cbits 0.1.1__tar.gz

cbits-0.1.1/.clang-format

@@ -0,0 +1,141 @@
+# .clang-format for PEP 7 (Python C Style Guide)
+# See: https://peps.python.org/pep-0007/
+---
+BasedOnStyle: Google
+Language: C
+
+# Indentation and whitespace
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+ColumnLimit: 79
+ContinuationIndentWidth: 4
+IndentCaseLabels: true
+IndentGotoLabels: false
+IndentPPDirectives: BeforeHash
+
+# Braces and blocks
+BreakBeforeBraces: Stroustrup
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortBlocksOnASingleLine: Never
+AllowShortBracesOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortRecordsOnASingleLine: false
+AlwaysBreakAfterReturnType: All
+
+# Spaces
+SpaceBeforeParens: ControlStatements
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceAfterCStyleCast: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeParensOptions:
+  AfterControlStatements: true
+  AfterForeachMacros: true
+  AfterFunctionDeclarationName: false
+  AfterFunctionDefinitionName: false
+  AfterIfMacros: true
+  AfterOverloadedOperator: false
+  AfterRequiresInClause: true
+  AfterRequiresInExpression: true
+
+# Pointer and reference alignment
+PointerAlignment: Right
+DerivePointerAlignment: false
+
+# Includes
+SortIncludes: false
+
+# Comments
+ReflowComments: true
+
+# Misc
+InsertTrailingCommas: None
+InsertBraces: true
+InsertNewlineAtEOF: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+
+# Function declaration/definition
+AlwaysBreakAfterDefinitionReturnType: None
+BreakAfterAttributes: Leave
+
+# Macro formatting (cannot enforce PEP 7's macro idioms, but keep formatting clean)
+AllowShortCaseLabelsOnASingleLine: false
+...
+
+---
+BasedOnStyle: Google
+Language: Cpp
+
+# Indentation and whitespace
+IndentWidth: 4
+TabWidth: 4
+UseTab: Never
+ColumnLimit: 79
+ContinuationIndentWidth: 4
+IndentCaseLabels: true
+IndentGotoLabels: false
+IndentPPDirectives: BeforeHash
+
+# Braces and blocks
+BreakBeforeBraces: Stroustrup
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortBlocksOnASingleLine: Never
+AllowShortBracesOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortRecordsOnASingleLine: false
+AlwaysBreakAfterReturnType: All
+
+# Spaces
+SpaceBeforeParens: ControlStatements
+SpacesInParentheses: false
+SpacesInSquareBrackets: false
+SpaceAfterCStyleCast: true
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeRangeBasedForLoopColon: true
+SpaceBeforeInheritanceColon: true
+SpaceBeforeCtorInitializerColon: true
+SpaceBeforeParensOptions:
+  AfterControlStatements: true
+  AfterForeachMacros: true
+  AfterFunctionDeclarationName: false
+  AfterFunctionDefinitionName: false
+  AfterIfMacros: true
+  AfterOverloadedOperator: false
+  AfterRequiresInClause: true
+  AfterRequiresInExpression: true
+
+# Pointer and reference alignment
+PointerAlignment: Right
+DerivePointerAlignment: false
+
+# Includes
+SortIncludes: false
+
+# Comments
+ReflowComments: true
+
+# Misc
+InsertTrailingCommas: None
+InsertBraces: true
+InsertNewlineAtEOF: true
+KeepEmptyLinesAtTheStartOfBlocks: false
+MaxEmptyLinesToKeep: 1
+
+# Function declaration/definition
+AlwaysBreakAfterDefinitionReturnType: None
+BreakAfterAttributes: Leave
+
+# Macro formatting (cannot enforce PEP 7's macro idioms, but keep formatting clean)
+AllowShortCaseLabelsOnASingleLine: false
+...

cbits-0.1.1/.github/workflows/build_and_publish.yml

