pytest-allure-host 0.1.1__tar.gz → 0.1.2__tar.gz

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pytest-allure-host
-Version: 0.1.1
+Version: 0.1.2
 Summary: Publish Allure static reports to private S3 behind CloudFront with history preservation
 License-Expression: MIT
 License-File: LICENSE
@@ -21,8 +21,8 @@ Classifier: Operating System :: OS Independent
 Requires-Dist: PyYAML (>=6,<7)
 Requires-Dist: boto3 (>=1.28,<2.0)
 Project-URL: Bug Tracker, https://github.com/darrenrabbs/allurehosting/issues
-Project-URL: Changelog, https://github.com/darrenrabbs/allurehosting/releases
-Project-URL: Documentation, https://github.com/darrenrabbs/allurehosting#readme
+Project-URL: Changelog, https://darrenrabbs.github.io/allurehosting/changelog/
+Project-URL: Documentation, https://darrenrabbs.github.io/allurehosting/
 Project-URL: Homepage, https://github.com/darrenrabbs/allurehosting
 Project-URL: Repository, https://github.com/darrenrabbs/allurehosting
 Description-Content-Type: text/markdown
@@ -33,11 +33,20 @@ Description-Content-Type: text/markdown
 ![CodeQL](https://github.com/darrenrabbs/allurehosting/actions/workflows/codeql.yml/badge.svg)
 ![PyPI - Version](https://img.shields.io/pypi/v/pytest-allure-host.svg)
 ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+[![Docs](https://img.shields.io/badge/docs-site-blue)](https://darrenrabbs.github.io/allurehosting/)
 
 Publish Allure static reports to private S3 behind CloudFront with history preservation and SPA-friendly routing.
 
 See `docs/architecture.md` and `.github/copilot-instructions.md` for architecture and design constraints.
 
+## Documentation
+
+Full documentation (quickstart, AWS setup, IAM least-privilege, CLI usage, changelog) is published at:
+
+https://darrenrabbs.github.io/allurehosting/
+
+The README intentionally stays lean—refer to the site for detailed guidance.
+
 ## Features
 
 - Generate Allure static report from `allure-results`

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/README.md

@@ -4,11 +4,20 @@
 ![CodeQL](https://github.com/darrenrabbs/allurehosting/actions/workflows/codeql.yml/badge.svg)
 ![PyPI - Version](https://img.shields.io/pypi/v/pytest-allure-host.svg)
 ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+[![Docs](https://img.shields.io/badge/docs-site-blue)](https://darrenrabbs.github.io/allurehosting/)
 
 Publish Allure static reports to private S3 behind CloudFront with history preservation and SPA-friendly routing.
 
 See `docs/architecture.md` and `.github/copilot-instructions.md` for architecture and design constraints.
 
+## Documentation
+
+Full documentation (quickstart, AWS setup, IAM least-privilege, CLI usage, changelog) is published at:
+
+https://darrenrabbs.github.io/allurehosting/
+
+The README intentionally stays lean—refer to the site for detailed guidance.
+
 ## Features
 
 - Generate Allure static report from `allure-results`

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "pytest-allure-host"
-version = "0.1.1"
+version = "0.1.2"
 description = "Publish Allure static reports to private S3 behind CloudFront with history preservation"
 readme = "README.md"
 license = "MIT"
@@ -44,7 +44,9 @@ allure-pytest = ">=2,<3"
 pytest-cov = ">=4,<5"
 ruff = ">=0.5,<1.0"
 pip-audit = ">=2.7,<3.0"
-black = ">=24,<25"
+black = ">=24,<26"
+mkdocs = ">=1.5,<2.0"
+mkdocs-material = ">=9.5,<10.0"
 
 [project.scripts]
 publish-allure = "pytest_allure_host.cli:main"
@@ -55,9 +57,9 @@ pytest_allure_host = "pytest_allure_host.plugin"
 [project.urls]
 Homepage = "https://github.com/darrenrabbs/allurehosting"
 Repository = "https://github.com/darrenrabbs/allurehosting"
-Documentation = "https://github.com/darrenrabbs/allurehosting#readme"
+Documentation = "https://darrenrabbs.github.io/allurehosting/"
 "Bug Tracker" = "https://github.com/darrenrabbs/allurehosting/issues"
-Changelog = "https://github.com/darrenrabbs/allurehosting/releases"
+Changelog = "https://darrenrabbs.github.io/allurehosting/changelog/"
 
 # Package include (PEP 621 doesn't specify this; still handled by Poetry configuration)
 [tool.poetry]

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pytest_allure_host/cli.py

@@ -24,6 +24,16 @@ def parse_args() -> argparse.Namespace:
     p.add_argument("--report", default="allure-report")
     p.add_argument("--ttl-days", type=int, default=None)
     p.add_argument("--max-keep-runs", type=int, default=None)
+    p.add_argument(
+        "--sse",
+        default=os.getenv("ALLURE_S3_SSE"),
+        help="Server-side encryption algorithm (AES256 or aws:kms)",
+    )
+    p.add_argument(
+        "--sse-kms-key-id",
+        default=os.getenv("ALLURE_S3_SSE_KMS_KEY_ID"),
+        help="KMS Key ID / ARN when --sse=aws:kms",
+    )
     p.add_argument(
         "--s3-endpoint",
         default=os.getenv("ALLURE_S3_ENDPOINT"),
@@ -35,6 +45,16 @@ def parse_args() -> argparse.Namespace:
         default=os.getenv("ALLURE_CONTEXT_URL"),
         help="Optional hyperlink giving change context (e.g. Jira ticket)",
     )
+    p.add_argument(
+        "--meta",
+        action="append",
+        default=[],
+        metavar="KEY=VAL",
+        help=(
+            "Attach arbitrary metadata (repeatable). Example: --meta jira=PROJ-123 "
+            "--meta env=staging. Adds columns to runs index & manifest fields."
+        ),
+    )
     p.add_argument("--dry-run", action="store_true", help="Plan only")
     p.add_argument(
         "--check",
@@ -44,6 +64,24 @@ def parse_args() -> argparse.Namespace:
     return p.parse_args()
 
 
+def _parse_metadata(pairs: list[str]) -> dict | None:
+    if not pairs:
+        return None
+    meta: dict[str, str] = {}
+    for raw in pairs:
+        if "=" not in raw:
+            continue
+        k, v = raw.split("=", 1)
+        k = k.strip()
+        v = v.strip()
+        if not k:
+            continue
+        safe_k = k.lower().replace("-", "_")
+        if safe_k and v:
+            meta[safe_k] = v
+    return meta or None
+
+
 def main() -> int:
     args = parse_args()
     cli_overrides = {
@@ -57,8 +95,13 @@ def main() -> int:
         "max_keep_runs": args.max_keep_runs,
         "s3_endpoint": args.s3_endpoint,
         "context_url": args.context_url,
+        "sse": args.sse,
+        "sse_kms_key_id": args.sse_kms_key_id,
     }
     effective = load_effective_config(cli_overrides, args.config)
+    cfg_source = effective.get("_config_file")
+    if cfg_source:
+        print(f"[config] loaded settings from {cfg_source}")
     missing = [k for k in ("bucket", "project") if not effective.get(k)]
     if missing:
         raise SystemExit(
@@ -75,6 +118,9 @@ def main() -> int:
         max_keep_runs=effective.get("max_keep_runs"),
         s3_endpoint=effective.get("s3_endpoint"),
         context_url=effective.get("context_url"),
+        sse=effective.get("sse"),
+        sse_kms_key_id=effective.get("sse_kms_key_id"),
+        metadata=_parse_metadata(args.meta),
     )
     if args.check:
         checks = preflight(cfg)

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pytest_allure_host/config.py

@@ -38,10 +38,14 @@ from typing import Any
 import yaml
 
 CONFIG_FILENAMES = [
+    # YAML (legacy / original)
     "allure-host.yml",
     "allure-host.yaml",
     ".allure-host.yml",
     ".allure-host.yaml",
+    # TOML (new preferred simple format)
+    "allurehost.toml",
+    ".allurehost.toml",
     # Additional generic app config names people often use:
     "application.yml",
     "application.yaml",
@@ -81,9 +85,32 @@ def _read_yaml(path: Path) -> dict[str, Any]:
         return {}
 
 
+def _read_toml(path: Path) -> dict[str, Any]:
+    try:
+        import sys
+
+        if sys.version_info >= (3, 11):  # stdlib tomllib
+            import tomllib  # type: ignore
+        else:  # fallback to optional dependency
+            import tomli as tomllib  # type: ignore
+    except Exception:  # pragma: no cover - toml not available
+        return {}
+    try:
+        with path.open("rb") as f:
+            data = tomllib.load(f)
+        return data if isinstance(data, dict) else {}
+    except Exception:  # pragma: no cover - malformed
+        return {}
+
+
 def discover_yaml_config(explicit: str | None = None) -> LoadedConfig:
     if explicit:
         p = Path(explicit)
+        if p.suffix.lower() == ".toml":
+            return LoadedConfig(
+                source_file=p if p.exists() else None,
+                data=_read_toml(p),
+            )
         return LoadedConfig(
             source_file=p if p.exists() else None,
             data=_read_yaml(p),
@@ -91,6 +118,8 @@ def discover_yaml_config(explicit: str | None = None) -> LoadedConfig:
     for name in CONFIG_FILENAMES:
         p = Path(name)
         if p.exists():
+            if p.suffix.lower() == ".toml":
+                return LoadedConfig(source_file=p, data=_read_toml(p))
             return LoadedConfig(source_file=p, data=_read_yaml(p))
     return LoadedConfig(source_file=None, data={})
 

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pytest_allure_host/plugin.py

@@ -79,6 +79,9 @@ def pytest_terminal_summary(  # noqa: C901 - central orchestration, readable
         "context_url": context_url,
     }
     effective = load_effective_config(cli_overrides, config.getoption("allure_config"))
+    cfg_source = effective.get("_config_file")
+    if cfg_source:
+        terminalreporter.write_line(f"[allure-host] config file: {cfg_source}")
     # Minimal required
     if not effective.get("bucket") or not effective.get("project"):
         return

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pytest_allure_host/publisher.py

@@ -5,6 +5,7 @@ Responsible for:
   * Uploading run report to S3 (run prefix) + atomic promotion to latest/
   * Writing manifest (runs/index.json) + human HTML index + trend viewer
   * Retention (max_keep_runs) + directory placeholder objects
+    * Extracting metadata keys from runs
 
 The trend viewer (runs/trend.html) is a small dependency‑free canvas page
 visualising passed / failed / broken counts across historical runs using
@@ -57,9 +58,35 @@ class Paths:
             self.report = self.base / "allure-report"
 
 
-# --------------------------------------------------------------------------------------
-# S3 helpers
-# --------------------------------------------------------------------------------------
+def _discover_meta_keys(runs: list[dict]) -> list[str]:
+    """Return sorted list of dynamic metadata keys across runs."""
+    core_cols = {
+        "run_id",
+        "time",
+        "size",
+        "project",
+        "branch",
+        "passed",
+        "failed",
+        "broken",
+        "context_url",
+    }
+    keys: list[str] = []
+    for r in runs:
+        for k in r.keys():
+            if k in core_cols or k.endswith("_url"):
+                continue
+            if k not in keys:
+                keys.append(k)
+    keys.sort()
+    return keys
+
+
+def _format_meta_cell(val) -> str:
+    if val is None:
+        return "<td>-</td>"
+    esc = str(val).replace("<", "&lt;").replace(">", "&gt;")
+    return f"<td>{esc}</td>"
 
 
 def _s3(cfg: PublishConfig):  # allow custom endpoint (tests / local)
@@ -69,7 +96,11 @@ def _s3(cfg: PublishConfig):  # allow custom endpoint (tests / local)
     return boto3.client("s3")
 
 
-def list_keys(bucket: str, prefix: str, endpoint: str | None = None) -> Iterable[str]:
+def list_keys(
+    bucket: str,
+    prefix: str,
+    endpoint: str | None = None,
+) -> Iterable[str]:
     s3 = boto3.client("s3", endpoint_url=endpoint) if endpoint else boto3.client("s3")
     paginator = s3.get_paginator("list_objects_v2")
     for page in paginator.paginate(Bucket=bucket, Prefix=prefix):
@@ -79,13 +110,18 @@ def list_keys(bucket: str, prefix: str, endpoint: str | None = None) -> Iterable
                 yield key
 
 
-def delete_prefix(bucket: str, prefix: str, endpoint: str | None = None) -> None:
+def delete_prefix(
+    bucket: str,
+    prefix: str,
+    endpoint: str | None = None,
+) -> None:
     keys = list(list_keys(bucket, prefix, endpoint))
     if not keys:
         return
     s3 = boto3.client("s3", endpoint_url=endpoint) if endpoint else boto3.client("s3")
     # Batch delete 1000 at a time
     for i in range(0, len(keys), 1000):
+        # Ruff style: remove spaces inside slice
         batch = keys[i : i + 1000]
         if not batch:
             continue
@@ -143,7 +179,9 @@ def generate_report(paths: Paths) -> None:
     # Validate discovered binary path before executing (Bandit B603 mitigation)
     exec_path = Path(allure_path).resolve()
     if not exec_path.is_file() or exec_path.name != "allure":  # pragma: no cover
-        raise RuntimeError(f"Unexpected allure executable: {exec_path}")
+        raise RuntimeError(
+            f"Unexpected allure exec: {exec_path}"  # shorter for line length
+        )
     # Safety: allure_path validated above; args are static & derived from
     # controlled paths (no user-provided injection surface).
     cmd = [
@@ -195,6 +233,10 @@ def upload_dir(cfg: PublishConfig, root_dir: Path, key_prefix: str) -> None:
             extra["ContentType"] = ctype
         if cfg.ttl_days is not None:
             extra["Tagging"] = f"ttl-days={cfg.ttl_days}"
+        if cfg.sse:
+            extra["ServerSideEncryption"] = cfg.sse
+            if cfg.sse == "aws:kms" and cfg.sse_kms_key_id:
+                extra["SSEKMSKeyId"] = cfg.sse_kms_key_id
         s3.upload_file(str(p), cfg.bucket, key, ExtraArgs=extra)
 
 
@@ -231,7 +273,11 @@ def two_phase_update_latest(cfg: PublishConfig, report_dir: Path) -> None:
     delete_prefix(cfg.bucket, tmp_prefix, getattr(cfg, "s3_endpoint", None))
 
 
-def _validate_and_repair_latest(cfg: PublishConfig, report_dir: Path, latest_prefix: str) -> None:
+def _validate_and_repair_latest(
+    cfg: PublishConfig,
+    report_dir: Path,
+    latest_prefix: str,
+) -> None:
     s3 = _s3(cfg)
     try:
         s3.head_object(Bucket=cfg.bucket, Key=f"{latest_prefix}index.html")
@@ -305,6 +351,10 @@ def write_manifest(cfg: PublishConfig, paths: Paths) -> None:
     }
     if getattr(cfg, "context_url", None):
         entry["context_url"] = cfg.context_url
+    if cfg.metadata:
+        for mk, mv in cfg.metadata.items():
+            if mk not in entry:
+                entry[mk] = mv
     counts = _extract_summary_counts(paths.report)
     if counts:
         entry.update(counts)
@@ -380,34 +430,47 @@ def _build_runs_index_html(
     row_cap: int = 500,
 ) -> bytes:
     runs_list = manifest.get("runs", [])
-    runs_sorted = sorted(runs_list, key=lambda r: r.get("time", 0), reverse=True)
+    runs_sorted = sorted(
+        runs_list,
+        key=lambda r: r.get("time", 0),
+        reverse=True,
+    )
+    # discover dynamic metadata keys (excluding core + *_url)
+    meta_keys = _discover_meta_keys(runs_sorted)
     rows: list[str] = []
     for rinfo in runs_sorted[:row_cap]:
         rid = rinfo.get("run_id", "?")
-        size = rinfo.get("size") or 0
-        t = rinfo.get("time") or 0
-        human_time = _format_epoch_utc(t)
-        pretty_size = _format_bytes(size)
-        passed = rinfo.get("passed")
-        failed = rinfo.get("failed")
-        broken = rinfo.get("broken")
-        if passed is None and failed is None and broken is None:
-            summary = "-"
-        else:
-            summary = f"{passed or 0}/{failed or 0}/{broken or 0}"
+        size = int(rinfo.get("size") or 0)
+        t = int(rinfo.get("time") or 0)
+        passed, failed, broken = (
+            rinfo.get("passed"),
+            rinfo.get("failed"),
+            rinfo.get("broken"),
+        )
+        has_counts = any(v is not None for v in (passed, failed, broken))
+        summary = f"{passed or 0}/{failed or 0}/{broken or 0}" if has_counts else "-"
         ctx_url = rinfo.get("context_url")
-        if ctx_url:
-            ctx_cell = f"<a href='{ctx_url}' target='_blank' rel='noopener'>link</a>"
-        else:
-            ctx_cell = "-"
-        rows.append(
-            f"<tr><td><code>{rid}</code></td><td>{t}</td>"
-            f"<td>{human_time}</td><td title='{size}'>{pretty_size}</td>"
-            f"<td>{summary}</td><td>{ctx_cell}</td>"
+        ctx_cell = (
+            f"<a href='{ctx_url}' target='_blank' rel='noopener'>link</a>" if ctx_url else "-"
+        )
+        meta_cells = "".join(_format_meta_cell(rinfo.get(mk)) for mk in meta_keys)
+        row_html = (
+            "\n<tr"
+            f" data-passed='{passed or 0}'"
+            f" data-failed='{failed or 0}'"
+            f" data-broken='{broken or 0}'><td><code>"
+            f"{rid}</code></td><td>{t}</td><td>{_format_epoch_utc(t)}</td>"
+            f"<td title='{size}'>{_format_bytes(size)}</td><td>{summary}</td>"
+            f"<td>{ctx_cell}</td>{meta_cells}"
             f"<td><a href='../{rid}/'>run</a></td>"
             "<td><a href='../latest/'>latest</a></td></tr>"
         )
-    table_rows = "\n".join(rows) if rows else "<tr><td colspan='8'>No runs yet</td></tr>"
+        rows.append(row_html)
+    # colspan accounts for base 8 columns + dynamic metadata count
+    empty_cols = 8 + len(meta_keys)
+    table_rows = (
+        "\n".join(rows) if rows else f"<tr><td colspan='{empty_cols}'>No runs yet</td></tr>"
+    )
     title = f"Allure Runs: {cfg.project} / {cfg.branch}"
     nav = (
         "<nav class='quick-links'><strong>Latest:</strong> "
@@ -418,6 +481,7 @@ def _build_runs_index_html(
         "<a href='trend.html'>trend-view</a>"
         "</nav>"
     )
+    meta_header = "".join(f"<th class='sortable' data-col='meta:{k}'>{k}</th>" for k in meta_keys)
     parts: list[str] = [
         "<!doctype html><html><head><meta charset='utf-8'>",
         f"<title>{title}</title>",
@@ -444,16 +508,79 @@ def _build_runs_index_html(
         "nav.quick-links a{margin-right:.65rem;}",
         "</style></head><body>",
         f"<h1>{title}</h1>",
+        (
+            "<div id='controls' style='margin:.5rem 0 1rem;display:flex;"  # noqa: E501
+            "gap:1rem;flex-wrap:wrap'>"  # noqa: E501
+            "<label style='font-size:14px'>Search: <input id='run-filter'"  # noqa: E501
+            " type='text' placeholder='substring (id, context, meta)'"  # noqa: E501
+            " style='padding:4px 6px;font-size:14px;border:1px solid #ccc;"  # noqa: E501
+            "border-radius:4px'></label>"  # noqa: E501
+            "<label style='font-size:14px'>"  # noqa: E501
+            "<input type='checkbox' id='only-failing' style='margin-right:4px'>"  # noqa: E501
+            "Only failing</label>"  # noqa: E501
+            "<span id='stats' style='font-size:12px;color:#666'></span></div>"  # noqa: E501
+        ),
         nav,
-        "<table><thead><tr>",
-        ("<th>Run ID</th><th>Epoch</th><th>UTC Time</th><th>Size</th>"),
-        ("<th>P/F/B</th><th>Context</th><th>Run</th><th>Latest</th></tr></thead><tbody>"),
+        "<table id='runs-table'><thead><tr>",
+        (
+            "<th class='sortable' data-col='run_id'>Run ID</th>"
+            "<th class='sortable' data-col='epoch'>Epoch</th>"
+            "<th class='sortable' data-col='utc'>UTC Time</th>"
+            "<th class='sortable' data-col='size'>Size</th>"
+        ),
+        (
+            "<th class='sortable' data-col='pfb'>P/F/B</th>"
+            "<th class='sortable' data-col='context'>Context</th>"
+            f"{meta_header}<th>Run</th><th>Latest</th></tr></thead><tbody>"
+        ),
         table_rows,
         "</tbody></table>",
         (
             f"<footer>Updated {latest_payload.get('run_id', '?')} • "
             f"{cfg.project}/{cfg.branch}</footer>"
         ),
+        (
+            "<script>"
+            "(function(){"  # IIFE wrapper
+            "const tbl=document.getElementById('runs-table');"
+            "const filter=document.getElementById('run-filter');"
+            "const stats=document.getElementById('stats');"
+            "const onlyFail=document.getElementById('only-failing');"
+            "function updateStats(){const total=tbl.tBodies[0].rows.length;"
+            "const visible=[...tbl.tBodies[0].rows]"  # next line filters
+            ".filter(r=>r.style.display!=='none').length;"
+            "stats.textContent=visible+' / '+total+' shown';}"
+            "function applyFilter(){const q=filter.value.toLowerCase();"
+            "const onlyF=onlyFail.checked;"
+            "[...tbl.tBodies[0].rows].forEach(r=>{"
+            "const txt=r.textContent.toLowerCase();"
+            "const hasTxt=!q||txt.indexOf(q)>-1;"
+            "const failing=Number(r.getAttribute('data-failed')||'0')>0;"
+            "r.style.display=(hasTxt&&(!onlyF||failing))?'':'none';});"
+            "updateStats();}"
+            "filter.addEventListener('input',applyFilter);"
+            "onlyFail.addEventListener('change',applyFilter);"
+            "let sortState=null;"
+            "function extract(r,col){switch(col){"
+            "case 'epoch':return r.cells[1].textContent;"
+            "case 'size':return r.cells[3].getAttribute('title');"
+            "case 'pfb':return r.cells[4].textContent;"
+            "default:return r.textContent;}}"
+            "function sortBy(col){const tbody=tbl.tBodies[0];"
+            "const rows=[...tbody.rows];let dir=1;"
+            "if(sortState&&sortState.col===col){dir=-sortState.dir;}"
+            "sortState={col,dir};"
+            "const numeric=(col==='epoch'||col==='size');"
+            "rows.sort((r1,r2)=>{const a=extract(r1,col);"
+            "const b=extract(r2,col);if(numeric){return (("
+            "(Number(a)||0)-(Number(b)||0))*dir;}"
+            "return a.localeCompare(b)*dir;});"
+            "rows.forEach(r=>tbody.appendChild(r));}"
+            "tbl.tHead.querySelectorAll('th.sortable')"  # split chain
+            ".forEach(th=>{th.addEventListener('click',()=>sortBy(th.dataset.col));});"  # noqa: E501
+            "updateStats();})();"
+            "</script>"
+        ),
         "</body></html>",
     ]
     return "".join(parts).encode("utf-8")
@@ -565,7 +692,11 @@ def cleanup_old_runs(cfg: PublishConfig, keep: int) -> None:
     # list immediate children (run prefixes)
     paginator = s3.get_paginator("list_objects_v2")
     run_prefixes: list[str] = []
-    for page in paginator.paginate(Bucket=cfg.bucket, Prefix=f"{root}/", Delimiter="/"):
+    for page in paginator.paginate(
+        Bucket=cfg.bucket,
+        Prefix=f"{root}/",
+        Delimiter="/",
+    ):
         for cp in page.get("CommonPrefixes", []) or []:
             pfx = cp.get("Prefix")
             if not pfx:
@@ -581,7 +712,11 @@ def cleanup_old_runs(cfg: PublishConfig, keep: int) -> None:
         delete_prefix(cfg.bucket, old, getattr(cfg, "s3_endpoint", None))
 
 
-def _ensure_directory_placeholder(cfg: PublishConfig, index_file: Path, dir_prefix: str) -> None:
+def _ensure_directory_placeholder(
+    cfg: PublishConfig,
+    index_file: Path,
+    dir_prefix: str,
+) -> None:
     if not index_file.exists() or not dir_prefix.endswith("/"):
         return
     body = index_file.read_bytes()
@@ -632,13 +767,30 @@ def preflight(
     except OSError:
         results["allure_results"] = False
 
+    region_mismatch = False
+    bucket_region = None
     try:
         s3 = _s3(cfg)
-        s3.head_bucket(Bucket=cfg.bucket)
-        s3.list_objects_v2(Bucket=cfg.bucket, Prefix=cfg.s3_latest_prefix, MaxKeys=1)
+        head = s3.head_bucket(Bucket=cfg.bucket)
+        # region detection (defensive: some stubs may return None)
+        if head:
+            bucket_region = (
+                head.get("ResponseMetadata", {}).get("HTTPHeaders", {}).get("x-amz-bucket-region")
+            )
+        # Attempt a small list to confirm permissions
+        s3.list_objects_v2(
+            Bucket=cfg.bucket,
+            Prefix=cfg.s3_latest_prefix,
+            MaxKeys=1,
+        )
         results["s3_bucket"] = True
-    except ClientError:
+    except ClientError as e:
+        code = getattr(e, "response", {}).get("Error", {}).get("Code")
+        if code == "301":  # permanent redirect / region mismatch
+            region_mismatch = True
         results["s3_bucket"] = False
+    results["bucket_region"] = bucket_region
+    results["region_mismatch"] = region_mismatch
     return results
 
 
@@ -662,14 +814,30 @@ def plan_dry_run(cfg: PublishConfig, paths: Paths | None = None) -> dict:
     else:
         samples.append({"note": "Report missing; would run allure generate."})
     root = branch_root(cfg.prefix, cfg.project, cfg.branch)
-    return {
+    latest_tmp = f"{root}/latest_tmp/"
+    mapping = {
         "bucket": cfg.bucket,
+        "prefix": cfg.prefix,
+        "project": cfg.project,
+        "branch": cfg.branch,
+        "run_id": cfg.run_id,
         "run_prefix": cfg.s3_run_prefix,
-        "latest_prefix": f"{root}/latest_tmp/",
+        # Backwards compat: historical key name pointed to temp swap area
+        "latest_prefix": latest_tmp,
+        "latest_tmp_prefix": latest_tmp,
+        "latest_final_prefix": cfg.s3_latest_prefix,
+    }
+    return {
+        **mapping,
         "run_url": cfg.url_run(),
         "latest_url": cfg.url_latest(),
         "context_url": getattr(cfg, "context_url", None),
+        "metadata": cfg.metadata or {},
         "samples": samples,
+        "encryption": {
+            "sse": cfg.sse,
+            "sse_kms_key_id": cfg.sse_kms_key_id,
+        },
     }
 
 

{pytest_allure_host-0.1.1 → pytest_allure_host-0.1.2}/pytest_allure_host/utils.py

@@ -53,6 +53,11 @@ class PublishConfig:
     s3_endpoint: str | None = None  # custom S3 endpoint (e.g. LocalStack)
     # optional link to change context (e.g. Jira ticket / work item)
     context_url: str | None = None
+    # encryption parameters (optional)
+    sse: str | None = None  # e.g. 'AES256' or 'aws:kms'
+    sse_kms_key_id: str | None = None
+    # arbitrary metadata (jira ticket, environment, etc.)
+    metadata: dict | None = None
 
     @property
     def s3_run_prefix(self) -> str: