salad 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 42dc06590c443b26abb03fc922c20cd33bd4e98b8e6c1f1ea712f2f28c2876bd
+  data.tar.gz: 3e052ddf1ef6c281b21526b87889dfac0800102866c88658c58a8853ef9007bd
+SHA512:
+  metadata.gz: 684e41e46f78e3989541df37d955a48b3f03fd2f0e55792b3169dd913b89483d08a82f74994562debf015e9e5c41fe4ab5b4a2a83d8156a174e6a7751318e405
+  data.tar.gz: c224a4919a4ea9a8b8507708efee64ea4917726a85c1632e0ea446dc9f343ce075f8f4ea396d8e1e767148b4fc840af3fa5bd0eba833907594b9575813462752

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.0.1] - 2026-06-04
+
+- Initial release

data/LICENSE.txt

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright © 2026 Species File Group
+
+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,123 @@
+# Salad
+
+<img width="200" height="200" alt="TaxonWorks Labs" src="https://github.com/user-attachments/assets/aed6a9d3-e737-4954-861c-99dfc3f89040" />
+
+TaxonWorks Labs Product
+
+`salad` is a meta-gem that bundles the [SpeciesFileGroup](https://github.com/SpeciesFileGroup) Ruby API wrappers into a single package and ships a `salad` executable that drops you into a [Pry](https://github.com/pry/pry) console with every service pre-loaded. It's a one-stop REPL for exploring biodiversity informatics APIs without bouncing between repos or firing up the full TaxonWorks Rails app.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'salad'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install salad
+
+## Usage
+
+Launch the console from your terminal:
+
+```
+$ salad
+salad v0.0.1 — type `help` to list services, `hints` for tips.
+salad>
+```
+
+List every bundled service and the two ways to access it:
+
+```
+help Salad
+```
+
+```
+=== Salad Services ===
+Access bundled biodiversity informatics API wrappers by service name or gem name:
+  Salad.bels               Salad.bell_pepper   ->  BellPepper
+  Salad.bhlnames           Salad.bok_choy      ->  BokChoy
+  Salad.bionomia           Salad.bananomia     ->  Bananomia
+  Salad.catalogue_of_life  Salad.colrapi       ->  Colrapi
+  Salad.checklistbank      Salad.colrapi       ->  Colrapi
+  Salad.clb                Salad.colrapi       ->  Colrapi
+  Salad.col                Salad.colrapi       ->  Colrapi
+  Salad.gnverifier         Salad.checkerberry  ->  Checkerberry
+  Salad.inaturalist        Salad.nasturtium    ->  Nasturtium
+  Salad.openalex           Salad.syconium      ->  Syconium
+  Salad.owl                Salad.hookkaido     ->  Hookkaido
+  Salad.plazi              Salad.plazucchini   ->  Plazucchini
+  Salad.wikidata           Salad.wikimelon     ->  Wikimelon
+  Salad.worms              Salad.crawlyflower  ->  Crawlyflower
+```
+
+Each wrapper is also available under its own top-level constant, so anything you'd do in an individual gem's console works here too:
+
+```ruby
+Crawlyflower.record(127160)
+Nasturtium::Observation.find(42)
+BellPepper.georeference("University of Illinois, Urbana, IL")
+```
+
+### Accessing services
+
+Three equivalent styles are supported — pick whichever you find most readable:
+
+```ruby
+Salad.inaturalist     # service name
+Salad.nasturtium      # gem name (keeps the produce pun alive)
+Nasturtium            # raw top-level constant
+```
+
+All three return the same module.
+
+### Using `salad` as a library
+
+You can also `require 'salad'` from your own code to load all wrappers at once:
+
+```ruby
+require 'salad'
+
+Salad.worms.record(127160)
+Salad.openalex.works(filter: { "authorships.author.id" => "A5023888391" })
+```
+
+## Included gems
+
+| Service              | Gem                                                                          | API                                                                                          |
+| -------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
+| `Salad.bels`         | [`bell_pepper`](https://github.com/SpeciesFileGroup/bell_pepper)             | [BELS Georeference](https://bels.geo-vocab.org/)                                             |
+| `Salad.bhlnames`     | [`bok_choy`](https://github.com/SpeciesFileGroup/bok_choy)                   | [BHLnames](https://bhlnames.globalnames.org/)                                                |
+| `Salad.bionomia`     | [`bananomia`](https://github.com/SpeciesFileGroup/bananomia)                 | [Bionomia](https://bionomia.net/)                                                            |
+| `Salad.col`          | [`colrapi`](https://github.com/SpeciesFileGroup/colrapi)                     | [Catalogue of Life / ChecklistBank](https://www.checklistbank.org/)                          |
+| `Salad.gnverifier`   | [`checkerberry`](https://github.com/SpeciesFileGroup/checkerberry)           | [GNverifier](https://verifier.globalnames.org/)                                              |
+| `Salad.inaturalist`  | [`nasturtium`](https://github.com/SpeciesFileGroup/nasturtium)               | [iNaturalist](https://www.inaturalist.org/)                                                  |
+| `Salad.openalex`     | [`syconium`](https://github.com/SpeciesFileGroup/syconium)                   | [OpenAlex](https://openalex.org/)                                                            |
+| `Salad.owl`          | [`hookkaido`](https://github.com/SpeciesFileGroup/hookkaido)                 | [Ontology Lookup Service (OLS)](https://www.ebi.ac.uk/ols4/)                                 |
+| `Salad.plazi`        | [`plazucchini`](https://github.com/SpeciesFileGroup/plazucchini)             | [Plazi TreatmentBank](https://www.plazi.org/)                                                |
+| `Salad.wikidata`     | [`wikimelon`](https://github.com/SpeciesFileGroup/wikimelon)                 | [Wikidata](https://www.wikidata.org/)                                                        |
+| `Salad.worms`        | [`crawlyflower`](https://github.com/SpeciesFileGroup/crawlyflower)           | [WoRMS](https://www.marinespecies.org/rest/)                                                 |
+
+Because `salad` installs each wrapper as a normal runtime dependency, you can freely mix it into a project that already depends on individual wrappers — Bundler will resolve them to compatible versions.
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Run `bin/console` for an interactive prompt that will allow you to experiment (this is the same console shipped by the `salad` executable, but it uses your local working copy of the gem).
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `lib/salad/version.rb`, update the CHANGELOG.md, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.
+
+## License
+
+The gem is available as open source under the terms of the [MIT license](https://github.com/SpeciesFileGroup/salad/blob/main/LICENSE.txt). You can learn more about the MIT license on [Wikipedia](https://en.wikipedia.org/wiki/MIT_License) and compare it with other open source licenses at the [Open Source Initiative](https://opensource.org/license/mit/).
+
+Third-party licensing and attribution details for vendored code are listed in [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+## Code of Conduct
+
+Everyone interacting in the Salad project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/SpeciesFileGroup/salad/blob/main/CODE_OF_CONDUCT.md).

data/exe/salad

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'salad/console'
+Salad.console

data/lib/salad/bond_completer.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# Vendored from pry-bond 0.0.1 (https://github.com/pry/pry-bond), modified for
+# compatibility with current Pry. Only the Pry <-> Bond completer shim is kept;
+# pry-bond's enable-bond!/disable-bond! commands are dropped (Salad always uses
+# Bond) and the readline integration is replaced with a no-op shim because Pry
+# drives Readline itself.
+#
+# Original copyright notice from pry-bond/LICENSE.txt:
+# ---------------------------------------------------------------------------
+# (The MIT License)
+#
+# Copyright (c) 2014 The Pry Team
+#
+# 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.
+# ---------------------------------------------------------------------------
+
+# Loaded before 'pry' so that Pry's `require 'readline'` resolves to
+# rb-readline's pure-Ruby Readline rather than Reline. Reline's tab-completion
+# display differs (e.g. TAB-TAB on an empty prefix doesn't list candidates),
+# which would break Salad's param completion at `Salad.x.method(<TAB><TAB>`.
+require 'rb-readline'
+require 'pry'
+require 'bond'
+
+# Pry drives Readline itself and feeds the line buffer to Bond via
+# Pry::BondCompleter#get_full_line_input, so Bond's Agent never needs to set up
+# Readline on its own. Without a plugin here, Agent#setup_readline(nil) rescues
+# internally and prints "Bond Error: Failed  setup with 'undefined method
+# 'setup' for nil'" on first complete() call. A no-op plugin silences it.
+Bond::M.config[:readline] = Module.new do
+  def self.setup(_agent); end
+  def self.line_buffer; ''; end
+end
+
+class Pry::BondCompleter
+  class << self
+    attr_reader :bond
+  end
+
+  def self.setup(config = {})
+    @lock ||= Mutex.new
+    return if @bond
+
+    @bond = Bond::M
+    @bond.config.merge!(config)
+    @current_pry_instance = nil
+    # Don't call start here - Bond will initialize when needed
+  end
+
+  def self.with_pry(instance)
+    @lock ||= Mutex.new
+    @lock.synchronize do
+      begin
+        @current_pry_instance = instance
+        yield
+      ensure
+        @current_pry_instance = nil
+      end
+    end
+  end
+
+  def initialize(input, pry = nil)
+    @pry = pry
+    @input = input
+  end
+
+  def call(str, _options)
+    Pry::BondCompleter.setup if Pry::BondCompleter.bond.nil?
+
+    Pry::BondCompleter.with_pry(@pry) do
+      Pry::BondCompleter.bond.agent.call(str, get_full_line_input || str)
+    end
+  end
+
+  protected
+
+  def get_full_line_input
+    if @input.respond_to?(:line_buffer)
+      @input.line_buffer
+    elsif @input.respond_to?(:line)
+      @input.line
+    end
+  end
+end
+
+Pry.config.completer = Pry::BondCompleter

data/lib/salad/catalogue_of_life.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Salad
+  # Wraps Colrapi so calls are scoped to a Catalogue of Life dataset by default.
+  # Users override by passing dataset_id explicitly — as a positional arg for
+  # methods that take it positionally, or as a kwarg otherwise.
+  class CatalogueOfLife
+    DEFAULT_DATASET_ID = '3LR'
+
+    def initialize(mod = Colrapi)
+      @mod = mod
+    end
+
+    def method_missing(name, *args, **kwargs, &block)
+      return super unless @mod.respond_to?(name)
+
+      ds_param = @mod.method(name).parameters.find { |_, pname| pname == :dataset_id }
+
+      if ds_param
+        case ds_param[0]
+        when :req
+          args = [DEFAULT_DATASET_ID] if args.empty?
+        when :key, :keyreq
+          kwargs[:dataset_id] = DEFAULT_DATASET_ID unless kwargs.key?(:dataset_id)
+        end
+      end
+
+      @mod.public_send(name, *args, **kwargs, &block)
+    end
+
+    def respond_to_missing?(name, include_private = false)
+      @mod.respond_to?(name, include_private) || super
+    end
+
+    def to_s
+      @mod.to_s
+    end
+
+    def inspect
+      "#<Salad::CatalogueOfLife(default dataset_id=#{DEFAULT_DATASET_ID})>"
+    end
+  end
+end