Developer Install#

Important

The following commands will install sequence into your current environment. Although not necessary, we highly recommend you install sequence into its own virtual environment.

If you will be modifying code or contributing new code to sequence, you will first need to get sequence’s source code and then install sequence from that code.

Source Install#

sequence is actively being developed on GitHub, where the code is freely available. If you would like to modify or contribute code, you can either clone our repository

git clone git://github.com/sequence-dev/sequence.git

or download a zip file:

curl -OL https://github.com/sequence-dev/sequence/archive/refs/heads/develop.zip

Once you have a copy of the source code, you can install it into your current Python environment,

cd sequence
mamba install --file=requirements.in
pip install -e .
 cd sequence
 conda install --file=requirements.in
 pip install -e .
 cd sequence
 pip install -e .

Developer Tools#

Once you start developing with sequence, we recommend that you use nox to automate common tasks such as, for example, running the tests, building the docs, and finding lint.

pip install nox

The following list show how to use nox for some of the more common tasks:

  • Run the tests:

    nox -s test
    
  • Run the tests on the notebooks:

    nox -s test-notebooks
    
  • Build the docs:

    nox -s build-docs
    
  • Run the linters:

    nox -s lint
    
  • To get a complete list of the available targets:

    nox -l