Pain001 працює на Python 3.11+ (кожна версія тестується в CI) на macOS, Linux і Windows. Встановлюйте лише потрібне: кожна необов'язкова можливість є екстрою, тому базове встановлення залишається компактним.
01. PyPI#
| Що вам потрібно | Команда |
|---|---|
| Базовий CLI та бібліотека Python | pip install pain001 |
| Мікросервіс REST API (FastAPI + Uvicorn) | pip install "pain001[api]" |
| Приймання Parquet (PyArrow) | pip install "pain001[parquet]" |
Вхідні файли, зашифровані PGP (.gpg / .asc) | pip install "pain001[gpg]" |
| Черга асинхронних завдань на Redis для API | pip install "pain001[redis]" |
| Трасування OpenTelemetry | pip install "pain001[otel]" |
| Вбудовані мінімальні сервери MCP / LSP | pip install "pain001[mcp]" / "pain001[lsp]" |
SFTP delivery (pain001 upload) | pip install "pain001[upload]" |
Private CEL policy rules (--rules) | pip install "pain001[rules]" |
| Faster XSD validation (lxml) | pip install "pain001[fast]" |
XML signing and verification (--xml-sign-key, verify-signature) | pip install "pain001[sign]" |
Супутні пакети встановлюються окремо й виходять синхронно з ядром: кожен випуск супутнього пакета має той самий номер версії, що й ядро, якого він потребує.
Перевірте встановлення та дослідіть каталог повідомлень:
02. Docker#
Мультиархітектурні образи (linux/amd64, linux/arm64) публікуються в GitHub Container Registry. Контейнер працює від виділеного користувача без прав root.
# Generate XML from a local CSV
# Launch the REST API
03. Закриті середовища#
Банківські та казначейські середовища часто забороняють динамічне завантаження плагінів. Саме для цього випадку існують два механізми контролю:
PAIN001_DISABLE_PLUGINS=1вимикає виявлення всіх сторонніх плагінів; працюють лише вбудовані завантажувачі.pain001 plugins list/pain001 plugins show <name>роблять кожен виявлений плагін придатним для аудиту ще до першого використання.
Усе виконується локально. Жоден пакет набору не надсилає даних розробникам і не викликає SaaS API, а платіжні дані залишають хост лише тоді, коли ви самі їх надсилаєте, наприклад командою pain001 upload.
04. Перший файл за три команди#
--dry-run перевіряє дані за JSON Schema, XSD і (з --scheme) за регламентом вказаної платіжної системи, не записуючи результат. Код виходу 0 означає, що файл пройшов саме ці перевірки: схему і, якщо його вибрано, збірник правил платіжної схеми. Власний профіль вашого банку та правила його каналу існують окремо й досі потребують тестування з банком. Приберіть --dry-run, щоб записати XML.
Продовжте в технічному довіднику (там кожен прапорець і ендпоінт) або у FAQ швидкого старту для операційних питань.
