https://github.com/fpgmaas/cookiecutter-pdm-example

An example of a project generated with cookiecutter-pdm.
https://github.com/fpgmaas/cookiecutter-pdm-example

Last synced: 6 months ago
JSON representation

An example of a project generated with cookiecutter-pdm.

• Host: GitHub
• URL: https://github.com/fpgmaas/cookiecutter-pdm-example
• Owner: fpgmaas
• License: mit
• Created: 2023-09-04T08:41:28.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-09-05T10:36:46.000Z (almost 3 years ago)
• Last Synced: 2025-04-05T00:25:40.353Z (over 1 year ago)
• Language: Makefile
• Homepage: https://fpgmaas.github.io/cookiecutter-pdm/
• Size: 32.2 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
# cookiecutter-pdm-example

[![Release](https://img.shields.io/github/v/release/fpgmaas/cookiecutter-pdm-example)](https://img.shields.io/github/v/release/fpgmaas/cookiecutter-pdm-example)

[![Build status](https://img.shields.io/github/actions/workflow/status/fpgmaas/cookiecutter-pdm-example/main.yml?branch=main)](https://github.com/fpgmaas/cookiecutter-pdm-example/actions/workflows/main.yml?query=branch%3Amain)

[![codecov](https://codecov.io/gh/fpgmaas/cookiecutter-pdm-example/branch/main/graph/badge.svg)](https://codecov.io/gh/fpgmaas/cookiecutter-pdm-example)

[![Commit activity](https://img.shields.io/github/commit-activity/m/fpgmaas/cookiecutter-pdm-example)](https://img.shields.io/github/commit-activity/m/fpgmaas/cookiecutter-pdm-example)

[![License](https://img.shields.io/github/license/fpgmaas/cookiecutter-pdm-example)](https://img.shields.io/github/license/fpgmaas/cookiecutter-pdm-example)

This is a template repository for Python projects that use PDM for their dependency management.

- **Github repository**: 

- **Documentation** 

## Getting started with your project

First, create a repository on GitHub with the same name as this project, and then run the following commands:

``` bash

git init -b main

git add .

git commit -m "init commit"

git remote add origin git@github.com:fpgmaas/cookiecutter-pdm-example.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/).

## Releasing a new version

- Create an API Token on [Pypi](https://pypi.org/).

- Add the API Token to your projects secrets with the name `PYPI_TOKEN` by visiting

[this page](https://github.com/fpgmaas/cookiecutter-pdm-example/settings/secrets/actions/new).

- Create a [new release](https://github.com/fpgmaas/cookiecutter-pdm-example/releases/new) on Github.

Create a new tag in the form ``*.*.*``.

For more details, see [here](https://fpgmaas.github.io/cookiecutter-pdm/features/cicd/#how-to-trigger-a-release).

---

Repository initiated with [fpgmaas/cookiecutter-pdm](https://github.com/fpgmaas/cookiecutter-pdm).