a
ao0
@ s d Z ddlZddlZddlmZ ze W n ey> e ZY n0 ze
W n ey^ e Z
Y n0 g dZ dZ dZ
dZdZd e Zd e Zejejed
Zeeejed d Zeeejed d
Zeeejed ddZeeejed ddZ eeejed ddZ ej ddeidZ ej ejedddZ!dd Z"dd Z#G d d d ej$Z%dS ) zxThe ``lxml.isoschematron`` package implements ISO Schematron support on top
of the pure-xslt 'skeleton' implementation.
N)etree) extract_xsd extract_rngiso_dsdl_includeiso_abstract_expandiso_svrl_for_xslt1svrl_validation_errorsschematron_schema_validstylesheet_params
Schematronz http://www.w3.org/2001/XMLSchemaz#http://relaxng.org/ns/structure/1.0z$http://purl.oclc.org/dsdl/schematronz http://purl.oclc.org/dsdl/svrlz
{%s}schemaZ resourcesZxslzXSD2Schtrn.xslzRNG2Schtrn.xslziso-schematron-xslt1ziso_dsdl_include.xslziso_abstract_expand.xslziso_svrl_for_xslt1.xslz//svrl:failed-assertsvrlZ
namespacesrngziso-schematron.rng)filec K s` i }| D ]N\}}t|tr,tj|}n&|du r>tdnt|tjsRt|}|||< q |S )a( Convert keyword args to a dictionary of stylesheet parameters.
XSL stylesheet parameters must be XPath expressions, i.e.:
* string expressions, like "'5'"
* simple (number) expressions, like "5"
* valid XPath expressions, like "/a/b/text()"
This function converts native Python keyword arguments to stylesheet
parameters following these rules:
If an arg is a string wrap it with XSLT.strparam().
If an arg is an XPath object use its path string.
If arg is None raise TypeError.
Else convert arg to string.
Nz*None not allowed as a stylesheet parameter) items
isinstance
basestring_etreeXSLTZstrparam TypeErrorXPathunicode)kwargsresultkeyval r A/usr/lib64/python3.9/site-packages/lxml/isoschematron/__init__.pyr
F s
r
c C s< t | } | D ]\}}|dur|| |< qtf i | } | S )zReturn a copy of paramsDict, updated with kwargsDict entries, wrapped as
stylesheet arguments.
kwargsDict entries with a value of None are ignored.
N)dictr r
)Z
paramsDictZ
kwargsDictkvr r r _stylesheet_param_dictb s
r! c s e Zd ZdZejjZejj Z
ej j Z
eZejddeidZdd ZeZeZeZeZe Z eZ ddddi i i d d d def fd
d Z d d
Z e!dd Z"e!dd Z#e!dd Z$ Z%S )r a
An ISO Schematron validator.
Pass a root Element or an ElementTree to turn it into a validator.
Alternatively, pass a filename as keyword argument 'file' to parse from
the file system.
Schematron is a less well known, but very powerful schema language.
The main idea is to use the capabilities of XPath to put restrictions on
the structure and the content of XML documents.
The standard behaviour is to fail on ``failed-assert`` findings only
(``ASSERTS_ONLY``). To change this, you can either pass a report filter
function to the ``error_finder`` parameter (e.g. ``ASSERTS_AND_REPORTS``
or a custom ``XPath`` object), or subclass isoschematron.Schematron for
complete control of the validation process.
Built on the Schematron language 'reference' skeleton pure-xslt
implementation, the validator is created as an XSLT 1.0 stylesheet using
these steps:
0) (Extract from XML Schema or RelaxNG schema)
1) Process inclusions
2) Process abstract patterns
3) Compile the schematron schema to XSLT
The ``include`` and ``expand`` keyword arguments can be used to switch off
steps 1) and 2).
To set parameters for steps 1), 2) and 3) hand parameter dictionaries to the
keyword arguments ``include_params``, ``expand_params`` or
``compile_params``.
For convenience, the compile-step parameter ``phase`` is also exposed as a
keyword argument ``phase``. This takes precedence if the parameter is also
given in the parameter dictionary.
If ``store_schematron`` is set to True, the (included-and-expanded)
schematron document tree is stored and available through the ``schematron``
property.
If ``store_xslt`` is set to True, the validation XSLT document tree will be
stored and can be retrieved through the ``validator_xslt`` property.
With ``store_report`` set to True (default: False), the resulting validation
report document gets stored and can be accessed as the ``validation_report``
property.
Here is a usage example::
>>> from lxml import etree
>>> from lxml.isoschematron import Schematron
>>> schematron = Schematron(etree.XML('''
...
...
... id is the only permitted attribute name
...
... Attribute
... is forbidden
...
...
...
... '''),
... error_finder=Schematron.ASSERTS_AND_REPORTS)
>>> xml = etree.XML('''
...
...
...
...
... ''')
>>> schematron.validate(xml)
False
>>> xml = etree.XML('''
...
...
...
...
... ''')
>>> schematron.validate(xml)
True
z///svrl:failed-assert | //svrl:successful-reportr r
c C s8 d}|j tkr| |}n|j|j tkr4| |}|S )a
Extract embedded schematron schema from non-schematron host schema.
This method will only be called by __init__ if the given schema document
is not a schematron schema by itself.
Must return a schematron schema document tree or None.
N)tag_xml_schema_root _extract_xsdZnsmapprefix
RELAXNG_NS _extract_rng)selfelement
schematronr r r _extract s
zSchematron._extractNTFc
sp t t| |
| _d | _d | _d | _| | jur6| | _d }
z<|d ur^t
|rT|}
qt| }
n|d urtt | }
W n( t
y t dt d Y n0 |
d u rtd|
jtkr|
}n
| |
}|d u rt d|r| j|fi |}|r
| j|fi |}t|s$t dtj |r0|| _d| i}t||}| j|fi |}| r`|| _t || _ d S )NzNo tree or file given: %s z
Empty treez=Document is not a schematron schema or schematron-extractablez invalid schematron schema: %sphase) superr __init__
_store_report _schematron_validator_xslt_validation_report ASSERTS_ONLY_validation_errorsr iselementZgetrootparse ExceptionZSchematronParseErrorsysexc_info
ValueErrorr" _schematron_rootr+ _include_expandr Z error_logr! _compiler
_validator)r( r r ZincludeexpandZinclude_paramsZ
expand_paramsZcompile_paramsZstore_schematronZ
store_xsltZ store_reportr- Z error_finderrootr* Zcompile_kwargsvalidator_xslt __class__r r r/ s\
zSchematron.__init__c
C s | | |}| jr || _| |}|rt|rH| jj pDd}n |jj pRd}|D ]*}| j
| j | j | j
dtj|dd|d qXdS dS )zaValidate doc using Schematron.
Returns true if document is valid, false if not.
zr r )encoding)domaintypelevellinemessagefilenameFT)Z_clear_error_logr@ r0 r3 r5 r r6 Z getroottreeZdocinfoZURLZ_append_log_message_domain _error_type_levelZtostring)r( r r errorsfnameerrorr r r __call__" s$
zSchematron.__call__c C s | j S )zrISO-schematron schema document (None if object has been initialized
with store_schematron=False).
)r1 r( r r r r* ; s zSchematron.schematronc C s | j S )zISO-schematron skeleton implementation XSLT validator document (None
if object has been initialized with store_xslt=False).
)r2 rT r r r rC B s zSchematron.validator_xsltc C s | j S )zfISO-schematron validation result report (None if result-storing has
been turned off).
)r3 rT r r r validation_reportI s z Schematron.validation_report)&__name__
__module__ __qualname____doc__r Z ErrorDomainsZ SCHEMATRONVrM Z ErrorLevelsZERRORrO Z
ErrorTypesZSCHEMATRONV_ASSERTrN r r4 r SVRL_NSZASSERTS_AND_REPORTSr+ r r$ r r' r r= r r> r r? r5 r/ rS propertyr* rC rU
__classcell__r r rD r r p s8 S8
r )&rY r9 Zos.pathosZlxmlr r r NameErrorstrr __all__Z
XML_SCHEMA_NSr& Z
SCHEMATRON_NSrZ r< r# pathjoindirname__file__Z_resources_dirr r7 r r r r r r r ZRelaxNGr r
r! Z
_Validatorr r r r r sb