standards

What's Changed

• Rewrite source parsing to allow for more source formats by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/72
• Deprecate "unused" status code as multiple status codes are unused and it's not part of the spec by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/73
• Exclude "Reserved for local use" from being included in language names as it doesn't have a single code by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/75
• Fix incorrect column count in script mapping resulting in incorrect Scripts by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/76
• Add missing old "Bolivar Soberano" and "Leone" as due to a name collision it was missing from the spec by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/74
• Add extensive alpha3 languages from ISO639-3 by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/71

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.4.0...v2.5.0

What's Changed

• Add Geographic regions by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/68

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.3.0...v2.4.0

What's Changed

• Introduce ISO-15924 Scripts by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/67

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.2.0...v2.3.0

What's Changed

• Fix typos by @szepeviktor in https://github.com/PrinsFrank/standards/pull/64
• Introduce EditorConfig by @szepeviktor in https://github.com/PrinsFrank/standards/pull/66
• Add Country groups: EU, EEA, EFTA, BRICS etc

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.1.0...v2.2.0

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.0.1...v2.1.0

What's Changed

"Netherlands (the)" has been renamed to "Netherlands (Kingdom of the)" in the CountryName specification by @github-actions in https://github.com/PrinsFrank/standards/pull/51

Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.0.0...v2.0.1

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: https://github.com/PrinsFrank/standards/compare/v1.6.0...v2.0.0

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.

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 https://github.com/PrinsFrank/standards/pull/50

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.5.0...v1.5.1

What's Changed

• Added HTTP Methods

Other changes

• Add incremental backoff to spec updating so manual retries are not ne… by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/46

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.4.0...v1.5.0

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 https://github.com/PrinsFrank/standards/pull/44

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.3.0...v1.4.0

What's Changed

• Add ::names ::values ::toArray helper to BackedEnum by @lakuapik in https://github.com/PrinsFrank/standards/pull/33

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.2.0...v1.3.0

What's Changed

• Add country calling codes enum by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/32

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.1.0...v1.2.0

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 https://github.com/PrinsFrank/standards/pull/14
• Fix Composer script in CI by @szepeviktor in https://github.com/PrinsFrank/standards/pull/16
• Run unit tests in CI by @szepeviktor in https://github.com/PrinsFrank/standards/pull/17
• Add phpstan by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/21
• Simplify BackedEnum by @szepeviktor in https://github.com/PrinsFrank/standards/pull/23
• Convert key variance to new enum to prevent many major releases by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/26
• Add code coverage generation by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/30

Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.0.0...v1.1.0

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 https://github.com/PrinsFrank/standards/pull/6
• Small fixes by @akalineskou in https://github.com/PrinsFrank/standards/pull/5
• Rename ISO4217_Alpha3 to ISO4217_Alpha_3 by @Wick96 in https://github.com/PrinsFrank/standards/pull/3
• HTTP Status Codes (iana) by @iRealWorlds in https://github.com/PrinsFrank/standards/pull/4
• Add automatic spec updating by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/9, https://github.com/PrinsFrank/standards/pull/10 and https://github.com/PrinsFrank/standards/pull/11
• Run SpecUpdater in a Composer way by @szepeviktor in https://github.com/PrinsFrank/standards/pull/13

New Contributors

• @lakuapik made their first contribution in https://github.com/PrinsFrank/standards/pull/6
• @akalineskou made their first contribution in https://github.com/PrinsFrank/standards/pull/5
• @Wick96 made their first contribution in https://github.com/PrinsFrank/standards/pull/3
• @iRealWorlds made their first contribution in https://github.com/PrinsFrank/standards/pull/4
• @szepeviktor made their first contribution in https://github.com/PrinsFrank/standards/pull/13

Full Changelog: https://github.com/PrinsFrank/standards/compare/v0.0.1...v1.0.0

Full Changelog: https://github.com/PrinsFrank/standards/commits/v0.0.1