turbo_luxury_stain_guide 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 212cc769eeff72807d086f8ea0b43246c7daaba5e0dfe2d665ab48876feb5a8c
+  data.tar.gz: cc4784b2dbb84776af1e60ac2c3a42ff3f032ba6cdc4a17b1e5ecfadbbe775f2
+SHA512:
+  metadata.gz: f142f762c0e3914e9d1c7d8229f83fc130f9eed9b64da29c2454043a602ceb58e0b557303b29b38b657531980e26ff7d4f81d81fa251b0fb890f917918d4aea0
+  data.tar.gz: 75388226da6e2cdbf3c6c6fa08efe95de86c458cb58f2c2b981b78ccde5892fa4477df414ba31fd739702134ef6a3ebf1fa8b94d8a8b55e5cd5e800dd4b273da

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Turbo Luxury Car Wash
+
+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,67 @@
+# turbo_luxury_stain_guide
+
+Step-by-step first aid for car interior stains. Give it a stain (coffee, grease, ink, blood or vomit,
+pet accident, mud, chocolate, dye transfer) and the surface (fabric, leather, vinyl, plastic, carpet),
+and it returns the supplies, the steps in order, what to avoid, how urgent it is and whether the job is
+better left to a professional. Pure Ruby, no dependencies, with a command-line tool.
+
+Maintained by Turbo Luxury Car Wash, the team behind [car interior cleaning Abu Dhabi](https://turboluxurycarwash.ae/services/car-interior-cleaning-abu-dhabi/) with mobile service at the customer's location.
+
+## Install
+
+```sh
+gem install turbo_luxury_stain_guide
+```
+
+## Library
+
+```ruby
+require "turbo_luxury_stain_guide"
+
+advice = TurboLuxuryStainGuide.advise("latte", "leather")   # aliases work
+advice.urgency        # => "high"
+advice.steps          # ordered steps
+advice.avoid          # what not to do
+advice.surface_note   # leather-specific note
+advice.professional   # => false
+puts advice
+```
+
+Unknown stains or surfaces raise `TurboLuxuryStainGuide::Error` with the valid choices.
+
+## CLI
+
+```sh
+turbo-luxury-stain-guide advise coffee leather
+turbo-luxury-stain-guide list
+```
+
+Example output:
+
+```
+Coffee, tea and sugary drinks on leather seat (act straight away)
+
+You need: microfibre cloths, cool water, mild upholstery cleaner
+
+1. Blot (never rub) to lift as much liquid as possible.
+2. Dab with a cloth dampened in cool water, working from the edge toward the centre.
+3. Apply a mild upholstery cleaner, agitate gently and blot again.
+4. Rinse with a barely damp cloth to remove cleaner residue, then dry.
+Note for leather: Use a pH-neutral leather cleaner instead of general upholstery cleaner, then condition once dry.
+
+Avoid: Hot water, which can set tannins
+Avoid: Rubbing, which spreads the stain into the fibres
+```
+
+The advice is general guidance. Always test a cleaner on a hidden spot first, and use a professional
+for old, large or colour-lifting stains.
+
+## Tests
+
+```sh
+ruby test/stain_guide_test.rb
+```
+
+## Licence
+
+MIT

data/exe/turbo-luxury-stain-guide

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+require "turbo_luxury_stain_guide"
+
+HELP = <<~TXT
+  turbo-luxury-stain-guide - car interior stain first aid
+
+  Usage:
+    turbo-luxury-stain-guide advise STAIN [SURFACE]   (SURFACE defaults to fabric)
+    turbo-luxury-stain-guide list
+TXT
+
+args = ARGV.dup
+case args.first
+when "list"
+  puts "Stains:   #{TurboLuxuryStainGuide.stains.join(', ')}"
+  puts "Surfaces: #{TurboLuxuryStainGuide.surfaces.join(', ')}"
+when "advise"
+  if args[1].nil?
+    warn "advise needs a stain name"
+    exit 2
+  end
+  begin
+    puts TurboLuxuryStainGuide.advise(args[1], args[2] || "fabric")
+  rescue TurboLuxuryStainGuide::Error => e
+    warn e.message
+    exit 2
+  end
+when nil, "-h", "--help"
+  puts HELP
+  exit(args.empty? ? 1 : 0)
+else
+  warn "unknown command #{args.first.inspect}"
+  warn HELP
+  exit 2
+end

data/lib/turbo_luxury_stain_guide/advisor.rb

@@ -0,0 +1,46 @@
+module TurboLuxuryStainGuide
+  # Combines the stain data with surface-specific notes.
+  module Advisor
+    Advice = Struct.new(:stain, :stain_name, :surface, :surface_name, :urgency, :supplies, :steps, :avoid,
+                        :surface_note, :professional, keyword_init: true) do
+      def to_s
+        lines = ["#{stain_name} on #{surface_name.downcase} (act #{urgency_phrase})", ""]
+        lines << "You need: #{supplies.join(', ')}"
+        lines << ""
+        steps.each_with_index { |s, i| lines << "#{i + 1}. #{s}" }
+        lines << "Note for #{surface}: #{surface_note}" if surface_note
+        lines << ""
+        avoid.each { |a| lines << "Avoid: #{a}" }
+        lines << "If it is old, large or the colour is lifting from the seat itself, a professional clean is the safe choice." if professional
+        lines.join("\n")
+      end
+
+      private
+
+      def urgency_phrase
+        { "high" => "straight away", "medium" => "within the hour", "low" => "when dry" }.fetch(urgency, urgency)
+      end
+    end
+
+    module_function
+
+    def resolve(aliases, table, name)
+      key = name.to_s.strip.downcase
+      return key if table.key?(key)
+      aliases[key]
+    end
+
+    def advise(stain, surface)
+      stain_id = TurboLuxuryStainGuide.resolve_stain(stain)
+      raise TurboLuxuryStainGuide::Error, "Unknown stain #{stain.inspect}. Try: #{Data::STAINS.keys.join(', ')}" unless stain_id
+      surface_id = TurboLuxuryStainGuide.resolve_surface(surface)
+      raise TurboLuxuryStainGuide::Error, "Unknown surface #{surface.inspect}. Try: #{Data::SURFACES.keys.join(', ')}" unless surface_id
+      s = Data::STAINS.fetch(stain_id)
+      Advice.new(
+        stain: stain_id, stain_name: s[:name], surface: surface_id, surface_name: Data::SURFACES.fetch(surface_id),
+        urgency: s[:urgency], supplies: s[:supplies], steps: s[:steps], avoid: s[:avoid],
+        surface_note: s[:surface_notes][surface_id], professional: s[:professional]
+      )
+    end
+  end
+end

data/lib/turbo_luxury_stain_guide/data.rb

@@ -0,0 +1,143 @@
+module TurboLuxuryStainGuide
+  module Data
+    SURFACES = {
+      "fabric" => "Fabric seat or headliner",
+      "leather" => "Leather seat",
+      "vinyl" => "Vinyl or synthetic leather",
+      "plastic" => "Hard plastic trim or dashboard",
+      "carpet" => "Carpet or floor mat"
+    }.freeze
+
+    SURFACE_ALIASES = {
+      "cloth" => "fabric", "upholstery" => "fabric", "seat" => "fabric", "headliner" => "fabric",
+      "leatherette" => "vinyl", "pu" => "vinyl", "synthetic" => "vinyl",
+      "trim" => "plastic", "dashboard" => "plastic", "dash" => "plastic", "door panel" => "plastic",
+      "mat" => "carpet", "floor" => "carpet", "floor mat" => "carpet", "rug" => "carpet"
+    }.freeze
+
+    # urgency: how quickly to act. method: base technique; surface_notes: overrides per surface.
+    STAINS = {
+      "coffee" => {
+        name: "Coffee, tea and sugary drinks", urgency: "high",
+        supplies: ["microfibre cloths", "cool water", "mild upholstery cleaner"],
+        steps: ["Blot (never rub) to lift as much liquid as possible.",
+                "Dab with a cloth dampened in cool water, working from the edge toward the centre.",
+                "Apply a mild upholstery cleaner, agitate gently and blot again.",
+                "Rinse with a barely damp cloth to remove cleaner residue, then dry."],
+        avoid: ["Hot water, which can set tannins", "Rubbing, which spreads the stain into the fibres"],
+        surface_notes: {
+          "leather" => "Use a pH-neutral leather cleaner instead of general upholstery cleaner, then condition once dry.",
+          "carpet" => "Blot with a thick pad of paper towel pressed down firmly before cleaning.",
+          "plastic" => "Wipe with a damp cloth; sugary residue is sticky, so follow with a dry cloth."
+        },
+        professional: false
+      },
+      "grease" => {
+        name: "Grease, oil, sunscreen and food fat", urgency: "medium",
+        supplies: ["paper towels", "cornstarch or baking soda", "soft brush", "vacuum", "upholstery cleaner"],
+        steps: ["Blot off any surface oil without pressing it deeper.",
+                "Cover with cornstarch or baking soda and leave for 15 to 30 minutes to absorb the oil.",
+                "Vacuum the powder, repeat if the spot is still dark.",
+                "Treat what remains with upholstery cleaner and blot dry."],
+        avoid: ["Water first: it spreads oil and makes it harder to lift"],
+        surface_notes: {
+          "leather" => "Wipe gently, absorb with powder, then clean with leather cleaner and condition. Do not scrub.",
+          "plastic" => "Wipe with a diluted interior cleaner; sunscreen film on trim usually needs two passes."
+        },
+        professional: false
+      },
+      "ink" => {
+        name: "Ink and pen marks", urgency: "high",
+        supplies: ["isopropyl alcohol", "cotton swabs", "white cloth"],
+        steps: ["Test the alcohol on a hidden spot first.",
+                "Dab (do not wipe) with a swab dampened with isopropyl alcohol, using a fresh swab as each one picks up ink.",
+                "Blot with a clean white cloth after each pass.",
+                "Finish with a damp cloth and dry."],
+        avoid: ["Wiping across the mark, which spreads ink", "Alcohol on unfinished or aniline leather"],
+        surface_notes: {
+          "leather" => "Ink on leather often needs a professional, especially on pale or aniline-dyed leather. Try a dedicated leather ink remover only after a hidden-spot test.",
+          "vinyl" => "A swab of isopropyl alcohol usually lifts ballpoint ink from vinyl in a few passes."
+        },
+        professional: true
+      },
+      "blood" => {
+        name: "Blood, vomit, milk and other protein stains", urgency: "high",
+        supplies: ["cold water", "microfibre cloths", "enzyme cleaner", "mild soap"],
+        steps: ["Blot up solids and liquid first; scrape solids with a card edge.",
+                "Dab with cold water only, working inward.",
+                "Apply an enzyme cleaner, leave for the time on the label, then blot.",
+                "Rinse with a barely damp cloth and dry with the doors open to remove odour."],
+        avoid: ["Hot water or steam, which cook proteins into the fibres", "Heavy soaking of seat foam"],
+        surface_notes: {
+          "leather" => "Wipe with a cloth dampened in cool water and a drop of mild soap, then leather cleaner. Skip enzyme sprays on untreated leather.",
+          "carpet" => "Use extra enzyme cleaner and blot repeatedly: carpet padding holds odour."
+        },
+        professional: false
+      },
+      "pet" => {
+        name: "Pet urine and accidents", urgency: "high",
+        supplies: ["paper towels", "enzyme cleaner for pet odour", "microfibre cloths", "fan or open doors"],
+        steps: ["Blot as much as possible with paper towels pressed down firmly.",
+                "Saturate the area lightly with enzyme cleaner so it reaches the same depth as the accident.",
+                "Leave it damp for the label time, then blot and let it air-dry fully with the doors open.",
+                "Repeat if the smell returns when the car warms up."],
+        avoid: ["Ammonia cleaners, which smell like urine to pets and encourage repeat marking",
+                "Steam, which can lock the odour in"],
+        surface_notes: {
+          "fabric" => "If it soaked into the foam, a professional hot-water extraction is the reliable fix.",
+          "leather" => "Clean the surface promptly and check the seams; liquid in the stitching leaves odour."
+        },
+        professional: true
+      },
+      "mud" => {
+        name: "Mud, sand and dirt", urgency: "low",
+        supplies: ["stiff brush", "vacuum", "upholstery cleaner", "microfibre cloths"],
+        steps: ["Let wet mud dry completely.",
+                "Crumble and brush it off, then vacuum thoroughly.",
+                "Treat any shadow left behind with upholstery cleaner and blot dry."],
+        avoid: ["Wiping wet mud, which grinds it into the fibres"],
+        surface_notes: {
+          "leather" => "Vacuum first so grit does not scratch the grain, then wipe with leather cleaner.",
+          "carpet" => "Beat or brush the mat outside, then vacuum slowly in two directions."
+        },
+        professional: false
+      },
+      "chocolate" => {
+        name: "Chocolate, melted sweets and gum", urgency: "medium",
+        supplies: ["ice cubes in a bag", "plastic card", "mild soap", "microfibre cloths"],
+        steps: ["Harden the residue with an ice bag for a few minutes.",
+                "Lift the solid with the edge of a card.",
+                "Clean the remaining mark with cool water and a drop of mild soap, then blot dry."],
+        avoid: ["Hot water or heat, which melts sugar deeper into the surface"],
+        surface_notes: {
+          "leather" => "Do not use ice directly on cold-sensitive leather for long; lift the residue gently and finish with leather cleaner."
+        },
+        professional: false
+      },
+      "dye" => {
+        name: "Red wine, juice, makeup and dye transfer", urgency: "high",
+        supplies: ["cool water", "microfibre cloths", "mild upholstery cleaner", "white vinegar (diluted)"],
+        steps: ["Blot immediately.",
+                "Dab with cool water, then a mild upholstery cleaner.",
+                "For fabric, try a half-and-half mix of white vinegar and water on a hidden spot first, then on the stain.",
+                "Rinse with a barely damp cloth and dry."],
+        avoid: ["Vinegar on leather or natural stone trim", "Letting the stain dry before treating it"],
+        surface_notes: {
+          "leather" => "Dye transfer from jeans or clothing needs a leather-specific cleaner; stop if colour lifts from the seat itself and call a professional."
+        },
+        professional: true
+      }
+    }.freeze
+
+    STAIN_ALIASES = {
+      "tea" => "coffee", "latte" => "coffee", "soda" => "coffee", "juice" => "dye", "cola" => "coffee",
+      "oil" => "grease", "sunscreen" => "grease", "butter" => "grease", "food" => "grease", "fat" => "grease",
+      "pen" => "ink", "marker" => "ink", "ballpoint" => "ink",
+      "vomit" => "blood", "milk" => "blood", "protein" => "blood",
+      "urine" => "pet", "dog" => "pet", "cat" => "pet", "accident" => "pet",
+      "dirt" => "mud", "sand" => "mud",
+      "sweets" => "chocolate", "candy" => "chocolate", "gum" => "chocolate",
+      "wine" => "dye", "red wine" => "dye", "makeup" => "dye", "denim" => "dye", "lipstick" => "dye"
+    }.freeze
+  end
+end

data/lib/turbo_luxury_stain_guide/version.rb

@@ -0,0 +1,3 @@
+module TurboLuxuryStainGuide
+  VERSION = "1.0.0"
+end

data/lib/turbo_luxury_stain_guide.rb

@@ -0,0 +1,35 @@
+require_relative "turbo_luxury_stain_guide/version"
+require_relative "turbo_luxury_stain_guide/data"
+require_relative "turbo_luxury_stain_guide/advisor"
+
+# First-aid advice for car interior stains.
+module TurboLuxuryStainGuide
+  class Error < StandardError; end
+
+  module_function
+
+  # Advice for a stain on a surface. Both are case-insensitive and aliases are accepted.
+  def advise(stain, surface = "fabric")
+    Advisor.advise(stain, surface)
+  end
+
+  # All stain ids.
+  def stains
+    Data::STAINS.keys
+  end
+
+  # All surface ids.
+  def surfaces
+    Data::SURFACES.keys
+  end
+
+  # Resolve an alias ("latte") to a stain id ("coffee"), or nil.
+  def resolve_stain(name)
+    Advisor.resolve(Data::STAIN_ALIASES, Data::STAINS, name)
+  end
+
+  # Resolve an alias ("seat leather") to a surface id, or nil.
+  def resolve_surface(name)
+    Advisor.resolve(Data::SURFACE_ALIASES, Data::SURFACES, name)
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: turbo_luxury_stain_guide
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Turbo Luxury Car Wash
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Look up how to treat coffee, grease, ink, blood, pet accidents, mud and
+  other stains on fabric, leather, vinyl, plastic or carpet in a car, with supplies,
+  what to avoid and when to call a professional.
+executables:
+- turbo-luxury-stain-guide
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- exe/turbo-luxury-stain-guide
+- lib/turbo_luxury_stain_guide.rb
+- lib/turbo_luxury_stain_guide/advisor.rb
+- lib/turbo_luxury_stain_guide/data.rb
+- lib/turbo_luxury_stain_guide/version.rb
+homepage: https://turboluxurycarwash.ae/services/car-interior-cleaning-abu-dhabi/
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://turboluxurycarwash.ae/services/car-interior-cleaning-abu-dhabi/
+  source_code_uri: https://github.com/nbkdevs/turbo-luxury/tree/main/packages/rubygems
+  bug_tracker_uri: https://github.com/nbkdevs/turbo-luxury/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.20
+specification_version: 4
+summary: Step-by-step first aid for car interior stains by stain type and seat surface.
+test_files: []