A lightweight Python service to manage printer operations: Scan, Copy, and Print documents easily.

• Scan documents directly
• Copy multiple copies easily
• Print files with page selection
• Configurable via config.json
• Detailed logging for debugging

• Python 3.12+
• Windows OS (with printer properly installed and accessible)
• A config.json file with your printer configuration

Clone the repository:

git clone https://github.com/JahongirHakimjonov/printer-service.git
cd printer-service

Install dependencies:

pip install -r requirements.txt

Create a config.json file in the project root:

{
  "printer_name": "Canon iR2006/2206 UFRII LT"
}

Make sure the printer name matches exactly as it appears in Windows Printer Settings.

Run the service:

python main.py

You will be prompted to select an operation:

Example flow:

$ python main.py
Type input (SCAN, COPY, PRINT): PRINT
How many pages to print?: 1-3
Enter the file path: D:\files\example.pdf

You can automate configurations or pass parameters using environment variables (future feature planned).

Planned CLI support:

python main.py --type PRINT --file_path "D:\docs\test.pdf" --pages "1-2"

For more information use this command:

python main.py --help

(Not available yet — currently interactive mode only.)

├── config/                # Configuration files (e.g., config.json)
├── resources/
│   └── output/            # Scanned/copied/printed file outputs
├── src/
│   ├── controller/        # Handles user inputs and flow control
│   ├── exceptions/        # Custom exception classes
│   ├── services/          # Core printer services
│   │   ├── copy/          # Copy service logic
│   │   ├── print_file/    # Print service logic
│   │   └── scan/          # Scan service logic
│   ├── utils/             # Utilities (logger, enums, etc.)
│   └── __pycache__/       # Python cache files (ignored)
├── main.py                # Application entry point
├── requirements.txt       # Python dependencies
└── README.md              # Project documentation

• Invalid operation type → error logged, program exits.
• Missing file or incorrect printer → critical error logged.
• Bad config format → immediate crash with readable error.

Jahongir Hakimjonov — Backend Developer

Please contact Jahongir Hakimjonov with any questions or concerns regarding this project.

• GitHub
• Instagram
• Telegram

• Buy Me Coffee

• Tirikchilik

This project is licensed under the MIT License.

• Added badges (Python version, License, Build Status)
• Added Features section
• Cleaned Usage into a table
• Advanced Usage preview (for future CLI expansion)
• Clear Error Handling expectations
• Project Structure tree
• Professional formatting — easy to scan