kamisaku 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08311183150f22bf9897f33d7ecb93616573e99b90a49455efd27747316b3a5b'
-  data.tar.gz: b198531b11fdf5b409c1b9c39be5ca04c64a1b9174a867f38e93f7d928f534e9
+  metadata.gz: 3c2b9b3a11f581cc1ee84330c7813cfc6e2875616de64d41fde78ad710891916
+  data.tar.gz: a54225bf6e5851ead275215047393339cbca5bd8834d9a2030fb4a121b0aded2
 SHA512:
-  metadata.gz: 621551dfa5fa5bf482ccccf5e8fb72a7a12b2736ed397f8a813f85274f8f33db09e1ffed4d1846dbd3dbb75f2ffc7abb53dd719229c1d00946945050949517d8
-  data.tar.gz: 6434717f692966c901becca7a7573ee69ed69b63516bdf356ea826c7d27302255dad520e72ac86519b87213ade8319d3a064de0f9991c5cf69f3242a3918aa20
+  metadata.gz: ba93279fffb6b6f6af37123a580d6084bd3d570870167c7eb912ce3950b18d8affa157eb1adbc253f463bf293803270ef17c4b66eec26b444b4f3c7754005eda
+  data.tar.gz: b097d987aa90f78b613738e096e8ffb4218dba1de43e5ff796d3092e21a6a07ed47d803b126baab0f3bc8aebc01326254adac3a1dfafab4f8d6c830bca1396c4

data/CHANGELOG.md

@@ -13,6 +13,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.3.2] - 2025.06.01
+
+### Added
+- Template name validation to `Kamisaku::PDF` interface
+
 ## [0.3.1] - 2025-06-01
 
 ### Changed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    kamisaku (0.3.1)
+    kamisaku (0.3.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -2,15 +2,47 @@
 
 *Build a CV PDF from a yaml text file.*
 
+🚀 See it in action at [https://kamisaku.sinaru.com/](https://kamisaku.sinaru.com/).
+
 [![Gem Version](https://badge.fury.io/rb/kamisaku.svg)](https://badge.fury.io/rb/kamisaku)
 
 ![Kamisaku](kamisaku.png)
 
 See [examples](/examples) directory for sample generated PDF files based of [templates](/lib/templates).
 
+## Templates
+For a list of templates availble for CV generation, check the [examples](/examples) directory where each directory name is a template name.
+
+## Installation
+
+This is a Ruby gem. So you can either install as a gem or clone the repo and use `bin/console` file run from terminal.
+
+### Dependency Requirement
+- Ruby 3.4.3
+- Ensure that [Google Chrome](https://www.google.com/chrome/) is installed.
+- Chrome must be accessible from the terminal as `google-chrome`.
+  - Kamisaku uses Chrome's [headless mode](https://developer.chrome.com/docs/chromium/headless/) to generate PDF files.
+- Ensure `exiftool` is installed available in command line.
+  - exiftool is used to soft remove metadata added by chrome in the PDF file.
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'kamisaku'
+```
+
+And then execute:
+```bash
+$ bundle install
+```
+Or install it yourself as:
+```bash
+$ gem install kamisaku
+```
+
 ## Usage
 
-First we need to have a `yaml` file with the CV data. The yaml file supports following sections.
+First we need to have a `yaml` file or a string with the CV data. The gem supports the following sections.
 
 ```yaml
 version: 1
@@ -69,36 +101,6 @@ education:
       - # Things you have achieved or did
 ```
 
-## Template
-For a list of templates availble for CV generation, check the [examples](/examples) directory where each directory name is a template name.
-
-## Installation
-
-This is a Ruby gem. So you can either install as a gem or clone the repo and use `bin/console` file run from terminal.
-
-### Dependency Requirement
-- Ruby 3.4.3
-- Ensure that [Google Chrome](https://www.google.com/chrome/) is installed.
-- Chrome must be accessible from the terminal as `google-chrome`.
-  - Kamisaku uses Chrome's [headless mode](https://developer.chrome.com/docs/chromium/headless/) to generate PDF files.
-- Ensure `exiftool` is installed available in command line.
-  - exiftool is used to soft remove metadata added by chrome in the PDF file.
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'kamisaku'
-```
-
-And then execute:
-```bash
-$ bundle install
-```
-Or install it yourself as:
-```bash
-$ gem install kamisaku
-```
-
 ## Generating PDF
 
 ### Using terminal
@@ -115,6 +117,21 @@ bin/console -c examples/paper/john_doe.yml -o examples/paper/john_doe.pdf  -t pa
 - `-o` output location for the PDF file including the name
 - `-t` template to use
 
+### Using `PDF` class
+
+```ruby
+# Have a YAML string
+yaml_str = "..."
+# Create a hash
+content_hash = Kamisaku::Helpers.yaml_str_to_content_hash(yaml_str)
+# Validate the hash is correct. If there is any issue, it will raise a ` Kamisaku::Error ` exception.
+Kamisaku::ContentValidator.new(content_hash:).validate!
+# create a pdf instance
+pdf = Kamisaku::PDF.new(content_hash:, template: "paper")
+# create the PDF at given path
+pdf.write_to('/path/to/generated_file.pdf')
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/kamisaku/pdf.rb

@@ -6,6 +6,8 @@ module Kamisaku
       @content_hash = content_hash
       @template = template || "sleek"
       ContentValidator.new(content_hash:).validate!
+      raise Error, "Invalid template name '#{template}'" unless template.is_a?(String)
+      raise Error, "Invalid template name '#{template}'" unless TemplateHelpers::TEMPLATES.include? @template
     end
 
     def write_to(pdf_location)

data/lib/kamisaku/template_helpers.rb

@@ -2,6 +2,8 @@ require "date"
 
 module Kamisaku
   module TemplateHelpers
+    TEMPLATES = %w[paper sleek].freeze
+
     def month_name(month_int)
       return "" if month_int.nil?
 

data/lib/kamisaku/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kamisaku
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kamisaku
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Sinaru Gunawardena