Metadata-Version: 2.1
Name: marquez-python
Version: 0.36.0
Summary: Marquez Python Client
Home-page: UNKNOWN
Author: Marquez Project
License: UNKNOWN
Keywords: marquez
Platform: UNKNOWN
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: tests
Provides-Extra: dev

# Marquez Python Client

Python client for [Marquez](https://github.com/MarquezProject/marquez).

## Documentation

See the [API docs](https://marquezproject.github.io/marquez/openapi.html).

## Requirements

* [Python 3.6](https://www.python.org/downloads)+

## Installation

```bash
$ pip3 install marquez-python
```

To install from source run:

```bash
$ python3 setup.py install
```

## Usage

### Reading Metadata
```python
from marquez_client import MarquezClient

client = MarquezClient(url='http://localhost:5000')

# list namespaces
client.list_namespaces()
```

To enable logging, set the environment variable `MARQUEZ_LOG_LEVEL` to `DEBUG`, `INFO`, or `ERROR`:

```
$ export MARQUEZ_LOG_LEVEL='INFO'
```

### Writing Metadata
To collect OpenLineage events using Marquez, please use the [openlineage-python](https://pypi.org/project/openlineage-python/) library. OpenLineage is an Open Standard for lineage metadata collection designed to collect metadata for a job in execution.

## Development

To install all dependencies for _local_ development:

```bash
$ pip3 install -e .[dev]
```

To run the entire test suite:

```bash
$ pytest
```

----
SPDX-License-Identifier: Apache-2.0 
Copyright 2018-2023 contributors to the Marquez project.

