# 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.
## Supported Platforms
The following platforms are officially supported (tested):
- **Python:** 3.11
- **Operating System:** Ubuntu Linux 20.04
- **Architectures:** amd64, arm64
## 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.4.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
```
This command will prompt you for the project type, name, and other
configuration options, and it will generate the entire project for you.
It is recommended to use a released version, you can do that by adding the
option `--checkout <version>` to the command above. You can check which is the
latest version
[here](https://github.com/frequenz-floss/frequenz-repo-config-python/releases/latest).
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": null,
"name": "frequenz-repo-config",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.11",
"maintainer_email": null,
"keywords": "config, frequenz, grpc, lib, library, mkdocs, nox, project, protobuf, python, repo-config, repository, setuptools, tool",
"author": null,
"author_email": "Frequenz Energy-as-a-Service GmbH <floss@frequenz.com>",
"download_url": "https://files.pythonhosted.org/packages/e7/de/1455e23b9fdcca13eb63825c77b9f514a5ffeeff2962c30862d776c3662c/frequenz_repo_config-0.12.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## Supported Platforms\n\nThe following platforms are officially supported (tested):\n\n- **Python:** 3.11\n- **Operating System:** Ubuntu Linux 20.04\n- **Architectures:** amd64, arm64\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.4.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 --directory=cookiecutter\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\nIt is recommended to use a released version, you can do that by adding the\noption `--checkout <version>` to the command above. You can check which is the\nlatest version\n[here](https://github.com/frequenz-floss/frequenz-repo-config-python/releases/latest).\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.12.2",
"project_urls": {
"Changelog": "https://github.com/frequenz-floss/frequenz-repo-config-python/releases",
"Documentation": "https://frequenz-floss.github.io/frequenz-repo-config-python/",
"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": null,
"digests": {
"blake2b_256": "8d03554bb6ebcda04de39efa06e36fab3589c5666271413710c61904212ec280",
"md5": "fc1e4de600a5d05da3761cc6b1c4a42f",
"sha256": "7d3bbf6dad02ed7131b60a3cb504d03e529e8082204d8c8dadd63786b55242fa"
},
"downloads": -1,
"filename": "frequenz_repo_config-0.12.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fc1e4de600a5d05da3761cc6b1c4a42f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.11",
"size": 44407,
"upload_time": "2025-02-11T13:30:36",
"upload_time_iso_8601": "2025-02-11T13:30:36.929037Z",
"url": "https://files.pythonhosted.org/packages/8d/03/554bb6ebcda04de39efa06e36fab3589c5666271413710c61904212ec280/frequenz_repo_config-0.12.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e7de1455e23b9fdcca13eb63825c77b9f514a5ffeeff2962c30862d776c3662c",
"md5": "1024a7d183e943346589d45f7dcc093a",
"sha256": "d77af8d155565f857d1c27e0499a384a96a3dd2cf5e94e44184b010d12e05010"
},
"downloads": -1,
"filename": "frequenz_repo_config-0.12.2.tar.gz",
"has_sig": false,
"md5_digest": "1024a7d183e943346589d45f7dcc093a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.11",
"size": 40663,
"upload_time": "2025-02-11T13:30:40",
"upload_time_iso_8601": "2025-02-11T13:30:40.324747Z",
"url": "https://files.pythonhosted.org/packages/e7/de/1455e23b9fdcca13eb63825c77b9f514a5ffeeff2962c30862d776c3662c/frequenz_repo_config-0.12.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-11 13:30:40",
"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
