mimir

README

Mimir  

What is Mimir ?

Mimir is a lightweight library that exposes some functions to validate some banking informations.

Disclaimer

This library is still in development, so it might be possible that some methods change over time.

Methods available

As the project just started, it is quite poor in method.
Stay tuned for updates !

• Validate an IBAN (every country supported)
• Compute check digits from a valid IBAN
• Get country configuration (ISO 13616-Compliant IBAN Formats)

Use

Get

$ go get -u github.com/vdlbk/mimir

Examples

Validate an IBAN

package main

import (
	"fmt"
	"github.com/vdlbk/mimir"
)

func main(){
	IBAN := "FR1420041010050500013M02606"
	
	ok, _ := mimir.IsIBANValid(IBAN)
	fmt.Println(ok) // true
	
	badIBAN := "FR1420041010050500013M02605"
    	
    ok, _ = mimir.IsIBANValid(badIBAN)
    fmt.Println(ok) // false
}

Documentation

Index

• Constants
• func GetCheckDigits(iban string) (string, string, error)
• func GetCountryConfiguration(countryCode string) (*configuration, error)
• func IsBBANValid(iban string) (bool, error)
• func IsIBANValid(iban string) (bool, error)

Constants

const (
	// ErrIBANTooshort is the error when a IBAN is too short for the validation process
	ErrIBANTooshort = mimirError("IBAN is too short")

	// ErrIBANIncorrectLength is the error when a IBAN does not have the required length
	ErrIBANIncorrectLength = mimirError("IBAN incorrect length")

	// ErrIBANInvalidChecksum is the error when a IBAN is invalid
	ErrIBANInvalidChecksum = mimirError("IBAN invalid checksum")

	// ErrCountryCodeDoesNotExist is the error when you lookup for a country code that does not exists
	ErrCountryCodeDoesNotExist = mimirError("Country Code does not exist")
)

Functions

func GetCheckDigits

func GetCheckDigits(iban string) (string, string, error)

GetCheckDigits compute the check digits from a given IBAN. Returns the computed digits, the IBAN set with the check digits or an error if something goes wrong

func GetCountryConfiguration

func GetCountryConfiguration(countryCode string) (*configuration, error)

GetCountryConfiguration returns ISO 13616-Compliant IBAN Formats from a given country code If the countryCode does not exist in the list, returns an error `ErrCountryCodeDoesNotExist`

func IsBBANValid

func IsBBANValid(iban string) (bool, error)

IsBBANValid checks if the given BBAN is valid based on the country its belong to

func IsIBANValid

func IsIBANValid(iban string) (bool, error)

IsIBANValid checks if the given IBAN is valid based on the country its belong to