This product contains the definition(s) of the SDSS Science Archiver Server (SAS) filesystem environment tree(s). It sets up the SDSS environment configuration files for loading either via the Modules Environment Manager or dynamically with a tree.Tree python package. Available environments are a SDSS "working" environment, i.e. sdsswork or any number of environments for public Data Releases, i.e. dr16.cfg. See full documentation at http://sdss-tree.readthedocs.io/en/latest/.

To install tree for development locally:

git clone https://github.com/sdss/tree
cd tree
pip install -e ".[dev,docs]"

To install at Utah for use with modules,

git clone https://github.com/sdss/tree main
cd main
python bin/setup_tree.py -v

Replace main with the desired branch or tag name as needed. Also, see the instructions on the Wiki

To install as a Python package dedendency for software use, install the latest tag straight from PyPi:

pip install sdss-tree

Within the top level repo directory, run the sdsstools commands:

# build the Sphinx documentation
sdss docs.build

# open the docs locally in a browser
sdss docs.show

Documentation is automatically built and pushed to Read The Docs.

Tests are created using pytest. Navigate to the tests directory from the top level and run with pytest.

cd tests
pytest

New releases of sdss-tree are created automatically, and pushed to PyPi, when new tags are pushed to Github. See the Create Release Github Action and Releases for the list.

New tag names follow the Python semantic versioning syntax, i.e. X.Y.Z.

• GitHub: https://github.com/sdss/tree
• Documentation: https://sdss-tree.readthedocs.org
• Issues: https://github.com/sdss/tree/issues