Cosmic tendrils is a fully type annoted Python API wrapper for both FLOWS
pipeline
and project.
Currently, tendrils is reliant on the flows project webserver. However, the functionality is
there for it to interface with any remote server providing an API with given URLS. all URLS can be modified
in utils/urls.py to point to a different API, and tendrils can be used to interface with it.
Homepage: https://github.com/SNflows/tendrils
PYPI: https://pypi.org/project/tendrils/
pip install tendrils
astropy, numpy, requests, tqdm
python >= 3.10
You will need to populate the included template config.ini with the right paths and flows API
token. To do so, you can use the tools provided in tendrils.utils. There is:
- a guided method that queries you in the command line for each field.
- a function for copying from an already filled out (e.g., previous) config.ini file.
- functions for setting each attribute separately (if you only need the API token for example)
using python shell (or ipython, or a script):
import tendrils
# Option 1
tendrils.utils.create_config() # will also ask for location of where to store flows photometry.
# Option 2
tendrils.utils.copy_from_other_config('<path_to_other_config>')
# Option 3
# can also be called without any arguments to query for manually inputting the token.
tendrils.utils.set_api_token(token = 'my_long_token')
After doing any of the above, your config.ini will have your API token, and all API calls will now use that token.
After cloning from the github repo, use the provided pyproject.toml file. Install using flit (pip install flit):
flit install --symlink to install in EDITABLE mode. A legacy setup.py is also provided for installing with
pip install -e . from the root directory. Important, do not upload you config.ini! Make sure all values are None
as in the template from Pypi. We welcome all PRs.