| Name | cookiecutter-pdm JSON |
| Version |
0.0.3
JSON |
| download |
| home_page | |
| Summary | A python cookiecutter application to create a new python project that uses PDM to manage its dependencies. |
| upload_time | 2023-09-04 09:35:10 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | <4.0,>=3.8 |
| license | MIT |
| keywords |
cookiecutter
template
pdm
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<p align="center">
<img width="600" src="https://raw.githubusercontent.com/fpgmaas/cookiecutter-pdm/main/docs/static/cookiecutter.svg">
</p style = "margin-bottom: 2rem;">
---
[](https://pypi.org/project/cookiecutter-pdm/)
[](https://github.com/fpgmaas/cookiecutter-pdm/actions/workflows/main.yml?query=branch%3Amain)
[](https://pypi.org/project/cookiecutter-pdm/)
[](https://fpgmaas.github.io/cookiecutter-pdm/)
[](https://img.shields.io/github/license/fpgmaas/cookiecutter-pdm)
This is a modern Cookiecutter template that can be used to initiate a Python project with all the necessary tools for development, testing, and deployment. It supports the following features:
- [PDM](https://pdm.fming.dev/latest/) for dependency management
- CI/CD with [GitHub Actions](https://github.com/features/actions)
- Pre-commit hooks with [pre-commit](https://pre-commit.com/)
- Code quality with [black](https://pypi.org/project/black/), [ruff](https://github.com/charliermarsh/ruff), [mypy](https://mypy.readthedocs.io/en/stable/), and [deptry](https://github.com/fpgmaas/deptry/)
- Publishing to [Pypi](https://pypi.org) or [Artifactory](https://jfrog.com/artifactory) by creating a new release on GitHub
- Testing and coverage with [pytest](https://docs.pytest.org/en/7.1.x/) and [codecov](https://about.codecov.io/)
- Documentation with [MkDocs](https://www.mkdocs.org/)
- Compatibility testing for multiple versions of Python with [Tox](https://tox.wiki/en/latest/)
- Containerization with [Docker](https://www.docker.com/)
---
<p align="center">
<a href="https://fpgmaas.github.io/cookiecutter-pdm/">Documentation</a> - <a href="https://github.com/fpgmaas/cookiecutter-pdm-example">Example</a> -
<a href="https://pypi.org/project/cookiecutter-pdm/">PyPi</a>
</p>
---
## Quickstart
On your local machine, navigate to the directory in which you want to
create a project directory, and run the following two commands:
``` bash
pip install cookiecutter-pdm
ccpdm
```
Alternatively, install `cookiecutter` and directly pass the URL to this
Github repository to the `cookiecutter` command:
``` bash
pip install cookiecutter
cookiecutter https://github.com/fpgmaas/cookiecutter-pdm.git
```
Create a repository on GitHub, and then run the following commands, replacing `<project-name>`, with the name that you gave the Github repository and
`<github_author_handle>` with your Github username.
``` bash
cd <project_name>
git init -b main
git add .
git commit -m "Init commit"
git remote add origin git@github.com:<github_author_handle>/<project_name>.git
git push -u origin main
```
Finally, install the environment and the pre-commit hooks with
```bash
make install
```
You are now ready to start development on your project! The CI/CD
pipeline will be triggered when you open a pull request, merge to main,
or when you create a new release.
To finalize the set-up for publishing to PyPi or Artifactory, see
[here](https://fpgmaas.github.io/cookiecutter-pdm/features/publishing/#set-up-for-pypi).
For activating the automatic documentation with MkDocs, see
[here](https://fpgmaas.github.io/cookiecutter-pdm/features/mkdocs/#enabling-the-documentation-on-github).
To enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-pdm/features/codecov/).
## Acknowledgements
This project is partially based on [Audrey
Feldroy\'s](https://github.com/audreyfeldroy)\'s great
[cookiecutter-pypackage](https://github.com/audreyfeldroy/cookiecutter-pypackage)
repository.
Raw data
{
"_id": null,
"home_page": "",
"name": "cookiecutter-pdm",
"maintainer": "",
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": "",
"keywords": "cookiecutter template PDM",
"author": "",
"author_email": "Florian Maas <info@fpgmaas.com>",
"download_url": "https://files.pythonhosted.org/packages/1b/11/303272822dc7628f381aa38dc1dbe41220ad70a70c79fed272012bf83ab4/cookiecutter_pdm-0.0.3.tar.gz",
"platform": null,
"description": "\n\n<p align=\"center\">\n <img width=\"600\" src=\"https://raw.githubusercontent.com/fpgmaas/cookiecutter-pdm/main/docs/static/cookiecutter.svg\">\n</p style = \"margin-bottom: 2rem;\">\n\n---\n\n[](https://pypi.org/project/cookiecutter-pdm/)\n[](https://github.com/fpgmaas/cookiecutter-pdm/actions/workflows/main.yml?query=branch%3Amain)\n[](https://pypi.org/project/cookiecutter-pdm/)\n[](https://fpgmaas.github.io/cookiecutter-pdm/)\n[](https://img.shields.io/github/license/fpgmaas/cookiecutter-pdm)\n\n\nThis is a modern Cookiecutter template that can be used to initiate a Python project with all the necessary tools for development, testing, and deployment. It supports the following features:\n\n- [PDM](https://pdm.fming.dev/latest/) for dependency management\n- CI/CD with [GitHub Actions](https://github.com/features/actions)\n- Pre-commit hooks with [pre-commit](https://pre-commit.com/)\n- Code quality with [black](https://pypi.org/project/black/), [ruff](https://github.com/charliermarsh/ruff), [mypy](https://mypy.readthedocs.io/en/stable/), and [deptry](https://github.com/fpgmaas/deptry/)\n- Publishing to [Pypi](https://pypi.org) or [Artifactory](https://jfrog.com/artifactory) by creating a new release on GitHub\n- Testing and coverage with [pytest](https://docs.pytest.org/en/7.1.x/) and [codecov](https://about.codecov.io/)\n- Documentation with [MkDocs](https://www.mkdocs.org/)\n- Compatibility testing for multiple versions of Python with [Tox](https://tox.wiki/en/latest/)\n- Containerization with [Docker](https://www.docker.com/)\n\n---\n<p align=\"center\">\n <a href=\"https://fpgmaas.github.io/cookiecutter-pdm/\">Documentation</a> - <a href=\"https://github.com/fpgmaas/cookiecutter-pdm-example\">Example</a> -\n <a href=\"https://pypi.org/project/cookiecutter-pdm/\">PyPi</a>\n</p>\n\n---\n\n\n## Quickstart\n\nOn your local machine, navigate to the directory in which you want to\ncreate a project directory, and run the following two commands:\n\n``` bash\npip install cookiecutter-pdm\nccpdm\n```\n\nAlternatively, install `cookiecutter` and directly pass the URL to this\nGithub repository to the `cookiecutter` command:\n\n``` bash\npip install cookiecutter\ncookiecutter https://github.com/fpgmaas/cookiecutter-pdm.git\n```\n\nCreate a repository on GitHub, and then run the following commands, replacing `<project-name>`, with the name that you gave the Github repository and\n`<github_author_handle>` with your Github username.\n\n``` bash\ncd <project_name>\ngit init -b main\ngit add .\ngit commit -m \"Init commit\"\ngit remote add origin git@github.com:<github_author_handle>/<project_name>.git\ngit push -u origin main\n```\n\nFinally, install the environment and the pre-commit hooks with\n\n ```bash\n make install\n ```\n\nYou are now ready to start development on your project! The CI/CD\npipeline will be triggered when you open a pull request, merge to main,\nor when you create a new release.\n\nTo finalize the set-up for publishing to PyPi or Artifactory, see\n[here](https://fpgmaas.github.io/cookiecutter-pdm/features/publishing/#set-up-for-pypi).\nFor activating the automatic documentation with MkDocs, see\n[here](https://fpgmaas.github.io/cookiecutter-pdm/features/mkdocs/#enabling-the-documentation-on-github).\nTo enable the code coverage reports, see [here](https://fpgmaas.github.io/cookiecutter-pdm/features/codecov/).\n\n## Acknowledgements\n\nThis project is partially based on [Audrey\nFeldroy\\'s](https://github.com/audreyfeldroy)\\'s great\n[cookiecutter-pypackage](https://github.com/audreyfeldroy/cookiecutter-pypackage)\nrepository.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python cookiecutter application to create a new python project that uses PDM to manage its dependencies.",
"version": "0.0.3",
"project_urls": {
"Documentation": "https://fpgmaas.github.io/cookiecutter-pdm/",
"Homepage": "https://fpgmaas.github.io/cookiecutter-pdm/",
"Repository": "https://github.com/fpgmaas/cookiecutter-pdm"
},
"split_keywords": [
"cookiecutter",
"template",
"pdm"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "db9e1729ee750c337d7be63e3e43b4c768ddf30ecfc2bb3468810d428dad0d1c",
"md5": "d92c0bfe0b0b5ec41be70b0e38012744",
"sha256": "52375553ee52d814bf77e7d0879c2a18855183fa1a6fef636fc330b9412fff9f"
},
"downloads": -1,
"filename": "cookiecutter_pdm-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d92c0bfe0b0b5ec41be70b0e38012744",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 4093,
"upload_time": "2023-09-04T09:35:09",
"upload_time_iso_8601": "2023-09-04T09:35:09.192648Z",
"url": "https://files.pythonhosted.org/packages/db/9e/1729ee750c337d7be63e3e43b4c768ddf30ecfc2bb3468810d428dad0d1c/cookiecutter_pdm-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1b11303272822dc7628f381aa38dc1dbe41220ad70a70c79fed272012bf83ab4",
"md5": "93f432cf794dcb2c93b1888a194ef606",
"sha256": "bddc176f30568d9982770bcc5dfbda3ec53958ab347f60d658d46fa1f91aa199"
},
"downloads": -1,
"filename": "cookiecutter_pdm-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "93f432cf794dcb2c93b1888a194ef606",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 12720,
"upload_time": "2023-09-04T09:35:10",
"upload_time_iso_8601": "2023-09-04T09:35:10.881303Z",
"url": "https://files.pythonhosted.org/packages/1b/11/303272822dc7628f381aa38dc1dbe41220ad70a70c79fed272012bf83ab4/cookiecutter_pdm-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-04 09:35:10",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fpgmaas",
"github_project": "cookiecutter-pdm",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "cookiecutter-pdm"
}
