# Stabber Stubbed XMPP (Jabber) Server. # Overview Stabber acts as a stubbed XMPP service for testing purposes, the API allows: * Sending of XMPP stanzas. * Responding to XMPP stanzas with stubbed responses. * Verifying that XMPP stanzas were received. An HTTP API is also included, currently only supporting the send operation. The project is work in progress with only the basics implemented, and is being developed alongside https://github.com/boothj5/profanity Currently the only API is written in C. # Installing ``` ./bootstrap.sh ./configure make make install (as root) ``` # Using the C API Include the following header in your tests: ``` #include ```` Include the following in the linker path when compiling tests: ``` -lstabber ``` # C API ### Starting To start Stabber on port 5230 for example: ```c stbbr_start(5230, 0); ``` The second argument is the port to use for the HTTP interface, a value of 0 will not start the HTTP daemon. ### Stopping To stop Stabber: ```c stbbr_stop(); ``` ### Authentication Currently only legacy authentication is supported, to set the password that stabber expects when an account connects: ```c stbbr_auth_passwd("mypassword"); ``` The default if not set is "password". ### Sending stanzas To make Stabber send an XMPP stanza: ```c stbbr_send( "" "" "" ); ``` ### Responding to stanzas As well as being able to send an XMPP stanza at any time, you can also respond to a stanza by its id attribute: ```c stbbr_for("msg_21", "" "I'm not real!" "" ); ``` ### Verify sent stanzas To verify that you sent a particular stanza to Stabber: ```c stbbr_received( "" "I know, its a test." "" ); ``` The above function returns 1 if the stanza has been received, and 0 if it hasn't. The following function check that it was specifically the last stanza received: ```c stbbr_last_received( "" "I know, its a test." "" ); ``` Both verifications allow for wildcards (*) as attribute values, for example, if you don't know the id's that are generated by your client: ```c stbbr_received( "" "I know, its a test." "" ); ```` By default the verification calls block for up to 10 seconds, the timeout in seconds can be set with: ```c stbbr_set_timeout(3); ``` A value of 0 or less is non-blocking and will return immediately. ### Waiting Sometimes a test needs to wait until the client being tested has had time to send some specific stanzas. The following will block until a stanza with a particular ID has been received by Stabber: ```c stbbr_wait_for("someid"); ``` # Logs Stabber logs to: ``` ~/.local/share/stabber/logs/stabber.log ``` # HTTP API To start stabber in standalone mode: ``` stabber -p 5230 -h 5231 ``` The second argument is the HTTP port on which Stabber will listen. To send a message to a client currently connected to Stabber on port 5230, send a POST request to `http://localhost:5231/send` with the body containing the stanza to send, e.g.: ``` curl --data 'Here's a message sent from stabber, using the HTTP api' http://localhost:5231/send ``` # Examples Example tests for Profanity can be found at: https://github.com/boothj5/profanity/tree/stabber-tests/functionaltests