Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/froosty/aiorentry
Asynchronous API client for pastebin service https://rentry.co/ (https://rentry.org/)
https://github.com/froosty/aiorentry
markdown pastebin pastebin-client rentry rentryco rentryorg
Last synced: about 2 months ago
JSON representation
Asynchronous API client for pastebin service https://rentry.co/ (https://rentry.org/)
- Host: GitHub
- URL: https://github.com/froosty/aiorentry
- Owner: froosty
- License: mit
- Created: 2024-08-05T09:43:43.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-11-18T17:22:29.000Z (2 months ago)
- Last Synced: 2024-11-18T18:38:49.514Z (2 months ago)
- Topics: markdown, pastebin, pastebin-client, rentry, rentryco, rentryorg
- Language: Python
- Homepage:
- Size: 161 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aiorentry
Asynchronous API client for [rentry.co](https://rentry.co) (mirror: [rentry.org](https://rentry.org))
[](https://codecov.io/gh/froosty/aiorentry)
[](https://pypi.org/project/aiorentry/)
## About
This package allows you to interact with the [rentry.co](https://rentry.co) (or [rentry.org](https://rentry.org)) service.
Rentry.co is a markdown pastebin and publishing service that offers features such as previews, custom URLs, and editing.
**Please note** that this library is not developed by the official authors of rentry.co. It replicates the functionality of the [official console utility](https://github.com/radude/rentry), but provides it as an asynchronous API client. With this package you can manage your pages: create, edit and delete, as well as get data in text, PNG or PDF formats. All directly from your asynchronous Python application.
## Installation
```bash
pip install aiorentry
```
## Setup client
You can setup client in 2 ways:
### As classic object
> [!CAUTION]
> If you prefer the classic way, you should call `await client.setup()` during initialization and `await client.close()` during completion
```python
import asyncio
from aiorentry.client import Client
async def main():
client = Client('https://rentry.co')
await client.setup()
# Your code here
await client.close()
asyncio.run(main())
```
### As async context manager
```python
import asyncio
from aiorentry.client import Client
async def main():
async with Client('https://rentry.co') as client:
# Your code here
asyncio.run(main())
```
## Examples
### Create new page
```python
...
# Create new page
page = await client.new_page(
'## Hello world from awesome API',
)
print(page)
...
```
```bash
Page(url='m2e2wpe8', edit_code='hUHeRUei', text='## Hello world from awesome API')
```
```python
...
# Create new page with custom url and edit_code
awesome_page = await client.new_page(
'## Hello world from awesome API',
url='awesome-url',
edit_code='qwerty=)'
)
print(awesome_page)
...
```
```bash
Page(url='awesome-url', edit_code='qwerty=)', text='## Hello world from awesome API')
```
### Edit page
```python
...
# Edit page
await client.edit_page(
'### Updated Hello world',
url='awesome-url',
edit_code='qwerty=)',
)
...
```
### Delete page
```python
...
# Delete page
await client.delete_page(
url='awesome-url',
edit_code='qwerty=)',
)
...
```
### Get raw page text
```python
...
# Get raw content
content = await client.raw('awesome-url')
print(content)
...
```
```
### Updated Hello world
```
### Get PDF file
```python
...
# Get PDF
with open('page.pdf', mode='wb') as fp:
fp.write(await client.pdf(page.url))
...
```
### Get PNG
```python
...
with open('page.png', mode='wb') as fp:
fp.write(await client.png(page.url))
...
```
## Custom ClientSession
> [!NOTE]
> By default, a new instance of `aiohttp.ClientSession` will be created automatically. So normally you don't need to worry about this.
If you don't want to automatically create the session object inside the client, you can pass an existing `aiohttp.ClientSession` to the client constructor.
> [!CAUTION]
> If you pass an existing session object to the client constructor, then you should care about releasing resources yourself. \
> **The session will not be closed automatically!** Even if the asynchronous context manager was used.
```python
from aiohttp import ClientSession, TCPConnector
from aiorentry.client import Client
connector = TCPConnector(
limit=5, # Just for example
)
session = ClientSession(
connector=connector,
)
async with Client('https://rentry.co', session=session) as client:
# Your code here
async with session.get(...) as response:
# You can still use this session object
```