Metadata-Version: 2.1
Name: sdss-access
Version: 3.0.3
Summary: Package to dynamically build filepaths and access all SDSS SAS products
Home-page: https://github.com/sdss/sdss_access
Author: Brian Cherinka
Author-email: bcherinka@stsci.edu
License: BSD 3-Clause License
Project-URL: Repository, https://github.com/sdss/sdss_access
Project-URL: Documentation, https://sdss-access.readthedocs.org
Keywords: astronomy,software
Platform: UNKNOWN
Classifier: Intended Audience :: Science/Research
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Documentation :: Sphinx
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: six >=1.11
Requires-Dist: requests >=2.10.0
Requires-Dist: sdss-tree >=4.0.0
Requires-Dist: sdsstools >=0.4.5
Requires-Dist: tqdm >=4.46.0
Provides-Extra: dev
Requires-Dist: Sphinx >=7.1.0 ; extra == 'dev'
Requires-Dist: sphinx-bootstrap-theme >=0.4.12 ; extra == 'dev'
Requires-Dist: recommonmark >=0.6 ; extra == 'dev'
Requires-Dist: sphinx-issues >=1.2.0 ; extra == 'dev'
Requires-Dist: importlib-metadata >=1.6.0 ; extra == 'dev'
Requires-Dist: Jinja2 <=3.0 ; extra == 'dev'
Requires-Dist: ipython >=7.9.0 ; extra == 'dev'
Requires-Dist: matplotlib >=3.1.1 ; extra == 'dev'
Requires-Dist: flake8 >=3.7.9 ; extra == 'dev'
Requires-Dist: doc8 >=0.8.0 ; extra == 'dev'
Requires-Dist: pytest >=5.2.2 ; extra == 'dev'
Requires-Dist: pytest-cov >=2.8.1 ; extra == 'dev'
Requires-Dist: pytest-mock >=1.13.0 ; extra == 'dev'
Requires-Dist: pytest-sugar >=0.9.2 ; extra == 'dev'
Requires-Dist: isort >=4.3.21 ; extra == 'dev'
Requires-Dist: codecov >=2.0.2dev5 ; extra == 'dev'
Requires-Dist: coverage[toml] >=5.0 ; extra == 'dev'
Requires-Dist: coveralls >=1.7 ; extra == 'dev'
Requires-Dist: ipdb >=0.12.3 ; extra == 'dev'
Requires-Dist: sdsstools[dev] >=0.4.0 ; extra == 'dev'
Requires-Dist: invoke >=1.3.0 ; extra == 'dev'
Requires-Dist: twine >=3.1.1 ; extra == 'dev'
Requires-Dist: wheel >=0.33.6 ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: Sphinx >=7.1.0 ; extra == 'docs'
Requires-Dist: sphinx-bootstrap-theme >=0.4.12 ; extra == 'docs'
Requires-Dist: recommonmark >=0.6 ; extra == 'docs'
Requires-Dist: sphinx-issues >=1.2.0 ; extra == 'docs'
Requires-Dist: importlib-metadata >=1.6.0 ; extra == 'docs'
Requires-Dist: Jinja2 <=3.0 ; extra == 'docs'

# sdss_access

![Versions](https://img.shields.io/badge/python->3.7-blue)
[![Documentation Status](https://readthedocs.org/projects/sdss-access/badge/?version=latest)](https://sdss-access.readthedocs.io/en/latest/?badge=latest)
[![Build Sphinx Documentation](https://github.com/sdss/sdss_access/actions/workflows/sphinxbuild.yml/badge.svg)](https://github.com/sdss/sdss_access/actions/workflows/sphinxbuild.yml)
[![Build and Test](https://github.com/sdss/sdss_access/actions/workflows/build.yml/badge.svg)](https://github.com/sdss/sdss_access/actions/workflows/build.yml)
[![codecov](https://codecov.io/gh/sdss/sdss_access/branch/master/graph/badge.svg)](https://codecov.io/gh/sdss/sdss_access)


This products allows for dynamically building filepaths to SDSS data products hosted on the Science Archive Server (SAS).  Filepaths
are dynamically constructed given a minimal name and set of keywords to be substituted via a string templating system.  Data products
can also be downloaded programmatically using an ``Access`` class which provides streaming downloads via ``rysnc`` or ``curl``
depending on your OS. See the full documentation at http://sdss-access.readthedocs.io/en/latest/

## Developer Install

To install `sdss_access` for development locally:

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

## Build Sphinx Docs

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.

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

## Creating Releases

New releases of `sdss-access` are created automatically, and pushed to [PyPi](https://pypi.org/project/sdss-access/), when new tags are pushed to Github.  See the [Create Release](.github/workflows/release.yml) Github Action and [Releases](https://github.com/sdss/sdss_access/releases) for the list.

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

# Useful links

- GitHub: https://github.com/sdss/sdss_access
- Documentation: https://sdss-access.readthedocs.org
- Issues: https://github.com/sdss/sdss_access/issues




