Metadata-Version: 2.4
Name: plone.meta
Version: 2.12.0
Summary: Applies a standard set of configuration files for Plone repositories
Author-email: Plone Foundation <releaseteam@plone.org>, Gil Forcada Codinachs <gil.gnome@gmail.com>
License-Expression: GPL-2.0-or-later
Project-URL: Homepage, https://github.com/plone/meta
Project-URL: Issue Tracker, https://github.com/plone/meta/issues
Project-URL: Changelog, https://github.com/plone/meta/blob/2.x/CHANGES.md
Project-URL: Documentation, https://6.docs.plone.org/developer-guide/standardize-python-project-configuration.html
Keywords: plone,packaging
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Jinja2
Requires-Dist: editorconfig
Requires-Dist: packaging
Requires-Dist: pyyaml
Requires-Dist: tomlkit
Requires-Dist: tox
Requires-Dist: validate-pyproject[all]
Requires-Dist: zest.releaser
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Dynamic: license-file

# plone.meta

`plone.meta` standardizes configuration files across Plone-related Python repositories.

It generates and manages `.editorconfig`, `.flake8`, `.gitignore`, `pyproject.toml`, `tox.ini`, `.pre-commit-config.yaml`, and CI pipelines (GitHub Actions, GitLab CI) from Jinja2 templates, with per-repository customization via `.meta.toml`.


## Quick Start

```shell
uvx --from plone.meta config-package path/to/your/package
```


## Documentation

Full documentation is available at **https://plone.github.io/meta/**

-   [Tutorials](https://plone.github.io/meta/tutorials/) -- Step-by-step lessons to get started
-   [How-To Guides](https://plone.github.io/meta/how-to/) -- Solutions to specific problems
-   [Reference](https://plone.github.io/meta/reference/) -- Configuration options and CLI details
-   [Explanation](https://plone.github.io/meta/explanation/) -- Architecture, design decisions, and philosophy


## Commands

-   `config-package` -- Generate configuration files for a single repository
-   `multi-call` -- Apply configuration across multiple repositories
-   `re-enable-actions` -- Re-enable auto-disabled GitHub Actions


## GitHub Actions Shared Automations

`plone.meta` also provides reusable workflows and composite actions for GitHub Actions.
See the [full documentation](https://plone.github.io/meta/reference/shared-workflows/) for details.


## Scope

`plone/meta` covers single-package Python repositories.
It does not cover:

-   Volto or other JavaScript-based projects
-   Monorepo projects (backend + frontend)
-   Projects supporting multiple Plone versions in the same branch


## License

GPLv2. See [LICENSE](LICENSE).
