| Name | fastkml JSON |
| Version |
1.1.0
JSON |
| download |
| home_page | None |
| Summary | Fast KML processing in python |
| upload_time | 2024-12-02 09:43:09 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | LGPL |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
Introduction
============
.. inclusion-marker-do-not-remove
KML is an XML geospatial data format and an OGC_ standard that deserves a canonical
python implementation.
Fastkml is a library to read, write and manipulate KML files. It aims to keep
it simple and fast (using lxml_ if available). Fast refers to the time you
spend to write and read KML files as well as the time you spend to get
acquainted to the library or to create KML objects. It aims to provide all of
the functionality that KML clients such as `Marble <https://marble.kde.org/>`_,
`NASA WorldWind <https://github.com/NASAWorldWind>`_,
`Cesium JS <https://cesium.com/>`_, `OpenLayers <https://openlayers.org/>`_,
`Google Maps <http://maps.google.com/>`_, and
`Google Earth <http://earth.google.com/>`_ support.
For more details about the KML Specification, check out the `KML Reference
<https://developers.google.com/kml/documentation/kmlreference>`_ on the Google
developers site.
Geometries are handled as pygeoif_ objects, which are compatible with any geometry that
implements the ``__geo_interface__`` protocol, such as shapely_.
Fastkml is tested on `CPython <https://python.org>`_ and
`PyPy <https://www.pypy.org/>`_, but it should work on alternative
Python implementations (that implement the language specification *>=3.8*) as well.
|test| |hypothesis| |cov| |black| |mypy| |commit|
.. |test| image:: https://github.com/cleder/fastkml/actions/workflows/run-all-tests.yml/badge.svg?branch=main
:target: https://github.com/cleder/fastkml/actions/workflows/run-all-tests.yml
:alt: Test
.. |hypothesis| image:: https://img.shields.io/badge/hypothesis-tested-brightgreen.svg
:alt: Tested with Hypothesis
:target: https://hypothesis.readthedocs.io
.. |cov| image:: https://codecov.io/gh/cleder/fastkml/branch/main/graph/badge.svg?token=VIuhPHq0ow
:target: http://codecov.io/github/cleder/fastkml?branch=main
:alt: codecov.io
.. |black| image:: https://img.shields.io/badge/code_style-black-000000.svg
:target: https://github.com/psf/black
:alt: Black
.. |mypy| image:: https://img.shields.io/badge/type_checker-mypy-blue
:target: http://mypy-lang.org/
:alt: Mypy
.. |commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit
:target: https://github.com/pre-commit/pre-commit
:alt: pre-commit
Is maintained and documented:
|pypi| |conda-forge| |status| |license| |doc| |stats| |pyversion| |pyimpl| |dependencies| |downloads|
.. |pypi| image:: https://img.shields.io/pypi/v/fastkml.svg
:target: https://pypi.python.org/pypi/fastkml
:alt: Latest PyPI version
.. |status| image:: https://img.shields.io/pypi/status/fastkml.svg
:target: https://pypi.python.org/pypi/fastkml/
:alt: Development Status
.. |license| image:: https://img.shields.io/pypi/l/fastkml
:target: https://www.gnu.org/licenses/lgpl-3.0.en.html
:alt: LGPL - License
.. |doc| image:: https://readthedocs.org/projects/fastkml/badge/
:target: https://fastkml.readthedocs.org/
:alt: Documentation
.. |stats| image:: https://www.openhub.net/p/fastkml/widgets/project_thin_badge.gif
:target: https://www.openhub.net/p/fastkml
:alt: Statistics from OpenHub
.. |pyversion| image:: https://img.shields.io/pypi/pyversions/fastkml.svg
:target: https://pypi.python.org/pypi/fastkml/
:alt: Supported Python versions
.. |pyimpl| image:: https://img.shields.io/pypi/implementation/fastkml.svg
:target: https://pypi.python.org/pypi/fastkml/
:alt: Supported Python implementations
.. |dependencies| image:: https://img.shields.io/librariesio/release/pypi/fastkml
:target: https://libraries.io/pypi/fastkml
:alt: Libraries.io dependency status for latest release
.. |downloads| image:: https://static.pepy.tech/badge/fastkml/month
:target: https://pepy.tech/project/fastkml
:alt: Downloads
.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/fastkml.svg
:target: https://anaconda.org/conda-forge/fastkml
:alt: Conda-Forge
Documentation
=============
You can find all of the documentation for FastKML at `fastkml.readthedocs.org
<https://fastkml.readthedocs.org>`_. If you find something that is missing,
please submit a pull request on `GitHub <https://github.com/cleder/fastkml>`_
with the improvement.
Install
========
You can install the package with ``pip install fastkml`` which will pull in all requirements.
Requirements
-------------
* pygeoif_
* arrow_
Optional
---------
* lxml_:
.. code-block:: bash
pip install "fastkml[lxml]"
Limitations
===========
Currently, the only major feature missing for the full Google Earth experience
is the `gx extension
<https://developers.google.com/kml/documentation/kmlreference#kmlextensions>`_.
Please submit a PR with the features you'd like to see implemented.
.. _pygeoif: https://pypi.python.org/pypi/pygeoif/
.. _lxml: https://pypi.python.org/pypi/lxml
.. _arrow: https://pypi.python.org/pypi/arrow
.. _OGC: https://www.ogc.org/standard/kml/
.. _shapely: https://shapely.readthedocs.io/
Raw data
{
"_id": null,
"home_page": null,
"name": "fastkml",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Christian Ledermann <christian.ledermann@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/6a/f4/759f7aa0e3647bec3a2750beaab7916f42443367f97c6087f8278e8ecec4/fastkml-1.1.0.tar.gz",
"platform": null,
"description": "Introduction\n============\n\n.. inclusion-marker-do-not-remove\n\nKML is an XML geospatial data format and an OGC_ standard that deserves a canonical\npython implementation.\n\nFastkml is a library to read, write and manipulate KML files. It aims to keep\nit simple and fast (using lxml_ if available). Fast refers to the time you\nspend to write and read KML files as well as the time you spend to get\nacquainted to the library or to create KML objects. It aims to provide all of\nthe functionality that KML clients such as `Marble <https://marble.kde.org/>`_,\n`NASA WorldWind <https://github.com/NASAWorldWind>`_,\n`Cesium JS <https://cesium.com/>`_, `OpenLayers <https://openlayers.org/>`_,\n`Google Maps <http://maps.google.com/>`_, and\n`Google Earth <http://earth.google.com/>`_ support.\n\nFor more details about the KML Specification, check out the `KML Reference\n<https://developers.google.com/kml/documentation/kmlreference>`_ on the Google\ndevelopers site.\n\nGeometries are handled as pygeoif_ objects, which are compatible with any geometry that\nimplements the ``__geo_interface__`` protocol, such as shapely_.\n\nFastkml is tested on `CPython <https://python.org>`_ and\n`PyPy <https://www.pypy.org/>`_, but it should work on alternative\nPython implementations (that implement the language specification *>=3.8*) as well.\n\n|test| |hypothesis| |cov| |black| |mypy| |commit|\n\n.. |test| image:: https://github.com/cleder/fastkml/actions/workflows/run-all-tests.yml/badge.svg?branch=main\n :target: https://github.com/cleder/fastkml/actions/workflows/run-all-tests.yml\n :alt: Test\n\n.. |hypothesis| image:: https://img.shields.io/badge/hypothesis-tested-brightgreen.svg\n :alt: Tested with Hypothesis\n :target: https://hypothesis.readthedocs.io\n\n.. |cov| image:: https://codecov.io/gh/cleder/fastkml/branch/main/graph/badge.svg?token=VIuhPHq0ow\n :target: http://codecov.io/github/cleder/fastkml?branch=main\n :alt: codecov.io\n\n.. |black| image:: https://img.shields.io/badge/code_style-black-000000.svg\n :target: https://github.com/psf/black\n :alt: Black\n\n.. |mypy| image:: https://img.shields.io/badge/type_checker-mypy-blue\n :target: http://mypy-lang.org/\n :alt: Mypy\n\n.. |commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\n :target: https://github.com/pre-commit/pre-commit\n :alt: pre-commit\n\nIs maintained and documented:\n\n|pypi| |conda-forge| |status| |license| |doc| |stats| |pyversion| |pyimpl| |dependencies| |downloads|\n\n.. |pypi| image:: https://img.shields.io/pypi/v/fastkml.svg\n :target: https://pypi.python.org/pypi/fastkml\n :alt: Latest PyPI version\n\n.. |status| image:: https://img.shields.io/pypi/status/fastkml.svg\n :target: https://pypi.python.org/pypi/fastkml/\n :alt: Development Status\n\n.. |license| image:: https://img.shields.io/pypi/l/fastkml\n :target: https://www.gnu.org/licenses/lgpl-3.0.en.html\n :alt: LGPL - License\n\n.. |doc| image:: https://readthedocs.org/projects/fastkml/badge/\n :target: https://fastkml.readthedocs.org/\n :alt: Documentation\n\n.. |stats| image:: https://www.openhub.net/p/fastkml/widgets/project_thin_badge.gif\n :target: https://www.openhub.net/p/fastkml\n :alt: Statistics from OpenHub\n\n.. |pyversion| image:: https://img.shields.io/pypi/pyversions/fastkml.svg\n :target: https://pypi.python.org/pypi/fastkml/\n :alt: Supported Python versions\n\n.. |pyimpl| image:: https://img.shields.io/pypi/implementation/fastkml.svg\n :target: https://pypi.python.org/pypi/fastkml/\n :alt: Supported Python implementations\n\n.. |dependencies| image:: https://img.shields.io/librariesio/release/pypi/fastkml\n :target: https://libraries.io/pypi/fastkml\n :alt: Libraries.io dependency status for latest release\n\n.. |downloads| image:: https://static.pepy.tech/badge/fastkml/month\n :target: https://pepy.tech/project/fastkml\n :alt: Downloads\n\n.. |conda-forge| image:: https://img.shields.io/conda/vn/conda-forge/fastkml.svg\n :target: https://anaconda.org/conda-forge/fastkml\n :alt: Conda-Forge\n\nDocumentation\n=============\n\nYou can find all of the documentation for FastKML at `fastkml.readthedocs.org\n<https://fastkml.readthedocs.org>`_. If you find something that is missing,\nplease submit a pull request on `GitHub <https://github.com/cleder/fastkml>`_\nwith the improvement.\n\n\nInstall\n========\n\nYou can install the package with ``pip install fastkml`` which will pull in all requirements.\n\nRequirements\n-------------\n\n* pygeoif_\n* arrow_\n\nOptional\n---------\n\n* lxml_:\n\n.. code-block:: bash\n\n pip install \"fastkml[lxml]\"\n\nLimitations\n===========\n\nCurrently, the only major feature missing for the full Google Earth experience\nis the `gx extension\n<https://developers.google.com/kml/documentation/kmlreference#kmlextensions>`_.\nPlease submit a PR with the features you'd like to see implemented.\n\n.. _pygeoif: https://pypi.python.org/pypi/pygeoif/\n.. _lxml: https://pypi.python.org/pypi/lxml\n.. _arrow: https://pypi.python.org/pypi/arrow\n.. _OGC: https://www.ogc.org/standard/kml/\n.. _shapely: https://shapely.readthedocs.io/\n",
"bugtrack_url": null,
"license": "LGPL",
"summary": "Fast KML processing in python",
"version": "1.1.0",
"project_urls": {
"Changelog": "https://github.com/cleder/fastkml/blob/develop/docs/HISTORY.rst",
"Documentation": "https://fastkml.readthedocs.org/",
"Homepage": "https://github.com/cleder/fastkml"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "866da40a85bde02b02f6fd50b313efa08393ee4cc0533760b99640b86c65ba47",
"md5": "108d520294c26faefc69df8727559dc1",
"sha256": "31a79801ec677046d68bf56f95837e9057ed49aa51dda5421c6726a239df645f"
},
"downloads": -1,
"filename": "fastkml-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "108d520294c26faefc69df8727559dc1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 107861,
"upload_time": "2024-12-02T09:43:07",
"upload_time_iso_8601": "2024-12-02T09:43:07.716710Z",
"url": "https://files.pythonhosted.org/packages/86/6d/a40a85bde02b02f6fd50b313efa08393ee4cc0533760b99640b86c65ba47/fastkml-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6af4759f7aa0e3647bec3a2750beaab7916f42443367f97c6087f8278e8ecec4",
"md5": "ccffea74aa7a3446d63ad532f5d3fb2a",
"sha256": "a786a80733763c16f5505efd7160a526f43b093bde767c9b35e816459bc6074e"
},
"downloads": -1,
"filename": "fastkml-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "ccffea74aa7a3446d63ad532f5d3fb2a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 87757,
"upload_time": "2024-12-02T09:43:09",
"upload_time_iso_8601": "2024-12-02T09:43:09.429194Z",
"url": "https://files.pythonhosted.org/packages/6a/f4/759f7aa0e3647bec3a2750beaab7916f42443367f97c6087f8278e8ecec4/fastkml-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-02 09:43:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "cleder",
"github_project": "fastkml",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "fastkml"
}
