X-Git-Url: https://git.kaliko.me/?a=blobdiff_plain;f=README.rst;h=1d724e19729a9b63bcc4922bbb0675cc7aff58da;hb=aedd6aa01b9f279a4ae5b10b31b66900ce84c07b;hp=1449a963eb5cca35dba863d80ca89a048cb3c3ab;hpb=a6de5443ea8f067023c94b97b405560f92cbd765;p=sid.git diff --git a/README.rst b/README.rst index 1449a96..1d724e1 100644 --- a/README.rst +++ b/README.rst @@ -5,15 +5,22 @@ sid an xmpp bot Getting sid ------------ -Currently unreleased, only a development version is available. +Currently unreleased on PyPi_. + +`git tagged` version and `master branch` should be stable though. + +* Doc: https://kaliko.gitlab.io/sid/ +* git: https://gitlab.com/kaliko/sid.git +* Issue: https://gitlab.com/kaliko/sid/-/issues -* http: https://kaliko.me/sid/ -* git: http://git.kaliko.me/?p=sid.git Get the source with git:: git clone git://git.kaliko.me/sid.git +Install/update master from git:: + + pip install -U git+https://gitlab.com/kaliko/sid.git@master#egg=sid Using the bot ------------- @@ -28,12 +35,18 @@ Here is a plain example:: from sid.ping import Ping JID = 'bot@example.org' - NICK = 'sid' - PASS = getpass.getpass('Password for "{}": '.format(JID)) ROOM = 'room@conf.example.org' + # Pay attention: if you join the room with the same account/nick, + # For instance with a regular interactive client, the bot will + # not answer you, it ignores its own messages for obvious reasons. + NICK = 'sid' + PASS = getpass.getpass(f'Password for "{JID}": ') + # Instanciate the bot xmpp = MUCBot(JID, PASS, ROOM, NICK) + # Register a plugin xmpp.register_bot_plugin(Ping) + # Connect to the XMPP server and start processing XMPP stanzas. try: xmpp.connect() @@ -47,3 +60,5 @@ Contacting author The current maintainer can be found on xmpp chat room or you can contact him by email/xmpp . + +.. _PyPI: https://pypi.org