Metadata-Version: 2.4
Name: pyffice
Version: 0.0.1
Summary: Unified Python interface for document processing, CAD, media, and office automation.
Author: Maintainers
Author-email: solubrew@solutionsbrewer.com
License: MIT
Platform: Linux
Requires-Python: >=3.8
Requires-Dist: subtrix>=0.0.1
Requires-Dist: adafruit-ampy==1.1.0
Requires-Dist: annotated-doc==0.0.4
Requires-Dist: annotated-types==0.7.0
Requires-Dist: anyio==4.13.0
Requires-Dist: attrs==26.1.0
Requires-Dist: backoff==2.2.1
Requires-Dist: beautifulsoup4==4.14.2
Requires-Dist: bitarray==3.8.1
Requires-Dist: bitstring==4.4.0
Requires-Dist: cairocffi==1.7.1
Requires-Dist: cairosvg==2.9.0
Requires-Dist: certifi==2026.2.25
Requires-Dist: cffi==2.0.0
Requires-Dist: click==8.3.3
Requires-Dist: colormath==3.0.0
Requires-Dist: contourpy==1.3.3
Requires-Dist: cryptography==46.0.7
Requires-Dist: cssselect2==0.9.0
Requires-Dist: cycler==0.12.1
Requires-Dist: defusedxml==0.7.1
Requires-Dist: emoji==2.15.0
Requires-Dist: esptool==5.2.0
Requires-Dist: et-xmlfile==2.0.0
Requires-Dist: euclid3==0.1
Requires-Dist: fastjsonschema==2.21.2
Requires-Dist: ffmpeg-python==0.2.0
Requires-Dist: floweaver==2.0.1
Requires-Dist: fonttools==4.63.0
Requires-Dist: furl==2.1.4
Requires-Dist: future==1.0.0
Requires-Dist: graphviz==0.21
Requires-Dist: greenlet==3.5.0
Requires-Dist: h11==0.16.0
Requires-Dist: httpcore==1.0.9
Requires-Dist: httpx==0.28.1
Requires-Dist: idna==3.11
Requires-Dist: intelhex==2.3.0
Requires-Dist: jsonschema==4.23.0
Requires-Dist: jsonschema-specifications==2025.9.1
Requires-Dist: jupyter-core==5.9.1
Requires-Dist: kiwisolver==1.5.0
Requires-Dist: lxml==6.1.0
Requires-Dist: markdown-it-py==4.0.0
Requires-Dist: matplotlib==3.10.9
Requires-Dist: mdurl==0.1.2
Requires-Dist: mistune==3.2.1
Requires-Dist: narwhals==2.21.0
Requires-Dist: nbformat==5.10.4
Requires-Dist: networkx==3.6.1
Requires-Dist: notion-client==2.5.0
Requires-Dist: numpy==2.2.6
Requires-Dist: opencv-python==4.13.0.90
Requires-Dist: openpyxl==3.1.5
Requires-Dist: orderedmultidict==1.0.2
Requires-Dist: packaging==26.0
Requires-Dist: palettable==3.3.3
Requires-Dist: pandas==2.3.3
Requires-Dist: pendulum==3.2.0
Requires-Dist: pillow==11.3.0
Requires-Dist: platformdirs==4.9.6
Requires-Dist: plotly==6.7.0
Requires-Dist: ply==3.11
Requires-Dist: prettytable==0.7.2
Requires-Dist: pycparser==3.0
Requires-Dist: pydantic==2.12.5
Requires-Dist: pydantic-core==2.41.5
Requires-Dist: pydot==4.0.1
Requires-Dist: pydub==0.25.1
Requires-Dist: pygments==2.20.0
Requires-Dist: pymupdf==1.27.2.3
Requires-Dist: pyparsing==3.3.2
Requires-Dist: pypdf2==3.0.1
Requires-Dist: pypng==0.0.19
Requires-Dist: pyserial==3.5
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: python-docx==1.2.0
Requires-Dist: python-dotenv==1.0.1
Requires-Dist: python-pptx==1.0.2
Requires-Dist: pyyaml==6.0.3
Requires-Dist: reedsolo==1.7.0
Requires-Dist: referencing==0.37.0
Requires-Dist: rich==14.3.4
Requires-Dist: rich-click==1.9.7
Requires-Dist: rpds-py==0.30.0
Requires-Dist: ruamel-yaml==0.19.1
Requires-Dist: schedule==1.2.2
Requires-Dist: seaborn==0.13.2
Requires-Dist: shellingham==1.5.4
Requires-Dist: six==1.17.0
Requires-Dist: solidpython==1.1.3
Requires-Dist: soupsieve==2.8.3
Requires-Dist: sqlalchemy==2.0.49
Requires-Dist: tabulate==0.10.0
Requires-Dist: tibs==0.5.7
Requires-Dist: tinycss2==1.5.1
Requires-Dist: tomli==2.4.1
Requires-Dist: tomli-w==1.2.0
Requires-Dist: traitlets==5.15.0
Requires-Dist: typer==0.24.1
Requires-Dist: typing-extensions==4.15.0
Requires-Dist: typing-inspection==0.4.2
Requires-Dist: tzdata==2026.1
Requires-Dist: ultimate-notion==0.9.6
Requires-Dist: url-normalize==3.0.0
Requires-Dist: webencodings==0.5.1
Requires-Dist: xlsxwriter==3.2.9
Requires-Dist: pytest ; extra == "dev"
Requires-Dist: ruff ; extra == "dev"
Requires-Dist: pyright ; extra == "dev"
Requires-Dist: bandit ; extra == "dev"
Provides-Extra: dev
Description: # Pyffice
        
        **Unified Python Office Automation & Productivity Suite**
        
        Pyffice provides a unified Python interface for document processing, CAD, media handling, email, calendar, and comprehensive office automation with an extensible port architecture.
        
        ---
        
        ## Features
        
        ### Document Processing
        - **Word Processing**: DOC, DOCX, ODT, RTF, PDF, LaTeX
        - **Spreadsheets**: XLS, XLSX, ODS, CSV
        - **Presentations**: PPT, PPTX, ODP
        - **Ebooks**: EPUB, MOBI, AZW
        - **Technical**: Markdown, reStructuredText, AsciiDoc
        
        ### Media Handling
        - **Images**: PNG, JPG, GIF, BMP, WEBP, HEIC, SVG, TIFF
        - **Video**: MP4, AVI, MKV, MOV, WEBM
        - **Audio**: MP3, WAV, FLAC, OGG, M4A, AAC
        - **CAD**: DXF, DWG (limited)
        
        ### Office Integration
        - **Email**: SMTP/IMAP with send/receive capabilities
        - **Calendar**: iCal support with event management
        - **Contacts**: Contact management and search
        - **Tasks**: Task and project tracking
        
        ### Automation & Workflows
        - **Workflows**: Custom workflow creation and execution
        - **Scripts**: Python script execution framework
        - **CLI**: 46 command-line operations (see `python -m pyffice --help`)
        - **Ports**: Extensible architecture for custom integrations
        
        ### Data & Analytics
        - **Charts**: Chart generation and visualization
        - **Analytics**: Data analytics and reporting
        - **Databases**: Database connectivity (SQLite, PostgreSQL)
        - **Matrix**: Matrix operations and calculations
        
        ### Web & Utilities
        - **Web**: URL fetching, parsing, scraping
        - **Forms**: Form creation and validation
        - **Tags**: Tagging system for organization
        - **Filesystems**: Virtual filesystem management
        
        ---
        
        ## Installation
        
        ### From PyPI
        ```bash
        pip install pyffice
        ```
        
        ### From Source
        ```bash
        git clone https://github.com/solubrew/pyffice.git
        cd pyffice
        pip install -e .
        ```
        
        ### Development Installation
        ```bash
        git clone https://github.com/solubrew/pyffice.git
        cd pyffice
        pip install -e ".[dev]"
        pip install pylint pytest bandit
        ```
        
        ---
        
        ## Quick Start
        
        ### CLI Usage
        
        ```bash
        # Show all 22 commands
        python -m pyffice --help
        
        # Example subcommands (verified working as of T-NEW-044):
        python -m pyffice document-info input.pdf
        python -m pyffice document-convert input.docx output.pdf
        python -m pyffice formats
        ```
        
        ### Python API
        
        The top-level class is `PyfficeCodex` (re-exported from
        `pyffice.pyffice`). Example (T-NEW-043):
        
        ```python
        from pyffice import PyfficeCodex
        
        # Initialize
        codex = PyfficeCodex()
        
        # Add a document (real public method on PyfficeCodex /
        # PyfficeDocumentManager)
        codex.add_document(path="input.docx", doc_type="document")
        codex.add_change("created", None, "input.docx")
        ```
        
        ---
        
        ## Documentation
        
        | Document | Description |
        |----------|-------------|
        | [CLI.md](CLI.md) | Complete CLI command reference |
        | [AGENT.md](AGENT.md) | Agent system documentation |
        | [STATE.md](STATE.md) | Project state and roadmap |
        | [CHANGES.md](CHANGES.md) | Changelog and release notes |
        | [CONTRIBUTING.md](CONTRIBUTING.md) | Contribution guidelines |
        
        ---
        
        ## Architecture
        
        ### Port System
        
        Pyffice uses a flexible port architecture for extensibility:
        
        ```python
        from pyffice.ports import DocumentPort, ImagePort, MediaPort
        
        # Create custom document handler
        class MyHandler(DocumentPort):
            def read(self, path):
                # Custom implementation
                pass
            
            def write(self, path, content):
                # Custom implementation
                pass
        ```
        
        ### Module Structure
        
        ```
        pyffice/
        ├── calendars/      # Calendar & event management
        ├── charts/         # Chart generation
        ├── config/         # Configuration management
        ├── contacts/       # Contact management
        ├── filesystems/    # Virtual filesystem
        ├── forms/          # Form handling
        ├── images/         # Image processing
        ├── items/          # Item utilities & colors
        ├── matrix/         # Matrix operations
        ├── notebooks/      # Jupyter notebooks
        ├── ports/          # Extensible port system
        ├── script/         # Script execution
        ├── skills/         # Skill framework
        ├── tags/           # Tagging system
        ├── updates/        # Update management
        ├── web/            # Web utilities
        ├── workflows/      # Workflow automation
        ├── cli.py          # CLI interface (46 commands)
        ├── document.py     # Document processing
        └── pyffice.py      # Main entry point
        ```
        
        ---
        
        ## Configuration
        
        Create `pyffice.yaml` in your project root:
        
        ```yaml
        # General settings
        general:
          debug: false
          log_level: INFO
        
        # Email configuration
        email:
          smtp_host: smtp.gmail.com
          smtp_port: 587
          imap_host: imap.gmail.com
          imap_port: 993
        
        # Database configuration
        database:
          default: sqlite
          connections:
            sqlite:
              path: ./data/pyffice.db
            
        # Workflow configuration
        workflows:
          default_timeout: 3600
          max_parallel: 4
        ```
        
        ---
        
        ## Development
        
        ### Running Tests
        ```bash
        pytest tests/
        ```
        
        ### Code Quality
        ```bash
        # Linting
        pylint pyffice/
        
        # Security
        bandit -r pyffice/
        
        # Type checking
        pyright pyffice/
        ```
        
        ### Contributing
        
        See [CONTRIBUTING.md](CONTRIBUTING.md) for:
        - Development setup
        - Coding standards
        - Pull request workflow
        - Release process
        
        ---
        
        ## License
        
        MIT License - See [LICENSE](LICENSE) for details.
        
        ---
        
        ## Support
        
        - **Issues**: https://github.com/solubrew/pyffice/issues
        - **Discussions**: https://github.com/solubrew/pyffice/discussions
Description-Content-Type: text/markdown
