capture_page 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4c0646db848b7f2468b5115caed1a2101188c86f3e2fe7764eb84cb155003df1
+  data.tar.gz: 77cb86e03ebaa2692a1c186ed9b3540c8e6600ab49f74732eb1bf9e732a23358
+SHA512:
+  metadata.gz: f7070bb1dc03c587dd27f0f76dc7bb4a22fdd694707ef3026069248d11a72648c2c77139cfcf0c463423593695388415965c12066850dea2141f22c40e445909
+  data.tar.gz: 7aa49e640f95945ad92e9de26319769b76b148c518333d636fb0957330e846b0ec50de4b8bf2c9166be8bc819d1d6f35b6399a41c0bf3349fd3143a34b29e383

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Techulus
+
+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,160 @@
+# Capture Ruby SDK
+
+Official Ruby SDK for [Capture](https://capture.page) - Screenshot and content extraction API.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "capture_page"
+```
+
+Or install directly:
+
+```bash
+gem install capture_page
+```
+
+## Quick Start
+
+```ruby
+require "capture"
+
+client = Capture.new("your-api-key", "your-api-secret")
+
+image_url = client.build_image_url("https://example.com")
+puts image_url
+```
+
+## Features
+
+- **Screenshot Capture**: Capture full-page or viewport screenshots as PNG/JPG
+- **PDF Generation**: Convert web pages to PDF documents
+- **Content Extraction**: Extract HTML and text content from web pages
+- **Metadata Extraction**: Get page metadata (title, description, og tags, etc.)
+- **Animated GIFs**: Create animated GIFs of page interactions
+- **Zero Dependencies**: Uses only Ruby standard library
+
+## Usage
+
+### Initialize the Client
+
+```ruby
+require "capture"
+
+client = Capture.new("your-api-key", "your-api-secret")
+
+# Use edge endpoint for faster response times
+client = Capture.new("your-api-key", "your-api-secret", use_edge: true)
+```
+
+### Building URLs
+
+#### Image Capture
+
+```ruby
+image_url = client.build_image_url("https://example.com")
+
+image_url = client.build_image_url("https://example.com", {
+  "full" => true,
+  "delay" => 2,
+  "vw" => 1920,
+  "vh" => 1080
+})
+```
+
+#### PDF Capture
+
+```ruby
+pdf_url = client.build_pdf_url("https://example.com")
+
+pdf_url = client.build_pdf_url("https://example.com", {
+  "format" => "A4",
+  "landscape" => true
+})
+```
+
+#### Content Extraction
+
+```ruby
+content_url = client.build_content_url("https://example.com")
+```
+
+#### Metadata Extraction
+
+```ruby
+metadata_url = client.build_metadata_url("https://example.com")
+```
+
+#### Animated GIF
+
+```ruby
+animated_url = client.build_animated_url("https://example.com")
+```
+
+### Fetching Data
+
+#### Fetch Image
+
+```ruby
+image_data = client.fetch_image("https://example.com")
+File.binwrite("screenshot.png", image_data)
+```
+
+#### Fetch PDF
+
+```ruby
+pdf_data = client.fetch_pdf("https://example.com", { "full" => true })
+File.binwrite("page.pdf", pdf_data)
+```
+
+#### Fetch Content
+
+```ruby
+content = client.fetch_content("https://example.com")
+puts content["html"]
+puts content["textContent"]
+puts content["markdown"]
+```
+
+#### Fetch Metadata
+
+```ruby
+metadata = client.fetch_metadata("https://example.com")
+puts metadata["metadata"]
+```
+
+#### Fetch Animated GIF
+
+```ruby
+gif_data = client.fetch_animated("https://example.com")
+File.binwrite("animation.gif", gif_data)
+```
+
+## Configuration Options
+
+### Constructor Options
+
+- `use_edge` (boolean): Use edge.capture.page instead of cdn.capture.page for faster response times
+
+## API Endpoints
+
+The SDK supports two base URLs:
+
+- **CDN**: `https://cdn.capture.page` (default)
+- **Edge**: `https://edge.capture.page` (when `use_edge: true`)
+
+## License
+
+MIT
+
+## Links
+
+- [Website](https://capture.page)
+- [Documentation](https://docs.capture.page)
+- [GitHub](https://github.com/techulus/capture-ruby)
+
+## Support
+
+For support, please visit [capture.page](https://capture.page) or open an issue on GitHub.

data/lib/capture.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+require "digest/md5"
+require "net/http"
+require "uri"
+require "json"
+
+class Capture
+  API_URL = "https://cdn.capture.page"
+  EDGE_URL = "https://edge.capture.page"
+
+  attr_reader :key, :options
+
+  def initialize(key, secret, options = {})
+    @key = key
+    @secret = secret
+    options = options.nil? ? {} : options
+    raise TypeError, "options must be a Hash" unless options.is_a?(Hash)
+    @options = options
+  end
+
+  def build_image_url(url, options = {})
+    build_url(url, "image", options)
+  end
+
+  def build_pdf_url(url, options = {})
+    build_url(url, "pdf", options)
+  end
+
+  def build_content_url(url, options = {})
+    build_url(url, "content", options)
+  end
+
+  def build_metadata_url(url, options = {})
+    build_url(url, "metadata", options)
+  end
+
+  def build_animated_url(url, options = {})
+    build_url(url, "animated", options)
+  end
+
+  def fetch_image(url, options = {})
+    fetch_binary(build_image_url(url, options))
+  end
+
+  def fetch_pdf(url, options = {})
+    fetch_binary(build_pdf_url(url, options))
+  end
+
+  def fetch_content(url, options = {})
+    fetch_json(build_content_url(url, options))
+  end
+
+  def fetch_metadata(url, options = {})
+    fetch_json(build_metadata_url(url, options))
+  end
+
+  def fetch_animated(url, options = {})
+    fetch_binary(build_animated_url(url, options))
+  end
+
+  private
+
+  def build_url(url, request_type, options)
+    raise TypeError, "key and secret must be strings" unless @key.is_a?(String) && @secret.is_a?(String)
+    raise ArgumentError, "Key and Secret is required" if @key.empty? || @secret.empty?
+    raise ArgumentError, "url is required" if url.nil? || (url.is_a?(String) && url.empty?)
+    raise TypeError, "url should be of type string (something like www.google.com)" unless url.is_a?(String)
+
+    options = options.nil? ? {} : options
+    raise TypeError, "options must be a Hash" unless options.is_a?(Hash)
+    params = options.merge("url" => url)
+    query_string = encode_query_string(params)
+    token = generate_token(@secret, query_string)
+    base_url = @options[:use_edge] || @options["useEdge"] ? EDGE_URL : API_URL
+
+    "#{base_url}/#{@key}/#{token}/#{request_type}?#{query_string}"
+  end
+
+  def generate_token(secret, query_string)
+    Digest::MD5.hexdigest("#{secret}#{query_string}")
+  end
+
+  def encode_query_string(params)
+    filtered = params.each_with_object({}) do |(k, v), hash|
+      next if v.nil?
+
+      hash[k] = case v
+                when true then "true"
+                when false then "false"
+                else v.to_s
+                end
+    end
+
+    URI.encode_www_form(filtered)
+  end
+
+  def fetch_binary(url)
+    uri = URI.parse(url)
+    response = Net::HTTP.get_response(uri)
+    raise "HTTP Error: #{response.code} #{response.message}" unless response.is_a?(Net::HTTPSuccess)
+
+    response.body.force_encoding("BINARY")
+  end
+
+  def fetch_json(url)
+    uri = URI.parse(url)
+    response = Net::HTTP.get_response(uri)
+    raise "HTTP Error: #{response.code} #{response.message}" unless response.is_a?(Net::HTTPSuccess)
+
+    JSON.parse(response.body)
+  end
+end

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: capture_page
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Capture Team
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Official Ruby SDK for Capture (capture.page). Capture screenshots, generate
+  PDFs, extract content and metadata from web pages.
+email:
+- support@capture.page
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/capture.rb
+homepage: https://capture.page
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://capture.page
+  source_code_uri: https://github.com/techulus/capture-ruby
+  documentation_uri: https://docs.capture.page
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Ruby SDK for Capture - Screenshot and content extraction API
+test_files: []