# ncs.template Module
This module implements classes to simplify template processing.
## Classes
### *class* **Template**
Class to simplify applying of templates in a NCS service callback.
```python
Template(service, path=None)
```
Initialize a Template object.
The 'service' argument is the 'service' variable received in decorated cb\_create method in a service class. ('service' can in fact be any maagic.Node (except a Root node) instance with an underlying Transaction). It is also possible to provide a maapi.Transaction instance for the 'service' argument in which case 'path' must also be provided.
Example use:
```
vars = ncs.template.Variables()
vars.add('VAR1', 'foo')
vars.add('VAR2', 'bar')
vars.add('VAR3', 42)
template = ncs.template.Template(service)
template.apply('my-service-template', vars)
```
Members:
apply(...)
Method:
```python
apply(self, name, vars=None, flags=0)
```
Apply the template 'name'.
The optional argument 'vars' may be provided in form of a Variables instance.
Arguments:
* name -- template name (str)
* vars -- template variables (template.Variables)
* flags -- template flags (int, optional)
### *class* **Variables**
Class to simplify passing of variables when applying a template.
```python
Variables(init=None)
```
Initialize a Variables object.
The optional argument 'init' can be any iterable yielding a 2-tuple in the form (name, value).
Members:
add(...)
Method:
```python
add(self, name, value)
```
Add a value for the variable 'name'.
The value will be normalized and quoted as a valid XPath string literal before adding it to the internal list.
Quoting rules:
* No quotes in value: wrapped in single quotes ('value')
* Single quotes only: wrapped in double quotes ("it's")
* Double quotes only: wrapped in single quotes ('say "hello"')
* Both quote types: uses XPath concat() to combine safely quoted segments, e.g. concat('A',"'","'",'B','"') for A'B"
Arguments:
* name -- service variable name (str)
* value -- variable value (str, int, boolean)
add_plain(...)
Method:
```python
add_plain(self, name, value)
```
Add a value for the variable 'name'.
It's up to the caller to do proper quoting of value.
For arguments, see Variables.add()
append(...)
Method:
```python
append(self, object, /)
```
Append object to the end of the list.
clear(...)
Method:
```python
clear(self, /)
```
Remove all items from list.
copy(...)
Method:
```python
copy(self, /)
```
Return a shallow copy of the list.
count(...)
Method:
```python
count(self, value, /)
```
Return number of occurrences of value.
extend(...)
Method:
```python
extend(self, iterable, /)
```
Extend list by appending elements from the iterable.
index(...)
Method:
```python
index(self, value, start=0, stop=9223372036854775807, /)
```
Return first index of value.
Raises ValueError if the value is not present.
insert(...)
Method:
```python
insert(self, index, object, /)
```
Insert object before index.
pop(...)
Method:
```python
pop(self, index=-1, /)
```
Remove and return item at index (default last).
Raises IndexError if list is empty or index is out of range.
remove(...)
Method:
```python
remove(self, value, /)
```
Remove first occurrence of value.
Raises ValueError if the value is not present.
reverse(...)
Method:
```python
reverse(self, /)
```
Reverse *IN PLACE*.
sort(...)
Method:
```python
sort(self, /, *, key=None, reverse=False)
```
Sort the list in ascending order and return None.
The sort is in-place (i.e. the list itself is modified) and stable (i.e. the order of two equal elements is maintained).
If a key function is given, apply it once to each list item and sort them, ascending or descending, according to their function values.
The reverse flag can be set to sort in descending order.