keystone_ui-pages 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a26feddb5cd80b4e5a676159463899d2aa3f8956e0a9e3a2a7cfdc2a9645a61
-  data.tar.gz: 118357d59feb0e62eeb1aa9c04a327fc59ee13683e7878023990ec0388542939
+  metadata.gz: 77da11cab12ab896f890ea203bdf2f4b346603a1a0de8163359adf0fb1f8a608
+  data.tar.gz: abed3bcb29768934b84651c448105a9a75d6480c5000149b3473d3ce7250eb6e
 SHA512:
-  metadata.gz: 9aee570200cb37d2bf6be9c90dec6202087b85c4cefe4a448607df0b26f274f162f5c73a85a456659404b4508541d6e6fe53da3c227877bcde74acaaa75baafe
-  data.tar.gz: b1413f0fc7236cbfcc7769ba870726b4e79addd6d786705e1eaf5b10e6feb6f602d05a4ad5b68238b0bf67ac2a3aee9a83b24b260fa7a213d41569f3d767bc17
+  metadata.gz: 9bc3c8e60570178ccc5c4ef7029a6fe9cad8039187cb5649039cd85b3162d2a349814987825326834f0d4a8d1791dfbb0f5a2abab60b2e578e470d804f6003b0
+  data.tar.gz: 68dea7bf498637cf98b1233afb11f509ff45be2e030a6d3ab4ce150dd2f7b289cca9e80a3ef9b23900aa4d3f85e7f8a82b1cd1b1f7fb1d2658a3ecaf0fb6752f

data/app/jobs/keystone_ui/pages/pdf_job.rb

@@ -3,8 +3,8 @@
 module KeystoneUi
   module Pages
     class PdfJob < ActiveJob::Base
-      def perform(page, values)
-        KeystoneUi::Pages.pdf(page, values: values)
+      def perform(page, values, version = nil)
+        KeystoneUi::Pages.pdf(page, values: values, version: version)
       end
     end
   end

data/lib/keystone_ui/pages/pdfs.rb

@@ -9,8 +9,8 @@ module KeystoneUi
     module Pdfs
       module_function
 
-      def for(page, values: {})
-        version = page.versions.live.first
+      def for(page, values: {}, version: nil)
+        version = version ? page.versions.find_by(number: version) : page.versions.live.first
         digest = Operations.digest(values.to_h.stringify_keys)
         Pdf.find_by(version: version, values_digest: digest) || Pdf.create!(version: version, values_digest: digest,
           file: { io: StringIO.new(Printer.pdf(PdfDocument.html(version, values: values))), filename: "#{page.slug}.pdf", content_type: "application/pdf" })

data/lib/keystone_ui/pages/version.rb

@@ -2,6 +2,6 @@
 
 module KeystoneUi
   module Pages
-    VERSION = "0.5.0"
+    VERSION = "0.6.0"
   end
 end

data/lib/keystone_ui/pages.rb

@@ -37,13 +37,13 @@ module KeystoneUi
       end
     end
 
-    def self.pdf(page, values: {})
+    def self.pdf(page, values: {}, version: nil)
       require "keystone_ui/pages/pdfs"
-      Pdfs.for(page, values: values)
+      Pdfs.for(page, values: values, version: version)
     end
 
-    def self.prepare_pdf(page, values: {})
-      PdfJob.perform_later(page, values.to_h.stringify_keys)
+    def self.prepare_pdf(page, values: {}, version: nil)
+      PdfJob.perform_later(page, values.to_h.stringify_keys, version)
     end
 
     def self.catalog

data/the_local/agents/keystone_ui-pages-develop.md

@@ -120,15 +120,17 @@ inherit from the base controller, so define it there.
   unpublished or archived. It returns nil when the page has no version with
   that number. A record made from a page keeps the number it was made with
   and passes it here, so it keeps drawing the same way after later publishes.
-- `KeystoneUi::Pages.pdf(page, values: {})` — returns a
+- `KeystoneUi::Pages.pdf(page, values: {}, version: nil)` — returns a
   `KeystoneUi::Pages::Pdf` record for the page's live version drawn with the
   values given. Its `file` is an Active Storage attachment, ready to download,
-  link or email. The same live version and values return the record already
+  link or email. The same version and values return the record already
   kept, and a newly published version or different values print a new one.
-  When nothing is kept it prints in the current request.
-- `KeystoneUi::Pages.prepare_pdf(page, values: {})` — queues
+  When nothing is kept it prints in the current request. `version:` takes a
+  published version's number and prints that version instead, live or
+  superseded, the same way `keystone_ui_page` draws it.
+- `KeystoneUi::Pages.prepare_pdf(page, values: {}, version: nil)` — queues
   `KeystoneUi::Pages::PdfJob`, which calls `KeystoneUi::Pages.pdf` with the same
-  page and values, so the file is kept before anyone asks for it.
+  page, values and version, so the file is kept before anyone asks for it.
 
 ### The builder and the editor's screens
 
@@ -276,8 +278,8 @@ The catalog offers these Keystone UI components by default: `button`,
   layout and print rules together.
 - **Only the live version leaves the builder.** The draft is what editors
   change. Visitors, `keystone_ui_page` and PDFs show the live version, so an
-  unpublished change shows nowhere else. `keystone_ui_page` with `version:`
-  shows an earlier published version, never the draft.
+  unpublished change shows nowhere else. `keystone_ui_page` and PDFs with
+  `version:` show an earlier published version, never the draft.
 - **Value names are strings.** `Values.names`, the provider's hash and the
   `values:` passed to the helper and to PDFs all use the same names. The gem
   turns symbol keys into strings, so either works, but the names must match.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: keystone_ui-pages
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Tyler Schneider