network-infra-utility 0.2.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e8a2b1b8402f7fdb0ba39e7a6d01b384d624e6906530a27c575ae6371bedabfd
-  data.tar.gz: 7f0cb17756a53dcc31386fa5aebc786ba3640ca0cd86443c539237c41239d0b8
+  metadata.gz: 52f005e254e4a41adb347cddd9ce08ab179fd7999e5f79db2de0171ba34a4284
+  data.tar.gz: d2cb8a65fec8e793de56c340305c7a545a6e5dd4e080128a2b1683bf2b606e3f
 SHA512:
-  metadata.gz: 75901331bb496d6bbd54935256bf01990ddd2221b97415a9210a1133ba03516abbb6ebc4d4550197e17ebeee9593dc0920f90b146fd0ae7f546836bd9a92f4e0
-  data.tar.gz: 66e83826b05f0029b781c93d03daf2f7faaf01058d1a404f34bf25a1bf2a68064c43ac95912148e1a9793d7ff05fd3fe80def8265d18f2aa71ceb69f9bc602ce
+  metadata.gz: 54793aea84005bb72d73e5e7806148ecda0ca2bf3ad01e710252936a81922e6b129fedaaf5259e6233380af3eb18d6948b87a80ef5c9c1a077d821f364784b5a
+  data.tar.gz: dea8ac4214edf3f206f92e9586219b70363d10d4fb63d5c72dddbd223c933e38c6167cd015c02f69aefedb0a1db2ef7fdaa29fa28d2e6d7a559e57720cd8c8f1

data/.gitignore

@@ -55,3 +55,24 @@ build-iPhoneSimulator/
 
 # Used by RuboCop. Remote config files pulled in from inherit_from directive.
 # .rubocop-https?--*
+
+## Erlang/OTP build artifacts:
+*.beam
+*.appup
+erl_crash.dump
+/ebin/
+/.eunit/
+
+## rebar3 build:
+.rebar3/
+/_build/
+**/_build/
+/rebar3.crashdump
+
+## erlang.mk build:
+.erlang.mk/
+/deps/
+/_rel/
+
+## Rust / Cargo build artifacts:
+target/

data/CHANGELOG.md

@@ -8,12 +8,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-07-26
+
+### Added
+
+- 新增 `geo-load` 命令行工具：GeoLite2 CSV → JSON 转换，支持 `geo-load [RAW_DIR] [DOC_DIR]` 双位置参数，RAW_DIR 省略时在当前目录自动查找，DOC_DIR 省略时默认 `./geodb/`，不存在的输出目录自动创建。支持 `--asn-only` / `--city-only` / `--country-only` 单选转换。
+- 新增 `geo-get` 命令行工具：向运行中的 geo-api 服务查询单个 IP 归属信息，一次输入三接口齐查，支持 `--text` / `--json` 两种输出格式与 `--country` / `--city` / `--asn` 单接口选择。
+- `geo-load` / `geo-get` 加入 gemspec executables，`gem install` 后自动进入 PATH。
+- 新增 example 文档：`ip_usage.md`（IP 模块代码级用法）、`geo_commands_usage.md`（Geo 三命令的命令行用法与代码级用法）。
+
+## [0.2.0] - 2026-07-25
+
+### Added
+
+- 新增 `IPv4` / `IPv6` / `IPv4Mask` / `IPv6Mask` 地址解析模块，提供地址分类、掩码运算、CIDR 展开、子网划分、区间相交判断等能力。
+- 新增 `IP` 统一入口模块，提供 `v4` / `v6` / `range` / `cross` / `xross` 五个方法，按地址串自动分派 IPv4 / IPv6。
+- 从原版 `network` gem（`utility/ipv4_address.rb` / `ipv6_address.rb`）迁移并重新编码。
+
+### Changed
+
+- ⚠️ **部分 IP 转换含义发生变化**，与原版 `network` gem（`utility/ipv4_address.rb` / `ipv6_address.rb`）不兼容，升级时需注意：
+  - `+` / `-` 算术运算从**破坏性**（原版直接修改 `@number` 并 `generate` 覆写自身）改为**非破坏性**（返回新对象，原对象不变）。
+  - `&` 按位与的返回值从原版的 `IP.v4(...)` / `IP.v6(...)`（依赖 `module IP` 上下文）改为直接 `IPv4.new` / `IPv6.new`，不再隐式依赖 `IP` 模块。
+  - `range_with` 原版返回 `[网络地址+1, 广播地址]`（排除了网络地址），新版改为 `[网络地址, 广播地址]`（含两端完整的网段区间）。
+  - `delegation` 的子网生成从原版的 `clone` + 破坏性 `+` 改为非破坏性 `base + offset`，返回的结果是独立对象。
+  - 方法命名规范化：原版的 `is_class_a?` / `is_mask?` / `is_private?` 等 `is_` 前缀方法保留为别名，新增无前缀的 `class_a?` / `mask?` / `private?` 等作为主方法名。
+  - `is_another?` 重命名为 `special?`（保留 `is_another?` 别名）。
+  - `IPv6` 非法地址从 `raise` + 返回 `nil` 的混合行为统一为抛出异常并附带 IPAddr 错误信息。
+- `generate` 中的 `formmat` → `format_parts`、`check` / `checks` → `valid?`，内部方法名规范化，外部接口不变。
+
+## [0.1.0] - 2026-07-24
+
 ### Added
 
 - 初始化 gem 骨架，按 document / service / support / tool 四层 require_paths 组织代码。
 - 配置 RSpec 原子能力测试（`spec/`）与功能用例（`example/`）双套结构。
 - 提供标准 gem 文件：gemspec / Gemfile / Rakefile / .rspec / bin/console / bin/setup 等。
-
-## [0.1.0] - Unreleased
-
-- 项目初始化。

data/Gemfile

@@ -2,5 +2,7 @@ source "https://rubygems.org"
 
 gemspec
 
+gem "base64", "~> 0.2"
+gem "thor", "~> 1.3"
 gem "rake", "~> 13.0", group: :development
 gem "rspec", "~> 3.0", group: :development

data/Gemfile.lock

@@ -0,0 +1,70 @@
+PATH
+  remote: .
+  specs:
+    network-infra-utility (0.4.0)
+      json (~> 2.6)
+      puma (~> 6.0)
+      rackup (~> 2.0)
+      roda (~> 3.0)
+      thor (~> 1.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    base64 (0.3.0)
+    diff-lcs (1.6.2)
+    json (2.20.0)
+    nio4r (2.7.5)
+    puma (6.6.1)
+      nio4r (~> 2.0)
+    rack (3.2.6)
+    rackup (2.3.1)
+      rack (>= 3)
+    rake (13.3.1)
+    roda (3.105.0)
+      rack
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    thor (1.5.0)
+
+PLATFORMS
+  x64-mingw-ucrt
+
+DEPENDENCIES
+  base64 (~> 0.2)
+  network-infra-utility!
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  thor (~> 1.3)
+
+CHECKSUMS
+  base64 (0.3.0)
+  diff-lcs (1.6.2)
+  json (2.20.0)
+  network-infra-utility (0.4.0)
+  nio4r (2.7.5)
+  puma (6.6.1)
+  rack (3.2.6)
+  rackup (2.3.1)
+  rake (13.3.1)
+  roda (3.105.0)
+  rspec (3.13.2)
+  rspec-core (3.13.6)
+  rspec-expectations (3.13.5)
+  rspec-mocks (3.13.8)
+  rspec-support (3.13.7)
+  thor (1.5.0)
+
+BUNDLED WITH
+  4.0.10

data/Rakefile

@@ -8,7 +8,7 @@ RSpec::Core::RakeTask.new(:spec)
 
 # 功能场景用例
 RSpec::Core::RakeTask.new(:example) do |t|
-  t.pattern = "example/**/*_spec.rb"
+  t.pattern = "example/**/*_example.rb"
 end
 
 task default: %i[spec example]