From 2d158474cea34ea3e906b56a78904fccfa14f275 Mon Sep 17 00:00:00 2001 From: Brandon Egger Date: Tue, 18 Apr 2023 00:46:04 -0500 Subject: [PATCH] add README --- data/README.md | 2 ++ scripts/README.md | 31 +++++++++++++++++++++++++++++++ scripts/README.rst | 0 3 files changed, 33 insertions(+) create mode 100644 data/README.md create mode 100644 scripts/README.md delete mode 100644 scripts/README.rst diff --git a/data/README.md b/data/README.md new file mode 100644 index 0000000..de002f6 --- /dev/null +++ b/data/README.md @@ -0,0 +1,2 @@ +# Data +Backend data is placed in this repository. Currently this consists of the auditory training resources \ No newline at end of file diff --git a/scripts/README.md b/scripts/README.md new file mode 100644 index 0000000..2814725 --- /dev/null +++ b/scripts/README.md @@ -0,0 +1,31 @@ +# Importing Data + +The purpose of the import script is to take the formatted excel sheet (found in /data/atr_data.xlsx) and upload it to the remote mongoDB server. + +# Tutorial +This script is currently in early stages and was initially designed to simplify uploading the assets until a more permanent web UI could be built for the task. Therefore this utility is very low-level and likely requires some tinkering outside its intended use case. + +## Setup +1. Open import/main.py +2. Configure the two globals: +```python +MONGO_URL = "enter mongo DB URL" +MONGO_DB = "name of DB" +``` +3. Make sure dependencies are intalled with `poetry install` + +## Run +The script takes one parameter which is simply the path of your excel sheet. +```sh +poetry run python import/main.py $PATH +``` +For example; if uploading the data provided in this repository you can run the following: +```sh +poetry run python import/main.py ../data/atr_data.xlsx +``` +You should see output showing the individual objects it extracted from your excel sheet along with a success message at the end. + +# Expected Data Format +***TODO:*** Outline expected data format for the utility. + +See atr_data.xlsx \ No newline at end of file diff --git a/scripts/README.rst b/scripts/README.rst deleted file mode 100644 index e69de29..0000000