Testing framework MVP

.gitignore

@@ -1,3 +1,6 @@
+dev_handler
+shm_api.c
+
 ### https://raw.github.com/github/gitignore/afbff9027d02ccfc680e031f6c295f79ad61662d/C++.gitignore
 
 # Prerequisites
@@ -404,3 +407,9 @@ hibike/virtual_devices.txt
 /dawn-*
 /artifacts
 .vagrant
+
+# user token used for google auth flow
+user_token.json
+
+
+

.travis.yml

@@ -1,32 +1,31 @@
 dist: xenial
 sudo: required
 os: linux
-
 language: python
 python: 3.7
-
-# list packages installable using apt here
 addons:
-    apt:
-        packages:
-            - python3-setuptools
-            - python3-pip
-            - libasound2-dev
-            - socat
-
-# requires that commit is for a PR or is on master branch
-if : (type = pull_request) OR (type = push AND branch = master)
-
+  apt:
+    packages:
+    - python3-setuptools
+    - python3-pip
+    - libasound2-dev
+    - socat
+if: "(type = pull_request) OR (type = push AND branch = master)"
 jobs:
-    include:
-        - name: test
-          script:
-            - echo "testing"
-
-        - name: format
-          script:
-            - echo "formatting"
-
-        - name: build
-          script:
-            - echo "building"
+  include:
+  - name: test
+    install:
+    - pip install -r requirements.txt
+    script:
+    - echo "testing"
+    - cd shepherd
+    - python3 testing_script.py
+  - name: format
+    script:
+    - echo "formatting"
+  - name: build
+    script:
+    - echo "building"
+before_install:
+- openssl aes-256-cbc -K $encrypted_6a33d71cd260_key -iv $encrypted_6a33d71cd260_iv
+  -in shepherd/sheets/user_token.json.enc -out shepherd/sheets/user_token.json -d

README.md

@@ -1,88 +1,55 @@
 # Shepherd
 
-Shepherd is the team that is in charge of field control. 
+Shepherd is the team that is in charge of field control.
 Shepherd brings together all the data on the game field into one centralized location, where it keeps track of score, processes game-specific actions, keeps track of time, and informs the scoreboard.
 
+## Sections
+
+- [Architecture](#Architecture)
+- [Installing Dependencies](#Installing-Dependencies)
+- [Running Shepherd](#Running-Shepherd)
+- [Testing](./shepherd/tests/TESTING_DOCS.md)
+
 ## Architecture
 
 Shepherd is essentially a [Flask](https://palletsprojects.com/p/flask/) web app that communicates with:
 
-* Arduino devices on the field over USB serial.
-* Each robot's [Runtime](https://github.com/pioneers/PieCentral/tree/master/runtime) instance using MessagePack remote procedure calls over TCP.
-* Each driver station's [Dawn](https://github.com/pioneers/PieCentral/tree/master/dawn) instance.
-* Each scoreboard client, which is rendered with jQuery. Typically, there is a scoreboard on each side of the field, a projection for spectators, and a fourth for the field control staff.
-* Each perk selection tablet (specific to Sugar Blast).
+- Arduino devices on the field over USB serial.
+- Each robot's [Runtime](https://github.com/pioneers/PieCentral/tree/master/runtime) instance using MessagePack remote procedure calls over TCP.
+- Each driver station's [Dawn](https://github.com/pioneers/PieCentral/tree/master/dawn) instance.
+- Each scoreboard client, which is rendered with jQuery. Typically, there is a scoreboard on each side of the field, a projection for spectators, and a fourth for the field control staff.
+- Each perk selection tablet (specific to Sugar Blast).
 
 ## Installing dependencies
 
-### Python dependencies
-Run the following
-```
-pip install -r requirements.txt
+```bash
+pip3 install -r requirements.txt
 ```
 
-### LCM
-
-#### Linux
-Run the installlcm script
-```
-./installlcm
-```
-
-#### Mac
-1. Set the Java Version to 8
-```
-export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
-```
-2. Run the installlcm script
-```
-./installlcm
-```
+## Architecture
 
-## Running Shepherd
+To read about Shepherd in detail, check out the [onboarding readme](https://github.com/pioneers/shepherd-onboarding#about-shepherd). This is where you will find detailed information about what each component of Shepherd does.
 
-### Instructions for 2018-2019, aka Sugar Blast:
-This year, we ran Shepherd on Ajax, one of the computers owned by PiE. 
-In order to make it easier to run Shepherd on various machines, we added needed dependencies to a Pipfile. 
-This allows you to work in a virtual environment with all necessary dependencies 
-(except for [LCM](https://lcm-proj.github.io/build_instructions.html), which must be installed beforehand) 
-by issuing the following commands in PieCentral/shepherd:
-```
-pipenv install
-pipenv shell
-```
-Next, open a terminal pane for each of the below (using tmux) and run the following commands in PieCentral/shepherd directory.
+## 2021 Instructions
 
-1:
-```
-export FLASK_APP=server.py
-flask run
-```
+First get the release labelled "working game spring 2021" or grab the core_game_2021 branch. 
 
-2:
-```
-export FLASK_APP=scoreboard_server.py
-flask run
-```
+For competition, we have 5 different scripts to run. Matthew has created a tmux script that runs everything we need that we encourage you to modify in future years because it is really easy to use. Do this inside a terminal (not VSCode) so that you have space.
 
-3:
 ```
-export FLASK_APP=dawn_server.py
-flask run
+docker restart sheep
+docker attach sheep
+cd outsideshep/shepherd
+./shepherd_tmux.sh
 ```
-
-4:
+After you are done, be sure to stop the container to please Samuel.
 ```
-python3 Shepherd.py
+docker stop sheep
 ```
 
-5:
-```
-python3 Sensors.py
-```
+One part of this that has not yet been tested is dev handler communication with Arduino devices. After that, Shepherd should be able to run straight out of the Docker container.
 
-6:
-```
-export FLASK_APP=perks_server.py
-flask run
+If you are not using docker, open a terminal, cd into shepherd and run
 ```
+./shepherd_tmux.sh
+```

requirements.txt

@@ -1,35 +1,11 @@
-bidict==0.21.2
-cachetools==4.2.1
-certifi==2020.12.5
-chardet==4.0.0
-click==7.1.2
-Flask==1.1.2
-Flask-SocketIO==5.0.1
-gevent==21.1.2
-gevent-websocket==0.10.1
-google-api-core==1.25.1
-google-api-python-client==1.12.8
-google-auth==1.25.0
-google-auth-httplib2==0.0.4
-googleapis-common-protos==1.52.0
-greenlet==1.0.0
-httplib2==0.18.1
-idna==2.10
-itsdangerous==1.1.0
-Jinja2==2.11.3
-MarkupSafe==1.1.1
-oauth2client==4.1.3
-protobuf==3.14.0
-pyasn1==0.4.8
-pyasn1-modules==0.2.8
-python-engineio==4.0.0
-python-socketio==5.0.4
-pytz==2021.1
-requests==2.25.1
-rsa==4.7
-six==1.15.0
-uritemplate==3.0.1
-urllib3==1.26.3
-Werkzeug==1.0.1
-zope.event==4.5.0
-zope.interface==5.2.0
+##### Protobuf for Runtime stuff #####  
+protobuf
+
+##### Google Sheets #####
+google-api-python-client
+google-auth-httplib2
+google-auth-oauthlib
+
+##### Flask server #####
+flask-socketio
+gevent-websocket