A Python REST client library for accessing VisualVault.
Project description
# *vvrest*
A `Python` REST client library for accessing `VisualVault`.
## install
```
pip3 install vvrest
```
## usage
```
from vvrest.vault import Vault
from vvrest.services.document_service import DocumentService
# define credentials
url = 'https://demo.visualvault.com'
customer_alias = 'test_customer'
database_alias = 'test_database'
client_id = '12344b69-cd52-4444-815a-1234ec0fb5ef'
client_secret = 'PouE/GLZ7pjFoqRRyu9L8K3EjTXXdf56sY/FxPaaxxU='
# get vault object (authenticate)
vault = Vault(url, customer_alias, database_alias, client_id, client_secret)
document_service = DocumentService(vault) # instantiate a service class (DocumentService)
documents = document_service.get_documents("folderPath='/test'") # request documents
```
* documentation coming soon.
* refer to the `VVRestTestSuite` in the `tests` directory for more examples.
For more information on any of the endpoints, data types, or anything referring to the
`VisualVault` REST API please refer to the `HTTP API` section at <http://developer.visualvault.com>
where each endpoint and there parameters are covered in great detail.
## unittest coverage
```
Name Stmts Miss Cover Missing
----------------------------------------------------------------------
vvrest/__init__.py 0 0 100%
vvrest/constants.py 30 0 100%
vvrest/services/__init__.py 0 0 100%
vvrest/services/auth_service.py 21 0 100%
vvrest/services/document_service.py 80 0 100%
vvrest/services/email_service.py 11 0 100%
vvrest/services/file_service.py 29 0 100%
vvrest/services/folder_service.py 73 11 85% 99-104, 192-205
vvrest/services/form_service.py 123 95 23% 21, 34-39, 49-58, 68-75, 83-88, 97-106, 115-120, 130-135, 146-151, 160-165, 174-179, 188-193, 202-207, 216-221, 230-235, 244-248, 257-266, 275-284
vvrest/services/group_service.py 49 1 98% 17
vvrest/services/index_field_service.py 30 0 100%
vvrest/services/site_service.py 35 6 83% 76-90
vvrest/services/user_service.py 37 7 81% 17, 60-74
vvrest/token.py 5 0 100%
vvrest/utilities.py 5 0 100%
vvrest/vault.py 33 0 100%
----------------------------------------------------------------------
TOTAL 561 120 79%
```
A `Python` REST client library for accessing `VisualVault`.
## install
```
pip3 install vvrest
```
## usage
```
from vvrest.vault import Vault
from vvrest.services.document_service import DocumentService
# define credentials
url = 'https://demo.visualvault.com'
customer_alias = 'test_customer'
database_alias = 'test_database'
client_id = '12344b69-cd52-4444-815a-1234ec0fb5ef'
client_secret = 'PouE/GLZ7pjFoqRRyu9L8K3EjTXXdf56sY/FxPaaxxU='
# get vault object (authenticate)
vault = Vault(url, customer_alias, database_alias, client_id, client_secret)
document_service = DocumentService(vault) # instantiate a service class (DocumentService)
documents = document_service.get_documents("folderPath='/test'") # request documents
```
* documentation coming soon.
* refer to the `VVRestTestSuite` in the `tests` directory for more examples.
For more information on any of the endpoints, data types, or anything referring to the
`VisualVault` REST API please refer to the `HTTP API` section at <http://developer.visualvault.com>
where each endpoint and there parameters are covered in great detail.
## unittest coverage
```
Name Stmts Miss Cover Missing
----------------------------------------------------------------------
vvrest/__init__.py 0 0 100%
vvrest/constants.py 30 0 100%
vvrest/services/__init__.py 0 0 100%
vvrest/services/auth_service.py 21 0 100%
vvrest/services/document_service.py 80 0 100%
vvrest/services/email_service.py 11 0 100%
vvrest/services/file_service.py 29 0 100%
vvrest/services/folder_service.py 73 11 85% 99-104, 192-205
vvrest/services/form_service.py 123 95 23% 21, 34-39, 49-58, 68-75, 83-88, 97-106, 115-120, 130-135, 146-151, 160-165, 174-179, 188-193, 202-207, 216-221, 230-235, 244-248, 257-266, 275-284
vvrest/services/group_service.py 49 1 98% 17
vvrest/services/index_field_service.py 30 0 100%
vvrest/services/site_service.py 35 6 83% 76-90
vvrest/services/user_service.py 37 7 81% 17, 60-74
vvrest/token.py 5 0 100%
vvrest/utilities.py 5 0 100%
vvrest/vault.py 33 0 100%
----------------------------------------------------------------------
TOTAL 561 120 79%
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
vvrest-1.0.0.tar.gz
(8.3 kB
view hashes)
Built Distribution
vvrest-1.0.0-py3-none-any.whl
(14.8 kB
view hashes)