tomtoolkit 2.32.3__tar.gz → 3.0.0__tar.gz

tomtoolkit-3.0.0/.git/FETCH_HEAD

@@ -0,0 +1 @@
+76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6		'76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6' of https://github.com/TOMToolkit/tom_base

tomtoolkit-3.0.0/.git/HEAD

@@ -0,0 +1 @@
+76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6

tomtoolkit-3.0.0/.git/config

@@ -0,0 +1,12 @@
+[core]
+	repositoryformatversion = 0
+	filemode = true
+	bare = false
+	logallrefupdates = true
+[remote "origin"]
+	url = https://github.com/TOMToolkit/tom_base
+	fetch = +refs/heads/*:refs/remotes/origin/*
+[gc]
+	auto = 0
+[http "https://github.com/"]
+	extraheader = AUTHORIZATION: basic eC1hY2Nlc3MtdG9rZW46Z2hzXzE1MzY4X2V5SmhiR2NpT2lKRlV6STFOaUlzSW5SNWNDSTZJa3BYVkNKOS5leUpoZFdRaU9pSmhkWFJvYm1RaUxDSmpkSGdpT2lJNFZuQkxiR2xWT1ZkSVdGSlhibnBwZVVGamIyRXRWR2htYm1aWFEwOWxVWHBuTVdneFIyNHdkbVJoUzFkRVptMUtPR2hST1Vodklpd2laWGh3SWpveE56ZzBNVFV6TmpBd0xDSnBZWFFpT2pFM09EUXhOVEF3TURBc0ltbHpjeUk2SW1kcGRHaDFZaUlzSW1wMGFTSTZJamc0TXpBNU5qY3hMVEEyWTJNdE5ERXdNQzFoTkRWaUxUSmlNMlZrTUdJd05tUmxOeUlzSW5abGNpSTZNMzAuVk4tc3JZS2tuZzZpUHJkTTNlcG5jb056c0ZkNGJxRTJYcjMyWkpzSEphajVrV2ZGMTRVeGxqLVJyaFB6bzJpVllGY3NFLWlWVkVKYWlPcmZjMy0yS3c=

tomtoolkit-3.0.0/.git/logs/HEAD

@@ -0,0 +1 @@
+0000000000000000000000000000000000000000 76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6 runner <runner@runnervm3jd5f.letgutb12saubddblb4a4bg5ga.dx.internal.cloudapp.net> 1784150004 +0000	checkout: moving from master to refs/tags/3.0.0

tomtoolkit-3.0.0/.git/refs/tags/3.0.0

@@ -0,0 +1 @@
+76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6

tomtoolkit-3.0.0/.git/shallow

@@ -0,0 +1 @@
+76ce4bd4b1c120abc5e63a793ef80a3eb86b00e6

tomtoolkit-3.0.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+recursive-include tom_common/templates *
+recursive-include tom_common/static *
+recursive-include tom_targets/templates *
+recursive-include tom_targets/static *
+recursive-include tom_setup/templates *
+recursive-include tom_observations/static *
+recursive-include tom_observations/templates *
+recursive-include tom_dataproducts/static *
+recursive-include tom_dataproducts/templates *

tomtoolkit-3.0.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: tomtoolkit
+Version: 3.0.0
+Summary: TOM Toolkit and base modules
+License-Expression: GPL-3.0-only
+License-File: LICENSE
+Keywords: tomtoolkit,TOM,astronomy,astrophysics,cosmology,science,fits,observatory
+Author: TOM Toolkit Project
+Author-email: tomtoolkit-maintainers@lco.global
+Maintainer: Joey Chatelain
+Maintainer-email: jchate6@gmail.com
+Requires-Python: >=3.10.0,<3.14
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Dist: alerce (>=2.0,<3.0)
+Requires-Dist: astroplan (>=0.8,<0.11)
+Requires-Dist: astropy (>=5.3.3,<6) ; python_version < "3.10"
+Requires-Dist: astropy (>=5.3.3,<8) ; python_version >= "3.10"
+Requires-Dist: astroquery (<1)
+Requires-Dist: beautifulsoup4 (<5)
+Requires-Dist: crispy-bootstrap5 (<2027)
+Requires-Dist: cryptography (<=48.0.1)
+Requires-Dist: django (>=5,<6)
+Requires-Dist: django-bootstrap5 (<27)
+Requires-Dist: django-contrib-comments (>=2.0,<3.0)
+Requires-Dist: django-crispy-forms (>=2.0,<3.0)
+Requires-Dist: django-extensions (>=3.0.0,<4.0.0)
+Requires-Dist: django-filter (>=23,<25)
+Requires-Dist: django-gravatar2 (>=1.0.0,<2.0.0)
+Requires-Dist: django-guardian (>=2.0.0,<3.0.0)
+Requires-Dist: django-htmx (>=1.0.0,<2.0.0)
+Requires-Dist: django-tables2 (>=3.0,<4)
+Requires-Dist: django-tasks (>=0.6.1,<0.7.0)
+Requires-Dist: djangorestframework (>=3.15,<4)
+Requires-Dist: fits2image (>=0.4,<0.5)
+Requires-Dist: importlib-resources (>=6.4.5,<6.5.0)
+Requires-Dist: markdown (<4)
+Requires-Dist: numpy (>1.24,<2.2)
+Requires-Dist: pillow (>9.2,<13.0)
+Requires-Dist: plotly (<6)
+Requires-Dist: python-dateutil (<3)
+Requires-Dist: requests (<3)
+Requires-Dist: specutils (>=1.20.0,<3)
+Description-Content-Type: text/markdown
+
+# TOM Toolkit
+[![pypi](https://img.shields.io/pypi/v/tomtoolkit.svg)](https://pypi.python.org/pypi/tomtoolkit)
+[![run-tests](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml/badge.svg)](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a09d330b4dca4a4a86e68755268b7da3)](https://www.codacy.com/gh/TOMToolkit/tom_base/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=TOMToolkit/tom_base&amp;utm_campaign=Badge_Grade)
+[![Coverage Status](https://coveralls.io/repos/github/TOMToolkit/tom_base/badge.svg?branch=main)](https://coveralls.io/github/TOMToolkit/tom_base?branch=main)
+[![Documentation Status](https://readthedocs.org/projects/tom-toolkit/badge/?version=stable)](https://tom-toolkit.readthedocs.io/en/stable/?badge=stable)
+[![ASCL](https://img.shields.io/badge/ascl-2208.004-blue.svg?colorB=262255)](https://ascl.net/2208.004)
+
+[Documentation](https://tom-toolkit.readthedocs.io/en/latest/)
+![logo](tom_common/static/tom_common/img/logo-color.png)
+
+The TOM Toolkit is a web framework for building TOMs: Target and Observation
+Managers. TOMs are meant to facilitate collaborative astronomical observing
+projects. A typical TOM allows its users to curate target lists, request
+observations of those targets at various observatories as well as manage and
+organize their data. [Read more](https://tom-toolkit.readthedocs.io/en/stable/introduction/about.html) about TOMs.
+
+## Getting started with the TOM Toolkit
+The [getting started guide](https://tom-toolkit.readthedocs.io/en/latest/introduction/getting_started.html)
+will guide you through the process of setting up a TOM for the first time.
+
+## Reporting issues/feature requests
+Please use the [issue tracker](https://github.com/TOMToolkit/tom_base/issues) to
+report any issues or support questions.
+
+## Development Team 
+The lead developers of the TOM Toolkit are [William Lindstrom](https://lco.global/people/)
+and [Joey Chatelain](https://sites.google.com/site/josephchatelain),
+professional software developers with the Las Cumbres Observatory software team,
+together with [Jon Nation](https://lco.global/people/), [Curtis McCully](https://lco.global/people/),
+[Matt Daily](https://lco.global/people/) and [Mark Bowman](https://lco.global/people/).  [Rachel Street](https://lco.global/user/rstreet/) is the project's Principle Investigator.
+The TOM Toolkit is grateful for the advice and collaboration with [Andy Howell](http://www.dahowell.com/),
+[Edward Gomez](https://www.zemogle.net/), Craig Pellegrino, Jamie Burke and the rest of the LCO Science team.
+The [original Toolkit](https://zenodo.org/records/4437764) was developed by
+Austin Riba, David Collom and William Lindstrom.
+
+Our team very much welcome input from the community, and we are grateful to
+the following people for their many contributions:
+ - Dan Avner, NOIRLab
+ - Doug Arnold, Liverpool Telescope
+ - Etienne Bachelet, IPAC/Caltech
+ - Ezequiel Contreras Martinez, UCSB
+ - Griffin Hosseinzadeh, University of Arizona
+ - Bryan Miller, Gemini Observatory
+ - Brendan Mills, UCSB
+ - Julien Peloton, Fink
+
+## Acknowledgements
+
+We hope you find our software useful for your research.  If so, we would be grateful
+if you can include a brief acknowledgement in your papers and presentations, for example 
+"This research made use of [The TOM Toolkit](https://tom-toolkit.readthedocs.io/)". 
+We would also very much appreciate you including a citation to our paper describing 
+the Toolkit [Street, R.A. et al., 2018, SPIE, 10707, 11](http://adsabs.harvard.edu/abs/2018SPIE10707E..11S) 
+(to export the BibTeX please click [here](https://ui.adsabs.harvard.edu/abs/2018SPIE10707E..11S/exportcitation)).  
+
+
+## Contributing to the project
+If you'd like to contribute to the TOM Toolkit, first of all, thanks! Secondly, we
+have a [contribution guide](https://tom-toolkit.readthedocs.io/en/stable/introduction/contributing.html) that
+you might find helpful. We are particularly interested in the contribution of
+observation and alert modules.
+
+### Community Code of Conduct
+We encourage developers to maintian a lively and civil discourse either on github or in our slack workspace.
+Please review our [code of conduct](CODE_OF_CONDUCT.md) for information about what is considered unacceptable behavior and how to report it.
+
+## Developer information
+For development information targeted at the maintainers of the project, please see [README-dev.md](README-dev.md).
+
+## Plugins
+Different TOM systems have different science goals and sometimes need 
+different functions. Rather than require users to support all 
+dependencies from all possible functions, we support a range of optional 
+plugin modules for the Toolkit.  Have a look at our [list of plugins](https://tom-toolkit.readthedocs.io/en/stable/api/plugins.html) 
+see which would benefit your science goals. 
+
+### Antares
+
+The [tom-antares](https://github.com/TOMToolkit/tom_antares) plugin adds support
+for querying the Antares broker for targets of interest.
+
+### tom_nonsidereal_airmass
+
+The [tom_nonsidereal_airmass](https://github.com/TOMToolkit/tom_nonsidereal_airmass) plugin provides a templatetag
+that supports plotting for non-sidereal objects. The plugin is fully supported by the TOM Toolkit team; however,
+non-sidereal visibility calculations require the PyEphem library, which is minimally supported while its successor
+is in development. The library used for the TOM Toolkit sidereal visibility, astroplan, does not yet support
+non-sidereal visibility calculations.
+
+### tom-lt
+
+This module provides the ability to submit observations to the Liverpool Telescope Phase 2 system. It is in a very alpha
+state, with little error handling and minimal instrument options, but can successfully submit well-formed observation
+requests.
+
+[Github](https://github.com/TOMToolkit/tom_lt)
+
+### tom_registration
+
+The [tom_registration](https://github.com/TOMToolkit/tom_registration) plugin introduces support for two TOM registration
+flows--an open registration, and a registration that requires administrator approval.
+Our philosophy is to keep the TOM as lightweight and adaptable as possible.  
+
+
+## About the TOM Toolkit
+
+The TOM Toolkit is managed by Las Cumbres Observatory, with generous
+financial support from the [National Science Foundation](https://www.nsf.gov/) grant 2209852.
+We are also grateful for support from the [Heising-Simons Foundation](https://hsfoundation.org) 
+and the [Zegar Family Foundation](https://sites.google.com/zegarff.org/site) at the start
+of the project.  
+

tomtoolkit-3.0.0/README-dev.md

@@ -0,0 +1,251 @@
+This README-dev is intended for maintainers of the repository for information on releases, standards, and anything that 
+isn't pertinent to the wider community.
+
+## Deployment
+The [PyPi](https://pypi.org/project/tomtoolkit/) package is kept under the Las Cumbres Observatory PyPi account. Upon 
+tagging either the main or dev branch, a draft Github Release is created.
+
+In order to trigger a draft Github Release of either dev or main, the branch must be given an annotated tag that matches the correct version format. The version formats are as follows:
+ 
+|             | Dev  | Main         | All other branches |
+|-------------|--------------|--------------|--------------------|
+| Tagged      | Push to PyPi | Push to PyPi | No effect          |
+| Not tagged  | No effect    | No effect    | No effect          |
+
+Tagged branches must follow the [semantic versioning syntax](https://semver.org/). Tagged versions will not be 
+deployed unless they match the validation regex. The version format is as follows:
+
+|   | Dev   | Main   |
+|---|---------------|--------|
+|   | x.y.z-alpha.w | x.y.z  |
+
+The created Github Release this should be filled in with the relevant release notes. Upon publishing the new Github Release, a PyPi release will be created automatically by Github Actions.
+
+## Deployment Workflow
+  _**This section of this document is a work-in-progress**_
+
+### Pre-release deployment
+1. Meet pre-deployment criteria.
+   * Includes appropriate release notes, including breaking changes, in `releasenotes.md`.
+   * Pass [Codacy code quality check](https://app.codacy.com/gh/TOMToolkit/tom_base/pullRequests).
+   * Doesn't decrease [Coveralls test coverage](https://coveralls.io/github/TOMToolkit/tom_base).
+   * Passes [Github Actions tests and code style check](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml).
+   * Successfully builds [ReadTheDocs documentation](https://readthedocs.org/projects/tom-toolkit/builds/) (not an automated check).
+   * One review approval by a repository owner.
+  
+2. Merge your feature branch into the `dev` branch
+   * `git checkout dev`
+   * `git merge feature/your_feature_branch`
+
+3. Tag the release, triggering GitHub Actions:
+
+   Release tags must follow [semantic versioning](https://semver.org) syntax.
+   * `git tag -a x.y.z-alpha.w -m "x.y.z-alpha.w"`
+   * `git push --tags`
+      * Pushing the tags causes Github to create a draft release in GitHub
+
+4. Edit the Release Notes in GitHub
+
+   When the tags were pushed above, GitHub created draft Release Notes which need to be filled out. (These can be found by following the `releases` link on the [front page](https://github.com/TOMToolkit/tom_base) of the repo.
+   Or, [here](https://github.com/TOMToolkit/tom_base/releases)).
+   
+   Edit, Update, and repeat until satisfied.
+   Release notes should contain (as needed):
+   * Links to Read the Docs API (docstring) docs
+   * Links to Read the Docs higher level docs
+   * Link to Tom Demo feature demonstration
+   * Links to issues that have been fixed
+
+5. Publish the Release
+
+   - When satisfied with the Release Notes, `Publish Release`. This will trigger the PyPi release automatically. Repo watchers are notified by email.
+
+6. Deploy `tom-demo-dev` with new features demonstrated, pulling `tomtoolkit==x.y.z-alpha.w` from PyPI.
+
+   Examples:
+     * Release of observation templates should include saving an observation template and submitting an observation via the observation_template
+     * Release of manual facility interface should include an implementation of the new interface
+     * Release of a new template tag should include that template tag in a template
+
+
+### Public release deployment
+The public release deployment workflow parallels the pre-release deployment work flow
+and more details for a particular step may be found above.
+ 
+1. Create PR: `main <- dev`
+
+2. Meet pre-deployment criteria.
+   * Include docstrings for any new or updated methods
+   * Include tutorial documentation for any new major features as needed
+   * Pass [Codacy code quality check](https://app.codacy.com/gh/TOMToolkit/tom_base/dashboard?bid=18204585).
+   * Doesn't decrease [Coveralls test coverage](https://coveralls.io/github/TOMToolkit/tom_base?branch=dev).
+   * Passes [Github Actions tests and code style check](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml).
+   * Successfully builds [ReadTheDocs documentation](https://readthedocs.org/projects/tom-toolkit/builds/) (not an automated check).
+
+3. Merge PR
+   * Must be a repository owner to merge.
+
+4. Tag the release, triggering GitHub and PyPI actions:
+   * `git tag -a x.y.z -m "Release x.y.z"` -- must follow semantic versioning
+   * `git push --tags` Triggers Github Actions to:
+      * build
+      * create GitHub draft release
+
+5. Update Release Notes in GitHub draft release.
+   
+   This should be the accumulation of the all
+   the dev-release release notes:  For example, release notes for releases x.y.z-alpha.1, x.y.z-alpha.2, etc. should be combined into release notes for release x.y.z.
+
+6. Publish Release
+
+   This will trigger Github Actions to push a new PyPi release.
+
+7. deploy `tom-demo` with new features demonstrated, pulling `tomtoolkit==x.y.z` from PyPI
+
+8.  Post notification to Slack, Tom Toolkit workspace, #general channel. (In the future, we hope to
+have automated release notification to a dedicated #releases slack channel).
+
+## Development Notes - Doing checks locally
+
+### Preview Read the Docs doc strings
+* `cd /path/to/tom_base/docs`
+* `pip install -r requirements.txt  # make sure sphinx is installed to your venv`
+* `make html  # make clean first, if things are weird`
+* point a browser to the html files in `./_build/html/` to proofread before deployment 
+
+### Run code style checks
+* `pip install pycodestyle`
+* `pycodestyle tom_* --exclude=*/migrations/* --max-line-length=120`
+
+### Run coverage checks
+* `coverage run --include=tom_* manage.py test --exclude-tag=canary`
+* `coverage html`
+* point a browser to `index.html` in your `htmlcov` directory
+
+### Run tests
+* `./manage.py test --exclude-tag=canary` to run non-canary tests
+
+* Examples for running specific tests or test suites:
+  * `./manage.py test tom_targets.tests`
+  * `./manage.py test tom_targets.tests.tests.TestTargetDetail`
+  * `./manage.py test tom_targets.tests.tests.TestTargetDetail.test_sidereal_target_detail`
+
+
+## Project Information
+
+The TOM Toolkit consists of the following repositories and external resources.
+
+### Repositories
+
+Releases are managed by the TOM Toolkit team unless otherwise specified.
+
+#### Core module
+
+- `tom_base`
+
+#### Modules providing additional functionality
+
+- `tom-toolkit-component-lib` - VueJS component library.
+- `tom_nonsidereal_airmass` - Provides airmass plots for non-sidereal targets. 
+- `tom_registration` - Provides registration flows in the TOM Toolkit.
+- `tom_superevents` - Provides models and views for astronomical events.
+
+#### Third-party service modules
+
+- `tom_antares` - Provides ANTARES support. Primary contacts are [Chien-Hsiu Lee](https://github.com/lchjoel1031) and [Nicholas Wolf](https://github.com/nicwolf). Maintained outside of `tom_base` due to `elasticsearch` dependency.
+- `tom_fink` - Provides Fink support. Primary contact is [Julien Peloton](https://github.com/JulienPeloton). Releases are managed by Julien. Maintained outside of `tom_base` due to `elasticsearch` dependency.
+- `tom_lt` - Provides Liverpool Telescope support. Primary contact is [Doug Arnold](https://github.com/blancmatter). Maintained outside of `tom_base` due to `lxml` and `soap` dependencies.
+- `tom_gemini_community` - Provides additional Gemini support beyond the Gemini module that ships with `tom_base`. Primary contact is [Bryan Miller](https://github.com/bryanmiller).  Releases are managed by Bryan. Maintained outside of `tom_base` due to `gsselect`.
+- `tom_scimma` - Provides Skip support. Maintained outside of `tom_base` due to `hop-client` dependency.
+
+#### Example modules
+
+- `dockertom` - Example TOM using Docker - Unmaintained, should be brought up to date.
+- `herokutom` - Example TOM deployment using Heroku - Unmaintained, should be brought up to date.
+
+#### Experimental/prototype modules
+
+- `tom_calibrations` - Provides additional models (and potentially views) for keeping track of calibration-specific data. Currently a private repo.
+- `tom_publications` - Provides support for generating LaTeX summaries of target and observation data. Deprecated.
+- `skip-django` - Provides Plotly Dash Single-Page app for Skip interaction. Deprecated, to be replaced by VueJS components.
+- `tom-demo-frontend` - Prototype for implementation of pure VueJS app rather than using django-webpack. Patterned after `science-archive-frontend`.
+
+#### Archived
+
+- `tomtoolkit.github.io` - Documentation page predating ReadTheDocs.
+
+### Build resources
+
+#### Github Actions
+
+The following Github Actions exist for `tom_base`, and some additional repositories have some or all of the actions.
+
+##### run-tests workflow
+
+The `run-tests` workflow is triggered on any push or opened pull request. It runs the linter, runs non-canary tests, and publishes code coverage to Coveralls.
+
+##### run-canary-tests workflow
+
+The `run-canary-tests` workflow is triggered nightly. It runs just the canary tests, no others.
+
+##### github-release workflow
+
+The `github-release` workflow is triggered on tags matching `x.y.z` or `x.y.z-alpha.w`. It creates a Github Release draft for the tag.
+
+##### pypi-release workflow
+
+The `pypi-release` workflow is triggered on the publishing of a Github release. It pushes the package to PyPi.
+
+#### Codacy
+
+[Codacy](https://app.codacy.com/organizations/gh/TOMToolkit/repositories) provides code quality information for the TOM Toolkit repositories. Quality is graded on a letter grade scale from A to F, and covers things like unused variables, duplicate code, hardcoded passwords, and security vulnerabilities.
+
+Codacy often provides duplicate issues, and sometimes flags things that aren't of interest. As an example, a unit test with a variable of `password` would be flagged for a hardcoded password. In the event that a Codacy issue is not actually of interest, an issue can be ignored. Ignoring can be configured for an individual issue or all instances of that issue.
+
+The codacy report is generated via Github webhook that triggers a static code analysis.
+
+#### Coveralls
+
+[Coveralls](https://coveralls.io/github/TOMToolkit/) - Provides code coverage information. Current `tom_base` threshold is 89%, with no greater than 0.1% decrease per PR. No other repos have thresholds. Settings can be found on the Coveralls page for each specific repo.
+
+Coveralls receives the report generated by the `coverage` library by way of a Github Actions webhook. The `coverage` library determines coverage simply by keeping track of whether a line of code is run by the tests. By default, Coveralls includes actual test files in test coverage, which artificially inflates our code coverage.
+
+#### Dependabot
+
+Dependabot is configured via the `.github/dependabot.yml` file, as Dependabot is now a built-in Github integration. It runs weekly for a majority of repos, and automatically opens pull requests for any updated libraries.
+
+In general, patch and minor releases are merged immediately, provided the pull request tests pass. For `astropy` and `astroquery` releases, it's generally best practice to update the version locally and do some smoke testing to ensure that aspects of the TOM Toolkit that use those two libraries will continue to work. Examples of `astropy`- and `astroquery`-dependent features are as follows:
+
+- Data processing
+- Catalog import
+- Data plotting
+
+For major versions of libraries that are not `django` or `djangorestframework`, it's best practice to check the release notes for any incompatibilities and smoke test the updates locally. If it's a particularly sketchy upgrade, an alpha release and a test in `tom-demo` is also recommended.
+
+Django major upgrades should be very carefully considered, with a particular focus on review of release notes.
+
+Following dependabot merges to dev, any subsequent TOM Toolkit release should follow the normal release procedure at developer convenience.
+
+#### Read the Docs
+
+The [documentation](https://tom-toolkit.readthedocs.io/en/stable/) is built on new Github releases of `main` for the `stable` version of the documentation, and on new pushes to `dev` for the `latest` version of the documentation. It is triggered by a Github webhook. Settings are maintained in the [RTD project page](https://readthedocs.org/projects/tom-toolkit/). Version-specific RTD pages have to be activated manually via the [versions](https://readthedocs.org/projects/tom-toolkit/versions/) page.
+
+
+| Repository          | Codacy | Coveralls | Dependabot | PyPi Responsibility |
+|---------------------|--------|-----------|------------|---------------------|
+| `dockertom`         | N/A    | N/A       | N/A        | N/A                 |
+| `herokutom`         | N/A    | N/A       | N/A        | N/A                 |
+| `skip-django`       | No     | No        | No         | TOM-Team            |
+| `tom-demo-frontend` | N/A    | N/A       | No         | N/A                 |
+| `tt-component-lib`  | No     | N/A       | No         | N/A                 |
+| `tom_antares`       | Yes    | Yes       | Yes        | TOM Team            |
+| `tom_base`          | Yes    | >89%      | Yes        | TOM Team            |
+| `tom_calibrations`  | No     | No        | No         | TOM Team            |
+| `tom_fink`          | Yes    | Yes       | Yes        | Julien Peloton      |
+| `tom_gemini_communi`| No     | No        | No         | Bryan Miller        |
+| `tom_lt`            | No     | No        | Yes        | TOM Team            |
+| `tom_nonsidereal`   | No     | No        | Yes        | TOM Team            |
+| `tom_publications`  | No     | No        | Yes        | TOM Team            |
+| `tom_registration`  | Yes    | Yes       | Yes        | TOM Team            |
+| `tom_scimma`        | Yes    | Yes       | Yes        | TOM Team            |
+| `tom_superevents`   | Yes    | Yes       | Yes        | TOM Team            |

tomtoolkit-3.0.0/README.md

@@ -0,0 +1,112 @@
+# TOM Toolkit
+[![pypi](https://img.shields.io/pypi/v/tomtoolkit.svg)](https://pypi.python.org/pypi/tomtoolkit)
+[![run-tests](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml/badge.svg)](https://github.com/TOMToolkit/tom_base/actions/workflows/run-tests.yml)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a09d330b4dca4a4a86e68755268b7da3)](https://www.codacy.com/gh/TOMToolkit/tom_base/dashboard?utm_source=github.com&utm_medium=referral&utm_content=TOMToolkit/tom_base&utm_campaign=Badge_Grade)
+[![Coverage Status](https://coveralls.io/repos/github/TOMToolkit/tom_base/badge.svg?branch=main)](https://coveralls.io/github/TOMToolkit/tom_base?branch=main)
+[![Documentation Status](https://readthedocs.org/projects/tom-toolkit/badge/?version=stable)](https://tom-toolkit.readthedocs.io/en/stable/?badge=stable)
+[![ASCL](https://img.shields.io/badge/ascl-2208.004-blue.svg?colorB=262255)](https://ascl.net/2208.004)
+
+[Documentation](https://tom-toolkit.readthedocs.io/en/latest/)
+![logo](tom_common/static/tom_common/img/logo-color.png)
+
+The TOM Toolkit is a web framework for building TOMs: Target and Observation
+Managers. TOMs are meant to facilitate collaborative astronomical observing
+projects. A typical TOM allows its users to curate target lists, request
+observations of those targets at various observatories as well as manage and
+organize their data. [Read more](https://tom-toolkit.readthedocs.io/en/stable/introduction/about.html) about TOMs.
+
+## Getting started with the TOM Toolkit
+The [getting started guide](https://tom-toolkit.readthedocs.io/en/latest/introduction/getting_started.html)
+will guide you through the process of setting up a TOM for the first time.
+
+## Reporting issues/feature requests
+Please use the [issue tracker](https://github.com/TOMToolkit/tom_base/issues) to
+report any issues or support questions.
+
+## Development Team 
+The lead developers of the TOM Toolkit are [William Lindstrom](https://lco.global/people/)
+and [Joey Chatelain](https://sites.google.com/site/josephchatelain),
+professional software developers with the Las Cumbres Observatory software team,
+together with [Jon Nation](https://lco.global/people/), [Curtis McCully](https://lco.global/people/),
+[Matt Daily](https://lco.global/people/) and [Mark Bowman](https://lco.global/people/).  [Rachel Street](https://lco.global/user/rstreet/) is the project's Principle Investigator.
+The TOM Toolkit is grateful for the advice and collaboration with [Andy Howell](http://www.dahowell.com/),
+[Edward Gomez](https://www.zemogle.net/), Craig Pellegrino, Jamie Burke and the rest of the LCO Science team.
+The [original Toolkit](https://zenodo.org/records/4437764) was developed by
+Austin Riba, David Collom and William Lindstrom.
+
+Our team very much welcome input from the community, and we are grateful to
+the following people for their many contributions:
+ - Dan Avner, NOIRLab
+ - Doug Arnold, Liverpool Telescope
+ - Etienne Bachelet, IPAC/Caltech
+ - Ezequiel Contreras Martinez, UCSB
+ - Griffin Hosseinzadeh, University of Arizona
+ - Bryan Miller, Gemini Observatory
+ - Brendan Mills, UCSB
+ - Julien Peloton, Fink
+
+## Acknowledgements
+
+We hope you find our software useful for your research.  If so, we would be grateful
+if you can include a brief acknowledgement in your papers and presentations, for example 
+"This research made use of [The TOM Toolkit](https://tom-toolkit.readthedocs.io/)". 
+We would also very much appreciate you including a citation to our paper describing 
+the Toolkit [Street, R.A. et al., 2018, SPIE, 10707, 11](http://adsabs.harvard.edu/abs/2018SPIE10707E..11S) 
+(to export the BibTeX please click [here](https://ui.adsabs.harvard.edu/abs/2018SPIE10707E..11S/exportcitation)).  
+
+
+## Contributing to the project
+If you'd like to contribute to the TOM Toolkit, first of all, thanks! Secondly, we
+have a [contribution guide](https://tom-toolkit.readthedocs.io/en/stable/introduction/contributing.html) that
+you might find helpful. We are particularly interested in the contribution of
+observation and alert modules.
+
+### Community Code of Conduct
+We encourage developers to maintian a lively and civil discourse either on github or in our slack workspace.
+Please review our [code of conduct](CODE_OF_CONDUCT.md) for information about what is considered unacceptable behavior and how to report it.
+
+## Developer information
+For development information targeted at the maintainers of the project, please see [README-dev.md](README-dev.md).
+
+## Plugins
+Different TOM systems have different science goals and sometimes need 
+different functions. Rather than require users to support all 
+dependencies from all possible functions, we support a range of optional 
+plugin modules for the Toolkit.  Have a look at our [list of plugins](https://tom-toolkit.readthedocs.io/en/stable/api/plugins.html) 
+see which would benefit your science goals. 
+
+### Antares
+
+The [tom-antares](https://github.com/TOMToolkit/tom_antares) plugin adds support
+for querying the Antares broker for targets of interest.
+
+### tom_nonsidereal_airmass
+
+The [tom_nonsidereal_airmass](https://github.com/TOMToolkit/tom_nonsidereal_airmass) plugin provides a templatetag
+that supports plotting for non-sidereal objects. The plugin is fully supported by the TOM Toolkit team; however,
+non-sidereal visibility calculations require the PyEphem library, which is minimally supported while its successor
+is in development. The library used for the TOM Toolkit sidereal visibility, astroplan, does not yet support
+non-sidereal visibility calculations.
+
+### tom-lt
+
+This module provides the ability to submit observations to the Liverpool Telescope Phase 2 system. It is in a very alpha
+state, with little error handling and minimal instrument options, but can successfully submit well-formed observation
+requests.
+
+[Github](https://github.com/TOMToolkit/tom_lt)
+
+### tom_registration
+
+The [tom_registration](https://github.com/TOMToolkit/tom_registration) plugin introduces support for two TOM registration
+flows--an open registration, and a registration that requires administrator approval.
+Our philosophy is to keep the TOM as lightweight and adaptable as possible.  
+
+
+## About the TOM Toolkit
+
+The TOM Toolkit is managed by Las Cumbres Observatory, with generous
+financial support from the [National Science Foundation](https://www.nsf.gov/) grant 2209852.
+We are also grateful for support from the [Heising-Simons Foundation](https://hsfoundation.org) 
+and the [Zegar Family Foundation](https://sites.google.com/zegarff.org/site) at the start
+of the project.  

tomtoolkit-3.0.0/docs/_static/custom.css

@@ -0,0 +1,26 @@
+/* TOM Toolkit Branding Colors */
+/* --primary: #017792;       /* TOM Toolkit logo colors */
+/* --color-primary: #017792; */
+/* --primary-light: #00a3c8; */
+
+[data-theme="light"] {
+    --color-primary: #017792;
+    --color-header-background: #00a3c8;
+}
+[data-theme="dark"] {
+    --color-primary: #017792;
+    --color-background: #00a3c8;
+}
+
+div.partners {
+  text-align: center;
+}
+
+a.hs {
+  padding-right: 10%;
+}
+
+.toctree-l1 > a[href*="getting_started"] {
+    color: #017792 !important;
+    font-weight: bold;
+}