mesa_test 1.1.12 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6197ab41eec170d06d29d19e2e66446c71a673434a316a100bd102e44a849d7d
-  data.tar.gz: f307cc7d5948121879fd4565ac90fbcf57b6e796ab47fdce4bca7c6f79b9092a
+  metadata.gz: 77716549c3af3f8960f9d630145619aed3fcc1a35b66f8303d0f5561fe70306a
+  data.tar.gz: 3a52ee9cbc1f853469979ffaff62ff2e72ef9422a9edc643a13f387747d414da
 SHA512:
-  metadata.gz: 856b3b1f1bc52c56aae8ca59916f0526306ebff35657b68b26ddcd96313b1f2b0ed051aa9b55c7c8d0378d01b7f433be89fcc035bb61d14cf7dc67fa95616be1
-  data.tar.gz: a9f230dd702be29a371b0442d8cdc6dc81a2774ddfae9105b7250b401881ca06b2db721728143b112d2e057027b456206d187e7298de0aef31bc5ba25d29a791
+  metadata.gz: a1db1bf6457b33ea8e0ce55f4cd6c6fafe3ece040925176748bd49541cdb6ba0540c3c7a6354743685df210a82be0f9acbcd1a9ad692d0be88a012746971eb8c
+  data.tar.gz: 264f3d0dd767b4bc610cbbd2d736bd387840e675de87a52ef5748453a5c0ffef8a7f90f6a2f0f14019fdb974cee54e9c1ad4c86227c04de5d9e0553f29f5d2a2

data/bin/mesa_test

@@ -328,8 +328,68 @@ class MesaTest < Thor
                                       force_setup: true)
   end
 
+  desc 'search "QUERY"', 'retrieve JSON test instances matching QUERY'
+  long_desc <<-LONGDESC
+  Sends a GET request to the MesaTestHub search API. QUERY should be
+  quoted. Credentials are read from your mesa_test config file and sent as
+  URL query parameters (HTTPS is mandatory).
+
+  Query syntax is the same key-value form used by the in-browser search box
+  at testhub.mesastar.org/test_instances/search (see the "Query syntax"
+  panel on that page). Example:
+
+    mesa_test search "computer: Hercules; passed: false"
+
+  The raw JSON response body is written to STDOUT, suitable for piping to
+  jq or redirecting to a file. If the server reports any rejected query
+  clauses in a `failures` array, those are also echoed to STDERR so they
+  aren't silently dropped from downstream pipelines. On a non-success HTTP
+  status, an error is written to STDERR and the command exits non-zero.
+  LONGDESC
+
+  def search(query)
+    s = create_submitter(force: true)
+    emit_search_response(s.search(query))
+  end
+
+  desc 'count "QUERY"', 'count test instances matching QUERY'
+  long_desc <<-LONGDESC
+  Like `search`, but hits the count endpoint. The response is a small JSON
+  object containing the result-set size (and any `failures`). Use this
+  before `search` when you don't know how large a result set will be.
+  LONGDESC
+
+  def count(query)
+    s = create_submitter(force: true)
+    emit_search_response(s.search_count(query))
+  end
+
   private
 
+  def emit_search_response(response)
+    if response.is_a?(Net::HTTPSuccess)
+      puts response.body
+      warn_search_failures(response.body)
+    else
+      $stderr.puts "Search request failed: HTTP #{response.code} "\
+                   "#{response.message}"
+      $stderr.puts response.body unless response.body.nil? || response.body.empty?
+      exit 1
+    end
+  end
+
+  def warn_search_failures(body)
+    parsed = JSON.parse(body)
+    failures = parsed['failures']
+    return unless failures.is_a?(Array) && !failures.empty?
+
+    $stderr.puts 'Warning: the following query clauses were rejected by '\
+                 'the server and ignored:'
+    failures.each { |f| $stderr.puts "  - #{f}" }
+  rescue JSON::ParserError
+    # Body wasn't JSON; nothing to surface.
+  end
+
   def work_dir(given, default)
     if given
       File.expand_path('', given)

data/lib/mesa_test.rb

@@ -18,7 +18,6 @@ GITHUB_HTTPS = 'https://github.com/MESAHub/mesa.git'.freeze
 GITHUB_SSH = 'git@github.com:MESAHub/mesa.git'.freeze
 
 class MesaTestSubmitter
-  # DEFAULT_URI = 'https://mesa-test-hub.herokuapp.com'.freeze
   DEFAULT_URI = 'https://testhub.mesastar.org'.freeze
 
   # set up config file for computer
@@ -52,8 +51,9 @@ e-mail and password will be stored in plain text.'
 
       # Get API key for submitting failure logs
       response = shell.ask 'What is the logs submission API token associated '\
-        "with the email #{s.email} (required; contact Philip Mocz if you "\
-        "need a key)? (#{s.logs_token})", :blue
+        "with the email #{s.email} (required; if you don't have one, ask a "\
+        "MESA testing maintainer or a representative from Flatiron for a "\
+        "key)? (#{s.logs_token})", :blue
       s.logs_token = response unless response.empty?
 
       # Determine if we'll use ssh or https to access github
@@ -515,6 +515,40 @@ e-mail and password will be stored in plain text.'
     end
   end
 
+  # GET a search query from the testhub. Credentials and the query string
+  # ride in the URL's query parameters (per the testhub search API contract;
+  # the controller also accepts session auth, but a CLI sends them in-band).
+  # Returns the raw Net::HTTP response.
+  def search(query_text)
+    get_search('/test_instances/search.json', query_text)
+  end
+
+  # Like #search, but hits the count endpoint. Useful for sizing a result set
+  # before pulling the full payload.
+  def search_count(query_text)
+    get_search('/test_instances/search_count.json', query_text)
+  end
+
+  private
+
+  def get_search(path, query_text)
+    uri = URI.parse(base_uri + path)
+    uri.query = URI.encode_www_form(
+      email: email,
+      password: password,
+      query_text: query_text
+    )
+
+    https = Net::HTTP.new(uri.hostname, uri.port)
+    https.use_ssl = base_uri.include? 'https'
+
+    request = Net::HTTP::Get.new(
+      uri,
+      initheader = { 'Accept' => 'application/json' }
+    )
+
+    https.request(request)
+  end
 end
 
 class Mesa

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mesa_test
 version: !ruby/object:Gem::Version
-  version: 1.1.12
+  version: 1.2.0
 platform: ruby
 authors:
 - William Wolf
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-20 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json