{"id":24589434,"url":"https://github.com/qharny/timetable_processor","last_synced_at":"2026-05-17T12:04:55.487Z","repository":{"id":272799703,"uuid":"917785452","full_name":"Qharny/timetable_processor","owner":"Qharny","description":"A university timetable file processor","archived":false,"fork":false,"pushed_at":"2025-01-16T19:16:13.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-24T08:15:46.133Z","etag":null,"topics":["csv","dart"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Qharny.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-16T16:36:16.000Z","updated_at":"2025-01-23T08:15:38.000Z","dependencies_parsed_at":"2025-01-16T18:27:10.890Z","dependency_job_id":"92a08b2c-b460-49e1-bcb7-b6d78aa6a4e1","html_url":"https://github.com/Qharny/timetable_processor","commit_stats":null,"previous_names":["qharny/timetable_processor"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qharny%2Ftimetable_processor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qharny%2Ftimetable_processor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qharny%2Ftimetable_processor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qharny%2Ftimetable_processor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Qharny","download_url":"https://codeload.github.com/Qharny/timetable_processor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244117640,"owners_count":20400743,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csv","dart"],"created_at":"2025-01-24T08:15:48.549Z","updated_at":"2026-05-17T12:04:50.437Z","avatar_url":"https://github.com/Qharny.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# University Timetable Processor\n\nA command-line application built with Dart that processes university timetable files in various formats (Excel, CSV, and JSON).\n\n## Features\n\n- **File Input Support**\n  - Excel (.xlsx)\n  - CSV (.csv)\n  - JSON (.json)\n  - Validates file formats and content\n  - Handles corrupt or improperly formatted files\n\n- **Data Processing**\n  - Extracts and validates timetable data\n  - Organizes information by class, course, and program\n  - Structured data model with error handling\n\n- **Export Capabilities**\n  - Export to Excel (.xlsx)\n  - Export to CSV (.csv)\n  - Export to JSON (.json)\n  - Maintains data structure across formats\n\n## Prerequisites\n\n- Dart SDK (version ^3.0.0)\n- Compatible operating system (Windows, macOS, or Linux)\n\n## Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/qharny/timetable_processor.git\n   cd timetable_processor\n   ```\n\n2. Install dependencies:\n   ```bash\n   dart pub get\n   ```\n\n## Usage\n\n1. Run the application:\n   ```bash\n   dart run bin/timetable_processor.dart\n   ```\n\n2. Follow the interactive menu:\n   ```\n   === Timetable Processor ===\n\n   Available options:\n   1. Select input file (Excel, CSV, or JSON)\n   2. Process and validate timetable data\n   3. Export processed data\n   4. Exit\n   ```\n\n3. When selecting a file, provide the full path to your timetable file:\n   ```\n   Enter the path to your file (Excel, CSV, or JSON):\n   /path/to/your/timetable.xlsx\n   ```\n\n## File Format Requirements\n\n### Excel (.xlsx)\n```\nClass Name | Course Name | Program | Day | Time | Room\n----------|-------------|---------|-----|------|------\nClass A   | Math 101    | BSc     | Mon | 9:00 | R101\n```\n\n### CSV (.csv)\n```csv\nClass Name,Course Name,Program,Day,Time,Room\nClass A,Math 101,BSc,Mon,9:00,R101\n```\n\n### JSON (.json)\n```json\n[\n  {\n    \"class_name\": \"Class A\",\n    \"course_name\": \"Math 101\",\n    \"program\": \"BSc\",\n    \"day\": \"Mon\",\n    \"time\": \"9:00\",\n    \"room\": \"R101\"\n  }\n]\n```\n\n## Project Structure\n```\ntimetable_processor/\n├── bin/\n│   └── timetable_processor.dart\n├── lib/\n│   ├── models/\n│   │   ├── timetable_entry.dart\n│   │   └── program.dart\n│   ├── services/\n│   │   ├── file_service.dart\n│   │   ├── parser_service.dart\n│   │   └── export_service.dart\n│   └── utils/\n│       ├── logger.dart\n│       └── constants.dart\n└── test/\n    └── timetable_processor_test.dart\n```\n\n## Error Handling\n\nThe application includes comprehensive error handling for:\n- Invalid file formats\n- Missing or corrupt data\n- File permission issues\n- Processing errors\n\nErrors are logged with timestamps and full stack traces for debugging.\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Commit changes: `git commit -am 'Add feature'`\n4. Push to the branch: `git push origin feature-name`\n5. Submit a Pull Request\n\n\u003c!-- ## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details. --\u003e\n\n## Future Improvements\n\n- Add support for more file formats\n- Implement batch processing\n- Add data validation rules\n- Create a web interface\n- Add support for custom timetable templates\n\n## Support\n\nFor support, please open an issue in the GitHub repository or contact [kabuteymanasseh5@gmail.com].","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqharny%2Ftimetable_processor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqharny%2Ftimetable_processor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqharny%2Ftimetable_processor/lists"}