Metadata-Version: 2.1
Name: honeyshare
Version: 0.1.1
Summary: Python API client for HoneyShare.live
License: MIT
Author: Pedro Melgueira
Author-email: pedromelgueira@gmail.com
Requires-Python: >=3.10,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: requests (>=2.32.4,<3.0.0)
Description-Content-Type: text/markdown

# HoneyShareLib

The [HoneyShare](https://honeyshare.live/) API Client.

## Installing

Available in [PYPI](https://pypi.org/project/honeyshare/).

    pip install honeyshare

## Usage

Initialize HoneyShare with a [Key](https://honeyshare.live/licenses):

    from honeyshare import HoneyShare

    hs = HoneyShare(key="Your HoneyShare Key"")

The library is organized around the four HoneyShare objects:

    hs.Blacklist.ipv4s()     // Blacklists of IPs
    hs.Blacklist.hostnames() // Blacklists of Hostnames

    hs.IPv4.list()               // IP list
    hs.IPv4(ip).ipv4()           // IP's meta data
    hs.IPv4(ip).ports()          // Ports accessed by IP
    hs.IPv4(ip).hostnames()      // Hostnames of IP
    hs.IPv4(ip).timeseries()     // Timeseries of IP
    hs.IPv4(ip).timeseries(port) // Timeseries of IP on Port
    hs.IPv4(ip).bytes(port)      // Bytes sent by IP on Port

    hs.Hostname.list()               // Hostname list
    hs.Hostname(hostname).hostname() // Hostname's meta data
    hs.Hostname(hostname).ipv4()     // IPs of Hostname

    hs.Port.list()          // List of Ports
    hs.Port(port).port()    // Port's meta data
    hs.Port(port).ipv4()    // IP's that acceed port
    hs.Port(port).ipv4(ip)  // IP's meta data on Port
    hs.Port(port).bytes(ip) // Bytes sent by IP on Port

## Building and Installing Locally

    poetry build
    pip install --force-reinstall dist/honeyshare-*.whl

