Pain001 kurulumu: pip, Docker ve ilk doğrulanmış dosya

Pain001, macOS, Linux ve Windows üzerinde Python 3.10, 3.11 ve 3.12 ile çalışır (her sürüm CI'da test edilir). Neye ihtiyacınız varsa onu kurun; her isteğe bağlı yetenek bir ekstradır, böylece temel kurulum yalın kalır.

01. PyPI#

Neye ihtiyacınız var	Komut
Çekirdek CLI & Python kütüphanesi	`pip install pain001`
REST API mikroservisi (FastAPI + Uvicorn)	`pip install "pain001[api]"`
Parquet alımı (PyArrow)	`pip install "pain001[parquet]"`
PGP ile şifrelenmiş girdi dosyaları (`.gpg` / `.asc`)	`pip install "pain001[gpg]"`
API için Redis destekli eşzamansız iş kuyruğu	`pip install "pain001[redis]"`
OpenTelemetry izleme	`pip install "pain001[otel]"`
Yerleşik minimal MCP / LSP sunucuları	`pip install "pain001[mcp]"` / `"pain001[lsp]"`

Yardımcı paketler ayrı kurulur ve bağımsız olarak sürümlenir:

pip install pain001-loader-xlsx    # Excel ingestion (auto-discovered plugin)
pip install pain001-loader-mt101   # SWIFT MT101 parsing library
pip install pain001-mcp            # Full 22-tool MCP server for AI agents
pip install pain001-lsp            # Full six-feature editor language server

Kurulumu doğrulayın ve mesaj kataloğunu keşfedin:

pain001 --version
pain001 versions          # list all 11 supported message definitions
pain001 init pain.001.001.09   # scaffold a starter CSV template

02. Docker#

Çok mimarili imajlar (linux/amd64, linux/arm64) GitHub Container Registry'de yayımlanır. Konteyner, özel bir root olmayan kullanıcıyla çalışır.

# Generate XML from a local CSV
docker run --rm -v "$PWD:/data" -w /data \
  ghcr.io/sebastienrousseau/pain001:latest \
  generate -t pain.001.001.09 -d payments.csv -o out/

# Launch the REST API
docker run --rm -p 8000:8000 \
  ghcr.io/sebastienrousseau/pain001:latest \
  serve --host 0.0.0.0 --port 8000

03. Kilitli ortamlar#

Banka ve hazine ortamları çoğu zaman dinamik eklenti yüklemeyi yasaklar. Tam olarak bu durum için iki kontrol vardır:

PAIN001_DISABLE_PLUGINS=1, tüm üçüncü taraf eklenti keşfini devre dışı bırakır; yalnızca paketle gelen yükleyiciler çalışır.
pain001 plugins list / pain001 plugins show <name>, keşfedilen her eklentiyi ilk kullanımdan önce denetlenebilir kılar.

Her şey yerel olarak çalışır. Paketteki hiçbir bileşen dışarıya veri göndermez, bir SaaS API'sini çağırmaz veya ödeme verilerini ana makineden taşımaz.

04. Üç komutta ilk dosya#

pip install pain001
pain001 init pain.001.001.09 -o work/
pain001 -t pain.001.001.09 -d work/template.csv -o work/ --dry-run

--dry-run, çıktı yazmadan JSON Schema'ya, XSD'ye ve (--scheme ile) bir SEPA veya sınır ötesi kural kitabına göre doğrular. Çıkış kodu 0, dosyanın bu denetimleri geçtiği anlamına gelir: şema ve seçildiyse ödeme şeması kural kitabı. Bankanızın kendi profili ve kanal kuralları bunlardan ayrıdır ve yine de bankayla test edilmesini gerektirir. XML'i yazmak için --dry-run'ı kaldırın.

Her bayrak ve uç nokta için Teknik Referans sayfasına veya operasyonel sorular için Hızlı Başlangıç SSS sayfasına geçin.