lr-gladiator 0.7.0__tar.gz → 0.9.0__tar.gz

lr_gladiator-0.9.0/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: lr-gladiator
+Version: 0.9.0
+Summary: CLI and Python client for Arena PLM (app.bom.com): login, get revisions, list/download attachments, and upload to working revisions.
+Author-email: Jonas Estberger <jonas.estberger@lumenradio.com>
+License: MIT
+Keywords: Arena,PLM,BOM,attachments,CLI
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: pydantic>=2.8
+Provides-Extra: dev
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: license-file
+
+# gladiator-arena
+
+CLI + Python client for interacting with the Arena PLM.
+
+## Install
+
+```bash
+pip install lr-gladiator
+```
+
+## Quick start
+
+### 1) Create `login.json`
+
+Interactive login (prompts for username/password):
+
+```bash
+gladiator login
+```
+
+Non-interactive (for CI/CD):
+
+```bash
+gladiator login --username "$ARENA_USERNAME" --password "$ARENA_PASSWORD" --ci
+```
+
+By default, this stores session details at:
+
+```
+~/.config/gladiator/login.json
+```
+
+### 2) Common commands
+
+Get the latest approved revision for an item:
+
+```bash
+gladiator latest-approved 890-1001
+```
+
+List all files on an item (defaults to the latest approved revision):
+
+```bash
+gladiator list-files 890-1001
+```
+
+Output JSON instead of a table:
+
+```bash
+gladiator list-files 890-1001 --format json
+```
+
+List the Bill of Materials (BOM) for an item:
+
+```bash
+gladiator bom 890-1001
+```
+
+Recursively expand subassemblies up to two levels deep:
+
+```bash
+gladiator bom 890-1001 --recursive --max-depth 2
+```
+
+Download attached files to a directory named after the article:
+
+```bash
+gladiator get-files 890-1001
+```
+
+Specify a different output directory:
+
+```bash
+gladiator get-files 890-1001 --out downloads/
+```
+
+Recursively download all files in the full BOM tree:
+
+```bash
+gladiator get-files 890-1001 --recursive
+```
+
+Upload or update a file on the working revision:
+
+```bash
+gladiator upload-file 890-1001 ./datasheet.pdf --category "CAD Data" --title "Datasheet"
+```
+
+### 3) Output control
+
+Most commands support a JSON output mode.  
+Example:
+
+```bash
+gladiator bom 890-1001 --output json
+```
+
+### Example sessions
+
+#### Human-readable
+
+```bash
+$ gladiator list-files 101-1031
+Files for 101-1031 rev (latest approved)
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓
+┃ Name                                 ┃ Size  ┃ Checksum            ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩
+│ Drawing.pdf                          │ 12345 │ d41d8cd98f00b204e…  │
+└──────────────────────────────────────┴───────┴─────────────────────┘
+```
+
+#### JSON output
+
+```bash
+$ gladiator list-files 101-1031 --format json
+{
+  "article": "101-1031",
+  "revision": "EFFECTIVE",
+  "files": [
+    {
+      "filename": "Drawing.pdf",
+      "size": 12345,
+      "checksum": "d41d8cd98f00b204e9800998ecf8427e"
+    }
+  ]
+}
+```
+
+## Programmatic use
+
+```python
+from gladiator import ArenaClient, load_config
+
+client = ArenaClient(load_config())
+rev = client.get_latest_approved_revision("890-1001")
+files = client.list_files("890-1001", rev)
+```
+
+## Development
+
+```bash
+python -m pip install -e .[dev]
+python -m build
+```
+
+## FAQ
+
+- **Where is the config kept?**
+  `~/.config/gladiator/login.json` (override with `GLADIATOR_CONFIG`)
+
+- **How do I run non-interactively?**
+  Pass `--ci` together with `--username` and `--password` (or use environment variables).
+
+- **What does `--recursive` do?**
+  Expands subassemblies and downloads or lists all contained items up to the given `--max-depth`.
+
+- **How does Gladiator handle authentication?**
+  It performs a `/login` call and stores the resulting `arenaSessionId` for reuse. If it expires, re-run `gladiator login`.
+
+

lr_gladiator-0.9.0/README.md

