lex-ping 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b0c831b1d15b421a088df12e80f893180a202dfff0e85a6b82ee5b6bb04dd72
-  data.tar.gz: dae5536d6035f67546136f12ffe1fc52d602bdffc8dd5eeba120fec2313c4cd7
+  metadata.gz: 919c373bd0e4a35df800efe6ee488cb30a7716290fec08f97ac0aee4ca0600ba
+  data.tar.gz: f4e885135ab9b397bcb7c464a6025e02bc41600c03ca3e3900c8d445fb969b7a
 SHA512:
-  metadata.gz: b8563c57fc36b9e1bd0d6c7de821b197b816f826fd8464899a467844dc120c6fc96036b981ad6ee99a40ee2b8a961aeb08fd33686809ba489278f20d4a0cff88
-  data.tar.gz: 8cf8d948c812075b068479e25737a0d43999831f2dea87a018d6d62fe8c1049d96bb27076f88173ed91d4bd4ae1939669d768402ee9e8ce8e5c215c14014d909
+  metadata.gz: 8ccf6f0cc38e6ca7f97822c2eee478434160c92eb4a7921bc451082a8762226f9bd7799328d2e5f6419e03c9b6b782dc4f43f68a31015ed323d23dbdc2a1f24a
+  data.tar.gz: c24bd985ac397148852492135c689ae0e14828faf9247649c62570e452e31e2bbf3a8fb242dfe20c229bf999ddb87c83153e4fa17ac9d5d0254bfd801f89a04d

data/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  ci:
+    uses: LegionIO/.github/.github/workflows/ci.yml@main
+
+  release:
+    needs: ci
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    uses: LegionIO/.github/.github/workflows/release.yml@main
+    secrets:
+      rubygems-api-key: ${{ secrets.RUBYGEMS_API_KEY }}

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,51 @@
+AllCops:
+  TargetRubyVersion: 3.4
+  NewCops: enable
+  SuggestExtensions: false
+
+Layout/LineLength:
+  Max: 160
+
+Layout/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: space
+
+Layout/HashAlignment:
+  EnforcedHashRocketStyle: table
+  EnforcedColonStyle: table
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 1500
+
+Metrics/ModuleLength:
+  Max: 1500
+
+Metrics/BlockLength:
+  Max: 40
+
+Metrics/AbcSize:
+  Max: 60
+
+Metrics/CyclomaticComplexity:
+  Max: 15
+
+Metrics/PerceivedComplexity:
+  Max: 17
+
+Style/Documentation:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: true
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Naming/FileName:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [0.1.2] - 2026-03-22
+
+### Changed
+- Migrated gemspec to real sub-gem runtime dependencies: legion-cache >= 1.3.11, legion-crypt >= 1.4.9, legion-data >= 1.4.17, legion-json >= 1.2.1, legion-logging >= 1.3.2, legion-settings >= 1.3.14, legion-transport >= 1.3.9 (replaces multi_json)
+- Updated spec_helper to require real sub-gem helpers and define Helpers::Lex with full helper includes
+- Removed redundant inline Helpers::Lex stubs from individual runner specs
+- Added Actors::Every and Actors::Subscription stubs for test isolation
+
+## [0.1.1] - 2026-03-18
+
+### Fixed
+- HTTP runner now uses `Net::Ping::HTTP` instead of `Net::Ping::UDP` for proper HTTP reachability checks
+- HTTP runner auto-prepends `http://` scheme when bare hostname is provided
+
+### Added
+- Runner specs for HTTP (6 examples), TCP (3 examples), UDP (3 examples) with stubbed `net-ping` classes
+
+## [0.1.0] - 2026-03-13
+
+### Added
+- Initial release

data/CLAUDE.md

