Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse Search

Direc­tory tex-archive/macros/latex/contrib/qstest

This is the public release of the qstest bundle
(written for DocScape Publisher <URL:http://www.docscape.de>)
(C) 2006, 2007 QuinScape GmbH <URL:http://www.quinscape.de>

This software comes without warranty of any kind.

The TeX source files are licensed under the LPPL version 1.3 or later,
see the individual files for details.  Generated files refer to the
license of their respective source.  Makefile and this README may be
freely used, modified and copied.

The bundle contains the packages `makematch' for matching patterns to
targets (with a generalization in the form of pattern lists and
keyword lists), and `qstest' for performing unit tests, allowing to
run a number of logged tests ensuring the consistency of values,
properties and call sequences during execution of test code.  Both
packages make extensive use of qstest in their package documentation,
providing illustrated examples that are automatically verified to work
as expected.

For efficiency and feature completeness reasons, both styles require
the use of an eTeX-based engine for LaTeX, as recommended by the LaTeX
team for some years (while the source code provides a way of producing
files for a non-eTeX setup, this is discouraged, untested, not feature
complete, not supported by Makefile and author).

Files in the bundle:

Makefile: this contains rules for managing unpacking, testing, and
installing the bundle in TDS-compliant trees.  Interesting targets are
all generated files, "test", and "install".

qstest.ins: installer file.  Running
    tex qstest.ins
will unpack the packages (but not their driver files) right into the 
target tree if your docstrip is configured for it.  If you want to
unpack into the current directory instead (and avoid getting asked
whether you want to overwrite old files, as is desirable for working
with the program `make'), you can do so by instead running
    tex "\let\Make=y \input qstest.ins"
Should qstest.ins be missing, you can use (or look at) the Makefile
for regenerating it.

makematch.dtx: documented source of makematch.sty.  Running this
document through LaTeX will give you the documentation of the package,
but without the documented package source.

qstest.dtx: documented source of qstest.sty.  Running this document
through LaTeX will give you the documentation of the package, but
without the documented package source.


The following files are also placed on CTAN for informational
purposes; as part of a TeX installation it would usually be preferable
to rather install DVI files with full source code listing, generated
by running latex on the files of form *.drv (see below):

qstest.pdf: the result of running PDFLaTeX on qstest.dtx, namely the
documentation for the qstest package without source code listing.

makematch.pdf: the result of running PDFLaTeX on qstest.dtx, namely
the documentation for the makematch package without source code
listing.


The following files will be unpacked by qstest.ins:

makematch.sty: this package matches pattern lists with wildcards to
keyword lists.

makematch.drv: this file can be run through LaTeX in order to generate
the documentation for the makematch package including the full
documented source code.

qstest.sty: this package allows one to perform unit tests and check
for values, definitions and macro call sequences to meet expectations.
Call sequences are specified with a syntax reminiscent of regular
expressions.

qstest.drv: this file can be run through LaTeX in order to generate
the documentation for the qstest package including the full documented
source code.

makematch-qs.tex: a standalone unit test of makematch.sty, to be run
through LaTeX.

qstest-qs.tex: a standalone unit test of qstest.sty, to be run
through LaTeX.


David Kastrup <dak@gnu.org>
QuinScape GmbH
http://www.QuinScape.de

Files

Name Size Date Notes
Makefile 2392 2007-02-21 03:38
README 3803 2007-02-23 08:49
makematch.dtx 23788 2007-02-23 03:22
makematch.pdf 101144 2007-02-23 03:23
qstest.dtx 64152 2007-02-21 03:03
qstest.ins 1278 2007-02-21 03:03
qstest.pdf 159684 2007-02-23 03:23

Down­load the con­tents of this pack­age in one zip archive (245.8k).

qstest – Bun­dle for unit tests and pat­tern match­ing

This is the pub­lic re­lease of the qstest bun­dle (writ­ten for DocS­cape Pub­lisher) (C) 2006, 2007 QuinS­cape GmbH.

The bun­dle con­tains the pack­ages ‘make­match’ for match­ing pat­terns to tar­gets (with a gen­er­al­iza­tion in the form of pat­tern lists and key­word lists), and ‘qstest’ for per­form­ing unit tests, al­low­ing the user to run a num­ber of logged tests en­sur­ing the con­sis­tency of val­ues, prop­er­ties and call se­quences dur­ing ex­e­cu­tion of test code. Both pack­ages make ex­ten­sive use of in their pack­age doc­u­men­ta­tion, pro­vid­ing il­lus­trated ex­am­ples that are au­to­mat­i­cally ver­i­fied to work as ex­pected.

Check the README file for de­tails.

Pack­age De­tailsqstest
Ver­sion 2007-02-23
Li­censeThe LaTeX Project Public Li­cense
Copy­right2006,2007 QuinS­cape GmbH
Main­tainerDavid Kas­trup
Con­tained inTeXlive as qstest
MikTeX as qstest
Topics uni­form type­set­ting of units
Guest Book Sitemap Contact