2.2 KiB

Czysty Wina Historia

Little Boxes

Tiny ActivityPub framework written in Python, both database and server agnostic.

Still in early development, and not published on PyPI yet.

Features

Database and server agnostic
- You need to implement a backend that respond to activiy side-effects
- This also need you're responsible for serving the activities/collections and receiving them
ActivityStreams helper classes
- with Outbox/Inbox abstractions
Content helper using Mardown
- with helpers for parsing hashtags and linkify content
Key (RSA) helper
HTTP signature helper
JSON-LD signature helper
Webfinger helper

Getting Started

from little_boxes import activitypub as ap

from mydb import db_client


class MyBackend(ap.Backend):

    def __init__(self, db_connection):
        self.db_connection = db_connection    

    def inbox_new(self, as_actor: ap.Person, activity: ap.Activity) -> None:
        # Save activity as "as_actor"
        # [...]

    def post_to_remote_inbox(self, as_actor: ap.Person, payload: ap.ObjectType, recipient: str) -> None:
        # Send the activity to the remote actor
        # [...]


db_con = db_client()
my_backend = MyBackend(db_con)

ap.use_backend(my_backend)

me = ap.Person({})  # Init an actor
outbox = ap.Outbox(me)

follow = ap.Follow(actor=me, object='http://iri-i-want-follow')
outbox.post(follow)

Projects using Little Boxes

microblog.pub (using MongoDB as a backend)

Contributions

TODO: document Mypy, flake8 and black.

PRs are welcome, please open an issue to start a discussion before your start any work.

License

ISC, see the LICENSE file.

2.2 KiB Czysty Wina Historia