# Frequenz Repository Configuration
[](https://github.com/frequenz-floss/frequenz-repo-config-python/actions/workflows/ci.yaml)
[](https://pypi.org/project/frequenz-repo-config/)
[](https://frequenz-floss.github.io/frequenz-repo-config-python/)
## Introduction
This is a highly opinionated set of tools and configurations to set up a Python
repository for [Frequenz](https://frequenz.com) projects.
It offers:
* [Cookiecutter] templates for scaffolding new projects
* Trivial build of `noxfile.py` with some predefined sessions that include all
common checks.
* Tools to build protobuf/grpc files as Python, including type information.
## Quick Example
To start a new project, you should first [install
Cookiecutter](https://cookiecutter.readthedocs.io/en/stable/installation.html).
It is normally available in any Linux distribution, but some have a very old
version (for example, Ubuntu/Debian). You can [check which version your distro
has on Repology](https://repology.org/project/cookiecutter/versions). You need
**at least version 2.1.0**. To ensure you get an up-to-date version, you can
always use `pip` and install it in a `venv`:
```console
$ python -m venv cookiecutter
$ cd cookiecutter
$ . bin/activate
(venv) $ pip install cookiecutter
Collecting cookiecutter
...
```
Then simply run [Cookiecutter] where you want to create the new project. A new
directory will be created with the generated project name. For example:
```sh
cd ~/devel
cookiecutter gh:frequenz-floss/frequenz-repo-config-python \
--directory=cookiecutter \
--checkout v0.6.2
```
This command will prompt you for the project type, name, and other
configuration options, and it will generate the entire project for you.
After completing the project and fixing the `TODO`s, you can either amend the
previous commit using `git commit --amend` or create a new commit for the
changes using `git commit`.
## Documentation
For more detailed documentation, please check the [project's
website](https://frequenz-floss.github.io/frequenz-repo-config-python/).
## Contributing
If you want to know how to build this project and contribute to it, please
refer to the [Contributing Guide](CONTRIBUTING.md).
[Cookiecutter]: https://cookiecutter.readthedocs.io/en/stable
Raw data
{
"_id": null,
"home_page": "",
"name": "frequenz-repo-config",
"maintainer": "",
"docs_url": null,
"requires_python": "<4,>=3.11",
"maintainer_email": "",
"keywords": "config,frequenz,grpc,lib,library,mkdocs,nox,project,protobuf,python,repo-config,repository,setuptools,tool",
"author": "",
"author_email": "Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>",
"download_url": "https://files.pythonhosted.org/packages/e8/e6/d3d6ab554bef1422911956f5dd63fd620042559b6d846f877354eca3b441/frequenz-repo-config-0.6.2.tar.gz",
"platform": null,
"description": "# Frequenz Repository Configuration\n\n[](https://github.com/frequenz-floss/frequenz-repo-config-python/actions/workflows/ci.yaml)\n[](https://pypi.org/project/frequenz-repo-config/)\n[](https://frequenz-floss.github.io/frequenz-repo-config-python/)\n\n## Introduction\n\nThis is a highly opinionated set of tools and configurations to set up a Python\nrepository for [Frequenz](https://frequenz.com) projects.\n\nIt offers:\n\n* [Cookiecutter] templates for scaffolding new projects\n* Trivial build of `noxfile.py` with some predefined sessions that include all\n common checks.\n* Tools to build protobuf/grpc files as Python, including type information.\n\n## Quick Example\n\nTo start a new project, you should first [install\nCookiecutter](https://cookiecutter.readthedocs.io/en/stable/installation.html).\nIt is normally available in any Linux distribution, but some have a very old\nversion (for example, Ubuntu/Debian). You can [check which version your distro\nhas on Repology](https://repology.org/project/cookiecutter/versions). You need\n**at least version 2.1.0**. To ensure you get an up-to-date version, you can\nalways use `pip` and install it in a `venv`:\n\n```console\n$ python -m venv cookiecutter\n$ cd cookiecutter\n$ . bin/activate\n(venv) $ pip install cookiecutter\nCollecting cookiecutter\n...\n```\n\nThen simply run [Cookiecutter] where you want to create the new project. A new\ndirectory will be created with the generated project name. For example:\n\n```sh\ncd ~/devel\ncookiecutter gh:frequenz-floss/frequenz-repo-config-python \\\n --directory=cookiecutter \\\n --checkout v0.6.2\n```\n\nThis command will prompt you for the project type, name, and other\nconfiguration options, and it will generate the entire project for you.\n\nAfter completing the project and fixing the `TODO`s, you can either amend the\nprevious commit using `git commit --amend` or create a new commit for the\nchanges using `git commit`.\n\n## Documentation\n\nFor more detailed documentation, please check the [project's\nwebsite](https://frequenz-floss.github.io/frequenz-repo-config-python/).\n\n## Contributing\n\nIf you want to know how to build this project and contribute to it, please\nrefer to the [Contributing Guide](CONTRIBUTING.md).\n\n\n[Cookiecutter]: https://cookiecutter.readthedocs.io/en/stable\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Frequenz repository setup tools and common configuration",
"version": "0.6.2",
"project_urls": {
"Changelog": "https://github.com/frequenz-floss/frequenz-repo-config-python/releases",
"Issues": "https://github.com/frequenz-floss/frequenz-repo-config-python/issues",
"Repository": "https://github.com/frequenz-floss/frequenz-repo-config-python",
"Support": "https://github.com/frequenz-floss/frequenz-repo-config-python/discussions/categories/support"
},
"split_keywords": [
"config",
"frequenz",
"grpc",
"lib",
"library",
"mkdocs",
"nox",
"project",
"protobuf",
"python",
"repo-config",
"repository",
"setuptools",
"tool"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "caeb1d4695b7332fff41594d6b6ac28281cd0534e5f22b3e1e6df7ea0131d0b5",
"md5": "9187c98565367c12f5886816db7cdc97",
"sha256": "9a7261edb6a7bf724988982686139da768229c0e4e9fca4597eb63744a766421"
},
"downloads": -1,
"filename": "frequenz_repo_config-0.6.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9187c98565367c12f5886816db7cdc97",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.11",
"size": 26341,
"upload_time": "2023-09-18T13:32:45",
"upload_time_iso_8601": "2023-09-18T13:32:45.798033Z",
"url": "https://files.pythonhosted.org/packages/ca/eb/1d4695b7332fff41594d6b6ac28281cd0534e5f22b3e1e6df7ea0131d0b5/frequenz_repo_config-0.6.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e8e6d3d6ab554bef1422911956f5dd63fd620042559b6d846f877354eca3b441",
"md5": "dadbd2eb8e463c4515bccde3ff6dd8f6",
"sha256": "294c172b75c21e96322b3895bae7a1aa26865b9b08e1520719ea66db74248adf"
},
"downloads": -1,
"filename": "frequenz-repo-config-0.6.2.tar.gz",
"has_sig": false,
"md5_digest": "dadbd2eb8e463c4515bccde3ff6dd8f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.11",
"size": 23392,
"upload_time": "2023-09-18T13:32:46",
"upload_time_iso_8601": "2023-09-18T13:32:46.821814Z",
"url": "https://files.pythonhosted.org/packages/e8/e6/d3d6ab554bef1422911956f5dd63fd620042559b6d846f877354eca3b441/frequenz-repo-config-0.6.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-18 13:32:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "frequenz-floss",
"github_project": "frequenz-repo-config-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "frequenz-repo-config"
}
JSON
