{"id":20925336,"url":"https://github.com/apehex/cookiecutter-pypi","last_synced_at":"2025-10-18T10:20:07.988Z","repository":{"id":111756132,"uuid":"294453172","full_name":"apehex/cookiecutter-pypi","owner":"apehex","description":":snake: Cookiecutter template for a Python package, streamlined","archived":false,"fork":false,"pushed_at":"2025-01-16T10:36:35.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-16T12:11:35.357Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apehex.png","metadata":{"files":{"readme":".github/README.rst","changelog":null,"contributing":".github/CONTRIBUTING.rst","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-10T15:45:28.000Z","updated_at":"2025-01-16T10:36:41.000Z","dependencies_parsed_at":"2023-04-12T04:46:52.327Z","dependency_job_id":null,"html_url":"https://github.com/apehex/cookiecutter-pypi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apehex%2Fcookiecutter-pypi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apehex%2Fcookiecutter-pypi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apehex%2Fcookiecutter-pypi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apehex%2Fcookiecutter-pypi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apehex","download_url":"https://codeload.github.com/apehex/cookiecutter-pypi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243318758,"owners_count":20272144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T20:31:24.428Z","updated_at":"2025-10-18T10:20:07.934Z","avatar_url":"https://github.com/apehex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"======================\nCookiecutter PyPackage\n======================\n\n.. image:: https://pyup.io/repos/github/audreyfeldroy/cookiecutter-pypackage/shield.svg\n    :target: https://pyup.io/repos/github/audreyfeldroy/cookiecutter-pypackage/\n    :alt: Updates\n\n.. image:: https://travis-ci.org/audreyfeldroy/cookiecutter-pypackage.svg?branch=master\n    :target: https://travis-ci.org/github/audreyfeldroy/cookiecutter-pypackage\n    :alt: Build Status\n\n.. image:: https://readthedocs.org/projects/cookiecutter-pypackage/badge/?version=latest\n    :target: https://cookiecutter-pypackage.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n\nCookiecutter_ template for a Python package. Light, tidy and up-to-date!\n\n* Repository: https://github.com/apehex/cookiecutter-pypi/\n* License: MIT\n\nFeatures\n--------\n\n* Testing setup with ``unittest``\n* Travis-CI_: Ready for Travis Continuous Integration testing\n* Tox_ testing: Setup to easily test for Python 3.5, 3.6, 3.7, 3.8\n* Sphinx_ docs: Documentation ready for generation with, for example, `Read the Docs`_\n* bump2version_: Pre-configured version bumping with a single command\n* Auto-release to PyPI_ when you push a new tag to master (optional)\n* Command line interface using argparse\n\n.. _Cookiecutter: https://github.com/cookiecutter/cookiecutter\n\nBuild Status\n-------------\n\nLinux:\n\n.. image:: https://img.shields.io/travis/apehex/cookiecutter-pypackage.svg\n    :target: https://travis-ci.org/apehex/cookiecutter-pypackage\n    :alt: Linux build status on Travis CI\n\nWindows:\n\n.. image:: https://ci.appveyor.com/api/projects/status/github/apehex/cookiecutter-pypackage?branch=master\u0026svg=true\n    :target: https://ci.appveyor.com/project/apehex/cookiecutter-pypackage/branch/master\n    :alt: Windows build status on Appveyor\n\nQuickstart\n----------\n\nInstall the latest Cookiecutter if you haven't installed it yet (this requires\nCookiecutter 1.4.0 or higher)::\n\n    pip install -U cookiecutter\n\nGenerate a Python package project::\n\n    cookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage.git\n\nThen:\n\n* Create a repo and put it there.\n* Add the repo to your Travis-CI_ account.\n* Install the dev requirements into a virtualenv. (``pip install -r requirements_dev.txt``)\n* Register_ your project with PyPI.\n* Run the Travis CLI command ``travis encrypt --add deploy.password`` to encrypt your PyPI password in Travis config\n  and activate automated deployment on PyPI when you push a new tag to master branch.\n* Add the repo to your `Read the Docs`_ account + turn on the Read the Docs service hook.\n* Release your package by pushing a new tag to master.\n* Add a ``requirements.txt`` file that specifies the packages you will need for\n  your project and their versions. For more info see the `pip docs for requirements files`_.\n* Activate your project on `pyup.io`_.\n\n.. _`pip docs for requirements files`: https://pip.pypa.io/en/stable/user_guide/#requirements-files\n.. _Register: https://packaging.python.org/tutorials/packaging-projects/#uploading-the-distribution-archives\n\nFor more details, see the `cookiecutter-pypackage tutorial`_.\n\n.. _`cookiecutter-pypackage tutorial`: https://cookiecutter-pypackage.readthedocs.io/en/latest/tutorial.html\n\nNot Exactly What You Want?\n--------------------------\n\nDon't worry, you have options:\n\nSimilar Cookiecutter Templates\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n* `Nekroze/cookiecutter-pypackage`_: A fork of this with a PyTest test runner,\n  strict flake8 checking with Travis/Tox, and some docs and ``setup.py`` differences.\n\n* `tony/cookiecutter-pypackage-pythonic`_: Fork with py2.7+3.3 optimizations.\n  Flask/Werkzeug-style test runner, ``_compat`` module and module/doc conventions.\n  See ``README.rst`` or the `github comparison view`_ for exhaustive list of\n  additions and modifications.\n\n* `ardydedase/cookiecutter-pypackage`_: A fork with separate requirements files rather than a requirements list in the ``setup.py`` file.\n\n* `lgiordani/cookiecutter-pypackage`_: A fork of Cookiecutter that uses Punch_ instead of bump2version_ and with separate requirements files.\n\n* `briggySmalls/cookiecutter-pypackage`_: A fork using Poetry_ for neat package management and deployment, with linting, formatting, no makefiles and more.\n\n* Also see the `network`_ and `family tree`_ for this repo. (If you find\n  anything that should be listed here, please add it and send a pull request!)\n\nFork This / Create Your Own\n~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIf you have differences in your preferred setup, I encourage you to fork this\nto create your own version. Or create your own; it doesn't strictly have to\nbe a fork.\n\n* Once you have your own version working, add it to the Similar Cookiecutter\n  Templates list above with a brief description.\n\n* It's up to you whether or not to rename your fork/own version. Do whatever\n  you think sounds good.\n\nOr Submit a Pull Request\n~~~~~~~~~~~~~~~~~~~~~~~~\n\nI also accept pull requests on this, if they're small, atomic, and if they\nmake my own packaging experience better.\n\n\n.. _Travis-CI: http://travis-ci.org/\n.. _Tox: http://testrun.org/tox/\n.. _Sphinx: http://sphinx-doc.org/\n.. _Read the Docs: https://readthedocs.io/\n.. _`pyup.io`: https://pyup.io/\n.. _bump2version: https://github.com/c4urself/bump2version\n.. _Punch: https://github.com/lgiordani/punch\n.. _Poetry: https://python-poetry.org/\n.. _PyPi: https://pypi.python.org/pypi\n\n.. _`Nekroze/cookiecutter-pypackage`: https://github.com/Nekroze/cookiecutter-pypackage\n.. _`tony/cookiecutter-pypackage-pythonic`: https://github.com/tony/cookiecutter-pypackage-pythonic\n.. _`ardydedase/cookiecutter-pypackage`: https://github.com/ardydedase/cookiecutter-pypackage\n.. _`lgiordani/cookiecutter-pypackage`: https://github.com/lgiordani/cookiecutter-pypackage\n.. _`briggySmalls/cookiecutter-pypackage`: https://github.com/briggySmalls/cookiecutter-pypackage\n.. _github comparison view: https://github.com/tony/cookiecutter-pypackage-pythonic/compare/audreyr:master...master\n.. _`network`: https://github.com/audreyr/cookiecutter-pypackage/network\n.. _`family tree`: https://github.com/audreyr/cookiecutter-pypackage/network/members\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapehex%2Fcookiecutter-pypi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapehex%2Fcookiecutter-pypi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapehex%2Fcookiecutter-pypi/lists"}