{"library":"pyclibrary","title":"pyclibrary","description":"PyCLibrary is a pure-python C parser and ctypes automation library, designed to simplify the process of creating Python bindings for C libraries. It parses C header files to automatically generate ctypes structures, unions, enums, and function prototypes, enabling easier interaction with shared C libraries. The project is actively maintained, with recent updates focused on stability and improvements, and currently supports Python 3.10 and newer.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install pyclibrary"],"cli":null},"imports":["from pyclibrary import CParser","from pyclibrary import CLibrary"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom pyclibrary import CParser\n\n# Create a dummy header file for demonstration\nheader_content = '''\n#define MY_VERSION_MAJOR 1\n#define MY_VERSION_MINOR 0\n\ntypedef struct {\n    int width;\n    int height;\n} Size;\n\nenum Color {\n    RED = 0,\n    GREEN,\n    BLUE\n};\n\nint calculate_area(Size s);\nvoid print_message(const char* msg);\n'''\nheader_file_path = \"temp_example_header.h\"\nwith open(header_file_path, \"w\") as f:\n    f.write(header_content)\n\ntry:\n    # Initialize the CParser with the header file(s)\n    parser = CParser([header_file_path])\n\n    print(\"--- Parsed Macros ---\")\n    print(f\"MY_VERSION_MAJOR: {parser.macros['MY_VERSION_MAJOR']}\")\n    print(f\"MY_VERSION_MINOR: {parser.macros['MY_VERSION_MINOR']}\")\n\n    print(\"\\n--- Parsed Types ---\")\n    print(f\"Size struct definition: {parser.structs['Size']}\")\n    print(f\"Color enum definition: {parser.enums['Color']}\")\n\n    print(\"\\n--- Parsed Functions ---\")\n    print(f\"calculate_area signature: {parser.functions['calculate_area']}\")\n    print(f\"print_message signature: {parser.functions['print_message']}\")\n\n    # To bind to a C library, you would typically do:\n    # from pyclibrary import CLibrary\n    # # Assuming a compiled shared library like 'libmyexample.so' or 'myexample.dll'\n    # # For this quickstart, we only demonstrate parsing, not live binding.\n    # try:\n    #     lib = CLibrary(header_file_path, 'libmyexample.so') # Or 'myexample.dll' on Windows\n    #     # Example function call (requires a real shared library):\n    #     # area = lib.calculate_area(width=10, height=20).r # Access return value\n    #     # lib.print_message(msg='Hello from Python')\n    # except OSError as e:\n    #     print(f\"\\nCould not load C library for live binding: {e}\")\n\nexcept Exception as e:\n    print(f\"An error occurred during parsing: {e}\")\nfinally:\n    # Clean up the dummy header file\n    if os.path.exists(header_file_path):\n        os.remove(header_file_path)","lang":"python","description":"This quickstart demonstrates how to use `pyclibrary.CParser` to parse a C header file and access its defined macros, structs, enums, and function prototypes. It creates a temporary header file, parses it, and prints the extracted information. While `pyclibrary` can also bind to dynamic libraries using `CLibrary`, that functionality is commented out in this example as it requires a pre-compiled C shared library.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"0.2.2","pypi_latest":"0.3.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.9,"avg_import_s":0.33,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.3,"mem_mb":8.4,"disk_size":"20.4M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":2,"import_time_s":0.24,"mem_mb":8.7,"disk_size":"21M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.4,"mem_mb":9,"disk_size":"22.5M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":1.9,"import_time_s":0.37,"mem_mb":9.8,"disk_size":"23M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.38,"mem_mb":8.9,"disk_size":"14.3M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":1.8,"import_time_s":0.41,"mem_mb":9.5,"disk_size":"15M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.38,"mem_mb":9,"disk_size":"14.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":1.8,"import_time_s":0.36,"mem_mb":9.7,"disk_size":"15M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.25,"mem_mb":8.8,"disk_size":"19.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pyclibrary","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"noisy","install_time_s":2.1,"import_time_s":0.22,"mem_mb":8.8,"disk_size":"20M"}]}}