documentprocessinghub-ljd 0.1.0

File type identification and validation for document processing workflows

Document Processing Hub

A Python library for intelligent file type identification and validation for document processing workflows.

Features

• File Type Identification: Automatically detect file types based on naming patterns
• Format Validation: Validate file naming conventions for specific formats:
  • ZJ Format: ZJ{YYMMDD}{DD}-{version} (e.g., ZJ26042804-8170.xlsx)
  • Manpower Files: Detect and classify Manpower Budget, Documents, and general types
  • Real-time Production: Identify real-time production reports
• Duplicate Handling: Support for files with duplicate suffixes like (1), (2), etc.
• Extensible: Easy to add new file type validators

Installation

From PyPI

pip install documentprocessinghub

From GitHub

git clone https://github.com/LJD-UwU/Document-Processing-Hub.git
cd Document-Processing-Hub
pip install .

Development Install

git clone https://github.com/LJD-UwU/Document-Processing-Hub.git
cd Document-Processing-Hub
pip install -e .

Quick Start

from documentprocessinghub import identify_file_type, get_file_info

# Identify file type
file_type = identify_file_type("ZJ26042804-8170.xlsx")
print(file_type)  # Output: "ZJ"

# Get detailed file information
info = get_file_info("Manpower Budget-Rev 18.1.xlsx")
print(info)
# Output: {
#     "file_name": "Manpower Budget-Rev 18.1.xlsx",
#     "file_type": "MANPOWER_BUDGET",
#     "recognized": True
# }

Supported File Types

ZJ Format

Files following the pattern: ZJ{YYMMDD}{DD}-{version}{.ext}

Examples:

• ZJ26042804-8170.xlsx ✓ Valid
• ZJ26042804-8170 (1).xlsx ✓ Valid (with duplicate suffix)
• ZJ26043007-v2.pdf ✗ Invalid (letters in version)
• ZJ26042804-04-8170.xlsx ✗ Invalid (double dash)

Manpower Files

Detected by "MANPOWER" keyword in filename

Types:

• MANPOWER_BUDGET: Contains "BUDGET" keyword
• MANPOWER_DOCUMENTS: Contains "DOCUMENTS" keyword
• MANPOWER: Generic Manpower file

Real-time Production

Files with "REAL-TIME" and "PRODUCTION" keywords

API Reference

identify_file_type(file_path: str) -> str

Identifies the type of a file based on its name.

Parameters:

• file_path (str): Full path or filename

Returns:

• str: File type identifier or "ARCHIVO_NO_CONOCIDO" if unrecognized

get_file_info(file_path: str) -> dict

Gets detailed information about a file.

Parameters:

• file_path (str): Full path or filename

Returns:

• dict: Dictionary with file_name, file_type, and recognized status

Testing

python -m pytest tests/
python tests/test_manpower_types.py
python tests/test_duplicates.py

License

MIT License - See LICENSE file for details

Author

Leonardo J. Diaz ([e-mail])