Files
Nim/tests
Ivan Bobev ccd77b42af Add some enhancements to jsonutils.nim (#15133)
* Add some enhancements to `jsonutils.nim`

* Use `jsonutils.nim` hookable API to add a possibility to deserialize
  JSON arrays directly to `HashSet` and `OrderedSet` types and
  respectively to serialize those types to JSON arrays.

* Also add a possibility to deserialize JSON `null` objects to Nim
  option objects and respectively to serialize Nim option object to JSON
  object if some or to JSON `null` object if none.

* Move serialization/deserialization functionality for `Table` and
  `OrderedTable` types from `jsonutils.nim` to `tables.nim` via the
  hookable API.

* Add object `jsonutils.Joptions` and parameter from its type to
  `jsonutils.fromJson` procedure to control whether to allow
  deserializing JSON objects to Nim objects when the JSON has some
  extra or missing keys.

* Add unit tests for the added functionalities to `tjsonutils.nim`.

* improve fromJsonFields

* Add changelog entry for the jsonutils enhancements

* Add TODO in `jsonutils.nim`

* Added an entry to "Future directions" section in `jsonutils.nim` as
  suggestion for future support of serialization and de-serialization of
  nested variant objects.

* Added currently disabled test case in `tjsonutils.nim` for testing
  serialization and de-serialization of nested variant objects.

* Move JSON hooks to `jsonutils.nim`

Move `fromJsonHook` and `toJsonHook` procedures for different types to
`jsonutils.nim` module to avoid a dependency of collections modules to
the `json.nim` module.

The hooks are removed from the following modules:

  * `tables.nim`

  * `sets.nim`

  * `options.nim`

  * `strtabs.nim`

* Add some tests about `StringTableRef`

Add tests for `StringTableRef`'s `fromJsonHook` and `toJsonHook` to
`tjsonutils.nim`.

* Disable a warning in `jsonutils.nim`

Mark `fun` template in `jsonutils` module with `{.used.}` pragma in
order to disable `[XDeclaredButNotUsed]` hint. The template is actually
used by the `initCaseObject` macro in the same module.

Co-authored-by: Timothee Cour <timothee.cour2@gmail.com>
2020-09-09 14:18:59 +02:00
..
2017-07-25 09:28:23 +02:00
2020-01-13 14:11:51 +01:00
2020-09-04 10:26:14 +02:00
2019-09-27 07:02:54 +02:00
2020-08-08 07:24:54 +02:00
2020-06-23 14:17:12 +02:00
2020-07-15 23:00:06 +02:00
2020-09-09 07:32:03 +02:00
2020-08-10 12:57:32 +02:00
2019-05-25 07:33:33 +02:00
2014-01-13 02:10:03 +01:00
2020-07-09 01:51:18 +02:00
2020-06-16 16:24:26 +02:00
2020-07-09 09:57:35 +02:00
2019-07-13 07:55:56 +02:00
2020-07-14 09:22:48 +02:00
2020-06-24 18:00:35 +02:00
2019-05-27 21:29:02 +02:00
2020-07-15 23:00:06 +02:00
2018-12-11 21:23:22 +01:00
2020-07-08 12:22:55 +02:00
2018-12-11 21:23:25 +01:00
2020-08-31 14:46:23 +02:00
2019-09-16 12:12:44 +02:00
2020-04-21 15:05:21 +02:00
2020-07-14 16:44:56 +02:00
2020-08-27 15:50:59 +02:00
2020-03-30 13:18:12 +02:00
2020-07-14 19:50:42 +02:00
2020-07-07 10:21:18 +02:00
2020-07-14 19:50:42 +02:00
2020-04-18 16:15:17 +02:00
2020-07-14 16:44:56 +02:00
2013-03-16 23:53:07 +01:00
2019-09-27 07:02:54 +02:00
2020-06-28 00:13:54 +02:00

This directory contains the test cases.

Each test must have a filename of the form: t*.nim

Note: Testament is only aware of tests under a directory (eg tests/foo/) and will ignore top-level tests like tests/tbar.nim.

Specs

Each test can contain a spec in a discard """ ... """ block.

Check out the parseSpec procedure in the specs module for a full and reliable reference

action

Specifies what action this test should take.

Default: run

Options:

  • compile - compiles the module and fails the test if compilations fails.
  • run - compiles and runs the module, fails the test if compilation or execution of test code fails.
  • reject - compiles the module and fails the test if compilation succeeds.

There are certain spec keys that imply run, including output and outputsub.

cmd

Specifies the Nim command to use for compiling the test.

There are a number of variables that are replaced in this spec option:

  • $target - the compilation target, e.g. c.
  • $options - the options for the compiler.
  • $file - the filename of the test.
  • $filedir - the directory of the test file.

Example:

discard """
  cmd: "nim $target --nimblePath:./nimbleDir/simplePkgs $options $file"
"""

Categories

Each folder under this directory represents a test category, which can be tested by running koch tests pcat <category> (or cat to avoid parallel testing, which is slower).

The folder dll contains simple DLL tests.

The folder realtimeGC contains a test for validating that the realtime GC can run properly without linking against the nimrtl.dll/so. It includes a C client and platform specific build files for manual compilation.