zipfyi 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7646cc12ad21f8296d7f80e4331f3d1103f8bdab1a0ece75be20adcd4ad1b412
+  data.tar.gz: 534eba69e2db6ebd2ff53cd0c4865398bf8caff515c3bcf5bc0f968af946b6bd
+SHA512:
+  metadata.gz: 68098e0be646bf7d0fc17cc4a9923f1195f1c3c539d76bfa8563920a78f8c34bcec4a6c0a63d6d0be6a65d9d396acc46cd673fb465139c7f9a5696de2f7fe766
+  data.tar.gz: 9b13096d31aa5c4f5241c5de6a5087c4989c6bdeaf849279f1e1e665cf888631a7f5431c4456e6bef554cfd64ecee72b9cbf216dbb1206cba59ce758cdb1804b

data/lib/zipfyi.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+# Ruby client for ZipFYI REST API (zipfyi.com).
+#
+#   client = ZipFYI::Client.new
+#   result = client.search("query")
+#
+module ZipFYI
+  class Client
+    BASE_URL = "https://zipfyi.com"
+
+    def initialize(base_url: BASE_URL)
+      @base_url = base_url
+    end
+
+    def search(query)
+      get("/api/v1/search/", q: query)
+    end
+
+    # List all blog posts.
+    def list_blog_posts
+      get("/api/v1/blog-posts/")
+    end
+
+    # Get blog post by slug.
+    def get_blog_post(slug)
+      get("/api/v1/blog-posts/#{slug}/")
+    end
+    # List all blog series.
+    def list_blog_series
+      get("/api/v1/blog-series/")
+    end
+
+    # Get blog sery by slug.
+    def get_blog_sery(slug)
+      get("/api/v1/blog-series/#{slug}/")
+    end
+    # List all cities.
+    def list_cities
+      get("/api/v1/cities/")
+    end
+
+    # Get city by slug.
+    def get_city(slug)
+      get("/api/v1/cities/#{slug}/")
+    end
+    # List all countries.
+    def list_countries
+      get("/api/v1/countries/")
+    end
+
+    # Get country by slug.
+    def get_country(slug)
+      get("/api/v1/countries/#{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 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 postal codes.
+    def list_postal_codes
+      get("/api/v1/postal-codes/")
+    end
+
+    # Get postal code by slug.
+    def get_postal_code(slug)
+      get("/api/v1/postal-codes/#{slug}/")
+    end
+    # List all states.
+    def list_states
+      get("/api/v1/states/")
+    end
+
+    # Get state by slug.
+    def get_state(slug)
+      get("/api/v1/states/#{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: zipfyi
+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 ZipFYI REST API at zipfyi.com. Zero external dependencies.
+email: dev@fyipedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/zipfyi.rb
+homepage: https://zipfyi.com
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/fyipedia/zipfyi-rb
+  documentation_uri: https://zipfyi.com/api/v1/schema/
+  homepage_uri: https://zipfyi.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 ZipFYI API
+test_files: []