githubdepchecker 1.0.4

CLI Tool to check the dependencies of github repositories and create a pull request if packages need to get updated.

GithubDepCheck

CLI Tool to check the dependencies of github repositories and create a pull request if packages need to get updated.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With Python
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. License
6. Contact
7. Acknowledgments

About The Project

GithubDepCheck is a cli tool which helps you check if dependecies of your node.js projects are up-to-date or not. If they are not up-to-date, githubdepcheck updates the package and creates a pull request on your github repository. All you need to do is pass a csv file containing the link to your github repository and package name and version that you want to check in all your repositories.

(back to top)

Built With

• Python

(back to top)

Getting Started

Following contains the prerequisites, installation and usage guide for for githubdepcheck

Prerequisites

You need to have following things installed:

1. Pip (Package Installer for python)
2. Git

sudo apt-get install git

3. Node and npm

Installation

Create a virtual environment and install the githubdepcheck package using pip.

pip install githubdepchecker

(back to top)

Usage

You need to first configure your github username and password to be able to check dependencies on private repositories and create pull requests on others repositories. If github username and password are not configured, it will first ask for it and automatically configure it.

To check your cofigured github username and password:

githubdepchecker --getgitconfig

To set or change your github username and password:

githubdepchecker --setgitconfig <github-username> <github-password>

To perform dependency check of multiple github repositories:

1. Create a csv file with following headers and enter the rows accordingly.

2. Enter the following command with csv path and dependency name and version for which you want to perform dependency check.

githubdepchecker -i '/home/user/Download/githubrepos.csv' axios@0.23.0

3. Above command will create an output file on home directory with an extra column of version_satisfied

To create pull request for updating dependency on github repositories:

1. Add --update on the command given in previous step.

githubdepchecker -i '/home/user/Download/githubrepos.csv' axios@0.23.0 --update

2. Above command will create an output file on home directory with an extra column of update_pr

Note: If csv file contains your own github repository whose dependencies needs to be updated, then it will not create any pull request, instead it will stop the process after committing the files as you don't need to create pull request for updating your own repository.

To create csv for above steps

If you feel lazy creating csv with repositories names and links, then don't worry githubdepcheck got your back :) Run the following command and it will generate an repositories.csv file on your home directory containing all your github repositories name and link whose language is JavaScript.

githubdepchecker --createcsv

To get the csv for repositories of an organization, run the following command:

githubdepchecker --createcsv --org <organization-name>

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Your Name - @linkedin_handle - [e-mail]

Project Link: https://github.com/dyte-submissions/dyte-vit-2022-Shubh0405

(back to top)

Acknowledgments

• I would like to thank dyte recruitment team to give this challenging task. It was fun working on this task as I wanted to do something different for a long time :)

(back to top)