===============================
Cookiecutter Namespace Template
===============================
`Cookiecutter <https://github.com/cookiecutter/cookiecutter>`_ Namespace
Template for a Python package.
|Downloads| |Updates| |Versions| |Contributors| |License| |pre-commit.ci status| |Docs|
.. |Downloads| image:: https://pepy.tech/badge/cookiecutter-namespace-template
:target: https://pepy.tech/project/cookiecutter-namespace-template
.. |Updates| image:: https://pyup.io/repos/github/veit/cookiecutter-namespace-template/shield.svg
:target: https://pyup.io/repos/github/veit/cookiecutter-namespace-template/
.. |Versions| image:: https://img.shields.io/pypi/pyversions/cookiecutter-namespace-template.svg
:target: https://pypi.org/project/cookiecutter-namespace-template/
.. |Contributors| image:: https://img.shields.io/github/contributors/veit/cookiecutter-namespace-template.svg
:target: https://github.com/veit/cookiecutter-namespace-template/graphs/contributors
.. |License| image:: https://img.shields.io/github/license/veit/cookiecutter-namespace-template.svg
:target: https://github.com/veit/cookiecutter-namespace-template/blob/main/LICENSE
.. |pre-commit.ci status| image:: https://results.pre-commit.ci/badge/github/veit/cookiecutter-namespace-template/main.svg
:target: https://results.pre-commit.ci/latest/github/veit/cookiecutter-namespace-template/main
.. |Docs| image:: https://readthedocs.org/projects/cookiecutter-namespace-template/badge/?version=latest
:target: https://cookiecutter-namespace-template.readthedocs.io/en/latest/
Features
--------
.. Keep python versions of tox in sync with tox.ini.
* Testing setup with ``unittest`` or ``pytest``
* `Tox <https://tox.wiki/en/latest/>`_ testing: Setup to easily test for Python
3.8, 3.9, 3.10, 3.11, 3.12 and pypy.
* `Sphinx <http://www.sphinx-doc.org/>`_ docs: Documentation ready for
generation with, for example, ReadTheDocs_
* `bump2version <https://github.com/c4urself/bump2version>`_: Pre-configured
version bumping with a single command
* If the `cookiecutter-namespace-template
<https://github.com/veit/cookiecutter-namespace-template>`_ project template
has been changed, you can apply these changes with
.. code-block:: console
$ cruft update
* Optional auto-release to `PyPI <https://pypi.org/>`_ when you push a new tag
to main (optional)
* Optional command line interface using `Typer <https://typer.tiangolo.com>`_ or
`Click <https://palletsprojects.com/p/click/>`_
If you really want to create a new package with Python 2, in spite of the
`Python 2.7 countdown <https://pythonclock.org/>`_ and the `Sunsetting Python 2
support <https://python3statement.org/>`_, then use
``cookiecutter-namespace-template`` <0.2.
Quickstart
----------
#. Install the latest Cookiecutter if you haven’t installed it yet (this
requires Cookiecutter 1.4.0 or higher):
.. code-block:: console
$ python -m pip install -U cruft
#. Generate a Python package project:
.. code-block:: console
$ python -m cruft create https://github.com/veit/cookiecutter-namespace-template.git
#. Create a repo and put it there.
#. `Register <https://pypi.org/account/register/>`_ your project with PyPI.
#. Add the repo to your `ReadTheDocs <https://readthedocs.io/>`_ account and
turn on the ReadTheDocs service hook.
#. If you want to add the pyup badge to your README file
#. create a new account at `pyup.io <https://pyup.io>`_ or log into your
existing account
#. click on the green *Add Repo* button
#. click *Pin* to add the repo
#. Release your package by pushing a new tag to main.
Pull requests
~~~~~~~~~~~~~
If you have differences in your preferred setup, I encourage you to fork this
to create your own version. I also accept pull requests on this, if they’re
small, atomic, and if they make my own packaging experience better.
Raw data
{
"_id": null,
"home_page": null,
"name": "cookiecutter-namespace-template",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cookiecutter, package, template",
"author": null,
"author_email": "Veit Schiele <veit@cusy.io>",
"download_url": "https://files.pythonhosted.org/packages/3b/0f/74fb9a7fd028c90b19ea888edb5a2e9a056054a7d4d43f5a0f2f81ad3467/cookiecutter_namespace_template-24.1.0.tar.gz",
"platform": null,
"description": "===============================\nCookiecutter Namespace Template\n===============================\n\n`Cookiecutter <https://github.com/cookiecutter/cookiecutter>`_ Namespace\nTemplate for a Python package.\n\n|Downloads| |Updates| |Versions| |Contributors| |License| |pre-commit.ci status| |Docs|\n\n.. |Downloads| image:: https://pepy.tech/badge/cookiecutter-namespace-template\n :target: https://pepy.tech/project/cookiecutter-namespace-template\n.. |Updates| image:: https://pyup.io/repos/github/veit/cookiecutter-namespace-template/shield.svg\n :target: https://pyup.io/repos/github/veit/cookiecutter-namespace-template/\n.. |Versions| image:: https://img.shields.io/pypi/pyversions/cookiecutter-namespace-template.svg\n :target: https://pypi.org/project/cookiecutter-namespace-template/\n.. |Contributors| image:: https://img.shields.io/github/contributors/veit/cookiecutter-namespace-template.svg\n :target: https://github.com/veit/cookiecutter-namespace-template/graphs/contributors\n.. |License| image:: https://img.shields.io/github/license/veit/cookiecutter-namespace-template.svg\n :target: https://github.com/veit/cookiecutter-namespace-template/blob/main/LICENSE\n.. |pre-commit.ci status| image:: https://results.pre-commit.ci/badge/github/veit/cookiecutter-namespace-template/main.svg\n :target: https://results.pre-commit.ci/latest/github/veit/cookiecutter-namespace-template/main\n.. |Docs| image:: https://readthedocs.org/projects/cookiecutter-namespace-template/badge/?version=latest\n :target: https://cookiecutter-namespace-template.readthedocs.io/en/latest/\n\nFeatures\n--------\n\n.. Keep python versions of tox in sync with tox.ini.\n\n* Testing setup with ``unittest`` or ``pytest``\n* `Tox <https://tox.wiki/en/latest/>`_ testing: Setup to easily test for Python\n 3.8, 3.9, 3.10, 3.11, 3.12 and pypy.\n* `Sphinx <http://www.sphinx-doc.org/>`_ docs: Documentation ready for\n generation with, for example, ReadTheDocs_\n* `bump2version <https://github.com/c4urself/bump2version>`_: Pre-configured\n version bumping with a single command\n* If the `cookiecutter-namespace-template\n <https://github.com/veit/cookiecutter-namespace-template>`_ project template\n has been changed, you can apply these changes with\n\n .. code-block:: console\n\n $ cruft update\n\n* Optional auto-release to `PyPI <https://pypi.org/>`_ when you push a new tag\n to main (optional)\n* Optional command line interface using `Typer <https://typer.tiangolo.com>`_ or\n `Click <https://palletsprojects.com/p/click/>`_\n\nIf you really want to create a new package with Python 2, in spite of the\n`Python 2.7 countdown <https://pythonclock.org/>`_ and the `Sunsetting Python 2\nsupport <https://python3statement.org/>`_, then use\n``cookiecutter-namespace-template`` <0.2.\n\nQuickstart\n----------\n\n#. Install the latest Cookiecutter if you haven\u2019t installed it yet (this\n requires Cookiecutter 1.4.0 or higher):\n\n .. code-block:: console\n\n $ python -m pip install -U cruft\n\n#. Generate a Python package project:\n\n .. code-block:: console\n\n $ python -m cruft create https://github.com/veit/cookiecutter-namespace-template.git\n\n#. Create a repo and put it there.\n\n#. `Register <https://pypi.org/account/register/>`_ your project with PyPI.\n\n#. Add the repo to your `ReadTheDocs <https://readthedocs.io/>`_ account and\n turn on the ReadTheDocs service hook.\n\n#. If you want to add the pyup badge to your README file\n\n #. create a new account at `pyup.io <https://pyup.io>`_ or log into your\n existing account\n #. click on the green *Add Repo* button\n #. click *Pin* to add the repo\n\n#. Release your package by pushing a new tag to main.\n\nPull requests\n~~~~~~~~~~~~~\n\nIf you have differences in your preferred setup, I encourage you to fork this\nto create your own version. I also accept pull requests on this, if they\u2019re\nsmall, atomic, and if they make my own packaging experience better.\n",
"bugtrack_url": null,
"license": null,
"summary": "Cookiecutter template for a Python namespace package",
"version": "24.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/veit/cookiecutter-namespace-template/issues",
"Documentation": "https://cookiecutter-namespace-template.readthedocs.io/",
"Source Code": "https://github.com/veit/cookiecutter-namespace-template"
},
"split_keywords": [
"cookiecutter",
" package",
" template"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "379a32ec14a645fa50d82fe94a246ffdf9a89b8298b9bdabf0510b3b4bc17731",
"md5": "a2240c1e3080c32b5012951ad925ca9b",
"sha256": "0161496fd5865be9e2311ef5efae499b1254195b416762b0c709d4fb62d13938"
},
"downloads": -1,
"filename": "cookiecutter_namespace_template-24.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a2240c1e3080c32b5012951ad925ca9b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 53017,
"upload_time": "2024-06-30T10:45:59",
"upload_time_iso_8601": "2024-06-30T10:45:59.927375Z",
"url": "https://files.pythonhosted.org/packages/37/9a/32ec14a645fa50d82fe94a246ffdf9a89b8298b9bdabf0510b3b4bc17731/cookiecutter_namespace_template-24.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3b0f74fb9a7fd028c90b19ea888edb5a2e9a056054a7d4d43f5a0f2f81ad3467",
"md5": "64df151ba7faad66cf1ab7a10a22d259",
"sha256": "bab6e1125bd6bc2872c0da54062ec7626d493eafbb8e5e085c86b391b18d7937"
},
"downloads": -1,
"filename": "cookiecutter_namespace_template-24.1.0.tar.gz",
"has_sig": false,
"md5_digest": "64df151ba7faad66cf1ab7a10a22d259",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 32052,
"upload_time": "2024-06-30T10:46:01",
"upload_time_iso_8601": "2024-06-30T10:46:01.713790Z",
"url": "https://files.pythonhosted.org/packages/3b/0f/74fb9a7fd028c90b19ea888edb5a2e9a056054a7d4d43f5a0f2f81ad3467/cookiecutter_namespace_template-24.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-30 10:46:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "veit",
"github_project": "cookiecutter-namespace-template",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "cookiecutter-namespace-template"
}