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 swagsocialbots import tasks
from swagsocial_py import User
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()
async def hello(ctx: Context, user: User):
await ctx.reply(f"Hello {user.display_name}")
@bot.event() # will reply to a post the bot is tagged on
async def on_mention(ctx: Context):
await ctx.reply(f"Hello, @{ctx.post.author.username}")
# will reply with an error message related to the comamnd
@bot.event()
async def on_command_error(ctx: Context, exception: Exception):
await ctx.reply(f"something went wrong: {exception.__class__.__name__}: {exception}")
@bot.event()
async def on_error(ctx: Context, exception: Exception):
# for now exception in this block will always be "Command not found"
await ctx.reply(f"something went wrong: {exception.__class__.__name__}: {exception}")
# used for making a function repeat every N time, and N times (using for_times argument)
@tasks.repeat_every(hours = 1) # add for_times = <int> to repeat this function for a specific amount of times before stopping
async def post_meow():
await bot.post("meow") # will post meow every 1 hour
@bot.event()
async def on_start():
print("bot started")
bot.run("api key")
more in depth examples are in here
Release files for swagsocialbots 1.0.0.dev15
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.dev15.tar.gz | 19.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| swagsocialbots-1.0.0.dev15-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 37.2 kB
Security for swagsocialbots 1.0.0.dev15
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.
