tag nameslix-1.8.0 (c00f45be46133b78e8ff4150779634cc4755f140)
tag date2022-02-27 22:25:56 +0100
tagged bymathieui <>
tagged objectcommit e8f45dedfe...
slixmpp 1.8.0 release
Slixmpp 1.8.0 is out, thanks to pep., Link Mauve, mathieui, Nicolas Cedilnik, Tim-Oliver Husser, southerntofu as well as the various people who run slixmpp and report bugs! The most important part of this release is that it fixes compatibility with python 3.10, but there are also plenty of changes and bugfixes! Many XEPs have been modified to accomodate an internal change, and as a result their public APIs have been modified. Slixmpp has an "internal API" for plugins, inherited from SleekXMPP which allows users of the library to substitute internal functions with their own, in order to e.g. provide a different storage backend (many default to in-memory), etc. This API has always been synchronous, which is not ideal in an asyncio library, and puts huge limits on what is possible to do. This change makes it possible to use async functions with the internal API, and as a result it forces us to change XEPs using this API to async in the relevant methods. As a rule of thumb, thin wrappers around del/set are generally preserved and return a future to guarantee that the task is done, while getters (which would require awaiting anyway when returning a future) are now pure coroutines. This inconsistency is a tradeoff to prevent wider changes across slixmpp internals and programs using it. - XEP-0012, Last Activity: - `begin_idle`, `end_idle`, `start_uptime`, `set_last_activity`, `del_last_activity` now return futures. - XEP-0027: GPG - `get_keyids` and `get_keyid` are now coroutines. - `set_keyid` and `del_keyid` now return a Future. - XEP-0030: Disco - `supports`, `has_identity`, `get_info`, `get_items` are now coroutines - `set_info``set_items`, `del_items`, `add_item`, `add_identity`, `del_identity`, `set_identities`, `del_identities`, `add_feature`, `del_feature`, `set_feature`, `set_features`, `del_features` now return a Future - XEP-0054: Vcard-Temp - `get_vcard`, `publish_vcard` are now coroutines. - XEP-0095: Stream Initiation - `accept` and `decline` are now coroutines. - XEP-0115: Entity Capabilities - `get_verstring`, `get_caps` are now coroutines. - `assign_verstring`, `cache_caps` now return a Future. - XEP-0128: Extended disco - `set_extended_info`, `add_extended_info` and `del_extended_info` return Futures. - XEP-0231: BoB - `get_bob` and `set_bob` are now coroutines. - `del_bob` returns a Future. - XEP-0319: Idle - `idle` and `active` are now coroutines. XMLStream.process() is now deprecated, and will be removed in the next version. This shorthand makes things more confusing for new users, and complicates integration with other asyncio libraries. - If defusedxml is available, it will be used, to mitigate XML parser vulns - `XMLStream.ca_certs` should be a list of paths to the CA certificates Nicoco (Nicolas Cedilnik) contributed an implementation of XEP-0356 (privileged entities), and XEP-100 (gateway interaction). The Form element (`{jabber:x:data}x`) can now be accessed properly if their are several available in a parent element, through a 'forms' multi attribute. - Add an async join method (returns once the rooms is properly joined, or raises on error). - Deprecate the old join_muc() API Nicoco added the possibility to register with components to the existing XEP-0077 implementation. - MAM preferences have been split into an XEP-0441 plugin. - Tests have been added - An `iterate()` method has been added, which should be easier to use. - XEP-0369: add events for participant and channels - XEP-0405: Add a method to retrieve annotated roster items - Add a simple MIX bot - Make `StanzaBase.get_plugin` a public API, so that slixmpp users can check for the existence of a substanza without risking to create it. - Change the sphinx theme to [Furo]( which has a dark mode, and looks good. See []( - Improve the toctree to be more logical - Update obsolete documentation and tutorials (and add some) - Update the event index - Add the proper XEP title instead of the number to the index, for easier discovery and search. More integration and stanza/stream tests have been added, which gives us more confidence on the overall stability. The HTTPUpload example has been updated to include an oob reference, because many people were reusing the code as-is and wondering why clients were not displaying their images inline. A lot of work in this release has been to incrementally type the internals of slixmpp as well as the public interfaces, to make it easier to validate changes and integrate seemlessy with the various IDEs and typecheckers. It is still very much a work in progress, in part due to the dynamicity of the API, but it should help catch some errors. The library now ships with a py.typed file to indicate that it is shipping type annotations. -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEqNX3CaXe9Dnz12IoxZ+Ezu/WFuMFAmIb7K8ACgkQxZ+Ezu/W FuMnkQ/6A4K0tSXKDupCu/YNEvSmV9IhegPtZJbF8ecA6/+5GCES4Eed7btdxx9Z OUTQ8EqMmoTFGla+b4lrGDUoyqhX8Hhg8NUcfukYOi7W6G3pQ9BF4Wx2W1T2MMA4 t+QGGZEwl8cDYBLIFgMIXtkkCM6EA7LOe5F4TwB3a2cf/B+A4LrvOWK6mhWZyPvo AcZjSbCLhR65YB4OmK7zHPnUPoQnWckIa4tj3oJOnZCFVjaT4rKkODxTfhgtkho5 j4luJ2Kn9WANNtaeENAv3nifmrEnxD59Q+/0YTBON2/VjDqEH66XngTFb08q2hBb cGVkC4FnQxj6erf/djkNjXz4GBKFOnpgWe9RkUa3Ow2+cq3Bo9AcckoJdEA5ayyK zhJseSsS9Bfp2hpYQefwqf3yQd2Xw7JgGeewb7MMLx+wOuB64NwtE0NRROMIpI6g WhtqkDxEpq/YlQwR7ieQQjh8npLeJX3A+TUF1Dr3BgqtKfEfjKPMBJOaQk023ido RU53zBp/9sLgtJLZfZ9YJL9FRjXHss6YBDEqCO1TzRuFi4OrN7XCjms/gSd41iFC zpn8Hw1IXP7Vk/J3vqk4oaB7mxA2FeKZ9nk39Bs8sjjsKphQEmMQUiQom8Kdi7PP 7hcwlKsUqiMEYNwOOayMmh9MakBg0f27BnpdCKpgTyFG7R9Ds1w= =NpTe -----END PGP SIGNATURE-----