diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-pypolyline.spec | 318 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 320 insertions, 0 deletions
@@ -0,0 +1 @@ +/pypolyline-0.3.1.tar.gz diff --git a/python-pypolyline.spec b/python-pypolyline.spec new file mode 100644 index 0000000..cbea632 --- /dev/null +++ b/python-pypolyline.spec @@ -0,0 +1,318 @@ +%global _empty_manifest_terminate_build 0 +Name: python-pypolyline +Version: 0.3.1 +Release: 1 +Summary: Fast Google Polyline encoding and decoding using Rust FFI +License: MIT +URL: https://github.com/urschrei/pypolyline +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/45/a4/6521d5b6ba678523fbda227fd3453a10debbf5e9da073d2ac046594cf2a5/pypolyline-0.3.1.tar.gz + +Requires: python3-numpy +Requires: python3-cython +Requires: python3-pytest +Requires: python3-pytest + +%description + [](https://coveralls.io/github/urschrei/pypolyline?branch=master) [](https://pepy.tech/project/pypolyline)[](https://zenodo.org/badge/latestdoi/63355673) + +# Fast Google [Polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) Encoding and Decoding + +## Installation +`pip install pypolyline` +Please use a recent (>= 8.1.2) version of `pip`. + +### Supported Python Versions +- Python 3.7 +- Python 3.8 +- Python 3.9 +- Python 3.10 + +### Supported Platforms +- Linux (`manylinux*`-compatible, x86_64 and aarch64) +- macOS (x86_64 and arm64) +- Windows 64-bit + +## Usage +Coordinates must be in (`Longitude, Latitude`) order + +```python +from pypolyline.cutil import encode_coordinates, decode_polyline + +coords = [ + [52.64125, 23.70162], + [52.64938, 23.70154], + [52.64957, 23.68546], + [52.64122, 23.68549], + [52.64125, 23.70162] + ] + +# precision is 5 for Google Polyline, 6 for OSRM / Valhalla +polyline = encode_coordinates(coords, 5) +# polyline is 'ynh`IcftoCyq@Ne@ncBds@EEycB' +decoded_coords = decode_polyline(polyline, 5) +``` + +## Cython Module 🔥 +If you're comfortable with a lack of built-in exceptions, you should use the compiled Cython version of the functions, giving a 3x speedup over the `ctypes` functions: +```python +from pypolyline.cutil import encode_coordinates, decode_polyline +``` +- Longitude errors will return strings beginning with `Longitude error:` +- Latitude errors will return strings beginning with `Latitude error:` +- Polyline errors will return `[[nan, nan]]` + +Otherwise, import from `util` instead, for a slower, `ctypes`-based interface. Attempts to decode an invalid Polyline will throw `util.EncodingError` +Attempts to encode invalid coordinates will throw `util.DecodingError` + +## How it Works +FFI and a [Rust binary](https://github.com/urschrei/polyline-ffi) + +## Is It Fast +…Yes. +You can verify this by installing the `polyline` package, then running [`benchmarks.py`](benchmarks.py), a calibrated benchmark using `cProfile`. +On a 1.8 GHz Intel Core i7, The pure-Python test runs in ~5000 ms and The Rust + Cython benchmark runs in around 300 ms (177 % faster). + +## License +[MIT](license.txt) + +## Citing `Pypolyline` +If Pypolyline has been significant in your research, and you would like to acknowledge the project in your academic publication, we suggest citing it as follows (example in APA style, 7th edition): + +> Hügel, S. (2021). Pypolyline (Version X.Y.Z) [Computer software]. https://doi.org/10.5281/zenodo.5774925 + +In Bibtex format: + + + @software{Hugel_Pypolyline_2021, + author = {Hügel, Stephan}, + doi = {10.5281/zenodo.5774925}, + license = {MIT}, + month = {12}, + title = {{Pypolyline}}, + url = {https://github.com/urschrei/simplification}, + version = {X.Y.Z}, + year = {2021} + } + + +%package -n python3-pypolyline +Summary: Fast Google Polyline encoding and decoding using Rust FFI +Provides: python-pypolyline +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +BuildRequires: python3-cffi +BuildRequires: gcc +BuildRequires: gdb +%description -n python3-pypolyline + [](https://coveralls.io/github/urschrei/pypolyline?branch=master) [](https://pepy.tech/project/pypolyline)[](https://zenodo.org/badge/latestdoi/63355673) + +# Fast Google [Polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) Encoding and Decoding + +## Installation +`pip install pypolyline` +Please use a recent (>= 8.1.2) version of `pip`. + +### Supported Python Versions +- Python 3.7 +- Python 3.8 +- Python 3.9 +- Python 3.10 + +### Supported Platforms +- Linux (`manylinux*`-compatible, x86_64 and aarch64) +- macOS (x86_64 and arm64) +- Windows 64-bit + +## Usage +Coordinates must be in (`Longitude, Latitude`) order + +```python +from pypolyline.cutil import encode_coordinates, decode_polyline + +coords = [ + [52.64125, 23.70162], + [52.64938, 23.70154], + [52.64957, 23.68546], + [52.64122, 23.68549], + [52.64125, 23.70162] + ] + +# precision is 5 for Google Polyline, 6 for OSRM / Valhalla +polyline = encode_coordinates(coords, 5) +# polyline is 'ynh`IcftoCyq@Ne@ncBds@EEycB' +decoded_coords = decode_polyline(polyline, 5) +``` + +## Cython Module 🔥 +If you're comfortable with a lack of built-in exceptions, you should use the compiled Cython version of the functions, giving a 3x speedup over the `ctypes` functions: +```python +from pypolyline.cutil import encode_coordinates, decode_polyline +``` +- Longitude errors will return strings beginning with `Longitude error:` +- Latitude errors will return strings beginning with `Latitude error:` +- Polyline errors will return `[[nan, nan]]` + +Otherwise, import from `util` instead, for a slower, `ctypes`-based interface. Attempts to decode an invalid Polyline will throw `util.EncodingError` +Attempts to encode invalid coordinates will throw `util.DecodingError` + +## How it Works +FFI and a [Rust binary](https://github.com/urschrei/polyline-ffi) + +## Is It Fast +…Yes. +You can verify this by installing the `polyline` package, then running [`benchmarks.py`](benchmarks.py), a calibrated benchmark using `cProfile`. +On a 1.8 GHz Intel Core i7, The pure-Python test runs in ~5000 ms and The Rust + Cython benchmark runs in around 300 ms (177 % faster). + +## License +[MIT](license.txt) + +## Citing `Pypolyline` +If Pypolyline has been significant in your research, and you would like to acknowledge the project in your academic publication, we suggest citing it as follows (example in APA style, 7th edition): + +> Hügel, S. (2021). Pypolyline (Version X.Y.Z) [Computer software]. https://doi.org/10.5281/zenodo.5774925 + +In Bibtex format: + + + @software{Hugel_Pypolyline_2021, + author = {Hügel, Stephan}, + doi = {10.5281/zenodo.5774925}, + license = {MIT}, + month = {12}, + title = {{Pypolyline}}, + url = {https://github.com/urschrei/simplification}, + version = {X.Y.Z}, + year = {2021} + } + + +%package help +Summary: Development documents and examples for pypolyline +Provides: python3-pypolyline-doc +%description help + [](https://coveralls.io/github/urschrei/pypolyline?branch=master) [](https://pepy.tech/project/pypolyline)[](https://zenodo.org/badge/latestdoi/63355673) + +# Fast Google [Polyline](https://developers.google.com/maps/documentation/utilities/polylinealgorithm) Encoding and Decoding + +## Installation +`pip install pypolyline` +Please use a recent (>= 8.1.2) version of `pip`. + +### Supported Python Versions +- Python 3.7 +- Python 3.8 +- Python 3.9 +- Python 3.10 + +### Supported Platforms +- Linux (`manylinux*`-compatible, x86_64 and aarch64) +- macOS (x86_64 and arm64) +- Windows 64-bit + +## Usage +Coordinates must be in (`Longitude, Latitude`) order + +```python +from pypolyline.cutil import encode_coordinates, decode_polyline + +coords = [ + [52.64125, 23.70162], + [52.64938, 23.70154], + [52.64957, 23.68546], + [52.64122, 23.68549], + [52.64125, 23.70162] + ] + +# precision is 5 for Google Polyline, 6 for OSRM / Valhalla +polyline = encode_coordinates(coords, 5) +# polyline is 'ynh`IcftoCyq@Ne@ncBds@EEycB' +decoded_coords = decode_polyline(polyline, 5) +``` + +## Cython Module 🔥 +If you're comfortable with a lack of built-in exceptions, you should use the compiled Cython version of the functions, giving a 3x speedup over the `ctypes` functions: +```python +from pypolyline.cutil import encode_coordinates, decode_polyline +``` +- Longitude errors will return strings beginning with `Longitude error:` +- Latitude errors will return strings beginning with `Latitude error:` +- Polyline errors will return `[[nan, nan]]` + +Otherwise, import from `util` instead, for a slower, `ctypes`-based interface. Attempts to decode an invalid Polyline will throw `util.EncodingError` +Attempts to encode invalid coordinates will throw `util.DecodingError` + +## How it Works +FFI and a [Rust binary](https://github.com/urschrei/polyline-ffi) + +## Is It Fast +…Yes. +You can verify this by installing the `polyline` package, then running [`benchmarks.py`](benchmarks.py), a calibrated benchmark using `cProfile`. +On a 1.8 GHz Intel Core i7, The pure-Python test runs in ~5000 ms and The Rust + Cython benchmark runs in around 300 ms (177 % faster). + +## License +[MIT](license.txt) + +## Citing `Pypolyline` +If Pypolyline has been significant in your research, and you would like to acknowledge the project in your academic publication, we suggest citing it as follows (example in APA style, 7th edition): + +> Hügel, S. (2021). Pypolyline (Version X.Y.Z) [Computer software]. https://doi.org/10.5281/zenodo.5774925 + +In Bibtex format: + + + @software{Hugel_Pypolyline_2021, + author = {Hügel, Stephan}, + doi = {10.5281/zenodo.5774925}, + license = {MIT}, + month = {12}, + title = {{Pypolyline}}, + url = {https://github.com/urschrei/simplification}, + version = {X.Y.Z}, + year = {2021} + } + + +%prep +%autosetup -n pypolyline-0.3.1 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-pypolyline -f filelist.lst +%dir %{python3_sitearch}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3.1-1 +- Package Spec generated @@ -0,0 +1 @@ +142dc83a06432f3755fc8e14785cffd1 pypolyline-0.3.1.tar.gz |