{"id":19676021,"url":"https://github.com/wannacry081/git-tivity-python","last_synced_at":"2026-05-10T03:10:56.063Z","repository":{"id":262056935,"uuid":"886090665","full_name":"WannaCry081/GiT-Tivity-Python","owner":"WannaCry081","description":"A simple Python tool that simulates GitHub contributions by generating fake commits for a GitHub repository. It can generate random commits, exclude weekends, and track analytics for each contribution activity.","archived":false,"fork":false,"pushed_at":"2024-11-11T07:47:10.000Z","size":40,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-27T05:51:44.320Z","etag":null,"topics":["bash","github","python","script"],"latest_commit_sha":null,"homepage":"","language":"Python","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/WannaCry081.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":"2024-11-10T06:54:52.000Z","updated_at":"2024-11-11T07:47:14.000Z","dependencies_parsed_at":"2024-11-10T08:27:22.258Z","dependency_job_id":"382238df-0d63-4f91-bbb1-1e527b9e4e53","html_url":"https://github.com/WannaCry081/GiT-Tivity-Python","commit_stats":null,"previous_names":["wannacry081/git-tivity-python"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/WannaCry081/GiT-Tivity-Python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WannaCry081%2FGiT-Tivity-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WannaCry081%2FGiT-Tivity-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WannaCry081%2FGiT-Tivity-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WannaCry081%2FGiT-Tivity-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WannaCry081","download_url":"https://codeload.github.com/WannaCry081/GiT-Tivity-Python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WannaCry081%2FGiT-Tivity-Python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264035368,"owners_count":23547387,"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":["bash","github","python","script"],"created_at":"2024-11-11T17:26:51.636Z","updated_at":"2026-05-10T03:10:56.030Z","avatar_url":"https://github.com/WannaCry081.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 GitHub Contribution Activity Generator\n\nA simple Python tool that simulates GitHub contributions by generating fake commits for a GitHub repository. It can generate random commits, exclude weekends, and track analytics for each contribution activity.\n\n## ✨ Features\n\n- **Generate Random Commits**: Simulate contributions with random commit dates.\n- **Exclude Weekends**: Option to exclude commits on weekends.\n- **Track Analytics**: Track the number of commits and files in a `analytics.json` file.\n- **Push to GitHub**: Automatically push commits to your GitHub repository.\n- **Customizable Commits**: Control the number of commits to be made and the repository to which they will be pushed.\n\n## 📦 Requirements\n\n- Python 3.x\n- Git installed and configured on your machine\n- A GitHub repository (optional if using an existing repo)\n\n## 💻 Installation\n\n1. Clone this repository:\n\n   ```bash\n   git clone https://github.com/yourusername/github-contribution-generator.git\n   ```\n\n2. Install the required dependencies:\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Execute the script:\n\n   ```bash\n   python main.py --random-commits --no-weekends --commits 20 --repository https://github.com/username/repo\n\n   ```\n\n4. Alternatively, modify the `run.sh` script and execute it:\n\n   ```bash\n   ./run.sh\n   ```\n\n## 🎊 Usage\n\n### Command-Line Arguments\n\n| Argument                   | Description                                                            |\n| -------------------------- | ---------------------------------------------------------------------- |\n| `-rc` / `--random-commits` | Enable random commit distribution (default: `False`)                   |\n| `-nw` / `--no-weekends`    | Exclude weekends from commit days (default: `False`)                   |\n| `-c` / `--commits`         | Specify the number of commits to generate (default: `10`)              |\n| `-l` / `--local`           | Specify if the repository is local (default: `False`)                  |\n| `-r` / `--repository`      | GitHub repository URL (e.g., `https://github.com/username/repository`) |\n\n### Example Usage\n\n1. **Generate 10 commits and push to GitHub**:\n\n   ```bash\n   python main.py --commits=10 --repository=https://github.com/yourusername/yourrepository\n   ```\n\n2. **Generate random commits and exclude weekends**:\n\n   ```bash\n   python main.py --random-commits --no-weekends --commits=5 --repository=https://github.com/yourusername/yourrepository\n   ```\n\n3. **Run with default settings (10 commits, no repository specified)**:\n   ```bash\n   python main.py --local --repository=sample-repository\n   ```\n\n## 🚀 How It Works\n\n1. **Git Configuration**: The tool checks for a valid Git configuration (user name and email). If not configured, it prompts the user to initialize Git.\n2. **Commit Generation**: Based on the user input (number of commits, random distribution, weekend exclusion), it generates commits in the repository.\n3. **Analytics**: It tracks the number of commits and files in a `analytics.json` file. This file is updated after each commit activity.\n4. **Push to GitHub**: After generating commits locally, it pushes the changes to the specified GitHub repository.\n\n## Example Output\n\n```bash\nCommit 1: chore: add [1] contribution 2024-11-10 10:30:15\nCommit 2: chore: add [2] contribution 2024-11-10 10:30:30\n...\nFinish executing program\n```\n\nThe tool will output logs for each commit, indicating the date, time, and a description of the commit.\n\n## 🤝 Contributing\n\nIf you'd like to contribute to this project, please follow these guidelines:\n\n1. Fork the repository.\n2. Create a new branch for your feature:\n   ```bash\n   git checkout -b feature/YourFeature\n   ```\n3. Commit your changes:\n   ```bash\n   git commit -am 'Add new feature'\n   ```\n4. Push to the branch:\n   ```bash\n   git push origin feature/YourFeature\n   ```\n5. Create a new Pull Request for review.\n\n## 📬 Contact\n\nFor any questions or feedback, feel free to reach out:\n\n- **Email:** liraedata59@gmail.com\n- **GitHub:** [WannaCry081](https://github.com/WannaCry081)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwannacry081%2Fgit-tivity-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwannacry081%2Fgit-tivity-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwannacry081%2Fgit-tivity-python/lists"}