docbook-apps

Hi,

For your information, I've packaged a few python scripts and a java plugin
for Saxon to compute and visualize the coverage of XSL stylesheets when
processed on documents with saxon (currently tested with saxon 6.5.5).

It's available here:

https://github.com/marsgui/xslcoverage/tree/master

You can look at the result with an example at the end of the readme.

Regards,
BG

Hi Ben,

This looks interesting, but I’ve got a basic (dumb:-) question. What do you mean by coverage?

Do you mean test coverage, that is, calculating how much a given test xml file exercises the stylesheets, or do you mean something else?

Thanks,
Dick Hamilton
-------
XML Press
XML for Technical Communicators
http://xmlpress.net
hamilton@xmlpress.net



> On Nov 8, 2016, at 15:58, ben.guillon <ben.guillon@gmail.com> wrote:
>
> Hi,
>
> For your information, I've packaged a few python scripts and a java plugin for Saxon to compute and visualize the coverage of XSL stylesheets when processed on documents with saxon (currently tested with saxon 6.5.5).
>
> It's available here:
>
> https://github.com/marsgui/xslcoverage/tree/master
>
> You can look at the result with an example at the end of the readme.
>
> Regards,
> BG
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

Hi Richard,

Yes, it means that: when stylesheets are processed on a given test xml
file, the tool traces the templates applied, and within the called
templates the XSL instructions performed (some instructions can be
unreachable because of conditional processing with xsl:if, xsl:choose). In
the HTML coverage report, the covered lines (that is, the XSL lines used
to transform the XML) have green background, while unused lines have
yellow backgrounds. Clicking on the green lines point to the XML line(s)
processed. The overall statistics for the stylesheets used are in a
coverage index file.

An example of such a report is here:
https://marsgui.github.io/xslcoverage/example/traces/coverage_index.html

Regards,
BG

On Fri, 11 Nov 2016 20:35:37 +0100, Richard Hamilton
<hamilton@xmlpress.net> wrote:

> Hi Ben,
>
> This looks interesting, but I’ve got a basic (dumb:-) question. What do
> you mean by coverage?
>
> Do you mean test coverage, that is, calculating how much a given test
> xml file exercises the stylesheets, or do you mean something else?
>
> Thanks,
> Dick Hamilton
> -------
> XML Press
> XML for Technical Communicators
> http://xmlpress.net
> hamilton@xmlpress.net
>
>> On Nov 8, 2016, at 15:58, ben.guillon <ben.guillon@gmail.com> wrote:
>>
>> Hi,
>>
>> For your information, I've packaged a few python scripts and a java
>> plugin for Saxon to compute and visualize the coverage of XSL
>> stylesheets when processed on documents with saxon (currently tested
>> with saxon 6.5.5).
>>
>> It's available here:
>>
>> https://github.com/marsgui/xslcoverage/tree/master
>>
>> You can look at the result with an example at the end of the readme.
>>
>> Regards,
>> BG
>>

Hi Ben,

Thanks for the explanation and for making this utility; it is very cool and useful.

Best regards,
Richard
-------
XML Press
XML for Technical Communicators
http://xmlpress.net
hamilton@xmlpress.net



> On Nov 11, 2016, at 19:06, ben.guillon <ben.guillon@gmail.com> wrote:
>
> Hi Richard,
>
> Yes, it means that: when stylesheets are processed on a given test xml file, the tool traces the templates applied, and within the called templates the XSL instructions performed (some instructions can be unreachable because of conditional processing with xsl:if, xsl:choose). In the HTML coverage report, the covered lines (that is, the XSL lines used to transform the XML) have green background, while unused lines have yellow backgrounds. Clicking on the green lines point to the XML line(s) processed. The overall statistics for the stylesheets used are in a coverage index file.
>
> An example of such a report is here:
> https://marsgui.github.io/xslcoverage/example/traces/coverage_index.html
>
> Regards,
> BG
>
> On Fri, 11 Nov 2016 20:35:37 +0100, Richard Hamilton <hamilton@xmlpress.net> wrote:
>
>> Hi Ben,
>>
>> This looks interesting, but I’ve got a basic (dumb:-) question. What do you mean by coverage?
>>
>> Do you mean test coverage, that is, calculating how much a given test xml file exercises the stylesheets, or do you mean something else?
>>
>> Thanks,
>> Dick Hamilton
>> -------
>> XML Press
>> XML for Technical Communicators
>> http://xmlpress.net
>> hamilton@xmlpress.net
>>
>>> On Nov 8, 2016, at 15:58, ben.guillon <ben.guillon@gmail.com> wrote:
>>>
>>> Hi,
>>>
>>> For your information, I've packaged a few python scripts and a java plugin for Saxon to compute and visualize the coverage of XSL stylesheets when processed on documents with saxon (currently tested with saxon 6.5.5).
>>>
>>> It's available here:
>>>
>>> https://github.com/marsgui/xslcoverage/tree/master
>>>
>>> You can look at the result with an example at the end of the readme.
>>>
>>> Regards,
>>> BG
>>>

Looks great, I want to try it! But does it work with the open source
version of Saxon? Saxon-CE, described here:
http://www.saxonica.com/download/opensource.xml
The version # there is quite different from what you give below (6.5.5):
theirs is 9.7.

Mike Maxwell

