From 57abb0520de4bb0acf175331f7bf946216063696 Mon Sep 17 00:00:00 2001 From: Justin Campbell Date: Tue, 29 Jun 2021 15:11:42 -0400 Subject: [PATCH] Remove unused package structure docs --- docs-src/package-structure.md | 63 ----------------------------------- 1 file changed, 63 deletions(-) delete mode 100644 docs-src/package-structure.md diff --git a/docs-src/package-structure.md b/docs-src/package-structure.md deleted file mode 100644 index e2450bb..0000000 --- a/docs-src/package-structure.md +++ /dev/null @@ -1,63 +0,0 @@ -## API package structure - -The api can be broken down into 4 distinct parts: -1. The logger -2. The api -3. The ECNQueue -4. The initialization scripts - -### Logger - -The logger is its own subpackage and script which is used for outputting log information to both the terminal and a specified file. The logger uses the logging module to create log outputs with specified format. - -### API - -The api is the link between the ECNQueue and the frontend. The api continuously runs in the background, and takes urls matching a specified format from the front end and translates those as functions to be executed in the ECNQueue. The api uses flask and flask restful to do this - -### ECNQueue - -The ECNQueue subpackage is a parser in the backend for all of the items in stored in the queue directory. The ECNQueue parses the text documents in the queue and outputs structured json, which is then transfered to the fronted via the api. - -### The initialization scripts - -The initialization scripts take in user input (either via command line or wrapper script) and initialize the logger, ECNQueue, and API according to the user input. After initializing and implementing all of the necessary configurations, the initialization scripts start the api. These scripts use argparse to get user input and subprocess to launch the api via gunicorn. While not its own subpackage, the scripts are located directly in the `webqueue2_api` directory. - - -## Structure - -```none -webqueue2_api/ # webqueue2_api parent package -│ -├── api/ # api subpackage -│ ├── __init__.py -│ ├── auth.py -│ └── resources/ -│ ├── __init__.py -│ ├── item.py -│ ├── login.py -│ ├── queue.py -│ ├── queue_list.py -│ └── refresh_access_token.py -│ -├── ECNQueue/ # ecnqueue subpackge -│ ├── __init__.py -│ ├── Item.py -│ ├── parser/ -│ │ ├── __init__.py -│ │ └── parser.py -│ ├── Queue.py -│ └── utils.py -│ -├── logger/ # logger subpackage -│ └─── __init__.py -│ -├── utils/ # utils subpackage -│ ├── __init__.py -│ └── tree.py -│ -├── __init__.py -├── __main__.py # parses user input -├── global_configs.py # stores the config file location -├── start.py # returns a flask object ater initializing the user configs -└── validate_arguments.py # validates all of teh user passed arguments -``` \ No newline at end of file