feat(pdf): implement advanced PDF operations (v0.0.4) #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

nedanwr merged 37 commits into develop from feat/pdf-advanced-operations

Jan 1, 2026

.github/PULL_REQUEST_TEMPLATE.md

-Original file line number
+Diff line change
@@ -0,0 +1,57 @@
+    ## Description
+    <!-- Provide a brief description of the changes in this PR -->
+    ## Type of Change
+    <!-- Mark the relevant option with an "x" -->
+    - [ ] `feat`: New feature
+    - [ ] `fix`: Bug fix
+    - [ ] `docs`: Documentation only
+    - [ ] `refactor`: Code refactoring (no behavior change)
+    - [ ] `perf`: Performance improvement
+    - [ ] `test`: Adding or updating tests
+    - [ ] `build`: Build system or dependencies
+    - [ ] `ci`: CI/workflow changes
+    - [ ] `chore`: Maintenance tasks
+    ## Scope
+    <!-- Which part of the codebase does this affect? -->
+    - [ ] `cli` - CLI commands and interface
+    - [ ] `core` - Core library functionality
+    - [ ] `tools` - Tool integrations (qpdf, ghostscript, etc.)
+    - [ ] `pdf` - PDF-specific operations
+    - [ ] `packaging` - Package configurations
+    - [ ] Other: <!-- specify -->
+    ## Related Issues
+    <!-- Link any related issues using "Closes #123" or "Refs #123" -->
+    ## Checklist
+    - [ ] I have read the [commit convention](./COMMIT_CONVENTION.md)
+    - [ ] My commits follow the conventional format: `type(scope): description`
+    - [ ] I have added/updated tests as appropriate
+    - [ ] All tests pass locally (`cargo test`)
+    - [ ] Code passes lint checks (`cargo clippy` and `cargo fmt`)
+    - [ ] I have updated documentation if needed
+    ## Breaking Changes
+    <!-- If this PR introduces breaking changes, describe them here -->
+    - [ ] This PR contains breaking changes
+    <!-- If yes, explain what breaks and how users should migrate -->
+    ## Screenshots / Output
+    <!-- If applicable, add screenshots or command output demonstrating the changes -->
+    ```
+    # Example command output
+    ```

.github/workflows/ci.yml

-Original file line number
+Diff line change
@@ -0,0 +1,77 @@
+    name: CI
+    on:
+      push:
+        branches: [main]
+      pull_request:
+        branches: ["*"]
+    env:
+      CARGO_TERM_COLOR: always
+      RUST_BACKTRACE: 1
+    jobs:
+      test:
+        name: Test (${{ matrix.os }})
+        runs-on: ${{ matrix.os }}
+        strategy:
+          fail-fast: false
+          matrix:
+            os: [ubuntu-latest, macos-latest, windows-latest]
+        steps:
+          - name: Checkout
+            uses: actions/checkout@v4
+          - name: Install Rust toolchain
+            uses: dtolnay/rust-toolchain@stable
+          - name: Cache Rust dependencies
+            uses: Swatinem/rust-cache@v2
+          # Install dependencies for integration tests
+          - name: Install dependencies (Ubuntu)
+            if: runner.os == 'Linux'
+            run: |
+              sudo apt-get update
+              sudo apt-get install -y qpdf ghostscript
+          - name: Install dependencies (macOS)
+            if: runner.os == 'macOS'
+            run: |
+              brew install qpdf ghostscript
+          - name: Install dependencies (Windows)
+            if: runner.os == 'Windows'
+            run: |
+              choco install qpdf ghostscript --yes
+          - name: Build
+            run: cargo build --all-targets
+          - name: Run tests
+            run: cargo test --all-targets
+          - name: Run doc tests
+            run: cargo test --doc
+      lint:
+        name: Lint
+        runs-on: ubuntu-latest
+        steps:
+          - name: Checkout
+            uses: actions/checkout@v4
+          - name: Install Rust toolchain
+            uses: dtolnay/rust-toolchain@stable
+            with:
+              components: clippy, rustfmt
+          - name: Cache Rust dependencies
+            uses: Swatinem/rust-cache@v2
+          - name: Check formatting
+            run: cargo fmt --all -- --check
+          - name: Clippy
+            run: cargo clippy --all-targets --all-features -- -D warnings

.gitignore

