package decimal

  1. Overview
  2. Docs
Arbitrary-precision floating-point decimal library

Install

Dune Dependency

Authors

Maintainers

Sources

decimal-1.0.1.tbz
sha256=9297d87d647301afd92be6ba2fe8512ea81c2e306454992e6662e80344654ff9
sha512=7acbc020ff0b1be2fa3258bb581143ee9d92b3ffab0ada21a79daeb568eaaa1317b71445ef047fc4b88efe0c592bb5239719442a646dbdb9ce8794415cdd5293

Description

Arbitrary-precision floating-point decimal library ported from the Python decimal module.

Published: 08 Aug 2023

README

decimal

Arbitrary-precision floating-point decimal type implemented in OCaml. Ported from Python decimal module. It uses Zarith to do biginteger arithmetic.

Opam: https://ocaml.org/p/decimal

License

This package is licensed under the Python Software Foundation License v2, for the sake of simplicity, as it is a derived work of the Python decimal module.

Examples

See next section (below) for dune instructions.

$ opam install decimal # if trying out
# (* if trying out: *)
  #require "decimal";;
  #require "ppx_decimal";;
# (* tell the REPL how to display decimals *)
  #install_printer Decimal.pp;;
# (* PPX gives convenience literal syntax *)
  Decimal.(0.1m + 0.2m);;
- : Decimal.t = 0.3
# (* default precision is 32 *)
  Decimal.(of_int 1 / of_int 3);;
- : Decimal.t = 0.33333333333333333333333333333333
# (* round to decimal places: *)
  Decimal.(round ~n:2 (of_int 22 / of_int 7));;
- : Decimal.t = 3.14

Use with dune

In your dune file's executable or similar stanza:

 (libraries decimal)
 (preprocess (pps ppx_decimal))

Dev

Build:

dune build

Try in REPL:

dune utop

Tests

The test runner source is in test/decimal_test.ml. It parses and runs the test cases in test/data/. I am adding test case data files from the Python snapshot as I go.

Run current tests:

dune test

Note that, some of the tests don't make sense for the OCaml port and have thus been deleted. If you ever need to update to new versions of the test files, you can apply the changes as patches after re-dowloading the relevant *.decTest files:

git show 07074859567e936b8d170aba5ef58889a4d9d467 | git apply
git show ae0196377fb7a99db7f198f2fb242e6a2fe4541e | git apply

Dependencies (3)

  1. zarith >= "1.10" & < "2.0.0"
  2. ocaml >= "4.08.0"
  3. dune >= "2.7"

Dev Dependencies (3)

  1. odoc with-doc
  2. angstrom >= "0.15.0" & < "1.0.0" & with-test
  3. alcotest >= "1.5.0" & < "2.0.0" & with-test

Used by (1)

  1. ppx_decimal >= "1.0.1"

Conflicts

None