Metadata-Version: 2.1
Name: interactions-transcript
Version: 0.0.3
Summary: An extension library for interactions.py to create transcripts.
Home-page: https://github.com/ItsRqtl/interactions-transcript
Author: ItsRqtl
Author-email: itsrqtl@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8.6
Description-Content-Type: text/markdown
License-File: LICENSE

# interactions-transcript

This project is a improved version of [mahtoid's DiscordChatExporterPy library](https://github.com/mahtoid/DiscordChatExporterPy), ported to an extension of interactions.py, another Discord API wrapper, with extra features.  

WIP: This extension is currently work-in-progress, which means it might not function well  

## Installation

### Install from PyPi

```bat
pip install interactions-transcript
```

### Install from github

```bat
pip install git+https://github.com/ItsRqtl/interactions-transcript.git
```

### Build from source

```bat
git clone https://github.com/ItsRqtl/interactions-transcript.git
cd interactions-transcript
pip install .
```

## Usage

### Loading the extension

```py
from interactions import Client

client = Client(token="...")

client.load("interactions.ext.transcript")

client.start()
```

### Using the extension

```py
await Channel.get_transcript(limit=...)
```

### Another way to use

```py
from interactions import Client
from interactions.ext.transcript import get_transcript
...
await get_transcript(Channel, limit=...)
...
client.start()
```

Parameters of method `get_transcript`:

|Parameter|Type|Description|Default Value|
|---|---|---|---|
|channel|`interactions.Channel`|The channel to get transcript from||
|limit|`int`|The limit of messages to get|`100`|
|pytz_timezone|`str`|The timezone to use|`"UTC"`|
|military_time|`bool`|Whether to use military time or not|`False`|
|fancy_time|`bool`|Whether to use fancy time or not (only with html mode)|`False`|
|mode|`str`|The mode to use for the transcript (html, json, csv, or plain)|`"html"`|

## Attributions

This project uses a modified version of the parser, cache, html, and css code from [mahtoid's DiscordChatExporterPy library](https://github.com/mahtoid/DiscordChatExporterPy).

## License

This project follows the original library and is licensed under the `GNU General Public License v3.0`. Check the [LICENSE](/LICENSE) for more information.
