✨ Release DeFFcode Stable v0.2.7

.github/workflows/CIlinux.yml

@@ -39,13 +39,13 @@ on:
 jobs:
   test:
     name: CI Linux
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install APT Dependencies
@@ -60,22 +60,23 @@ jobs:
           sudo chmod +x scripts/bash/prepare_dataset.sh
       - name: Install Pip Dependencies
         run: |
-          sudo pip install -U pip wheel numpy 
+          sudo pip install -U numpy
           sudo pip install -U .
           sudo pip install -U opencv-python-headless 
           sudo pip install -U vidgear[core]
-          sudo pip install -U flake8 six codecov pytest pytest-cov
+          sudo pip install -U ruff six codecov pytest pytest-cov
         if: success()
       - name: Run prepare_dataset Bash script
         run: bash scripts/bash/prepare_dataset.sh
         shell: bash
-      - name: Run pytest and flake8
+      - name: Run pytest and ruff
         run: |
-          timeout 1200 sudo python -m pytest -sv --cov=deffcode --cov-report=xml --cov-report term-missing tests/ || code=$?; if [[ $code -ne 124 && $code -ne 0 ]]; then exit $code; else echo "EXIT_CODE=$code" >>$GITHUB_ENV; fi
-          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          timeout 1200 sudo pytest -sv --cov=deffcode --cov-report=xml --cov-report term-missing tests/ || code=$?; if [[ $code -ne 124 && $code -ne 0 ]]; then exit $code; else echo "EXIT_CODE=$code" >>$GITHUB_ENV; fi
+          ruff check .
+          ruff format --check .
         if: success()
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v5
         with:
           name: ${{ matrix.python-version }}
           token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/docs_deployer.yml

@@ -23,7 +23,7 @@ on:
     types: [published]
 
 env:
-  PYTHON_VERSION: 3.9
+  PYTHON_VERSION: 3.11
   GIT_TOKEN: ${{ secrets.GIT_TOKEN }}
   GIT_NAME: ${{ secrets.GIT_NAME }}
   GIT_EMAIL: ${{ secrets.GIT_EMAIL }}
@@ -34,10 +34,10 @@ jobs:
     if: github.event_name == 'release' && github.event.action == 'published'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ env.PYTHON_VERSION }}
       - name: install_deffcode
@@ -48,8 +48,7 @@ jobs:
       - name: install_docs_deps
         run: |
           pip install -U mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin mkdocs-minify-plugin          
-          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python-legacy
-          pip install jinja2==3.0.*
+          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python
         if: success()
       - name: git configure
         run: |
@@ -82,10 +81,10 @@ jobs:
     if: github.event_name == 'push' && github.ref == 'refs/heads/master'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ env.PYTHON_VERSION }}
       - name: install_deffcode
@@ -96,8 +95,7 @@ jobs:
       - name: install_docs_deps
         run: |
           pip install -U mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin mkdocs-minify-plugin          
-          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python-legacy
-          pip install jinja2==3.0.*
+          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python
         if: success()
       - name: git configure
         run: |
@@ -131,11 +129,11 @@ jobs:
     if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - run: git checkout dev
-      - uses: actions/setup-python@v4
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ env.PYTHON_VERSION }}
       - name: install_deffcode
@@ -146,8 +144,7 @@ jobs:
       - name: install_docs_deps
         run: |
           pip install -U mkdocs mkdocs-material mkdocs-git-revision-date-localized-plugin mkdocs-minify-plugin          
-          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python-legacy
-          pip install jinja2==3.0.*
+          pip install -U mkdocs-exclude mike mkdocstrings mkdocstrings-python
         if: success()
       - name: git configure
         run: |

README.md

@@ -67,12 +67,13 @@ Here are some key features that stand out:
 - Curated list of well-documented recipes ranging from [**Basic**][basic-recipes] to [**Advanced**][advanced-recipes] skill levels.
 - Hands down the easiest [**Index based Camera Device Capturing**][decoding-camera-devices-using-indexes], similar to OpenCV.
 - Easy to code **Real-time [Simple][transcoding-live-simple-filtergraphs] & [Complex][transcoding-live-complex-filtergraphs] Filtergraphs**. _(Yes, You read it correctly "Real-time"!)_
