Install pyspeckit via GitHub

Quick

You can pip install the development version of pyspeckit:

pip install https://github.com/pyspeckit/pyspeckit/archive/master.zip

Installing a branch

If there’s a bugfix branch, e.g., from a pull request, you can install it in a similar way. Just replace the branch name:

pip install https://github.com/pyspeckit/pyspeckit/archive/{branchname}.zip

Or, if the contribution is from a different user:

pip install https://github.com/{username}/pyspeckit/archive/{branchname}.zip

Where in both cases you need to replace {{branchname}} and {username}.

More detailed

If you want to help develop pyspeckit, follow these instructions:

Logged into your github account, go to https://github.com/pyspeckit/pyspeckit and click “Fork” in upper right.

Copy the URL of your pyspeckit fork https://github.com/yourusername/pyspeckit

On the command line type:

git clone https://github.com/yourusername/pyspeckit

(it will put it in a directory called pyspeckit in your working directory):

cd pyspeckit

git remote add upstream https://github.com/pyspeckit/pyspeckit

To get the most up to date version, type:

git pull upstream master

Update your personal “fork” to match upstream/master:

git push origin master

and enter your username and password if it asks.

Still in the pyspeckit/ directory, type:

pip install -e .

You’re good to go!

To make changes and generate a Pull request:

Create a new branch: git checkout -b name_of_your_new_branch This will automatically switch you to this new branch. Type git branch to see all the branches. The active one will be highlighted and have an asterisk next to it. To switch to an existing branch, type git checkout name_of_branch

After you make a change inside your local fork on your machine, type git add changed_file where changed_file is the name of the file(s) you edited.

Time to commit your change and add a little note about your change git commit -m details details should be a description of the changes you made, inside quotes

Push the change to GitHub: git push origin name_of_branch where name_of_branch is the branch you’ve been active in during this process.

If you want to contribute your changes to https://github.com/pyspeckit/pyspeckit, create a “pull request”. In https://github.com/yourusername/pyspeckit, navigate to your branch where you pushed you want to merge with https://github.com/pyspeckit/pyspeckit and click “Pull request”