emby-cli 0.5.0__tar.gz → 0.5.2__tar.gz

{emby_cli-0.5.0 → emby_cli-0.5.2}/.github/workflows/ci.yml

@@ -29,5 +29,8 @@ jobs:
           python -m pip install --upgrade pip
           pip install -e ".[dev]"
 
+      - name: Lint with ruff
+        run: ruff check .
+
       - name: Run tests
         run: pytest -q

{emby_cli-0.5.0 → emby_cli-0.5.2}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.5.2
+
+Changed:
+
+- Validation and per-item `error:` messages go to **stderr** (tables and normal progress stay on stdout), so scripts can separate data from failures.
+- `download --dry-run`: planned items count as `ok` in the Done summary (was always `ok=0`).
+- 401 re-authentication is limited to **one attempt per request** (no retry loop if the new token is also rejected).
+
+Fixed:
+
+- HLS segment downloads retry when the body disconnects mid-stream and overwrite the partial segment.
+- Reauth invalidates the cached session before obtaining a new AccessToken.
+
+Internal:
+
+- Shared helpers for retries/backoff, pagination, download loop, item-id resolution, and optional request kwargs.
+- TypedDict shapes for Emby API responses; Ruff lint gate in CI.
+- Much stronger automated tests (retry matrix, title resolution, download skip/dry-run, stderr contracts). Editable installs link to `src/` so pytest sees live edits.
+
+## 0.5.1
+
+- Set HTTP `User-Agent` to `emby-cli/<version>` (clear client identity; replaces the default `python-requests` UA).
+- `search`: when results are capped by `--count`, print `Total: N (out of M)`.
+- README: example tweaks and docs polish.
+
 ## 0.5.0
 
 Breaking:

