GITS

GIT Simplified

Installation Guidelines:

1. Clone the GITS repository
   
2. Navigate inside GITS folder and enter the following command:
   pip install -r requirements.txt
   
3. Navigate inside the configurations folder and run the folllowing commands:
   

• chmod +x project_init.sh
  
• ./project_init.sh
  
• source .bashrc
  

4. Run gits hello_world from any directory. If you end up getting a welcome msg you're good to go!
   

Supported functionality

gits pr_update

This functionality makes sure that the current branch is able to make a PR without much trouble ( conflict ). It makes sure that the current branch has the latest commit off master branch, and that the local master has all the commits from the upstream master. This helps in reducing merge conflicts

gits profile

This functionality allows the user to change the git account quickly with a single command. There are situations when a developer has a personal github account and a enterprise github account as well. Changing between these accounts is a little complicated. This functionality aims to simplify it.

gits rebase

This is a highly simplified version of git rebase command. This interactive command asks for the branch that you want to rebase and automatically rebases it off master. This is the most common scenario. The original GIT rebase command is a little un-intuitive and there is always a confusion , about the source branch and the destination branch.

gits reset

'Reset' intuitively means a HARD reset. This functionality does a HARD reset on your branch, and makes it even with the remote branch. This aims to simplify the confusion between HARD and the SOFT reset.

gits set

This functionality sets the parent branch.

gits upstream

This functionality changes the upstream with a single command. No need to manually remove the existing upstream, and adding a new upstream. This command will automatically change the upstream for the git repo. If there is any existing upstream , it will be overwritten.

gits super reset

Have you ever run into a situation, where you had to clone the repository again ? Yes, this functionality is exactly for that scenario. It will remove the current repository. It will clone it again, and add all the 'remote' to this freshly cloned repository.

gits add

Function that adds files as passed to the gits add command. Performs operation as similar to git add command

gits commit

It is a highly simplified version of git commit command. We are actively working on this functionality such that a commit would fail if the unit tests does not pass. We can specify the tests that need to pass before the commit can actually happen.

gits create_branch

This automatically checks out a new branch from local master , after pulling all the changes from the remote master to local master. The idea behind this is that this new branch should have all the latest commits before a developer starts working on them.

gits all-branch

This command lists all the branches on both local and remote repositories.

gits remote-branch

This command lists all the branches on remote repository.

gits init

Function that creates an empty Git repository or re-initializes an existing one. There are three versions of this function,

• gits init --url='cloning url': Clones the repository at url at current directory
• gits init: This variant creates a repository with a working directory so you can actually work
• gits init --bare: This variant creates a repository without a working directory

gits logging

This logs all the commands executed by the user, and also stores the output of each command

gits push

This pushes all the local changes of origin to the branch specified.

gits checkout

This command switches between two branches. The function takes branch name as input and returns True for successful execution or False otherwise with an exception.

gits unstage

This command moves files from staging area to the working directory. These untracked files will not be considered for the upcoming commits. The function filenames as input to move from staging area to working directory and returns True for successful execution or False with an exception.

Note: More functionality are being added to this project. Please refer to the 'issues' tab for more information. In case you want to contribute to this project , please refer to 'Contributing.md' file.

pydoc implementation

We have tried to write as much documentation as possible. You can use pydoc to go through the documentation. For example if you want to go through all the documentation for all files in code/ directory, do the following:

cd code
python3 -m pydoc -b

This will open up a browser and you can see all the files. You can click on a particular file to access the documentation associated with that file.

Style Checker and Analyzer

We are using flake9 as our style checker and code analyzer. While contrivuting to this project, make sure you conform to norms dictated by flake8

Flake8

Installation

• python<version> -m pip install flake8

If you want Flake8 to be installed for your default Python installation, you can instead use:

• python -m pip install flake8

Using Flake8
To start using Flake8, open an interactive shell and run one of the following,

• flake8 path/to/code/to/check.py
• flake8 path/to/code/

This repository is made for CSC 510 Software Engineering Course at NC State University.

Group 15 Team Members:

• Steve Victor Menezes
• Durga Devi Mummadi
• Bhavesh Shailesh Agrawal
• Nikitha Thotireddy
• Aadil Anwar Khan