migrate to uv and modern package structure

Author: slhck

.github/workflows/python-package.yml

@@ -1,4 +1,4 @@
-name: Test Package 
+name: Test Package
 
 on:
   push:
@@ -11,21 +11,28 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v3
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
-      with:
-        python-version: ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
     - name: Install ffmpeg
       run: |
         sudo apt-get update -y
         sudo apt-get install -y ffmpeg
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        python -m pip install tox tox-gh-actions
-    - name: Test with tox
-      run: tox
+        uv sync --group dev
+    - name: Lint with ruff
+      run: |
+        uv run ruff check .
+        uv run ruff format --check .
+    - name: Type check with mypy
+      run: |
+        uv run mypy .
+    - name: Test with pytest
+      run: |
+        uv run pytest

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.11
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

README.md

@@ -28,18 +28,25 @@ Contents:
 
 ## Requirements
 
-- Python 3.8 or higher
+- Python 3.9 or higher
 - FFmpeg:
-    - download a static build from [their website](http://ffmpeg.org/download.html)
-    - put the `ffprobe` executable in your `$PATH`
+  - download a static build from [their website](http://ffmpeg.org/download.html)
+  - put the `ffprobe` executable in your `$PATH`
 
 ## Installation
 
+Simply run it via [uv](https://docs.astral.sh/uv/getting-started/installation/):
+
 ```bash
-pip3 install ffmpeg_bitrate_stats
+uvx ffmpeg-bitrate-stats
 ```
 
-Or clone this repository, then run the tool with `python -m ffmpeg_bitrate_stats`
+Or install via [pipx](https://pipx.pypa.io/latest/installation/).
+Or with pip:
+
+```bash
+pip3 install --user ffmpeg_bitrate_stats
+```
 
 ## Usage
 
@@ -120,6 +127,7 @@ ffmpeg-bitrate-stats -a time -c 30 -of json BigBuckBunny.mp4
 ```
 
 This returns:
+
 ```json
 {
     "input_file": "BigBuckBunny.mp4",

docs/ffmpeg_bitrate_stats.html

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["uv_build>=0.8.14,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "ffmpeg_bitrate_stats"
+version = "1.1.2"
+description = "Calculate bitrate statistics using FFmpeg"
+readme = "README.md"
+authors = [
+    { name = "Werner Robitza", email = "[email protected]" }
+]
+license = "MIT"
+license-files = ["LICENSE.md"]
+requires-python = ">=3.9"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Multimedia :: Video",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "numpy",
+    "pandas",
+    "plotille",
+]
+
+[project.urls]
+Homepage = "https://github.com/slhck/ffmpeg-bitrate-stats"
+Repository = "https://github.com/slhck/ffmpeg-bitrate-stats"
+
+[project.scripts]
+ffmpeg-bitrate-stats = "ffmpeg_bitrate_stats.__main__:main"
+
+[dependency-groups]
+dev = [
+    "pytest >=8.1.1,<9",
+    "ruff>=0.12.11",
+    "mypy",
+    "pdoc>=15.0.4",
+]
+
+[tool.mypy]
+python_version = "3.13"
+ignore_missing_imports = true
+exclude = ["build"]
+namespace_packages = false

pyproject.toml

@@ -1,5 +1,7 @@
+import importlib.metadata
+
 from .bitrate_stats import BitrateStats, BitrateStatsSummary, run_command
 
-__version__ = "1.1.2"
+__version__ = importlib.metadata.version("ffmpeg_bitrate_stats")
 
 __all__ = ["BitrateStats", "BitrateStatsSummary", "run_command"]