root / ncclient / capabilities.py @ b5d5a1b1
History | View | Annotate | Download (3.6 kB)
1 | d095a59e | Shikhar Bhushan | # Copyright 2009 Shikhar Bhushan
|
---|---|---|---|
2 | d095a59e | Shikhar Bhushan | #
|
3 | d095a59e | Shikhar Bhushan | # Licensed under the Apache License, Version 2.0 (the "License");
|
4 | d095a59e | Shikhar Bhushan | # you may not use this file except in compliance with the License.
|
5 | d095a59e | Shikhar Bhushan | # You may obtain a copy of the License at
|
6 | d095a59e | Shikhar Bhushan | #
|
7 | d095a59e | Shikhar Bhushan | # http://www.apache.org/licenses/LICENSE-2.0
|
8 | d095a59e | Shikhar Bhushan | #
|
9 | d095a59e | Shikhar Bhushan | # Unless required by applicable law or agreed to in writing, software
|
10 | d095a59e | Shikhar Bhushan | # distributed under the License is distributed on an "AS IS" BASIS,
|
11 | d095a59e | Shikhar Bhushan | # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
12 | d095a59e | Shikhar Bhushan | # See the License for the specific language governing permissions and
|
13 | d095a59e | Shikhar Bhushan | # limitations under the License.
|
14 | d095a59e | Shikhar Bhushan | |
15 | 216bb34c | Shikhar Bhushan | def _abbreviate(uri): |
16 | 216bb34c | Shikhar Bhushan | if uri.startswith('urn:ietf:params:netconf:'): |
17 | 216bb34c | Shikhar Bhushan | splitted = uri.split(':')
|
18 | 216bb34c | Shikhar Bhushan | if ':capability:' in uri: |
19 | 216bb34c | Shikhar Bhushan | return [ ':' + splitted[5], ':' + splitted[5] + ':' + splitted[6] ] |
20 | 216bb34c | Shikhar Bhushan | elif ':base:' in uri: |
21 | 216bb34c | Shikhar Bhushan | return [ ':base', ':base' + ':'+ splitted[5] ] |
22 | 216bb34c | Shikhar Bhushan | else:
|
23 | 216bb34c | Shikhar Bhushan | return []
|
24 | 216bb34c | Shikhar Bhushan | else:
|
25 | 216bb34c | Shikhar Bhushan | return []
|
26 | 216bb34c | Shikhar Bhushan | |
27 | 216bb34c | Shikhar Bhushan | def schemes(url_uri): |
28 | 216bb34c | Shikhar Bhushan | """Given a URI that has a *scheme* query string (i.e. *:url* capability
|
29 | 216bb34c | Shikhar Bhushan | URI), will return a list of supported schemes.
|
30 | 216bb34c | Shikhar Bhushan | """
|
31 | 216bb34c | Shikhar Bhushan | return url_uri.partition("?scheme=")[2].split(',') |
32 | 78f6c132 | Shikhar Bhushan | |
33 | d095a59e | Shikhar Bhushan | class Capabilities: |
34 | a7cb58ce | Shikhar Bhushan | |
35 | 216bb34c | Shikhar Bhushan | """Represents the set of capabilities for a NETCONF client or server.
|
36 | 216bb34c | Shikhar Bhushan | Initialised with a list of capability URI's.
|
37 | 216bb34c | Shikhar Bhushan |
|
38 | 216bb34c | Shikhar Bhushan | Presence of a capability can be checked with the *in* operations. In addition
|
39 | 216bb34c | Shikhar Bhushan | to the URI, for capabilities of the form
|
40 | 216bb34c | Shikhar Bhushan | *urn:ietf:params:netconf:capability:$name:$version* their shorthand can be
|
41 | 216bb34c | Shikhar Bhushan | used as a key. For example, for
|
42 | 216bb34c | Shikhar Bhushan | *urn:ietf:params:netconf:capability:candidate:1.0* the shorthand would be
|
43 | 216bb34c | Shikhar Bhushan | *:candidate*. If version is significant, use *:candidate:1.0* as key.
|
44 | 216bb34c | Shikhar Bhushan | """
|
45 | 216bb34c | Shikhar Bhushan | |
46 | 216bb34c | Shikhar Bhushan | def __init__(self, capabilities): |
47 | d095a59e | Shikhar Bhushan | self._dict = {}
|
48 | 216bb34c | Shikhar Bhushan | for uri in capabilities: |
49 | 216bb34c | Shikhar Bhushan | self._dict[uri] = _abbreviate(uri)
|
50 | a7cb58ce | Shikhar Bhushan | |
51 | d095a59e | Shikhar Bhushan | def __contains__(self, key): |
52 | a7cb58ce | Shikhar Bhushan | if key in self._dict: |
53 | a7cb58ce | Shikhar Bhushan | return True |
54 | 216bb34c | Shikhar Bhushan | for abbrs in self._dict.values(): |
55 | 216bb34c | Shikhar Bhushan | if key in abbrs: |
56 | a7cb58ce | Shikhar Bhushan | return True |
57 | a7cb58ce | Shikhar Bhushan | return False |
58 | a7cb58ce | Shikhar Bhushan | |
59 | 216bb34c | Shikhar Bhushan | def __len__(self): |
60 | 216bb34c | Shikhar Bhushan | return len(self._dict) |
61 | 216bb34c | Shikhar Bhushan | |
62 | d095a59e | Shikhar Bhushan | def __iter__(self): |
63 | d095a59e | Shikhar Bhushan | return self._dict.keys().__iter__() |
64 | a7cb58ce | Shikhar Bhushan | |
65 | d095a59e | Shikhar Bhushan | def __repr__(self): |
66 | d095a59e | Shikhar Bhushan | return repr(self._dict.keys()) |
67 | a7cb58ce | Shikhar Bhushan | |
68 | 94803aaf | Shikhar Bhushan | def __list__(self): |
69 | 94803aaf | Shikhar Bhushan | return self._dict.keys() |
70 | a7cb58ce | Shikhar Bhushan | |
71 | 216bb34c | Shikhar Bhushan | def add(self, uri): |
72 | 216bb34c | Shikhar Bhushan | "Add a capability"
|
73 | 216bb34c | Shikhar Bhushan | self._dict[uri] = _abbreviate(uri)
|
74 | a7cb58ce | Shikhar Bhushan | |
75 | 216bb34c | Shikhar Bhushan | def remove(self, uri): |
76 | 216bb34c | Shikhar Bhushan | "Remove a capability"
|
77 | d095a59e | Shikhar Bhushan | if key in self._dict: |
78 | d095a59e | Shikhar Bhushan | del self._dict[key] |
79 | a7cb58ce | Shikhar Bhushan | |
80 | 216bb34c | Shikhar Bhushan | def check(self, key): |
81 | 216bb34c | Shikhar Bhushan | """Whether specified capability is present.
|
82 | 216bb34c | Shikhar Bhushan |
|
83 | 216bb34c | Shikhar Bhushan | :arg key: URI or shorthand
|
84 | 216bb34c | Shikhar Bhushan |
|
85 | 216bb34c | Shikhar Bhushan | .. note:
|
86 | 216bb34c | Shikhar Bhushan | The *in* operation is the preferred form.
|
87 | 216bb34c | Shikhar Bhushan | """
|
88 | 216bb34c | Shikhar Bhushan | return key in self |
89 | a7cb58ce | Shikhar Bhushan | |
90 | 216bb34c | Shikhar Bhushan | def get_uris(self, shorthand): |
91 | 216bb34c | Shikhar Bhushan | return [uri for uri, abbrs in self._dict.items() if shorthand in abbrs] |
92 | a7cb58ce | Shikhar Bhushan | |
93 | 216bb34c | Shikhar Bhushan | #: :class:`Capabilities` object representing the capabilities currently supported by NCClient
|
94 | d095a59e | Shikhar Bhushan | CAPABILITIES = Capabilities([ |
95 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:base:1.0',
|
96 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:writable-running:1.0',
|
97 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:candidate:1.0',
|
98 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:confirmed-commit:1.0',
|
99 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:rollback-on-error:1.0',
|
100 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:startup:1.0',
|
101 | 0cdb8b3c | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:url:1.0?scheme=http,ftp,file,https,sftp',
|
102 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:validate:1.0',
|
103 | d6688264 | Shikhar Bhushan | 'urn:ietf:params:netconf:capability:xpath:1.0',
|
104 | 0cdb8b3c | Shikhar Bhushan | #'urn:ietf:params:netconf:capability:notification:1.0', # TODO
|
105 | 0cdb8b3c | Shikhar Bhushan | #'urn:ietf:params:netconf:capability:interleave:1.0' # theoretically already supported
|
106 | a7cb58ce | Shikhar Bhushan | ]) |