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.jsonfile with your printer configuration
Clone the repository:
git clone https://github.com/JahongirHakimjonov/printer-service.git
cd printer-serviceInstall dependencies:
pip install -r requirements.txtCreate 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.pyYou will be prompted to select an operation:
| Type | Description |
|---|---|
| SCAN | Start scanning a document |
| COPY | Make multiple copies |
| Print a file (PDF, etc.) |
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.pdfYou 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.
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
