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.dev12

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.dev12
File Size Uploaded Provenance
swagsocialbots-1.0.0.dev12.tar.gz 17.6 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 33.6 kB

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

Download URL swagsocialbots-1.0.0.dev12.tar.gz
Size 17.6 kB
Tags Source
SHA-256 checksum
How to use checksums
6b6afef45d1df977935742293ada2f1f68defe2fe8861b5d25d69bdf433c95c0
BLAKE2b-256 checksum
How to use checksums
66612a57f1eed03aff5654b59d68968acb76b6aad862f3b02cc0f240f6cc59b7
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.dev12-py3-none-any.whl

Download URL swagsocialbots-1.0.0.dev12-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
731bae66e2609e4d3e650b9cf1499899e4b495cfe6f1a54706872ef3660a3606
BLAKE2b-256 checksum
How to use checksums
b83fb21f79e2e1ff58f3b11027a56509f4856a39d3ff9fbf7240d4af76fb8a6b
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.dev12

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