lr-gladiator 0.6.0__tar.gz → 0.8.0__tar.gz

lr_gladiator-0.8.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: lr-gladiator
+Version: 0.8.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.8.0/README.md

@@ -0,0 +1,158 @@
+# 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.6.0 → lr_gladiator-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lr-gladiator"
-version = "0.6.0"
+version = "0.8.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.6.0 → lr_gladiator-0.8.0}/src/gladiator/arena.py

@@ -156,21 +156,88 @@ class ArenaClient:
         out_dir.mkdir(parents=True, exist_ok=True)
         downloaded: List[Path] = []
         for f in files:
+            # Skip associations with no blob
+            if not f.get("haveContent", True):
+                self._log(
+                    f"Skip {item_number}: file {f.get('filename')} has no content"
+                )
+                continue
+
             url = f.get("downloadUrl") or f.get("url")
             filename = f.get("filename") or f.get("name")
             if not url or not filename:
                 continue
+
             p = out_dir / filename
-            with self.session.get(
-                url,
-                stream=True,
-                headers={"arena_session_id": self.cfg.arena_session_id or ""},
-            ) as r:
-                r.raise_for_status()
-                with open(p, "wb") as fh:
-                    for chunk in r.iter_content(128 * 1024):
-                        fh.write(chunk)
-            downloaded.append(p)
+            try:
+                with self.session.get(
+                    url,
+                    stream=True,
+                    headers={"arena_session_id": self.cfg.arena_session_id or ""},
+                ) as r:
+                    # If the blob is missing/forbidden, don’t abort the whole command
+                    if r.status_code in (400, 403, 404):
+                        self._log(
+                            f"Skip {item_number}: {filename} content unavailable "
+                            f"(HTTP {r.status_code})"
+                        )
+                        continue
+                    r.raise_for_status()
+                    with open(p, "wb") as fh:
+                        for chunk in r.iter_content(128 * 1024):
+                            fh.write(chunk)
+                downloaded.append(p)
+            except requests.HTTPError as e:
+                # Be resilient: log and continue
+                self._log(f"Download failed for {filename}: {e}")
+                continue
+        return downloaded
+
+    def download_files_recursive(
+        self,
+        item_number: str,
+        revision: Optional[str] = None,
+        out_dir: Path = Path("."),
+        *,
+        max_depth: Optional[int] = None,
+    ) -> List[Path]:
+        """
+        Download files for `item_number` AND, recursively, for all subassemblies
+        discovered via the BOM. Each child item is placed under a subdirectory:
+            <out_dir>/<child_item_number>/
+        Root files go directly in <out_dir>/.
+
+        Depth semantics match `get_bom(..., recursive=True, max_depth=...)`.
+        """
+        # Ensure the root directory exists
+        out_dir.mkdir(parents=True, exist_ok=True)
+
+        downloaded: List[Path] = []
+        # 1) Download files for the root item into out_dir
+        downloaded.extend(self.download_files(item_number, revision, out_dir=out_dir))
+
+        # 2) Expand BOM recursively and collect unique child item numbers
+        lines = self.get_bom(
+            item_number,
+            revision,
+            recursive=True,
+            max_depth=max_depth,
+        )
+        seen_children = set()
+        for ln in lines:
+            child_num = (ln or {}).get("itemNumber")
+            if not child_num or child_num == item_number:
+                continue
+            if child_num in seen_children:
+                continue
+            seen_children.add(child_num)
+
+            # Place each child's files under <out_dir>/<child_num>/
+            child_dir = out_dir / child_num
+            downloaded.extend(
+                self.download_files(child_num, revision, out_dir=child_dir)
+            )
+
         return downloaded
 
     def upload_file_to_working(
@@ -406,18 +473,18 @@ class ArenaClient:
             file_guid = f.get("guid") or f.get("id")
             norm.append(
                 {
-                    "id": row.get("guid") or row.get("id"),  # association id
-                    "fileGuid": file_guid,  # actual file id
+                    "id": row.get("guid") or row.get("id"),
+                    "fileGuid": file_guid,
                     "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
                     ),
-                    # for “pick latest” helper:
                     "version": f.get("version") or f.get("edition"),
                     "updatedAt": f.get("lastModifiedDateTime")
                     or f.get("lastModifiedDate")
@@ -505,6 +572,7 @@ class ArenaClient:
                     "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

{lr_gladiator-0.6.0 → lr_gladiator-0.8.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,
@@ -174,12 +196,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 +222,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 ""),
@@ -221,10 +250,34 @@ def get_files(
         "--out",
         help="Output directory (default: a folder named after the item number)",
     ),
+    recursive: bool = typer.Option(
+        False,
+        "--recursive/--no-recursive",
+        help="Recursively download files from subassemblies",
+    ),
+    max_depth: Optional[int] = typer.Option(
+        None,
+        "--max-depth",
+        min=1,
+        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)
-        paths = _client().download_files(item, revision, out_dir=out_dir)
+        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))
     except requests.HTTPError as e:
@@ -268,17 +321,18 @@ def upload_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.8.0/src/lr_gladiator.egg-info/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: lr-gladiator
+Version: 0.8.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.6.0/PKG-INFO

@@ -1,90 +0,0 @@
-Metadata-Version: 2.4
-Name: lr-gladiator
-Version: 0.6.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.6.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.6.0/src/lr_gladiator.egg-info/PKG-INFO

@@ -1,90 +0,0 @@
-Metadata-Version: 2.4
-Name: lr-gladiator
-Version: 0.6.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`).