This release is a pre-release and may not be stable for production use.
swagsocialbots
Now on PyPI: https://pypi.org/project/swagsocialbots/
Python module to make bots in swagsocial with swagsocial.py
Created by maxie!
Getting your API key
Log into your desired swagsocial account and go to Settings --> API, or click this link
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!
an example
from swagsocialbots import SwagBot, Context
from swagsocial_py import User
import time
bot = SwagBot(prefix = "!")
# example command
# on swagsocial you would mention the bot
# write the command afterwards, and the arguments for it
#
# here its gonna be "@botexample !hello @user"
# will reply with "Hello User Display Example"
#
# annotating your arguments with desired class will make the
# command parser return the class instance you need such
# as in the example below
@bot.command()
def hello(ctx: Context, user: User):
ctx.reply(f"Hello {user.display_name}")
@bot.event() # will reply to a post the bot is tagged on
def on_mention(ctx: Context):
ctx.reply(f"Hello, @{ctx.post.author.username}")
# will do anything in a forever loop, useful for bots that
# post something every N amount of time
@bot.event()
def forever_loop():
bot.post("meow")
time.sleep(3600) # bot will post "meow" every 1 hour
# will reply with an error message related to the comamnd
@bot.event()
def on_command_error(ctx: Context, exception: Exception):
ctx.reply(f"something went wrong: {exception.__class__.__name__}: {exception}")
@bot.event()
def on_error(ctx: Context, exception: Exception):
# for now exception in this block will always be "Command not found"
ctx.reply(f"something went wrong: {exception.__class__.__name__}: {exception}")
@bot.event()
def on_start():
print("bot started")
bot.run("api key")
more in depth examples are in here
Metadata
Release files for swagsocialbots 1.0.0.dev13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| swagsocialbots-1.0.0.dev13.tar.gz | 18.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| swagsocialbots-1.0.0.dev13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 35.2 kB
Security for swagsocialbots 1.0.0.dev13
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.