duvc-ctl 1.0.0__tar.gz

duvc_ctl-1.0.0/.github/workflows/build-and-publish.yml

@@ -0,0 +1,75 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: [ 'v*' ]  # Trigger on version tags
+  workflow_dispatch:  # Manual override trigger
+    inputs:
+      run_id:
+        description: 'Run ID from TestPyPI workflow (optional - will use latest successful run if empty)'
+        required: false
+        type: string
+
+jobs:
+  upload_pypi:
+    name: Upload to PyPI
+    runs-on: ubuntu-latest
+    # Only run for stable releases (no hyphens) OR manual dispatch
+    if: |
+      (github.event_name == 'push' && 
+       startsWith(github.ref, 'refs/tags/v') && 
+       !contains(github.ref, '-')) ||
+      github.event_name == 'workflow_dispatch'
+    environment:
+      name: pypi
+      url: https://pypi.org/p/duvc-ctl
+    permissions:
+      id-token: write
+      actions: read  # Needed to download artifacts from other workflows
+    
+    steps:
+      - name: Get latest successful TestPyPI run
+        if: ${{ !inputs.run_id }}
+        id: get-run
+        run: |
+          RUN_ID=$(gh api repos/${{ github.repository }}/actions/workflows/build-wheels.yml/runs \
+            --jq '.workflow_runs[] | select(.conclusion == "success") | .id' | head -n1)
+          echo "run_id=$RUN_ID" >> $GITHUB_OUTPUT
+        env:
+          GH_TOKEN: ${{ github.token }}
+
+      - name: Set run ID
+        id: run-id
+        run: |
+          if [ -n "${{ inputs.run_id }}" ]; then
+            echo "run_id=${{ inputs.run_id }}" >> $GITHUB_OUTPUT
+          else
+            echo "run_id=${{ steps.get-run.outputs.run_id }}" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Download wheels from TestPyPI workflow
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+          run-id: ${{ steps.run-id.outputs.run_id }}
+          github-token: ${{ github.token }}
+
+      - name: Download sdist from TestPyPI workflow
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+          run-id: ${{ steps.run-id.outputs.run_id }}
+          github-token: ${{ github.token }}
+
+      - name: List artifacts to upload
+        run: |
+          ls -la dist/
+          echo "Uploading $(ls dist/ | wc -l) files to PyPI"
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          print-hash: true

duvc_ctl-1.0.0/.github/workflows/build-wheels.yml

