.. _index:
.. module:: django-vue-utilities

Django Vue Utilities
**********************

|PyPI version|_ |Build status|_

.. |PyPI version| image::
   https://badge.fury.io/py/django-vue-utilities.svg
.. _PyPI version: https://pypi.python.org/pypi/django-vue-utilities

.. |Build status| image::
   https://travis-ci.org/ilikerobots/django-vue-utilities.svg?branch=master
.. _Build status: https://travis-ci.org/ilikerobots/django-vue-utilities

**Django Vue Utilities** is a `Django <https://www.djangoproject.com/>`_ `template tag <https://docs.djangoproject.com/en/1.11/howto/custom-template-tags/>`_ collection for use with a Vue integration as described in `Cookiecutter Vue + Django <https://github.com/ilikerobots/cookiecutter-vue-django>`_

* `Package distribution <https://pypi.python.org/pypi/django-vue-utilities>`_
* `Code repository <https://github.com/ilikerobots/django-vue-utilities>`_
* `Documentation <https://django-vue-utilities.readthedocs.io/>`_
* `Tests <https://travis-ci.org/ilikerobots/django-vue-utilities>`_

Install
=======

.. code-block:: bash

   $ pip install django-vue-utilities

Add to ``settings.py``.

.. code-block:: python

   INSTALLED_APPS = [
       # ...
       'django_vue_utilities',
   ]

Usage
=====

.. code-block:: django

   {% load vue_utils %}

   {% block extra_js %}
    {# Import entrypoint JavaScript, choosing dev or static source depending on settings #}
    <script type="module" crossorigin src="{% vue_bundle_url 'my_vue_entrypoint' %}"></script>

    {# 'provide" strings which can 'injected' throughout the Vue app, including from within a pinia store #}
    {% url 'home' as homeUrl %}
    {% vue_provide 'homeUrl' homeUrl %}
   {% endblock %}

Contents
========

.. toctree::
   :maxdepth: 2

   install
   settings
   usage
   documentation
   tests


Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`
