Skip to main content
Version: 2.1.0

Changelog

All notable changes to Pedantigo are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.1.0] - 2026-08-17​

Changed​

  • Added a Gin plugin (plugins/web/gin) that installs pedantigo into Gin's codec/json.API and binding.Validator hooks, giving automatic request validation on ShouldBindJSON/Query/Form/Header — mirrors the existing Echo Binder plugin by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/27
  • Fixed a bug where RegisterValidation/RegisterAlias/RegisterTagNameFunc could silently evict Register()'d framework validators, by splitting the core cache into a permanent registry and a disposable Simple API cache by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/27
  • Added ValidateInto, a type-erased validation lookup for framework adapters that returns a clear error on non-pointer/nil input instead of silently reporting success by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/27
  • Made the Register() tag-name check race-free via atomic compare-and-swap, and pedantigo now enforces a single struct-tag name across all Register()'d validators in a process by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/27
  • Documented the Echo Binder plugin in the README by @tushar2708
  • Removed the dead Go Report Card badge, added a dedicated Lint workflow/badge, and documented that MAC-address parsing behavior depends on the consuming app's Go toolchain, not pedantigo's go.mod floor by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/26
  • First release where plugins/web/echo and plugins/web/gin are tagged as independently installable Go modules (plugins/web/echo/v2.1.0, plugins/web/gin/v2.1.0) — earlier releases only tagged the root module, so a pinned go get of either plugin wasn't possible before now

[2.0.1] - 2026-08-08​

Changed​

  • Retracted v2.0.0 in go.mod — it was published with a stale pre-restructure layout (bare validator.go at module root, before the move to the validator/ subpackage) that got permanently cached on the public Go module proxy before the fix landed. v2.0.1 is the corrected release; use this version or later by @tushar2708

[2.0.0] - 2026-08-06​

Changed​

Breaking Changes​

  • Default struct tag changed from pedantigo to validate — rename tags to validate: or call SetTagName("pedantigo") to keep v1 behavior.
  • Import path changed to github.com/SmrutAI/pedantigo/v2 (Go semantic import versioning for v2+).
  • feat!: change default struct tag from pedantigo to validate, feat!: bump module to v2 for pedantigo/v2 import path, ci: pin golangci-lint to go1.25.12 via GOTOOLCHAIN, bump to v2.12.2 by @tushar2708 in https://github.com/SmrutAI/pedantigo/pull/22
  • Update README with v2 breaking change details by @tushar2708 in 4922f87
  • docs: fix import path casing and missing v2 suffix in code examples by @tushar2708 in 8d4b259
  • test: cover pedantigo as an explicit custom tag name by @tushar2708 in 46f1a03

[1.1.4] - 2026-06-21​

Changed​

Release v1.1.4 with schema improvements, omitempty support, and JSON array examples syntax

[1.1.3] - 2026-02-04​

Changed​

What's Changed​

What's Changed​

[1.1.2] - 2026-01-06​

Changed​

What's Changed​

[1.1.1] - 2026-01-05​

Changed​

What's Changed​

[1.1.0] - 2025-12-27​

Changed​

What's Changed​

[1.0.0] - 2025-12-21​

Changed​

What's Changed​

[0.1.2] - 2025-12-20​

Changed​

[0.1.1] - 2025-12-20​

Changed​

[0.1.0] - 2024-12-18​

Initial release of Pedantigo - Pydantic-inspired validation for Go.

Added​

Core Validation​

  • Struct tag-based validation with pedantigo:"..." tags
  • 100+ built-in validation constraints
  • Detailed error messages with field paths
  • Support for nested structs and slices
  • Unmarshal[T]() - Parse JSON and validate in one call
  • NewModel[T]() - Create validated instances from JSON, maps, or structs
  • Validate[T]() - Validate existing struct instances
  • Schema[T]() - Get cached JSON Schema
  • SchemaJSON[T]() - Get JSON Schema as bytes
  • Marshal[T]() - Validate and marshal to JSON
  • Dict[T]() - Convert struct to map

Validator API (Advanced)​

  • Validator[T] struct for custom configurations
  • ValidatorOptions for strict mode, extra fields handling
  • ExtraFieldsMode: Ignore, Forbid, or Allow extra JSON fields

JSON Schema Generation​

  • Automatic generation from struct definitions
  • 240x speedup with caching (via SchemaRegistry)
  • OpenAPI 3.0 compatible output

Streaming Validation​

  • StreamParser for partial JSON validation
  • Real-time validation of LLM streaming responses
  • Progress callbacks for incremental updates

Discriminated Unions​

  • Union[A, B, C] type for type-safe unions
  • Automatic discriminator detection
  • JSON Schema oneOf support

Field Types​

  • Secret[T] - Masks sensitive values in logs/JSON
  • Pointer support for optional fields
  • Custom type support via Validatable interface