@@ -0,0 +1,160 @@
+# gladiator-arena
+
+CLI + Python client for interacting with the Arena PLM.
+
+## Install
+
+```bash
+pip install lr-gladiator
+```
+
+## Quick start
+
+### 1) Create `login.json`
+
+Interactive login (prompts for username/password):
+
+```bash
+gladiator login
+```
+
+Non-interactive (for CI/CD):
+
+```bash
+gladiator login --username "$ARENA_USERNAME" --password "$ARENA_PASSWORD" --ci
+```
+
+By default, this stores session details at:
+
+```
+~/.config/gladiator/login.json
+```
+
+### 2) Common commands
+
+Get the latest approved revision for an item:
+
+```bash
+gladiator latest-approved 890-1001
+```
+
+List all files on an item (defaults to the latest approved revision):
+
+```bash
+gladiator list-files 890-1001
+```
+
+Output JSON instead of a table:
+
+```bash
+gladiator list-files 890-1001 --format json
+```
+
+List the Bill of Materials (BOM) for an item:
+
+```bash
+gladiator bom 890-1001
+```
+
+Recursively expand subassemblies up to two levels deep:
+
+```bash
+gladiator bom 890-1001 --recursive --max-depth 2
+```
+
+Download attached files to a directory named after the article:
+
+```bash
+gladiator get-files 890-1001
+```
+
+Specify a different output directory:
+
+```bash
+gladiator get-files 890-1001 --out downloads/
+```
+
+Recursively download all files in the full BOM tree:
+
+```bash
+gladiator get-files 890-1001 --recursive
+```
+
+Upload or update a file on the working revision:
+
+```bash
+gladiator upload-file 890-1001 ./datasheet.pdf --category "CAD Data" --title "Datasheet"
+```
+
+### 3) Output control
+
+Most commands support a JSON output mode.  
+Example:
+
+```bash
+gladiator bom 890-1001 --output json
+```
+
+### Example sessions
+
+#### Human-readable
+
+```bash
+$ gladiator list-files 101-1031
+Files for 101-1031 rev (latest approved)
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓
+┃ Name                                 ┃ Size  ┃ Checksum            ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩
+│ Drawing.pdf                          │ 12345 │ d41d8cd98f00b204e…  │
+└──────────────────────────────────────┴───────┴─────────────────────┘
+```
+
+#### JSON output
+
+```bash
+$ gladiator list-files 101-1031 --format json
+{
+  "article": "101-1031",
+  "revision": "EFFECTIVE",
+  "files": [
+    {
+      "filename": "Drawing.pdf",
+      "size": 12345,
+      "checksum": "d41d8cd98f00b204e9800998ecf8427e"
+    }
+  ]
+}
+```
+
+## Programmatic use
+
+```python
+from gladiator import ArenaClient, load_config
+
+client = ArenaClient(load_config())
+rev = client.get_latest_approved_revision("890-1001")
+files = client.list_files("890-1001", rev)
+```
+
+## Development
+
+```bash
+python -m pip install -e .[dev]
+python -m build
+```
+
+## FAQ
+
+- **Where is the config kept?**
+  `~/.config/gladiator/login.json` (override with `GLADIATOR_CONFIG`)
+
+- **How do I run non-interactively?**
+  Pass `--ci` together with `--username` and `--password` (or use environment variables).
+
+- **What does `--recursive` do?**
+  Expands subassemblies and downloads or lists all contained items up to the given `--max-depth`.
+
+- **How does Gladiator handle authentication?**
+  It performs a `/login` call and stores the resulting `arenaSessionId` for reuse. If it expires, re-run `gladiator login`.
+
+

