Metadata-Version: 2.1
Name: kurl
Version: 0.0.4
Summary: Konnection URL
Home-page: https://github.com/pyrustic/kurl
Author: Pyrustic Evangelist
Author-email: pyrustic@protonmail.com
Maintainer: Pyrustic Evangelist
Maintainer-email: pyrustic@protonmail.com
License: MIT
Keywords: library,fetching-resources,api,json,url,pyrustic
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

<!-- Intro Text -->
# Kurl
<b> Konnection URL </b>

This project is part of the [Pyrustic Ecosystem](https://pyrustic.github.io).

<!-- Quick Links -->
[Installation](#installation) | [Reference](https://github.com/pyrustic/kurl/tree/master/docs/reference#readme)


`Kurl` is a library to fetch resources with an implementation of conditional request and a smart responses caching system. It is used by [Hubstore](https://github.com/pyrustic/hubstore) and more projects in the [Pyrustic Open Ecosystem](https://pyrustic.github.io).

This is a simple usage example:

```python
from kurl import Kurl


kurl = Kurl()
response = kurl.request("https://api.github.com/zen")

print(response.headers)
# output: [('Server', 'GitHub.com'), ...,  ('connection', 'close')]

print(response.body)
# output: b'Avoid administrative distraction.'

print(response.error_reason)
# output: None

print(response.json)
# output: None

```

Read the [reference](https://github.com/pyrustic/kurl/tree/master/docs/reference#readme) !

## Installation

```bash
pip install kurl
```


