feat: re-structure; re-write (wip)

.editorconfig

@@ -0,0 +1,15 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{md,json,yml,yaml,js,jsx,ts,tsx,css,scss,html}]
+indent_size = 2

.gitignore

@@ -1,134 +1,206 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-lerna-debug.log*
-
-# Diagnostic reports (https://nodejs.org/api/report.html)
-report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
+### Custom
 
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
 
-# Coverage directory used by tools like istanbul
-coverage
-*.lcov
 
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
+### Python.gitignore
 
-# Bower dependency directory (https://bower.io/)
-bower_components
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
 
-# node-waf configuration
-.lock-wscript
+# C extensions
+*.so
 
-# Compiled binary addons (https://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-jspm_packages/
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
 
-# Snowpack dependency directory (https://snowpack.dev/)
-web_modules/
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
 
-# TypeScript cache
-*.tsbuildinfo
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
 
-# Optional npm cache directory
-.npm
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
 
-# Optional eslint cache
-.eslintcache
+# Translations
+*.mo
+*.pot
 
-# Microbundle cache
-.rpt2_cache/
-.rts2_cache_cjs/
-.rts2_cache_es/
-.rts2_cache_umd/
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
 
-# Optional REPL history
-.node_repl_history
+# Flask stuff:
+instance/
+.webassets-cache
 
-# Output of 'npm pack'
-*.tgz
+# Scrapy stuff:
+.scrapy
 
-# Yarn Integrity file
-.yarn-integrity
+# Sphinx documentation
+docs/_build/
 
-# dotenv environment variables file
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
 .env
-.env.test
-
-# parcel-bundler cache (https://parceljs.org/)
-.cache
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
 
-# Next.js build output
-.next
+# Spyder project settings
+.spyderproject
+.spyproject
 
-# Nuxt.js build / generate output
-.nuxt
-dist
+# Rope project settings
+.ropeproject
 
-# Gatsby files
-.cache/
-# Comment in the public line in if your project uses Gatsby and not Next.js
-# https://nextjs.org/blog/next-9-1#public-directory-support
-# public
+# mkdocs documentation
+/site
 
-# vuepress build output
-.vuepress/dist
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
 
-# Serverless directories
-.serverless/
+# Pyre type checker
+.pyre/
 
-# FuseBox cache
-.fusebox/
+# pytype static type analyzer
+.pytype/
 
-# DynamoDB Local files
-.dynamodb/
+# Cython debug symbols
+cython_debug/
 
-# TernJS port file
-.tern-port
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
 
-# Stores VSCode versions used for testing VSCode extensions
-.vscode-test
+### React.gitignore
 
-.DS_Store
-.env
-.flaskenv
+.DS_STORE
+node_modules
+scripts/flow/*/.flowconfig
+.flowconfig
+*~
 *.pyc
-*.pyo
-env/
-dist/
+.grunt
+_SpecRunner.html
+__benchmarks__
 build/
-*.egg
-*.egg-info/
-_mailinglist
-.tox/
-.cache/
-.pytest_cache/
-.idea/
-docs/_build/
-.vscode
-
-# Coverage reports
-htmlcov/
-.coverage
-.coverage.*
-*,cover
-
-#ignore generated react build
-flask-backend/static/
+remote-repo/
+coverage/
+.module-cache
+fixtures/dom/public/react-dom.js
+fixtures/dom/public/react.js
+test/the-files-to-test.generated.js
+*.log*
+chrome-user-data
+*.sublime-project
+*.sublime-workspace
+.idea
+*.iml
+*.swp
+*.swo
+
+packages/react-devtools-core/dist
+packages/react-devtools-extensions/chrome/build
+packages/react-devtools-extensions/chrome/*.crx
+packages/react-devtools-extensions/chrome/*.pem
+packages/react-devtools-extensions/firefox/build
+packages/react-devtools-extensions/firefox/*.xpi
+packages/react-devtools-extensions/firefox/*.pem
+packages/react-devtools-extensions/shared/build
+packages/react-devtools-extensions/.tempUserDataDir
+packages/react-devtools-inline/dist
+packages/react-devtools-shell/dist
+packages/react-devtools-timeline/dist

.markdownlint.json

@@ -0,0 +1,4 @@
+{
+  "line-length": false,
+  "first-line-h1": false
+}

.vscode/extensions.json

@@ -0,0 +1,13 @@
+{
+  "recommendations": [
+    "ms-python.python",
+    "ms-python.black-formatter",
+    "ms-python.isort",
+    "ms-python.pylint",
+    "ms-python.mypy-type-checker",
+    "dbaeumer.vscode-eslint",
+    "esbenp.prettier-vscode",
+    "yzhang.markdown-all-in-one",
+    "DavidAnson.vscode-markdownlint"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "files.insertFinalNewline": true,
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.black-formatter"
+  },
+  "python.analysis.extraPaths": [
+    "server"
+  ],
+  "python.defaultInterpreterPath": "server/env/bin/python",
+  "python.formatting.provider": "black",
+}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 Michael DeMarco
+Copyright (c) 2023 Michael DeMarco
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

Makefile

@@ -0,0 +1,17 @@
+# Inspired by PrairieLearn's Makefile!
+# see: https://github.com/PrairieLearn/PrairieLearn/blob/e783f4e4aefe37afb3409f20546824404534a4d2/Makefile
+
+lint: lint-client lint-server
+lint-client:
+	@cd client && yarn eslint --ext js --report-unused-disable-directives "**/*.js"
+	@cd client && yarn prettier --check "**/*.{js,md}"
+lint-server:
+	@cd server && python -m pylint .
+
+format: format-client format-server
+format-client:
+	@cd client && yarn eslint --ext js --fix "**/*.js"
+	@cd client && yarn prettier --write "**/*.{js,md}"
+format-server:
+	@cd server && python3 -m isort .
+	@cd server && python3 -m black .