ebook-rs 0.18.0__tar.gz

ebook_rs-0.18.0/.github/workflows/ci.yml

@@ -0,0 +1,61 @@
+name: Rust CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    name: Test & Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+
+      - name: Check Formatting
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets --all-features -- -D warnings
+
+      # The binary and the library share an output filename on MSVC (cargo normalizes
+      # `ebook-rs` -> `ebook_rs`, colliding with the `ebook_rs` lib PDB). Building lib, bin,
+      # tests and examples in one `cargo test --all-targets` invocation could then fail
+      # intermittently with:
+      #   crate `write_fonts` required to be available in rlib format, but was not found in this form
+      # Building the binary separately keeps test compilation deterministic.
+      - name: Run Tests
+        run: cargo test --lib --tests --all-features --no-fail-fast
+
+      - name: Build Binary
+        run: cargo build --all-features --bins
+
+      - name: Build Examples
+        run: cargo build --all-features --examples
+
+      - name: Dependency Vulnerability Audit
+        run: |
+          cargo install cargo-audit --locked
+          cargo audit
+
+      - name: Random 25 Project Gutenberg Books Stress Test
+        run: |
+          chmod +x scripts/fetch_gutenberg.sh
+          ./scripts/fetch_gutenberg.sh 25 corpus/ci_gutenberg --random
+          cargo run --release --all-features --example corpus_stress -- corpus/ci_gutenberg
+
+      - name: Install wasm-pack & Target
+        run: |
+          rustup target add wasm32-unknown-unknown
+          curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh || cargo install wasm-pack || true
+
+      - name: Build & Check WASM
+        run: |
+          wasm-pack test --node -- --no-default-features --features wasm || cargo check --target wasm32-unknown-unknown --no-default-features --features wasm
+          wasm-pack build --target web --out-dir pkg -- --no-default-features --features wasm

ebook_rs-0.18.0/.github/workflows/deploy-docs.yml

@@ -0,0 +1,61 @@
+name: Deploy Documentation to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'website/**'
+      - '.github/workflows/deploy-docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: 'pages'
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          # Astro 7 requires Node >= 22.23.4; the runner's cached 22.23.3 made
+          # `npm run build` abort with "Node.js v22.23.3 is not supported".
+          node-version: '24'
+          check-latest: true
+          cache: 'npm'
+          cache-dependency-path: 'website/package.json'
+
+      - name: Install dependencies
+        working-directory: ./website
+        run: npm ci || npm install
+
+      - name: Build Astro site
+        working-directory: ./website
+        run: npm run build
+
+      - name: Upload Pages Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./website/dist
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

ebook_rs-0.18.0/.github/workflows/fuzz-stress.yml

