thai_geodata 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a834e0b3da9844bd334e183cf4b49fc2bbf8a64a10eb57c6534431dca99b4232
+  data.tar.gz: 4b5423f51b064bcb9280054ee8f81e659f0815081deef33c758b302a41d3680b
+SHA512:
+  metadata.gz: 6fe2aedf5751f62e91882cf2200e7f2ca0aceab6c8cb5a71c2e3d1fab10fb23ea8f999a47467bd42cbce539e9ee5c2db7db01158405db967e5553520ea9b7fbd
+  data.tar.gz: 0dc0743834208419ac619b3bb1960a89f7cc5f04494bcd20685f1ab222f79cc6573d52ea94d1f9ac9369d1758c52ee9cd903701b0de9309445473b1aa727e61e

data/.gitignore

@@ -0,0 +1,56 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*

data/Gemfile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Use the .gemspec to define runtime & development dependencies
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chayut Orapinpatipat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,92 @@
+# ThaiGeodata
+
+A lightweight Ruby gem providing Thailand’s official administrative geography data (provinces, districts, subdistricts) and postal codes in a Ruby-friendly API. All data is sourced from the [Thailand Geography JSON](https://github.com/thailand-geography-data/thailand-geography-json) project under the MIT license.
+
+## Features
+
+* 🔍 Fast lookups of provinces, districts, subdistricts, and postal codes
+* 🇹🇭 Full Thai & English names
+* 📦 Zero external dependencies (only stdlib JSON)
+* 🛠 Lazy–loaded and cached in memory
+
+## Installation
+
+Add this line to your application’s `Gemfile`:
+
+```ruby
+gem "thai_geodata"
+```
+
+Then execute:
+
+```bash
+bundle install
+```
+
+Or install directly:
+
+```bash
+gem install thai_geodata
+```
+
+## Usage
+
+```ruby
+require "thai_geodata"
+
+# List all provinces
+ThaiGeodata.provinces.each do |prov|
+  puts "#{prov["provinceCode"]}: #{prov["provinceNameTh"]} (#{prov["provinceNameEn"]})"
+end
+# => 10: กรุงเทพมหานคร (Bangkok)
+#    50: เชียงใหม่ (Chiang Mai)
+#    …
+
+# Find a specific province by Thai or English name
+tg = ThaiGeodata.provinces.find { |p|
+  p["provinceNameTh"] == "เชียงใหม่" || p["provinceNameEn"].casecmp("Chiang Mai").zero?
+}
+puts tg["provinceCode"]  # => 50
+
+# Get all districts in a given province
+districts_in_cm = ThaiGeodata.districts.select { |d|
+  d["provinceCode"] == tg["provinceCode"]
+}
+puts districts_in_cm.map { |d| d["districtNameTh"] }.join(", ")
+# => เมืองเชียงใหม่, แม่ริม, สารภี, …
+
+# List all subdistricts in a given district code
+subdistricts_in_district = ThaiGeodata.subdistricts.select { |s|
+  s["districtCode"] == districts_in_cm.first["districtCode"]
+}
+puts subdistricts_in_district.map { |s| s["subdistrictNameTh"] }.join(", ")
+# => พร้าว, ท่าตอน, …
+```
+
+## API Reference
+
+* `ThaiGeodata.provinces` → Array of province hashes
+* `ThaiGeodata.districts` → Array of district hashes
+* `ThaiGeodata.subdistricts` → Array of subdistrict hashes
+
+*All methods memoize their data on first call.*
+
+## Data Source & Attribution
+
+Geographical data licensed under MIT and maintained by the [Thailand Geography JSON](https://github.com/thailand-geography-data/thailand-geography-json) project.
+
+> **License**: MIT — see [LICENSE.txt](LICENSE.txt) for full text.
+
+## Contributing
+
+1. Fork the repo
+2. Create or update JSON files under `lib/thai_geodata/data/`
+3. Write tests in `test/` and ensure `rake test` passes
+4. Submit a PR with a clear description of changes
+
+Please follow the existing code style and include tests for any new features or bugfixes.
+
+## License
+
+© 2025 Chayut Orapinpatipat
+Released under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.

data/Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+end
+
+task default: :test