@@ -0,0 +1,95 @@
+name: 🐍 Build Wheels & Publish Python Package
+on:
+    push:
+        tags:
+            - 'v*.*.*'
+
+permissions:
+    contents: write
+
+jobs:
+    build:
+        runs-on: ${{ matrix.os }}
+        strategy:
+            matrix:
+                os: [ubuntu-latest, macos-latest, windows-latest]
+        env:
+            CIBW_OUTPUT_DIR: dist
+            CIBW_SKIP: ""
+            CIBW_BUILD: "cp38-* cp39-* cp310-* cp311-* cp312-* cp313-*"
+        steps:
+            - name: Check out code
+              uses: actions/checkout@v4
+
+            - name: Setup Python & build tools
+              uses: actions/setup-python@v5
+              with:
+                python-version: "3.x"
+
+            - name: Install build dependencies
+              run: |
+                python -m pip install --upgrade pip build cibuildwheel[global]
+
+            - name: Build wheels
+              run: |
+                python -m cibuildwheel
+
+            - name: Build source‐dist
+              run: |
+                python -m build --sdist --outdir dist
+
+            - name: Upload all artifacts
+              uses: actions/upload-artifact@v4
+              with:
+                name: wheels-${{ matrix.os }}
+                path: dist
+    
+    release:
+        name: Attach & Publish
+        needs: build
+        runs-on: ubuntu-latest
+        env:
+            TWINE_USERNAME: __token__
+            TWINE_PASSWORD: ${{ secrets.PYPI_TOKEN }}
+        
+        steps:
+            - name: Download built wheels & sdist
+              uses: actions/download-artifact@v4
+              with:
+                path: dist
+            
+            - name: Flaten dist folder
+              run: |
+                for d in dist/wheels-*-latest; do
+                  cp "$d"/*.whl dist/
+                done
+
+                tarball=$(find dist/wheels-*-latest -type f -name 'cbits-*.tar.gz' | head -n1)
+                if [ -z "$tarball" ]; then
+                  echo "Fehler: kein cbits-*.tar.gz gefunden!" >&2
+                  exit 1
+                fi
+                cp "$tarball" dist/
+
+                rm -rf dist/wheels-*-latest
+            
+            - name: List all files in dist
+              run: |
+                echo "=== Contents of dist ==="
+                ls -lhR dist
+
+            - name: Create GitHub Release assets
+              uses: softprops/action-gh-release@v1
+              with:
+                tag_name: ${{ github.ref_name }}
+                files: dist/*
+
+            - name: Publish to PyPI
+              if: env.TWINE_PASSWORD != ''
+              uses: pypa/gh-action-pypi-publish@v1.12.4
+              with:
+                user: ${{ env.TWINE_USERNAME }}
+                password: ${{ env.TWINE_PASSWORD }}
+                name: Publish to PyPI
+                skip-existing: true
+

cbits-0.1.1/.github/workflows/deploy_doxygen.yml

@@ -0,0 +1,35 @@
+name: Deploy Doxygen 🚀
+
+on:
+    push:
+        branches:
+            - main
+
+jobs:
+    publish:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v3
+              with:
+                fetch-depth: 0
+            
+            - name: Install dependencies
+              run: |
+                sudo apt-get update
+                sudo apt-get install -y doxygen graphviz
+            
+            - name: Build Doxygen HTML
+              run: doxygen Doxyfile
+            
+            - name: Show generated files
+              run: ls -R doxygen
+            
+            - name: Publish to GitHub Pages
+              uses: peaceiris/actions-gh-pages@v4
+              with:
+                github_token: ${{ secrets.GITHUB_TOKEN }}
+                publish_dir: doxygen/html
+                publish_branch: docs

cbits-0.1.1/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+.pypirc
+/dist/
+
+# C extensions
+*.so
+*.pyd
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+*.whl
+pip-wheel-metadata/
+*.egg-info/
+eggs/
+
+# Virtual environments
+env/
+venv/
+.venv/
+ENV/
+env.bak/
+venv.bak/
+
+# CMake build directories and files
+CMakeFiles/
+CMakeCache.txt
+cmake_install.cmake
+CMakeLists.txt.user
+Makefile
+build-*/
+
+# IDE / editor directories and files
+.vscode/
+.idea/
+*.sublime-project
+*.sublime-workspace
+
+# Documentation build
+doxygen
+Doxyfile.bak

cbits-0.1.1/CHANGELOG.md

