CHANGELOG.md

Change Log

All notable changes to this project should be documented in this file. This project attempts to adhere to Semantic Versioning.

[master branch] - Unreleased changes

Breaking Changes

New Features

Fixes

[2.8.2]

Fixes

• Fix for frozen_string_literal in Ruby 3.4
• Add OpenStruct dependency explicitly for Ruby 3.5

[2.8.1]

Fixes

• Explicitly require OpenStruct, which isn't loaded by default anymore in new versions of Rake
• Ensure assets without extensions are handled correctly

[2.8.0]

New Features

• Add New config option raise_on_missing_assets
• Add support for truffleruby (22.1.0) on Linux

Fixes

• Fix Propshaft encoding issue
• Fix Webpacker & Shakapacker compatibility issue

[2.7.0]

New Features

• Support Shakapacker 7
• Add option delete_temporary_files to keep the temporary files generated by pdf_from_string method
• Add support for --allow flag

Fixes

• Add require for stringio, which is no longer loaded by default in Ruby 3.1+
• Fix CI build.
• Fix Header/footer temporary file is removed before wkhtmltopdf is called
• Bump rubocop to 1.46
• Add Ruby 3.2 to the test matrix

[2.6.3]

Fixes

• Fix typo of #possible_binary_locations
• Drop unused executables gemspec directive

[2.6.2]

Fixes

• Fix undefined local variable or method 'block' for render_to_string
• Add require for delegate, which is no longer loaded by default in Ruby 2.7+

[2.6.0]

New Features

• Support Propshaft in find_asset helper

Fixes

• Update Changelog with changes from 2.1.0
• Fix CI build for Rails 7.

[2.5.4] December 20th 2021 769f9df487f3c1e31dc91431666baa78d2aa24fb

New Features

• Test with Rails 7

Fixes

• Include view helper on view load.

[2.5.3] December 15th 2021 7991877de634067b4245fb47fdad65da43761887

• Fix check for webpacker version
• Complete transition to Github actions

[2.5.2] November 2021 - fix webpacker_source_url bdd0ca3eca759e277ce5461141b1506f56fefcd1

• fix: webpacker_source_url
• update README

[2.5.1] September 2021 - fix webpacker helper, github actions and Readme updates ae725e8055dc8f51a392c27767b4dcdcfffe155d

• Add comment about enable_local_file_access to README
• README updates &&
• Github actions
• Screencast links
• fix url generating in webpacker helper

[2.5.0] November 2020 Release - 2b1d47a84fce3600e7cbe2f50843af1a7b84d4a6

• Remove code for unsupported rails and ruby versions

[2.4.1] b56c46a05895def395ebc75ed8e822551c2c478f

• Extract reading in chunk
• add ruby 2.7 to the test matrix

[2.4.0] 8c007a77057e1a6680469d1ef53aa19a108fe209

New Features

• Do not unlink HTML temp files immediately (to enable HTML tempfile inspection)
• Read HTML string and generated PDF file in chunks (to reduce memory overhead of generating large PDFs)
• Add wicked_pdf_url_base64 helper

[2.3.1] - Allow bundler 2.x ee6a5e1f807c872af37c1382f629dd4cac3040a8

• Adjust gemspec development dependencies

[2.3.0] - Remove support for Ruby 1.x and Rails 2.x 66149c67e54cd3a63dd27528f5b78255fdd5ac43

• Remove support for Ruby 1.x and Rails 2.x

[2.2.0] - October 2020 release f8abe706f5eb6dba2fcded473c81f2176e9d717e

Fixes

• Make CI green again
• rubocop fixes

New Features

• Add support for --keep-relative-links flag
• Encapsulate binary path and version handling && #815

[2.1.0] - 2020-06-14

Fixes

• Document no_stop_slow_scripts in README
• Document how to use locals in README

New Features

• Improved support for Webpacker assets with wicked_pdf_asset_pack_path
• Support enabling/disabling local file access compatible with wkhtmltopdf 0.12.6
• Add option use_xvfb to emulate an X server

[2.0.2] - 2020-03-17

Fixes

• Force UTF-8 encoding in assets helper

[2.0.1] - 2020-02-22

Fixes

• Replace open-uri with more secure Net:HTTP.get

[2.0.0] - 2020-02-22

Breaking changes

• Remove support for older Ruby and Rails versions - This project no longer supports Ruby < 2.2 and Rails < 4. It may work for you, but we are no longer worrying about breaking backwards compatibility for versions older than these. If you are on an affected version, you can continue to use the 1.x releases. Patches to fix broken behavior on old versions may not be accepted unless they are highly decoupled from the rest of the code base.

New Features

• Add Rubygems metadata hash to gemspec
• Add support for Rails 6

Fixes

• Fix Webpacker helpers in production environment
• Fix unit tests

[1.4.0] - 2019-05-23

New Features

• Add support for log_level and quiet options

[1.3.0] - 2019-05-20

New Features

• Add support for Webpacker provided bundles

[1.2.2] - 2019-04-13

Fixes

• Fix issue loading Pty on Windows
• Fix conflict with remotipart causing SystemStackError

[1.2.1] - 2019-03-16

Fixes

• Fix SystemStackError in some setups

[1.2.0] - 2019-03-16

New Features

• Add raise_on_all_errors: true option to raise on any error that prints to STDOUT during PDF generation
• Add ability to use the assigns option to render to assign instance variables to a PDF template
• Add ability to track console progress with progress: -> (output) { puts output }. This is useful to add reporting hooks to show your frontend what page number is being generated.

