Metadata-Version: 2.4
Name: swagsocialbots
Version: 1.0.0.dev3
Summary: swagsocialbots is a library to make bots with the swagsocial.py library
Project-URL: Homepage, https://git.nomaakip.xyz/maxie/swagsocialbots
Project-URL: Issues, https://git.nomaakip.xyz/maxie/swagsocialbots/issues
Author: maxie
License-Expression: GPL-3.0-only
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# swagsocialbots

Now on PyPI: https://pypi.org/project/swagsocialbots/

Python module to make bots in swagsocial with [swagsocial.py](https://pypi.org/project/swagsocial-py)

Created by maxie!

# Getting your API key

Log into your desired swagsocial account and go to Settings --> API, or [click this link](https://swag.nomaakip.xyz/settings/api)

If you would like to grant manage post permissions, which includes making posts and replies. It also allows deleting posts and replies, so be careful!

# examples

```python
from swagsocialbots import SwagBot
import time

bot = SwagBot()

@bot.on_mention() # will reply to a post the bot is tagged on
def on_mention(post):
    bot.reply(post.id, f"Hello, @{post.author.username}")

# will do anything in a forever loop, useful for bots that
# post something every N amount of time
@bot.forever_loop()
def forever():
    bot.create_post("meow")
    time.sleep(3600) # bot will post "meow" every 1 hour

bot.run("api key")
```
