Metadata-Version: 2.1
Name: blackduck
Version: 0.0.38
Summary: Package for using the Synopsys Black Duck Hub REST API.
Home-page: https://github.com/blackducksoftware/hub-rest-api-python
Author: Glenn Snyder
Author-email: gsnyder@synopsys.com
License: Apache
Keywords: api
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Requires-Dist: requests


## Overview ##
The hub-rest-api-python provides Python bindings for Hub REST API.

## To use

```
pip install blackduck
```

```python
from blackduck.HubRestApi import HubInstance
import json

username = "sysadmin"
password = "your-password"
urlbase = "https://ec2-34-201-23-208.compute-1.amazonaws.com"

hub = HubInstance(urlbase, username, password, insecure=True)

projects = hub.get_projects()

print(json.dumps(projects.get('items', [])))
```

### Examples

Example code showing how to do various things can be found in the *examples* folder. 

## Build ##

You should be using [virtualenv](https://pypi.org/project/virtualenv/), [virtrualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/) to make things easy on yourself.

Ref: [Packaging Python Projects Tutorial](https://packaging.python.org/tutorials/packaging-projects/)

### Build the blackduck packages
To build both the source distribution package and the wheel package,

```
pip3 install -r requirements.txt
python3 setup.py sdist bdist_wheel
```

### Distribute the package

Requires you have an account on either/both [PyPi](https://pypi.org) and [Test PyPi](https://test.pypi.org) *AND* you must be a package maintainer.

Send a request to gsnyder@synopsys.com or gsnyder2007@gmail.com if you want to be listed as a package maintainer.

#### To PyPi

Upload to PyPi,

```
twine upload dist/*
```

Then try installing it from PyPy

```
pip install blackduck
```

#### To Test PyPi

Upload to Test PyPi,

```
twine upload --repository-url https://test.pypi.org/legacy/ dist/*
```

Then try installing it from Test PyPy

```
pip install --index-url https://test.pypi.org/simple/ blackduck
```

### Install package locally

Do this when testing a new version.

```
git clone https://github.com/blackducksoftware/hub-rest-api-python.git
cd hub-rest-api-python
pip3 install -r requirements.txt
pip3 install .
```

## Test ##
Using (pytest)[https://pytest.readthedocs.io/en/latest/contents.html]

```bash
git clone https://github.com/blackducksoftware/hub-rest-api-python.git
cd hub-rest-api-python
# optional but advisable: create/use virtualenv
# you should have 3.x+, e.g. Python 3.7.0

pip3 install -r requirements.txt
pip3 install .
cd test
pytest
```

## Where can I get the latest release? ##
This package is available on PyPi,

`pip3 install blackduck`

## Documentation ##
Documentation for hub-rest-api-python can be found on the base project:  [Hub REST API Python Wiki](https://github.com/blackducksoftware/hub-rest-api-python/wiki)