+- Native **[Multi-Input Source Configurations][multi-input-source-configurations]** support for decoding complex topologies.
 - Lightning fast dedicated **GPU-Accelerated Video [Decoding][hardware-accelerated-video-decoding] & [Transcoding][hardware-accelerated-video-transcoding]**.
 - Enables precise FFmpeg [**Key-frame Seeking**][extracting-key-frames-as-png-image] with pinpoint accuracy.
 - Effortless [**Metadata Extraction**][extracting-video-metadata] from all streams available in the source.
 - Maintains the standard easy to learn [**OpenCV-Python**](https://docs.opencv.org/4.x/d6/d00/tutorial_py_root.html) coding syntax.
 - Out-of-the-box support for all prominent Computer Vision libraries.
-- Cross-platform, runs on Python 3.7+, and easy to install.
+- Cross-platform, runs on Python 3.10+, and easy to install.
 
 <!--
 - [x] Lossless Transcoding support with [WriteGear](https://abhitronix.github.io/deffcode/latest/gears/writegear/introduction/). #TODO
@@ -193,6 +194,7 @@ Once you have DeFFcode installed, checkout our Well-Documented **[Recipes 🍱][
 - [CUDA-accelerated Video Transcoding with OpenCV's VideoWriter API][cuda-accelerated-video-transcoding-with-opencvs-videowriter-api]
 - [CUDA-NVENC-accelerated Video Transcoding with WriteGear API][cuda-nvenc-accelerated-video-transcoding-with-writegear-api]
 - [CUDA-NVENC-accelerated End-to-end Lossless Video Transcoding with WriteGear API][cuda-nvenc-accelerated-end-to-end-lossless-video-transcoding-with-writegear-api]
+- [Multi-Input Source Configurations][multi-input-source-configurations]
 
 </details>
 
@@ -201,6 +203,8 @@ Once you have DeFFcode installed, checkout our Well-Documented **[Recipes 🍱][
 
 - [Added new attributes to metadata in FFdecoder API][added-new-attributes-to-metadata-in-ffdecoder-api]
 - [Overriding source video metadata in FFdecoder API][overriding-source-video-metadata-in-ffdecoder-api]
+- [Smart Keyframe-only decoding for heavy AI inference][smart-keyframe-only-decoding-for-heavy-ai-inference]
+- [Variable-Frame-Rate (VFR) synchronization via pts_time][variable-frame-rate-vfr-synchronization-via-pts_time]
 
 </details>
 
@@ -310,18 +314,18 @@ It is something I am doing with my own free time. But so much more needs to be d
 
 Here is a Bibtex entry you can use to cite this project in a publication:
 
-[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.7523792.svg)](https://doi.org/10.5281/zenodo.7523792)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.12689394.svg)](https://doi.org/10.5281/zenodo.12689394)
 
 ```BibTeX
 @software{deffcode,
   author       = {Abhishek Thakur},
-  title        = {abhiTronix/deffcode: v0.2.5},
-  month        = jan,
-  year         = 2023,
+  title        = {abhiTronix/deffcode: v0.2.6},
+  month        = jul,
+  year         = 2024,
   publisher    = {Zenodo},
-  version      = {v0.2.5},
-  doi          = {10.5281/zenodo.7523792},
-  url          = {https://doi.org/10.5281/zenodo.7523792}
+  version      = {v0.2.6},
+  doi          = {10.5281/zenodo.12689394},
+  url          = {https://doi.org/10.5281/zenodo.12689394},
 }
 ```
 
@@ -431,6 +435,9 @@ Advanced Recipes
 [cuda-nvenc-accelerated-end-to-end-lossless-video-transcoding-with-writegear-api]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/transcode-hw-acceleration/#cuda-nvenc-accelerated-end-to-end-lossless-video-transcoding-with-writegear-api
 [added-new-attributes-to-metadata-in-ffdecoder-api]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/update-metadata/#added-new-attributes-to-metadata-in-ffdecoder-api
 [overriding-source-video-metadata-in-ffdecoder-api]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/update-metadata/#overriding-source-video-metadata-in-ffdecoder-api
+[smart-keyframe-only-decoding-for-heavy-ai-inference]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/extract-frame-metadata/#smart-keyframe-only-decoding-for-heavy-ai-inference
+[variable-frame-rate-vfr-synchronization-via-pts_time]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/extract-frame-metadata/#variable-frame-rate-vfr-synchronization-via-pts_time
+[multi-input-source-configurations]: https://abhitronix.github.io/deffcode/latest/recipes/advanced/multi_input/#multi-input-source-configurations
 
 <!--
 CI Apps URLs

appveyor.yml

@@ -18,14 +18,6 @@ image: Visual Studio 2019
 
 environment:
   matrix:
-    - PYTHON: "C:\\Python38-x64"
-      PYTHON_VERSION: "3.8.x"
-      PYTHON_ARCH: "64"
-
-    - PYTHON: "C:\\Python39-x64"
-      PYTHON_VERSION: "3.9.x"
-      PYTHON_ARCH: "64"
-
     - PYTHON: "C:\\Python310-x64"
       PYTHON_VERSION: "3.10.x"
       PYTHON_ARCH: "64"
@@ -34,7 +26,15 @@ environment:
       PYTHON_VERSION: "3.11.x"
       PYTHON_ARCH: "64"
 
-build: off
+    - PYTHON: "C:\\Python312-x64"
+      PYTHON_VERSION: "3.12.x"
+      PYTHON_ARCH: "64"
+
+    - PYTHON: "C:\\Python313-x64"
+      PYTHON_VERSION: "3.13.x"
+      PYTHON_ARCH: "64"
+
+build: false
 
 version: '{branch}-{build}'
 
@@ -71,4 +71,4 @@ test_script:
   - cmd: python -m pytest --verbose --capture=no --cov-report term-missing --cov=deffcode tests/
 
 after_test:
-  - cmd: python -m codecov 
+  - cmd: python -m codecov

azure-pipelines.yml

@@ -37,14 +37,14 @@ pool:
 
 strategy:
   matrix:
-    Python38:
-      python.version: "3.8"
-    Python39:
-      python.version: "3.9"
     Python310:
       python.version: "3.10"
     Python311:
       python.version: "3.11"
+    Python312:
+      python.version: "3.12"
+    Python313:
+      python.version: "3.13"
 
 steps:
 - task: UsePythonVersion@0
@@ -68,26 +68,26 @@ steps:
   displayName: 'Prepare dataset'
 
 - script: |
-    python -m pip install --upgrade pip wheel numpy
-    pip install --upgrade vidgear[core] opencv-python-headless codecov pytest pytest-cov pytest-azurepipelines
+    python -m pip install --upgrade pip wheel numpy cython opencv-python
+    pip install --upgrade vidgear[core] codecov pytest pytest-cov pytest-azurepipelines
     pip install --upgrade .
   displayName: 'Install pip dependencies'
 
 - script: |
     timeout 1500 pytest -sv --cov=deffcode --cov-report=xml --cov-report=html --cov-report term-missing tests/ || code=$?; if [[ $code -ne 124 && $code -ne 0 ]]; then exit $code; else echo "##vso[task.setvariable variable=exit_code]$code"; fi
   displayName: 'pytest'
-  
+
 - bash: |
     echo "Exit Code was: $(exit_code)"
     curl https://keybase.io/codecovsecurity/pgp_keys.asc | gpg --no-default-keyring --keyring trustedkeys.gpg --import
-    curl -Os https://uploader.codecov.io/latest/macos/codecov
-    curl -Os https://uploader.codecov.io/latest/macos/codecov.SHA256SUM
-    curl -Os https://uploader.codecov.io/latest/macos/codecov.SHA256SUM.sig
+    curl -Os https://cli.codecov.io/latest/macos/codecov
+    curl -Os https://cli.codecov.io/latest/macos/codecov.SHA256SUM
+    curl -Os https://cli.codecov.io/latest/macos/codecov.SHA256SUM.sig
     gpgv codecov.SHA256SUM.sig codecov.SHA256SUM
     shasum -a 256 -c codecov.SHA256SUM
     chmod +x codecov
     if [ "$(exit_code)" != "124" ]; then
-      ./codecov -t $CODECOV_TOKEN -f coverage.xml -C $(Build.SourceVersion) -B $(Build.SourceBranch) -b $(Build.BuildNumber);
+      ./codecov  --verbose upload-process --fail-on-error -t $CODECOV_TOKEN -f coverage.xml -C $(Build.SourceVersion) -B $(Build.SourceBranch) -b $(Build.BuildNumber);
     else
       echo "Timeout test - Skipped Codecov!"; 
     fi

deffcode/__init__.py

@@ -4,4 +4,4 @@
 
 from .ffdecoder import FFdecoder
 from .sourcer import Sourcer
-from .version import __version__
+from .version import __version__