contemble 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3e11de0b7a122b2a0e036240b764cda308ba26ce3a82b298d3e9a7333e70597e
+  data.tar.gz: 95b4039dd5515f0c07d8f305e4dd994a09492f96213e7656b6166c9a46e0a3d6
+SHA512:
+  metadata.gz: 23c9a6586fc151ee597bc7ac1164310e5f78c9f12bff585dc3db49b806751f72eacb16bb5a44bfa85200116d77217c56347d28fdfb83873b7fc6164c960c8be2
+  data.tar.gz: 6d298dd5bbd779f9fbf176db84e31f745fd3fa75d073c1b2663649c89798ca5121e8cb3a154dbc1f6144150669cb564f56c627395bb14249a58cab0fb2008f96

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Contemble
+
+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,49 @@
+# Contemble
+
+A Ruby gem for interacting with the Contemble CMS API.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem 'contemble'
+```
+
+## Setup
+
+Generate the initializer:
+
+```bash
+rails generate contemble:install
+```
+
+This creates `config/initializers/contemble.rb`:
+
+```ruby
+Contemble.configure do |config|
+  config.post_path = "/blog"
+end
+```
+
+## Usage
+
+```ruby
+client = Contemble::Client.new(api_key: "your_api_key")
+
+# Get all posts
+posts = client.collections.posts
+
+# Get posts from specific collection
+posts = client.collections.posts(collection_name: "blog")
+
+# Get individual post
+post = client.content.show(slug: "post-slug")
+```
+
+Each post includes a `url` field for easy linking based on your configured `post_path`.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: :rubocop

data/lib/contemble/client.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+
+module Contemble
+  class Client
+    attr_reader :base_url, :api_key
+
+    def initialize(api_key:)
+      @base_url = "https://api.contemble.com"
+      @api_key = api_key
+    end
+
+    def collections
+      @collections ||= Resources::Collections.new(self)
+    end
+
+    def content
+      @content ||= Resources::Content.new(self)
+    end
+
+    def get(path, params = {})
+      uri = URI("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(params) unless params.empty?
+
+      request = Net::HTTP::Get.new(uri)
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["Content-Type"] = "application/json"
+
+      make_request(uri, request)
+    end
+
+    def post(path, body = {})
+      uri = URI("#{@base_url}#{path}")
+
+      request = Net::HTTP::Post.new(uri)
+      request["Authorization"] = "Bearer #{@api_key}"
+      request["Content-Type"] = "application/json"
+      request.body = body.to_json
+
+      make_request(uri, request)
+    end
+
+    private
+
+    def make_request(uri, request)
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+        response = http.request(request)
+        handle_response(response)
+      end
+    end
+
+    def handle_response(response)
+      case response.code.to_i
+      when 200..299
+        JSON.parse(response.body) if response.body && !response.body.empty?
+      when 404
+        raise Error, "Resource not found"
+      when 401
+        raise Error, "Unauthorized"
+      else
+        raise Error, "Request failed with status #{response.code}: #{response.body}"
+      end
+    end
+  end
+end

data/lib/contemble/configuration.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Contemble
+  class Configuration
+    attr_accessor :post_path
+
+    def initialize
+      @post_path = "/blog"
+    end
+  end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    delegate :post_path, to: :configuration
+  end
+end

data/lib/contemble/railtie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Contemble
+  class Railtie < Rails::Railtie
+    generators do
+      require_relative "../generators/contemble/install_generator"
+    end
+  end
+end

data/lib/contemble/resources.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Contemble
+  module Resources
+    class Collections
+      def initialize(client)
+        @client = client
+      end
+
+      def list
+        @client.get("/collections")
+      end
+
+      def posts(collection_name: nil)
+        posts = if collection_name
+                  @client.get("/collections/#{collection_name}")
+        else
+                  collections = list
+                  all_posts = []
+
+                  collections.each do |collection|
+                    posts = @client.get("/collections/#{collection["name"]}")
+                    all_posts.concat(posts)
+                  end
+
+                  all_posts
+        end
+
+        posts.map do |post|
+          post.merge(
+            "url" => "#{Contemble.post_path}/#{post["slug"]}"
+          )
+        end
+      end
+    end
+
+    class Content
+      def initialize(client)
+        @client = client
+      end
+
+      def show(slug:)
+        @client.get("/content/#{slug}")
+      end
+    end
+  end
+end

data/lib/contemble/version.rb

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

data/lib/contemble.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "contemble/version"
+require_relative "contemble/configuration"
+require_relative "contemble/resources"
+require_relative "contemble/client"
+
+if defined?(Rails::Railtie)
+  require_relative "contemble/railtie"
+end
+
+module Contemble
+  class Error < StandardError; end
+end

data/lib/generators/contemble/install_generator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/actions"
+
+module Contemble
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Rails::Generators::Actions
+
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a Contemble initializer file"
+
+      def create_initializer_file
+        template "contemble.rb", "config/initializers/contemble.rb"
+      end
+    end
+  end
+end

data/lib/generators/contemble/templates/contemble.rb

@@ -0,0 +1,5 @@
+Contemble.configure do |config|
+  # Set the base path for post URLs
+  # Example: /articles, /blog, etc.
+  config.post_path = "/articles"
+end

data/sig/contemble.rbs

@@ -0,0 +1,4 @@
+module Contemble
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: contemble
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- contemble
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+email:
+- development@contemble.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/contemble.rb
+- lib/contemble/client.rb
+- lib/contemble/configuration.rb
+- lib/contemble/railtie.rb
+- lib/contemble/resources.rb
+- lib/contemble/version.rb
+- lib/generators/contemble/install_generator.rb
+- lib/generators/contemble/templates/contemble.rb
+- sig/contemble.rbs
+homepage: https://contemble.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://contemble.com
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Ruby gem to connect to Contemble.com and serve content via our Headless API.
+test_files: []