Metadata-Version: 2.1
Name: VWS-CLI
Version: 2021.12.15
Summary: 'A CLI for the Vuforia Web Services (VWS) API.'
Home-page: https://github.com/VWS-Python/vws-cli
Author: Adam Dangoor
Author-email: adamdangoor@gmail.com
License: MIT License
Keywords: vuforia vws cli
Platform: UNKNOWN
Classifier: Operating System :: POSIX
Classifier: Environment :: Web Environment
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 5 - Production/Stable
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: PyYAML (==6.0)
Requires-Dist: VWS-Python (==2021.3.28.2)
Requires-Dist: click (==8.0.3)
Requires-Dist: setuptools-scm (==6.3.2)
Requires-Dist: wrapt (==1.13.3)
Provides-Extra: dev
Requires-Dist: Sphinx-Substitution-Extensions (==2020.9.30.0) ; extra == 'dev'
Requires-Dist: VWS-Python-Mock (==2021.3.27.1) ; extra == 'dev'
Requires-Dist: VWS-Test-Fixtures (==2021.11.5.1) ; extra == 'dev'
Requires-Dist: autoflake (==1.4) ; extra == 'dev'
Requires-Dist: black (==21.12b0) ; extra == 'dev'
Requires-Dist: check-manifest (==0.47) ; extra == 'dev'
Requires-Dist: doc8 (==0.10.1) ; extra == 'dev'
Requires-Dist: docker (==5.0.3) ; extra == 'dev'
Requires-Dist: flake8-commas (==2.1.0) ; extra == 'dev'
Requires-Dist: flake8-quotes (==3.3.1) ; extra == 'dev'
Requires-Dist: flake8 (==4.0.1) ; extra == 'dev'
Requires-Dist: freezegun (==1.1.0) ; extra == 'dev'
Requires-Dist: furo (==2021.11.23) ; extra == 'dev'
Requires-Dist: homebrew-pypi-poet (==0.10.0) ; extra == 'dev'
Requires-Dist: isort (==5.10.1) ; extra == 'dev'
Requires-Dist: mypy (==0.910) ; extra == 'dev'
Requires-Dist: pip-check-reqs (==2.3.2) ; extra == 'dev'
Requires-Dist: pydocstyle (==6.1.1) ; extra == 'dev'
Requires-Dist: pygithub (==1.55) ; extra == 'dev'
Requires-Dist: pylint (==2.12.2) ; extra == 'dev'
Requires-Dist: pyroma (==3.2) ; extra == 'dev'
Requires-Dist: pytest-cov (==3.0.0) ; extra == 'dev'
Requires-Dist: pytest (==6.2.5) ; extra == 'dev'
Requires-Dist: sphinx-click (==3.0.2) ; extra == 'dev'
Requires-Dist: sphinx (==4.3.1) ; extra == 'dev'
Requires-Dist: sphinx-inline-tabs (==2021.8.17b10) ; extra == 'dev'
Requires-Dist: sphinxcontrib.spelling (==7.3.0) ; extra == 'dev'
Requires-Dist: types-freezegun (==1.1.3) ; extra == 'dev'
Requires-Dist: types-setuptools (==57.4.4) ; extra == 'dev'
Requires-Dist: types-PyYAML (==6.0.1) ; extra == 'dev'
Requires-Dist: vulture (==2.3) ; extra == 'dev'
Provides-Extra: packaging
Requires-Dist: PyInstaller (==4.7) ; extra == 'packaging'

|Build Status| |codecov| |PyPI| |Documentation Status|

vws-cli
=======

A CLI for `Vuforia Web Services`_.

.. _Vuforia Web Services: https://library.vuforia.com/articles/Solution/How-To-Use-the-Vuforia-Web-Services-API

.. contents::
   :local:

Installation
------------

With `pip`
^^^^^^^^^^

Requires Python 3.9+.

.. code:: sh

   pip install VWS-CLI

With Homebrew (macOS, Linux, WSL)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Requires `Homebrew`_.

.. code:: sh

   brew tap VWS-Python/vws
   brew install vws-cli

.. _Homebrew: https://docs.brew.sh/Installation

Pre-built Linux binaries
^^^^^^^^^^^^^^^^^^^^^^^^

See the `full documentation`_ for details on how to install pre-built Linux binaries.

.. _full documentation: https://vws-cli.readthedocs.io/en/latest/install.html#pre-built-linux-binaries

Usage example
-------------

.. code:: sh

   $ vws add-target \
       --server-access-key $SERVER_ACCESS_KEY \
       --server-secret-key $SERVER_SECRET_KEY \
       --name my_image_name \
       --width 2 \
       --image ~/Documents/my_image.png \
       --application-metadata $(echo "my_metadata" | base64) \
       --active-flag true
   03b99df0-78cf-4b01-b929-f1860d4f8ed1
   $ vws --help
   ...
   $ vuforia-cloud-reco my_image.jpg \
       --max-num-results 5 \
       --include-target-data none
   - target_id: b60f60121d37418eb1de123c381b2af9
   - target_id: e3a6e1a216ad4df3aaae1f6dd309c800
   $

Full documentation
------------------

See the `full documentation <https://vws-cli.readthedocs.io/en/latest>`__ for information on:

* All available commands.
* Setting up autocompletion.
* How to contribute to this project.
* Release notes.

.. |Build Status| image:: https://github.com/VWS-Python/vws-cli/workflows/CI/badge.svg
   :target: https://github.com/VWS-Python/vws-cli/actions
.. |codecov| image:: https://codecov.io/gh/VWS-Python/vws-cli/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/VWS-Python/vws-cli
.. |Documentation Status| image:: https://readthedocs.org/projects/vws-cli/badge/?version=latest
   :target: https://vws-cli.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status
.. |PyPI| image:: https://badge.fury.io/py/VWS-CLI.svg
   :target: https://badge.fury.io/py/VWS-CLI


