Files
Nim/tests
shirleyquirk 0bc943ad54 followup strformat PR. backslash escapes, tests, docs (#17700)
* Allow use of colons inside fmt
allowing colons inside fmt by replacing the format specifier delimiter lets arbitrary nim code be run within fmt expressions.

Co-authored-by: flywind <xzsflywind@gmail.com>

* formatting,documentation,backslash escapes

Adding support for evaluating expressions by special-casing parentheses causes this regression: `&"""{ "(hello)" }"""` no longer parses.
In addition, code such as &"""{(if open: '(' else: ')')}""" wouldn't work.
To enable that, as well as the use of, e.g. Table constructors inside curlies, I've added backslash escapes.
This also means that if/for/etc statements, unparenthesized, will work, if the colons are escaped, but i've left that under-documented.

It's not exactly elegant having two types of escape, but I believe it's the least bad option.

* changelog
* added json strformat test
* pulled my thumb out and wrote a parser

Co-authored-by: Andreas Rumpf <rumpf_a@web.de>
Co-authored-by: flywind <xzsflywind@gmail.com>
2021-04-12 07:32:37 +02:00
..
2017-07-25 09:28:23 +02:00
2021-03-26 13:05:51 +01:00
2021-02-08 09:46:07 +01:00
2021-03-30 02:06:51 +02:00
2021-03-31 20:54:36 +02:00
2020-06-23 14:17:12 +02:00
2021-03-11 14:03:25 +01:00
2021-02-08 09:46:07 +01:00
2019-05-25 07:33:33 +02:00
2021-04-06 16:20:01 +02:00
2021-01-21 17:31:47 +01:00
2020-07-09 09:57:35 +02:00
2021-04-06 16:20:01 +02:00
2021-03-19 16:53:38 +01:00
2021-04-06 16:20:01 +02:00
2020-11-02 08:56:51 +01:00
2021-04-06 16:20:01 +02:00
2020-12-28 14:13:21 +01:00
2021-03-29 17:54:28 +02:00
2018-12-11 21:23:22 +01:00
2021-04-06 16:20:01 +02:00
2021-03-24 08:49:05 +01:00
2021-04-06 18:01:54 +02:00
2021-03-30 02:06:51 +02:00
2021-04-02 11:56:30 +02:00
2021-04-06 16:20:01 +02:00
2019-09-16 12:12:44 +02:00
2021-03-28 00:57:22 -07:00
2021-04-06 16:20:01 +02:00
2020-12-28 14:13:21 +01:00
2020-11-07 08:00:41 +00:00
2021-04-06 16:20:01 +02:00
2021-03-27 01:51:57 -07:00
2021-03-27 10:18:35 -07:00
2020-07-14 16:44:56 +02:00
2020-11-18 00:14:14 +00:00
2021-04-01 12:46:47 +02:00
2021-03-07 12:13:41 +01:00
2021-04-03 08:17:55 +02:00
2020-07-14 19:50:42 +02:00
2021-03-27 10:12:11 -07:00
2021-04-11 14:25:41 +02:00
2020-07-14 16:44:56 +02:00
2021-04-06 16:20:01 +02:00
2021-04-06 16:20:01 +02:00
2020-12-28 14:13:21 +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.