- Clone the GITS repository
- Navigate inside GITS folder and enter the following command:
pip install -r requirements.txt
- Navigate inside the configurations folder and run the folllowing commands:
chmod +x project_init.sh
./project_init.sh
source .bashrc
- Run
gits hello_world
from any directory. If you end up getting a welcome msg you're good to go!
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
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.
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.
'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.
This functionality sets the parent branch.
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.
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.
Function that adds files as passed to the gits add command. Performs operation as similar to git add command
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.
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.
This command lists all the branches on both local and remote repositories.
This command lists all the branches on remote repository.
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
This logs all the commands executed by the user, and also stores the output of each command
This pushes all the local changes of origin to the branch specified.
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.
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.
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.
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
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