Rconybea / xo-ratio

constexpr header-only ratio library

ratio library

Header-only, constexpr library providing exact representation for rational numbers.

Relative to std::ratio:

1. Uses constexpr instead of creating new types. This means it can be used seamlessly at runtime.
2. Supports a few more arithmetic operations, for example exponentiation to integer powers.
3. Provides constexpr conversion to fixed-capacity strings (using xo-flatstring)
4. Provides concept support (with c++20)
5. Requires modern (c++17) support to achieve this

Relative to boost::ratio:

1. Streamlined, assumes modern compiler support

Documentation

• xo-ratio documentation [under construction]: documentation
• unit test coverage here: coverage

Getting Started

install dependencies

• github/Rconybea/xo-cmake cmake macros
• github/Rconybea/xo-flatstring fixed-capacity strings
• github/rconybea/xo-indentlog logging (used by unit tests)
• github/rconybea/xo-randomgen rng (used by unit tests)

clone xo-ratio

$ cd ~/proj   # for example
$ git clone https://github.com/Rconybea/xo-ratio

build + install

$ cd xo-ratio
$ PREFIX=/usr/local # for example
$ BUILDDIR=.build   # for example
$ mkdir ${BUILDDIR}
$ cmake --build .build
$ cmake --install .build

build with unit test coverage

$ cd xo-ratio
$ mkdir .build-ccov
$ cmake -DCMAKE_BUILD_TYPE=coverage -B .build-ccov
$ cmake --build .build-ccov

run coverage-enabled unit tests

$ cmake --build .build-ccov -- test

generate html+text coverage report

$ cmake --build .build-ccov -- ccov

browse to .build-ccov/ccov/html/index.html

LSP support

$ cd xo-ratio
$ ln -s .build/compile_commands.json