contributors.md

Create Contributors.md for your project just by a simple program!

NOTE :

To create Contributors.md for any Repository
It is must that the GITHUB_USER should have PUSH-ACCESS to the REPO.

Introduction

A Good Organisation is the one which recognizes all of its contributors.

But it can be hectic at times creating a MARKDOWN file containing all the collaborators
and their contributions to the project.

This is where the script comes to use.

It automatically generates a simple yet cool Contributors.MD for your Repository

Skip to Usage

Modules used are :

OS
SYS
ARGPARSE
PyGithub

PyGithub

PyGitHub is a Python (2 and 3) library to access the GitHub API v3. This library enables you to manage GitHub resources such as repositories, user profiles, and organizations in your Python applications.
Link To it Here

OS Module

OS Module is used to iterate through the folders in your directory and to find the templates to render (.rpy files).

SYS Module

SYS Module performs the sys.exit(Error_Code) function.

ArgParse Module

ArgParse Module is used for parsing the commandline arguments for Github Authentication and name of Repository.

Usage

pip install PyGithub
git clone https://github.com/gabru-md/contributors.md
cd contributors.md
python ./contrib.py -id GITHUB_USERNAME -pwd GITHUB_PASSWORD -repo REPO_NAME

The Repository Name must be in format user/repo_name or org_name/repo_name

Here is an example of the Contributors.md that can be created.

Changes can be made to the .rpy files to add subsequent data to the file.

Contributors.md is generated inside the 'rpy' folder

FelixDavidson/contributors.md