Metadata-Version: 2.3
Name: yapyang
Version: 0.2.0
Summary: An open source Python package that helps developers to translate YANG (RFC6020/RFC7950) data models to Python.
License: Apache-2.0
Author: a.faria
Author-email: antonio.faria@nomios.co.uk
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: ordered-set (>=4.1.0,<5.0.0)
Project-URL: Documentation, https://nomios-opensource.github.io/yapyang
Project-URL: Repository, https://github.com/nomios-opensource/yapyang
Description-Content-Type: text/markdown

# Yet Another PYANG

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/nomios-opensource/yapyang/publish.yml)
![Codecov](https://img.shields.io/codecov/c/github/nomios-opensource/yapyang)  
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/yapyang)
![PyPI - Downloads](https://img.shields.io/pypi/dm/yapyang)
![GitHub License](https://img.shields.io/github/license/nomios-opensource/yapyang)

An open source Python package that helps developers to translate YANG (RFC6020/RFC7950) data models to Python. YAPYANG mimics the functionality of YANG data structures, enforces types through annotations, and supports JSON/XML ser/des. YAPYANG is authored by [Antonio Faria](https://github.com/movedempackets), governed as a [benevolent dictatorship](CODE_OF_CONDUCT.md), and distributed under [license](LICENSE)

> [!WARNING]
> YAPYANG is in construction, during this time no effort shall be afforded to migrations and backwards compatibility. See [versioning](#versioning).

## Quick Start

For convenience we've included a basic quick start below. Ensure that a supported version of [Python](https://devguide.python.org/versions/) and the latest version of [YAPYANG](https://github.com/nomios-opensource/yapyang/releases/latest) is installed.

Start by choosing the YANG model to translate. We've simplified OpenConfig interfaces.

```text
module openconfig-interfaces {
    namespace "http://openconfig.net/yang/interfaces";
    container interfaces {
        list interface {
            key "name";
            leaf name {
                type string;
            }
        }
    }
}
```

For each YANG node (module, container, list, and leaf) in the YANG model translate it into Python with YAPYANG through subclasses of the provided node types.

```py

from yapyang import *

class Name(LeafNode):
    __identifier__ = "name"

    value: str

class Interface(ListNode):
    __identifier__ = "interface"
    __key__ = "name"

    name: Name

class Interfaces(ContainerNode):
    __identifier__ = "interfaces"

    interface: Interface

class OpenConfigInterfaces(ModuleNode):
    __identifier__ = "openconfig-interfaces"
    __namespace__ = "http://openconfig.net/yang/interfaces"

    interfaces: Interfaces
```

Create instances of the translated YANG model nodes, add interface entries, and serialize to XML. Read the full [docs]().

```py

module = OpenConfigInterfaces(Interfaces(Interface()))
module.interfaces.interface.append(Name("xe-0/0/0"))
print(module.to_xml())
...

<interfaces xmlns="http://openconfig.net/yang/interfaces"><interface><name>xe-0/0/0</name></interface></interfaces>

```

## Versioning

Releases will follow semantic versioning (major.minor.patch). Before 1.0.0 breaking changes can be included in a minor release, therefore we highly recommend pinning this package.

## Contributing

Suggest a [feature]() or report a [bug](). Read our developer [guide](CONTRIBUTING.md).

## License

YAPYANG is distributed under the Apache 2.0 [license](LICENSE).

