decant 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff0fe21b57ea4db012b2cedce3a14b6e8b34186a85071525949431524f0cdc4b
-  data.tar.gz: a6953eace2994504c734d002f8357aacb1b0563a6a31513684826888c7aefe59
+  metadata.gz: 7d32c0ae7327b06ec1bb31a9d48fedef546f4fad06f842a62e0f55c991b2a7ca
+  data.tar.gz: 5c12770cb43243d034b513d40e36684cc775a31866eb4f909751a44eb25da7c2
 SHA512:
-  metadata.gz: 66aee785137091d9a134161e3b45cd60b85e7e8d1d4f5a9a7601d4b389b83a1f408d0b08bd15460a101379c00137d568ee6070a699b28571dfaab6aea1a8ec40
-  data.tar.gz: fc536bc67d8a596add87ebb75ded2cd81bbbda22f93e0ae7b1b9e6de01fc46c5b565b83415a119bf4edf37552e36efc98ca91550784cfb91e54e0781e03decd7
+  metadata.gz: e60a0037d18fc03e59704e16c2915ea2c108e7d91e9e811c75f61aadd993e7199880257e96a86ef68681ef5004e61f21dc7c3a08cfefd3a33221fdcddff3a7e5
+  data.tar.gz: db533bba59b5c0ccae359cc5a8f7f8b839b9d76d4765f77d95b5141224237335a91ac91e35883a3ceb34e88b9ea97672e7b58d183c1b5f2f8aad98316398d1d2

data/CHANGELOG.md

@@ -1,8 +1,16 @@
 # CHANGELOG
 
+## Version 0.4.0 - 2025-06-30
+
+- Add `Content.glob` which uses its collection's glob method and returns instances of the class.
+
+## Version 0.3.0 - 2024-11-19
+
+- Add `Content#relative_path` which returns a file's relative path within its collection.
+
 ## Version 0.2.0 - 2024-10-13
 
-- Add support for a content instance knowing its own `#slug` - its relative path within its collection:
+- Add support for a content instance knowing its own `#slug` - its extension-less relative path within its collection:
 
   ```ruby
   Page = Decant.define(dir: 'content', ext: 'md')

data/README.md

@@ -2,7 +2,7 @@
 
 [![Ruby](https://github.com/benpickles/decant/actions/workflows/main.yml/badge.svg)](https://github.com/benpickles/decant/actions/workflows/main.yml)
 
-A frontmatter-aware wrapper around a directory of static content.
+A dependency-free frontmatter-aware framework-agnostic wrapper around a directory of static content.
 
 ## Installation
 

data/lib/decant/collection.rb

@@ -44,13 +44,22 @@ module Decant
       dir.glob("#{pattern}#{ext}").select { |path| path.file? }
     end
 
+    # The relative path of +path+ within {#dir}.
+    #
+    # @param path [Pathname]
+    #
+    # @return [String]
+    def relative_path_for(path)
+      path.relative_path_from(dir).to_s
+    end
+
     # The extension-less relative path of +path+ within {#dir}.
     #
     # @param path [Pathname]
     #
     # @return [String]
     def slug_for(path)
-      relative_path = path.relative_path_from(dir).to_s
+      relative_path = relative_path_for(path)
 
       # The collection has no configured extension, files are identified by
       # their full (relative) path so there's no extension to remove.

data/lib/decant/content.rb

@@ -47,6 +47,27 @@ module Decant
           end
         end
       end
+
+      # @param pattern [String]
+      #
+      # @return [Array<Content>]
+      def glob(pattern)
+        collection.glob(pattern).map { |path| new(path) }
+      end
+    end
+
+    # The relative path of the file within its collection.
+    #
+    # @example
+    #   Page = Decant.define(dir: 'content', ext: 'md')
+    #
+    #   page = Page.find('features/slugs')
+    #   page.path.expand_path # => "/Users/dave/my-website/content/features/slugs.md"
+    #   page.relative_path    # => "features/slugs.md"
+    #
+    # @return [String]
+    def relative_path
+      self.class.collection.relative_path_for(path)
     end
 
     # The extension-less relative path of the file within its collection.

data/lib/decant/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Decant
-  VERSION = '0.2.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: decant
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Ben Pickles
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-13 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: A frontmatter-aware wrapper around a directory of static content
+description: A dependency-free frontmatter-aware framework-agnostic wrapper around
+  a directory of static content
 email:
 - spideryoung@gmail.com
 executables: []
@@ -39,7 +39,6 @@ metadata:
   source_code_uri: https://github.com/benpickles/decant
   changelog_uri: https://github.com/benpickles/decant/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -54,8 +53,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.16
-signing_key:
+rubygems_version: 3.6.7
 specification_version: 4
-summary: A frontmatter-aware wrapper around a directory of static content
+summary: A dependency-free frontmatter-aware framework-agnostic wrapper around a directory
+  of static content
 test_files: []