-Original file line number
+Diff line change
@@ Expand Up / @@ -42,3 +42,6 @@ desktop.ini @@
     *.tmp
     *.temp
+    # PDF files
+    *.pdf

CONTRIBUTING.md

            
                      Original file line number
                      Diff line number
                      Diff line change
                  
    @@ -59,7 +59,7 @@ ForgeKit is organized as a Rust workspace with two main crates:
  
    - A `JobSpec` describes what you want to do (merge PDFs, resize images, etc.)

    - It's pure data - no execution logic

    - Examples: `PdfMerge`, `PdfSplit`, `ImageConvert` (coming soon)

    - Examples: `PdfMerge`, `PdfSplit`, `PdfCompress`

    **Tools** (`crates/core/src/tools/`)

    @@ -94,13 +94,13 @@ ForgeKit is organized as a Rust workspace with two main crates:
  
       }

       ```

    2. **Create a tool adapter** (`crates/core/src/tools/pdfcpu.rs`):

    2. **Create a tool adapter** (`crates/core/src/tools/gs.rs`):

       ```rust

       pub struct PdfcpuTool;

       pub struct GsTool;

       impl Tool for PdfcpuTool {

           fn name(&self) -> &'static str { "pdfcpu" }

       impl Tool for GsTool {

           fn name(&self) -> &'static str { "gs" }

           fn probe(&self, config: &ToolConfig) -> Result<ToolInfo> { /* ... */ }

           fn version(&self, path: &PathBuf) -> Result<String> { /* ... */ }

       }

    @@ -178,7 +178,7 @@ Keep commits focused and descriptive:
  
    Add PDF compression support

    - Add PdfCompress JobSpec variant

    - Implement pdfcpu tool adapter

    - Implement Ghostscript tool adapter

    - Add pdf compress CLI subcommand

    - Add tests for compression levels

    ```

Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

README.md

            
                      Original file line number
                      Diff line number
                      Diff line change
                  
    @@ -104,14 +104,14 @@ Then install them based on your platform:
  
    **macOS (Homebrew):**

    ```bash

    brew install qpdf pdfcpu tesseract ffmpeg libvips exiftool

    brew install qpdf ghostscript tesseract ffmpeg libvips exiftool

    pip3 install ocrmypdf

    ```

    **Windows (winget/scoop):**

    ```powershell

    winget install qpdf.qpdf pdfcpu.pdfcpu tesseract-ocr Gyan.FFmpeg

    winget install qpdf.qpdf ArtifexSoftware.GhostScript tesseract-ocr Gyan.FFmpeg

    scoop install libvips exiftool

    pip install ocrmypdf

    ```

    @@ -121,21 +121,21 @@ pip install ocrmypdf
  
    **Debian/Ubuntu:**

    ```bash

    sudo apt install qpdf pdfcpu tesseract-ocr ffmpeg libvips-tools libimage-exiftool-perl python3-pip

    sudo apt install qpdf ghostscript tesseract-ocr ffmpeg libvips-tools libimage-exiftool-perl python3-pip

    pip3 install ocrmypdf

    ```

    **Fedora/RHEL:**

    ```bash

    sudo dnf install qpdf pdfcpu tesseract ffmpeg libvips perl-Image-ExifTool python3-pip

    sudo dnf install qpdf ghostscript tesseract ffmpeg libvips perl-Image-ExifTool python3-pip

    pip3 install ocrmypdf

    ```

    **Arch Linux:**

    ```bash

    sudo pacman -S qpdf pdfcpu tesseract ffmpeg libvips perl-image-exiftool python-pip

    sudo pacman -S qpdf ghostscript tesseract ffmpeg libvips perl-image-exiftool python-pip

    pip3 install ocrmypdf

    ```

    @@ -148,7 +148,7 @@ pip3 install ocrmypdf
  
    - **Merge**: Combine multiple PDFs into one

    - **Split**: Extract pages by ranges or keywords

    - **Linearize**: Optimize for fast web view

    - **Compress**: Reduce file size with presets (coming soon)

    - **Compress**: Reduce file size with Ghostscript presets

    - **OCR**: Add searchable text layer (coming soon)

    - **Metadata**: View/edit PDF metadata (coming soon)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(pdf): implement advanced PDF operations (v0.0.4) #2

Uh oh!

Diff view

Diff view

There are no files selected for viewing

Uh oh!

Uh oh!