XCAP RLS services

Version 8 (Adrian Georgescu, 03/31/2009 03:10 pm)

1 2 Adrian Georgescu
== xcap_rls_services ==
2 2 Adrian Georgescu
3 6 Adrian Georgescu
[[TOC(SipTesting*, sip_*, xcap*,depth=2)]]
4 6 Adrian Georgescu
5 7 Adrian Georgescu
To use this script you must to have a valid [wiki:SipSettingsAPI configuration].
6 2 Adrian Georgescu
7 2 Adrian Georgescu
=== Description ===
8 2 Adrian Georgescu
9 3 Adrian Georgescu
This script adds and removed buddies in the RLS services XCAP document. Can be used to prepare the buddy list prior to execute [source:scripts/sip_subscribe_rls.py scripts/sip_subscribe_rls.py] script. 
10 2 Adrian Georgescu
11 2 Adrian Georgescu
Source code: [source:scripts/xcap_rls_services.py scripts/xcap_rls_services.py]
12 2 Adrian Georgescu
13 2 Adrian Georgescu
{{{
14 8 Adrian Georgescu
adigeo@ag-imac3:~$xcap_rls_services -h
15 2 Adrian Georgescu
Usage: xcap_rls_services [options] [service URI]
16 2 Adrian Georgescu
17 2 Adrian Georgescu
This example script will use the specified SIP account to manage rls services
18 2 Adrian Georgescu
via XCAP. The program will quit when CTRL+D is pressed. You can specify the
19 2 Adrian Georgescu
service URI as an argument (if domain name is not specified, the user's domain
20 2 Adrian Georgescu
name will be used). If it is not specified, it defaults to username-
21 2 Adrian Georgescu
buddies@domain.
22 2 Adrian Georgescu
23 2 Adrian Georgescu
Options:
24 2 Adrian Georgescu
  -h, --help            show this help message and exit
25 8 Adrian Georgescu
  -a ACCOUNT_NAME, --account-name=ACCOUNT_NAME
26 8 Adrian Georgescu
                        The name of the account to use.
27 8 Adrian Georgescu
  -s, --show-xml        Show the presence rules XML whenever it is changed and
28 2 Adrian Georgescu
                        at start-up.
29 8 Adrian Georgescu
30 1
}}}
31 4 Adrian Georgescu
32 4 Adrian Georgescu
=== Example ===
33 4 Adrian Georgescu
{{{
34 8 Adrian Georgescu
adigeo@ag-imac3:~$xcap_rls_services   
35 4 Adrian Georgescu
Retrieving current RLS services from https://xcap.sipthor.net/xcap-root/
36 4 Adrian Georgescu
Managing service URI sip:31208005169-buddies@ag-projects.com
37 4 Adrian Georgescu
38 4 Adrian Georgescu
Buddies:
39 4 Adrian Georgescu
	adi@umts.ro
40 8 Adrian Georgescu
	alice@ag-projects.com
41 4 Adrian Georgescu
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.
42 4 Adrian Georgescu
RLS services document:
43 4 Adrian Georgescu
<?xml version='1.0' encoding='UTF-8'?>
44 4 Adrian Georgescu
<rls-services xmlns:rl="urn:ietf:params:xml:ns:resource-lists" xmlns="urn:ietf:params:xml:ns:rls-services">
45 4 Adrian Georgescu
  <service uri="sip:31208005169-buddies@ag-projects.com">
46 4 Adrian Georgescu
    <list>
47 4 Adrian Georgescu
      <rl:entry uri="sip:adi@umts.ro"/>
48 8 Adrian Georgescu
      <rl:entry uri="sip:alice@ag-projects.com"/>
49 4 Adrian Georgescu
    </list>
50 4 Adrian Georgescu
    <packages>
51 4 Adrian Georgescu
      <package>presence</package>
52 4 Adrian Georgescu
    </packages>
53 4 Adrian Georgescu
  </service>
54 4 Adrian Georgescu
</rls-services>
55 4 Adrian Georgescu
56 4 Adrian Georgescu
57 4 Adrian Georgescu
Buddies:
58 4 Adrian Georgescu
	adi@umts.ro
59 8 Adrian Georgescu
	alice@ag-projects.com
60 4 Adrian Georgescu
Press (a) to add or (r) to remove a buddy. (s) will show the RLS services xml. (d) will delete the currently selected service.
61 8 Adrian Georgescu
62 4 Adrian Georgescu
63 4 Adrian Georgescu
}}}