** Plone CLI для создания пакетов Plone**

Plone CLI предназначен для разработки пакетов Plone. Он использует шаблоны копиров для создания резервных аддонов Plone, настроек проекта Zope и добавления таких функций, как типы контента, поведение и услуги REST API.

##Совместимость

Начиная с версии 7.x, мы используем шаблоны копировальных устройств вместо шаблонов. шаблоны plone или cookiecutter. Это приносит некоторые преимущества UX и гибкость шаблонам и является перспективным.

Версии >= 7.x используют новые шаблоны копировальных устройств (UV/pyproject.toml вместо сборки) и поддерживают Plone >= 6.x.

• Версии == 3.x** (текущая стабильная версия)** используют бобтемплаты. plone и некоторые шаблоны cookieplone, а также поддержка Plone >= 6.x. При использовании bobtemplates.plone для Plone 5.x и Python 3 можно использовать plonecli вместе с bobtemplates. plone == 6.x. Они поддерживают Plone 5 и Plone 6, за исключением шаблонов тем, которые сделаны для Plone 6. Если вам действительно нужно создать тематический пакет для Plone 5.x, используйте bobtemplates.plone (the open-standard discovery path) and linked from~/.claude/skills/ for Claude Code. Use — масштабный проект для установки в текущий проект.

Plone CLI

A Plone CLI for creating Plone packages

The Plone CLI is meant for developing Plone packages. It uses copier templates to scaffold Plone backend addons, Zope project setups, and add features like content types, behaviors, and REST API services.

Compatibility

Starting from version 7.x, we use copier templates instead of bobtemplates.plone or cookiecutter templates. This brings some UX advantages and flexibility to the templates and is future-proof.

• Versions >= 7.x use the new copier templates (UV/pyproject.toml instead of buildout) and support Plone >= 6.x.
• Versions == 3.x (current stable version) use bobtemplates.plone and some cookieplone templates and also support Plone >= 6.x.
  • When using bobtemplates.plone for Plone 5.x and Python 3, you can use plonecli together with bobtemplates.plone == 6.x. They support Plone 5 and Plone 6, except for the theming templates, which are made for Plone 6. If you really need to create a theming package for Plone 5.x, use bobtemplates.plone < 6.x.

Installation

UV Tool (Recommended)

The recommended way to install plonecli is as a UV tool, which makes it available globally:

uv tool install plonecli

To upgrade:

uv tool upgrade plonecli

Run Without Installing (uvx)

You can run plonecli without installing it using uvx:

uvx plonecli create addon my.addon

In a Virtual Environment

uv venv
source .venv/bin/activate
uv pip install plonecli

With pipx

pipx install plonecli

Shell Completion

plonecli supports tab-completion for commands and template names in bash, zsh, and fish.

Quick Install

plonecli completion --install

This auto-detects your shell and appends the activation line to your ~/.bashrc, ~/.zshrc, or fish completions directory. Restart your shell afterward.

Manual Setup

If you prefer to set it up yourself:

Bash (add to ~/.bashrc):

eval "$(_PLONECLI_COMPLETE=bash_source plonecli)"

Zsh (add to ~/.zshrc):

eval "$(_PLONECLI_COMPLETE=zsh_source plonecli)"

Fish (add to ~/.config/fish/completions/plonecli.fish):

env _PLONECLI_COMPLETE=fish_source plonecli | source

Faster Startup (Optional)

The eval approach generates the completion script on every shell start. For faster startup, save it to a file:

# Generate once
_PLONECLI_COMPLETE=bash_source plonecli > ~/.plonecli-complete.bash

# Then source from your ~/.bashrc instead of eval
source ~/.plonecli-complete.bash