versacommerce-theme_api_client 0.1.2 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ddae795537f35e2728dcf6116c65685321c76508
-  data.tar.gz: 07dadb3ee73691942fdc0dd81e342fc2c2ec6de1
+SHA256:
+  metadata.gz: 4fcf2656faa757b046931d4a22ead1d4cfa15758320b1c32504f897565a5eaba
+  data.tar.gz: 4f9bcef22485ca0be490100dee1153b33f916b7f6b840aae47196458a39c141b
 SHA512:
-  metadata.gz: 86056b19788e9d2e16755cc70bd66fab38ad5451a74630071e68ca3c761a4768d0906659895e9ad749a8b45f91cf2a87f30a0861c7edcbbd17ed95fd62870838
-  data.tar.gz: 1bed5146aca67d503c1431e267e82aec087ac2daad155ff5f390260a81adbcd46060e2c5987bfd910e2ed0a5598f356dfc0c9a12d766d1c94e2406906c547da2
+  metadata.gz: 6805af2804b62be8808a3119b1bc280b1264a6f711a333b26b86e7bce7198201773fd22b0c929346c8daa4f021b578d44131048a3805916ed305c47ea210980d
+  data.tar.gz: 2b3a4a26c23598b963deb0a7fe9941e9ee45df6e8fdd99bec939f7e221c49bdaac5043505ccc3b6406f4828459afa92c70c0b0b5b0e6b0b254664f1d79f4a2df

data/.ruby-version

@@ -0,0 +1 @@
+3.1.3

data/CLAUDE.md

