Skip to main content
Pre-release

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
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, 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):
    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, exception):
    ctx.reply(f"something went wrong: {exception.__class__.__name__}: {exception}")

@bot.event()
def on_error(ctx, 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.dev11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for swagsocialbots 1.0.0.dev11
File Size Uploaded Provenance
swagsocialbots-1.0.0.dev11.tar.gz 17.6 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for swagsocialbots 1.0.0.dev11
File Interpreter ABI Platform
swagsocialbots-1.0.0.dev11-py3-none-any.whl Python 3 none any Details

Total release size: 33.5 kB

Release files / swagsocialbots-1.0.0.dev11.tar.gz

Download URL swagsocialbots-1.0.0.dev11.tar.gz
Size 17.6 kB
Tags Source
SHA-256 checksum
How to use checksums
58c5656dd0c93e0d1d1c68e1635e303338a6ca95285023272a4ed7d5a9a25fe5
BLAKE2b-256 checksum
How to use checksums
64d757f08cf9eda84581890865a4a14eb77e6c2cf2c1c6ebca2ef401dbb55704
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / swagsocialbots-1.0.0.dev11-py3-none-any.whl

Download URL swagsocialbots-1.0.0.dev11-py3-none-any.whl
Size 15.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f70df99969885860180dd888f2dd8870d79e9edae59d8ca23bb8ad55227099b
BLAKE2b-256 checksum
How to use checksums
3f2ebf4a153c418201f1d2aeaabb12c0d4aed35245456c3113adff407a1576ed
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Security for swagsocialbots 1.0.0.dev11

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page