Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Software development kit for the Terbium Labs Matchlight product.

Project Description

Matchlight Python SDK
=====================

.. image:: https://img.shields.io/travis/TerbiumLabs/python-matchlightsdk.svg
:target: https://travis-ci.org/TerbiumLabs/python-matchlightsdk

.. image:: https://img.shields.io/coveralls/TerbiumLabs/python-matchlightsdk.svg
:target: https://coveralls.io/r/TerbiumLabs/python-matchlightsdk

.. image:: https://img.shields.io/pypi/pyversions/matchlightsdk.svg
:target: https://pypi.python.org/pypi/matchlightsdk/

Matchlight exists to quickly and privately alert its users when any of their
sensitive information appears for sale or vandalism out on the dark web. The
product is fully automated, and operates using Data Fingerprints — a one-way
representation that allows Terbium to monitor for client data without
needing to know what that data is.

The Matchlight SDK provides a Python interface to Matchlight's API, allowing
developers to create and retrieve projects, download feeds, create document,
source code, and PII records, and perform searches.

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

Matchlight SDK is supported on Python 2.7, 3.3, 3.4, and 3.5. To install the
SDK, you'll need `pip <https://pip.pypa.io/en/stable/>`_::

$ pip install matchlightsdk

Documentation
-------------

A walkthrough of the SDK features and API documentation is available at
https://python-matchlightsdk.readthedocs.io.

License
-------

The Matchlight Python SDK source code is licensed under the
`3-clause BSD License <https://opensource.org/licenses/BSD-3-Clause>`_. For
more information, please see the LICENSE file included in this repository or
source distribution.

Contributing
------------

Bug reports and pull requests are welcome. If you would like to contribute,
please create a pull request against **master**. Include unit tests if
necessary, and ensure that your code passes all linters (see tox.ini).

**Building**

First, install all requirements::

$ make requirements

Then::

$ make build

**Tests**

To run tests, install test requirements::

$ make dev_requirements

You will also need to install Pyenv https://github.com/pyenv/pyenv#installation
The easiest way is with Homebrew::
$ brew update
$ brew install pyenv

NOTE: Make sure that pyenv is added to your path

Then::

$ make test

**Update Requirements**

If you made a change that adds a new requirement, add it to the correct file in 'requirements/src'.
Then update the requirements file::

$ pip-compile --output-file requirements/<file>.txt requirements/src/<file>.in

**Update Documentation**

To update the documentation::

$ make docs

To preview changes::

$ make serve docs



Release history Release notifications

This version
History Node

2018.2.6

History Node

2018.2.1.1

History Node

2017.9.15

History Node

2017.7.26

History Node

2017.5.8

History Node

2017.1.23

History Node

2016.10.5

History Node

2016.10.4

History Node

2016.9.21

History Node

2016.9.16

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
matchlightsdk-2018.2.6-py2.py3-none-any.whl (1.0 MB) Copy SHA256 hash SHA256 Wheel py2.py3 Feb 5, 2018
matchlightsdk-2018.2.6.tar.gz (1.1 MB) Copy SHA256 hash SHA256 Source None Feb 5, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page