Metadata-Version: 2.1
Name: lndpy
Version: 0.1.0
Summary: Modern pythonic bindings for the lightning network daemon 
Home-page: https://github.com/yuvadm/lndpy
Author: Yuval Adam
Author-email: _@yuv.al
License: MIT
Project-URL: Bug Tracker, https://github.com/yuvadm/lndpy/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# lndpy

Modern pythonic bindings for the [lightning network daemon (lnd)](https://github.com/lightningnetwork/lnd/).

## Features

- Standard lnd gRPC bindings built natively as part of the CI pipeline from the latest released version. _No more copy-pasta._
- Supports Python 3.6+
- Pythonic interface to auto-generated gRPC functions (coming soon)
- Documentation generated automatically from gRPC binding docs (coming soon)

## Installation

Install as usual with `pip` or any other packaging tool of choice from PyPI:

```bash
$ pip install lndpy
```

### Usage

Example usage:

```python
from lndpy import Lnd
info = Lnd().get_info()
print(info)
```

## Development

`pipenv` is the recommended tool of choice for local development. First, checkout the git repository. Then, create and sync a new virtualenv with the development dependencies:

```bash
$ git clone https://github.com/yuvadm/lndpy
$ cd lndpy
$ pipenv sync --dev
```

As an optional step, install pre-commit hooks:

```bash
$ pipenv run pre-commit install
```

Next, fetch and build the lnd proto files:

```bash
$ pipenv run buildprotos
```

In order to build the gRPC .proto files you will also need https://github.com/googleapis/googleapis checked out next to lndpy.

Run the tests to ensure they were built properly:

```bash
$ pipenv run test
```

## License

[MIT License](LICENSE)

Copyright Ⓒ 2021 Yuval Adam


