that_language-client 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ede343e2d2d2065c8eec215ad7434eed345c0fce
-  data.tar.gz: 725f13a0d292bcc889ee3bddf8951f47385f64bb
+SHA256:
+  metadata.gz: a35e778f0e91bb68c5768bf80e96b4e5b01bb2ccc61742f1d17600beace868ef
+  data.tar.gz: 906cc116a23a46c34a7293d4f1731c8e7b8225b0a1da431587724b3ea05942b2
 SHA512:
-  metadata.gz: 49442abaaeae4c90371c03ffd294cb7fe8ea75306328d25714bceb56474c79eb3918e4aa6de71967719ef8e3e28e72b56ccc26867ba8dce359b672b6cbed3548
-  data.tar.gz: b0cac92492926a67f690af4479716852de3dd0fb4517b18f4996b27074d6be86c3fbd5da9359b481f9365752d95d04c346245c1aa00ef1ab24036a535a6c0c3b
+  metadata.gz: 155c8e6dcc568f0617cc26d88e72cbfd19beb5f8a80e6f6e6543870d5fdc3e63009b47961194a76cdb92c4ad86b70f6f3a0a0b205f55e4691304bd25dacbabea
+  data.tar.gz: fb696ca48f2d3413027ecf3490fbea2476f26842ab8538a4f26ccb7a47c9891544ca836f46f721766145d3a7c39938bb07eed775e249cf0c4f6949d20086bd5f

