longwei 1.0.0.dev0

Python client library for ActivityPub-compatible servers

longwei

Longwei is a minimal Python implementation of the ActivityPub REST API used by Mastodon, Pleroma, GotoSocial, and Takahe. This implementation makes use of asyncio where appropriate. It is intended to be used as a library by other applications. No standalone functionality is provided.

So far Longwei only implements the activtiy pub API calls I need for my other projects Fedinesia, Feed2Fedi, FenLiu and Zhongli.

DO NOT expect a full or complete implementation of all ActivityPub API functionality.

API References

• Mastodon API
• Pleroma API
• GotoSocial API

Heavy Development / Breaking Changes

I have only just forked this from minimal_activitypub and am still working on it. Expect some major changes still and some breaking changes. It is not a drop in replacement and will need some adjustments, even when I am done with the rework.

I advise not to use this at until at least version 1.0.0 (non dev)

Contributing

Issues and pull requests are welcome.

longwei is using pre-commit for code quality checks and uv for dependency management. Please install and use both pre-commit and uv if you'd like to contribute.

Documentation

The documentation is built using MkDocs with the Material theme.

Building Documentation Locally

# Install documentation dependencies (using the docs group from pyproject.toml)
uv sync --group docs

# Build documentation
mkdocs build

# Serve documentation locally
mkdocs serve

Documentation Structure

• docs/ - Markdown source files
• mkdocs.yml - MkDocs configuration

Development

This project uses uv for dependency management and virtual environments. To set up the development environment:

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install all dependencies including development and documentation groups
uv sync --all-groups

# Run tests
uv run nox

For more details on the development workflow, check the noxfile.py and .woodpecker/ configuration files.

Licensing

longwei is licenced with the GNU Affero General Public License v3.0

Supporting longwei

There are a number of ways you can support longwei:

• Create an issue with problems or ideas you have with/for longwei
• You can buy me a coffee.
• You can send me small change in Monero to the address below:

Monero donation address

8ADQkCya3orL178dADn4bnKuF1JuVGEG97HPRgmXgmZ2cZFSkWU9M2v7BssEGeTRNN2V5p6bSyHa83nrdu1XffDX3cnjKVu