{"id":29223048,"url":"https://github.com/hafiz-shamnad/tics","last_synced_at":"2025-10-14T23:51:03.542Z","repository":{"id":301465426,"uuid":"996084275","full_name":"Hafiz-shamnad/TICS","owner":"Hafiz-shamnad","description":"Tronics is a minimal version control system built in C, inspired by Git, designed to track changes in code, IoT device data, and CAD files. It supports basic version control features like staging, committing, branching, and file history tracking using a custom .tronics directory.","archived":false,"fork":false,"pushed_at":"2025-06-18T13:50:17.000Z","size":115,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-11T13:07:29.543Z","etag":null,"topics":["cad","code","iot"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hafiz-shamnad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-04T12:38:39.000Z","updated_at":"2025-06-18T13:50:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"310c6ebd-54c4-4b4a-b4ff-64f8c7f5d254","html_url":"https://github.com/Hafiz-shamnad/TICS","commit_stats":null,"previous_names":["hafiz-shamnad/tics"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Hafiz-shamnad/TICS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hafiz-shamnad%2FTICS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hafiz-shamnad%2FTICS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hafiz-shamnad%2FTICS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hafiz-shamnad%2FTICS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hafiz-shamnad","download_url":"https://codeload.github.com/Hafiz-shamnad/TICS/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hafiz-shamnad%2FTICS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279027922,"owners_count":26088516,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cad","code","iot"],"created_at":"2025-07-03T04:32:51.902Z","updated_at":"2025-10-14T23:51:03.531Z","avatar_url":"https://github.com/Hafiz-shamnad.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TICS 🚀\n\nWelcome to **TICS** 🎉 — a Git-inspired version control system designed to **Track**, **Integrate**, **Control**, and **Synchronize** code, IoT device data, and CAD designs in a seamless workflow. 🌐\n\n---\n\n## 🔢 TICS Explained\n\n| **Letter** | **Meaning**                                                   |\n| ---------- | ------------------------------------------------------------- |\n| **T**      | Track: Monitors changes and progress in your projects.        |\n| **I**      | Integrate: Combines different code versions or data smoothly. |\n| **C**      | Control: Manages versions, branches, and updates efficiently. |\n| **S**      | Synchronize: Aligns your work across devices or teams.        |\n\n---\n\n## ✨ Features\n\n### Version Control 📚\n\n* **Git-like Functionality**: Commit, branch, merge, diff, log, stash, tag, and history tracking.\n* **Diffing**: Compare text files and staged changes across commits.\n* **Status Checking**: View staged/committed files and current branch details.\n* **File Restoration**: Revert files to previous commit states.\n\n### IoT Integration 🛁\n\n* **Device Simulation**: Tracks simulated IoT device states.\n* **Event Logging**: Appends IoT data to versioned files.\n* **Device Management**: Stores sensor data in the repository (MQTT support coming soon).\n\n### CAD Handling 🎨\n\n* **File Support**: Versions CAD logs (e.g., draw\\_line events).\n* **Event Logging**: Records CAD operations.\n* **Metadata Tracking**: Captures CAD metadata (STL/STEP support planned).\n\n### CLI Interface 🖱️\n\n**Available commands:**\n\n```\ntics init         tics add        tics commit     tics log\ntics status       tics diff       tics restore    tics branch\ntics checkout     tics merge      tics history    tics stash\ntics pop          tics list-stash tics tag        tics list-tags\ntics iot          tics cad\n```\n\n---\n\n## 🛠️ Installation\n\n### Prerequisites\n\n* GCC or any C compiler\n* Standard C libraries: `stdio.h`, `stdlib.h`, etc.\n* POSIX system (Linux/macOS)\n* `make` utility\n\n### Setup\n\n```bash\ngit clone https://github.com/your-username/tics.git\ncd tics\nmake\nsudo mv tics /usr/local/bin/   # Optional\n./tics init myrepo\n```\n\n---\n\n## 🚀 Usage\n\n### Initialize a Repository\n\n```bash\n./tics init myrepo\n```\n\n### Add Files\n\n```bash\n./tics add sensor_data.txt\n```\n\n### Commit Changes\n\n```bash\n./tics commit -m \"Initial commit with sensor data\"\n```\n\n### Simulate IoT and CAD\n\n```bash\n./tics iot\n./tics cad\n```\n\n### Manage Branches\n\n```bash\n./tics branch dev\n./tics checkout dev\n```\n\n### Stash and Pop\n\n```bash\necho \"sensor: updated\" \u003e\u003e sensor_data.txt\n./tics add sensor_data.txt\n./tics stash\n./tics pop\n```\n\n### History and Tags\n\n```bash\n./tics commit -m \"Updated sensor data\"\n./tics history sensor_data.txt\n./tics checkout main\n./tics merge dev\n./tics tag v1.0\n```\n\n---\n\n## 📂 Project Structure\n\n```\ntics/\n├── include/           # Header files\n│   ├── branch_ops.h\n│   ├── cad_ops.h\n│   ├── commit_ops.h\n│   ├── file_ops.h\n│   ├── repo_ops.h\n│   ├── stash_ops.h\n│   ├── tag_ops.h\n│   └── tics.h\n├── src/               # C source files\n│   ├── branch_ops.c\n│   ├── cad_ops.c\n│   ├── commit_ops.c\n│   ├── file_ops.c\n│   ├── main.c\n│   ├── repo_ops.c\n│   ├── stash_ops.c\n│   ├── tag_ops.c\n├── Makefile           # Build script\n├── README.md          # This file\n├── LICENSE            # Apache 2.0\n├── test-tics.sh       # Test script\n├── test.txt           # Sample file\n```\n\n---\n\n## 🌍 Roadmap\n\n### Q3 2025\n\n* ✅ Automated merge conflict resolution\n* ✅ STL/STEP file versioning\n* ✅ MQTT integration for IoT\n\n### Q4 2025\n\n* ✅ **TICSHub**: remote hosting, web interface, pull requests\n\n### Q1 2026\n\n* ✅ Real-time IoT dashboard\n* ✅ CAD file diffing \u0026 previews\n* ✅ Integration with IoT/CAD tools\n\n---\n\n## 🧪 Testing\n\n```bash\nchmod +x test-tics.sh\n./test-tics.sh\n```\n\n*Ensure the executable is named `tics`. Rename the test file if needed.*\n\n---\n\n## ⚠️ Troubleshooting\n\n* **Command Not Found**: Use `./tics` or add to PATH.\n* **Build Issues**: Run `make clean \u0026\u0026 make`.\n* **Crashes**: Use `gdb ./tics` to debug.\n* **Merge Conflicts**: Reset file metadata and retry.\n\n---\n\n## 🤝 Contributing\n\n1. Fork the repo\n2. Create a branch: `git checkout -b feature`\n3. Commit: `git commit -m \"Add feature\"`\n4. Push: `git push origin feature`\n5. Open a Pull Request\n\n---\n\n## 📧 Contact\n\nEmail: **[haafizshamnad@gmail.com](mailto:haafizshamnad@gmail.com)**\n\n\u003e **TICS** is the foundation for **TICSLab**, a future-ready platform for collaborative IoT \u0026 CAD innovation. Join us in building the future of engineering! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhafiz-shamnad%2Ftics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhafiz-shamnad%2Ftics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhafiz-shamnad%2Ftics/lists"}