zengin_lite 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1bd1615a98a69ef75d84bee347add6a97ec7c6b8379a3ec6f819562438c0a8dc
+  data.tar.gz: a08142fef0806359cde5aa72c86f8a753b67636f47d8d3308e3b3c921d4983d8
+SHA512:
+  metadata.gz: 5badad29ff71bba1bfcac693c85c5ff9f353a5fa9c32fd754014dfd8eae2d4e50d3e6ba082fe10e69116832d636039e15c94155e9f5b39773f9cf6379fdcd8e2
+  data.tar.gz: e080aee4d196a4644fcfc7100ff298f01a059143ebe8c1e1a3da0d4670bc0ec75ef33fa4d08e6e6ea9048d57d291b7cf5dfb02baa7b810d4781a96fb5e13197e

data/.yardoc/checksums

@@ -0,0 +1,5 @@
+lib/zengin_lite.rb d518a122e134675475192bccdac2427659c196e3
+lib/zengin_lite/bank.rb 99e97a39dd8bae1e33df304fcc0bba2781a96ad1
+lib/zengin_lite/branch.rb 7fb6032820dd54ce8f63a2da59270724d5a69b4e
+lib/zengin_lite/version.rb 0e597aca7d715adc1e9682612636f2a5dac0140b
+lib/zengin_lite/database.rb 1a3028a4c49d16ab410852421ea8157e0587be36

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+--readme README.md
+lib

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YOUR_NAME
+
+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,91 @@
+# ZenginLite
+
+[![Gem Version](https://badge.fury.io/rb/zengin_lite.svg)](https://badge.fury.io/rb/zengin_lite)
+[![update](https://github.com/kromiii/zengin-lite/actions/workflows/update.yml/badge.svg)](https://github.com/kromiii/zengin-lite/actions/workflows/update.yml)
+
+A lightweight implementation of [zengin-code/zengin-rb](https://github.com/zengin-code/zengin-rb).
+
+The name "zengin-lite" comes from the fact that it uses SQLite to store and query bank and branch data.
+
+Rebuilt from scratch with focus on:
+- ⚡️ Fast startup time (5-10ms)
+- 💾 Low memory footprint (1MB)
+- 🔍 Flexible query capabilities
+
+## Performance & Trade-offs
+
+This gem (`zengin-lite`) is designed as a lightweight alternative to `zengin-rb`.
+
+### When to use `zengin-lite`
+- **Web Applications / API Servers**: When you need to validate bank codes or look up branch names occasionally in user requests.
+- **Memory Constrained Environments**: Running on FaaS (AWS Lambda, etc.) or small containers where memory usage matters. `zengin-lite` keeps memory usage very low (~1MB) by querying SQLite on demand.
+
+### When to use `zengin-rb`
+- **Batch Processing / Heavy Loops**: If you need to iterate over thousands of banks/branches or perform bulk data processing.
+- **Maximum Performance**: `zengin-rb` loads all data into memory (Hash), offering microsecond-level access speed at the cost of higher memory usage (20MB+).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'zengin_lite'
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install zengin_lite
+```
+
+## Usage
+
+```ruby
+require 'zengin_lite'
+
+# Find bank and branch
+bank = ZenginLite.bank("0001") # => #<ZenginLite::Bank code="0001" name="みずほ銀行" ...>
+branch = bank.branch("001")    # => #<ZenginLite::Branch code="001" name="東京営業部" ...>
+
+# Search banks
+banks = ZenginLite.search_banks(name: "三井")
+
+# Check existence (returns nil if not found)
+ZenginLite.bank("9999") # => nil
+```
+
+For more detailed API documentation, please refer to the [YARD documentation](https://rubydoc.info/gems/zengin_lite).
+
+## Data Source
+
+This gem uses data from [zengin-code/source-data](https://github.com/zengin-code/source-data), which is automatically updated daily.
+
+## Development
+
+```bash
+# Clone with submodule
+$ git clone --recursive https://github.com/kromiii/zengin-lite.git
+$ cd zengin-lite
+$ bundle install
+
+# Update source data and build database
+$ git submodule update --remote
+$ bundle exec rake db:build
+
+# Run tests
+$ bundle exec rake test
+
+# Verify database integrity
+$ bundle exec rake db:verify
+
+# Build and install locally (database will be built automatically)
+$ bundle exec rake install
+
+# Generate documentation
+$ bundle exec yard doc
+$ open doc/index.html
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,24 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test
+
+namespace :db do
+  desc "Build the database from source data"
+  task :build do
+    ruby "scripts/build_database.rb"
+  end
+
+  desc "Verify the database integrity"
+  task :verify do
+    ruby "scripts/verify_database.rb"
+  end
+end
+
+task :build => 'db:build'