PyPI 官网下载 | gon-1.4.2.tar.gz

gon === [](https://travis-ci.com/lycantropos/gon "Travis CI") [](https://dev.azure.com/lycantropos/gon/_build/latest?definitionId=9&branchName=master "Azure Pipelines") [](https://gon.readthedocs.io/en/latest "Documentation") [](https://codecov.io/gh/lycantropos/gon "Codecov") [](https://github.com/lycantropos/gon/blob/master/LICENSE "License") [](https://badge.fury.io/py/gon "PyPI") Summary ------- `gon` is a pure Python library that provides support for planar geometry objects built from discrete points, finite number of straight line segments (e.g. polylines) and areas bound by closed polylines (e.g. polygons). Main features are - convenience: all geometric objects are [immutable](https://docs.python.org/3/glossary.html#term-immutable), [hashable](https://docs.python.org/3/glossary.html#term-hashable) and implement [set-like](https://docs.python.org/3/library/collections.abc.html#collections.abc.Set) interface, i.e. support containment, equality, "is-subset" tests and boolean set operations (e.g. finding intersection). - correctness: all calculations are robust for floating point numbers & precise for integral numbers (like `int`), each operation corresponds to its mathematical definition and property-based tested. - efficiency: all operations are efficient in terms of both time & memory complexity, upper bound for expected time complexity is `O(n * log n)`, for memory complexity is `O(n)`. --- In what follows - `python` is an alias for `python3.5` or any later version (`python3.6` and so on), - `pypy` is an alias for `pypy3.5` or any later version (`pypy3.6` and so on). Installation ------------ Install the latest `pip` & `setuptools` packages versions: - with `CPython` ```bash python -m pip install --upgrade pip setuptools ``` - with `PyPy` ```bash pypy -m pip install --upgrade pip setuptools ``` ### User Download and install the latest stable version from `PyPI` repository: - with `CPython` ```bash python -m pip install --upgrade gon ``` - with `PyPy` ```bash pypy -m pip install --upgrade gon ``` ### Developer Download the latest version from `GitHub` repository ```bash git clone https://github.com/lycantropos/gon.git cd gon ``` Install dependencies: - with `CPython` ```bash python -m pip install --force-reinstall -r requirements.txt ``` - with `PyPy` ```bash pypy -m pip install --force-reinstall -r requirements.txt ``` Install: - with `CPython` ```bash python setup.py install ``` - with `PyPy` ```bash pypy setup.py install ``` Usage ----- ```python >>> from gon.degenerate import EMPTY >>> from gon.primitive import Point >>> from gon.shaped import Polygon >>> raw_square = [(0, 0), (4, 0), (4, 4), (0, 4)], [] >>> square = Polygon.from_raw(raw_square) >>> square.raw() == raw_square True >>> square == square True >>> square >= square True >>> square <= square True >>> square < square False >>> square > square False >>> square & square == square True >>> square | square == square True >>> square - square is EMPTY True >>> square ^ square is EMPTY True >>> Point(0, 0) in square True >>> square.index() >>> Point(0, 0) in square True >>> len(square.border.vertices) == 4 True >>> len(square.holes) == 0 True >>> square.is_convex True >>> square.convex_hull == square True >>> square.area == 16 True >>> square.perimeter == 16 True >>> square.centroid == Point(2, 2) True >>> (square.scale(1, 2) ... == Polygon.from_raw(([(0, 0), (4, 0), (4, 8), (0, 8)], []))) True >>> (square.translate(1, 2) ... == Polygon.from_raw(([(1, 2), (5, 2), (5, 6), (1, 6)], []))) True >>> (square.triangulate() ... == [Polygon.from_raw(([(0, 4), (4, 0), (4, 4)], [])), ... Polygon.from_raw(([(0, 0), (4, 0), (0, 4)], []))]) True ``` Development ----------- ### Bumping version #### Preparation Install [bump2version](https://github.com/c4urself/bump2version#installation). #### Pre-release Choose which version number category to bump following [semver specification](http://semver.org/). Test bumping version ```bash bump2version --dry-run --verbose $CATEGORY ``` where `$CATEGORY` is the target version number category name, possible values are `patch`/`minor`/`major`. Bump version ```bash bump2version --verbose $CATEGORY ``` This will set version to `major.minor.patch-alpha`. #### Release Test bumping version ```bash bump2version --dry-run --verbose release ``` Bump version ```bash bump2version --verbose release ``` This will set version to `major.minor.patch`. ### Running tests Install dependencies: - with `CPython` ```bash python -m pip install --force-reinstall -r requirements-tests.txt ``` - with `PyPy` ```bash pypy -m pip install --force-reinstall -r requirements-tests.txt ``` Plain ```bash pytest ``` Inside `Docker` container: - with `CPython` ```bash docker-compose --file docker-compose.cpython.yml up ``` - with `PyPy` ```bash docker-compose --file docker-compose.pypy.yml up ``` `Bash` script (e.g. can be used in `Git` hooks): - with `CPython` ```bash ./run-tests.sh ``` or ```bash ./run-tests.sh cpython ``` - with `PyPy` ```bash ./run-tests.sh pypy ``` `PowerShell` script (e.g. can be used in `Git` hooks): - with `CPython` ```powershell .\run-tests.ps1 ``` or ```powershell .\run-tests.ps1 cpython ``` - with `PyPy` ```powershell .\run-tests.ps1 pypy ```