Skip to content
goloopPublic

About

Package includes validation functions of various data such as e-mail, bank card number, bank account IBAN, phone number and others.

Topics

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

1 watching

Forks

Latest commit

 

History

55 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

deps.dev License License Stay with Ukraine

is

is is a comprehensive set of format-validation functions for the data types you meet in web, financial and general Go applications — emails, phone numbers, bank cards, IBANs, coordinates, IP/host/URL, hashes, UUIDs, character classes and number properties.

Every validator answers a question about format, not real-world assignment or existence. Normalization is function-specific: non-strict IBAN removes ASCII spaces and uppercases input; Phone removes common separators. ISBN permits single spaces and hyphens between groups. Other contracts are documented below.

Features

  • Identity — Email, Nickname, VariableName, VariableNameFor (language-aware, reserved words included).
  • Financial — BankCard (Luhn + optional brand), IBAN/IBANCountry.
  • Geographic — Latitude, Longitude, Coordinates (string or float64).
  • Network — IPv4/IPv6/IP, MAC, URL, Hostname, Domain, Phone, E164.
  • Character classes — Alpha, Alnum, Digit, Numeric, Decimal, Float, Lower/Upper/Title, Space.
  • Numbers — Even/Odd, Whole, Natural, Positive/Negative/Zero.
  • Encoding & format — Base64/Base64URL, Hex/Bin, HexColor/ RGBColor, MD5/SHA1/SHA256/SHA512, UUID, JWT.
  • Telecom — IMEI, IMSI.

Installation

go get -u github.com/goloop/is/v2
import "github.com/goloop/is/v2"

Requires Go 1.24 or newer. Existing dependencies are g/v2 and trit/v2; the additional validators use only the Go standard library.

Quick start

package main

import (
    "fmt"

    "github.com/goloop/is/v2"
)

func main() {
    fmt.Println(is.Email("user@example.com"))         // true
    fmt.Println(is.Phone("+1 (234) 567-8900"))        // true
    fmt.Println(is.E164("+12345678900"))              // true
    fmt.Println(is.Coordinates(51.5074, -0.1278))     // true

    // BankCard: any brand, or require a specific one.
    fmt.Println(is.BankCard("4111111111111111"))          // true
    fmt.Println(is.BankCard("4111111111111111", is.Visa)) // true
    fmt.Println(is.IBAN("DE89370400440532013000"))        // true

    // Formats and hashes.
    fmt.Println(is.HexColor("#FF5733"))                             // true
    fmt.Println(is.UUID("550e8400-e29b-41d4-a716-446655440000"))    // true
}

For strict electronic IBAN syntax, pass true:

ok := is.IBAN("GB82WEST12345698765432", true)

Additional formats

Area Validators
Dates and time Date, RFC3339, UTCOffset, Duration
Network CIDR, IPPort, Port
Finance BIC, CurrencyCode, national BBAN grammar in IBAN
Identifiers UUIDv4, UUIDv7, ISBN, EAN, GTIN
Geography CountryCode, PostalCode for 11 countries
Technical JSON, MIME, SemVer, Base32, SHA384

See FORMATS.md for exact syntax, reference versions and limitations.

Documentation

Contributing

Contributions are welcome. Please run go test ./..., go vet ./... and gofmt -l . before submitting a pull request.

License

is is released under the MIT License. See LICENSE.

Release v2.4.0

Add structured format validators and enforce national IBAN grammar. See FORMATS.md for contracts.

About

Package includes validation functions of various data such as e-mail, bank card number, bank account IBAN, phone number and others.

Topics

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages