v0.0.1

.flake8

@@ -0,0 +1,5 @@
+[flake8]
+ignore = E203, E266, E501, W503, F403, F401
+max-line-length = 120
+max-complexity = 18
+select = B,C,E,F,W,T4,B9

.gitignore

@@ -0,0 +1,149 @@
+.env
+# .gitignore for edx-platform.
+# There's a lot here, please try to keep it organized.
+
+### Files private to developers
+
+# Files that should be git-ignored, but are hand-edited or otherwise valued,
+# and so should not be destroyed by "make clean".
+# start-noclean
+requirements/private.txt
+requirements/edx/private.in
+requirements/edx/private.txt
+lms/envs/private.py
+cms/envs/private.py
+# end-noclean
+
+### Python artifacts
+*.pyc
+
+### Editor and IDE artifacts
+*~
+*.swp
+*.orig
+/nbproject
+.idea/
+.redcar/
+codekit-config.json
+.pycharm_helpers/
+/_mac/*
+/IntelliLang.xml
+/conda_packages.xml
+/databaseSettings.xml
+/diff.xml
+/debugger.xml
+/editor.xml
+/ide.general.xml
+/inspection/Default.xml
+/other.xml
+/packages.xml
+/web-browsers.xml
+
+### NFS artifacts
+.nfs*
+
+### OS X artifacts
+*.DS_Store
+.AppleDouble
+:2e_*
+:2e#
+
+### Internationalization artifacts
+*.mo
+*.po
+*.prob
+*.dup
+!django.po
+!django.mo
+!djangojs.po
+!djangojs.mo
+conf/locale/en/LC_MESSAGES/*.mo
+conf/locale/fake*/LC_MESSAGES/*.po
+conf/locale/fake*/LC_MESSAGES/*.mo
+# this was a mistake in i18n_tools, now fixed.
+conf/locale/messages.mo
+
+### Testing artifacts
+.testids/
+.noseids
+nosetests.xml
+.cache/
+.coverage
+.coverage.*
+coverage.xml
+cover/
+cover_html/
+reports/
+jscover.log
+jscover.log.*
+.pytest_cache/
+pytest_task*.txt
+.tddium*
+common/test/data/test_unicode/static/
+test_root/courses/
+test_root/data/test_bare.git/
+test_root/export_course_repos/
+test_root/paver_logs/
+test_root/uploads/
+django-pyfs
+.tox/
+common/test/db_cache/bok_choy_*.yaml
+common/test/data/badges/*.png
+
+### Installation artifacts
+*.egg-info
+.pip_download_cache/
+.prereqs_cache
+.vagrant/
+node_modules
+bin/
+
+### Static assets pipeline artifacts
+*.scssc
+lms/static/css/
+lms/static/certificates/css/
+cms/static/css/
+common/static/common/js/vendor/
+common/static/common/css/vendor/
+common/static/bundles
+webpack-stats.json
+
+### Styling generated from templates
+lms/static/sass/*.css
+lms/static/sass/*.css.map
+lms/static/certificates/sass/*.css
+lms/static/themed_sass/
+cms/static/css/
+cms/static/sass/*.css
+cms/static/sass/*.css.map
+cms/static/themed_sass/
+themes/**/css
+
+### Logging artifacts
+log/
+logs
+chromedriver.log
+ghostdriver.log
+
+### Celery artifacts ###
+celerybeat-schedule
+
+### Unknown artifacts
+database.sqlite
+courseware/static/js/mathjax/*
+flushdb.sh
+build
+/src/
+\#*\#
+.env/
+openedx/core/djangoapps/django_comment_common/comment_client/python
+autodeploy.properties
+.ws_migrations_complete
+dist
+*.bak
+
+# Visual Studio Code
+.vscode
+
+# Locally generated PII reports
+pii_report

.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+default_language_version:
+  # default language version for each language
+  python: python3.8
+repos:
+  -   repo: https://github.com/ambv/black
+      rev: 21.7b0
+      hooks:
+      - id: black
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.0.1
+    hooks:
+      # See https://pre-commit.com/hooks.html for more hooks
+      - id: check-ast
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: end-of-file-fixer
+      #- id: name-tests-test
+      #  args: [ "--django" ]
+      - id: trailing-whitespace
+  -   repo: https://gitlab.com/pycqa/flake8
+      rev: 3.9.2
+      hooks:
+        - id: flake8

README.md

@@ -0,0 +1,174 @@
+# example Open edX Plugin
+
+[![hack.d Lawrence McDaniel](https://img.shields.io/badge/hack.d-Lawrence%20McDaniel-orange.svg)](https://lawrencemcdaniel.com)
+
+
+
+## Implements the following:
+
+### lms.example.edu Configuration API
+
+Assigns the example api server to use for the Open edX instance on which this plugin is installed.
+The api endpoint is: https://lms.example.edu/example/api/v1/configuration
+
+source code is located in openedx_plugin/api/
+
+Uses this Django model: https://lms.example.edu/admin/openedx_plugin/configuration/
+
+
+public url to the api: https://lms.example.edu/example/api/v1/configuration
+
+
+### Wordpress CTA links
+
+Provides a means to embed localization information about the user in CTA buttons that send the user from Wordpress to Open edX. The most common url presently is: https://lms.example.edu/example/dashboard?language=es-419
+
+source code is located in openedx_plugin/dashboard/
+
+### Localized Marketing Links
+
+The reverse case. Provides a generalized way to seamlessly map the user from the LMS to the most sensible marketing site. An example usage is the "Discover New" link in the LMS site header. The url, assigned inside lms.yml within MKTG_URL_OVERRIDES is, https://lms.example.edu/example/marketing-redirector/?example_page=learning-content/ and will redirect to https://example.org/learning-content/ for a US-based user.
+
+Uses this Django model: https://lms.example.edu/admin/openedx_plugin/marketingsites/
+
+
+### Localized html anchor tags
+
+Same as above, but for html anchor tags. In addition to the URL mapping, these also require language translation of the text of the html element value, bearing in mind that we need to avoid changes to the edx-platform po files since we do not want to fork the edx-platform repo.
+
+Uses this Django model: https://lms.example.edu/admin/openedx_plugin/locale/
+
+An example usage would be the "Blog" and "Privacy Policy" links in the LMS site footer. The following is added to the Mako template:
+
+```
+<%!
+  from openedx_plugin.locale.utils import anchor, language_from_request
+%>
+
+<%
+
+  # figure out the best language code to use based on whatever we
+  # know about this user.
+  try:
+    preferred_language = language_from_request(request) or 'en'
+  except:
+    preferred_language = 'en'
+
+  # get a Python dict containing the url and element text.
+  blog_dict = anchor('example-locale-blog', preferred_language)
+%>
+
+```
+
+and the link itself would take the form
+
+```
+    <a id="example-locale-blog" href="${blog_dict.get('url')}">${blog_dict.get('value')}</a>
+```
+
+
+
+## Getting Started
+
+### Install
+
+#### Native
+
+```bash
+# where github-plugin is defined in .ssh/config
+git clone git@github-plugin:Turn-The-Bus/example-openedx-plugin.git -b main  /home/ubuntu/openedx_plugin
+
+sudo -H -u edxapp bash
+source /edx/app/edxapp/edxapp_env
+source /edx/app/edxapp/venvs/edxapp/bin/activate
+pip install /home/ubuntu/openedx_plugin
+```
+
+```python
+# DO NOT!! add this near the bottom of /edx/app/edxapp/edx-platform/lms/envs/common.py
+
+# NO! NO! NO! NO! NO! NO! NO! NO! NO! NO! NO! NO!
+INSTALLED_APPS.extend('openedx_plugin')    # DO NOT DO THIS!!!!!!
+# NO! NO! NO! NO! NO! NO! NO! NO! NO! NO! NO! NO!
+
+# it turns out that Open edX finds this package of its own accord.
+# magical!!! :O
+```
+
+
+```bash
+# to run tests
+sudo -H -u edxapp bash
+source /edx/app/edxapp/edxapp_env
+source /edx/app/edxapp/venvs/edxapp/bin/activate
+pip install -r requirements/edx/testing.txt
+cd ~/edx-platform
+./manage.py lms test openedx_plugin --settings=test
+```
+
+
+### Local development
+
+* Use the same virtual environment that you use for edx-platform
+* Set your Python interpreter to 3.8x
+* install black: https://pypi.org/project/black/
+* install flake8: https://flake8.pycqa.org/en/latest/
+
+```bash
+# Run these from within your edx-platform virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
+cd /path/to/edx-platform
+pip install -r requirements/edx/base.txt
+pip install -r requirements/edx/coverage.txt
+pip install -r requirements/edx/development.txt
+pip install -r requirements/edx/pip-tools.txt
+pip install -r requirements/edx/testing.txt
+pip install -r requirements/edx/doc.txt
+pip install -r requirements/edx/paver.txt
+
+pip install pre-commit black flake8
+pre-commit install
+```
+
+### Local development good practices
+
+* run `black` on modified code before committing.
+* run `flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics`
+* run `flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics`
+* run `pre-commit run --all-files` before pushing. see: https://pre-commit.com/
+
+#### edx-platform dependencies
+
+To avoid freaky version conflicts in prod it's a good idea to install all of the edx-platform requirements to your local dev virtual environment.
+
+* requirements/edx/base.txt
+* requirements/edx/develop.txt,
+* requirements/edx/testing.txt
+
+At a minimum this will give you the full benefit of your IDE's linter.
+
+#### Notes regarding development with macOS M1
+
+1. To avoid problems with installing the edx-platform requirements, create your virtual environment with Python >= 3.9.x using the native installer from https://www.python.org/. `which python` should return `/Library/Frameworks/Python.framework/Versions/3.9/bin/python3`. Ignoring this advise will lead to very weird side effects. Note that this is true even though Lilac actually runs on Python 3.8.x
+
+2. Best to install openssl, openblas, zstd, mysql, and mysql-client with Brew. Using brew helps you avoid problems with gcc compilations and linking that have proven problematic on early releases of macOS 11 on M1. If you run into problems while pip installing mysql-client / MongoDBProxy / mongoengine/ pymongo /numpy / scipy / matplotlib then analyze the stack trace for any other straggling dependencies that I might have ommitted here that might also break due to the gcc compiler or linker, and try installing these instead with Brew.
+
+3. In addition to launching your virtual environment it also helps to set the following environment variables in your terminal window. Make sure you pay attention to any further suggestions echoed in Brew installation output:
+
+```bash
+export OPENBLAS=/opt/homebrew/opt/openblas/lib/
+export LDFLAGS="-L/opt/homebrew/opt/openblas/lib -L/opt/homebrew/opt/mysql-client/lib"
+export CPPFLAGS="-I/opt/homebrew/opt/openblas/include -I/opt/homebrew/opt/mysql-client/include"
+export PKG_CONFIG_PATH="/opt/homebrew/opt/openblas/lib/pkgconfig /opt/homebrew/opt/mysql-client/lib/pkgconfig"
+```
+
+
+### Shell Plus and iPython
+
+The example_edxapi module adds ipython and django-extensions to the stack.  It is then possible to get an enhanced shell via:
+
+```
+tutor local exec lms ./manage.py lms shell_plus
+```