mavolin / standards

📄 Boringly simple parsing and validation for IBANs, BICs, ISO3166 alpha-2s, German Health Insurance Numbers, German Tax IDs, German Pension Insurance Numbers, and German Postal Codes.

standards

---

About

Boringly simple parsing and validation for various notations.

Supported Standards

• 🏦 BICs
• 💰 IBANs with country-specific BBAN validation
• 🏴‍☠️ ISO3166-1 Alpha2 (e.g. DE, or ES)
• 🚑 German Health Insurance Numbers (Krankenversicherungsnummern)
• 🧓 German Pension Insurance Numbers (Renten-/ Sozialversicherungsnummern)
• 💲 German Tax Identification Numbers (Steuer-IDs)
• ✉ German Postal Codes (Postleitzahlen)

Each Package Is the Same

Each standard is implemented in its own package, and each package provides a type for the standard, e.g. bic.BIC for BICs. That type contains all the information that can be extracted from the notation.

package bic

type BIC struct {
	BusinessPartyPrefix string
	CountryCode         string
	BusinessPartySuffix string
	BranchCode          string
}

Each type implements:

• String() string to get the notation pretty-printed
• Compact() string to get the notation in compact, machine-readable form
• MarshalText() ([]byte, error) same as Compact
• UnmarshalText([]byte) error to parse the notation

Additionally, each package provides these two functions:

• Parse(string) (Type, error) parses the given string, and validates it
• IsValid(string) bool simply checks whether the given string is valid in the given standard.

License

Built with ❤ by Maximilian von Lindern. Available under the MIT License.

standards's Issues

fix(iban): Incorrect national check sum validations for Finland and Estonia.

Describe the bug
Valid IBANs from Finland and Estonia are considered invalid due to national checksum validation.
Here are two random valid IBANs "EE321282973364859699", "FI9775844768617584".

Expected behavior
Valid IBANs are considered valid.

Error Messages
If applicable provide error messages and stack traces.

Versions
v0.4.0

Additional context

Consider replacing country codes with external library

Your own country codes take 55kb space. I think it would make more sense to use a dependency(github.com/biter777/countries) which is re-usable by other code as well whilst your own is not(really).