Search by

rallisf1 / greek-postal-code-db

rallisf1

Read-only Greek postal-code data for PHP, backed by an embedded SQLite database.

Package info

github.com/rallisf1/greek-postal-code-db

Language:Go

pkg:composer/rallisf1/greek-postal-code-db

Security

Advisories: 0

Aikido package health analysis

Transparency log

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 14

Open Issues: 0

dev-main / 0.1.x-dev 2026-09-09 21:55 UTC

Requires

Requires (Dev)

Suggests

None

Provides

None

Conflicts

None

Replaces

None

MIT 4f1a3c3ba9a84c1041360d12630333abc405e2db

sqlitepostcodegreecegreekpostal-code

Published on Packagist.org on 2026-09-09 21:55 UTC

This package is auto-updated.

Last update: 2026-09-09 21:55:46 UTC

README

Language clients for the Greek Postal Code DB. Each package embeds the same read-only library.sqlite asset and is versioned and published independently.

Features

  • 1328 postal codes with hierarchy information (region, municipality, community, etc)
  • partial street database (which street and numbers belong to each postal code)
  • official government codes from Kallikratis (WIP)
  • sqlite database included for offline use
  • list / get / search / validateAddress functions

Packages

  • typescript: Node.js and Bun client, published as @rallisf1/greek-postal-code-db.
  • php: PHP 8.1+ Composer client, published from this repository root as rallisf1/greek-postal-code-db.
  • go: Go client, imported as github.com/rallisf1/greek-postal-code-db/go.
  • python: Python client; install from this monorepo with pip's #subdirectory=python URL.
  • rust: Rust crate; use Cargo's Git subdirectory = "rust" support until crates.io publication.
  • csharp: .NET 10 client, packaged for NuGet as GreekPostalCodeDb.
  • java: Java 21 client, packaged for Maven Central as io.github.rallisf1:greek-postal-code-db.
  • dart: native Dart client, published as greek_postal_code_db.
  • flutter: Flutter asset-bundle adapter, published as greek_postal_code_db_flutter.
  • swift: native Swift Package Manager client for Linux and Apple platforms.
  • models: private TypeScript types used internally; it is not published.
  • demo: internal Cloudflare Pages/D1 demo application; it is not published.

Contributing

Packages

These packages have been almost entirely AI generated. Bug fixes through PRs are welcome. For new features open an issue first, as it has to be implemented in all clients.

Dataset

PRs for ./library.sqlite are welcome as long as they are accompanied with the changes in SQL format.

Data sources used

  • ELTA street search form
  • OpencartGreece Post Code API
  • Central Association of chambers of commerce in Greece (GEMI)
  • data.gov.gr
  • locationiq.com