pycapng 0.3__tar.gz

pycapng-0.3/.github/workflows/build.yml

@@ -0,0 +1,133 @@
+name: Build
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.create.outputs.tag }}
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Create tag and release
+        id: create
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION=$(cat VERSION)
+          SHA=$(git rev-parse --short HEAD)
+          TAG="v${VERSION}-${SHA}"
+          echo "tag=${TAG}" >> $GITHUB_OUTPUT
+          git tag "${TAG}" 2>/dev/null || echo "tag already exists"
+          git push origin "${TAG}" 2>/dev/null || echo "tag already pushed"
+          gh release create "${TAG}" \
+            --title "${TAG}" \
+            --notes "Automated build from commit ${GITHUB_SHA}" \
+            2>/dev/null || echo "release already exists"
+
+  build:
+    needs: tag
+    name: ${{ matrix.os }} / py${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest      # x86_64
+          - ubuntu-24.04-arm   # aarch64
+#          - macos-13           # x86_64
+          - macos-14           # arm64
+        python-version: ['3.11', '3.12', '3.13', '3.14']
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - name: Install pybind11
+        run: pip install pybind11
+
+      - name: Configure
+        run: |
+          cmake -S . -B build \
+            -DCMAKE_BUILD_TYPE=Release \
+            -Dpybind11_DIR=$(python3 -m pybind11 --cmakedir)
+
+      - name: Build
+        run: cmake --build build --target pycapng --parallel
+
+      - name: Stage artifact
+        shell: bash
+        run: |
+          SO=$(find build/bindings -name "pycapng*.so" -o -name "pycapng*.dylib" | head -1)
+          cp "$SO" .
+          echo "ARTIFACT=$(basename $SO)" >> $GITHUB_ENV
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: ${{ env.ARTIFACT }}
+          path: ${{ env.ARTIFACT }}
+
+      - name: Attach to release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release upload "${{ needs.tag.outputs.tag }}" "${{ env.ARTIFACT }}" --repo "${{ github.repository }}" --clobber
+
+  build-debian:
+    needs: tag
+    name: debian-bookworm-${{ matrix.arch }} / py3.14
+    runs-on: ${{ matrix.runner }}
+    container: ghcr.io/astral-sh/uv:python3.14-bookworm-slim
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest     # x86_64
+            arch: x86_64
+          - runner: ubuntu-24.04-arm  # aarch64
+            arch: aarch64
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install build dependencies
+        run: apt-get update -qq && apt-get install -y --no-install-recommends cmake build-essential gh
+
+      - name: Install pybind11
+        run: uv pip install --system pybind11
+
+      - name: Configure
+        run: |
+          cmake -S . -B build \
+            -DCMAKE_BUILD_TYPE=Release \
+            -Dpybind11_DIR=$(python3 -m pybind11 --cmakedir)
+
+      - name: Build
+        run: cmake --build build --target pycapng --parallel
+
+      - name: Stage artifact
+        run: |
+          SO=$(find build/bindings -name "pycapng*.so" | head -1)
+          cp "$SO" .
+          echo "ARTIFACT=$(basename $SO)" >> $GITHUB_ENV
+
+      - uses: actions/upload-artifact@v7
+        with:
+          name: ${{ env.ARTIFACT }}-debian-bookworm
+          path: ${{ env.ARTIFACT }}
+
+      - name: Attach to release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release upload "${{ needs.tag.outputs.tag }}" "${{ env.ARTIFACT }}" --repo "${{ github.repository }}" --clobber

pycapng-0.3/.github/workflows/release.yml

@@ -0,0 +1,90 @@
+name: Build & publish wheels
+
+# Wheels are built on every push/PR to catch breakage early.
+# They are *published* to PyPI only when a version tag like `v0.2.0` is pushed.
+#
+# To release:
+#   git tag v0.2.0
+#   git push origin v0.2.0
+#
+# PyPI publishing uses Trusted Publishing (OIDC) — no API token needed.
+# Set it up once at https://pypi.org/manage/project/pycapng/settings/publishing/
+# with environment name "pypi".
+
+on:
+  push:
+    branches: [main, dev]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ── Wheels ────────────────────────────────────────────────────────────────
+  build_wheels:
+    name: wheels · ${{ matrix.name }}
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { name: linux-x86_64,  runner: ubuntu-latest,    archs: x86_64  }
+          - { name: linux-aarch64, runner: ubuntu-24.04-arm, archs: aarch64 }
+          - { name: macos-arm64,   runner: macos-14,         archs: arm64   }
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0        # setuptools-scm needs full history + tags
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.23.3
+        env:
+          CIBW_ARCHS: ${{ matrix.archs }}
+        # All other config lives in [tool.cibuildwheel] in pyproject.toml.
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.name }}
+          path: ./wheelhouse/*.whl
+
+  # ── Source distribution ───────────────────────────────────────────────────
+  build_sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build sdist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: ./dist/*.tar.gz
+
+  # ── Publish ───────────────────────────────────────────────────────────────
+  publish:
+    name: publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    # Only publish on a clean version tag (v0.2.0, not v0.1-abc1234).
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pycapng
+    permissions:
+      id-token: write           # required for OIDC Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: "*"
+          merge-multiple: true  # collect all wheels + sdist into dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

pycapng-0.3/.gitignore

@@ -0,0 +1,19 @@
+*~
+.pcapsh_history
+
+# build output
+build/
+*.so
+*.dylib
+*.elc
+
+# Python bytecode
+__pycache__/
+*.pyc
+*.pyo
+
+# macOS metadata
+.DS_Store
+
+# pcapng capture files at repo root (test/scratch files)
+*.pcapng

pycapng-0.3/CMakeLists.txt

@@ -0,0 +1,77 @@
+cmake_minimum_required (VERSION 3.20)
+project (libpcapng)
+
+if(POLICY CMP0148)
+  cmake_policy(SET CMP0148 NEW)
+endif()
+
+if(${CMAKE_CURRENT_SOURCE_DIR} STREQUAL ${CMAKE_CURRENT_BINARY_DIR})
+message(FATAL_ERROR "CMake generation is not allowed within the source directory!
+Remove the CMakeCache.txt file and try again from another folder, e.g.:
+
+   rm CMakeCache.txt
+   mkdir build
+   cd build
+   cmake ..
+")
+endif()
+
+# add_definitions(-DDEBUG=1)
+include(GNUInstallDirs)
+enable_testing()
+
+include(FindPkgConfig)
+include(FindPackageHandleStandardArgs)
+
+file(STRINGS VERSION VERSION)
+set(LIBPCAPNG_VERSION ${VERSION})
+file(STRINGS "VERSION" LIBPCAPNG_VERSION)
+string(REGEX MATCH "^[0-9]+" LIBPCAPNG_VERSION_MAJOR ${LIBPCAPNG_VERSION})
+string(REGEX MATCH "[0-9]+$" LIBPCAPNG_VERSION_MINOR ${LIBPCAPNG_VERSION})
+message("Libpcapng Version: ${LIBPCAPNG_VERSION}")
+message("Libpcapng Version Major: ${LIBPCAPNG_VERSION_MAJOR}")
+message("Libpcapng Version Minor: ${LIBPCAPNG_VERSION_MINOR}")
+
+configure_file("${libpcapng_SOURCE_DIR}/libpcapng.pc.cmake" "${libpcapng_BINARY_DIR}/libpcapng.pc")
+install(FILES "${libpcapng_BINARY_DIR}/libpcapng.pc" DESTINATION "${CMAKE_INSTALL_FULL_LIBDIR}/pkgconfig" COMPONENT Headers)
+
+include_directories(AFTER ${libpcapng_SOURCE_DIR}/lib/include)
+
+find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+set(PYBIND11_FINDPYTHON ON)
+find_package(pybind11 CONFIG REQUIRED)
+
+# <pybind11>
+# execute_process (
+#    COMMAND pybind11-config --cmakedir
+#    OUTPUT_VARIABLE PYBIND11_CMAKEDIR
+#    OUTPUT_STRIP_TRAILING_WHITESPACE
+# )
+# set(pybind11_ROOT "${PYBIND11_CMAKEDIR}")
+# set(PYBIND11_FINDPYTHON "off")
+# find_package(pybind11 CONFIG REQUIRED)
+# message("Using Python libraries: ${Python_LIBRARIES}")
+# </pybind11>
+
+# find_path(WANDIO_INCLUDE_DIR NAMES wandio.h)
+# find_library(WANDIO_LIBRARY NAMES wandio REQUIRED)
+# find_package_handle_standard_args(wandio "Could not find wandio library header and/or library ${DEFAULT_MSG}" WANDIO_INCLUDE_DIR WANDIO_LIBRARY)
+# if(WANDIO_FOUND)
+#   message("-- Found wandio: ${WANDIO_INCLUDE_DIR}" )
+# endif()
+
+set(LIBPCAPNG_INCLUDE_DIRS "${libpcapng_SOURCE_DIR}/lib/include/")
+if (LINUX)
+  set(LIBPCAPNG_LIBRARY "${libpcapng_BINARY_DIR}/lib/libpcapng.so")
+endif()
+if (APPLE)
+  set(CMAKE_MACOSX_RPATH ON)
+  set(LIBPCAPNG_LIBRARY "${libpcapng_BINARY_DIR}/lib/libpcapng.dylib")
+endif()
+
+add_definitions(-g)
+
+add_subdirectory(lib)
+add_subdirectory(bin)
+add_subdirectory(bindings)
+

pycapng-0.3/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2021 Devo Inc.
+Copyright (c) 2022 Sebastien Tricaud
+
+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.

pycapng-0.3/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.2
+Name: pycapng
+Version: 0.3
+Summary: Python bindings for libpcapng — read/write pcapng files and live packet capture
+Keywords: pcapng,pcap,packet-capture,network,packet,wireshark
+Author-Email: Seb Tricaud <sebastien.tricaud@proton.me>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: C++
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Project-URL: Homepage, https://github.com/stricaud/libpcapng
+Project-URL: Repository, https://github.com/stricaud/libpcapng
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# libpcapng
+
+C library with Python bindings to read and write pcapng buffers. It follows the pcapng standard from https://github.com/pcapng/pcapng
+
+## Writing your first packet
+
+Let's write a TCP SYN using libdumbnet and push the buffer into a pcapng file:
+
+```c
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <dumbnet.h>
+#include <libpcapng/libpcapng.h>
+
+int main(int argc, char **argv)
+{
+	FILE *pcapout;
+
+	char *pkt;
+	size_t pktsize = 40;
+
+	pkt = (char *)malloc(pktsize);
+	if (!pkt) {
+	   fprintf(stderr, "Cannot allocate pkt!\n");
+	   return -1;
+	}
+
+	pcapout = fopen("pkts.pcap", "wb");
+
+	libpcapng_write_header_to_file(pcapout);
+
+	uint32_t saddr = 0x0100a8c0;
+	uint32_t daddr = 0x561c1268;
+
+	ip_pack_hdr(pkt, 0, pktsize, 1, 0, 128, IP_PROTO_TCP, saddr, daddr);
+	tcp_pack_hdr(pkt + 20, 4096, 80, 1, 0, TH_SYN, 14, 0);
+	ip_checksum(pkt, pktsize);
+
+	libpcapng_write_enhanced_packet_to_file(pcapout, pkt, pktsize);
+
+	fflush(pcapout);
+	fclose(pcapout);
+
+	free(pkt);
+
+	return 0;
+}
+```
+
+Compile using:
+```
+gcc test.c -o test -ldumbnet $(pkg-config libpcapng --libs --cflags)
+```
+
+And after running, open the created pcap with wireshark:
+
+<p align="center"><img src="doc/firstpkt.png" size="30%"/></p>

pycapng-0.3/README.md

@@ -0,0 +1,59 @@
+# libpcapng
+
+C library with Python bindings to read and write pcapng buffers. It follows the pcapng standard from https://github.com/pcapng/pcapng
+
+## Writing your first packet
+
+Let's write a TCP SYN using libdumbnet and push the buffer into a pcapng file:
+
+```c
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <dumbnet.h>
+#include <libpcapng/libpcapng.h>
+
+int main(int argc, char **argv)
+{
+	FILE *pcapout;
+
+	char *pkt;
+	size_t pktsize = 40;
+
+	pkt = (char *)malloc(pktsize);
+	if (!pkt) {
+	   fprintf(stderr, "Cannot allocate pkt!\n");
+	   return -1;
+	}
+
+	pcapout = fopen("pkts.pcap", "wb");
+
+	libpcapng_write_header_to_file(pcapout);
+
+	uint32_t saddr = 0x0100a8c0;
+	uint32_t daddr = 0x561c1268;
+
+	ip_pack_hdr(pkt, 0, pktsize, 1, 0, 128, IP_PROTO_TCP, saddr, daddr);
+	tcp_pack_hdr(pkt + 20, 4096, 80, 1, 0, TH_SYN, 14, 0);
+	ip_checksum(pkt, pktsize);
+
+	libpcapng_write_enhanced_packet_to_file(pcapout, pkt, pktsize);
+
+	fflush(pcapout);
+	fclose(pcapout);
+
+	free(pkt);
+
+	return 0;
+}
+```
+
+Compile using:
+```
+gcc test.c -o test -ldumbnet $(pkg-config libpcapng --libs --cflags)
+```
+
+And after running, open the created pcap with wireshark:
+
+<p align="center"><img src="doc/firstpkt.png" size="30%"/></p>