robotframework-xmlvalidator 1.0.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

{robotframework_xmlvalidator-1.0.0.dist-info → robotframework_xmlvalidator-2.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: robotframework-xmlvalidator
-Version: 1.0.0
+Version: 2.0.0
 Summary: A Robot Framework test library for validating XML files against XSD schemas
 License: Apache-2.0
 Keywords: robotframework,xml,xsd,validation,test-library,test,testing,test-automation
@@ -25,9 +25,14 @@ Project-URL: Homepage, https://github.com/MichaelHallik/robotframework-xmlvalida
 Project-URL: Repository, https://github.com/MichaelHallik/robotframework-xmlvalidator
 Description-Content-Type: text/markdown
 
-[![PyPI version](https://img.shields.io/pypi/v/robotframework-xmlvalidator.svg)](https://pypi.org/project/robotframework-xmlvalidator/)
-[![License](https://img.shields.io/pypi/l/robotframework-xmlvalidator)](LICENSE)
-[![Tests](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/test.yml/badge.svg)](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/test.yml)
+| Version | License | Tests |
+|---------|---------|-------|
+| [![PyPI version](https://img.shields.io/pypi/v/robotframework-xmlvalidator.svg)](https://pypi.org/project/robotframework-xmlvalidator/) | [![License](https://img.shields.io/pypi/l/robotframework-xmlvalidator?cacheSeconds=600)](LICENSE) | [![Tests](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/test.yml/badge.svg)](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/test.yml) |
+
+| Downloads | Update Badge |
+|-----------|---------------|
+| [![Total Downloads](https://github.com/MichaelHallik/robotframework-xmlvalidator/raw/main/badge_pepy_downloads.svg)](https://pepy.tech/project/robotframework-xmlvalidator) | [![Run Badge Update](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/update_pepy_badge.yml/badge.svg)](https://github.com/MichaelHallik/robotframework-xmlvalidator/actions/workflows/update_pepy_badge.yml) |
+
 
 <details>
 <summary><strong>📚 Table of Contents</strong></summary>
@@ -46,14 +51,26 @@ Description-Content-Type: text/markdown
     - [Examples](#examples)
       - [Using a preloaded schema](#using-a-preloaded-schema)
       - [Defer schema loading to the test case(s)](#defer-schema-loading-to-the-test-cases)
-      - [Importing with preloaded XSD that requires a base\_url](#importing-with-preloaded-xsd-that-requires-a-base_url)
-      - [Importing with custom error\_facets](#importing-with-custom-error_facets)
+      - [Importing with preloaded XSD that requires a `base_url`](#importing-with-preloaded-xsd-that-requires-a-base_url)
+      - [Importing with custom `error_facets`](#importing-with-custom-error_facets)
+      - [Importing with \`fail\_on\_errors=True](#importing-with-fail_on_errorstrue)
       - [Further examples](#further-examples)
   - [Using the library](#using-the-library)
     - [Keyword overview](#keyword-overview)
+      - [Error collection](#error-collection)
+      - [Batch mode](#batch-mode)
+      - [Single file mode](#single-file-mode)
+      - [Test case status - fail\_on\_error](#test-case-status---fail_on_error)
+      - [Dyanmic XSD resolution](#dyanmic-xsd-resolution)
+    - [Error collection](#error-collection-1)
+      - [XSD Schema violations.](#xsd-schema-violations)
+      - [Malformed XML](#malformed-xml)
+      - [File-level issues](#file-level-issues)
+      - [Final note on error collection](#final-note-on-error-collection)
     - [Keyword documentation](#keyword-documentation)
     - [Keyword example usage](#keyword-example-usage)
       - [A few basic examples](#a-few-basic-examples)
+      - [Demo test suite file as examples](#demo-test-suite-file-as-examples)
       - [Integration tests as examples](#integration-tests-as-examples)
     - [Example console output](#example-console-output)
     - [Example CSV output](#example-csv-output)
@@ -75,6 +92,8 @@ Description-Content-Type: text/markdown
     - [Continuous Integration \& GitHub templates](#continuous-integration--github-templates)
   - [Class architecture (Simplified)](#class-architecture-simplified)
   - [Project Structure](#project-structure)
+  - [Changelog](#changelog)
+  - [Roadmap](#roadmap)
   - [License](#license)
   - [Author](#author)
 
@@ -99,7 +118,7 @@ It provides structured and detailed reporting of XML parse errors (malformed XML
 - Customizable error attributes (`path`, `reason`, `message`, etc.)
 - Batch validation and per-file error tracking
 - Export collected errors to CSV (with optional file name timestamping).
-- And more (see below and the keyword documentation).
+- And more.
 
 ---
 
@@ -147,11 +166,12 @@ See the [Robot Framework Library Scope docs](https://robotframework.org/robotfra
 
 ### Library arguments
 
-| Argument       | Type        | Required? | Description                                                                        |
-|----------------|-------------|-----------|------------------------------------------------------------------------------------|
-| `xsd_path`     | `str`       | No        | Path to an XSD file or folder to preload during initialization. In case of a folder, the folder must hold one file only.                                                                                                             |
-| `base_url`     | `str`       | No        | Base path used to resolve includes/imports within the provided XSD schema.         |
-| `error_facets` | `list[str]` | No        | The attributes of validation errors to collect and report (e.g., `path`, `reason`) |
+| Argument        | Type        | Required? | Description                                                                                                            | Default         |
+|-----------------|-------------|-----------|------------------------------------------------------------------------------------------------------------------------|-----------------|
+| `xsd_path`      | `str`       | No        | Path to an XSD file/folder to preload during initialization. In case of a folder, the folder must hold one file only.  | None            |
+| `base_url`      | `str`       | No        | Base path used to resolve includes/imports within the provided XSD schema.                                             | None            |
+| `error_facets`  | `list[str]` | No        | The attributes of validation errors to collect and report (e.g., `path`, `reason`)                                     | [path, reason]  |
+| `fail_on_error` | `bool`      | No        | Whether to fail the test case if one or more XML validation errors are found. Can be overridden per keyword call.      | True            |
 
 ### Examples
 
@@ -168,7 +188,7 @@ Library    xmlvalidator    xsd_path=path/to/schema.xsd
 Library    xmlvalidator
 ```
 
-#### Importing with preloaded XSD that requires a base_url
+#### Importing with preloaded XSD that requires a `base_url`
 
 ```robotframework
 Library    xmlvalidator    xsd_path=path/to/schema_with_include.xsd
@@ -177,7 +197,7 @@ Library    xmlvalidator    xsd_path=path/to/schema_with_include.xsd
 
 Use `base_url` when your XSD uses `<xs:include>` or `<xs:import>` with relative paths.
 
-#### Importing with custom error_facets
+#### Importing with custom `error_facets`
 
 Use the `error_facets` argument to control which attributes of detected errors will be collected and reported.
 
@@ -196,6 +216,21 @@ Library    xmlvalidator    xsd_path=schemas/schema.xsd
 ...                        error_facets=value, namespaces
 ```
 
+#### Importing with `fail_on_errors=True
+
+The fail_on_errors argument controls whether a test case should fail if XML validation errors are detected.
+
+It defaults to True.
+
+The library's batch validation behavior remains unchanged. That is, `fail_on_errors=True` does *not* short-circuit the validation process in any way.
+
+Set `fail_on_errors=False` to log validation issues without failing the test. This is useful for:
+
+- Non-blocking checks in dashboards or QA reports.
+- Legacy or transitional systems where some invalid files are expected.
+- Schema discovery or diagnostics, where conformance isn’t yet enforced.
+- Soft rollout of stricter validation rules, allowing time to adapt.
+
 #### Further examples
 
 See also the [library initialization Robot test file](test/integration/01_library_initialization.robot).
@@ -206,43 +241,154 @@ See also the [library initialization Robot test file](test/integration/01_librar
 
 ### Keyword overview
 
-| Keyword                  | Description |
-|--------------------------|-------------|
+Thi section merely provides a short summary of the library's capabilities.
+
+For more details, please see the [keyword documentation](https://michaelhallik.github.io/robotframework-xmlvalidator/XmlValidator.html).
+
+| Keyword                  | Description                                                         |
+|--------------------------|---------------------------------------------------------------------|
 | `Validate Xml Files`     | Validate one or more XML files against one or more XSD schema files |
-| `Reset Schema`           | Clear the currently loaded XSD schema |
-| `Reset Errors`           | Clear the set of collected errors |
-| `Get Schema`             | Get the current schema name or object |
-| `Log Schema`             | Log the currently loaded schema |
-| `Get Error Facets`       | Returns a list of the currently active error facets |
-| `Reset Error Facets`     | Reset the error facets to default (`path`, `reason`) |
+| `Reset Schema`           | Clear the currently loaded XSD schema                               |
+| `Reset Errors`           | Clear the set of collected errors                                   |
+| `Get Schema`             | Get the current schema name or object                               |
+| `Log Schema`             | Log the currently loaded schema                                     |
+| `Get Error Facets`       | Returns a list of the currently active error facets                 |
+| `Reset Error Facets`     | Reset the error facets to default (`path`, `reason`)                |
 
 The main keyword is `Validate Xml Files`. The other keywords are convenience/helper functions, e.g. 'Reset Error Facets'.
 
+#### Error collection
+
 The `Validate Xml Files` validates one or more XML files against one or more XSD schema files and collects and reports all encountered errors.
 
-The type of error that the keyword can detect is not limited to XSD violations, but may also pertain to malformed XML files (e.g. parse errors), empty files, unmatched XML files (no XSD match found), etc.
+The type of error that the keyword can detect is not limited to XSD violations, but may also pertain to malformed XML files, empty files, unmatched XML files (no XSD match found), etc.
 
 Errors that result from malformed XML files or from XSD violations support detailed error reporting. Using the `error_facets` argument you may specify the details the keyword should collect and report about captured errors.
 
-When operating in batch mode, the `Validate Xml Files` keyword always validates the entire set of passed XML files.
+#### Batch mode
+
+The `Validate Xml Files` keyword always validates the entire set of passed XML files.
 
-That is, when it encounters an error in a file, it does not fail. Rather, it collects the error details (as determined by the `error_facets` arg) and then continues validating the current file as well as any subsequent file(s).
+That is, when it encounters an error in a file, it does not fail and stop execution. Rather, it collects the error details (as determined by the `error_facets` arg) and then continues validating the current file as well as any subsequent file(s).
 
 In that fashion the keyword works through the entire set of files.
 
-When having finished checking the last file, it will log a summary of the test run and then proceed to report all collected errors in the console, in the RF log and, optionally, in the form of a CSV file.
+Once *all* files are processed it will log a summary of the test run and then proceed to report all collected errors in the console, in the RF log and, optionally, in the form of a CSV file.
 
-However, in case you want your test case to fail when one or more errors have been detected, you can use the ``fail_on_errors`` (bool) argument to make it so. It defaults to False. When setting it to True, then the keyword will still check each XML file (and collect possible errors), but after it has thus processed the batch, it will fail if one or more errors will have been detected.
+For example:
+- If you validate fifteen XML files and five of them contain schema violations or other errors, all files will still be processed.
+- Errors are simply collected throughout the run and reported collectively, only after the final file has been (fully) processed.
+- The test case will fail (assuming `fail_on_errors=True`) only after all files have been checked, ensuring comprehensive diagnostics.
 
-The keyword further supports the dynamic matching (i.e. pairing) of XML and XSD files, using either a 'by filename' or a 'by namespace' strategy. That means you can simply pass the paths to a folder containing XML files and to a folder containing XSD files and the keyword will determine which XSD schema file to use for each XML file. If the XML and XSD files reside in the same folder, you only have to pass one folder path. When no matching XSD schema could be identified for an XML file, this will be integrated into the mentioned summary and error reporting (the keyword will not fail).
+#### Single file mode
 
 Of course, you may also refer to specific XML/XSD files (instead of to folders). In that case, no matching will be attempted, but the keyword will simply try to validate the specified XML file against the specified XSD file.
 
-See for more details the keyword documentation.
+Actually, almost anything goes:
+
+- one folder with: one or more XML files and one or more XSD files
+- one folder with one or more XML files and another folder with one or more XSD files
+- one folder with one or more XML files and a single XSD file
+- a single XML file and a sigle XSD file
+
+#### Test case status - fail_on_error
+
+A test case that has resulted in the collection of one or more errors (of whatever type) will receive a status of FAIL. You can use the ``fail_on_errors`` (bool) argument to change this default behaviour. When set to `False`, the test cases's status will always be PASS, regardless whether errors were collected or not.
+
+#### Dyanmic XSD resolution
+
+The keyword further supports the dynamic matching (i.e. pairing) of XML and XSD files, using either a 'by filename' or a 'by namespace' strategy. That means you can simply pass the paths to a folder containing XML files and to a folder containing XSD files and the keyword will determine which XSD schema file to use for each XML file. If the XML and XSD files reside in the same folder, you only have to pass one folder path. When no matching XSD schema could be identified for an XML file, this will be integrated into the mentioned summary and error reporting (the keyword will not fail).
+
+### Error collection
+
+Errors that are collected and reported can be categorized as follows:
+
+#### XSD Schema violations.
+
+- Missing or extra elements that violate cardinality rules, e.g.:
+  - Verifies that all mandatory elements (minOccurs > 0) are present in the XML.
+  - Ensures that optional elements (minOccurs = 0) do not exceed their maximum allowed occurrences (maxOccurs).
+
+- Sequence and order violations:
+  - Validates the order of child elements within a parent element if the schema specifies a sequence model (`<xsd:sequence>`).
+  - Detects elements that are out of order or missing in a sequence.
+
+- Datatype violations:
+  - Ensures that element and attribute values conform to their specified datatypes (e.g., xs:string, xs:integer, xs:dateTime).
+  - Identifies invalid formats, such as incorrect date or time formats for xs:date and xs:dateTime.
+
+- Pattern and enumeration violations:
+  - Checks that values conform to patterns defined using `<xsd:pattern>`.
+  - Ensures that values fall within allowed enumerations specified in the schema.
+
+- Attribute validation:
+  - Verifies that required attributes are present.
+  - Ensures that attribute values adhere to their declared datatypes and constraints.
+
+- Namespace compliance:
+  - Validates that elements and attributes belong to the correct namespaces as defined in the schema.
+  - Detects namespace mismatches or missing namespace declarations.
+
+- Group model violations:
+  - Validates conformance with `<xsd:choice>` and `<xsd:all>` group models, ensuring correct usage of child elements as per the schema.
+
+- Referential constraints:
+  - Checks for violations in `<xsd:key>`, `<xsd:keyref>`, and `<xsd:unique>` constraints.
+
+- Document structure and completeness:
+  - Ensures that the XML document adheres to the hierarchical structure defined by the schema.
+  - Detects incomplete or improperly nested elements.
+
+- General schema violations:
+  - Detects schema-level issues, such as invalid imports or includes, during schema compilation if they affect validation.
+
+#### Malformed XML
+
+Malformed XML errors arise from issues that prevent the XML file from being parsed at all, before schema validation can even occur. These errors typically reflect syntactic problems in the structure or encoding of the XML content.
+
+Typical cases include:
+
+- Mismatched tags
+  - Opening and closing tags do not match.
+  - Example: `<Title>My Book</title>`
+
+- Unclosed elements
+  - Elements are left unclosed or self-closing syntax is incorrect.
+  - Example: `<Price>12.99`
+
+- Premature end-of-file
+  - The file ends abruptly before all tags are closed, often due to truncation or corruption.
+  - Example: `<Product><ID>123`
+
+- Invalid characters or encoding
+  - The XML includes characters that are not valid in the declared encoding or in XML itself.
+  - Example: Control characters or non-UTF-8 bytes.
+
+- Misused namespaces
+  - Prefixes declared but not bound, or invalid namespace URIs used.
+
+- Declaration errors
+  - Malformed or duplicate `<?xml ... ?>` declarations.
+
+#### File-level issues
+
+General errors that do not pertain to syntax or schema issues:
+
+| Error Type   | Description                               |
+|--------------|-------------------------------------------|
+| Missing File | The specified XML file could not be found |
+| Empty File   | The file exists but is completely empty   |
+| Wrong Format | The file is not `.xml` or `.xsd`          |
+
+#### Final note on error collection
+
+On account of the purpose of this library, all encountered errors (regardless the involved types) are collected and reported. The validator analyzes all files, collects encountered errors (if any) and, finally, reports the results of the run in the console and in the Robot Framework log.
+
+Every test case in which one or more errors have been collected, will receive status FAIL unless `fail_on_errors=True` (see earlier explanations).
 
 ### Keyword documentation
 
-See [keyword documention](docs/XmlValidator.html).
+See the [keyword documentation](https://michaelhallik.github.io/robotframework-xmlvalidator/XmlValidator.html).
 
 The keyword documentation provides detailed descriptions of all functionalities, features and the various ways in which the library and its keywords can be employed.
 
@@ -287,6 +433,10 @@ Validate Folder With Multiple Schemas By File Name
     Validate Xml Files    ${FOLDER_MULTIPLE_XML_XSD_FN}    xsd_search_strategy=by_file_name
 ```
 
+#### Demo test suite file as examples
+
+See the [demo test suite](test/demo/demo.robot) for a demo test suite that demonstrates the most important features of the library in a concise fashion.
+
 #### Integration tests as examples
 
 Note that the [integration test](test/integration) folder contains seven Robot Framework test suite files.
@@ -403,7 +553,7 @@ These are the facets (or attributes) that can be collected and reported for each
 | `severity`    | The severity level of the error (not always present).                      |
 | `args`        | The arguments passed to the error message formatting.        
 
-Use the `error_facets` arg to set which error details to collect.
+Use the `error_facets` argument to set which error details to collect.
 
 For each error that is encountered, the selected error facet(s) will be collected and reported.
 
@@ -413,7 +563,7 @@ You can customize which error facet(s) should be collected, by passing a list of
 
 Error facets passed during library initialization will be overruled by error facets that are passed at the test case level, when calling the `Validate Xml Files` keyword.
 
-The values you can pass through the `error_facets` argument are based on the attributes of the error objects as returned by the XMLSchema.iter_errors() method, that is provided by the xmlschema library and the the xmlvalidator library leverages. Said method yields instances of xmlschema.validators.exceptions.XMLSchemaValidationError (or its subclasses), each representing a specific validation issue encountered in an XML file. These error objects expose various attributes that describe the nature, location, and cause of the problem.
+The values you can pass through the `error_facets` argument are based on the attributes of the error objects as returned by the XMLSchema.iter_errors() method, that is provided by the xmlschema library and the xmlvalidator library leverages. Said method yields instances of xmlschema.validators.exceptions.XMLSchemaValidationError (or its subclasses), each representing a specific validation issue encountered in an XML file. These error objects expose various attributes that describe the nature, location, and cause of the problem.
 
 The table lists the most commonly available attributes, though additional fields may be available depending on the type of validation error.
 
@@ -427,7 +577,7 @@ The table lists the most commonly available attributes, though additional fields
 | [CHANGELOG](CHANGELOG.md) | User / Dev | Version history, features |
 | [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) | Dev | Community guidelines |
 | [CONTRIBUTING](CONTRIBUTING.md) | Dev | Contribute |
-| [Mermaid diagram of GitHub Actions](github_actions.md) | Dev | CI, GitHub Actions |
+| [Mermaid diagram of GitHub Actions](docs/images/github_actions.md) | Dev | CI, GitHub Actions |
 | [License](LICENSE) | All | Legal usage terms |
 | [Make file](Makefile) | Dev | Automation, commands |
 | [Project Structure](project_structure.txt) | Dev | Project layout |
@@ -450,7 +600,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 The overall process:
 
-![Contributing to the project](./docs/images/contributing.JPG)
+![Contributing to robotframework-xmlvalidator](./docs/images/contributing.JPG)
 
 This project uses Poetry for dependency and packaging management.
 
@@ -475,7 +625,7 @@ poetry install
 poetry shell
 ```
 
-Or, if you use a different virt env, activate that.
+Or, if you use a different virt environment, activate that.
 
 ### Running tests
 
@@ -535,7 +685,7 @@ GitHub Actions CI is defined under [github/workflows/](.github/workflows/), in p
 
 The test workflow:
 
-![Test workflow diagram](./docs/images/test_workflow.JPG)
+![Workflow diagram for the robotframework-xmlvalidator project](./docs/images/test_workflow.JPG)
   
 In [.github/](.github/) you’ll also find the various contribution templates:
 
@@ -675,6 +825,18 @@ requirements.txt                     # Requirements file for users (pip)
 
 ---
 
+## Changelog
+
+For a list of changes across versions, including recent behavioral changes in validation logic, see the [CHANGELOG](https://github.com/MichaelHallik/robotframework-xmlvalidator/blob/main/CHANGELOG.md).
+
+---
+
+## Roadmap
+
+See the [project roadmap](ROADMAP.md) for upcoming features and ideas.
+
+---
+
 ## License
 
 Licensed under the Apache License 2.0. See [LICENSE](LICENSE).

robotframework_xmlvalidator-2.0.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+xmlvalidator/__init__.py,sha256=xsEr0B8N7ex4bh5xyYPoxUP3nYofoEI2ANT94jrOlCk,2293
+xmlvalidator/xml_validator_results.py,sha256=JDkoGLO91HE7Ar1HXWLj7Olc0VtLZH_e43JAPPrWykA,13124
+xmlvalidator/xml_validator_utils.py,sha256=VPSwcLVziuR9erj-jYRqvHKP-jrFf1bcrgshxcSqXKA,17807
+xmlvalidator/XmlValidator.py,sha256=a3vZVGIKXyNKD7UQk8AOrHKvRu1-sQSiyquo-0eiDbc,75204
+robotframework_xmlvalidator-2.0.0.dist-info/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+robotframework_xmlvalidator-2.0.0.dist-info/METADATA,sha256=5dJCEUl5Kmp41hI_2Qby-yX1UZFZcQD4oyJWKapijY0,38768
+robotframework_xmlvalidator-2.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+robotframework_xmlvalidator-2.0.0.dist-info/RECORD,,

xmlvalidator/XmlValidator.py

@@ -40,9 +40,9 @@ or executed as a Python module via a direct call.
 """
 
 
-# pylint: disable=C0103:invalid-name      # On account of the module name, that is not snake-cased (required by Robot Framework).
-# pylint: disable=C0302:too-many-lines    # On account of the extensive docstrings and annotations.
-# pylint: disable=C0301:line-too-long     # On account of tables in docstrings.
+# pylint: disable=C0103:invalid-name   # On account of the module name, that is not snake-cased (required by Robot Framework).
+# pylint: disable=C0302:too-many-lines # On account of the extensive docstrings and annotations.
+# pylint: disable=C0301:line-too-long  # On account of tables in docstrings.
 
 
 # Standard library imports.
@@ -82,9 +82,9 @@ class XmlValidator:
     The other keywords are convenience/helper functions, e.g. ``Reset 
     Error Facets``.
 
-    The ``Validate Xml Files`` validates one or more XML files against one 
-    or more XSD schema files and collects and reports all encountered 
-    errors.
+    The ``Validate Xml Files`` validates one or more XML files against 
+    one or more XSD schema files and collects and reports all 
+    encountered errors.
 
     The type of error that the keyword can detect is not limited to XSD 
     violations, but may also pertain to malformed XML files (e.g. parse 
@@ -92,16 +92,16 @@ class XmlValidator:
     others.
 
     Errors that result from malformed XML files or from XSD violations 
-    support detailed error reporting. Using the ``error_facets`` argument 
-    you may specify the details the keyword should collect and report 
-    about captured errors.
+    support detailed error reporting. Using the ``error_facets`` 
+    argument you may specify the details the keyword should collect and 
+    report about captured errors.
 
     When operating in batch mode, the ``Validate Xml Files`` keyword 
     always validates the entire set of passed XML files. That is, when 
-    it encounters an error in a file, it does not simply fail. Rather, 
-    it collects the error details (as determined by the error_facets 
-    arg) and then continues validating the current file as well as any 
-    subsequent file(s).
+    it encounters an error in a file, it does not simply then fail.
+    Rather, it collects the error details (as determined by the 
+    error_facets arg) and then continues validating the current file as 
+    well as any subsequent file(s).
 
     In that fashion the keyword works through the entire set of files.
 
@@ -158,12 +158,14 @@ class XmlValidator:
      - Namespace errors.
      - Etc.
 
-    - Captures malformed XML.
+    - Captures malformed XML (e.g. missing closing tag, encoding 
+      issues).
     - Handles edge cases like empty files or XML files that could not be 
       matched to an XSD schema file.
-    - Does not fail on errors, but collects encountered errors in all 
-      files and reports them in a structured format in the console and 
-      RF log.
+    - Does not immediately fail on errors, but collects encountered all 
+      errors in all files and reports them in a structured format in the 
+      console and RF log. Only *then* fails (assuming one or more 
+      errors have been collected).
     - Supports specifying the details that should be collected for 
       encountered errors.
     - Optionally exports the error report to a CSV file, providing the 
@@ -236,23 +238,13 @@ class XmlValidator:
     Enables resolution of schema imports/includes via a custom base URL, 
     via the ``base_url`` arg.
 
-    Use ``base_url`` when your XSD uses <xs:include> or <xs:import> with 
-    relative paths.
+    Use ``base_url`` when your XSD uses ``<xs:include>`` or ``<xs:import>``
+    with relative paths.
 
     You can pass ``base_url`` with the library import (together with 
     passing ``xsd_path``) and/or when calling ``Validate Xml Files`` 
     with ``xsd_path``.
 
-    ** Optional test case fail **
-
-    The ``Validate Xml Files`` keyword collects one or more errors for 
-    one or more XML files. As mentioned earlier, the keyword is designed 
-    so as to not fail upon encountering errors.
-
-    However, in case you want your test case to fail when one or more 
-    errors have been detected, you can use the ``fail_on_errors`` (bool)
-    argument to make it so. It defaults to ${False}.
-
     **Basic usage examples**
 
     For a comprehensive set of example test cases, please see the 
@@ -266,6 +258,18 @@ class XmlValidator:
     It further contains a detailed instruction on 
     `how to run Robot Framework tests <https://github.com/MichaelHallik/robotframework-xmlvalidator/blob/main/test/_doc/integration/README.md>`_.
 
+    Finally, the repo also contains a `demo test suite file <https://github.com/MichaelHallik/robotframework-xmlvalidator/blob/main/test/demo/demo.robot>`_ containing 
+    eight self-contained test cases to demonstrates the following features:
+    
+    - Single and batch XML validation
+    - Schema matching by filename and namespace
+    - Custom error facets
+    - Malformed XML handling
+    - XSD includes/imports
+    - CSV export
+
+    A test suite file may look like the following:
+
 	.. code:: robotframework
 
 		*** Settings ***
@@ -361,21 +365,8 @@ class XmlValidator:
         [ WARN ]    XML is invalid:
         [ WARN ]        Error #0:
         [ WARN ]            reason: No matching XSD found for: no_xsd_match_2.xml.
-        Validation errors exported to 'C:\\test\\01_Advanced_Validation\\errors_2025-03-29_13-54-46-552150.csv'.
-        Total_files validated: 11.
-        Valid files: 6.
-        Invalid files: 5
-        01 Advanced Validation:: Demo XML validation | PASS |
-        21 errors have been detected.
-        ========================================================
-        01 Advanced Validation:: Demo XML validation | PASS |
-        1 test, 1 passed, 0 failed
-
-    In case ``fail_on_errors`` is True, the console output will look like this:
-
-    .. code:: console
-
-        Validation errors exported to 'C:\\test\\01_Advanced_Validation\\errors_2025-03-29_13-54-46-552150.csv'.
+        Validation errors exported to:
+            'C:\\test\\01_Advanced_Validation\\errors_2025-03-29_13-54-46-552150.csv'.
         Total_files validated: 11.
         Valid files: 6.
         Invalid files: 5.
@@ -384,8 +375,8 @@ class XmlValidator:
         ========================================================
         01 Advanced Validation:: Demo XML validation | FAIL |
         1 test, 0 passed, 1 failed
-        
-    The corresponding CSV output would in both cases look like:
+
+    The corresponding CSV output will look like:
 
     .. code:: text
 
@@ -402,16 +393,17 @@ class XmlValidator:
 
     """
 
-    __version__ = '1.0.0'
+    __version__ = '2.0.0'
     ROBOT_LIBRARY_DOC_FORMAT = 'reST'
     nr_instances = 0
 
     def __init__(
-            self,
-            xsd_path: Optional[str | Path] = None,
-            base_url: Optional[str] = None,
-            error_facets: Optional[ List[str] ] = None
-            ) -> None:
+        self,
+        xsd_path: str | Path | None = None,
+        base_url: str | None = None,
+        error_facets: List[str] | None = None,
+        fail_on_errors: bool = True
+    ) -> None:
         """
         **Library Scope**
 
@@ -421,16 +413,19 @@ class XmlValidator:
 
         **Library Arguments**
 
-        +--------------+--------------+-----------+---------------------------------------------------------------------------------------------+
-        | Argument     | Type         | Required  | Description                                                                                 |
-        +==============+==============+===========+=============================================================================================+
-        | xsd_path     | str          | No        | Path to an XSD file or folder to preload during initialization.                             |
-        |              |              |           | In case of a folder, the folder must hold one file only.                                    |
-        +--------------+--------------+-----------+---------------------------------------------------------------------------------------------+
-        | base_url     | str          | No        | Base path used to resolve includes/imports within the provided XSD schema.                  |
-        +--------------+--------------+-----------+---------------------------------------------------------------------------------------------+
-        | error_facets | list of str  | No        | The attributes of validation errors to collect and report. E.g. ``path``, ``reason``.       |
-        +--------------+--------------+-----------+---------------------------------------------------------------------------------------------+
+        +---------------+-------------+----------+---------------------------------------------------------------------------------------------+----------------+
+        | Argument      | Type        | Required | Description                                                                                 | Default        |
+        +===============+=============+==========+=============================================================================================+================+
+        | xsd_path      | str         | No       | Path to an XSD file or folder to preload during initialization.                             | None           |
+        |               |             |          | In case of a folder, the folder must hold one file only.                                    |                |
+        +---------------+-------------+----------+---------------------------------------------------------------------------------------------+----------------+
+        | base_url      | str         | No       | Base path used to resolve includes/imports within the provided XSD schema.                  | None           |
+        +---------------+-------------+----------+---------------------------------------------------------------------------------------------+----------------+
+        | error_facets  | list of str | No       | The attributes of validation errors to collect and report. E.g. ``path``, ``reason``.       | [path, reason] |
+        +---------------+-------------+----------+---------------------------------------------------------------------------------------------+----------------+
+        | fail_on_error | bool        | No       | Whether to fail the test case if one or more XML validation errors are found.               | True           |
+        |               |             |          | Can be overridden per keyword call.                                                         |                |
+        +---------------+-------------+----------+---------------------------------------------------------------------------------------------+----------------+
 
         All arguments are optional.
 
@@ -485,6 +480,30 @@ class XmlValidator:
         
         See the introduction for more details on the purpose and usage 
         of error facets.
+
+        ``fail_on_error``
+
+        The ``fail_on_errors`` argument controls whether a test case 
+        should fail if one or more XML validation errors are detected. 
+        It defaults to True. A test case that has resulted in the 
+        collection of one or more errors (of whatever type) will then 
+        receive a status of FAIL.
+        
+        You can use the ``fail_on_errors`` argument to change this 
+        default behaviour. When set to False, a test cases's status will 
+        always be PASS, regardless whether errors were collected or not.
+
+        This may be useful for:
+        
+        - Non-blocking checks in dashboards or QA reports.
+        - Legacy or transitional systems where some invalid files are expected.
+        - Schema discovery or diagnostics, where conformance isn’t yet enforced.
+        - Soft rollout of stricter validation rules, allowing time to adapt.
+
+        Note that with ``fail_on_error=True`` the library's batch 
+        validation behavior remains unchanged by the latter. That is, 
+        fail_on_errors=True does not short-circuit the validation 
+        process in any way.
         
         **Examples**
 
@@ -530,6 +549,8 @@ class XmlValidator:
         For more examples see the project's 
         `Robot Framework integration test suite <https://github.com/MichaelHallik/robotframework-xmlvalidator/blob/main/test/integration/01_library_initialization.robot>`_.
 
+        And also the `demo test suite file <https://github.com/MichaelHallik/robotframework-xmlvalidator/blob/main/test/demo/demo.robot>`_.
+
         **Raises**
 
         +---------------+--------------------------------------------------------------+
@@ -549,62 +570,38 @@ class XmlValidator:
         self.validator_utils = ValidatorUtils()
         self.validator_results = ValidatorResultRecorder()
         # Initialize the xsd schema from the xsd_path, if provided.
-        if xsd_path:
-            # Try to get a single xsd file from the provided xsd_path.
-            xsd_file_path, is_single_xsd_file = (
-                self.validator_utils.get_file_paths(
-                    xsd_path, 'xsd'
-                    )
-                )
-            # We need (a path to) a single xsd file.
-            if not is_single_xsd_file:
-                raise ValueError(f"Got multiple xsd files: {xsd_file_path}.")
-            # Handle incorrect file extension.
-            if xsd_file_path[0].suffix != '.xsd':
-                # Raise a load error.
-                raise SystemError(
-                    f"ValueError: {xsd_file_path[0]} is not an XSD file."
-                    )
-            # Try to load the provided XSD file.
-            result = self._load_schema(xsd_file_path[0], base_url )
-            if result.success:
-                # Set the loaded XSD file as default schema.
-                self.schema = result.value
-                logger.info(
-                    f"Schema '{self.schema.name}' set.", # type: ignore
-                    also_console=True)
-            else:
-                # Or report the load error.
-                raise SystemError(f"Loading of schema failed: {result.error}")
-        # Or inform the user on what to do.
-        else:
-            logger.info(
-                "No XSD schema set: provide schema(s) during keyword calls.",
-                also_console=True
-                )
-            # And flag the schema attr as None.
-            self.schema = None
+        self.schema = self._try_load_initial_schema(
+            xsd_path=xsd_path, base_url=base_url
+        )
         # Set the error facets to collect for failed XML validations.
         self.error_facets = error_facets if error_facets else [
             'path', 'reason'
-            ]
+        ]
         logger.info(
             f"Collecting error facets: {self.error_facets}.",
             also_console=True
-            )
+        )
+        # Set the validation strictness.
+        self.fail_on_errors = fail_on_errors
+        logger.info(
+            f"Fail on errors: {self.fail_on_errors}.", also_console=True
+        )
+        # Report readiness.
         logger.info("XML Validator ready for use!", also_console=True)
         self.nr_instances += 1
-        logger.info(f'Number of library instances: {self.nr_instances}.')
+        logger.info(
+            f'Number of library instances: {self.nr_instances}.'
+        )
 
     def _determine_validations(
-            self,
-            xml_paths: List[Path],
-            xsd_path: Optional[str|Path] = None,
-            xsd_search_strategy: Optional[
+        self,
+        xml_paths: List[Path],
+        xsd_path: Optional[str|Path] = None,
+        xsd_search_strategy: Optional[
                 Literal['by_namespace', 'by_file_name']
                 ] = None,
-            base_url: Optional[str] = None
-            ) -> Dict[Path, Path | None]:
+        base_url: Optional[str] = None
+        ) -> Dict[Path, Path | None]:
         """
         Constructs a mapping between XML files and the XSD schemas to 
         use for their validation.
@@ -744,10 +741,10 @@ class XmlValidator:
         return validations
 
     def _ensure_schema(
-            self,
-            xsd_path: Optional[Path] = None,
-            base_url: Optional[str] = None
-            ) -> ValidatorResult:
+        self,
+        xsd_path: Optional[Path] = None,
+        base_url: Optional[str] = None
+        ) -> ValidatorResult:
         """
         Ensures that a schema is available for validation.
 
@@ -815,29 +812,26 @@ class XmlValidator:
                 "No schema: provide an XSD path during keyword call(s)."
                 )
         if self.schema and not xsd_path :
-            logger.info(
-                f'No new schema set: keeping existing schema {self.schema}.'
-                )
+            # logger.info(
+            #     f'No new schema set: keeping existing schema {self.schema}.'
+            #     )
             return ValidatorResult(success=True, value=self.schema)
         if not self.schema and xsd_path:
             logger.info(f'Setting schema file: {xsd_path}.', also_console=True)
         if self.schema and xsd_path:
             logger.info(
-                f'Setting new schema file: {xsd_path}.',
+                f'\tUsing schema: {xsd_path}.',
                 also_console=True
                 )
         return self._load_schema(xsd_path, base_url) # pyright: ignore
 
     def _find_schemas(
-            self,
-            xml_file_paths: List[Path],
-            xsd_file_paths: List[Path],
-            search_by: Literal[
-                'by_namespace',
-                'by_file_name'
-                ] = 'by_namespace',
-            base_url: Optional[str] = None
-            ) -> Dict[ Path, Path | None ]:
+        self,
+        xml_file_paths: List[Path],
+        xsd_file_paths: List[Path],
+        search_by: Literal['by_namespace', 'by_file_name'] = 'by_namespace',
+        base_url: Optional[str] = None
+        ) -> Dict[ Path, Path | None ]:
         """
         Finds matching XSD schemas for XML files using the specified 
         search strategy.
@@ -929,13 +923,13 @@ class XmlValidator:
                 # Catch and handle any exception.
                 except Exception as err: # pylint: disable=W0718:broad-exception-caught
                     # Inform the user.
-                    logger.warn('Processing XML file failed.')
+                    logger.info('\t\tProcessing XML file failed.')
                     # Collect the error to be mapped to the xml file.
                     validations[xml_file_path] = err
                     continue
                 # Test each XSD file for a matching namespace.
                 for xsd_file_path in xsd_file_paths:
-                    logger.info(f"Testing schema: {xsd_file_path}.")
+                    logger.info(f"\t\tTesting schema: {xsd_file_path}.")
                     # Load the schema.
                     result = self._load_schema(
                         xsd_file_path, base_url=base_url
@@ -963,7 +957,7 @@ class XmlValidator:
                     logger.info(f"\t\t\tTesting file name: {xsd_file_path}.")
                     # Compare the XSD/XML file names.
                     if xsd_file_path.stem == xml_file_path.stem:
-                        logger.info("\t\t\tFound match.")
+                        logger.info("\t\tFound match.")
                         # Assign current XSD path in case of a match & break.
                         validations[xml_file_path] = xsd_file_path
                         break
@@ -975,17 +969,17 @@ class XmlValidator:
                 raise ValueError(f"Unsupported search strategy: {search_by}.")
             # If no match has been found.
             if not validations[xml_file_path]:
-                logger.info(f"No valid XSD found for {xml_file_path}.")
+                logger.info(f"\t\tNo valid XSD found for {xml_file_path}.")
                 validations[xml_file_path] = FileNotFoundError(
                     f'No matching XSD found for: {xml_file_path.stem}.'
                     )
         return validations
 
     def _load_schema(
-            self,
-            xsd_path: Path,
-            base_url: Optional[str] = None
-            ) -> ValidatorResult:
+        self,
+        xsd_path: Path,
+        base_url: Optional[str] = None
+        ) -> ValidatorResult:
         """
         This method is responsible for initializing a schema object, 
         using the `xmlschema` library.
@@ -1036,17 +1030,96 @@ class XmlValidator:
                 success=False, error={"XMLSchemaValidationError": e}
                 )
 
-    def _validate_xml(self, # pylint: disable=R0913:too-many-arguments disable=R0917:too-many-positional-arguments
-                      xml_file_path: Path,
-                      xsd_file_path: Optional[Path] = None,
-                      base_url: Optional[str] = None,
-                      error_facets: Optional[ List[str] ] = None,
-                      pre_parse: Optional[bool] = True
-                      ) -> Tuple[
-                          bool, Optional[
-                              List[ dict[str, Any] ]
-                              ]
-                            ]:
+    def _try_load_initial_schema(
+        self,
+        xsd_path: Optional[str|Path] = None,
+        base_url: Optional[str] = None
+        ) -> None:
+        """
+        Attempts to resolve, validate, and load a single XSD schema from 
+        the provided path.
+
+        This method is invoked during library initialization (i.e., 
+        within `__init__`) when an optional `xsd_path` is provided. If a 
+        path is provided, this method expects the path to resolve to 
+        exactly one valid`.xsd` file. If successful, the compiled schema 
+        is returned and stored in `self.schema`.
+
+        If the path points to a directory, the method searches for a 
+        single `.xsd` file inside it. If multiple matching files are 
+        found, or if the file extension is incorrect, an error is 
+        raised.
+
+        This method is not intended to be used interactively — it is a 
+        one-time helper to support declarative schema configuration 
+        during import of the test library.
+
+        Args:
+        
+        - xsd_path (str):
+          Path to a `.xsd` file or to a directory containing exactly one 
+          `.xsd` file.
+        - base_url (Optional[str]):
+          Optional base URL used when parsing the schema, typically to 
+          resolve includes.
+
+        Raises:
+        
+        - ValueError:
+          If multiple `.xsd` files are found in the provided directory.
+        - SystemError:
+          If the resolved file does not have a `.xsd` extension or the 
+          schema fails to load.
+        """
+        if xsd_path:
+            # Try to get a single xsd file from the provided xsd_path.
+            xsd_file_path, is_single_xsd_file = (
+                self.validator_utils.get_file_paths(
+                    xsd_path, 'xsd'
+                    )
+                )
+            # We need (a path to) a single xsd file.
+            if not is_single_xsd_file:
+                raise ValueError(
+                    f"Got multiple xsd files: {xsd_file_path}."
+                    )
+            # Handle incorrect file extension.
+            if xsd_file_path[0].suffix != '.xsd':
+                # Raise a load error.
+                raise SystemError(
+                    f"ValueError: {xsd_file_path[0]} is not an XSD file."
+                    )
+            # Try to load the provided XSD file.
+            result = self._load_schema(xsd_file_path[0], base_url )
+            if result.success:
+                # Set the loaded XSD file as default schema.
+                logger.info(
+                    f"Schema '{self.schema.name}' set.", # type: ignore
+                    also_console=True)
+                return result.value
+            # Or report the load error.
+            raise SystemError(
+                f"Loading of schema failed: {result.error}"
+                )
+        # Or inform the user on what to do.
+        logger.info(
+            "No XSD schema set: provide schema(s) during keyword calls.",
+            also_console=True
+            )
+        # And explicitly flag the schema attr as None.
+        return None
+
+    def _validate_xml( # pylint: disable=R0913:too-many-arguments disable=R0917:too-many-positional-arguments
+        self,
+        xml_file_path: Path,
+        xsd_file_path: Optional[Path] = None,
+        base_url: Optional[str] = None,
+        error_facets: Optional[ List[str] ] = None,
+        pre_parse: Optional[bool] = True
+        ) -> Tuple[
+            bool,
+            Optional[List[dict[str, Any]]]
+            ]:
         """
         Validates an XML file against the currently loaded or provided 
         XSD schema.
@@ -1193,7 +1266,7 @@ class XmlValidator:
         """
         # Log informative.
         logger.info(
-            f"Validating '{xml_file_path.stem}'.", also_console=True
+            f"Validating '{xml_file_path.name}", also_console=True
             )
         # Check upstream XSD matching led to an err pertaining to the XML.
         if isinstance(xsd_file_path, BaseException):
@@ -1211,7 +1284,7 @@ class XmlValidator:
             )
         if not sanity_check_result.success:
             # Abort validation if one or more sanity checks failed.
-            logger.warn("File(s) failed basic sanity check.")
+            # logger.warn("File(s) failed basic sanity check.")
             return False, sanity_check_result.error
         # Ensure a valid schema is loaded.
         loading_result = self._ensure_schema(
@@ -1259,9 +1332,7 @@ class XmlValidator:
         return self.error_facets
 
     @keyword
-    def get_schema(
-        self,
-        return_schema_name: bool = True
+    def get_schema(self,return_schema_name: bool = True
         ) -> Optional[str|XMLSchema]:
         """
         .. raw:: html
@@ -1389,7 +1460,7 @@ class XmlValidator:
         write_to_csv: Optional[bool] = True,
         timestamped: Optional[bool] = True,
         reset_errors: bool = True,
-        fail_on_errors: Optional[bool] = False
+        fail_on_errors: Optional[bool] = None
         ) -> Tuple[
             List[ Dict[str, Any] ],
             str | None
@@ -1552,6 +1623,12 @@ class XmlValidator:
         # Reset attributes, if requested.
         if reset_errors:
             self.validator_results.reset()
+        # Determine the validation strictness.
+        fail_on_errors = (
+            fail_on_errors \
+                if fail_on_errors is not None \
+                    else self.fail_on_errors
+        )
         # Determine and resolve/normalize the XML file path(s).
         xml_file_paths, is_single_xml_file = (
             self.validator_utils.get_file_paths(

xmlvalidator/__init__.py

@@ -55,6 +55,6 @@ try:
     __version__ = version("robotframework-xmlvalidator")
 except PackageNotFoundError:
     # Fall back when package not installed (default version for development).
-    __version__ = "0.0.1"
+    __version__ = "2.0.0"
     import warnings
     warnings.warn("Package metadata not found, using fallback version.")

xmlvalidator/xml_validator_results.py

@@ -75,7 +75,7 @@ class ValidatorResultRecorder:
     and export validation results.
     """
 
-    __version__ = '1.0.0'
+    __version__ = '2.0.0'
 
     errors_by_file: List[Dict[str, Any]] = field(default_factory=list)
     validation_summary: Dict[str, List[str]] = field(
@@ -331,7 +331,7 @@ class ValidatorResultRecorder:
         try:
             df.to_csv(output_csv_path, index=False)
             logger.info(
-                f"Validation errors exported to '{output_csv_path}'.",
+                f"Validation errors exported to: \n\t'{output_csv_path}'.",
                 also_console=True
                 )
         except IOError as e:
@@ -364,7 +364,7 @@ class ValidatorResult: # pylint: disable=R0903:too-few-public-methods
         Error information if the operation failed.
     """
 
-    __version__ = '0.0.1'
+    __version__ = '1.0.1'
 
     def __init__(
             self,

xmlvalidator/xml_validator_utils.py

@@ -43,7 +43,6 @@ from pathlib import Path
 from typing import List, Optional, Tuple, Union, TYPE_CHECKING
 # Third party library imports.
 from lxml import etree
-from robot.api import logger
 # Local application imports.
 from .xml_validator_results import ValidatorResult
 if TYPE_CHECKING:
@@ -67,7 +66,7 @@ class ValidatorUtils:
     All methods are static and the class maintains no internal state.
     """
 
-    __version__ = '1.0.0'
+    __version__ = '2.0.0'
 
     @staticmethod
     def _resolve_path(path: str | Path) -> Path:
@@ -472,9 +471,9 @@ class ValidatorUtils:
                         if isinstance(value, tuple):
                             value = f"Line {value[0]}, Column {value[1]}."
                         error_details[facet] = value
-                    logger.warn(
-                        f"Facet '{facet}' is not an attribute of error type'{type(e).__name__}'."
-                        )
+                    # logger.warn(
+                    #     f"Facet '{facet}' is not an attribute of error type'{type(e).__name__}'."
+                    #     )
                 # Add the error type to the error details
                 error_details['Error type'] = type(e).__name__
                 # Append the error to the return list.

robotframework_xmlvalidator-1.0.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-xmlvalidator/__init__.py,sha256=5kxSsQ1XkpyeYSdcZvZlnSpnbRPiyd1w3hb8l-G0BtQ,2293
-xmlvalidator/xml_validator_results.py,sha256=r2QvkNoFRkEYcS_J8yMDjX4pwqyYJAFmSvbMkqEnLkY,13119
-xmlvalidator/xml_validator_utils.py,sha256=jjZ7hwSmEpNQTP_fxECqIMriyvr5xr0RWibakpnEPmo,17830
-xmlvalidator/XmlValidator.py,sha256=9kAzacpQixC5hIs_LZIl5oSr96Ze4pVwh_m4bMJUMVs,71829
-robotframework_xmlvalidator-1.0.0.dist-info/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-robotframework_xmlvalidator-1.0.0.dist-info/METADATA,sha256=xWZDdS0cmZSf-ZFTWaRdhsxsmffxCiq3db_W6rrY0XM,30798
-robotframework_xmlvalidator-1.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-robotframework_xmlvalidator-1.0.0.dist-info/RECORD,,