@@ -0,0 +1,14 @@
+# CHANGELOG
+## [0.1.1]
+### Added
+- Introduce `compat_dispatch.c` for runtime CPU feature detection and automatic selection of the fastest popcount implementation.
+- Additional unit tests
+
+### Changed
+- Refactor `compat.h` dispatch logic to clarify fallback paths and cleanup macros.  
+
+## [0.1.0]
+### Added
+- C backend with SIMD popcount support
+- Python sequence and numeric protocol support (`getitem`, `and`, `or`, etc.)
+- Unit tests for all methods

cbits-0.1.1/CMakeLists.txt

@@ -0,0 +1,86 @@
+cmake_minimum_required(VERSION 3.15)
+project(cbits LANGUAGES C)
+
+include(CheckCCompilerFlag)
+
+set(MODULE_NAME "_cbits")
+
+if(DEFINED ENV{VIRTUAL_ENV})
+	message(STATUS "Using Python from VIRTUAL_ENV=$ENV{VIRTUAL_ENV}")
+	set(Python_ROOT_DIR "$ENV{VIRTUAL_ENV}")
+	set(Python_FIND_STRATEGY LOCATION)
+endif()
+
+if(APPLE)
+	set(Python_FIND_FRAMEWORK NEVER)
+endif()
+
+find_package(Python
+	COMPONENTS Interpreter Development.Module
+	REQUIRED
+)
+
+message(STATUS "Found Python ${Python_VERSION_STRING}")
+message(STATUS "  Executable: ${Python_EXECUTABLE}")
+message(STATUS "  Include dir: ${Python_INCLUDE_DIRS}")
+message(STATUS "  Libraries: ${Python_LIBRARIES}")
+message(STATUS "  Module ext: ${Python_MODULE_EXTENSION}")
+
+add_library(${MODULE_NAME} MODULE
+	src/bitvector.c
+	src/compat_dispatch.c
+	python/binding.c
+)
+
+set_target_properties(${MODULE_NAME} PROPERTIES
+	PREFIX ""
+)
+
+target_include_directories(${MODULE_NAME}
+	PRIVATE
+		${Python_INCLUDE_DIRS}
+		${CMAKE_SOURCE_DIR}/include
+)
+
+target_link_libraries(${MODULE_NAME}
+	PRIVATE
+		Python::Module
+)
+
+if (MSVC)
+	if(CMAKE_SIZEOF_VOID_P EQUAL 8)
+		target_compile_options(_cbits PRIVATE /O2 /arch:AVX2)
+		target_compile_definitions(_cbits PRIVATE
+			__AVX2__=1
+		)
+		check_c_compiler_flag("/arch:AVX512VPOPCNTDQ" HAS_AVX512VPOPCNTDQ)
+		if(HAS_AVX512VPOPCNTDQ)
+			target_compile_options(_cbits PRIVATE /arch:AVX512VPOPCNTDQ)
+			target_compile_definitions(_cbits PRIVATE __AVX512VPOPCNTDQ__=1)
+		endif()
+	else()
+		target_compile_options(_cbits PRIVATE /O2)
+	endif()
+	set_target_properties(${MODULE_NAME} PROPERTIES SUFFIX ".pyd")
+else()
+	if(CMAKE_OSX_ARCHITECTURES STREQUAL "x86_64" OR CMAKE_SYSTEM_PROCESSOR STREQUAL "x86_64")
+		target_compile_definitions(${MODULE_NAME} PRIVATE USE_X86_INTRINSIC)
+		target_compile_options(${MODULE_NAME} PRIVATE
+			-O3 -funroll-loops -mavx2 -mavx512vpopcntdq
+		)
+	else()
+		target_compile_options(${MODULE_NAME} PRIVATE -O3)
+	endif()
+	set_target_properties(${MODULE_NAME} PROPERTIES SUFFIX ".so")
+endif()
+
+
+install(TARGETS ${MODULE_NAME}
+	LIBRARY DESTINATION cbits
+	RUNTIME DESTINATION cbits
+	ARCHIVE DESTINATION cbits
+)
+
+install(FILES ${CMAKE_SOURCE_DIR}/python/cbits/__init__.py
+	DESTINATION cbits
+)