plone.meta

plone.meta#

Standardize configuration files across Plone-related Python repositories.

plone.meta generates and manages a consistent set of configuration files – from CI pipelines and linting to tox environments and editor settings – so every Plone package provides the same developer experience.

Key capabilities:

  • Generate .editorconfig, .flake8, .gitignore, pyproject.toml, tox.ini, .pre-commit-config.yaml from Jinja2 templates

  • GitHub Actions and GitLab CI workflows, centrally managed

  • Test matrix: automatically test all combinations of Plone versions (6.0, 6.1, 6.2) and Python versions (3.10–3.14)

  • Shared reusable GitHub Actions workflows and composite actions for Cookieplone projects

  • Per-repository customization via .meta.toml without editing generated files

  • Bulk updates across 100+ Plone packages with a single command

  • Validation of generated TOML, YAML, INI, and editorconfig files

  • Install from PyPI: pip install plone.meta

Requirements: Python 3.10+

Documentation#

Tutorials

Learning-oriented – Step-by-step lessons to get started.

Start here if you are new to plone.meta.

Tutorials
How-To Guides

Goal-oriented – Solutions to specific problems.

Use these when you need to accomplish something.

How-To Guides
Reference

Information-oriented – Configuration options and CLI details.

Consult when you need detailed information.

Reference
Explanation

Understanding-oriented – Architecture, design decisions, and philosophy.

Read to deepen your understanding of how and why it works.

Explanation

Quick Start#

  1. Install plone.meta

  2. Configure your first package

  3. Customize via .meta.toml

Contents