@@ -0,0 +1,62 @@
+# lex-ping: Network Ping Extension for LegionIO
+
+**Repository Level 3 Documentation**
+- **Parent**: `/Users/miverso2/rubymine/legion/extensions-core/CLAUDE.md`
+- **Grandparent**: `/Users/miverso2/rubymine/legion/CLAUDE.md`
+
+## Purpose
+
+Legion Extension that performs network connectivity checks. Provides runners for HTTP, TCP, and UDP ping operations to verify host reachability. No explicit actors - the framework auto-generates subscription actors for each runner.
+
+**GitHub**: https://github.com/LegionIO/lex-ping
+**License**: MIT
+**Version**: 0.1.1
+
+## Architecture
+
+```
+Legion::Extensions::Ping
+└── Runners/
+    ├── Http               # HTTP ping via Net::Ping::HTTP (auto-prepends http:// scheme)
+    ├── Tcp                # TCP ping via Net::Ping::TCP
+    └── Udp                # UDP ping via Net::Ping::UDP
+```
+
+No explicit actors directory - the framework auto-generates subscription actors for each runner.
+
+## Runner Interface
+
+All three runners expose a single `ping(host:, **)` method and return:
+```ruby
+{ host: host, result: result_object, success: true/false }
+```
+
+The HTTP runner auto-prepends `http://` to bare hostnames and uses `Net::Ping::HTTP` for proper HTTP reachability checks.
+
+## Key Files
+
+| Path | Purpose |
+|------|---------|
+| `lib/legion/extensions/ping.rb` | Entry point, extension registration |
+| `lib/legion/extensions/ping/runners/http.rb` | HTTP ping runner |
+| `lib/legion/extensions/ping/runners/tcp.rb` | TCP ping runner |
+| `lib/legion/extensions/ping/runners/udp.rb` | UDP ping runner |
+
+## Dependencies
+
+| Gem | Purpose |
+|-----|---------|
+| `net-ping` | Network ping library (TCP, UDP) |
+| `multi_json` | JSON parser abstraction |
+
+## Testing
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop
+```
+
+---
+
+**Maintained By**: Matthew Iverson (@Esity)

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Esity
+
+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,35 @@
+# lex-ping
+
+Network connectivity checks for [LegionIO](https://github.com/LegionIO/LegionIO). Verify host reachability via HTTP, TCP, and UDP pings.
+
+## Installation
+
+```bash
+gem install lex-ping
+```
+
+## Functions
+
+- **Http** - Checks reachability via `Net::Ping::HTTP` (auto-prepends `http://` to bare hostnames)
+- **Tcp** - TCP ping (checks port connectivity via `Net::Ping::TCP`)
+- **Udp** - UDP ping (checks UDP reachability via `Net::Ping::UDP`)
+
+All runners accept `host:` and return `{ host:, result:, success: true/false }`.
+
+## Usage
+
+```ruby
+Legion::Ingress.run('lex_ping.http.ping', host: 'myservice.internal')
+Legion::Ingress.run('lex_ping.tcp.ping', host: 'myservice.internal')
+Legion::Ingress.run('lex_ping.udp.ping', host: 'myservice.internal')
+```
+
+## Requirements
+
+- Ruby >= 3.4
+- [LegionIO](https://github.com/LegionIO/LegionIO) framework
+- `net-ping`
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lex-ping.gemspec

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require_relative 'lib/legion/extensions/ping/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'lex-ping'
+  spec.version       = Legion::Extensions::Ping::VERSION
+  spec.authors       = ['Esity']
+  spec.email         = ['matthewdiverson@gmail.com']
+
+  spec.summary       = 'LEX::Ping'
+  spec.description   = 'Network connectivity checks for LegionIO via HTTP, TCP, and UDP'
+  spec.homepage      = 'https://github.com/LegionIO/lex-ping'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.4'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/LegionIO/lex-ping'
+  spec.metadata['documentation_uri'] = 'https://github.com/LegionIO/lex-ping'
+  spec.metadata['changelog_uri'] = 'https://github.com/LegionIO/lex-ping'
+  spec.metadata['bug_tracker_uri'] = 'https://github.com/LegionIO/lex-ping/issues'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'legion-cache',     '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',     '>= 1.4.9'
+  spec.add_dependency 'legion-data',      '>= 1.4.17'
+  spec.add_dependency 'legion-json',      '>= 1.2.1'
+  spec.add_dependency 'legion-logging',   '>= 1.3.2'
+  spec.add_dependency 'legion-settings',  '>= 1.3.14'
+  spec.add_dependency 'legion-transport', '>= 1.3.9'
+  spec.add_dependency 'net-ping'
+
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rspec'
+  spec.add_development_dependency 'simplecov'
+end

data/lib/legion/extensions/ping/runners/http.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Ping
+      module Runners
+        module Http
+          def ping(host:, **)
+            url = host.start_with?('http://', 'https://') ? host : "http://#{host}"
+            result = Net::Ping::HTTP.new(url)
+            { host: host, result: result, success: result.ping? }
+          end
+
+          include Legion::Extensions::Helpers::Lex
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/ping/runners/tcp.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Ping
+      module Runners
+        module Tcp
+          def ping(host:, **)
+            result = Net::Ping::TCP.new(host)
+            { host: host, result: result, success: result.ping? }
+          end
+
+          include Legion::Extensions::Helpers::Lex
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/ping/runners/udp.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Ping
+      module Runners
+        module Udp
+          def ping(host:, **)
+            result = Net::Ping::UDP.new(host)
+            { host: host, result: result, success: result.ping? }
+          end
+
+          include Legion::Extensions::Helpers::Lex
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/ping/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Legion
+  module Extensions
+    module Ping
+      VERSION = '0.1.2'
+    end
+  end
+end

data/lib/legion/extensions/ping.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/ping/version'
+
+module Legion
+  module Extensions
+    module Ping
+      class Error < StandardError; end
+      # Your code goes here...
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-ping
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Esity
@@ -10,13 +10,111 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+- !ruby/object:Gem::Dependency
+  name: net-ping
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -24,7 +122,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -38,7 +136,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -52,7 +150,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -66,13 +164,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: multi_json
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -80,13 +178,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: net-ping
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -99,7 +197,23 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- ".github/workflows/ci.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lex-ping.gemspec
+- lib/legion/extensions/ping.rb
+- lib/legion/extensions/ping/runners/http.rb
+- lib/legion/extensions/ping/runners/tcp.rb
+- lib/legion/extensions/ping/runners/udp.rb
+- lib/legion/extensions/ping/version.rb
 homepage: https://github.com/LegionIO/lex-ping
 licenses:
 - MIT