Releases: PrinsFrank/standards
v2.0.1 "Netherlands (the)" has been renamed to "Netherlands (Kingdom of the)"
What's Changed
"Netherlands (the)" has been renamed to "Netherlands (Kingdom of the)" in the CountryName specification by @github-actions in #51
Full Changelog: v2.0.0...v2.0.1
v2.0.0 Readability Improvements
As this package is getting adopted and more people start using it, I got some valid feedback on the readability of the standards in codebases.
- If you want to use a country code in code, you need to navigate the namespaces or know the ISO code of the spec for the country codes
- If a country has a long formal name, using the enum name may span an entire line of code decreasing readability.
This update solves both of these problems.
For an upgrade guide please check the UPGRADING.md in the root of this project.
Full Changelog: v1.6.0...v2.0.0
v1.6.0 Added short country code variant
As the country code enums names are based on the actual country name, they can become quite long and decrease readability when used in code. As to not make any backwards incompatible changes, a new set of country code enums was added in the CountryCodeShort namespace that are optimised for use in code.
v1.5.1 Croation Kuna has been replaced by the Euro, so it has been deprecated
What's Changed
As of today Croatia joined the Eurozone and Schengen area, and the country will use the Euro instead of the Croatian Kuna. As such, the Kuna has already been removed from the ISO4217 specification by the maintaining upstream party for it - the six group.
To maintain backwards compatibility in this minor release, the enum cases will stay in this specification package and will just be marked as deprecated.
- Automatic Currency spec update by @github-actions in #50
Full Changelog: v1.5.0...v1.5.1
v1.5.0 Added HTTP Methods
What's Changed
- Added HTTP Methods
Other changes
- Add incremental backoff to spec updating so manual retries are not ne… by @PrinsFrank in #46
Full Changelog: v1.4.0...v1.5.0
Contributors
Assets 2
v1.4.0 Add UnitEnum utility class
What's Changed
- Add UnitEnum utility class providing similar function as BackedEnum functionality but for UnitEnums instead.
- Update the six group datasource url for currency codes as it has been update on their website by @PrinsFrank in #44
Full Changelog: v1.3.0...v1.4.0
Contributors
Assets 2
v1.3.0 Expand BackedEnum utility class with ::names, ::values and ::toArray
What's Changed
Full Changelog: v1.2.0...v1.3.0
Contributors
Assets 2
v1.2.0 Added Country calling codes
Contributors
Assets 2
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
Contributors
Assets 2
v1.0.0 - First stable release
What's Changed
With version 1.0.0, this package is now stable! As the standards are now pulled daily from their respective sources, this package will be updated as soon as their counterpart spec updates! Unfortunately, when pulling from the official sources it became apparent that the 0.0.1 release contained several enum keys that were not consistent with the official spec. make sure to follow the upgrade guide to implement these changes and get up and running with this new release!
- Add .gitattributes by @lakuapik in #6
- Small fixes by @akalineskou in #5
- Rename ISO4217_Alpha3 to ISO4217_Alpha_3 by @Wick96 in #3
- HTTP Status Codes (iana) by @irealworlds in #4
- Add automatic spec updating by @PrinsFrank in #9, #10 and #11
- Run SpecUpdater in a Composer way by @szepeviktor in #13
New Contributors
- @lakuapik made their first contribution in #6
- @akalineskou made their first contribution in #5
- @Wick96 made their first contribution in #3
- @irealworlds made their first contribution in #4
- @szepeviktor made their first contribution in #13
Full Changelog: v0.0.1...v1.0.0
