namefyi 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34a00411afe636ca98df9f95764a383d952ee2f72fd8d3b41ede9084213f2332
-  data.tar.gz: f0942160d2e476816bc7f1f3953ddc8d67490e45241e579f4afd7ca9b69e4ae3
+  metadata.gz: 35db2dd47f3f5b02ceead8d448ffa05e3a933ef49a4ccb4b1e9f8f02176e8bf5
+  data.tar.gz: 4636cb958b9efa30c8262438f920272f4c8388f16b266af3753628d09f02764f
 SHA512:
-  metadata.gz: d8de88c0ef31efae8cae81c0b20bc6f919fa83a4866494008604bb4b5f3619e2c4e2d8650c53552a7a1194a10d9db343238d2bd8cf6c4f440eda26ed40758d75
-  data.tar.gz: a4b6791328ea0e5a3e3c70224d8a5ad1f5488aba98f35b422a4bd9165c6be2e71c1454a5fe1fba91591ebe7f61c8304025ac39a629d3ea07feaba1c2c25a620f
+  metadata.gz: dc3f1bf51ee51f5be2ce93c1b616401864b4a1e16225dab733bcb5035847a659a9f3c9bd07079a7396a487096ebaa0b5bdf75aea9ac6d242c8721b6f49221218
+  data.tar.gz: f935e8e7cc5d75ad202965bacc29b02fb21d106f0bc22d1b89f5a65109419004015fbc3c652fe9dad31b3f6755ed919c8f06bd01bf28b0dde4d363504890ee3a

data/lib/namefyi/client.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module NameFYI
+  class Client
+    DEFAULT_BASE_URL = "https://namefyi.com/api"
+
+    def initialize(base_url: DEFAULT_BASE_URL)
+      @base_url = base_url
+    end
+
+    def search(query)
+      get("/search/", q: query)
+    end
+
+    def entity(slug)
+      get("/name/#{slug}/")
+    end
+
+    def glossary_term(slug)
+      get("/glossary/#{slug}/")
+    end
+
+    def random
+      get("/random/")
+    end
+
+    private
+
+    def get(path, params = {})
+      uri = URI("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(params) unless params.empty?
+
+      response = Net::HTTP.get_response(uri)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        raise Error, "HTTP #{response.code}: #{response.body}"
+      end
+
+      JSON.parse(response.body, symbolize_names: true)
+    end
+  end
+
+  class Error < StandardError; end
+end

data/lib/namefyi/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NameFYI
+  VERSION = "0.1.1"
+end

data/lib/namefyi.rb

@@ -1,107 +1,4 @@
 # frozen_string_literal: true
 
-require "net/http"
-require "json"
-require "uri"
-
-# Ruby client for NameFYI REST API (namefyi.com).
-#
-#   client = NameFYI::Client.new
-#   result = client.search("query")
-#
-module NameFYI
-  class Client
-    BASE_URL = "https://namefyi.com"
-
-    def initialize(base_url: BASE_URL)
-      @base_url = base_url
-    end
-
-    def search(query)
-      get("/api/v1/search/", q: query)
-    end
-
-    # List all characters.
-    def list_characters
-      get("/api/v1/characters/")
-    end
-
-    # Get character by slug.
-    def get_character(slug)
-      get("/api/v1/characters/#{slug}/")
-    end
-    # List all cultures.
-    def list_cultures
-      get("/api/v1/cultures/")
-    end
-
-    # Get culture by slug.
-    def get_culture(slug)
-      get("/api/v1/cultures/#{slug}/")
-    end
-    # List all faqs.
-    def list_faqs
-      get("/api/v1/faqs/")
-    end
-
-    # Get faq by slug.
-    def get_faq(slug)
-      get("/api/v1/faqs/#{slug}/")
-    end
-    # List all given names.
-    def list_given_names
-      get("/api/v1/given-names/")
-    end
-
-    # Get given name by slug.
-    def get_given_name(slug)
-      get("/api/v1/given-names/#{slug}/")
-    end
-    # List all glossary.
-    def list_glossary
-      get("/api/v1/glossary/")
-    end
-
-    # Get term by slug.
-    def get_term(slug)
-      get("/api/v1/glossary/#{slug}/")
-    end
-    # List all guides.
-    def list_guides
-      get("/api/v1/guides/")
-    end
-
-    # Get guide by slug.
-    def get_guide(slug)
-      get("/api/v1/guides/#{slug}/")
-    end
-    # List all meaning tags.
-    def list_meaning_tags
-      get("/api/v1/meaning-tags/")
-    end
-
-    # Get meaning tag by slug.
-    def get_meaning_tag(slug)
-      get("/api/v1/meaning-tags/#{slug}/")
-    end
-    # List all surnames.
-    def list_surnames
-      get("/api/v1/surnames/")
-    end
-
-    # Get surname by slug.
-    def get_surname(slug)
-      get("/api/v1/surnames/#{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
+require_relative "namefyi/version"
+require_relative "namefyi/client"

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: namefyi
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - FYIPedia
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-21 00:00:00.000000000 Z
+date: 2026-03-30 00:00:00.000000000 Z
 dependencies: []
-description: Ruby client for the NameFYI REST API at namefyi.com. Zero external dependencies.
-email: dev@fyipedia.com
+description: API client for namefyi.com. Korean romanization, Five Elements, and CJK
+  stroke lookup. Zero dependencies.
+email:
+- hello@fyipedia.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - lib/namefyi.rb
+- lib/namefyi/client.rb
+- lib/namefyi/version.rb
 homepage: https://namefyi.com
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/fyipedia/namefyi-rb
-  documentation_uri: https://namefyi.com/api/v1/schema/
   homepage_uri: https://namefyi.com
+  source_code_uri: https://github.com/fyipedia/namefyi-rb
+  changelog_uri: https://github.com/fyipedia/namefyi-rb/blob/main/CHANGELOG.md
+  documentation_uri: https://namefyi.com/developers/
+  bug_tracker_uri: https://github.com/fyipedia/namefyi-rb/issues
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -42,5 +48,5 @@ requirements: []
 rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
-summary: Ruby client for NameFYI API
+summary: Korean romanization, Five Elements, and CJK stroke lookup
 test_files: []