update quickstart guide

This commit is contained in:
Gonçalo Valério 2019-12-01 00:07:03 +00:00
parent 9b7eadfb31
commit e12a7a8a44
8 changed files with 138 additions and 3 deletions

View File

@ -8,6 +8,7 @@ History
* A default urls.py is provided by the package so can work "out-of-the-box".
* Default location for templates moved to ``django_cryptolock`` folder.
* Updated quickstart guide
0.0.1 (2019-11-25)
++++++++++++++++++

View File

@ -46,6 +46,7 @@ coverage: ## check code coverage quickly with the default Python
open htmlcov/index.html
docs: ## generate Sphinx HTML documentation, including API docs
rm -f docs/django_cryptolock.migrations.rst
rm -f docs/django-cryptolock.rst
rm -f docs/modules.rst
sphinx-apidoc -o docs/ django_cryptolock

View File

@ -35,23 +35,33 @@ Add it to your `INSTALLED_APPS`:
...
)
Migrate your database.
Add Django-Cryptolock's URL patterns:
.. code-block:: python
from django_cryptolock import urls as django_cryptolock_urls
from django.conf.urls import url
urlpatterns = [
...
url(r'^', include(django_cryptolock_urls)),
url(r"^auth/", include("django_cryptolock.urls", namespace="django_cryptolock")),
...
]
Add the following settings to your project:
* ``django_cryptolock.backends.MoneroAddressBackend`` to your ``AUTHENTICATION_BACKENDS``
* Set ``DJCL_MONERO_NETWORK`` with the network in use: ``mainnet``, ``stagenet`` or ``testnet``
* Use ``MONERO_WALLET_RPC_PROTOCOL``, ``MONERO_WALLET_RPC_HOST``, ``MONERO_WALLET_RPC_USER`` and ``MONERO_WALLET_RPC_PASS`` to specify which wallet RPC should be used.
Finaly create the templates files (``login.html`` and ``signup.html``) under a ``django_cryptolock`` subfolder.
Features
--------
* TODO
* Adds authentication based on cryptocurrency wallets a Django project.
Running Tests
-------------

View File

@ -24,6 +24,14 @@ sys.path.append(parent)
import django_cryptolock
# Specify settings module
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "tests.settings")
# Setup Django
import django
django.setup()
# -- General configuration -----------------------------------------------------
# If your documentation needs a minimal Sphinx version, state it here.

View File

@ -0,0 +1,22 @@
django\_cryptolock.migrations package
=====================================
Submodules
----------
django\_cryptolock.migrations.0001\_initial module
--------------------------------------------------
.. automodule:: django_cryptolock.migrations.0001_initial
:members:
:undoc-members:
:show-inheritance:
Module contents
---------------
.. automodule:: django_cryptolock.migrations
:members:
:undoc-members:
:show-inheritance:

View File

@ -0,0 +1,85 @@
django\_cryptolock package
==========================
Subpackages
-----------
.. toctree::
django_cryptolock.migrations
Submodules
----------
django\_cryptolock.apps module
------------------------------
.. automodule:: django_cryptolock.apps
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.backends module
----------------------------------
.. automodule:: django_cryptolock.backends
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.forms module
-------------------------------
.. automodule:: django_cryptolock.forms
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.models module
--------------------------------
.. automodule:: django_cryptolock.models
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.urls module
------------------------------
.. automodule:: django_cryptolock.urls
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.utils module
-------------------------------
.. automodule:: django_cryptolock.utils
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.validators module
------------------------------------
.. automodule:: django_cryptolock.validators
:members:
:undoc-members:
:show-inheritance:
django\_cryptolock.views module
-------------------------------
.. automodule:: django_cryptolock.views
:members:
:undoc-members:
:show-inheritance:
Module contents
---------------
.. automodule:: django_cryptolock
:members:
:undoc-members:
:show-inheritance:

7
docs/modules.rst Normal file
View File

@ -0,0 +1,7 @@
django_cryptolock
=================
.. toctree::
:maxdepth: 4
django_cryptolock

View File

@ -3,3 +3,4 @@
bumpversion==0.5.3
wheel==0.30.0
twine==3.1.0
Sphinx==2.2.1