fmrest-spyke 0.21.0 → 0.23.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d82defdc68f56e1e3e2a9f4d7e2fb09fcfe85fbfd4d839a72d07e13328301f0
-  data.tar.gz: 80055c0eee52a2acc819c92d737ddb1eeb758f99b19f3864468379b10f461465
+  metadata.gz: a4e30c2055c096479e79ba9c5d4fd2d5376ba854b9295cb8936e81a86fc4e231
+  data.tar.gz: d18a1d36aca81732e4e90d67a13575d5e891f6504e48f8e7df529d23acaf576d
 SHA512:
-  metadata.gz: 88b6edba4e6f98d53ddad102a7c9ae9d80589396487b623a08d0ec0470cac42c9d97fddabe0c91d87d30b6aa9003b34aa888f7d4e44680675b7abfca9fd53ed3
-  data.tar.gz: 9f28167114c3c614705abd21256bbd53d30c11766802b98dc776729f5609a3742bf789a1fd63635745b186c61b49a1f397fda4af30820f935df5254339c4410d
+  metadata.gz: 4e1748cc9448aa032c4683ba809a7298e3f6a9ef4530ac7811ee0d24cabe9911ddd447f4773af06919a5bbb0c08fd85ae4e5908ee14f87f88f7fd6ae7778e05c
+  data.tar.gz: b8e6828dcf31aeb7a6443483d560e529833606b0a55e2454532db855d4d3bef9e4357aaa3c1bff073015df0d2370047826ba38f555631ed9a0ac8f4add2a9609

data/.yardopts

@@ -1,5 +1,6 @@
 --markup markdown
 --plugin activesupport-concern
-lib/**/*.rb
+--exclude lib/generators/*
 -
+lib/**/*.rb
 docs/*

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## Changelog
 
+### 0.23.1
+
+* Fix crash when booting in Rails and `config/fmrest.yml` didn't exist
+
+### 0.23.0
+
+* Add `find_one!` (aliased as `first!`) exception-raising method
+* Add mapping of API exceptions to HTTP responses in Rails
+
+### 0.22.0 
+
+* Add `fmrest-rails` gem with Rails integration (initializer, generators)
+
 ### 0.21.0
 
 * Support for Spyke 7 and Faraday 2

data/README.md

@@ -19,13 +19,14 @@ Need Ruby or FileMaker consulting? Contact us at
 
 ## Gems
 
-The `fmrest` gem is a wrapper for two other gems:
+The `fmrest` gem is a wrapper for these gems:
 
 * `fmrest-spyke`, providing an ActiveRecord-like ORM library built on top
   of `fmrest-core` and [Spyke](https://github.com/balvig/spyke).
 * `fmrest-core`, providing the core
   [Faraday](https://github.com/lostisland/faraday) connection builder, session
   management, and other core utilities.
+* `fmrest-rails`, providing Rails integration.
 
 In addition, the optional `fmrest-cloud` gem adds support for FileMaker Cloud.
 See the [main document on connecting to FileMaker
@@ -42,6 +43,12 @@ gem 'fmrest'
 gem 'fmrest-cloud'
 ```
 
+If you're using Rails you can now run:
+
+```
+rails generate fmrest:config
+```
+
 ## Simple example
 
 ```ruby

data/lib/fmrest/spyke/model/orm.rb

@@ -18,10 +18,6 @@ module FmRest
           class_attribute :default_limit, instance_accessor: false, instance_predicate: false
 
           class_attribute :default_sort, instance_accessor: false, instance_predicate: false
-
-          # Whether to raise an FmRest::APIError::NoMatchingRecordsError when a
-          # _find request has no results
-          class_attribute :raise_on_no_matching_records, instance_accessor: false, instance_predicate: false
         end
 
         class_methods do
@@ -42,10 +38,14 @@ module FmRest
           # options, as well as using the appropriate HTTP method/URL depending
           # on whether there's a query present in the current scope.
           #
+          # @option options [Boolean] :raise_on_no_matching_records whether to
+          #   raise `APIError::NoMatchingRecordsError` when no records match (FM
+          #   error 401). If not given it returns an empty resultset.
+          #
           # @example
           #   Person.query(first_name: "Stefan").fetch # -> POST .../_find
           #
-          def fetch
+          def fetch(options = {})
             if current_scope.has_query?
               scope = extend_scope_with_fm_params(current_scope, prefixed: false)
               scope = scope.where(query: scope.query_params)
@@ -60,9 +60,9 @@ module FmRest
             # nothing matches a _find request, so we need to catch it in order
             # to provide sane behavior (i.e. return an empty resultset)
             begin
-              current_scope.has_query? ? scoped_request(:post) : super
+              current_scope.has_query? ? scoped_request(:post) : super()
             rescue FmRest::APIError::NoMatchingRecordsError => e
-              raise e if raise_on_no_matching_records
+              raise e if options[:raise_on_no_matching_records]
               ::Spyke::Result.new({})
             end
           ensure

data/lib/fmrest/spyke/relation.rb

@@ -276,13 +276,15 @@ module FmRest
       # Finds a single instance of the model by forcing limit = 1, or simply
       # fetching the record by id if the primary key was set
       #
+      # @option (see FmRest::Spyke::Model::ORM.fetch)
+      #
       # @return [FmRest::Spyke::Base]
-      def find_one
+      def find_one(options = {})
         @find_one ||=
           if primary_key_set?
-            without_collection_params { super }
+            without_collection_params { super() }
           else
-            klass.new_collection_from_result(limit(1).fetch).first
+            klass.new_collection_from_result(limit(1).fetch(options)).first
           end
       rescue ::Spyke::ConnectionError => error
         fallback_or_reraise(error, default: nil)
@@ -290,6 +292,18 @@ module FmRest
       alias_method :first, :find_one
       alias_method :any, :find_one
 
+      # Same as `#find_one`, but raises `APIError::NoMatchingRecordsError` when
+      # no records match.
+      # Equivalent to calling `find_one(raise_on_no_matching_records: true)`.
+      #
+      # @option (see FmRest::Spyke::Model::ORM.fetch)
+      #
+      # @return [FmRest::Spyke::Base]
+      def find_one!(options = {})
+        find_one(options.merge(raise_on_no_matching_records: true))
+      end
+      alias_method :first!, :find_one!
+
       # Yields each batch of records that was found by the find options.
       #
       # NOTE: By its nature, batch processing is subject to race conditions if

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fmrest-spyke
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.23.1
 platform: ruby
 authors:
 - Pedro Carbajal
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-05-12 00:00:00.000000000 Z
+date: 2022-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fmrest-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.21.0
+        version: 0.23.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.21.0
+        version: 0.23.1
 - !ruby/object:Gem::Dependency
   name: spyke
   requirement: !ruby/object:Gem::Requirement