nohead 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f80d6fdee7ba3b00716d16b5a0e0203b8e2b0c12e35cbf9747bb2e17a40335f
-  data.tar.gz: 413cce95b1bc00ae8c68ca6d4c951975940b5e5e61e1bb0ab9a807c4b9b32f5b
+  metadata.gz: 9b3361c68d640e8b2774b8e797bbf4108e19be21f0019600788d9f45e04457fe
+  data.tar.gz: d3c200b25b6afd1db440dced441f142da3d38b1731e34780356c373c2bc4b67c
 SHA512:
-  metadata.gz: 3a0ef2d3ca637467739881a7bc9ccf667d47d8419dafb2959290b2108e6ad8b7204661452272e218c73b5dee7c8c3f69611404a2253cb2b998f7ff1b3daec207
-  data.tar.gz: 3658e753b524d77745c43947edf2a5f4926b615adfa6fbd30bf46bea84a2c6f02210d9b40fdb7323497d879f2e96c59372dd483a8cde4402d9b41246b1c28517
+  metadata.gz: 409ee914aaf232ce8f7109b4628f260f47f6b83861dceb48aebeaee661873c03f5ebef3ccbbd6e269504febad9325505a3b97a2f42905bb279e81d76aef70f18
+  data.tar.gz: 87b158ed9116745555538a9ef4297c584050251e69d0bab6101b823e239b3586262f161901f519973b1b07c4f2f2b76dfcd78ac86c55eedb905b208867d96d60

data/CHANGELOG.md

@@ -5,6 +5,12 @@ Changes to the `nohead` gem that you can notice. Versions follow
 releases; a change that could break your code is a major one. Each release's
 section is its GitHub release's notes.
 
+## 0.7.0
+
+- `assets.list(q:, kind:)`: `q` finds assets whose filename or alt text has
+  every word, ignoring case; `kind` lists only `image`, `video`, `audio`,
+  `document` or `other` assets, or several kinds as an array.
+
 ## 0.6.0
 
 - API keys now start `nohead_sk_`, or `nohead_pk_` for published-only keys;

data/lib/nohead/resources/assets.rb

@@ -54,14 +54,18 @@ module Nohead
         @client.request("assets_complete", path: { asset_id: asset }, idempotency_key: idempotency_key)
       end
 
+      # `q` finds assets whose filename or alt text has every word, ignoring
+      # case ("hero jpg" finds `Hero-banner.jpg`). `kind` lists only assets of
+      # a kind ("image", "video", "audio", "document" or "other"), or of
+      # several (%w[image video]).
+      #
       # `content_type` lists only assets of a MIME type or `type/*` wildcard
       # ("image/*"), or of several (["image/*", "application/pdf"]), for
       # example the ones an asset field accepts (its `accepted_types`; an
       # empty list, like a field's, means any type).
-      def list(content_type: nil, deleted: nil, limit: nil, cursor: nil)
-        content_type = (content_type.empty? ? nil : { in: content_type }) if content_type.is_a?(Array)
-        @client.paginate("assets_list", query: { filter: { content_type: content_type, deleted: deleted },
-                                                 limit: limit, cursor: cursor })
+      def list(q: nil, kind: nil, content_type: nil, deleted: nil, limit: nil, cursor: nil)
+        filter = { kind: one_or_in(kind), content_type: one_or_in(content_type), deleted: deleted }
+        @client.paginate("assets_list", query: { q: q, filter: filter, limit: limit, cursor: cursor })
       end
 
       def get(asset)
@@ -106,6 +110,16 @@ module Nohead
       def download_url(asset)
         @client.request("assets_download_url", path: { asset_id: asset })
       end
+
+      private
+
+      # One value as it is, several as `[in]`; an empty list (like an asset
+      # field's accepted_types) is no filter.
+      def one_or_in(value)
+        return value unless value.is_a?(Array)
+
+        value.empty? ? nil : { in: value }
+      end
     end
   end
 end

data/lib/nohead/resources/records.rb

@@ -126,9 +126,9 @@ module Nohead
         @client.paginate("record_drafts_list", path: { record_id: record }, query: { limit: limit, cursor: cursor })
       end
 
-      # A collection's pending scheduled publishes and unpublishes, soonest
-      # first: one per change, so a record due to publish and later unpublish
-      # appears twice.
+      # A collection's pending scheduled changes, soonest first: publishes,
+      # unpublishes and draft merges, one per change, so a record due to
+      # publish and later unpublish appears twice.
       def scheduled_changes(collection, sort: nil, limit: nil, cursor: nil)
         @client.paginate("scheduled_changes_list", path: { collection_id: collection },
                                                    query: { sort: sort, limit: limit, cursor: cursor })

data/lib/nohead/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nohead
-  VERSION = "0.6.0"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nohead
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Nohead