{"id":15908812,"url":"https://github.com/kartikchugh/giterator","last_synced_at":"2026-04-24T12:32:18.261Z","repository":{"id":111947877,"uuid":"261528495","full_name":"KartikChugh/giterator","owner":"KartikChugh","description":"Automate commits quickly and iteratively","archived":false,"fork":false,"pushed_at":"2020-05-22T22:01:23.000Z","size":176,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-03T00:42:35.338Z","etag":null,"topics":["command-line-tool","commit","git","shell","shell-script"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/KartikChugh.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2020-05-05T16:40:51.000Z","updated_at":"2021-10-19T19:24:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"22ff6131-6267-44c6-acf3-f5915e6445e1","html_url":"https://github.com/KartikChugh/giterator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KartikChugh/giterator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KartikChugh%2Fgiterator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KartikChugh%2Fgiterator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KartikChugh%2Fgiterator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KartikChugh%2Fgiterator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KartikChugh","download_url":"https://codeload.github.com/KartikChugh/giterator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KartikChugh%2Fgiterator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259490489,"owners_count":22865762,"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":["command-line-tool","commit","git","shell","shell-script"],"created_at":"2024-10-06T14:40:36.521Z","updated_at":"2026-04-24T12:32:13.240Z","avatar_url":"https://github.com/KartikChugh.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# giterator: automated commit scheduler\n![giterator logo](https://raw.githubusercontent.com/KartikChugh/giterator/master/img/logo.jpg)\n\n## Schedule commits from the command line\nGiterator is a tool designed to clone the content of existing files incrementally, leaving a chain of commits spaced out over time. Just give it files to recreate, a destination folder, and a time horizon, and then let it work in the background!\n\nThe program works by dividing source files into discrete \"chunks\" that are to be written to disk periodically. The chunks are cached, so the source file can be deleted upon execution if desired.\n\n## Usage is simple\nClone this repository to your computer, or download the `giterate` script directly. \nUsage is as follows:\n```bash\n./giterate.sh \u003csource\u003e \u003cdestination\u003e \u003ctime\u003e\n```\nAn example is provided below:\n```bash\n./giterate.sh \"C:/Users/User/notebook.ipynb\" \"C:/Users/User/StatisticsRepo/\" 5\n```\n\nThis would create a new `notebook.ipynb` file under the `/StatisticsRepo/` directory in a span of five hours, with regular\u003csup\u003e†\u003c/sup\u003e commits in between. To work on multiple files at once, run the script concurrently in another shell.\n\n![giterator logo](https://raw.githubusercontent.com/KartikChugh/giterator/master/img/example.PNG)\n\n## Fine-tune the process\nWith recent updates, giterator now allows you to specify the number of chunks, or commits, that should be used when working on your files. Include the commit count when calling the script.\n\n```bash\n./giterate.sh \"C:/Users/User/notebook.ipynb\" \"C:/Users/User/StatisticsRepo/\" 5 8 \n```\n\nwrites eight commits in five hours, or roughly one commit (doing an eighth of the total work) every 40 minutes. Use the time and chunk settings to tailor the workflow to your liking. Read more at the [official documentation page](https://github.com/KartikChugh/giterator/wiki#giteratesh).\n\n### \u003csup\u003e†\u003c/sup\u003eVariation\nGiterator now supports random variance in commit times and chunk sizes to create a more natural commit history. This feature is enabled by default.\n\n## Dependencies\nJust `git` and a Bash shell.\n\n## To-Do\n### Bugfixes\n- ~~Fix newline behavior~~ [(#1](https://github.com/KartikChugh/giterator/issues/1), [#7](https://github.com/KartikChugh/giterator/issues/7))\n- ~~Fix working directory~~ [(#2](https://github.com/KartikChugh/giterator/issues/2), [#5](https://github.com/KartikChugh/giterator/issues/5))\n- ~~Restore whitespace writing~~ [(#4)](https://github.com/KartikChugh/giterator/issues/4)\n- ~~Ensure full file writing~~ [(#6)](https://github.com/KartikChugh/giterator/issues/6)\n\n### Features\n- ~~Parameterize number of commits~~\n- Automate pushing to upstream\n- Select entire source folders\n- ~~Lessen commit time regularity~~\n- ~~Create destination folder~~\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkartikchugh%2Fgiterator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkartikchugh%2Fgiterator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkartikchugh%2Fgiterator/lists"}