tldfyi 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6102be2980b72dbf92a9a5a3d1184b062e9c368d826a7c2c15d7922c6456b124
+  data.tar.gz: b9f37036ce1c2b1c24abd1d8db4115cd252e4e643ad2b87284516eb7dcc16a01
+SHA512:
+  metadata.gz: a46ade210a44dcf88df9290fe17a5383c733a4e117383bd479ca0e31d1ea55d12b5ba9fe717815aaaad6f9b03acb6c880292244dc633d59857099c1305a6c507
+  data.tar.gz: 922c27a73fb1e2ef4888dd633e29d31b64227aa9f4a41315b0b90065a8d7f775f73f9ca08e7ae708969307ee13069bbe09ce90977b299b9f3efa0af79e3b738b

data/lib/tldfyi.rb

@@ -0,0 +1,251 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+# Ruby client for TLDFYI REST API (tldfyi.com).
+#
+#   client = TLDFYI::Client.new
+#   result = client.search("query")
+#
+module TLDFYI
+  class Client
+    BASE_URL = "https://tldfyi.com"
+
+    def initialize(base_url: BASE_URL)
+      @base_url = base_url
+    end
+
+    def search(query)
+      get("/api/v1/rest/search/", q: query)
+    end
+
+    # List all brands.
+    def list_brands
+      get("/api/v1/rest/brands/")
+    end
+
+    # Get brand by slug.
+    def get_brand(slug)
+      get("/api/v1/rest/brands/#{slug}/")
+    end
+    # List all collections.
+    def list_collections
+      get("/api/v1/rest/collections/")
+    end
+
+    # Get collection by slug.
+    def get_collection(slug)
+      get("/api/v1/rest/collections/#{slug}/")
+    end
+    # List all comparisons.
+    def list_comparisons
+      get("/api/v1/rest/comparisons/")
+    end
+
+    # Get comparison by slug.
+    def get_comparison(slug)
+      get("/api/v1/rest/comparisons/#{slug}/")
+    end
+    # List all continents.
+    def list_continents
+      get("/api/v1/rest/continents/")
+    end
+
+    # Get continent by slug.
+    def get_continent(slug)
+      get("/api/v1/rest/continents/#{slug}/")
+    end
+    # List all countries.
+    def list_countries
+      get("/api/v1/rest/countries/")
+    end
+
+    # Get country by slug.
+    def get_country(slug)
+      get("/api/v1/rest/countries/#{slug}/")
+    end
+    # List all domain hacks.
+    def list_domain_hacks
+      get("/api/v1/rest/domain-hacks/")
+    end
+
+    # Get domain hack by slug.
+    def get_domain_hack(slug)
+      get("/api/v1/rest/domain-hacks/#{slug}/")
+    end
+    # List all faq categories.
+    def list_faq_categories
+      get("/api/v1/rest/faq-categories/")
+    end
+
+    # Get faq category by slug.
+    def get_faq_category(slug)
+      get("/api/v1/rest/faq-categories/#{slug}/")
+    end
+    # List all faq entries.
+    def list_faq_entries
+      get("/api/v1/rest/faq-entries/")
+    end
+
+    # Get faq entry by slug.
+    def get_faq_entry(slug)
+      get("/api/v1/rest/faq-entries/#{slug}/")
+    end
+    # List all faqs.
+    def list_faqs
+      get("/api/v1/rest/faqs/")
+    end
+
+    # Get faq by slug.
+    def get_faq(slug)
+      get("/api/v1/rest/faqs/#{slug}/")
+    end
+    # List all glossary categories.
+    def list_glossary_categories
+      get("/api/v1/rest/glossary-categories/")
+    end
+
+    # Get glossary category by slug.
+    def get_glossary_category(slug)
+      get("/api/v1/rest/glossary-categories/#{slug}/")
+    end
+    # List all glossary terms.
+    def list_glossary_terms
+      get("/api/v1/rest/glossary-terms/")
+    end
+
+    # Get glossary term by slug.
+    def get_glossary_term(slug)
+      get("/api/v1/rest/glossary-terms/#{slug}/")
+    end
+    # List all guide series.
+    def list_guide_series
+      get("/api/v1/rest/guide-series/")
+    end
+
+    # Get guide sery by slug.
+    def get_guide_sery(slug)
+      get("/api/v1/rest/guide-series/#{slug}/")
+    end
+    # List all guides.
+    def list_guides
+      get("/api/v1/rest/guides/")
+    end
+
+    # Get guide by slug.
+    def get_guide(slug)
+      get("/api/v1/rest/guides/#{slug}/")
+    end
+    # List all industries.
+    def list_industries
+      get("/api/v1/rest/industries/")
+    end
+
+    # Get industry by slug.
+    def get_industry(slug)
+      get("/api/v1/rest/industries/#{slug}/")
+    end
+    # List all pricing.
+    def list_pricing
+      get("/api/v1/rest/pricing/")
+    end
+
+    # Get pricing by slug.
+    def get_pricing(slug)
+      get("/api/v1/rest/pricing/#{slug}/")
+    end
+    # List all registrar comparisons.
+    def list_registrar_comparisons
+      get("/api/v1/rest/registrar-comparisons/")
+    end
+
+    # Get registrar comparison by slug.
+    def get_registrar_comparison(slug)
+      get("/api/v1/rest/registrar-comparisons/#{slug}/")
+    end
+    # List all registrars.
+    def list_registrars
+      get("/api/v1/rest/registrars/")
+    end
+
+    # Get registrar by slug.
+    def get_registrar(slug)
+      get("/api/v1/rest/registrars/#{slug}/")
+    end
+    # List all registries.
+    def list_registries
+      get("/api/v1/rest/registries/")
+    end
+
+    # Get registry by slug.
+    def get_registry(slug)
+      get("/api/v1/rest/registries/#{slug}/")
+    end
+    # List all stat snapshots.
+    def list_stat_snapshots
+      get("/api/v1/rest/stat-snapshots/")
+    end
+
+    # Get stat snapshot by slug.
+    def get_stat_snapshot(slug)
+      get("/api/v1/rest/stat-snapshots/#{slug}/")
+    end
+    # List all timeline eras.
+    def list_timeline_eras
+      get("/api/v1/rest/timeline-eras/")
+    end
+
+    # Get timeline era by slug.
+    def get_timeline_era(slug)
+      get("/api/v1/rest/timeline-eras/#{slug}/")
+    end
+    # List all timeline events.
+    def list_timeline_events
+      get("/api/v1/rest/timeline-events/")
+    end
+
+    # Get timeline event by slug.
+    def get_timeline_event(slug)
+      get("/api/v1/rest/timeline-events/#{slug}/")
+    end
+    # List all tlds.
+    def list_tlds
+      get("/api/v1/rest/tlds/")
+    end
+
+    # Get tld by slug.
+    def get_tld(slug)
+      get("/api/v1/rest/tlds/#{slug}/")
+    end
+    # List all tools.
+    def list_tools
+      get("/api/v1/rest/tools/")
+    end
+
+    # Get tool by slug.
+    def get_tool(slug)
+      get("/api/v1/rest/tools/#{slug}/")
+    end
+    # List all use cases.
+    def list_use_cases
+      get("/api/v1/rest/use-cases/")
+    end
+
+    # Get use case by slug.
+    def get_use_case(slug)
+      get("/api/v1/rest/use-cases/#{slug}/")
+    end
+
+    private
+
+    def get(path, **params)
+      uri = URI.join(@base_url, path)
+      uri.query = URI.encode_www_form(params) unless params.empty?
+      response = Net::HTTP.get_response(uri)
+      raise "HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
+      JSON.parse(response.body)
+    end
+  end
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: tldfyi
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- FYIPedia
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-21 00:00:00.000000000 Z
+dependencies: []
+description: Ruby client for the TLDFYI REST API at tldfyi.com. Zero external dependencies.
+email: dev@fyipedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tldfyi.rb
+homepage: https://tldfyi.com
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/fyipedia/tldfyi-rb
+  documentation_uri: https://tldfyi.com/api/v1/schema/
+  homepage_uri: https://tldfyi.com
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Ruby client for TLDFYI API
+test_files: []