@@ -0,0 +1,172 @@
+name: Build and publish to Test_PyPi
+
+on:
+  push:
+    branches: [ main ]
+    tags: [ 'v*' ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Build wheels for Python ${{ matrix.python-version }} 
+    runs-on: windows-2022
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+    
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set Python version for cibuildwheel
+        shell: bash
+        run: |
+          PYTHON_VERSION="${{ matrix.python-version }}"
+          CIBW_PYTHON="cp${PYTHON_VERSION//./}"
+          echo "CIBW_PYTHON=${CIBW_PYTHON}" >> $GITHUB_ENV
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.16.5
+        env:
+          CIBW_BUILD: "${{ env.CIBW_PYTHON }}-win_amd64"
+          CIBW_ARCHS_WINDOWS: "AMD64"
+          CIBW_TEST_COMMAND: >
+            python -c "import duvc_ctl; 
+            print(f'SUCCESS: duvc_ctl {duvc_ctl.__version__} imported'); 
+            devices = duvc_ctl.list_devices(); 
+            print(f'Found {len(devices)} devices')"
+          CIBW_BUILD_VERBOSITY: 1
+          
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-py${{ matrix.python-version }}
+          path: ./wheelhouse/*.whl
+          retention-days: 30
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: windows-2022
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+      
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+      
+      - name: Build sdist
+        run: python -m build --sdist
+      
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          retention-days: 30
+
+  test_install:
+    name: Test installation
+    needs: [build_wheels]
+    runs-on: windows-2022
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+    
+    steps:
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download wheels
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-py${{ matrix.python-version }}
+          path: wheels
+
+      - name: Test wheel installation
+        run: |
+          $wheel = Get-ChildItem wheels\*.whl | Select-Object -First 1
+          python -m pip install $wheel.FullName
+          python -c "
+          import duvc_ctl
+          print(f'SUCCESS: duvc_ctl {duvc_ctl.__version__}')
+          devices = duvc_ctl.list_devices()
+          print(f'Found {len(devices)} devices')
+          "
+
+  upload_testpypi:
+    name: Upload to TestPyPI
+    needs: [build_wheels, build_sdist, test_install]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment: 
+      name: testpypi
+      url: https://test.pypi.org/p/duvc-ctl
+    permissions:
+      id-token: write
+    
+    steps:
+      - name: Download all wheels
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+
+      - name: Download sdist
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+      - name: List artifacts to upload
+        run: |
+          ls -la dist/
+          echo "Uploading $(ls dist/ | wc -l) files to TestPyPI"
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          print-hash: true
+          skip-existing: true
+          verbose: true     
+
+  create_release:
+    name: Create GitHub Release
+    needs: [upload_testpypi]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: write
+    
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: "*"
+          path: artifacts
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: artifacts/**/*
+          generate_release_notes: true

duvc_ctl-1.0.0/CMakeLists.txt

@@ -0,0 +1,197 @@
+cmake_minimum_required(VERSION 3.16)
+project(duvc-ctl VERSION 1.0.0 LANGUAGES CXX)
+
+# Options
+option(DUVC_BUILD_STATIC "Build duvc static library" ON)
+option(DUVC_BUILD_SHARED "Build duvc shared library" OFF)
+option(DUVC_BUILD_CLI "Build duvc CLI" ON)
+option(DUVC_BUILD_PYTHON "Build Python bindings (pybind11)" OFF)
+option(DUVC_WARNINGS_AS_ERRORS "Treat warnings as errors" OFF)
+
+# Global settings
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# Output dirs (nice layout for MSVC multi-config and Makefile single-config)
+foreach(OUTPUTCONFIG ${CMAKE_CONFIGURATION_TYPES})
+    string(TOUPPER ${OUTPUTCONFIG} OUTPUTCONFIG_UC)
+    set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY_${OUTPUTCONFIG_UC} ${CMAKE_BINARY_DIR}/lib)
+    set(CMAKE_LIBRARY_OUTPUT_DIRECTORY_${OUTPUTCONFIG_UC} ${CMAKE_BINARY_DIR}/bin)
+    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_${OUTPUTCONFIG_UC} ${CMAKE_BINARY_DIR}/bin)
+endforeach()
+if(NOT CMAKE_CONFIGURATION_TYPES)
+    set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib)
+    set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)
+endif()
+
+# Helper: warning flags
+function(duvc_apply_warnings target)
+    if(MSVC)
+        target_compile_options(${target} PRIVATE /W4 /permissive-)
+        if(DUVC_WARNINGS_AS_ERRORS)
+            target_compile_options(${target} PRIVATE /WX)
+        endif()
+        target_compile_definitions(${target} PRIVATE UNICODE _UNICODE NOMINMAX)
+    else()
+        target_compile_options(${target} PRIVATE -Wall -Wextra -Wpedantic)
+        if(DUVC_WARNINGS_AS_ERRORS)
+            target_compile_options(${target} PRIVATE -Werror)
+        endif()
+    endif()
+endfunction()
+
+# Helper: link DirectShow on Windows
+function(duvc_link_directshow target)
+    if(WIN32)
+        target_link_libraries(${target} PRIVATE ole32 oleaut32 strmiids)
+    endif()
+endfunction()
+
+# Helper: MinGW console subsystem fix
+function(duvc_fix_mingw_console target)
+    if(MINGW)
+        target_link_options(${target} PRIVATE -mconsole -Wl,--subsystem,console)
+    endif()
+endfunction()
+
+# Include dirs
+set(DUVC_INCLUDE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/include)
+
+# Library target(s)
+set(DUVC_SOURCES
+    src/core.cpp
+    src/bindings.cpp
+)
+
+if(DUVC_BUILD_STATIC)
+    add_library(duvc STATIC ${DUVC_SOURCES})
+    target_include_directories(duvc PUBLIC ${DUVC_INCLUDE_DIR})
+    target_compile_features(duvc PUBLIC cxx_std_17)
+    duvc_apply_warnings(duvc)
+    duvc_link_directshow(duvc)
+endif()
+
+if(DUVC_BUILD_SHARED)
+    add_library(duvc_shared SHARED ${DUVC_SOURCES})
+    target_include_directories(duvc_shared PUBLIC ${DUVC_INCLUDE_DIR})
+    target_compile_features(duvc_shared PUBLIC cxx_std_17)
+    target_compile_definitions(duvc_shared PRIVATE DUVCC_DLL_BUILD)
+    set_target_properties(duvc_shared PROPERTIES OUTPUT_NAME duvc)
+    duvc_apply_warnings(duvc_shared)
+    duvc_link_directshow(duvc_shared)
+endif()
+
+# CLI
+if(DUVC_BUILD_CLI)
+    add_executable(duvc-cli cli/main.cpp)
+    target_include_directories(duvc-cli PRIVATE ${DUVC_INCLUDE_DIR})
+    if(DUVC_BUILD_STATIC)
+        target_link_libraries(duvc-cli PRIVATE duvc)
+    elseif(DUVC_BUILD_SHARED)
+        target_link_libraries(duvc-cli PRIVATE duvc_shared)
+    else()
+        message(FATAL_ERROR "CLI requested but no library variant enabled. Enable DUVC_BUILD_STATIC or DUVC_BUILD_SHARED.")
+    endif()
+    duvc_apply_warnings(duvc-cli)
+    duvc_link_directshow(duvc-cli)
+    duvc_fix_mingw_console(duvc-cli)
+endif()
+
+# Python bindings via pybind11 (optional)
+option(DUVC_USE_SYSTEM_PYBIND11 "Use system-installed pybind11" OFF)
+
+if(DUVC_BUILD_PYTHON)
+    # Locate Python
+    find_package(Python COMPONENTS Interpreter Development REQUIRED)
+
+    # pybind11
+    if(DUVC_USE_SYSTEM_PYBIND11)
+        find_package(pybind11 CONFIG REQUIRED)
+    else()
+        # Use FetchContent to grab pybind11
+        include(FetchContent)
+        FetchContent_Declare(
+            pybind11
+            GIT_REPOSITORY https://github.com/pybind/pybind11.git
+            GIT_TAG v2.11.1
+        )
+        FetchContent_MakeAvailable(pybind11)
+    endif()
+
+    # Python binding source
+    set(DUVC_PY_SOURCES src/py/pybind_module.cpp)
+
+    if(EXISTS ${CMAKE_CURRENT_SOURCE_DIR}/src/py/pybind_module.cpp)
+        pybind11_add_module(_duvc_ctl ${DUVC_PY_SOURCES})
+        
+        # For MSVC, handle configuration-specific output directories
+        if(CMAKE_GENERATOR_PLATFORM)
+            set_target_properties(_duvc_ctl PROPERTIES 
+                OUTPUT_NAME "_duvc_ctl"
+                LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/py
+                RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/py
+                LIBRARY_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/py
+                RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/py
+                LIBRARY_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/py
+                RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/py
+            )
+        else()
+            set_target_properties(_duvc_ctl PROPERTIES 
+                OUTPUT_NAME "_duvc_ctl"
+                LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/py
+                RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/py
+            )
+        endif()
+        
+        target_include_directories(_duvc_ctl PRIVATE ${DUVC_INCLUDE_DIR})
+        
+        if(DUVC_BUILD_STATIC)
+            target_link_libraries(_duvc_ctl PRIVATE duvc)
+        elseif(DUVC_BUILD_SHARED)
+            target_link_libraries(_duvc_ctl PRIVATE duvc_shared)
+        else()
+            target_sources(_duvc_ctl PRIVATE ${DUVC_SOURCES})
+            duvc_link_directshow(_duvc_ctl)
+        endif()
+        
+        duvc_apply_warnings(_duvc_ctl)
+        duvc_link_directshow(_duvc_ctl)
+             
+    else()
+        message(WARNING "DUVC_BUILD_PYTHON=ON but src/py/pybind_module.cpp not found. Skipping Python module.")
+    endif()
+endif()
+
+# Installation (optional, basic)
+include(GNUInstallDirs)
+
+if(DUVC_BUILD_STATIC OR DUVC_BUILD_SHARED)
+    install(DIRECTORY include/ DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+endif()
+
+if(TARGET duvc)
+    install(TARGETS duvc
+        ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+        LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+        RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
+endif()
+
+if(TARGET duvc_shared)
+    install(TARGETS duvc_shared
+        ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+        LIBRARY DESTINATION ${CMAKE_LIBRARY_DIR}
+        RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
+endif()
+
+if(TARGET duvc-cli)
+    install(TARGETS duvc-cli
+        RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR})
+endif()
+
+if(DUVC_BUILD_PYTHON AND TARGET _duvc_ctl)
+    # Install the Python extension module to the correct location within the package
+    install(TARGETS _duvc_ctl
+        DESTINATION ${SKBUILD_PLATLIB_DIR}/duvc_ctl)
+endif()

duvc_ctl-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 allanhanan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.