Git Product home page Git Product logo

ctap's Introduction

ctap

GoReportCard Build Status GitHub license

ctap is a lightweight, portable TAP-output colouriser, written in Go.

It turns boring old TAP output:

Boring TAP output

into snazzy, easily-scannable output:

Snazzy, scannable TAP output

and returns non-zero exit codes on failures.

Installation

Binary packages are available from the Releases page.

Or if you have go installed, you can do:

go install github.com/gavincarr/ctap@latest

which installs the latest version of ctap in your $GOPATH/bin or $HOME/go/bin directory (which you might need to add to your $PATH).

Usage

Usage:
  ctap [OPTIONS] [TapFile]

Application Options:
  -f, --failures  show test failures (suppress TAP successes)
  -g, --glyphs    show ✓✗ glyphs instead of 'ok/not ok' in TAP output
  -s, --summary   append a Test::Harness-like summary of the test results
  -V, --cversion= colour to use for version lines
  -P, --cplan=    colour to use for plan lines
  -O, --cok=      colour to use for test ok lines
  -F, --cfail=    colour to use for test fail/not ok lines
  -D, --cdiag=    colour to use for diagnostic lines
  -B, --cbail=    colour to use for bail out lines

Help Options:
  -h, --help      Show this help message


Colour strings may be any of the following colour names:

  red, green, blue, yellow, cyan, magenta, white, black, gray, default

They may also be hex colour strings like "#cc9900" or "#c90" (with the
leading "#" optional).

Colour names or hex strings can also have any of the following modifiers
appended to them (space-separated):

  bold, italic, underscore, reverse, blink, concealed, fuzzy

(though how they work will depend on your terminal support)

Todo

  • add -f option to show failures (suppress successes from TAP output)
  • add -g option to use glyphs instead of 'ok/not ok' in TAP output
  • add options to specify custom colours (-VPOFDB?)
  • add config file support for standard options/colours
  • add a --save option for setting config file standard options/colours
  • add other renderers to transmute TAP output (e.g. 'dots') (?)

See Also

  • Tap Colorize - nice javascript library and cli utility

  • Tap Prettify - javascript formatter with a focus on making TAP output useful (rather than colourful)

  • Tap::Formatter::Color - the original perl TAP color formatter library

  • Awesome TAP - great general list of TAP-related resources (esp. javascript-related)

Author

Copyright 2021 Gavin Carr [email protected].

Licence

ctap is available under the terms of the MIT Licence.

ctap's People

Contributors

gavincarr avatar

Stargazers

 avatar

Watchers

 avatar James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.