pdf-section-binding 1.0.0__tar.gz

pdf_section_binding-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+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.

pdf_section_binding-1.0.0/MANIFEST.in

@@ -0,0 +1,15 @@
+include README.md
+include LICENSE
+include pyproject.toml
+include requirements.txt
+recursive-include src/pdf_section_binding *.py
+recursive-include tests *.py
+include tests/test-data/.gitkeep
+
+# Exclude moved utility files from distribution
+exclude src/demo.py
+exclude src/section_binding.py
+exclude src/test_section_binding.py
+exclude src/create_test_pdf.py
+exclude src/example_usage.py
+exclude src/add_page_numbers.py

pdf_section_binding-1.0.0/PKG-INFO

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: pdf-section-binding
+Version: 1.0.0
+Summary: A CLI tool for reordering PDF pages for section binding (bookbinding)
+Home-page: https://github.com/sravankumarrekandar/pdf-section-binding
+Author: Sravan Kumar Rekandar
+Author-email: Sravan Kumar Rekandar <sravankumarrekandar@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/pdf-section-binding
+Project-URL: Bug Reports, https://github.com/yourusername/pdf-section-binding/issues
+Project-URL: Source, https://github.com/yourusername/pdf-section-binding
+Project-URL: Documentation, https://github.com/yourusername/pdf-section-binding#readme
+Keywords: pdf,bookbinding,section-binding,printing,cli,page-reordering,signatures,folding
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Printing
+Classifier: Topic :: Utilities
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyPDF2>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: flake8>=5.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0.0; extra == "test"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# PDF Section Binding Tool
+
+This tool reorders PDF pages for section binding (bookbinding), where pages are arranged in signatures (folded sheets) so that when printed and folded, they appear in the correct reading order.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install pdf-section-binding
+```
+
+### From Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/pdf-section-binding.git
+cd pdf-section-binding
+```
+
+2. Create and activate virtual environment:
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On macOS/Linux
+# or
+venv\Scripts\activate  # On Windows
+```
+
+3. Install in development mode:
+```bash
+pip install -e .
+```
+
+## Usage
+
+After installation, use the `pdf-section-binding` command (or the shorter `section-binding` alias):
+
+```bash
+pdf-section-binding input.pdf [options]
+```
+
+### Command Line Options
+
+- `-o, --output`: Output PDF file path (default: `input_name_section_bound.pdf`)
+- `-s, --signature-size`: Pages per signature - must be multiple of 4 (default: 8)
+- `--dry-run`: Preview analysis without creating output file
+- `-v, --verbose`: Enable verbose output with progress tracking
+- `-q, --quiet`: Suppress all output except errors
+- `--force`: Overwrite output file if it exists
+- `--version`: Show version information
+- `-h, --help`: Show help message
+
+### Examples
+
+```bash
+# Basic usage with 8-page signatures (2 papers per signature)
+pdf-section-binding book.pdf
+
+# Specify output file and 4-page signatures (1 paper per signature)  
+pdf-section-binding book.pdf -o output.pdf -s 4
+
+# Use 16-page signatures (4 papers per signature)
+pdf-section-binding book.pdf -s 16
+
+# Use 40-page signatures (10 papers per signature)
+pdf-section-binding book.pdf -s 40
+
+# Preview without creating file (dry run)
+pdf-section-binding book.pdf --dry-run
+
+# Verbose output with progress tracking
+pdf-section-binding book.pdf -v
+
+# Quiet mode (minimal output)
+pdf-section-binding book.pdf -q
+
+# Force overwrite existing output
+pdf-section-binding book.pdf --force
+```
+
+## Features
+
+✨ **Enhanced CLI Tool**
+- 🎨 **Colorized output** for better user experience
+- 📊 **Progress tracking** for large documents
+- 🔍 **Dry run mode** to preview without creating files
+- ⚡ **Fast processing** with optimized algorithms
+- 🛡️ **Robust error handling** with helpful suggestions
+- 📏 **Flexible signature sizes** (any multiple of 4)
+
+🔧 **Advanced Options**
+- Verbose and quiet modes
+- Force overwrite protection
+- Input validation with helpful error messages
+- Multiple command aliases (`pdf-section-binding` or `section-binding`)
+
+📦 **Library Usage**
+- Use as a Python library in your own projects
+- Clean API with `SectionBindingProcessor` class
+- Comprehensive test suite included
+
+## CLI Features in Detail
+
+### Smart Error Messages
+The tool provides helpful suggestions when you make mistakes:
+
+```bash
+$ pdf-section-binding book.pdf -s 15
+Error: Signature size must be a multiple of 4 (each paper = 4 pages).
+You specified 15. Try: 12 or 16
+```
+
+### Progress Tracking
+For large documents, see progress in real-time:
+
+```bash
+$ pdf-section-binding large-book.pdf -v
+PDF Section Binding Tool v1.0.0
+==================================================
+[INFO] Reading PDF: large-book.pdf
+[INFO] Total pages: 1500
+[INFO] Signature size: 8
+[INFO] Creating reordered PDF...
+Creating PDF: [████████████████████████████████████████████████] 100% (1500/1500)
+[INFO] Writing output: large-book_section_bound.pdf
+✅ Successfully created: large-book_section_bound.pdf
+```
+
+### Dry Run Analysis
+Preview the binding setup without creating files:
+
+```bash
+$ pdf-section-binding book.pdf --dry-run
+🔍 DRY RUN ANALYSIS:
+Would process 701 pages
+Would create 88 signatures  
+Would need 176 papers total
+Would save to: book_section_bound.pdf
+```
+
+Section binding involves:
+
+1. **Signature Creation**: Pages are grouped into signatures (folded sheets)
+2. **Page Reordering**: Pages are rearranged so that when printed double-sided and folded, they appear in correct reading order
+3. **Printing**: Print the reordered PDF double-sided
+4. **Folding**: Fold each signature in half
+5. **Binding**: Stack signatures and bind along the fold
+
+## Signature Sizes
+
+- **4 pages**: Each signature uses 1 paper (2 pages front, 2 pages back)
+- **8 pages**: Each signature uses 2 papers (4 pages front, 4 pages back)
+- **16 pages**: Each signature uses 4 papers (8 pages front, 8 pages back)
+- **32 pages**: Each signature uses 8 papers (16 pages front, 16 pages back)
+- **40 pages**: Each signature uses 10 papers (20 pages front, 20 pages back)
+- **Custom sizes**: Any multiple of 4 pages (e.g., 12=3 papers, 20=5 papers, 24=6 papers)
+
+## Paper Calculation
+
+**Formula**: `Papers per signature = Signature size ÷ 4`
+
+Examples:
+- 10 papers = 40 pages per signature
+- 6 papers = 24 pages per signature  
+- 3 papers = 12 pages per signature
+
+## Example Output
+
+For a 4-page signature with pages 1, 2, 3, 4:
+- The reordered sequence would be: [4, 1, 3, 2]
+- When printed double-sided and folded, you get pages in order: 1, 2, 3, 4
+
+## Generated Files
+
+This tool was used to process the book in `data/book.pdf`:
+
+- `data/book_section_bound.pdf` - Default 8-page signatures (2 papers each)
+- `data/book_40page_signature.pdf` - 40-page signatures (10 papers each)
+
+## Publishing to PyPI
+
+This package is ready for PyPI publication! Here's how to publish it:
+
+### Prerequisites
+
+1. Create accounts on [PyPI](https://pypi.org/) and [TestPyPI](https://test.pypi.org/)
+2. Install build tools:
+   ```bash
+   pip install build twine
+   ```
+
+### Build and Upload
+
+1. **Build the package:**
+   ```bash
+   python -m build
+   ```
+
+2. **Test on TestPyPI first:**
+   ```bash
+   twine upload --repository testpypi dist/*
+   ```
+
+3. **Upload to PyPI:**
+   ```bash
+   twine upload dist/*
+   ```
+
+### Package Structure
+
+The package follows modern Python packaging standards:
+
+```
+pdf-section-binding/
+├── src/pdf_section_binding/    # Source code
+│   ├── __init__.py
+│   ├── cli.py                  # Enhanced CLI interface
+│   ├── core.py                 # Core processing logic
+│   └── version.py              # Version and metadata
+├── tests/                      # Comprehensive test suite
+├── pyproject.toml              # Modern packaging config
+├── setup.py                    # Fallback setup config
+├── LICENSE                     # MIT license
+├── README.md                   # This file
+└── requirements.txt            # Dependencies
+
+```
+
+### Development Setup
+
+For development work:
+
+```bash
+# Clone and setup
+git clone <your-repo-url>
+cd pdf-section-binding
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # or venv\Scripts\activate on Windows
+
+# Install in development mode
+pip install -e .[dev]
+
+# Run tests
+pytest
+
+# Run with coverage
+pytest --cov=pdf_section_binding
+
+# Format code
+black src/ tests/
+
+# Lint code
+pylint src/ tests/
+
+# Type checking
+mypy src/
+```
+
+## Requirements
+
+- Python 3.7+
+- PyPDF2 library
+
+## Binding Instructions
+
+After running the script:
+
+1. Print the output PDF double-sided (flip on long edge)
+2. Cut or separate the printed sheets by signature
+3. Fold each signature in half along the center
+4. Stack all signatures in order
+5. Bind along the folded edge using:
+   - Saddle stitching (stapling)
+   - Perfect binding (glue)
+   - Spiral binding
+   - Or other binding methods

pdf_section_binding-1.0.0/README.md

@@ -0,0 +1,278 @@
+# PDF Section Binding Tool
+
+This tool reorders PDF pages for section binding (bookbinding), where pages are arranged in signatures (folded sheets) so that when printed and folded, they appear in the correct reading order.
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install pdf-section-binding
+```
+
+### From Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/yourusername/pdf-section-binding.git
+cd pdf-section-binding
+```
+
+2. Create and activate virtual environment:
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On macOS/Linux
+# or
+venv\Scripts\activate  # On Windows
+```
+
+3. Install in development mode:
+```bash
+pip install -e .
+```
+
+## Usage
+
+After installation, use the `pdf-section-binding` command (or the shorter `section-binding` alias):
+
+```bash
+pdf-section-binding input.pdf [options]
+```
+
+### Command Line Options
+
+- `-o, --output`: Output PDF file path (default: `input_name_section_bound.pdf`)
+- `-s, --signature-size`: Pages per signature - must be multiple of 4 (default: 8)
+- `--dry-run`: Preview analysis without creating output file
+- `-v, --verbose`: Enable verbose output with progress tracking
+- `-q, --quiet`: Suppress all output except errors
+- `--force`: Overwrite output file if it exists
+- `--version`: Show version information
+- `-h, --help`: Show help message
+
+### Examples
+
+```bash
+# Basic usage with 8-page signatures (2 papers per signature)
+pdf-section-binding book.pdf
+
+# Specify output file and 4-page signatures (1 paper per signature)  
+pdf-section-binding book.pdf -o output.pdf -s 4
+
+# Use 16-page signatures (4 papers per signature)
+pdf-section-binding book.pdf -s 16
+
+# Use 40-page signatures (10 papers per signature)
+pdf-section-binding book.pdf -s 40
+
+# Preview without creating file (dry run)
+pdf-section-binding book.pdf --dry-run
+
+# Verbose output with progress tracking
+pdf-section-binding book.pdf -v
+
+# Quiet mode (minimal output)
+pdf-section-binding book.pdf -q
+
+# Force overwrite existing output
+pdf-section-binding book.pdf --force
+```
+
+## Features
+
+✨ **Enhanced CLI Tool**
+- 🎨 **Colorized output** for better user experience
+- 📊 **Progress tracking** for large documents
+- 🔍 **Dry run mode** to preview without creating files
+- ⚡ **Fast processing** with optimized algorithms
+- 🛡️ **Robust error handling** with helpful suggestions
+- 📏 **Flexible signature sizes** (any multiple of 4)
+
+🔧 **Advanced Options**
+- Verbose and quiet modes
+- Force overwrite protection
+- Input validation with helpful error messages
+- Multiple command aliases (`pdf-section-binding` or `section-binding`)
+
+📦 **Library Usage**
+- Use as a Python library in your own projects
+- Clean API with `SectionBindingProcessor` class
+- Comprehensive test suite included
+
+## CLI Features in Detail
+
+### Smart Error Messages
+The tool provides helpful suggestions when you make mistakes:
+
+```bash
+$ pdf-section-binding book.pdf -s 15
+Error: Signature size must be a multiple of 4 (each paper = 4 pages).
+You specified 15. Try: 12 or 16
+```
+
+### Progress Tracking
+For large documents, see progress in real-time:
+
+```bash
+$ pdf-section-binding large-book.pdf -v
+PDF Section Binding Tool v1.0.0
+==================================================
+[INFO] Reading PDF: large-book.pdf
+[INFO] Total pages: 1500
+[INFO] Signature size: 8
+[INFO] Creating reordered PDF...
+Creating PDF: [████████████████████████████████████████████████] 100% (1500/1500)
+[INFO] Writing output: large-book_section_bound.pdf
+✅ Successfully created: large-book_section_bound.pdf
+```
+
+### Dry Run Analysis
+Preview the binding setup without creating files:
+
+```bash
+$ pdf-section-binding book.pdf --dry-run
+🔍 DRY RUN ANALYSIS:
+Would process 701 pages
+Would create 88 signatures  
+Would need 176 papers total
+Would save to: book_section_bound.pdf
+```
+
+Section binding involves:
+
+1. **Signature Creation**: Pages are grouped into signatures (folded sheets)
+2. **Page Reordering**: Pages are rearranged so that when printed double-sided and folded, they appear in correct reading order
+3. **Printing**: Print the reordered PDF double-sided
+4. **Folding**: Fold each signature in half
+5. **Binding**: Stack signatures and bind along the fold
+
+## Signature Sizes
+
+- **4 pages**: Each signature uses 1 paper (2 pages front, 2 pages back)
+- **8 pages**: Each signature uses 2 papers (4 pages front, 4 pages back)
+- **16 pages**: Each signature uses 4 papers (8 pages front, 8 pages back)
+- **32 pages**: Each signature uses 8 papers (16 pages front, 16 pages back)
+- **40 pages**: Each signature uses 10 papers (20 pages front, 20 pages back)
+- **Custom sizes**: Any multiple of 4 pages (e.g., 12=3 papers, 20=5 papers, 24=6 papers)
+
+## Paper Calculation
+
+**Formula**: `Papers per signature = Signature size ÷ 4`
+
+Examples:
+- 10 papers = 40 pages per signature
+- 6 papers = 24 pages per signature  
+- 3 papers = 12 pages per signature
+
+## Example Output
+
+For a 4-page signature with pages 1, 2, 3, 4:
+- The reordered sequence would be: [4, 1, 3, 2]
+- When printed double-sided and folded, you get pages in order: 1, 2, 3, 4
+
+## Generated Files
+
+This tool was used to process the book in `data/book.pdf`:
+
+- `data/book_section_bound.pdf` - Default 8-page signatures (2 papers each)
+- `data/book_40page_signature.pdf` - 40-page signatures (10 papers each)
+
+## Publishing to PyPI
+
+This package is ready for PyPI publication! Here's how to publish it:
+
+### Prerequisites
+
+1. Create accounts on [PyPI](https://pypi.org/) and [TestPyPI](https://test.pypi.org/)
+2. Install build tools:
+   ```bash
+   pip install build twine
+   ```
+
+### Build and Upload
+
+1. **Build the package:**
+   ```bash
+   python -m build
+   ```
+
+2. **Test on TestPyPI first:**
+   ```bash
+   twine upload --repository testpypi dist/*
+   ```
+
+3. **Upload to PyPI:**
+   ```bash
+   twine upload dist/*
+   ```
+
+### Package Structure
+
+The package follows modern Python packaging standards:
+
+```
+pdf-section-binding/
+├── src/pdf_section_binding/    # Source code
+│   ├── __init__.py
+│   ├── cli.py                  # Enhanced CLI interface
+│   ├── core.py                 # Core processing logic
+│   └── version.py              # Version and metadata
+├── tests/                      # Comprehensive test suite
+├── pyproject.toml              # Modern packaging config
+├── setup.py                    # Fallback setup config
+├── LICENSE                     # MIT license
+├── README.md                   # This file
+└── requirements.txt            # Dependencies
+
+```
+
+### Development Setup
+
+For development work:
+
+```bash
+# Clone and setup
+git clone <your-repo-url>
+cd pdf-section-binding
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # or venv\Scripts\activate on Windows
+
+# Install in development mode
+pip install -e .[dev]
+
+# Run tests
+pytest
+
+# Run with coverage
+pytest --cov=pdf_section_binding
+
+# Format code
+black src/ tests/
+
+# Lint code
+pylint src/ tests/
+
+# Type checking
+mypy src/
+```
+
+## Requirements
+
+- Python 3.7+
+- PyPDF2 library
+
+## Binding Instructions
+
+After running the script:
+
+1. Print the output PDF double-sided (flip on long edge)
+2. Cut or separate the printed sheets by signature
+3. Fold each signature in half along the center
+4. Stack all signatures in order
+5. Bind along the folded edge using:
+   - Saddle stitching (stapling)
+   - Perfect binding (glue)
+   - Spiral binding
+   - Or other binding methods