@@ -0,0 +1,104 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Ruby gem that provides an API client for the VersaCommerce Theme API. It allows developers to programmatically manage theme files and directories for VersaCommerce shops.
+
+## Requirements
+
+- Ruby >= 3.3.0
+- Dependencies: http (~> 5.0), activesupport (>= 4.2, < 8.0), activemodel (>= 4.2, < 8.0)
+
+## Common Commands
+
+### Setup and Development
+```bash
+bin/setup              # Install dependencies
+bin/console            # Launch interactive console for experimentation
+bundle install         # Install gem dependencies
+```
+
+### Building and Publishing
+```bash
+rake build             # Build the gem
+rake install           # Build and install gem locally
+rake release           # Create git tag, build and push gem to rubygems.org
+```
+
+## Architecture
+
+### Core Components
+
+**Client (lib/versacommerce/theme_api_client.rb)**
+- Entry point for the gem
+- Initialized with authorization token
+- Provides `directories()` and `files()` methods that return relation objects
+- Configurable `base_url` (defaults to https://theme-api.versacommerce.de)
+- Dynamically creates resource classes tied to the client instance
+
+**Fetcher (lib/versacommerce/theme_api_client/fetcher.rb)**
+- HTTP communication layer using the `http` gem
+- Handles all HTTP verbs (GET, POST, PATCH, DELETE, HEAD)
+- Adds Theme-Authorization header to all requests
+- Defines custom errors: `RecordNotFoundError` and `UnauthorizedError`
+- Extends HTTP::Response with a `json` method for parsing JSON responses
+
+**Relation (lib/versacommerce/theme_api_client/relation.rb)**
+- Base class for DirectoryRelation and FileRelation
+- Implements Enumerable for iteration
+- Provides ActiveRecord-like interface: `find()`, `build()`, `create()`, `delete()`
+- Supports path scoping with `in_path()` method
+- Handles recursive vs non-recursive queries
+
+**Resource (lib/versacommerce/theme_api_client/resource.rb)**
+- Base class for Directory and File resources
+- Uses ActiveModel for validations and dirty tracking
+- Implements `save()`, `update()`, `new_record?` methods
+- Each resource class is dynamically created per client instance (see `directory_class` and `file_class` in client)
+
+### Resource Types
+
+**Directory (lib/versacommerce/theme_api_client/resources/directory.rb)**
+- Represents theme directories
+- Has `path` attribute
+- Provides `files()` method to access files within the directory
+
+**File (lib/versacommerce/theme_api_client/resources/file.rb)**
+- Represents theme files
+- Has `path` and `content` attributes
+- Content loading is conditional: text files load automatically, binary files require explicit `load_content: true`
+- Provides `reload_content()` and `has_content?` methods
+
+### Key Design Patterns
+
+**Dynamic Class Creation**: The client creates subclasses of Directory and File at runtime (via `directory_class` and `file_class`), binding them to the specific client instance. This allows each resource to access the client's fetcher and configuration.
+
+**Relation Pattern**: Inspired by ActiveRecord, relations provide chainable query interfaces and lazy evaluation. The `in_path()` method modifies the relation's path scope without executing queries.
+
+**Path Helpers**: The client provides `directory_path()`, `file_path()`, `download_path()`, and `tree_path()` helper methods that build Pathname objects for API endpoints.
+
+## Module Structure
+
+```
+lib/versacommerce/
+  theme_api_client.rb              # Main client class
+  theme_api_client/
+    client.rb                       # (Appears to be duplicate/alternative entry point)
+    fetcher.rb                      # HTTP client wrapper
+    relation.rb                     # Base relation class
+    resource.rb                     # Base resource class with ActiveModel
+    version.rb                      # Gem version constant
+    relations/
+      directory_relation.rb
+      file_relation.rb
+    resources/
+      directory.rb
+      file.rb
+      file_behaviour.rb             # Shared file behavior module
+```
+
+## Testing
+
+This gem does not appear to have a test suite in the repository. When adding tests, consider creating a spec/ or test/ directory.

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2015 VersaCommerce
+Copyright (c) 2025 VersaCommerce
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -6,7 +6,7 @@ Versacommerce::ThemeAPIClient is a library to consume the VersaCommerce Theme AP
 
 ## Requirements
 
-Ruby ≥ 2.0.0
+Ruby ≥ 3.1.0
 
 ## Installation
 

data/lib/versacommerce/theme_api_client/fetcher.rb

@@ -84,7 +84,7 @@ module Versacommerce
       end
 
       def with_headers
-        HTTP.with_headers(accept: 'application/json', 'Theme-Authorization' => authorization)
+        HTTP.headers(accept: 'application/json', 'Theme-Authorization' => authorization)
       end
     end
   end

data/lib/versacommerce/theme_api_client/resources/file.rb

@@ -73,7 +73,7 @@ module Versacommerce
 
         def delete
           unless new_record?
-            response = fetcher.delete(file_path(path))
+            fetcher.delete(file_path(path))
             content_will_change!
             self.new_record = true
           end
@@ -94,7 +94,7 @@ module Versacommerce
           unless new_record?
             response = fetcher.get(download_path(path))
             self.content = response.to_s
-            clear_attribute_changes(:content)
+            clear_attribute_changes([:content])
           end
 
           self

data/lib/versacommerce/theme_api_client/version.rb

@@ -1,5 +1,5 @@
 module Versacommerce
   class ThemeAPIClient
-    VERSION = Gem::Version.new('0.1.2')
+    VERSION = Gem::Version.new('1.0.1')
   end
 end

data/versacommerce-theme_api_client.gemspec

@@ -3,8 +3,7 @@ require_relative 'lib/versacommerce/theme_api_client/version'
 Gem::Specification.new do |spec|
   spec.name          = 'versacommerce-theme_api_client'
   spec.version       = Versacommerce::ThemeAPIClient::VERSION
-  spec.authors       = ['Tobias Bühlmann']
-  spec.email         = ['buehlmann@versacommerce.de']
+  spec.authors       = ['VersaCommerce GmbH']
 
   spec.summary       = 'API Client for the VersaCommercer Theme API.'
   spec.description   = 'This Gem acts as an API Client for the VersaCommerce Theme API.'
@@ -16,14 +15,14 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(/\Aexe/) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.required_ruby_version = '>= 2.0.0'
+  spec.required_ruby_version = '>= 3.1.0'
 
-  spec.add_runtime_dependency 'http', '0.8.3'
-  spec.add_runtime_dependency 'activesupport', '~> 4.2'
-  spec.add_runtime_dependency 'activemodel', '~> 4.2'
+  spec.add_runtime_dependency 'http', '~> 5.0'
+  spec.add_runtime_dependency 'activesupport', '>= 4.2', '< 7.0'
+  spec.add_runtime_dependency 'activemodel', '>= 4.2', '< 7.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.8'
-  spec.add_development_dependency 'rake', '~> 10.4'
-  spec.add_development_dependency 'pry', '0.10.1'
-  spec.add_development_dependency 'pry-stack_explorer', '0.4.9.2'
+  spec.add_development_dependency 'bundler', '>= 1.8'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'pry', '~> 0.14'
+  spec.add_development_dependency 'pry-stack_explorer', '~> 0.6'
 end

metadata

@@ -1,69 +1,81 @@
 --- !ruby/object:Gem::Specification
 name: versacommerce-theme_api_client
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 1.0.1
 platform: ruby
 authors:
-- Tobias Bühlmann
-autorequire: 
+- VersaCommerce GmbH
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2015-04-15 00:00:00.000000000 Z
+date: 2025-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.3
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.3
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: activemodel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.8'
 - !ruby/object:Gem::Dependency
@@ -72,50 +84,51 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.1
+        version: '0.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.1
+        version: '0.14'
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9.2
+        version: '0.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9.2
+        version: '0.6'
 description: This Gem acts as an API Client for the VersaCommerce Theme API.
 email:
-- buehlmann@versacommerce.de
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".ruby-version"
+- CLAUDE.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -138,7 +151,7 @@ homepage: https://github.com/versacommerce/versacommerce-theme_api_client
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -146,16 +159,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.5
-signing_key: 
+rubygems_version: 3.3.26
+signing_key:
 specification_version: 4
 summary: API Client for the VersaCommercer Theme API.
 test_files: []