1
0
mirror of https://github.com/woo-j/zint.git synced 2024-12-23 13:33:55 +03:00
zint/backend/tests
gitlost e515f63fab - PDF417/MICROPDF417: use latch not ps shift for padding when
spanning Text segments to avoid affecting 1st char of 2nd segment
- PDF417/MICROPDF417: add optimized encoding, FAST_MODE for
  previous scheme; formatting changes
- common.c/h: add `cnt_digits()`, comments in include and make more
  consistent, minor code fiddling
- DOTCODE: replace `dc_n_digits()` with new `cnt_digits()`
- test_qr: fix `test_qr_perf()`
- composite: minor code fiddling
- library: debug dump HIBC-processed input
- BWIPP: update to latest
2022-11-06 22:25:19 +00:00
..
cmake/Modules Remove further refs to QZint; win32/README; add zintconfig.h to Win make files 2020-11-24 22:22:12 +00:00
data PDF417: some tweaks to MR #151 [e8a125], update test suite 2022-08-18 22:25:09 +01:00
tools - PDF417/MICROPDF417: use latch not ps shift for padding when 2022-11-06 22:25:19 +00:00
CMakeLists.txt test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
README test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_2of5.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_auspost.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_aztec.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_bc412.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_big5_tab.h eci: Add support for all ECIs (Big5, Korean, UCS-2BE) 2021-01-11 18:11:41 +00:00
test_big5.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_bmp.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_channel.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_codablock.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_code1.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_code16k.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_code49.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_code128.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_code.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_common.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_composite.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_dmatrix.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_dotcode.c - DOTCODE, QRCODE, RMQR: return warning if ECI or Structured Append used in 2022-09-28 21:58:57 +01:00
test_eci.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_emf.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_gb2312_tab.h eci: Add support for all ECIs (Big5, Korean, UCS-2BE) 2021-01-11 18:11:41 +00:00
test_gb2312.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_gb18030_tab.h eci: Add support for all ECIs (Big5, Korean, UCS-2BE) 2021-01-11 18:11:41 +00:00
test_gb18030.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_gbk_tab.h eci.c: replace libiconv-adapted code with own implementations so 2022-06-02 20:32:25 +01:00
test_gif.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_gridmtx.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_gs1.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_hanxin.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_imail.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_iso3166.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_iso4217.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_ksx1001_tab.h eci: Add support for all ECIs (Big5, Korean, UCS-2BE) 2021-01-11 18:11:41 +00:00
test_ksx1001.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_large.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_library.c test suite: suppress some Windows warnings (strlen) 2022-09-12 20:19:41 +01:00
test_mailmark.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_maxicode.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_medical.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_output.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_pcx.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_pdf417.c - PDF417/MICROPDF417: use latch not ps shift for padding when 2022-11-06 22:25:19 +00:00
test_plessey.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_png.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_postal.c CODE128: allow for extended latching (double FNC4) spanning 2022-10-13 13:33:59 +01:00
test_print.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_ps.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_qr.c - PDF417/MICROPDF417: use latch not ps shift for padding when 2022-11-06 22:25:19 +00:00
test_raster.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_reedsol.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_rss.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_sjis_tab.h eci: Add support for all ECIs (Big5, Korean, UCS-2BE) 2021-01-11 18:11:41 +00:00
test_sjis.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_svg.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_telepen.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_tif.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_ultra.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_upcean.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
test_vector.c test suite: convert to use test context p_ctx instead of individual 2022-09-12 19:26:04 +01:00
testcommon.c - PDF417/MICROPDF417: use latch not ps shift for padding when 2022-11-06 22:25:19 +00:00
testcommon.h common.h: define ZINT_IS_C89 as __STDC_VERSION__ not defined by MSVC 2022-09-14 14:48:57 +01:00

Zint backend test suite
-----------------------

