trame-vuetify: Material Design widgets for trame
===========================================================================
.. image:: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml/badge.svg
:target: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml
:alt: Test and Release
Trame-vuetify extend trame **widgets** and **ui** with all the beautiful Vuetify UI components.
Vuetify is a UI Library with beautifully handcrafted Material Components. No design skills required — everything you need to create amazing applications is at your fingertips.
This package is not supposed to be used by itself but rather should come as a dependency of **trame**.
For any specificity, please refer to `the trame documentation <https://kitware.github.io/trame/>`_.
Installing
-----------------------------------------------------------
trame-vuetify can be installed with `pip <https://pypi.org/project/trame-vuetify/>`_:
.. code-block:: bash
pip install --upgrade trame-vuetify
Usage
-----------------------------------------------------------
The `Trame Tutorial <https://kitware.github.io/trame/docs/tutorial.html>`_ is the place to go to learn how to use the library and start building your own application.
The `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.
The `Vuetify website <https://vuetifyjs.com/en/>`_ is very well made for exploring components and understanding components' parameters and controls, while a reference to our wrapper API is available `here <https://trame-vuetify.readthedocs.io/en/latest/trame.html.vuetify.html>`_.
The way trame translate Vue templates into plain Python code is by doing the following.
Material Design Widgets
```````````````````````````````````````````````````````````
First you need to import the `vuetify` module so you can instantiate the various Material Components like illustrated below. Moreover, in the documentation the component names use dashes as separators while in Python we use the Camelcase notation for the class name.
.. code-block:: python
from trame.widgets import vuetify
# <v-btn>Hello World</v-btn>
btn = vuetify.VBtn("Hello World")
Boolean attributes
```````````````````````````````````````````````````````````
Implicit attribute values must be made explicit in Python by assigning `True` to them.
.. code-block:: python
# <v-text-field disabled />
vuetify.VTextField(disabled=True)
Dash and colon separators
```````````````````````````````````````````````````````````
Any special characters (`-` and `:`) become `_` in Python.
.. code-block:: python
# <v-text-field v-model="myText" />
vuetify.VTextField(v_model=("myText",))
Events
```````````````````````````````````````````````````````````
Events in vue are prefixed with a `@` but in Python we declare them the same way we declare regular attributes.
.. code-block:: python
def runMethod():
pass
# <v-btn @click="runMethod" />
vuetify.VBtn(click=runMethod)
License
-----------------------------------------------------------
trame-vuetify is made available under the MIT License. For more details, see `LICENSE <https://github.com/Kitware/trame-vuetify/blob/master/LICENSE>`_
This license has been chosen to match the one use by `Vuetify <https://github.com/vuetifyjs/vuetify/blob/master/LICENSE.md>`_ which is instrumental for making that library possible.
Community
-----------------------------------------------------------
`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_
.. image:: https://zenodo.org/badge/410108340.svg
:target: https://zenodo.org/badge/latestdoi/410108340
Enjoying trame?
-----------------------------------------------------------
Share your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.
Raw data
{
"_id": null,
"home_page": "",
"name": "trame-vuetify",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Python,Interactive,Web,Application,Framework",
"author": "Kitware Inc.",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/09/6f/941c93ce5d3c401208be7ef3f30befabc84a41e3b32f76516e8c53d229f6/trame-vuetify-2.4.3.tar.gz",
"platform": null,
"description": "trame-vuetify: Material Design widgets for trame\n===========================================================================\n\n.. image:: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml/badge.svg\n :target: https://github.com/Kitware/trame-vuetify/actions/workflows/test_and_release.yml\n :alt: Test and Release\n\nTrame-vuetify extend trame **widgets** and **ui** with all the beautiful Vuetify UI components.\nVuetify is a UI Library with beautifully handcrafted Material Components. No design skills required \u2014 everything you need to create amazing applications is at your fingertips.\n\nThis package is not supposed to be used by itself but rather should come as a dependency of **trame**.\nFor any specificity, please refer to `the trame documentation <https://kitware.github.io/trame/>`_.\n\n\nInstalling\n-----------------------------------------------------------\n\ntrame-vuetify can be installed with `pip <https://pypi.org/project/trame-vuetify/>`_:\n\n.. code-block:: bash\n\n pip install --upgrade trame-vuetify\n\n\nUsage\n-----------------------------------------------------------\n\nThe `Trame Tutorial <https://kitware.github.io/trame/docs/tutorial.html>`_ is the place to go to learn how to use the library and start building your own application.\n\nThe `API Reference <https://trame.readthedocs.io/en/latest/index.html>`_ documentation provides API-level documentation.\n\nThe `Vuetify website <https://vuetifyjs.com/en/>`_ is very well made for exploring components and understanding components' parameters and controls, while a reference to our wrapper API is available `here <https://trame-vuetify.readthedocs.io/en/latest/trame.html.vuetify.html>`_.\n\nThe way trame translate Vue templates into plain Python code is by doing the following.\n\n\nMaterial Design Widgets\n```````````````````````````````````````````````````````````\n\nFirst you need to import the `vuetify` module so you can instantiate the various Material Components like illustrated below. Moreover, in the documentation the component names use dashes as separators while in Python we use the Camelcase notation for the class name.\n\n.. code-block:: python\n\n from trame.widgets import vuetify\n\n # <v-btn>Hello World</v-btn>\n btn = vuetify.VBtn(\"Hello World\")\n\nBoolean attributes\n```````````````````````````````````````````````````````````\n\nImplicit attribute values must be made explicit in Python by assigning `True` to them.\n\n.. code-block:: python\n\n # <v-text-field disabled />\n vuetify.VTextField(disabled=True)\n\n\nDash and colon separators\n```````````````````````````````````````````````````````````\n\nAny special characters (`-` and `:`) become `_` in Python.\n\n.. code-block:: python\n\n # <v-text-field v-model=\"myText\" />\n vuetify.VTextField(v_model=(\"myText\",))\n\n\nEvents\n```````````````````````````````````````````````````````````\n\nEvents in vue are prefixed with a `@` but in Python we declare them the same way we declare regular attributes.\n\n.. code-block:: python\n\n def runMethod():\n pass\n\n # <v-btn @click=\"runMethod\" />\n vuetify.VBtn(click=runMethod)\n\n\nLicense\n-----------------------------------------------------------\n\ntrame-vuetify is made available under the MIT License. For more details, see `LICENSE <https://github.com/Kitware/trame-vuetify/blob/master/LICENSE>`_\nThis license has been chosen to match the one use by `Vuetify <https://github.com/vuetifyjs/vuetify/blob/master/LICENSE.md>`_ which is instrumental for making that library possible.\n\n\nCommunity\n-----------------------------------------------------------\n\n`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `RoadMap <https://github.com/Kitware/trame/projects/1>`_ | `Contact Us <https://www.kitware.com/contact-us/>`_\n\n.. image:: https://zenodo.org/badge/410108340.svg\n :target: https://zenodo.org/badge/latestdoi/410108340\n\n\nEnjoying trame?\n-----------------------------------------------------------\n\nShare your experience `with a testimonial <https://github.com/Kitware/trame/issues/18>`_ or `with a brand approval <https://github.com/Kitware/trame/issues/19>`_.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Vuetify widgets for trame",
"version": "2.4.3",
"project_urls": null,
"split_keywords": [
"python",
"interactive",
"web",
"application",
"framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d3d96d8f6259996d8ee71fcb6b32ad8d50012609617d70106d14b1f1329f21d",
"md5": "e0f827c9655aabcd4e1d029ed00e2a6a",
"sha256": "a3d05d714b78241d61fb5c76f65754e4b26afae67a3667a2daf47b399035f69c"
},
"downloads": -1,
"filename": "trame_vuetify-2.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e0f827c9655aabcd4e1d029ed00e2a6a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 3667998,
"upload_time": "2024-03-13T16:22:35",
"upload_time_iso_8601": "2024-03-13T16:22:35.097020Z",
"url": "https://files.pythonhosted.org/packages/4d/3d/96d8f6259996d8ee71fcb6b32ad8d50012609617d70106d14b1f1329f21d/trame_vuetify-2.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "096f941c93ce5d3c401208be7ef3f30befabc84a41e3b32f76516e8c53d229f6",
"md5": "094da0c3375b42b57996191d7d8b61be",
"sha256": "aa96059cb739244cf023f9af83f6b446e2207ebe3faff33a6f73f34efaf26eb7"
},
"downloads": -1,
"filename": "trame-vuetify-2.4.3.tar.gz",
"has_sig": false,
"md5_digest": "094da0c3375b42b57996191d7d8b61be",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3646155,
"upload_time": "2024-03-13T16:22:37",
"upload_time_iso_8601": "2024-03-13T16:22:37.587468Z",
"url": "https://files.pythonhosted.org/packages/09/6f/941c93ce5d3c401208be7ef3f30befabc84a41e3b32f76516e8c53d229f6/trame-vuetify-2.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-13 16:22:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "trame-vuetify"
}
JSON