Skip to content
Amir Iranmanesh edited this page Aug 11, 2026 · 3 revisions

Go Persian Tools

An anthology of tools for working with Persian (Iranian) data in Go.

Go Reference

The module has no dependencies. go.mod lists nothing and there is no go.sum — everything is the standard library and this repository.

Packages

Package What it does
text Normalize Persian text, fold Arabic look-alikes, fix keyboard layouts, romanize
digit Convert digit sets, group and spell numbers, format Toman and Rial
bank Validate card numbers, resolve banks, validate Sheba (IBAN) codes
nationalid Validate national numbers (code-e Melli), resolve city and province
phonenumbers Validate Iranian mobiles, normalize prefixes, resolve operators
bill Determine a utility bill's type, amount and barcode; validate its id

Getting started

go get github.com/amiranmanesh/go-persian-tools@latest

Requires Go 1.22+. Import only the sub-packages you need.

The full API reference lives on pkg.go.dev. This wiki is the narrative guide.

Clone this wiki locally