[ANN] ggspec v1.0 released - a unit testing framework

[ANN] ggspec v1.0 released - a unit testing framework

[Yawar Amin]

[-- Attachment #1: Type: text/plain, Size: 1363 bytes --]

Hi folks,

I've just polished up and released ggspec v1.0.[1] Ggspec is a unit testing framework targeting Guile 1.8.8, with Guile 2 support in the planning stage. Excerpt from the release notes:

  - The `ggspec` script is a test runner that will find and run all tests in your project's `spec` subdirectory (recursively).

  - Test results (pass or fail) and details (if fail) are output _as soon as they are known._ This means before the next test is run. So you get immediate feedback.

  - All setups (i.e. definitions) are re-run before _every_ test, and so are all teardowns. This means that all setup values used in tests are completely isolated from each other and every test runs in a clean environment. Modulo, of course, you or some implicitly-run Scheme procedure changing global or thread-local state.

  - **Warning** that the `test` macro API will change slightly, soon. You should be future-proof if you restrict the test body to a single expression. Use `begin` if you need to. E.g., use:

...
(test "Description"
  e
  (begin expr1 expr2 exp3 ...))
...

... instead of:

...
(test "Description"
  e
  expr1 expr2 exp3 ...)
...

Tutorial is on the repo home page.[2] I'd welcome feedback.

Regards,

Yawar

[1] https://github.com/yawaramin/ggspec/releases/tag/v1.0

[2] https://github.com/yawaramin/ggspec



[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 899 bytes --]

Re: [ANN] ggspec v1.0 released - a unit testing framework

[Jan Wedekind]

Hi,
Maybe you might be interested in making the output TAP compatible [3]? 
Automake 1.14 supports TAP testing. I am using Guile-TAP [4] at the moment [5].

Regards Jan

[3] https://en.wikipedia.org/wiki/Test_Anything_Protocol
[4] https://github.com/xevz/guile-tap/
[5] https://github.com/wedesoft/aiscm/

On Sun, 9 Feb 2014, Yawar Amin wrote:

> Hi folks,
>
> I've just polished up and released ggspec v1.0.[1] Ggspec is a unit testing framework targeting Guile 1.8.8, with Guile 2 support in the planning stage. Excerpt from the release notes:
>
>  - The `ggspec` script is a test runner that will find and run all tests in your project's `spec` subdirectory (recursively).
>
>  - Test results (pass or fail) and details (if fail) are output _as soon as they are known._ This means before the next test is run. So you get immediate feedback.
>
>  - All setups (i.e. definitions) are re-run before _every_ test, and so are all teardowns. This means that all setup values used in tests are completely isolated from each other and every test runs in a clean environment. Modulo, of course, you or some implicitly-run Scheme procedure changing global or thread-local state.
>
>  - **Warning** that the `test` macro API will change slightly, soon. You should be future-proof if you restrict the test body to a single expression. Use `begin` if you need to. E.g., use:
>
> ...
> (test "Description"
>  e
>  (begin expr1 expr2 exp3 ...))
> ...
>
> ... instead of:
>
> ...
> (test "Description"
>  e
>  expr1 expr2 exp3 ...)
> ...
>
> Tutorial is on the repo home page.[2] I'd welcome feedback.
>
> Regards,
>
> Yawar
>
> [1] https://github.com/yawaramin/ggspec/releases/tag/v1.0
>
> [2] https://github.com/yawaramin/ggspec
>
>
>

Re: [ANN] ggspec v1.0 released - a unit testing framework

[Yawar Amin]

[-- Attachment #1: Type: text/plain, Size: 892 bytes --]

Hello Jan,

On 2014-02-10 16:52, Jan Wedekind wrote:
> Hi,
> Maybe you might be interested in making the output TAP compatible [3]? Automake 1.14 supports TAP testing. I am using Guile-TAP [4] at the moment [5].
>
> Regards Jan
>
> [3] https://en.wikipedia.org/wiki/Test_Anything_Protocol
> [4] https://github.com/xevz/guile-tap/
> [5] https://github.com/wedesoft/aiscm/

TAP has been on my radar recently.[6] But I have to admit I didn't look at it very seriously ... until now--now that you mention Automake.

I'm about 95% sure I can write an output formatter for ggspec that formats to TAP. But before that I need to clean up the internals a bit. I've made a plan [7] and am going to implement it--stay tuned....

Regards,

Yawar

[6] http://stackoverflow.com/q/72057/20371
[7] https://github.com/yawaramin/ggspec/commit/0d812c5e6c1e3343ab0a820058e07c7771e24249



[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 899 bytes --]

Re: [ANN] ggspec v1.0 released - a unit testing framework

[Jan Wedekind]

Hi Yawar,
Cool, hopefully the Automake TAP support will be helpful. I've created an 
example project which might save you some time [8]. Note that you do need 
a recent version of the Autotools.

Regards Jan

[8] https://github.com/wedesoft/automake-tap/releases

On Mon, 10 Feb 2014, Yawar Amin wrote:

> Hello Jan,
>
> On 2014-02-10 16:52, Jan Wedekind wrote:
>> Hi, Maybe you might be interested in making the output TAP compatible 
>> [3]? Automake 1.14 supports TAP testing. I am using Guile-TAP [4] at 
>> the moment [5].
>>
>> Regards Jan
>>
>> [3] https://en.wikipedia.org/wiki/Test_Anything_Protocol
>> [4] https://github.com/xevz/guile-tap/
>> [5] https://github.com/wedesoft/aiscm/
>
> TAP has been on my radar recently.[6] But I have to admit I didn't look 
> at it very seriously ... until now--now that you mention Automake.
>
> I'm about 95% sure I can write an output formatter for ggspec that 
> formats to TAP. But before that I need to clean up the internals a bit. 
> I've made a plan [7] and am going to implement it--stay tuned....
>
> Regards,
>
> Yawar
>
> [6] http://stackoverflow.com/q/72057/20371
> [7] https://github.com/yawaramin/ggspec/commit/0d812c5e6c1e3343ab0a820058e07c7771e24249
>
>
>