v1.1.0 Turkiye rename & lots of new features
What's Changed
Turkey, Türkiye and BC key changes.
A new minor version is released as Turkey has now officially been renamed to Türkiye in ISO3166.
This brought one major challenge though; Renaming enum names are breaking changes, and releasing a new major version for every country rename is not ideal and leaves a lot of overhead for package users. Therefor, a new enum is added with the latest name for countries, currencies and languages, that can be used instead of enum keys. Keys will not change to keep this package backwards compatible:
/**
* @source https://www.iso.org/obp/ui/#search/code/
*/
enum ISO3166_1_Name: string
{
case Turkey = 'Türkiye';
// Enum key is unchanged to be backwards compatible
}
Methods are added to get the name corresponding to alpha2, alpha3 and numeric values:
$turkiye = ISO3166_1_Alpha_2::fromValue('TR');
$name = $turkiye->toISO3166_Name()->value(); // Türkiye
Helper methods for casing and numeric values as integers
All alpha2 and alpha3 values in ISO3166 and ISO4127 are uppercase, and lowercase in ISO639. You may want to get them as lowercase and uppercase respectfully. Methods to get these values are now available:
$netherlands = ISO3166_1_Alpha_2::fromValue('NL');
$netherlandsLowerCase = $netherlands->lowerCaseValue(); // nl
$dutchFlemish = ISO639_1_Alpha_2::fromValue('nl');
$dutchFlemishUpperCase = $dutchFlemish->upperCaseValue(): // NL
Numeric enums sometimes have leading zeros that are required as their complete value. You may want to get those values as integers though;
$euro = ISO4217_Numeric::fromValue('978');
$euro = ISO4217_Numeric::fromInt(978);
$euroAsInt = $euro->valueAsInt(): // 978
Other changes
Apart from these changes, a lot has been done to improve this package's stability and make this package more mature;
- Name Composer scripts like $tool:$action by @szepeviktor in #14
- Fix Composer script in CI by @szepeviktor in #16
- Run unit tests in CI by @szepeviktor in #17
- Add phpstan by @PrinsFrank in #21
- Simplify BackedEnum by @szepeviktor in #23
- Convert key variance to new enum to prevent many major releases by @PrinsFrank in #26
- Add code coverage generation by @PrinsFrank in #30
Full Changelog: v1.0.0...v1.1.0