data/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+jobs:
+  rspec:
+    name: rspec (ruby ${{ matrix.ruby }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ["3.1", "3.2", "3.3", "3.4", "4.0"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+      - run: bundle exec rspec
+
+  rubocop:
+    name: rubocop
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "4.0"
+          bundler-cache: true
+      - run: bundle exec rubocop

data/.rubocop.yml

@@ -0,0 +1,18 @@
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  # TargetRubyVersion is deliberately not set here. RuboCop derives it from
+  # required_ruby_version in the gemspec (currently ">= 3.1"), which takes
+  # precedence over .ruby-version, so the oldest supported Ruby is stated in
+  # exactly one place. It is the *minimum* supported version, not the version
+  # used for development -- raising it means dropping support for users.
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "bin/**/*"
+    - "vendor/**/*"
+    - "tmp/**/*"
+
+# Specs read better without a documentation comment on every describe block.
+Style/Documentation:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,208 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-07-20 03:15:13 UTC using RuboCop version 1.88.2.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 6
+# Configuration parameters: EnforcedStyle, AllowedGems.
+# SupportedStyles: Gemfile, gems.rb, gemspec
+Gemspec/DevelopmentDependencies:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: with_first_element, with_fixed_indentation
+Layout/ArrayAlignment:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Layout/ClosingHeredocIndentation:
+  Exclude:
+    - 'spec/support/that_language_client_spec_helper.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IndentationWidth.
+Layout/ClosingParenthesisIndentation:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Layout/EmptyLineAfterMagicComment:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, IndentationWidth.
+# SupportedStyles: special_inside_parentheses, consistent, align_brackets
+Layout/FirstArrayElementIndentation:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 4
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: IndentationWidth.
+# SupportedStyles: special_inside_parentheses, consistent, align_braces
+Layout/FirstHashElementIndentation:
+  EnforcedStyle: consistent
+
+# Offense count: 3
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowMultipleStyles, EnforcedHashRocketStyle, EnforcedColonStyle, EnforcedLastArgumentHashStyle.
+# SupportedHashRocketStyles: key, separator, table
+# SupportedColonStyles: key, separator, table
+# SupportedLastArgumentHashStyles: always_inspect, always_ignore, ignore_implicit, ignore_explicit
+Layout/HashAlignment:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Layout/HeredocIndentation:
+  Exclude:
+    - 'spec/support/that_language_client_spec_helper.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineHashBraceLayout:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: symmetrical, new_line, same_line
+Layout/MultilineMethodCallBraceLayout:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, EnforcedStyleForEmptyBraces.
+# SupportedStyles: space, no_space, compact
+# SupportedStylesForEmptyBraces: space, no_space
+Layout/SpaceInsideHashLiteralBraces:
+  Exclude:
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 20
+
+# Offense count: 4
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Max: 60
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 37
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ProceduralMethods, FunctionalMethods, AllowedMethods, AllowedPatterns, AllowBracesOnProceduralOneLiners, BracesRequiredMethods.
+# SupportedStyles: line_count_based, semantic, braces_for_chaining, always_braces
+# ProceduralMethods: benchmark, bm, bmbm, create, each_with_object, measure, new, realtime, tap, with_object
+# FunctionalMethods: let, let!, subject, watch
+# AllowedMethods: lambda, proc, it
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/that_language/client/available_query_spec.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/Encoding:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/ExpandPathArguments:
+  Exclude:
+    - 'spec/spec_helper.rb'
+    - 'that_language-client.gemspec'
+
+# Offense count: 26
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: always, always_true, never
+Style/FrozenStringLiteralComment:
+  Enabled: false
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, EnforcedShorthandSyntax, UseHashRocketsWithSymbolValues, PreferHashRocketsForNonAlnumEndingSymbols.
+# SupportedStyles: ruby19, hash_rockets, no_mixed_keys, ruby19_no_mixed_keys
+# SupportedShorthandSyntax: always, never, either, consistent, either_consistent
+Style/HashSyntax:
+  Exclude:
+    - 'Rakefile'
+
+# Offense count: 1
+# This cop supports unsafe autocorrection (--autocorrect-all).
+# Configuration parameters: EnforcedStyle, Recursive.
+# SupportedStyles: literals, strict
+Style/MutableConstant:
+  Exclude:
+    - 'lib/that_language/client/version.rb'
+
+# Offense count: 2
+Style/OpenStructUse:
+  Exclude:
+    - 'lib/that_language/client/details_query.rb'
+    - 'spec/that_language/client/details_query_spec.rb'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: PreferredDelimiters.
+Style/PercentLiteralDelimiters:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 2
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantPercentQ:
+  Exclude:
+    - 'that_language-client.gemspec'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+Style/RedundantSelf:
+  Exclude:
+    - 'lib/that_language.rb'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle.
+# SupportedStyles: only_raise, only_fail, semantic
+Style/SignalException:
+  Exclude:
+    - 'lib/that_language/client/query.rb'
+
+# Offense count: 168
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: EnforcedStyle, ConsistentQuotesInMultiline.
+# SupportedStyles: single_quotes, double_quotes
+Style/StringLiterals:
+  Enabled: false
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, AllowQualifiedName, URISchemes, AllowRBSInlineAnnotation, AllowCopDirectives, AllowedPatterns, SplitStrings.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 185

data/CHANGELOG.md

@@ -0,0 +1,42 @@
+## 0.2.0 [☰](https://github.com/Deradon/that_language-client/compare/v0.1.2...v0.2.0) (2026-07-20)
+
+Revival release. 0.1.2 dates from 2016 and does not install on Ruby 3 or later.
+
+### Breaking changes
+
+* **Return types now match the core gem.** This gem claims to be a drop-in
+  replacement for `that_language`, and it was not: language *names* are symbols
+  and language *codes* are strings in the core gem, but this gem returned
+  strings throughout, and `available_languages` came back unsorted. Seven of
+  fourteen public methods disagreed, and had since 2016. Corrected at the JSON
+  boundary; `to_h` still exposes the raw wire format. Code that compares
+  against strings will need updating — which is precisely the incompatibility
+  that made this gem not a drop-in replacement in the first place.
+* `required_ruby_version` is now `>= 3.1`, so the gem no longer installs on
+  Ruby 2.x.
+* The default host is now `localhost:4567`. The previous default pointed at
+  `that-language-api.ruby-on-rails.guru`, which no longer resolves. A default
+  you can start yourself cannot rot; point it elsewhere with
+  `ThatLanguage::Client.configure { |c| c.host = "..." }`.
+
+### Bug fixes
+
+* `ostruct` is declared as a runtime dependency. It stopped being a default gem
+  in Ruby 4.0, where `DetailsQuery` requiring it is a bare `LoadError`.
+
+### Enhancements
+
+* Gemspec: dropped the `bundler ~> 1.10` development dependency that made
+  `bundle install` unsolvable, and modernised the remaining pins.
+* The specs no longer encode the implementation's own assumptions — they assert
+  the core gem's contract, which is why stubs alone never caught the drift
+  above.
+* CI moved from Travis to GitHub Actions, covering Ruby 3.1 through 4.0.
+
+## 0.1.2 [☰](https://github.com/Deradon/that_language-client/compare/v0.1.1...v0.1.2) (2016-04-12)
+
+## 0.1.1 [☰](https://github.com/Deradon/that_language-client/compare/v0.1.0...v0.1.1) (2015-12-07)
+
+## 0.1.0 (2015-12-07)
+
+* Initial release

data/CLAUDE.md

@@ -0,0 +1,82 @@
+# CLAUDE.md — that_language-client
+
+HTTP client for `that_language-service`, and a drop-in replacement for the
+`that_language` gem: same `ThatLanguage` module, same methods, same return
+types, but each call is an HTTP request instead of a local wordlist lookup.
+
+Developed on Ruby 4.0.6 (`.tool-versions`); supports 3.1 and up.
+
+## Commands
+
+```sh
+bundle install
+bundle exec rspec       # 56 examples, 0 failures
+bundle exec rubocop
+```
+
+The specs stub HTTP with webmock and never touch the network.
+
+## Hard constraints
+
+**The public API is a contract with two other repositories.** `that_language`
+is the reference implementation, `that_language-service` exposes the same
+surface as eight HTTP endpoints, and this gem mirrors it method for method.
+Nothing enforces the parity. Adding a method to the core gem means adding a
+query class here.
+
+**Language names are symbols; language codes are strings.** That is the core
+gem's contract, and it is what `Query#language_name` exists to preserve across
+the JSON boundary. The one exception is `available`, which is keyed by symbol.
+`to_h` is deliberately outside this — it returns the raw wire format.
+
+This drifted once, undetected from 2016 until 2026-07-20: every language name
+came back as a string and `available_languages` was unsorted. **The specs did
+not catch it because they were written from the implementation** — the webmock
+stubs asserted whatever the code already did, so they were green against a
+client that did not match the gem it replaces.
+
+If you change anything on the JSON boundary, verify against a real service
+rather than the stubs:
+
+```sh
+docker run -p 4567:4567 that_language-service    # from that_language-docker
+```
+
+Then call every public method and compare the *types* against the core gem. The
+two gems both define `ThatLanguage` and cannot be loaded into one process, so
+this is two processes producing comparable output and a diff.
+
+## Conventions
+
+- Two-space indent, double-quoted strings in `require`s.
+- **Do not mass-autocorrect RuboCop.** `.rubocop_todo.yml` grandfathers the
+  pre-existing offences by design. If a cop fires on new code, fix that code; if
+  the todo needs regenerating, use `rubocop --auto-gen-config`.
+- **Explain a shared constraint once, in the shared place.** If the same comment
+  would appear on several call sites, that is a signal to hoist the thing being
+  explained — a helper method, a shared example — and put the explanation there.
+  Repeating an explanation verbatim is noise: it costs a reader attention at
+  every occurrence and it goes stale in more than one place at once.
+  `Query#language_name` and `spec/support/private_readers.rb` are both this
+  pattern.
+
+## Gotchas
+
+- **`ostruct` is a declared runtime dependency.** It stopped being a default gem
+  in Ruby 4.0 and `DetailsQuery` requires it. Removing it means a bare
+  `LoadError` on 4.x. (There is a `TODO` about replacing OpenStruct with a real
+  result class; that would retire the dependency.)
+- **`rspec-its` 2.0 resolves the subject with `public_send`**, so `its(:foo)`
+  cannot reach a private reader. Use the shared examples in
+  `spec/support/private_readers.rb` rather than widening the API to suit a
+  matcher.
+- **The default host is `localhost:4567`** — what the service container listens
+  on. It used to be a hosted domain, which went offline and left the gem inert
+  out of the box. Prefer a default the reader can start themselves over one that
+  depends on somebody else's DNS.
+- `Config#host` accepts a bare host, a `host:port`, or a full base URL. Without a
+  scheme, `http` is assumed.
+
+## Context
+
+This is a public GitHub repository — do not push without asking.

data/README.md

@@ -1,144 +1,131 @@
+[![CI](https://github.com/Deradon/that_language-client/actions/workflows/ci.yml/badge.svg)](https://github.com/Deradon/that_language-client/actions/workflows/ci.yml)
+
 # ThatLanguage::Client
 
-## Installation
+A drop-in replacement for the [`that_language`][core] gem that answers each call
+over HTTP against a [`that_language-service`][service] instance, instead of
+loading wordlists locally.
+
+Same `ThatLanguage` module, same methods, same return types — but no 16 MB of
+wordlists in your process and no cold-start cost.
 
-Add this line to your application's Gemfile:
+[core]: https://github.com/Deradon/that_language
+[service]: https://github.com/Deradon/that_language-service
+
+## Installation
 
 ```ruby
 gem 'that_language-client'
 ```
 
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install that_language-client
-
-## Examples
+Note that the published 0.1.2 predates this revision. Until a new version is
+released, point at the repository:
 
 ```ruby
-text = "This is just a random english sentence."
-
-## == Language
-
-  ThatLanguage.language(text)
-  # => "English"
-
-
-## == LanguageCode
-
-  ThatLanguage.language_code(text)
-  # => "en"
-
-
-## == Detect
-
-  detect = ThatLanguage.detect(text)
-  # => #<ThatLanguage::Client::DetectQuery:...
+gem 'that_language-client', git: 'https://github.com/Deradon/that_language-client.git'
+```
 
-  detect.language
-  # => "English"
+## You need a service to talk to
 
-  detect.language_code
-  # => "en"
+This gem is a client and does nothing on its own. The default host is
+`localhost:4567`, which is what the [service container][service] listens on:
 
-  detect.confidence
-  # => 0.5631093821386951
+```sh
+docker run -p 4567:4567 that_language-service
+```
 
-  detect.to_h
-  # => {"language"=>"English", "language_code"=>"en", "confidence"=>0.5631093821386951}
+Point it somewhere else with:
 
+```ruby
+ThatLanguage::Client.configure do |config|
+  config.host = "https://api.example.com"
+end
+```
 
-## == Details
+The host may be a bare `example.com`, a `host:port`, or a full base URL. Without
+a scheme, `http` is assumed.
 
-  details = ThatLanguage.details(text)
-  # => #<ThatLanguage::Client::DetailsQuery:...
+> Earlier versions defaulted to a hosted domain. That host went offline, which
+> left the gem inert out of the box with nothing to show for it but a connection
+> error. The default is now something you can start yourself.
 
-  winner = details.winner
-  # => OpenStruct
+## Examples
 
-    winner.language
-    # => "English"
+```ruby
+text = "This is just a random english sentence."
 
-    winner.language_code
-    # => "en"
+ThatLanguage.language(text)
+# => :English
 
-    winner.confidence
-    # => 0.5631093821386951
+ThatLanguage.language_code(text)
+# => "en"
 
-    winner.value
-    # => 3.9417656749708656
+detect = ThatLanguage.detect(text)
+detect.language        # => :English
+detect.language_code   # => "en"
+detect.confidence      # => 0.5631093821386951
+detect.to_h            # => {"language"=>"English", ...}  # raw wire format
 
-    winner.hit_ratio
-    # => 0.8571428571428571
+details = ThatLanguage.details(text)
+winner = details.winner
+winner.language        # => :English
+winner.language_code   # => "en"
+winner.confidence      # => 0.5631093821386951
+winner.value           # => 3.9417656749708656
+winner.hit_ratio       # => 0.8571428571428571
+winner.hit_count       # => 6
+winner.words_count     # => 7
+details.results        # => [#<OpenStruct ...>, ...]
 
-    winner.hit_count
-    # => 6
+ThatLanguage.available
+# => { ak: :Akan, am: :Amharic, ... }
 
-    winner.words_count
-    # => 7
+ThatLanguage.available_languages
+# => [:Akan, :Amharic, ...]
 
-  results = details.results
-  # => [#<OpenStruct, #<OpenStruct, ...]
+ThatLanguage.available_language_codes
+# => [:ak, :am, ...]
 
-  details.to_h
-  # =>
-  # {
-  #   "results" => [
-  #     {
-  #       "language"=>"English",
-  #       "language_code"=>"en",
-  #       "confidence"=>0.5631093821386951,
-  #       "value"=>3.9417656749708656,
-  #       "hit_ratio"=>0.8571428571428571,
-  #       "hit_count"=>6,
-  #       "words_count"=>7
-  #     },
-  #     {
-  #       "language"=>"Sundanese",
-  #       "language_code"=>"su",
-  #       "confidence"=>0.26101716738575337,
-  #       "value"=>1.8271201717002734,
-  #       "hit_ratio"=>0.7142857142857143,
-  #       "hit_count"=>5,
-  #       "words_count"=>7
-  #     },
-  #     # ...
-  #   ]
-  # }
+ThatLanguage.api_version   # the *remote service's* version
+# => "0.1.2"
 ```
 
-## Configure
+### Symbols and strings
 
-Configure the host to use:
+Following the core gem: **language names are symbols, language codes are
+strings.** `available` is keyed by symbol with symbol values, and both
+`available_languages` and `available_language_codes` come back sorted.
 
-```ruby
-ThatLanguage::Client.configure do |config|
-  config.host = "my-custom-that-language-api.com"
-end
-```
+JSON has no symbols, so this gem converts at the boundary. Before this was
+fixed, every one of those returned a string and `available_languages` was
+unsorted — which meant the gem was not actually a drop-in replacement. `to_h`
+is the exception and still gives you the raw wire format.
 
 ## Development
 
-After checking out the repo, run `bin/setup` to install dependencies.
-Then, run `rake rspec` to run the tests.
-You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```sh
+bundle install
+bundle exec rspec     # 56 examples
+bundle exec rubocop
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`.
-To release a new version, update the version number in `version.rb`, and then run
-`bundle exec rake release`, which will create a git tag for the version,
-push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Tested on Ruby 3.2, 3.3 and 4.0. The specs stub HTTP with `webmock` and never
+touch the network.
 
-## Contributing
+To check parity against a real service rather than stubs, start the container
+and exercise the gem against it — that is how the symbol/string drift above was
+found, and stubs alone would not have caught it, because the stubs encoded the
+same wrong assumption the code did.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/Deradon/that_language-client.
-This project is intended to be a safe, welcoming space for collaboration,
-and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+## Contributing
 
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/Deradon/that_language-client. This project is intended to be
+a safe, welcoming space for collaboration, and contributors are expected to
+adhere to the [Contributor Covenant](http://contributor-covenant.org) code of
+conduct.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
-
+The gem is available as open source under the terms of the
+[MIT License](http://opensource.org/licenses/MIT).

data/lib/that_language/client/available_query.rb

@@ -0,0 +1,25 @@
+require "that_language/client/query"
+
+module ThatLanguage
+  class Client
+    class AvailableQuery < Query
+      # FIXME: do not pass text to super
+      def initialize(client: Client.current)
+        super(text: "", client: client)
+      end
+
+      # The exception to the rule in Query#language_name: this hash is keyed by
+      # symbol in the core gem (`{ak: :Akan}`), so the *code* is a symbol here
+      # even though language_code(text) returns a string.
+      def available
+        @available ||= json["available"].to_h { |code, name| [code.to_sym, language_name(name)] }
+      end
+
+      private
+
+      def endpoint
+        "/available"
+      end
+    end
+  end
+end

data/lib/that_language/client/config.rb

@@ -1,10 +1,24 @@
 module ThatLanguage
   class Client
     class Config
-      attr_accessor :host
+      attr_writer :host
 
+      # The default points at a service on this machine, which is what the
+      # container image listens on:
+      #
+      #   docker run -p 4567:4567 that_language-service
+      #
+      # It used to be a hosted domain. That host went offline and the gem became
+      # inert out of the box, with nothing to show for it but a connection
+      # error -- so the default is now something the reader can start
+      # themselves, and it cannot rot, because it is not somebody else's DNS
+      # record.
+      #
+      # Point it at a real deployment with:
+      #
+      #   ThatLanguage::Client.configure { |c| c.host = "https://api.example.com" }
       def host
-        @host ||= "that-language-api.ruby-on-rails.guru"
+        @host ||= "localhost:4567"
       end
     end
   end

data/lib/that_language/client/details_query.rb

@@ -10,7 +10,9 @@ module ThatLanguage
       end
 
       def results
-        @results ||= json["results"].map { |result| OpenStruct.new(result) }
+        @results ||= json["results"].map do |result|
+          OpenStruct.new(result.merge("language" => language_name(result["language"])))
+        end
       end
 
       private

data/lib/that_language/client/detect_query.rb

@@ -4,7 +4,7 @@ module ThatLanguage
   class Client
     class DetectQuery < Query
       def language
-        json["language"]
+        language_name(json["language"])
       end
 
       def language_code

data/lib/that_language/client/language_query.rb

@@ -4,7 +4,7 @@ module ThatLanguage
   class Client
     class LanguageQuery < Query
       def language
-        json["language"]
+        language_name(json["language"])
       end
 
       private

data/lib/that_language/client/query.rb

@@ -19,6 +19,15 @@ module ThatLanguage
 
       attr_reader :client
 
+      # The core gem returns language *names* as symbols and language *codes*
+      # as strings. JSON has neither, so every name crossing this boundary is
+      # converted back -- without it this gem is not the drop-in replacement it
+      # claims to be. Every subclass that surfaces a language name goes through
+      # here, so the rule is stated once.
+      def language_name(value)
+        value&.to_sym
+      end
+
       def json
         @json ||= JSON.parse(response.body)
       end
@@ -28,7 +37,7 @@ module ThatLanguage
       end
 
       def url
-        "http://#{client.host}#{endpoint}"
+        "#{client.base_url}#{endpoint}"
       end
 
       def endpoint

data/lib/that_language/client/version.rb

@@ -1,5 +1,5 @@
 module ThatLanguage
   class Client
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

data/lib/that_language/client/version_query.rb

@@ -0,0 +1,22 @@
+require "that_language/client/query"
+
+module ThatLanguage
+  class Client
+    class VersionQuery < Query
+      # FIXME: do not pass text to super
+      def initialize(client: Client.current)
+        super(text: "", client: client)
+      end
+
+      def version
+        json["version"]
+      end
+
+      private
+
+      def endpoint
+        "/version"
+      end
+    end
+  end
+end

data/lib/that_language/client.rb

@@ -1,10 +1,12 @@
 require "that_language"
 require "that_language/client/config"
 
-require "that_language/client/language_query"
-require "that_language/client/language_code_query"
-require "that_language/client/detect_query"
+require "that_language/client/available_query"
 require "that_language/client/details_query"
+require "that_language/client/detect_query"
+require "that_language/client/language_code_query"
+require "that_language/client/language_query"
+require "that_language/client/version_query"
 
 require "that_language/client/version"
 
@@ -16,6 +18,16 @@ module ThatLanguage
       @host = host
     end
 
+    # `host` may be a bare "example.com", a "host:port", or a full base URL
+    # carrying a scheme. Anything without a scheme is assumed to be http, which
+    # is what this client always did; https is now expressible, and any real
+    # deployment will need it.
+    def base_url
+      return host.sub(%r{/+\z}, "") if host.include?("://")
+
+      "http://#{host}"
+    end
+
     def self.current
       @current ||= Client.new(host: config.host)
     end

data/lib/that_language.rb

@@ -17,6 +17,25 @@ module ThatLanguage
     ThatLanguage::Client::DetailsQuery.new(text: text)
   end
 
+  def self.available
+    ThatLanguage::Client::AvailableQuery.new.available
+  end
+
+  # Sorted, to match the core gem. The service happens to return codes in
+  # order, so only the names were visibly unsorted -- but relying on the
+  # server's ordering is exactly how the two implementations drift.
+  def self.available_languages
+    available.values.sort
+  end
+
+  def self.available_language_codes
+    available.keys.sort
+  end
+
+  def self.api_version
+    ThatLanguage::Client::VersionQuery.new.version
+  end
+
   def self.monkeypatch(klass)
     klass.class_eval do
       define_method(:language_code) { ThatLanguage.language_code(self.to_s) }

data/that_language-client.gemspec

@@ -10,27 +10,33 @@ Gem::Specification.new do |spec|
   spec.email         = ["me@patrick-helm.de"]
 
   spec.summary       = %q{API client for ThatLanguage.}
-  # spec.description   = %q{Detect language for given text.}
+  spec.description   = %q{Drop-in replacement for the that_language gem that answers each call over HTTP against a that_language-service instance, instead of loading wordlists locally.}
   spec.homepage      = "https://github.com/Deradon/that_language-client"
   spec.license       = "MIT"
 
-  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
-  # delete this section to allow pushing this gem to any host.
-  # if spec.respond_to?(:metadata)
-  #   spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
-  # else
-  #   raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
-  # end
+  spec.required_ruby_version = ">= 3.1"
+
+  spec.metadata = {
+    "homepage_uri"          => spec.homepage,
+    "source_code_uri"       => spec.homepage,
+    "bug_tracker_uri"       => "#{spec.homepage}/issues",
+    "rubygems_mfa_required" => "true"
+  }
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.10"
+  # ostruct stopped being a default gem in Ruby 4.0, so it must be declared
+  # explicitly. DetailsQuery wraps each result in an OpenStruct; without this
+  # the gem fails to load on 4.x with a bare LoadError.
+  spec.add_dependency "ostruct", "~> 0.6"
+
   spec.add_development_dependency "pry"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
-  spec.add_development_dependency "rspec-its"
-  spec.add_development_dependency "webmock"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.13"
+  spec.add_development_dependency "rspec-its", "~> 2.0"
+  spec.add_development_dependency "rubocop", "~> 1.88"
+  spec.add_development_dependency "webmock", "~> 3.25"
 end

metadata

@@ -1,29 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: that_language-client
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Patrick Helm
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-07 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: ostruct
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
-  type: :development
+        version: '0.6'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -44,66 +43,86 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.88'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.25'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-description: 
+        version: '3.25'
+description: Drop-in replacement for the that_language gem that answers each call
+  over HTTP against a that_language-service instance, instead of loading wordlists
+  locally.
 email:
 - me@patrick-helm.de
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rspec"
-- ".travis.yml"
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
@@ -113,6 +132,7 @@ files:
 - bin/setup
 - lib/that_language.rb
 - lib/that_language/client.rb
+- lib/that_language/client/available_query.rb
 - lib/that_language/client/config.rb
 - lib/that_language/client/details_query.rb
 - lib/that_language/client/detect_query.rb
@@ -120,12 +140,16 @@ files:
 - lib/that_language/client/language_query.rb
 - lib/that_language/client/query.rb
 - lib/that_language/client/version.rb
+- lib/that_language/client/version_query.rb
 - that_language-client.gemspec
 homepage: https://github.com/Deradon/that_language-client
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  homepage_uri: https://github.com/Deradon/that_language-client
+  source_code_uri: https://github.com/Deradon/that_language-client
+  bug_tracker_uri: https://github.com/Deradon/that_language-client/issues
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -133,16 +157,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.6
-signing_key: 
+rubygems_version: 4.0.16
 specification_version: 4
 summary: API client for ThatLanguage.
 test_files: []

data/.travis.yml

@@ -1,4 +0,0 @@
-language: ruby
-rvm:
-  - 2.2.2
-before_install: gem install bundler -v 1.10.4