ffmpeg-update 3.1.0__tar.gz → 3.1.2__tar.gz

{ffmpeg_update-3.1.0 → ffmpeg_update-3.1.2}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.3
 Name: ffmpeg-update
-Version: 3.1.0
+Version: 3.1.2
 Summary: Package manager for FFmpeg, FFprobe, and FFplay static binaries
 Keywords: updater,installer,downloader,program,executable,binary,command,line,cli,tool
 Author: Asadullah Shaikh
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
+Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: System Administrators
@@ -33,15 +34,12 @@ FFmpeg-update is a package manager for the FFmpeg suite, available as both a CLI
 
 # Features
 
-- Install [pre-built static binaries of] FFmpeg, FFprobe, and/or FFplay
-- Fetch latest *release* or *snapshot* builds
-- Configure custom installation location
-- Update to latest version
-- Check for updates
-- Uninstall from system
-- Progress bar with ETA
-- Smart permission handling
-- Atomic file system operations
+- Atomic installation
+- Concurrent downloads
+- Download progress bars
+- Configurable installation directory
+- Latest *release* and *snapshot* builds available
+- Automatic sudo escalation for privileged installation directory
 - Automatic operating system and machine architecture detection
 
 # Installation
@@ -63,7 +61,7 @@ ffup <install|update [--dry-run]|check|uninstall> [OPTIONS] [ffmpeg] [ffprobe] [
 Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND>`.
 
 > [!TIP]
-> Multiple names can be passed, e.g. `ffup install ffmpeg ffprobe`
+> Multiple names can be passed, e.g., `ffup install ffmpeg ffprobe`
 
 > [!NOTE]
 > Default is `ffmpeg`, if no name is passed
@@ -71,39 +69,39 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 ## Parameters
 
 - `--dir`: The path to the installation directory
-  - Environment variable: `$FFUP_DIR`/`$XDG_BIN_HOME`
   - Default: `~/.local/bin`
-  - Functions: `check`, `install`, `uninstall`, `update`
+  - Environment variable: `$FFUP_DIR`, `$XDG_BIN_HOME`
+  - Commands: `check`, `install`, `uninstall`, `update`
 
 - `--build`: The build type
+  - Default: `snapshot`
   - Choices: `release`, `snapshot`
   - Environment Variable: `$FFUP_BUILD`
-  - Default: `snapshot`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--arch`: The machine architecture
+  - Default: Auto-detect using `platform.machine()`
   - Choices: `amd64`, `arm64`
   - Environment Variable: `$FFUP_ARCH`
-  - Default: Auto-detect using `platform.machine()`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--os`: The operating system
+  - Default: Auto-detect using `platform.system()`
   - Choices: `linux`, `macos`
   - Environment Variable: `$FFUP_OS`
-  - Default: Auto-detect using `platform.system()`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--dry-run`: A flag to skip download/install, and only check for updates
-  - `ffup check` is an alias for `ffup update --dry-run`
   - Default: `False`
-  - Functions: `update`
+  - Commands: `update`
+  - Note: `ffup check` is an alias for `ffup update --dry-run`
 
 # API Reference
 
 ## Functions
 
-- `update(bins = {"ffmpeg"}, /, *, dry_run = False, dir, tempdir, progress, client) -> None`
-- `install(bins = {"ffmpeg"}, /, *, dir, tempdir, progress, client) -> None`
+- async `update(bins = {"ffmpeg"}, /, *, dry_run = False, dir, tempdir, progress, client) -> None`
+- async `install(bins = {"ffmpeg"}, /, *, dir, tempdir, progress, client) -> None`
 - `uninstall(bins = {"ffmpeg"}, /, *, dir) -> None`
 - `get_arch() -> Literal["amd64", "arm64"]`
 - `get_os() -> Literal["linux", "macos"]`
@@ -120,26 +118,8 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 >
 > - `progress`: A `rich.progress.Progress` used to show progress bars in the terminal
 >
-> - `client`: A `niquests.Session` used to make HTTP requests
+> - `client`: A `niquests.AsyncSession` used to make HTTP requests
 >   - Must set parameter `base_url` to `f"https://ffmpeg.martin-riedl.de/redirect/latest/{os}/{arch}/{build}/"`
 >   - `build`: `"release"`, `"snapshot"`
 >   - `arch`: `"amd64"`, `"arm64"`
 >   - `os`: `"linux"`, `"macos"`
-
-# Error Handling
-
-## `FileNotFoundError`
-
-- By design, all operations will fail if the path in question does not exist
-- For new installations, ensure that the installation directory exists
-- For other operations, ensure that the path points to the installed binary
-
-## `HTTPError`
-
-- `404 Client Error: Not Found for url: ...`
-  - Caused by invalid values for one or more of `build`, `arch`, and `os` parameters
-
-## `PermissionError`
-
-- Triggers automatic escalation via `sudo`
-- The user is prompted for a password at `stdin`

{ffmpeg_update-3.1.0 → ffmpeg_update-3.1.2}/README.md

@@ -5,15 +5,12 @@ FFmpeg-update is a package manager for the FFmpeg suite, available as both a CLI
 
 # Features
 
-- Install [pre-built static binaries of] FFmpeg, FFprobe, and/or FFplay
-- Fetch latest *release* or *snapshot* builds
-- Configure custom installation location
-- Update to latest version
-- Check for updates
-- Uninstall from system
-- Progress bar with ETA
-- Smart permission handling
-- Atomic file system operations
+- Atomic installation
+- Concurrent downloads
+- Download progress bars
+- Configurable installation directory
+- Latest *release* and *snapshot* builds available
+- Automatic sudo escalation for privileged installation directory
 - Automatic operating system and machine architecture detection
 
 # Installation
@@ -35,7 +32,7 @@ ffup <install|update [--dry-run]|check|uninstall> [OPTIONS] [ffmpeg] [ffprobe] [
 Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND>`.
 
 > [!TIP]
-> Multiple names can be passed, e.g. `ffup install ffmpeg ffprobe`
+> Multiple names can be passed, e.g., `ffup install ffmpeg ffprobe`
 
 > [!NOTE]
 > Default is `ffmpeg`, if no name is passed
@@ -43,39 +40,39 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 ## Parameters
 
 - `--dir`: The path to the installation directory
-  - Environment variable: `$FFUP_DIR`/`$XDG_BIN_HOME`
   - Default: `~/.local/bin`
-  - Functions: `check`, `install`, `uninstall`, `update`
+  - Environment variable: `$FFUP_DIR`, `$XDG_BIN_HOME`
+  - Commands: `check`, `install`, `uninstall`, `update`
 
 - `--build`: The build type
+  - Default: `snapshot`
   - Choices: `release`, `snapshot`
   - Environment Variable: `$FFUP_BUILD`
-  - Default: `snapshot`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--arch`: The machine architecture
+  - Default: Auto-detect using `platform.machine()`
   - Choices: `amd64`, `arm64`
   - Environment Variable: `$FFUP_ARCH`
-  - Default: Auto-detect using `platform.machine()`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--os`: The operating system
+  - Default: Auto-detect using `platform.system()`
   - Choices: `linux`, `macos`
   - Environment Variable: `$FFUP_OS`
-  - Default: Auto-detect using `platform.system()`
-  - Functions: `check`, `install`, `update`
+  - Commands: `check`, `install`, `update`
 
 - `--dry-run`: A flag to skip download/install, and only check for updates
-  - `ffup check` is an alias for `ffup update --dry-run`
   - Default: `False`
-  - Functions: `update`
+  - Commands: `update`
+  - Note: `ffup check` is an alias for `ffup update --dry-run`
 
 # API Reference
 
 ## Functions
 
-- `update(bins = {"ffmpeg"}, /, *, dry_run = False, dir, tempdir, progress, client) -> None`
-- `install(bins = {"ffmpeg"}, /, *, dir, tempdir, progress, client) -> None`
+- async `update(bins = {"ffmpeg"}, /, *, dry_run = False, dir, tempdir, progress, client) -> None`
+- async `install(bins = {"ffmpeg"}, /, *, dir, tempdir, progress, client) -> None`
 - `uninstall(bins = {"ffmpeg"}, /, *, dir) -> None`
 - `get_arch() -> Literal["amd64", "arm64"]`
 - `get_os() -> Literal["linux", "macos"]`
@@ -92,26 +89,8 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 >
 > - `progress`: A `rich.progress.Progress` used to show progress bars in the terminal
 >
-> - `client`: A `niquests.Session` used to make HTTP requests
+> - `client`: A `niquests.AsyncSession` used to make HTTP requests
 >   - Must set parameter `base_url` to `f"https://ffmpeg.martin-riedl.de/redirect/latest/{os}/{arch}/{build}/"`
 >   - `build`: `"release"`, `"snapshot"`
 >   - `arch`: `"amd64"`, `"arm64"`
 >   - `os`: `"linux"`, `"macos"`
-
-# Error Handling
-
-## `FileNotFoundError`
-
-- By design, all operations will fail if the path in question does not exist
-- For new installations, ensure that the installation directory exists
-- For other operations, ensure that the path points to the installed binary
-
-## `HTTPError`
-
-- `404 Client Error: Not Found for url: ...`
-  - Caused by invalid values for one or more of `build`, `arch`, and `os` parameters
-
-## `PermissionError`
-
-- Triggers automatic escalation via `sudo`
-- The user is prompted for a password at `stdin`

{ffmpeg_update-3.1.0 → ffmpeg_update-3.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ffmpeg-update"
-version = "3.1.0"
+version = "3.1.2"
 description = "Package manager for FFmpeg, FFprobe, and FFplay static binaries"
 readme = "README.md"
 authors = [
@@ -11,6 +11,7 @@ keywords = ["updater", "installer", "downloader", "program", "executable", "bina
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
+    "Framework :: AsyncIO",
     "Intended Audience :: Developers",
     "Intended Audience :: End Users/Desktop",
     "Intended Audience :: System Administrators",

{ffmpeg_update-3.1.0 → ffmpeg_update-3.1.2}/src/ffmpeg_update/__init__.py

@@ -73,21 +73,20 @@ async def update(
     progress: Annotated[Progress, Parameter(parse=False)],
     client: Annotated[AsyncSession, Parameter(parse=False)],
 ) -> None:
-    with progress:
-        for bin in bins.copy():
-            current = _current(dir / bin)
-            latest = await _latest(bin, client)
-            print(f"{_fmt_FF(bin)}:\n\tCurrent: {current}\n\tLatest: {latest}")
-            if current != latest:
-                print(f"{_fmt_FF(bin)}: update available")
-            else:
-                bins.remove(bin)
-                print(f"{_fmt_FF(bin)}: up to date")
-
-        if not dry_run and bins:
-            await install(
-                bins, dir=dir, tempdir=tempdir, progress=progress, client=client
-            )
+    bin_lst = list(bins)
+    latest, *current_lst = await asyncio.gather(
+        _latest("ffmpeg", client), *[_current(dir / bin) for bin in bin_lst]
+    )
+    print(f"Latest Version: {latest}")
+    for bin, current in zip(bin_lst, current_lst):
+        if current != latest:
+            print(f"{_fmt_FF(bin)}: update available")
+        else:
+            bins.remove(bin)
+            print(f"{_fmt_FF(bin)}: up to date")
+
+    if not dry_run and bins:
+        await install(bins, dir=dir, tempdir=tempdir, progress=progress, client=client)
 
 
 @app.command
@@ -159,24 +158,24 @@ def get_os() -> OSType:
         raise RuntimeError(f"unsupported operating system '{os}'")
 
 
-def _current(path):
-    output = subprocess.check_output([path, "-version"], text=True)
-    match = re.search(r"version (N-\d+-\w+|\d\.\d(\.\d)?)", output)
+async def _current(path):
+    process = await asyncio.create_subprocess_exec(
+        path, "-version", stdout=asyncio.subprocess.PIPE
+    )
+    stdout, _ = await process.communicate()
+    match = re.search(r"version (N-\d+-\w+|\d\.\d(\.\d)?)", stdout.decode())
     if match is None:
-        raise ValueError(f"failed to parse version from `{path} -version` output")
+        raise ValueError(f"failed to parse version from `{path} -version`")
     return match.group(1)
 
 
 async def _latest(bin, client):
-    response = await client.get(f"{bin}.zip", allow_redirects=False)
+    response = await client.get(f"{bin}.zip", allow_redirects=False, stream=True)
     response.raise_for_status()
-    if response.status_code == 307:
-        match = re.search(r"_(N-\d+-\w+|\d\.\d(\.\d)?)", response.headers["location"])
-        if match is None:
-            raise ValueError("failed to parse version from HTTP response")
-        return match.group(1)
-    else:
-        raise ValueError(f"unexpected {response}")
+    match = re.search(r"_(N-\d+-\w+|\d\.\d(\.\d)?)", response.headers["location"])
+    if match is None:
+        raise ValueError(f"failed to parse version from {response}")
+    return match.group(1)
 
 
 async def _download(bin, tempdir, progress, client):