1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
Metadata-Version: 2.4
Name: Tx-XMPP
Version: 0.10.1.post1
Summary: Twisted XMPP support library
Project-URL: Homepage, https://www.goffi.org/forge/goffi/tx-xmpp
Project-URL: Repository, https://www.goffi.org/forge/goffi/tx-xmpp
Project-URL: Changelog, https://www.goffi.org/forge/goffi/tx-xmpp/src/branch/main/CHANGELOG.md
Author-email: Ralph Meijer <ralphm@ik.nu>, Jérôme Poisson <goffi@goffi.org>
Maintainer-email: Jérôme Poisson <goffi@goffi.org>
License-Expression: MIT
License-File: LICENSE
Keywords: jabber,pubsub,twisted,wokkel,xmpp
Classifier: Framework :: Twisted
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Topic :: Internet :: XMPP
Requires-Python: >=3.10
Requires-Dist: constantly
Requires-Dist: python-dateutil
Requires-Dist: twisted[tls]>=22.1.0
Description-Content-Type: text/markdown
Tx-XMPP
======
Forewords
---------
This is an XMPP implementation for Twisted.
This project is a friendly fork of [Wokkel](https://github.com/ralphm/wokkel.git) due to
it being currently unmaintained and not compatible with the latest version of Twisted. Its
aim is to keep the project up-to-date and improved, but the maintenance will be minimal.
It keeps the same license as the original Wokkel. If one day the original Wokkel comes
back to life, this project may be stopped and changes merged back to Wokkel.
This project also implements changes necessary for the Libervia project
([https://libervia.org](https://libervia.org)), in particular RSM and MAM support. Modern
tooling (notably `pyproject.toml` support) and type hints should progressively be added.
A big thanks to Ralph Meijer and other contributors for all the work done.
The sections below are taken from the original projects, but updated to reflect the
current situation.
What is this?
-------------
Tx-XMPP is an implementation built on top of Twisted. It is a friendly fork of Wokkel
maintained to keep compatible with the latest Python and Twisted versions, to use modern
tooling and type hints, and to add some features.
The original Wokkel description was:
Wokkel is a Python module for experimenting with future enhancements to Twisted
Words, that should eventually be included in the main Twisted development
tree. Some of the code in Wokkel has already made that transition, but is still
included to be used with older Twisted releases.
Requirements
------------
- Python 3.10 or later
- Twisted 22.1.0 or later with TLS support
- python-dateutil
- constantly
Resources
---------
<!-- Wokkel website and documentation return 503 -->
<!-- Wokkel has a [home](https://wokkel.ik.nu/) and [documentation](https://wokkel.ik.nu/documentation/). -->
You can get help with Tx-XMPP in the official Libervia XMPP room at
[libervia@chat.jabberfr.org](xmpp:libervia@chat.jabberfr.org?join).
<!-- The mailing list address works, but no message since 2017. -->
<!-- Besides the general Twisted resources, help is available on the -->
<!-- [Twisted-Jabber mailing list](https://mailman.ik.nu/mailman/listinfo/twisted-jabber). -->
Copyright and Warranty
----------------------
The original code in this distribution (pre-fork) is Copyright (c) Ralph Meijer, unless
explicitly specified otherwise.
The Tx-XMPP fork was created on 2026-03-20. Please check the Git logs to see the author of
changes and the related copyright.
Tx-XMPP is made available under the MIT License (same as Wokkel). The included LICENSE
file describes this in detail.
Contributors
------------
- Christopher Zorn
- Jack Moffitt
- Mike Malone
- Pablo Martín
- Fabio Forno
- Kandaurov Oleg
- Jérôme Poisson
- Ilja Braude
- Alexey Bezhan
- Mayank Singh
- Adrien Cossa
- Arnaud Joset (contribution to `sat_tmp`)
Original Author
---------------
Ralph Meijer
- Email: [ralphm@ik.nu](mailto:ralphm@ik.nu)
- XMPP: [ralphm@ik.nu](xmpp:ralphm@ik.nu)
Current Maintainer
------------------
Jérôme Poisson (aka Goffi)
- Email: [goffi@goffi.org](mailto:goffi@goffi.org)
- You can contact me on the official Libervia XMPP room at
[libervia@chat.jabberfr.org](xmpp:libervia@chat.jabberfr.org?join)
Name
----
Wokkel lends its name from a popular Twisted savory snack in the Netherlands.
The current fork has been named Tx-XMPP to avoid confusion with the original. `Tx` is a
common prefix used in the Twisted community to indicate that it's a Twisted-related
package.
|
