Metadata-Version: 2.1
Name: itkdb
Version: 0.3.9
Summary: Python wrapper to interface with ITk DB.
Home-page: https://gitlab.cern.ch/atlas-itk/sw/db/itkdb
Author: Giordon Stark
Author-email: gstark@cern.ch
License: UNKNOWN
Keywords: physics itk database wrapper
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
Description-Content-Type: text/markdown
Provides-Extra: develop
Provides-Extra: plotting
Provides-Extra: complete
License-File: LICENSE
License-File: COPYING

# ITk DB

[![PyPI version](https://badge.fury.io/py/itkdb.svg)](https://badge.fury.io/py/itkdb)
[![Downloads](https://pepy.tech/badge/itkdb)](https://pepy.tech/project/itkdb) [![Downloads](https://pepy.tech/badge/itkdb/month)](https://pepy.tech/project/itkdb) [![Downloads](https://pepy.tech/badge/itkdb/week)](https://pepy.tech/project/itkdb)

To install as a user

```
pip install itkdb
```

or if you wish to develop/contribute

```
git clone ...
pip install -e .[develop]
```

or

```
git clone ...
pip install -e .[complete]
```

## Using

Command line available via

```
itkdb --help
```

## Environment Variables

See [itkdb/settings/base.py](src/itkdb/settings/base.py) for all environment variables that can be set. All environment variables for this package are prefixed with `ITKDB_`. As of now, there are:

* `ITKDB_ACCESS_CODE1`: access code #1 for authentication
* `ITKDB_ACCESS_CODE2`: access code #2 for authentication
* `ITKDB_AUTH_URL`: authentication server
* `ITKDB_SITE_URL`: API server
* `ITKDB_CASSETTE_LIBRARY_DIR`: for tests, where to store recorded requests/responses

## Develop

### Bump Version

Run `bump2version x.y.z` to bump to the next version. We will always tag any version we bump, and this creates the relevant commits/tags for you. All you need to do is `git push --tags` and that should be it.

# Examples

```
import itkdb

client = itkdb.Client()
comps = client.get(
    'listComponents', json={'project': 'P', 'pageInfo': {'pageSize': 32}}
)

for i, comp in enumerate(comps):
    print(i, comp['code'])
```


