generated from febus982/bootstrap-python-package
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
11 changed files
with
22 additions
and
159 deletions.
There are no files selected for viewing
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
2 changes: 1 addition & 1 deletion
2
.idea/bootstrap-python-package.iml → .idea/mkdocs-macros-adr-summary.iml
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,75 +1 @@ | ||
| # bootstrap-python-package | ||
|
|
||
| This template repository provides the boilerplate to create a python package. | ||
| It is configured with all the following features: | ||
|
|
||
| * Test suite using [pytest](https://docs.pytest.org/en/7.4.x/) | ||
| * Typing using [mypy](https://mypy.readthedocs.io/en/stable/) | ||
| * Linting using [ruff](https://github.com/astral-sh/ruff) | ||
| * Code formatter using [black](https://pypi.org/project/black/) | ||
| * Security checks using [bandit](https://github.com/PyCQA/bandit) | ||
| * Integration with CodeClimate for code quality and coverage checks | ||
| * CI pipeline supporting: | ||
| * testing against multiple python versions | ||
| * releases on [PyPI](https://pypi.org) | ||
| * GitHub pages documentation using [mkdocs](https://www.mkdocs.org) | ||
|
|
||
| This project doesn't currently use [tox](https://tox.wiki/en/4.11.4/index.html) or other matrix | ||
| testing utilities. I prefer to run the tests only against the latest python locally, and run | ||
| previous python versions directly in the CI pipeline. | ||
|
|
||
| ## How to use this repository template to create a new package | ||
|
|
||
| * Create your github repository using this template. (The big green `Use this template` button) | ||
| * Rename the `bootstrap_python_package` directory | ||
| * Search and replace all the occurrences of `bootstrap-python-package` and `bootstrap_python_package` | ||
| * Configure a pending trusted publisher on [pypi](https://pypi.org/manage/account/publishing) using the following values: | ||
| * PyPI Project Name: what you renamed the directory `bootstrap_python_package` to (Double check `_` and `-`) | ||
| * Owner: The github repository owner (in this case `febus982`) | ||
| * Repository name: The github repository name (in this case `bootstrap-python-package`) | ||
| * Workflow name: `release.yml` | ||
| * Create a GitHub Actions secret named `CODECLIMATE_REPORTER_ID` (at URL `https://github.com/GITHUB_NAME_OR_ORGANIZATION/GITHUB_REPOSITORY/settings/secrets/actions`) | ||
| containing the codeclimate reporter id (you can find it at `https://codeclimate.com/repos/YOUR_REPO_ID/settings/test_reporter`). | ||
| If you don't want to use CodeClimate just delete `workflows/python-quality.yml`. | ||
| * Update the badges in `README.md`! (check [shields.io](https://shields.io/) for extra badges) | ||
| * Setup local development: | ||
| * Clone the repository | ||
| * Install poetry `pip install poetry` | ||
| * Install dev dependencies with `make dev-dependencies` | ||
| * Setup GitHub pages (this need local development setup): | ||
| * Initialise documentation branch `poetry run mike deploy dev latest --update-aliases --push` | ||
| * Configure GitHub Pages to deploy from the `gh-pages` branch (at URL `https://github.com/GITHUB_NAME_OR_ORGANIZATION/GITHUB_REPOSITORY/settings/pages`) | ||
| * Add the `main` branch and the `v*.*.*` tag rules to the "deployment branches and tags" list in the `gh-pages` environment (at URL `https://github.com/GITHUB_NAME_OR_ORGANIZATION/GITHUB_REPOSITORY/settings/environments`) | ||
|
|
||
| **IMPORTANT:** The repository is configured to deploy on the [test PyPI repository](https://test.pypi.org/). | ||
| It's strongly recommended to create the project in the [test PyPI repository](https://test.pypi.org/) and test | ||
| the deployment pipeline. When you're happy with the result, create the project on the official [PyPI repository](https://pypi.org/) | ||
| and remove the marked lines in `workflows/release.yml`. | ||
|
|
||
| ## Package release | ||
|
|
||
| This setup uses [poetry-dynamic-versioning](https://github.com/mtkennerly/poetry-dynamic-versioning). | ||
| This means it's not necessary to commit the version in the code but the CI pipeline | ||
| will infer it from the git tag. | ||
|
|
||
| To release a new version, just create a new release and tag in the GitHub repository, to: | ||
|
|
||
| * Build and deploy the python package to PyPI | ||
| * Build and deploy a new version of the documentation to GitHub pages | ||
|
|
||
| **IMPORTANT:** The default configuration requires the release name and the tag to follow | ||
| the convention `vX.X.X` (semantic versioning preceded by lowercase `v`). It will publish | ||
| the correct version on Pypi, omitting the `v` (ie. `v1.0.0` will publish `1.0.0`). | ||
|
|
||
| This format can be customized, refer to [poetry-dynamic-versioning docs](https://github.com/mtkennerly/poetry-dynamic-versioning) | ||
|
|
||
| ## Commands for development | ||
|
|
||
| All the common commands used during development can be run using make targets: | ||
|
|
||
| * `make dev-dependencies`: Install dev requirements | ||
| * `make update-dependencies`: Update dev requirements | ||
| * `make test`: Run test suite | ||
| * `make check`: Run tests, code style and lint checks | ||
| * `make fix`: Run code style and lint automatic fixes (where possible) | ||
| * `make docs`: Render the mkdocs website locally | ||
| # mkdocs-macros-adr-summary |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,13 +1,13 @@ | ||
| [tool.poetry] | ||
| name = "bootstrap-python-package" | ||
| name = "mkdocs-macros-adr-summary" | ||
| version = "0.0.0" | ||
| description = "A manager to easily handle multiple SQLAlchemy configurations" | ||
| license = "MIT" | ||
| authors = ["Federico Busetti <[email protected]>"] | ||
| repository = "https://github.com/febus982/bootstrap-python-package" | ||
| homepage = "https://febus982.github.io/bootstrap-python-package" | ||
| repository = "https://github.com/febus982/mkdocs-macros-adr-summary" | ||
| homepage = "https://febus982.github.io/mkdocs-macros-adr-summary" | ||
| readme = "README.md" | ||
| packages = [{include = "bootstrap_python_package"}] | ||
| packages = [{include = "mkdocs_macros_adr_summary"}] | ||
| #keywords = ["add", "keywords", "here"] | ||
| classifiers = [ | ||
| "Development Status :: 4 - Beta", | ||
|
|
@@ -65,11 +65,11 @@ testpaths = [ | |
| ] | ||
|
|
||
| [tool.mypy] | ||
| files = "bootstrap_python_package" | ||
| files = "mkdocs_macros_adr_summary" | ||
|
|
||
| [tool.coverage.run] | ||
| branch = true | ||
| source = ["bootstrap_python_package"] | ||
| source = ["mkdocs_macros_adr_summary"] | ||
| concurrency = ["multiprocessing"] | ||
| parallel = true | ||
|
|
||
|
|
@@ -91,7 +91,7 @@ extend-exclude = ["docs"] | |
| [tool.black] | ||
| files = ''' | ||
| ( | ||
| bootstrap_python_package | ||
| mkdocs_macros_adr_summary | ||
| tests | ||
| ) | ||
| ''' | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters