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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ffmpeg-update
-Version: 3.1.1
+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
@@ -34,16 +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
+- Atomic installation
 - Concurrent downloads
-- Uninstall from system
-- Progress bar with ETA
-- Smart permission handling
-- Atomic file system operations
+- 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
@@ -65,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
@@ -73,32 +69,32 @@ 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
 
@@ -127,21 +123,3 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 >   - `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.1 → ffmpeg_update-3.1.2}/README.md

@@ -5,16 +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
+- Atomic installation
 - Concurrent downloads
-- Uninstall from system
-- Progress bar with ETA
-- Smart permission handling
-- Atomic file system operations
+- 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
@@ -36,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
@@ -44,32 +40,32 @@ 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
 
@@ -98,21 +94,3 @@ Alternatively, can be invoked as a module with `python -m ffmpeg_update <COMMAND
 >   - `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.1 → ffmpeg_update-3.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ffmpeg-update"
-version = "3.1.1"
+version = "3.1.2"
 description = "Package manager for FFmpeg, FFprobe, and FFplay static binaries"
 readme = "README.md"
 authors = [

{ffmpeg_update-3.1.1 → 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,11 +158,14 @@ 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)
 
 
@@ -172,7 +174,7 @@ async def _latest(bin, client):
     response.raise_for_status()
     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")
+        raise ValueError(f"failed to parse version from {response}")
     return match.group(1)