faceless_reels 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 89701ebc0b2011d0784fb5fd85411a65cb705290f82262ed65b29de24b6ff8a3
+  data.tar.gz: 664a630d9e02e52933b32dc000038c82cd6c5c70beeb5269893aaed9994e0f0a
+SHA512:
+  metadata.gz: 22b389db1499d1b64ac2a3f3dba34b29bf489c5ee066d9e33dee62d5467665c06d40734478dec199e960a5658e5aa8e922482d30f75deb22fd831be1136da5bf
+  data.tar.gz: 269ec2a39d2c0e9eb6ae60dc17c5f0567a74dd1cddd25f3cf2d789e673064fb733e9322a340f7c57b79596360e2c1dd81ecf66c8a95738e08c38c4cc88138741

data/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Allen328
+
+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,73 @@
+# Faceless Reels Ruby
+
+`faceless_reels` is a small Ruby client for the public endpoints exposed by
+[Faceless Reels](https://faceless-reels.io), an AI-assisted workflow for
+creating narrated vertical videos.
+
+The gem currently supports service health checks and public showcase-video
+URLs. It does not call private project APIs or submit video-generation jobs.
+
+## Installation
+
+Install the gem directly:
+
+```shell
+gem install faceless_reels
+```
+
+Or add it to your Gemfile:
+
+```ruby
+gem "faceless_reels"
+```
+
+## Usage
+
+```ruby
+require "faceless_reels"
+
+client = FacelessReels::Client.new
+
+client.ping
+# => {"message"=>"pong"}
+
+FacelessReels.homepage
+# => "https://faceless-reels.io"
+
+FacelessReels.showcase_video_url("shackleton")
+# => "https://faceless-reels.io/api/public/showcase-videos/shackleton"
+```
+
+To convert service failures into a boolean health signal:
+
+```ruby
+client.available?
+# => true or false
+```
+
+## Development
+
+Run the tests:
+
+```shell
+bundle install
+bundle exec rake test
+```
+
+Build the gem:
+
+```shell
+gem build faceless_reels.gemspec
+```
+
+## Links
+
+- Website: <https://faceless-reels.io>
+- Examples: <https://faceless-reels.io/examples>
+- Source: <https://github.com/allen207/faceless-reels-ruby>
+- RubyGems: <https://rubygems.org/gems/faceless_reels>
+
+## License
+
+The Ruby client in this repository is available under the MIT License.
+

data/lib/faceless_reels/client.rb

@@ -0,0 +1,54 @@
+require "json"
+require "net/http"
+require "uri"
+
+module FacelessReels
+  class Client
+    SHOWCASE_ID_PATTERN = /\A[a-z0-9]+(?:-[a-z0-9]+)*\z/.freeze
+
+    def initialize(base_url: HOMEPAGE, http_get: nil)
+      @base_url = normalize_base_url(base_url)
+      @http_get = http_get || lambda { |uri| Net::HTTP.get_response(uri) }
+    end
+
+    def ping
+      response = @http_get.call(URI("#{@base_url}/api/ping"))
+      raise HTTPError, response.code unless success?(response)
+
+      JSON.parse(response.body)
+    rescue JSON::ParserError => error
+      raise Error, "Faceless Reels returned invalid JSON: #{error.message}"
+    end
+
+    def available?
+      ping.fetch("message", nil) == "pong"
+    rescue Error, SystemCallError, Timeout::Error
+      false
+    end
+
+    def showcase_video_url(showcase_id)
+      id = showcase_id.to_s
+      unless SHOWCASE_ID_PATTERN.match?(id)
+        raise ArgumentError, "Invalid showcase ID"
+      end
+
+      "#{@base_url}/api/public/showcase-videos/#{id}"
+    end
+
+    private
+
+    def normalize_base_url(base_url)
+      uri = URI(base_url.to_s)
+      unless %w[http https].include?(uri.scheme) && uri.host
+        raise ArgumentError, "base_url must be an HTTP or HTTPS URL"
+      end
+
+      base_url.to_s.sub(%r{/+\z}, "")
+    end
+
+    def success?(response)
+      response.code.to_i.between?(200, 299)
+    end
+  end
+end
+

data/lib/faceless_reels/version.rb

@@ -0,0 +1,4 @@
+module FacelessReels
+  VERSION = "0.1.0".freeze
+end
+

data/lib/faceless_reels.rb

@@ -0,0 +1,35 @@
+require_relative "faceless_reels/version"
+
+module FacelessReels
+  HOMEPAGE = "https://faceless-reels.io".freeze
+  SUMMARY =
+    "Turn story ideas into narrated vertical videos with Faceless Reels.".freeze
+
+  class Error < StandardError; end
+
+  class HTTPError < Error
+    attr_reader :status
+
+    def initialize(status)
+      @status = status.to_i
+      super("Faceless Reels returned HTTP #{@status}")
+    end
+  end
+end
+
+require_relative "faceless_reels/client"
+
+module FacelessReels
+  def self.homepage
+    HOMEPAGE
+  end
+
+  def self.summary
+    SUMMARY
+  end
+
+  def self.showcase_video_url(showcase_id)
+    Client.new.showcase_video_url(showcase_id)
+  end
+end
+

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: faceless_reels
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Allen328
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A small Ruby client for checking Faceless Reels availability and building
+  URLs for its public showcase videos.
+email:
+- support@faceless-reels.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/faceless_reels.rb
+- lib/faceless_reels/client.rb
+- lib/faceless_reels/version.rb
+homepage: https://faceless-reels.io
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://faceless-reels.io
+  source_code_uri: https://github.com/allen207/faceless-reels-ruby
+  documentation_uri: https://www.rubydoc.info/gems/faceless_reels
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby client for Faceless Reels public endpoints.
+test_files: []