Contributions: Automate Your GitHub Commits with Ease 🚀

Table of Contents

• Overview
• Features
• Installation
• Usage
• Configuration
• How It Works
• Contributing
• License
• Contact

Overview

Contributions is a JavaScript-based program that automates the generation of backdated commits to a GitHub repository. It uses randomly generated dates and timestamps from the past year. This tool updates a .json file with the commit date, adds the changes to Git, creates commits with the backdated timestamp, and pushes them to the provided GitHub repository.

You can download the latest version of Contributions from the Releases section.

Features

• Automated Backdated Commits: Generate commits with random dates from the past year.
• JSON Configuration: Easily update commit dates in a .json file.
• Git Integration: Automatically add, commit, and push changes to your GitHub repository.
• Customizable Settings: Adjust settings to fit your specific needs.
• Cross-Platform: Works on any system that supports Node.js.

Installation

To get started with Contributions, follow these steps:

1. Clone the Repository: Open your terminal and run:

   git clone https://github.com/nassim13ALG/contributions.git

2. Navigate to the Directory:

   cd contributions

3. Install Dependencies: Use npm to install required packages:

   npm install

4. Download the Latest Release: Visit the Releases section to download the latest version. Execute the downloaded file to set up Contributions.

Usage

Once you have installed Contributions, you can start using it by following these steps:

1. Run the Program: Execute the following command in your terminal:

   node index.js

2. Follow Prompts: The program will guide you through the configuration process.

3. Check Your Repository: After execution, check your GitHub repository for the new commits.

Configuration

Before running Contributions, you may want to configure the settings to match your needs. Open the config.json file and modify the following parameters:

• repository: Your GitHub repository URL.
• commitCount: The number of backdated commits to generate.
• dateRange: Specify the range of dates for the commits.

Here is an example of how the config.json might look:

{
  "repository": "https://github.com/yourusername/yourrepo",
  "commitCount": 10,
  "dateRange": {
    "start": "2022-01-01",
    "end": "2022-12-31"
  }
}

How It Works

Contributions uses a combination of JavaScript and Node.js to perform its tasks. Here's a brief overview of the workflow:

1. Random Date Generation: The program generates random dates within the specified range.
2. JSON File Update: It updates the .json file with the new commit dates.
3. Git Commands: Contributions executes Git commands to add, commit, and push changes to the specified repository.
4. Error Handling: The program includes error handling to manage issues during execution.

Contributing

Contributions is open for contributions. If you would like to help improve the project, follow these steps:

1. Fork the Repository: Click the "Fork" button at the top right of the page.
2. Create a Branch:

   git checkout -b feature/YourFeature

3. Make Your Changes: Edit files and commit your changes.
4. Push to Your Fork:

   git push origin feature/YourFeature

5. Create a Pull Request: Go to the original repository and click "New Pull Request".

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any questions or feedback, feel free to reach out:

• GitHub: nassim13ALG
• Email: your.email@example.com

You can download the latest version of Contributions from the Releases section.