Skip to main content

Render Cucumber JSON to Confluence Storage Format (Jinja2 templates) and optional publish.

Project description

🥒➡📄 cuke2conf — Publish Cucumber Reports to Confluence

Build PyPI Docker Pulls License: MIT

cuke2conf is a lightweight tool that converts Cucumber JSON reports into Confluence pages — including feature summaries, scenario details, and embedded screenshots/files.

It’s designed for teams who want their automated BDD test results to show up in Confluence automatically, without copy-pasting or manual formatting.


📦 Get it

🐍 Python (PyPI)

pip install cuke2confluence[publish]

🐳 Docker (Docker Hub)

docker pull lukian/cuke2confluence:latest

🚀 Use it

1️⃣ Convert Cucumber JSON to Confluence XML

cuke2conf \
  --json target/cucumber-reports/cucumber.json \
  --title "Smoke Test Results" \
  --out page-storage.xml

2️⃣ Publish directly to Confluence

export CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki"
export CONFLUENCE_USER="user@example.com"
export CONFLUENCE_TOKEN="your_api_token"

cuke2conf \
  --json target/cucumber-reports/cucumber.json \
  --title "Smoke Test Results" \
  --space QA \
  --parent 123456789 \
  --publish

🐳 Use it with Docker - No Python needed

docker run --rm \
  -v "$PWD:/work" \
  <your-user>/cuke2confluence:latest \
  --json /work/target/cucumber-reports/cucumber.json \
  --title "Smoke Test Results" \
  --out /work/page-storage.xml

Or publish directly:

docker run --rm \
  -e CONFLUENCE_BASE_URL="https://your-domain.atlassian.net/wiki" \
  -e CONFLUENCE_USER="user@example.com" \
  -e CONFLUENCE_TOKEN="your_api_token" \
  -v "$PWD:/work" \
  <your-user>/cuke2confluence:latest \
  --json /work/target/cucumber-reports/cucumber.json \
  --title "Smoke Test Results" \
  --space QA \
  --parent 123456789 \
  --publish

Links

🐍 PyPI: https://pypi.org/project/cuke2confluence

🐳 Docker Hub: https://hub.docker.com/r/lukian/cuke2confluence

📄 Cucumber JSON Format: https://cucumber.io/docs/cucumber/reporting/

📚 Confluence REST API: https://developer.atlassian.com/cloud/confluence/rest/

License

MIT License © 2025 — sjacobs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cuke2confluence-1.1.0.tar.gz (10.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cuke2confluence-1.1.0-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file cuke2confluence-1.1.0.tar.gz.

File metadata

  • Download URL: cuke2confluence-1.1.0.tar.gz
  • Upload date:
  • Size: 10.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for cuke2confluence-1.1.0.tar.gz
Algorithm Hash digest
SHA256 12934d3c2f4c8aab2242d99b0610a401de468e2e55a175a09d3e5697b7054f3a
MD5 67a08eab3b0e1223548b28fedcc5ee0e
BLAKE2b-256 34b1da2ef56ca7fb86352a120be364dd36e6f19968542b1e63a76c3d692973b5

See more details on using hashes here.

File details

Details for the file cuke2confluence-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cuke2confluence-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 208d3617e641152bbb2750047dc12064279c7c52f50ccf8d4276ec6edb49708f
MD5 89c8760cd49d886d3b32f8236b2feeec
BLAKE2b-256 8aaf9bcbc6f4baa3ca77102bedf7c004919710f3c690d714de33fba428eede5f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page