On 11/11/2016 10:06 PM, ben.guillon wrote:
> Hi Richard,
>
> Yes, it means that: when stylesheets are processed on a given test xml
> file, the tool traces the templates applied, and within the called
> templates the XSL instructions performed (some instructions can be
> unreachable because of conditional processing with xsl:if, xsl:choose).
> In the HTML coverage report, the covered lines (that is, the XSL lines
> used to transform the XML) have green background, while unused lines
> have yellow backgrounds. Clicking on the green lines point to the XML
> line(s) processed. The overall statistics for the stylesheets used are
> in a coverage index file.
>
> An example of such a report is here:
> https://marsgui.github.io/xslcoverage/example/traces/coverage_index.html
>
> Regards,
> BG
>
> On Fri, 11 Nov 2016 20:35:37 +0100, Richard Hamilton
> <hamilton@xmlpress.net> wrote:
>
>> Hi Ben,
>>
>> This looks interesting, but I’ve got a basic (dumb:-) question. What
>> do you mean by coverage?
>>
>> Do you mean test coverage, that is, calculating how much a given test
>> xml file exercises the stylesheets, or do you mean something else?
>>
>> Thanks,
>> Dick Hamilton
>> -------
>> XML Press
>> XML for Technical Communicators
>> http://xmlpress.net
>> hamilton@xmlpress.net
>>
>>> On Nov 8, 2016, at 15:58, ben.guillon <ben.guillon@gmail.com> wrote:
>>>
>>> Hi,
>>>
>>> For your information, I've packaged a few python scripts and a java
>>> plugin for Saxon to compute and visualize the coverage of XSL
>>> stylesheets when processed on documents with saxon (currently tested
>>> with saxon 6.5.5).
>>>
>>> It's available here:
>>>
>>> https://github.com/marsgui/xslcoverage/tree/master
>>>
>>> You can look at the result with an example at the end of the readme.
>>>
>>> Regards,
>>> BG
>>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

Sorry, I meant Saxon-HE (same link)

On 11/12/2016 1:13 PM, maxwell wrote:
> Looks great, I want to try it! But does it work with the open source
> version of Saxon? Saxon-CE, described here:
> http://www.saxonica.com/download/opensource.xml
> The version # there is quite different from what you give below (6.5.5):
> theirs is 9.7.
>
> Mike Maxwell
>
> On 11/11/2016 10:06 PM, ben.guillon wrote:
>> Hi Richard,
>>
>> Yes, it means that: when stylesheets are processed on a given test xml
>> file, the tool traces the templates applied, and within the called
>> templates the XSL instructions performed (some instructions can be
>> unreachable because of conditional processing with xsl:if, xsl:choose).
>> In the HTML coverage report, the covered lines (that is, the XSL lines
>> used to transform the XML) have green background, while unused lines
>> have yellow backgrounds. Clicking on the green lines point to the XML
>> line(s) processed. The overall statistics for the stylesheets used are
>> in a coverage index file.
>>
>> An example of such a report is here:
>> https://marsgui.github.io/xslcoverage/example/traces/coverage_index.html
>>
>> Regards,
>> BG
>>
>> On Fri, 11 Nov 2016 20:35:37 +0100, Richard Hamilton
>> <hamilton@xmlpress.net> wrote:
>>
>>> Hi Ben,
>>>
>>> This looks interesting, but I’ve got a basic (dumb:-) question. What
>>> do you mean by coverage?
>>>
>>> Do you mean test coverage, that is, calculating how much a given test
>>> xml file exercises the stylesheets, or do you mean something else?
>>>
>>> Thanks,
>>> Dick Hamilton
>>> -------
>>> XML Press
>>> XML for Technical Communicators
>>> http://xmlpress.net
>>> hamilton@xmlpress.net
>>>
>>>> On Nov 8, 2016, at 15:58, ben.guillon <ben.guillon@gmail.com> wrote:
>>>>
>>>> Hi,
>>>>
>>>> For your information, I've packaged a few python scripts and a java
>>>> plugin for Saxon to compute and visualize the coverage of XSL
>>>> stylesheets when processed on documents with saxon (currently tested
>>>> with saxon 6.5.5).
>>>>
>>>> It's available here:
>>>>
>>>> https://github.com/marsgui/xslcoverage/tree/master
>>>>
>>>> You can look at the result with an example at the end of the readme.
>>>>
>>>> Regards,
>>>> BG
>>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>

Hi,

I've updated in github to support saxon9HE, but it's not in a tagged
release yet. to use it:

xslcoverage report run saxon9he [saxon options and args]

Note that I've noticed some regressions in tracing since release 6.5.5.
The side effect is that some covered instructions appear as not covered.
I've reported to saxon:

https://saxonica.plan.io/issues/3027
https://saxonica.plan.io/issues/3028
https://saxonica.plan.io/issues/3029

Regards,
BG

On Sat, 12 Nov 2016 19:20:00 +0100, maxwell <maxwell@umiacs.umd.edu> wrote:

> Sorry, I meant Saxon-HE (same link)
>
> On 11/12/2016 1:13 PM, maxwell wrote:
>> Looks great, I want to try it! But does it work with the open source
>> version of Saxon? Saxon-CE, described here:
>> http://www.saxonica.com/download/opensource.xml
>> The version # there is quite different from what you give below (6.5.5):
>> theirs is 9.7.
>>
>> Mike Maxwell
>>