From 7692f674bc4d813cac2b999f5380205e363a4e66 Mon Sep 17 00:00:00 2001
From: Vadim Kononov <vadim@konoson.com>
Date: Sat, 19 Nov 2022 15:40:39 -0600
Subject: [PATCH] Fix an issue with incorrect or blank checkbox appearances.
 (#29)

In a previous commit, iText's `generateAppearance` field was set to true for all fields except checkboxes in order to enable custom checkboxes to show correctly. However, this had unintended consequences for some developers where checkboxes with the default appearance were completely blank.

In order to work correctly with both custom checkboxes (such as square, circle, diamond, or other) and default checkboxes, developers can now set `generate_appearance` themselves to whatever suits their type of PDF file.
---
 .rubocop.yml        |   1 +
 README.md           |  86 ++++++++++++++++++++++++++++++++++----------
 example/run.rb      |   7 ++--
 images/blank.png    | Bin 0 -> 5087 bytes
 images/checked.png  | Bin 0 -> 6965 bytes
 images/distinct.png | Bin 0 -> 6233 bytes
 lib/fillable-pdf.rb |  21 ++++++-----
 test/pdf_test.rb    |  14 +++++++-
 8 files changed, 98 insertions(+), 31 deletions(-)
 create mode 100755 images/blank.png
 create mode 100755 images/checked.png
 create mode 100755 images/distinct.png

diff --git a/.rubocop.yml b/.rubocop.yml
index 2993c27..6be802b 100644
--- a/.rubocop.yml
+++ b/.rubocop.yml
@@ -29,6 +29,7 @@ Layout/LineLength:
     - README.md
     - fillable-pdf.gemspec
   Max: 120
+  AllowedPatterns: ['^(\s*#)']
 
 Layout/SpaceInsideHashLiteralBraces:
   Enabled: false
diff --git a/README.md b/README.md
index f114f82..d65f6ce 100644
--- a/README.md
+++ b/README.md
@@ -23,9 +23,35 @@ FillablePDF is an extremely simple and lightweight utility that bridges iText an
 
 4. Read-only, write-protected or encrypted PDF files are currently not supported.
 
-5. Adobe generated field arrays (i.e. fields with names such as `array.0` or `array.1.0`) are not supported. 
+5. Adobe generated field arrays (i.e. fields with names such as `array.0` or `array.1.0`) are not supported.
 
 
+## Troubleshooting Issues
+
+### Blank Fields
+
+* **Actual Result:**
+
+  ![Blank](images/blank.png)
+
+* **Expected Result:**
+
+  ![Blank](images/checked.png)
+
+If only of the fields are blank, try setting the `generate_appearance` flag to `true` when calling `set_field` or `set_fields`.
+
+### Invalid Checkbox Appearances
+
+* **Actual Result:**
+
+  ![Blank](images/checked.png)
+
+* **Expected Result:**
+
+  ![Blank](images/distinct.png)
+
+If your checkboxes are showing incorrectly, it's likely because iText is overwriting your checkbox appearances. Try setting the `generate_appearance` flag to `false` when calling `set_field` or `set_fields`.
+
 ## Installation
 
 **Prerequisites:** Java SE Development Kit v8, v11
@@ -131,19 +157,21 @@ An instance of `FillablePDF` has the following methods at its disposal:
     pdf.num_fields
     ```
 
-* `field`
+* `field(key)`
     *Retrieves the value of a field given its unique field name.*
 
     ```ruby
     pdf.field(:full_name)
+    pdf.field('full_name')
     # output example: 'Richard'
     ```
 
-* `field_type`
+* `field_type(key)`
     *Retrieves the string type of a field given its unique field name.*
 
     ```ruby
     pdf.field_type(:football)
+    pdf.field_type('football')
     # output example: '/Btn'
 
     # list of all field types
@@ -157,6 +185,7 @@ An instance of `FillablePDF` has the following methods at its disposal:
 
     ```ruby
     pdf.field_type(:football) == Field::BUTTON
+    pdf.field_type('football') == Field::BUTTON
     ```
 
 * `fields`
@@ -167,52 +196,71 @@ An instance of `FillablePDF` has the following methods at its disposal:
     # output example: {first_name: "Richard", last_name: "Rahl"}
     ```
 
-* `set_field`
-    *Sets the value of a field given its unique field name and value.*
+* `set_field(key, value, generate_appearance: nil)`
+    *Sets the value of a field given its unique field name and value, with an optional `generate_appearance` directive.*
 
     ```ruby
     pdf.set_field(:first_name, 'Richard')
+    pdf.set_field('first_name', 'Richard')
     # result: changes the value of 'first_name' to 'Richard'
     ```
 
-* `set_fields`
-    *Sets the values of multiple fields given a set of unique field names and values.*
+  Optionally, you can choose to override iText's `generateAppearance` flag to take better control of your field's appearance, using `generate_appearance`. Passing `true` will force the field to generate its own appearance, while setting it to `false` would leave the appearance generation up to the PDF viewer application. Omitting the parameter would allow iText to decide what should happen.
+
+    ```ruby
+    pdf.set_field(:first_name, 'Richard', generate_appearance: true)
+    pdf.set_field('first_name', 'Richard', generate_appearance: false)
+    ```
+
+* `def set_fields(fields, generate_appearance: nil)`
+    *Sets the values of multiple fields given a set of unique field names and values, with an optional `generate_appearance` directive.*
 
     ```ruby
-    pdf.set_fields(first_name: 'Richard', last_name: 'Rahl')
+    pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'})
     # result: changes the values of 'first_name' and 'last_name'
     ```
 
-* `set_image`
+  Optionally, you can choose to override iText's `generateAppearance` flag to take better control of your fields' appearance, using `generate_appearance`. Passing `true` will force the field to generate its own appearance, while setting it to `false` would leave the appearance generation up to the PDF viewer application. Omitting the parameter would allow iText to decide what should happen.
+
+    ```ruby
+    pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'}, generate_appearance: true)
+    pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'}, generate_appearance: false)
+    ```
+
+* `set_image(key, file_path)`
   *Places an image file within the rectangular bounding box of the given form field.*
 
     ```ruby
     pdf.set_image(:signature, 'signature.png')
+    pdf.set_image('signature', 'signature.png')
     # result: the image 'signature.png' is shown in the foreground of the form field
     ```
 
-* `set_image_base64`
+* `set_image_base64(key, base64_image_data)`
   *Places a base64 encoded image within the rectangular bounding box of the given form field.*
 
     ```ruby
+    pdf.set_image_base64('signature', 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==')
     pdf.set_image_base64(:signature, 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==')
     # result: the base64 encoded image is shown in the foreground of the form field
     ```
 
-* `rename_field`
+* `rename_field(old_key, new_key)`
     *Renames a field given its unique field name and the new field name.*
 
     ```ruby
     pdf.rename_field(:last_name, :surname)
+    pdf.rename_field('last_name', 'surname')
     # result: renames field name 'last_name' to 'surname'
     # NOTE: this action does not take effect until the document is saved
     ```
 
-* `remove_field`
+* `remove_field(key)`
     *Removes a field from the document given its unique field name.*
 
     ```ruby
     pdf.remove_field(:last_name)
+    pdf.remove_field('last_name')
     # result: physically removes field 'last_name' from document
     ```
 
@@ -232,7 +280,7 @@ An instance of `FillablePDF` has the following methods at its disposal:
     # output example: ["Rahl", "Richard"]
     ```
 
-* `save`
+* `save(flatten: false)`
     *Overwrites the previously opened PDF document and flattens it if requested.*
 
     ```ruby
@@ -242,7 +290,7 @@ An instance of `FillablePDF` has the following methods at its disposal:
     # result: document is saved with flattening
     ```
 
-* `save_as`
+* `save_as(file_path, flatten: false)`
     *Saves the filled out PDF document in a given path and flattens it if requested.*
 
     ```ruby
@@ -344,8 +392,8 @@ end
 puts
 
 # setting form fields
-pdf.set_fields(first_name: 'Richard', last_name: 'Rahl')
-pdf.set_fields(football: 'Yes', baseball: 'Yes', basketball: 'Yes', nascar: 'Yes', hockey: 'Yes')
+pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'})
+pdf.set_fields({football: 'Yes', baseball: 'Yes', basketball: 'Yes', nascar: 'Yes', hockey: 'Yes', rugby: 'Yes'}, generate_appearance: false)
 pdf.set_field(:date, Time.now.strftime('%B %e, %Y'))
 pdf.set_field(:newsletter, 'Off') # uncheck the checkbox
 pdf.set_field(:language, 'dart') # select a radio button option
@@ -368,7 +416,7 @@ puts "Values: #{pdf.values}"
 puts
 
 # Checking field type
-if pdf.field_type(:football) == Field::BUTTON
+if pdf.field_type(:rugby) == Field::BUTTON
   puts "Field 'football' is of type BUTTON"
 else
   puts "Field 'football' is not of type BUTTON"
@@ -383,8 +431,8 @@ puts "Renamed field 'last_name' to 'surname'"
 puts
 
 # Removing field
-pdf.remove_field :nascar
-puts "Removed field 'nascar'"
+pdf.remove_field :marketing
+puts "Removed field 'marketing'"
 
 # saving the filled out PDF in another file
 pdf.save_as('output.pdf')
diff --git a/example/run.rb b/example/run.rb
index ae4c116..5a445fd 100644
--- a/example/run.rb
+++ b/example/run.rb
@@ -15,8 +15,11 @@
 puts
 
 # setting form fields
-pdf.set_fields(first_name: 'Richard', last_name: 'Rahl')
-pdf.set_fields(football: 'Yes', baseball: 'Yes', basketball: 'Yes', nascar: 'Yes', hockey: 'Yes', rugby: 'Yes')
+pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'})
+pdf.set_fields(
+  {football: 'Yes', baseball: 'Yes', basketball: 'Yes', nascar: 'Yes', hockey: 'Yes', rugby: 'Yes'},
+  generate_appearance: false
+)
 pdf.set_field(:date, Time.now.strftime('%B %e, %Y'))
 pdf.set_field(:newsletter, 'Off') # uncheck the checkbox
 pdf.set_field(:language, 'dart') # select a radio button option
diff --git a/images/blank.png b/images/blank.png
new file mode 100755
index 0000000000000000000000000000000000000000..d510176d0924aa33707ab063691aaa75a2943ed3
GIT binary patch
literal 5087
zcmZu#c{o&U*cUBt*<LAR&zdbu4YF3k%-C{dn;4|18GA{HNsCFc4o0#hGjyzlNoFh|
zTS9VVU#gLeH5y~hH+tXqyRPrLzVpX<o^#G~&VB#x`*$zri8*g=&U--g00##LF9LoJ
z;NaK?vga;;ak0<b{sAZ1gY9|C3#QxK+wAGXhYw9mOuW3jWMpJAGBWDx>qkdN1q1|W
zG+Jk8=luM9Sy`E%pPz(;gqD_8NJvOwVWGXfy^W2Ho}OM#P7V%->+bGONJv;*T>M6U
z`;db}5P>*%=EAL^+0U8>?wsZ^ZFqN<+f+rMX8R1KB0-wkCH}?a)_%6&|L?eC=6iiq
zq;t4{YRED1T7G8zDw-H<al1cJXLI6S_}3aOjd}e}=c>KP2mnKl<khSesgl?i9#T21
zz!U8;FwP%+_Uh%+7l|A7J$>+^hk-&az3xpcNqe<q`_|Q%Q}AQVUH~<h67~qN!(3W2
zu$~Wm4ykvSuFR;_xTUPSrDOntgsH%w1VM6S=uJw$a?MOAsjhHwj9;1p)+gmc^K(pF
zyrTdim=IpnL<<b6N~9Jy%_zahzaIhqvcb7^wr9Z6;ThKlEPVRr$e8_g_KJ0r2dt-n
z9i!|RjBG8BjBq;`E=<mc)=WY6d)cO7MGSyH2QJ66RYDrZ0^WjTz8GLig1saqOo-g2
zfRs2$?$SqEfl5qOWR_Kmo*XhOBxSuBsBa*&2~n?c$dj#={{5^`DI~+|^MGf&+N?<%
zS+o=b6i73@^T|+aEHF-dH#P}(ZD@y+zp8K?qK$Olq<>oLNqYgQ8DaG%9l{oNJt=h<
zJ1+Yj!TKfYs-)<hl78Jmv}jZomQS9}S*+?;TeBqZrJn?_tJqXKy31^RyDeiQd4QG%
zs1rs>LZ|W|5l5u2BrY+Szslp)Mtp!4pH<f}fvMti4*KLV7Yt8|o|XVIB0Cbmr27ej
z7vruY<2+I!Vavl~xbP>sCNL+c5@{$ZKcAV}f+>JB0V1pZAlJoSTShu6&eNiH<<#7K
zf`Vk1=fUuPWzb_Kk-ED}Ik>kZiHh&M`*k}uDYo3ccHhSXcBr8k&z>&UAyxC3Q{M9B
zLrTFZP)DGTAvylV?k)w&cBcWEk4Vj^50vzn2}wldIAR{Fkmg18i|T}@z8aOyx3q6R
zG2rqE3-CWSYA7zx_(z`}Kpph6mSeiDbop919NOD-kl!MOn}1=uw1PT9;o7`>ta3Ic
zzB+xdX!>BrdZ&3KSW@RZw@rZ33nJjPcxa$!%Y-p5M{x#7EjsQDz{Ta~e(VoS_=Zdh
z_o`omgo#@CH&uBI4jz#SiFn8JgHiw&Xt7+$53&+Pdvkszt~(-pUDKel)BW;w8pMF2
zQeH`FJ_qHr7C&ZC%v;HJ!-Ua9vR;eEL;PSA)Eqj5hxFlb@whPfRuM^C<*w`(1HAC{
zf_ElqhfWI*@I+IJFRAVO`bXr}6(GbJ_%_m3BR8sCQr0+sl!=?CTgy>0|Iz)86?@#m
zlCqC(XUV{PbFp}rS)i=p2fybGZa8G}9crc3843MPTt5kXQ_;JBM6~rO=gjZEb4y0r
zl?!J#Sls0!4<b*b;UP!G;7{fTBqK|PXx*J`ujO*l_}7fr_g<;?O!;A--3)h15ba8+
zd4&*G3^o^EdQbAJTJ3jUt)S8$U07h5$?9gM_GiUV=(Q|E#FqI0Ox|Uklk<4mCJbSS
zvt;y$YU`VkBp-XL7#qO+E{NORGrM0Nq>i_q|3tE;Uy}lG#`%&8KcB^RiM~EEDinU^
z1WB@L<qg-1!{%c_gi<R8<`P~$DJ&E(%qv$;6jw&9KZv3-#xZN#$wR_74b5-?Gy4Zp
zEsTUs81j^gOsoK+^O;wL)oDiiOH(f7Bg3BJH0Xsub@50?E`g>23hsDd{7C`&!MC!;
zasS4<ulH3oqgA$a^`AvgCRL4)u!J!BX4N?cQv%I1(Vf};;gHRfpjT<z*p=bFH)0o#
zReUpQ@6aTDO%MCtckc+`znEKBC_ea1c-#qvqgyvb-4fh~emrlh1fG$7QhsR%XCuid
zu^`pXP8j|+8;LmpYKpx?D`(t+CMcqUgLg#Jc5oiIVmw+N=L97b)lhJ`K3z$C_alzB
zzT|`ozpCfO{*(8_Mh+bwj3m-0Mc9n@o{!}L+l`Aq_w5JNcWp|9=V=!E1JviLC2XK?
zJKC-1sU)NH9hvV1UluGBWIyj~?^S@I#xa+^bT-Y{4G$0O0>$_YoNzFE+&<{_KHd&l
z|7t|P0&J>&4<M+oc_~4pM7p4obtKB#JxFa$cP5fnnQs;5+AMJN!9WS_eT(t-n0)A|
z=nF_jylPG=;V7lzORk<B9P@bhLu0cq05^cdoRJN3jv@+Xja)%QoU~CX$WKvpw~?jf
zWsLH)Vy$kh5&HL-Oia$CL$j0t;lVvdTv)aHI}V5?WGs)L#_$C;#6B1C4m$rcdARdf
zKOo}$YWn<!5n#9KT5RO9kBc_`;ibt^5D(~WdPHQ~LklEe#W&I+E7Xn7XpQZtT5G^U
zG^yi2P38~!aSKLXDC!i9Y_My?9^e+%nJD*|ziz!+l3Q+d4ucHD-M`ZD%p;JlrZYW6
z`o5`?m{Ab7Wqso>(fnYqGe?~A({5)5m-L>KpXr_6Y`Onj%VK~s!?!~MKcLDpRT1Xb
z>MsMZru#$gINw7}MPi))LvD(Q(ES&Aw+zgB*ZGk-S(SWVgq51DhD{v0XrGtHoNbft
zl2FEteZckKV(?CjSAnl!kx9jtt9+&etWs>nz>OCX!eF3#(^M@}$$3a3ndk}cBjp#q
zPt-G{JDmk=G)`44p773z&MFtv%TUf^6QFH}>8c?A)U`<{<@fH{YLcIllW)J%!{WV<
zg%(Br`h_|yA0p!X@uk61+S41se*{bT`rp*n9100c^FA(3aj~$?Y|cM7M}ybih12Gq
zeu=p)lAUIOesuKkTtWPYrL;O8(A??U#95&G<uYz1tYbm3fB==7(aSm274@n+64#6V
z*xP7V_(}<J?tE14C9kdvatN!57RMUxNA(;ZUurCk&E6!9Q7eKi87ZpOhiJ7=1)hZh
zQ`q)a=c{^9T`XjPZjk@U+p+YFP8I<KK(WY3MtB;c);;L07Wl>1E@ji@&6KEb6<XWg
znr-iDB8?y9pWK1GzI!$lTdzN~TlrZ=n;$u91`XQ0QPaA`DO9&8SkqXYq@z78N%CsY
z1Z#i$<k^(iH=3b%htF%-sP(hs?IYXZ-H*!0Ch++zyuy#w+GOG-cpRzJC95r~jWqvB
zarP&6%%eYQJGiWMT8{D}$#T$7-TZQy6~p9zF}tD$E=maO;`C}VvshGE?7qH>H&IV#
zsYPM*K9srb1vIr>Ow7L#Ab%pSBT>)M!l>(PZ|({JoCtVXX=V9VGS#3Z5oIGd3AS8E
zjPB{Jb(rRrcy6Y3We=J!bA*D3P~G8FB|DnrgJI@lKIvrUPmcxzg^{$m<+a|umsM)J
z0||bnm@b?-Dcho=Yil-S)?Ldm36z)e&YeCVt^_`Sd|~y5YAYK@+dX-}RH$^ae)a@F
zlL5*!_AE9PJ1c>vahKmCYsB@dRg%|fe{dP@3YP?bN;cJLyWf5m=%kDH!<HA*77{a_
z-Y{oVNMDWub1xU(PkqrXm5@`iBTC7ZEsFfK{UL&v-#|L_@lod3N6n?1HH7b=4t7&+
z=|u|k+>BIy3Gnw{G=xVO{D(>wX6+NNeOj}5Mo+>j+Lt-{nZ9~v{3tWS?~^Zls|$xG
zp?OfhmGLnfV~_rJT32@a*MM$uV26ByCJ7BVzEi)I0a?6R30FdGST%@!dCgELVcF$~
z*_9y_L#_c*A9~-HC9Uk9Wg+6u`V5Hq7m)3wzON0|d_lJQVT0^pp`|W-2&0^aD236h
zb5+D`K18i(<&V>E5a|}!)m?damY)Ps=-*T|<T2ad4VZFWb_;22pFKjjmKX%wyF%?*
zt5B%O32R0)xAFRH_aZU2>{`HI>oQ9}{$^!^ZO<prkl;&2LYRAq*;5yHGs(xlcOR~K
zG*FA9bxAb-`dJ8H%D6#uMWKJ|O9$sTP0#sMZacPl^>3<me~J@tnZ)b_i853dKBtpf
zwsoAymR-0|Fb26x+%n0bn}jXu;z_TMAHUupW#_+o6NOO2$l0yr5<L||23=9(oxSf#
zpR@05#ifT$vI>cKLS)ROFXQO+emxBvOej6hiYfqZ)9ar=HS&MAYgH78^=>&gT|un^
zeS@f_K%sO#ig2=CeNNb(Y-<%Y{T+*A0DsJvoX@Jtd)NMs?ssV+#lyb?CpO~Iqxq?j
zIm>RUR$Q+-may)gt-bbvTh84^0rtQdUyYo4W0nyY8yj}>;={0-r2fHZvmgF}^en$m
zaqun0?JXI1=<w<pZsCBx#z+G9$CkQJQ0QM(H4bCcrGwj#T$#AfLP&bTM@gj)))HUa
zbt{q<KB25mV+>GQV_&N+jkkL&7_#0eleI3N+Fdgt^QB4v!{FRMFz&Qb>z;u(?^<*o
z%WNREs0g=KatK50bjS|SNjhQm?VfahA!)2YT2HW;Nk+jt<1Q#UuHq6qMlS&!Q`%y!
z5ghBIiflrs5~x)zvH`*_NZoH9`UKBXQ<C<a$cKg2<U+Sb$O404yFK9#_N?1WeFh~d
z8PwC9E8;*NSL<L$#<;n+)BD>ET$Uc4bwBd2au^2Lzwi(bEqHn(#}##vSfh4?Di{AE
zhd^ki7`N7x8$ZTAzpW<K>g=Njp-(fCX_e85uAk?U+0GwA)V4Q#Ff!n&E)4qBIP@7N
znc%kH9K$Yd=spYWR}rmsQ_{@j^#NB@=uSg2M62Zcey#aWraVRZp7SchXOa8cZj~CW
z@NK`n08OZrMGj~?_j1NWGPJ{r$_<7-<#b7j3OV*zoKYO3ljrgL{`lcC%2necc9=iN
zH<=r!<qXL!6wDV`Ez{)Kd<X*^Df|vvQ9U+a-hREr1?V`8`L%tiW?S#Sl3Z%>Z@M(x
zwc!hVE2n*46PD898lPYDq_0U^7<MZSWFvS_98w*QiIl7_cCpv>kWZ+YR2Yqh>}LoW
zr=Q;n7WdtH6Oil4n&7YZ5#A6z5$V9r0|%_|Lmh}tkCz~=f5Y7w{WytPP^|cQfo~_#
z<v<YuqSg{Y1B$`0foB?WFkTMK$fn~p1<Fo?__ia)dcK@wl(y41vBT3%j^Zwhx7`1f
zysSur_Qvl`j%x3S6N{Js(<W{thW$bqA~t-8R)vxMluD)mZ1a-2`|HXq8PgFkXQy-H
zWD_QfG=FjW*})dU;Wsu*A|~iNP*32(JKQJW0jYF-Nc}O~H4aC6BiVaMj{UQCQigc=
z)~UgE*Hox=sWJ$IjNn}H0fx^QPz#r*R>a!;$?&;i<C1zLQH=lg+Ot39TMBSIQQzT-
zxqHNPfX=^HagC##O_G*BB(cPFVLA+}8;i;<c4S9Eeec>u<5>=c$_g;I+1FWoZ)rZ8
zF{r}OiF8rEUsOb#XnV>(3M51L<$o2p40Lzl5n^eH##Q6aO%4f-xqn$qND?Qa_NS?~
zCxyI5u#PgNrW?MJc6TfOjIFc~mu%9A7}8@_uyaM4Kf99SA>C4E=WyxuzPS`OS2N&S
zzSm8M=cgRUl@wtZIkz-c&?&``!vOBoe@&uXunG5#ErrrF>bucmZmR$mVtrNSZuj4&
zs@GntOT(7Bbf(#V6zu;0{f1Agv^V1zu2*PJxo`E@Kgg9Kv?V6RX>KNCk59Ev4qY?4
zMgY7fGw?Cd+f%yL+L+y$1J19AgshQZ#Fh<vqayR<-+SD3_cQ+Dh5s!+zKuA{#jEAn
zrcg3!czYaHJ9u>KREHMLJ?G{Ptnvcy0GX^n0P4Xe=Ek)B_0_4-zELJnZDk*Sh1`WU
zHZfCX&f%WWV;lLVgsY^`jH#b>WOSX4J{6YA+FJ}1ghd0bhif35R~wvc#Irp9a^IRE
zInRm=c|KBRevKG<RRY%NxToqp0fbd=f*VJ)0B}QUctqmk@P!0kqOl4yJ<}o%m^uSW
zb<juAX8){EchkPPrOrvCW~V{R9mA!@e7TTk3RMJ|br$RpqC#6dM~WbpxgUOi_$LoW
za1oUEzYi;+suP!s0k?P-&x%_?acjU0N6=g;STjZM0YFr{3i^AsT_u+e*)Ze0hQ@26
zQDE!;eHcLgT{0bgqN?{Kk^4=`x&Zn313=N1@qCXOQ^O=$mFa`rdI$)cfP`bgJ$KXA
zgQG8C$kxxH=JSk0NY~dd$aUx0*LnY4FVku_lKjX}k43Ff*GmV+Mk^L)S#^+bEjC;)
zU*Fk<e7vhFEPqOg8J07D{SMHb2l+4Eiiv6N9GG_*aiyjLDool{#*-9L&9&I(I8VoJ
z5`>H(L&z*%%_B}Dx+&}R`q|%y9ljW1!QnYh-{xj7{c%A9v{2P~q!oIIxEATa@w4Xk
jlWx4+|F;pwzGnofcQ#rxRar=nofQaE>vN@N-S7SnV^<Qn

literal 0
HcmV?d00001

diff --git a/images/checked.png b/images/checked.png
new file mode 100755
index 0000000000000000000000000000000000000000..72c5da3daf6400f3f43d891a94a324face3a67d4
GIT binary patch
literal 6965
zcmZvBc|4SD8@45>kfbQ<gHSS-7(x>@i7}RGh>R_S+`?lSYqms*vXmLySTe)h3W*_m
zdt|HJDC<+nGPc5yv3>XSyx;qMf4uX@%>Db_*K%Cvc^t=iUcX7gS(*s#k=Vn<#U+F>
zJ%{Jw;s@bp$6dVew}AiO+VD>x&fLa$dwUyxynXvN8jbe!^lWNsl9!h^G&CF;84(c?
z$<EG>iHWhawB+aK-@A9Oi;K(H*jPtLM`&p1{QP`tYpa%))`t%tSS%Ks%}z~Cm64Gt
zD=WKr@nTg~RY5@kl}fFwtW;H1J#gRvfk0p~nLmI2v`C)k<KmKt#+*B26E-;8r@7~*
z(LUoB`KDt0@y0uZ1e><ygpl)?;K%weOLN6xaR2i|DMODMHq><r@o?o>C{~_d1=@4J
zHNX9IS*T+5y+F#kIl6u52E<5>wA?%o#yE5rLATrQ2CN4>4GQf@;yH65c3Nat&ea3w
zjwQUWm~YuW?uUD1DNpx0^fY$4{(WjY_3ixD%N@n|?N!w)y}?<jXlBXmV}3Pa%eAZ|
zv%9L}?q5`W-i-g65bN+f798Y6i+0lKFsIpqJr_WSbawME5(u@O?RTzLJ$Sz$*GY23
z(FBy#T~p5_&|1#H!`Am_vK`nb8f}2gh^rUCi$EsZ$A(#Sj#hie3^kSa2&M1m%iKUo
zW<!#VdOuI${ZYwRR9Fa5E7!Nv29N~jbnIw;7nq&Z?Y6X#@|CN~>JBmw<C{E+Ga9nq
z$rK1{_Q<oC`@(|nXyCya+C9YJ@kj$t6-ENo(l^0YA^PC`LuSLC35sS8f`eE(pN%N4
zL%B}@o}Bzz440fWnHIrF3pYZe$WB!J07kmFc^CHFy=*fJ?3{yNMJ2xO2y5bb>a7lq
z3m~N|3MG!SID=^2PBCFl)u1$mh}qu`Q%6<LU6J{KOP(dE5HB+AYQ#N~+8WKe%;p^Y
zISa@WgP(^L7K&w8+5n}1un|&#m1Ws_Hx}5-bYBs~`@8IDZZksoXPY^tOU%6?$jhoA
z4I1|hby37sh?02sQy*|xwjC`54C&l2!3-F=u(QmY?r$cIu}HBGpWki#+TRMmb)m~k
z$1Z{&owXr$C=e172S@;@O+RBGg<p~$Ljc@M@Sbifp)#Uo*~2?V|Hj)I7+|?rpPgxZ
zWf;0Wn65ol08JV12bzl?s~|_5V+jkJ6JFwU&!QGmgsr!+*3z)nvF0gif%0$tCd@5z
zPN@WLz*M@;t0XB@+U2yh$I9}QWXJd-QYrj**1jI?syj<WQY6Ej^Z{o_6MNw4@v3;<
zY}5(BS)jYHceA!Icb&%zm1uiur!zgIRv)g**_m0?iWl||ST9v4(<E?X_a!tb7~jsz
zR8Mdxq)Q{^J<!iQ!Fc{QkP_v=o(Rl5pe^#~nX^~Doq^|WUe<5w&b}j16V%ocgD)08
zOgA78X62jRU5OB6Y)y(be&H)SOviwV7W(P>yF85WK{mWh1AIq*Mueigu1?6}Z}E!D
zDw*cIJ?^#vt=)l@A$}w-rly%t*>1Y5*<8$a8m0$%f7uFHmggqg;oaY}Y=IhaZlW<j
z4jS}A#lD&4>DvK4hB89r80sgEf``kvSx#W-ZUv&MJQt0fy&Sk7mCQZG(vr^kXE`Xl
zLy8dIsWLxcKi_BBwciM337$c6GbqsS3Dg6LW>cdP5Na_^rJauy!3~&o74+V-gu`a!
zbetu)V4`Fg>due9g}%?$?2Bc$KpCQV<=#NMnf$yyRyZ-EU}IapXKQwOtD)%SP5U>S
z`W?-K+4em2cPdD2#lqSQi8_tt3!Gyh)rr4Tn;S<0`ggw6FwZmMW@J7;>&u6~2u{YN
z^eHt)iofl5&#L*_SFv5w7%h6q>y&u@&kLwV<RmF)TCq?J-=RNe_dueI4<Z0N8#YM<
zOgXp{P-J=Z<5&F``br%gXAM+mY=%NYi)_`U^tbK~-ie|7NDZN2W7#uiUHtNeqsNgm
zonKS%x%F8$*$#jlvKMQFppuA#>c@~a0(2Vm!0=TabQZ8c;(WlyqqG+FVE1pl$w@U5
zxqZ26#|k~~gu5NzB9aUTiE7-;N>$FJRWl2}lQgLF%_(RMj|H=x!|4pD!Ezl*O9Z$X
z89A>Fqp<KEHoU|*h-{1*Iep3L_usbuCrY^})#CA0nY7FQuIRy85y4qe*mML7&V?#`
z&oh7IS|7S%2_pN9HW5T;0M#5zz?RR{xYz)6F`NKcZ(h1aBAAxbIbjGp)7J!jtqPti
zPmTg41Xn{nZ59WdjGGT`>vzb`sgSu?c4SWQWWc!t<pT$E+Kl4{YWJ)T{Ce83HZ^<t
z`%^9S=M$QNcx+i5+kx2x1x9cavmq6e>leWyf{~Lvt54%&;;*Rg1Oz5(YJLfEbFt>)
zt%+Zr<#%19#(hJl`8YEPW+VKhrf@L#9a}eKqKBz#d~I=5h;bj|^|eW>>fizgiaeQ%
zVFE~g9)QZ7Jb6BgELvp}E(pQ6Ob|$~GanjU6^ItH7b%)S!$+xNK_89g9uQvNp0c*@
zE*RgyYc=nH6Lg_;^C2Eh+yji|G~_?kZJ25l@U8JqRt*EK{p)I0_7p0Gjw3=~NR!}B
zCJ*>1>1O8rh^<S`!#GNXYUYvowB>kL3*R3#`1@Ev$Qks#?4ld~%zw(^+g6&Lk7+A}
z^DSC2m0l=5u?vioDDyuKmJ0X=86B?8zIp(kTz|DN1Y7R@dL`3KFD7FN+qG<lE~oVq
z2P=;wZ6xWTX40+-QR|PQDQQ<Nd_IZUAKwgd@^wG?A4Fa-B6*OXIkp?L-->QI^4L)0
zm&LCm>}m%+AJ)+LeqM$ZGmK#u@5yd(jcH3pQXK$#Ev}I&qZf%Y-F!Y-eq-M&UIaC|
z<_BW<6*DnRR6u=7Cd9PM@c=xiU(;><PIaC^`x>pbmqX~D%H9dAwV@F=X*iQ60h3i4
z7awcS&>2A5gY5*d&<JzE(tAyB)SAr!ED}e?I9=GT#TWl-d-&QizI(^f%08~C@+l(8
zZ|iDZ{cEE+a)a-puHWt6l1DzPx0)`Y^=Y*>ybLTey=otx-_JJLfg8kVD5Up%5m^?A
zCjbWG2q+pfP8nyvug)`sL3u{l!|M1Kl(PEsjK)A4UY0W$+4f_0d|Cu>UAwKs<NtV}
zGNSYCsA-h@*E1VVXjZt<2tz3`$Yj)w?0kd)p8`uO+47|+v4l4KDf;oJsLfIzj*Ttb
zF6(1;V`_#R-Qe_~P-iPEFNq`~8wcuIzHV*{--OXNP&sJP%&n*+Ids}R>FqRbW1xEf
zt|q~sD$x({L-kpSgX)ai>DOGsNlVIlt&q7oFN4HhBMx5oW{&e+3bacE3P+WRf_9$-
zXBa~hU#$+Jag`@t5sxG7lO3V1q=COH5>765&wlFQ>_n`Bpw@CoHK5x5!DT5?;g30e
zeJK&gBPfc4OT`opOf%{Jf;Wr)jx#-{qsw531T-6VjlxkmhPTanCbS~;F61~1Ast*N
z{4(s7ttq8ce>cMg5K(wod9-8gex3_ZB94>I9CRt|B9~Y?$0~+;z)pZ5PP`CWsd0Uq
zcVp~neMN`@(X_rN)!bY3Rl9<J6}B>M5HAG%z*}!yV!8(23cA&NC}f;2N-3$sw{(B%
zlAY5b3&LtAwlGTadj8pOv*6nPL5=^cbGh6m9*xAU)BF<6u)gZ=T79X0*1hDqe~br!
zN~qJgFuDYiKff6D<NxYZ9w+<Y|AR&Y?-?~?f%St%pZBgCz1H>t(V}M=8G~2K`?KO!
zUOzdxSlbxP0~Wy~HMQ6rGV20APh6Q9=GXh!6`Q0~E8lPb5M?;nt|$(NjiUGDYqY<w
zifSXToO*v+G+4y;Dh$DN$v&jk-jZ4(Fx#)|X)Wa|NbIlWkT8x-hiXSuL=@Iq7F8#$
z0;6G<ZslQ#fSZ3ZyTQq94$~!$9Sd2|uM(dTJv}b^+X-k>YwaKHX+NH#FZ$|Rn?XHR
zJu_$dCqHf>J%?SFnbVQG)-E;o&NtIbHIv|PTv;vEB{GK-f(b7!O5L1P7Tp!T*Gf16
z=G~v9hG0elFa>E58j~kqGoa%7#h4o9)}EAM88AE9X!8oVr1|jwsf7E#v|IiI4(5ac
zvfTBOx02g=m4g^C9`ijp>e>NWE=|>YO$&3u`1>-k4K_exb&@G%4>n@%$!am54Hi-N
zaKQfF#GR19-EiI}!rtWXk5N#i$W{IcnFKwRazX5OUNSY`H=qy=EZO#!{MOS7tTV$<
ziY4d;s*F47*9#Onn$H6qR<V|5YSunM(*jS%D+K$DnwN$bPHT&Q=R(|^uO>syH+9l$
zU%naT?y&sbZthCt6a*;_U&OH%&x^(*PUUtzB0*w_Pd;0#-S}y9&A1#6m-w7x{u@Tp
zme%{hWWFGF*vBh7M@1Ihgr*-z%&U=GxqRv%N3TA?1pMl>!K`Liq(QLK_IdeBX1+rO
zow3T;a<?O6lWl==!RqPk)dHDcOSx#kgkno7v2=l@ptv(M;;Jiu-G)6OMeN3{%exM#
z*JxBu$h6uCNGLG$Ic(bxJ{l`AapYymfMARQapI-JS*@7wW}Q<BklS%L%8#r0SNQ>Y
z2v+E1ZJn#PY0$p{-TAm<Dm@3ga%<ZW$gg{Urc({HulO7J*1G4YwPwbGLB<c$z{)fj
zQMU75P?|`%n4=#F+pi*jog+XWy;2>~Ns(=xKXmKdAd}!^*j)b7w#O@E+7U0@njsT{
zg{g0fnlIO{Q{aspyM1VP)xoOnKyAAkUgXz#a?U4&??ziq$gnhr_A;E><b;2h*!tL<
z`3%c^bDdA4YQTWH6QD;|Kq{~n-`IC&!!^@=cP|#ZxuIXKW<hD@!p`rHZ*&0GrCyPw
zu23tO#K~ut4%Q~aC=(!L`sN=Pdtn7if=LELIVuB(9@>t{xcL5u-@`wzOz7}ff<abF
z0;awt$qM6dBt9u3aaQJC@p$W>-rr(YP)OMw#^YaOq2Zr51(XYp!G?O>r5@`1X8?0o
zQK1)W%0Z&~FA_7uiHsMhzmP811|8;7T_c^n1bY)|Hw=6&(sd*5LD&d#w;YR?>0&Bu
z0DFFOdPK|T64@Ubnk!CXarNcnu;q7rl=|2$WW`+lJ7zPd;S>jsI#T!4Zd{ZjQ$^#&
zU1$f+;#a^x{g^9K;hTGqHPHz03tJ5MI-Xiv;=F<BR!4>^xkpI<aVo3gYVphMPScYY
zf&?Bk<3(@lKK=FGZ@P%q-I`8$m6>0Id=tr*%k&~2`7!oSmXm%@{g^Plv=t*9$pJ@-
zsHaNk-mKQUo1^Qmapk0J{NNpDuj!Qym_&Z1%P!GYsJJ`cu#-NP8^QA;>x}f&klZ}a
zh5q(mFpLy|FCix!UAi__x24h~==JYjY_FhLN7#G*t(!Z65;7Waq3EcyzHkJn4IQ+R
zO>a=5B$zzQ@*lSl7!WY-pE2R_4_Dq#A?e4Acd1ckRmxK(^V9xtDpHY{d$QLcBzGp}
z_z?Zo3V5!|`q{(J|HXG7yD=Gk3pE)nyC=LVaTzNF;i4`94~vqMuH7Cdvi}L#sDqkz
zM+F?T9^fDQbsI7g>g$2KGSimIQyqF4a3K;v_IAiI9$Ds+*|QwSf;o7)sl++UuKZ-)
z^@ZtY=23{KOG1Si1nKZ0C;d360C!(z1tz;BSbyZh`x6<{iOXTm+<FP&sVZ*A0SYbG
zaBvBCAM1#pnE}PWPuJXB`@3xjN#$&0BTLG;`nAsP#-6qr)?&_S>Zqxh_1NsY=TGMD
zOVF)t)@ds)R^`=sT5!Ly6VPnlLt7c}zQ3@>djQU@9=!;5`M5G(O-~<3^da?tp}ve-
zRhHCgEh~RljqeoHqUFM;8QM<f^@tB}iF8iODbi4%?c_aq;>$Q`_j2M`a(UaIcBlt!
zq4o<~zHq@a<7Zr&xR2>ANDTH0j1%I)-g>RQak<w?V(RCBNT2pO#r&n$>Y*4R2vfF+
zUthRTQk|#%A8dE1Ft#8XC|d~2^8Hz%KK`D~eBbO_3SLVDwQeI|z3q*hbnKE!;+yok
z5!%4m+75cq^ck$L|Fg?2{@s5KX^v^74$;d?Zw5dPA7@lQZhTZLR3b|~AdIZ8??22d
z+WLoXD7*u`Xi$+j<Rrth^idb_Hfz%Q-JXH89LcF)n_D{6iq|u0U>pHAm-Z*6+8t}0
zlopEhJ~9VlC^~jIZ0<cU>2^Rj00eUPaCBt2$LY5MMV-7d^k}Vw-3{JBT&O3<+)l=f
zQ$}fI7aAX=gqkHs7y*sJMSLd@9ZsKnQZsJ0_%#B1#-DbDqL^bacn})jUkS1839P{i
zHJM!;(!l{r1X7_U{_nxNtIFJ-Rj-`Z4!f>?a&+AmA7tx4wV%8Ye4YOo%@(I6Zndt8
zxc|eEBVSzd^hFg$t7R_2g3<y<@hNVS-j820cnCUd#=D;I3Um3+Bo?RZ>rDJ=i9;(z
zkCzDtj8neQ?BM<6Q3uSrJobEf7x1^v_;b7$rZYwI;bX(&-Hfa6YvJ1YFud65tc6<m
z))F}V$S!IwICafk&VL|nFL)5rh`a<mKcq66CN`??b0gW4+EN}lIlhA)3XA6sbJDPY
z@XpGc6r>2Zkw%CTyDDf)-?v4ZxWc1a-(f_d5wKm}q14f#?>}o>QoCN}Dex1Eei$TF
z7z0Z}e69uwb#(>eIt+r&<e%>R9Gs2mA{$^UgeQ<1v_5qbkJjovj1k^Gy}^uF`k7dC
zjnh`<=nf*`xZZ+P<JAYYPRr`Q6gW?+Yth-)8i|Ho2ZiTlY*A~VmDS%wCxZ<+q{)%s
z3ff*qLXOUpbSL;_;h-Ypwn$%Tb)NEn`1ziroh2Ih#}{`3XBg@Fy*o+fNjekrhF|PV
zePtD_4)h-SD(Ta{oL={tMmFWd)D-mH%>5<5%X`U$ej?Z+Eak#8%_?1u(4v;slNxl7
zKSXW%SW%=zK1uV-9lmS!Pm+$5KzL)~vT1oyBC{AjG}O$$MXhH)$eFn`J#6YERDixN
z{b^5P^B;`LFvgGn17k18yJ3v*rB(V2${#V&81?d=d&>i;%AMgm|Ky_}oi#f6UzjSW
ztDv_+Q21ZWt2(><*>C@mi{U-doS8u+U7f!=09%g~-ny?lW!$ageNkGSk0}|FfaPuK
zWO2af(gLEWEG>t>5xH9TRYj5-t^Sf&)II0fXboq{#(*ZKDbKz_iZsqZ1BJG|j~qD~
za>>z;;xqw;iA)qewd!GCSA+7#dgEqGacZ&qC$S6fdX|_%qNGl^MTh%LxB^^^I7-g>
zprx#=c&cEQzx}M|h-XmNX`!afVc4{jChmm@A?shuG4v|zZ=*z)vB5W+oZvnaK0Xq^
zEsS`GJ0p46;20wT7Io&ox99nTn7y#b&DG^ty?;8ncDRtJ@gZ%*&7uUV53_$dJ9v2W
zsRd<qR$G0lQ{OXzl)I){A9bB;rOjdClK|XRq|1bup{|>aXc}5?-!?WEWMdp$57r6|
z^*J0Pc(qTYh7^j`zg9-dg(y~d2Te`E?UFq@g4&Nmvtm?<S!ex=cO{;i$vR*L2*6B3
zaI&cUboh9N6r9yO=d;YxKTHb}zr5|b;1@ZV_~NKw?{Wg5(!Rft@1?fI`u27JA$Mxt
z_Mz0fdk0?Wjisf;wneMWp0c1jp>d-0^MG;!th5LG)O>_*OiYARP5eTIADjH%cVQ8u
zJH$r^6-}FeKe?5XDM3e;^<uk(zjizqPhe<YrsH{8NBbO4@Po#5d*>U_u^#VRsU@T+
zF6^AdEr~J&5f8>iG@bg3A*wkPN1!XNnRdyXI1B6s==m3!q)l0`w1rT&{#oidcvv2Q
zh1(h2OossIb-GmgbPi#KTa_U|=Yy9y3y1%xFiAh8wgYF44NT8LU7^B=aVRo${qscG
z8LI`~Nxq&2$fz9W3-ZGO4-b#hRdSo-0g?bL#T+Oky^p8eE0{Av^k<k;J%tY|BXL-p
z9z~?CWNwEtPi~)?!RXkQaZ8c(*$136B9Lcb0+PwJejjmMvW)}t931IOGOEPcYy3bx
z>53dOvh5^{sYJgSibvEnHnSrGUKYZ(sM1Gb+X99C@KjrPY6m>^2t3sho;rMupBYPd
zdJRlKQPq&}s~%<Iz$iL@^*yVQXh&|?2@nx72v#{HStv#xc!7U}w^M;OCcVL4*cwjs
zk@SIDLlhS)td{(-gGBg@evg+W(!;fpc;%k&6B5j`>oSG?wCFV<Xpk@*X0;gyt?L$&
zNOtxPz~-rabj7lcLA-K0dl$SEgLW@xZiru+>9_pSsuhOQQmV#NIB%lBk~$_4;m0_z
zDex>9?13-*PsDUvI7@kz#q3nAe7X|FOp}4((bas$N-Y&w(=v3E-qczspgL+@6&-cB
zdHLSccRO&eEQ`=1si(0N|Au={$pf*i>&wj1g}Bj$D9NWyz-lyqlpi0QR-e`A(sXu8
zr65svuypJ~HA-9W)Y?td`112^;lq#pmX*`>k47)H$3icvprAfA!(vqrlP_R;QA<jQ
zNjB{sCL%<Y;STy&KN$1?MNOp-85Vcqx5cr(AbCG_(~5*|RAtb*5u`!919RpQ)6or#
zcLS>}>)9*Xh)mj6Cw`$UDZCn@I+j234%b!sF20Jh=y)MMfcGK=BK2I*%#qESjrWes
z=_&|AB5SVoIyX}_cJ1KaH>bH<O=+Ke#km6uF&N$aLgS5}qauLyH)mT1XQWp!GtZ+f
z^4<3+>|nXo$bj_LixSXa$2VtdhfjGqyw^*b^tkd%*M1PW|L0#vTwKZoZpR^QK{t<y
Rzc?c>#+K(Q&R)Lpe*ksNr0D<v

literal 0
HcmV?d00001

diff --git a/images/distinct.png b/images/distinct.png
new file mode 100755
index 0000000000000000000000000000000000000000..648903cd0c8ca14b0645b02ec017712027ed5a72
GIT binary patch
literal 6233
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
K7+0M<8~q=1(eH==

literal 0
HcmV?d00001

diff --git a/lib/fillable-pdf.rb b/lib/fillable-pdf.rb
index b26cd25..e61bf5b 100644
--- a/lib/fillable-pdf.rb
+++ b/lib/fillable-pdf.rb
@@ -87,12 +87,14 @@ def fields
   #
   #   @param [String|Symbol] key the field name
   #   @param [String|Symbol] value the field value
+  #   @param [NilClass|TrueClass|FalseClass] generate_appearance true to generate appearance, false to let the PDF viewer application generate form field appearance, nil (default) to let iText decide what's appropriate
   #
-  def set_field(key, value)
-    # we set generate_appearance to false for buttons to ensure that the chosen
-    # appearance for checkboxes (i.e. check, circle, diamond) is not changed
-    generate_appearance = field_type(key) != Field::BUTTON
-    pdf_field(key).setValue(value.to_s, generate_appearance)
+  def set_field(key, value, generate_appearance: nil)
+    if generate_appearance.nil?
+      pdf_field(key).setValue(value.to_s)
+    else
+      pdf_field(key).setValue(value.to_s, generate_appearance)
+    end
   end
 
   ##
@@ -157,9 +159,10 @@ def set_image_base64(key, base64_image_data)
   # Sets the values of multiple fields given a set of unique field names and values.
   #
   #   @param [Hash] fields the set of field names and values
+  #   @param [NilClass|TrueClass|FalseClass] generate_appearance true to generate appearance, false to let the PDF viewer application generate form field appearance,  nil (default) to let iText decide what's appropriate
   #
-  def set_fields(fields)
-    fields.each { |key, value| set_field key, value }
+  def set_fields(fields, generate_appearance: nil)
+    fields.each { |key, value| set_field key, value, generate_appearance: generate_appearance }
   end
 
   ##
@@ -220,7 +223,7 @@ def save(flatten: false)
   # Saves the filled out PDF document in a given path and flattens it if requested.
   #
   #   @param [String] file_path the name of the PDF file or file path
-  #   @param [Hash] flatten: true if PDF should be flattened, false otherwise
+  #   @param [TrueClass|FalseClass] flatten true if PDF should be flattened, false otherwise
   #
   def save_as(file_path, flatten: false)
     if @file_path == file_path
@@ -245,7 +248,7 @@ def close
   ##
   # Writes the contents of the modified fields to the previously opened PDF file.
   #
-  #   @param [Hash] flatten: true if PDF should be flattened, false otherwise
+  #   @param [TrueClass|FalseClass] flatten: true if PDF should be flattened, false otherwise
   #
   def finalize(flatten: false)
     @pdf_form.flattenFields if flatten
diff --git a/test/pdf_test.rb b/test/pdf_test.rb
index 8fb0f72..7762468 100644
--- a/test/pdf_test.rb
+++ b/test/pdf_test.rb
@@ -19,6 +19,7 @@ def test_that_an_error_is_thrown_for_non_existing_file
     err = assert_raises IOError do
       @pdf = FillablePDF.new 'test.pdf'
     end
+
     assert_match 'is not found', err.message
   end
 
@@ -46,6 +47,7 @@ def test_that_a_field_type_can_be_accessed_by_name
 
   def test_that_a_field_value_can_be_modified
     @pdf.set_field(:first_name, 'Richard')
+
     assert_equal 'Richard', @pdf.field(:first_name)
   end
 
@@ -59,26 +61,32 @@ def test_that_a_base64_can_be_placed_in_photo_field
 
   def test_that_an_asian_font_works
     @pdf.set_field(:first_name, '理查德')
+
     assert_equal '理查德', @pdf.field(:first_name)
   end
 
   def test_that_multiple_field_values_can_be_modified
-    @pdf.set_fields(first_name: 'Richard', last_name: 'Rahl')
+    @pdf.set_fields({first_name: 'Richard', last_name: 'Rahl'})
+
     assert_equal 'Richard', @pdf.field(:first_name)
     assert_equal 'Rahl', @pdf.field(:last_name)
   end
 
   def test_that_a_checkbox_can_be_checked_and_unchecked
     @pdf.set_field(:nascar, 'Yes')
+
     assert_equal 'Yes', @pdf.field(:nascar)
     @pdf.set_field(:newsletter, 'Off')
+
     assert_equal 'Off', @pdf.field(:newsletter)
   end
 
   def test_that_a_radio_button_can_be_checked_and_unchecked
     @pdf.set_field(:language, 'ruby')
+
     3.times { |i| assert_equal 'ruby', @pdf.field("language.#{i}".gsub('.0', '')) }
     @pdf.set_field(:language, 'Off')
+
     3.times { |i| assert_equal 'Off', @pdf.field("language.#{i}".gsub('.0', '')) }
   end
 
@@ -89,6 +97,7 @@ def test_that_a_field_can_be_renamed
     err = assert_raises RuntimeError do
       @pdf.field(:last_name)
     end
+
     assert_match 'unknown key name', err.message
     assert_equal 'Test', @pdf.field(:surname)
   end
@@ -98,6 +107,7 @@ def test_that_a_field_can_be_removed
     err = assert_raises RuntimeError do
       @pdf.field(:first_name)
     end
+
     assert_match 'unknown key name', err.message
   end
 
@@ -111,9 +121,11 @@ def test_that_field_values_can_be_accessed
 
   def test_that_a_file_can_be_saved
     @pdf.save_as(@tmp)
+
     refute_nil FillablePDF.new(@tmp)
     @pdf = FillablePDF.new(@tmp)
     @pdf.save
+
     refute_nil FillablePDF.new(@tmp)
   end