Metadata-Version: 2.4
Name: trame-gwc
Version: 0.2.0
Summary: Trame wrapper to girder_web_components
Author: Kitware Inc.
License: Apache License 2.0
License-File: LICENSE
Keywords: Application,Framework,Interactive,Python,Web
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: trame-client<4,>=3.4
Provides-Extra: dev
Requires-Dist: pre-commit; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: examples
Requires-Dist: trame; extra == 'examples'
Requires-Dist: trame-vuetify; extra == 'examples'
Description-Content-Type: text/x-rst

Girder Web Components for trame
==================================

trame-gwc extend trame **widgets** with components that can be used to authenticate to girder and to manage files, jobs and accesses.
It leverages `girder_web_components <https://github.com/girder/girder_web_components>`_.

|screenshot|

Installing
-----------------------------------------------------------

trame-gwc can be installed with `pip <https://pypi.org/project/trame-gwc/>`_:

.. code-block:: bash

    pip install --upgrade trame-gwc


Usage
-----------------------------------------------------------

The `Trame Tutorial <https://kitware.github.io/trame/guide/tutorial>`_ 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.


License
-----------------------------------------------------------

trame-gwc is made available under the Apache License.
For more details, see `LICENSE <https://github.com/Kitware/trame-gwc/blob/main/LICENSE>`_. This license has been chosen to match the one use by `girder_web_components <https://github.com/girder/girder_web_components>` which can be exposed via this library.

Community
-----------------------------------------------------------

`Trame <https://kitware.github.io/trame/>`_ | `Discussions <https://github.com/Kitware/trame/discussions>`_ | `Issues <https://github.com/Kitware/trame/issues>`_ | `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>`_.


Development
-----------------------------------------------------------

Build and install the Vue components (see `vue-components/README.md <https://github.com/Kitware/trame-gwc/blob/main/vue-components/README.md>`_)

.. code-block:: console

    cd vue-components
    npm i
    npm run build
    cd -

Install the application for development

.. code-block:: console

    pip install -e .

Example
-----------------------------------------------------------

Try the `demo app <https://github.com/Kitware/trame-gwc/blob/main/examples/demo.py>`_. The default Girder API is `data.kitware.com <https://data.kitware.com/>`_.

.. code-block:: console

    pip install ".[examples]"
    python examples/demo.py

.. |screenshot| image:: examples/screenshots/demo.png


JavaScript dependency
-----------------------------------------------------------

This Python package bundle the ``@girder/components@3.2.0`` JavaScript library. If you would like us to upgrade it, `please reach out <https://www.kitware.com/trame/>`_.
