spoonerize 0.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 932ce6e7e6441c787ded513aebed0b3e0b83fa6afa83790abe8da66c9314e96b
-  data.tar.gz: 6a5dedc04324853f1bfbc63e6317b17737eab6fb10b89ae11136b598438a4f08
+  metadata.gz: 9ad82a22fd996a0e5af1653a6ed66f27863da252331b4fa58865980d6a27b063
+  data.tar.gz: d206494ce8cc6e9dabbda3ab86389d080e57d1baf0a003800ba6edd3fe3c3b13
 SHA512:
-  metadata.gz: b579d2925471dca724865574a82a827a5f0d31229991d1746db4890a0d4c250141daa536bbc932c829fd9d7e8f5af63e89b85846a788d23eca766219c2a60681
-  data.tar.gz: 1531172c418c2cf00e155ca5e56c888218888af9c8b6694ff7a9b3195dbda173c122058e7ac46c4705c311d7951a8c6f773aa09d4571a447da7f4781ca425168
+  metadata.gz: f8b89f4ea9ca38fb0ee9773ca55e6fb654e94d4135f4b4748abc91c90fe014e3c1bd90e6f0c9c4f9d74f2efcf64b7bfd8b488ebcf3cf92dc40d9c2616089d30e
+  data.tar.gz: 1c81200ffd8922cc1384c11b9a8a8766eae3d59f3301c544dbf9a6928617c85d231f931cec768d4ad4c7c8fcbc697ca94d666c182340974c7d406411c11dab34

data/Gemfile.lock

@@ -1,28 +1,101 @@
 PATH
   remote: .
   specs:
-    spoonerize (0.2.0)
+    spoonerize (2.0.0)
       csv
