astro-otter 0.0.1__py3-none-any.whl → 0.1.0__py3-none-any.whl

astro_otter-0.1.0.dist-info/METADATA

@@ -0,0 +1,127 @@
+Metadata-Version: 2.1
+Name: astro-otter
+Version: 0.1.0
+Author-email: Noah Franz <nfranz@arizona.edu>
+License: MIT License
+        
+        Copyright (c) 2023 Noah Franz
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Home, https://github.com/astro-otter
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Topic :: Scientific/Engineering
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Development Status :: 2 - Pre-Alpha
+Requires-Python: <3.12,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy <2,>=1.20
+Requires-Dist: astropy >=6
+Requires-Dist: pandas
+Requires-Dist: synphot
+Requires-Dist: typing-extensions
+Requires-Dist: matplotlib
+Requires-Dist: plotly
+Requires-Dist: astroquery
+Requires-Dist: ads
+Requires-Dist: skypatrol
+Requires-Dist: fundamentals
+Requires-Dist: astro-datalab
+Requires-Dist: sparclclient
+Requires-Dist: astro-ghost
+Requires-Dist: pyreadline3 ; platform_system == "Windows"
+Provides-Extra: dev
+Requires-Dist: ruff ; extra == 'dev'
+Requires-Dist: pre-commit ; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: Sphinx >=3.0.0 ; extra == 'docs'
+Requires-Dist: myst-parser >=0.13 ; extra == 'docs'
+Requires-Dist: nbsphinx >=0.9.1 ; extra == 'docs'
+Requires-Dist: sphinx-book-theme >=0.0.33 ; extra == 'docs'
+Requires-Dist: sphinx-copybutton ; extra == 'docs'
+Requires-Dist: autodoc ; extra == 'docs'
+Requires-Dist: ipykernel ; extra == 'docs'
+
+# OTTER API
+### **O**pen mul**T**iwavelength **T**ransient **E**vent **R**epository
+
+A Python API for the OTTER.
+
+[actions-badge]:            https://github.com/astro-otter/otter/workflows/CI/badge.svg
+[actions-link]:             https://github.com/astro-otter/otter/actions
+[black-badge]:              https://img.shields.io/badge/code%20style-black-000000.svg
+[black-link]:               https://github.com/psf/black
+[conda-badge]:              https://img.shields.io/conda/vn/conda-forge/hepfile
+[conda-link]:               https://github.com/conda-forge/hepfile-feedstock
+[github-discussions-badge]: https://img.shields.io/static/v1?label=Discussions&message=Ask&color=blue&logo=github
+[github-discussions-link]:  https://github.com/mattbellis/hepfile/discussions
+[gitter-badge]:             https://badges.gitter.im/https://github.com/mattbellis/hepfile/community.svg
+[gitter-link]:              https://gitter.im/https://github.com/mattbellis/hepfile/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
+[pypi-link]:                https://pypi.org/project/astro-otter/
+[pypi-platforms]:           https://img.shields.io/pypi/pyversions/astro-otter
+[pypi-version]:             https://badge.fury.io/py/astro-otter.svg
+[rtd-badge]:                https://readthedocs.org/projects/otter/badge/?version=latest
+[rtd-link]:                 https://otter.readthedocs.io/en/latest/?badge=latest
+[sk-badge]:                 https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg
+[ruff-badge]:               https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
+[ruff-link]:                https://github.com/astral-sh/ruff
+[codecov-badge]:            https://codecov.io/gh/astro-otter/otter/graph/badge.svg?token=BtCerOdTc0
+[codecov-link]:             https://codecov.io/gh/astro-otter/otter
+
+[![Documentation Status](https://readthedocs.org/projects/astro-otter/badge/?version=latest)](https://astro-otter.readthedocs.io/en/latest/?badge=latest)
+[![Actions Status][actions-badge]][actions-link]
+[![PyPI version][pypi-version]][pypi-link]
+[![Linting: Ruff][ruff-badge]][ruff-link]
+[![codecov][codecov-badge]][codecov-link]
+
+## Installation
+To install the OTTER API use
+```
+python3 -m pip install astro-otter
+```
+
+## Installation from Source
+To install the OTTER API from the source code use
+```
+git clone https://github.com/astro-otter/otter.git
+cd otter
+python -m pip install .
+```
+This will be changed into the more convenient `python -m pip install astro-otter` at a later date!
+
+For developers, please also enable the pre-commit hooks using
+```
+pre-commit install
+```
+
+## Repo Organization
+| Directory | Contents |
+|------------|------------|
+| `src/otter` | A pip installable API for interfacing with the OTTER database|
+| `scripts` | The pipeline scripts for converting unprocessed data into the OTTER JSON format|
+| `docs` | Documentation for the OTTER API |
+| `test` | Some Unit tests for the source code |

astro_otter-0.1.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+otter/__init__.py,sha256=ml7fLtTVno4fvpJvw91bAp8ff2nuRG1hZ1lMCt3ZumY,440
+otter/_version.py,sha256=IwGQL03Wwse3OmpK33wS6CFwrF8rqxvbN79PydSE480,76
+otter/exceptions.py,sha256=3lQF4AXVTfs9VRsVePQoIrXnramsPZbUL5crvf1s9Ng,1702
+otter/util.py,sha256=7ZJYeTjBmwpXKgqXcmBtxhtn2j7XSQMaBbTurPKyEO0,15788
+otter/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+otter/io/data_finder.py,sha256=pBGtfzjFt9pbJQR4exXP17eZoHVHClm_Jno1vXmcpAU,28026
+otter/io/host.py,sha256=ZYewz347_6FD5mVcQLDxHSS75n5RCv69xxLHAmpjoiI,4410
+otter/io/otter.py,sha256=VMtDCfiQniQNLIOL_P3NySwS-YnDF-nT4ceQjV0XJfE,18016
+otter/io/transient.py,sha256=YVOppPAqhChPx8sxRPfuC_9BBJVtE7ku5ITKkWKSL9w,35551
+otter/plotter/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+otter/plotter/otter_plotter.py,sha256=iQe5AFsB5plw5eClUfuEfqcNRiXEcKc5-hkLPVKCkg8,2091
+otter/plotter/plotter.py,sha256=i9ZAlbIjftpzyFzgCIFdye9XnppTwOSwazb5ruLpjnE,2896
+astro_otter-0.1.0.dist-info/LICENSE,sha256=s9IPE8A3CAMEaZpDhj4eaorpmfLYGB0mIGphq301PUY,1067
+astro_otter-0.1.0.dist-info/METADATA,sha256=nR8WxIF2Yez-yZxyv0kMZ-QZHuJJdcClr--J9cvbqHw,5905
+astro_otter-0.1.0.dist-info/WHEEL,sha256=Z4pYXqR_rTB7OWNDYFOm1qRk0RX6GFP2o8LgvP453Hk,91
+astro_otter-0.1.0.dist-info/top_level.txt,sha256=Wth72sCwBRUk3KZGknSKvLQDMFuJk6qiaAavMDOdG5k,6
+astro_otter-0.1.0.dist-info/RECORD,,

{astro_otter-0.0.1.dist-info → astro_otter-0.1.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.43.0)
+Generator: setuptools (70.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

otter/__init__.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 # get the version
 from ._version import __version__
 
@@ -8,5 +10,7 @@ __package__ = "otter"
 # import important stuff
 from .io.otter import Otter
 from .io.transient import Transient
+from .io.host import Host
+from .io.data_finder import DataFinder
 from .plotter.otter_plotter import OtterPlotter
 from .plotter.plotter import plot_light_curve, plot_sed

otter/_version.py

@@ -2,4 +2,4 @@
 Just define the package version in one place
 """
 
-__version__ = "0.0.1"
+__version__ = "0.1.0"

otter/exceptions.py

@@ -2,8 +2,14 @@
 Custom exceptions for otter
 """
 
+from __future__ import annotations
+
 
 class FailedQueryError(ValueError):
+    """
+    Exception thrown when the users query does not return any results.
+    """
+
     def __str__(self):
         txt = "You're query/search did not return any results! "
         txt += "Try again with different parameters!"
@@ -11,10 +17,19 @@ class FailedQueryError(ValueError):
 
 
 class IOError(ValueError):
+    """
+    Exception thrown when the input or output argument/value is not the correct type.
+    """
+
     pass
 
 
 class OtterLimitationError(Exception):
+    """
+    Exception thrown when the user requests something that is currently not supported
+    by the API.
+    """
+
     def __init__(self, msg):
         self.msg = "Current Limitation Found: " + msg
 
@@ -23,4 +38,37 @@ class OtterLimitationError(Exception):
 
 
 class TransientMergeError(Exception):
+    """
+    Exception thrown when the Transient objects can not be combined as expected.
+    """
+
     pass
+
+
+class OtterNotImplementedError(Exception):
+    """
+    Exception thrown by methods that are not yet implemented
+    """
+
+    def __str__(self):
+        return "Not yet implemented! Please consider contributing on our GitHub!"
+
+
+class MissingEnvVarError(Exception):
+    """
+    Thrown when the querying code expects an Environment variable and doesn't get one
+    """
+
+    def __init__(self, v, url=None):
+        self.v = v
+        self.url = url
+
+    def __str__(self):
+        msg = "You are missing the following environment variables:\n"
+        for vv in self.v:
+            msg += f"\t- {vv}\n"
+        msg += "Please make an account and/or set these variables!\n"
+        if self.url is not None:
+            msg += f"See: {self.url}"
+
+        return msg