standards

README

standards

---

About

Boringly simple parsing and validation for various notations.

Supported Standards

• 🏦 BICs (Business Identifier Codes/Bank Identifier Codes)
• 💰 IBANs (International Bank Account Numbers) with country-specific BBAN validation
• 🏴‍☠️ ISO3166-1 Alpha2 (Country Codes, such as DE, ES, etc.)
• 🧓 German Pension Insurance Numbers (Rentenversicherungsnummern/Sozialversicherungsnummern)
• 💲 German Tax Identification Numbers (Steuernummern)
• ✉ 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
• MarshalText() ([]byte, error) to get the notation in compact form
• 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() 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.