go-countries

go-countries is a Go library designed to simplify working with ISO-3166 country codes in applications. It provides a set of types and functions for easy lookup, validation, and database integration, eliminating the need to manually manage country code data.

Key Features

• Code Generation — Created with a code generator for accuracy and maintainability.
• Multiple Interfaces — Implements driver.Valuer, ozzo validation.Validate, Stringer, and json.Unmarshaler for seamless integration.
• Flexible Lookup — Search countries by Alpha-2 code, Alpha-3 code, or full name with error-handling variants.
• Validation Support — Works directly with ozzo-validation for required field and value checks.
• Database Ready — Stores and retrieves codes as standardized strings in databases.
• Predefined Constants — Includes constants like country.Canada, country.Alpha2CA, and country.NameCanada for type-safe usage.

Philosophy

The library prioritizes simplicity and interoperability, providing a minimal, type-safe abstraction over ISO-3166 data that fits naturally into Go application workflows.