YANG Tools¶
Overview¶
YANG Tools provides a set of libraries to deal with YANG models and data modeled using them.
Behavior/Feature Changes¶
XML and JSON parsers now ensure type decimal64 values are validated to be within the range
implied by their fraction-digits statements.
New Features¶
No new features.
Removed Features¶
Code generation plugin APIs for yang-maven-plugin contained in the yang-maven-plugin-spi
artifact were removed.
The SchemaPath class has been removed.
Deprecated Features¶
No deprecated features.
Resolved Issues¶
The following table lists the issues resolved in this release.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
Unexpected error while processing submodule references |
Done |
10.0.0, 8.0.7, 9.0.1 |
||
Fix YangDataEffectiveStatement definition |
Done |
10.0.0, 8.0.8, 9.0.2 |
||
Data change event notification fails |
Done |
10.0.0, 7.0.18, 8.0.8, 9.0.2 |
||
xml to json translation creates duplicates. |
Done |
10.0.0 |
||
Failed to parse deviation statement present in submodule |
Done |
10.0.1, 8.0.9, 9.0.3 |
||
Node name collision for unique argument |
Done |
10.0.1, 8.0.9, 9.0.3 |
||
yang-xpath-impl depends on javax.inject |
Done |
10.0.1, 8.0.9, 9.0.3 |
||
Unexpected error processing source SourceIdentifier [ietf-network@2018-02-26] |
Done |
10.0.1, 8.0.9, 9.0.4 |
||
NormalizedNodeStreamWriter.create() ignores path |
Done |
10.0.2, 9.0.5 |
||
Fail to find unique argument node in augmented list |
Done |
10.0.3, 8.0.10, 9.0.6 |
||
Fail to process unsupported augment statement |
Done |
10.0.3, 8.0.10, 9.0.6 |
||
Instance identifier parser : handle inner quotes within quoted strings |
Done |
10.0.3, 8.0.10, 9.0.7 |
||
YangXPathExpression.interpretAsInstanceIdentifier() does not handle unqualified names |
Done |
10.0.3, 8.0.10, 9.0.7 |
||
Fail to process augmentation with empty grouping |
Done |
10.0.3, 8.0.10, 9.0.7 |
||
Fail to parse a list with unique statement when unsupported |
Done |
10.0.4, 8.0.10, 9.0.7 |
||
 |
Remove yang.model.api.SchemaPath |
Done |
10.0.0 |
|
PrefixToModule has cognitive issues |
Done |
10.0.0 |
||
Normalize Decimal64 scale in range constraints |
Done |
10.0.0 |
||
Do not use Class for ParserNamespace identification |
Done |
10.0.0 |
||
Enforce range constraints in DecimalStringCodec |
Done |
10.0.0 |
||
Audit users of NamespaceBehaviour.global() |
Done |
10.0.0 |
||
Do not use Class for IdentifierNamespace identification |
Done |
10.0.0 |
||
Improve EffectiveStatement definitions |
Done |
10.0.1 |
||
Expose pre-sized builders from Builders |
Done |
10.0.2 |
||
Reduce AbstractPrerequisite footprint |
Done |
10.0.4, 8.0.10, 9.0.7 |
||
Define a YangDataName in yang.common |
Done |
10.0.3 |
||
Remove SchemaAware NormalizedNode builders |
Done |
10.0.0 |
||
Remove yang-maven-plugin-spi APIs |
Done |
10.0.0 |
||
Split out yang-ir and IRSchemaSource |
Done |
10.0.0 |
Known Issues¶
The following table lists the known issues that exist in this release.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
Fail to process deviation/augmentation from multiple modules |
Resolved |
10.0.3, 7.0.18, 8.0.9, 9.0.6 |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
XML/JSON YangInstanceIdentifier codecs mis-handle key values |
Resolved |
10.0.4, 7.0.18, 8.0.0, 9.0.0 |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
Fail to process deviation of augmented node without feature support |
Resolved |
10.0.3, 8.0.9, 9.0.6 |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
Failed to process YANGs containing refine of a if-feature’d target |
Resolved |
10.0.0, 10.0.7, 7.0.18, 8.0.10, 9.0.0, 9.0.8 |
10.0.8, 11.0.0, 9.0.9 |
||
yang-maven-plugin execution is not reliably following the configuration |
Confirmed |
10.0.0 |
11.0.6, 13.0.2, 14.0.0 |
Resolved Issues in SR1¶
The following table lists the issues resolved in Service Release 1.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
Empty XML anydata nodes cannot be normalized |
Done |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
Fail to process deviation/augmentation from multiple modules |
Done |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
XML/JSON YangInstanceIdentifier codecs mis-handle key values |
Done |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
Fail to process deviation of augmented node without feature support |
Done |
10.0.5, 11.0.0, 8.0.10, 9.0.7 |
||
YangTextSchemaContextResolver needs to we aware of supported features |
Done |
10.0.5, 11.0.0 |
Known Issues in SR1¶
The following table lists the known issues that exist in Service Release 1.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
yang-maven-plugin elicits deprecation warning with maven-3.9.1 |
Resolved |
10.0.5, 8.0.10, 9.0.7 |
10.0.7, 11.0.0, 9.0.8 |
Resolved Issues in SR2¶
The following table lists the issues resolved in Service Release 2.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
XML parser omits leading/trailing whitespace in string values |
Done |
10.0.9, 11.0.1, 9.0.9 |
||
yang-maven-plugin elicits deprecation warning with maven-3.9.1 |
Done |
10.0.7, 11.0.0, 9.0.8 |
||
Failed to process YANGs containing refine of a if-feature’d target |
Done |
10.0.8, 11.0.0, 9.0.9 |
||
Enrich YangParserTestUtils with String literal YANG methods |
Done |
10.0.9, 11.0.0, 9.0.9 |
Known Issues in SR2¶
The following table lists the known issues that exist in Service Release 2.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
XmlParserStream reports “Unhandled mount-aware schema” |
Resolved |
10.0.9, 11.0.0, 3.0.17, 4.0.15, 5.0.10, 6.0.12, 7.0.18, 8.0.10, 9.0.8 |
10.0.10, 11.0.1, 9.0.9 |
||
CME in AbstractNodeContainerModificationStrategy.checkChildPreconditions() |
Resolved |
10.0.9, 11.0.1, 4.0.15, 5.0.10, 6.0.12, 7.0.18, 8.0.10, 9.0.8 |
10.0.10, 11.0.2, 9.0.9 |
||
XmlStringInstanceIdentifierCodec is using JSON encoding for writeValue() |
Resolved |
10.0.9, 11.0.2, 8.0.10, 9.0.8 |
10.0.10, 11.0.3, 9.0.9 |
||
Fail to parse YANG module with a node with if-feature augmented within grouping |
Resolved |
10.0.9, 11.0.0, 9.0.8 |
10.0.11, 11.0.4, 12.0.0, 9.0.9 |
Resolved Issues in SR3¶
The following table lists the issues resolved in Service Release 3.
Type |
Key |
Summary |
Resolution |
Fix Version(s) |
|---|---|---|---|---|
XmlParserStream reports “Unhandled mount-aware schema” |
Done |
10.0.10, 11.0.1, 9.0.9 |
||
CME in AbstractNodeContainerModificationStrategy.checkChildPreconditions() |
Done |
10.0.10, 11.0.2, 9.0.9 |
||
XmlStringInstanceIdentifierCodec is using JSON encoding for writeValue() |
Done |
10.0.10, 11.0.3, 9.0.9 |
||
Fail to parse YANG module with a node with if-feature augmented within grouping |
Done |
10.0.11, 11.0.4, 12.0.0, 9.0.9 |
||
Improve YangInstanceIdentifier serialization error reporting |
Done |
10.0.10, 11.0.3, 9.0.9 |
||
Enhance XML prefix assignment |
Done |
10.0.10, 11.0.3, 9.0.9 |
||
Validate ietf-restconf:yang-data substatements are unique |
Done |
10.0.10, 11.0.4, 12.0.0 |
||
Seal XmlCodec interface to deal with XmlCodecFactory warnings |
Done |
10.0.10, 11.0.1, 9.0.9 |
||
Expose YangInstanceIdentifier codec from codec factories |
Done |
10.0.10, 11.0.2, 9.0.9 |
Known Issues in SR3¶
The following table lists the known issues that exist in Service Release 3.
Type |
Key |
Summary |
Status |
Affected Version(s) |
Fix Version(s) |
|---|---|---|---|---|---|
Unstable NodeWithValue.toString() |
Resolved |
10.0.12, 11.0.5, 12.0.0, 13.0.0, 9.0.10 |
11.0.6, 13.0.1 |