root / docs / source / intro.rst @ 0b7d3b31
History | View | Annotate | Download (1 kB)
| 1 |
************* |
|---|---|
| 2 |
Introduction |
| 3 |
************* |
| 4 |
|
| 5 |
NCClient is a Python library for NETCONF clients. NETCONF is a network management protocol defined in :rfc:`4741`. |
| 6 |
|
| 7 |
It is meant for Python 2.6+ (not Python 3 yet, though). |
| 8 |
|
| 9 |
The features of NCClient include: |
| 10 |
|
| 11 |
* Request pipelining. |
| 12 |
* (A)synchronous RPC requests. |
| 13 |
* Keeps XML out of the way unless really needed. |
| 14 |
* Supports all operations and capabilities defined in :rfc:`4741`. |
| 15 |
* Extensible. New transport mappings and capabilities/operations can be easily added. |
| 16 |
|
| 17 |
The best way to introduce is of course, through a simple code example:: |
| 18 |
|
| 19 |
from ncclient import manager |
| 20 |
|
| 21 |
with manager.connect_ssh('host', 'username') as m:
|
| 22 |
assert(":url" in manager.server_capabilities)
|
| 23 |
with m.locked('running'):
|
| 24 |
m.copy_config(source="running", target="file://new_checkpoint.conf") |
| 25 |
m.copy_config(source="file://old_checkpoint.conf", target="running") |
| 26 |
|
| 27 |
It is recommended to use the high-level :class:`Manager` API where possible. It exposes almost all of the functionality. |
| 28 |
|