Fixes

• Fix conflict with other gems that hook into render and avoid using alias_method_chain where possible
• Fix issue using the shell to locate wkhtmltopdf in a Bundler environment
• Fix wkhtmltopdf path detection when HOME environment variable is unset
• Fix error when the Rails constant is defined but not actually using Rails
• Fix compatibility issue with Sprockets 4
• Fix compatibility issue with Mime::JS in Rails 5.1+
• Fix deprecation warning by using after_action instead of after_filter when available
• Provide Rails base_path to find_asset calls for Sprockets file lookup
• Logger changes:
  • Use Rails.logger.debug instead of p
  • Change logger message to prepend [wicked_pdf] instead of nonstandard ****************WICKED****************
• Documentation changes:
  • Update link to wkhtmltopdf homepage
  • Update link to wkhtmltopdf_binary_gem
  • Update documentation for usage with the Asset Pipeline
  • Document default_protocol option
  • Document image and no_image options
  • Document issue with DPI/scaling on various platforms
  • Document creating and attaching a PDF in a mailer
  • Document dependency on wkhtmltopdf with RubyGems
  • Add example using WickedPDF with Rails in an API-only configuration
  • Add example for rending a template as a header/footer
  • Add GitHub issue template
  • Add CodeClimate Badge
• RuboCop cleanup
• Updates to Travis CI pipeline to support newer versions of Ruby & Rails

[1.1.0] - 2016-08-30

New Features

• Support Rails 5.x and Sprockets 3.x
• Support window_status: 'somestring' option, to instruct wkhtmltopdf to wait until the browser window.status is equal to the supplied string. This can be useful to force rendering to wait as explained quite well here
• Support no_stop_slow_scripts: true to let slow running scripts delay rendering
• Changes to asset finding to support Rails 5

Fixes

• Improved error handling
• Namespace helper classes under WickedPdf namespace

[1.0.6] - 2016-04-04

Fixes

• Revert shell escaping of options. The fix was causing more issues than it solved (like "[page] of [topage]" being escaped, and thus not parsed by wkhtmltopdf). See #514 for details.

[1.0.5] - 2016-03-28

Fixes

• Numerous RuboCop style violation fixes, spelling errors, and test-setup issues from indyrb.org hack night. Thank you all for your contributions!
• Shellescape options. A stray quote in header or footer would cause PDF to fail to generate, and this should close down many potential attack vectors if you allow user-supplied values to be passed into wicked_pdf render options.

[1.0.4] - 2016-01-26

Fixes

• Check that logger responds to info before calling it. It was possible to have a logger method defined as a controller helper that would override Rails.logger.
• Issue with Sprockets 3.0 where an asset referenced in a stylesheet not existing would raise an exception read_asset on nil.

[1.0.3] - 2015-12-02

Fixes

• Revert default DPI. Some installs of wkhtmltopdf would experience major slowdowns or crashes with it set to 72. It is suggested that a DPI of 75 may be better, but I'm holding off on making it a default without more information.

[1.0.2] - 2015-11-30

Fixes

• The default dpi is now 72. Previously the default would be whatever your wkhtmltopdf version specified as the default. This change speeds up generation of documents that contain border-radius dramatically

[1.0.1] - 2015-11-19

Fixes

• Made minor RuboCop style tweaks.
• Added default RuboCop config and run after test suite.
• Issue with nil.basename from asset helpers.

[1.0.0] - 2015-11-03

Breaking Changes

• Accepted that WickedPDF cannot guarantee backwards compatibility with older versions of wkthmltopdf, and decided to publish a new version with the MAJOR number incremented, signaling that this may have breaking changes for some people, but providing a path forward for progress. This release number also signals that this is a mature (and relatively stable) project, and should be deemed ready for production (since it has been used in production since ~2009, and downloaded over a million times on RubyGems.org).
• Stopped attempting to track with version number of wkhtmltopdf binary releases (wkhtmltopdf v9.x == WickedPDF v9.x)
• Adopted Semantic Versioning for release numbering
• Added a CHANGELOG (based on keepachangelog.com)
• Misc code tweaks as suggested by RuboCop

New Features

• Check version of wkhtmltopdf before deciding to pass arguments with or without dashes
• New arguments and options for the table of contents supported in newer versions of wkhtmltopdf: text_size_shrink, level_indentation, disable_dotted_lines, disable_toc_links, xsl_style_sheet
• Merge in global options to pdf_from_html_file and pdf_from_string
• Add ability to generate pdf from a web resource: pdf_from_url(url)
• Removed explicit dependency on Rails, since parts of this library may be used without it.

Fixes

• Comment out the :exe_path option in the generated initializer by default (since many systems won't have wkthmltopdf installed in that specific location)
• Issues with file:// paths on Windows-based systems
• Issues with parsed options/argument ordering on versions of wkthmltopdf > 0.9
• Issues with middleware headers when running Rails app mounted in a subdirectory
• Issues with options that have a key: 'value' syntax when passed to wkthmltopdf
• Issue with :temp_path option being deleted from original options hash
• Issue with header/footer :content being deleted after the first page
• Issues with options being modified during processing (including global config options)
• Issues with asset helpers recognizing assets specified without a protocol
• Issues with url() references and embedded data:base64 assets in stylesheets rendered with wicked_pdf_stylesheet_link_tag
• Asset helpers no longer add a file extension if it already is specified with one