Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chocolateboy/startup-time

A command-line benchmarking tool to measure the startup times of programs in various languages
https://github.com/chocolateboy/startup-time

benchmark benchmarks cli command-line command-line-tool console startup startup-time startup-times

Last synced: 2 months ago
JSON representation

A command-line benchmarking tool to measure the startup times of programs in various languages

Host: GitHub
URL: https://github.com/chocolateboy/startup-time
Owner: chocolateboy
License: artistic-2.0
Created: 2016-03-09T22:04:55.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2020-10-17T17:11:24.000Z (about 4 years ago)
Last Synced: 2024-04-25T02:25:55.010Z (8 months ago)
Topics: benchmark, benchmarks, cli, command-line, command-line-tool, console, startup, startup-time, startup-times
Language: Ruby
Homepage:
Size: 111 KB
Stars: 14
Watchers: 4
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md

Awesome Lists containing this project

Open-Source-Ruby-and-Rails-Apps - startup-time - A command-line benchmarking tool to measure the startup times of programs in various languages 🔥 🚀 (Happy Exploring 🤘)

README

        # startup-time

[![Build Status](https://travis-ci.org/chocolateboy/startup-time.svg)](https://travis-ci.org/chocolateboy/startup-time)

[![Gem Version](https://img.shields.io/gem/v/startup-time.svg)](https://rubygems.org/gems/startup-time)

- [NAME](#name)

- [INSTALLATION](#installation)

- [SYNOPSIS](#synopsis)

  - [Sample Output](#sample-output)

- [DESCRIPTION](#description)

  - [Why?](#why)

- [OPTIONS](#options)

- [COMPATIBILITY](#compatibility)

- [LINKS](#links)

  - [Response Times](#response-times)

  - [Hello World](#hello-world)

- [SEE ALSO](#see-also)

- [AUTHOR](#author)

- [VERSION](#version)

- [COPYRIGHT AND LICENSE](#copyright-and-license)

## NAME

startup-time - a command-line benchmarking tool to measure the startup times of programs in various languages

## INSTALLATION

```sh

$ gem install startup-time

```

## SYNOPSIS

```sh

# run all available tests

$ startup-time

# only run the "fast" tests

$ startup-time --only fast

# run all but the "slow" tests

$ startup-time --omit slow

# only run the JVM tests (e.g. Java, Scala etc.)

$ startup-time --only jvm

# only run tests which finish quickly

$ startup-time --only fast --omit slow-compile

# run the test suite for at least 30 seconds (default: 10)

$ startup-time --time 30

# run each program 10 times

$ startup-time --count 10

```

### Sample Output

    Test                      Time (ms)

    C (gcc)                        0.38

    Rust                           0.64

    Lua (LuaJIT)                   0.68

    Go                             0.88

    JavaScript (QuickJS)           0.91

    Lua                            0.97

    Haskell (GHC)                  1.12

    C++ (g++)                      1.26

    Crystal                        1.68

    Perl                           1.69

    Bash                           2.69

    Python 2                       9.32

    JavaScript (Deno)             14.53

    Python 3                      22.46

    JavaScript (SpiderMonkey)     24.69

    JavaScript (Node.js)          41.70

    Ruby                          55.24

## DESCRIPTION

A command-line tool which measures how long it takes to execute

["Hello, world!"](https://en.wikipedia.org/wiki/%22Hello,_World!%22_program)

programs written in various languages. It records the fastest time for each

program and prints a sorted table of the results after each run. Apart from

[ruby](#compatibility), the tool doesn't require any of the tested languages to

be installed: if a compiler/interpreter is not available, the test is skipped.

### Why?

To determine which languages are practical (or impractical) to use for

command-line interface (CLI) tools. Anything under

[100 milliseconds](https://www.nngroup.com/articles/response-times-3-important-limits/)

is perceived as instantaneous. Anything over that is perceptibly delayed, which

can impair interactivity and productivity on the command line, and can mean the

difference between staying in the zone and losing your train of thought.

## OPTIONS

```

USAGE:

    startup-time [options]

OPTIONS:

    -c, --count, --rounds INTEGER    The number of times to run each program (minimum: 2)

        --clean                      Remove the build directory and exit

                                     (targets will be recompiled on the next run)

    -d, --dir PATH                   Specify the build directory

                                     (default: "${XDG_CACHE_HOME:-~/.cache}/startup-time")

    -h, --help                       Show this help message and exit

    -H, --help-only, --help-omit     Show the IDs and groups that can be passed to --only and --omit

    -j, --json                       Output the results in JSON format (implies --quiet)

    -o, --only LIST                  Only run the specified tests (comma-separated list of IDs/groups)

    -O, --omit LIST                  Don't run the specified tests (comma-separated list of IDs/groups)

    -q, --quiet                      Suppress all inessential output

    -t, --time INTEGER               The minimum number of seconds to run the test suite for

                                     (minimum: 2, default: 10)

    -v, --verbose                    Enable verbose logging

    -V, --version                    Display the version and exit

```

## COMPATIBILITY

startup-time is tested and supported on all versions of Ruby

[supported by the ruby-core team](https://www.ruby-lang.org/en/downloads/branches/),

i.e., currently, Ruby 2.5 and above.

## LINKS

### Response Times

- [100 milliseconds](https://cogsci.stackexchange.com/questions/1664/what-is-the-threshold-where-actions-are-perceived-as-instant)

- [Response Times: The 3 Important Limits](https://www.nngroup.com/articles/response-times-3-important-limits/)

### Hello World

- [Comparison of "Hello, world!" syscalls](https://drewdevault.com/2020/01/04/Slow.html)

- [Hello "Hello world!"](https://blog.jfo.click/hello-hello-world/)

## SEE ALSO

- [drujensen/fib](https://github.com/drujensen/fib) - a recursive Fibonacci benchmark for multiple languages

- [Gabriel439/bench](https://github.com/Gabriel439/bench) - a command-line benchmark tool written in Haskell

- [gnustavo/startup-times](https://github.com/gnustavo/startup-times) - a script to investigate the startup times of several programming languages

- [jwiegley/helloworld](https://github.com/jwiegley/helloworld) - a comparison of "Hello, world" startup times in various languages

- [sharkdp/hyperfine](https://github.com/sharkdp/hyperfine) - a command-line benchmarking tool

## AUTHOR

[chocolateboy](mailto:[email protected])

## VERSION

1.3.0

## COPYRIGHT AND LICENSE

Copyright © 2015-2020 by chocolateboy

This benchmark game is free software; you can redistribute it and/or modify it under the

terms of the [Artistic License 2.0](https://www.opensource.org/licenses/artistic-license-2.0.php).