DOBSON
Dobson file parser
.. start-badges
| |build| |docs| |coverage| |maintainability| |tech-debt|
| |release_version| |wheel| |supported_versions| |gh-lic| |commits_since_specific_tag_on_master| |commits_since_latest_github_release|
|
| **Code:** https://github.com/gosow9/dobson
| **Docs:** https://dobson.readthedocs.io/en/master/
| **PyPI:** https://pypi.org/project/dobson/
| **CI:** https://github.com/gosow9/dobson/actions/
Features
========
1. **dobson** `python package`
a. TODO Document a **Great Feature**
b. TODO Document another **Nice Feature**
2. Tested against multiple `platforms` and `python` versions
Development
-----------
Here are some useful notes related to doing development on this project.
1. **Test Suite**, using `pytest`_, located in `tests` dir
2. **Parallel Execution** of Unit Tests, on multiple cpu's
3. **Documentation Pages**, hosted on `readthedocs` server, located in `docs` dir
4. **Automation**, using `tox`_, driven by single `tox.ini` file
a. **Code Coverage** measuring
b. **Build Command**, using the `build`_ python package
c. **Pypi Deploy Command**, supporting upload to both `pypi.org`_ and `test.pypi.org`_ servers
d. **Type Check Command**, using `mypy`_
e. **Lint** *Check* and `Apply` commands, using `isort`_ and `black`_
5. **CI Pipeline**, running on `Github Actions`_, defined in `.github/`
a. **Job Matrix**, spanning different `platform`'s and `python version`'s
1. Platforms: `ubuntu-latest`, `macos-latest`
2. Python Interpreters: `3.6`, `3.7`, `3.8`, `3.9`, `3.10`
b. **Parallel Job** execution, generated from the `matrix`, that runs the `Test Suite`
Prerequisites
=============
You need to have `Python` installed.
Quickstart
==========
Using `pip` is the approved way for installing `dobson`.
.. code-block:: sh
python3 -m pip install dobson
TODO Document a use case
License
=======
|gh-lic|
* `GNU Affero General Public License v3.0`_
License
=======
* Free software: GNU Affero General Public License v3.0
.. LINKS
.. _tox: https://tox.wiki/en/latest/
.. _pytest: https://docs.pytest.org/en/7.1.x/
.. _build: https://github.com/pypa/build
.. _pypi.org: https://pypi.org/
.. _test.pypi.org: https://test.pypi.org/
.. _mypy: https://mypy.readthedocs.io/en/stable/
.. _isort: https://pycqa.github.io/isort/
.. _black: https://black.readthedocs.io/en/stable/
.. _Github Actions: https://github.com/gosow9/dobson/actions
.. _GNU Affero General Public License v3.0: https://github.com/gosow9/dobson/blob/master/LICENSE
.. BADGE ALIASES
.. Build Status
.. Github Actions: Test Workflow Status for specific branch <branch>
.. |build| image:: https://img.shields.io/github/workflow/status/gosow9/dobson/Test%20Python%20Package/master?label=build&logo=github-actions&logoColor=%233392FF
:alt: GitHub Workflow Status (branch)
:target: https://github.com/gosow9/dobson/actions/workflows/test.yaml?query=branch%3Amaster
.. Documentation
.. |docs| image:: https://img.shields.io/readthedocs/dobson/master?logo=readthedocs&logoColor=lightblue
:alt: Read the Docs (version)
:target: https://dobson.readthedocs.io/en/master/
.. Code Coverage
.. |coverage| image:: https://img.shields.io/codecov/c/github/gosow9/dobson/master?logo=codecov
:alt: Codecov
:target: https://app.codecov.io/gh/gosow9/dobson
.. PyPI
.. |release_version| image:: https://img.shields.io/pypi/v/dobson
:alt: Production Version
:target: https://pypi.org/project/dobson/
.. |wheel| image:: https://img.shields.io/pypi/wheel/dobson?color=green&label=wheel
:alt: PyPI - Wheel
:target: https://pypi.org/project/dobson
.. |supported_versions| image:: https://img.shields.io/pypi/pyversions/dobson?color=blue&label=python&logo=python&logoColor=%23ccccff
:alt: Supported Python versions
:target: https://pypi.org/project/dobson
.. Github Releases & Tags
.. |commits_since_specific_tag_on_master| image:: https://img.shields.io/github/commits-since/gosow9/dobson/v0.0.1/master?color=blue&logo=github
:alt: GitHub commits since tagged version (branch)
:target: https://github.com/gosow9/dobson/compare/v0.0.1..master
.. |commits_since_latest_github_release| image:: https://img.shields.io/github/commits-since/gosow9/dobson/latest?color=blue&logo=semver&sort=semver
:alt: GitHub commits since latest release (by SemVer)
.. LICENSE (eg AGPL, MIT)
.. Github License
.. |gh-lic| image:: https://img.shields.io/github/license/gosow9/dobson
:alt: GitHub
:target: https://github.com/gosow9/dobson/blob/master/LICENSE
.. CODE QUALITY
.. Code Climate CI
.. Code maintainability & Technical Debt
.. |maintainability| image:: https://img.shields.io/codeclimate/maintainability/gosow9/dobson
:alt: Code Climate Maintainability
:target: https://codeclimate.com/github/gosow9/dobson
.. |tech-debt| image:: https://img.shields.io/codeclimate/tech-debt/gosow9/dobson
:alt: Technical Debt
:target: https://codeclimate.com/github/gosow9/dobson
Raw data
{
"_id": null,
"home_page": "https://github.com/gosow9/dobson",
"name": "dobson",
"maintainer": "Cedric Renda",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "cedric.renda@hotmail.com",
"keywords": "python package",
"author": "Cedric Renda",
"author_email": "cedric.renda@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/e8/31/6a8017a0b297b80f8860f8220f95bbc3a5b8d7dc4c44621487adb89075a5/dobson-0.0.1.tar.gz",
"platform": null,
"description": "DOBSON\n\nDobson file parser\n\n.. start-badges\n\n| |build| |docs| |coverage| |maintainability| |tech-debt|\n| |release_version| |wheel| |supported_versions| |gh-lic| |commits_since_specific_tag_on_master| |commits_since_latest_github_release|\n\n|\n| **Code:** https://github.com/gosow9/dobson\n| **Docs:** https://dobson.readthedocs.io/en/master/\n| **PyPI:** https://pypi.org/project/dobson/\n| **CI:** https://github.com/gosow9/dobson/actions/\n\n\nFeatures\n========\n\n1. **dobson** `python package`\n\n a. TODO Document a **Great Feature**\n b. TODO Document another **Nice Feature**\n2. Tested against multiple `platforms` and `python` versions\n\n\nDevelopment\n-----------\nHere are some useful notes related to doing development on this project.\n\n1. **Test Suite**, using `pytest`_, located in `tests` dir\n2. **Parallel Execution** of Unit Tests, on multiple cpu's\n3. **Documentation Pages**, hosted on `readthedocs` server, located in `docs` dir\n4. **Automation**, using `tox`_, driven by single `tox.ini` file\n\n a. **Code Coverage** measuring\n b. **Build Command**, using the `build`_ python package\n c. **Pypi Deploy Command**, supporting upload to both `pypi.org`_ and `test.pypi.org`_ servers\n d. **Type Check Command**, using `mypy`_\n e. **Lint** *Check* and `Apply` commands, using `isort`_ and `black`_\n5. **CI Pipeline**, running on `Github Actions`_, defined in `.github/`\n\n a. **Job Matrix**, spanning different `platform`'s and `python version`'s\n\n 1. Platforms: `ubuntu-latest`, `macos-latest`\n 2. Python Interpreters: `3.6`, `3.7`, `3.8`, `3.9`, `3.10`\n b. **Parallel Job** execution, generated from the `matrix`, that runs the `Test Suite`\n\n\nPrerequisites\n=============\n\nYou need to have `Python` installed.\n\nQuickstart\n==========\n\nUsing `pip` is the approved way for installing `dobson`.\n\n.. code-block:: sh\n\n python3 -m pip install dobson\n\n\nTODO Document a use case\n\n\nLicense\n=======\n\n|gh-lic|\n\n* `GNU Affero General Public License v3.0`_\n\n\nLicense\n=======\n\n* Free software: GNU Affero General Public License v3.0\n\n\n\n.. LINKS\n\n.. _tox: https://tox.wiki/en/latest/\n\n.. _pytest: https://docs.pytest.org/en/7.1.x/\n\n.. _build: https://github.com/pypa/build\n\n.. _pypi.org: https://pypi.org/\n\n.. _test.pypi.org: https://test.pypi.org/\n\n.. _mypy: https://mypy.readthedocs.io/en/stable/\n\n.. _isort: https://pycqa.github.io/isort/\n\n.. _black: https://black.readthedocs.io/en/stable/\n\n.. _Github Actions: https://github.com/gosow9/dobson/actions\n\n.. _GNU Affero General Public License v3.0: https://github.com/gosow9/dobson/blob/master/LICENSE\n\n\n.. BADGE ALIASES\n\n.. Build Status\n.. Github Actions: Test Workflow Status for specific branch <branch>\n\n.. |build| image:: https://img.shields.io/github/workflow/status/gosow9/dobson/Test%20Python%20Package/master?label=build&logo=github-actions&logoColor=%233392FF\n :alt: GitHub Workflow Status (branch)\n :target: https://github.com/gosow9/dobson/actions/workflows/test.yaml?query=branch%3Amaster\n\n\n.. Documentation\n\n.. |docs| image:: https://img.shields.io/readthedocs/dobson/master?logo=readthedocs&logoColor=lightblue\n :alt: Read the Docs (version)\n :target: https://dobson.readthedocs.io/en/master/\n\n.. Code Coverage\n\n.. |coverage| image:: https://img.shields.io/codecov/c/github/gosow9/dobson/master?logo=codecov\n :alt: Codecov\n :target: https://app.codecov.io/gh/gosow9/dobson\n\n.. PyPI\n\n.. |release_version| image:: https://img.shields.io/pypi/v/dobson\n :alt: Production Version\n :target: https://pypi.org/project/dobson/\n\n.. |wheel| image:: https://img.shields.io/pypi/wheel/dobson?color=green&label=wheel\n :alt: PyPI - Wheel\n :target: https://pypi.org/project/dobson\n\n.. |supported_versions| image:: https://img.shields.io/pypi/pyversions/dobson?color=blue&label=python&logo=python&logoColor=%23ccccff\n :alt: Supported Python versions\n :target: https://pypi.org/project/dobson\n\n.. Github Releases & Tags\n\n.. |commits_since_specific_tag_on_master| image:: https://img.shields.io/github/commits-since/gosow9/dobson/v0.0.1/master?color=blue&logo=github\n :alt: GitHub commits since tagged version (branch)\n :target: https://github.com/gosow9/dobson/compare/v0.0.1..master\n\n.. |commits_since_latest_github_release| image:: https://img.shields.io/github/commits-since/gosow9/dobson/latest?color=blue&logo=semver&sort=semver\n :alt: GitHub commits since latest release (by SemVer)\n\n.. LICENSE (eg AGPL, MIT)\n.. Github License\n\n.. |gh-lic| image:: https://img.shields.io/github/license/gosow9/dobson\n :alt: GitHub\n :target: https://github.com/gosow9/dobson/blob/master/LICENSE\n\n\n.. CODE QUALITY\n\n.. Code Climate CI\n.. Code maintainability & Technical Debt\n\n.. |maintainability| image:: https://img.shields.io/codeclimate/maintainability/gosow9/dobson\n :alt: Code Climate Maintainability\n :target: https://codeclimate.com/github/gosow9/dobson\n\n.. |tech-debt| image:: https://img.shields.io/codeclimate/tech-debt/gosow9/dobson\n :alt: Technical Debt\n :target: https://codeclimate.com/github/gosow9/dobson\n\n",
"bugtrack_url": null,
"license": "AGPL-3.0-only",
"summary": "Dobson file parser",
"version": "0.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/dobson/issues",
"CI: Github Actions": "https://github.com/gosow9/dobson/actions",
"Changelog": "https://github.com/gosow9/dobson/blob/master/CHANGELOG.rst",
"Code of Conduct": "https://github.com/gosow9/dobson/blob/master/CONTRIBUTING.rst",
"Documentation": "https://dobson.readthedocs.io/",
"Homepage": "https://github.com/gosow9/dobson",
"Repository": "https://github.com/gosow9/dobson",
"Source Code": "https://github.com/gosow9/dobson"
},
"split_keywords": [
"python",
"package"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "06e806c342fccadfa7a83c21dc5d9de81d25aa18b4d134b2f74599b8d6c6bb4b",
"md5": "3c5374cdcdbb42ec92600b9dbb3e17ca",
"sha256": "6213a9a8aa94db9383db92aebe8839c2c04bd21d26947776f55f0e88938e32d2"
},
"downloads": -1,
"filename": "dobson-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c5374cdcdbb42ec92600b9dbb3e17ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 35844,
"upload_time": "2023-08-17T15:04:52",
"upload_time_iso_8601": "2023-08-17T15:04:52.151460Z",
"url": "https://files.pythonhosted.org/packages/06/e8/06c342fccadfa7a83c21dc5d9de81d25aa18b4d134b2f74599b8d6c6bb4b/dobson-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e8316a8017a0b297b80f8860f8220f95bbc3a5b8d7dc4c44621487adb89075a5",
"md5": "afb0cbb0856cc764d2f4b1b109d6ceff",
"sha256": "c8f9b08e4f15c7f797d90d93ed13adb96ad359417051ff552e414ed09c2748e8"
},
"downloads": -1,
"filename": "dobson-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "afb0cbb0856cc764d2f4b1b109d6ceff",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 23006,
"upload_time": "2023-08-17T15:04:55",
"upload_time_iso_8601": "2023-08-17T15:04:55.303158Z",
"url": "https://files.pythonhosted.org/packages/e8/31/6a8017a0b297b80f8860f8220f95bbc3a5b8d7dc4c44621487adb89075a5/dobson-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-17 15:04:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gosow9",
"github_project": "dobson",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"tox": true,
"lcname": "dobson"
}