lum/lum-units

Lum Units

Maintainers

Details

github.com/supernovus/lum.units.php

Source

Issues

Installs: 7

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 3

Forks: 0

Open Issues: 0

v2.0.0 2021-12-15 23:23 UTC

Requires

MIT 3b3253f2be2d872f2d64cc7073040b08a50fa4f2

  • Timothy Totten <supernovus.woop@gmail.com>

This package is auto-updated.

Last update: 2024-04-16 04:52:06 UTC

README

Summary

Classes representing different units of measurement, with the ability to convert between them.

The configuration file format is a bit weird, but it's that way for historical reasons. I'll probably make it support a nicer format at some point, while keeping a compatibility wrapper for the original version.

Classes

Class Description
Lum\Units\Units The main Units library.
Lum\Units\Exception Something went wrong.
Lum\Units\HasUnits A trait for classes with units.
Lum\Units\TypeClass A container representing a class of units.
Lum\Units\Item An individual unit.

Examples

See examples for a sample data file, and a script to convert between the units defined in it. You can only convert between units of the same type class. So for instance:

php example/convert.php 10 ha ac
# 24.710516301528

php example/convert.php 5 min sec
# 300

php example/convert.php 1.5 b mb
# 1572864

php example/convert.php 10 ha mb
# PHP Fatal error: Uncaught Lum\Units\Exception...

TODO

  • Write tests.
  • Add new configuration format that is somewhat nicer.
  • Add some kind of formatting feature using the 'sign'.

Official URLs

This library can be found in two places:

Author

Timothy Totten

License

MIT