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, 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)

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

Built distribution (wheel)

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

Total release size: 35.2 kB

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

Download URL swagsocialbots-1.0.0.dev13.tar.gz
Size 18.3 kB
Tags Source
SHA-256 checksum
How to use checksums
07317cbef0a00f45902a5aa84ee806e2b577270238c6b8248d19f3cc9ec59303
BLAKE2b-256 checksum
How to use checksums
12d6e79fed1d7291cae4763dcf2a8c34d9666a9789c4c8d8b4f8e4475a3121bd
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.dev13-py3-none-any.whl

Download URL swagsocialbots-1.0.0.dev13-py3-none-any.whl
Size 16.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
72ab481ea9a96872a3db2b44c389b3f8ddd5d7267788c374adcf5a75a8af5494
BLAKE2b-256 checksum
How to use checksums
83ab2ca88c2a181f63d3f7553754d38621226bfab98150dc41f7e6d6f71d5298
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.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.

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