Mercurial > repos > shellac > guppy_basecaller
diff env/lib/python3.7/site-packages/planemo/xml/validation.py @ 0:26e78fe6e8c4 draft
"planemo upload commit c699937486c35866861690329de38ec1a5d9f783"
author | shellac |
---|---|
date | Sat, 02 May 2020 07:14:21 -0400 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/env/lib/python3.7/site-packages/planemo/xml/validation.py Sat May 02 07:14:21 2020 -0400 @@ -0,0 +1,92 @@ +"""Module describing abstractions for validating XML content.""" +import abc +import subprocess +from collections import namedtuple + +from galaxy.tool_util.deps.commands import which +from galaxy.util import unicodify +try: + from lxml import etree +except ImportError: + etree = None + +XMLLINT_COMMAND = "xmllint --noout --schema {0} {1} 2>&1" +INSTALL_VALIDATOR_MESSAGE = ("This feature requires an external dependency " + "to function, pleaes install xmllint (e.g 'brew " + "install libxml2' or 'apt-get install " + "libxml2-utils'.") + + +class XsdValidator(object): + """Class allowing validation of XML files against XSD schema.""" + + __metaclass__ = abc.ABCMeta + + @abc.abstractmethod + def validate(self, schema_path, target_path): + """Validate ``target_path`` against ``schema_path``. + + :return type: ValidationResult + """ + + @abc.abstractmethod + def enabled(self): + """Return True iff system has dependencies for this validator. + + :return type: bool + """ + + +ValidationResult = namedtuple("ValidationResult", ["passed", "output"]) + + +class LxmlValidator(XsdValidator): + """Validate XSD files using lxml library.""" + + def validate(self, schema_path, target_path): + try: + xsd_doc = etree.parse(schema_path) + xsd = etree.XMLSchema(xsd_doc) + xml = etree.parse(target_path) + passed = xsd.validate(xml) + return ValidationResult(passed, xsd.error_log) + except etree.XMLSyntaxError as e: + return ValidationResult(False, unicodify(e)) + + def enabled(self): + return etree is not None + + +class XmllintValidator(XsdValidator): + """Validate XSD files with the external tool xmllint.""" + + def validate(self, schema_path, target_path): + command = XMLLINT_COMMAND.format(schema_path, target_path) + p = subprocess.Popen(command, stdout=subprocess.PIPE, shell=True) + stdout, _ = p.communicate() + passed = p.returncode == 0 + return ValidationResult(passed, stdout) + + def enabled(self): + return bool(which("xmllint")) + + +VALIDATORS = [LxmlValidator(), XmllintValidator()] + + +def get_validator(require=True): + """Return a :class:`XsdValidator` object based on available dependencies.""" + for validator in VALIDATORS: + if validator.enabled(): + return validator + + if require: + raise Exception(INSTALL_VALIDATOR_MESSAGE) + + return None + + +__all__ = ( + "get_validator", + "XsdValidator", +)