codingmatters/unit-of-measures

Unit of Measurements as Immutable Objects

dev-develop 2020-04-21 16:27 UTC

Requires

• php: ^7.3

Requires (Dev)

• laminas/laminas-coding-standard: ^1.0.0
• malukenho/mcbumpface: ^1.1.2
• phpunit/phpunit: ^9.1.2
• sebastian/phpcpd: ^5.0.2

GPL-3.0-or-later

• Coding Matters

README

A library for Unit of Measurements written in PHP.

Installation:

composer require codingmatters/unit-of-measures

Units for Mass

Using Weight::class in measuring the mass. Following are practical usage for the weight object.

use CodingMatters\UoM\Weight;

$weightInGrams = Weight::inGrams(1000);
$weightInPounds = Weight::inPounds(250);
$weightInOunce = Weight::inOunch(350);

Weight In Grams

use CodingMatters\UoM\Weight;

$weight = Weight::inGrams(1000); // will return string "1000 g"
$weight->unit(); // will return g
$weight->value(); // will return 1000

/**
 * Available conversion method:
 */
$weightInKilos = $weight->toKilo(); // will return string as "1 kg"
$weightInPounds = $weight->toPounds(); // will return string as ""

// you can still use the unit() and value() methods after conversion
$weightInKilos->unit(); // will return kg
$weightInKilos->value(); // will return 1

Contributions

Developed by Gab Amba and maintained by Coding Matters Software Development Services

We thank all the contributors who made this project possible.

Security and Vulnerabilities

If you discover a security vulnerability within this library, please send an email to Gab Amba via [e-mail]. All security vulnerabilities will be promptly addressed.

License

Copyright (C) 2020  Coding Matters Software Development Services

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.