psat-server-web

Python 3 web interface for the Pan-STARRS and ATLAS surveys.

To install:

pip install psat-server-web

Once installed, don't forget to add the "data" symlinks in the:

site-packages/psat_server_web/atlas/media/images site-packages/psat_server_web/ps1/media/images

directories which point to the location of the image stamps.

Local development version

A localised development instance can be run with docker compose. You will need a .env file in your repository root to define some environment variables, looking something like:

# Django settings
SECRET_KEY={YOUR_SECRET_KEY_HERE}
DJANGO_ALLOWED_HOSTS=localhost 127.0.0.1 [::1]

# MySQL/MariaDB settings
MYSQL_ROOT_USER=root
MYSQL_ROOT_PASSWORD=root
MYSQL_DATABASE=atlas
MYSQL_USER=atlas
MYSQL_PASSWORD=atlas
MYSQL_PORT=3306
MYSQL_TEST_DATABASE=atlas_test
MYSQL_TEST_PORT=3306
MYSQL_TEST_USER=root
MYSQL_TEST_PASSWORD=root

DJANGO_MYSQL_DBUSER=atlas
DJANGO_LASAIR_TOKEN=

Several of the values are omitted but aren't necessary to run a development environment. Also ruch simple passwords should not be used in production, but this should get you something running locally. Hopefully it's then as simple as running the following:

docker compose up

Which will start 4 services, comprised of:

  • db - A MariaDB instance. By default served at localhost:3036
  • atlas-web - A mod-wsgi instance to serve the django front end. By default served at localhost:8086 and requires db to be running.
  • adminer - A web interface for interacting with the db. By default served at localhost:8080 and requires db to be running.
  • tests - A single-use run of the unit tests using django's manage.py test. Requires db to be running.

Each of these services can be run independently with

docker compose up {service_name}

So if, for example, you wanted to run the tests you could execute docker compose up tests and it would – after starting db if it is not already running – perform a single run of the unit tests.

A dummy database

There are a few things you will likely need to do to get a fully working version of the web-server so as to make your local version useful, namely:

  1. Get a dummy database dump .sql file from one of the developers and place it into data/init.sql
  2. [Optional] Get an image dump and place it into data/db_data/
  3. Fix a mild issue with the database model (see next section)

If you are having problems with any of this, contact one of the developers.

Issue with TcsGravityEventAnnotations.map_iteration

If you are getting an error along the lines of

atlas-web-1  | ERRORS:
atlas-web-1  | atlas.TcsGravityEventAnnotations.map_iteration: (fields.E311) 'TcsGravityAlerts.map_iteration' must be unique because it is referenced by a foreign key.
atlas-web-1  | 	HINT: Add unique=True to this field or add a UniqueConstraint (without condition) in the model Meta.constraints.

Then you may need to make an adjustment to the models, specifically by uncommenting the line declaring TcsGravityAlerts.map_iteration which adds a unique kwarg, and commenting the line without the unique kwarg, should solve the problem. Specifically, the lines should look like

# map_iteration = models.CharField(max_length=100, blank=True, null=True)
map_iteration = models.CharField(max_length=100, blank=True, null=True, unique=True)

This is within the TcsGravityAlerts(models.Model) class. Again, please speak to one of the developers if this is unclear.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.9.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for genghisken from gravatar.com genghisken

Credits

Author: genghisken

License

MIT License (MIT)

Requires

Python >=3.6

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

psat_server_web-0.9.2.tar.gz (12.1 MB view details)

Uploaded Source

File details

Details for the file psat_server_web-0.9.2.tar.gz.

File metadata

  • Download URL: psat_server_web-0.9.2.tar.gz
  • Upload date:
  • Size: 12.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for psat_server_web-0.9.2.tar.gz
Algorithm Hash digest
SHA256 751fa893d2c6ea9ee4240cf7261c435367335ec180f04e30e6b830c2f1b283bc
MD5 276204cf2b8a8e649e68f01d5c31e7e3
BLAKE2b-256 d4fbe5a18366b77e9f13dd637579f81bc292afdb3738115dca6ffb03925e6e13

See more details on using hashes here.

Release history Release notifications | RSS feed

0.9.3

This release

0.9.2

0.9.1

0.9.0

0.8.5

0.8.4

0.8.3

0.8.2

0.8.1

0.8.0

0.7.5

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.12

0.6.10

0.6.9

0.6.8

0.6.7

0.6.6

0.6.5

0.6.4

0.6.3

0.6.2

0.6.1

0.6.0

0.5.10

0.5.9

0.5.8

0.5.7

0.5.6

0.5.5

0.5.4

0.5.3

0.5.2

0.5.1

0.5.0

0.4.2

0.4.1

0.4.0

0.3.22

0.3.21

0.3.20

0.3.19

0.3.18

0.3.17

0.3.16

0.3.15

0.3.14

0.3.13

0.3.12

0.3.11

0.3.10

0.3.9

0.3.8

0.3.7

0.3.6

0.3.5

0.3.4

0.3.3

0.3.2

0.3.1

0.3.0

0.2.9

0.2.8

0.2.7

0.2.6

0.2.5

0.2.4

0.2.3

0.2.2

0.2.1

0.2.0

0.1.11

0.1.10

0.1.9

0.1.8

0.1.7

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

0.0.54

0.0.53

0.0.52

0.0.51

0.0.50

0.0.49

0.0.48

0.0.47

0.0.46

0.0.45

0.0.44

0.0.43

0.0.42

0.0.41

0.0.40

0.0.39

0.0.38

0.0.37

0.0.36

0.0.35

0.0.34

0.0.33

0.0.32

0.0.31

0.0.30

0.0.29

0.0.28

0.0.27

0.0.26

0.0.25

0.0.24

0.0.23

0.0.22

0.0.21

0.0.20

0.0.19

0.0.18

0.0.17

0.0.16

0.0.15

0.0.14

0.0.13

0.0.12

0.0.11

0.0.10

0.0.9

0.0.8

0.0.7

0.0.6

0.0.5

0.0.4

0.0.3

0.0.2

0.0.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page