resteze 0.1.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1bbe0973ffabaab62515892208bebf19b154493382a272236d833c6b8e621b1e
-  data.tar.gz: f3674096d21235157673d5678d4586549b111e67842a24778e830b7507124123
+  metadata.gz: 4be8c1254251ae0e6d2fb624d9ebbfff5ddc309d903ffe1ded346d816b4a3cf0
+  data.tar.gz: b49908651339547627e4a46b13944d9029ce06bea3a1a189fc63538b7fb54cb2
 SHA512:
-  metadata.gz: 0ddebadb823fc854a48f99c547134458f2be39f229d76d58bbc872ebae0aaa8b48296596565bb2d2f3e612bc0164949489e05ce212b1cb78f11bb0c40164d160
-  data.tar.gz: b534a50b9674cb29c570610d320bbead76f21548119bd8b5c9580938be459a8704a230eba2ef4dbb1a08b5ab9620c4978bd462356a4259429dec838e2c294ed7
+  metadata.gz: d318326b40178c6bbcfb949908e37742d56c74c1e366ec4522c217bc5886b21f2884536b94d814f17e1c2ab7262a5820df0b43ed481302f5b6bcc6071af2e64d
+  data.tar.gz: 62db4cc4bc2edf0761b258ef64b7e4edf42faea613099c3ab7091434c0d4fea100bcca33604e910e0943c07a242f807f6165f06d9e94195aba10f9deb6381d47

data/.rubocop.yml

@@ -7,6 +7,9 @@ inherit_mode:
   merge:
     - Exclude
 
+Layout/LineLength:
+  Max: 125
+
 Metrics/ParameterLists:
   Exclude:
     - lib/resteze/errors.rb
@@ -25,9 +28,15 @@ Metrics/ClassLength:
     - lib/resteze/client.rb
     - test/**/*
 
+Metrics/MethodLength:
+  Max: 15
+
 Minitest/MultipleAssertions:
   Max: 6
 
+Style/Documentation:
+  Enabled: false
+
 Style/FrozenStringLiteralComment:
   Enabled: false
 
@@ -37,5 +46,6 @@ Style/StringLiterals:
 
 AllCops:
   NewCops: enable
+  TargetRubyVersion: 3.2
   Exclude:
-    - 'bin/*'
+    - "bin/*"

data/.ruby-version

@@ -0,0 +1 @@
+3.4.2

data/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.3.1]
+
+### Added
+
+- Minitest and RSpec testing helpers for resources and configuration.
+
+## [0.3.0]
+
+### Added
+
+- Initial implementation of Resteze, a framework for building REST API client gems.
+- Support for defining API resources, requests, and responses.
+- Configuration management for API clients.
+- Integration with Faraday, Hashie, and ActiveSupport.
+- Middleware for error handling and request transformation.
+- Serialization and deserialization of API responses.
+- Thread-safe client management.
+- Flexible resource paths and property mapping.
+
+## [0.1.0] - 2025-08-12
+
+### Added
+
+- First public release.
+- Documentation and usage examples.
+- CI workflow for RuboCop and tests across Ruby 3.2–3.4.4.
+- Code coverage reporting integration.

data/Guardfile

@@ -3,6 +3,5 @@ directories %w[lib test]
 guard :minitest, all_on_start: false do
   watch(%r{^lib/(.+)\.rb$}) { |m| "test/#{m[1]}_test.rb" }
   watch(%r{^test/.+_test\.rb$})
-  watch(%r{^test/factories\.rb$})   { "test" }
   watch(%r{^test/test_helper\.rb$}) { "test" }
 end

data/README.md

@@ -1,38 +1,86 @@
-# Resteze
+<div style="display: block; text-align: center;">
+  <img src="assets/resteze.svg" alt="Resteze API Ointment" width="128" style="margin: auto;">
+</div>
 
-TODO: Delete this and the text below, and describe your gem
+[![Continuous Integration](https://github.com/rwx-services/resteze/actions/workflows/ci.yml/badge.svg)](https://github.com/rwx-services/resteze/actions/workflows/ci.yml)
+[![Gem Version](https://badge.fury.io/rb/resteze.svg)](https://badge.fury.io/rb/resteze)
+[![Coverage Status](https://coveralls.io/repos/github/rwx-services/resteze/badge.svg?branch=main)](https://coveralls.io/github/rwx-services/resteze?branch=main)
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/resteze`. To experiment with that code, run `bin/console` for an interactive prompt.
+---
+
+Resteze is a Ruby library designed to simplify the creation of REST API client gems. It provides a flexible framework for defining API resources, handling requests and responses, managing configuration, and supporting common patterns like listing, saving, and error handling. Built on top of popular Ruby libraries such as Faraday, Hashie, and ActiveSupport, Resteze enables developers to quickly build robust, object-oriented clients for RESTful services, with features for custom resource paths, serialization, and thread-safe client management.
+
+But Resteze isn't just for REST! Its resource-oriented design lets you give any API—SOAP, RPC, GraphQL, or even quirky legacy endpoints—a clean, resourceful feel. You can wrap non-RESTful APIs in familiar objects, organize calls as resource methods, and enjoy the same convenience and clarity, no matter how your backend is structured. Resteze helps you tame any API and make it feel right at home in Ruby.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+You can install Resteze from RubyGems or use it directly from source.
 
-Install the gem and add to the application's Gemfile by executing:
+### Install via RubyGems
+
+Add Resteze to your application's Gemfile:
+
+```ruby
+bundle add resteze
+```
+
+Then run:
 
 ```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+bundle install
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+Or install it directly with:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+gem install resteze
 ```
 
 ## Usage
 
-TODO: Write usage instructions here
+### Building an API Client with Resteze
+
+To build an API client using Resteze, define a Ruby module for your API and include the `Resteze` concern. Then, create resource classes under your module that inherit from `ApiResource` and define properties for your API objects.
 
-## Development
+Here's a simple example:
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+```ruby
+require 'resteze'
+
+module MyCoolApi
+  include Resteze
+
+  # Configure your API client
+  configure do |config|
+    config.api_base = 'https://api.example.com/'
+    config.api_key = 'your-api-key'
+    config.logger = Logger.new($stdout)
+  end
+
+  # Define a resource
+  class Widget < ApiResource
+    property :id
+    property :name
+    property :status
+  end
+end
+
+# Usage example
+widget = MyCoolApi::Widget.retrieve(123)
+puts widget.name
+
+# List resources
+widgets = MyCoolApi::Widget.list
+widgets.each do |w|
+  puts w.id
+end
+```
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+You can define additional resources, customize paths, and add methods as needed. Resteze handles requests, responses, and error management for you, so you can focus on your API's business logic.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/resteze.
+Bug reports and pull requests are welcome on GitHub at https://github.com/rwx-services/resteze.
 
 ## License