{lr_gladiator-0.7.0 → lr_gladiator-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lr-gladiator"
-version = "0.7.0"
+version = "0.9.0"
 description = "CLI and Python client for Arena PLM (app.bom.com): login, get revisions, list/download attachments, and upload to working revisions."
 readme = "README.md"
 requires-python = ">=3.9"

{lr_gladiator-0.7.0 → lr_gladiator-0.9.0}/src/gladiator/arena.py

@@ -9,6 +9,7 @@ from pathlib import Path
 from typing import Dict, List, Optional, Tuple
 import requests
 from .config import LoginConfig
+from .checksums import sha256_file
 
 
 class ArenaError(RuntimeError):
@@ -252,7 +253,7 @@ class ArenaClient:
         description: Optional[str] = None,
         primary: bool = True,
         latest_edition_association: bool = True,
-        edition: str = "1",
+        edition: str = None,
     ) -> Dict:
         """
         Update-if-exists-else-create semantics, matching the bash script:
@@ -476,16 +477,16 @@ class ArenaClient:
                     "id": row.get("guid") or row.get("id"),
                     "fileGuid": file_guid,
                     "name": f.get("name") or f.get("title"),
+                    "title": f.get("title"),
                     "filename": f.get("name") or f.get("title"),
                     "size": f.get("size"),
-                    "checksum": f.get("checksum") or f.get("md5"),
                     "haveContent": f.get("haveContent", True),
                     "downloadUrl": (
                         f"{self._api_base()}/files/{file_guid}/content"
                         if file_guid
                         else None
                     ),
-                    "version": f.get("version") or f.get("edition"),
+                    "edition": f.get("edition"),
                     "updatedAt": f.get("lastModifiedDateTime")
                     or f.get("lastModifiedDate")
                     or f.get("creationDateTime"),
@@ -571,14 +572,13 @@ class ArenaClient:
                     "name": f.get("name") or f.get("title"),
                     "filename": f.get("name") or f.get("title"),
                     "size": f.get("size"),
-                    "checksum": f.get("checksum") or f.get("md5"),
                     "haveContent": f.get("haveContent", True),
                     "downloadUrl": (
                         f"{self._api_base()}/files/{file_guid}/content"
                         if file_guid
                         else None
                     ),
-                    "version": f.get("version") or f.get("edition"),
+                    "edition": f.get("edition"),
                     "updatedAt": f.get("lastModifiedDateTime")
                     or f.get("lastModifiedDate")
                     or f.get("creationDateTime"),
@@ -604,6 +604,13 @@ class ArenaClient:
         if not file_path.exists() or not file_path.is_file():
             raise ArenaError(f"File not found: {file_path}")
 
+        filename = file_path.name  # Use truncated SHA256 hash if no edition is provided
+        if not edition:
+            # Arena seems to only accept 16 characters of edition information.
+            # The hex digest gives 16 hex × 4 bits = 64 bits of entropy.
+            # Less than a million files, collision risk is practically zero (~1 / 10^8).
+            edition = sha256_file(file_path)[:16]
+
         # 0) Resolve EFFECTIVE revision guid from item number
         effective_guid = self._api_resolve_item_guid(item_number)
 
@@ -674,6 +681,17 @@ class ArenaClient:
                     if existing_ct is not None:
                         self.session.headers["Content-Type"] = existing_ct
             ur.raise_for_status()
+
+            # Update the edition label on the File itself
+            try:
+                put_url = f"{self._api_base()}/files/{file_guid}"
+                self._log(f"PUT {put_url} (set edition={edition})")
+                pr = self.session.put(put_url, json={"edition": str(edition)})
+                pr.raise_for_status()
+            except requests.HTTPError as e:
+                # Don't fail the whole operation if the label update is rejected
+                self._log(f"Edition update failed for {file_guid}: {e}")
+
             # Many tenants return 201 with no JSON for content updates. Be flexible.
             data = self._try_json(ur)
             if data is None:
@@ -683,6 +701,7 @@ class ArenaClient:
                     "status": ur.status_code,
                     "fileGuid": file_guid,
                     "location": ur.headers.get("Location"),
+                    "edition": str(edition),
                 }
             return data
 
@@ -706,7 +725,7 @@ class ArenaClient:
             )
 
         # 3) Prepare multipart (create association)
-        title = title or file_path.stem
+        title = title or file_path.name
         file_format = file_format or (
             file_path.suffix[1:].lower() if file_path.suffix else "bin"
         )
@@ -754,6 +773,22 @@ class ArenaClient:
         # Normalize common fields we use elsewhere
         row = resp if isinstance(resp, dict) else {}
         f = row.get("file", {})
+
+        # Ensure the edition label is exactly what we asked for (some tenants ignore form edition)
+        try:
+            file_guid_created = (f or {}).get("guid")
+            if file_guid_created and str(edition):
+                put_url = f"{self._api_base()}/files/{file_guid_created}"
+                self._log(f"PUT {put_url} (set edition={edition})")
+                pr = self.session.put(put_url, json={"edition": str(edition)})
+                pr.raise_for_status()
+                # Update local 'f' edition if the PUT succeeded
+                f["edition"] = str(edition)
+        except requests.HTTPError as e:
+            self._log(
+                f"Edition update after create failed for {file_guid_created}: {e}"
+            )
+
         return {
             "associationGuid": row.get("guid"),
             "primary": row.get("primary"),
@@ -765,7 +800,7 @@ class ArenaClient:
                 "size": f.get("size"),
                 "format": f.get("format"),
                 "category": (f.get("category") or {}).get("name"),
-                "edition": f.get("edition"),
+                "edition": f.get("edition") or str(edition),
                 "lastModifiedDateTime": f.get("lastModifiedDateTime"),
             },
             "downloadUrl": (

lr_gladiator-0.9.0/src/gladiator/checksums.py

@@ -0,0 +1,31 @@
+#! /usr/bin/env python
+# -*- coding: utf-8 -*-
+# src/gladiator/checksums.py
+from __future__ import annotations
+from pathlib import Path
+import hashlib
+import base64
+
+
+def sha256_file(path: Path, chunk_size: int = 128 * 1024) -> str:
+    """
+    Return the lowercase hex SHA-256 of the file at `path`.
+    Streams the file in chunks to support large files.
+    """
+    h = hashlib.sha256()
+    with open(path, "rb") as f:
+        for chunk in iter(lambda: f.read(chunk_size), b""):
+            h.update(chunk)
+    return h.hexdigest()
+
+
+def md5_base64_file(path: Path, chunk_size: int = 128 * 1024) -> str:
+    """
+    Return base64-encoded MD5 digest of the file at `path`,
+    suitable for the Content-MD5 header per RFC 1864.
+    """
+    h = hashlib.md5()
+    with open(path, "rb") as f:
+        for chunk in iter(lambda: f.read(chunk_size), b""):
+            h.update(chunk)
+    return base64.b64encode(h.digest()).decode("ascii")

{lr_gladiator-0.7.0 → lr_gladiator-0.9.0}/src/gladiator/cli.py

@@ -8,13 +8,33 @@ from typing import Optional
 import typer
 from rich import print
 from rich.table import Table
+from rich.console import Console
+from rich.status import Status
 from getpass import getpass
 import requests
 import sys
+import os
 from .config import LoginConfig, save_config, load_config, save_config_raw, CONFIG_PATH
 from .arena import ArenaClient, ArenaError
 
 app = typer.Typer(add_completion=False, help="Arena PLM command-line utility")
+console = Console()
+
+# --- tiny helper to show a spinner when appropriate ---
+from contextlib import contextmanager
+
+
+@contextmanager
+def spinner(message: str, enabled: bool = True):
+    """
+    Show a Rich spinner while the body executes.
+    Auto-disables if stdout is not a TTY (e.g., CI) or enabled=False.
+    """
+    if enabled and sys.stdout.isatty():
+        with console.status(message, spinner="dots"):
+            yield
+    else:
+        yield
 
 
 @app.command()
@@ -36,10 +56,7 @@ def login(
         "CI/CD integration", help="Arena-Usage-Reason header"
     ),
 ):
-    """Create or update ~/.config/gladiator/login.json for subsequent commands.
-
-    This performs a `/login` call against Arena and stores the JSON (including arenaSessionId) in login.json.
-    """
+    """Create or update ~/.config/gladiator/login.json for subsequent commands."""
     if not username and not non_interactive:
         username = typer.prompt("Email/username")
     if not password and not non_interactive:
@@ -59,27 +76,22 @@ def login(
         "User-Agent": "gladiator-arena/0.1",
     }
     url = f"{(base_url or '').rstrip('/')}/login"
-    resp = sess.post(
-        url, headers=headers, json={"email": username, "password": password}
-    )
     try:
-        resp.raise_for_status()
+        with spinner("Logging in…", enabled=sys.stdout.isatty()):
+            resp = sess.post(
+                url, headers=headers, json={"email": username, "password": password}
+            )
+            resp.raise_for_status()
     except Exception as e:
         typer.secho(
-            f"Login failed: {e} Body: {resp.text[:400]}", fg=typer.colors.RED, err=True
+            f"Login failed: {e} Body: {getattr(resp, 'text', '')[:400]}",
+            fg=typer.colors.RED,
+            err=True,
         )
         raise typer.Exit(2)
 
     data = resp.json()
-
-    # Merge our client settings alongside the session info into the same file (compatible with your bash scripts)
-    data.update(
-        {
-            "base_url": base_url,
-            "verify_tls": verify_tls,
-            "reason": reason,
-        }
-    )
+    data.update({"base_url": base_url, "verify_tls": verify_tls, "reason": reason})
     save_config_raw(data)
     print(f"[green]Saved session to {CONFIG_PATH}[/green]")
 
@@ -97,9 +109,13 @@ def latest_approved(
     ),
 ):
     """Print latest approved revision for the given item number."""
+    json_mode = (format or "").lower() == "json"
     try:
-        rev = _client().get_latest_approved_revision(item)
-        if format == "json":
+        with spinner(
+            f"Resolving latest approved revision for {item}…", enabled=not json_mode
+        ):
+            rev = _client().get_latest_approved_revision(item)
+        if json_mode:
             json.dump({"article": item, "revision": rev}, sys.stdout, indent=2)
             sys.stdout.write("\n")
         else:
@@ -124,9 +140,15 @@ def list_files(
         None, "--format", "-f", help="Output format: human (default) or json"
     ),
 ):
+    json_mode = (format or "").lower() == "json"
     try:
-        files = _client().list_files(item, revision)
-        if format == "json":
+        with spinner(
+            f"Listing files for {item} ({revision or 'EFFECTIVE'})…",
+            enabled=not json_mode,
+        ):
+            files = _client().list_files(item, revision)
+
+        if json_mode:
             json.dump(
                 {"article": item, "revision": revision, "files": files},
                 sys.stdout,
@@ -138,11 +160,9 @@ def list_files(
         table = Table(title=f"Files for {item} rev {revision or '(latest approved)'}")
         table.add_column("Name")
         table.add_column("Size", justify="right")
-        table.add_column("Checksum")
+        table.add_column("Edition")
         for f in files:
-            table.add_row(
-                str(f.get("filename")), str(f.get("size")), str(f.get("checksum"))
-            )
+            table.add_row(str(f.get("name")), str(f.get("size")), str(f.get("edition")))
         print(table)
     except requests.HTTPError as e:
         typer.secho(f"Arena request failed: {e}", fg=typer.colors.RED, err=True)
@@ -174,12 +194,19 @@ def bom(
     ),
 ):
     """List the BOM lines for an item revision."""
+    json_mode = output.lower() == "json"
     try:
-        lines = _client().get_bom(
-            item, revision, recursive=recursive, max_depth=max_depth
-        )
+        with spinner(
+            f"Fetching BOM for {item} ({revision or 'EFFECTIVE'})"
+            + (" [recursive]" if recursive else "")
+            + "…",
+            enabled=not json_mode,
+        ):
+            lines = _client().get_bom(
+                item, revision, recursive=recursive, max_depth=max_depth
+            )
 
-        if output.lower() == "json":
+        if json_mode:
             print(json.dumps({"count": len(lines), "results": lines}, indent=2))
             return
 
@@ -193,7 +220,7 @@ def bom(
 
         for ln in lines:
             lvl = int(ln.get("level", 0) or 0)
-            indent = "  " * lvl  # 2 spaces per level
+            indent = "  " * lvl
             table.add_row(
                 str(ln.get("lineNumber") or ""),
                 str(ln.get("quantity") or ""),
@@ -233,14 +260,21 @@ def get_files(
         help="Maximum recursion depth for --recursive (1 = only direct children).",
     ),
 ):
+    json_mode = False  # this command prints file paths line-by-line (no JSON mode here)
     try:
-        out_dir = out or Path(item)  # article numbers are never files; safe as dir name
-        if recursive:
-            paths = _client().download_files_recursive(
-                item, revision, out_dir=out_dir, max_depth=max_depth
-            )
-        else:
-            paths = _client().download_files(item, revision, out_dir=out_dir)
+        out_dir = out or Path(item)
+        with spinner(
+            f"Downloading files for {item} ({revision or 'EFFECTIVE'})"
+            + (" [recursive]" if recursive else "")
+            + f" → {out_dir}…",
+            enabled=not json_mode,
+        ):
+            if recursive:
+                paths = _client().download_files_recursive(
+                    item, revision, out_dir=out_dir, max_depth=max_depth
+                )
+            else:
+                paths = _client().download_files(item, revision, out_dir=out_dir)
 
         for p in paths:
             print(str(p))
@@ -277,25 +311,26 @@ def upload_file(
         False, "--primary/--no-primary", help="Mark association as primary"
     ),
     edition: str = typer.Option(
-        "1",
+        None,
         "--edition",
-        help="Edition number when creating a new association (default: 1)",
+        help="Edition number when creating a new association (default: SHA256 checksum of file)",
     ),
 ):
     """If a file with the same filename exists: update its content (new edition).
     Otherwise: create a new association on the WORKING revision (requires --edition)."""
     try:
-        result = _client().upload_file_to_working(
-            item,
-            file,
-            reference,
-            title=title,
-            category_name=category,
-            file_format=file_format,
-            description=description,
-            primary=primary,
-            edition=edition,
-        )
+        with spinner(f"Uploading {file.name} to {item}…", enabled=sys.stdout.isatty()):
+            result = _client().upload_file_to_working(
+                item,
+                file,
+                reference,
+                title=title,
+                category_name=category,
+                file_format=file_format,
+                description=description,
+                primary=primary,
+                edition=edition,
+            )
         print(json.dumps(result, indent=2))
     except requests.HTTPError as e:
         typer.secho(f"Arena request failed: {e}", fg=typer.colors.RED, err=True)

lr_gladiator-0.9.0/src/lr_gladiator.egg-info/PKG-INFO

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: lr-gladiator
+Version: 0.9.0
+Summary: CLI and Python client for Arena PLM (app.bom.com): login, get revisions, list/download attachments, and upload to working revisions.
+Author-email: Jonas Estberger <jonas.estberger@lumenradio.com>
+License: MIT
+Keywords: Arena,PLM,BOM,attachments,CLI
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.32
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: pydantic>=2.8
+Provides-Extra: dev
+Requires-Dist: build>=1.2.1; extra == "dev"
+Requires-Dist: twine>=5.1.1; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: license-file
+
+# gladiator-arena
+
+CLI + Python client for interacting with the Arena PLM.
+
+## Install
+
+```bash
+pip install lr-gladiator
+```
+
+## Quick start
+
+### 1) Create `login.json`
+
+Interactive login (prompts for username/password):
+
+```bash
+gladiator login
+```
+
+Non-interactive (for CI/CD):
+
+```bash
+gladiator login --username "$ARENA_USERNAME" --password "$ARENA_PASSWORD" --ci
+```
+
+By default, this stores session details at:
+
+```
+~/.config/gladiator/login.json
+```
+
+### 2) Common commands
+
+Get the latest approved revision for an item:
+
+```bash
+gladiator latest-approved 890-1001
+```
+
+List all files on an item (defaults to the latest approved revision):
+
+```bash
+gladiator list-files 890-1001
+```
+
+Output JSON instead of a table:
+
+```bash
+gladiator list-files 890-1001 --format json
+```
+
+List the Bill of Materials (BOM) for an item:
+
+```bash
+gladiator bom 890-1001
+```
+
+Recursively expand subassemblies up to two levels deep:
+
+```bash
+gladiator bom 890-1001 --recursive --max-depth 2
+```
+
+Download attached files to a directory named after the article:
+
+```bash
+gladiator get-files 890-1001
+```
+
+Specify a different output directory:
+
+```bash
+gladiator get-files 890-1001 --out downloads/
+```
+
+Recursively download all files in the full BOM tree:
+
+```bash
+gladiator get-files 890-1001 --recursive
+```
+
+Upload or update a file on the working revision:
+
+```bash
+gladiator upload-file 890-1001 ./datasheet.pdf --category "CAD Data" --title "Datasheet"
+```
+
+### 3) Output control
+
+Most commands support a JSON output mode.  
+Example:
+
+```bash
+gladiator bom 890-1001 --output json
+```
+
+### Example sessions
+
+#### Human-readable
+
+```bash
+$ gladiator list-files 101-1031
+Files for 101-1031 rev (latest approved)
+┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓
+┃ Name                                 ┃ Size  ┃ Checksum            ┃
+┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩
+│ Drawing.pdf                          │ 12345 │ d41d8cd98f00b204e…  │
+└──────────────────────────────────────┴───────┴─────────────────────┘
+```
+
+#### JSON output
+
+```bash
+$ gladiator list-files 101-1031 --format json
+{
+  "article": "101-1031",
+  "revision": "EFFECTIVE",
+  "files": [
+    {
+      "filename": "Drawing.pdf",
+      "size": 12345,
+      "checksum": "d41d8cd98f00b204e9800998ecf8427e"
+    }
+  ]
+}
+```
+
+## Programmatic use
+
+```python
+from gladiator import ArenaClient, load_config
+
+client = ArenaClient(load_config())
+rev = client.get_latest_approved_revision("890-1001")
+files = client.list_files("890-1001", rev)
+```
+
+## Development
+
+```bash
+python -m pip install -e .[dev]
+python -m build
+```
+
+## FAQ
+
+- **Where is the config kept?**
+  `~/.config/gladiator/login.json` (override with `GLADIATOR_CONFIG`)
+
+- **How do I run non-interactively?**
+  Pass `--ci` together with `--username` and `--password` (or use environment variables).
+
+- **What does `--recursive` do?**
+  Expands subassemblies and downloads or lists all contained items up to the given `--max-depth`.
+
+- **How does Gladiator handle authentication?**
+  It performs a `/login` call and stores the resulting `arenaSessionId` for reuse. If it expires, re-run `gladiator login`.
+
+

{lr_gladiator-0.7.0 → lr_gladiator-0.9.0}/src/lr_gladiator.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ README.md
 pyproject.toml
 src/gladiator/__init__.py
 src/gladiator/arena.py
+src/gladiator/checksums.py
 src/gladiator/cli.py
 src/gladiator/config.py
 src/lr_gladiator.egg-info/PKG-INFO
@@ -11,4 +12,5 @@ src/lr_gladiator.egg-info/dependency_links.txt
 src/lr_gladiator.egg-info/entry_points.txt
 src/lr_gladiator.egg-info/requires.txt
 src/lr_gladiator.egg-info/top_level.txt
+tests/test_checksums.py
 tests/test_smoke.py

lr_gladiator-0.9.0/tests/test_checksums.py

@@ -0,0 +1,16 @@
+# tests/test_md5_content_header.py
+from pathlib import Path
+from gladiator.checksums import md5_base64_file
+import hashlib, base64, os, tempfile
+
+
+def test_md5_base64_file_matches_python():
+    payload = b"hello world"
+    with tempfile.NamedTemporaryFile(delete=False) as tf:
+        tf.write(payload)
+        p = Path(tf.name)
+    try:
+        expected = base64.b64encode(hashlib.md5(payload).digest()).decode("ascii")
+        assert md5_base64_file(p) == expected
+    finally:
+        os.unlink(p)

lr_gladiator-0.7.0/PKG-INFO

@@ -1,90 +0,0 @@
-Metadata-Version: 2.4
-Name: lr-gladiator
-Version: 0.7.0
-Summary: CLI and Python client for Arena PLM (app.bom.com): login, get revisions, list/download attachments, and upload to working revisions.
-Author-email: Jonas Estberger <jonas.estberger@lumenradio.com>
-License: MIT
-Keywords: Arena,PLM,BOM,attachments,CLI
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.32
-Requires-Dist: typer>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: pydantic>=2.8
-Provides-Extra: dev
-Requires-Dist: build>=1.2.1; extra == "dev"
-Requires-Dist: twine>=5.1.1; extra == "dev"
-Requires-Dist: wheel; extra == "dev"
-Dynamic: license-file
-
-# gladiator-arena
-
-CLI + Python client for interacting with the Arena PLM.
-
-## Install
-
-```bash
-pip install lr-gladiator
-```
-
-## Quick start
-
-### 1) Create `login.json`
-
-Interactive:
-
-```bash
-gladiator login
-```
-
-`login.json` is stored at `~/.config/gladiator/login.json` by default.
-
-### 2) Queries
-
-Get latest approved revision for an item:
-
-```bash
-gladiator latest-approved ABC-1234
-```
-
-List files on an item (defaults to latest approved):
-
-```bash
-gladiator list-files ABC-1234
-```
-
-Download files:
-
-```bash
-gladiator get-files ABC-1234 --out downloads/
-```
-
-Upload a file to the working revision
-
-```bash
-gladiator upload-file ABC-1234 ./datasheet.pdf --reference datasheet
-```
-
-## Programmatic use
-
-```python
-from gladiator import ArenaClient, load_config
-client = ArenaClient(load_config())
-rev = client.get_latest_approved_revision("ABC-1234")
-files = client.list_files("ABC-1234", rev)
-```
-
-## Development
-
-```bash
-python -m pip install -e .[dev]
-python -m build
-```
-
-## FAQ
-
-- **Where is the config kept?** `~/.config/gladiator/login.json` (override via `GLADIATOR_CONFIG`).

lr_gladiator-0.7.0/README.md

@@ -1,67 +0,0 @@
-# gladiator-arena
-
-CLI + Python client for interacting with the Arena PLM.
-
-## Install
-
-```bash
-pip install lr-gladiator
-```
-
-## Quick start
-
-### 1) Create `login.json`
-
-Interactive:
-
-```bash
-gladiator login
-```
-
-`login.json` is stored at `~/.config/gladiator/login.json` by default.
-
-### 2) Queries
-
-Get latest approved revision for an item:
-
-```bash
-gladiator latest-approved ABC-1234
-```
-
-List files on an item (defaults to latest approved):
-
-```bash
-gladiator list-files ABC-1234
-```
-
-Download files:
-
-```bash
-gladiator get-files ABC-1234 --out downloads/
-```
-
-Upload a file to the working revision
-
-```bash
-gladiator upload-file ABC-1234 ./datasheet.pdf --reference datasheet
-```
-
-## Programmatic use
-
-```python
-from gladiator import ArenaClient, load_config
-client = ArenaClient(load_config())
-rev = client.get_latest_approved_revision("ABC-1234")
-files = client.list_files("ABC-1234", rev)
-```
-
-## Development
-
-```bash
-python -m pip install -e .[dev]
-python -m build
-```
-
-## FAQ
-
-- **Where is the config kept?** `~/.config/gladiator/login.json` (override via `GLADIATOR_CONFIG`).

lr_gladiator-0.7.0/src/lr_gladiator.egg-info/PKG-INFO

@@ -1,90 +0,0 @@
-Metadata-Version: 2.4
-Name: lr-gladiator
-Version: 0.7.0
-Summary: CLI and Python client for Arena PLM (app.bom.com): login, get revisions, list/download attachments, and upload to working revisions.
-Author-email: Jonas Estberger <jonas.estberger@lumenradio.com>
-License: MIT
-Keywords: Arena,PLM,BOM,attachments,CLI
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.32
-Requires-Dist: typer>=0.12
-Requires-Dist: rich>=13.7
-Requires-Dist: pydantic>=2.8
-Provides-Extra: dev
-Requires-Dist: build>=1.2.1; extra == "dev"
-Requires-Dist: twine>=5.1.1; extra == "dev"
-Requires-Dist: wheel; extra == "dev"
-Dynamic: license-file
-
-# gladiator-arena
-
-CLI + Python client for interacting with the Arena PLM.
-
-## Install
-
-```bash
-pip install lr-gladiator
-```
-
-## Quick start
-
-### 1) Create `login.json`
-
-Interactive:
-
-```bash
-gladiator login
-```
-
-`login.json` is stored at `~/.config/gladiator/login.json` by default.
-
-### 2) Queries
-
-Get latest approved revision for an item:
-
-```bash
-gladiator latest-approved ABC-1234
-```
-
-List files on an item (defaults to latest approved):
-
-```bash
-gladiator list-files ABC-1234
-```
-
-Download files:
-
-```bash
-gladiator get-files ABC-1234 --out downloads/
-```
-
-Upload a file to the working revision
-
-```bash
-gladiator upload-file ABC-1234 ./datasheet.pdf --reference datasheet
-```
-
-## Programmatic use
-
-```python
-from gladiator import ArenaClient, load_config
-client = ArenaClient(load_config())
-rev = client.get_latest_approved_revision("ABC-1234")
-files = client.list_files("ABC-1234", rev)
-```
-
-## Development
-
-```bash
-python -m pip install -e .[dev]
-python -m build
-```
-
-## FAQ
-
-- **Where is the config kept?** `~/.config/gladiator/login.json` (override via `GLADIATOR_CONFIG`).