+      puma (~> 8.0)
+      rackup (~> 2.3)
+      sinatra (~> 4.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    ast (2.4.3)
+    base64 (0.3.0)
     csv (3.3.5)
     date (3.5.1)
     erb (6.0.4)
+    json (2.20.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    mustermann (3.1.1)
+    nio4r (2.7.5)
+    parallel (1.28.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
     power_assert (3.0.1)
+    prism (1.9.0)
     psych (5.4.0)
       date
       stringio
+    puma (8.0.2)
+      nio4r (~> 2.0)
+    racc (1.8.1)
+    rack (3.2.6)
+    rack-protection (4.2.1)
+      base64 (>= 0.1.0)
+      logger (>= 1.6.0)
+      rack (>= 3.0.0, < 4)
+    rack-session (2.1.2)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rackup (2.3.1)
+      rack (>= 3)
+    rainbow (3.1.1)
     rake (13.4.2)
     rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
+    regexp_parser (2.12.0)
+    rubocop (1.84.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    sinatra (4.2.1)
+      logger (>= 1.6.0)
+      mustermann (~> 3.0)
+      rack (>= 3.0.0, < 4)
+      rack-protection (= 4.2.1)
+      rack-session (>= 2.0.0, < 3)
+      tilt (~> 2.0)
+    standard (1.54.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.84.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
     stringio (3.2.0)
     test-unit (3.7.8)
       power_assert
+    tilt (2.7.0)
     tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
   arm64-darwin-25
@@ -33,6 +106,7 @@ DEPENDENCIES
   rake (~> 13.0, >= 13.0.1)
   rdoc
   spoonerize!
+  standard (= 1.54.0)
   test-unit (~> 3.3, >= 3.3.5)
 
 BUNDLED WITH

data/README.md

@@ -26,6 +26,8 @@ consonants, but will still lose its own if it has any.
 - If the word to pull from is excluded, that word is skipped, and you pull the
 leading consonants from the next non-excluded word.
 - "Q" and "U" should stay together (like "queen").
+- "Y" is treated like a leading consonant by itself or before a vowel sound
+(like "yellow"), but like a leading vowel before a consonant (like "yttrium").
 - A lot of the time, the words won't look how they're supposed to sound, as you
 go by how the word *used* to sound, not how it's spelled. For instance,
 `$ spoonerize two new cuties` becomes "no cew twuties", but it would be
@@ -40,7 +42,7 @@ Just install the gem!
 gem install spoonerize
 ```
 
-If you don't have permission on your system to install ruby or gems, I recommend
+If you don't have permission on your system to install Ruby or gems, I recommend
 using
 [rbenv](http://www.rubyinside.com/rbenv-a-simple-new-ruby-version-management-tool-5302.html),
 or you can try the manual methods below.
@@ -82,10 +84,12 @@ get the results. For example:
 
 ```
 $ spoonerize -s not too shabby
-Saving [tot shoo nabby] to ~/.cache/spoonerize/spoonerize.csv
+tot shoo nabby
+Saving...
 
 $ spoonerize -rs not too shabby
-Saving [shot noo tabby] to ~/.cache/spoonerize/spoonerize.csv
+shot noo tabby
+Saving...
 
 $ spoonerize -p
 not too shabby | tot shoo nabby | No Options
@@ -96,22 +100,48 @@ Here is a list of all available options:
 
 ```
 -r, --[no-]reverse               Reverse flipping
--l, --[no-]lazy                  Skip small words
+-l, --[no-]lazy                  Skip common words
+-c, --[no-]consonants-only       Only flip consonant-starting words
 -m, --[no-]map                   Print words mapping
--p, --[no-]print                 Print all entries in the log
+-p, --[no-]print-log             Print all entries in the log
 -s, --[no-]save                  Save results in log
-    --exclude=WORDS              Words to skip
+    --exclude=WORD               Words to skip
 ```
 
+## Web Usage
+The gem also installs a small Sinatra app:
+
+```sh
+spoonerize-web
+```
+
+By default, Sinatra starts on its normal local development address. You can
+choose a host or port when you need to:
+
+```sh
+spoonerize-web --host 127.0.0.1 --port 9292
+```
+
+Open the printed local URL in your browser, enter a phrase, choose any options,
+and submit the form. The page reloads with the spoonerized result and keeps
+your phrase and options in the form. Check "Save result" to write a successful
+result to the configured log file.
+
+The web app ships with the main gem for now, so `gem install spoonerize`
+installs both `spoonerize` and `spoonerize-web`.
+
 ### Config File
 You can create a Ruby config file called `~/.spoonerizerc`. The CLI loads this
 file automatically before it parses command-line options, so options set in the
-file can still be overridden at runtime by executable flags.
+file can still be overridden at runtime by executable flags. The web app loads
+the same file when it starts, and uses those values for the initial form
+defaults.
 
 ```ruby
 Spoonerize.configure do |config|
   config.excluded_words = []
   config.lazy = false
+  config.consonants_only = false
   config.reverse = false
   config.logfile_name = File.expand_path("~/.cache/spoonerize/spoonerize.csv")
 end
@@ -122,50 +152,63 @@ Because the file is Ruby, you can set only the values you want to change.
 ## API
 The API is [fully
 documented](https://evanthegrayt.github.io/spoonerize/), but below
-are some quick examples of how you could use this in your ruby code.
+are some quick examples of how you could use this in your Ruby code.
 
 ```ruby
 require 'spoonerize'
 
-spoonerism = Spoonerize::Spoonerism.new(%w[not too shabby])
+spoonerism = Spoonerize::Spoonerism.new("not", "too", "shabby")
 
 spoonerism.to_s
 # => tot shoo nabby
 
-Spoonerize.configure do |config|
-  config.reverse = true
-end
-
-spoonerism.to_s
+reversed = Spoonerize::Spoonerism.new("not", "too", "shabby", reverse: true)
+reversed.to_s
 # => shot noo tabby
 
 Spoonerize.configure do |config|
   config.logfile_name = File.expand_path("~/.cache/spoonerize/spoonerize.csv")
 end
-spoonerism.save
+Spoonerize::Spoonerism.new("not", "too", "shabby").save
+```
+
+To leave vowel-starting words alone, enable consonants-only mode:
+
+```ruby
+Spoonerize::Spoonerism.new("turn", "up", "son", consonants_only: true).to_s
+# => surn up ton
 ```
 
-You can also configure Spoonerize in Ruby before creating a spoonerism:
+You can also configure global defaults before creating a spoonerism:
 
 ```ruby
 Spoonerize.configure do |config|
   config.reverse = true
 end
 
-s = Spoonerize::Spoonerism.new(%w[not too shabby])
+s = Spoonerize::Spoonerism.new("not", "too", "shabby")
 s.spoonerize
 # => shot noo tabby
 ```
 
+Options passed directly to `Spoonerize::Spoonerism.new` only apply to that
+instance.
+
+Passing words as an array is deprecated and will be removed in Spoonerize 1.0:
+
+```ruby
+Spoonerize::Spoonerism.new(%w[not too shabby])
+```
+
 Or load a config file manually:
 
 ```ruby
 Spoonerize.load_config_file("~/.spoonerizerc")
-s = Spoonerize::Spoonerism.new(%w[not too shabby])
+s = Spoonerize::Spoonerism.new("not", "too", "shabby")
 ```
 
 ## Self Promotion
 I do these projects for fun, and I enjoy knowing that they're helpful to people.
 Consider starring [the repository](https://github.com/evanthegrayt/spoonerize)
 if you like it! If you love it, follow me [on
-github](https://github.com/evanthegrayt)!
+GitHub](https://github.com/evanthegrayt)!

data/Rakefile

@@ -4,6 +4,7 @@ require_relative "lib/spoonerize"
 require "bundler/gem_tasks"
 require "rdoc/task"
 require "rake/testtask"
+require "standard/rake"
 
 Rake::TestTask.new do |t|
   t.libs = ["lib"]
@@ -64,4 +65,3 @@ namespace :version do
     end
   end
 end
-

data/bin/spoonerize-web

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative "../lib/spoonerize/web/cli"
+
+Spoonerize::Web::Cli.execute(ARGV)

data/lib/spoonerize/cli.rb

@@ -7,10 +7,10 @@ module Spoonerize
   # The class for handling the command-line interface.
   class Cli
     ##
-    # The config file the user can create to change default runtime options.
+    # The config file the CLI loads before parsing runtime options.
     #
     # @return [String]
-    CONFIG_FILE = File.expand_path(File.join(ENV["HOME"], ".spoonerizerc"))
+    CONFIG_FILE = Spoonerize::CONFIG_FILE
 
     ##
     # Creates an instance of +Spoonerism+ and runs what the user requested.
@@ -40,10 +40,10 @@ module Spoonerize
     attr_reader :options
 
     ##
-    # Preferences after reading config file and parsing ARGV.
+    # Overrides after reading config file and parsing ARGV.
     #
-    # @return [Array]
-    attr_reader :preferences
+    # @return [Hash]
+    attr_reader :overrides
 
     ##
     # Create instance of +Cli+
@@ -57,7 +57,7 @@ module Spoonerize
       @save = false
       @print_log = false
       @options = options
-      @preferences = get_preferences
+      @overrides = get_overrides
     end
 
     ##
@@ -65,7 +65,7 @@ module Spoonerize
     #
     # @return [Spoonerize::Spoonerism]
     def spoonerism
-      @spoonerism ||= Spoonerism.new(options)
+      @spoonerism ||= Spoonerism.new(*options, **overrides)
     end
 
     ##
@@ -124,15 +124,18 @@ module Spoonerize
 
     ##
     # Read in args and set options
-    def get_preferences # :nodoc:
+    def get_overrides # :nodoc:
       {}.tap do |prefs|
         OptionParser.new do |o|
           o.version = ::Spoonerize::Version.to_s
           o.on("-r", "--[no-]reverse", "Reverse flipping") do |v|
-            Spoonerize.config.reverse = v
+            prefs[:reverse] = v
           end
-          o.on("-l", "--[no-]lazy", "Skip small words") do |v|
-            Spoonerize.config.lazy = v
+          o.on("-l", "--[no-]lazy", "Skip common words") do |v|
+            prefs[:lazy] = v
+          end
+          o.on("-c", "--[no-]consonants-only", "Only flip consonant-starting words") do |v|
+            prefs[:consonants_only] = v
           end
           o.on("-m", "--[no-]map", "Print words mapping") do |v|
             @map = v
@@ -144,7 +147,7 @@ module Spoonerize
             @save = v
           end
           o.on("--exclude=WORD", Array, "Words to skip") do |v|
-            Spoonerize.config.excluded_words = v
+            prefs[:excluded_words] = v
           end
         end.parse!(options)
       end

data/lib/spoonerize/config.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module Spoonerize
+  ##
+  # Runtime options used by the CLI and Spoonerism instances.
   class Config
     ##
     # Lazy mode. If true, words in +lazy_words+ will not be altered.
@@ -20,6 +22,12 @@ module Spoonerize
     # @return [Array]
     attr_accessor :excluded_words
 
+    ##
+    # When true, only consonant-starting words are eligible to be flipped.
+    #
+    # @return [Boolean]
+    attr_accessor :consonants_only
+
     ##
     # When true, reverse the order of the flipping. Only makes a difference
     # when there are more than two flip-able words.
@@ -41,10 +49,36 @@ module Spoonerize
       @lazy = false
       @lazy_words = %w[i a an and in of the my your his her him hers to is]
       @excluded_words = []
+      @consonants_only = false
       @reverse = false
       @logfile_name = File.expand_path(
         File.join(ENV["HOME"], ".cache", "spoonerize", "spoonerize.csv")
       )
     end
+
+    ##
+    # Create a copy of the current config with optional overrides.
+    #
+    # @return [Spoonerize::Config]
+    def with(**overrides)
+      self.class.new.tap do |config|
+        config.lazy = lazy
+        config.lazy_words = lazy_words.dup
+        config.excluded_words = excluded_words.dup
+        config.consonants_only = consonants_only
+        config.reverse = reverse
+        config.logfile_name = logfile_name
+
+        overrides.each do |key, value|
+          config.public_send(:"#{key}=", copy_value(value))
+        end
+      end
+    end
+
+    private
+
+    def copy_value(value)
+      value.is_a?(Array) ? value.dup : value
+    end
   end
 end

data/lib/spoonerize/spoonerism.rb

@@ -4,20 +4,69 @@ module Spoonerize
   ##
   # The main word-flipper.
   class Spoonerism
+    ##
+    # Letters that always represent vowel sounds.
+    #
+    # @return [String]
+    VOWEL_LETTERS = "aeio"
+
+    ##
+    # Letters that always represent consonant sounds.
+    #
+    # @return [String]
+    CONSONANT_LETTERS = "bcdfghjklmnprstvwxz"
+
+    ##
+    # Letters that make an initial "y" act like a vowel sound.
+    #
+    # @return [String]
+    Y_FOLLOWING_CONSONANTS = "bcdfghjklmnpqrstvwxz"
+
     ##
     # The words originally passed at initialization.
     #
     # @return [Array]
     attr_reader :words
 
+    ##
+    # Configuration values for this spoonerism.
+    #
+    # @return [Spoonerize::Config]
+    attr_reader :config
+
     ##
     # Initialize instance.
     #
-    # @param [Array] words
+    # @param [Array<String>] words Words to spoonerize. Passing a single array
+    #   is deprecated and will be removed in Spoonerize 1.0.
+    # @param [Spoonerize::Config] config Base config to copy.
+    # @param [Boolean, nil] lazy Override lazy mode for this instance.
+    # @param [Array<String>, nil] lazy_words Override lazy words for this instance.
+    # @param [Array<String>, nil] excluded_words Override excluded words for this instance.
+    # @param [Boolean, nil] consonants_only Override consonants-only mode for this instance.
+    # @param [Boolean, nil] reverse Override reverse mode for this instance.
+    # @param [String, nil] logfile_name Override the log file path for this instance.
     #
     # @return [Spoonerize::Spoonerism]
-    def initialize(words)
-      @words = words.map(&:downcase)
+    def initialize(
+      *words,
+      config: Spoonerize.config,
+      lazy: nil,
+      lazy_words: nil,
+      excluded_words: nil,
+      consonants_only: nil,
+      reverse: nil,
+      logfile_name: nil
+    )
+      @words = normalize_words(words).map(&:downcase)
+      @config = config.with(**{
+        lazy: lazy,
+        lazy_words: lazy_words,
+        excluded_words: excluded_words,
+        consonants_only: consonants_only,
+        reverse: reverse,
+        logfile_name: logfile_name
+      }.reject { |_, value| value.nil? })
     end
 
     ##
@@ -60,7 +109,7 @@ module Spoonerize
     #
     # @return [Boolean]
     def enough_flippable_words?
-      (words - all_excluded_words).size > 1
+      words.each_index.count { |index| flippable?(index) } > 1
     end
 
     ##
@@ -73,27 +122,44 @@ module Spoonerize
 
     ##
     # Array of words to exclude by combining two arrays:
-    # * Any user-passed words, stored in +Spoonerize.config.excluded_words+
+    # * Any user-passed words, stored in +config.excluded_words+
     # * Any lazy words, if lazy mode is true
     #
     # @return [Array]
     def all_excluded_words
-      (Spoonerize.config.excluded_words + (
-        Spoonerize.config.lazy ? Spoonerize.config.lazy_words : []
+      (config.excluded_words + (
+        config.lazy ? config.lazy_words : []
       )).map(&:downcase)
     end
 
     private
 
+    def normalize_words(words)
+      if words.size == 1 && words.first.is_a?(Array)
+        warn(
+          "Passing words as an array is deprecated and will be removed in Spoonerize 1.0. " \
+          "Pass words as positional arguments instead."
+        )
+        words = words.first
+      end
+
+      unless words.all? { |word| word.is_a?(String) }
+        raise ArgumentError, "Words must be strings"
+      end
+
+      words
+    end
+
     ##
     # Main flipping method. Creates the replacement word from the next
-    # non-excluded word's leading syllables, and the current word's first vowels
-    # through the end of the word.
+    # non-excluded word's leading consonants, and the current word's first
+    # vowel sound through the end of the word.
     def flip_words(word, idx) # :nodoc:
-      return word if excluded?(idx)
-      bumper = Bumper.new(idx, words.size, Spoonerize.config.reverse)
-      bumper.bump while excluded?(bumper.value)
-      words[bumper.value].match(consonants).to_s + word.match(vowels).to_s
+      return word unless flippable?(idx)
+
+      bumper = Bumper.new(idx, words.size, config.reverse)
+      bumper.bump until flippable?(bumper.value)
+      leading_consonants(words[bumper.value]) + retained_suffix(word)
     end
 
     ##
@@ -103,31 +169,94 @@ module Spoonerize
     end
 
     ##
-    # Returns regex to match first vowels through the rest of the word
-    def vowels # :nodoc:
-      /((?<!q)u|[aeio]|(?<=[bcdfghjklmnprstvwxz])y).*$/
+    # Returns true if word[index] can participate in a spoonerism.
+    def flippable?(index) # :nodoc:
+      return false if excluded?(index)
+
+      !config.consonants_only || consonant_sound_start?(words[index])
+    end
+
+    ##
+    # Returns true when a word starts with a consonant sound.
+    def consonant_sound_start?(word) # :nodoc:
+      return false if word.empty?
+
+      !vowel_sound_at?(word, 0)
+    end
+
+    ##
+    # Returns the consonant group a word contributes to another word.
+    def leading_consonants(word) # :nodoc:
+      return "qu" if word.start_with?("qu")
+      return "y" if initial_y_consonant?(word)
+
+      index = word.length.times.find do |letter_index|
+        !CONSONANT_LETTERS.include?(word[letter_index])
+      end
+
+      index ? word[0...index] : word
+    end
+
+    ##
+    # Returns the part of a word kept after dropping its leading consonants.
+    def retained_suffix(word) # :nodoc:
+      index = first_vowel_sound_index(word)
+
+      index ? word[index..] : ""
+    end
+
+    ##
+    # Returns the first index where a word starts sounding vowel-like.
+    def first_vowel_sound_index(word) # :nodoc:
+      word.length.times.find { |index| vowel_sound_at?(word, index) }
+    end
+
+    ##
+    # Returns true when the letter at index starts a vowel sound.
+    def vowel_sound_at?(word, index) # :nodoc:
+      letter = word[index]
+
+      VOWEL_LETTERS.include?(letter) ||
+        (letter == "u" && word[index - 1] != "q") ||
+        y_vowel_sound_at?(word, index)
+    end
+
+    ##
+    # Initial y is vowel-like before a consonant; later y is vowel-like after a
+    # consonant.
+    def y_vowel_sound_at?(word, index) # :nodoc:
+      return false unless word[index] == "y"
+
+      if index.zero?
+        next_letter = word[index + 1]
+
+        next_letter && Y_FOLLOWING_CONSONANTS.include?(next_letter)
+      else
+        CONSONANT_LETTERS.include?(word[index - 1])
+      end
     end
 
     ##
-    # Returns regex to match leading consonants
-    def consonants # :nodoc:
-      /^(y|[bcdfghjklmnprstvwxz]+|qu)/
+    # Initial y is consonant-like by itself or before a vowel sound.
+    def initial_y_consonant?(word) # :nodoc:
+      word == "y" || (word.start_with?("y") && vowel_sound_at?(word, 1))
     end
 
     ##
     # Creates and memoizes instance of the log file.
     def log # :nodoc:
-      @log ||= Spoonerize::Log.new(Spoonerize.config.logfile_name)
+      @log ||= Spoonerize::Log.new(config.logfile_name)
     end
 
     ##
     # The options that were passed at runtime as a string
     def options # :nodoc:
       [].tap do |o|
-        o << "Lazy" if Spoonerize.config.lazy
-        o << "Reverse" if Spoonerize.config.reverse
-        if Spoonerize.config.excluded_words.any?
-          o << "Exclude [#{Spoonerize.config.excluded_words.join(", ")}]"
+        o << "Lazy" if config.lazy
+        o << "Consonants Only" if config.consonants_only
+        o << "Reverse" if config.reverse
+        if config.excluded_words.any?
+          o << "Exclude [#{config.excluded_words.join(", ")}]"
         end
         o << "No Options" if o.empty?
       end

data/lib/spoonerize/version.rb

@@ -9,13 +9,13 @@ module Spoonerize
     # Major version.
     #
     # @return [Integer]
-    MAJOR = 0
+    MAJOR = 2
 
     ##
     # Minor version.
     #
     # @return [Integer]
-    MINOR = 2
+    MINOR = 0
 
     ##
     # Patch version.

data/lib/spoonerize/web/cli.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+require_relative "../web"
+
+module Spoonerize
+  class Web
+    ##
+    # Command-line launcher for the web app.
+    class Cli
+      ##
+      # Server options used when no command-line overrides are passed.
+      #
+      # @return [Hash]
+      DEFAULT_OPTIONS = {
+        host: Web.bind,
+        port: Web.port
+      }.freeze
+
+      ##
+      # Starts the web app from command-line arguments.
+      #
+      # @param [Array] options
+      #
+      # @return [nil]
+      def self.execute(options = [])
+        new(options).execute
+      end
+
+      ##
+      # Parsed server options.
+      #
+      # @return [Hash]
+      attr_reader :options
+
+      ##
+      # Create a web CLI launcher.
+      #
+      # @param [Array] options Command-line arguments.
+      #
+      # @return [self]
+      def initialize(options)
+        @options = DEFAULT_OPTIONS.merge(parse(options))
+      end
+
+      ##
+      # Starts the Sinatra web app.
+      #
+      # @return [nil]
+      def execute
+        Web.run!(bind: options[:host], port: options[:port])
+      end
+
+      private
+
+      def parse(options)
+        {}.tap do |prefs|
+          OptionParser.new do |o|
+            o.version = ::Spoonerize::Version.to_s
+            o.on("--host=HOST", "Host to bind") do |value|
+              prefs[:host] = value
+            end
+            o.on("--port=PORT", Integer, "Port to bind") do |value|
+              prefs[:port] = value
+            end
+          end.parse!(options)
+        end
+      end
+    end
+  end
+end

data/lib/spoonerize/web/public/styles.css

@@ -0,0 +1,178 @@
+:root {
+  color-scheme: light;
+  --bg: #f7f7f4;
+  --ink: #24211f;
+  --muted: #6c655f;
+  --line: #d7d2c9;
+  --panel: #fffdfa;
+  --accent: #1d6f78;
+  --accent-dark: #145059;
+  --notice-bg: #fff0dc;
+  --notice-line: #e1a853;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background: var(--bg);
+  color: var(--ink);
+  font-family: ui-serif, Georgia, "Times New Roman", serif;
+  line-height: 1.5;
+}
+
+.page {
+  min-height: 100vh;
+  display: grid;
+  place-items: start center;
+  padding: 4rem 1rem;
+}
+
+.shell {
+  width: min(100%, 46rem);
+}
+
+.masthead {
+  margin-bottom: 2rem;
+  border-bottom: 1px solid var(--line);
+  padding-bottom: 1.25rem;
+}
+
+h1 {
+  margin: 0;
+  font-size: clamp(2.2rem, 7vw, 4rem);
+  line-height: 1;
+}
+
+.result {
+  margin: 0 0 1.75rem;
+  font-size: clamp(2rem, 6vw, 3.6rem);
+  font-weight: 800;
+  line-height: 1.05;
+}
+
+.notice {
+  margin: 0 0 1.5rem;
+  border: 1px solid var(--notice-line);
+  background: var(--notice-bg);
+  padding: 0.8rem 1rem;
+  font-family: ui-sans-serif, system-ui, sans-serif;
+  font-weight: 650;
+}
+
+.spoonerize-form {
+  display: grid;
+  gap: 1rem;
+}
+
+.field,
+fieldset {
+  display: grid;
+  gap: 0.45rem;
+}
+
+.field span,
+legend {
+  color: var(--muted);
+  font-family: ui-sans-serif, system-ui, sans-serif;
+  font-size: 0.85rem;
+  font-weight: 700;
+}
+
+input[type="text"] {
+  width: 100%;
+  border: 1px solid var(--line);
+  border-radius: 4px;
+  background: var(--panel);
+  color: var(--ink);
+  font: inherit;
+  font-size: 1.1rem;
+  padding: 0.75rem 0.85rem;
+}
+
+input[type="text"]:focus {
+  border-color: var(--accent);
+  outline: 3px solid color-mix(in srgb, var(--accent) 22%, transparent);
+}
+
+fieldset {
+  margin: 0;
+  border: 1px solid var(--line);
+  border-radius: 4px;
+  background: var(--panel);
+  padding: 0.9rem 1rem 1rem;
+}
+
+legend {
+  padding: 0 0.35rem;
+}
+
+.check {
+  display: flex;
+  align-items: center;
+  gap: 0.55rem;
+  font-family: ui-sans-serif, system-ui, sans-serif;
+}
+
+.check input {
+  width: 1rem;
+  height: 1rem;
+  accent-color: var(--accent);
+}
+
+button {
+  width: fit-content;
+  border: 0;
+  border-radius: 4px;
+  background: var(--accent);
+  color: #fff;
+  cursor: pointer;
+  font-family: ui-sans-serif, system-ui, sans-serif;
+  font-size: 1rem;
+  font-weight: 750;
+  padding: 0.72rem 1rem;
+}
+
+button:hover,
+button:focus {
+  background: var(--accent-dark);
+}
+
+.footer {
+  width: min(100%, 46rem);
+  margin-top: 2.5rem;
+  border-top: 1px solid var(--line);
+  padding-top: 1rem;
+  color: var(--muted);
+  font-family: ui-sans-serif, system-ui, sans-serif;
+  font-size: 0.82rem;
+}
+
+.footer a {
+  color: inherit;
+  text-decoration-color: color-mix(in srgb, var(--muted) 45%, transparent);
+  text-underline-offset: 0.16em;
+}
+
+.footer a:hover,
+.footer a:focus {
+  color: var(--accent-dark);
+  text-decoration-color: currentcolor;
+}
+
+.footer span {
+  margin: 0 0.35rem;
+}
+
+@media (max-width: 40rem) {
+  .page {
+    padding-top: 2rem;
+  }
+
+  button {
+    width: 100%;
+  }
+}

data/lib/spoonerize/web/views/index.erb

@@ -0,0 +1,61 @@
+<section class="shell">
+  <header class="masthead">
+    <h1>Flip a phrase</h1>
+  </header>
+
+  <% if @result %>
+    <p class="result"><%= h @result %></p>
+    <% if @saved %>
+      <p class="notice">Saved.</p>
+    <% end %>
+  <% elsif @error %>
+    <p class="notice"><%= h @error %></p>
+  <% end %>
+
+  <form action="/" method="post" class="spoonerize-form">
+    <label class="field">
+      <span>Phrase</span>
+      <input
+        type="text"
+        name="phrase"
+        value="<%= h @phrase %>"
+        placeholder="Enter phrase to spoonerize..."
+        autofocus>
+    </label>
+
+    <fieldset>
+      <legend>Options</legend>
+
+      <label class="check">
+        <input type="checkbox" name="reverse" value="1" <%= checked?("reverse") %>>
+        <span>Reverse flipping</span>
+      </label>
+
+      <label class="check">
+        <input type="checkbox" name="lazy" value="1" <%= checked?("lazy") %>>
+        <span>Skip common words</span>
+      </label>
+
+      <label class="check">
+        <input type="checkbox" name="consonants_only" value="1" <%= checked?("consonants_only") %>>
+        <span>Only flip consonant-starting words</span>
+      </label>
+
+      <label class="check">
+        <input type="checkbox" name="save" value="1" <%= @save ? "checked" : nil %>>
+        <span>Save result</span>
+      </label>
+    </fieldset>
+
+    <label class="field">
+      <span>Excluded words</span>
+      <input
+        type="text"
+        name="excluded_words"
+        value="<%= h @excluded_words_value %>"
+        placeholder="word another">
+    </label>
+
+    <button type="submit">Spoonerize</button>
+  </form>
+</section>

data/lib/spoonerize/web/views/layout.erb

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>Spoonerize</title>
+    <link rel="stylesheet" href="/styles.css">
+  </head>
+  <body>
+    <main class="page">
+      <%= yield %>
+
+      <footer class="footer">
+        <a href="https://github.com/evanthegrayt">evanthegrayt</a>
+        <span>/</span>
+        <a href="https://github.com/evanthegrayt/spoonerize">spoonerize</a>
+      </footer>
+    </main>
+  </body>
+</html>

data/lib/spoonerize/web.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require "sinatra/base"
+
+require_relative "../spoonerize"
+
+module Spoonerize
+  ##
+  # Sinatra app for spoonerizing phrases in the browser.
+  class Web < Sinatra::Base
+    ##
+    # Boolean Spoonerism options exposed by the web form.
+    #
+    # @return [Array<String>]
+    OPTION_NAMES = %w[reverse lazy consonants_only].freeze
+
+    set :root, File.expand_path(File.join(__dir__, "..", ".."))
+    set :public_folder, File.expand_path(File.join(__dir__, "web", "public"))
+    set :views, File.expand_path(File.join(__dir__, "web", "views"))
+    set :static, true
+    set :show_exceptions, false
+
+    configure do
+      Spoonerize.load_config_file(Spoonerize::CONFIG_FILE) if File.file?(Spoonerize::CONFIG_FILE)
+    end
+
+    helpers do
+      ##
+      # HTML checkbox attribute for a truthy option value.
+      #
+      # @param [String] name The option name.
+      #
+      # @return [String, nil]
+      def checked?(name)
+        option_value(name) ? "checked" : nil
+      end
+
+      ##
+      # Current boolean value for a web form option.
+      #
+      # @param [String] name The option name.
+      #
+      # @return [Boolean]
+      def option_value(name)
+        @options.fetch(name.to_sym)
+      end
+
+      ##
+      # Escapes a value for safe HTML output.
+      #
+      # @param [Object] value The value to escape.
+      #
+      # @return [String]
+      def h(value)
+        Rack::Utils.escape_html(value)
+      end
+    end
+
+    get "/" do
+      prepare_request(false)
+      erb :index
+    end
+
+    post "/" do
+      prepare_request(true)
+      @result = spoonerize_phrase if @submitted && !@phrase.strip.empty?
+
+      erb :index
+    end
+
+    private
+
+    def options_from_params
+      OPTION_NAMES.to_h do |name|
+        value = @submitted ? params.key?(name) : Spoonerize.config.public_send(name)
+        [name.to_sym, value]
+      end
+    end
+
+    def excluded_words_from(value)
+      value.split(/[,\s]+/).reject(&:empty?)
+    end
+
+    def excluded_words_from_params
+      return excluded_words_from(params["excluded_words"].to_s) if @submitted
+
+      Spoonerize.config.excluded_words
+    end
+
+    def prepare_request(submitted)
+      @submitted = submitted
+      @phrase = params["phrase"].to_s
+      @options = options_from_params
+      @excluded_words = excluded_words_from_params
+      @excluded_words_value = @excluded_words.join(" ")
+      @save = @submitted && params.key?("save")
+    end
+
+    def spoonerize_phrase
+      spoonerism = Spoonerism.new(
+        *@phrase.split,
+        **@options,
+        excluded_words: @excluded_words
+      )
+      result = spoonerism.to_s
+      spoonerism.save if @save
+      @saved = @save
+
+      result
+    rescue => error
+      @error = friendly_error(error)
+      nil
+    end
+
+    def friendly_error(error)
+      return "Not enough words to flip." if error.message == "Not enough words to flip"
+
+      error.message
+    end
+  end
+end

data/lib/spoonerize.rb

@@ -1,5 +1,15 @@
 # frozen_string_literal: true
 
+##
+# The main namespace for the gem.
+module Spoonerize
+  ##
+  # The config file the user can create to change default runtime options.
+  #
+  # @return [String]
+  CONFIG_FILE = File.expand_path(File.join(ENV["HOME"], ".spoonerizerc"))
+end
+
 require_relative "spoonerize/config"
 require_relative "spoonerize/spoonerism"
 require_relative "spoonerize/bumper"
@@ -53,7 +63,7 @@ module Spoonerize
   ##
   # Loads a config file.
   #
-  # @param [String] file
+  # @param [String] config_file
   #
   # @return [String] file
   def load_config_file(config_file)

data/spoonerize.gemspec

@@ -10,6 +10,7 @@ Gem::Specification.new do |spec|
   spec.summary = %(Spoonerize phrases from the command line.)
   spec.description = %(Spoonerize phrases from the command line. Comes with an API)
   spec.homepage = "https://evanthegrayt.github.io/spoonerize/"
+  spec.required_ruby_version = ">= 3.2"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
   # to allow pushing to a single host or delete this section to allow pushing to any host.
@@ -29,7 +30,11 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
   spec.add_dependency "csv"
+  spec.add_dependency "puma", "~> 8.0"
+  spec.add_dependency "rackup", "~> 2.3"
+  spec.add_dependency "sinatra", "~> 4.2"
   spec.add_development_dependency "rdoc"
   spec.add_development_dependency "rake", "~> 13.0", ">= 13.0.1"
+  spec.add_development_dependency "standard", "= 1.54.0"
   spec.add_development_dependency "test-unit", "~> 3.3", ">= 3.3.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spoonerize
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Evan Gray
@@ -23,6 +23,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: puma
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: rackup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -57,6 +99,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 13.0.1
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.54.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 1.54.0
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -81,6 +137,7 @@ description: Spoonerize phrases from the command line. Comes with an API
 email: evanthegrayt@vivaldi.net
 executables:
 - spoonerize
+- spoonerize-web
 extensions: []
 extra_rdoc_files: []
 files:
@@ -93,6 +150,7 @@ files:
 - Rakefile
 - _config.yml
 - bin/spoonerize
+- bin/spoonerize-web
 - lib/spoonerize.rb
 - lib/spoonerize/bumper.rb
 - lib/spoonerize/cli.rb
@@ -100,6 +158,11 @@ files:
 - lib/spoonerize/log.rb
 - lib/spoonerize/spoonerism.rb
 - lib/spoonerize/version.rb
+- lib/spoonerize/web.rb
+- lib/spoonerize/web/cli.rb
+- lib/spoonerize/web/public/styles.css
+- lib/spoonerize/web/views/index.erb
+- lib/spoonerize/web/views/layout.erb
 - spoonerize.gemspec
 homepage: https://evanthegrayt.github.io/spoonerize/
 licenses:
@@ -116,7 +179,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="