{emby_cli-0.5.0 → emby_cli-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: emby-cli
-Version: 0.5.0
+Version: 0.5.2
 Summary: CLI to list, search, play, and download/backup original media from an Emby server via its REST API.
 Project-URL: Homepage, https://github.com/soukron/emby-cli
 Project-URL: Repository, https://github.com/soukron/emby-cli
@@ -29,6 +29,7 @@ Requires-Dist: tqdm>=4.66
 Provides-Extra: dev
 Requires-Dist: build>=1.0; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: twine>=5.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -66,7 +67,7 @@ emby-cli info
 
 ```bash
 emby-cli search --item "matrix"
-emby-cli download --item "matrix" --pick-best-item
+emby-cli download --item "matrix (1999)" --pick-best-item
 ```
 
 Use `emby-cli help` for the command list, and `emby-cli <command> -h` for options.
@@ -88,7 +89,7 @@ Find movies, episodes, and other media — or list libraries:
 
 ```bash
 emby-cli search --item "fast and furious"
-emby-cli search --item "fast and furious" --count 50
+emby-cli search --item "fast and furious" --count 5
 emby-cli search --item --id 123456
 emby-cli search --library "peliculas"
 emby-cli search --library --all
@@ -110,7 +111,7 @@ emby-cli show --library --id 614156
 Open a title in an external player (VLC, mpv, IINA, …):
 
 ```bash
-emby-cli play --item "Pelicula (1980)" --pick-best-item
+emby-cli play --item "matrix (1999)" --pick-best-item
 emby-cli play --id 123456
 emby-cli play --id 111,222,333
 emby-cli play --id 123456 --player vlc --wait
@@ -125,8 +126,8 @@ Download a single title, a whole library, or a list of titles from a file:
 ```bash
 emby-cli download --item --id 123456
 emby-cli download --item --id 111,222,333
-emby-cli download --item "californication S01E01" --pick-best-item
-emby-cli download --library "PELICULAS 4K"
+emby-cli download --item "breaking bad S01E01" --pick-best-item
+emby-cli download --library "peliculas 4k"
 emby-cli download --from-file titles.txt
 ```
 
@@ -146,7 +147,7 @@ Useful options:
 
 - `Movie (2010)`
 - `Show S01E05`
-- `Show S01` — whole season (with `--item` or `--from-file`)
+- `Show S01` — whole season
 
 By default, matching is **strict**: a wrong year or several ambiguous results stops with a table of candidates. Add `--pick-best-item` to choose automatically (best quality up to 1080p).
 
@@ -156,11 +157,11 @@ Library downloads match the library **name** (case-insensitive, unique match req
 
 ## Logging in and switching servers
 
-| Approach | When to use |
-|----------|-------------|
-| `emby-cli login` | Recommended — saves a session and remembers the server |
-| API key | `--api-key` / `EMBY_API_KEY` (keys are not stored by `login`) |
-| Flags / env | `--server`, `--username`, `--password` or `EMBY_*` for one-off use |
+| Approach         | When to use                                                        |
+| ---------------- | ------------------------------------------------------------------ |
+| `emby-cli login` | Recommended — saves a session and remembers the server             |
+| API key          | `--api-key` / `EMBY_API_KEY` (keys are not stored by `login`)      |
+| Flags / env      | `--server`, `--username`, `--password` or `EMBY_*` for one-off use |
 
 Manage saved servers:
 
@@ -180,11 +181,11 @@ Sessions live under `~/.cache/emby-cli/auth.json` (override with `EMBY_CACHE_DIR
 
 Choose with `-m` / `EMBY_METHOD`:
 
-| Method | Best for |
-|--------|----------|
-| `download` (default) | Normal file download from Emby |
-| `stream` | Direct stream URL (similar to Emby Web) |
-| `hls` | HLS remux to `.mkv` |
+| Method               | Best for                                |
+| -------------------- | --------------------------------------- |
+| `download` (default) | Normal file download from Emby          |
+| `stream`             | Direct stream URL (similar to Emby Web) |
+| `hls`                | HLS remux to `.mkv`                     |
 
 ---
 
@@ -192,17 +193,17 @@ Choose with `-m` / `EMBY_METHOD`:
 
 Flags override environment variables. Optional template: `.env.example` (export the vars yourself — the CLI does not load `.env` files).
 
-| Variable | Description |
-|----------|-------------|
-| `EMBY_SERVER` | Server URL |
-| `EMBY_API_KEY` | API key |
-| `EMBY_USERNAME` / `EMBY_PASSWORD` | Username / password |
-| `EMBY_OUTPUT` | Download directory (default `./downloads`) |
-| `EMBY_METHOD` | `download`, `stream`, or `hls` |
-| `EMBY_PLAYER` | External player command or path |
-| `EMBY_ITEM_ID` | Default `--id` for item download / play |
-| `EMBY_CACHE_DIR` | Credentials directory (default `~/.cache/emby-cli`) |
-| `EMBY_NO_AUTH_CACHE` | `1` = disable session cache |
+| Variable                          | Description                                         |
+| --------------------------------- | --------------------------------------------------- |
+| `EMBY_SERVER`                     | Server URL                                          |
+| `EMBY_API_KEY`                    | API key                                             |
+| `EMBY_USERNAME` / `EMBY_PASSWORD` | Username / password                                 |
+| `EMBY_OUTPUT`                     | Download directory (default `./downloads`)          |
+| `EMBY_METHOD`                     | `download`, `stream`, or `hls`                      |
+| `EMBY_PLAYER`                     | External player command or path                     |
+| `EMBY_ITEM_ID`                    | Default `--id` for item download / play             |
+| `EMBY_CACHE_DIR`                  | Credentials directory (default `~/.cache/emby-cli`) |
+| `EMBY_NO_AUTH_CACHE`              | `1` = disable session cache                         |
 
 ---
 
@@ -210,19 +211,11 @@ Flags override environment variables. Optional template: `.env.example` (export
 
 - Prefer **search → show → download** when you are unsure of the exact title.
 - Prefer **IDs** (`--id`) when you already have them — no ambiguity.
-- Use **`--dry-run`** before a large library or file-list download.
+- Use `--dry-run` before a large library or file-list download.
 - Content totals in `info` can count multiple versions of the same title separately.
 
 ---
 
-## Responsible use
-
-This tool talks to Emby over its normal HTTP API. Whether download or playback is allowed depends on **how that server is configured** and on **the terms set by whoever runs it**.
-
-Use `emby-cli` only on servers you are authorized to access, and only in ways that comply with that server’s terms of use, policies, and applicable law. The authors provide the software as-is and are **not responsible** for misuse, for downloads from servers that disallow them, or for any consequences of using the tool.
-
----
-
 ## For contributors
 
 ```bash
@@ -232,7 +225,17 @@ pytest -q
 python -m build && twine check dist/*
 ```
 
-Releases: tag `vX.Y.Z` and push (or create a GitHub Release). CI publishes to PyPI via Trusted Publisher.
+Releases: tag `vX.Y.Z` and push. CI publishes to PyPI via Trusted Publisher.
+
+---
+
+## Responsible use
+
+This tool talks to Emby over its normal HTTP API. Whether download or playback is allowed depends on **how that server is configured** and on **the terms set by whoever runs it**.
+
+Use `emby-cli` only on servers you are authorized to access, and only in ways that comply with that server’s terms of use, policies, and applicable law. The authors provide the software as-is and are **not responsible** for misuse, for downloads from servers that disallow them, or for any consequences of using the tool.
+
+---
 
 ## License
 

{emby_cli-0.5.0 → emby_cli-0.5.2}/README.md

@@ -32,7 +32,7 @@ emby-cli info
 
 ```bash
 emby-cli search --item "matrix"
-emby-cli download --item "matrix" --pick-best-item
+emby-cli download --item "matrix (1999)" --pick-best-item
 ```
 
 Use `emby-cli help` for the command list, and `emby-cli <command> -h` for options.
@@ -54,7 +54,7 @@ Find movies, episodes, and other media — or list libraries:
 
 ```bash
 emby-cli search --item "fast and furious"
-emby-cli search --item "fast and furious" --count 50
+emby-cli search --item "fast and furious" --count 5
 emby-cli search --item --id 123456
 emby-cli search --library "peliculas"
 emby-cli search --library --all
@@ -76,7 +76,7 @@ emby-cli show --library --id 614156
 Open a title in an external player (VLC, mpv, IINA, …):
 
 ```bash
-emby-cli play --item "Pelicula (1980)" --pick-best-item
+emby-cli play --item "matrix (1999)" --pick-best-item
 emby-cli play --id 123456
 emby-cli play --id 111,222,333
 emby-cli play --id 123456 --player vlc --wait
@@ -91,8 +91,8 @@ Download a single title, a whole library, or a list of titles from a file:
 ```bash
 emby-cli download --item --id 123456
 emby-cli download --item --id 111,222,333
-emby-cli download --item "californication S01E01" --pick-best-item
-emby-cli download --library "PELICULAS 4K"
+emby-cli download --item "breaking bad S01E01" --pick-best-item
+emby-cli download --library "peliculas 4k"
 emby-cli download --from-file titles.txt
 ```
 
@@ -112,7 +112,7 @@ Useful options:
 
 - `Movie (2010)`
 - `Show S01E05`
-- `Show S01` — whole season (with `--item` or `--from-file`)
+- `Show S01` — whole season
 
 By default, matching is **strict**: a wrong year or several ambiguous results stops with a table of candidates. Add `--pick-best-item` to choose automatically (best quality up to 1080p).
 
@@ -122,11 +122,11 @@ Library downloads match the library **name** (case-insensitive, unique match req
 
 ## Logging in and switching servers
 
-| Approach | When to use |
-|----------|-------------|
-| `emby-cli login` | Recommended — saves a session and remembers the server |
-| API key | `--api-key` / `EMBY_API_KEY` (keys are not stored by `login`) |
-| Flags / env | `--server`, `--username`, `--password` or `EMBY_*` for one-off use |
+| Approach         | When to use                                                        |
+| ---------------- | ------------------------------------------------------------------ |
+| `emby-cli login` | Recommended — saves a session and remembers the server             |
+| API key          | `--api-key` / `EMBY_API_KEY` (keys are not stored by `login`)      |
+| Flags / env      | `--server`, `--username`, `--password` or `EMBY_*` for one-off use |
 
 Manage saved servers:
 
@@ -146,11 +146,11 @@ Sessions live under `~/.cache/emby-cli/auth.json` (override with `EMBY_CACHE_DIR
 
 Choose with `-m` / `EMBY_METHOD`:
 
-| Method | Best for |
-|--------|----------|
-| `download` (default) | Normal file download from Emby |
-| `stream` | Direct stream URL (similar to Emby Web) |
-| `hls` | HLS remux to `.mkv` |
+| Method               | Best for                                |
+| -------------------- | --------------------------------------- |
+| `download` (default) | Normal file download from Emby          |
+| `stream`             | Direct stream URL (similar to Emby Web) |
+| `hls`                | HLS remux to `.mkv`                     |
 
 ---
 
@@ -158,17 +158,17 @@ Choose with `-m` / `EMBY_METHOD`:
 
 Flags override environment variables. Optional template: `.env.example` (export the vars yourself — the CLI does not load `.env` files).
 
-| Variable | Description |
-|----------|-------------|
-| `EMBY_SERVER` | Server URL |
-| `EMBY_API_KEY` | API key |
-| `EMBY_USERNAME` / `EMBY_PASSWORD` | Username / password |
-| `EMBY_OUTPUT` | Download directory (default `./downloads`) |
-| `EMBY_METHOD` | `download`, `stream`, or `hls` |
-| `EMBY_PLAYER` | External player command or path |
-| `EMBY_ITEM_ID` | Default `--id` for item download / play |
-| `EMBY_CACHE_DIR` | Credentials directory (default `~/.cache/emby-cli`) |
-| `EMBY_NO_AUTH_CACHE` | `1` = disable session cache |
+| Variable                          | Description                                         |
+| --------------------------------- | --------------------------------------------------- |
+| `EMBY_SERVER`                     | Server URL                                          |
+| `EMBY_API_KEY`                    | API key                                             |
+| `EMBY_USERNAME` / `EMBY_PASSWORD` | Username / password                                 |
+| `EMBY_OUTPUT`                     | Download directory (default `./downloads`)          |
+| `EMBY_METHOD`                     | `download`, `stream`, or `hls`                      |
+| `EMBY_PLAYER`                     | External player command or path                     |
+| `EMBY_ITEM_ID`                    | Default `--id` for item download / play             |
+| `EMBY_CACHE_DIR`                  | Credentials directory (default `~/.cache/emby-cli`) |
+| `EMBY_NO_AUTH_CACHE`              | `1` = disable session cache                         |
 
 ---
 
@@ -176,19 +176,11 @@ Flags override environment variables. Optional template: `.env.example` (export
 
 - Prefer **search → show → download** when you are unsure of the exact title.
 - Prefer **IDs** (`--id`) when you already have them — no ambiguity.
-- Use **`--dry-run`** before a large library or file-list download.
+- Use `--dry-run` before a large library or file-list download.
 - Content totals in `info` can count multiple versions of the same title separately.
 
 ---
 
-## Responsible use
-
-This tool talks to Emby over its normal HTTP API. Whether download or playback is allowed depends on **how that server is configured** and on **the terms set by whoever runs it**.
-
-Use `emby-cli` only on servers you are authorized to access, and only in ways that comply with that server’s terms of use, policies, and applicable law. The authors provide the software as-is and are **not responsible** for misuse, for downloads from servers that disallow them, or for any consequences of using the tool.
-
----
-
 ## For contributors
 
 ```bash
@@ -198,7 +190,17 @@ pytest -q
 python -m build && twine check dist/*
 ```
 
-Releases: tag `vX.Y.Z` and push (or create a GitHub Release). CI publishes to PyPI via Trusted Publisher.
+Releases: tag `vX.Y.Z` and push. CI publishes to PyPI via Trusted Publisher.
+
+---
+
+## Responsible use
+
+This tool talks to Emby over its normal HTTP API. Whether download or playback is allowed depends on **how that server is configured** and on **the terms set by whoever runs it**.
+
+Use `emby-cli` only on servers you are authorized to access, and only in ways that comply with that server’s terms of use, policies, and applicable law. The authors provide the software as-is and are **not responsible** for misuse, for downloads from servers that disallow them, or for any consequences of using the tool.
+
+---
 
 ## License
 

{emby_cli-0.5.0 → emby_cli-0.5.2}/pyproject.toml

@@ -47,16 +47,17 @@ dev = [
     "pytest>=8.0",
     "build>=1.0",
     "twine>=5.0",
+    "ruff",
 ]
 
 [project.scripts]
 emby-cli = "emby_cli.cli:main"
 
 [tool.hatch.build.targets.wheel]
-only-include = ["src/emby_cli"]
+packages = ["src/emby_cli"]
 
-[tool.hatch.build.targets.wheel.force-include]
-"src/emby_cli" = "emby_cli"
+[tool.hatch.build]
+dev-mode-dirs = ["src"]
 
 [tool.hatch.version]
 source = "vcs"
@@ -66,3 +67,13 @@ version-file = "src/emby_cli/_version.py"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.ruff]
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I", "B", "UP"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/emby_cli/cli.py" = ["E402"]  # warnings.filterwarnings antes de import requests (intencional)

{emby_cli-0.5.0 → emby_cli-0.5.2}/src/emby_cli/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.5.0'
-__version_tuple__ = version_tuple = (0, 5, 0)
+__version__ = version = '0.5.2'
+__version_tuple__ = version_tuple = (0, 5, 2)
 
 __commit_id__ = commit_id = None

{emby_cli-0.5.0 → emby_cli-0.5.2}/src/emby_cli/cli.py

@@ -30,7 +30,6 @@ from emby_cli.credentials import (
     resolve_server,
 )
 
-
 _FORCE_HELP = "Re-download even if local file already matches"
 
 
@@ -340,10 +339,7 @@ def main() -> None:
 
     err = _validate_command_args(args.command, args)
     if err:
-        if err.startswith("error:"):
-            print(err, file=sys.stderr)
-        else:
-            print(err)
+        print(err, file=sys.stderr)
         sys.exit(1)
 
     client = _open_client(args)