In order to build the zint test suite, zint has to be compiled with the
ZINT_TEST option enabled:

  cd <project-dir>
  mkdir build
  cd build
  cmake -DZINT_TEST=ON ..
  cmake --build .

When using generators that support multiple build configurations, such as
Visual C++ Project Files (the default generator on win32), the configuration
can be provided via --config:

  cd <project-dir>
  mkdir build
  cd build
  cmake -DZINT_TEST=ON ..
  cmake --build . --config Debug
  
------------------------------------------------------------------------------

In order to run the test suite, the path of the zint library may need to be
communicated to the runtime linker. On UNIX-like systems, this is done by
exporting LD_LIBRARY_PATH to the path containing the zint library, which is
<build-dir>/backend:

  cd <project-dir>
  cd build
  export LD_LIBRARY_PATH=$(pwd)/backend

Setting LD_LIBRARY_PATH is not required if the zint library to be tested is
installed into a system library path ( /usr/lib for example ) prior to running
the tests.

To run all tests (within <build-dir>):

  ctest

When using a generator that does support multiple build configurations, the
configuration that was used to build the project has to be explicitly provided
to ctest, even if it was the default one:

  ctest -C Debug

For various useful options, e.g. matching (-R) and excluding (-E) tests, see
https://cmake.org/cmake/help/latest/manual/ctest.1.html#options

Tests can also be run individually, eg:

  backend/tests/test_common
  backend/tests/test_vector

To run a single test function within an individual test, use '-f <func-name>':

  backend/tests/test_common -f utf8_to_unicode
  backend/tests/test_dotcode -f input

To run a single dataset item in a single test function, use '-i <index>':

  backend/tests/test_dotcode -f input -i 2

To run a range of dataset items in a single test function, use '-i <start>,<end>':

  backend/tests/test_dotcode -f input -i 2,5

To exclude a single dataset item in a single test function, use '-x <index>':

  backend/tests/test_dotcode -f input -x 4

This can also take a range, '-x <start>,<end>':

  backend/tests/test_dotcode -f input -x 4,6

The include and exclude options can be used together:

  backend/tests/test_dotcode -f input -i 2,7 -x 4

To show debug info (if any), use '-d <flag>':

  backend/tests/test_dotcode -f input -i 2 -d 1

E.g. to print which dataset items are being run, use '-d 16':

  backend/tests/test_dotcode -f input -d 16 -i 2

(for other flags see <project-dir>/backend/tests/testcommon.h)

To run a test against BWIPP (if any), use '-d 128':

  backend/tests/test_composite -d 128

(see also <project-dir>/backend/tests/tools/run_bwipp_tests.sh)

To run a test against ZXing-C++ (if any), use '-d 512':

  backend/tests/test_rss -d 512

(see also <project-dir>/backend/tests/tools/run_zxingcpp_tests.sh)

To generate test data, use '-g':

  backend/tests/test_dotcode -f encode -g

------------------------------------------------------------------------------

If the zint library was built with static linkage support, i.e. ZINT_STATIC
is ON, an additional test executable, which uses the zint-static library, will
be built. The static variant of each test shares the test name, but has a
"-static" suffix. For example,

  backend/tests/test_dotcode

would run the dotcode test that uses the shared zint library, while

  backend/tests/test_dotcode-static

runs the same test built against the zint-static library.

------------------------------------------------------------------------------

To make with gcc sanitize, first set for libzint and make:

  cd <project-dir>
  cd build
  cmake -DZINT_SANITIZE=ON ..
  make && sudo make install

Similarly to make with gcc debug:

  cd <project-dir>
  cd build
  cmake -DZINT_DEBUG=ON ..
  make && sudo make install

To undo sanitize/debug, remake each after setting:

  cmake -DZINT_SANITIZE=OFF ..
  cmake -DZINT_DEBUG=OFF ..

To get a clean libzint, set the above and also:

  cmake -DZINT_TEST=OFF ..

(The tests will now fail to link.)