|
1 | | -# - AthenaTwitchBot - |
2 | | -[](https://pypi.org/project/AthenaTwitchBot/) [](https://github.com/DirectiveAthena/VerSC-AthenaColor/blob/master/LICENSE) [](https://discord.gg/6JcDbhXkCH) [](https://pepy.tech/project/athenatwitchbot) |
| 1 | +# - AthenaTwitchLib - |
| 2 | +[](https://pypi.org/project/AthenaTwitchLib/) [](https://github.com/DirectiveAthena/VerSC-AthenaColor/blob/master/LICENSE) [](https://discord.gg/6JcDbhXkCH) [](https://pepy.tech/project/athenatwitchbot) |
3 | 3 |
|
4 | 4 | --- |
5 | 5 | ## Package Details |
6 | 6 | #### Details and features |
7 | | -- A library to connect to the Twitch IRC system for a chatbot to utilize |
8 | | -- Isn't dependent on 3rd party packages, except for those that have been created by [@AndreasSas](https://github.com/AndreasSas) |
9 | | - - These can be designated by the leading "*Athena*..." |
10 | | - - These packages aren't seen as a 3rd party dependency as they are all made by the "same party" |
| 7 | +- A library to create Twitch Chat Bots |
| 8 | + - hard coded commands |
| 9 | + - hard coded tasks |
| 10 | + - Bots have the ability to pull commands from a database |
| 11 | + - Currently supported databases: *Sqlite* (more will come in the future) |
| 12 | + - Logging is handled by other Process |
| 13 | + - Logs are stored to a Sqlite file |
| 14 | + |
| 15 | +- Features that are planned but still being worked on |
| 16 | + - Twitch Helix API connector |
| 17 | + - Task pulling from a database |
| 18 | + - ... |
11 | 19 |
|
12 | 20 | #### Python Version |
13 | | -- Supported Python versions: **3.10** |
14 | | - - Other older versions of Python are not gonna be supported. |
| 21 | +- Supported Python versions: **3.11** |
| 22 | + - Other older versions of Python are not going to be supported. |
15 | 23 |
|
16 | 24 | --- |
17 | | -## Quick Example |
18 | | -The following example is a working bot, but currently only meant as proof of work as the package is still in its early stages of being developed and needs some heavy tuning. |
19 | 25 |
|
20 | | -Stay tuned for updates while we work on this on [stream](https://www.twitch.tv/directiveathena) or come hang out in the [discord](https://discord.com/invite/6JcDbhXkCH). |
| 26 | +## Example |
| 27 | +**Currently, still in Alpha phase. Will have a good example working once version 1.0.0 is released** |
21 | 28 |
|
22 | | -```python |
23 | | -# --- Imports --- |
24 | | -import os |
25 | | - |
26 | | -from AthenaTwitchBot.models.twitch_bot.twitch_bot import TwitchBot |
27 | | -from AthenaTwitchBot.models.twitch_bot.bot_methods.bot_command import BotCommand |
28 | | -from AthenaTwitchBot.models.twitch_bot.message_context import MessageContext |
29 | | -from AthenaTwitchBot.models.launcher import Launcher |
30 | | -from AthenaTwitchBot.models.twitch_channel import TwitchChannel |
31 | | - |
32 | | -# --- Code --- |
33 | | -class SomeBot(TwitchBot): |
34 | | - def __init__(self): |
35 | | - super(SomeBot, self).__init__( |
36 | | - nickname=..., # <--- your bot name |
37 | | - oauth_token=os.getenv("TWITCH_TOKEN"), |
38 | | - channel=TwitchChannel(...), # <--- your channel name |
39 | | - command_prefix="!", |
40 | | - client_id=os.getenv("TWITCH_CLIENT_ID") |
41 | | - ) |
42 | | - |
43 | | - @BotCommand.register(name="today") |
44 | | - async def command_today(self, context: MessageContext): |
45 | | - context.reply(f"Today we will be working on: ..." ) |
46 | | - |
47 | | -# ----------------------------------------------------------------------------- |
48 | | -def main(): |
49 | | - Launcher.start_Bot( |
50 | | - bot=SomeBot(), |
51 | | - sll=True, |
52 | | - ) |
53 | | - |
54 | | -if __name__ == '__main__': |
55 | | - main() |
56 | | - |
57 | | -``` |
58 | | - |
59 | | ---- |
60 | | -## Documentation |
61 | | -Full documentation can be found at: |
62 | | -**[directiveathena.com/docu](https://publish.obsidian.md/directiveathena/)** (redirect to Obsidian.md publish site) |
63 | | -(Reminder, the documentation is still under heavy development) |
64 | | - |
65 | | ---- |
66 | 29 | ## Install |
67 | 30 | To install the package in your Python environment |
68 | 31 |
|
69 | 32 | ``` |
70 | | -pip install AthenaTwitchBot --upgrade |
| 33 | +pip install AthenaTwitchLib --upgrade |
71 | 34 | ``` |
72 | 35 |
|
73 | 36 | --- |
74 | 37 |
|
75 | 38 | ## Links |
76 | 39 | Project files can be found at: |
77 | | -- [GitHub Repo](https://github.com/DirectiveAthena/AthenaTwitchBot) |
78 | | -- [Pypi link](https://pypi.org/project/AthenaTwitchBot/) |
79 | | - |
80 | | ---- |
81 | | - |
82 | | -## Disclaimer |
83 | | -With *No Dependency*, the standard library is not counted as a dependency |
| 40 | +- [GitHub Repo](https://github.com/DirectiveAthena/AthenaTwitchLib) |
| 41 | +- [Pypi link](https://pypi.org/project/AthenaTwitchLib/) |
84 | 42 |
|
85 | 43 | --- |
86 | 44 | Made By Andreas Sas,` 2022` |
0 commit comments