Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 24 days 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 (over 8 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 (7 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
[](https://travis-ci.org/chocolateboy/startup-time)
[](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).