|aerofiles|
===========
**airspace, waypoint, task, tracklog readers and writers for aviation**
This is a python library to read and write many important file formats
for aviation. It is compatible with python 3.0 (and newer) and 2.6
(except AIXM which needs python 3.7). Please read the documentation
under https://aerofiles.readthedocs.io for further information.
.. image:: ../../actions/workflows/ci.yml/badge.svg
:target: ../../actions/workflows/ci.yml
:alt: Build Status
Features
--------
- `AIXM <http://aixm.aero/>`_ read AIXM 5.1.1 airspaces (``aerofiles.aixm``)
- use [aixm-to-openair.py](aerofiles/aixm/aixm-to-openair.py) to convert AIXM into openair
- `Flarm <http://flarm.com/>`_ configuration file writer
(``aerofiles.flarmcfg``)
- `IGC <https://www.fai.org/commission/igc>`_ file reader and writer (``aerofiles.igc``)
- `OpenAir <https://github.com/naviter/seeyou_file_formats/blob/main/OpenAir_File_Format_Support.md>`_ file
reader and writer (``aerofiles.openair``)
- `SeeYou <http://www.naviter.com/products/seeyou/>`_ CUP file reader and
writer (``aerofiles.seeyou``)
- `WELT2000 <http://www.segelflug.de/vereine/welt2000/>`_ file reader
(``aerofiles.welt2000``)
- `XCSoar <http://www.xcsoar.org>`_ task file writer (``aerofiles.xcsoar``)
Development Environment
-----------------------
If you want to work on aerofiles you should install the necessary dependencies
using pip, preferably in a virtual environment::
$ python -m venv .env
$ source .env/bin/activate
$ pip install -r requirements-dev.txt
You can run the testsuite with::
$ make test
If you close the current shell, the virtual python environment will
also be deactivated. To continue working in the environment and using
the installed requirements, you must use this again::
$ source .env/bin/activate
Building Docs
-------------
Make sure that you have checked out git submodules::
$ git submodule update --init
Then build docs using Sphinx and Make::
$ make doc
The HTML output can be found in the `docs/_build/html` directory.
License
-------
This code is published under the MIT license. See the
`LICENSE <https://github.com/Turbo87/aerofiles/blob/master/LICENSE>`__ file
for the full text.
How to release
--------------
Make sure, that all succeed::
$ make lint
(and use `make lint-fix` for automatic fixing)::
$ make vermin
$ make test
$ make doc-test
Ensure CHANGELOG.rst is up to date including the (next) version
number. Also check, that (next) version number is included in
setup.py.
Use browser with https://github.com/Turbo87/aerofiles/releases and
"Draft a new release". Use "Choose a tag" to create a new tag
following the structure "v1.2.1". The release title should be
"aerofiles v1.2.1". Use text from CHANGELOG.rst to describe this
release.
Finally use "Set as the latest release" and publish release.
Then go to https://readthedocs.org/projects/aerofiles/ and hit
"Build-Version" to update the documentation from github.com.
.. |aerofiles| image:: https://github.com/Turbo87/aerofiles/raw/master/img/logo.png
:alt: aerofiles
Raw data
{
"_id": null,
"home_page": "https://github.com/Turbo87/aerofiles/",
"name": "aerofiles",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Tobias Bieniek",
"author_email": "tobias.bieniek@gmx.de",
"download_url": "https://files.pythonhosted.org/packages/57/92/2962292b4cdc575f303197791a2516f761cef680d9ffbbf763679c041803/aerofiles-1.5.0.tar.gz",
"platform": null,
"description": "|aerofiles|\n===========\n\n**airspace, waypoint, task, tracklog readers and writers for aviation**\n\nThis is a python library to read and write many important file formats\nfor aviation. It is compatible with python 3.0 (and newer) and 2.6\n(except AIXM which needs python 3.7). Please read the documentation\nunder https://aerofiles.readthedocs.io for further information.\n\n.. image:: ../../actions/workflows/ci.yml/badge.svg\n :target: ../../actions/workflows/ci.yml\n :alt: Build Status\n\nFeatures\n--------\n\n- `AIXM <http://aixm.aero/>`_ read AIXM 5.1.1 airspaces (``aerofiles.aixm``)\n\n - use [aixm-to-openair.py](aerofiles/aixm/aixm-to-openair.py) to convert AIXM into openair\n\n- `Flarm <http://flarm.com/>`_ configuration file writer\n (``aerofiles.flarmcfg``)\n- `IGC <https://www.fai.org/commission/igc>`_ file reader and writer (``aerofiles.igc``)\n- `OpenAir <https://github.com/naviter/seeyou_file_formats/blob/main/OpenAir_File_Format_Support.md>`_ file\n reader and writer (``aerofiles.openair``)\n- `SeeYou <http://www.naviter.com/products/seeyou/>`_ CUP file reader and\n writer (``aerofiles.seeyou``)\n- `WELT2000 <http://www.segelflug.de/vereine/welt2000/>`_ file reader\n (``aerofiles.welt2000``)\n- `XCSoar <http://www.xcsoar.org>`_ task file writer (``aerofiles.xcsoar``)\n\nDevelopment Environment\n-----------------------\n\nIf you want to work on aerofiles you should install the necessary dependencies\nusing pip, preferably in a virtual environment::\n\n $ python -m venv .env\n $ source .env/bin/activate\n $ pip install -r requirements-dev.txt\n\nYou can run the testsuite with::\n\n $ make test\n\nIf you close the current shell, the virtual python environment will\nalso be deactivated. To continue working in the environment and using\nthe installed requirements, you must use this again::\n \n $ source .env/bin/activate\n\nBuilding Docs\n-------------\n\nMake sure that you have checked out git submodules::\n\n $ git submodule update --init\n\nThen build docs using Sphinx and Make::\n\n $ make doc\n\nThe HTML output can be found in the `docs/_build/html` directory.\n\nLicense\n-------\n\nThis code is published under the MIT license. See the\n`LICENSE <https://github.com/Turbo87/aerofiles/blob/master/LICENSE>`__ file\nfor the full text.\n\nHow to release\n--------------\n\nMake sure, that all succeed::\n\n $ make lint\n\n(and use `make lint-fix` for automatic fixing)::\n\n $ make vermin\n $ make test\n $ make doc-test\n\nEnsure CHANGELOG.rst is up to date including the (next) version\nnumber. Also check, that (next) version number is included in\nsetup.py.\n\nUse browser with https://github.com/Turbo87/aerofiles/releases and\n\"Draft a new release\". Use \"Choose a tag\" to create a new tag\nfollowing the structure \"v1.2.1\". The release title should be\n\"aerofiles v1.2.1\". Use text from CHANGELOG.rst to describe this\nrelease.\n\nFinally use \"Set as the latest release\" and publish release.\n\nThen go to https://readthedocs.org/projects/aerofiles/ and hit\n\"Build-Version\" to update the documentation from github.com.\n\n.. |aerofiles| image:: https://github.com/Turbo87/aerofiles/raw/master/img/logo.png\n :alt: aerofiles\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "waypoint, task, tracklog readers and writers for aviation",
"version": "1.5.0",
"project_urls": {
"Homepage": "https://github.com/Turbo87/aerofiles/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "57922962292b4cdc575f303197791a2516f761cef680d9ffbbf763679c041803",
"md5": "703b8e76ba25a987b5b71a8d34545dd4",
"sha256": "ce81e0055aa9fe8dc02a79c63aaaafb46eb25bc875bca78ff284c7a2062038fb"
},
"downloads": -1,
"filename": "aerofiles-1.5.0.tar.gz",
"has_sig": false,
"md5_digest": "703b8e76ba25a987b5b71a8d34545dd4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 47362,
"upload_time": "2025-07-10T12:30:52",
"upload_time_iso_8601": "2025-07-10T12:30:52.494797Z",
"url": "https://files.pythonhosted.org/packages/57/92/2962292b4cdc575f303197791a2516f761cef680d9ffbbf763679c041803/aerofiles-1.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-10 12:30:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Turbo87",
"github_project": "aerofiles",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "aerofiles"
}