precompiled_assets 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8def5c63790a7b16733d25ec1875e7fb294dca734ef389cc26f30b093b41c39
-  data.tar.gz: a3db5b16a4dd0fbd55d3e8d0f907de84b3db35269c5c005ee97891cb612d798a
+  metadata.gz: 0f0320f9e06f583c9ef4ff7bbcd1aef431a96aec01aa6a45666545c4041af3f9
+  data.tar.gz: 46a10e8013605de64bc3e3f409249f0820df85290900b521d582408a9086e136
 SHA512:
-  metadata.gz: a794f9316533f5422397e3ea950e1529cef6c64326bcec41df60ef122464833ca77e49222fe0c1ce9f7e21a963ddf8ba9007e2a774ffd8f5717187acf37b2a4c
-  data.tar.gz: cc1743713e3a27b962f0e4910cc5f67eec72ef00345b6d07da164d08748356382603900d3ee2d058fab02bb9411bcf80b43727408160eab60854142aa741dbd5
+  metadata.gz: 3758f0bc4631ea3bc7e1b0f32ca3d93591e01999715567e245f6f099fa8c4882e44291c898f5fa394308a9fdd8ac054c31e756a16585ce845632ee46c3e7f866
+  data.tar.gz: 7cff3b5686510acfda6d36c0bc3e7dde5347bdb3a25ebbb336a96908d0a331507c4e633cfab3a8b22845df59472b5cbbd9a04c6969d0608e7e0524d2eb71c68c

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.2.0] - 2022-08-04
+
+- `Manifest#updated_at` now exposes manifest's modification time.
+- Updated readme document.
+
 ## [0.1.0] - 2022-07-27
 
 - First public release.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    precompiled_assets (0.1.0)
+    precompiled_assets (0.2.0)
       railties (>= 6.0.0)
 
 GEM

data/README.md

@@ -21,6 +21,8 @@ If bundler is not being used to manage dependencies, install the gem by executin
 
 ## Usage
 
+### Configuration
+
 In your `config/application.rb`, configure an `asset_path` which should be in your `public/` directory:
 
 ```ruby
@@ -45,6 +47,26 @@ Once that is set up, `javascript_include_tag('application.js')` or `image_path('
 In the `development` Rails environment, the gem detects changes to the manifest and reloads the manifest automatically.
 Hence, your development experience should be similar to other stacks, like with Propshaft or esbuild: You change assets, the manifest changes, Rails will then resolve to the updated asset paths. 🎉
 
+### Accessing manifest or resolver manually
+
+In views, you can use the helper method `asset_resolver` to access the (cached) resolver instance.
+Otherwise, instantiate via `PrecompiledAssets::Resolver.new`.
+
+To resolve an asset path, use `Resolver#resolve`:
+```ruby
+resolver = PrecompiledAssets::Resolver.new
+resolver.resolve('application.js')
+# => "/assets/application-HP2LS2UH.js"
+```
+
+If you want to know if assets were updated (e.g. when using etags), use `Manifest#updated_at`:
+```ruby
+resolver = PrecompiledAssets::Resolver.new
+resolver.manifest.updated_at
+# => (returns a Time instance)
+```
+
+Side note: `Manifest#updated_at` reads its motification time from the file system. If your production environments use a distributed file system, it is not recommended for etagging in production.
 
 
 ## Development
@@ -54,6 +76,12 @@ After checking out the repo, run `bin/setup` to install dependencies. You can al
 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).
 
 
+## Roadmap
+
+1. Add tests
+2. Integrate into more existing applications to discover new features that we might need.
+
+
 ## Contributing
 
 I am very eager to keep this gem lightweight and on topic.

data/lib/precompiled_assets/manifest.rb

@@ -19,9 +19,14 @@ module PrecompiledAssets
       digested_paths.include?(path_or_pathname.to_s)
     end
 
+    def updated_at
+      # Not intended for use in production environments.
+      @mtime || fetch_mtime
+    end
+
     def expired?
       # Not intended for use in production environments.
-      @mtime && @mtime != fetch_mtime
+      @time && @time != fetch_mtime
     end
 
     private

data/lib/precompiled_assets/version.rb

@@ -1,3 +1,3 @@
 module PrecompiledAssets
-  VERSION = '0.1.0'.freeze
+  VERSION = '0.2.0'.freeze
 end

data/precompiled-assets.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
     'rubygems_mfa_required' => 'true',
     'homepage_uri' => spec.homepage,
     'source_code_uri' => spec.homepage,
-    'changelog_uri' => "#{spec.homepage}/CHANGELOG.md",
+    'changelog_uri' => "#{spec.homepage}/blob/main/CHANGELOG.md",
   }
 
   spec.files = Dir.chdir(__dir__) do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: precompiled_assets
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Arne Hartherz
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-07-27 00:00:00.000000000 Z
+date: 2022-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -57,7 +57,7 @@ metadata:
   rubygems_mfa_required: 'true'
   homepage_uri: https://github.com/makandra/precompiled_assets
   source_code_uri: https://github.com/makandra/precompiled_assets
-  changelog_uri: https://github.com/makandra/precompiled_assets/CHANGELOG.md
+  changelog_uri: https://github.com/makandra/precompiled_assets/blob/main/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: