Prerelease version 0.5.0 (#13)

* Refactor Pipe component so that the uid property is set per-js-instance and not per-py-instance. As a consequence it is no longer a first-class plotly dash property

* Added plotly_dash settings, and use within routing and templates

* Localised pipe websocket endpoint name determination

* Remove unneeded global declaration

* Suppress extra gc steps in favour of updating underlying packages

* Relocate channels routing for all non-http dpd purposes

* Added http endpoint to pass messages on to widgets

* Added authorisation to routing:

* Tidied up http consumer

* Added django_redis - dev requirements requires a refresh:

* Demo four now working with component uid generation and redis for caching inside django for demo. Out-of-band calls to update now handled cleanly with an empty response.

* Removed older connected demo code and objects

* Trimmed dev requirements list

* Tidy up requirements

* More tweaking of demo apps

* Changed settings code to correctly locate plotly dash component modules

* Added initial testing files

* Separate demo and dpd linting and testing, and some linter-suggested changes

* Added demo linting, and extended demo tests to pull in the main dpd test suite

* Progress towards some testing of demo infrastructure

* Add code coverage of demo and linter suggestions, leaving just the plotly_apps demo code to fix for both of these

* Linter now at 9.92 out of 10, with a single fixme for the code coverage extension to the callbacks

* Fix simpler dpd files for linter issues

* Code improvements driven by pylint output

* Moved to standard pylintrc config file

* IMproved code based on linter output. Linter scores now above 9.8, and remaining issues are due to TODO in code

* Relocate channels-dependent function to allow non-channels-use of django_plotly_dash

* Import tweak

* Minor readme tweaks

* Test improvements

* Fix up bad URL

* Another small step towards adequate test coverage. Now at 50 pc of code

* Updated documentation to cover configuration and installation of channels and redis

* More developer-level documentation

* More documentation, and reset python version to 3.5

* Added a faq and some related documentation points

* More development documentation

* More release instructions in development documentation

* Remove redundant instructions

* Rounded out first draft of development documentation

* Add in live updating document chapter

* More documentation

* More documentation tweaks

* Revise use of PLOTLY_DASH configuration settings, along with associated tests and documentation

* Added configuration option to control insertion of demo data

* Added test for migration flag

* More testing of the demo app

* App update through POST request

Added test to check app updating through a post request to a demo model instance.
Both stateless and stateful routes are used.

* Fix up indentation to appease linter

* Added use of click timestamp to demo, and expanded DjangoDash to add in bootstrap css

* Clean up demo code for linter happiness

* Improved demo somewhat, now outputs a plotly graph

* More polishing of demo four

* Extend to another colour

* More finishing on demo four

* Bump version to 0.5.0

Fix setup to include template and migration directories.
Bump version number to 0.5.0
Remove outdated template.

Author: delsim

.gitignore

@@ -101,3 +101,6 @@ ENV/
 
 # mypy
 .mypy_cache/
+
+# testing
+.pytest_cache/

MANIFEST.in

@@ -0,0 +1 @@
+recursive-include django_plotly_dash/templates *.html

README.md

@@ -1,6 +1,6 @@
 # django-plotly-dash
 
-Expose [plotly dash](https://plot.ly/products/dash/) apps as [Django](https:://www.djangoproject.com/) tags. Multiple Dash apps can
+Expose [plotly dash](https://plot.ly/products/dash/) apps as [Django](https://www.djangoproject.com/) tags. Multiple Dash apps can
 then be embedded into a single web page, persist and share internal state, and also have access to the
 current user and session variables.
 
@@ -31,6 +31,10 @@ Then, just add `django_plotly_dash` to `INSTALLED_APPS` in your Django `settings
 
 Note that this package requires version 2.0 or greater of Django, due to the use of the `path` function for registering routes.
 
+Live updating of applications, to share application
+state, requires further
+configuration. See the [online documentation](https://django-plotly-dash.readthedocs.io/en/latest/) for more details.
+
 ## Demonstration
 
 The source repository contains a demo application. To clone the repo and lauch the demo:
@@ -43,6 +47,10 @@ cd django-plotly-dash
 ./make_env                # sets up a virtual environment for development
                           #   with direct use of the source code for the package
 
+./prepare_redis           # downloads a redis docker container
+                          #   and launches it with default settings
+                          #   *THIS STEP IS OPTIONAL*
+
 ./prepare_demo            # prepares and launches the demo
                           #   using the Django debug server at http://localhost:8000
 ```
@@ -107,3 +115,12 @@ The registration code needs to be in a location
 that will be imported into the Django process before any model or template tag attempts to use it. The example Django application
 in the demo subdirectory achieves this through an import in the main `urls.py` file; any `views.py` would also be sufficient.
 
+Whilst this example allows for the direct use of existing `Dash` applications, it does not provide for the sharing or updating of
+internal state. The [online documentation](https://django-plotly-dash.readthedocs.io/en/latest/) provides details on using these
+and other additional features.
+
+## Development
+
+The `make_env` script sets up the development environment, and pulls in the packages
+specified in the `dev_requirements.txt` file. The `check_code` script invokes the test suite (using `pytest`) as well
+as invoking `pylint` on both the package and the associated demo.

check_code

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+#
+./check_code_dpd
+./check_code_demo
+#
+

check_code_demo

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+source env/bin/activate
+pushd demo
+pylint demo --rcfile=../pylintrc
+pytest demo --cov=demo --cov=django_plotly_dash --cov-report term-missing
+popd

check_code_dpd

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+#
+source env/bin/activate
+#
+pylint django_plotly_dash

demo/demo/asgi.py

@@ -1,8 +1,11 @@
+'Configure asgi server for serving asynchronous content such as websockets'
+
 import os
 import django
 from channels.routing import get_default_application
 
 os.environ.setdefault("DJANGO_SETTINGS_MODULE", "demo.settings")
+
 django.setup()
-application = get_default_application()
 
+application = get_default_application()