pyrsb3 0.1.0__tar.gz

pyrsb3-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  rust:
+    name: fmt and clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+      - run: cargo fmt --check
+      - run: cargo clippy --all-targets -- -D warnings
+
+  test:
+    name: test (${{ matrix.os }}, python ${{ matrix.python }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.10", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Build and install
+        run: pip install ".[test]"
+      - name: Test
+        run: pytest -v
+      - name: Type stubs match the module
+        if: matrix.os == 'ubuntu-latest' && matrix.python == '3.13'
+        run: |
+          pip install mypy pyarrow-stubs
+          python -m mypy.stubtest rsb3._rsb3 --ignore-disjoint-bases --allowlist stubtest-allowlist.txt

pyrsb3-0.1.0/.github/workflows/workflow.yml

@@ -0,0 +1,90 @@
+name: release
+
+# The file name workflow.yml is the one registered on PyPI as trusted
+# publisher: do not rename it.
+#
+# Wheels for every platform on demand; on a tag vX.Y.Z they are also
+# published to PyPI by trusted publishing (the project must be registered as
+# a trusted publisher on pypi.org, environment "pypi").
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  # a tag has to name the version that Cargo.toml declares
+  version:
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: |
+          declared=$(grep -m1 '^version' Cargo.toml | cut -d'"' -f2)
+          test "v$declared" = "$GITHUB_REF_NAME" || { echo "tag $GITHUB_REF_NAME, Cargo.toml $declared"; exit 1; }
+
+  wheels:
+    name: wheel (${{ matrix.os }}, ${{ matrix.target }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - { os: ubuntu-latest, target: x86_64 }
+          - { os: ubuntu-latest, target: aarch64 }
+          - { os: macos-latest, target: aarch64 }
+          - { os: macos-latest, target: x86_64 }
+          - { os: windows-latest, target: x64 }
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          manylinux: auto
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Test the wheel
+        # only where the wheel runs on the machine that built it
+        if: (matrix.os == 'ubuntu-latest' && matrix.target == 'x86_64') || (matrix.os == 'macos-latest' && matrix.target == 'aarch64') || matrix.os == 'windows-latest'
+        shell: bash
+        run: |
+          python -m pip install pytest
+          # sem --no-index: a dependência pyarrow vem do PyPI, o pyrsb3 de dist/
+          python -m pip install --find-links dist pyrsb3
+          python -m pytest -q
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.os }}-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [version, wheels, sdist]
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@release/v1

pyrsb3-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+/target
+Cargo.lock
+__pycache__/
+*.so
+*.pyd
+.venv/
+dist/
+.pytest_cache/
+.mypy_cache/
+.DS_Store
+.claude/

pyrsb3-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## [0.1.0] — 2026-10-29
+
+Primeira versão: `fetch`, `parse`, `parse_bytes`, `load`, `to_parquet`,
+`schema` e `file_name` sobre o crate `rsb3` 0.2.0; saída como `pyarrow.Table`
+no esquema v1; exceções `LayoutError`, `RecordError` e `DownloadError`.

pyrsb3-0.1.0/CITATION.cff

@@ -0,0 +1,28 @@
+cff-version: 1.2.0
+message: "If you use this package, please cite it as below."
+title: "pyrsb3: B3 public files as Arrow (Python bindings of the rsb3 Rust crate)"
+type: software
+license: MIT
+repository-code: "https://github.com/milkway/pyrsb3"
+url: "https://pypi.org/project/pyrsb3/"
+authors:
+  - family-names: Leite
+    given-names: André
+    email: leite@castlab.org
+    orcid: "https://orcid.org/0000-0002-4718-9766"
+version: "0.1.0"
+date-released: "2026-10-29"
+keywords:
+  - B3
+  - Bovespa
+  - COTAHIST
+  - finance
+  - Arrow
+  - Python
+  - Rust
+abstract: >-
+  pyrsb3 is the Python binding of rsb3, a Rust crate that downloads, validates
+  and converts the public files of B3, the Brazilian stock exchange, into
+  Arrow. The COTAHIST parser reads the official 245-byte fixed-width historical
+  quotes file strictly, keeps prices as integer cents and hands the result to
+  Python as a pyarrow.Table through the Arrow C Data Interface.