@@ -0,0 +1,77 @@
+name: Continuous Real-World Corpus Stress & Fuzzing
+
+on:
+  schedule:
+    - cron: '0 4 * * 0' # Every Sunday at 04:00 UTC
+  workflow_dispatch:
+
+jobs:
+  corpus-stress-test:
+    name: Real-World Corpus & Corruption Stress Test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Install Rust Toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache Project Gutenberg Corpus
+        id: cache-gutenberg
+        uses: actions/cache@v4
+        with:
+          path: corpus/gutenberg
+          key: gutenberg-corpus-v1
+
+      - name: Fetch Project Gutenberg Books
+        run: |
+          chmod +x scripts/fetch_gutenberg.sh
+          ./scripts/fetch_gutenberg.sh 25 corpus/gutenberg --random
+
+      - name: Run Sample Suite Stress Test
+        run: |
+          echo "## 🧪 Local Golden Sample Stress Test" >> $GITHUB_STEP_SUMMARY
+          cargo run --release --all-features --example corpus_stress -- samples > sample_report.md
+          cat sample_report.md >> $GITHUB_STEP_SUMMARY
+
+      - name: Run Project Gutenberg Mass Stress Test
+        run: |
+          echo -e "\n## 📚 Project Gutenberg Mass Stress Test (25 Random Real-World Books)" >> $GITHUB_STEP_SUMMARY
+          cargo run --release --all-features --example corpus_stress -- corpus/gutenberg > gutenberg_report.md
+          cat gutenberg_report.md >> $GITHUB_STEP_SUMMARY
+
+      - name: Upload Stress Test Reports
+        uses: actions/upload-artifact@v4
+        with:
+          name: stress-test-reports
+          path: |
+            sample_report.md
+            gutenberg_report.md
+
+  mutation-fuzzing:
+    name: 10-Minute Continuous libFuzzer Mutation Run
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - name: Install Nightly Rust Toolchain
+        uses: dtolnay/rust-toolchain@nightly
+
+      - name: Install cargo-fuzz
+        run: cargo install cargo-fuzz --locked
+
+      - name: Seed Fuzz Corpus
+        run: |
+          mkdir -p fuzz/corpus/fuzz_from_bytes
+          # Seed with sample files up to 256KB to prime coverage-guided mutation engine
+          for file in samples/*; do
+            if [ -f "$file" ]; then
+              head -c 262144 "$file" > "fuzz/corpus/fuzz_from_bytes/$(basename "$file")" || true
+            fi
+          done
+
+      - name: Run Coverage-Guided Fuzzing (10 minutes)
+        run: |
+          cd fuzz
+          cargo +nightly fuzz run fuzz_from_bytes -- -max_total_time=600 -rss_limit_mb=4096

ebook_rs-0.18.0/.github/workflows/npm.yml

@@ -0,0 +1,76 @@
+name: Publish to npm
+
+on:
+  # Publishing is driven by the GitHub Release so that the npm version, the
+  # PyPI version and the release notes all come from the same tag. The old
+  # `push: tags` trigger is intentionally gone: together with `release` it
+  # produced two concurrent publishes per release, and the loser failed.
+  release:
+    types: [published]
+  workflow_dispatch:
+
+# Never run two publishes at once; npm rejects duplicate versions.
+concurrency:
+  group: npm-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  # The registry rejects the unscoped name `ebook-rs` with
+  # `400 Bad Request - That word is not allowed`, so the package lives under
+  # the user scope. wasm-pack regenerates pkg/package.json on every build and
+  # ignores [package.metadata.wasm-pack.package], so the name is patched here.
+  NPM_PACKAGE_NAME: '@svstark/ebook-rs'
+  NPM_REPOSITORY_URL: 'https://github.com/SV-stark/ebook-rs'
+
+jobs:
+  publish-npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      # Required for npm Trusted Publishing (OIDC) and for the provenance
+      # attestation npm attaches to the tarball.
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+      - name: Build WebAssembly package
+        run: wasm-pack build --target web --out-dir pkg -- --no-default-features --features wasm
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          # Trusted publishing needs Node >= 22.14 and npm >= 11.5.1.
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      # wasm-pack derives `name` from the crate name and ignores the
+      # [package.metadata.wasm-pack.package] table in Cargo.toml.
+      - name: Fix package manifest for npm
+        working-directory: pkg
+        run: |
+          npm pkg set "name=$NPM_PACKAGE_NAME"
+          npm pkg set "repository.type=git" "repository.url=$NPM_REPOSITORY_URL"
+
+      - name: Show package manifest
+        working-directory: pkg
+        run: |
+          node -e "const p=require('./package.json'); console.log(p.name + '@' + p.version); console.log('repository:', p.repository && p.repository.url)"
+
+      # No NODE_AUTH_TOKEN and no NPM_TOKEN: the npm CLI detects the GitHub
+      # Actions OIDC environment and exchanges the ID token for short-lived
+      # publish credentials (npm Trusted Publishing).
+      - name: Publish to npm
+        working-directory: pkg
+        run: npm publish --access public

ebook_rs-0.18.0/.github/workflows/pypi.yml

@@ -0,0 +1,85 @@
+name: Publish Python Wheels to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+# Never run two publishes at once; PyPI rejects duplicate filenames.
+concurrency:
+  group: pypi-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  wheels:
+    name: Build wheels on ${{ matrix.os }} (${{ matrix.target || 'default' }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: ubuntu-latest
+            target: aarch64
+          - os: windows-latest
+            target: x64
+          - os: macos-latest
+            target: x86_64
+          - os: macos-latest
+            target: aarch64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --features python --strip
+
+      # maturin-action@v1 has no `sdist` input (it was silently ignored), so the
+      # sdist is built as its own step. It lands in target/wheels and is uploaded
+      # with the linux-x86_64 artifact.
+      - name: Build sdist
+        if: matrix.os == 'ubuntu-latest' && matrix.target == 'x86_64'
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out target/wheels
+
+      - name: Upload wheels artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
+          path: target/wheels/*
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: [wheels]
+    # Trusted Publishing: maturin exchanges this OIDC token for a short-lived
+    # PyPI API token. No PYPI_API_TOKEN secret is needed (or wanted).
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+
+      - name: Publish wheels to PyPI
+        uses: PyO3/maturin-action@v1
+        with:
+          command: upload
+          # --skip-existing makes re-runs after a partial upload idempotent.
+          args: --non-interactive --skip-existing *

ebook_rs-0.18.0/.gitignore

@@ -0,0 +1,15 @@
+/target
+/boko
+scratch/
+website/node_modules/
+website/dist/
+website/.astro/
+fuzz/corpus/
+fuzz/artifacts/
+fuzz/target/
+corpus/
+# wasm-pack output (regenerated by CI and locally)
+/pkg/
+# machine-local cargo config (disables the global kache wrapper for this repo)
+/.cargo/
+hp.pdf