Mercurial > libervia-backend
view INSTALL @ 1963:a2bc5089c2eb
backend, frontends: message refactoring (huge commit):
/!\ several features are temporarily disabled, like notifications in frontends
next step in refactoring, with the following changes:
- jp: updated jp message to follow changes in backend/bridge
- jp: added --lang, --subject, --subject_lang, and --type options to jp message + fixed unicode handling for jid
- quick_frontend (QuickApp, QuickChat):
- follow backend changes
- refactored chat, message are now handled in OrderedDict and uid are kept so they can be updated
- Message and Occupant classes handle metadata, so frontend just have to display them
- Primitivus (Chat):
- follow backend/QuickFrontend changes
- info & standard messages are handled in the same MessageWidget class
- improved/simplified handling of messages, removed update() method
- user joined/left messages are merged when next to each other
- a separator is shown when message is received while widget is out of focus, so user can quickly see the new messages
- affiliation/role are shown (in a basic way for now) in occupants panel
- removed "/me" messages handling, as it will be done by a backend plugin
- message language is displayed when available (only one language per message for now)
- fixed :history and :search commands
- core (constants): new constants for messages type, XML namespace, entity type
- core: *Message methods renamed to follow new code sytle (e.g. sendMessageToBridge => messageSendToBridge)
- core (messages handling): fixed handling of language
- core (messages handling): mes_data['from'] and ['to'] are now jid.JID
- core (core.xmpp): reorganised message methods, added getNick() method to client.roster
- plugin text commands: fixed plugin and adapted to new messages behaviour. client is now used in arguments instead of profile
- plugins: added information for cancellation reason in CancelError calls
- plugin XEP-0045: various improvments, but this plugin still need work:
- trigger is used to avoid message already handled by the plugin to be handled a second time
- changed the way to handle history, the last message from DB is checked and we request only messages since this one, in seconds (thanks Poezio folks :))
- subject reception is waited before sending the roomJoined signal, this way we are sure that everything including history is ready
- cmd_* method now follow the new convention with client instead of profile
- roomUserJoined and roomUserLeft messages are removed, the events are now handled with info message with a "ROOM_USER_JOINED" info subtype
- probably other forgotten stuffs :p
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 20 Jun 2016 18:41:53 +0200 |
parents | 1128feb54180 |
children | e7bd2945518f |
line wrap: on
line source
You can install SàT automatically using easy_install or pip, and it is available in several GNU/Linux distributions. The full instructions are available on the wiki: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi Below is are installation instructions, but please check the wiki which may be more up-to-date. *** You can automatically install SàT and its dependencies using easy_install or pip. You will however need to install Python's headers (needed to build some packages), WxPython which is available in most Gnu/Linux distributions, PyGObject and developments version of libxml2 and libxslt (to compile lxml python library). The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces: - "nopreinstall" skips all preinstallation checks - "autodeb" automatically installs missing packages on Debian-based distributions - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers PyGobject is automatically installed on Debian-based distributions if "autodeb" option is set. Indeed, on Debian-based distribution, you can type (with the root account): # apt-get install python-pip python-dev libxml2-dev libxslt-dev # SAT_INSTALL=autodeb pip install . On a *buntu, same commands with sudo: $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev $ sudo SAT_INSTALL=autodeb pip install . After installing SàT, you need to install the media: $ mkdir -p ~/sat/media/destination/path $ cd ~/sat/media/destination/path wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2 tar -jxvf sat_media.tar.bz2 then, create a ~/.sat.conf file which contains: ### sat.conf ### [DEFAULT] media_dir=~/sat/media/destination/path ### end sat.conf ### Of course, replace ~/sat/media/destination/path with the actual path you want to use. Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en You should now be able to launch sat: - to launch the backend, enter $ sat - to stop the backend, enter: $ sat stop - to launch Primitivus, enter: $ primitivus then create a profile. - to use jp, follow its help: $ jp --help For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org