gretl 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 125347cb9702505790be6258d05cc6423ee35ea7eefab6d45f40a7bcba533605
+  data.tar.gz: c785a560021af5505094db888107c20e5f5a8f5fffd77629f2a3aa6f73777cb6
+SHA512:
+  metadata.gz: ba05270b3e2d771e10db4e164860f8a4d223263b1db275957e2a2720c55d53d53b03871dd747dd8e98b33611d92c40e8410bac636d685c959ed5a3733b194cd2
+  data.tar.gz: 30f4c52dfa7bef423a9716ff815d6a7dba57d4b8c7c2fccfd6eb3deb6b6c32b88ad074908ffc8b62b27af1dbc2180751244d4bcf0c465dd063512bb09d14e42e

data/lib/gretl.rb

@@ -0,0 +1,122 @@
+require "net/http"
+require "json"
+require "uri"
+
+module Gretl
+  BASE = "http://127.0.0.1:27892"
+
+  PortInfo = Struct.new(
+    :port, :name, :active, :pid, :process,
+    :has_command, :group, :is_docker, :links,
+    keyword_init: true
+  ) do
+    def running? = active
+    def stopped? = !active
+    def to_s = "#<PortInfo #{name.inspect} :#{port} #{active ? "running" : "stopped"}>"
+  end
+
+  module_function
+
+  def _request(method, path)
+    uri = URI("#{BASE}#{path}")
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.open_timeout = 5
+    http.read_timeout = 5
+    req = case method
+          when :get    then Net::HTTP::Get.new(uri)
+          when :post   then Net::HTTP::Post.new(uri)
+          when :delete then Net::HTTP::Delete.new(uri)
+          end
+    res = http.request(req)
+    JSON.parse(res.body, symbolize_names: true)
+  rescue Errno::ECONNREFUSED
+    raise "Cannot connect to Gretl. Make sure the app is running."
+  end
+
+  def _fetch_ports
+    _request(:get, "/ports").map { |d| PortInfo.new(**d.slice(*PortInfo.members)) }
+  end
+
+  def _resolve(query)
+    all = _fetch_ports
+    if query.match?(/\A\d+\z/)
+      exact = all.select { |p| p.port == query.to_i }
+      return exact unless exact.empty?
+    end
+    q = query.downcase
+    all.select { |p| p.name.downcase.include?(q) }
+  end
+
+  class Client
+    def ports = Gretl._fetch_ports
+    def port(query) = Gretl._resolve(query)
+    def active = _fetch_ports.select(&:active)
+    def inactive = _fetch_ports.reject(&:active)
+
+    def start(query)
+      matches = Gretl._resolve(query)
+      raise ArgumentError, "No port found matching #{query.inspect}" if matches.empty?
+      matches.each do |p|
+        Gretl._request(:post, "/ports/#{p.port}/start") if !p.active && p.has_command
+      end
+      matches
+    end
+
+    def stop(query)
+      matches = Gretl._resolve(query)
+      raise ArgumentError, "No port found matching #{query.inspect}" if matches.empty?
+      matches.each do |p|
+        Gretl._request(:post, "/ports/#{p.port}/stop") if p.active
+      end
+      matches
+    end
+
+    def start_group(group)
+      matches = Gretl._fetch_ports.select { |p| p.group&.downcase == group.downcase }
+      raise ArgumentError, "No ports found in group #{group.inspect}" if matches.empty?
+      matches.each { |p| Gretl._request(:post, "/ports/#{p.port}/start") if !p.active && p.has_command }
+      matches
+    end
+
+    def stop_group(group)
+      matches = Gretl._fetch_ports.select { |p| p.group&.downcase == group.downcase }
+      raise ArgumentError, "No ports found in group #{group.inspect}" if matches.empty?
+      matches.each { |p| Gretl._request(:post, "/ports/#{p.port}/stop") if p.active }
+      matches
+    end
+
+    def status_group(group)
+      matches = Gretl._fetch_ports.select { |p| p.group&.downcase == group.downcase }
+      raise ArgumentError, "No ports found in group #{group.inspect}" if matches.empty?
+      matches
+    end
+
+    def remove(query)
+      matches = Gretl._resolve(query)
+      raise ArgumentError, "No port found matching #{query.inspect}" if matches.empty?
+      matches.each { |p| Gretl._request(:delete, "/ports/#{p.port}") }
+      matches
+    end
+
+    def wait_for_active(query, timeout: 30, interval: 0.5)
+      deadline = Time.now + timeout
+      while Time.now < deadline
+        Gretl._resolve(query).each { |p| return p if p.active }
+        sleep interval
+      end
+      raise "Port matching #{query.inspect} did not become active within #{timeout}s"
+    end
+
+    def wait_for_inactive(query, timeout: 30, interval: 0.5)
+      deadline = Time.now + timeout
+      while Time.now < deadline
+        Gretl._resolve(query).each { |p| return p if p.stopped? }
+        sleep interval
+      end
+      raise "Port matching #{query.inspect} did not become inactive within #{timeout}s"
+    end
+  end
+
+  # Default client
+  PA = Client.new
+end

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: gretl
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- SlowDutch
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-04 00:00:00.000000000 Z
+dependencies: []
+description:
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/gretl.rb
+homepage: https://github.com/slowdutch/Gretl
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.1
+signing_key:
+specification_version: 4
+summary: Ruby SDK for Gretl — control local services by name or port number
+test_files: []