Metadata-Version: 2.2
Name: matteridge
Version: 0.2.0
Summary: XMPP/Mattermost gateway
Author-email: Nicolas Cedilnik <nicoco@nicoco.fr>
Project-URL: Homepage, https://codeberg.org/slidge/matridge
Project-URL: Issues, https://codeberg.org/slidge/matridge/issues
Project-URL: Repository, https://codeberg.org/slidge/matridge
Project-URL: Chat room, https://conference.nicoco.fr:5281/muc_log/slidge/
Project-URL: Documentation, https://slidge.im/docs/matridge/main
Keywords: xmpp,gateway,bridge,instant messaging,mattermost,chat
Classifier: Topic :: Internet :: XMPP
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mattermost-api-reference-client<5,>=4.0.0.post3
Requires-Dist: emoji<3,>=2.2.0
Requires-Dist: async-lru<3,>=2.0.4
Requires-Dist: slidge<0.3,>=0.2.3

# matteridge

A
[feature-rich](https://slidge.im/docs/matteridge/main/features.html)
[Mattermost](https://mattermost.com) to
[XMPP](https://xmpp.org/) puppeteering
[gateway](https://xmpp.org/extensions/xep-0100.html), based on
[slidge](https://slidge.im) and
[mattermost-api-reference-client](https://git.sr.ht/~nicoco/mattermost-api-reference-client).

[![PyPI package version](https://badge.fury.io/py/matteridge.svg)](https://pypi.org/project/matteridge/)
[![CI pipeline status](https://ci.codeberg.org/api/badges/14070/status.svg)](https://ci.codeberg.org/repos/14070)
[![Chat](https://conference.nicoco.fr:5281/muc_badge/slidge@conference.nicoco.fr)](https://conference.nicoco.fr:5281/muc_log/slidge/)

## Installation

Refer to the [slidge admin documentation](https://slidge.im/docs/slidge/main/admin/)
for general info on how to set up an XMPP server component.

### Containers

From [the codeberg package registry](https://codeberg.org/slidge/-/packages?q=&type=container)

```sh
docker run codeberg.org/slidge/matridge
```

### Python package

With [pipx](https://pypa.github.io/pipx/):

```sh

# for the latest stable release (if any)
pipx install matridge

# for the bleeding edge
pipx install matridge==0.0.0.dev0 \
    --pip-args='--extra-index-url https://codeberg.org/api/packages/slidge/pypi/simple/'

# to update bleeding edge installs
pipx install matridge==0.0.0.dev0 \
    --pip-args='--extra-index-url https://codeberg.org/api/packages/slidge/pypi/simple/' --force

matridge --help
```

## Dev

```sh
git clone https://codeberg.org/slidge/matteridge
cd matteridge
docker-compose up
```
