Xcap pres rules

Version 3 (Adrian Georgescu, 10/26/2008 06:26 pm)

1 1 Adrian Georgescu
== xcap_pres_rules ==
2 1 Adrian Georgescu
3 1 Adrian Georgescu
To use this script you must to have a valid [wiki:configuration_file configuration file].
4 1 Adrian Georgescu
5 1 Adrian Georgescu
=== Description ===
6 1 Adrian Georgescu
7 1 Adrian Georgescu
{{{
8 1 Adrian Georgescu
adigeo@ag-imac3:~/work/pypjua/scripts$./xcap_pres_rules.py -h
9 1 Adrian Georgescu
Usage: xcap_pres_rules.py [options]
10 1 Adrian Georgescu
11 1 Adrian Georgescu
This example script will use the specified SIP account to manage presence
12 1 Adrian Georgescu
rules via XCAP. The program will quit when CTRL+D is pressed.
13 1 Adrian Georgescu
14 1 Adrian Georgescu
Options:
15 1 Adrian Georgescu
  -h, --help            show this help message and exit
16 1 Adrian Georgescu
  -a NAME, --account-name=NAME
17 1 Adrian Georgescu
                        The account name from which to read account settings.
18 1 Adrian Georgescu
                        Corresponds to section Account_NAME in the
19 1 Adrian Georgescu
                        configuration file. If not supplied, the section
20 1 Adrian Georgescu
                        Account will be read.
21 1 Adrian Georgescu
  --sip-address=SIP_ADDRESS
22 1 Adrian Georgescu
                        SIP address of the user in the form user@domain
23 1 Adrian Georgescu
  -p PASSWORD, --password=PASSWORD
24 1 Adrian Georgescu
                        Password to use to authenticate the local account.
25 1 Adrian Georgescu
                        This overrides the setting from the config file.
26 1 Adrian Georgescu
  -n DISPLAY_NAME, --display-name=DISPLAY_NAME
27 1 Adrian Georgescu
                        Display name to use for the local account. This
28 1 Adrian Georgescu
                        overrides the setting from the config file.
29 1 Adrian Georgescu
  -x XCAP_ROOT, --xcap-root=XCAP_ROOT
30 1 Adrian Georgescu
                        The XCAP root to use to access the pres-rules document
31 1 Adrian Georgescu
                        for authorizing subscriptions to presence.
32 1 Adrian Georgescu
}}}
33 2 Adrian Georgescu
34 2 Adrian Georgescu
== Example ==
35 2 Adrian Georgescu
36 2 Adrian Georgescu
{{{
37 2 Adrian Georgescu
xcapag-oxygen:~ adigeo$ xcap_pres_rules 
38 2 Adrian Georgescu
Accounts available: 'alice', 'ew', 'gert', 'mrg', 'tf', 'umts', 'unet', default
39 2 Adrian Georgescu
Using default account: 31208005169@ag-projects.com
40 2 Adrian Georgescu
Retrieving current presence rules from https://xcap.sipthor.net/xcap-root/
41 2 Adrian Georgescu
Allowed watchers:
42 2 Adrian Georgescu
	2233350608@sip2sip.info
43 2 Adrian Georgescu
	31208005163@ag-projects.com
44 2 Adrian Georgescu
	31208005166@ag-projects.com
45 2 Adrian Georgescu
	31208005167@ag-projects.com
46 2 Adrian Georgescu
	adi@umts.ro
47 2 Adrian Georgescu
	alice@example.com
48 2 Adrian Georgescu
	317105169@eurovoice.ro
49 2 Adrian Georgescu
	bob@example.com
50 2 Adrian Georgescu
Blocked watchers:
51 2 Adrian Georgescu
	test1@merge.net.nl
52 2 Adrian Georgescu
Polite-blocked watchers:
53 3 Adrian Georgescu
Press (a) to allow, (d) to deny, (p) to politely block a new watcher or (r) to remove a watcher from the rules. 
54 3 Adrian Georgescu
(s) will show the presence rules xml.
55 2 Adrian Georgescu
a
56 2 Adrian Georgescu
watcher> abc@example.com
57 2 Adrian Georgescu
Watcher sip:abc@example.com is now authorized
58 2 Adrian Georgescu
}}}