verse
c9a144591649
README

Find changesets by keywords by author, files, the commit message, revision number or hash, or revset expression.

Software / code / verse

File

README @ 485:c9a144591649

component: Avoid adding to the global stream metatable This allows component and client connections to be made side-by-side. Previous to this change, loading this connection module would break the ability to make client connections, due to overriding stream methods such as :reopen() and :reset(). A next step would be to share the methods that the two connection modules have in common.
author Matthew Wild <mwild1@gmail.com>
date Thu, 23 Mar 2023 18:56:32 +0000
parent 374:3267ae7c9217
line wrap: on
line source

# Verse

Verse is an XMPP library for Lua. It allows you to connect to an XMPP server, as
either a client or a component. It also supports connecting over HTTP (BOSH).

Currently Verse supports Lua 5.1 and LuaJIT, though support for later versions of
Lua is planned (contributions welcome).

Verse shares some of its underlying code with the Prosody XMPP server. To avoid
duplication, the shared files are not part of the Verse project, but are available
in Prosody's source repository, and are bundled with official Verse releases.

## Features

  - Standard XMPP, including SRV and TLS support
  - Roster management
  - Service discovery
  - Stream management (XEP-0198)
  - MUC
  - Ad-hoc commands
  - Jingle (peer-to-peer TCP and file transfer)
  - File transfer proxies
  - Message receipts
  - Pubsub
  - Message archive management
  - PEP
  - Many more...

## Dependencies

Verse requires:

  - LuaSocket
  - LuaExpat
  - LuaSec

All these libraries are available for Windows, OS X, many popular Linux distributions, and
also via LuaRocks.

## Building

To generate a self-contained verse.lua:

	./configure
	make

The configure script will take a guess at the best place to install verse.lua. To install:

	make install # (may require root, e.g. sudo)

If you fetched Verse from its source repository, some files will automatically be fetched
from Prosody's repository the first time you run 'make'. Official Verse releases already
include these files.

## Documentation

See doc/ for a number of example scripts.