PYROS (PYthon Robotic telescope Operating Software)
A Python software for the management of a Telescope control center

COPYRIGHT (C) 2012-2018 IRAP (Institut de Recherche en Astrophysique et Planetologie) Toulouse - France

Authors : etienne.pallier@irap.omp.eu, paul.carensac@epitech.eu, alexandru.burlacu11@gmail.com, jeremy.barneron@gmail.com, quentin.durand@epitech.eu

GPL License (http://www.gnu.org/copyleft/gpl.html) - See the file LICENSE.txt

This software runs with Python 3 and Django 2.0.5

To install it, go into the "install/" folder, and read the document INSTALLATION

-----------------------------------------------------------------------------------------------------------
This software has been tested and validated with the following configurations :

- Centos 7 (test server planetoweb2) :
	- Python: 3.5
	- Mysql:
	- Apache:

- Ubuntu 14LTS (Paul Carensac's laptop) :
	- Python: 3.5
	- Mysql: 5.5.46
	- Apache:

- Ubuntu 16.04 LTS (Jérémy Barneron's laptop) :
	- Python: 3.5.2
	- Mysql: 5.7.15
	- Apache: 2.4.18
	- Django: 1.10.2

- Mac OS 10.11.4 (Etienne Pallier's laptop)
	- Python: 3.5
	- XAMPP for OS X 5.6.3, which comes with :
		- MySQL: 5.6.21
		- Apache 2.4.10

--------------------------------------------------------------------------------------------
PROJECT STRUCTURE:

    - src/ : conteneur du projet (le nom est sans importance)
    	- manage.py : utilitaire en ligne de commande permettant differentes actions sur le projet
    	- pyros/ : the actual Python package of the project
    		- settings.py : project settings and configuration
	    	- urls.py : déclaration des URLs du projet
    		- wsgi.py : point d'entrée pour déployer le projet avec WSGI

	- database/ : database configuration and documentation

	- doc/ : project documentation

	- install/ : project installation howto

	- private/ : the content of this folder is private and thus not commited to git ; it should contain your Python3 virtual environment
	
	- simulators/ : the devices simulators

	- public/ : this folder contains all public files like the web html files
		- static/

--------------------------------------------------------------------------------------------
LAST VERSION

Date: 14/05/2018
By: E. Pallier
Version: 0.20
- The dependencies of the project are all up-to-date and in adequacy with Django 2.0.
- Django have been updated to Django 2.
- Creation of an interactive dashboard as the home page of PYROS (still work-in-progress).

Major current version (0.20): https://projects.irap.omp.eu/versions/158

ROADMAP: https://projects.irap.omp.eu/projects/pyros/roadmap
--------------------------------------------------------------------------------------------

IF EVER STRUCTURAL MODIFICATIONS NEED TO BE DONE MANUALLY AFTER UPDATE (git pull) :
re-execute the installation script (python3 install.py update)

--------------------------------------------------------------------------------------------
MAIN CHANGES (MILESTONES):

Full list of commits: https://gitlab.irap.omp.eu/epallier/pyros/commits/master

14/05/18     	Version 0.20 (Q. Durand)
		Update all dependencies, update to django 2 and work in progress on the dashboard

23/03/18	Version 0.16.11 (E. Pallier)
            All unit tests now pass WITHOUT celery (./manage.py test or ./pyros.py test)

22/03/18	Version 0.16.10 (E. Pallier)
            New global variable USE_CELERY (false by default) in pyros.settings

13/03/18	Version 0.16.7 (E. Pallier)
            Each agent (envmonitor, majordome, alert) can be started independently with a script (new script start_agent in each agent directory)
            New command "pyros start" to start pyros in different ways (different options : everything or only some components)

22/02/18	Version 0.16.5 (E. Pallier)
			Better isolation of Monitoring for easier testing (+ tuto)

01/02/18	Version 0.16.3 (Q. Durand)
			New installation script src/install/install.py multiplatform (Lin-Mac-Win10, but also tested on Win7)
			
24/02/17    Version 0.15.1 - Added comments (Jeremy Barneron)
            Details added to describe the functions behavior
            https://projects.irap.omp.eu/versions/158

18/01/17    Version 0.15 - Execution with simulators
            Simulators evolution / majordome / monitoring / installer
            https://projects.irap.omp.eu/versions/158

15/12/16    Version 0.14.1 - Final version 0.14
			Scenarist first versions
			https://projects.irap.omp.eu/versions/152

02/08/16	Version 0.12.4 - Final version 0.12
			Simulators first versions
			https://projects.irap.omp.eu/versions/129

20/07/16	Version 0.11.4 - Final version 0.11
			Alert manager second version
			https://projects.irap.omp.eu/versions/128

05/07/16	Version 0.10.2 - Final version 0.10
			Monitoring first version
			https://projects.irap.omp.eu/versions/120

05/07/16	Version 0.9.2 - Final version 0.9
			Analysis skeleton
			https://projects.irap.omp.eu/versions/119

28/06/16	Version 0.8.3 - Final version 0.8
			Execution (majordome & obs manager), first version
			https://projects.irap.omp.eu/versions/118

23/06/16		Version 0.7.8 - Final version 0.7
			Routine manager, first version
			https://projects.irap.omp.eu/versions/117

20/05/16		Version 0.6.1 - Final version 0.6
			Complete user management
			https://projects.irap.omp.eu/versions/123

20/05/16		Version 0.5.4 - Final version 0.5
			Complete alert manager first version
			https://projects.irap.omp.eu/versions/116

20/05/16		Version 0.4.2 - Final version 0.4
			Complete scheduler update
			https://projects.irap.omp.eu/versions/90

10/05/16		Version 0.3.12 - Final version 0.3
			Complete workflow skeleton
			https://projects.irap.omp.eu/versions/88

13/04/16		Version 0.2.7 - Final version 0.2
			Integrate PLANNER module
			https://projects.irap.omp.eu/versions/97

12/04/16		Version 0.1.1 - Final version 0.1
			Multi-platform skeleton easy install + admin interface on database + start dashboard
			https://projects.irap.omp.eu/versions/87

04/04/16 	Installable version (install script)