From 9b25d302b77a013b0094dd840428a6c24e035d4d Mon Sep 17 00:00:00 2001
From: Amit Garg <amit13.07@gmail.com>
Date: Sun, 26 Jul 2020 21:57:15 +0100
Subject: [PATCH 001/254] Fix broken logging in service layer

---
 service-layer/src/main/resources/logback.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/service-layer/src/main/resources/logback.xml b/service-layer/src/main/resources/logback.xml
index 47fe42236..e6678aff2 100644
--- a/service-layer/src/main/resources/logback.xml
+++ b/service-layer/src/main/resources/logback.xml
@@ -43,6 +43,7 @@
     <logger name="com.iluwatar" additivity="false">
         <level value="DEBUG"/>
         <appender-ref ref="FILE"/>
+        <appender-ref ref="STDOUT"/>
     </logger>
 
     <logger name="org.hibernate" additivity="false">

From a968dce586ec574d17628d99b524b285752fc15e Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Wed, 29 Jul 2020 17:08:12 +0000
Subject: [PATCH 002/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0801c677c..733bb5afb 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=alert_status)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-103-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-104-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -222,6 +222,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="http://vk.com/yuri.orlov"><img src="https://avatars0.githubusercontent.com/u/1595733?v=4" width="100px;" alt=""/><br /><sub><b>Yuri Orlov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yorlov" title="Code">💻</a></td>
     <td align="center"><a href="https://www.linkedin.com/in/varunu28/"><img src="https://avatars0.githubusercontent.com/u/7676016?v=4" width="100px;" alt=""/><br /><sub><b>Varun Upadhyay</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=varunu28" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/PalAditya"><img src="https://avatars2.githubusercontent.com/u/25523604?v=4" width="100px;" alt=""/><br /><sub><b>Aditya Pal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=PalAditya" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4" width="100px;" alt=""/><br /><sub><b>grzesiekkedzior</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=grzesiekkedzior" title="Code">💻</a></td>
   </tr>
 </table>
 

From 46d415532831b3a534a98f2317177b57ea7fe9ed Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Wed, 29 Jul 2020 17:08:13 +0000
Subject: [PATCH 003/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 3ec5459fb..c7a0d5b48 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -938,6 +938,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "grzesiekkedzior",
+      "name": "grzesiekkedzior",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/23739158?v=4",
+      "profile": "https://github.com/grzesiekkedzior",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 31471acb69bb5e41d0668cfbf10c3d8e083b1861 Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Sat, 15 Aug 2020 21:47:39 +0400
Subject: [PATCH 004/254] Fixed most reported issues by SonarCloud.

---
 .../iluwatar/abstractdocument/AppTest.java    |  15 +-
 .../com/iluwatar/abstractfactory/AppTest.java |  17 +-
 .../com/iluwatar/acyclicvisitor/AppTest.java  |  16 +-
 .../java/com/iluwatar/adapter/AppTest.java    |  17 +-
 .../iluwatar/ambassador/RemoteService.java    |   4 +-
 .../ambassador/RemoteServiceInterface.java    |   1 -
 .../ambassador/RemoteServiceStatus.java       |  23 ++
 .../ambassador/ServiceAmbassador.java         |   7 +-
 .../java/com/iluwatar/ambassador/AppTest.java |  14 +-
 .../com/iluwatar/ambassador/ClientTest.java   |   2 +-
 .../ambassador/RemoteServiceTest.java         |   2 +-
 .../ambassador/ServiceAmbassadorTest.java     |   2 +-
 .../async/method/invocation/AppTest.java      |  16 +-
 .../java/com/iluwatar/balking/AppTest.java    |  15 +-
 .../java/com/iluwatar/bridge/AppTest.java     |  14 +-
 .../java/com/iluwatar/builder/AppTest.java    |  15 +-
 .../iluwatar/business/delegate/AppTest.java   |  18 +-
 .../main/java/com/iluwatar/bytecode/App.java  |  10 +-
 .../java/com/iluwatar/bytecode/AppTest.java   |  15 +-
 .../java/com/iluwatar/caching/AppTest.java    |  17 +-
 .../java/com/iluwatar/callback/AppTest.java   |  17 +-
 .../test/java/com/iluwatar/chain/AppTest.java |  16 +-
 combinator/pom.xml                            |   6 +
 .../combinator/CombinatorAppTest.java         |  13 +-
 .../java/com/iluwatar/command/AppTest.java    |  15 +-
 .../com/iluwatar/commander/Commander.java     | 315 ++++++++++--------
 .../java/com/iluwatar/commander/Order.java    |   8 +-
 .../messagingservice/MessagingService.java    |  12 +-
 .../iluwatar/commander/queue/QueueTask.java   |   4 +-
 .../java/com/iluwatar/composite/AppTest.java  |  14 +-
 .../java/com/iluwatar/converter/AppTest.java  |  16 +-
 .../test/java/com/iluwatar/dao/AppTest.java   |  16 +-
 .../locality/game/component/AiComponent.java  |   2 +-
 .../component/manager/AiComponentManager.java |   2 +-
 .../manager/PhysicsComponentManager.java      |   2 +-
 .../manager/RenderComponentManager.java       |   2 +-
 .../data/locality/ApplicationTest.java        |  12 +-
 .../java/com/iluwatar/datamapper/AppTest.java |  17 +-
 .../com/iluwatar/datatransfer/AppTest.java    |  16 +-
 .../java/com/iluwatar/decorator/AppTest.java  |  15 +-
 .../iluwatar/delegation/simple/AppTest.java   |  15 +-
 .../dependency/injection/AppTest.java         |  15 +-
 .../src/test/java/org/dirty/flag/AppTest.java |  16 +-
 double-buffer/pom.xml                         |   5 +
 .../com/iluwatar/doublebuffer/AppTest.java    |  13 +-
 .../doublechecked/locking/AppTest.java        |  16 +-
 .../com/iluwatar/doubledispatch/AppTest.java  |  16 +-
 .../com/iluwatar/eip/aggregator/AppTest.java  |  15 +-
 .../iluwatar/eip/message/channel/AppTest.java |  15 +-
 .../eip/publish/subscribe/AppTest.java        |  15 +-
 .../com/iluwatar/eip/splitter/AppTest.java    |  15 +-
 .../com/iluwatar/eip/wiretap/AppTest.java     |  15 +-
 .../iluwatar/event/aggregator/AppTest.java    |  15 +-
 .../iluwatar/event/asynchronous/AppTest.java  |  16 +-
 .../test/java/com/iluwatar/eda/AppTest.java   |  16 +-
 .../com/iluwatar/execute/around/AppTest.java  |  10 +-
 .../java/concreteextensions/Commander.java    |   4 +
 .../java/concreteextensions/Sergeant.java     |   6 +-
 .../main/java/concreteextensions/Soldier.java |   4 +
 extension-objects/src/test/java/AppTest.java  |   9 +-
 .../concreteextensions/CommanderTest.java     |  30 +-
 .../java/concreteextensions/SergeantTest.java |  28 +-
 .../java/concreteextensions/SoldierTest.java  |  28 +-
 .../java/com/iluwatar/facade/AppTest.java     |   8 +-
 .../com/iluwatar/factorykit/app/AppTest.java  |   8 +-
 .../com/iluwatar/factory/method/AppTest.java  |   9 +-
 .../iluwatar/fluentinterface/app/AppTest.java |   8 +-
 .../iluwatar/flux/dispatcher/Dispatcher.java  |  13 +-
 .../java/com/iluwatar/flux/app/AppTest.java   |   8 +-
 .../java/com/iluwatar/flyweight/AppTest.java  |   8 +-
 .../iluwatar/front/controller/AppTest.java    |   8 +-
 game-loop/pom.xml                             |   6 +
 .../java/com/iluwatar/gameloop/AppTest.java   |   6 +-
 .../iluwatar/halfsynchalfasync/AppTest.java   |   8 +-
 .../database/MongoTicketRepository.java       |  11 +-
 .../hexagonal/eventlog/MongoEventLog.java     |  33 +-
 .../java/com/iluwatar/hexagonal/AppTest.java  |   7 +-
 .../iluwatar/intercepting/filter/AppTest.java |   8 +-
 .../com/iluwatar/interpreter/AppTest.java     |   8 +-
 .../java/com/iluwatar/iterator/AppTest.java   |   6 +-
 .../java/com/iluwatar/layers/app/App.java     |   9 +-
 .../java/com/iluwatar/layers/app/AppTest.java |  10 +-
 .../com/iluwatar/lazy/loading/AppTest.java    |   9 +-
 .../leaderelection/AbstractInstance.java      |  13 +-
 .../leaderelection/bully/BullyInstance.java   |  21 +-
 .../leaderelection/ring/RingInstance.java     |  18 +-
 .../leaderelection/bully/BullyAppTest.java    |   9 +-
 .../leaderelection/ring/RingAppTest.java      |   9 +-
 leader-followers/pom.xml                      |   5 +
 .../iluwatar/leaderfollowers}/App.java        |   0
 .../iluwatar/leaderfollowers}/Task.java       |   0
 .../leaderfollowers}/TaskHandler.java         |   0
 .../iluwatar/leaderfollowers}/TaskSet.java    |   0
 .../iluwatar/leaderfollowers}/WorkCenter.java |   0
 .../iluwatar/leaderfollowers}/Worker.java     |   0
 .../AppTest.java                              |  10 +-
 .../TaskHandlerTest.java                      |   4 +-
 .../TaskSetTest.java                          |   4 +-
 .../WorkCenterTest.java                       |   5 +-
 marker/src/test/java/AppTest.java             |   8 +-
 .../java/com/iluwatar/mediator/AppTest.java   |   8 +-
 .../java/com/iluwatar/memento/AppTest.java    |   8 +-
 .../model/view/controller/AppTest.java        |   8 +-
 .../view/presenter/FileSelectorJFrame.java    |  10 +-
 .../model/view/presenter/AppTest.java         |   8 +-
 .../java/com/iluwatar/module/AppTest.java     |   9 +-
 .../test/java/com/iluwatar/mute/AppTest.java  |   8 +-
 .../test/java/com/iluwatar/mute/MuteTest.java |  19 +-
 .../test/java/com/iluwatar/mutex/AppTest.java |   9 +-
 .../java/com/iluwatar/nullobject/AppTest.java |   9 +-
 .../com/iluwatar/nullobject/NullNodeTest.java |  13 +-
 .../java/com/iluwatar/object/pool/App.java    |  12 +-
 .../com/iluwatar/object/pool/AppTest.java     |   7 +-
 .../java/com/iluwatar/observer/AppTest.java   |   9 +-
 partial-response/pom.xml                      |   5 +
 .../com/iluwatar/partialresponse/AppTest.java |   6 +-
 .../java/com/iluwatar/pipeline/AppTest.java   |   8 +-
 .../com/iluwatar/poison/pill/AppTest.java     |   8 +-
 .../iluwatar/privateclassdata/AppTest.java    |   8 +-
 .../iluwatar/producer/consumer/AppTest.java   |   8 +-
 .../java/com/iluwatar/promise/Promise.java    |   1 +
 .../java/com/iluwatar/promise/AppTest.java    |   8 +-
 .../com/iluwatar/promise/PromiseTest.java     |   2 +-
 .../java/com/iluwatar/property/Character.java |   2 +
 .../java/com/iluwatar/property/AppTest.java   |   8 +-
 .../java/com/iluwatar/prototype/AppTest.java  |   8 +-
 .../test/java/com/iluwatar/proxy/AppTest.java |   8 +-
 .../iluwatar/queue/load/leveling/AppTest.java |   9 +-
 .../load/leveling/TaskGenSrvExeTest.java      |  11 +-
 .../com/iluwatar/reactor/app/ReactorTest.java |  11 +
 .../iluwatar/reader/writer/lock/AppTest.java  |   8 +-
 .../java/com/iluwatar/repository/AppTest.java |   9 +-
 .../is/initialization/AppTest.java            |   8 +-
 .../src/main/java/com/iluwatar/retry/App.java |   7 +-
 role-object/pom.xml                           |   5 +
 .../roleobject/ApplicationRoleObjectTest.java |   6 +-
 saga/pom.xml                                  |   5 +
 .../choreography/SagaApplicationTest.java     |   6 +-
 .../java/com/iluwatar/semaphore/AppTest.java  |   9 +-
 .../java/com/iluwatar/servant/AppTest.java    |   8 +-
 .../com/iluwatar/servicelayer/app/App.java    |   7 +-
 .../iluwatar/servicelayer/app/AppTest.java    |  10 +-
 .../java/com/iluwatar/servicelocator/App.java |  11 +-
 .../com/iluwatar/servicelocator/AppTest.java  |   8 +-
 sharding/pom.xml                              |   5 +
 .../main/java/com/iluwatar/sharding/App.java  |   8 +-
 .../main/java/com/iluwatar/sharding/Data.java |   2 +-
 .../iluwatar/sharding/RangeShardManager.java  |   6 +-
 .../java/com/iluwatar/sharding/AppTest.java   |   6 +-
 .../sharding/HashShardManagerTest.java        |   2 +-
 .../sharding/LookupShardManagerTest.java      |   2 +-
 .../sharding/RangeShardManagerTest.java       |   2 +-
 .../java/com/iluwatar/sharding/ShardTest.java |   2 +-
 .../java/com/iluwatar/singleton/AppTest.java  |   8 +-
 .../com/iluwatar/spatialpartition/App.java    |   7 +-
 .../SpatialPartitionBubbles.java              |   4 +-
 .../iluwatar/specification/app/AppTest.java   |   8 +-
 .../test/java/com/iluwatar/state/AppTest.java |   8 +-
 .../com/iluwatar/stepbuilder/AppTest.java     |   8 +-
 .../com/iluwatar/strangler/NewSource.java     |   7 +-
 .../java/com/iluwatar/strangler/AppTest.java  |   9 +-
 .../java/com/iluwatar/strategy/AppTest.java   |   8 +-
 subclass-sandbox/pom.xml                      |   5 +
 .../com/iluwatar/subclasssandbox/AppTest.java |   6 +-
 .../com/iluwatar/templatemethod/AppTest.java  |   8 +-
 .../java/com/iluwatar/threadpool/AppTest.java |   8 +-
 .../java/com/iluwatar/throttling/AppTest.java |   8 +-
 .../test/java/com/iluwatar/tls/AppTest.java   |   8 +-
 .../tolerantreader/RainbowFishSerializer.java |  13 +-
 .../com/iluwatar/tolerantreader/AppTest.java  |  10 +-
 .../iluwatar/transactionscript/AppTest.java   |   9 +-
 .../test/java/com/iluwatar/twin/AppTest.java  |   8 +-
 .../java/com/iluwatar/typeobject/Candy.java   |   4 +-
 .../com/iluwatar/typeobject/CandyGame.java    |   6 +-
 .../java/com/iluwatar/typeobject/Cell.java    |   4 +-
 .../com/iluwatar/typeobject/CellPool.java     |  16 +-
 .../com/iluwatar/typeobject/JsonParser.java   |   6 +-
 .../iluwatar/typeobject/CandyGameTest.java    |   6 +-
 .../com/iluwatar/typeobject/CellTest.java     |   8 +-
 unit-of-work/pom.xml                          |   5 +
 .../com/iluwatar/unitofwork/IUnitOfWork.java  |   3 -
 .../unitofwork/StudentRepository.java         |  18 +-
 .../com/iluwatar/unitofwork/UnitActions.java  |  18 +
 .../java/com/iluwatar/unitofwork/AppTest.java |   6 +-
 .../unitofwork/StudentRepositoryTest.java     |  24 +-
 update-method/pom.xml                         |   5 +
 .../java/com/iluwatar/updatemethod/World.java |   1 +
 .../com/iluwatar/updatemethod/AppTest.java    |   7 +-
 .../com/iluwatar/value/object/AppTest.java    |   8 +-
 .../java/com/iluwatar/visitor/AppTest.java    |   8 +-
 190 files changed, 1426 insertions(+), 661 deletions(-)
 create mode 100644 ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/App.java (100%)
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/Task.java (100%)
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/TaskHandler.java (100%)
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/TaskSet.java (100%)
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/WorkCenter.java (100%)
 rename leader-followers/src/main/java/{com.iluwatar.leaderfollowers => com/iluwatar/leaderfollowers}/Worker.java (100%)
 rename leader-followers/src/test/java/{com.iluwatar.leaderfollowers => com}/AppTest.java (83%)
 rename leader-followers/src/test/java/{com.iluwatar.leaderfollowers => com}/TaskHandlerTest.java (93%)
 rename leader-followers/src/test/java/{com.iluwatar.leaderfollowers => com}/TaskSetTest.java (94%)
 rename leader-followers/src/test/java/{com.iluwatar.leaderfollowers => com}/WorkCenterTest.java (93%)
 create mode 100644 unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java

diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
index aed63f303..dca4f040f 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
@@ -25,14 +25,23 @@ package com.iluwatar.abstractdocument;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Simple App test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
 
   @Test
-  public void shouldExecuteAppWithoutException() {
-    App.main(null);
+  void shouldExecuteAppWithoutException() {
+    assertDoesNotThrow(() -> App.main(null));
   }
 
 }
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 4036cc9b8..238ff76d0 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -25,12 +25,23 @@ package com.iluwatar.abstractfactory;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Abstract Factory example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
index 4b9a7ec6c..842779fff 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
@@ -25,13 +25,23 @@ package com.iluwatar.acyclicvisitor;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that the Acyclic Visitor example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
index 3bf8e1010..3748c64f6 100644
--- a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
+++ b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
@@ -25,12 +25,23 @@ package com.iluwatar.adapter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Adapter example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
index a80806851..42b09d617 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
@@ -62,7 +62,7 @@ public class RemoteService implements RemoteServiceInterface {
    *
    * @param value integer value to be multiplied.
    * @return if waitTime is less than {@link RemoteService#THRESHOLD}, it returns value * 10,
-   *     otherwise {@link RemoteServiceInterface#FAILURE}.
+   *     otherwise {@link RemoteServiceStatus#FAILURE}.
    */
   @Override
   public long doRemoteFunction(int value) {
@@ -74,6 +74,6 @@ public class RemoteService implements RemoteServiceInterface {
     } catch (InterruptedException e) {
       LOGGER.error("Thread sleep state interrupted", e);
     }
-    return waitTime <= THRESHOLD ? value * 10 : FAILURE;
+    return waitTime <= THRESHOLD ? value * 10 : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();
   }
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
index 5b4995134..eadb981a2 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
@@ -27,7 +27,6 @@ package com.iluwatar.ambassador;
  * Interface shared by ({@link RemoteService}) and ({@link ServiceAmbassador}).
  */
 interface RemoteServiceInterface {
-  int FAILURE = -1;
 
   long doRemoteFunction(int value);
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
new file mode 100644
index 000000000..f9faebd0e
--- /dev/null
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
@@ -0,0 +1,23 @@
+package com.iluwatar.ambassador;
+
+/**
+ * Holds information regarding the status of the Remote Service.
+ *
+ * !Attention - This Enum replaces the integer value previously stored in {@link RemoteServiceInterface}
+ * as SonarCloud was identifying it as an issue. All test cases have been checked after changes, without failures.
+ */
+
+public enum RemoteServiceStatus {
+    FAILURE(-1)
+    ;
+
+    private final long remoteServiceStatusValue;
+
+    RemoteServiceStatus(long remoteServiceStatusValue) {
+        this.remoteServiceStatusValue = remoteServiceStatusValue;
+    }
+
+    public long getRemoteServiceStatusValue() {
+        return remoteServiceStatusValue;
+    }
+}
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
index a9d34581c..57e444d88 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
@@ -23,6 +23,7 @@
 
 package com.iluwatar.ambassador;
 
+import static com.iluwatar.ambassador.RemoteServiceStatus.FAILURE;
 import static java.lang.Thread.sleep;
 
 import org.slf4j.Logger;
@@ -58,14 +59,14 @@ public class ServiceAmbassador implements RemoteServiceInterface {
 
   private long safeCall(int value) {
     var retries = 0;
-    var result = (long) FAILURE;
+    var result = FAILURE.getRemoteServiceStatusValue();
 
     for (int i = 0; i < RETRIES; i++) {
       if (retries >= RETRIES) {
-        return FAILURE;
+        return FAILURE.getRemoteServiceStatusValue();
       }
 
-      if ((result = checkLatency(value)) == FAILURE) {
+      if ((result = checkLatency(value)) == FAILURE.getRemoteServiceStatusValue()) {
         LOGGER.info("Failed to reach remote: (" + (i + 1) + ")");
         retries++;
         try {
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
index c9a4d09b6..186f13715 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
@@ -25,13 +25,23 @@ package com.iluwatar.ambassador;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
 class AppTest {
 
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
index 12a93a1cb..bab319bee 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
@@ -37,6 +37,6 @@ class ClientTest {
     Client client = new Client();
     var result = client.useService(10);
 
-    assertTrue(result == 100 || result == RemoteService.FAILURE);
+    assertTrue(result == 100 || result == RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue());
   }
 }
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
index 6c45acf66..374a909f3 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
@@ -37,7 +37,7 @@ class RemoteServiceTest {
   void testFailedCall() {
     var remoteService = new RemoteService(new StaticRandomProvider(0.21));
     var result = remoteService.doRemoteFunction(10);
-    assertEquals(RemoteServiceInterface.FAILURE, result);
+    assertEquals(RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue(), result);
   }
 
   @Test
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
index 8eb55b30a..48d128115 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
@@ -35,6 +35,6 @@ class ServiceAmbassadorTest {
   @Test
   void test() {
     long result = new ServiceAmbassador().doRemoteFunction(10);
-    assertTrue(result == 100 || result == RemoteServiceInterface.FAILURE);
+    assertTrue(result == 100 || result == RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue());
   }
 }
diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
index 830e66a2d..5dfe901e8 100644
--- a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
+++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
@@ -25,12 +25,24 @@ package com.iluwatar.async.method.invocation;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
 class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+
   }
 }
diff --git a/balking/src/test/java/com/iluwatar/balking/AppTest.java b/balking/src/test/java/com/iluwatar/balking/AppTest.java
index 8c75a1f62..b12b6e1ec 100644
--- a/balking/src/test/java/com/iluwatar/balking/AppTest.java
+++ b/balking/src/test/java/com/iluwatar/balking/AppTest.java
@@ -24,15 +24,26 @@
 package com.iluwatar.balking;
 
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.function.Executable;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 
 /**
  * Application test
  */
 class AppTest {
 
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  void main() {
-    App.main();
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow((Executable) App::main);
   }
 
 }
\ No newline at end of file
diff --git a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
index d3edbb27c..026f0954c 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
@@ -25,12 +25,22 @@ package com.iluwatar.bridge;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
 class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/builder/src/test/java/com/iluwatar/builder/AppTest.java b/builder/src/test/java/com/iluwatar/builder/AppTest.java
index 941f62f75..29b6ecb15 100644
--- a/builder/src/test/java/com/iluwatar/builder/AppTest.java
+++ b/builder/src/test/java/com/iluwatar/builder/AppTest.java
@@ -25,12 +25,23 @@ package com.iluwatar.builder;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
 class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
index 48e756acb..6c57e145e 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
@@ -27,13 +27,23 @@ import org.junit.jupiter.api.Test;
 
 import java.io.IOException;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Business Delegate example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  public void test() throws IOException {
-    String[] args = {};
-    App.main(args);
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/App.java b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
index 04f473cee..b85d8ef05 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/App.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
@@ -58,12 +58,14 @@ public class App {
     var vm = new VirtualMachine();
     vm.getWizards()[0] = wizard;
 
-    interpretInstruction("LITERAL 0", vm);
-    interpretInstruction("LITERAL 0", vm);
+    String literal = "LITERAL 0";
+
+    interpretInstruction(literal, vm);
+    interpretInstruction(literal, vm);
     interpretInstruction("GET_HEALTH", vm);
-    interpretInstruction("LITERAL 0", vm);
+    interpretInstruction(literal, vm);
     interpretInstruction("GET_AGILITY", vm);
-    interpretInstruction("LITERAL 0", vm);
+    interpretInstruction(literal, vm);
     interpretInstruction("GET_WISDOM ", vm);
     interpretInstruction("ADD", vm);
     interpretInstruction("LITERAL 2", vm);
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
index 59962d39e..31060b683 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.bytecode;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/caching/src/test/java/com/iluwatar/caching/AppTest.java b/caching/src/test/java/com/iluwatar/caching/AppTest.java
index 831cfe493..20a03282d 100644
--- a/caching/src/test/java/com/iluwatar/caching/AppTest.java
+++ b/caching/src/test/java/com/iluwatar/caching/AppTest.java
@@ -27,12 +27,23 @@ import org.junit.jupiter.api.Test;
 
 import java.io.IOException;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Caching example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/callback/src/test/java/com/iluwatar/callback/AppTest.java b/callback/src/test/java/com/iluwatar/callback/AppTest.java
index c1f466dee..3a70df7e0 100644
--- a/callback/src/test/java/com/iluwatar/callback/AppTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/AppTest.java
@@ -25,12 +25,23 @@ package com.iluwatar.callback;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Callback example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/chain/src/test/java/com/iluwatar/chain/AppTest.java b/chain/src/test/java/com/iluwatar/chain/AppTest.java
index 164ff9bfe..6cd696517 100644
--- a/chain/src/test/java/com/iluwatar/chain/AppTest.java
+++ b/chain/src/test/java/com/iluwatar/chain/AppTest.java
@@ -25,13 +25,23 @@ package com.iluwatar.chain;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/combinator/pom.xml b/combinator/pom.xml
index 3edfa7580..c2677fcc1 100644
--- a/combinator/pom.xml
+++ b/combinator/pom.xml
@@ -39,6 +39,12 @@
       <artifactId>junit</artifactId>
       <scope>test</scope>
     </dependency>
+
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 
 </project>
diff --git a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
index f42b46c14..6e7b4f63f 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
@@ -25,12 +25,19 @@ package com.iluwatar.combinator;
 
 import org.junit.Test;
 
-import static org.junit.Assert.*;
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 public class CombinatorAppTest {
 
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link CombinatorApp#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void main() {
-    CombinatorApp.main(new String[]{});
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> CombinatorApp.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/command/src/test/java/com/iluwatar/command/AppTest.java b/command/src/test/java/com/iluwatar/command/AppTest.java
index cf691aba3..73d098fa3 100644
--- a/command/src/test/java/com/iluwatar/command/AppTest.java
+++ b/command/src/test/java/com/iluwatar/command/AppTest.java
@@ -25,12 +25,21 @@ package com.iluwatar.command;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Command example runs without errors.
  */
-public class AppTest {
+class AppTest {
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/commander/src/main/java/com/iluwatar/commander/Commander.java b/commander/src/main/java/com/iluwatar/commander/Commander.java
index 41779c076..c2e124663 100644
--- a/commander/src/main/java/com/iluwatar/commander/Commander.java
+++ b/commander/src/main/java/com/iluwatar/commander/Commander.java
@@ -39,6 +39,8 @@ import com.iluwatar.commander.shippingservice.ShippingService;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import java.util.List;
+
 /**
  * <p>Commander pattern is used to handle all issues that can come up while making a
  * distributed transaction. The idea is to have a commander, which coordinates the execution of all
@@ -159,8 +161,8 @@ public class Commander {
 
   private void sendPaymentRequest(Order order) {
     if (System.currentTimeMillis() - order.createdTime >= this.paymentTime) {
-      if (order.paid.equals(PaymentStatus.Trying)) {
-        order.paid = PaymentStatus.NotDone;
+      if (order.paid.equals(PaymentStatus.TRYING)) {
+        order.paid = PaymentStatus.NOT_DONE;
         sendPaymentFailureMessage(order);
         LOG.error("Order " + order.id + ": Payment time for order over, failed and returning..");
       } //if succeeded or failed, would have been dequeued, no attempt to make payment     
@@ -169,53 +171,10 @@ public class Commander {
     var list = paymentService.exceptionsList;
     var t = new Thread(() -> {
       Retry.Operation op = (l) -> {
-        if (!l.isEmpty()) {
-          if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
-            LOG.debug("Order " + order.id + ": Error in connecting to payment service,"
-                + " trying again..");
-          } else {
-            LOG.debug("Order " + order.id + ": Error in creating payment request..");
-          }
-          throw l.remove(0);
-        }
-        if (order.paid.equals(PaymentStatus.Trying)) {
-          var transactionId = paymentService.receiveRequest(order.price);
-          order.paid = PaymentStatus.Done;
-          LOG.info("Order " + order.id + ": Payment successful, transaction Id: " + transactionId);
-          if (!finalSiteMsgShown) {
-            LOG.info("Payment made successfully, thank you for shopping with us!!");
-            finalSiteMsgShown = true;
-          }
-          sendSuccessMessage(order);
-        }
+        handlePaymentRetryOperation(order, l);
       };
       Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
-        if (PaymentDetailsErrorException.class.isAssignableFrom(err.getClass())) {
-          if (!finalSiteMsgShown) {
-            LOG.info("There was an error in payment. Your account/card details "
-                + "may have been incorrect. "
-                + "Meanwhile, your order has been converted to COD and will be shipped.");
-            finalSiteMsgShown = true;
-          }
-          LOG.error("Order " + order.id + ": Payment details incorrect, failed..");
-          o.paid = PaymentStatus.NotDone;
-          sendPaymentFailureMessage(o);
-        } else {
-          if (o.messageSent.equals(MessageSent.NoneSent)) {
-            if (!finalSiteMsgShown) {
-              LOG.info("There was an error in payment. We are on it, and will get back to you "
-                  + "asap. Don't worry, your order has been placed and will be shipped.");
-              finalSiteMsgShown = true;
-            }
-            LOG.warn("Order " + order.id + ": Payment error, going to queue..");
-            sendPaymentPossibleErrorMsg(o);
-          }
-          if (o.paid.equals(PaymentStatus.Trying) && System
-              .currentTimeMillis() - o.createdTime < paymentTime) {
-            var qt = new QueueTask(o, TaskType.Payment, -1);
-            updateQueue(qt);
-          }
-        }
+        handlePaymentErrorIssue(order, o, err);
       };
       var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
           e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
@@ -228,18 +187,70 @@ public class Commander {
     t.start();
   }
 
+  private void handlePaymentRetryOperation(Order order, List<Exception> l) throws Exception {
+    if (!l.isEmpty()) {
+      if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
+        LOG.debug("Order " + order.id + ": Error in connecting to payment service,"
+            + " trying again..");
+      } else {
+        LOG.debug("Order " + order.id + ": Error in creating payment request..");
+      }
+      throw l.remove(0);
+    }
+    if (order.paid.equals(PaymentStatus.TRYING)) {
+      var transactionId = paymentService.receiveRequest(order.price);
+      order.paid = PaymentStatus.DONE;
+      LOG.info("Order " + order.id + ": Payment successful, transaction Id: " + transactionId);
+
+      if (!finalSiteMsgShown) {
+        LOG.info("Payment made successfully, thank you for shopping with us!!");
+        finalSiteMsgShown = true;
+      }
+      sendSuccessMessage(order);
+    }
+  }
+
+  private void handlePaymentErrorIssue(Order order, Order o, Exception err) {
+    if (PaymentDetailsErrorException.class.isAssignableFrom(err.getClass())) {
+      if (!finalSiteMsgShown) {
+        LOG.info("There was an error in payment. Your account/card details "
+            + "may have been incorrect. "
+            + "Meanwhile, your order has been converted to COD and will be shipped.");
+        finalSiteMsgShown = true;
+      }
+      LOG.error("Order " + order.id + ": Payment details incorrect, failed..");
+      o.paid = PaymentStatus.NOT_DONE;
+      sendPaymentFailureMessage(o);
+    } else {
+      if (o.messageSent.equals(MessageSent.NONE_SENT)) {
+        if (!finalSiteMsgShown) {
+          LOG.info("There was an error in payment. We are on it, and will get back to you "
+              + "asap. Don't worry, your order has been placed and will be shipped.");
+          finalSiteMsgShown = true;
+        }
+        LOG.warn("Order " + order.id + ": Payment error, going to queue..");
+        sendPaymentPossibleErrorMsg(o);
+      }
+      if (o.paid.equals(PaymentStatus.TRYING) && System
+          .currentTimeMillis() - o.createdTime < paymentTime) {
+        var qt = new QueueTask(o, TaskType.PAYMENT, -1);
+        updateQueue(qt);
+      }
+    }
+  }
+
   private void updateQueue(QueueTask qt) {
     if (System.currentTimeMillis() - qt.order.createdTime >= this.queueTime) {
       // since payment time is lesser than queuetime it would have already failed..
       // additional check not needed
       LOG.trace("Order " + qt.order.id + ": Queue time for order over, failed..");
       return;
-    } else if (qt.taskType.equals(TaskType.Payment) && !qt.order.paid.equals(PaymentStatus.Trying)
-        || qt.taskType.equals(TaskType.Messaging) && (qt.messageType == 1
-        && !qt.order.messageSent.equals(MessageSent.NoneSent)
-        || qt.order.messageSent.equals(MessageSent.PaymentFail)
-        || qt.order.messageSent.equals(MessageSent.PaymentSuccessful))
-        || qt.taskType.equals(TaskType.EmployeeDb) && qt.order.addedToEmployeeHandle) {
+    } else if (qt.taskType.equals(TaskType.PAYMENT) && !qt.order.paid.equals(PaymentStatus.TRYING)
+        || qt.taskType.equals(TaskType.MESSAGING) && (qt.messageType == 1
+        && !qt.order.messageSent.equals(MessageSent.NONE_SENT)
+        || qt.order.messageSent.equals(MessageSent.PAYMENT_FAIL)
+        || qt.order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL))
+        || qt.taskType.equals(TaskType.EMPLOYEE_DB) && qt.order.addedToEmployeeHandle) {
       LOG.trace("Order " + qt.order.id + ": Not queueing task since task already done..");
       return;
     }
@@ -256,8 +267,8 @@ public class Commander {
         tryDoingTasksInQueue();
       };
       Retry.HandleErrorIssue<QueueTask> handleError = (qt1, err) -> {
-        if (qt1.taskType.equals(TaskType.Payment)) {
-          qt1.order.paid = PaymentStatus.NotDone;
+        if (qt1.taskType.equals(TaskType.PAYMENT)) {
+          qt1.order.paid = PaymentStatus.NOT_DONE;
           sendPaymentFailureMessage(qt1.order);
           LOG.error("Order " + qt1.order.id + ": Unable to enqueue payment task,"
               + " payment failed..");
@@ -331,7 +342,35 @@ public class Commander {
     }
     var list = messagingService.exceptionsList;
     Thread t = new Thread(() -> {
-      Retry.Operation op = (l) -> {
+      Retry.Operation op = handleSuccessMessageRetryOperation(order);
+      Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
+        handleSuccessMessageErrorIssue(order, o);
+      };
+      var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
+          e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
+      try {
+        r.perform(list, order);
+      } catch (Exception e1) {
+        e1.printStackTrace();
+      }
+    });
+    t.start();
+  }
+
+  private void handleSuccessMessageErrorIssue(Order order, Order o) {
+    if ((o.messageSent.equals(MessageSent.NONE_SENT) || o.messageSent
+        .equals(MessageSent.PAYMENT_TRYING))
+        && System.currentTimeMillis() - o.createdTime < messageTime) {
+      var qt = new QueueTask(order, TaskType.MESSAGING, 2);
+      updateQueue(qt);
+      LOG.info("Order " + order.id + ": Error in sending Payment Success message, trying to"
+          + " queue task and add to employee handle..");
+      employeeHandleIssue(order);
+    }
+  }
+
+  private Retry.Operation handleSuccessMessageRetryOperation(Order order) {
+    return (l) -> {
         if (!l.isEmpty()) {
           if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
             LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
@@ -342,34 +381,14 @@ public class Commander {
           }
           throw l.remove(0);
         }
-        if (!order.messageSent.equals(MessageSent.PaymentFail)
-            && !order.messageSent.equals(MessageSent.PaymentSuccessful)) {
+        if (!order.messageSent.equals(MessageSent.PAYMENT_FAIL)
+            && !order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL)) {
           var requestId = messagingService.receiveRequest(2);
-          order.messageSent = MessageSent.PaymentSuccessful;
+          order.messageSent = MessageSent.PAYMENT_SUCCESSFUL;
           LOG.info("Order " + order.id + ": Payment Success message sent,"
               + " request Id: " + requestId);
         }
       };
-      Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
-        if ((o.messageSent.equals(MessageSent.NoneSent) || o.messageSent
-            .equals(MessageSent.PaymentTrying))
-            && System.currentTimeMillis() - o.createdTime < messageTime) {
-          var qt = new QueueTask(order, TaskType.Messaging, 2);
-          updateQueue(qt);
-          LOG.info("Order " + order.id + ": Error in sending Payment Success message, trying to"
-              + " queue task and add to employee handle..");
-          employeeHandleIssue(order);
-        }
-      };
-      var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
-          e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
-      try {
-        r.perform(list, order);
-      } catch (Exception e1) {
-        e1.printStackTrace();
-      }
-    });
-    t.start();
   }
 
   private void sendPaymentFailureMessage(Order order) {
@@ -380,34 +399,10 @@ public class Commander {
     var list = messagingService.exceptionsList;
     var t = new Thread(() -> {
       Retry.Operation op = (l) -> {
-        if (!l.isEmpty()) {
-          if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
-            LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
-                + "(Payment Failure msg), trying again..");
-          } else {
-            LOG.debug("Order " + order.id + ": Error in creating Payment Failure"
-                + " message request..");
-          }
-          throw l.remove(0);
-        }
-        if (!order.messageSent.equals(MessageSent.PaymentFail)
-            && !order.messageSent.equals(MessageSent.PaymentSuccessful)) {
-          var requestId = messagingService.receiveRequest(0);
-          order.messageSent = MessageSent.PaymentFail;
-          LOG.info("Order " + order.id + ": Payment Failure message sent successfully,"
-              + " request Id: " + requestId);
-        }
+        handlePaymentFailureRetryOperation(order, l);
       };
       Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
-        if ((o.messageSent.equals(MessageSent.NoneSent) || o.messageSent
-            .equals(MessageSent.PaymentTrying))
-            && System.currentTimeMillis() - o.createdTime < messageTime) {
-          var qt = new QueueTask(order, TaskType.Messaging, 0);
-          updateQueue(qt);
-          LOG.warn("Order " + order.id + ": Error in sending Payment Failure message, "
-              + "trying to queue task and add to employee handle..");
-          employeeHandleIssue(o);
-        }
+        handlePaymentErrorIssue(order, o);
       };
       var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
           e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
@@ -420,6 +415,38 @@ public class Commander {
     t.start();
   }
 
+  private void handlePaymentErrorIssue(Order order, Order o) {
+    if ((o.messageSent.equals(MessageSent.NONE_SENT) || o.messageSent
+        .equals(MessageSent.PAYMENT_TRYING))
+        && System.currentTimeMillis() - o.createdTime < messageTime) {
+      var qt = new QueueTask(order, TaskType.MESSAGING, 0);
+      updateQueue(qt);
+      LOG.warn("Order " + order.id + ": Error in sending Payment Failure message, "
+          + "trying to queue task and add to employee handle..");
+      employeeHandleIssue(o);
+    }
+  }
+
+  private void handlePaymentFailureRetryOperation(Order order, List<Exception> l) throws Exception {
+    if (!l.isEmpty()) {
+      if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
+        LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
+            + "(Payment Failure msg), trying again..");
+      } else {
+        LOG.debug("Order " + order.id + ": Error in creating Payment Failure"
+            + " message request..");
+      }
+      throw l.remove(0);
+    }
+    if (!order.messageSent.equals(MessageSent.PAYMENT_FAIL)
+        && !order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL)) {
+      var requestId = messagingService.receiveRequest(0);
+      order.messageSent = MessageSent.PAYMENT_FAIL;
+      LOG.info("Order " + order.id + ": Payment Failure message sent successfully,"
+          + " request Id: " + requestId);
+    }
+  }
+
   private void sendPaymentPossibleErrorMsg(Order order) {
     if (System.currentTimeMillis() - order.createdTime >= this.messageTime) {
       LOG.trace("Message time for order over, returning..");
@@ -428,34 +455,10 @@ public class Commander {
     var list = messagingService.exceptionsList;
     var t = new Thread(() -> {
       Retry.Operation op = (l) -> {
-        if (!l.isEmpty()) {
-          if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
-            LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
-                + "(Payment Error msg), trying again..");
-          } else {
-            LOG.debug("Order " + order.id + ": Error in creating Payment Error"
-                + " messaging request..");
-          }
-          throw l.remove(0);
-        }
-        if (order.paid.equals(PaymentStatus.Trying) && order.messageSent
-            .equals(MessageSent.NoneSent)) {
-          var requestId = messagingService.receiveRequest(1);
-          order.messageSent = MessageSent.PaymentTrying;
-          LOG.info("Order " + order.id + ": Payment Error message sent successfully,"
-              + " request Id: " + requestId);
-        }
+        handlePaymentPossibleErrorMsgRetryOperation(order, l);
       };
       Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
-        if (o.messageSent.equals(MessageSent.NoneSent) && order.paid
-            .equals(PaymentStatus.Trying)
-            && System.currentTimeMillis() - o.createdTime < messageTime) {
-          var qt = new QueueTask(order, TaskType.Messaging, 1);
-          updateQueue(qt);
-          LOG.warn("Order " + order.id + ": Error in sending Payment Error message, "
-              + "trying to queue task and add to employee handle..");
-          employeeHandleIssue(o);
-        }
+        handlePaymentPossibleErrorMsgErrorIssue(order, o);
       };
       var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
           e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
@@ -468,6 +471,38 @@ public class Commander {
     t.start();
   }
 
+  private void handlePaymentPossibleErrorMsgErrorIssue(Order order, Order o) {
+    if (o.messageSent.equals(MessageSent.NONE_SENT) && order.paid
+        .equals(PaymentStatus.TRYING)
+        && System.currentTimeMillis() - o.createdTime < messageTime) {
+      var qt = new QueueTask(order, TaskType.MESSAGING, 1);
+      updateQueue(qt);
+      LOG.warn("Order " + order.id + ": Error in sending Payment Error message, "
+          + "trying to queue task and add to employee handle..");
+      employeeHandleIssue(o);
+    }
+  }
+
+  private void handlePaymentPossibleErrorMsgRetryOperation(Order order, List<Exception> l) throws Exception {
+    if (!l.isEmpty()) {
+      if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
+        LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
+            + "(Payment Error msg), trying again..");
+      } else {
+        LOG.debug("Order " + order.id + ": Error in creating Payment Error"
+            + " messaging request..");
+      }
+      throw l.remove(0);
+    }
+    if (order.paid.equals(PaymentStatus.TRYING) && order.messageSent
+        .equals(MessageSent.NONE_SENT)) {
+      var requestId = messagingService.receiveRequest(1);
+      order.messageSent = MessageSent.PAYMENT_TRYING;
+      LOG.info("Order " + order.id + ": Payment Error message sent successfully,"
+          + " request Id: " + requestId);
+    }
+  }
+
   private void employeeHandleIssue(Order order) {
     if (System.currentTimeMillis() - order.createdTime >= this.employeeTime) {
       LOG.trace("Order " + order.id + ": Employee handle time for order over, returning..");
@@ -490,7 +525,7 @@ public class Commander {
       Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
         if (!o.addedToEmployeeHandle && System
             .currentTimeMillis() - order.createdTime < employeeTime) {
-          var qt = new QueueTask(order, TaskType.EmployeeDb, -1);
+          var qt = new QueueTask(order, TaskType.EMPLOYEE_DB, -1);
           updateQueue(qt);
           LOG.warn("Order " + order.id + ": Error in adding to employee db,"
               + " trying to queue task..");
@@ -520,21 +555,21 @@ public class Commander {
         LOG.trace("Order " + qt.order.id + ": This queue task of type " + qt.getType()
             + " does not need to be done anymore (timeout), dequeue..");
       } else {
-        if (qt.taskType.equals(TaskType.Payment)) {
-          if (!qt.order.paid.equals(PaymentStatus.Trying)) {
+        if (qt.taskType.equals(TaskType.PAYMENT)) {
+          if (!qt.order.paid.equals(PaymentStatus.TRYING)) {
             tryDequeue();
             LOG.trace("Order " + qt.order.id + ": This payment task already done, dequeueing..");
           } else {
             sendPaymentRequest(qt.order);
             LOG.debug("Order " + qt.order.id + ": Trying to connect to payment service..");
           }
-        } else if (qt.taskType.equals(TaskType.Messaging)) {
-          if (qt.order.messageSent.equals(MessageSent.PaymentFail)
-              || qt.order.messageSent.equals(MessageSent.PaymentSuccessful)) {
+        } else if (qt.taskType.equals(TaskType.MESSAGING)) {
+          if (qt.order.messageSent.equals(MessageSent.PAYMENT_FAIL)
+              || qt.order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL)) {
             tryDequeue();
             LOG.trace("Order " + qt.order.id + ": This messaging task already done, dequeue..");
-          } else if (qt.messageType == 1 && (!qt.order.messageSent.equals(MessageSent.NoneSent)
-              || !qt.order.paid.equals(PaymentStatus.Trying))) {
+          } else if (qt.messageType == 1 && (!qt.order.messageSent.equals(MessageSent.NONE_SENT)
+              || !qt.order.paid.equals(PaymentStatus.TRYING))) {
             tryDequeue();
             LOG.trace("Order " + qt.order.id + ": This messaging task does not need to be done,"
                 + " dequeue..");
@@ -548,7 +583,7 @@ public class Commander {
             sendSuccessMessage(qt.order);
             LOG.debug("Order " + qt.order.id + ": Trying to connect to messaging service..");
           }
-        } else if (qt.taskType.equals(TaskType.EmployeeDb)) {
+        } else if (qt.taskType.equals(TaskType.EMPLOYEE_DB)) {
           if (qt.order.addedToEmployeeHandle) {
             tryDequeue();
             LOG.trace("Order " + qt.order.id + ": This employee handle task already done,"
diff --git a/commander/src/main/java/com/iluwatar/commander/Order.java b/commander/src/main/java/com/iluwatar/commander/Order.java
index 87a9f794a..f736aa47c 100644
--- a/commander/src/main/java/com/iluwatar/commander/Order.java
+++ b/commander/src/main/java/com/iluwatar/commander/Order.java
@@ -33,11 +33,11 @@ import java.util.Random;
 public class Order { //can store all transactions ids also
 
   enum PaymentStatus {
-    NotDone, Trying, Done
+    NOT_DONE, TRYING, DONE
   }
 
   enum MessageSent {
-    NoneSent, PaymentFail, PaymentTrying, PaymentSuccessful
+    NONE_SENT, PAYMENT_FAIL, PAYMENT_TRYING, PAYMENT_SUCCESSFUL
   }
 
   final User user;
@@ -65,8 +65,8 @@ public class Order { //can store all transactions ids also
     }
     this.id = id;
     USED_IDS.put(this.id, true);
-    this.paid = PaymentStatus.Trying;
-    this.messageSent = MessageSent.NoneSent;
+    this.paid = PaymentStatus.TRYING;
+    this.messageSent = MessageSent.NONE_SENT;
     this.addedToEmployeeHandle = false;
   }
 
diff --git a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
index 3fb385757..e353a4c7c 100644
--- a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
+++ b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
@@ -38,7 +38,7 @@ public class MessagingService extends Service {
   private static final Logger LOGGER = LoggerFactory.getLogger(MessagingService.class);
 
   enum MessageToSend {
-    PaymentFail, PaymentTrying, PaymentSuccessful
+    PAYMENT_FAIL, PAYMENT_TRYING, PAYMENT_SUCCESSFUL
   }
 
   class MessageRequest {
@@ -63,11 +63,11 @@ public class MessagingService extends Service {
     var id = generateId();
     MessageToSend msg;
     if (messageToSend == 0) {
-      msg = MessageToSend.PaymentFail;
+      msg = MessageToSend.PAYMENT_FAIL;
     } else if (messageToSend == 1) {
-      msg = MessageToSend.PaymentTrying;
+      msg = MessageToSend.PAYMENT_TRYING;
     } else { //messageToSend == 2
-      msg = MessageToSend.PaymentSuccessful;
+      msg = MessageToSend.PAYMENT_SUCCESSFUL;
     }
     var req = new MessageRequest(id, msg);
     return updateDb(req);
@@ -84,10 +84,10 @@ public class MessagingService extends Service {
   }
 
   String sendMessage(MessageToSend m) {
-    if (m.equals(MessageToSend.PaymentSuccessful)) {
+    if (m.equals(MessageToSend.PAYMENT_SUCCESSFUL)) {
       return "Msg: Your order has been placed and paid for successfully!"
           + " Thank you for shopping with us!";
-    } else if (m.equals(MessageToSend.PaymentTrying)) {
+    } else if (m.equals(MessageToSend.PAYMENT_TRYING)) {
       return "Msg: There was an error in your payment process,"
           + " we are working on it and will return back to you shortly."
           + " Meanwhile, your order has been placed and will be shipped.";
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
index a27dd62b8..341eb628c 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
@@ -36,7 +36,7 @@ public class QueueTask {
    */
 
   public enum TaskType {
-    Messaging, Payment, EmployeeDb
+    MESSAGING, PAYMENT, EMPLOYEE_DB
   }
 
   public Order order;
@@ -68,7 +68,7 @@ public class QueueTask {
    * @return String representing type of task
    */
   public String getType() {
-    if (!this.taskType.equals(TaskType.Messaging)) {
+    if (!this.taskType.equals(TaskType.MESSAGING)) {
       return this.taskType.toString();
     } else {
       if (this.messageType == 0) {
diff --git a/composite/src/test/java/com/iluwatar/composite/AppTest.java b/composite/src/test/java/com/iluwatar/composite/AppTest.java
index 5eb8c35c7..c82056a51 100644
--- a/composite/src/test/java/com/iluwatar/composite/AppTest.java
+++ b/composite/src/test/java/com/iluwatar/composite/AppTest.java
@@ -23,15 +23,23 @@
 
 package com.iluwatar.composite;
 
+import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    Assertions.assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/converter/src/test/java/com/iluwatar/converter/AppTest.java b/converter/src/test/java/com/iluwatar/converter/AppTest.java
index ed53c6863..7a99fe6ae 100644
--- a/converter/src/test/java/com/iluwatar/converter/AppTest.java
+++ b/converter/src/test/java/com/iluwatar/converter/AppTest.java
@@ -25,14 +25,24 @@ package com.iluwatar.converter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * App running test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void testMain() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/dao/src/test/java/com/iluwatar/dao/AppTest.java b/dao/src/test/java/com/iluwatar/dao/AppTest.java
index edfcf7cd0..e6d41fc8a 100644
--- a/dao/src/test/java/com/iluwatar/dao/AppTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/AppTest.java
@@ -25,12 +25,22 @@ package com.iluwatar.dao;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that DAO example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteDaoWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
index 5b1be9e35..40acb2f71 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
@@ -43,6 +43,6 @@ public class AiComponent implements Component {
 
   @Override
   public void render() {
-
+    // Do Nothing.
   }
 }
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
index 616ebf801..1baf99a3a 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
@@ -40,7 +40,7 @@ public class AiComponentManager {
 
   private final int numEntities;
 
-  private static final Component[] AI_COMPONENTS = new AiComponent[MAX_ENTITIES];
+  private final Component[] AI_COMPONENTS = new AiComponent[MAX_ENTITIES];
 
   public AiComponentManager(int numEntities) {
     this.numEntities = numEntities;
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
index 61ba4ebdd..e5917979c 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
@@ -40,7 +40,7 @@ public class PhysicsComponentManager {
 
   private final int numEntities;
 
-  private static final Component[] PHYSICS_COMPONENTS = new PhysicsComponent[MAX_ENTITIES];
+  private final Component[] PHYSICS_COMPONENTS = new PhysicsComponent[MAX_ENTITIES];
 
   public PhysicsComponentManager(int numEntities) {
     this.numEntities = numEntities;
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
index f8c4b3522..b3522f908 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
@@ -40,7 +40,7 @@ public class RenderComponentManager {
 
   private final int numEntities;
 
-  private static final Component[] RENDER_COMPONENTS = new RenderComponent[MAX_ENTITIES];
+  private final Component[] RENDER_COMPONENTS = new RenderComponent[MAX_ENTITIES];
 
   public RenderComponentManager(int numEntities) {
     this.numEntities = numEntities;
diff --git a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
index 3371be4c1..b7d1f8961 100644
--- a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
+++ b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
@@ -26,16 +26,22 @@ package com.iluwatar.data.locality;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Test Game Application
  */
 class ApplicationTest {
 
   /**
-   * Test run
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link Application#main(String[])}
+   * throws an exception.
    */
+
   @Test
-  void main() {
-    Application.main(new String[] {});
+  void shouldExecuteGameApplicationWithoutException() {
+    assertDoesNotThrow(() -> Application.main(new String[] {}));
   }
 }
\ No newline at end of file
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
index ec1d71be4..ab74edd6c 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
@@ -24,14 +24,25 @@
 package com.iluwatar.datamapper;
 
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.function.Executable;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 /**
  * Tests that Data-Mapper example runs without errors.
  */
-public final class AppTest {
+final class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main();
+  void shouldExecuteApplicationWithoutException() {
+
+    assertDoesNotThrow((Executable) App::main);
   }
 }
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
index 3a58d0c54..68a8b9444 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
@@ -25,9 +25,19 @@ package com.iluwatar.datatransfer;
 
 import org.junit.jupiter.api.Test;
 
-public class AppTest {
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+class AppTest {
+
+    /**
+     * Issue: Add at least one assertion to this test case.
+     *
+     * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+     * throws an exception.
+     */
+
     @Test
-    public void test() throws Exception {
-        App.main(new String[]{});
+    void shouldExecuteApplicationWithoutException() {
+        assertDoesNotThrow(() -> App.main(new String[]{}));
     }
 }
diff --git a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
index e8d4c8505..792d61233 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.decorator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java b/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
index 2865c76c1..8e20c9032 100644
--- a/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
+++ b/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
@@ -25,14 +25,23 @@ package com.iluwatar.delegation.simple;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test Entry
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
index 51115496d..52508814a 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.dependency.injection;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/dirty-flag/src/test/java/org/dirty/flag/AppTest.java b/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
index 1b604898b..82c7fea9b 100644
--- a/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
+++ b/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
@@ -26,12 +26,22 @@ package org.dirty.flag;
 import com.iluwatar.dirtyflag.App;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Dirty-Flag example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/double-buffer/pom.xml b/double-buffer/pom.xml
index 084cbc8c9..cb66af1cb 100644
--- a/double-buffer/pom.xml
+++ b/double-buffer/pom.xml
@@ -44,6 +44,11 @@
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
index eb89a4044..6612d2b00 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
@@ -25,14 +25,23 @@ package com.iluwatar.doublebuffer;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * App unit test.
  */
 public class AppTest {
 
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void testMain() {
-    App.main(new String[]{});
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
index 6eac88fcd..e24e51094 100644
--- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
+++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
@@ -25,13 +25,23 @@ package com.iluwatar.doublechecked.locking;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
index 67ca00c56..e5df7a2be 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
@@ -25,13 +25,23 @@ package com.iluwatar.doubledispatch;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
index ed604e8c2..3da3b3e66 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.eip.aggregator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Test for App class
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void testMain() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java b/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
index 9f11c0209..14cdc5c65 100644
--- a/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
+++ b/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.eip.message.channel;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java b/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
index 107e954ed..f910d0abe 100644
--- a/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
+++ b/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.eip.publish.subscribe;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
index 1a7dfcb0a..d5936282e 100644
--- a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
+++ b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.eip.splitter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Test for App class
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void testMain() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
index 31154043c..8be8bcbe7 100644
--- a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
+++ b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.eip.wiretap;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Test for App class
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void testMain() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
index a65424023..e56bc9d7f 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
@@ -25,13 +25,22 @@ package com.iluwatar.event.aggregator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
index 76554d6b1..638e77f87 100644
--- a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
+++ b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
@@ -25,12 +25,22 @@ package com.iluwatar.event.asynchronous;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that EventAsynchronous example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
index 0f1720363..eb944a22c 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
@@ -25,12 +25,22 @@ package com.iluwatar.eda;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Event Driven Architecture example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
index 5512ba8d2..6516ede4a 100644
--- a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
+++ b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
@@ -29,19 +29,21 @@ import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests execute-around example.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() throws IOException {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
   @BeforeEach
   @AfterEach
-  public void cleanup() {
+  void cleanup() {
     var file = new File("testfile.txt");
     file.delete();
   }
diff --git a/extension-objects/src/main/java/concreteextensions/Commander.java b/extension-objects/src/main/java/concreteextensions/Commander.java
index 1d8054562..ffd46dd25 100644
--- a/extension-objects/src/main/java/concreteextensions/Commander.java
+++ b/extension-objects/src/main/java/concreteextensions/Commander.java
@@ -45,4 +45,8 @@ public class Commander implements CommanderExtension {
   public void commanderReady() {
     LOGGER.info("[Commander] " + unit.getName() + " is ready!");
   }
+
+  public CommanderUnit getUnit() {
+    return unit;
+  }
 }
diff --git a/extension-objects/src/main/java/concreteextensions/Sergeant.java b/extension-objects/src/main/java/concreteextensions/Sergeant.java
index 4f5a474b3..aea2ddaca 100644
--- a/extension-objects/src/main/java/concreteextensions/Sergeant.java
+++ b/extension-objects/src/main/java/concreteextensions/Sergeant.java
@@ -43,6 +43,10 @@ public class Sergeant implements SergeantExtension {
 
   @Override
   public void sergeantReady() {
-    LOGGER.info("[Sergeant] " + unit.getName() + " is ready! ");
+    LOGGER.info("[Sergeant] " + unit.getName() + " is ready!");
+  }
+
+  public SergeantUnit getUnit() {
+    return unit;
   }
 }
diff --git a/extension-objects/src/main/java/concreteextensions/Soldier.java b/extension-objects/src/main/java/concreteextensions/Soldier.java
index d500ab604..76ddbfd06 100644
--- a/extension-objects/src/main/java/concreteextensions/Soldier.java
+++ b/extension-objects/src/main/java/concreteextensions/Soldier.java
@@ -44,4 +44,8 @@ public class Soldier implements SoldierExtension {
   public void soldierReady() {
     LOGGER.info("[Solider] " + unit.getName() + "  is ready!");
   }
+
+  public SoldierUnit getUnit() {
+    return unit;
+  }
 }
diff --git a/extension-objects/src/test/java/AppTest.java b/extension-objects/src/test/java/AppTest.java
index 2af33e506..321bf758f 100644
--- a/extension-objects/src/test/java/AppTest.java
+++ b/extension-objects/src/test/java/AppTest.java
@@ -23,13 +23,16 @@
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void main() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/concreteextensions/CommanderTest.java b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
index 60ff614e4..0c9d00baf 100644
--- a/extension-objects/src/test/java/concreteextensions/CommanderTest.java
+++ b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
@@ -23,17 +23,43 @@
 
 package concreteextensions;
 
+import ch.qos.logback.classic.Level;
+import ch.qos.logback.classic.Logger;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.read.ListAppender;
 import org.junit.jupiter.api.Test;
+import org.slf4j.LoggerFactory;
 import units.CommanderUnit;
 
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Created by Srdjan on 03-May-17.
+ *
+ * Modified by ToxicDreamz on 15-Aug-20
  */
-public class CommanderTest {
+class CommanderTest {
+
   @Test
-  public void commanderReady() {
+  void shouldExecuteCommanderReady() {
+
+    Logger commanderLogger = (Logger) LoggerFactory.getLogger(Commander.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+
+    commanderLogger.addAppender(listAppender);
+
     final var commander = new Commander(new CommanderUnit("CommanderUnitTest"));
     commander.commanderReady();
+
+    List<ILoggingEvent> logsList = listAppender.list;
+    assertEquals("[Commander] " + commander.getUnit().getName() + " is ready!", logsList.get(0)
+            .getMessage());
+    assertEquals(Level.INFO, logsList.get(0)
+            .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/concreteextensions/SergeantTest.java b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
index a5a60d914..3970a5c80 100644
--- a/extension-objects/src/test/java/concreteextensions/SergeantTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
@@ -23,17 +23,41 @@
 
 package concreteextensions;
 
+import ch.qos.logback.classic.Level;
+import ch.qos.logback.classic.Logger;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.read.ListAppender;
 import org.junit.jupiter.api.Test;
+import org.slf4j.LoggerFactory;
 import units.SergeantUnit;
 
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class SergeantTest {
+class SergeantTest {
+
   @Test
-  public void sergeantReady() {
+  void sergeantReady() {
+
+    Logger sergeantLogger = (Logger) LoggerFactory.getLogger(Sergeant.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+
+    sergeantLogger.addAppender(listAppender);
+
     final var sergeant = new Sergeant(new SergeantUnit("SergeantUnitTest"));
     sergeant.sergeantReady();
+
+    List<ILoggingEvent> logsList = listAppender.list;
+    assertEquals("[Sergeant] " + sergeant.getUnit().getName() + " is ready!", logsList.get(0)
+            .getMessage());
+    assertEquals(Level.INFO, logsList.get(0)
+            .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/concreteextensions/SoldierTest.java b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
index 89c8c2d91..98224e848 100644
--- a/extension-objects/src/test/java/concreteextensions/SoldierTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
@@ -23,17 +23,41 @@
 
 package concreteextensions;
 
+import ch.qos.logback.classic.Level;
+import ch.qos.logback.classic.Logger;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.read.ListAppender;
 import org.junit.jupiter.api.Test;
+import org.slf4j.LoggerFactory;
 import units.SoldierUnit;
 
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class SoldierTest {
+class SoldierTest {
+
   @Test
-  public void soldierReady() {
+  void soldierReady() {
+
+    Logger soldierLogger = (Logger) LoggerFactory.getLogger(Soldier.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+
+    soldierLogger.addAppender(listAppender);
+
     final var soldier = new Soldier(new SoldierUnit("SoldierUnitTest"));
     soldier.soldierReady();
+
+    List<ILoggingEvent> logsList = listAppender.list;
+    assertEquals("[Soldier] " + soldier.getUnit().getName() + " is ready!", logsList.get(0)
+            .getMessage());
+    assertEquals(Level.INFO, logsList.get(0)
+            .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/facade/src/test/java/com/iluwatar/facade/AppTest.java b/facade/src/test/java/com/iluwatar/facade/AppTest.java
index b6287b02b..7e2d389dc 100644
--- a/facade/src/test/java/com/iluwatar/facade/AppTest.java
+++ b/facade/src/test/java/com/iluwatar/facade/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.facade;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java b/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
index f1d3c65a2..99477aaf0 100644
--- a/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
+++ b/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
@@ -26,14 +26,16 @@ package com.iluwatar.factorykit.app;
 import com.iluwatar.factorykit.App;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test Entrypoint
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
 
diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
index c23295d9a..8756ba0aa 100644
--- a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
+++ b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.factory.method;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Factory Method example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
index 6f25d8416..1b6671917 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.fluentinterface.app;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test Entry
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
index 27d374f5d..c43d87680 100644
--- a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
+++ b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
@@ -57,15 +57,10 @@ public final class Dispatcher {
    */
   public void menuItemSelected(MenuItem menuItem) {
     dispatchAction(new MenuAction(menuItem));
-    switch (menuItem) {
-      case HOME:
-      case PRODUCTS:
-      default:
-        dispatchAction(new ContentAction(Content.PRODUCTS));
-        break;
-      case COMPANY:
-        dispatchAction(new ContentAction(Content.COMPANY));
-        break;
+    if (menuItem == MenuItem.COMPANY) {
+      dispatchAction(new ContentAction(Content.COMPANY));
+    } else {
+      dispatchAction(new ContentAction(Content.PRODUCTS));
     }
   }
 
diff --git a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
index 8916ad4de..649708d8f 100644
--- a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.flux.app;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
index 3d81a6db2..5f957c794 100644
--- a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
+++ b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.flyweight;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
index 2ea58c6a6..cf33bfb48 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.front.controller;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/game-loop/pom.xml b/game-loop/pom.xml
index 2c2908271..706d3cff4 100644
--- a/game-loop/pom.xml
+++ b/game-loop/pom.xml
@@ -39,6 +39,12 @@
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
         </dependency>
+
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
index 447e4f411..0c027028d 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.gameloop;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * App unit test class.
  */
 public class AppTest {
 
   @Test
-  public void testMain() {
-    new App().main(new String[]{});
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
index b3cf4839b..395599927 100644
--- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
+++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.halfsynchalfasync;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(null);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(null));
   }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
index 96ab74ba3..6d6c33239 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
@@ -46,6 +46,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
   private static final String DEFAULT_DB = "lotteryDB";
   private static final String DEFAULT_TICKETS_COLLECTION = "lotteryTickets";
   private static final String DEFAULT_COUNTERS_COLLECTION = "counters";
+  private static final String TICKET_ID = "ticketId";
 
   private MongoClient mongoClient;
   private MongoDatabase database;
@@ -93,7 +94,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
   }
 
   private void initCounters() {
-    var doc = new Document("_id", "ticketId").append("seq", 1);
+    var doc = new Document("_id", TICKET_ID).append("seq", 1);
     countersCollection.insertOne(doc);
   }
 
@@ -103,7 +104,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
    * @return next ticket id
    */
   public int getNextId() {
-    var find = new Document("_id", "ticketId");
+    var find = new Document("_id", TICKET_ID);
     var increase = new Document("seq", 1);
     var update = new Document("$inc", increase);
     var result = countersCollection.findOneAndUpdate(find, update);
@@ -131,7 +132,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
   @Override
   public Optional<LotteryTicket> findById(LotteryTicketId id) {
     return ticketsCollection
-        .find(new Document("ticketId", id.getId()))
+        .find(new Document(TICKET_ID, id.getId()))
         .limit(1)
         .into(new ArrayList<>())
         .stream()
@@ -142,7 +143,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
   @Override
   public Optional<LotteryTicketId> save(LotteryTicket ticket) {
     var ticketId = getNextId();
-    var doc = new Document("ticketId", ticketId);
+    var doc = new Document(TICKET_ID, ticketId);
     doc.put("email", ticket.getPlayerDetails().getEmail());
     doc.put("bank", ticket.getPlayerDetails().getBankAccount());
     doc.put("phone", ticket.getPlayerDetails().getPhoneNumber());
@@ -173,7 +174,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
         .map(Integer::parseInt)
         .collect(Collectors.toSet());
     var lotteryNumbers = LotteryNumbers.create(numbers);
-    var ticketId = new LotteryTicketId(doc.getInteger("ticketId"));
+    var ticketId = new LotteryTicketId(doc.getInteger(TICKET_ID));
     return new LotteryTicket(ticketId, playerDetails, lotteryNumbers);
   }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
index c632debe8..62fcf32b4 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
@@ -36,6 +36,9 @@ public class MongoEventLog implements LotteryEventLog {
 
   private static final String DEFAULT_DB = "lotteryDB";
   private static final String DEFAULT_EVENTS_COLLECTION = "events";
+  private static final String EMAIL = "email";
+  private static final String PHONE = "phone";
+  public static final String MESSAGE = "message";
 
   private MongoClient mongoClient;
   private MongoDatabase database;
@@ -107,41 +110,41 @@ public class MongoEventLog implements LotteryEventLog {
 
   @Override
   public void ticketSubmitted(PlayerDetails details) {
-    var document = new Document("email", details.getEmail());
-    document.put("phone", details.getPhoneNumber());
+    var document = new Document(EMAIL, details.getEmail());
+    document.put(PHONE, details.getPhoneNumber());
     document.put("bank", details.getBankAccount());
     document
-        .put("message", "Lottery ticket was submitted and bank account was charged for 3 credits.");
+        .put(MESSAGE, "Lottery ticket was submitted and bank account was charged for 3 credits.");
     eventsCollection.insertOne(document);
     stdOutEventLog.ticketSubmitted(details);
   }
 
   @Override
   public void ticketSubmitError(PlayerDetails details) {
-    var document = new Document("email", details.getEmail());
-    document.put("phone", details.getPhoneNumber());
+    var document = new Document(EMAIL, details.getEmail());
+    document.put(PHONE, details.getPhoneNumber());
     document.put("bank", details.getBankAccount());
-    document.put("message", "Lottery ticket could not be submitted because lack of funds.");
+    document.put(MESSAGE, "Lottery ticket could not be submitted because lack of funds.");
     eventsCollection.insertOne(document);
     stdOutEventLog.ticketSubmitError(details);
   }
 
   @Override
   public void ticketDidNotWin(PlayerDetails details) {
-    var document = new Document("email", details.getEmail());
-    document.put("phone", details.getPhoneNumber());
+    var document = new Document(EMAIL, details.getEmail());
+    document.put(PHONE, details.getPhoneNumber());
     document.put("bank", details.getBankAccount());
-    document.put("message", "Lottery ticket was checked and unfortunately did not win this time.");
+    document.put(MESSAGE, "Lottery ticket was checked and unfortunately did not win this time.");
     eventsCollection.insertOne(document);
     stdOutEventLog.ticketDidNotWin(details);
   }
 
   @Override
   public void ticketWon(PlayerDetails details, int prizeAmount) {
-    var document = new Document("email", details.getEmail());
-    document.put("phone", details.getPhoneNumber());
+    var document = new Document(EMAIL, details.getEmail());
+    document.put(PHONE, details.getPhoneNumber());
     document.put("bank", details.getBankAccount());
-    document.put("message", String
+    document.put(MESSAGE, String
         .format("Lottery ticket won! The bank account was deposited with %d credits.",
             prizeAmount));
     eventsCollection.insertOne(document);
@@ -150,10 +153,10 @@ public class MongoEventLog implements LotteryEventLog {
 
   @Override
   public void prizeError(PlayerDetails details, int prizeAmount) {
-    var document = new Document("email", details.getEmail());
-    document.put("phone", details.getPhoneNumber());
+    var document = new Document(EMAIL, details.getEmail());
+    document.put(PHONE, details.getPhoneNumber());
     document.put("bank", details.getBankAccount());
-    document.put("message", String
+    document.put(MESSAGE, String
         .format("Lottery ticket won! Unfortunately the bank credit transfer of %d failed.",
             prizeAmount));
     eventsCollection.insertOne(document);
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
index 05d51a283..d2ad89c9b 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
@@ -25,13 +25,16 @@ package com.iluwatar.hexagonal;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Unit test for simple App.
  */
 class AppTest {
 
   @Test
-  void testApp() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+
   }
 }
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
index 8fbe9f1d2..d8f22a478 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.intercepting.filter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
index 505dc559c..f4fb45637 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.interpreter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
index ccb33307c..2e0d28b67 100644
--- a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
+++ b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.iterator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test
  */
 class AppTest {
 
   @Test
-  void testApp() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 } 
\ No newline at end of file
diff --git a/layers/src/main/java/com/iluwatar/layers/app/App.java b/layers/src/main/java/com/iluwatar/layers/app/App.java
index e5a4f9995..8574b8d02 100644
--- a/layers/src/main/java/com/iluwatar/layers/app/App.java
+++ b/layers/src/main/java/com/iluwatar/layers/app/App.java
@@ -81,6 +81,7 @@ import java.util.List;
 public class App {
 
   private static final CakeBakingService cakeBakingService = new CakeBakingServiceImpl();
+  public static final String STRAWBERRY = "strawberry";
 
   /**
    * Application entry point.
@@ -103,10 +104,10 @@ public class App {
   private static void initializeData(CakeBakingService cakeBakingService) {
     cakeBakingService.saveNewLayer(new CakeLayerInfo("chocolate", 1200));
     cakeBakingService.saveNewLayer(new CakeLayerInfo("banana", 900));
-    cakeBakingService.saveNewLayer(new CakeLayerInfo("strawberry", 950));
+    cakeBakingService.saveNewLayer(new CakeLayerInfo(STRAWBERRY, 950));
     cakeBakingService.saveNewLayer(new CakeLayerInfo("lemon", 950));
     cakeBakingService.saveNewLayer(new CakeLayerInfo("vanilla", 950));
-    cakeBakingService.saveNewLayer(new CakeLayerInfo("strawberry", 950));
+    cakeBakingService.saveNewLayer(new CakeLayerInfo(STRAWBERRY, 950));
 
     cakeBakingService.saveNewTopping(new CakeToppingInfo("candies", 350));
     cakeBakingService.saveNewTopping(new CakeToppingInfo("cherry", 350));
@@ -114,7 +115,7 @@ public class App {
     var cake1 = new CakeInfo(new CakeToppingInfo("candies", 0), List.of(
         new CakeLayerInfo("chocolate", 0),
         new CakeLayerInfo("banana", 0),
-        new CakeLayerInfo("strawberry", 0)));
+        new CakeLayerInfo(STRAWBERRY, 0)));
     try {
       cakeBakingService.bakeNewCake(cake1);
     } catch (CakeBakingException e) {
@@ -123,7 +124,7 @@ public class App {
     var cake2 = new CakeInfo(new CakeToppingInfo("cherry", 0), List.of(
         new CakeLayerInfo("vanilla", 0),
         new CakeLayerInfo("lemon", 0),
-        new CakeLayerInfo("strawberry", 0)));
+        new CakeLayerInfo(STRAWBERRY, 0)));
     try {
       cakeBakingService.bakeNewCake(cake2);
     } catch (CakeBakingException e) {
diff --git a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
index 10d224a8e..105487683 100644
--- a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.layers.app;
 
-import com.iluwatar.layers.app.App;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * 
  * Application test
  *
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    App.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
index eeccd10ce..74c324b24 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
@@ -25,16 +25,17 @@ package com.iluwatar.lazy.loading;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * 
  * Application test
  *
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    App.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
index f30610597..94db89ef7 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
@@ -36,6 +36,7 @@ public abstract class AbstractInstance implements Instance, Runnable {
   private static final Logger LOGGER = LoggerFactory.getLogger(AbstractInstance.class);
 
   protected static final int HEARTBEAT_INTERVAL = 5000;
+  private static final String INSTANCE = "Instance ";
 
   protected MessageManager messageManager;
   protected Queue<Message> messageQueue;
@@ -106,27 +107,27 @@ public abstract class AbstractInstance implements Instance, Runnable {
   private void processMessage(Message message) {
     switch (message.getType()) {
       case ELECTION:
-        LOGGER.info("Instance " + localId + " - Election Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Election Message handling...");
         handleElectionMessage(message);
         break;
       case LEADER:
-        LOGGER.info("Instance " + localId + " - Leader Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Leader Message handling...");
         handleLeaderMessage(message);
         break;
       case HEARTBEAT:
-        LOGGER.info("Instance " + localId + " - Heartbeat Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Heartbeat Message handling...");
         handleHeartbeatMessage(message);
         break;
       case ELECTION_INVOKE:
-        LOGGER.info("Instance " + localId + " - Election Invoke Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Election Invoke Message handling...");
         handleElectionInvokeMessage();
         break;
       case LEADER_INVOKE:
-        LOGGER.info("Instance " + localId + " - Leader Invoke Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Leader Invoke Message handling...");
         handleLeaderInvokeMessage();
         break;
       case HEARTBEAT_INVOKE:
-        LOGGER.info("Instance " + localId + " - Heartbeat Invoke Message handling...");
+        LOGGER.info(INSTANCE + localId + " - Heartbeat Invoke Message handling...");
         handleHeartbeatInvokeMessage();
         break;
       default:
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
index 92cb18ab4..3181791d4 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
@@ -41,6 +41,7 @@ import org.slf4j.LoggerFactory;
 public class BullyInstance extends AbstractInstance {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(BullyInstance.class);
+  private static final String INSTANCE = "Instance ";
 
   /**
    * Constructor of BullyInstance.
@@ -59,20 +60,20 @@ public class BullyInstance extends AbstractInstance {
     try {
       boolean isLeaderAlive = messageManager.sendHeartbeatMessage(leaderId);
       if (isLeaderAlive) {
-        LOGGER.info("Instance " + localId + "- Leader is alive.");
+        LOGGER.info(INSTANCE + localId + "- Leader is alive.");
         Thread.sleep(HEARTBEAT_INTERVAL);
         messageManager.sendHeartbeatInvokeMessage(localId);
       } else {
-        LOGGER.info("Instance " + localId + "- Leader is not alive. Start election.");
+        LOGGER.info(INSTANCE + localId + "- Leader is not alive. Start election.");
         boolean electionResult =
             messageManager.sendElectionMessage(localId, String.valueOf(localId));
         if (electionResult) {
-          LOGGER.info("Instance " + localId + "- Succeed in election. Start leader notification.");
+          LOGGER.info(INSTANCE + localId + "- Succeed in election. Start leader notification.");
           messageManager.sendLeaderMessage(localId, localId);
         }
       }
     } catch (InterruptedException e) {
-      LOGGER.info("Instance " + localId + "- Interrupted.");
+      LOGGER.info(INSTANCE + localId + "- Interrupted.");
     }
   }
 
@@ -84,10 +85,10 @@ public class BullyInstance extends AbstractInstance {
   @Override
   protected void handleElectionInvokeMessage() {
     if (!isLeader()) {
-      LOGGER.info("Instance " + localId + "- Start election.");
+      LOGGER.info(INSTANCE + localId + "- Start election.");
       boolean electionResult = messageManager.sendElectionMessage(localId, String.valueOf(localId));
       if (electionResult) {
-        LOGGER.info("Instance " + localId + "- Succeed in election. Start leader notification.");
+        LOGGER.info(INSTANCE + localId + "- Succeed in election. Start leader notification.");
         leaderId = localId;
         messageManager.sendLeaderMessage(localId, localId);
         messageManager.sendHeartbeatInvokeMessage(localId);
@@ -101,25 +102,25 @@ public class BullyInstance extends AbstractInstance {
   @Override
   protected void handleLeaderMessage(Message message) {
     leaderId = Integer.valueOf(message.getContent());
-    LOGGER.info("Instance " + localId + " - Leader update done.");
+    LOGGER.info(INSTANCE + localId + " - Leader update done.");
   }
 
   private boolean isLeader() {
     return localId == leaderId;
   }
 
-  /**
-   * Not used in Bully instance.
-   */
   @Override
   protected void handleLeaderInvokeMessage() {
+    // Not used in Bully Instance
   }
 
   @Override
   protected void handleHeartbeatMessage(Message message) {
+    // Not used in Bully Instance
   }
 
   @Override
   protected void handleElectionMessage(Message message) {
+    // Not used in Bully Instance
   }
 }
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
index d4a3075d8..2d2d0ae1a 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
@@ -46,6 +46,7 @@ import org.slf4j.LoggerFactory;
 public class RingInstance extends AbstractInstance {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(RingInstance.class);
+  private static final String INSTANCE = "Instance ";
 
   /**
    * Constructor of RingInstance.
@@ -64,15 +65,15 @@ public class RingInstance extends AbstractInstance {
     try {
       var isLeaderAlive = messageManager.sendHeartbeatMessage(this.leaderId);
       if (isLeaderAlive) {
-        LOGGER.info("Instance " + localId + "- Leader is alive. Start next heartbeat in 5 second.");
+        LOGGER.info(INSTANCE + localId + "- Leader is alive. Start next heartbeat in 5 second.");
         Thread.sleep(HEARTBEAT_INTERVAL);
         messageManager.sendHeartbeatInvokeMessage(this.localId);
       } else {
-        LOGGER.info("Instance " + localId + "- Leader is not alive. Start election.");
+        LOGGER.info(INSTANCE + localId + "- Leader is not alive. Start election.");
         messageManager.sendElectionMessage(this.localId, String.valueOf(this.localId));
       }
     } catch (InterruptedException e) {
-      LOGGER.info("Instance " + localId + "- Interrupted.");
+      LOGGER.info(INSTANCE + localId + "- Interrupted.");
     }
   }
 
@@ -85,14 +86,14 @@ public class RingInstance extends AbstractInstance {
   @Override
   protected void handleElectionMessage(Message message) {
     var content = message.getContent();
-    LOGGER.info("Instance " + localId + " - Election Message: " + content);
+    LOGGER.info(INSTANCE + localId + " - Election Message: " + content);
     var candidateList = Arrays.stream(content.trim().split(","))
         .map(Integer::valueOf)
         .sorted()
         .collect(Collectors.toList());
     if (candidateList.contains(localId)) {
       var newLeaderId = candidateList.get(0);
-      LOGGER.info("Instance " + localId + " - New leader should be " + newLeaderId + ".");
+      LOGGER.info(INSTANCE + localId + " - New leader should be " + newLeaderId + ".");
       messageManager.sendLeaderMessage(localId, newLeaderId);
     } else {
       content += "," + localId;
@@ -108,11 +109,11 @@ public class RingInstance extends AbstractInstance {
   protected void handleLeaderMessage(Message message) {
     var newLeaderId = Integer.valueOf(message.getContent());
     if (this.leaderId != newLeaderId) {
-      LOGGER.info("Instance " + localId + " - Update leaderID");
+      LOGGER.info(INSTANCE + localId + " - Update leaderID");
       this.leaderId = newLeaderId;
       messageManager.sendLeaderMessage(localId, newLeaderId);
     } else {
-      LOGGER.info("Instance " + localId + " - Leader update done. Start heartbeat.");
+      LOGGER.info(INSTANCE + localId + " - Leader update done. Start heartbeat.");
       messageManager.sendHeartbeatInvokeMessage(localId);
     }
   }
@@ -122,14 +123,17 @@ public class RingInstance extends AbstractInstance {
    */
   @Override
   protected void handleLeaderInvokeMessage() {
+    // Not used in Ring instance.
   }
 
   @Override
   protected void handleHeartbeatMessage(Message message) {
+    // Not used in Ring instance.
   }
 
   @Override
   protected void handleElectionInvokeMessage() {
+    // Not used in Ring instance.
   }
 
 }
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
index 3ef36f758..19497a32c 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
@@ -25,15 +25,16 @@ package com.iluwatar.leaderelection.bully;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * BullyApp unit test.
  */
-public class BullyAppTest {
+class BullyAppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    BullyApp.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> BullyApp.main(new String[]{}));
   }
 
 }
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
index ec3851d9b..ce5c59aa7 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
@@ -25,15 +25,16 @@ package com.iluwatar.leaderelection.ring;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * RingApp unit test.
  */
-public class RingAppTest {
+class RingAppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    RingApp.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> RingApp.main(new String[]{}));
   }
 
 }
diff --git a/leader-followers/pom.xml b/leader-followers/pom.xml
index 4efdbf3ac..c0f27d051 100644
--- a/leader-followers/pom.xml
+++ b/leader-followers/pom.xml
@@ -37,6 +37,11 @@
             <artifactId>junit</artifactId>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-core</artifactId>
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/App.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/App.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/Task.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/Task.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/TaskHandler.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/TaskHandler.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/TaskSet.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/TaskSet.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/WorkCenter.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/WorkCenter.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java
diff --git a/leader-followers/src/main/java/com.iluwatar.leaderfollowers/Worker.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
similarity index 100%
rename from leader-followers/src/main/java/com.iluwatar.leaderfollowers/Worker.java
rename to leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
diff --git a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/AppTest.java b/leader-followers/src/test/java/com/AppTest.java
similarity index 83%
rename from leader-followers/src/test/java/com.iluwatar.leaderfollowers/AppTest.java
rename to leader-followers/src/test/java/com/AppTest.java
index 00fbfe4d2..3d0588fef 100644
--- a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/AppTest.java
+++ b/leader-followers/src/test/java/com/AppTest.java
@@ -21,10 +21,13 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.leaderfollowers;
+package com;
 
+import com.iluwatar.leaderfollowers.App;
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  *
  * Application test
@@ -33,9 +36,8 @@ import org.junit.Test;
 public class AppTest {
 
     @Test
-    public void test() throws InterruptedException {
-        String[] args = {};
-        App.main(args);
+    public void shouldExecuteApplicationWithoutException() {
+        assertDoesNotThrow(() -> App.main(new String[]{}));
     }
 
 }
diff --git a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskHandlerTest.java b/leader-followers/src/test/java/com/TaskHandlerTest.java
similarity index 93%
rename from leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskHandlerTest.java
rename to leader-followers/src/test/java/com/TaskHandlerTest.java
index 9fb39c922..7dc44c04f 100644
--- a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskHandlerTest.java
+++ b/leader-followers/src/test/java/com/TaskHandlerTest.java
@@ -21,8 +21,10 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.leaderfollowers;
+package com;
 
+import com.iluwatar.leaderfollowers.Task;
+import com.iluwatar.leaderfollowers.TaskHandler;
 import org.junit.Assert;
 import org.junit.Test;
 
diff --git a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskSetTest.java b/leader-followers/src/test/java/com/TaskSetTest.java
similarity index 94%
rename from leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskSetTest.java
rename to leader-followers/src/test/java/com/TaskSetTest.java
index 53cb31deb..e3691d220 100644
--- a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/TaskSetTest.java
+++ b/leader-followers/src/test/java/com/TaskSetTest.java
@@ -21,8 +21,10 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.leaderfollowers;
+package com;
 
+import com.iluwatar.leaderfollowers.Task;
+import com.iluwatar.leaderfollowers.TaskSet;
 import org.junit.Assert;
 import org.junit.Test;
 
diff --git a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/WorkCenterTest.java b/leader-followers/src/test/java/com/WorkCenterTest.java
similarity index 93%
rename from leader-followers/src/test/java/com.iluwatar.leaderfollowers/WorkCenterTest.java
rename to leader-followers/src/test/java/com/WorkCenterTest.java
index 045d8c3dc..41e9ff43f 100644
--- a/leader-followers/src/test/java/com.iluwatar.leaderfollowers/WorkCenterTest.java
+++ b/leader-followers/src/test/java/com/WorkCenterTest.java
@@ -21,8 +21,11 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.leaderfollowers;
+package com;
 
+import com.iluwatar.leaderfollowers.TaskHandler;
+import com.iluwatar.leaderfollowers.TaskSet;
+import com.iluwatar.leaderfollowers.WorkCenter;
 import org.junit.Assert;
 import org.junit.Test;
 
diff --git a/marker/src/test/java/AppTest.java b/marker/src/test/java/AppTest.java
index 13295a9e5..17a13c167 100644
--- a/marker/src/test/java/AppTest.java
+++ b/marker/src/test/java/AppTest.java
@@ -23,13 +23,15 @@
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
index 23f2a72f2..558ec4907 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.mediator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/memento/src/test/java/com/iluwatar/memento/AppTest.java b/memento/src/test/java/com/iluwatar/memento/AppTest.java
index e0448c289..2d8a518e2 100644
--- a/memento/src/test/java/com/iluwatar/memento/AppTest.java
+++ b/memento/src/test/java/com/iluwatar/memento/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.memento;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
index 69dc19f1c..a0fdbf3ba 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.model.view.controller;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
index 1d59b5d8c..1dd1bf818 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
@@ -35,6 +35,10 @@ import javax.swing.JScrollPane;
 import javax.swing.JTextArea;
 import javax.swing.JTextField;
 
+import static javax.swing.ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED;
+import static javax.swing.ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED;
+import static javax.swing.WindowConstants.EXIT_ON_CLOSE;
+
 /**
  * This class is the GUI implementation of the View component in the Model-View-Presenter pattern.
  */
@@ -80,7 +84,7 @@ public class FileSelectorJFrame extends JFrame implements FileSelectorView, Acti
    */
   public FileSelectorJFrame() {
     super("File Loader");
-    this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
+    this.setDefaultCloseOperation(EXIT_ON_CLOSE);
     this.setLayout(null);
     this.setBounds(100, 100, 500, 200);
 
@@ -119,8 +123,8 @@ public class FileSelectorJFrame extends JFrame implements FileSelectorView, Acti
      */
     this.area = new JTextArea(100, 100);
     var pane = new JScrollPane(area);
-    pane.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED);
-    pane.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
+    pane.setHorizontalScrollBarPolicy(HORIZONTAL_SCROLLBAR_AS_NEEDED);
+    pane.setVerticalScrollBarPolicy(VERTICAL_SCROLLBAR_AS_NEEDED);
     panel.add(pane);
     this.area.setEditable(false);
     pane.setBounds(150, 100, 250, 80);
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
index 4db990a2d..6529cd18d 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.model.view.presenter;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/module/src/test/java/com/iluwatar/module/AppTest.java b/module/src/test/java/com/iluwatar/module/AppTest.java
index 8dcfd565e..4bf72fcb0 100644
--- a/module/src/test/java/com/iluwatar/module/AppTest.java
+++ b/module/src/test/java/com/iluwatar/module/AppTest.java
@@ -25,14 +25,17 @@ package com.iluwatar.module;
 
 import java.io.FileNotFoundException;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.function.Executable;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 /**
  * Tests that Module example runs without errors.
  */
-public final class AppTest {
+final class AppTest {
 
   @Test
-  public void test() throws FileNotFoundException {
-    App.main();
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow((Executable) App::main);
   }
 }
diff --git a/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java b/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
index 5883812c7..c5ce35582 100644
--- a/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
+++ b/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.mute;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Mute idiom example runs without errors.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java b/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
index 33d104ffc..e92b26f9b 100644
--- a/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
+++ b/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
@@ -23,41 +23,40 @@
 
 package com.iluwatar.mute;
 
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
 import java.io.ByteArrayOutputStream;
 import java.io.PrintStream;
 import org.junit.jupiter.api.Test;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import static org.junit.jupiter.api.Assertions.*;
+
 /**
  * Test for the mute-idiom pattern
  */
-public class MuteTest {
+class MuteTest {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(MuteTest.class);
 
   private static final String MESSAGE = "should not occur";
 
   @Test
-  public void muteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() {
-    Mute.mute(this::methodNotThrowingAnyException);
+  void muteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() {
+    assertDoesNotThrow(() -> Mute.mute(this::methodNotThrowingAnyException));
   }
 
   @Test
-  public void muteShouldRethrowUnexpectedExceptionAsAssertionError() {
+  void muteShouldRethrowUnexpectedExceptionAsAssertionError() {
     assertThrows(AssertionError.class, () -> Mute.mute(this::methodThrowingException));
   }
 
   @Test
-  public void loggedMuteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() {
-    Mute.loggedMute(this::methodNotThrowingAnyException);
+  void loggedMuteShouldRunTheCheckedRunnableAndNotThrowAnyExceptionIfCheckedRunnableDoesNotThrowAnyException() {
+    assertDoesNotThrow(() -> Mute.mute(this::methodNotThrowingAnyException));
   }
 
   @Test
-  public void loggedMuteShouldLogExceptionTraceBeforeSwallowingIt() {
+  void loggedMuteShouldLogExceptionTraceBeforeSwallowingIt() {
     var stream = new ByteArrayOutputStream();
     System.setErr(new PrintStream(stream));
 
diff --git a/mutex/src/test/java/com/iluwatar/mutex/AppTest.java b/mutex/src/test/java/com/iluwatar/mutex/AppTest.java
index 0bee249a6..7866b22a8 100644
--- a/mutex/src/test/java/com/iluwatar/mutex/AppTest.java
+++ b/mutex/src/test/java/com/iluwatar/mutex/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.mutex;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test Entrypoint
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
index 754aadc80..27724a724 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.nullobject;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java b/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
index aeec371ff..5862d1e1a 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
@@ -35,20 +35,20 @@ import static org.junit.jupiter.api.Assertions.assertSame;
  *
  * @author Jeroen Meulemeester
  */
-public class NullNodeTest {
+class NullNodeTest {
 
   /**
    * Verify if {@link NullNode#getInstance()} actually returns the same object instance
    */
   @Test
-  public void testGetInstance() {
+  void testGetInstance() {
     final var instance = NullNode.getInstance();
     assertNotNull(instance);
     assertSame(instance, NullNode.getInstance());
   }
 
   @Test
-  public void testFields() {
+  void testFields() {
     final var node = NullNode.getInstance();
     assertEquals(0, node.getTreeSize());
     assertNull(node.getName());
@@ -56,9 +56,8 @@ public class NullNodeTest {
     assertNull(node.getRight());
   }
 
-  @Test
-  public void testWalk() {
-    NullNode.getInstance().walk();
-  }
+  /**
+   * Removed unnecessary test method for {@link NullNode#walk()} as the method doesn't have an implementation.
+   */
 
 }
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
index cbfc7dea5..48957ce24 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
@@ -57,12 +57,14 @@ public class App {
     var pool = new OliphauntPool();
     LOGGER.info(pool.toString());
     var oliphaunt1 = pool.checkOut();
-    LOGGER.info("Checked out {}", oliphaunt1);
+    String checkedOut = "Checked out {}";
+
+    LOGGER.info(checkedOut, oliphaunt1);
     LOGGER.info(pool.toString());
     var oliphaunt2 = pool.checkOut();
-    LOGGER.info("Checked out {}", oliphaunt2);
+    LOGGER.info(checkedOut, oliphaunt2);
     var oliphaunt3 = pool.checkOut();
-    LOGGER.info("Checked out {}", oliphaunt3);
+    LOGGER.info(checkedOut, oliphaunt3);
     LOGGER.info(pool.toString());
     LOGGER.info("Checking in {}", oliphaunt1);
     pool.checkIn(oliphaunt1);
@@ -70,9 +72,9 @@ public class App {
     pool.checkIn(oliphaunt2);
     LOGGER.info(pool.toString());
     var oliphaunt4 = pool.checkOut();
-    LOGGER.info("Checked out {}", oliphaunt4);
+    LOGGER.info(checkedOut, oliphaunt4);
     var oliphaunt5 = pool.checkOut();
-    LOGGER.info("Checked out {}", oliphaunt5);
+    LOGGER.info(checkedOut, oliphaunt5);
     LOGGER.info(pool.toString());
   }
 }
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
index 7113f9304..f36563a8c 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
@@ -30,11 +30,10 @@ import org.junit.jupiter.api.Test;
  * Application test
  *
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    App.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    App.main(new String[]{});
   }
 }
diff --git a/observer/src/test/java/com/iluwatar/observer/AppTest.java b/observer/src/test/java/com/iluwatar/observer/AppTest.java
index b557fdf7e..6b1f426d6 100644
--- a/observer/src/test/java/com/iluwatar/observer/AppTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/AppTest.java
@@ -25,16 +25,17 @@ package com.iluwatar.observer;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * 
  * Application test
  *
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    String[] args = {};
-    App.main(args);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index 83d81bf82..eb094874f 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -44,6 +44,11 @@
             <artifactId>junit-vintage-engine</artifactId>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-core</artifactId>
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
index d50084a36..b00ee6861 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.partialresponse;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
 public class AppTest {
 
   @Test
-  public void main() throws Exception {
-    App.main(new String[]{});
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
\ No newline at end of file
diff --git a/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java b/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
index 8ea6a4c60..1316491ad 100644
--- a/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
+++ b/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.pipeline;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
index c23fe5563..50d7a90c9 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.poison.pill;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
index 166ddbdee..d551614cf 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.privateclassdata;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
index bf4b6cc66..0a436bd02 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.producer.consumer;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
 
   }
 }
diff --git a/promise/src/main/java/com/iluwatar/promise/Promise.java b/promise/src/main/java/com/iluwatar/promise/Promise.java
index 9eecf00eb..e81cccb58 100644
--- a/promise/src/main/java/com/iluwatar/promise/Promise.java
+++ b/promise/src/main/java/com/iluwatar/promise/Promise.java
@@ -47,6 +47,7 @@ public class Promise<T> extends PromiseSupport<T> {
    * Creates a promise that will be fulfilled in future.
    */
   public Promise() {
+    // Empty constructor
   }
 
   /**
diff --git a/promise/src/test/java/com/iluwatar/promise/AppTest.java b/promise/src/test/java/com/iluwatar/promise/AppTest.java
index 63ac06aec..bf2f264c0 100644
--- a/promise/src/test/java/com/iluwatar/promise/AppTest.java
+++ b/promise/src/test/java/com/iluwatar/promise/AppTest.java
@@ -26,13 +26,15 @@ package com.iluwatar.promise;
 import java.util.concurrent.ExecutionException;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void testApp() throws InterruptedException, ExecutionException {
-    App.main(null);
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(null));
   }
 }
diff --git a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
index a72faf01e..3b6d43be2 100644
--- a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
+++ b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
@@ -67,7 +67,7 @@ public class PromiseTest {
 
   @Test
   public void promiseIsFulfilledWithAnExceptionIfTaskThrowsAnException()
-      throws InterruptedException, TimeoutException {
+      throws InterruptedException {
     testWaitingForeverForPromiseToBeFulfilled();
     testWaitingSomeTimeForPromiseToBeFulfilled();
   }
diff --git a/property/src/main/java/com/iluwatar/property/Character.java b/property/src/main/java/com/iluwatar/property/Character.java
index afe9fe16c..3d3813e5f 100644
--- a/property/src/main/java/com/iluwatar/property/Character.java
+++ b/property/src/main/java/com/iluwatar/property/Character.java
@@ -61,10 +61,12 @@ public class Character implements Prototype {
 
       @Override
       public void set(Stats stat, Integer val) {
+        // Does Nothing
       }
 
       @Override
       public void remove(Stats stat) {
+        // Does Nothing.
       }
     };
   }
diff --git a/property/src/test/java/com/iluwatar/property/AppTest.java b/property/src/test/java/com/iluwatar/property/AppTest.java
index 89c0dcbf6..38c5cb4d5 100644
--- a/property/src/test/java/com/iluwatar/property/AppTest.java
+++ b/property/src/test/java/com/iluwatar/property/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.property;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
index 489b6365c..d82568ddf 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.prototype;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
index 2fdd5253e..dde0bbe57 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.proxy;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
index 55c9528e6..2adc15011 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.queue.load.leveling;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
index 1e81c5d11..3d12e6abf 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
@@ -25,14 +25,17 @@ package com.iluwatar.queue.load.leveling;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
 /**
  * Test case for submitting Message to Blocking Queue by TaskGenerator and retrieve the message by
  * ServiceExecutor.
  */
-public class TaskGenSrvExeTest {
+class TaskGenSrvExeTest {
 
   @Test
-  public void taskGeneratorTest() {
+  void taskGeneratorTest() {
     var msgQueue = new MessageQueue();
 
     // Create a task generator thread with 1 job to submit.
@@ -40,10 +43,14 @@ public class TaskGenSrvExeTest {
     var taskGenThr = new Thread(taskRunnable);
     taskGenThr.start();
 
+    assertNotNull(taskGenThr);
+
     // Create a service executor thread.
     var srvRunnable = new ServiceExecutor(msgQueue);
     var srvExeThr = new Thread(srvRunnable);
     srvExeThr.start();
+
+    assertNotNull(srvExeThr);
   }
 
 }
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
index 76ddfbdba..1d7faab7e 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
@@ -30,6 +30,9 @@ import org.junit.jupiter.api.Test;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
 /**
  * This class tests the Distributed Logging service by starting a Reactor and then sending it
  * concurrent logging requests using multiple clients.
@@ -50,9 +53,13 @@ public class ReactorTest {
     var app = new App(new ThreadPoolDispatcher(2));
     app.start();
 
+    assertNotNull(app);
+
     var client = new AppClient();
     client.start();
 
+    assertNotNull(client);
+
     // allow clients to send requests. Artificial delay.
     try {
       Thread.sleep(2000);
@@ -78,9 +85,13 @@ public class ReactorTest {
     var app = new App(new SameThreadDispatcher());
     app.start();
 
+    assertNotNull(app);
+
     var client = new AppClient();
     client.start();
 
+    assertNotNull(client);
+
     // allow clients to send requests. Artificial delay.
     try {
       Thread.sleep(2000);
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
index a0175e259..63f4c764d 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.reader.writer.lock;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
 
   }
 }
diff --git a/repository/src/test/java/com/iluwatar/repository/AppTest.java b/repository/src/test/java/com/iluwatar/repository/AppTest.java
index b12f03d8c..d44af23db 100644
--- a/repository/src/test/java/com/iluwatar/repository/AppTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.repository;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Repository example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
index dedeee7e0..057a85500 100644
--- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
+++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.resource.acquisition.is.initialization;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/retry/src/main/java/com/iluwatar/retry/App.java b/retry/src/main/java/com/iluwatar/retry/App.java
index 06f43c29f..7d6e6faec 100644
--- a/retry/src/main/java/com/iluwatar/retry/App.java
+++ b/retry/src/main/java/com/iluwatar/retry/App.java
@@ -59,6 +59,7 @@ import org.slf4j.LoggerFactory;
  */
 public final class App {
   private static final Logger LOG = LoggerFactory.getLogger(App.class);
+  public static final String NOT_FOUND = "not found";
   private static BusinessOperation<String> op;
 
   /**
@@ -81,7 +82,7 @@ public final class App {
   }
 
   private static void errorNoRetry() throws Exception {
-    op = new FindCustomer("123", new CustomerNotFoundException("not found"));
+    op = new FindCustomer("123", new CustomerNotFoundException(NOT_FOUND));
     try {
       op.perform();
     } catch (CustomerNotFoundException e) {
@@ -91,7 +92,7 @@ public final class App {
 
   private static void errorWithRetry() throws Exception {
     final var retry = new Retry<>(
-        new FindCustomer("123", new CustomerNotFoundException("not found")),
+        new FindCustomer("123", new CustomerNotFoundException(NOT_FOUND)),
         3,  //3 attempts
         100, //100 ms delay between attempts
         e -> CustomerNotFoundException.class.isAssignableFrom(e.getClass())
@@ -106,7 +107,7 @@ public final class App {
 
   private static void errorWithRetryExponentialBackoff() throws Exception {
     final var retry = new RetryExponentialBackoff<>(
-        new FindCustomer("123", new CustomerNotFoundException("not found")),
+        new FindCustomer("123", new CustomerNotFoundException(NOT_FOUND)),
         6,  //6 attempts
         30000, //30 s max delay between attempts
         e -> CustomerNotFoundException.class.isAssignableFrom(e.getClass())
diff --git a/role-object/pom.xml b/role-object/pom.xml
index ccb8219eb..c980adc2c 100644
--- a/role-object/pom.xml
+++ b/role-object/pom.xml
@@ -39,6 +39,11 @@
       <artifactId>junit</artifactId>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
 
   <build>
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
index eb8d57f4f..01535f477 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
@@ -24,10 +24,12 @@ package com.iluwatar.roleobject;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 public class ApplicationRoleObjectTest {
 
   @Test
-  public void mainTest() {
-    ApplicationRoleObject.main(new String[]{});
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> ApplicationRoleObject.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/saga/pom.xml b/saga/pom.xml
index 08a5cdc77..1971ae6cf 100644
--- a/saga/pom.xml
+++ b/saga/pom.xml
@@ -40,6 +40,11 @@
             <artifactId>junit</artifactId>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
index d7a2a34b2..5d73a9fa3 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.saga.choreography;
 import com.iluwatar.saga.orchestration.SagaApplication;
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 
 /***
  * empty test
  */
 public class SagaApplicationTest {
   @Test
-  public void mainTest() {
-    SagaApplication.main(new String[]{});
+  public void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> SagaApplication.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java b/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
index f450c0593..302796238 100644
--- a/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
+++ b/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.semaphore;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application Test Entrypoint
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/servant/src/test/java/com/iluwatar/servant/AppTest.java b/servant/src/test/java/com/iluwatar/servant/AppTest.java
index ab1e99e55..d05c22eeb 100644
--- a/servant/src/test/java/com/iluwatar/servant/AppTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.servant;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
index ea660f01e..e360e5c94 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
@@ -55,6 +55,7 @@ import org.slf4j.LoggerFactory;
 public class App {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+  public static final String BOOK_OF_IDORES = "Book of Idores";
 
   /**
    * Program entry point.
@@ -135,7 +136,7 @@ public class App {
     spellbook4.addSpell(spell11);
     spellbook4.addSpell(spell12);
     spellbookDao.merge(spellbook4);
-    var spellbook5 = new Spellbook("Book of Idores");
+    var spellbook5 = new Spellbook(BOOK_OF_IDORES);
     spellbookDao.persist(spellbook5);
     spellbook5.addSpell(spell13);
     spellbookDao.merge(spellbook5);
@@ -164,7 +165,7 @@ public class App {
     wizardDao.merge(wizard2);
     var wizard3 = new Wizard("Xuban Munoa");
     wizardDao.persist(wizard3);
-    wizard3.addSpellbook(spellbookDao.findByName("Book of Idores"));
+    wizard3.addSpellbook(spellbookDao.findByName(BOOK_OF_IDORES));
     wizard3.addSpellbook(spellbookDao.findByName("Book of Opaen"));
     wizardDao.merge(wizard3);
     var wizard4 = new Wizard("Blasius Dehooge");
@@ -188,7 +189,7 @@ public class App {
     LOGGER.info("Enumerating all spells");
     service.findAllSpells().stream().map(Spell::getName).forEach(LOGGER::info);
     LOGGER.info("Find wizards with spellbook 'Book of Idores'");
-    var wizardsWithSpellbook = service.findWizardsWithSpellbook("Book of Idores");
+    var wizardsWithSpellbook = service.findWizardsWithSpellbook(BOOK_OF_IDORES);
     wizardsWithSpellbook.forEach(w -> LOGGER.info("{} has 'Book of Idores'", w.getName()));
     LOGGER.info("Find wizards with spell 'Fireball'");
     var wizardsWithSpell = service.findWizardsWithSpell("Fireball");
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
index 26aa2b168..5cc1ccfff 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
@@ -27,18 +27,20 @@ import com.iluwatar.servicelayer.hibernate.HibernateUtil;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     HibernateUtil.dropSession();
   }
 
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
index efc25bd89..85419b603 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
@@ -37,19 +37,22 @@ package com.iluwatar.servicelocator;
  */
 public class App {
 
+  public static final String JNDI_SERVICE_A = "jndi/serviceA";
+  public static final String JNDI_SERVICE_B = "jndi/serviceB";
+
   /**
    * Program entry point.
    *
    * @param args command line args
    */
   public static void main(String[] args) {
-    var service = ServiceLocator.getService("jndi/serviceA");
+    var service = ServiceLocator.getService(JNDI_SERVICE_A);
     service.execute();
-    service = ServiceLocator.getService("jndi/serviceB");
+    service = ServiceLocator.getService(JNDI_SERVICE_B);
     service.execute();
-    service = ServiceLocator.getService("jndi/serviceA");
+    service = ServiceLocator.getService(JNDI_SERVICE_A);
     service.execute();
-    service = ServiceLocator.getService("jndi/serviceA");
+    service = ServiceLocator.getService(JNDI_SERVICE_A);
     service.execute();
   }
 }
diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
index cb4c98c07..75d6f8b05 100644
--- a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
+++ b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.servicelocator;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/sharding/pom.xml b/sharding/pom.xml
index a641ce375..2d00629bc 100644
--- a/sharding/pom.xml
+++ b/sharding/pom.xml
@@ -40,6 +40,11 @@
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/sharding/src/main/java/com/iluwatar/sharding/App.java b/sharding/src/main/java/com/iluwatar/sharding/App.java
index fe3cb7923..109f88cf8 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/App.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/App.java
@@ -36,10 +36,10 @@ public class App {
    */
   public static void main(String[] args) {
 
-    var data1 = new Data(1, "data1", Data.DataType.type1);
-    var data2 = new Data(2, "data2", Data.DataType.type2);
-    var data3 = new Data(3, "data3", Data.DataType.type3);
-    var data4 = new Data(4, "data4", Data.DataType.type1);
+    var data1 = new Data(1, "data1", Data.DataType.TYPE_1);
+    var data2 = new Data(2, "data2", Data.DataType.TYPE_2);
+    var data3 = new Data(3, "data3", Data.DataType.TYPE_3);
+    var data4 = new Data(4, "data4", Data.DataType.TYPE_1);
 
     var shard1 = new Shard(1);
     var shard2 = new Shard(2);
diff --git a/sharding/src/main/java/com/iluwatar/sharding/Data.java b/sharding/src/main/java/com/iluwatar/sharding/Data.java
index 92e84e93a..abe49f15d 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/Data.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/Data.java
@@ -71,7 +71,7 @@ public class Data {
   }
 
   enum DataType {
-    type1, type2, type3
+    TYPE_1, TYPE_2, TYPE_3
   }
 
   @Override
diff --git a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
index bdb862571..d06cd51da 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
@@ -47,11 +47,11 @@ public class RangeShardManager extends ShardManager {
   protected int allocateShard(Data data) {
     var type = data.getType();
     switch (type) {
-      case type1:
+      case TYPE_1:
         return 1;
-      case type2:
+      case TYPE_2:
         return 2;
-      case type3:
+      case TYPE_3:
         return 3;
       default:
         return -1;
diff --git a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
index 40e6391bf..f23b71d1e 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.sharding;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Unit tests for App class.
  */
 public class AppTest {
 
   @Test
-  public void testMain() {
-    App.main(new String[]{});
+  public void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
index 6418cf0c4..e19de75d2 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
@@ -56,7 +56,7 @@ public class HashShardManagerTest {
 
   @Test
   public void testStoreData() {
-    var data = new Data(1, "test", Data.DataType.type1);
+    var data = new Data(1, "test", Data.DataType.TYPE_1);
     hashShardManager.storeData(data);
     Assert.assertEquals(data, hashShardManager.getShardById(1).getDataById(1));
   }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
index 70650bb50..c6ce5851d 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
@@ -52,7 +52,7 @@ public class LookupShardManagerTest {
   @Test
   public void testStoreData() {
     try {
-      var data = new Data(1, "test", Data.DataType.type1);
+      var data = new Data(1, "test", Data.DataType.TYPE_1);
       lookupShardManager.storeData(data);
       var field = LookupShardManager.class.getDeclaredField("lookupMap");
       field.setAccessible(true);
diff --git a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
index 997687dfc..9ea4a2d86 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
@@ -50,7 +50,7 @@ public class RangeShardManagerTest {
 
   @Test
   public void testStoreData() {
-    var data = new Data(1, "test", Data.DataType.type1);
+    var data = new Data(1, "test", Data.DataType.TYPE_1);
     rangeShardManager.storeData(data);
     Assert.assertEquals(data, rangeShardManager.getShardById(1).getDataById(1));
   }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
index a747933af..a12ab3a97 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
@@ -42,7 +42,7 @@ public class ShardTest {
 
   @Before
   public void setup() {
-    data = new Data(1, "test", Data.DataType.type1);
+    data = new Data(1, "test", Data.DataType.TYPE_1);
     shard = new Shard(1);
   }
 
diff --git a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
index b7c55ddea..5d3f247de 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.singleton;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
index 8a0e2383c..083d6a019 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
@@ -59,6 +59,7 @@ import org.slf4j.LoggerFactory;
 
 public class App {
   private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+  private static final String BUBBLE = "Bubble ";
 
   static void noSpatialPartition(int numOfMovements, Hashtable<Integer, Bubble> bubbles) {
     //all bubbles have to be checked for collision for all bubbles
@@ -76,7 +77,7 @@ public class App {
       numOfMovements--;
     }
     //bubbles not popped
-    bubbles.keySet().stream().map(key -> "Bubble " + key + " not popped").forEach(LOGGER::info);
+    bubbles.keySet().stream().map(key -> BUBBLE + key + " not popped").forEach(LOGGER::info);
   }
 
   static void withSpatialPartition(
@@ -99,7 +100,7 @@ public class App {
       numOfMovements--;
     }
     //bubbles not popped
-    bubbles.keySet().stream().map(key -> "Bubble " + key + " not popped").forEach(LOGGER::info);
+    bubbles.keySet().stream().map(key -> BUBBLE + key + " not popped").forEach(LOGGER::info);
   }
 
   /**
@@ -116,7 +117,7 @@ public class App {
       var b = new Bubble(rand.nextInt(300), rand.nextInt(300), i, rand.nextInt(2) + 1);
       bubbles1.put(i, b);
       bubbles2.put(i, b);
-      LOGGER.info("Bubble " + i + " with radius " + b.radius
+      LOGGER.info(BUBBLE + i + " with radius " + b.radius
           + " added at (" + b.coordinateX + "," + b.coordinateY + ")");
     }
 
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
index b3f60632f..c0eb5ecde 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
@@ -34,8 +34,8 @@ import java.util.Hashtable;
 
 public class SpatialPartitionBubbles extends SpatialPartitionGeneric<Bubble> {
 
-  final Hashtable<Integer, Bubble> bubbles;
-  final QuadTree quadTree;
+  private final Hashtable<Integer, Bubble> bubbles;
+  private final QuadTree quadTree;
 
   SpatialPartitionBubbles(Hashtable<Integer, Bubble> bubbles, QuadTree quadTree) {
     this.bubbles = bubbles;
diff --git a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
index bc6f2226f..4b29e11e8 100644
--- a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.specification.app;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/state/src/test/java/com/iluwatar/state/AppTest.java b/state/src/test/java/com/iluwatar/state/AppTest.java
index 9f7b65ff2..90beddb33 100644
--- a/state/src/test/java/com/iluwatar/state/AppTest.java
+++ b/state/src/test/java/com/iluwatar/state/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.state;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
index 1f3fc6238..20119b41b 100644
--- a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
+++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.stepbuilder;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
index f53a31bd8..8cc1822fe 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
@@ -34,9 +34,10 @@ import org.slf4j.LoggerFactory;
 public class NewSource {
   private static final Logger LOGGER = LoggerFactory.getLogger(NewSource.class);
   private static final  String VERSION = "2.0";
+  public static final String SOURCE_MODULE = "Source module {}";
 
   public int accumulateSum(int... nums) {
-    LOGGER.info("Source module {}", VERSION);
+    LOGGER.info(SOURCE_MODULE, VERSION);
     return Arrays.stream(nums).reduce(0, Integer::sum);
   }
 
@@ -45,12 +46,12 @@ public class NewSource {
    * Replace old one in {@link OldSource}
    */
   public int accumulateMul(int... nums) {
-    LOGGER.info("Source module {}", VERSION);
+    LOGGER.info(SOURCE_MODULE, VERSION);
     return Arrays.stream(nums).reduce(1, (a, b) -> a * b);
   }
 
   public boolean ifNonZero(int... nums) {
-    LOGGER.info("Source module {}", VERSION);
+    LOGGER.info(SOURCE_MODULE, VERSION);
     return Arrays.stream(nums).allMatch(num -> num != 0);
   }
 }
diff --git a/strangler/src/test/java/com/iluwatar/strangler/AppTest.java b/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
index a9e878a94..7e45d63ec 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.strangler;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
index f1137c4c5..174334f51 100644
--- a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
+++ b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.strategy;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index 264343b00..ac718291e 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -44,6 +44,11 @@
             <groupId>com.github.stefanbirkner</groupId>
             <artifactId>system-rules</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
 </project>
\ No newline at end of file
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
index 83ba5315f..8d4865f6b 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.subclasssandbox;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * App unit tests.
  */
 public class AppTest {
 
   @Test
-  public void testMain() {
-    App.main(new String[]{});
+  public void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
index e70e8a78f..32f09242e 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.templatemethod;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
index ca6dc30e4..4c1cf90d6 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
@@ -25,15 +25,17 @@ package com.iluwatar.threadpool;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  *
  * @author ilkka
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/throttling/src/test/java/com/iluwatar/throttling/AppTest.java b/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
index daf8c2f21..dcabb02b3 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.throttling;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/tls/src/test/java/com/iluwatar/tls/AppTest.java b/tls/src/test/java/com/iluwatar/tls/AppTest.java
index bae673b97..ba3774b3e 100644
--- a/tls/src/test/java/com/iluwatar/tls/AppTest.java
+++ b/tls/src/test/java/com/iluwatar/tls/AppTest.java
@@ -25,14 +25,16 @@ package com.iluwatar.tls;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that thread local storage example runs without errors.
  *
  * @author Thomas Bauer, January 2017
  */
-public class AppTest {
+class AppTest {
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
index f6a9e6a0e..98ad31fe5 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
@@ -38,6 +38,9 @@ import java.util.Map;
  */
 public final class RainbowFishSerializer {
 
+  public static final String LENGTH_METERS = "lengthMeters";
+  public static final String WEIGHT_TONS = "weightTons";
+
   private RainbowFishSerializer() {
   }
 
@@ -48,8 +51,8 @@ public final class RainbowFishSerializer {
     var map = Map.of(
         "name", rainbowFish.getName(),
         "age", String.format("%d", rainbowFish.getAge()),
-        "lengthMeters", String.format("%d", rainbowFish.getLengthMeters()),
-        "weightTons", String.format("%d", rainbowFish.getWeightTons())
+            LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
+            WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons())
     );
 
     try (var fileOut = new FileOutputStream(filename);
@@ -65,8 +68,8 @@ public final class RainbowFishSerializer {
     var map = Map.of(
         "name", rainbowFish.getName(),
         "age", String.format("%d", rainbowFish.getAge()),
-        "lengthMeters", String.format("%d", rainbowFish.getLengthMeters()),
-        "weightTons", String.format("%d", rainbowFish.getWeightTons()),
+            "lengthMeters", String.format("%d", rainbowFish.getLengthMeters()),
+            WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons()),
         "angry", Boolean.toString(rainbowFish.getAngry()),
         "hungry", Boolean.toString(rainbowFish.getHungry()),
         "sleeping", Boolean.toString(rainbowFish.getSleeping())
@@ -93,7 +96,7 @@ public final class RainbowFishSerializer {
         map.get("name"),
         Integer.parseInt(map.get("age")),
         Integer.parseInt(map.get("lengthMeters")),
-        Integer.parseInt(map.get("weightTons"))
+        Integer.parseInt(map.get(WEIGHT_TONS))
     );
   }
 }
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
index d28e118d2..4b9432408 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
@@ -29,19 +29,21 @@ import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() throws ClassNotFoundException, IOException {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
   @BeforeEach
   @AfterEach
-  public void cleanup() {
+  void cleanup() {
     var file1 = new File("fish1.out");
     file1.delete();
     var file2 = new File("fish2.out");
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
index 425d6e153..eb819cabe 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
@@ -25,12 +25,15 @@ package com.iluwatar.transactionscript;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Tests that Transaction script example runs without errors.
  */
-public class AppTest {
+class AppTest {
+
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/twin/src/test/java/com/iluwatar/twin/AppTest.java b/twin/src/test/java/com/iluwatar/twin/AppTest.java
index 50b787eeb..38a3208ad 100644
--- a/twin/src/test/java/com/iluwatar/twin/AppTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.twin;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() throws Exception {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
index 88bfe0ada..7183c99df 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
@@ -30,8 +30,8 @@ package com.iluwatar.typeobject;
 public class Candy {
 
   enum Type {
-    crushableCandy,
-    rewardFruit
+    CRUSHABLE_CANDY,
+    REWARD_FRUIT
   }
 
   String name;
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
index 04e281a99..ab175e660 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
@@ -104,13 +104,13 @@ public class CandyGame {
 
   boolean continueRound() {
     for (var i = 0; i < this.cells.length; i++) {
-      if (this.cells[cells.length - 1][i].candy.getType().equals(Type.rewardFruit)) {
+      if (this.cells[cells.length - 1][i].candy.getType().equals(Type.REWARD_FRUIT)) {
         return true;
       }
     }
     for (var i = 0; i < this.cells.length; i++) {
       for (var j = 0; j < this.cells.length; j++) {
-        if (!this.cells[i][j].candy.getType().equals(Type.rewardFruit)) {
+        if (!this.cells[i][j].candy.getType().equals(Type.REWARD_FRUIT)) {
           var adj = adjacentCells(i, j);
           for (Cell cell : adj) {
             if (this.cells[i][j].candy.name.equals(cell.candy.name)) {
@@ -136,7 +136,7 @@ public class CandyGame {
       for (var i = 0; i < this.cells.length; i++) {
         var points = 0;
         var j = this.cells.length - 1;
-        while (this.cells[j][i].candy.getType().equals(Type.rewardFruit)) {
+        while (this.cells[j][i].candy.getType().equals(Type.REWARD_FRUIT)) {
           points = this.cells[j][i].candy.getPoints();
           this.cells[j][i].crush(pool, this.cells);
           handleChange(points);
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
index e4d9d497f..76629b9dd 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
@@ -74,8 +74,8 @@ public class Cell {
   }
 
   int interact(Cell c, CellPool pool, Cell[][] cellMatrix) {
-    if (this.candy.getType().equals(Type.rewardFruit) || c.candy.getType()
-        .equals(Type.rewardFruit)) {
+    if (this.candy.getType().equals(Type.REWARD_FRUIT) || c.candy.getType()
+        .equals(Type.REWARD_FRUIT)) {
       return 0;
     } else {
       if (this.candy.name.equals(c.candy.name)) {
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
index f33640f2a..923a5c403 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
@@ -24,7 +24,7 @@
 package com.iluwatar.typeobject;
 
 import com.iluwatar.typeobject.Candy.Type;
-import java.io.FileNotFoundException;
+
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
@@ -39,6 +39,8 @@ import org.json.simple.parser.ParseException;
 
 public class CellPool {
   private static final Random RANDOM = new Random();
+  public static final String FRUIT = "fruit";
+  public static final String CANDY = "candy";
   List<Cell> pool;
   int pointer;
   Candy[] randomCode;
@@ -51,11 +53,11 @@ public class CellPool {
       e.printStackTrace();
       //manually initialising this.randomCode
       this.randomCode = new Candy[5];
-      randomCode[0] = new Candy("cherry", "fruit", Type.rewardFruit, 20);
-      randomCode[1] = new Candy("mango", "fruit", Type.rewardFruit, 20);
-      randomCode[2] = new Candy("purple popsicle", "candy", Type.crushableCandy, 10);
-      randomCode[3] = new Candy("green jellybean", "candy", Type.crushableCandy, 10);
-      randomCode[4] = new Candy("orange gum", "candy", Type.crushableCandy, 10);
+      randomCode[0] = new Candy("cherry", FRUIT, Type.REWARD_FRUIT, 20);
+      randomCode[1] = new Candy("mango", FRUIT, Type.REWARD_FRUIT, 20);
+      randomCode[2] = new Candy("purple popsicle", CANDY, Type.CRUSHABLE_CANDY, 10);
+      randomCode[3] = new Candy("green jellybean", CANDY, Type.CRUSHABLE_CANDY, 10);
+      randomCode[4] = new Candy("orange gum", CANDY, Type.CRUSHABLE_CANDY, 10);
     }
     for (int i = 0; i < num; i++) {
       var c = new Cell();
@@ -84,7 +86,7 @@ public class CellPool {
     var i = 0;
     for (var e = jp.candies.keys(); e.hasMoreElements(); ) {
       var s = e.nextElement();
-      if (!s.equals("fruit") && !s.equals("candy")) {
+      if (!s.equals(FRUIT) && !s.equals(CANDY)) {
         //not generic
         randomCode[i] = jp.candies.get(s);
         i++;
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
index 01e709c8f..150c648d3 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
@@ -29,7 +29,7 @@ import java.io.FileReader;
 import java.io.IOException;
 import java.util.Hashtable;
 import java.util.List;
-import java.util.stream.Collectors;
+
 import org.json.simple.JSONArray;
 import org.json.simple.JSONObject;
 import org.json.simple.parser.JSONParser;
@@ -58,9 +58,9 @@ public class JsonParser {
       var name = (String) candy.get("name");
       var parentName = (String) candy.get("parent");
       var t = (String) candy.get("type");
-      var type = Type.crushableCandy;
+      var type = Type.CRUSHABLE_CANDY;
       if (t.equals("rewardFruit")) {
-        type = Type.rewardFruit;
+        type = Type.REWARD_FRUIT;
       }
       var points = Integer.parseInt((String) candy.get("points"));
       var c = new Candy(name, parentName, type, points);
diff --git a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
index 8175d1dd0..69bcc67c5 100644
--- a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
+++ b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
@@ -46,9 +46,9 @@ class CandyGameTest {
   @Test
   void continueRoundTest() {
     var matrix = new Cell[2][2];
-    var c1 = new Candy("green jelly", "jelly", Type.crushableCandy, 5);
-    var c2 = new Candy("purple jelly", "jelly", Type.crushableCandy, 5);
-    var c3 = new Candy("green apple", "apple", Type.rewardFruit, 10);
+    var c1 = new Candy("green jelly", "jelly", Type.CRUSHABLE_CANDY, 5);
+    var c2 = new Candy("purple jelly", "jelly", Type.CRUSHABLE_CANDY, 5);
+    var c3 = new Candy("green apple", "apple", Type.REWARD_FRUIT, 10);
     matrix[0][0] = new Cell(c1, 0, 0);
     matrix[0][1] = new Cell(c2, 1, 0);
     matrix[1][0] = new Cell(c3, 0, 1);
diff --git a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
index 18bca62bb..6d910e47c 100644
--- a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
+++ b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
@@ -36,8 +36,8 @@ class CellTest {
 
   @Test
   void interactTest() {
-    var c1 = new Candy("green jelly", "jelly", Type.crushableCandy, 5);
-    var c2 = new Candy("green apple", "apple", Type.rewardFruit, 10);
+    var c1 = new Candy("green jelly", "jelly", Type.CRUSHABLE_CANDY, 5);
+    var c2 = new Candy("green apple", "apple", Type.REWARD_FRUIT, 10);
     var matrix = new Cell[4][4];
     matrix[0][0] = new Cell(c1, 0, 0);
     matrix[0][1] = new Cell(c1, 1, 0);
@@ -51,8 +51,8 @@ class CellTest {
 
   @Test
   void crushTest() {
-    var c1 = new Candy("green jelly", "jelly", Type.crushableCandy, 5);
-    var c2 = new Candy("purple candy", "candy", Type.crushableCandy, 5);
+    var c1 = new Candy("green jelly", "jelly", Type.CRUSHABLE_CANDY, 5);
+    var c2 = new Candy("purple candy", "candy", Type.CRUSHABLE_CANDY, 5);
     var matrix = new Cell[4][4];
     matrix[0][0] = new Cell(c1, 0, 0);
     matrix[1][0] = new Cell(c2, 0, 1);
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index cd6ce06f1..1fab10186 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -44,6 +44,11 @@
             <artifactId>junit-vintage-engine</artifactId>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-core</artifactId>
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
index c44a696e3..e5e24817f 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
@@ -29,9 +29,6 @@ package com.iluwatar.unitofwork;
  * @param <T> Any generic entity
  */
 public interface IUnitOfWork<T> {
-  String INSERT = "INSERT";
-  String DELETE = "DELETE";
-  String MODIFY = "MODIFY";
 
   /**
    * Any register new operation occurring on UnitOfWork is only going to be performed on commit.
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
index 73c1068b3..70433ed98 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
@@ -52,20 +52,20 @@ public class StudentRepository implements IUnitOfWork<Student> {
   @Override
   public void registerNew(Student student) {
     LOGGER.info("Registering {} for insert in context.", student.getName());
-    register(student, IUnitOfWork.INSERT);
+    register(student, UnitActions.INSERT.getActionValue());
   }
 
   @Override
   public void registerModified(Student student) {
     LOGGER.info("Registering {} for modify in context.", student.getName());
-    register(student, IUnitOfWork.MODIFY);
+    register(student, UnitActions.MODIFY.getActionValue());
 
   }
 
   @Override
   public void registerDeleted(Student student) {
     LOGGER.info("Registering {} for delete in context.", student.getName());
-    register(student, IUnitOfWork.DELETE);
+    register(student, UnitActions.DELETE.getActionValue());
   }
 
   private void register(Student student, String operation) {
@@ -86,21 +86,21 @@ public class StudentRepository implements IUnitOfWork<Student> {
       return;
     }
     LOGGER.info("Commit started");
-    if (context.containsKey(IUnitOfWork.INSERT)) {
+    if (context.containsKey(UnitActions.INSERT.getActionValue())) {
       commitInsert();
     }
 
-    if (context.containsKey(IUnitOfWork.MODIFY)) {
+    if (context.containsKey(UnitActions.MODIFY.getActionValue())) {
       commitModify();
     }
-    if (context.containsKey(IUnitOfWork.DELETE)) {
+    if (context.containsKey(UnitActions.DELETE.getActionValue())) {
       commitDelete();
     }
     LOGGER.info("Commit finished.");
   }
 
   private void commitInsert() {
-    var studentsToBeInserted = context.get(IUnitOfWork.INSERT);
+    var studentsToBeInserted = context.get(UnitActions.INSERT.getActionValue());
     for (var student : studentsToBeInserted) {
       LOGGER.info("Saving {} to database.", student.getName());
       studentDatabase.insert(student);
@@ -108,7 +108,7 @@ public class StudentRepository implements IUnitOfWork<Student> {
   }
 
   private void commitModify() {
-    var modifiedStudents = context.get(IUnitOfWork.MODIFY);
+    var modifiedStudents = context.get(UnitActions.MODIFY.getActionValue());
     for (var student : modifiedStudents) {
       LOGGER.info("Modifying {} to database.", student.getName());
       studentDatabase.modify(student);
@@ -116,7 +116,7 @@ public class StudentRepository implements IUnitOfWork<Student> {
   }
 
   private void commitDelete() {
-    var deletedStudents = context.get(IUnitOfWork.DELETE);
+    var deletedStudents = context.get(UnitActions.DELETE.getActionValue());
     for (var student : deletedStudents) {
       LOGGER.info("Deleting {} to database.", student.getName());
       studentDatabase.delete(student);
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
new file mode 100644
index 000000000..b00d015a3
--- /dev/null
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
@@ -0,0 +1,18 @@
+package com.iluwatar.unitofwork;
+
+public enum UnitActions {
+    INSERT("INSERT"),
+    DELETE("DELETE"),
+    MODIFY("MODIFY")
+    ;
+
+    private final String actionValue;
+
+    UnitActions(String actionValue) {
+        this.actionValue = actionValue;
+    }
+
+    public String getActionValue() {
+        return actionValue;
+    }
+}
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
index ecbe5fc53..2fbe37ccf 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
@@ -25,12 +25,14 @@ package com.iluwatar.unitofwork;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * AppTest
  */
 public class AppTest {
   @Test
-  public void test() {
-    App.main(new String[]{});
+  public void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
index cda2f6fca..6cf1e6e16 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
@@ -63,7 +63,7 @@ public class StudentRepositoryTest {
     studentRepository.registerNew(student1);
     studentRepository.registerNew(student2);
 
-    assertEquals(2, context.get(IUnitOfWork.INSERT).size());
+    assertEquals(2, context.get(UnitActions.INSERT.getActionValue()).size());
     verifyNoMoreInteractions(studentDatabase);
   }
 
@@ -72,7 +72,7 @@ public class StudentRepositoryTest {
     studentRepository.registerDeleted(student1);
     studentRepository.registerDeleted(student2);
 
-    assertEquals(2, context.get(IUnitOfWork.DELETE).size());
+    assertEquals(2, context.get(UnitActions.DELETE.getActionValue()).size());
     verifyNoMoreInteractions(studentDatabase);
   }
 
@@ -81,15 +81,15 @@ public class StudentRepositoryTest {
     studentRepository.registerModified(student1);
     studentRepository.registerModified(student2);
 
-    assertEquals(2, context.get(IUnitOfWork.MODIFY).size());
+    assertEquals(2, context.get(UnitActions.MODIFY.getActionValue()).size());
     verifyNoMoreInteractions(studentDatabase);
   }
 
   @Test
   public void shouldSaveAllLocalChangesToDb() {
-    context.put(IUnitOfWork.INSERT, List.of(student1));
-    context.put(IUnitOfWork.MODIFY, List.of(student1));
-    context.put(IUnitOfWork.DELETE, List.of(student1));
+    context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
+    context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
+    context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
 
     studentRepository.commit();
 
@@ -118,8 +118,8 @@ public class StudentRepositoryTest {
 
   @Test
   public void shouldNotInsertToDbIfNoRegisteredStudentsToBeCommitted() {
-    context.put(IUnitOfWork.MODIFY, List.of(student1));
-    context.put(IUnitOfWork.DELETE, List.of(student1));
+    context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
+    context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
 
     studentRepository.commit();
 
@@ -128,8 +128,8 @@ public class StudentRepositoryTest {
 
   @Test
   public void shouldNotModifyToDbIfNotRegisteredStudentsToBeCommitted() {
-    context.put(IUnitOfWork.INSERT, List.of(student1));
-    context.put(IUnitOfWork.DELETE, List.of(student1));
+    context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
+    context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
 
     studentRepository.commit();
 
@@ -138,8 +138,8 @@ public class StudentRepositoryTest {
 
   @Test
   public void shouldNotDeleteFromDbIfNotRegisteredStudentsToBeCommitted() {
-    context.put(IUnitOfWork.INSERT, List.of(student1));
-    context.put(IUnitOfWork.MODIFY, List.of(student1));
+    context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
+    context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
 
     studentRepository.commit();
 
diff --git a/update-method/pom.xml b/update-method/pom.xml
index a89364328..78b89555a 100644
--- a/update-method/pom.xml
+++ b/update-method/pom.xml
@@ -38,6 +38,11 @@
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/World.java b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
index 5b99050c8..37211abb1 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/World.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
@@ -88,6 +88,7 @@ public class World {
    * pattern.
    */
   private void render() {
+    // Does Nothing
   }
 
   /**
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
index 75c30470d..4849c4e62 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
@@ -25,11 +25,12 @@ package com.iluwatar.updatemethod;
 
 import org.junit.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 public class AppTest {
 
   @Test
-  public void testMain() {
-    String[] args = {};
-    App.main(args);
+  public void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/value-object/src/test/java/com/iluwatar/value/object/AppTest.java b/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
index c0e680ec4..39eaef28c 100644
--- a/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
+++ b/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.value.object;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
index c16f31195..45f7006a7 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
@@ -25,13 +25,15 @@ package com.iluwatar.visitor;
 
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 /**
  * Application test.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void test() {
-    App.main(new String[]{});
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }

From 133ef52898287827ff6648e3a9261560cee258b0 Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Sat, 15 Aug 2020 22:19:27 +0400
Subject: [PATCH 005/254] Fixed an issue with the order of imports that was
 causing build failures.

---
 .../iluwatar/model/view/presenter/FileSelectorJFrame.java | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
index 1dd1bf818..f59bcdf6f 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
@@ -23,9 +23,13 @@
 
 package com.iluwatar.model.view.presenter;
 
+import static javax.swing.ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED;
+import static javax.swing.ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED;
+
 import java.awt.Color;
 import java.awt.event.ActionEvent;
 import java.awt.event.ActionListener;
+
 import javax.swing.JButton;
 import javax.swing.JFrame;
 import javax.swing.JLabel;
@@ -35,10 +39,6 @@ import javax.swing.JScrollPane;
 import javax.swing.JTextArea;
 import javax.swing.JTextField;
 
-import static javax.swing.ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED;
-import static javax.swing.ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED;
-import static javax.swing.WindowConstants.EXIT_ON_CLOSE;
-
 /**
  * This class is the GUI implementation of the View component in the Model-View-Presenter pattern.
  */

From 00d06871f4841b676467bb933d7859713de0f306 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <contact@subho.xyz>
Date: Sun, 16 Aug 2020 12:42:08 +0530
Subject: [PATCH 006/254] updated workflows

---
 .github/workflows/{maven.yml => maven-ci.yml} | 10 ++-
 .github/workflows/maven-pr-builder.yml        | 64 +++++++++++++++++++
 2 files changed, 71 insertions(+), 3 deletions(-)
 rename .github/workflows/{maven.yml => maven-ci.yml} (91%)
 create mode 100644 .github/workflows/maven-pr-builder.yml

diff --git a/.github/workflows/maven.yml b/.github/workflows/maven-ci.yml
similarity index 91%
rename from .github/workflows/maven.yml
rename to .github/workflows/maven-ci.yml
index d18cad280..914db3f4d 100644
--- a/.github/workflows/maven.yml
+++ b/.github/workflows/maven-ci.yml
@@ -24,13 +24,11 @@
 # This workflow will build a Java project with Maven
 # For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
 
-name: Java CI with Maven
+name: Java CI
 
 on:
   push:
     branches: [ master ]
-  pull_request:
-    branches: [ master ]
 
 jobs:
   build:
@@ -43,6 +41,12 @@ jobs:
       uses: actions/setup-java@v1
       with:
         java-version: 11
+    - uses: actions/cache@v1
+      with:
+        path: ~/.m2/repository
+        key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+        restore-keys: |
+          ${{ runner.os }}-maven-
     # Some tests need screen access
     - name: Install xvfb
       run: sudo apt-get install xvfb
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
new file mode 100644
index 000000000..ea5d3d703
--- /dev/null
+++ b/.github/workflows/maven-pr-builder.yml
@@ -0,0 +1,64 @@
+#
+# The MIT License
+# Copyright © 2014-2019 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+# This workflow will build a Java project with Maven
+# For more information see: https://help.github.com/actions/language-and-framework-guides/building-and-testing-java-with-maven
+
+name: Java PR Builder
+
+on:
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-18.04
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up JDK 11
+      uses: actions/setup-java@v1
+      with:
+        java-version: 11
+    - uses: actions/cache@v1
+      with:
+        path: ~/.m2/repository
+        key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
+        restore-keys: |
+          ${{ runner.os }}-maven-
+    # Some tests need screen access
+    - name: Install xvfb
+      run: sudo apt-get install xvfb
+    # SonarQube scan does not work for forked repositories
+    # See https://jira.sonarsource.com/browse/MMF-1371
+    - name: Build with Maven
+      if: github.ref != 'refs/heads/master'
+      run: xvfb-run mvn clean verify
+    - name: Build with Maven and run SonarQube analysis
+      if: github.ref == 'refs/heads/master'
+      run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
+      env:
+        # These two env variables are needed for sonar analysis
+        GITHUB_TOKEN: ${{ secrets.REPOSITORY_ACCESS_TOKEN }}
+        SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

From 79a6af703ec94e3719c05122e0c1c08768a877d6 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <contact@subho.xyz>
Date: Sun, 16 Aug 2020 12:49:21 +0530
Subject: [PATCH 007/254] updated copyright year to 2020

---
 .github/workflows/maven-ci.yml         | 2 +-
 .github/workflows/maven-pr-builder.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 914db3f4d..a04b0021e 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2020 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index ea5d3d703..0384c326c 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2020 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal

From 57e45a329f23571544663a6e7b9c7133a4dcc731 Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Sun, 16 Aug 2020 22:35:15 +0400
Subject: [PATCH 008/254] Fixed a whitespace and spelling issue that was
 causing the test case to fail.

---
 extension-objects/src/main/java/concreteextensions/Soldier.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/extension-objects/src/main/java/concreteextensions/Soldier.java b/extension-objects/src/main/java/concreteextensions/Soldier.java
index 76ddbfd06..3ceaa7880 100644
--- a/extension-objects/src/main/java/concreteextensions/Soldier.java
+++ b/extension-objects/src/main/java/concreteextensions/Soldier.java
@@ -42,7 +42,7 @@ public class Soldier implements SoldierExtension {
 
   @Override
   public void soldierReady() {
-    LOGGER.info("[Solider] " + unit.getName() + "  is ready!");
+    LOGGER.info("[Soldier] " + unit.getName() + " is ready!");
   }
 
   public SoldierUnit getUnit() {

From 241f93f3ccd6d83b16006ede3c5241f5feae480a Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <contact@subho.xyz>
Date: Mon, 17 Aug 2020 11:28:33 +0530
Subject: [PATCH 009/254] updated cache to v2 and removed SQ analysis

---
 .github/workflows/maven-ci.yml         | 2 +-
 .github/workflows/maven-pr-builder.yml | 9 +--------
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index a04b0021e..8a7f7a0bb 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -41,7 +41,7 @@ jobs:
       uses: actions/setup-java@v1
       with:
         java-version: 11
-    - uses: actions/cache@v1
+    - uses: actions/cache@v2
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 0384c326c..1bdad0621 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -41,7 +41,7 @@ jobs:
       uses: actions/setup-java@v1
       with:
         java-version: 11
-    - uses: actions/cache@v1
+    - uses: actions/cache@v2
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
@@ -55,10 +55,3 @@ jobs:
     - name: Build with Maven
       if: github.ref != 'refs/heads/master'
       run: xvfb-run mvn clean verify
-    - name: Build with Maven and run SonarQube analysis
-      if: github.ref == 'refs/heads/master'
-      run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
-      env:
-        # These two env variables are needed for sonar analysis
-        GITHUB_TOKEN: ${{ secrets.REPOSITORY_ACCESS_TOKEN }}
-        SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

From 8c5740563dc5c1eb01c55bdcc919a70bb880d99d Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <contact@subho.xyz>
Date: Mon, 17 Aug 2020 19:12:54 +0530
Subject: [PATCH 010/254] reverted the copyright year back to 2019

---
 .github/workflows/maven-ci.yml         | 2 +-
 .github/workflows/maven-pr-builder.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 8a7f7a0bb..be0a74e9f 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2020 Ilkka Seppälä
+# Copyright © 2014-2019 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 1bdad0621..7e4f3670f 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2020 Ilkka Seppälä
+# Copyright © 2014-2019 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal

From 95e513b6ecffbc7a1fbd194c1908e0f9f9adf2d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Mon, 17 Aug 2020 19:49:00 +0300
Subject: [PATCH 011/254] Edit readme

---
 visitor/README.md | 48 ++++++++++++++++++++++++++++++-----------------
 1 file changed, 31 insertions(+), 17 deletions(-)

diff --git a/visitor/README.md b/visitor/README.md
index c97e97120..75a032a47 100644
--- a/visitor/README.md
+++ b/visitor/README.md
@@ -9,13 +9,17 @@ tags:
 ---
 
 ## Intent
-Represent an operation to be performed on the elements of an object structure. Visitor lets you define a new operation without changing the classes of the elements on which it operates.
+
+Represent an operation to be performed on the elements of an object structure. Visitor lets you 
+define a new operation without changing the classes of the elements on which it operates.
 
 ## Explanation
 
 Real world example
 
-> Consider a tree structure with army units. Commander has two sergeants under it and each sergeant has three soldiers under them. Given that the hierarchy implements the visitor pattern, we can easily create new objects that interact with the commander, sergeants, soldiers or all of them. 
+> Consider a tree structure with army units. Commander has two sergeants under it and each sergeant 
+> has three soldiers under them. Given that the hierarchy implements the visitor pattern, we can 
+> easily create new objects that interact with the commander, sergeants, soldiers or all of them. 
 
 In plain words
 
@@ -23,7 +27,10 @@ In plain words
 
 Wikipedia says
 
-> In object-oriented programming and software engineering, the visitor design pattern is a way of separating an algorithm from an object structure on which it operates. A practical result of this separation is the ability to add new operations to existing object structures without modifying the structures.
+> In object-oriented programming and software engineering, the visitor design pattern is a way of 
+> separating an algorithm from an object structure on which it operates. A practical result of this 
+> separation is the ability to add new operations to existing object structures without modifying 
+> the structures.
 
 **Programmatic Example**
 
@@ -111,7 +118,7 @@ public class Soldier extends Unit {
 }
 ```
 
-And then some concrete visitors.
+Here are then some concrete visitors.
 
 ```java
 public class CommanderVisitor implements UnitVisitor {
@@ -175,32 +182,39 @@ public class SoldierVisitor implements UnitVisitor {
 }
 ```
 
-Finally we can show the power of visitors in action.
+Finally, we can show the power of visitors in action.
 
 ```java
 commander.accept(new SoldierVisitor());
-// Greetings soldier
-// Greetings soldier
-// Greetings soldier
-// Greetings soldier
-// Greetings soldier
-// Greetings soldier
 commander.accept(new SergeantVisitor());
-// Hello sergeant
-// Hello sergeant
 commander.accept(new CommanderVisitor());
-// Good to see you commander
+```
+
+Program output:
+
+```
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Hello sergeant
+Hello sergeant
+Good to see you commander
 ```
 
 ## Class diagram
+
 ![alt text](./etc/visitor_1.png "Visitor")
 
 ## Applicability
+
 Use the Visitor pattern when
 
-* An object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes
-* Many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them
-* The classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes
+* An object structure contains many classes of objects with differing interfaces, and you want to perform operations on these objects that depend on their concrete classes.
+* Many distinct and unrelated operations need to be performed on objects in an object structure, and you want to avoid "polluting" their classes with these operations. Visitor lets you keep related operations together by defining them in one class. When the object structure is shared by many applications, use Visitor to put operations in just those applications that need them.
+* The classes defining the object structure rarely change, but you often want to define new operations over the structure. Changing the object structure classes requires redefining the interface to all visitors, which is potentially costly. If the object structure classes change often, then it's probably better to define the operations in those classes.
 
 ## Real world examples
 

From ef43af3b2372026214512fa486c758ce98721567 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 18 Aug 2020 16:42:02 +0000
Subject: [PATCH 012/254] docs: update README.md [skip ci]

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 36094b1db..225f14709 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=alert_status)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-124-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-125-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -254,6 +254,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://xdvrx1.github.io/"><img src="https://avatars0.githubusercontent.com/u/47092464?v=4" width="100px;" alt=""/><br /><sub><b>xdvrx1</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Axdvrx1" title="Reviewed Pull Requests">👀</a> <a href="#ideas-xdvrx1" title="Ideas, Planning, & Feedback">🤔</a></td>
     <td align="center"><a href="http://subho.xyz"><img src="https://avatars0.githubusercontent.com/u/13291222?v=4" width="100px;" alt=""/><br /><sub><b>Subhrodip Mohanta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ohbus" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From 6c7715ace6b15cf010a4540b862d2b961c6e91c9 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 18 Aug 2020 16:42:03 +0000
Subject: [PATCH 013/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 6ea5a5de6..712ae41c2 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1130,6 +1130,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "nahteb",
+      "name": "Bethan Palmer",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/13121570?v=4",
+      "profile": "https://github.com/nahteb",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 847585334c4edea23aa675cc6b18c40db14982e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 18 Aug 2020 20:07:47 +0300
Subject: [PATCH 014/254] Update README.md

---
 unit-of-work/README.md | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/unit-of-work/README.md b/unit-of-work/README.md
index 590f718d3..01aa8e5d7 100644
--- a/unit-of-work/README.md
+++ b/unit-of-work/README.md
@@ -11,21 +11,27 @@ tags:
 ---
 
 ## Intent
-When a business transaction is completed, all the the updates are sent as one big unit of work to be persisted 
-in one go to minimize database round-trips. 
+
+When a business transaction is completed, all the the updates are sent as one big unit of work to be 
+persisted in one go to minimize database round-trips. 
 
 ## Explanation
+
 Real world example
 
-> We have a database containing student information. Administrators all over the country are constantly updating this information and it causes high load on the database server. To make the load more manageable we apply to Unit of Work pattern to send many small updates in batches.       
+> We have a database containing student information. Administrators all over the country are 
+> constantly updating this information and it causes high load on the database server. To make the 
+> load more manageable we apply to Unit of Work pattern to send many small updates in batches.       
 
 In plain words
 
-> Unit of Work merges many small database updates in single batch to optimize the number of round-trips. 
+> Unit of Work merges many small database updates in single batch to optimize the number of 
+> round-trips. 
 
 [MartinFowler.com](https://martinfowler.com/eaaCatalog/unitOfWork.html) says
 
-> Maintains a list of objects affected by a business transaction and coordinates the writing out of changes and the resolution of concurrency problems.
+> Maintains a list of objects affected by a business transaction and coordinates the writing out of 
+> changes and the resolution of concurrency problems.
 
 **Programmatic Example**
 
@@ -57,8 +63,9 @@ public class Student {
 }
 ```
 
-The essence of the implementation is the `StudentRepository` implementing the Unit of Work pattern. It maintains a map
-of database operations (`context`) that need to be done and when `commit` is called it applies them in single batch.
+The essence of the implementation is the `StudentRepository` implementing the Unit of Work pattern. 
+It maintains a map of database operations (`context`) that need to be done and when `commit` is 
+called it applies them in single batch.
 
 ```java
 public interface IUnitOfWork<T> {
@@ -160,7 +167,7 @@ public class StudentRepository implements IUnitOfWork<Student> {
 }
 ```
 
-Finally here's how we use the `StudentRepository` and `commit` the transaction.
+Finally, here's how we use the `StudentRepository` and `commit` the transaction.
 
 ```java
     studentRepository.registerNew(ram);
@@ -170,9 +177,11 @@ Finally here's how we use the `StudentRepository` and `commit` the transaction.
 ```
 
 ## Class diagram
+
 ![alt text](etc/unit-of-work.urm.png "unit-of-work")
 
 ## Applicability
+
 Use the Unit Of Work pattern when
 
 * To optimize the time taken for database transactions.

From 1e385056fc2a0ffefe15eab840bf250652bac2d7 Mon Sep 17 00:00:00 2001
From: Mike Liu <657829312@qq.com>
Date: Wed, 19 Aug 2020 17:10:14 +0800
Subject: [PATCH 015/254] finish translate adapter pattern into chinese

---
 zh/adapter/README.md | 138 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 138 insertions(+)
 create mode 100644 zh/adapter/README.md

diff --git a/zh/adapter/README.md b/zh/adapter/README.md
new file mode 100644
index 000000000..b00d757a6
--- /dev/null
+++ b/zh/adapter/README.md
@@ -0,0 +1,138 @@
+---
+layout: pattern
+title: Adapter
+folder: adapter
+permalink: /patterns/adapter/
+categories: Structural
+tags:
+ - Gang of Four
+---
+
+## 又被称为
+包装器
+
+## 目的
+将一个接口转换成另一个客户所期望的接口。适配器让那些本来因为接口不兼容的类可以合作无间。
+
+## 解释
+
+现实世界例子
+
+> 考虑有这么一种情况，在你的存储卡中有一些照片，你想将其传到你的电脑中。为了传送数据，你需要某种能够兼容你电脑接口的适配器以便你的储存卡能连上你的电脑。在这种情况下，读卡器就是一个适配器。
+> 另一个例子就是注明的电源适配器；三脚插头不能插在两脚插座上，需要一个电源适配器来使其能够插在两脚插座上。
+> 还有一个例子就是翻译官，他翻译一个人对另一个人说的话。
+
+用直白的话来说
+
+> 适配器模式让你可以把不兼容的对象包在适配器中，以让其兼容其他类。
+
+维基百科中说
+
+> 在软件工程中，适配器模式是一种可以让现有类的接口把其作为其他接口来使用的设计模式。它经常用来使现有的类和其他类能够工作并且不用修改其他类的源代码。
+
+**编程样例(对象适配器)**
+
+假如有一个船长他只会划船，但不会航行。
+
+首先我们有接口`RowingBoat`和`FishingBoat`
+
+```java
+public interface RowingBoat {
+  void row();
+}
+
+public class FishingBoat {
+  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class);
+  public void sail() {
+    LOGGER.info("The fishing boat is sailing");
+  }
+}
+```
+船长希望有一个`RowingBoat`接口的实现，这样就可以移动
+
+```java
+public class Captain {
+
+  private final RowingBoat rowingBoat;
+  // default constructor and setter for rowingBoat
+  public Captain(RowingBoat rowingBoat) {
+    this.rowingBoat = rowingBoat;
+  }
+
+  public void row() {
+    rowingBoat.row();
+  }
+}
+```
+
+现在海盗来了，我们的船长需要逃跑但是只有一个渔船可用。我们需要创建一个可以让船长使用其划船技能来操作渔船的适配器。
+
+```java
+public class FishingBoatAdapter implements RowingBoat {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoatAdapter.class);
+
+  private final FishingBoat boat;
+
+  public FishingBoatAdapter() {
+    boat = new FishingBoat();
+  }
+
+  @Override
+  public void row() {
+    boat.sail();
+  }
+}
+
+```
+
+现在 `船长` 可以使用`FishingBoat`接口来逃离海盗了。
+
+```java
+var captain = new Captain(new FishingBoatAdapter());
+captain.row();
+```
+
+## 类图
+![alt text](../../adapter/etc/adapter.urm.png "Adapter class diagram")
+
+
+## 应用
+使用适配器模式当
+
+* 你想使用一个已有类，但是它的接口不能和你需要的所匹配
+* 你需要创建一个可重用类，该类与不相关或不可预见的类进行协作，即不一定具有兼容接口的类
+* 你需要使用一些现有的子类，但是子类化他们每一个的子类来进行接口的适配是不现实的。一个对象适配器可以适配他们父类的接口。
+* 大多数使用第三方类库的应用使用适配器作为一个在应用和第三方类库间的中间层来使应用和类库解耦。如果必须使用另一个库，则只需使用一个新库的适配器而无需改变应用程序的代码。
+
+## 后果:
+类和对象适配器有不同的权衡取舍。一个类适配器
+
+*	适配被适配者到目标接口，需要保证只有一个具体的被适配者类。作为结果，当我们想适配一个类和它所有的子类时，类适配器将不会起作用。
+*	可以让适配器重写一些被适配者的行为，因为适配器是被适配者的子类。
+*	只引入了一个对象，并且不需要其他指针间接访问被适配者。
+
+对象适配器	
+
+*	一个适配器可以和许多被适配者工作，也就是被适配者自己和所有它的子类。适配器同时可以为所有被适配者添加功能。
+*	覆盖被适配者的行为变得更难。需要子类化被适配者然后让适配器引用这个子类不是被适配者。
+
+
+## 现实世界的案例
+
+* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29)
+* [java.util.Collections#list()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#list-java.util.Enumeration-)
+* [java.util.Collections#enumeration()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#enumeration-java.util.Collection-)
+* [javax.xml.bind.annotation.adapters.XMLAdapter](http://docs.oracle.com/javase/8/docs/api/javax/xml/bind/annotation/adapters/XmlAdapter.html#marshal-BoundType-)
+
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
+
+```
+
+```
\ No newline at end of file

From 6921b0dce0b503529a6bd8983bde91279487522c Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Wed, 19 Aug 2020 13:27:08 +0400
Subject: [PATCH 016/254] Fixed checkstyle errors causing build failures.

---
 .../iluwatar/ambassador/RemoteService.java    |   3 +-
 .../ambassador/RemoteServiceStatus.java       |  47 ++++--
 .../com/iluwatar/commander/Commander.java     | 138 +++++++++---------
 .../component/manager/AiComponentManager.java |   8 +-
 .../manager/PhysicsComponentManager.java      |   8 +-
 .../manager/RenderComponentManager.java       |   8 +-
 unit-of-work/pom.xml                          |   1 +
 .../java/com/iluwatar/unitofwork/App.java     |   1 +
 .../com/iluwatar/unitofwork/UnitActions.java  |  44 ++++--
 .../java/com/iluwatar/unitofwork/AppTest.java |   1 +
 10 files changed, 151 insertions(+), 108 deletions(-)

diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
index 42b09d617..e2877b683 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
@@ -74,6 +74,7 @@ public class RemoteService implements RemoteServiceInterface {
     } catch (InterruptedException e) {
       LOGGER.error("Thread sleep state interrupted", e);
     }
-    return waitTime <= THRESHOLD ? value * 10 : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();
+    return waitTime <= THRESHOLD ? value * 10
+            : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();
   }
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
index f9faebd0e..5d830e0fc 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
@@ -1,23 +1,48 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.ambassador;
 
 /**
  * Holds information regarding the status of the Remote Service.
  *
- * !Attention - This Enum replaces the integer value previously stored in {@link RemoteServiceInterface}
- * as SonarCloud was identifying it as an issue. All test cases have been checked after changes, without failures.
+ * <p> This Enum replaces the integer value previously
+ * stored in {@link RemoteServiceInterface} as SonarCloud was identifying
+ * it as an issue. All test cases have been checked after changes,
+ * without failures. </p>
  */
 
 public enum RemoteServiceStatus {
-    FAILURE(-1)
-    ;
+  FAILURE(-1)
+  ;
 
-    private final long remoteServiceStatusValue;
+  private final long remoteServiceStatusValue;
 
-    RemoteServiceStatus(long remoteServiceStatusValue) {
-        this.remoteServiceStatusValue = remoteServiceStatusValue;
-    }
+  RemoteServiceStatus(long remoteServiceStatusValue) {
+    this.remoteServiceStatusValue = remoteServiceStatusValue;
+  }
 
-    public long getRemoteServiceStatusValue() {
-        return remoteServiceStatusValue;
-    }
+  public long getRemoteServiceStatusValue() {
+    return remoteServiceStatusValue;
+  }
 }
diff --git a/commander/src/main/java/com/iluwatar/commander/Commander.java b/commander/src/main/java/com/iluwatar/commander/Commander.java
index c2e124663..2909f9304 100644
--- a/commander/src/main/java/com/iluwatar/commander/Commander.java
+++ b/commander/src/main/java/com/iluwatar/commander/Commander.java
@@ -36,10 +36,10 @@ import com.iluwatar.commander.queue.QueueDatabase;
 import com.iluwatar.commander.queue.QueueTask;
 import com.iluwatar.commander.queue.QueueTask.TaskType;
 import com.iluwatar.commander.shippingservice.ShippingService;
+import java.util.List;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import java.util.List;
 
 /**
  * <p>Commander pattern is used to handle all issues that can come up while making a
@@ -171,10 +171,53 @@ public class Commander {
     var list = paymentService.exceptionsList;
     var t = new Thread(() -> {
       Retry.Operation op = (l) -> {
-        handlePaymentRetryOperation(order, l);
+        if (!l.isEmpty()) {
+          if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
+            LOG.debug("Order " + order.id + ": Error in connecting to payment service,"
+                    + " trying again..");
+          } else {
+            LOG.debug("Order " + order.id + ": Error in creating payment request..");
+          }
+          throw l.remove(0);
+        }
+        if (order.paid.equals(PaymentStatus.TRYING)) {
+          var transactionId = paymentService.receiveRequest(order.price);
+          order.paid = PaymentStatus.DONE;
+          LOG.info("Order " + order.id + ": Payment successful, transaction Id: " + transactionId);
+          if (!finalSiteMsgShown) {
+            LOG.info("Payment made successfully, thank you for shopping with us!!");
+            finalSiteMsgShown = true;
+          }
+          sendSuccessMessage(order);
+        }
       };
       Retry.HandleErrorIssue<Order> handleError = (o, err) -> {
-        handlePaymentErrorIssue(order, o, err);
+        if (PaymentDetailsErrorException.class.isAssignableFrom(err.getClass())) {
+          if (!finalSiteMsgShown) {
+            LOG.info("There was an error in payment. Your account/card details "
+                    + "may have been incorrect. "
+                    + "Meanwhile, your order has been converted to COD and will be shipped.");
+            finalSiteMsgShown = true;
+          }
+          LOG.error("Order " + order.id + ": Payment details incorrect, failed..");
+          o.paid = PaymentStatus.NOT_DONE;
+          sendPaymentFailureMessage(o);
+        } else {
+          if (o.messageSent.equals(MessageSent.NONE_SENT)) {
+            if (!finalSiteMsgShown) {
+              LOG.info("There was an error in payment. We are on it, and will get back to you "
+                      + "asap. Don't worry, your order has been placed and will be shipped.");
+              finalSiteMsgShown = true;
+            }
+            LOG.warn("Order " + order.id + ": Payment error, going to queue..");
+            sendPaymentPossibleErrorMsg(o);
+          }
+          if (o.paid.equals(PaymentStatus.TRYING) && System
+                  .currentTimeMillis() - o.createdTime < paymentTime) {
+            var qt = new QueueTask(o, TaskType.PAYMENT, -1);
+            updateQueue(qt);
+          }
+        }
       };
       var r = new Retry<>(op, handleError, numOfRetries, retryDuration,
           e -> DatabaseUnavailableException.class.isAssignableFrom(e.getClass()));
@@ -187,58 +230,6 @@ public class Commander {
     t.start();
   }
 
-  private void handlePaymentRetryOperation(Order order, List<Exception> l) throws Exception {
-    if (!l.isEmpty()) {
-      if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
-        LOG.debug("Order " + order.id + ": Error in connecting to payment service,"
-            + " trying again..");
-      } else {
-        LOG.debug("Order " + order.id + ": Error in creating payment request..");
-      }
-      throw l.remove(0);
-    }
-    if (order.paid.equals(PaymentStatus.TRYING)) {
-      var transactionId = paymentService.receiveRequest(order.price);
-      order.paid = PaymentStatus.DONE;
-      LOG.info("Order " + order.id + ": Payment successful, transaction Id: " + transactionId);
-
-      if (!finalSiteMsgShown) {
-        LOG.info("Payment made successfully, thank you for shopping with us!!");
-        finalSiteMsgShown = true;
-      }
-      sendSuccessMessage(order);
-    }
-  }
-
-  private void handlePaymentErrorIssue(Order order, Order o, Exception err) {
-    if (PaymentDetailsErrorException.class.isAssignableFrom(err.getClass())) {
-      if (!finalSiteMsgShown) {
-        LOG.info("There was an error in payment. Your account/card details "
-            + "may have been incorrect. "
-            + "Meanwhile, your order has been converted to COD and will be shipped.");
-        finalSiteMsgShown = true;
-      }
-      LOG.error("Order " + order.id + ": Payment details incorrect, failed..");
-      o.paid = PaymentStatus.NOT_DONE;
-      sendPaymentFailureMessage(o);
-    } else {
-      if (o.messageSent.equals(MessageSent.NONE_SENT)) {
-        if (!finalSiteMsgShown) {
-          LOG.info("There was an error in payment. We are on it, and will get back to you "
-              + "asap. Don't worry, your order has been placed and will be shipped.");
-          finalSiteMsgShown = true;
-        }
-        LOG.warn("Order " + order.id + ": Payment error, going to queue..");
-        sendPaymentPossibleErrorMsg(o);
-      }
-      if (o.paid.equals(PaymentStatus.TRYING) && System
-          .currentTimeMillis() - o.createdTime < paymentTime) {
-        var qt = new QueueTask(o, TaskType.PAYMENT, -1);
-        updateQueue(qt);
-      }
-    }
-  }
-
   private void updateQueue(QueueTask qt) {
     if (System.currentTimeMillis() - qt.order.createdTime >= this.queueTime) {
       // since payment time is lesser than queuetime it would have already failed..
@@ -371,24 +362,24 @@ public class Commander {
 
   private Retry.Operation handleSuccessMessageRetryOperation(Order order) {
     return (l) -> {
-        if (!l.isEmpty()) {
-          if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
-            LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
-                + "(Payment Success msg), trying again..");
-          } else {
-            LOG.debug("Order " + order.id + ": Error in creating Payment Success"
-                + " messaging request..");
-          }
-          throw l.remove(0);
+      if (!l.isEmpty()) {
+        if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
+          LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
+              + "(Payment Success msg), trying again..");
+        } else {
+          LOG.debug("Order " + order.id + ": Error in creating Payment Success"
+              + " messaging request..");
         }
-        if (!order.messageSent.equals(MessageSent.PAYMENT_FAIL)
-            && !order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL)) {
-          var requestId = messagingService.receiveRequest(2);
-          order.messageSent = MessageSent.PAYMENT_SUCCESSFUL;
-          LOG.info("Order " + order.id + ": Payment Success message sent,"
-              + " request Id: " + requestId);
-        }
-      };
+        throw l.remove(0);
+      }
+      if (!order.messageSent.equals(MessageSent.PAYMENT_FAIL)
+          && !order.messageSent.equals(MessageSent.PAYMENT_SUCCESSFUL)) {
+        var requestId = messagingService.receiveRequest(2);
+        order.messageSent = MessageSent.PAYMENT_SUCCESSFUL;
+        LOG.info("Order " + order.id + ": Payment Success message sent,"
+            + " request Id: " + requestId);
+      }
+    };
   }
 
   private void sendPaymentFailureMessage(Order order) {
@@ -483,7 +474,8 @@ public class Commander {
     }
   }
 
-  private void handlePaymentPossibleErrorMsgRetryOperation(Order order, List<Exception> l) throws Exception {
+  private void handlePaymentPossibleErrorMsgRetryOperation(Order order, List<Exception> l)
+          throws Exception {
     if (!l.isEmpty()) {
       if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
         LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
index 1baf99a3a..c85bd1e68 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
@@ -40,7 +40,7 @@ public class AiComponentManager {
 
   private final int numEntities;
 
-  private final Component[] AI_COMPONENTS = new AiComponent[MAX_ENTITIES];
+  private final Component[] aiComponents = new AiComponent[MAX_ENTITIES];
 
   public AiComponentManager(int numEntities) {
     this.numEntities = numEntities;
@@ -51,7 +51,7 @@ public class AiComponentManager {
    */
   public void start() {
     LOGGER.info("Start AI Game Component");
-    IntStream.range(0, numEntities).forEach(i -> AI_COMPONENTS[i] = new AiComponent());
+    IntStream.range(0, numEntities).forEach(i -> aiComponents[i] = new AiComponent());
   }
 
   /**
@@ -60,7 +60,7 @@ public class AiComponentManager {
   public void update() {
     LOGGER.info("Update AI Game Component");
     IntStream.range(0, numEntities)
-        .filter(i -> AI_COMPONENTS.length > i && AI_COMPONENTS[i] != null)
-        .forEach(i -> AI_COMPONENTS[i].update());
+        .filter(i -> aiComponents.length > i && aiComponents[i] != null)
+        .forEach(i -> aiComponents[i].update());
   }
 }
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
index e5917979c..155793c88 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
@@ -40,7 +40,7 @@ public class PhysicsComponentManager {
 
   private final int numEntities;
 
-  private final Component[] PHYSICS_COMPONENTS = new PhysicsComponent[MAX_ENTITIES];
+  private final Component[] physicsComponents = new PhysicsComponent[MAX_ENTITIES];
 
   public PhysicsComponentManager(int numEntities) {
     this.numEntities = numEntities;
@@ -51,7 +51,7 @@ public class PhysicsComponentManager {
    */
   public void start() {
     LOGGER.info("Start Physics Game Component ");
-    IntStream.range(0, numEntities).forEach(i -> PHYSICS_COMPONENTS[i] = new PhysicsComponent());
+    IntStream.range(0, numEntities).forEach(i -> physicsComponents[i] = new PhysicsComponent());
   }
 
 
@@ -62,7 +62,7 @@ public class PhysicsComponentManager {
     LOGGER.info("Update Physics Game Component ");
     // Process physics.
     IntStream.range(0, numEntities)
-        .filter(i -> PHYSICS_COMPONENTS.length > i && PHYSICS_COMPONENTS[i] != null)
-        .forEach(i -> PHYSICS_COMPONENTS[i].update());
+        .filter(i -> physicsComponents.length > i && physicsComponents[i] != null)
+        .forEach(i -> physicsComponents[i].update());
   }
 }
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
index b3522f908..be1d3c2e9 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
@@ -40,7 +40,7 @@ public class RenderComponentManager {
 
   private final int numEntities;
 
-  private final Component[] RENDER_COMPONENTS = new RenderComponent[MAX_ENTITIES];
+  private final Component[] renderComponents = new RenderComponent[MAX_ENTITIES];
 
   public RenderComponentManager(int numEntities) {
     this.numEntities = numEntities;
@@ -51,7 +51,7 @@ public class RenderComponentManager {
    */
   public void start() {
     LOGGER.info("Start Render Game Component ");
-    IntStream.range(0, numEntities).forEach(i -> RENDER_COMPONENTS[i] = new RenderComponent());
+    IntStream.range(0, numEntities).forEach(i -> renderComponents[i] = new RenderComponent());
   }
 
 
@@ -62,7 +62,7 @@ public class RenderComponentManager {
     LOGGER.info("Update Render Game Component ");
     // Process Render.
     IntStream.range(0, numEntities)
-        .filter(i -> RENDER_COMPONENTS.length > i && RENDER_COMPONENTS[i] != null)
-        .forEach(i -> RENDER_COMPONENTS[i].render());
+        .filter(i -> renderComponents.length > i && renderComponents[i] != null)
+        .forEach(i -> renderComponents[i].render());
   }
 }
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index 1fab10186..0f8f0b21a 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -47,6 +47,7 @@
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.0.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
index a9e41dd7c..6caf1de49 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
@@ -35,6 +35,7 @@ public class App {
    *
    * @param args no argument sent
    */
+
   public static void main(String[] args) {
     var ram = new Student(1, "Ram", "Street 9, Cupertino");
     var shyam = new Student(2, "Shyam", "Z bridge, Pune");
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
index b00d015a3..36e738626 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
@@ -1,18 +1,40 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.unitofwork;
 
 public enum UnitActions {
-    INSERT("INSERT"),
-    DELETE("DELETE"),
-    MODIFY("MODIFY")
-    ;
+  INSERT("INSERT"),
+  DELETE("DELETE"),
+  MODIFY("MODIFY");
 
-    private final String actionValue;
+  private final String actionValue;
 
-    UnitActions(String actionValue) {
-        this.actionValue = actionValue;
-    }
+  UnitActions(String actionValue) {
+    this.actionValue = actionValue;
+  }
 
-    public String getActionValue() {
-        return actionValue;
-    }
+  public String getActionValue() {
+    return actionValue;
+  }
 }
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
index 2fbe37ccf..630bb1392 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
@@ -31,6 +31,7 @@ import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
  * AppTest
  */
 public class AppTest {
+
   @Test
   public void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));

From 860453b46b73d7e977196a28439f1c4b4dca3c64 Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Wed, 19 Aug 2020 23:14:37 +0400
Subject: [PATCH 017/254] Fixed JUnit tests causing build issues due to mixing
 JUnit 4 & JUnit 5

---
 .../java/org/dirty/flag/DirtyFlagTest.java    | 14 +++----
 partial-response/pom.xml                      | 14 +++----
 .../com/iluwatar/partialresponse/AppTest.java | 11 +++---
 .../partialresponse/FieldJsonMapperTest.java  | 19 +++++----
 .../partialresponse/VideoResourceTest.java    | 39 +++++++++----------
 pom.xml                                       |  7 ++++
 6 files changed, 52 insertions(+), 52 deletions(-)

diff --git a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
index 6a3274a45..d0c9079a6 100644
--- a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
+++ b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
@@ -23,29 +23,27 @@
 
 package org.dirty.flag;
 
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
 import com.iluwatar.dirtyflag.DataFetcher;
+import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
 /**
  * Application test
  */
-public class DirtyFlagTest {
+class DirtyFlagTest {
 
   @Test
-  public void testIsDirty() {
+  void testIsDirty() {
     var df = new DataFetcher();
     var countries = df.fetch();
-    assertFalse(countries.isEmpty());
+    Assertions.assertTrue(countries.isEmpty());
   }
 
   @Test
-  public void testIsNotDirty() {
+  void testIsNotDirty() {
     var df = new DataFetcher();
     df.fetch();
     var countries = df.fetch();
-    assertTrue(countries.isEmpty());
+    Assertions.assertTrue(countries.isEmpty());
   }
 }
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index eb094874f..fad5450d9 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -35,13 +35,15 @@
 
     <artifactId>partial-response</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
         <dependency>
             <groupId>org.junit.vintage</groupId>
             <artifactId>junit-vintage-engine</artifactId>
+            <version>5.4.0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.mockito</groupId>
+            <artifactId>mockito-junit-jupiter</artifactId>
             <scope>test</scope>
         </dependency>
         <dependency>
@@ -49,10 +51,6 @@
             <artifactId>junit-jupiter-engine</artifactId>
             <scope>test</scope>
         </dependency>
-        <dependency>
-            <groupId>org.mockito</groupId>
-            <artifactId>mockito-core</artifactId>
-        </dependency>
     </dependencies>
     <build>
         <plugins>
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
index b00ee6861..c423355f5 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
@@ -23,18 +23,17 @@
 
 package com.iluwatar.partialresponse;
 
-import org.junit.Test;
-
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.Assertions;
 
 /**
  * Application test
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
-    assertDoesNotThrow(() -> App.main(new String[]{}));
+  void shouldExecuteApplicationWithoutException() {
+    Assertions.assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
 }
\ No newline at end of file
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
index 57741c1d7..6bf5bf190 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
@@ -23,24 +23,23 @@
 
 package com.iluwatar.partialresponse;
 
-import static org.junit.Assert.assertEquals;
-
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
 
 /**
  * tests {@link FieldJsonMapper}.
  */
-public class FieldJsonMapperTest {
-  private FieldJsonMapper mapper;
+class FieldJsonMapperTest {
+  private static FieldJsonMapper mapper;
 
-  @Before
-  public void setUp() {
+  @BeforeAll
+  static void setUp() {
     mapper = new FieldJsonMapper();
   }
 
   @Test
-  public void shouldReturnJsonForSpecifiedFieldsInVideo() throws Exception {
+  void shouldReturnJsonForSpecifiedFieldsInVideo() throws Exception {
     var fields = new String[]{"id", "title", "length"};
     var video = new Video(
         2, "Godzilla Resurgence", 120,
@@ -50,6 +49,6 @@ public class FieldJsonMapperTest {
     var jsonFieldResponse = mapper.toJson(video, fields);
 
     var expectedDetails = "{\"id\": 2,\"title\": \"Godzilla Resurgence\",\"length\": 120}";
-    assertEquals(expectedDetails, jsonFieldResponse);
+    Assertions.assertEquals(expectedDetails, jsonFieldResponse);
   }
 }
\ No newline at end of file
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
index 252499803..dbd8e78dd 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
@@ -23,30 +23,29 @@
 
 package com.iluwatar.partialresponse;
 
-import static org.junit.Assert.assertEquals;
-import static org.mockito.Matchers.any;
-import static org.mockito.Matchers.eq;
-import static org.mockito.Mockito.when;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Matchers;
+import org.mockito.Mock;
+import org.mockito.Mockito;
+import org.mockito.junit.jupiter.MockitoExtension;
 
 import java.util.Map;
-import org.junit.Before;
-import org.junit.Test;
-import org.junit.runner.RunWith;
-import org.mockito.Mock;
-import org.mockito.runners.MockitoJUnitRunner;
 
 /**
  * tests {@link VideoResource}.
  */
-@RunWith(MockitoJUnitRunner.class)
-public class VideoResourceTest {
+@ExtendWith(MockitoExtension.class)
+class VideoResourceTest {
   @Mock
-  private FieldJsonMapper fieldJsonMapper;
+  private static FieldJsonMapper fieldJsonMapper;
 
-  private VideoResource resource;
+  private static VideoResource resource;
 
-  @Before
-  public void setUp() {
+  @BeforeAll
+  static void setUp() {
     var videos = Map.of(
         1, new Video(1, "Avatar", 178, "epic science fiction film",
             "James Cameron", "English"),
@@ -58,23 +57,23 @@ public class VideoResourceTest {
   }
 
   @Test
-  public void shouldGiveVideoDetailsById() throws Exception {
+  void shouldGiveVideoDetailsById() throws Exception {
     var actualDetails = resource.getDetails(1);
 
     var expectedDetails = "{\"id\": 1,\"title\": \"Avatar\",\"length\": 178,\"description\": "
         + "\"epic science fiction film\",\"director\": \"James Cameron\",\"language\": \"English\",}";
-    assertEquals(expectedDetails, actualDetails);
+    Assertions.assertEquals(expectedDetails, actualDetails);
   }
 
   @Test
-  public void shouldGiveSpecifiedFieldsInformationOfVideo() throws Exception {
+  void shouldGiveSpecifiedFieldsInformationOfVideo() throws Exception {
     var fields = new String[]{"id", "title", "length"};
 
     var expectedDetails = "{\"id\": 1,\"title\": \"Avatar\",\"length\": 178}";
-    when(fieldJsonMapper.toJson(any(Video.class), eq(fields))).thenReturn(expectedDetails);
+    Mockito.when(fieldJsonMapper.toJson(Matchers.any(Video.class), Matchers.eq(fields))).thenReturn(expectedDetails);
 
     var actualFieldsDetails = resource.getDetails(2, fields);
 
-    assertEquals(expectedDetails, actualFieldsDetails);
+    Assertions.assertEquals(expectedDetails, actualFieldsDetails);
   }
 }
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 9b3382795..e917304a8 100644
--- a/pom.xml
+++ b/pom.xml
@@ -54,6 +54,7 @@
         <annotation-api.version>1.3.2</annotation-api.version>
         <system-rules.version>1.19.0</system-rules.version>
         <urm.version>1.4.8</urm.version>
+        <mockito-junit-jupiter.version>3.5.0</mockito-junit-jupiter.version>
         <!-- SonarCloud -->
         <sonar.host.url>https://sonarcloud.io</sonar.host.url>
         <sonar.organization>iluwatar</sonar.organization>
@@ -226,6 +227,12 @@
                 <artifactId>spring-webmvc</artifactId>
                 <version>${spring.version}</version>
             </dependency>
+            <dependency>
+                <groupId>org.mockito</groupId>
+                <artifactId>mockito-junit-jupiter</artifactId>
+                <version>${mockito-junit-jupiter.version}</version>
+                <scope>test</scope>
+            </dependency>
             <dependency>
                 <groupId>com.h2database</groupId>
                 <artifactId>h2</artifactId>

From c35b98b4d74a17211850c42cf507bdd49eb39769 Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Thu, 20 Aug 2020 01:01:03 +0400
Subject: [PATCH 018/254] Fixed pom.xml issues within the dirty-flag and
 partial-response modules that were causing build failures.

---
 dirty-flag/pom.xml       | 7 ++++++-
 partial-response/pom.xml | 1 +
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/dirty-flag/pom.xml b/dirty-flag/pom.xml
index c014cd41e..372a637f1 100644
--- a/dirty-flag/pom.xml
+++ b/dirty-flag/pom.xml
@@ -31,7 +31,6 @@
     <artifactId>java-design-patterns</artifactId>
     <version>1.23.0-SNAPSHOT</version>
   </parent>
-  <groupId>com.iluwatar</groupId>
   <artifactId>dirty-flag</artifactId>
   <version>1.23.0-SNAPSHOT</version>
   <name>dirty-flag</name>
@@ -45,6 +44,12 @@
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-junit-jupiter</artifactId>
+      <version>3.5.0</version>
+      <scope>test</scope>
+    </dependency>
   </dependencies>
   <build>
     <plugins>
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index fad5450d9..d10a496dd 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -44,6 +44,7 @@
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-junit-jupiter</artifactId>
+            <version>3.5.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>

From 885c8a6765b37f3a403b63b993d1996ae2a31e1b Mon Sep 17 00:00:00 2001
From: Toxic Dreamz <Toxic_Dreamz@outlook.com>
Date: Thu, 20 Aug 2020 01:21:03 +0400
Subject: [PATCH 019/254] Fixed a test-case issue within the dirty-flag module.

---
 dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
index d0c9079a6..9af9664d6 100644
--- a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
+++ b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
@@ -36,7 +36,7 @@ class DirtyFlagTest {
   void testIsDirty() {
     var df = new DataFetcher();
     var countries = df.fetch();
-    Assertions.assertTrue(countries.isEmpty());
+    Assertions.assertFalse(countries.isEmpty());
   }
 
   @Test

From 905b5dc6d86d0e346d6336a2c4e7dcea9e622a71 Mon Sep 17 00:00:00 2001
From: Michal Krzywanski <outcast1231@wp.pl>
Date: Fri, 21 Aug 2020 11:07:23 +0200
Subject: [PATCH 020/254] Implemented filterer pattern

---
 filterer/README.MD                            |  45 ++++++
 filterer/etc/filterer.png                     | Bin 0 -> 141773 bytes
 filterer/etc/filterer.urm.puml                | 132 ++++++++++++++++++
 filterer/pom.xml                              |  76 ++++++++++
 .../iluwatar/filterer/domain/Filterer.java    |  36 +++++
 .../com/iluwatar/filterer/issue/Issue.java    |  49 +++++++
 .../filterer/issue/IssueAwareText.java        |  55 ++++++++
 .../filterer/issue/IssuePosition.java         |  76 ++++++++++
 .../iluwatar/filterer/issue/IssueType.java    |  26 ++++
 .../issue/ProbabilisticIssueAwareText.java    |  49 +++++++
 .../filterer/issue/ProbableIssue.java         |  35 +++++
 .../iluwatar/filterer/issue/SimpleIssue.java  |  79 +++++++++++
 .../filterer/issue/SimpleIssueAwareText.java  |  98 +++++++++++++
 .../SimpleProbabilisticIssueAwareText.java    | 101 ++++++++++++++
 .../filterer/issue/SimpleProbableIssue.java   |  70 ++++++++++
 .../issue/SimpleIssueAwareTextTest.java       |  52 +++++++
 ...SimpleProbabilisticIssueAwareTextTest.java |  52 +++++++
 pom.xml                                       |   1 +
 18 files changed, 1032 insertions(+)
 create mode 100644 filterer/README.MD
 create mode 100644 filterer/etc/filterer.png
 create mode 100644 filterer/etc/filterer.urm.puml
 create mode 100644 filterer/pom.xml
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java
 create mode 100644 filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java
 create mode 100644 filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java

diff --git a/filterer/README.MD b/filterer/README.MD
new file mode 100644
index 000000000..8a2526048
--- /dev/null
+++ b/filterer/README.MD
@@ -0,0 +1,45 @@
+--- # this is so called 'Yaml Front Matter', read up on it here: http://jekyllrb.com/docs/frontmatter/
+layout: pattern
+title: Filterer Pattern
+folder: filterer
+permalink: /patterns/filterer/
+description: Design pattern that helps container-like objects to return filtered version of themselves.# short meta description that shows in Google search results
+categories:
+ - Functional
+tags:
+ - Extensibility
+---
+
+## Name / classification
+Filterer Pattern
+
+## Intent
+The intent of this design pattern is to to introduce a functional interface that will add a functionality for container-like objects to easily return filtered versions of themselves.
+
+## Explanation
+The container-like object needs to have a method that returns an instance of `Filterer`. This helper interface gives 
+ability to covariantly specify a lower bound of contravariant `Predicate` in the subinterfaces of interfaces representing the container-like objects.
+
+## Class diagram
+![Filterer](./etc/filterer.png "Filterer")
+
+## Applicability
+Pattern can be used when working with container-like objects that use subtyping, instead of parametrizing(generics) for extensible class structure.
+It enables you to easily extend filtering ability of container-like objects as business requirements change.
+
+## Tutorials
+* [Article about Filterer pattern posted on it's author's blog](https://blog.tlinkowski.pl/2018/filterer-pattern/)
+* [Application of Filterer pattern in domain of text analysis](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html)
+
+## Known uses
+One of the uses is present on the blog presented in this link. It presents how to use `Filterer` pattern to create text issue anaylyzer with support for test cases used for unit testing.
+
+## Consequences (the good and the bad, add criticism here)
+Good :
+ * you can easily introduce new subtypes for container-like objects and subtypes for objects that are contained within them and still be able to filter easily be new properties of those new subtypes.
+
+Bad :
+ * covariant return types mixed with generics can be sometimes tricky
+
+## Credits
+* Author of the pattern : [Tomasz Linkowski](https://tlinkowski.pl/)
\ No newline at end of file
diff --git a/filterer/etc/filterer.png b/filterer/etc/filterer.png
new file mode 100644
index 0000000000000000000000000000000000000000..f86764aa32aa18b063105c8ab529c2d04747326c
GIT binary patch
literal 141773
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%0ALv#igQ8NZ|3?qHU^qD?G%J=d~i5NG+tY
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

literal 0
HcmV?d00001

diff --git a/filterer/etc/filterer.urm.puml b/filterer/etc/filterer.urm.puml
new file mode 100644
index 000000000..24060b6aa
--- /dev/null
+++ b/filterer/etc/filterer.urm.puml
@@ -0,0 +1,132 @@
+@startuml
+package com.iluwatar.filterer.domain {
+  interface Filterer<G, E> {
+    + by(Predicate<? super E>) : G {abstract}
+  }
+}
+package com.iluwatar.filterer.issue {
+  interface Issue {
+    + endOffset() : int {abstract}
+    + startOffset() : int {abstract}
+    + type() : IssueType {abstract}
+  }
+  interface IssueAwareText {
+    + filtered() : Filterer<? extends IssueAwareText, ? extends Issue> {abstract}
+    + issues() : List<? extends Issue> {abstract}
+    + text() : String {abstract}
+  }
+  class IssuePosition {
+    - endOffset : int
+    - startOffset : int
+    - IssuePosition(startOffset : int, endOffset : int)
+    ~ endOffset() : int
+    + equals(o : Object) : boolean
+    + hashCode() : int
+    + of(startOffset : int, endOffset : int) : IssuePosition {static}
+    ~ startOffset() : int
+  }
+  ~enum IssueType {
+    + GRAMMAR {static}
+    + SPELLING {static}
+    + valueOf(name : String) : IssueType {static}
+    + values() : IssueType[] {static}
+  }
+  interface IssueWiseText {
+    + filtered() : Filterer<? extends IssueWiseText, ? extends Issue> {abstract}
+    + issues() : List<? extends Issue> {abstract}
+    + text() : String {abstract}
+  }
+  interface ProbabilisticIssueAwareText {
+    + filtered() : Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> {abstract}
+    + issues() : List<? extends ProbableIssue> {abstract}
+  }
+  interface ProbabilisticIssueWiseText {
+    + filtered() : Filterer<? extends ProbabilisticIssueWiseText, ? extends ProbableIssue> {abstract}
+    + issues() : List<? extends ProbableIssue> {abstract}
+  }
+  interface ProbableIssue {
+    + probability() : double {abstract}
+  }
+  class SimpleIssue {
+    - issuePosition : IssuePosition
+    - issueType : IssueType
+    ~ SimpleIssue(issuePosition : IssuePosition, issueType : IssueType)
+    + endOffset() : int
+    + equals(o : Object) : boolean
+    + hashCode() : int
+    + startOffset() : int
+    + type() : IssueType
+  }
+  class SimpleIssueAwareText {
+    - issues : ImmutableList<Issue>
+    - text : String
+    ~ SimpleIssueAwareText(text : String, issues : List<Issue>)
+    + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends IssueAwareText, ? extends Issue>
+    - filteredGroup(predicate : Predicate<? super Issue>) : IssueAwareText
+    - filteredItems(predicate : Predicate<? super Issue>) : ImmutableList<Issue>
+    + hashCode() : int
+    + issues() : List<? extends Issue>
+    + text() : String
+  }
+  class SimpleIssueWiseText {
+    - issues : ImmutableList<Issue>
+    - text : String
+    + SimpleIssueWiseText(text : String, issues : List<Issue>)
+    + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends IssueWiseText, ? extends Issue>
+    - filteredGroup(predicate : Predicate<? super Issue>) : IssueWiseText
+    - filteredItems(predicate : Predicate<? super Issue>) : ImmutableList<Issue>
+    + hashCode() : int
+    + issues() : List<? extends Issue>
+    + text() : String
+  }
+  class SimpleProbabilisticIssueAwareText {
+    - issues : ImmutableList<ProbableIssue>
+    - text : String
+    ~ SimpleProbabilisticIssueAwareText(text : String, issues : List<ProbableIssue>)
+    + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue>
+    - filteredGroup(predicate : Predicate<? super ProbableIssue>) : ProbabilisticIssueAwareText
+    - filteredItems(predicate : Predicate<? super ProbableIssue>) : ImmutableList<ProbableIssue>
+    + hashCode() : int
+    + issues() : List<? extends ProbableIssue>
+    + text() : String
+  }
+  class SimpleProbabilisticIssueWiseText {
+    - issues : ImmutableList<ProbableIssue>
+    - text : String
+    + SimpleProbabilisticIssueWiseText(text : String, issues : List<ProbableIssue>)
+    + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends ProbabilisticIssueWiseText, ? extends ProbableIssue>
+    - filteredGroup(predicate : Predicate<? super ProbableIssue>) : ProbabilisticIssueWiseText
+    - filteredItems(predicate : Predicate<? super ProbableIssue>) : ImmutableList<ProbableIssue>
+    + hashCode() : int
+    + issues() : List<? extends ProbableIssue>
+    + text() : String
+  }
+  class SimpleProbableIssue {
+    - probability : double
+    ~ SimpleProbableIssue(issuePosition : IssuePosition, issueType : IssueType, probability : double)
+    + equals(o : Object) : boolean
+    + hashCode() : int
+    + probability() : double
+  }
+}
+SimpleIssueWiseText -->  "-issues" Issue
+SimpleProbabilisticIssueAwareText -->  "-issues" ProbableIssue
+SimpleIssue -->  "-issueType" IssueType
+SimpleIssueAwareText -->  "-issues" Issue
+SimpleProbabilisticIssueWiseText -->  "-issues" ProbableIssue
+SimpleIssue -->  "-issuePosition" IssuePosition
+ProbabilisticIssueAwareText --|> IssueAwareText 
+ProbabilisticIssueWiseText --|> IssueWiseText 
+ProbableIssue --|> Issue 
+SimpleIssue ..|> Issue 
+SimpleIssueAwareText ..|> IssueAwareText 
+SimpleIssueWiseText ..|> IssueWiseText 
+SimpleProbabilisticIssueAwareText ..|> ProbabilisticIssueAwareText 
+SimpleProbabilisticIssueWiseText ..|> ProbabilisticIssueWiseText 
+SimpleProbableIssue ..|> ProbableIssue 
+SimpleProbableIssue --|> SimpleIssue 
+@enduml
\ No newline at end of file
diff --git a/filterer/pom.xml b/filterer/pom.xml
new file mode 100644
index 000000000..24dae571e
--- /dev/null
+++ b/filterer/pom.xml
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>java-design-patterns</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.23.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>filterer</artifactId>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.google.guava</groupId>
+            <artifactId>guava</artifactId>
+            <version>29.0-jre</version>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.6.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <version>5.6.2</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <version>3.16.1</version>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <version>2.22.2</version>
+            </plugin>
+            <plugin>
+                <artifactId>maven-failsafe-plugin</artifactId>
+                <version>2.22.2</version>
+            </plugin>
+        </plugins>
+    </build>
+</project>
\ No newline at end of file
diff --git a/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java b/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
new file mode 100644
index 000000000..17970c115
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
@@ -0,0 +1,36 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.domain;
+
+import java.util.function.Predicate;
+
+/**
+ * Filterer helper interface.
+ * @param <G> type of the container-like object.
+ * @param <E> type of the elements contained within this container-like object.
+ */
+@FunctionalInterface
+public interface Filterer<G, E> {
+  G by(Predicate<? super E> predicate);
+}
\ No newline at end of file
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java b/filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java
new file mode 100644
index 000000000..957ade6e5
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java
@@ -0,0 +1,49 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+/**
+ * Represents an issue that can be detected in given text.
+ */
+public interface Issue {
+  /**
+   * Returns starting position where the issue begins.
+   *
+   * @return value representing starting position of the issue.
+   */
+  int startOffset();
+
+  /**
+   * Returns ending position where the issue ends.
+   *
+   * @return value representing ending position of the issue.
+   */
+  int endOffset();
+
+  /**
+   * Returns issue type.
+   * @return {@link IssueType}
+   */
+  IssueType type();
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java
new file mode 100644
index 000000000..8141ae849
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java
@@ -0,0 +1,55 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import com.iluwatar.filterer.domain.Filterer;
+
+import java.util.List;
+
+/**
+ * Represents text that is aware of issues that are present in it.
+ */
+public interface IssueAwareText {
+
+  /**
+   * Returns the analyzed text.
+   *
+   * @return the analyzed text.
+   */
+  String text();
+
+  /**
+   * Returns list of issues for this text.
+   * @return list of issues for this text.
+   */
+  List<? extends Issue> issues();
+
+  /**
+   * Returns the instance of {@link Filterer} helper interface that allows to covariantly
+   * specify lower bound for predicate that we want to filter by.
+   * @return an instance of {@link Filterer} helper interface.
+   */
+  Filterer<? extends IssueAwareText, ? extends Issue> filtered();
+
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java b/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
new file mode 100644
index 000000000..a771c1a82
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
@@ -0,0 +1,76 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import java.util.Objects;
+
+/**
+ * Represents position of an issue. Takes starting and ending offset of issue in given text.
+ */
+public final class IssuePosition {
+
+  private final int startOffset;
+  private final int endOffset;
+
+  /**
+   * Factory method for constructing `IssuePosition` instances.
+   * @param startOffset starting offset of where the issue begins.
+   * @param endOffset ending offset of where the issue ends.
+   * @return new IssuePosition instance.
+   */
+  public static IssuePosition of(final int startOffset, final int endOffset) {
+    return new IssuePosition(startOffset, endOffset);
+  }
+
+  private IssuePosition(int startOffset, int endOffset) {
+    this.startOffset = startOffset;
+    this.endOffset = endOffset;
+  }
+
+  int startOffset() {
+    return startOffset;
+  }
+
+  int endOffset() {
+    return endOffset;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    IssuePosition that = (IssuePosition) o;
+    return startOffset == that.startOffset
+            && endOffset == that.endOffset;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(startOffset, endOffset);
+  }
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java b/filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java
new file mode 100644
index 000000000..ee2c12ce5
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java
@@ -0,0 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+enum IssueType { GRAMMAR, SPELLING }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java
new file mode 100644
index 000000000..da15bdd99
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java
@@ -0,0 +1,49 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import com.iluwatar.filterer.domain.Filterer;
+
+import java.util.List;
+
+/**
+ * Represents text that is aware of it's issues with given probability of their occurrence.
+ */
+public interface ProbabilisticIssueAwareText extends IssueAwareText {
+
+  /**
+   * {@inheritDoc}
+   * @return
+   */
+  @Override
+  List<? extends ProbableIssue> issues();
+
+  /**
+   * {@inheritDoc}
+   * @return
+   */
+  @Override
+  Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> filtered();
+}
+
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java b/filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java
new file mode 100644
index 000000000..ccb047fa4
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java
@@ -0,0 +1,35 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+/**
+ * Represents issue that is an issue with given probability.
+ */
+public interface ProbableIssue extends Issue {
+  /**
+   * Returns probability of occurrence of given issue.
+   * @return probability of occurrence of given issue.
+   */
+  double probability();
+}
\ No newline at end of file
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java
new file mode 100644
index 000000000..fde5b8d8e
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java
@@ -0,0 +1,79 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import java.util.Objects;
+
+public class SimpleIssue implements Issue {
+
+  private final IssuePosition issuePosition;
+  private final IssueType issueType;
+
+  SimpleIssue(final IssuePosition issuePosition, IssueType issueType) {
+    this.issuePosition = issuePosition;
+    this.issueType = issueType;
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public int startOffset() {
+    return issuePosition.startOffset();
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public int endOffset() {
+    return issuePosition.endOffset();
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public IssueType type() {
+    return issueType;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    SimpleIssue that = (SimpleIssue) o;
+    return issuePosition.equals(that.issuePosition)
+            && issueType == that.issueType;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(issuePosition, issueType);
+  }
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java
new file mode 100644
index 000000000..c654a3aaa
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java
@@ -0,0 +1,98 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import com.google.common.collect.ImmutableList;
+import com.iluwatar.filterer.domain.Filterer;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+import java.util.function.Predicate;
+
+/**
+ * {@inheritDoc}
+ */
+public class SimpleIssueAwareText implements IssueAwareText {
+
+  private final String text;
+  private final ImmutableList<Issue> issues;
+
+  SimpleIssueAwareText(final String text, final List<Issue> issues) {
+    this.text = text;
+    this.issues = ImmutableList.copyOf(issues);
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public String text() {
+    return text;
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public List<? extends Issue> issues() {
+    return new ArrayList<>(issues);
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public Filterer<? extends IssueAwareText, ? extends Issue> filtered() {
+    return this::filteredGroup;
+  }
+
+  private IssueAwareText filteredGroup(Predicate<? super Issue> predicate) {
+    return new SimpleIssueAwareText(this.text, filteredItems(predicate));
+  }
+
+  private ImmutableList<Issue> filteredItems(Predicate<? super Issue> predicate) {
+    return this.issues.stream()
+            .filter(predicate)
+            .collect(ImmutableList.toImmutableList());
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    SimpleIssueAwareText that = (SimpleIssueAwareText) o;
+    return text.equals(that.text)
+            && issues.equals(that.issues);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(text, issues);
+  }
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java
new file mode 100644
index 000000000..e1b4afc82
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java
@@ -0,0 +1,101 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import com.google.common.collect.ImmutableList;
+import com.iluwatar.filterer.domain.Filterer;
+
+import java.util.List;
+import java.util.Objects;
+import java.util.function.Predicate;
+
+/**
+ * {@inheritDoc}
+ */
+public class SimpleProbabilisticIssueAwareText implements ProbabilisticIssueAwareText {
+
+  private final String text;
+  private final ImmutableList<ProbableIssue> issues;
+
+  SimpleProbabilisticIssueAwareText(final String text, final List<ProbableIssue> issues) {
+    this.text = text;
+    this.issues = ImmutableList.copyOf(issues);
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public String text() {
+    return text;
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public List<? extends ProbableIssue> issues() {
+    return issues;
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> filtered() {
+    return this::filteredGroup;
+  }
+
+  private ProbabilisticIssueAwareText filteredGroup(
+          final Predicate<? super ProbableIssue> predicate
+  ) {
+    return new SimpleProbabilisticIssueAwareText(this.text, filteredItems(predicate));
+  }
+
+  private ImmutableList<ProbableIssue> filteredItems(
+          final Predicate<? super ProbableIssue> predicate
+  ) {
+    return this.issues.stream()
+            .filter(predicate)
+            .collect(ImmutableList.toImmutableList());
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    SimpleProbabilisticIssueAwareText that = (SimpleProbabilisticIssueAwareText) o;
+    return text.equals(that.text)
+            && issues.equals(that.issues);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(text, issues);
+  }
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java
new file mode 100644
index 000000000..2b7672256
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java
@@ -0,0 +1,70 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import java.util.Objects;
+
+/**
+ * {@inheritDoc}
+ */
+public class SimpleProbableIssue extends SimpleIssue implements ProbableIssue {
+
+  private final double probability;
+
+  SimpleProbableIssue(final IssuePosition issuePosition,
+                      final IssueType issueType,
+                      final double probability
+  ) {
+    super(issuePosition, issueType);
+    this.probability = probability;
+  }
+
+  /**
+   * {@inheritDoc}
+   */
+  @Override
+  public double probability() {
+    return probability;
+  }
+
+  @Override
+  public boolean equals(Object o) {
+    if (this == o) {
+      return true;
+    }
+    if (o == null || getClass() != o.getClass()) {
+      return false;
+    }
+    if (!super.equals(o)) {
+      return false;
+    }
+    SimpleProbableIssue that = (SimpleProbableIssue) o;
+    return Double.compare(that.probability, probability) == 0;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(super.hashCode(), probability);
+  }
+}
diff --git a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java b/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java
new file mode 100644
index 000000000..1278128ae
--- /dev/null
+++ b/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java
@@ -0,0 +1,52 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import org.junit.jupiter.api.Test;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class SimpleIssueAwareTextTest {
+
+  @Test
+  void shouldFilterByStartOffset() {
+    //given
+    SimpleIssue spellingIssue = new SimpleIssue(IssuePosition.of(4, 5), IssueType.SPELLING);
+    SimpleIssue grammarIssue = new SimpleIssue(IssuePosition.of(8, 12), IssueType.GRAMMAR);
+    List<Issue> issues = List.of(spellingIssue, grammarIssue);
+
+    SimpleIssueAwareText simpleIssueWiseText = new SimpleIssueAwareText("I mihgt gone there", issues);
+
+    //when
+    IssueAwareText filtered = simpleIssueWiseText.filtered()
+            .by(issue1 -> issue1.startOffset() == 4);
+
+    //then
+    assertThat(filtered.issues()).hasSize(1);
+    assertThat(filtered.issues()).element(0).isEqualTo(spellingIssue);
+  }
+
+}
diff --git a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java b/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java
new file mode 100644
index 000000000..142415111
--- /dev/null
+++ b/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java
@@ -0,0 +1,52 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer.issue;
+
+import org.junit.jupiter.api.Test;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class SimpleProbabilisticIssueAwareTextTest {
+
+  @Test
+  void shouldFilterByProbability() {
+    //given
+    ProbableIssue spellingIssue = new SimpleProbableIssue(IssuePosition.of(4, 5), IssueType.SPELLING, 100);
+    ProbableIssue grammarIssue = new SimpleProbableIssue(IssuePosition.of(8, 12), IssueType.GRAMMAR, 99);
+    List<ProbableIssue> issues = List.of(spellingIssue, grammarIssue);
+
+    SimpleProbabilisticIssueAwareText simpleIssueWiseText = new SimpleProbabilisticIssueAwareText("I mihgt gone there", issues);
+
+    //when
+    ProbabilisticIssueAwareText filtered = simpleIssueWiseText.filtered()
+            .by(issue1 -> Double.compare(issue1.probability(), 99) == 0);
+
+    //then
+    assertThat(filtered.issues()).hasSize(1);
+    assertThat(filtered.issues()).element(0).isEqualTo(grammarIssue);
+  }
+
+}
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 0718ff045..1e34bcb67 100644
--- a/pom.xml
+++ b/pom.xml
@@ -193,6 +193,7 @@
         <module>strangler</module>
         <module>arrange-act-assert</module>
         <module>transaction-script</module>
+        <module>filterer</module>
     </modules>
 
     <repositories>

From b388020fc0f42badd2af207e1440cb5f077f6d31 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2020 14:34:23 +0000
Subject: [PATCH 021/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 355744159..69f417574 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=alert_status)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-125-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-126-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -256,6 +256,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4" width="100px;" alt=""/><br /><sub><b>Toxic Dreamz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ToxicDreamz" title="Code">💻</a></td>
   </tr>
 </table>
 

From 7f09cd5b2d232cf267c5f9d3b69c7699fb8240eb Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2020 14:34:24 +0000
Subject: [PATCH 022/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index fa325716e..fadd92bc9 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1140,6 +1140,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "ToxicDreamz",
+      "name": "Toxic Dreamz",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/45225562?v=4",
+      "profile": "https://github.com/ToxicDreamz",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From a2ae5d1324386b24aaf944e65304f4ef60481697 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2020 15:00:48 +0000
Subject: [PATCH 023/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 69f417574..4691b19b4 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 [![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=alert_status)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-126-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-127-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -257,6 +257,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4" width="100px;" alt=""/><br /><sub><b>Toxic Dreamz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ToxicDreamz" title="Code">💻</a></td>
+    <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4" width="100px;" alt=""/><br /><sub><b>Edy Cu Tjong</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=edycutjong" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From 0529b77abb677dda5ded898aa46c9d1c769e0718 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 21 Aug 2020 15:00:49 +0000
Subject: [PATCH 024/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index fadd92bc9..b968e8c31 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1149,6 +1149,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "edycutjong",
+      "name": "Edy Cu Tjong",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/1098102?v=4",
+      "profile": "http://www.edycutjong.com",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 4068d1feadfd03fe683b6157aa1e13fa0f64e495 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 22 Aug 2020 14:03:21 +0300
Subject: [PATCH 025/254] Update sonar badges

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4691b19b4..b0e297f82 100644
--- a/README.md
+++ b/README.md
@@ -6,8 +6,9 @@
 
 ![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
 [![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
-[![Sonarcloud Status](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=alert_status)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
 [![All Contributors](https://img.shields.io/badge/all_contributors-127-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->

From 61b95c294be022b19d48f457ee459610e666dec5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 22 Aug 2020 14:49:56 +0300
Subject: [PATCH 026/254] Update github token

---
 .github/workflows/maven-ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index be0a74e9f..9281c0f3d 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -60,5 +60,5 @@ jobs:
       run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
       env:
         # These two env variables are needed for sonar analysis
-        GITHUB_TOKEN: ${{ secrets.REPOSITORY_ACCESS_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

From 61a819aab8de2c9dce268815f641941bd45e18e7 Mon Sep 17 00:00:00 2001
From: Michal Krzywanski <outcast1231@wp.pl>
Date: Sat, 22 Aug 2020 17:53:09 +0200
Subject: [PATCH 027/254] Added fixes after review. Changed example pattern
 application to threat detection domain

---
 filterer/README.MD                            | 170 +++++++++++++++-
 filterer/etc/filterer.png                     | Bin 141773 -> 130820 bytes
 filterer/etc/filterer.urm.puml                | 188 +++++++-----------
 filterer/pom.xml                              |  29 ++-
 .../main/java/com/iluwatar/filterer/App.java  | 111 +++++++++++
 .../filterer/issue/IssuePosition.java         |  76 -------
 .../ProbabilisticThreatAwareSystem.java}      |  10 +-
 .../ProbableThreat.java}                      |  10 +-
 ...SimpleProbabilisticThreatAwareSystem.java} |  58 +++---
 .../SimpleProbableThreat.java}                |  23 ++-
 .../SimpleThreat.java}                        |  56 ++++--
 .../SimpleThreatAwareSystem.java}             |  43 ++--
 .../{issue/Issue.java => threat/Threat.java}  |  24 +--
 .../ThreatAwareSystem.java}                   |  20 +-
 .../IssueType.java => threat/ThreatType.java} |   4 +-
 .../java/com/iluwatar/filterer/AppTest.java   |  33 +++
 ...leProbabilisticThreatAwareSystemTest.java} |  25 ++-
 .../SimpleThreatAwareSystemTest.java}         |  28 ++-
 18 files changed, 572 insertions(+), 336 deletions(-)
 create mode 100644 filterer/src/main/java/com/iluwatar/filterer/App.java
 delete mode 100644 filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/ProbabilisticIssueAwareText.java => threat/ProbabilisticThreatAwareSystem.java} (79%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/ProbableIssue.java => threat/ProbableThreat.java} (81%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/SimpleProbabilisticIssueAwareText.java => threat/SimpleProbabilisticThreatAwareSystem.java} (54%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/SimpleProbableIssue.java => threat/SimpleProbableThreat.java} (74%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/SimpleIssue.java => threat/SimpleThreat.java} (59%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/SimpleIssueAwareText.java => threat/SimpleThreatAwareSystem.java} (63%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/Issue.java => threat/Threat.java} (71%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/IssueAwareText.java => threat/ThreatAwareSystem.java} (78%)
 rename filterer/src/main/java/com/iluwatar/filterer/{issue/IssueType.java => threat/ThreatType.java} (92%)
 create mode 100644 filterer/src/test/java/com/iluwatar/filterer/AppTest.java
 rename filterer/src/test/java/com/iluwatar/filterer/{issue/SimpleProbabilisticIssueAwareTextTest.java => threat/SimpleProbabilisticThreatAwareSystemTest.java} (60%)
 rename filterer/src/test/java/com/iluwatar/filterer/{issue/SimpleIssueAwareTextTest.java => threat/SimpleThreatAwareSystemTest.java} (62%)

diff --git a/filterer/README.MD b/filterer/README.MD
index 8a2526048..3281e9ecc 100644
--- a/filterer/README.MD
+++ b/filterer/README.MD
@@ -1,6 +1,6 @@
 --- # this is so called 'Yaml Front Matter', read up on it here: http://jekyllrb.com/docs/frontmatter/
 layout: pattern
-title: Filterer Pattern
+title: Filterer
 folder: filterer
 permalink: /patterns/filterer/
 description: Design pattern that helps container-like objects to return filtered version of themselves.# short meta description that shows in Google search results
@@ -11,15 +11,173 @@ tags:
 ---
 
 ## Name / classification
-Filterer Pattern
+Filterer
 
 ## Intent
 The intent of this design pattern is to to introduce a functional interface that will add a functionality for container-like objects to easily return filtered versions of themselves.
 
 ## Explanation
-The container-like object needs to have a method that returns an instance of `Filterer`. This helper interface gives 
+Real world example
+
+> We are designing a threat(malware) detection system. We can have different types of threats and systems. We have a requirement that
+> system should be aware of threats that are present in it. In the design we have to take into consideration that new Threat types can be
+> added later. Also there is a requirement that a system can filter itself based on the threats that it possesses (system acts as container-like object for threats).
+>
+
+In plain words
+
+> We need to be able to filter different types of systems(container-like objects) based on properties of Threats that they contain.
+> Adding new properties for Threats should be easy (we still need the ability to filter by those new properties).
+
+**Programmatic Example**
+
+To model the threat detection example presented above we introduce `Threat` and `ThreatAwareSystem` interfaces.
+
+```java
+public interface Threat {
+  String name();
+  int id();
+  ThreatType type();
+}
+
+public interface ThreatAwareSystem {
+  String systemId();
+  List<? extends Threat> threats();
+  Filterer<? extends ThreatAwareSystem, ? extends Threat> filtered();
+
+}
+```
+Notice the `filtered` method that returns instance of `Filterer` interface which is defined as :
+```java
+@FunctionalInterface
+public interface Filterer<G, E> {
+  G by(Predicate<? super E> predicate);
+}
+```
+it is used to fulfill the requirement for system to be able to filter itself based on threat properties.
+The container-like object (`ThreatAwareSystem` in our case) needs to have a method that returns an instance of `Filterer`. This helper interface gives 
 ability to covariantly specify a lower bound of contravariant `Predicate` in the subinterfaces of interfaces representing the container-like objects.
 
+In our example we will be able to pass a predicate that takes `? extends Threat` object and return `?  extends ThreatAwareSystem`
+from `Filtered::by` method. A simple implementation of `ThreadAwareSystem` :
+```java
+public class SimpleThreatAwareSystem implements ThreatAwareSystem {
+
+  private final String systemId;
+  private final ImmutableList<Threat> issues;
+
+  public SimpleThreatAwareSystem(final String systemId, final List<Threat> issues) {
+    this.systemId = systemId;
+    this.issues = ImmutableList.copyOf(issues);
+  }
+  
+  @Override
+  public String systemId() {
+    return systemId;
+  }
+  
+  @Override
+  public List<? extends Threat> threats() {
+    return new ArrayList<>(issues);
+  }
+
+  @Override
+  public Filterer<? extends ThreatAwareSystem, ? extends Threat> filtered() {
+    return this::filteredGroup;
+  }
+
+  private ThreatAwareSystem filteredGroup(Predicate<? super Threat> predicate) {
+    return new SimpleThreatAwareSystem(this.systemId, filteredItems(predicate));
+  }
+
+  private List<Threat> filteredItems(Predicate<? super Threat> predicate) {
+    return this.issues.stream()
+            .filter(predicate)
+            .collect(Collectors.toList());
+  }
+}
+```
+the `filtered` method is overridden to filter the threats list by given predicate.
+
+Now if we introduce new subtype of `Thread` interface that adds probability with which given thread can appear :
+```java
+public interface ProbableThreat extends Threat {
+  double probability();
+}
+```
+we can also introduce a new interface that represents a system that is aware of threats with their probabilities :
+````java
+public interface ProbabilisticThreatAwareSystem extends ThreatAwareSystem {
+  @Override
+  List<? extends ProbableThreat> threats();
+
+  @Override
+  Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> filtered();
+}
+````
+Notice how we override the `filtered` method in `ProbabilisticThreatAwareSystem` and specify different return covariant type
+by specifing different generic types. Our interfaces are clean and not cluttered by default implementations. We
+we will be able to filter `ProbabilisticThreatAwareSystem` by `ProbableThreat` properties :
+```java
+public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreatAwareSystem {
+
+  private final String systemId;
+  private final ImmutableList<ProbableThreat> threats;
+
+  public SimpleProbabilisticThreatAwareSystem(final String systemId, final List<ProbableThreat> threats) {
+    this.systemId = systemId;
+    this.threats = ImmutableList.copyOf(threats);
+  }
+
+  @Override
+  public String systemId() {
+    return systemId;
+  }
+
+  @Override
+  public List<? extends ProbableThreat> threats() {
+    return threats;
+  }
+
+  @Override
+  public Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> filtered() {
+    return this::filteredGroup;
+  }
+
+  private ProbabilisticThreatAwareSystem filteredGroup(final Predicate<? super ProbableThreat> predicate) {
+    return new SimpleProbabilisticThreatAwareSystem(this.systemId, filteredItems(predicate));
+  }
+
+  private List<ProbableThreat> filteredItems(final Predicate<? super ProbableThreat> predicate) {
+    return this.threats.stream()
+            .filter(predicate)
+            .collect(Collectors.toList());
+  }
+}
+```
+
+Now if we want filter `ThreatAwareSystem` by threat type we can do :
+```java
+Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
+Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
+List<Threat> threats = List.of(rootkit, trojan);
+
+ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
+
+ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
+           .by(threat -> threat.type() == ThreatType.ROOTKIT);
+```
+or if we want to filter `ProbabilisticThreatAwareSystem` :
+```java
+ProbableThreat malwareTroyan = new SimpleProbableThreat("Troyan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
+ProbableThreat rootkit = new SimpleProbableThreat("Rootkit-System", 2, ThreatType.ROOTKIT, 0.8);
+List<ProbableThreat> probableThreats = List.of(malwareTroyan, rootkit);
+
+ProbabilisticThreatAwareSystem simpleProbabilisticThreatAwareSystem =new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
+
+ProbabilisticThreatAwareSystem filtered = simpleProbabilisticThreatAwareSystem.filtered()
+           .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
+```
 ## Class diagram
 ![Filterer](./etc/filterer.png "Filterer")
 
@@ -34,11 +192,11 @@ It enables you to easily extend filtering ability of container-like objects as b
 ## Known uses
 One of the uses is present on the blog presented in this link. It presents how to use `Filterer` pattern to create text issue anaylyzer with support for test cases used for unit testing.
 
-## Consequences (the good and the bad, add criticism here)
-Good :
+## Consequences
+Pros :
  * you can easily introduce new subtypes for container-like objects and subtypes for objects that are contained within them and still be able to filter easily be new properties of those new subtypes.
 
-Bad :
+Cons :
  * covariant return types mixed with generics can be sometimes tricky
 
 ## Credits
diff --git a/filterer/etc/filterer.png b/filterer/etc/filterer.png
index f86764aa32aa18b063105c8ab529c2d04747326c..6a6eb059b92d4bd0cc54d3d0df87cdff8eca01bb 100644
GIT binary patch
literal 130820
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
J-P3vg{{V|wMWFxy

literal 141773
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%0ALv#igQ8NZ|3?qHU^qD?G%J=d~i5NG+tY
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

diff --git a/filterer/etc/filterer.urm.puml b/filterer/etc/filterer.urm.puml
index 24060b6aa..c0bb0b54d 100644
--- a/filterer/etc/filterer.urm.puml
+++ b/filterer/etc/filterer.urm.puml
@@ -4,129 +4,93 @@ package com.iluwatar.filterer.domain {
     + by(Predicate<? super E>) : G {abstract}
   }
 }
-package com.iluwatar.filterer.issue {
-  interface Issue {
-    + endOffset() : int {abstract}
-    + startOffset() : int {abstract}
-    + type() : IssueType {abstract}
+package com.iluwatar.filterer {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    - filteringSimpleProbableThreats() {static}
+    - filteringSimpleThreats() {static}
+    + main(args : String[]) {static}
   }
-  interface IssueAwareText {
-    + filtered() : Filterer<? extends IssueAwareText, ? extends Issue> {abstract}
-    + issues() : List<? extends Issue> {abstract}
-    + text() : String {abstract}
+}
+package com.iluwatar.filterer.threat {
+  interface ProbabilisticThreatAwareSystem {
+    + filtered() : Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> {abstract}
+    + threats() : List<? extends ProbableThreat> {abstract}
   }
-  class IssuePosition {
-    - endOffset : int
-    - startOffset : int
-    - IssuePosition(startOffset : int, endOffset : int)
-    ~ endOffset() : int
-    + equals(o : Object) : boolean
-    + hashCode() : int
-    + of(startOffset : int, endOffset : int) : IssuePosition {static}
-    ~ startOffset() : int
-  }
-  ~enum IssueType {
-    + GRAMMAR {static}
-    + SPELLING {static}
-    + valueOf(name : String) : IssueType {static}
-    + values() : IssueType[] {static}
-  }
-  interface IssueWiseText {
-    + filtered() : Filterer<? extends IssueWiseText, ? extends Issue> {abstract}
-    + issues() : List<? extends Issue> {abstract}
-    + text() : String {abstract}
-  }
-  interface ProbabilisticIssueAwareText {
-    + filtered() : Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> {abstract}
-    + issues() : List<? extends ProbableIssue> {abstract}
-  }
-  interface ProbabilisticIssueWiseText {
-    + filtered() : Filterer<? extends ProbabilisticIssueWiseText, ? extends ProbableIssue> {abstract}
-    + issues() : List<? extends ProbableIssue> {abstract}
-  }
-  interface ProbableIssue {
+  interface ProbableThreat {
     + probability() : double {abstract}
   }
-  class SimpleIssue {
-    - issuePosition : IssuePosition
-    - issueType : IssueType
-    ~ SimpleIssue(issuePosition : IssuePosition, issueType : IssueType)
-    + endOffset() : int
+  class SimpleProbabilisticThreatAwareSystem {
+    - systemId : String
+    - threats : ImmutableList<ProbableThreat>
+    + SimpleProbabilisticThreatAwareSystem(systemId : String, threats : List<ProbableThreat>)
     + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat>
+    - filteredGroup(predicate : Predicate<? super ProbableThreat>) : ProbabilisticThreatAwareSystem
+    - filteredItems(predicate : Predicate<? super ProbableThreat>) : List<ProbableThreat>
     + hashCode() : int
-    + startOffset() : int
-    + type() : IssueType
+    + systemId() : String
+    + threats() : List<? extends ProbableThreat>
+    + toString() : String
   }
-  class SimpleIssueAwareText {
-    - issues : ImmutableList<Issue>
-    - text : String
-    ~ SimpleIssueAwareText(text : String, issues : List<Issue>)
-    + equals(o : Object) : boolean
-    + filtered() : Filterer<? extends IssueAwareText, ? extends Issue>
-    - filteredGroup(predicate : Predicate<? super Issue>) : IssueAwareText
-    - filteredItems(predicate : Predicate<? super Issue>) : ImmutableList<Issue>
-    + hashCode() : int
-    + issues() : List<? extends Issue>
-    + text() : String
-  }
-  class SimpleIssueWiseText {
-    - issues : ImmutableList<Issue>
-    - text : String
-    + SimpleIssueWiseText(text : String, issues : List<Issue>)
-    + equals(o : Object) : boolean
-    + filtered() : Filterer<? extends IssueWiseText, ? extends Issue>
-    - filteredGroup(predicate : Predicate<? super Issue>) : IssueWiseText
-    - filteredItems(predicate : Predicate<? super Issue>) : ImmutableList<Issue>
-    + hashCode() : int
-    + issues() : List<? extends Issue>
-    + text() : String
-  }
-  class SimpleProbabilisticIssueAwareText {
-    - issues : ImmutableList<ProbableIssue>
-    - text : String
-    ~ SimpleProbabilisticIssueAwareText(text : String, issues : List<ProbableIssue>)
-    + equals(o : Object) : boolean
-    + filtered() : Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue>
-    - filteredGroup(predicate : Predicate<? super ProbableIssue>) : ProbabilisticIssueAwareText
-    - filteredItems(predicate : Predicate<? super ProbableIssue>) : ImmutableList<ProbableIssue>
-    + hashCode() : int
-    + issues() : List<? extends ProbableIssue>
-    + text() : String
-  }
-  class SimpleProbabilisticIssueWiseText {
-    - issues : ImmutableList<ProbableIssue>
-    - text : String
-    + SimpleProbabilisticIssueWiseText(text : String, issues : List<ProbableIssue>)
-    + equals(o : Object) : boolean
-    + filtered() : Filterer<? extends ProbabilisticIssueWiseText, ? extends ProbableIssue>
-    - filteredGroup(predicate : Predicate<? super ProbableIssue>) : ProbabilisticIssueWiseText
-    - filteredItems(predicate : Predicate<? super ProbableIssue>) : ImmutableList<ProbableIssue>
-    + hashCode() : int
-    + issues() : List<? extends ProbableIssue>
-    + text() : String
-  }
-  class SimpleProbableIssue {
+  class SimpleProbableThreat {
     - probability : double
-    ~ SimpleProbableIssue(issuePosition : IssuePosition, issueType : IssueType, probability : double)
+    + SimpleProbableThreat(name : String, id : int, threatType : ThreatType, probability : double)
     + equals(o : Object) : boolean
     + hashCode() : int
     + probability() : double
+    + toString() : String
+  }
+  class SimpleThreat {
+    - id : int
+    - name : String
+    - threatType : ThreatType
+    + SimpleThreat(threatType : ThreatType, id : int, name : String)
+    + id() : int
+    + name() : String
+    + toString() : String
+    + type() : ThreatType
+  }
+  class SimpleThreatAwareSystem {
+    - issues : ImmutableList<Threat>
+    - systemId : String
+    + SimpleThreatAwareSystem(systemId : String, issues : List<Threat>)
+    + equals(o : Object) : boolean
+    + filtered() : Filterer<? extends ThreatAwareSystem, ? extends Threat>
+    - filteredGroup(predicate : Predicate<? super Threat>) : ThreatAwareSystem
+    - filteredItems(predicate : Predicate<? super Threat>) : List<Threat>
+    + hashCode() : int
+    + systemId() : String
+    + threats() : List<? extends Threat>
+    + toString() : String
+  }
+  interface Threat {
+    + id() : int {abstract}
+    + name() : String {abstract}
+    + type() : ThreatType {abstract}
+  }
+  interface ThreatAwareSystem {
+    + filtered() : Filterer<? extends ThreatAwareSystem, ? extends Threat> {abstract}
+    + systemId() : String {abstract}
+    + threats() : List<? extends Threat> {abstract}
+  }
+  enum ThreatType {
+    + ROOTKIT {static}
+    + TROJAN {static}
+    + WORM {static}
+    + valueOf(name : String) : ThreatType {static}
+    + values() : ThreatType[] {static}
   }
 }
-SimpleIssueWiseText -->  "-issues" Issue
-SimpleProbabilisticIssueAwareText -->  "-issues" ProbableIssue
-SimpleIssue -->  "-issueType" IssueType
-SimpleIssueAwareText -->  "-issues" Issue
-SimpleProbabilisticIssueWiseText -->  "-issues" ProbableIssue
-SimpleIssue -->  "-issuePosition" IssuePosition
-ProbabilisticIssueAwareText --|> IssueAwareText 
-ProbabilisticIssueWiseText --|> IssueWiseText 
-ProbableIssue --|> Issue 
-SimpleIssue ..|> Issue 
-SimpleIssueAwareText ..|> IssueAwareText 
-SimpleIssueWiseText ..|> IssueWiseText 
-SimpleProbabilisticIssueAwareText ..|> ProbabilisticIssueAwareText 
-SimpleProbabilisticIssueWiseText ..|> ProbabilisticIssueWiseText 
-SimpleProbableIssue ..|> ProbableIssue 
-SimpleProbableIssue --|> SimpleIssue 
+SimpleThreatAwareSystem -->  "-issues" Threat
+SimpleThreat -->  "-threatType" ThreatType
+SimpleProbabilisticThreatAwareSystem -->  "-threats" ProbableThreat
+ProbabilisticThreatAwareSystem --|> ThreatAwareSystem 
+ProbableThreat --|> Threat 
+SimpleProbabilisticThreatAwareSystem ..|> ProbabilisticThreatAwareSystem 
+SimpleProbableThreat ..|> ProbableThreat 
+SimpleProbableThreat --|> SimpleThreat 
+SimpleThreat ..|> Threat 
+SimpleThreatAwareSystem ..|> ThreatAwareSystem 
 @enduml
\ No newline at end of file
diff --git a/filterer/pom.xml b/filterer/pom.xml
index 24dae571e..4477332ae 100644
--- a/filterer/pom.xml
+++ b/filterer/pom.xml
@@ -39,37 +39,34 @@
         <dependency>
             <groupId>com.google.guava</groupId>
             <artifactId>guava</artifactId>
-            <version>29.0-jre</version>
         </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-api</artifactId>
-            <version>5.6.2</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
-            <version>5.6.2</version>
-            <scope>test</scope>
-        </dependency>
-        <dependency>
-            <groupId>org.assertj</groupId>
-            <artifactId>assertj-core</artifactId>
-            <version>3.16.1</version>
             <scope>test</scope>
         </dependency>
     </dependencies>
-
     <build>
         <plugins>
             <plugin>
-                <artifactId>maven-surefire-plugin</artifactId>
-                <version>2.22.2</version>
-            </plugin>
-            <plugin>
-                <artifactId>maven-failsafe-plugin</artifactId>
-                <version>2.22.2</version>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <configuration>
+                            <archive>
+                                <manifest>
+                                    <mainClass>com.iluwatar.filterer.App</mainClass>
+                                </manifest>
+                            </archive>
+                        </configuration>
+                    </execution>
+                </executions>
             </plugin>
         </plugins>
     </build>
diff --git a/filterer/src/main/java/com/iluwatar/filterer/App.java b/filterer/src/main/java/com/iluwatar/filterer/App.java
new file mode 100644
index 000000000..97ed24837
--- /dev/null
+++ b/filterer/src/main/java/com/iluwatar/filterer/App.java
@@ -0,0 +1,111 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer;
+
+import com.iluwatar.filterer.threat.ProbabilisticThreatAwareSystem;
+import com.iluwatar.filterer.threat.ProbableThreat;
+import com.iluwatar.filterer.threat.SimpleProbabilisticThreatAwareSystem;
+import com.iluwatar.filterer.threat.SimpleProbableThreat;
+import com.iluwatar.filterer.threat.SimpleThreat;
+import com.iluwatar.filterer.threat.SimpleThreatAwareSystem;
+import com.iluwatar.filterer.threat.Threat;
+import com.iluwatar.filterer.threat.ThreatAwareSystem;
+import com.iluwatar.filterer.threat.ThreatType;
+
+import java.util.List;
+import java.util.function.Predicate;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * This demo class represent how {@link com.iluwatar.filterer.domain.Filterer} pattern is used to
+ * filter container-like objects to return filtered versions of themselves. The container like
+ * objects are systems that are aware of threats that they can be vulnerable to. We would like
+ * to have a way to create copy of different system objects but with filtered threats.
+ * The thing is to keep it simple if we add new subtype of {@link Threat}
+ * (for example {@link ProbableThreat}) - we still need to be able to filter by it's properties.
+ */
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  public static void main(String[] args) {
+    filteringSimpleThreats();
+    filteringSimpleProbableThreats();
+  }
+
+  /**
+   * Demonstrates how to filter {@link com.iluwatar.filterer.threat.ProbabilisticThreatAwareSystem}
+   * based on probability property. The @{@link com.iluwatar.filterer.domain.Filterer#by(Predicate)}
+   * method is able to use {@link com.iluwatar.filterer.threat.ProbableThreat}
+   * as predicate argument.
+   */
+  private static void filteringSimpleProbableThreats() {
+    LOGGER.info(" ### Filtering ProbabilisticThreatAwareSystem by probability ###");
+
+    ProbableThreat trojanArcBomb =
+            new SimpleProbableThreat("Trojan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
+    ProbableThreat rootkit =
+            new SimpleProbableThreat("Rootkit-Kernel", 2, ThreatType.ROOTKIT, 0.8);
+
+    List<ProbableThreat> probableThreats = List.of(trojanArcBomb, rootkit);
+
+    ProbabilisticThreatAwareSystem probabilisticThreatAwareSystem =
+            new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
+
+    LOGGER.info("Filtering ProbabilisticThreatAwareSystem. Initial : "
+            + probabilisticThreatAwareSystem);
+
+    //Filtering using filterer
+    ProbabilisticThreatAwareSystem filtered = probabilisticThreatAwareSystem.filtered()
+            .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
+
+    LOGGER.info("Filtered by probability = 0.99 : " + filtered);
+  }
+
+  /**
+   * Demonstrates how to filter {@link ThreatAwareSystem} based on startingOffset property
+   * of {@link SimpleThreat}. The @{@link com.iluwatar.filterer.domain.Filterer#by(Predicate)}
+   * method is able to use {@link Threat} as predicate argument.
+   */
+  private static void filteringSimpleThreats() {
+    LOGGER.info("### Filtering ThreatAwareSystem by ThreatType ###");
+
+    Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
+    Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
+    List<Threat> threats = List.of(rootkit, trojan);
+
+    ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
+
+    LOGGER.info("Filtering ThreatAwareSystem. Initial : " + threatAwareSystem);
+
+    //Filtering using Filterer
+    ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
+            .by(threat -> threat.type() == ThreatType.ROOTKIT);
+
+    LOGGER.info("Filtered by threatType = ROOTKIT : " + rootkitThreatAwareSystem);
+  }
+
+}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java b/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
deleted file mode 100644
index a771c1a82..000000000
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/IssuePosition.java
+++ /dev/null
@@ -1,76 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.filterer.issue;
-
-import java.util.Objects;
-
-/**
- * Represents position of an issue. Takes starting and ending offset of issue in given text.
- */
-public final class IssuePosition {
-
-  private final int startOffset;
-  private final int endOffset;
-
-  /**
-   * Factory method for constructing `IssuePosition` instances.
-   * @param startOffset starting offset of where the issue begins.
-   * @param endOffset ending offset of where the issue ends.
-   * @return new IssuePosition instance.
-   */
-  public static IssuePosition of(final int startOffset, final int endOffset) {
-    return new IssuePosition(startOffset, endOffset);
-  }
-
-  private IssuePosition(int startOffset, int endOffset) {
-    this.startOffset = startOffset;
-    this.endOffset = endOffset;
-  }
-
-  int startOffset() {
-    return startOffset;
-  }
-
-  int endOffset() {
-    return endOffset;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    IssuePosition that = (IssuePosition) o;
-    return startOffset == that.startOffset
-            && endOffset == that.endOffset;
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(startOffset, endOffset);
-  }
-}
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
similarity index 79%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
index da15bdd99..3a2959828 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbabilisticIssueAwareText.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
@@ -21,29 +21,29 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import com.iluwatar.filterer.domain.Filterer;
 
 import java.util.List;
 
 /**
- * Represents text that is aware of it's issues with given probability of their occurrence.
+ * Represents system that is aware of it's threats with given probability of their occurrence.
  */
-public interface ProbabilisticIssueAwareText extends IssueAwareText {
+public interface ProbabilisticThreatAwareSystem extends ThreatAwareSystem {
 
   /**
    * {@inheritDoc}
    * @return
    */
   @Override
-  List<? extends ProbableIssue> issues();
+  List<? extends ProbableThreat> threats();
 
   /**
    * {@inheritDoc}
    * @return
    */
   @Override
-  Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> filtered();
+  Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> filtered();
 }
 
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
similarity index 81%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
index ccb047fa4..11e61dbf6 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/ProbableIssue.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
@@ -21,15 +21,15 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 /**
- * Represents issue that is an issue with given probability.
+ * Represents threat that might be a threat with given probability.
  */
-public interface ProbableIssue extends Issue {
+public interface ProbableThreat extends Threat {
   /**
-   * Returns probability of occurrence of given issue.
-   * @return probability of occurrence of given issue.
+   * Returns probability of occurrence of given threat.
+   * @return probability of occurrence of given threat.
    */
   double probability();
 }
\ No newline at end of file
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
similarity index 54%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
index e1b4afc82..37fae6a74 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareText.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
@@ -21,7 +21,7 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import com.google.common.collect.ImmutableList;
 import com.iluwatar.filterer.domain.Filterer;
@@ -29,56 +29,60 @@ import com.iluwatar.filterer.domain.Filterer;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 
 /**
  * {@inheritDoc}
  */
-public class SimpleProbabilisticIssueAwareText implements ProbabilisticIssueAwareText {
+public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreatAwareSystem {
 
-  private final String text;
-  private final ImmutableList<ProbableIssue> issues;
+  private final String systemId;
+  private final ImmutableList<ProbableThreat> threats;
 
-  SimpleProbabilisticIssueAwareText(final String text, final List<ProbableIssue> issues) {
-    this.text = text;
-    this.issues = ImmutableList.copyOf(issues);
+  public SimpleProbabilisticThreatAwareSystem(
+          final String systemId,
+          final List<ProbableThreat> threats
+  ) {
+    this.systemId = systemId;
+    this.threats = ImmutableList.copyOf(threats);
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public String text() {
-    return text;
+  public String systemId() {
+    return systemId;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public List<? extends ProbableIssue> issues() {
-    return issues;
+  public List<? extends ProbableThreat> threats() {
+    return threats;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public Filterer<? extends ProbabilisticIssueAwareText, ? extends ProbableIssue> filtered() {
+  public Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> filtered() {
     return this::filteredGroup;
   }
 
-  private ProbabilisticIssueAwareText filteredGroup(
-          final Predicate<? super ProbableIssue> predicate
+  private ProbabilisticThreatAwareSystem filteredGroup(
+          final Predicate<? super ProbableThreat> predicate
   ) {
-    return new SimpleProbabilisticIssueAwareText(this.text, filteredItems(predicate));
+    return new SimpleProbabilisticThreatAwareSystem(this.systemId, filteredItems(predicate));
   }
 
-  private ImmutableList<ProbableIssue> filteredItems(
-          final Predicate<? super ProbableIssue> predicate
+  private List<ProbableThreat> filteredItems(
+          final Predicate<? super ProbableThreat> predicate
   ) {
-    return this.issues.stream()
+    return this.threats.stream()
             .filter(predicate)
-            .collect(ImmutableList.toImmutableList());
+            .collect(Collectors.toList());
   }
 
   @Override
@@ -89,13 +93,21 @@ public class SimpleProbabilisticIssueAwareText implements ProbabilisticIssueAwar
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleProbabilisticIssueAwareText that = (SimpleProbabilisticIssueAwareText) o;
-    return text.equals(that.text)
-            && issues.equals(that.issues);
+    SimpleProbabilisticThreatAwareSystem that = (SimpleProbabilisticThreatAwareSystem) o;
+    return systemId.equals(that.systemId)
+            && threats.equals(that.threats);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(text, issues);
+    return Objects.hash(systemId, threats);
+  }
+
+  @Override
+  public String toString() {
+    return "SimpleProbabilisticThreatAwareSystem{"
+            + "systemId='" + systemId + '\''
+            + ", threats=" + threats
+            + '}';
   }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
similarity index 74%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
index 2b7672256..27efc740a 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleProbableIssue.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
@@ -21,22 +21,23 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import java.util.Objects;
 
 /**
  * {@inheritDoc}
  */
-public class SimpleProbableIssue extends SimpleIssue implements ProbableIssue {
+public class SimpleProbableThreat extends SimpleThreat implements ProbableThreat {
 
   private final double probability;
 
-  SimpleProbableIssue(final IssuePosition issuePosition,
-                      final IssueType issueType,
-                      final double probability
+  public SimpleProbableThreat(final String name,
+                              final int id,
+                              final ThreatType threatType,
+                              final double probability
   ) {
-    super(issuePosition, issueType);
+    super(threatType, id, name);
     this.probability = probability;
   }
 
@@ -59,7 +60,7 @@ public class SimpleProbableIssue extends SimpleIssue implements ProbableIssue {
     if (!super.equals(o)) {
       return false;
     }
-    SimpleProbableIssue that = (SimpleProbableIssue) o;
+    SimpleProbableThreat that = (SimpleProbableThreat) o;
     return Double.compare(that.probability, probability) == 0;
   }
 
@@ -67,4 +68,12 @@ public class SimpleProbableIssue extends SimpleIssue implements ProbableIssue {
   public int hashCode() {
     return Objects.hash(super.hashCode(), probability);
   }
+
+  @Override
+  public String toString() {
+    return "SimpleProbableThreat{"
+            + "probability=" + probability
+            + "} "
+            + super.toString();
+  }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
similarity index 59%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
index fde5b8d8e..fe7f155d4 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssue.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
@@ -21,42 +21,54 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import java.util.Objects;
 
-public class SimpleIssue implements Issue {
+/**
+ * Represents a simple threat.
+ */
+public class SimpleThreat implements Threat {
 
-  private final IssuePosition issuePosition;
-  private final IssueType issueType;
+  private final ThreatType threatType;
+  private final int id;
+  private final String name;
 
-  SimpleIssue(final IssuePosition issuePosition, IssueType issueType) {
-    this.issuePosition = issuePosition;
-    this.issueType = issueType;
+  /**
+   * Constructor.
+   *
+   * @param threatType {@link ThreatType}.
+   * @param id         threat id.
+   * @param name       threat name.
+   */
+  public SimpleThreat(final ThreatType threatType, final int id, String name) {
+    this.threatType = threatType;
+    this.id = id;
+    this.name = name;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public int startOffset() {
-    return issuePosition.startOffset();
+  public String name() {
+    return name;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public int endOffset() {
-    return issuePosition.endOffset();
+  public int id() {
+    return id;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public IssueType type() {
-    return issueType;
+  public ThreatType type() {
+    return threatType;
   }
 
   @Override
@@ -67,13 +79,23 @@ public class SimpleIssue implements Issue {
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleIssue that = (SimpleIssue) o;
-    return issuePosition.equals(that.issuePosition)
-            && issueType == that.issueType;
+    SimpleThreat that = (SimpleThreat) o;
+    return id == that.id
+            && threatType == that.threatType
+            && Objects.equals(name, that.name);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(issuePosition, issueType);
+    return Objects.hash(threatType, id, name);
+  }
+
+  @Override
+  public String toString() {
+    return "SimpleThreat{"
+            + "threatType=" + threatType
+            + ", id=" + id
+            + ", name='" + name + '\''
+            + '}';
   }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
similarity index 63%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
index c654a3aaa..49707cf50 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/SimpleIssueAwareText.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
@@ -21,7 +21,7 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import com.google.common.collect.ImmutableList;
 import com.iluwatar.filterer.domain.Filterer;
@@ -30,17 +30,18 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Predicate;
+import java.util.stream.Collectors;
 
 /**
  * {@inheritDoc}
  */
-public class SimpleIssueAwareText implements IssueAwareText {
+public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 
-  private final String text;
-  private final ImmutableList<Issue> issues;
+  private final String systemId;
+  private final ImmutableList<Threat> issues;
 
-  SimpleIssueAwareText(final String text, final List<Issue> issues) {
-    this.text = text;
+  public SimpleThreatAwareSystem(final String systemId, final List<Threat> issues) {
+    this.systemId = systemId;
     this.issues = ImmutableList.copyOf(issues);
   }
 
@@ -48,15 +49,15 @@ public class SimpleIssueAwareText implements IssueAwareText {
    * {@inheritDoc}
    */
   @Override
-  public String text() {
-    return text;
+  public String systemId() {
+    return systemId;
   }
 
   /**
    * {@inheritDoc}
    */
   @Override
-  public List<? extends Issue> issues() {
+  public List<? extends Threat> threats() {
     return new ArrayList<>(issues);
   }
 
@@ -64,18 +65,18 @@ public class SimpleIssueAwareText implements IssueAwareText {
    * {@inheritDoc}
    */
   @Override
-  public Filterer<? extends IssueAwareText, ? extends Issue> filtered() {
+  public Filterer<? extends ThreatAwareSystem, ? extends Threat> filtered() {
     return this::filteredGroup;
   }
 
-  private IssueAwareText filteredGroup(Predicate<? super Issue> predicate) {
-    return new SimpleIssueAwareText(this.text, filteredItems(predicate));
+  private ThreatAwareSystem filteredGroup(Predicate<? super Threat> predicate) {
+    return new SimpleThreatAwareSystem(this.systemId, filteredItems(predicate));
   }
 
-  private ImmutableList<Issue> filteredItems(Predicate<? super Issue> predicate) {
+  private List<Threat> filteredItems(Predicate<? super Threat> predicate) {
     return this.issues.stream()
             .filter(predicate)
-            .collect(ImmutableList.toImmutableList());
+            .collect(Collectors.toList());
   }
 
   @Override
@@ -86,13 +87,21 @@ public class SimpleIssueAwareText implements IssueAwareText {
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleIssueAwareText that = (SimpleIssueAwareText) o;
-    return text.equals(that.text)
+    SimpleThreatAwareSystem that = (SimpleThreatAwareSystem) o;
+    return systemId.equals(that.systemId)
             && issues.equals(that.issues);
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(text, issues);
+    return Objects.hash(systemId, issues);
+  }
+
+  @Override
+  public String toString() {
+    return "SimpleThreatAwareSystem{"
+            + "systemId='" + systemId
+            + '\'' + ", issues=" + issues
+            + '}';
   }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java b/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
similarity index 71%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
index 957ade6e5..515b59332 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/Issue.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
@@ -21,29 +21,29 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 /**
- * Represents an issue that can be detected in given text.
+ * Represents a threat that can be detected in given system.
  */
-public interface Issue {
+public interface Threat {
   /**
-   * Returns starting position where the issue begins.
+   * Returns name of the threat.
    *
-   * @return value representing starting position of the issue.
+   * @return value representing name of the threat.
    */
-  int startOffset();
+  String name();
 
   /**
-   * Returns ending position where the issue ends.
+   * Returns unique id of the threat.
    *
-   * @return value representing ending position of the issue.
+   * @return value representing threat id.
    */
-  int endOffset();
+  int id();
 
   /**
-   * Returns issue type.
-   * @return {@link IssueType}
+   * Returns threat type.
+   * @return {@link ThreatType}
    */
-  IssueType type();
+  ThreatType type();
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
similarity index 78%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
index 8141ae849..b889d537d 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueAwareText.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
@@ -21,35 +21,35 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import com.iluwatar.filterer.domain.Filterer;
 
 import java.util.List;
 
 /**
- * Represents text that is aware of issues that are present in it.
+ * Represents system that is aware of threats that are present in it.
  */
-public interface IssueAwareText {
+public interface ThreatAwareSystem {
 
   /**
-   * Returns the analyzed text.
+   * Returns the system id.
    *
-   * @return the analyzed text.
+   * @return system id.
    */
-  String text();
+  String systemId();
 
   /**
-   * Returns list of issues for this text.
-   * @return list of issues for this text.
+   * Returns list of threats for this system.
+   * @return list of threats for this system.
    */
-  List<? extends Issue> issues();
+  List<? extends Threat> threats();
 
   /**
    * Returns the instance of {@link Filterer} helper interface that allows to covariantly
    * specify lower bound for predicate that we want to filter by.
    * @return an instance of {@link Filterer} helper interface.
    */
-  Filterer<? extends IssueAwareText, ? extends Issue> filtered();
+  Filterer<? extends ThreatAwareSystem, ? extends Threat> filtered();
 
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
similarity index 92%
rename from filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java
rename to filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
index ee2c12ce5..5f9a152a8 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/issue/IssueType.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
@@ -21,6 +21,6 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
-enum IssueType { GRAMMAR, SPELLING }
+public enum ThreatType { TROJAN, WORM, ROOTKIT }
diff --git a/filterer/src/test/java/com/iluwatar/filterer/AppTest.java b/filterer/src/test/java/com/iluwatar/filterer/AppTest.java
new file mode 100644
index 000000000..551ebcc18
--- /dev/null
+++ b/filterer/src/test/java/com/iluwatar/filterer/AppTest.java
@@ -0,0 +1,33 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.filterer;
+
+import org.junit.jupiter.api.Test;
+
+class AppTest {
+  @Test
+  void shouldLaunchApp() {
+    App.main(new String[]{});
+  }
+}
\ No newline at end of file
diff --git a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
similarity index 60%
rename from filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java
rename to filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
index 142415111..592fabe88 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleProbabilisticIssueAwareTextTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
@@ -21,32 +21,31 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import org.junit.jupiter.api.Test;
 
 import java.util.List;
 
-import static org.assertj.core.api.Assertions.assertThat;
-
-class SimpleProbabilisticIssueAwareTextTest {
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
+class SimpleProbabilisticThreatAwareSystemTest {
   @Test
   void shouldFilterByProbability() {
     //given
-    ProbableIssue spellingIssue = new SimpleProbableIssue(IssuePosition.of(4, 5), IssueType.SPELLING, 100);
-    ProbableIssue grammarIssue = new SimpleProbableIssue(IssuePosition.of(8, 12), IssueType.GRAMMAR, 99);
-    List<ProbableIssue> issues = List.of(spellingIssue, grammarIssue);
+    ProbableThreat trojan = new SimpleProbableThreat("Troyan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
+    ProbableThreat rootkit = new SimpleProbableThreat("Rootkit-System", 2, ThreatType.ROOTKIT, 0.8);
+    List<ProbableThreat> probableThreats = List.of(trojan, rootkit);
 
-    SimpleProbabilisticIssueAwareText simpleIssueWiseText = new SimpleProbabilisticIssueAwareText("I mihgt gone there", issues);
+    ProbabilisticThreatAwareSystem simpleProbabilisticThreatAwareSystem =
+            new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
 
     //when
-    ProbabilisticIssueAwareText filtered = simpleIssueWiseText.filtered()
-            .by(issue1 -> Double.compare(issue1.probability(), 99) == 0);
+    ProbabilisticThreatAwareSystem filtered = simpleProbabilisticThreatAwareSystem.filtered()
+            .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 
     //then
-    assertThat(filtered.issues()).hasSize(1);
-    assertThat(filtered.issues()).element(0).isEqualTo(grammarIssue);
+    assertEquals(filtered.threats().size(), 1);
+    assertEquals(filtered.threats().get(0), trojan);
   }
-
 }
\ No newline at end of file
diff --git a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
similarity index 62%
rename from filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java
rename to filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
index 1278128ae..91fb62718 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/issue/SimpleIssueAwareTextTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
@@ -21,32 +21,30 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.filterer.issue;
+package com.iluwatar.filterer.threat;
 
 import org.junit.jupiter.api.Test;
 
 import java.util.List;
 
-import static org.assertj.core.api.Assertions.assertThat;
-
-class SimpleIssueAwareTextTest {
+import static org.junit.jupiter.api.Assertions.*;
 
+class SimpleThreatAwareSystemTest {
   @Test
-  void shouldFilterByStartOffset() {
+  void shouldFilterByThreatType() {
     //given
-    SimpleIssue spellingIssue = new SimpleIssue(IssuePosition.of(4, 5), IssueType.SPELLING);
-    SimpleIssue grammarIssue = new SimpleIssue(IssuePosition.of(8, 12), IssueType.GRAMMAR);
-    List<Issue> issues = List.of(spellingIssue, grammarIssue);
+    Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
+    Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
+    List<Threat> threats = List.of(rootkit, trojan);
 
-    SimpleIssueAwareText simpleIssueWiseText = new SimpleIssueAwareText("I mihgt gone there", issues);
+    ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
 
     //when
-    IssueAwareText filtered = simpleIssueWiseText.filtered()
-            .by(issue1 -> issue1.startOffset() == 4);
+    ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
+            .by(threat -> threat.type() == ThreatType.ROOTKIT);
 
     //then
-    assertThat(filtered.issues()).hasSize(1);
-    assertThat(filtered.issues()).element(0).isEqualTo(spellingIssue);
+    assertEquals(rootkitThreatAwareSystem.threats().size(), 1);
+    assertEquals(rootkitThreatAwareSystem.threats().get(0), rootkit);
   }
-
-}
+}
\ No newline at end of file

From 3d9afbaeec872b6ee36f68c9e5738f543d8d5562 Mon Sep 17 00:00:00 2001
From: Michal Krzywanski <outcast1231@wp.pl>
Date: Sat, 22 Aug 2020 18:24:41 +0200
Subject: [PATCH 028/254] fixed typo in read me

---
 filterer/README.MD | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/filterer/README.MD b/filterer/README.MD
index 3281e9ecc..b8207af6f 100644
--- a/filterer/README.MD
+++ b/filterer/README.MD
@@ -190,7 +190,8 @@ It enables you to easily extend filtering ability of container-like objects as b
 * [Application of Filterer pattern in domain of text analysis](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html)
 
 ## Known uses
-One of the uses is present on the blog presented in this link. It presents how to use `Filterer` pattern to create text issue anaylyzer with support for test cases used for unit testing.
+One of the uses is present on the blog presented in [this](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html) link. 
+It presents how to use `Filterer` pattern to create text issue analyzer with support for test cases used for unit testing.
 
 ## Consequences
 Pros :

From e65b65257ebaf80113ec08f2ff85c2b8a1c10bd4 Mon Sep 17 00:00:00 2001
From: Michal Krzywanski <outcast1231@wp.pl>
Date: Sun, 23 Aug 2020 11:00:15 +0200
Subject: [PATCH 029/254] fixing typos in readme file, introducing var local
 type inference where possible

---
 filterer/README.MD                            |  8 +++----
 .../main/java/com/iluwatar/filterer/App.java  | 23 ++++++++-----------
 .../SimpleProbabilisticThreatAwareSystem.java |  2 +-
 .../filterer/threat/SimpleProbableThreat.java |  2 +-
 .../filterer/threat/SimpleThreat.java         |  2 +-
 .../threat/SimpleThreatAwareSystem.java       |  2 +-
 ...pleProbabilisticThreatAwareSystemTest.java |  8 +++----
 .../threat/SimpleThreatAwareSystemTest.java   |  8 +++----
 8 files changed, 26 insertions(+), 29 deletions(-)

diff --git a/filterer/README.MD b/filterer/README.MD
index b8207af6f..0c03e21a9 100644
--- a/filterer/README.MD
+++ b/filterer/README.MD
@@ -14,7 +14,7 @@ tags:
 Filterer
 
 ## Intent
-The intent of this design pattern is to to introduce a functional interface that will add a functionality for container-like objects to easily return filtered versions of themselves.
+The intent of this design pattern is to introduce a functional interface that will add a functionality for container-like objects to easily return filtered versions of themselves.
 
 ## Explanation
 Real world example
@@ -59,7 +59,7 @@ The container-like object (`ThreatAwareSystem` in our case) needs to have a meth
 ability to covariantly specify a lower bound of contravariant `Predicate` in the subinterfaces of interfaces representing the container-like objects.
 
 In our example we will be able to pass a predicate that takes `? extends Threat` object and return `?  extends ThreatAwareSystem`
-from `Filtered::by` method. A simple implementation of `ThreadAwareSystem` :
+from `Filtered::by` method. A simple implementation of `ThreatAwareSystem` :
 ```java
 public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 
@@ -99,7 +99,7 @@ public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 ```
 the `filtered` method is overridden to filter the threats list by given predicate.
 
-Now if we introduce new subtype of `Thread` interface that adds probability with which given thread can appear :
+Now if we introduce a new subtype of `Threat` interface that adds probability with which given threat can appear :
 ```java
 public interface ProbableThreat extends Threat {
   double probability();
@@ -116,7 +116,7 @@ public interface ProbabilisticThreatAwareSystem extends ThreatAwareSystem {
 }
 ````
 Notice how we override the `filtered` method in `ProbabilisticThreatAwareSystem` and specify different return covariant type
-by specifing different generic types. Our interfaces are clean and not cluttered by default implementations. We
+by specifying different generic types. Our interfaces are clean and not cluttered by default implementations. We
 we will be able to filter `ProbabilisticThreatAwareSystem` by `ProbableThreat` properties :
 ```java
 public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreatAwareSystem {
diff --git a/filterer/src/main/java/com/iluwatar/filterer/App.java b/filterer/src/main/java/com/iluwatar/filterer/App.java
index 97ed24837..43de5a646 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/App.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/App.java
@@ -23,7 +23,6 @@
 
 package com.iluwatar.filterer;
 
-import com.iluwatar.filterer.threat.ProbabilisticThreatAwareSystem;
 import com.iluwatar.filterer.threat.ProbableThreat;
 import com.iluwatar.filterer.threat.SimpleProbabilisticThreatAwareSystem;
 import com.iluwatar.filterer.threat.SimpleProbableThreat;
@@ -65,24 +64,22 @@ public class App {
   private static void filteringSimpleProbableThreats() {
     LOGGER.info(" ### Filtering ProbabilisticThreatAwareSystem by probability ###");
 
-    ProbableThreat trojanArcBomb =
-            new SimpleProbableThreat("Trojan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
-    ProbableThreat rootkit =
-            new SimpleProbableThreat("Rootkit-Kernel", 2, ThreatType.ROOTKIT, 0.8);
+    var trojanArcBomb = new SimpleProbableThreat("Trojan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
+    var rootkit = new SimpleProbableThreat("Rootkit-Kernel", 2, ThreatType.ROOTKIT, 0.8);
 
     List<ProbableThreat> probableThreats = List.of(trojanArcBomb, rootkit);
 
-    ProbabilisticThreatAwareSystem probabilisticThreatAwareSystem =
-            new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
+    var probabilisticThreatAwareSystem =
+            new SimpleProbabilisticThreatAwareSystem("Sys-1", probableThreats);
 
     LOGGER.info("Filtering ProbabilisticThreatAwareSystem. Initial : "
             + probabilisticThreatAwareSystem);
 
     //Filtering using filterer
-    ProbabilisticThreatAwareSystem filtered = probabilisticThreatAwareSystem.filtered()
+    var filteredThreatAwareSystem = probabilisticThreatAwareSystem.filtered()
             .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 
-    LOGGER.info("Filtered by probability = 0.99 : " + filtered);
+    LOGGER.info("Filtered by probability = 0.99 : " + filteredThreatAwareSystem);
   }
 
   /**
@@ -93,16 +90,16 @@ public class App {
   private static void filteringSimpleThreats() {
     LOGGER.info("### Filtering ThreatAwareSystem by ThreatType ###");
 
-    Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
-    Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
+    var rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
+    var trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
     List<Threat> threats = List.of(rootkit, trojan);
 
-    ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
+    var threatAwareSystem = new SimpleThreatAwareSystem("Sys-1", threats);
 
     LOGGER.info("Filtering ThreatAwareSystem. Initial : " + threatAwareSystem);
 
     //Filtering using Filterer
-    ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
+    var rootkitThreatAwareSystem = threatAwareSystem.filtered()
             .by(threat -> threat.type() == ThreatType.ROOTKIT);
 
     LOGGER.info("Filtered by threatType = ROOTKIT : " + rootkitThreatAwareSystem);
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
index 37fae6a74..3991d975e 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
@@ -93,7 +93,7 @@ public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreat
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleProbabilisticThreatAwareSystem that = (SimpleProbabilisticThreatAwareSystem) o;
+    var that = (SimpleProbabilisticThreatAwareSystem) o;
     return systemId.equals(that.systemId)
             && threats.equals(that.threats);
   }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
index 27efc740a..54da07873 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
@@ -60,7 +60,7 @@ public class SimpleProbableThreat extends SimpleThreat implements ProbableThreat
     if (!super.equals(o)) {
       return false;
     }
-    SimpleProbableThreat that = (SimpleProbableThreat) o;
+    var that = (SimpleProbableThreat) o;
     return Double.compare(that.probability, probability) == 0;
   }
 
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
index fe7f155d4..08a8b0e17 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
@@ -79,7 +79,7 @@ public class SimpleThreat implements Threat {
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleThreat that = (SimpleThreat) o;
+    var that = (SimpleThreat) o;
     return id == that.id
             && threatType == that.threatType
             && Objects.equals(name, that.name);
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
index 49707cf50..f1dec40ae 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
@@ -87,7 +87,7 @@ public class SimpleThreatAwareSystem implements ThreatAwareSystem {
     if (o == null || getClass() != o.getClass()) {
       return false;
     }
-    SimpleThreatAwareSystem that = (SimpleThreatAwareSystem) o;
+    var that = (SimpleThreatAwareSystem) o;
     return systemId.equals(that.systemId)
             && issues.equals(that.issues);
   }
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
index 592fabe88..2f14ca057 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
@@ -33,15 +33,15 @@ class SimpleProbabilisticThreatAwareSystemTest {
   @Test
   void shouldFilterByProbability() {
     //given
-    ProbableThreat trojan = new SimpleProbableThreat("Troyan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
-    ProbableThreat rootkit = new SimpleProbableThreat("Rootkit-System", 2, ThreatType.ROOTKIT, 0.8);
+    var trojan = new SimpleProbableThreat("Troyan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
+    var rootkit = new SimpleProbableThreat("Rootkit-System", 2, ThreatType.ROOTKIT, 0.8);
     List<ProbableThreat> probableThreats = List.of(trojan, rootkit);
 
-    ProbabilisticThreatAwareSystem simpleProbabilisticThreatAwareSystem =
+    var simpleProbabilisticThreatAwareSystem =
             new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
 
     //when
-    ProbabilisticThreatAwareSystem filtered = simpleProbabilisticThreatAwareSystem.filtered()
+    var filtered = simpleProbabilisticThreatAwareSystem.filtered()
             .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 
     //then
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
index 91fb62718..ea918c9ec 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
@@ -33,14 +33,14 @@ class SimpleThreatAwareSystemTest {
   @Test
   void shouldFilterByThreatType() {
     //given
-    Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
-    Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
+    var rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
+    var trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
     List<Threat> threats = List.of(rootkit, trojan);
 
-    ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
+    var threatAwareSystem = new SimpleThreatAwareSystem("System-1", threats);
 
     //when
-    ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
+    var rootkitThreatAwareSystem = threatAwareSystem.filtered()
             .by(threat -> threat.type() == ThreatType.ROOTKIT);
 
     //then

From 7411ea86bf6c2ea375d238f98b9d5a1d504d7c71 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 23 Aug 2020 13:59:14 +0000
Subject: [PATCH 030/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b0e297f82..d186a560b 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-127-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-128-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -259,6 +259,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4" width="100px;" alt=""/><br /><sub><b>Toxic Dreamz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ToxicDreamz" title="Code">💻</a></td>
     <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4" width="100px;" alt=""/><br /><sub><b>Edy Cu Tjong</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=edycutjong" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4" width="100px;" alt=""/><br /><sub><b>Michał Krzywański</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mkrzywanski" title="Code">💻</a></td>
   </tr>
 </table>
 

From c18282ad5d3cf69e024288571b14edca1777f3d3 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 23 Aug 2020 13:59:15 +0000
Subject: [PATCH 031/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index b968e8c31..18a590cc5 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1158,6 +1158,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "mkrzywanski",
+      "name": "Michał Krzywański",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/15279585?v=4",
+      "profile": "https://github.com/mkrzywanski",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 0cba30784430fe001a6fe944494d9459b9b55b72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 23 Aug 2020 17:06:37 +0300
Subject: [PATCH 032/254] Fix readme filename

---
 filterer/{README.MD => README.md} | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename filterer/{README.MD => README.md} (98%)

diff --git a/filterer/README.MD b/filterer/README.md
similarity index 98%
rename from filterer/README.MD
rename to filterer/README.md
index 0c03e21a9..9ac49d6f8 100644
--- a/filterer/README.MD
+++ b/filterer/README.md
@@ -1,4 +1,4 @@
---- # this is so called 'Yaml Front Matter', read up on it here: http://jekyllrb.com/docs/frontmatter/
+---
 layout: pattern
 title: Filterer
 folder: filterer

From 015b4181145680e4b93f1fc54895aacb1238cdbe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 23 Aug 2020 18:03:29 +0300
Subject: [PATCH 033/254] Update README.md

---
 filterer/README.md | 97 +++++++++++++++++++++++++++++++---------------
 1 file changed, 66 insertions(+), 31 deletions(-)

diff --git a/filterer/README.md b/filterer/README.md
index 9ac49d6f8..89dc87e84 100644
--- a/filterer/README.md
+++ b/filterer/README.md
@@ -11,27 +11,33 @@ tags:
 ---
 
 ## Name / classification
+
 Filterer
 
 ## Intent
-The intent of this design pattern is to introduce a functional interface that will add a functionality for container-like objects to easily return filtered versions of themselves.
+
+The intent of this design pattern is to introduce a functional interface that will add a 
+functionality for container-like objects to easily return filtered versions of themselves.
 
 ## Explanation
+
 Real world example
 
-> We are designing a threat(malware) detection system. We can have different types of threats and systems. We have a requirement that
-> system should be aware of threats that are present in it. In the design we have to take into consideration that new Threat types can be
-> added later. Also there is a requirement that a system can filter itself based on the threats that it possesses (system acts as container-like object for threats).
->
+> We are designing a threat (malware) detection software which can analyze target systems for 
+> threats that are present in it. In the design we have to take into consideration that new 
+> Threat types can be added later. Additionally, there is a requirement that the threat detection 
+> system can filter the detected threats based on different criteria (the target system acts as 
+> container-like object for threats).
 
 In plain words
 
-> We need to be able to filter different types of systems(container-like objects) based on properties of Threats that they contain.
-> Adding new properties for Threats should be easy (we still need the ability to filter by those new properties).
+> Filterer pattern is a design pattern that helps container-like objects return filtered versions 
+> of themselves. 
 
 **Programmatic Example**
 
-To model the threat detection example presented above we introduce `Threat` and `ThreatAwareSystem` interfaces.
+To model the threat detection example presented above we introduce `Threat` and `ThreatAwareSystem` 
+interfaces.
 
 ```java
 public interface Threat {
@@ -47,19 +53,26 @@ public interface ThreatAwareSystem {
 
 }
 ```
-Notice the `filtered` method that returns instance of `Filterer` interface which is defined as :
+
+Notice the `filtered` method that returns instance of `Filterer` interface which is defined as:
+
 ```java
 @FunctionalInterface
 public interface Filterer<G, E> {
   G by(Predicate<? super E> predicate);
 }
 ```
-it is used to fulfill the requirement for system to be able to filter itself based on threat properties.
-The container-like object (`ThreatAwareSystem` in our case) needs to have a method that returns an instance of `Filterer`. This helper interface gives 
-ability to covariantly specify a lower bound of contravariant `Predicate` in the subinterfaces of interfaces representing the container-like objects.
 
-In our example we will be able to pass a predicate that takes `? extends Threat` object and return `?  extends ThreatAwareSystem`
-from `Filtered::by` method. A simple implementation of `ThreatAwareSystem` :
+It is used to fulfill the requirement for system to be able to filter itself based on threat 
+properties. The container-like object (`ThreatAwareSystem` in our case) needs to have a method that 
+returns an instance of `Filterer`. This helper interface gives ability to covariantly specify a 
+lower bound of contravariant `Predicate` in the subinterfaces of interfaces representing the 
+container-like objects.
+
+In our example we will be able to pass a predicate that takes `? extends Threat` object and 
+return `?  extends ThreatAwareSystem` from `Filtered::by` method. A simple implementation 
+of `ThreatAwareSystem`:
+
 ```java
 public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 
@@ -97,15 +110,21 @@ public class SimpleThreatAwareSystem implements ThreatAwareSystem {
   }
 }
 ```
-the `filtered` method is overridden to filter the threats list by given predicate.
 
-Now if we introduce a new subtype of `Threat` interface that adds probability with which given threat can appear :
+The `filtered` method is overridden to filter the threats list by given predicate.
+
+Now if we introduce a new subtype of `Threat` interface that adds probability with which given 
+threat can appear:
+
 ```java
 public interface ProbableThreat extends Threat {
   double probability();
 }
 ```
-we can also introduce a new interface that represents a system that is aware of threats with their probabilities :
+
+We can also introduce a new interface that represents a system that is aware of threats with their 
+probabilities:
+
 ````java
 public interface ProbabilisticThreatAwareSystem extends ThreatAwareSystem {
   @Override
@@ -115,9 +134,12 @@ public interface ProbabilisticThreatAwareSystem extends ThreatAwareSystem {
   Filterer<? extends ProbabilisticThreatAwareSystem, ? extends ProbableThreat> filtered();
 }
 ````
-Notice how we override the `filtered` method in `ProbabilisticThreatAwareSystem` and specify different return covariant type
-by specifying different generic types. Our interfaces are clean and not cluttered by default implementations. We
-we will be able to filter `ProbabilisticThreatAwareSystem` by `ProbableThreat` properties :
+
+Notice how we override the `filtered` method in `ProbabilisticThreatAwareSystem` and specify 
+different return covariant type by specifying different generic types. Our interfaces are clean and 
+not cluttered by default implementations. We we will be able to filter 
+`ProbabilisticThreatAwareSystem` by `ProbableThreat` properties:
+
 ```java
 public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreatAwareSystem {
 
@@ -156,7 +178,8 @@ public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreat
 }
 ```
 
-Now if we want filter `ThreatAwareSystem` by threat type we can do :
+Now if we want filter `ThreatAwareSystem` by threat type we can do:
+
 ```java
 Threat rootkit = new SimpleThreat(ThreatType.ROOTKIT, 1, "Simple-Rootkit");
 Threat trojan = new SimpleThreat(ThreatType.TROJAN, 2, "Simple-Trojan");
@@ -167,7 +190,9 @@ ThreatAwareSystem threatAwareSystem = new SimpleThreatAwareSystem("System-1", th
 ThreatAwareSystem rootkitThreatAwareSystem = threatAwareSystem.filtered()
            .by(threat -> threat.type() == ThreatType.ROOTKIT);
 ```
-or if we want to filter `ProbabilisticThreatAwareSystem` :
+
+Or if we want to filter `ProbabilisticThreatAwareSystem`:
+
 ```java
 ProbableThreat malwareTroyan = new SimpleProbableThreat("Troyan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
 ProbableThreat rootkit = new SimpleProbableThreat("Rootkit-System", 2, ThreatType.ROOTKIT, 0.8);
@@ -178,27 +203,37 @@ ProbabilisticThreatAwareSystem simpleProbabilisticThreatAwareSystem =new SimpleP
 ProbabilisticThreatAwareSystem filtered = simpleProbabilisticThreatAwareSystem.filtered()
            .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 ```
+
 ## Class diagram
+
 ![Filterer](./etc/filterer.png "Filterer")
 
 ## Applicability
-Pattern can be used when working with container-like objects that use subtyping, instead of parametrizing(generics) for extensible class structure.
-It enables you to easily extend filtering ability of container-like objects as business requirements change.
+
+Pattern can be used when working with container-like objects that use subtyping, instead of 
+parametrizing (generics) for extensible class structure. It enables you to easily extend filtering 
+ability of container-like objects as business requirements change.
 
 ## Tutorials
+
 * [Article about Filterer pattern posted on it's author's blog](https://blog.tlinkowski.pl/2018/filterer-pattern/)
 * [Application of Filterer pattern in domain of text analysis](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html)
 
 ## Known uses
-One of the uses is present on the blog presented in [this](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html) link. 
-It presents how to use `Filterer` pattern to create text issue analyzer with support for test cases used for unit testing.
+
+One of the uses is present on the blog presented in 
+[this](https://www.javacodegeeks.com/2019/02/filterer-pattern-10-steps.html) link. It presents how 
+to use `Filterer` pattern to create text issue analyzer with support for test cases used for unit 
+testing.
 
 ## Consequences
-Pros :
- * you can easily introduce new subtypes for container-like objects and subtypes for objects that are contained within them and still be able to filter easily be new properties of those new subtypes.
 
-Cons :
- * covariant return types mixed with generics can be sometimes tricky
+Pros:
+ * You can easily introduce new subtypes for container-like objects and subtypes for objects that are contained within them and still be able to filter easily be new properties of those new subtypes.
+
+Cons:
+ * Covariant return types mixed with generics can be sometimes tricky
 
 ## Credits
-* Author of the pattern : [Tomasz Linkowski](https://tlinkowski.pl/)
\ No newline at end of file
+
+* Author of the pattern : [Tomasz Linkowski](https://tlinkowski.pl/)

From 6d83ceba285fb2a62119f6169d8041ec05c196c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 23 Aug 2020 18:53:57 +0300
Subject: [PATCH 034/254] Update README.md

---
 bridge/README.md | 29 +++++++++++++++++++----------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/bridge/README.md b/bridge/README.md
index 82c2f2735..12a6358f5 100644
--- a/bridge/README.md
+++ b/bridge/README.md
@@ -9,20 +9,26 @@ tags:
 ---
 
 ## Also known as
+
 Handle/Body
 
 ## Intent
+
 Decouple an abstraction from its implementation so that the two can vary independently.
 
 ## Explanation
 
 Real world example
 
-> Consider you have a weapon with different enchantments and you are supposed to allow mixing different weapons with different enchantments. What would you do? Create multiple copies of each of the weapons for each of the enchantments or would you just create separate enchantment and set it for the weapon as needed? Bridge pattern allows you to do the second.
+> Consider you have a weapon with different enchantments, and you are supposed to allow mixing 
+> different weapons with different enchantments. What would you do? Create multiple copies of each 
+> of the weapons for each of the enchantments or would you just create separate enchantment and set 
+> it for the weapon as needed? Bridge pattern allows you to do the second.
 
 In Plain Words
 
-> Bridge pattern is about preferring composition over inheritance. Implementation details are pushed from a hierarchy to another object with a separate hierarchy.
+> Bridge pattern is about preferring composition over inheritance. Implementation details are pushed 
+> from a hierarchy to another object with a separate hierarchy.
 
 Wikipedia says
 
@@ -30,7 +36,7 @@ Wikipedia says
 
 **Programmatic Example**
 
-Translating our weapon example from above. Here we have the `Weapon` hierarchy
+Translating our weapon example from above. Here we have the `Weapon` hierarchy:
 
 ```java
 public interface Weapon {
@@ -105,7 +111,7 @@ public class Hammer implements Weapon {
 }
 ```
 
-And the separate enchantment hierarchy
+Here's the separate enchantment hierarchy:
 
 ```java
 public interface Enchantment {
@@ -151,7 +157,7 @@ public class SoulEatingEnchantment implements Enchantment {
 }
 ```
 
-And both the hierarchies in action
+Here are both hierarchies in action:
 
 ```java
 var enchantedSword = new Sword(new SoulEatingEnchantment());
@@ -178,18 +184,21 @@ hammer.unwield();
 ```
 
 ## Class diagram
+
 ![alt text](./etc/bridge.urm.png "Bridge class diagram")
 
 ## Applicability
+
 Use the Bridge pattern when
 
-* you want to avoid a permanent binding between an abstraction and its implementation. This might be the case, for example, when the implementation must be selected or switched at run-time.
-* both the abstractions and their implementations should be extensible by subclassing. In this case, the Bridge pattern lets you combine the different abstractions and implementations and extend them independently
-* changes in the implementation of an abstraction should have no impact on clients; that is, their code should not have to be recompiled.
-* you have a proliferation of classes. Such a class hierarchy indicates the need for splitting an object into two parts. Rumbaugh uses the term "nested generalizations" to refer to such class hierarchies
-* you want to share an implementation among multiple objects (perhaps using reference counting), and this fact should be hidden from the client. A simple example is Coplien's String class, in which multiple objects can share the same string representation.
+* You want to avoid a permanent binding between an abstraction and its implementation. This might be the case, for example, when the implementation must be selected or switched at run-time.
+* Both the abstractions and their implementations should be extensible by subclassing. In this case, the Bridge pattern lets you combine the different abstractions and implementations and extend them independently.
+* Changes in the implementation of an abstraction should have no impact on clients; that is, their code should not have to be recompiled.
+* You have a proliferation of classes. Such a class hierarchy indicates the need for splitting an object into two parts. Rumbaugh uses the term "nested generalizations" to refer to such class hierarchies.
+* You want to share an implementation among multiple objects (perhaps using reference counting), and this fact should be hidden from the client. A simple example is Coplien's String class, in which multiple objects can share the same string representation.
 
 ## Tutorial
+
 * [Bridge Pattern Tutorial](https://www.journaldev.com/1491/bridge-design-pattern-java)
 
 ## Credits

From 3754c666045c1420d9bd118bc0f4ea8fee85a680 Mon Sep 17 00:00:00 2001
From: Stefan Birkner <mail@stefan-birkner.de>
Date: Mon, 24 Aug 2020 23:12:45 +0200
Subject: [PATCH 035/254] Replace System Rules with System Lambda

System Lambda is more specific. It only wraps the part of the code that
produces the output.
---
 pom.xml                                       |  6 +--
 subclass-sandbox/pom.xml                      |  2 +-
 .../subclasssandbox/GroundDiveTest.java       | 38 +++++++++---------
 .../subclasssandbox/SkyLaunchTest.java        | 39 +++++++++----------
 4 files changed, 40 insertions(+), 45 deletions(-)

diff --git a/pom.xml b/pom.xml
index 1275ce115..3b7ad3568 100644
--- a/pom.xml
+++ b/pom.xml
@@ -52,7 +52,7 @@
         <jaxb-api.version>2.3.1</jaxb-api.version>
         <jaxb-impl.version>2.3.2</jaxb-impl.version>
         <annotation-api.version>1.3.2</annotation-api.version>
-        <system-rules.version>1.19.0</system-rules.version>
+        <system-lambda.version>1.1.0</system-lambda.version>
         <urm.version>2.0.0</urm.version>
         <mockito-junit-jupiter.version>3.5.0</mockito-junit-jupiter.version>
         <!-- SonarCloud -->
@@ -338,8 +338,8 @@
             </dependency>
             <dependency>
                 <groupId>com.github.stefanbirkner</groupId>
-                <artifactId>system-rules</artifactId>
-                <version>${system-rules.version}</version>
+                <artifactId>system-lambda</artifactId>
+                <version>${system-lambda.version}</version>
                 <scope>test</scope>
             </dependency>
         </dependencies>
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index ac718291e..a912ada3f 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -42,7 +42,7 @@
         </dependency>
         <dependency>
             <groupId>com.github.stefanbirkner</groupId>
-            <artifactId>system-rules</artifactId>
+            <artifactId>system-lambda</artifactId>
         </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
index 97e2ac67d..3b379946c 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
@@ -23,55 +23,48 @@
 
 package com.iluwatar.subclasssandbox;
 
+import com.github.stefanbirkner.systemlambda.Statement;
 import org.junit.Assert;
-import org.junit.Rule;
 import org.junit.Test;
-import org.junit.contrib.java.lang.system.SystemOutRule;
+
+import static com.github.stefanbirkner.systemlambda.SystemLambda.tapSystemOutNormalized;
 
 /**
  * GroundDive unit tests.
  */
 public class GroundDiveTest {
 
-  @Rule
-  public SystemOutRule log = new SystemOutRule().enableLog();
-
   @Test
-  public void testMove() {
-    log.clearLog();
+  public void testMove() throws Exception {
     var groundDive = new GroundDive();
     groundDive.move(1.0, 1.0, 1.0);
-    var outputLog = getLogContent(log.getLog());
+    var outputLog = getLogContent(() -> groundDive.move(1.0, 1.0, 1.0));
     var expectedLog = "Move to ( 1.0, 1.0, 1.0 )";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testPlaySound() {
-    log.clearLog();
+  public void testPlaySound() throws Exception {
     var groundDive = new GroundDive();
-    groundDive.playSound("SOUND_NAME", 1);
-    var outputLog = getLogContent(log.getLog());
+    var outputLog = getLogContent(() -> groundDive.playSound("SOUND_NAME", 1));
     var expectedLog = "Play SOUND_NAME with volumn 1";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testSpawnParticles() {
-    log.clearLog();
+  public void testSpawnParticles() throws Exception {
     var groundDive = new GroundDive();
-    groundDive.spawnParticles("PARTICLE_TYPE", 100);
-    final var outputLog = getLogContent(log.getLog());
+    final var outputLog = getLogContent(
+            () -> groundDive.spawnParticles("PARTICLE_TYPE", 100));
     final var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testActivate() {
-    log.clearLog();
+  public void testActivate() throws Exception {
     var groundDive = new GroundDive();
-    groundDive.activate();
-    var logs = log.getLog().split("\n");
+    var logs = tapSystemOutNormalized(groundDive::activate)
+            .split("\n");
     final var expectedSize = 3;
     final var log1 = logs[0].split("-")[1].trim() + " -" + logs[0].split("-")[2].trim();
     final var expectedLog1 = "Move to ( 0.0, 0.0, -20.0 )";
@@ -85,6 +78,11 @@ public class GroundDiveTest {
     Assert.assertEquals(log3, expectedLog3);
   }
 
+  private String getLogContent(Statement statement) throws Exception {
+    var log = tapSystemOutNormalized(statement);
+    return getLogContent(log);
+  }
+
   private String getLogContent(String log) {
     return log.split("-")[1].trim();
   }
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
index e192737f6..d285e6c7d 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
@@ -23,55 +23,47 @@
 
 package com.iluwatar.subclasssandbox;
 
+import com.github.stefanbirkner.systemlambda.Statement;
 import org.junit.Assert;
-import org.junit.Rule;
 import org.junit.Test;
-import org.junit.contrib.java.lang.system.SystemOutRule;
+
+import static com.github.stefanbirkner.systemlambda.SystemLambda.tapSystemOutNormalized;
 
 /**
  * SkyLaunch unit tests.
  */
 public class SkyLaunchTest {
 
-  @Rule
-  public SystemOutRule log = new SystemOutRule().enableLog();
-
   @Test
-  public void testMove() {
-    log.clearLog();
+  public void testMove() throws Exception {
     var skyLaunch = new SkyLaunch();
-    skyLaunch.move(1.0, 1.0, 1.0);
-    var outputLog = getLogContent(log.getLog());
+    var outputLog = getLogContent(() -> skyLaunch.move(1.0, 1.0, 1.0));
     var expectedLog = "Move to ( 1.0, 1.0, 1.0 )";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testPlaySound() {
-    log.clearLog();
+  public void testPlaySound() throws Exception {
     var skyLaunch = new SkyLaunch();
-    skyLaunch.playSound("SOUND_NAME", 1);
-    var outputLog = getLogContent(log.getLog());
+    var outputLog = getLogContent(() -> skyLaunch.playSound("SOUND_NAME", 1));
     var expectedLog = "Play SOUND_NAME with volumn 1";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testSpawnParticles() {
-    log.clearLog();
+  public void testSpawnParticles() throws Exception {
     var skyLaunch = new SkyLaunch();
-    skyLaunch.spawnParticles("PARTICLE_TYPE", 100);
-    var outputLog = getLogContent(log.getLog());
+    var outputLog = getLogContent(
+            () -> skyLaunch.spawnParticles("PARTICLE_TYPE", 100));
     var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
     Assert.assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testActivate() {
-    log.clearLog();
+  public void testActivate() throws Exception {
     var skyLaunch = new SkyLaunch();
-    skyLaunch.activate();
-    var logs = log.getLog().split("\n");
+    var logs = tapSystemOutNormalized(skyLaunch::activate)
+            .split("\n");
     final var expectedSize = 3;
     final var log1 = getLogContent(logs[0]);
     final var expectedLog1 = "Move to ( 0.0, 0.0, 20.0 )";
@@ -85,6 +77,11 @@ public class SkyLaunchTest {
     Assert.assertEquals(log3, expectedLog3);
   }
 
+  private String getLogContent(Statement statement) throws Exception {
+    var log = tapSystemOutNormalized(statement);
+    return getLogContent(log);
+  }
+
   private String getLogContent(String log) {
     return log.split("-")[1].trim();
   }

From b8f83c326dceb92290b31480a074c92058760989 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 25 Aug 2020 14:42:53 +0000
Subject: [PATCH 036/254] docs: update README.md [skip ci]

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d186a560b..95fe7a912 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-128-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-129-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -261,6 +261,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4" width="100px;" alt=""/><br /><sub><b>Edy Cu Tjong</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=edycutjong" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4" width="100px;" alt=""/><br /><sub><b>Michał Krzywański</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mkrzywanski" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From 96aa21d0e886a9858637f30c0110aedf5f752c2d Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 25 Aug 2020 14:42:54 +0000
Subject: [PATCH 037/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 18a590cc5..65eb0bf92 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1167,6 +1167,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "stefanbirkner",
+      "name": "Stefan Birkner",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/711349?v=4",
+      "profile": "https://www.stefan-birkner.de",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From a0e5d061cbb55d4eb0cca1798e545ccbbb391de0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 25 Aug 2020 21:20:30 +0300
Subject: [PATCH 038/254] Milestone 1.23.0

---
 abstract-document/pom.xml                                 | 2 +-
 abstract-factory/pom.xml                                  | 2 +-
 acyclic-visitor/pom.xml                                   | 2 +-
 adapter/pom.xml                                           | 2 +-
 aggregator-microservices/aggregator-service/pom.xml       | 2 +-
 aggregator-microservices/information-microservice/pom.xml | 2 +-
 aggregator-microservices/inventory-microservice/pom.xml   | 2 +-
 aggregator-microservices/pom.xml                          | 2 +-
 ambassador/pom.xml                                        | 2 +-
 api-gateway/api-gateway-service/pom.xml                   | 2 +-
 api-gateway/image-microservice/pom.xml                    | 2 +-
 api-gateway/pom.xml                                       | 2 +-
 api-gateway/price-microservice/pom.xml                    | 2 +-
 arrange-act-assert/pom.xml                                | 2 +-
 async-method-invocation/pom.xml                           | 2 +-
 balking/pom.xml                                           | 2 +-
 bridge/pom.xml                                            | 2 +-
 builder/pom.xml                                           | 2 +-
 business-delegate/pom.xml                                 | 2 +-
 bytecode/pom.xml                                          | 2 +-
 caching/pom.xml                                           | 2 +-
 callback/pom.xml                                          | 2 +-
 chain/pom.xml                                             | 2 +-
 circuit-breaker/pom.xml                                   | 2 +-
 collection-pipeline/pom.xml                               | 2 +-
 combinator/pom.xml                                        | 2 +-
 command/pom.xml                                           | 2 +-
 commander/pom.xml                                         | 2 +-
 composite/pom.xml                                         | 2 +-
 converter/pom.xml                                         | 2 +-
 cqrs/pom.xml                                              | 2 +-
 dao/pom.xml                                               | 2 +-
 data-bus/pom.xml                                          | 2 +-
 data-locality/pom.xml                                     | 2 +-
 data-mapper/pom.xml                                       | 2 +-
 data-transfer-object/pom.xml                              | 2 +-
 decorator/pom.xml                                         | 2 +-
 delegation/pom.xml                                        | 2 +-
 dependency-injection/pom.xml                              | 2 +-
 dirty-flag/pom.xml                                        | 4 ++--
 double-buffer/pom.xml                                     | 2 +-
 double-checked-locking/pom.xml                            | 2 +-
 double-dispatch/pom.xml                                   | 2 +-
 eip-aggregator/pom.xml                                    | 2 +-
 eip-message-channel/pom.xml                               | 2 +-
 eip-publish-subscribe/pom.xml                             | 2 +-
 eip-splitter/pom.xml                                      | 2 +-
 eip-wire-tap/pom.xml                                      | 2 +-
 event-aggregator/pom.xml                                  | 2 +-
 event-asynchronous/pom.xml                                | 2 +-
 event-driven-architecture/pom.xml                         | 2 +-
 event-queue/pom.xml                                       | 2 +-
 event-sourcing/pom.xml                                    | 2 +-
 execute-around/pom.xml                                    | 2 +-
 extension-objects/pom.xml                                 | 2 +-
 facade/pom.xml                                            | 2 +-
 factory-kit/pom.xml                                       | 2 +-
 factory-method/pom.xml                                    | 2 +-
 feature-toggle/pom.xml                                    | 2 +-
 filterer/pom.xml                                          | 2 +-
 fluentinterface/pom.xml                                   | 2 +-
 flux/pom.xml                                              | 2 +-
 flyweight/pom.xml                                         | 2 +-
 front-controller/pom.xml                                  | 2 +-
 game-loop/pom.xml                                         | 2 +-
 guarded-suspension/pom.xml                                | 2 +-
 half-sync-half-async/pom.xml                              | 2 +-
 hexagonal/pom.xml                                         | 2 +-
 intercepting-filter/pom.xml                               | 2 +-
 interpreter/pom.xml                                       | 2 +-
 iterator/pom.xml                                          | 2 +-
 layers/pom.xml                                            | 2 +-
 lazy-loading/pom.xml                                      | 2 +-
 leader-election/pom.xml                                   | 2 +-
 leader-followers/pom.xml                                  | 2 +-
 marker/pom.xml                                            | 2 +-
 master-worker-pattern/pom.xml                             | 2 +-
 mediator/pom.xml                                          | 2 +-
 memento/pom.xml                                           | 2 +-
 model-view-controller/pom.xml                             | 2 +-
 model-view-presenter/pom.xml                              | 2 +-
 module/pom.xml                                            | 2 +-
 monad/pom.xml                                             | 2 +-
 monostate/pom.xml                                         | 2 +-
 multiton/pom.xml                                          | 2 +-
 mute-idiom/pom.xml                                        | 2 +-
 mutex/pom.xml                                             | 2 +-
 naked-objects/dom/pom.xml                                 | 2 +-
 naked-objects/fixture/pom.xml                             | 2 +-
 naked-objects/integtests/pom.xml                          | 2 +-
 naked-objects/pom.xml                                     | 8 ++++----
 naked-objects/webapp/pom.xml                              | 2 +-
 null-object/pom.xml                                       | 2 +-
 object-mother/pom.xml                                     | 2 +-
 object-pool/pom.xml                                       | 2 +-
 observer/pom.xml                                          | 2 +-
 page-object/pom.xml                                       | 2 +-
 page-object/sample-application/pom.xml                    | 2 +-
 page-object/test-automation/pom.xml                       | 2 +-
 partial-response/pom.xml                                  | 2 +-
 pipeline/pom.xml                                          | 2 +-
 poison-pill/pom.xml                                       | 2 +-
 pom.xml                                                   | 2 +-
 priority-queue/pom.xml                                    | 2 +-
 private-class-data/pom.xml                                | 2 +-
 producer-consumer/pom.xml                                 | 2 +-
 promise/pom.xml                                           | 2 +-
 property/pom.xml                                          | 2 +-
 prototype/pom.xml                                         | 2 +-
 proxy/pom.xml                                             | 2 +-
 queue-load-leveling/pom.xml                               | 2 +-
 reactor/pom.xml                                           | 2 +-
 reader-writer-lock/pom.xml                                | 2 +-
 repository/pom.xml                                        | 2 +-
 resource-acquisition-is-initialization/pom.xml            | 2 +-
 retry/pom.xml                                             | 2 +-
 role-object/pom.xml                                       | 2 +-
 saga/pom.xml                                              | 2 +-
 semaphore/pom.xml                                         | 2 +-
 servant/pom.xml                                           | 2 +-
 serverless/pom.xml                                        | 2 +-
 service-layer/pom.xml                                     | 2 +-
 service-locator/pom.xml                                   | 2 +-
 sharding/pom.xml                                          | 2 +-
 singleton/pom.xml                                         | 2 +-
 spatial-partition/pom.xml                                 | 2 +-
 specification/pom.xml                                     | 2 +-
 state/pom.xml                                             | 2 +-
 step-builder/pom.xml                                      | 2 +-
 strangler/pom.xml                                         | 2 +-
 strategy/pom.xml                                          | 2 +-
 subclass-sandbox/pom.xml                                  | 2 +-
 template-method/pom.xml                                   | 2 +-
 thread-pool/pom.xml                                       | 2 +-
 throttling/pom.xml                                        | 2 +-
 tls/pom.xml                                               | 2 +-
 tolerant-reader/pom.xml                                   | 2 +-
 trampoline/pom.xml                                        | 2 +-
 transaction-script/pom.xml                                | 2 +-
 twin/pom.xml                                              | 2 +-
 typeobjectpattern/pom.xml                                 | 2 +-
 unit-of-work/pom.xml                                      | 2 +-
 update-method/pom.xml                                     | 2 +-
 value-object/pom.xml                                      | 2 +-
 visitor/pom.xml                                           | 2 +-
 145 files changed, 149 insertions(+), 149 deletions(-)

diff --git a/abstract-document/pom.xml b/abstract-document/pom.xml
index 5a19c3c81..a285e2d82 100644
--- a/abstract-document/pom.xml
+++ b/abstract-document/pom.xml
@@ -21,7 +21,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>abstract-document</artifactId>
 	<dependencies>
diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index 614b26232..4fe0b58cd 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>abstract-factory</artifactId>
 	<dependencies>
diff --git a/acyclic-visitor/pom.xml b/acyclic-visitor/pom.xml
index 24bab933a..41a126d27 100644
--- a/acyclic-visitor/pom.xml
+++ b/acyclic-visitor/pom.xml
@@ -21,7 +21,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 
 	<artifactId>acyclic-visitor</artifactId>
diff --git a/adapter/pom.xml b/adapter/pom.xml
index 4c725def8..2cd449c06 100644
--- a/adapter/pom.xml
+++ b/adapter/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>adapter</artifactId>
 	<dependencies>
diff --git a/aggregator-microservices/aggregator-service/pom.xml b/aggregator-microservices/aggregator-service/pom.xml
index f4482d0e3..8f1e2ad06 100644
--- a/aggregator-microservices/aggregator-service/pom.xml
+++ b/aggregator-microservices/aggregator-service/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>aggregator-service</artifactId>
diff --git a/aggregator-microservices/information-microservice/pom.xml b/aggregator-microservices/information-microservice/pom.xml
index f99d26b65..bde50bd98 100644
--- a/aggregator-microservices/information-microservice/pom.xml
+++ b/aggregator-microservices/information-microservice/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/aggregator-microservices/inventory-microservice/pom.xml b/aggregator-microservices/inventory-microservice/pom.xml
index f7899aa8f..76d506ed1 100644
--- a/aggregator-microservices/inventory-microservice/pom.xml
+++ b/aggregator-microservices/inventory-microservice/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>inventory-microservice</artifactId>
diff --git a/aggregator-microservices/pom.xml b/aggregator-microservices/pom.xml
index a63ec2f12..e6bf655f7 100644
--- a/aggregator-microservices/pom.xml
+++ b/aggregator-microservices/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <artifactId>aggregator-microservices</artifactId>
diff --git a/ambassador/pom.xml b/ambassador/pom.xml
index 6d6a9894d..33f623457 100644
--- a/ambassador/pom.xml
+++ b/ambassador/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>ambassador</artifactId>
diff --git a/api-gateway/api-gateway-service/pom.xml b/api-gateway/api-gateway-service/pom.xml
index 744023e90..08c7d47dc 100644
--- a/api-gateway/api-gateway-service/pom.xml
+++ b/api-gateway/api-gateway-service/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>api-gateway-service</artifactId>
diff --git a/api-gateway/image-microservice/pom.xml b/api-gateway/image-microservice/pom.xml
index 27ef343af..ba055bd71 100644
--- a/api-gateway/image-microservice/pom.xml
+++ b/api-gateway/image-microservice/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>image-microservice</artifactId>
diff --git a/api-gateway/pom.xml b/api-gateway/pom.xml
index 63a986996..0edcbc83a 100644
--- a/api-gateway/pom.xml
+++ b/api-gateway/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>api-gateway</artifactId>
diff --git a/api-gateway/price-microservice/pom.xml b/api-gateway/price-microservice/pom.xml
index e7b144c58..6b61ff2e5 100644
--- a/api-gateway/price-microservice/pom.xml
+++ b/api-gateway/price-microservice/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
 
   <modelVersion>4.0.0</modelVersion>
diff --git a/arrange-act-assert/pom.xml b/arrange-act-assert/pom.xml
index bb0387e7a..c00660b01 100644
--- a/arrange-act-assert/pom.xml
+++ b/arrange-act-assert/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index 46aa9d354..32adc0508 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>async-method-invocation</artifactId>
 	<dependencies>
diff --git a/balking/pom.xml b/balking/pom.xml
index 964531692..6d789244c 100644
--- a/balking/pom.xml
+++ b/balking/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/bridge/pom.xml b/bridge/pom.xml
index 0664bc9b5..ae50aba2e 100644
--- a/bridge/pom.xml
+++ b/bridge/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>bridge</artifactId>
 	<dependencies>
diff --git a/builder/pom.xml b/builder/pom.xml
index dab9c66a7..069f6f841 100644
--- a/builder/pom.xml
+++ b/builder/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>builder</artifactId>
 	<dependencies>
diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml
index 26987c73a..9f7e3ea70 100644
--- a/business-delegate/pom.xml
+++ b/business-delegate/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>business-delegate</artifactId>
 	<dependencies>
diff --git a/bytecode/pom.xml b/bytecode/pom.xml
index f6be69cee..cfae54ad1 100644
--- a/bytecode/pom.xml
+++ b/bytecode/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/caching/pom.xml b/caching/pom.xml
index 704dd78d0..82e7546f5 100644
--- a/caching/pom.xml
+++ b/caching/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>caching</artifactId>
   <dependencies>
diff --git a/callback/pom.xml b/callback/pom.xml
index c156527f5..a493c2cab 100644
--- a/callback/pom.xml
+++ b/callback/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>callback</artifactId>
   <dependencies>
diff --git a/chain/pom.xml b/chain/pom.xml
index cf70ad1e8..40966eebf 100644
--- a/chain/pom.xml
+++ b/chain/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>chain</artifactId>
   <dependencies>
diff --git a/circuit-breaker/pom.xml b/circuit-breaker/pom.xml
index fd9f85675..4df9aacd3 100644
--- a/circuit-breaker/pom.xml
+++ b/circuit-breaker/pom.xml
@@ -27,7 +27,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>circuit-breaker</artifactId>
     <dependencies>
diff --git a/collection-pipeline/pom.xml b/collection-pipeline/pom.xml
index 6d8d467ad..e8de7ff33 100644
--- a/collection-pipeline/pom.xml
+++ b/collection-pipeline/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>collection-pipeline</artifactId>
   <dependencies>
diff --git a/combinator/pom.xml b/combinator/pom.xml
index c2677fcc1..62c6a6658 100644
--- a/combinator/pom.xml
+++ b/combinator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
 
   <artifactId>combinator</artifactId>
diff --git a/command/pom.xml b/command/pom.xml
index 50a14c45f..557f2cd89 100644
--- a/command/pom.xml
+++ b/command/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>command</artifactId>
   <dependencies>
diff --git a/commander/pom.xml b/commander/pom.xml
index 7ab29e421..8b87442ae 100644
--- a/commander/pom.xml
+++ b/commander/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>commander</artifactId>
   <dependencies>
diff --git a/composite/pom.xml b/composite/pom.xml
index c16b95c13..5e41920d7 100644
--- a/composite/pom.xml
+++ b/composite/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>composite</artifactId>
   <dependencies>
diff --git a/converter/pom.xml b/converter/pom.xml
index 56eb2ccdb..b19db2bae 100644
--- a/converter/pom.xml
+++ b/converter/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>converter</artifactId>
 	<modelVersion>4.0.0</modelVersion>
diff --git a/cqrs/pom.xml b/cqrs/pom.xml
index b3a0303e6..57570fff4 100644
--- a/cqrs/pom.xml
+++ b/cqrs/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>cqrs</artifactId>
 	<dependencies>
diff --git a/dao/pom.xml b/dao/pom.xml
index 7e8bd5625..ead5e030f 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>dao</artifactId>
 
diff --git a/data-bus/pom.xml b/data-bus/pom.xml
index e67135ae0..cc3553336 100644
--- a/data-bus/pom.xml
+++ b/data-bus/pom.xml
@@ -33,7 +33,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>data-bus</artifactId>
     <dependencies>
diff --git a/data-locality/pom.xml b/data-locality/pom.xml
index 660daa9b7..f14676b45 100644
--- a/data-locality/pom.xml
+++ b/data-locality/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>data-locality</artifactId>
 
diff --git a/data-mapper/pom.xml b/data-mapper/pom.xml
index 64f03a186..45221020b 100644
--- a/data-mapper/pom.xml
+++ b/data-mapper/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>data-mapper</artifactId>
 	<dependencies>
diff --git a/data-transfer-object/pom.xml b/data-transfer-object/pom.xml
index 459b1ab1e..d51b62d2c 100644
--- a/data-transfer-object/pom.xml
+++ b/data-transfer-object/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>data-transfer-object</artifactId>
     <dependencies>
diff --git a/decorator/pom.xml b/decorator/pom.xml
index c7e1a4d8d..1209d5efb 100644
--- a/decorator/pom.xml
+++ b/decorator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>decorator</artifactId>
   <dependencies>
diff --git a/delegation/pom.xml b/delegation/pom.xml
index 63cd91842..8ff7c6617 100644
--- a/delegation/pom.xml
+++ b/delegation/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml
index 9baffe382..85e8cdd1c 100644
--- a/dependency-injection/pom.xml
+++ b/dependency-injection/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>dependency-injection</artifactId>
   <dependencies>
diff --git a/dirty-flag/pom.xml b/dirty-flag/pom.xml
index 372a637f1..3908dca36 100644
--- a/dirty-flag/pom.xml
+++ b/dirty-flag/pom.xml
@@ -29,10 +29,10 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>dirty-flag</artifactId>
-  <version>1.23.0-SNAPSHOT</version>
+  <version>1.23.0</version>
   <name>dirty-flag</name>
   <url>http://maven.apache.org</url>
   <properties>
diff --git a/double-buffer/pom.xml b/double-buffer/pom.xml
index cb66af1cb..e2e649fa9 100644
--- a/double-buffer/pom.xml
+++ b/double-buffer/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index a77546386..de8d27a4e 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>double-checked-locking</artifactId>
   <dependencies>
diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml
index 9582797a2..67febf5bb 100644
--- a/double-dispatch/pom.xml
+++ b/double-dispatch/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>double-dispatch</artifactId>
   <dependencies>
diff --git a/eip-aggregator/pom.xml b/eip-aggregator/pom.xml
index 578d1bbf2..c77dded15 100644
--- a/eip-aggregator/pom.xml
+++ b/eip-aggregator/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <dependencies>
diff --git a/eip-message-channel/pom.xml b/eip-message-channel/pom.xml
index bea72b1f9..02db57903 100644
--- a/eip-message-channel/pom.xml
+++ b/eip-message-channel/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>eip-message-channel</artifactId>
 	<dependencies>
diff --git a/eip-publish-subscribe/pom.xml b/eip-publish-subscribe/pom.xml
index e7b5462b6..ab98cf76a 100644
--- a/eip-publish-subscribe/pom.xml
+++ b/eip-publish-subscribe/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>eip-publish-subscribe</artifactId>
 	<dependencies>
diff --git a/eip-splitter/pom.xml b/eip-splitter/pom.xml
index 9c06f3f8d..d1bc7f9c6 100644
--- a/eip-splitter/pom.xml
+++ b/eip-splitter/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <dependencies>
diff --git a/eip-wire-tap/pom.xml b/eip-wire-tap/pom.xml
index 06cbc33db..2b122a64e 100644
--- a/eip-wire-tap/pom.xml
+++ b/eip-wire-tap/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <dependencies>
diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml
index 5553de2e3..1f3896ff3 100644
--- a/event-aggregator/pom.xml
+++ b/event-aggregator/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>event-aggregator</artifactId>
 	<dependencies>
diff --git a/event-asynchronous/pom.xml b/event-asynchronous/pom.xml
index 001b3b9a8..ccbda1f0a 100644
--- a/event-asynchronous/pom.xml
+++ b/event-asynchronous/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>event-asynchronous</artifactId>
   <dependencies>
diff --git a/event-driven-architecture/pom.xml b/event-driven-architecture/pom.xml
index 17d2795c4..b9da44c6f 100644
--- a/event-driven-architecture/pom.xml
+++ b/event-driven-architecture/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <artifactId>event-driven-architecture</artifactId>
diff --git a/event-queue/pom.xml b/event-queue/pom.xml
index fd8ce9902..1a93f9dad 100644
--- a/event-queue/pom.xml
+++ b/event-queue/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>event-queue</artifactId>
   <dependencies>
diff --git a/event-sourcing/pom.xml b/event-sourcing/pom.xml
index 0d1592abb..486f6d9e0 100644
--- a/event-sourcing/pom.xml
+++ b/event-sourcing/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>event-sourcing</artifactId>
   <dependencies>
diff --git a/execute-around/pom.xml b/execute-around/pom.xml
index 1752f04f5..65b98a10f 100644
--- a/execute-around/pom.xml
+++ b/execute-around/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>execute-around</artifactId>
   <dependencies>
diff --git a/extension-objects/pom.xml b/extension-objects/pom.xml
index 0194357ed..f6463e35f 100644
--- a/extension-objects/pom.xml
+++ b/extension-objects/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/facade/pom.xml b/facade/pom.xml
index a7fdb88f0..3847f8cbb 100644
--- a/facade/pom.xml
+++ b/facade/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>facade</artifactId>
   <dependencies>
diff --git a/factory-kit/pom.xml b/factory-kit/pom.xml
index 87f27b341..521e6340f 100644
--- a/factory-kit/pom.xml
+++ b/factory-kit/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>factory-kit</artifactId>
     <dependencies>
diff --git a/factory-method/pom.xml b/factory-method/pom.xml
index 5f0358d4d..8038a1ff9 100644
--- a/factory-method/pom.xml
+++ b/factory-method/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>factory-method</artifactId>
   <dependencies>
diff --git a/feature-toggle/pom.xml b/feature-toggle/pom.xml
index 13f646b80..a44eae026 100644
--- a/feature-toggle/pom.xml
+++ b/feature-toggle/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/filterer/pom.xml b/filterer/pom.xml
index 4477332ae..e64ac9846 100644
--- a/filterer/pom.xml
+++ b/filterer/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index 9eb063c13..28e573258 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/flux/pom.xml b/flux/pom.xml
index 8effd0fc9..00435f835 100644
--- a/flux/pom.xml
+++ b/flux/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>flux</artifactId>
   <dependencies>
diff --git a/flyweight/pom.xml b/flyweight/pom.xml
index f3a8082b5..574f5b516 100644
--- a/flyweight/pom.xml
+++ b/flyweight/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>flyweight</artifactId>
   <dependencies>
diff --git a/front-controller/pom.xml b/front-controller/pom.xml
index 34dabc182..447e341fd 100644
--- a/front-controller/pom.xml
+++ b/front-controller/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>front-controller</artifactId>
 	<dependencies>
diff --git a/game-loop/pom.xml b/game-loop/pom.xml
index 706d3cff4..33a671449 100644
--- a/game-loop/pom.xml
+++ b/game-loop/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/guarded-suspension/pom.xml b/guarded-suspension/pom.xml
index 791c696c1..81cf96084 100644
--- a/guarded-suspension/pom.xml
+++ b/guarded-suspension/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <packaging>jar</packaging>
   <artifactId>guarded-suspension</artifactId>
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index fdb37edb0..e101a849c 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>half-sync-half-async</artifactId>
   <dependencies>
diff --git a/hexagonal/pom.xml b/hexagonal/pom.xml
index 4873d0ddb..3a932749b 100644
--- a/hexagonal/pom.xml
+++ b/hexagonal/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>hexagonal</artifactId>
   <dependencies>
diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml
index ea8597374..59f82325a 100644
--- a/intercepting-filter/pom.xml
+++ b/intercepting-filter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>intercepting-filter</artifactId>
   <dependencies>
diff --git a/interpreter/pom.xml b/interpreter/pom.xml
index 118cfcdf6..d2d538c24 100644
--- a/interpreter/pom.xml
+++ b/interpreter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>interpreter</artifactId>
   <dependencies>
diff --git a/iterator/pom.xml b/iterator/pom.xml
index 514cedbea..1d4faf770 100644
--- a/iterator/pom.xml
+++ b/iterator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>iterator</artifactId>
   <dependencies>
diff --git a/layers/pom.xml b/layers/pom.xml
index 2ebace18b..d4b218272 100644
--- a/layers/pom.xml
+++ b/layers/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<groupId>com.iluwatar.layers</groupId>
 	<artifactId>layers</artifactId>
diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml
index a6a5d3a45..1bfe3b637 100644
--- a/lazy-loading/pom.xml
+++ b/lazy-loading/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>lazy-loading</artifactId>
   <dependencies>
diff --git a/leader-election/pom.xml b/leader-election/pom.xml
index 8fc833f18..b61041502 100644
--- a/leader-election/pom.xml
+++ b/leader-election/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>leader-election</artifactId>
     <dependencies>
diff --git a/leader-followers/pom.xml b/leader-followers/pom.xml
index c0f27d051..2e5789acc 100644
--- a/leader-followers/pom.xml
+++ b/leader-followers/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>leader-followers</artifactId>
     <dependencies>
diff --git a/marker/pom.xml b/marker/pom.xml
index 5212832d8..2e2ec74b5 100644
--- a/marker/pom.xml
+++ b/marker/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/master-worker-pattern/pom.xml b/master-worker-pattern/pom.xml
index 26f4d70bb..54a72da69 100644
--- a/master-worker-pattern/pom.xml
+++ b/master-worker-pattern/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>master-worker-pattern</artifactId>
     <dependencies>
diff --git a/mediator/pom.xml b/mediator/pom.xml
index 23d28726b..ffae20778 100644
--- a/mediator/pom.xml
+++ b/mediator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>mediator</artifactId>
   <dependencies>
diff --git a/memento/pom.xml b/memento/pom.xml
index 70121cea3..265825ccb 100644
--- a/memento/pom.xml
+++ b/memento/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>memento</artifactId>
   <dependencies>
diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml
index a8ef230e8..6e2e062d8 100644
--- a/model-view-controller/pom.xml
+++ b/model-view-controller/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>model-view-controller</artifactId>
   <dependencies>
diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml
index 97b47f82c..363dfd78c 100644
--- a/model-view-presenter/pom.xml
+++ b/model-view-presenter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>model-view-presenter</artifactId>
   <name>model-view-presenter</name>
diff --git a/module/pom.xml b/module/pom.xml
index 5d9a6d529..4768ffcef 100644
--- a/module/pom.xml
+++ b/module/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>module</artifactId>
     <dependencies>
diff --git a/monad/pom.xml b/monad/pom.xml
index f553c3079..e74ee83eb 100644
--- a/monad/pom.xml
+++ b/monad/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>monad</artifactId>
     <dependencies>
diff --git a/monostate/pom.xml b/monostate/pom.xml
index 0e51fc700..f00f7a677 100644
--- a/monostate/pom.xml
+++ b/monostate/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>monostate</artifactId>
   <dependencies>
diff --git a/multiton/pom.xml b/multiton/pom.xml
index ef1e9c892..8bb51845f 100644
--- a/multiton/pom.xml
+++ b/multiton/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>multiton</artifactId>
   <dependencies>
diff --git a/mute-idiom/pom.xml b/mute-idiom/pom.xml
index a32f6a3ea..0d24529fa 100644
--- a/mute-idiom/pom.xml
+++ b/mute-idiom/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>mute-idiom</artifactId>
 	<dependencies>
diff --git a/mutex/pom.xml b/mutex/pom.xml
index 9cdff25e4..c08862948 100644
--- a/mutex/pom.xml
+++ b/mutex/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>mutex</artifactId>
   <dependencies>
diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml
index 0437c2da5..41cbd8571 100644
--- a/naked-objects/dom/pom.xml
+++ b/naked-objects/dom/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 
 	<artifactId>naked-objects-dom</artifactId>
diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml
index 3457ac0a4..869af61f3 100644
--- a/naked-objects/fixture/pom.xml
+++ b/naked-objects/fixture/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 
 	<artifactId>naked-objects-fixture</artifactId>
diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml
index f46541f48..f43b99197 100644
--- a/naked-objects/integtests/pom.xml
+++ b/naked-objects/integtests/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 
 	<artifactId>naked-objects-integtests</artifactId>
diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index 5b7a2e0c7..0fc95946c 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -29,7 +29,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>naked-objects</artifactId>
 	<packaging>pom</packaging>
@@ -333,17 +333,17 @@
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-dom</artifactId>
-				<version>1.23.0-SNAPSHOT</version>
+				<version>1.23.0</version>
 			</dependency>
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-fixture</artifactId>
-				<version>1.23.0-SNAPSHOT</version>
+				<version>1.23.0</version>
 			</dependency>
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-webapp</artifactId>
-				<version>1.23.0-SNAPSHOT</version>
+				<version>1.23.0</version>
 			</dependency>
 
 		</dependencies>
diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml
index bbddeb791..86960a5fb 100644
--- a/naked-objects/webapp/pom.xml
+++ b/naked-objects/webapp/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 
 	<artifactId>naked-objects-webapp</artifactId>
diff --git a/null-object/pom.xml b/null-object/pom.xml
index 7b88fca79..e91b06f74 100644
--- a/null-object/pom.xml
+++ b/null-object/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>null-object</artifactId>
   <dependencies>
diff --git a/object-mother/pom.xml b/object-mother/pom.xml
index 5ac3ce410..07d724e76 100644
--- a/object-mother/pom.xml
+++ b/object-mother/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>object-mother</artifactId>
     <dependencies>
diff --git a/object-pool/pom.xml b/object-pool/pom.xml
index 2adad8942..ed3f87a0d 100644
--- a/object-pool/pom.xml
+++ b/object-pool/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>object-pool</artifactId>
   <dependencies>
diff --git a/observer/pom.xml b/observer/pom.xml
index 1e48268d8..e971c5602 100644
--- a/observer/pom.xml
+++ b/observer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>observer</artifactId>
   <dependencies>
diff --git a/page-object/pom.xml b/page-object/pom.xml
index 4bf31d72e..6c1066fce 100644
--- a/page-object/pom.xml
+++ b/page-object/pom.xml
@@ -46,7 +46,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>page-object</artifactId>
     <packaging>pom</packaging>
diff --git a/page-object/sample-application/pom.xml b/page-object/sample-application/pom.xml
index 5ded184cc..c715418d5 100644
--- a/page-object/sample-application/pom.xml
+++ b/page-object/sample-application/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>page-object</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>sample-application</artifactId>
 </project>
diff --git a/page-object/test-automation/pom.xml b/page-object/test-automation/pom.xml
index 68025f4b8..f2ca98689 100644
--- a/page-object/test-automation/pom.xml
+++ b/page-object/test-automation/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>page-object</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>test-automation</artifactId>
   <dependencies>
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index d10a496dd..a4788e5d1 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/pipeline/pom.xml b/pipeline/pom.xml
index 8c511cd8a..a29007cda 100644
--- a/pipeline/pom.xml
+++ b/pipeline/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>pipeline</artifactId>
     <dependencies>
diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml
index 4989581d7..38d12c6c7 100644
--- a/poison-pill/pom.xml
+++ b/poison-pill/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>poison-pill</artifactId>
   <dependencies>
diff --git a/pom.xml b/pom.xml
index 3b7ad3568..56c593574 100644
--- a/pom.xml
+++ b/pom.xml
@@ -20,7 +20,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
     <packaging>pom</packaging>
     <inceptionYear>2014-2019</inceptionYear>
     <properties>
diff --git a/priority-queue/pom.xml b/priority-queue/pom.xml
index 7f435f489..338079a66 100644
--- a/priority-queue/pom.xml
+++ b/priority-queue/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <dependencies>
diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml
index cb81ca3fc..bc4eeff65 100644
--- a/private-class-data/pom.xml
+++ b/private-class-data/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>private-class-data</artifactId>
   <dependencies>
diff --git a/producer-consumer/pom.xml b/producer-consumer/pom.xml
index ab1872c51..853eb68f8 100644
--- a/producer-consumer/pom.xml
+++ b/producer-consumer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>producer-consumer</artifactId>
   <dependencies>
diff --git a/promise/pom.xml b/promise/pom.xml
index 4a9d76df1..ac0f66a43 100644
--- a/promise/pom.xml
+++ b/promise/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>promise</artifactId>
   <dependencies>
diff --git a/property/pom.xml b/property/pom.xml
index d271af036..e96371c9c 100644
--- a/property/pom.xml
+++ b/property/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>property</artifactId>
   <dependencies>
diff --git a/prototype/pom.xml b/prototype/pom.xml
index e68b11892..7fc26080a 100644
--- a/prototype/pom.xml
+++ b/prototype/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>prototype</artifactId>
   <dependencies>
diff --git a/proxy/pom.xml b/proxy/pom.xml
index f54c77dcf..8d2749483 100644
--- a/proxy/pom.xml
+++ b/proxy/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>proxy</artifactId>
   <dependencies>
diff --git a/queue-load-leveling/pom.xml b/queue-load-leveling/pom.xml
index ee6e6c623..8f9a785c9 100644
--- a/queue-load-leveling/pom.xml
+++ b/queue-load-leveling/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>queue-load-leveling</artifactId>
   <dependencies>
diff --git a/reactor/pom.xml b/reactor/pom.xml
index b95b0b6e2..424c00db7 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>reactor</artifactId>
   <dependencies>
diff --git a/reader-writer-lock/pom.xml b/reader-writer-lock/pom.xml
index 92f53df66..10d49f6cc 100644
--- a/reader-writer-lock/pom.xml
+++ b/reader-writer-lock/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>reader-writer-lock</artifactId>
     <dependencies>
diff --git a/repository/pom.xml b/repository/pom.xml
index 0b98cdb41..5511c4fc3 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>repository</artifactId>
     <dependencies>
diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml
index ef8e19f48..80d34e3aa 100644
--- a/resource-acquisition-is-initialization/pom.xml
+++ b/resource-acquisition-is-initialization/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>resource-acquisition-is-initialization</artifactId>
   <dependencies>
diff --git a/retry/pom.xml b/retry/pom.xml
index e6c2701e0..db59fa049 100644
--- a/retry/pom.xml
+++ b/retry/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <artifactId>retry</artifactId>
     <packaging>jar</packaging>
diff --git a/role-object/pom.xml b/role-object/pom.xml
index c980adc2c..2b3e07be0 100644
--- a/role-object/pom.xml
+++ b/role-object/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
 
   <artifactId>role-object</artifactId>
diff --git a/saga/pom.xml b/saga/pom.xml
index 1971ae6cf..c83c8fb45 100644
--- a/saga/pom.xml
+++ b/saga/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <artifactId>saga</artifactId>
diff --git a/semaphore/pom.xml b/semaphore/pom.xml
index b6375366b..0a2ac7aed 100644
--- a/semaphore/pom.xml
+++ b/semaphore/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>semaphore</artifactId>
   <dependencies>
diff --git a/servant/pom.xml b/servant/pom.xml
index 395060d50..e8925cea9 100644
--- a/servant/pom.xml
+++ b/servant/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>servant</artifactId>
   <dependencies>
diff --git a/serverless/pom.xml b/serverless/pom.xml
index 1fb55ec47..c9d7ec71b 100644
--- a/serverless/pom.xml
+++ b/serverless/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
 
     <dependencies>
diff --git a/service-layer/pom.xml b/service-layer/pom.xml
index 881ec8ba6..aaee48310 100644
--- a/service-layer/pom.xml
+++ b/service-layer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>service-layer</artifactId>
   <dependencies>
diff --git a/service-locator/pom.xml b/service-locator/pom.xml
index 1d8e9fcd8..ed2366ed0 100644
--- a/service-locator/pom.xml
+++ b/service-locator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>service-locator</artifactId>
   <dependencies>
diff --git a/sharding/pom.xml b/sharding/pom.xml
index 2d00629bc..61c15db5b 100644
--- a/sharding/pom.xml
+++ b/sharding/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/singleton/pom.xml b/singleton/pom.xml
index b09602d0e..7b7686108 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>singleton</artifactId>
   <dependencies>
diff --git a/spatial-partition/pom.xml b/spatial-partition/pom.xml
index 7312427d0..2f47d73d9 100644
--- a/spatial-partition/pom.xml
+++ b/spatial-partition/pom.xml
@@ -46,7 +46,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>spatial-partition</artifactId>
   <dependencies>
diff --git a/specification/pom.xml b/specification/pom.xml
index 9214e984e..d2945516b 100644
--- a/specification/pom.xml
+++ b/specification/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>specification</artifactId>
   <dependencies>
diff --git a/state/pom.xml b/state/pom.xml
index b1ff3f5f3..c53f3d797 100644
--- a/state/pom.xml
+++ b/state/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>state</artifactId>
   <dependencies>
diff --git a/step-builder/pom.xml b/step-builder/pom.xml
index 3cea3b158..1de9b653d 100644
--- a/step-builder/pom.xml
+++ b/step-builder/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>step-builder</artifactId>
   <dependencies>
diff --git a/strangler/pom.xml b/strangler/pom.xml
index 4a1fb42ba..ba85f7184 100644
--- a/strangler/pom.xml
+++ b/strangler/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/strategy/pom.xml b/strategy/pom.xml
index cd1395c7a..aad38f1ce 100644
--- a/strategy/pom.xml
+++ b/strategy/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>strategy</artifactId>
   <dependencies>
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index a912ada3f..144f099a3 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/template-method/pom.xml b/template-method/pom.xml
index c449ef04f..36a0d8550 100644
--- a/template-method/pom.xml
+++ b/template-method/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>template-method</artifactId>
   <dependencies>
diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml
index 0ea0b1266..abcb8a9f5 100644
--- a/thread-pool/pom.xml
+++ b/thread-pool/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>thread-pool</artifactId>
   <dependencies>
diff --git a/throttling/pom.xml b/throttling/pom.xml
index 6ae062c5e..77f911c24 100644
--- a/throttling/pom.xml
+++ b/throttling/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/tls/pom.xml b/tls/pom.xml
index 7100ae295..f6adc911f 100644
--- a/tls/pom.xml
+++ b/tls/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>tls</artifactId>
   <dependencies>
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index 2966cca19..3324f75f0 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>tolerant-reader</artifactId>
   <dependencies>
diff --git a/trampoline/pom.xml b/trampoline/pom.xml
index 13988ca92..c651b4f8b 100644
--- a/trampoline/pom.xml
+++ b/trampoline/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
 
     </parent>
     <artifactId>trampoline</artifactId>
diff --git a/transaction-script/pom.xml b/transaction-script/pom.xml
index 5dc2aa981..081567c47 100644
--- a/transaction-script/pom.xml
+++ b/transaction-script/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/twin/pom.xml b/twin/pom.xml
index cb60511c9..37c06bd20 100644
--- a/twin/pom.xml
+++ b/twin/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>twin</artifactId>
   <dependencies>
diff --git a/typeobjectpattern/pom.xml b/typeobjectpattern/pom.xml
index c8f0005af..32e252aea 100644
--- a/typeobjectpattern/pom.xml
+++ b/typeobjectpattern/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>typeobjectpattern</artifactId>
   <dependencies>
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index 0f8f0b21a..730b7921b 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/update-method/pom.xml b/update-method/pom.xml
index 78b89555a..2659d1e2c 100644
--- a/update-method/pom.xml
+++ b/update-method/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0-SNAPSHOT</version>
+        <version>1.23.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/value-object/pom.xml b/value-object/pom.xml
index aa4101b5c..a2dd714de 100644
--- a/value-object/pom.xml
+++ b/value-object/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0-SNAPSHOT</version>
+		<version>1.23.0</version>
 	</parent>
 	<artifactId>value-object</artifactId>
 	<dependencies>
diff --git a/visitor/pom.xml b/visitor/pom.xml
index 00497b41f..dddb4d4e3 100644
--- a/visitor/pom.xml
+++ b/visitor/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0-SNAPSHOT</version>
+    <version>1.23.0</version>
   </parent>
   <artifactId>visitor</artifactId>
   <dependencies>

From 723afb85ba1ce9a1865040a8471ab457dc0edc80 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 25 Aug 2020 21:21:36 +0300
Subject: [PATCH 039/254] Set version for next development iteration

---
 abstract-document/pom.xml                                 | 2 +-
 abstract-factory/pom.xml                                  | 2 +-
 acyclic-visitor/pom.xml                                   | 2 +-
 adapter/pom.xml                                           | 2 +-
 aggregator-microservices/aggregator-service/pom.xml       | 2 +-
 aggregator-microservices/information-microservice/pom.xml | 2 +-
 aggregator-microservices/inventory-microservice/pom.xml   | 2 +-
 aggregator-microservices/pom.xml                          | 2 +-
 ambassador/pom.xml                                        | 2 +-
 api-gateway/api-gateway-service/pom.xml                   | 2 +-
 api-gateway/image-microservice/pom.xml                    | 2 +-
 api-gateway/pom.xml                                       | 2 +-
 api-gateway/price-microservice/pom.xml                    | 2 +-
 arrange-act-assert/pom.xml                                | 2 +-
 async-method-invocation/pom.xml                           | 2 +-
 balking/pom.xml                                           | 2 +-
 bridge/pom.xml                                            | 2 +-
 builder/pom.xml                                           | 2 +-
 business-delegate/pom.xml                                 | 2 +-
 bytecode/pom.xml                                          | 2 +-
 caching/pom.xml                                           | 2 +-
 callback/pom.xml                                          | 2 +-
 chain/pom.xml                                             | 2 +-
 circuit-breaker/pom.xml                                   | 2 +-
 collection-pipeline/pom.xml                               | 2 +-
 combinator/pom.xml                                        | 2 +-
 command/pom.xml                                           | 2 +-
 commander/pom.xml                                         | 2 +-
 composite/pom.xml                                         | 2 +-
 converter/pom.xml                                         | 2 +-
 cqrs/pom.xml                                              | 2 +-
 dao/pom.xml                                               | 2 +-
 data-bus/pom.xml                                          | 2 +-
 data-locality/pom.xml                                     | 2 +-
 data-mapper/pom.xml                                       | 2 +-
 data-transfer-object/pom.xml                              | 2 +-
 decorator/pom.xml                                         | 2 +-
 delegation/pom.xml                                        | 2 +-
 dependency-injection/pom.xml                              | 2 +-
 dirty-flag/pom.xml                                        | 4 ++--
 double-buffer/pom.xml                                     | 2 +-
 double-checked-locking/pom.xml                            | 2 +-
 double-dispatch/pom.xml                                   | 2 +-
 eip-aggregator/pom.xml                                    | 2 +-
 eip-message-channel/pom.xml                               | 2 +-
 eip-publish-subscribe/pom.xml                             | 2 +-
 eip-splitter/pom.xml                                      | 2 +-
 eip-wire-tap/pom.xml                                      | 2 +-
 event-aggregator/pom.xml                                  | 2 +-
 event-asynchronous/pom.xml                                | 2 +-
 event-driven-architecture/pom.xml                         | 2 +-
 event-queue/pom.xml                                       | 2 +-
 event-sourcing/pom.xml                                    | 2 +-
 execute-around/pom.xml                                    | 2 +-
 extension-objects/pom.xml                                 | 2 +-
 facade/pom.xml                                            | 2 +-
 factory-kit/pom.xml                                       | 2 +-
 factory-method/pom.xml                                    | 2 +-
 feature-toggle/pom.xml                                    | 2 +-
 filterer/pom.xml                                          | 2 +-
 fluentinterface/pom.xml                                   | 2 +-
 flux/pom.xml                                              | 2 +-
 flyweight/pom.xml                                         | 2 +-
 front-controller/pom.xml                                  | 2 +-
 game-loop/pom.xml                                         | 2 +-
 guarded-suspension/pom.xml                                | 2 +-
 half-sync-half-async/pom.xml                              | 2 +-
 hexagonal/pom.xml                                         | 2 +-
 intercepting-filter/pom.xml                               | 2 +-
 interpreter/pom.xml                                       | 2 +-
 iterator/pom.xml                                          | 2 +-
 layers/pom.xml                                            | 2 +-
 lazy-loading/pom.xml                                      | 2 +-
 leader-election/pom.xml                                   | 2 +-
 leader-followers/pom.xml                                  | 2 +-
 marker/pom.xml                                            | 2 +-
 master-worker-pattern/pom.xml                             | 2 +-
 mediator/pom.xml                                          | 2 +-
 memento/pom.xml                                           | 2 +-
 model-view-controller/pom.xml                             | 2 +-
 model-view-presenter/pom.xml                              | 2 +-
 module/pom.xml                                            | 2 +-
 monad/pom.xml                                             | 2 +-
 monostate/pom.xml                                         | 2 +-
 multiton/pom.xml                                          | 2 +-
 mute-idiom/pom.xml                                        | 2 +-
 mutex/pom.xml                                             | 2 +-
 naked-objects/dom/pom.xml                                 | 2 +-
 naked-objects/fixture/pom.xml                             | 2 +-
 naked-objects/integtests/pom.xml                          | 2 +-
 naked-objects/pom.xml                                     | 8 ++++----
 naked-objects/webapp/pom.xml                              | 2 +-
 null-object/pom.xml                                       | 2 +-
 object-mother/pom.xml                                     | 2 +-
 object-pool/pom.xml                                       | 2 +-
 observer/pom.xml                                          | 2 +-
 page-object/pom.xml                                       | 2 +-
 page-object/sample-application/pom.xml                    | 2 +-
 page-object/test-automation/pom.xml                       | 2 +-
 partial-response/pom.xml                                  | 2 +-
 pipeline/pom.xml                                          | 2 +-
 poison-pill/pom.xml                                       | 2 +-
 pom.xml                                                   | 2 +-
 priority-queue/pom.xml                                    | 2 +-
 private-class-data/pom.xml                                | 2 +-
 producer-consumer/pom.xml                                 | 2 +-
 promise/pom.xml                                           | 2 +-
 property/pom.xml                                          | 2 +-
 prototype/pom.xml                                         | 2 +-
 proxy/pom.xml                                             | 2 +-
 queue-load-leveling/pom.xml                               | 2 +-
 reactor/pom.xml                                           | 2 +-
 reader-writer-lock/pom.xml                                | 2 +-
 repository/pom.xml                                        | 2 +-
 resource-acquisition-is-initialization/pom.xml            | 2 +-
 retry/pom.xml                                             | 2 +-
 role-object/pom.xml                                       | 2 +-
 saga/pom.xml                                              | 2 +-
 semaphore/pom.xml                                         | 2 +-
 servant/pom.xml                                           | 2 +-
 serverless/pom.xml                                        | 2 +-
 service-layer/pom.xml                                     | 2 +-
 service-locator/pom.xml                                   | 2 +-
 sharding/pom.xml                                          | 2 +-
 singleton/pom.xml                                         | 2 +-
 spatial-partition/pom.xml                                 | 2 +-
 specification/pom.xml                                     | 2 +-
 state/pom.xml                                             | 2 +-
 step-builder/pom.xml                                      | 2 +-
 strangler/pom.xml                                         | 2 +-
 strategy/pom.xml                                          | 2 +-
 subclass-sandbox/pom.xml                                  | 2 +-
 template-method/pom.xml                                   | 2 +-
 thread-pool/pom.xml                                       | 2 +-
 throttling/pom.xml                                        | 2 +-
 tls/pom.xml                                               | 2 +-
 tolerant-reader/pom.xml                                   | 2 +-
 trampoline/pom.xml                                        | 2 +-
 transaction-script/pom.xml                                | 2 +-
 twin/pom.xml                                              | 2 +-
 typeobjectpattern/pom.xml                                 | 2 +-
 unit-of-work/pom.xml                                      | 2 +-
 update-method/pom.xml                                     | 2 +-
 value-object/pom.xml                                      | 2 +-
 visitor/pom.xml                                           | 2 +-
 145 files changed, 149 insertions(+), 149 deletions(-)

diff --git a/abstract-document/pom.xml b/abstract-document/pom.xml
index a285e2d82..15e7cc54d 100644
--- a/abstract-document/pom.xml
+++ b/abstract-document/pom.xml
@@ -21,7 +21,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>abstract-document</artifactId>
 	<dependencies>
diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index 4fe0b58cd..2328c60a8 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>abstract-factory</artifactId>
 	<dependencies>
diff --git a/acyclic-visitor/pom.xml b/acyclic-visitor/pom.xml
index 41a126d27..8c53b8750 100644
--- a/acyclic-visitor/pom.xml
+++ b/acyclic-visitor/pom.xml
@@ -21,7 +21,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>acyclic-visitor</artifactId>
diff --git a/adapter/pom.xml b/adapter/pom.xml
index 2cd449c06..a4d8d7b12 100644
--- a/adapter/pom.xml
+++ b/adapter/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>adapter</artifactId>
 	<dependencies>
diff --git a/aggregator-microservices/aggregator-service/pom.xml b/aggregator-microservices/aggregator-service/pom.xml
index 8f1e2ad06..b7c2bac66 100644
--- a/aggregator-microservices/aggregator-service/pom.xml
+++ b/aggregator-microservices/aggregator-service/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>aggregator-service</artifactId>
diff --git a/aggregator-microservices/information-microservice/pom.xml b/aggregator-microservices/information-microservice/pom.xml
index bde50bd98..71935757f 100644
--- a/aggregator-microservices/information-microservice/pom.xml
+++ b/aggregator-microservices/information-microservice/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/aggregator-microservices/inventory-microservice/pom.xml b/aggregator-microservices/inventory-microservice/pom.xml
index 76d506ed1..6c2726a35 100644
--- a/aggregator-microservices/inventory-microservice/pom.xml
+++ b/aggregator-microservices/inventory-microservice/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>aggregator-microservices</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>inventory-microservice</artifactId>
diff --git a/aggregator-microservices/pom.xml b/aggregator-microservices/pom.xml
index e6bf655f7..9e66e9be0 100644
--- a/aggregator-microservices/pom.xml
+++ b/aggregator-microservices/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
     <artifactId>aggregator-microservices</artifactId>
diff --git a/ambassador/pom.xml b/ambassador/pom.xml
index 33f623457..0e5e208d5 100644
--- a/ambassador/pom.xml
+++ b/ambassador/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>ambassador</artifactId>
diff --git a/api-gateway/api-gateway-service/pom.xml b/api-gateway/api-gateway-service/pom.xml
index 08c7d47dc..c5ca117b6 100644
--- a/api-gateway/api-gateway-service/pom.xml
+++ b/api-gateway/api-gateway-service/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>api-gateway-service</artifactId>
diff --git a/api-gateway/image-microservice/pom.xml b/api-gateway/image-microservice/pom.xml
index ba055bd71..821857449 100644
--- a/api-gateway/image-microservice/pom.xml
+++ b/api-gateway/image-microservice/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>image-microservice</artifactId>
diff --git a/api-gateway/pom.xml b/api-gateway/pom.xml
index 0edcbc83a..8ed569412 100644
--- a/api-gateway/pom.xml
+++ b/api-gateway/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>api-gateway</artifactId>
diff --git a/api-gateway/price-microservice/pom.xml b/api-gateway/price-microservice/pom.xml
index 6b61ff2e5..dc3591bf3 100644
--- a/api-gateway/price-microservice/pom.xml
+++ b/api-gateway/price-microservice/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>api-gateway</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
 
   <modelVersion>4.0.0</modelVersion>
diff --git a/arrange-act-assert/pom.xml b/arrange-act-assert/pom.xml
index c00660b01..4b0d57ebf 100644
--- a/arrange-act-assert/pom.xml
+++ b/arrange-act-assert/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index 32adc0508..b4f7dd670 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>async-method-invocation</artifactId>
 	<dependencies>
diff --git a/balking/pom.xml b/balking/pom.xml
index 6d789244c..0a86bc430 100644
--- a/balking/pom.xml
+++ b/balking/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/bridge/pom.xml b/bridge/pom.xml
index ae50aba2e..41271814c 100644
--- a/bridge/pom.xml
+++ b/bridge/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>bridge</artifactId>
 	<dependencies>
diff --git a/builder/pom.xml b/builder/pom.xml
index 069f6f841..6aa467f9e 100644
--- a/builder/pom.xml
+++ b/builder/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>builder</artifactId>
 	<dependencies>
diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml
index 9f7e3ea70..a46e856a9 100644
--- a/business-delegate/pom.xml
+++ b/business-delegate/pom.xml
@@ -22,7 +22,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>business-delegate</artifactId>
 	<dependencies>
diff --git a/bytecode/pom.xml b/bytecode/pom.xml
index cfae54ad1..d21064be4 100644
--- a/bytecode/pom.xml
+++ b/bytecode/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
diff --git a/caching/pom.xml b/caching/pom.xml
index 82e7546f5..627f76e98 100644
--- a/caching/pom.xml
+++ b/caching/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>caching</artifactId>
   <dependencies>
diff --git a/callback/pom.xml b/callback/pom.xml
index a493c2cab..a74b653e1 100644
--- a/callback/pom.xml
+++ b/callback/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>callback</artifactId>
   <dependencies>
diff --git a/chain/pom.xml b/chain/pom.xml
index 40966eebf..9a7097e6d 100644
--- a/chain/pom.xml
+++ b/chain/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>chain</artifactId>
   <dependencies>
diff --git a/circuit-breaker/pom.xml b/circuit-breaker/pom.xml
index 4df9aacd3..083c527fa 100644
--- a/circuit-breaker/pom.xml
+++ b/circuit-breaker/pom.xml
@@ -27,7 +27,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>circuit-breaker</artifactId>
     <dependencies>
diff --git a/collection-pipeline/pom.xml b/collection-pipeline/pom.xml
index e8de7ff33..08c41880b 100644
--- a/collection-pipeline/pom.xml
+++ b/collection-pipeline/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>collection-pipeline</artifactId>
   <dependencies>
diff --git a/combinator/pom.xml b/combinator/pom.xml
index 62c6a6658..4886873cd 100644
--- a/combinator/pom.xml
+++ b/combinator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
 
   <artifactId>combinator</artifactId>
diff --git a/command/pom.xml b/command/pom.xml
index 557f2cd89..3869d4b44 100644
--- a/command/pom.xml
+++ b/command/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>command</artifactId>
   <dependencies>
diff --git a/commander/pom.xml b/commander/pom.xml
index 8b87442ae..baabc04fc 100644
--- a/commander/pom.xml
+++ b/commander/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>commander</artifactId>
   <dependencies>
diff --git a/composite/pom.xml b/composite/pom.xml
index 5e41920d7..6f7147482 100644
--- a/composite/pom.xml
+++ b/composite/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>composite</artifactId>
   <dependencies>
diff --git a/converter/pom.xml b/converter/pom.xml
index b19db2bae..1bed5e973 100644
--- a/converter/pom.xml
+++ b/converter/pom.xml
@@ -20,7 +20,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>converter</artifactId>
 	<modelVersion>4.0.0</modelVersion>
diff --git a/cqrs/pom.xml b/cqrs/pom.xml
index 57570fff4..1838ed599 100644
--- a/cqrs/pom.xml
+++ b/cqrs/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>cqrs</artifactId>
 	<dependencies>
diff --git a/dao/pom.xml b/dao/pom.xml
index ead5e030f..32e9ef1ff 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>dao</artifactId>
 
diff --git a/data-bus/pom.xml b/data-bus/pom.xml
index cc3553336..4db738307 100644
--- a/data-bus/pom.xml
+++ b/data-bus/pom.xml
@@ -33,7 +33,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>data-bus</artifactId>
     <dependencies>
diff --git a/data-locality/pom.xml b/data-locality/pom.xml
index f14676b45..88fd96c64 100644
--- a/data-locality/pom.xml
+++ b/data-locality/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>data-locality</artifactId>
 
diff --git a/data-mapper/pom.xml b/data-mapper/pom.xml
index 45221020b..cf17de69b 100644
--- a/data-mapper/pom.xml
+++ b/data-mapper/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>data-mapper</artifactId>
 	<dependencies>
diff --git a/data-transfer-object/pom.xml b/data-transfer-object/pom.xml
index d51b62d2c..2529b3756 100644
--- a/data-transfer-object/pom.xml
+++ b/data-transfer-object/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>data-transfer-object</artifactId>
     <dependencies>
diff --git a/decorator/pom.xml b/decorator/pom.xml
index 1209d5efb..b075704c8 100644
--- a/decorator/pom.xml
+++ b/decorator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>decorator</artifactId>
   <dependencies>
diff --git a/delegation/pom.xml b/delegation/pom.xml
index 8ff7c6617..d7ad81362 100644
--- a/delegation/pom.xml
+++ b/delegation/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml
index 85e8cdd1c..f3aaba520 100644
--- a/dependency-injection/pom.xml
+++ b/dependency-injection/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>dependency-injection</artifactId>
   <dependencies>
diff --git a/dirty-flag/pom.xml b/dirty-flag/pom.xml
index 3908dca36..b796ab37a 100644
--- a/dirty-flag/pom.xml
+++ b/dirty-flag/pom.xml
@@ -29,10 +29,10 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>dirty-flag</artifactId>
-  <version>1.23.0</version>
+  <version>1.24.0-SNAPSHOT</version>
   <name>dirty-flag</name>
   <url>http://maven.apache.org</url>
   <properties>
diff --git a/double-buffer/pom.xml b/double-buffer/pom.xml
index e2e649fa9..cc4032074 100644
--- a/double-buffer/pom.xml
+++ b/double-buffer/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index de8d27a4e..04aba2260 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>double-checked-locking</artifactId>
   <dependencies>
diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml
index 67febf5bb..275b505a5 100644
--- a/double-dispatch/pom.xml
+++ b/double-dispatch/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>double-dispatch</artifactId>
   <dependencies>
diff --git a/eip-aggregator/pom.xml b/eip-aggregator/pom.xml
index c77dded15..efee153a3 100644
--- a/eip-aggregator/pom.xml
+++ b/eip-aggregator/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <dependencies>
diff --git a/eip-message-channel/pom.xml b/eip-message-channel/pom.xml
index 02db57903..12fe153e3 100644
--- a/eip-message-channel/pom.xml
+++ b/eip-message-channel/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>eip-message-channel</artifactId>
 	<dependencies>
diff --git a/eip-publish-subscribe/pom.xml b/eip-publish-subscribe/pom.xml
index ab98cf76a..f354b1ee3 100644
--- a/eip-publish-subscribe/pom.xml
+++ b/eip-publish-subscribe/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>eip-publish-subscribe</artifactId>
 	<dependencies>
diff --git a/eip-splitter/pom.xml b/eip-splitter/pom.xml
index d1bc7f9c6..5b4758a9e 100644
--- a/eip-splitter/pom.xml
+++ b/eip-splitter/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <dependencies>
diff --git a/eip-wire-tap/pom.xml b/eip-wire-tap/pom.xml
index 2b122a64e..332861547 100644
--- a/eip-wire-tap/pom.xml
+++ b/eip-wire-tap/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <dependencies>
diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml
index 1f3896ff3..813521c48 100644
--- a/event-aggregator/pom.xml
+++ b/event-aggregator/pom.xml
@@ -28,7 +28,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>event-aggregator</artifactId>
 	<dependencies>
diff --git a/event-asynchronous/pom.xml b/event-asynchronous/pom.xml
index ccbda1f0a..06921a100 100644
--- a/event-asynchronous/pom.xml
+++ b/event-asynchronous/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>event-asynchronous</artifactId>
   <dependencies>
diff --git a/event-driven-architecture/pom.xml b/event-driven-architecture/pom.xml
index b9da44c6f..c40a8821b 100644
--- a/event-driven-architecture/pom.xml
+++ b/event-driven-architecture/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <artifactId>event-driven-architecture</artifactId>
diff --git a/event-queue/pom.xml b/event-queue/pom.xml
index 1a93f9dad..232b9abaa 100644
--- a/event-queue/pom.xml
+++ b/event-queue/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>event-queue</artifactId>
   <dependencies>
diff --git a/event-sourcing/pom.xml b/event-sourcing/pom.xml
index 486f6d9e0..44af5fc5e 100644
--- a/event-sourcing/pom.xml
+++ b/event-sourcing/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>event-sourcing</artifactId>
   <dependencies>
diff --git a/execute-around/pom.xml b/execute-around/pom.xml
index 65b98a10f..2d0640fe0 100644
--- a/execute-around/pom.xml
+++ b/execute-around/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>execute-around</artifactId>
   <dependencies>
diff --git a/extension-objects/pom.xml b/extension-objects/pom.xml
index f6463e35f..7247a9676 100644
--- a/extension-objects/pom.xml
+++ b/extension-objects/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/facade/pom.xml b/facade/pom.xml
index 3847f8cbb..cf73e6a43 100644
--- a/facade/pom.xml
+++ b/facade/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>facade</artifactId>
   <dependencies>
diff --git a/factory-kit/pom.xml b/factory-kit/pom.xml
index 521e6340f..987bbdb24 100644
--- a/factory-kit/pom.xml
+++ b/factory-kit/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>factory-kit</artifactId>
     <dependencies>
diff --git a/factory-method/pom.xml b/factory-method/pom.xml
index 8038a1ff9..c49fae691 100644
--- a/factory-method/pom.xml
+++ b/factory-method/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>factory-method</artifactId>
   <dependencies>
diff --git a/feature-toggle/pom.xml b/feature-toggle/pom.xml
index a44eae026..1818d882d 100644
--- a/feature-toggle/pom.xml
+++ b/feature-toggle/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/filterer/pom.xml b/filterer/pom.xml
index e64ac9846..46042c1b0 100644
--- a/filterer/pom.xml
+++ b/filterer/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index 28e573258..138dbfa12 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/flux/pom.xml b/flux/pom.xml
index 00435f835..14f4f5557 100644
--- a/flux/pom.xml
+++ b/flux/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>flux</artifactId>
   <dependencies>
diff --git a/flyweight/pom.xml b/flyweight/pom.xml
index 574f5b516..b9ffd42ae 100644
--- a/flyweight/pom.xml
+++ b/flyweight/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>flyweight</artifactId>
   <dependencies>
diff --git a/front-controller/pom.xml b/front-controller/pom.xml
index 447e341fd..a90029a82 100644
--- a/front-controller/pom.xml
+++ b/front-controller/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>front-controller</artifactId>
 	<dependencies>
diff --git a/game-loop/pom.xml b/game-loop/pom.xml
index 33a671449..6935c1fd1 100644
--- a/game-loop/pom.xml
+++ b/game-loop/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/guarded-suspension/pom.xml b/guarded-suspension/pom.xml
index 81cf96084..f1bd31c66 100644
--- a/guarded-suspension/pom.xml
+++ b/guarded-suspension/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <packaging>jar</packaging>
   <artifactId>guarded-suspension</artifactId>
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index e101a849c..635b76172 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>half-sync-half-async</artifactId>
   <dependencies>
diff --git a/hexagonal/pom.xml b/hexagonal/pom.xml
index 3a932749b..f51825d5f 100644
--- a/hexagonal/pom.xml
+++ b/hexagonal/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>hexagonal</artifactId>
   <dependencies>
diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml
index 59f82325a..d8ee9985f 100644
--- a/intercepting-filter/pom.xml
+++ b/intercepting-filter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>intercepting-filter</artifactId>
   <dependencies>
diff --git a/interpreter/pom.xml b/interpreter/pom.xml
index d2d538c24..d32c80839 100644
--- a/interpreter/pom.xml
+++ b/interpreter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>interpreter</artifactId>
   <dependencies>
diff --git a/iterator/pom.xml b/iterator/pom.xml
index 1d4faf770..bca091f11 100644
--- a/iterator/pom.xml
+++ b/iterator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>iterator</artifactId>
   <dependencies>
diff --git a/layers/pom.xml b/layers/pom.xml
index d4b218272..9c299d2ba 100644
--- a/layers/pom.xml
+++ b/layers/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<groupId>com.iluwatar.layers</groupId>
 	<artifactId>layers</artifactId>
diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml
index 1bfe3b637..49421edc2 100644
--- a/lazy-loading/pom.xml
+++ b/lazy-loading/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>lazy-loading</artifactId>
   <dependencies>
diff --git a/leader-election/pom.xml b/leader-election/pom.xml
index b61041502..78ad13e4d 100644
--- a/leader-election/pom.xml
+++ b/leader-election/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>leader-election</artifactId>
     <dependencies>
diff --git a/leader-followers/pom.xml b/leader-followers/pom.xml
index 2e5789acc..42e552ac8 100644
--- a/leader-followers/pom.xml
+++ b/leader-followers/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>leader-followers</artifactId>
     <dependencies>
diff --git a/marker/pom.xml b/marker/pom.xml
index 2e2ec74b5..64b7243f3 100644
--- a/marker/pom.xml
+++ b/marker/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
 
diff --git a/master-worker-pattern/pom.xml b/master-worker-pattern/pom.xml
index 54a72da69..c6bc2facf 100644
--- a/master-worker-pattern/pom.xml
+++ b/master-worker-pattern/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>master-worker-pattern</artifactId>
     <dependencies>
diff --git a/mediator/pom.xml b/mediator/pom.xml
index ffae20778..ae802a349 100644
--- a/mediator/pom.xml
+++ b/mediator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>mediator</artifactId>
   <dependencies>
diff --git a/memento/pom.xml b/memento/pom.xml
index 265825ccb..596883819 100644
--- a/memento/pom.xml
+++ b/memento/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>memento</artifactId>
   <dependencies>
diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml
index 6e2e062d8..98c9dddfe 100644
--- a/model-view-controller/pom.xml
+++ b/model-view-controller/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>model-view-controller</artifactId>
   <dependencies>
diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml
index 363dfd78c..ee309f292 100644
--- a/model-view-presenter/pom.xml
+++ b/model-view-presenter/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>model-view-presenter</artifactId>
   <name>model-view-presenter</name>
diff --git a/module/pom.xml b/module/pom.xml
index 4768ffcef..2dc3fe340 100644
--- a/module/pom.xml
+++ b/module/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>module</artifactId>
     <dependencies>
diff --git a/monad/pom.xml b/monad/pom.xml
index e74ee83eb..2c21a28b3 100644
--- a/monad/pom.xml
+++ b/monad/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>monad</artifactId>
     <dependencies>
diff --git a/monostate/pom.xml b/monostate/pom.xml
index f00f7a677..02e271931 100644
--- a/monostate/pom.xml
+++ b/monostate/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>monostate</artifactId>
   <dependencies>
diff --git a/multiton/pom.xml b/multiton/pom.xml
index 8bb51845f..d1e4d50d5 100644
--- a/multiton/pom.xml
+++ b/multiton/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>multiton</artifactId>
   <dependencies>
diff --git a/mute-idiom/pom.xml b/mute-idiom/pom.xml
index 0d24529fa..2bf95f070 100644
--- a/mute-idiom/pom.xml
+++ b/mute-idiom/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>mute-idiom</artifactId>
 	<dependencies>
diff --git a/mutex/pom.xml b/mutex/pom.xml
index c08862948..84455abb1 100644
--- a/mutex/pom.xml
+++ b/mutex/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>mutex</artifactId>
   <dependencies>
diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml
index 41cbd8571..1b1eb2266 100644
--- a/naked-objects/dom/pom.xml
+++ b/naked-objects/dom/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>naked-objects-dom</artifactId>
diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml
index 869af61f3..a918e20de 100644
--- a/naked-objects/fixture/pom.xml
+++ b/naked-objects/fixture/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>naked-objects-fixture</artifactId>
diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml
index f43b99197..b9482b292 100644
--- a/naked-objects/integtests/pom.xml
+++ b/naked-objects/integtests/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>naked-objects-integtests</artifactId>
diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index 0fc95946c..e8b9b79c5 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -29,7 +29,7 @@
 	<parent>
 		<artifactId>java-design-patterns</artifactId>
 		<groupId>com.iluwatar</groupId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>naked-objects</artifactId>
 	<packaging>pom</packaging>
@@ -333,17 +333,17 @@
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-dom</artifactId>
-				<version>1.23.0</version>
+				<version>1.24.0-SNAPSHOT</version>
 			</dependency>
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-fixture</artifactId>
-				<version>1.23.0</version>
+				<version>1.24.0-SNAPSHOT</version>
 			</dependency>
 			<dependency>
 				<groupId>${project.groupId}</groupId>
 				<artifactId>naked-objects-webapp</artifactId>
-				<version>1.23.0</version>
+				<version>1.24.0-SNAPSHOT</version>
 			</dependency>
 
 		</dependencies>
diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml
index 86960a5fb..3a817f9e2 100644
--- a/naked-objects/webapp/pom.xml
+++ b/naked-objects/webapp/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>naked-objects</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 
 	<artifactId>naked-objects-webapp</artifactId>
diff --git a/null-object/pom.xml b/null-object/pom.xml
index e91b06f74..4317ee36a 100644
--- a/null-object/pom.xml
+++ b/null-object/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>null-object</artifactId>
   <dependencies>
diff --git a/object-mother/pom.xml b/object-mother/pom.xml
index 07d724e76..f9ca156ad 100644
--- a/object-mother/pom.xml
+++ b/object-mother/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>object-mother</artifactId>
     <dependencies>
diff --git a/object-pool/pom.xml b/object-pool/pom.xml
index ed3f87a0d..0587c3968 100644
--- a/object-pool/pom.xml
+++ b/object-pool/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>object-pool</artifactId>
   <dependencies>
diff --git a/observer/pom.xml b/observer/pom.xml
index e971c5602..c558992ac 100644
--- a/observer/pom.xml
+++ b/observer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>observer</artifactId>
   <dependencies>
diff --git a/page-object/pom.xml b/page-object/pom.xml
index 6c1066fce..a91843121 100644
--- a/page-object/pom.xml
+++ b/page-object/pom.xml
@@ -46,7 +46,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>page-object</artifactId>
     <packaging>pom</packaging>
diff --git a/page-object/sample-application/pom.xml b/page-object/sample-application/pom.xml
index c715418d5..6748a4063 100644
--- a/page-object/sample-application/pom.xml
+++ b/page-object/sample-application/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>page-object</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>sample-application</artifactId>
 </project>
diff --git a/page-object/test-automation/pom.xml b/page-object/test-automation/pom.xml
index f2ca98689..5f64807de 100644
--- a/page-object/test-automation/pom.xml
+++ b/page-object/test-automation/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <artifactId>page-object</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>test-automation</artifactId>
   <dependencies>
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index a4788e5d1..fbece028e 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/pipeline/pom.xml b/pipeline/pom.xml
index a29007cda..fca6180bc 100644
--- a/pipeline/pom.xml
+++ b/pipeline/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>pipeline</artifactId>
     <dependencies>
diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml
index 38d12c6c7..c4780fe1b 100644
--- a/poison-pill/pom.xml
+++ b/poison-pill/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>poison-pill</artifactId>
   <dependencies>
diff --git a/pom.xml b/pom.xml
index 56c593574..56b955204 100644
--- a/pom.xml
+++ b/pom.xml
@@ -20,7 +20,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
     <packaging>pom</packaging>
     <inceptionYear>2014-2019</inceptionYear>
     <properties>
diff --git a/priority-queue/pom.xml b/priority-queue/pom.xml
index 338079a66..ff04a5359 100644
--- a/priority-queue/pom.xml
+++ b/priority-queue/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <dependencies>
diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml
index bc4eeff65..01d0149ea 100644
--- a/private-class-data/pom.xml
+++ b/private-class-data/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>private-class-data</artifactId>
   <dependencies>
diff --git a/producer-consumer/pom.xml b/producer-consumer/pom.xml
index 853eb68f8..4884ef728 100644
--- a/producer-consumer/pom.xml
+++ b/producer-consumer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>producer-consumer</artifactId>
   <dependencies>
diff --git a/promise/pom.xml b/promise/pom.xml
index ac0f66a43..6ef67edec 100644
--- a/promise/pom.xml
+++ b/promise/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>promise</artifactId>
   <dependencies>
diff --git a/property/pom.xml b/property/pom.xml
index e96371c9c..8746a60ac 100644
--- a/property/pom.xml
+++ b/property/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>property</artifactId>
   <dependencies>
diff --git a/prototype/pom.xml b/prototype/pom.xml
index 7fc26080a..220ed4521 100644
--- a/prototype/pom.xml
+++ b/prototype/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>prototype</artifactId>
   <dependencies>
diff --git a/proxy/pom.xml b/proxy/pom.xml
index 8d2749483..0e7707bf8 100644
--- a/proxy/pom.xml
+++ b/proxy/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>proxy</artifactId>
   <dependencies>
diff --git a/queue-load-leveling/pom.xml b/queue-load-leveling/pom.xml
index 8f9a785c9..817e6e3cc 100644
--- a/queue-load-leveling/pom.xml
+++ b/queue-load-leveling/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>queue-load-leveling</artifactId>
   <dependencies>
diff --git a/reactor/pom.xml b/reactor/pom.xml
index 424c00db7..c25ed45ae 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>reactor</artifactId>
   <dependencies>
diff --git a/reader-writer-lock/pom.xml b/reader-writer-lock/pom.xml
index 10d49f6cc..37f70b435 100644
--- a/reader-writer-lock/pom.xml
+++ b/reader-writer-lock/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>reader-writer-lock</artifactId>
     <dependencies>
diff --git a/repository/pom.xml b/repository/pom.xml
index 5511c4fc3..694629efa 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>repository</artifactId>
     <dependencies>
diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml
index 80d34e3aa..34428033b 100644
--- a/resource-acquisition-is-initialization/pom.xml
+++ b/resource-acquisition-is-initialization/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>resource-acquisition-is-initialization</artifactId>
   <dependencies>
diff --git a/retry/pom.xml b/retry/pom.xml
index db59fa049..2f0b15bd2 100644
--- a/retry/pom.xml
+++ b/retry/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <artifactId>retry</artifactId>
     <packaging>jar</packaging>
diff --git a/role-object/pom.xml b/role-object/pom.xml
index 2b3e07be0..07becfc9b 100644
--- a/role-object/pom.xml
+++ b/role-object/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
 
   <artifactId>role-object</artifactId>
diff --git a/saga/pom.xml b/saga/pom.xml
index c83c8fb45..a3ae60ed8 100644
--- a/saga/pom.xml
+++ b/saga/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <artifactId>saga</artifactId>
diff --git a/semaphore/pom.xml b/semaphore/pom.xml
index 0a2ac7aed..64fd44db6 100644
--- a/semaphore/pom.xml
+++ b/semaphore/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>semaphore</artifactId>
   <dependencies>
diff --git a/servant/pom.xml b/servant/pom.xml
index e8925cea9..c7b282c09 100644
--- a/servant/pom.xml
+++ b/servant/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>servant</artifactId>
   <dependencies>
diff --git a/serverless/pom.xml b/serverless/pom.xml
index c9d7ec71b..2880764ec 100644
--- a/serverless/pom.xml
+++ b/serverless/pom.xml
@@ -31,7 +31,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
 
     <dependencies>
diff --git a/service-layer/pom.xml b/service-layer/pom.xml
index aaee48310..071cf0f49 100644
--- a/service-layer/pom.xml
+++ b/service-layer/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>service-layer</artifactId>
   <dependencies>
diff --git a/service-locator/pom.xml b/service-locator/pom.xml
index ed2366ed0..2b0037eb8 100644
--- a/service-locator/pom.xml
+++ b/service-locator/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>service-locator</artifactId>
   <dependencies>
diff --git a/sharding/pom.xml b/sharding/pom.xml
index 61c15db5b..5f6c40ee5 100644
--- a/sharding/pom.xml
+++ b/sharding/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/singleton/pom.xml b/singleton/pom.xml
index 7b7686108..80a34ea86 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>singleton</artifactId>
   <dependencies>
diff --git a/spatial-partition/pom.xml b/spatial-partition/pom.xml
index 2f47d73d9..fe749b22b 100644
--- a/spatial-partition/pom.xml
+++ b/spatial-partition/pom.xml
@@ -46,7 +46,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>spatial-partition</artifactId>
   <dependencies>
diff --git a/specification/pom.xml b/specification/pom.xml
index d2945516b..1494ca305 100644
--- a/specification/pom.xml
+++ b/specification/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>specification</artifactId>
   <dependencies>
diff --git a/state/pom.xml b/state/pom.xml
index c53f3d797..a434dabe4 100644
--- a/state/pom.xml
+++ b/state/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>state</artifactId>
   <dependencies>
diff --git a/step-builder/pom.xml b/step-builder/pom.xml
index 1de9b653d..de5763695 100644
--- a/step-builder/pom.xml
+++ b/step-builder/pom.xml
@@ -30,7 +30,7 @@
   <parent>
     <artifactId>java-design-patterns</artifactId>
     <groupId>com.iluwatar</groupId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>step-builder</artifactId>
   <dependencies>
diff --git a/strangler/pom.xml b/strangler/pom.xml
index ba85f7184..7cb2ff263 100644
--- a/strangler/pom.xml
+++ b/strangler/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/strategy/pom.xml b/strategy/pom.xml
index aad38f1ce..0f3b0e830 100644
--- a/strategy/pom.xml
+++ b/strategy/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>strategy</artifactId>
   <dependencies>
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index 144f099a3..780547e95 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/template-method/pom.xml b/template-method/pom.xml
index 36a0d8550..cbf2ac156 100644
--- a/template-method/pom.xml
+++ b/template-method/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>template-method</artifactId>
   <dependencies>
diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml
index abcb8a9f5..3727bd240 100644
--- a/thread-pool/pom.xml
+++ b/thread-pool/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>thread-pool</artifactId>
   <dependencies>
diff --git a/throttling/pom.xml b/throttling/pom.xml
index 77f911c24..ba2ca9c47 100644
--- a/throttling/pom.xml
+++ b/throttling/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/tls/pom.xml b/tls/pom.xml
index f6adc911f..54e911e40 100644
--- a/tls/pom.xml
+++ b/tls/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>tls</artifactId>
   <dependencies>
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index 3324f75f0..6cc0ac283 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>tolerant-reader</artifactId>
   <dependencies>
diff --git a/trampoline/pom.xml b/trampoline/pom.xml
index c651b4f8b..fff117bf8 100644
--- a/trampoline/pom.xml
+++ b/trampoline/pom.xml
@@ -30,7 +30,7 @@
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
 
     </parent>
     <artifactId>trampoline</artifactId>
diff --git a/transaction-script/pom.xml b/transaction-script/pom.xml
index 081567c47..7a6f40219 100644
--- a/transaction-script/pom.xml
+++ b/transaction-script/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/twin/pom.xml b/twin/pom.xml
index 37c06bd20..b879ac593 100644
--- a/twin/pom.xml
+++ b/twin/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>twin</artifactId>
   <dependencies>
diff --git a/typeobjectpattern/pom.xml b/typeobjectpattern/pom.xml
index 32e252aea..03af8e78d 100644
--- a/typeobjectpattern/pom.xml
+++ b/typeobjectpattern/pom.xml
@@ -27,7 +27,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>typeobjectpattern</artifactId>
   <dependencies>
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index 730b7921b..1d57e138f 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -29,7 +29,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/update-method/pom.xml b/update-method/pom.xml
index 2659d1e2c..3a60d433b 100644
--- a/update-method/pom.xml
+++ b/update-method/pom.xml
@@ -28,7 +28,7 @@
     <parent>
         <artifactId>java-design-patterns</artifactId>
         <groupId>com.iluwatar</groupId>
-        <version>1.23.0</version>
+        <version>1.24.0-SNAPSHOT</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
diff --git a/value-object/pom.xml b/value-object/pom.xml
index a2dd714de..dbbbccd01 100644
--- a/value-object/pom.xml
+++ b/value-object/pom.xml
@@ -30,7 +30,7 @@
 	<parent>
 		<groupId>com.iluwatar</groupId>
 		<artifactId>java-design-patterns</artifactId>
-		<version>1.23.0</version>
+		<version>1.24.0-SNAPSHOT</version>
 	</parent>
 	<artifactId>value-object</artifactId>
 	<dependencies>
diff --git a/visitor/pom.xml b/visitor/pom.xml
index dddb4d4e3..a08f6ee8c 100644
--- a/visitor/pom.xml
+++ b/visitor/pom.xml
@@ -29,7 +29,7 @@
   <parent>
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
-    <version>1.23.0</version>
+    <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>visitor</artifactId>
   <dependencies>

From 9dd46d7b4a4329d07956b263dd627272e25db707 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 25 Aug 2020 21:42:42 +0300
Subject: [PATCH 040/254] Update README.md

---
 builder/README.md | 39 ++++++++++++++++++++++++++-------------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/builder/README.md b/builder/README.md
index bb7426e35..008854ed7 100644
--- a/builder/README.md
+++ b/builder/README.md
@@ -9,36 +9,47 @@ tags:
 ---
 
 ## Intent
-Separate the construction of a complex object from its
-representation so that the same construction process can create different
-representations.
+
+Separate the construction of a complex object from its representation so that the same construction 
+process can create different representations.
 
 ## Explanation
 
 Real world example
 
-> Imagine a character generator for a role playing game. The easiest option is to let computer create the character for you. But if you want to select the character details like profession, gender, hair color etc. the character generation becomes a step-by-step process that completes when all the selections are ready.
+> Imagine a character generator for a role-playing game. The easiest option is to let the computer 
+> create the character for you. If you want to manually select the character details like 
+> profession, gender, hair color etc. the character generation becomes a step-by-step process that 
+> completes when all the selections are ready.
 
 In plain words
 
-> Allows you to create different flavors of an object while avoiding constructor pollution. Useful when there could be several flavors of an object. Or when there are a lot of steps involved in creation of an object.
+> Allows you to create different flavors of an object while avoiding constructor pollution. Useful 
+> when there could be several flavors of an object. Or when there are a lot of steps involved in 
+> creation of an object.
 
 Wikipedia says
 
-> The builder pattern is an object creation software design pattern with the intentions of finding a solution to the telescoping constructor anti-pattern.
+> The builder pattern is an object creation software design pattern with the intentions of finding 
+> a solution to the telescoping constructor anti-pattern.
 
-Having said that let me add a bit about what telescoping constructor anti-pattern is. At one point or the other we have all seen a constructor like below:
+Having said that let me add a bit about what telescoping constructor anti-pattern is. At one point 
+or the other, we have all seen a constructor like below:
 
 ```java
 public Hero(Profession profession, String name, HairType hairType, HairColor hairColor, Armor armor, Weapon weapon) {
 }
 ```
 
-As you can see the number of constructor parameters can quickly get out of hand and it might become difficult to understand the arrangement of parameters. Plus this parameter list could keep on growing if you would want to add more options in future. This is called telescoping constructor anti-pattern.
+As you can see the number of constructor parameters can quickly get out of hand, and it may become 
+difficult to understand the arrangement of parameters. Plus this parameter list could keep on 
+growing if you would want to add more options in the future. This is called telescoping constructor 
+anti-pattern.
 
 **Programmatic Example**
 
-The sane alternative is to use the Builder pattern. First of all we have our hero that we want to create
+The sane alternative is to use the Builder pattern. First of all we have our hero that we want to 
+create:
 
 ```java
 public final class Hero {
@@ -60,7 +71,7 @@ public final class Hero {
 }
 ```
 
-And then we have the builder
+Then we have the builder:
 
 ```java
   public static class Builder {
@@ -105,20 +116,22 @@ And then we have the builder
   }
 ```
 
-And then it can be used as:
+Then it can be used as:
 
 ```java
 var mage = new Hero.Builder(Profession.MAGE, "Riobard").withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER).build();
 ```
 
 ## Class diagram
+
 ![alt text](./etc/builder.urm.png "Builder class diagram")
 
 ## Applicability
+
 Use the Builder pattern when
 
-* the algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled
-* the construction process must allow different representations for the object that's constructed
+* The algorithm for creating a complex object should be independent of the parts that make up the object and how they're assembled
+* The construction process must allow different representations for the object that's constructed
 
 ## Real world examples
 

From b07d33f332f2378e26b4191de42174fb7ba83468 Mon Sep 17 00:00:00 2001
From: Amit Garg <amit.garg@sky.uk>
Date: Wed, 26 Aug 2020 00:09:30 +0100
Subject: [PATCH 041/254] Upgrade Mockito version to latest

---
 pom.xml | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 56b955204..6d779700f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -39,7 +39,7 @@
         <commons-dbcp.version>1.4</commons-dbcp.version>
         <camel.version>2.24.0</camel.version>
         <guava.version>19.0</guava.version>
-        <mockito.version>1.10.19</mockito.version>
+        <mockito.version>3.5.6</mockito.version>
         <htmlunit.version>2.22</htmlunit.version>
         <guice.version>4.0</guice.version>
         <mongo-java-driver.version>3.12.1</mongo-java-driver.version>
@@ -206,6 +206,18 @@
 
     <dependencyManagement>
         <dependencies>
+            <dependency>
+                <groupId>net.bytebuddy</groupId>
+                <artifactId>byte-buddy</artifactId>
+                <version>1.9.7</version>
+                <scope>test</scope>
+            </dependency>
+            <dependency>
+                <groupId>net.bytebuddy</groupId>
+                <artifactId>byte-buddy-agent</artifactId>
+                <version>1.9.7</version>
+                <scope>test</scope>
+            </dependency>
             <dependency>
                 <groupId>org.hibernate</groupId>
                 <artifactId>hibernate-core</artifactId>

From 8983f9c11ce69f18661479ef40512bbab0c98bb0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Wed, 26 Aug 2020 21:54:44 +0300
Subject: [PATCH 042/254] Update README.md

---
 callback/README.md             |  18 ++++++++++++------
 callback/etc/callback.png      | Bin 8577 -> 18256 bytes
 callback/etc/callback.urm.puml |   5 -----
 3 files changed, 12 insertions(+), 11 deletions(-)

diff --git a/callback/README.md b/callback/README.md
index 78766cc15..34543f0bb 100644
--- a/callback/README.md
+++ b/callback/README.md
@@ -9,14 +9,16 @@ tags:
 ---
 
 ## Intent
-Callback is a piece of executable code that is passed as an argument to other code, which is expected to call back 
-(execute) the argument at some convenient time.
+
+Callback is a piece of executable code that is passed as an argument to other code, which is 
+expected to call back (execute) the argument at some convenient time.
 
 ## Explanation
 
 Real world example
 
-> We need to be notified after executing task has finished. We pass a callback method for the executor and wait for it to call back on us.     
+> We need to be notified after executing task has finished. We pass a callback method for 
+> the executor and wait for it to call back on us.     
 
 In plain words
 
@@ -24,7 +26,9 @@ In plain words
 
 Wikipedia says
 
-> In computer programming, a callback, also known as a "call-after" function, is any executable code that is passed as an argument to other code; that other code is expected to call back (execute) the argument at a given time.
+> In computer programming, a callback, also known as a "call-after" function, is any executable 
+> code that is passed as an argument to other code; that other code is expected to call 
+> back (execute) the argument at a given time.
 
 **Programmatic Example**
 
@@ -61,7 +65,7 @@ public final class SimpleTask extends Task {
 }
 ```
 
-Finally here's how we execute a task and receive a callback when it's finished.
+Finally, here's how we execute a task and receive a callback when it's finished.
 
 ```java
     var task = new SimpleTask();
@@ -69,13 +73,15 @@ Finally here's how we execute a task and receive a callback when it's finished.
 ```
 
 ## Class diagram
+
 ![alt text](./etc/callback.png "Callback")
 
 ## Applicability
+
 Use the Callback pattern when
 
 * when some arbitrary synchronous or asynchronous action must be performed after execution of some defined activity.
 
 ## Real world examples
 
-* [CyclicBarrier](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CyclicBarrier.html#CyclicBarrier%28int,%20java.lang.Runnable%29) constructor can accept callback that will be triggered every time when barrier is tripped.
+* [CyclicBarrier](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CyclicBarrier.html#CyclicBarrier%28int,%20java.lang.Runnable%29) constructor can accept a callback that will be triggered every time a barrier is tripped.
diff --git a/callback/etc/callback.png b/callback/etc/callback.png
index a81745871a642705dad3be5fe90fc7abacb7185c..7b499f79fcaa1484dcdd485668c14549eef79b6e 100644
GIT binary patch
literal 18256
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
G`uso13T4~?

literal 8577
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
Peyvbb(N->dY!&ujDtTa#

diff --git a/callback/etc/callback.urm.puml b/callback/etc/callback.urm.puml
index a666a4fdb..2d213eda8 100644
--- a/callback/etc/callback.urm.puml
+++ b/callback/etc/callback.urm.puml
@@ -8,11 +8,6 @@ package com.iluwatar.callback {
   interface Callback {
     + call() {abstract}
   }
-  class LambdasApp {
-    - LOGGER : Logger {static}
-    - LambdasApp()
-    + main(args : String[]) {static}
-  }
   class SimpleTask {
     - LOGGER : Logger {static}
     + SimpleTask()

From 7118ccafa95916267c2160cdaf12b4be95e1f6b2 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Fri, 28 Aug 2020 12:17:38 +0530
Subject: [PATCH 043/254] Update maven-ci.yml

Removed if clause for building code in main codebase from the CI pipeline.
---
 .github/workflows/maven-ci.yml | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 9281c0f3d..304953bc9 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -49,14 +49,10 @@ jobs:
           ${{ runner.os }}-maven-
     # Some tests need screen access
     - name: Install xvfb
-      run: sudo apt-get install xvfb
+      run: sudo apt-get install -y xvfb
     # SonarQube scan does not work for forked repositories
     # See https://jira.sonarsource.com/browse/MMF-1371
-    - name: Build with Maven
-      if: github.ref != 'refs/heads/master'
-      run: xvfb-run mvn clean verify
     - name: Build with Maven and run SonarQube analysis
-      if: github.ref == 'refs/heads/master'
       run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
       env:
         # These two env variables are needed for sonar analysis

From 47e746c3bae4ebfd7a422b99f923458940067d58 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Fri, 28 Aug 2020 12:26:27 +0530
Subject: [PATCH 044/254] Update maven-pr-builder.yml

removed the if checking block for building Pull Requests as this was redundant code.
---
 .github/workflows/maven-pr-builder.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 7e4f3670f..8ef817687 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -49,9 +49,8 @@ jobs:
           ${{ runner.os }}-maven-
     # Some tests need screen access
     - name: Install xvfb
-      run: sudo apt-get install xvfb
+      run: sudo apt-get install -y xvfb
     # SonarQube scan does not work for forked repositories
     # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven
-      if: github.ref != 'refs/heads/master'
       run: xvfb-run mvn clean verify

From 96c16a8f3a904c17f47856219b245e52df33c000 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 11:29:30 +0300
Subject: [PATCH 045/254] Update README.md

---
 chain/README.md | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/chain/README.md b/chain/README.md
index f11f0c59e..8b0508833 100644
--- a/chain/README.md
+++ b/chain/README.md
@@ -9,27 +9,32 @@ tags:
 ---
 
 ## Intent
-Avoid coupling the sender of a request to its receiver by giving
-more than one object a chance to handle the request. Chain the receiving
-objects and pass the request along the chain until an object handles it.
+Avoid coupling the sender of a request to its receiver by giving more than one object a chance to 
+handle the request. Chain the receiving objects and pass the request along the chain until an object 
+handles it.
 
 ## Explanation
 
 Real world example
 
-> The Orc King gives loud orders to his army. The closest one to react is the commander, then officer and then soldier. The commander, officer and soldier here form a chain of responsibility.
+> The Orc King gives loud orders to his army. The closest one to react is the commander, then 
+> officer and then soldier. The commander, officer and soldier here form a chain of responsibility.
 
 In plain words
 
-> It helps building a chain of objects. Request enters from one end and keeps going from object to object till it finds the suitable handler.
+> It helps to build a chain of objects. A request enters from one end and keeps going from an object 
+> to another until it finds a suitable handler.
 
 Wikipedia says
 
-> In object-oriented design, the chain-of-responsibility pattern is a design pattern consisting of a source of command objects and a series of processing objects. Each processing object contains logic that defines the types of command objects that it can handle; the rest are passed to the next processing object in the chain.
+> In object-oriented design, the chain-of-responsibility pattern is a design pattern consisting of 
+> a source of command objects and a series of processing objects. Each processing object contains 
+> logic that defines the types of command objects that it can handle; the rest are passed to the 
+> next processing object in the chain.
 
 **Programmatic Example**
 
-Translating our example with orcs from above. First we have the request class
+Translating our example with the orcs from above. First we have the `Request` class:
 
 ```java
 public class Request {
@@ -140,14 +145,16 @@ king.makeRequest(new Request(RequestType.COLLECT_TAX, "collect tax")); // Orc so
 ```
 
 ## Class diagram
+
 ![alt text](./etc/chain.urm.png "Chain of Responsibility class diagram")
 
 ## Applicability
+
 Use Chain of Responsibility when
 
-* more than one object may handle a request, and the handler isn't known a priori. The handler should be ascertained automatically
-* you want to issue a request to one of several objects without specifying the receiver explicitly
-* the set of objects that can handle a request should be specified dynamically
+* More than one object may handle a request, and the handler isn't known a priori. The handler should be ascertained automatically.
+* You want to issue a request to one of several objects without specifying the receiver explicitly.
+* The set of objects that can handle a request should be specified dynamically.
 
 ## Real world examples
 

From a4f2d14848ae3f53cd3d6ed6bca9ea7cd0318ef1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 12:01:23 +0300
Subject: [PATCH 046/254] Update README.md

---
 circuit-breaker/README.md | 47 ++++++++++++++++++++++++++-------------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/circuit-breaker/README.md b/circuit-breaker/README.md
index ce280a570..8d2205f2b 100644
--- a/circuit-breaker/README.md
+++ b/circuit-breaker/README.md
@@ -12,32 +12,43 @@ tags:
 
 ## Intent
 
-Handle costly remote *procedure/service* calls in such a way that the failure of a **single** service/component cannot bring the whole application down, and we can reconnect to the service as soon as possible.
+Handle costly remote service calls in such a way that the failure of a single service/component 
+cannot bring the whole application down, and we can reconnect to the service as soon as possible.
 
 ## Explanation
 
 Real world example
 
-> Imagine a Web App that has both local (example: files and images) and remote (example: database entries) to serve. The database might not be responding due to a variety of reasons, so if the application keeps trying to read from the database using multiple threads/processes, soon all of them will hang and our entire web application will crash. We should be able to detect this situation and show the user an appropriate message so that he/she can explore other parts of the app unaffected by the database failure without any problem. 
+> Imagine a web application that has both local files/images and remote database entries to serve. 
+> The database might not be responding due to a variety of reasons, so if the application keeps 
+> trying to read from the database using multiple threads/processes, soon all of them will hang 
+> causing our entire web application will crash. We should be able to detect this situation and show 
+> the user an appropriate message so that he/she can explore other parts of the app unaffected by 
+> the database failure. 
 
 In plain words
 
-> Allows us to save resources when we know a remote service failed. Useful when all parts of our application are highly decoupled from each other, and failure of one component doesn't mean the other parts will stop working.
+> Circuit Breaker allows graceful handling of failed remote services. It's especially useful when 
+> all parts of our application are highly decoupled from each other, and failure of one component 
+> doesn't mean the other parts will stop working.
 
 Wikipedia says
 
-> **Circuit breaker** is a design pattern used in modern software development. It is used to detect failures and encapsulates the logic of preventing a failure from constantly recurring, during maintenance, temporary external system failure or unexpected system difficulties.
-
-So, how does this all come together?
+> Circuit breaker is a design pattern used in modern software development. It is used to detect 
+> failures and encapsulates the logic of preventing a failure from constantly recurring, during 
+> maintenance, temporary external system failure or unexpected system difficulties.
 
 ## Programmatic Example
-With the above example in mind we will imitate the functionality in a simple manner. We have two services: A *monitoring service* which will mimic the web app and will make both **local** and **remote** calls.
+
+So, how does this all come together? With the above example in mind we will imitate the 
+functionality in a simple example. A monitoring service mimics the web app and makes both local and 
+remote calls.
 
 The service architecture is as follows:
 
 ![alt text](./etc/ServiceDiagram.PNG "Service Diagram")
 
-In terms of code, the End user application is:
+In terms of code, the end user application is:
 
 ```java
 public class App {
@@ -62,7 +73,7 @@ public class App {
 }
 ```
 
-The monitoring service is: 
+The monitoring service: 
 
 ``` java
 public class MonitoringService {
@@ -80,7 +91,8 @@ public class MonitoringService {
   }
 }
 ```
-As it can be seen, it does the call to get local resources directly, but it wraps the call to remote (costly) service in a circuit breaker object, which prevents faults as follows:
+As it can be seen, it does the call to get local resources directly, but it wraps the call to 
+remote (costly) service in a circuit breaker object, which prevents faults as follows:
 
 ```java
 public class CircuitBreaker {
@@ -155,24 +167,27 @@ public class CircuitBreaker {
 }
 ```
 
-How does the above pattern prevent failures? Let's understand via this finite state machine implemented by it.
+How does the above pattern prevent failures? Let's understand via this finite state machine 
+implemented by it.
 
 ![alt text](./etc/StateDiagram.PNG "State Diagram")
 
-- We initialize the Circuit Breaker object with certain parameters: **timeout**, **failureThreshold** and **retryTimePeriod** which help determine how resilient the API is.
-- Initially, we are in the **closed** state and the remote call to API happens.
+- We initialize the Circuit Breaker object with certain parameters: `timeout`, `failureThreshold` and `retryTimePeriod` which help determine how resilient the API is.
+- Initially, we are in the `closed` state and nos remote calls to the API have occurred.
 - Every time the call succeeds, we reset the state to as it was in the beginning.
-- If the number of failures cross a certain threshold, we move to the **open** state, which acts just like an open circuit and prevents remote service calls from being made, thus saving resources. (Here, we return the response called ```stale response from API```)
-- Once we exceed the retry timeout period, we move to the **half-open** state and make another call to the remote service again to check if the service is working so that we can serve fresh content. A *failure* sets it back to **open** state and another attempt is made after retry timeout period, while a *success* sets it to **closed** state so that everything starts working normally again. 
+- If the number of failures cross a certain threshold, we move to the `open` state, which acts just like an open circuit and prevents remote service calls from being made, thus saving resources. (Here, we return the response called ```stale response from API```)
+- Once we exceed the retry timeout period, we move to the `half-open` state and make another call to the remote service again to check if the service is working so that we can serve fresh content. A failure sets it back to `open` state and another attempt is made after retry timeout period, while a success sets it to `closed` state so that everything starts working normally again. 
 
 ## Class diagram
+
 ![alt text](./etc/circuit-breaker.urm.png "Circuit Breaker class diagram")
 
 ## Applicability
+
 Use the Circuit Breaker pattern when
 
 - Building a fault-tolerant application where failure of some services shouldn't bring the entire application down.
-- Building an continuously incremental/continuous delivery application, as some of it's components can be upgraded without shutting it down entirely.
+- Building a continuously running (always-on) application, so that its components can be upgraded without shutting it down entirely.
 
 ## Related Patterns
 

From 8135dbecdba26c93aad9d40dbee67f2fadd63167 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 29 Aug 2020 17:36:31 +0530
Subject: [PATCH 047/254] Update maven-ci.yml

---
 .github/workflows/maven-ci.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 304953bc9..cb3b8e45c 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -50,7 +50,8 @@ jobs:
     # Some tests need screen access
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
-    # SonarQube scan does not work for forked repositories
+    # The SonarQube analysis is only for the master branch of the main repository.
+    # SonarQube scan does not work for forked repositories try changing it to xvfb-run mvn clean verify
     # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven and run SonarQube analysis
       run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar

From 338c146c7888d368177c50808ea581bf3e42aa45 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 29 Aug 2020 17:39:50 +0530
Subject: [PATCH 048/254] Update maven-pr-builder.yml

---
 .github/workflows/maven-pr-builder.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 8ef817687..0c6d624c2 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -50,7 +50,8 @@ jobs:
     # Some tests need screen access
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
-    # SonarQube scan does not work for forked repositories
+    # This worflow is only for building Pull Requests, the master branch runs Sonar analysis on the main repository.
+    # SonarQube scan does not work for forked repositories.
     # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven
       run: xvfb-run mvn clean verify

From 675b2f14b22b042be0663f05afd7a56cfaf1b5d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:10:59 +0300
Subject: [PATCH 049/254] Update README.md

---
 command/README.md | 72 +++++++++++++++++++++++++++++++++--------------
 1 file changed, 51 insertions(+), 21 deletions(-)

diff --git a/command/README.md b/command/README.md
index b763cf4dd..28c7e88e9 100644
--- a/command/README.md
+++ b/command/README.md
@@ -9,15 +9,20 @@ tags:
 ---
 
 ## Also known as
+
 Action, Transaction
 
 ## Intent
-Encapsulate a request as an object, thereby letting you parameterize clients with different requests, queue or log requests, and support undoable operations.
+
+Encapsulate a request as an object, thereby letting you parameterize clients with different 
+requests, queue or log requests, and support undoable operations.
 
 ## Explanation
 Real world example
 
-> There is a wizard casting spells on a goblin. The spells are executed on the goblin one by one. The first spell shrinks the goblin and the second makes him invisible. Then the wizard reverses the spells one by one. Each spell here is a command object that can be undone.
+> There is a wizard casting spells on a goblin. The spells are executed on the goblin one by one. 
+> The first spell shrinks the goblin and the second makes him invisible. Then the wizard reverses 
+> the spells one by one. Each spell here is a command object that can be undone.
 
 In plain words
 
@@ -25,11 +30,13 @@ In plain words
 
 Wikipedia says
 
-> In object-oriented programming, the command pattern is a behavioral design pattern in which an object is used to encapsulate all information needed to perform an action or trigger an event at a later time.
+> In object-oriented programming, the command pattern is a behavioral design pattern in which an 
+> object is used to encapsulate all information needed to perform an action or trigger an event at 
+> a later time.
 
 **Programmatic Example**
 
-Here's the sample code with wizard and goblin. Let's start from the wizard class.
+Here's the sample code with wizard and goblin. Let's start from the `Wizard` class.
 
 ```java
 public class Wizard {
@@ -149,7 +156,7 @@ public class ShrinkSpell implements Command {
 }
 ```
 
-And last we have the goblin who's the target of the spells.
+Finally, we have the goblin who's the target of the spells.
 
 ```java
 public abstract class Target {
@@ -199,44 +206,67 @@ public class Goblin extends Target {
 }
 ```
 
-Finally here's the whole example in action.
+Here's the whole example in action.
 
 ```java
 var wizard = new Wizard();
 var goblin = new Goblin();
 goblin.printStatus();
-// Goblin, [size=normal] [visibility=visible]
 wizard.castSpell(new ShrinkSpell(), goblin);
-// Wizard casts Shrink spell at Goblin
 goblin.printStatus();
-// Goblin, [size=small] [visibility=visible]
 wizard.castSpell(new InvisibilitySpell(), goblin);
-// Wizard casts Invisibility spell at Goblin
 goblin.printStatus();
-// Goblin, [size=small] [visibility=invisible]
 wizard.undoLastSpell();
-// Wizard undoes Invisibility spell
 goblin.printStatus();
+```
+
+Here's the program output:
+
+```java
+// Goblin, [size=normal] [visibility=visible]
+// Wizard casts Shrink spell at Goblin
+// Goblin, [size=small] [visibility=visible]
+// Wizard casts Invisibility spell at Goblin
+// Goblin, [size=small] [visibility=invisible]
+// Wizard undoes Invisibility spell
 // Goblin, [size=small] [visibility=visible]
 ```
 
 ## Class diagram
+
 ![alt text](./etc/command.png "Command")
 
 ## Applicability
-Use the Command pattern when you want to
 
-* parameterize objects by an action to perform. You can express such parameterization in a procedural language with a callback function, that is, a function that's registered somewhere to be called at a later point. Commands are an object-oriented replacement for callbacks.
-* specify, queue, and execute requests at different times. A Command object can have a lifetime independent of the original request. If the receiver of a request can be represented in an address space-independent way, then you can transfer a command object for the request to a different process and fulfill the request there
-* support undo. The Command's execute operation can store state for reversing its effects in the command itself. The Command interface must have an added Unexecute operation that reverses the effects of a previous call to execute. Executed commands are stored in a history list. Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling unexecute and execute, respectively
-* support logging changes so that they can be reapplied in case of a system crash. By augmenting the Command interface with load and store operations, you can keep a persistent log of changes. Recovering from a crash involves reloading logged commands from disk and re-executing them with the execute operation
-* structure a system around high-level operations build on primitive operations. Such a structure is common in information systems that support transactions. A transaction encapsulates a set of changes to data. The Command pattern offers a way to model transactions. Commands have a common interface, letting you invoke all transactions the same way. The pattern also makes it easy to extend the system with new transactions
+Use the Command pattern when you want to:
+
+* Parameterize objects by an action to perform. You can express such parameterization in a 
+procedural language with a callback function, that is, a function that's registered somewhere to be 
+called at a later point. Commands are an object-oriented replacement for callbacks.
+* Specify, queue, and execute requests at different times. A Command object can have a lifetime 
+independent of the original request. If the receiver of a request can be represented in an address 
+space-independent way, then you can transfer a command object for the request to a different process 
+and fulfill the request there.
+* Support undo. The Command's execute operation can store state for reversing its effects in the 
+command itself. The Command interface must have an added un-execute operation that reverses the 
+effects of a previous call to execute. The executed commands are stored in a history list. 
+Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling 
+un-execute and execute, respectively.
+* Support logging changes so that they can be reapplied in case of a system crash. By augmenting the 
+Command interface with load and store operations, you can keep a persistent log of changes. 
+Recovering from a crash involves reloading logged commands from disk and re-executing them with 
+the execute operation.
+* Structure a system around high-level operations build on primitive operations. Such a structure is 
+common in information systems that support transactions. A transaction encapsulates a set of changes 
+to data. The Command pattern offers a way to model transactions. Commands have a common interface, 
+letting you invoke all transactions the same way. The pattern also makes it easy to extend the 
+system with new transactions.
 
 ## Typical Use Case
 
-* to keep a history of requests
-* implement callback functionality
-* implement the undo functionality
+* To keep a history of requests
+* Implement callback functionality
+* Implement the undo functionality
 
 ## Real world examples
 

From 2bb2134636dec894c828666e9bdc1920775883be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:17:15 +0300
Subject: [PATCH 050/254] Update README.md

---
 composite/README.md | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/composite/README.md b/composite/README.md
index dad6fb5a5..b7aaa69df 100644
--- a/composite/README.md
+++ b/composite/README.md
@@ -9,15 +9,17 @@ tags:
 ---
 
 ## Intent
-Compose objects into tree structures to represent part-whole
-hierarchies. Composite lets clients treat individual objects and compositions
-of objects uniformly.
+
+Compose objects into tree structures to represent part-whole hierarchies. Composite lets clients 
+treat individual objects and compositions of objects uniformly.
 
 ## Explanation
 
 Real world example
 
-> Every sentence is composed of words which are in turn composed of characters. Each of these objects is printable and they can have something printed before or after them like sentence always ends with full stop and word always has space before it
+> Every sentence is composed of words which are in turn composed of characters. Each of these 
+> objects is printable and they can have something printed before or after them like sentence always 
+> ends with full stop and word always has space before it.
 
 In plain words
 
@@ -25,11 +27,16 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, the composite pattern is a partitioning design pattern. The composite pattern describes that a group of objects is to be treated in the same way as a single instance of an object. The intent of a composite is to "compose" objects into tree structures to represent part-whole hierarchies. Implementing the composite pattern lets clients treat individual objects and compositions uniformly.
+> In software engineering, the composite pattern is a partitioning design pattern. The composite 
+> pattern describes that a group of objects is to be treated in the same way as a single instance of 
+> an object. The intent of a composite is to "compose" objects into tree structures to represent 
+> part-whole hierarchies. Implementing the composite pattern lets clients treat individual objects 
+> and compositions uniformly.
 
 **Programmatic Example**
 
-Taking our sentence example from above. Here we have the base class and different printable types
+Taking our sentence example from above. Here we have the base class `LetterComposite` and the 
+different printable types `Letter`, `Word` and `Sentence`. 
 
 ```java
 public abstract class LetterComposite {
@@ -102,7 +109,7 @@ public class Sentence extends LetterComposite {
 }
 ```
 
-Then we have a messenger to carry messages
+Then we have a messenger to carry messages:
 
 ```java
 public class Messenger {
@@ -143,7 +150,7 @@ public class Messenger {
 }
 ```
 
-And then it can be used as
+And then it can be used as:
 
 ```java
 var orcMessage = new Messenger().messageFromOrcs();
@@ -153,13 +160,16 @@ elfMessage.print(); // Much wind pours from your mouth.
 ```
 
 ## Class diagram
+
 ![alt text](./etc/composite.urm.png "Composite class diagram")
 
 ## Applicability
+
 Use the Composite pattern when
 
-* you want to represent part-whole hierarchies of objects
-* you want clients to be able to ignore the difference between compositions of objects and individual objects. Clients will treat all objects in the composite structure uniformly
+* You want to represent part-whole hierarchies of objects.
+* You want clients to be able to ignore the difference between compositions of objects and 
+individual objects. Clients will treat all objects in the composite structure uniformly.
 
 ## Real world examples
 

From e8b42bd135fbedf4816b1d5222a13dfbf0701ad7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:23:28 +0300
Subject: [PATCH 051/254] Update README.md

---
 converter/README.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/converter/README.md b/converter/README.md
index 3be8ce331..02b172149 100644
--- a/converter/README.md
+++ b/converter/README.md
@@ -9,16 +9,19 @@ tags:
 ---
 
 ## Intent
-The purpose of the Converter Pattern is to provide a generic, common way of bidirectional
+
+The purpose of the Converter pattern is to provide a generic, common way of bidirectional
 conversion between corresponding types, allowing a clean implementation in which the types do not
-need to be aware of each other. Moreover, the Converter Pattern introduces bidirectional collection
+need to be aware of each other. Moreover, the Converter pattern introduces bidirectional collection
 mapping, reducing a boilerplate code to minimum.
 
 ## Explanation
 
 Real world example
 
-> In real world applications it is often the case that database layer consists of entities that need to be mapped into DTOs for use on the business logic layer. Similar mapping is done for potentially huge amount of classes and we need a generic way to achieve this.
+> In real world applications it is often the case that database layer consists of entities that need 
+> to be mapped into DTOs for use on the business logic layer. Similar mapping is done for 
+> potentially huge amount of classes and we need a generic way to achieve this.
 
 In plain words
 
@@ -26,7 +29,8 @@ In plain words
 
 **Programmatic Example**
 
-We need a generic solution for the mapping problem. To achieve this, let's introduce a generic converter.
+We need a generic solution for the mapping problem. To achieve this, let's introduce a generic 
+converter.
 
 ```java
 public class Converter<T, U> {
@@ -77,7 +81,7 @@ public class UserConverter extends Converter<UserDto, User> {
 }
 ```
 
-Now mapping between User and UserDto becomes trivial.
+Now mapping between `User` and `UserDto` becomes trivial.
 
 ```java
 var userConverter = new UserConverter();
@@ -86,14 +90,18 @@ var user = userConverter.convertFromDto(dtoUser);
 ```
 
 ## Class diagram
+
 ![alt text](./etc/converter.png "Converter Pattern")
 
 ## Applicability
+
 Use the Converter Pattern in the following situations:
 
-* When you have types that logically correspond which other and you need to convert entities between them
-* When you want to provide different ways of types conversions depending on a context
-* Whenever you introduce a DTO (Data transfer object), you will probably need to convert it into the domain equivalence
+* When you have types that logically correspond with each other and you need to convert entities 
+between them.
+* When you want to provide different ways of types conversions depending on the context.
+* Whenever you introduce a DTO (Data transfer object), you will probably need to convert it into the 
+domain equivalence.
 
 ## Credits
 

From 6373f7b115e570c0e075cc25eb1770ba41aeb2ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:38:20 +0300
Subject: [PATCH 052/254] Update README.md

---
 dao/README.md | 248 ++++++++++----------------------------------------
 1 file changed, 47 insertions(+), 201 deletions(-)

diff --git a/dao/README.md b/dao/README.md
index 11e5f9ca3..29e64a74f 100644
--- a/dao/README.md
+++ b/dao/README.md
@@ -9,13 +9,15 @@ tags:
 ---
 
 ## Intent
+
 Object provides an abstract interface to some type of database or other persistence mechanism.
 
 ## Explanation
 
 Real world example
 
-> There's a set of customers that need to be persisted to database. Additionally we need the whole set of CRUD (create/read/update/delete) operations so we can operate on customers easily. 
+> There's a set of customers that need to be persisted to database. Additionally we need the whole 
+> set of CRUD (create/read/update/delete) operations so we can operate on customers easily. 
 
 In plain words
 
@@ -23,11 +25,12 @@ In plain words
 
 Wikipedia says
 
-> In computer software, a data access object (DAO) is a pattern that provides an abstract interface to some type of database or other persistence mechanism.
+> In computer software, a data access object (DAO) is a pattern that provides an abstract interface 
+> to some type of database or other persistence mechanism.
 
 **Programmatic Example**
 
-Walking through our customers example, here's the basic Customer entity.
+Walking through our customers example, here's the basic `Customer` entity.
 
 ```java
 public class Customer {
@@ -41,60 +44,13 @@ public class Customer {
     this.firstName = firstName;
     this.lastName = lastName;
   }
-
-  public int getId() {
-    return id;
-  }
-
-  public void setId(final int id) {
-    this.id = id;
-  }
-
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public void setFirstName(final String firstName) {
-    this.firstName = firstName;
-  }
-
-  public String getLastName() {
-    return lastName;
-  }
-
-  public void setLastName(final String lastName) {
-    this.lastName = lastName;
-  }
-
-  @Override
-  public String toString() {
-    return "Customer{" + "id=" + getId() + ", firstName='" + getFirstName() + '\'' + ", lastName='"
-        + getLastName() + '\'' + '}';
-  }
-
-  @Override
-  public boolean equals(final Object that) {
-    var isEqual = false;
-    if (this == that) {
-      isEqual = true;
-    } else if (that != null && getClass() == that.getClass()) {
-      final var customer = (Customer) that;
-      if (getId() == customer.getId()) {
-        isEqual = true;
-      }
-    }
-    return isEqual;
-  }
-
-  @Override
-  public int hashCode() {
-    return getId();
-  }
+  // getters and setters ->
+  ...
 }
 ```
 
-Here's the DAO interface and two different implementations for it. InMemoryCustomerDao keeps a simple map of customers 
-in memory while DBCustomerDao is the real RDBMS implementation.
+Here's the `CustomerDao` interface and two different implementations for it. `InMemoryCustomerDao` 
+keeps a simple map of customers in memory while `DBCustomerDao` is the real RDBMS implementation.
 
 ```java
 public interface CustomerDao {
@@ -114,35 +70,8 @@ public class InMemoryCustomerDao implements CustomerDao {
 
   private final Map<Integer, Customer> idToCustomer = new HashMap<>();
 
-  @Override
-  public Stream<Customer> getAll() {
-    return idToCustomer.values().stream();
-  }
-
-  @Override
-  public Optional<Customer> getById(final int id) {
-    return Optional.ofNullable(idToCustomer.get(id));
-  }
-
-  @Override
-  public boolean add(final Customer customer) {
-    if (getById(customer.getId()).isPresent()) {
-      return false;
-    }
-
-    idToCustomer.put(customer.getId(), customer);
-    return true;
-  }
-
-  @Override
-  public boolean update(final Customer customer) {
-    return idToCustomer.replace(customer.getId(), customer) != null;
-  }
-
-  @Override
-  public boolean delete(final Customer customer) {
-    return idToCustomer.remove(customer.getId()) != null;
-  }
+  // implement the interface using the map
+  ...
 }
 
 public class DbCustomerDao implements CustomerDao {
@@ -155,121 +84,8 @@ public class DbCustomerDao implements CustomerDao {
     this.dataSource = dataSource;
   }
 
-  @Override
-  public Stream<Customer> getAll() throws Exception {
-    try {
-      var connection = getConnection();
-      var statement = connection.prepareStatement("SELECT * FROM CUSTOMERS");
-      var resultSet = statement.executeQuery();
-      return StreamSupport.stream(new Spliterators.AbstractSpliterator<Customer>(Long.MAX_VALUE,
-          Spliterator.ORDERED) {
-
-        @Override
-        public boolean tryAdvance(Consumer<? super Customer> action) {
-          try {
-            if (!resultSet.next()) {
-              return false;
-            }
-            action.accept(createCustomer(resultSet));
-            return true;
-          } catch (SQLException e) {
-            throw new RuntimeException(e);
-          }
-        }
-      }, false).onClose(() -> mutedClose(connection, statement, resultSet));
-    } catch (SQLException e) {
-      throw new CustomException(e.getMessage(), e);
-    }
-  }
-
-  private Connection getConnection() throws SQLException {
-    return dataSource.getConnection();
-  }
-
-  private void mutedClose(Connection connection, PreparedStatement statement, ResultSet resultSet) {
-    try {
-      resultSet.close();
-      statement.close();
-      connection.close();
-    } catch (SQLException e) {
-      LOGGER.info("Exception thrown " + e.getMessage());
-    }
-  }
-
-  private Customer createCustomer(ResultSet resultSet) throws SQLException {
-    return new Customer(resultSet.getInt("ID"),
-        resultSet.getString("FNAME"),
-        resultSet.getString("LNAME"));
-  }
-
-  @Override
-  public Optional<Customer> getById(int id) throws Exception {
-
-    ResultSet resultSet = null;
-
-    try (var connection = getConnection();
-         var statement = connection.prepareStatement("SELECT * FROM CUSTOMERS WHERE ID = ?")) {
-
-      statement.setInt(1, id);
-      resultSet = statement.executeQuery();
-      if (resultSet.next()) {
-        return Optional.of(createCustomer(resultSet));
-      } else {
-        return Optional.empty();
-      }
-    } catch (SQLException ex) {
-      throw new CustomException(ex.getMessage(), ex);
-    } finally {
-      if (resultSet != null) {
-        resultSet.close();
-      }
-    }
-  }
-
-  @Override
-  public boolean add(Customer customer) throws Exception {
-    if (getById(customer.getId()).isPresent()) {
-      return false;
-    }
-
-    try (var connection = getConnection();
-         var statement = connection.prepareStatement("INSERT INTO CUSTOMERS VALUES (?,?,?)")) {
-      statement.setInt(1, customer.getId());
-      statement.setString(2, customer.getFirstName());
-      statement.setString(3, customer.getLastName());
-      statement.execute();
-      return true;
-    } catch (SQLException ex) {
-      throw new CustomException(ex.getMessage(), ex);
-    }
-  }
-
-  @Override
-  public boolean update(Customer customer) throws Exception {
-    try (var connection = getConnection();
-         var statement =
-             connection
-                 .prepareStatement("UPDATE CUSTOMERS SET FNAME = ?, LNAME = ? WHERE ID = ?")) {
-      statement.setString(1, customer.getFirstName());
-      statement.setString(2, customer.getLastName());
-      statement.setInt(3, customer.getId());
-      return statement.executeUpdate() > 0;
-    } catch (SQLException ex) {
-      throw new CustomException(ex.getMessage(), ex);
-    }
-  }
-
-  @Override
-  public boolean delete(Customer customer) throws Exception {
-    try (var connection = getConnection();
-         var statement = connection.prepareStatement("DELETE FROM CUSTOMERS WHERE ID = ?")) {
-      statement.setInt(1, customer.getId());
-      return statement.executeUpdate() > 0;
-    } catch (SQLException ex) {
-      throw new CustomException(ex.getMessage(), ex);
-    }
-  }
-}
+  // implement the interface using the data source
+  ...
 ```
 
 Finally here's how we use our DAO to manage customers.
@@ -301,15 +117,45 @@ Finally here's how we use our DAO to manage customers.
     deleteSchema(dataSource);
 ```
 
+The program output:
+
+```java
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+customerDao.getCustomerById(2): Optional[Customer{id=2, firstName='Bob', lastName='Bobson'}]
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@7cef4e59
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+Customer{id=4, firstName='Daniel', lastName='Danielson'}
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@2db0f6b2
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+customerDao.getCustomerById(2): Optional[Customer{id=2, firstName='Bob', lastName='Bobson'}]
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@12c8a2c0
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+Customer{id=4, firstName='Daniel', lastName='Danielson'}
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@6ec8211c
+```
 
 ## Class diagram
+
 ![alt text](./etc/dao.png "Data Access Object")
 
 ## Applicability
-Use the Data Access Object in any of the following situations
 
-* when you want to consolidate how the data layer is accessed
-* when you want to avoid writing multiple data retrieval/persistence layers
+Use the Data Access Object in any of the following situations:
+
+* When you want to consolidate how the data layer is accessed.
+* When you want to avoid writing multiple data retrieval/persistence layers.
 
 ## Credits
 

From 8512c65aefb821e7a1d9631040a55c9c79601902 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:42:46 +0300
Subject: [PATCH 053/254] Update README.md

---
 data-transfer-object/README.md | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/data-transfer-object/README.md b/data-transfer-object/README.md
index fd0ff1137..72e2e240e 100644
--- a/data-transfer-object/README.md
+++ b/data-transfer-object/README.md
@@ -9,13 +9,16 @@ tags:
 ---
 
 ## Intent
-Pass data with multiple attributes in one shot from client to server, to avoid multiple calls to remote server. 
+
+Pass data with multiple attributes in one shot from client to server, to avoid multiple calls to 
+remote server. 
 
 ## Explanation
 
 Real world example
 
-> We need to fetch information about customers from remote database. Instead of querying the attributes one at a time, we use DTOs to transfer all the relevant attributes in a single shot.     
+> We need to fetch information about customers from remote database. Instead of querying the 
+> attributes one at a time, we use DTOs to transfer all the relevant attributes in a single shot.     
 
 In plain words
 
@@ -23,16 +26,17 @@ In plain words
 
 Wikipedia says
 
-> In the field of programming a data transfer object (DTO) is an object that carries data between processes. The 
-motivation for its use is that communication between processes is usually done resorting to remote interfaces 
-(e.g., web services), where each call is an expensive operation. Because the majority of the cost of each call is 
-related to the round-trip time between the client and the server, one way of reducing the number of calls is to use an 
-object (the DTO) that aggregates the data that would have been transferred by the several calls, but that is served by 
-one call only.
+> In the field of programming a data transfer object (DTO) is an object that carries data between 
+> processes. The motivation for its use is that communication between processes is usually done 
+> resorting to remote interfaces (e.g. web services), where each call is an expensive operation. 
+> Because the majority of the cost of each call is related to the round-trip time between the client 
+> and the server, one way of reducing the number of calls is to use an object (the DTO) that 
+> aggregates the data that would have been transferred by the several calls, but that is served by 
+> one call only.
 
 **Programmatic Example**
 
-Let's first introduce our simple customer DTO class.
+Let's first introduce our simple `CustomerDTO` class.
 
 ```java
 public class CustomerDto {
@@ -60,7 +64,7 @@ public class CustomerDto {
 }
 ```
 
-Customer resource class acts as the server for customer information.
+`CustomerResource` class acts as the server for customer information.
 
 ```java
 public class CustomerResource {
@@ -94,10 +98,12 @@ Now fetching customer information is easy since we have the DTOs.
 ```
 
 ## Class diagram
+
 ![alt text](./etc/data-transfer-object.urm.png "data-transfer-object")
 
 ## Applicability
-Use the Data Transfer Object pattern when
+
+Use the Data Transfer Object pattern when:
 
 * The client is asking for multiple information. And the information is related.
 * When you want to boost the performance to get resources.

From 2dd2cfb8cabbac1ecd72bb091f4e43b41f1b3cae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:49:45 +0300
Subject: [PATCH 054/254] Update README.md

---
 decorator/README.md | 51 +++++++++++++++++++++++++++++++++------------
 1 file changed, 38 insertions(+), 13 deletions(-)

diff --git a/decorator/README.md b/decorator/README.md
index 26dbd1803..7ac0bb94c 100644
--- a/decorator/README.md
+++ b/decorator/README.md
@@ -10,30 +10,39 @@ tags:
 ---
 
 ## Also known as
+
 Wrapper
 
 ## Intent
-Attach additional responsibilities to an object dynamically.
-Decorators provide a flexible alternative to subclassing for extending
-functionality.
+
+Attach additional responsibilities to an object dynamically. Decorators provide a flexible 
+alternative to subclassing for extending functionality.
 
 ## Explanation
 
 Real world example
 
-> There is an angry troll living in the nearby hills. Usually it goes bare handed but sometimes it has a weapon. To arm the troll it's not necessary to create a new troll but to decorate it dynamically with a suitable weapon.
+> There is an angry troll living in the nearby hills. Usually it goes bare handed but sometimes it 
+> has a weapon. To arm the troll it's not necessary to create a new troll but to decorate it 
+> dynamically with a suitable weapon.
 
 In plain words
 
-> Decorator pattern lets you dynamically change the behavior of an object at run time by wrapping them in an object of a decorator class.
+> Decorator pattern lets you dynamically change the behavior of an object at run time by wrapping 
+> them in an object of a decorator class.
 
 Wikipedia says
 
-> In object-oriented programming, the decorator pattern is a design pattern that allows behavior to be added to an individual object, either statically or dynamically, without affecting the behavior of other objects from the same class. The decorator pattern is often useful for adhering to the Single Responsibility Principle, as it allows functionality to be divided between classes with unique areas of concern.
+> In object-oriented programming, the decorator pattern is a design pattern that allows behavior to 
+> be added to an individual object, either statically or dynamically, without affecting the behavior 
+> of other objects from the same class. The decorator pattern is often useful for adhering to the 
+> Single Responsibility Principle, as it allows functionality to be divided between classes with 
+> unique areas of concern.
 
 **Programmatic Example**
 
-Let's take the troll example. First of all we have a simple troll implementing the troll interface
+Let's take the troll example. First of all we have a `SimpleTroll` implementing the `Troll` 
+interface:
 
 ```java
 public interface Troll {
@@ -63,7 +72,7 @@ public class SimpleTroll implements Troll {
 }
 ```
 
-Next we want to add club for the troll. We can do it dynamically by using a decorator
+Next we want to add club for the troll. We can do it dynamically by using a decorator:
 
 ```java
 public class ClubbedTroll implements Troll {
@@ -94,7 +103,7 @@ public class ClubbedTroll implements Troll {
 }
 ```
 
-Here's the troll in action
+Here's the troll in action:
 
 ```java
 // simple troll
@@ -108,20 +117,36 @@ clubbedTroll.attack(); // The troll tries to grab you! The troll swings at you w
 clubbedTroll.fleeBattle(); // The troll shrieks in horror and runs away!
 ```
 
+Program output:
+
+```java
+The troll tries to grab you!
+The troll shrieks in horror and runs away!
+The troll tries to grab you! The troll swings at you with a club!
+The troll shrieks in horror and runs away!
+```
+
 ## Class diagram
+
 ![alt text](./etc/decorator.urm.png "Decorator pattern class diagram")
 
 ## Applicability
-Use Decorator
 
-* To add responsibilities to individual objects dynamically and transparently, that is, without affecting other objects
-* For responsibilities that can be withdrawn
-* When extension by subclassing is impractical. Sometimes a large number of independent extensions are possible and would produce an explosion of subclasses to support every combination. Or a class definition may be hidden or otherwise unavailable for subclassing
+Decorator is used to:
+
+* Add responsibilities to individual objects dynamically and transparently, that is, without 
+affecting other objects.
+* For responsibilities that can be withdrawn.
+* When extension by subclassing is impractical. Sometimes a large number of independent extensions 
+are possible and would produce an explosion of subclasses to support every combination. Or a class 
+definition may be hidden or otherwise unavailable for subclassing.
 
 ## Tutorial
+
 * [Decorator Pattern Tutorial](https://www.journaldev.com/1540/decorator-design-pattern-in-java-example)
 
 ## Real world examples
+
  * [java.io.InputStream](http://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html), [java.io.OutputStream](http://docs.oracle.com/javase/8/docs/api/java/io/OutputStream.html),
  [java.io.Reader](http://docs.oracle.com/javase/8/docs/api/java/io/Reader.html) and [java.io.Writer](http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html)
  * [java.util.Collections#synchronizedXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#synchronizedCollection-java.util.Collection-)

From 8afe4c314a462eef05f2c2b026eb8ae9e90bb014 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 16:56:52 +0300
Subject: [PATCH 055/254] Update README.md

---
 dependency-injection/README.md | 29 ++++++++++++++++++-----------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/dependency-injection/README.md b/dependency-injection/README.md
index b47c1d2f9..e5bf93387 100644
--- a/dependency-injection/README.md
+++ b/dependency-injection/README.md
@@ -9,15 +9,19 @@ tags:
 ---
 
 ## Intent
-Dependency Injection is a software design pattern in which one or more dependencies (or services) are injected, or 
-passed by reference, into a dependent object (or client) and are made part of the client's state. The pattern separates 
-the creation of a client's dependencies from its own behavior, which allows program designs to be loosely coupled and 
-to follow the inversion of control and single responsibility principles.
+
+Dependency Injection is a software design pattern in which one or more dependencies (or services) 
+are injected, or passed by reference, into a dependent object (or client) and are made part of the 
+client's state. The pattern separates the creation of a client's dependencies from its own behavior, 
+which allows program designs to be loosely coupled and to follow the inversion of control and single 
+responsibility principles.
 
 ## Explanation
+
 Real world example
 
-> The old wizard likes to fill his pipe and smoke tobacco once in a while. However, he doesn't want to depend on a single tobacco brand only but likes to be able to enjoy them all interchangeably.    
+> The old wizard likes to fill his pipe and smoke tobacco once in a while. However, he doesn't want 
+> to depend on a single tobacco brand only but likes to be able to enjoy them all interchangeably.    
 
 In plain words
 
@@ -25,11 +29,12 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, dependency injection is a technique in which an object receives other objects that it depends on. These other objects are called dependencies.
+> In software engineering, dependency injection is a technique in which an object receives other 
+> objects that it depends on. These other objects are called dependencies.
 
 **Programmatic Example**
 
-Let's first introduce the tobacco brands.
+Let's first introduce the `Tobacco` interface and the concrete brands.
 
 ```java
 public abstract class Tobacco {
@@ -52,7 +57,7 @@ public class OldTobyTobacco extends Tobacco {
 }
 ```
 
-Next here's the wizard class hierarchy.
+Next here's the `Wizard` class hierarchy.
 
 ```java
 public interface Wizard {
@@ -83,13 +88,15 @@ And lastly we can show how easy it is to give the old wizard any brand of tobacc
 ```
 
 ## Class diagram
+
 ![alt text](./etc/dependency-injection.png "Dependency Injection")
 
 ## Applicability
-Use the Dependency Injection pattern when
 
-* When you need to remove knowledge of concrete implementation from object
-* To enable unit testing of classes in isolation using mock objects or stubs
+Use the Dependency Injection pattern when:
+
+* When you need to remove knowledge of concrete implementation from object.
+* To enable unit testing of classes in isolation using mock objects or stubs.
 
 ## Credits
 

From f5886325ec8e07e994f4eeda8d7a4adb1e391f45 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 29 Aug 2020 19:34:43 +0530
Subject: [PATCH 056/254] Update maven-ci.yml

upgraded build server runtime from Ubuntu 18.04 to 20.04 LTS
---
 .github/workflows/maven-ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index cb3b8e45c..19291fa41 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -33,7 +33,7 @@ on:
 jobs:
   build:
 
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-20.04
 
     steps:
     - uses: actions/checkout@v2

From 1973d1bc63bc60727b5fdba0dda9070eb66f5cd9 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 29 Aug 2020 19:35:20 +0530
Subject: [PATCH 057/254] Update maven-pr-builder.yml

upgraded build server runtime from Ubuntu 18.04 to 20.04 LTS for the PR builder as well
---
 .github/workflows/maven-pr-builder.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 0c6d624c2..f970c0ee5 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -33,7 +33,7 @@ on:
 jobs:
   build:
 
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-20.04
 
     steps:
     - uses: actions/checkout@v2

From c541176b3869000dffb595a84de09147ecad31e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 20:26:37 +0300
Subject: [PATCH 058/254] Update README.md

---
 execute-around/README.md | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/execute-around/README.md b/execute-around/README.md
index 2873aef9b..600e41196 100644
--- a/execute-around/README.md
+++ b/execute-around/README.md
@@ -9,15 +9,18 @@ tags:
 ---
 
 ## Intent
-Execute Around idiom frees the user from certain actions that should always be executed before and after the business 
-method. A good example of this is resource allocation and deallocation leaving the user to specify only what to do with 
-the resource.
+
+Execute Around idiom frees the user from certain actions that should always be executed before and 
+after the business method. A good example of this is resource allocation and deallocation leaving 
+the user to specify only what to do with the resource.
 
 ## Explanation
 
 Real world example
 
-> We need to provide a class that can be used to write text strings to files. To make it easy for the user we let our service class open and close the file automatically, the user only has to specify what is written into which file.       
+> We need to provide a class that can be used to write text strings to files. To make it easy for 
+> the user we let our service class open and close the file automatically, the user only has to 
+> specify what is written into which file.       
 
 In plain words
 
@@ -25,7 +28,9 @@ In plain words
 
 [Stack Overflow](https://stackoverflow.com/questions/341971/what-is-the-execute-around-idiom) says
 
-> Basically it's the pattern where you write a method to do things which are always required, e.g. resource allocation and clean-up, and make the caller pass in "what we want to do with the resource".
+> Basically it's the pattern where you write a method to do things which are always required, e.g. 
+> resource allocation and clean-up, and make the caller pass in "what we want to do with the 
+> resource".
 
 **Programmatic Example**
 
@@ -61,12 +66,15 @@ To utilize the file writer the following code is needed.
 ```
 
 ## Class diagram
+
 ![alt text](./etc/execute-around.png "Execute Around")
 
 ## Applicability
+
 Use the Execute Around idiom when
 
-* you use an API that requires methods to be called in pairs such as open/close or allocate/deallocate.
+* You use an API that requires methods to be called in pairs such as open/close or 
+allocate/deallocate.
 
 ## Credits
 

From 0ee03db4d0b0fa6061d6147b2ce1432c245e8539 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 20:38:04 +0300
Subject: [PATCH 059/254] Update README.md

---
 facade/README.md | 53 ++++++++++++++++++++++++++++++++++++------------
 1 file changed, 40 insertions(+), 13 deletions(-)

diff --git a/facade/README.md b/facade/README.md
index ce9d892b6..f6765e325 100644
--- a/facade/README.md
+++ b/facade/README.md
@@ -10,14 +10,18 @@ tags:
 ---
 
 ## Intent
-Provide a unified interface to a set of interfaces in a subsystem.
-Facade defines a higher-level interface that makes the subsystem easier to use.
+
+Provide a unified interface to a set of interfaces in a subsystem. Facade defines a higher-level 
+interface that makes the subsystem easier to use.
 
 ## Explanation
 
 Real world example
 
-> How does a goldmine work? "Well, the miners go down there and dig gold!" you say. That is what you believe because you are using a simple interface that goldmine provides on the outside, internally it has to do a lot of stuff to make it happen. This simple interface to the complex subsystem is a facade.
+> How does a goldmine work? "Well, the miners go down there and dig gold!" you say. That is what you 
+> believe because you are using a simple interface that goldmine provides on the outside, internally 
+> it has to do a lot of stuff to make it happen. This simple interface to the complex subsystem is a 
+> facade.
 
 In plain words
 
@@ -25,11 +29,13 @@ In plain words
 
 Wikipedia says
 
-> A facade is an object that provides a simplified interface to a larger body of code, such as a class library.
+> A facade is an object that provides a simplified interface to a larger body of code, such as a 
+> class library.
 
 **Programmatic Example**
 
-Taking our goldmine example from above. Here we have the dwarven mine worker hierarchy
+Let's take our goldmine example from above. Here we have the dwarven mine worker hierarchy. First
+there's a base class `DwarvenMineWorker`:
 
 ```java
 public abstract class DwarvenMineWorker {
@@ -87,7 +93,12 @@ public abstract class DwarvenMineWorker {
     GO_TO_SLEEP, WAKE_UP, GO_HOME, GO_TO_MINE, WORK
   }
 }
+```
 
+Then we have the concrete dwarf classes `DwarvenTunnelDigger`, `DwarvenGoldDigger` and 
+`DwarvenCartOperator`:
+
+```java
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class);
@@ -135,7 +146,7 @@ public class DwarvenCartOperator extends DwarvenMineWorker {
 
 ```
 
-To operate all these goldmine workers we have the facade
+To operate all these goldmine workers we have the `DwarvenGoldmineFacade`:
 
 ```java
 public class DwarvenGoldmineFacade {
@@ -168,22 +179,27 @@ public class DwarvenGoldmineFacade {
 }
 ```
 
-Now to use the facade
+Now let's use the facade:
 
 ```java
-DwarvenGoldmineFacade facade = new DwarvenGoldmineFacade();
+var facade = new DwarvenGoldmineFacade();
 facade.startNewDay();
+facade.digOutGold();
+facade.endDay();
+```
+
+Program output:
+
+```java
 // Dwarf gold digger wakes up.
 // Dwarf gold digger goes to the mine.
 // Dwarf cart operator wakes up.
 // Dwarf cart operator goes to the mine.
 // Dwarven tunnel digger wakes up.
 // Dwarven tunnel digger goes to the mine.
-facade.digOutGold();
 // Dwarf gold digger digs for gold.
 // Dwarf cart operator moves gold chunks out of the mine.
 // Dwarven tunnel digger creates another promising tunnel.
-facade.endDay();
 // Dwarf gold digger goes home.
 // Dwarf gold digger goes to sleep.
 // Dwarf cart operator goes home.
@@ -193,14 +209,25 @@ facade.endDay();
 ```
 
 ## Class diagram
+
 ![alt text](./etc/facade.urm.png "Facade pattern class diagram")
 
 ## Applicability
+
 Use the Facade pattern when
 
-* you want to provide a simple interface to a complex subsystem. Subsystems often get more complex  as they evolve. Most patterns, when applied, result in more and smaller classes. This makes the subsystem more reusable and easier to customize, but it also becomes harder to use for clients that don't need to customize it. A facade can provide a simple default view of the subsystem that is good enough for most clients. Only clients needing more customizability will need to look beyond the facade.
-* there are many dependencies between clients and the implementation classes of an abstraction. Introduce a facade to decouple the subsystem from clients and other subsystems, thereby promoting subsystem independence and portability.
-* you want to layer your subsystems. Use a facade to define an entry point to each subsystem level. If subsystems are dependent, then you can simplify the dependencies between them by making them communicate with each other solely through their facades.
+* You want to provide a simple interface to a complex subsystem. Subsystems often get more complex 
+as they evolve. Most patterns, when applied, result in more and smaller classes. This makes the 
+subsystem more reusable and easier to customize, but it also becomes harder to use for clients that 
+don't need to customize it. A facade can provide a simple default view of the subsystem that is good 
+enough for most clients. Only clients needing more customization will need to look beyond the 
+facade.
+* There are many dependencies between clients and the implementation classes of an abstraction. 
+Introduce a facade to decouple the subsystem from clients and other subsystems, thereby promoting 
+subsystem independence and portability.
+* You want to layer your subsystems. Use a facade to define an entry point to each subsystem level. 
+If subsystems are dependent, then you can simplify the dependencies between them by making them 
+communicate with each other solely through their facades.
 
 ## Credits
 

From b77a05f0fb09fdae94055c7d1506b4898e80985e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 20:46:40 +0300
Subject: [PATCH 060/254] Update README.md

---
 factory-method/README.md | 41 ++++++++++++++++++++++++++++------------
 1 file changed, 29 insertions(+), 12 deletions(-)

diff --git a/factory-method/README.md b/factory-method/README.md
index 206388537..180ddb868 100644
--- a/factory-method/README.md
+++ b/factory-method/README.md
@@ -10,17 +10,20 @@ tags:
 ---
 
 ## Also known as
+
 Virtual Constructor
 
 ## Intent
-Define an interface for creating an object, but let subclasses
-decide which class to instantiate. Factory Method lets a class defer
-instantiation to subclasses.
+
+Define an interface for creating an object, but let subclasses decide which class to instantiate. 
+Factory Method lets a class defer instantiation to subclasses.
 
 ## Explanation
+
 Real world example
 
-> Blacksmith manufactures weapons. Elves require Elvish weapons and orcs require Orcish weapons. Depending on the customer at hand the right type of blacksmith is summoned.
+> Blacksmith manufactures weapons. Elves require Elvish weapons and orcs require Orcish weapons. 
+> Depending on the customer at hand the right type of blacksmith is summoned.
 
 In plain words
 
@@ -28,11 +31,16 @@ In plain words
 
 Wikipedia says
 
-> In class-based programming, the factory method pattern is a creational pattern that uses factory methods to deal with the problem of creating objects without having to specify the exact class of the object that will be created. This is done by creating objects by calling a factory method—either specified in an interface and implemented by child classes, or implemented in a base class and optionally overridden by derived classes—rather than by calling a constructor.
+> In class-based programming, the factory method pattern is a creational pattern that uses factory 
+> methods to deal with the problem of creating objects without having to specify the exact class of 
+> the object that will be created. This is done by creating objects by calling a factory method 
+> — either specified in an interface and implemented by child classes, or implemented in a base 
+> class and optionally overridden by derived classes—rather than by calling a constructor.
 
  **Programmatic Example**
 
-Taking our blacksmith example above. First of all we have a blacksmith interface and some implementations for it
+Taking our blacksmith example above. First of all we have a `Blacksmith` interface and some 
+implementations for it:
 
 ```java
 public interface Blacksmith {
@@ -52,24 +60,33 @@ public class OrcBlacksmith implements Blacksmith {
 }
 ```
 
-Now as the customers come the correct type of blacksmith is summoned and requested weapons are manufactured
+When the customers come, the correct type of blacksmith is summoned and requested weapons are 
+manufactured:
 
 ```java
 var blacksmith = new ElfBlacksmith();
 blacksmith.manufactureWeapon(WeaponType.SPEAR);
 blacksmith.manufactureWeapon(WeaponType.AXE);
-// Elvish weapons are created
+```
+
+Program output:
+```java
+// Elven spear
+// Elven axe
 ```
 
 ## Class diagram
+
 ![alt text](./etc/factory-method.urm.png "Factory Method pattern class diagram")
 
 ## Applicability
-Use the Factory Method pattern when
 
-* a class can't anticipate the class of objects it must create
-* a class wants its subclasses to specify the objects it creates
-* classes delegate responsibility to one of several helper subclasses, and you want to localize the knowledge of which helper subclass is the delegate
+Use the Factory Method pattern when:
+
+* Class cannot anticipate the class of objects it must create.
+* Class wants its subclasses to specify the objects it creates.
+* Classes delegate responsibility to one of several helper subclasses, and you want to localize the 
+knowledge of which helper subclass is the delegate.
 
 ## Real world examples
 

From 1fbef60f37dea69764ed665d2b28e099bc31afef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:00:17 +0300
Subject: [PATCH 061/254] Update README.md

---
 fluentinterface/README.md                     | 48 +++++++++++--------
 .../com/iluwatar/fluentinterface/app/App.java |  2 -
 .../lazy/LazyFluentIterable.java              | 16 +++----
 3 files changed, 37 insertions(+), 29 deletions(-)

diff --git a/fluentinterface/README.md b/fluentinterface/README.md
index 61c5f2eb5..8b3f80fae 100644
--- a/fluentinterface/README.md
+++ b/fluentinterface/README.md
@@ -9,23 +9,25 @@ tags:
 ---
 
 ## Intent
-A fluent interface provides an easy-readable, flowing interface, that often mimics a domain specific language. Using 
-this pattern results in code that can be read nearly as human language.
+
+A fluent interface provides an easy-readable, flowing interface, that often mimics a domain specific 
+language. Using this pattern results in code that can be read nearly as human language.
 
 ## Explanation
 
-The Fluent Interface pattern is useful when you want to provide an easy readable, flowing API. Those interfaces tend 
-to mimic domain specific languages, so they can nearly be read as human languages.
+The Fluent Interface pattern is useful when you want to provide an easy readable, flowing API. Those 
+interfaces tend to mimic domain specific languages, so they can nearly be read as human languages.
  
 A fluent interface can be implemented using any of
  
- * Method Chaining - calling a method returns some object on which further methods can be called.
- * Static Factory Methods and Imports
+ * Method chaining - calling a method returns some object on which further methods can be called.
+ * Static factory methods and imports.
  * Named parameters - can be simulated in Java using static factory methods.
 
 Real world example
 
-> We need to select numbers based on different criteria from the list. It's a great chance to utilize fluent interface pattern to provide readable easy-to-use developer experience. 
+> We need to select numbers based on different criteria from the list. It's a great chance to 
+> utilize fluent interface pattern to provide readable easy-to-use developer experience. 
 
 In plain words
 
@@ -33,7 +35,9 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, a fluent interface is an object-oriented API whose design relies extensively on method chaining. Its goal is to increase code legibility by creating a domain-specific language (DSL).
+> In software engineering, a fluent interface is an object-oriented API whose design relies 
+> extensively on method chaining. Its goal is to increase code legibility by creating a 
+> domain-specific language (DSL).
 
 **Programmatic Example**
 
@@ -134,29 +138,35 @@ result is printed afterwards.
         .first(2)
         .last()
         .ifPresent(number -> LOGGER.info("Last amongst first two negatives: {}", number));
-    
-    // The initial list contains: 1, -61, 14, -22, 18, -87, 6, 64, -82, 26, -98, 97, 45, 23, 2, -68.
-    // The first three negative values are: -61, -22, -87.
-    // The last two positive values are: 23, 2.
-    // The first even number is: 14
-    // A string-mapped list of negative numbers contains: String[-61], String[-22], String[-87], String[-82], String[-98], String[-68].
-    // The lazy list contains the last two of the first four positive numbers mapped to Strings: String[18], String[6].
-    // Last amongst first two negatives: -22    
+```
+
+Program output:
+
+```java
+The initial list contains: 1, -61, 14, -22, 18, -87, 6, 64, -82, 26, -98, 97, 45, 23, 2, -68.
+The first three negative values are: -61, -22, -87.
+The last two positive values are: 23, 2.
+The first even number is: 14
+A string-mapped list of negative numbers contains: String[-61], String[-22], String[-87], String[-82], String[-98], String[-68].
+The lazy list contains the last two of the first four positive numbers mapped to Strings: String[18], String[6].
+Last amongst first two negatives: -22    
 ```
 
 ## Class diagram
+
 ![Fluent Interface](./etc/fluentinterface.png "Fluent Interface")
 
 ## Applicability
+
 Use the Fluent Interface pattern when
 
-* You provide an API that would benefit from a DSL-like usage
-* You have objects that are difficult to configure or use
+* You provide an API that would benefit from a DSL-like usage.
+* You have objects that are difficult to configure or use.
 
 ## Known uses
 
 * [Java 8 Stream API](http://www.oracle.com/technetwork/articles/java/ma14-java-se-8-streams-2177646.html)
-* [Google Guava FluentInterable](https://github.com/google/guava/wiki/FunctionalExplained)
+* [Google Guava FluentIterable](https://github.com/google/guava/wiki/FunctionalExplained)
 * [JOOQ](http://www.jooq.org/doc/3.0/manual/getting-started/use-cases/jooq-as-a-standalone-sql-builder/)
 * [Mockito](http://mockito.org/)
 * [Java Hamcrest](http://code.google.com/p/hamcrest/wiki/Tutorial)
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index 09513163c..0222fc54a 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -23,8 +23,6 @@
 
 package com.iluwatar.fluentinterface.app;
 
-import static java.lang.String.valueOf;
-
 import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
 import com.iluwatar.fluentinterface.fluentiterable.lazy.LazyFluentIterable;
 import com.iluwatar.fluentinterface.fluentiterable.simple.SimpleFluentIterable;
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index 966f35287..517e6b778 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -70,7 +70,7 @@ public class LazyFluentIterable<E> implements FluentIterable<E> {
     return new LazyFluentIterable<>() {
       @Override
       public Iterator<E> iterator() {
-        return new DecoratingIterator<E>(iterable.iterator()) {
+        return new DecoratingIterator<>(iterable.iterator()) {
           @Override
           public E computeNext() {
             while (fromIterator.hasNext()) {
@@ -107,10 +107,10 @@ public class LazyFluentIterable<E> implements FluentIterable<E> {
    */
   @Override
   public FluentIterable<E> first(int count) {
-    return new LazyFluentIterable<E>() {
+    return new LazyFluentIterable<>() {
       @Override
       public Iterator<E> iterator() {
-        return new DecoratingIterator<E>(iterable.iterator()) {
+        return new DecoratingIterator<>(iterable.iterator()) {
           int currentIndex;
 
           @Override
@@ -149,10 +149,10 @@ public class LazyFluentIterable<E> implements FluentIterable<E> {
    */
   @Override
   public FluentIterable<E> last(int count) {
-    return new LazyFluentIterable<E>() {
+    return new LazyFluentIterable<>() {
       @Override
       public Iterator<E> iterator() {
-        return new DecoratingIterator<E>(iterable.iterator()) {
+        return new DecoratingIterator<>(iterable.iterator()) {
           private int stopIndex;
           private int totalElementsCount;
           private List<E> list;
@@ -194,10 +194,10 @@ public class LazyFluentIterable<E> implements FluentIterable<E> {
    */
   @Override
   public <T> FluentIterable<T> map(Function<? super E, T> function) {
-    return new LazyFluentIterable<T>() {
+    return new LazyFluentIterable<>() {
       @Override
       public Iterator<T> iterator() {
-        return new DecoratingIterator<T>(null) {
+        return new DecoratingIterator<>(null) {
           final Iterator<E> oldTypeIterator = iterable.iterator();
 
           @Override
@@ -226,7 +226,7 @@ public class LazyFluentIterable<E> implements FluentIterable<E> {
 
   @Override
   public Iterator<E> iterator() {
-    return new DecoratingIterator<E>(iterable.iterator()) {
+    return new DecoratingIterator<>(iterable.iterator()) {
       @Override
       public E computeNext() {
         return fromIterator.hasNext() ? fromIterator.next() : null;

From f3fd49870c6762682a1544654d9860587db29078 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:05:30 +0300
Subject: [PATCH 062/254] Update README.md

---
 flyweight/README.md | 53 +++++++++++++++++++++++++++++++--------------
 1 file changed, 37 insertions(+), 16 deletions(-)

diff --git a/flyweight/README.md b/flyweight/README.md
index 7b52ef800..fbefd3740 100644
--- a/flyweight/README.md
+++ b/flyweight/README.md
@@ -10,25 +10,32 @@ tags:
 ---
 
 ## Intent
-Use sharing to support large numbers of fine-grained objects
-efficiently.
+
+Use sharing to support large numbers of fine-grained objects efficiently.
 
 ## Explanation
+
 Real world example
 
-> Alchemist's shop has shelves full of magic potions. Many of the potions are the same so there is no need to create new object for each of them. Instead one object instance can represent multiple shelf items so memory footprint remains small.
+> Alchemist's shop has shelves full of magic potions. Many of the potions are the same so there is 
+> no need to create new object for each of them. Instead one object instance can represent multiple 
+> shelf items so memory footprint remains small.
 
 In plain words
 
-> It is used to minimize memory usage or computational expenses by sharing as much as possible with similar objects.
+> It is used to minimize memory usage or computational expenses by sharing as much as possible with 
+> similar objects.
 
 Wikipedia says
 
-> In computer programming, flyweight is a software design pattern. A flyweight is an object that minimizes memory use by sharing as much data as possible with other similar objects; it is a way to use objects in large numbers when a simple repeated representation would use an unacceptable amount of memory.
+> In computer programming, flyweight is a software design pattern. A flyweight is an object that 
+> minimizes memory use by sharing as much data as possible with other similar objects; it is a way 
+> to use objects in large numbers when a simple repeated representation would use an unacceptable 
+> amount of memory.
 
 **Programmatic example**
 
-Translating our alchemist shop example from above. First of all we have different potion types
+Translating our alchemist shop example from above. First of all we have different potion types:
 
 ```java
 public interface Potion {
@@ -60,7 +67,7 @@ public class InvisibilityPotion implements Potion {
 }
 ```
 
-Then the actual Flyweight object which is the factory for creating potions
+Then the actual Flyweight class `PotionFactory`, which is the factory for creating potions.
 
 ```java
 public class PotionFactory {
@@ -96,7 +103,7 @@ public class PotionFactory {
 }
 ```
 
-And it can be used as below
+And it can be used as below:
 
 ```java
 var factory = new PotionFactory();
@@ -108,19 +115,33 @@ factory.createPotion(PotionType.HOLY_WATER).drink(); // You feel blessed. (Potio
 factory.createPotion(PotionType.HEALING).drink(); // You feel healed. (Potion=648129364)
 ```
 
+Program output:
+
+```java
+You become invisible. (Potion=6566818)
+You feel healed. (Potion=648129364)
+You become invisible. (Potion=6566818)
+You feel blessed. (Potion=1104106489)
+You feel blessed. (Potion=1104106489)
+You feel healed. (Potion=648129364)
+```
+
 ## Class diagram
+
 ![alt text](./etc/flyweight.urm.png "Flyweight pattern class diagram")
 
 ## Applicability
-The Flyweight pattern's effectiveness depends heavily on how
-and where it's used. Apply the Flyweight pattern when all of the following are
-true
 
-* an application uses a large number of objects
-* storage costs are high because of the sheer quantity of objects
-* most object state can be made extrinsic
-* many groups of objects may be replaced by relatively few shared objects once extrinsic state is removed
-* the application doesn't depend on object identity. Since flyweight objects may be shared, identity tests will return true for conceptually distinct objects.
+The Flyweight pattern's effectiveness depends heavily on how and where it's used. Apply the 
+Flyweight pattern when all of the following are true:
+
+* An application uses a large number of objects.
+* Storage costs are high because of the sheer quantity of objects.
+* Most object state can be made extrinsic.
+* Many groups of objects may be replaced by relatively few shared objects once extrinsic state is 
+removed.
+* The application doesn't depend on object identity. Since flyweight objects may be shared, identity 
+tests will return true for conceptually distinct objects.
 
 ## Real world examples
 

From 6606d6cd0883c7ad5b00dcdb7ec81181f02b7c34 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:21:01 +0300
Subject: [PATCH 063/254] Update README.md

---
 game-loop/README.md                           | 145 ++++++++++--------
 .../java/com/iluwatar/gameloop/GameLoop.java  |   4 +-
 2 files changed, 84 insertions(+), 65 deletions(-)

diff --git a/game-loop/README.md b/game-loop/README.md
index 5f2cd9653..e967ff52d 100644
--- a/game-loop/README.md
+++ b/game-loop/README.md
@@ -8,31 +8,39 @@ tags:
  - Game programming
 ---  
   
-## Intent  
-A game loop runs continuously during gameplay. Each turn of the loop, it processes user input without blocking, updates 
-the game state, and renders the game. It tracks the passage of time to control the rate of gameplay.
+## Intent
+  
+A game loop runs continuously during gameplay. Each turn of the loop, it processes user input 
+without blocking, updates the game state, and renders the game. It tracks the passage of time to 
+control the rate of gameplay.
 
 This pattern decouples progression of game time from user input and processor speed.
 
-## Applicability  
+## Applicability
+  
 This pattern is used in every game engine. 
 
 ## Explanation
+
 Real world example
 
-> Game loop is the main process of all the game rendering threads. It's present in all modern games. It drives input process, internal status update, rendering, AI and all the other processes.
+> Game loop is the main process of all the game rendering threads. It's present in all modern games. 
+> It drives input process, internal status update, rendering, AI and all the other processes.
 
 In plain words
 
-> Game Loop pattern ensures that game time progresses in equal speed in all different hardware setups. 
+> Game Loop pattern ensures that game time progresses in equal speed in all different hardware 
+> setups. 
 
 Wikipedia says
 
-> The central component of any game, from a programming standpoint, is the game loop. The game loop allows the game to run smoothly regardless of a user's input or lack thereof.
+> The central component of any game, from a programming standpoint, is the game loop. The game loop 
+> allows the game to run smoothly regardless of a user's input, or lack thereof.
 
 **Programmatic Example**
 
-Let's start with something simple. Here's a bullet that will move in our game. For demonstration it's enough that it has 1-dimensional position.
+Let's start with something simple. Here's `Bullet` class. Bullets will move in our game. For 
+demonstration purposes it's enough that it has 1-dimensional position.
 
 ```java
 public class Bullet {
@@ -53,7 +61,7 @@ public class Bullet {
 }
 ```
 
-GameController is responsible for moving objects in the game. Including the aforementioned bullet.
+`GameController` is responsible for moving objects in the game, including the aforementioned bullet.
 
 ```java
 public class GameController {
@@ -75,7 +83,8 @@ public class GameController {
 }
 ```
 
-Now we introduce the game loop. Or actually in this demo we have 3 different game loops.
+Now we introduce the game loop. Or actually in this demo we have 3 different game loops. Let's see
+the base class `GameLoop` first.
 
 ```java
 public enum GameStatus {
@@ -100,7 +109,7 @@ public abstract class GameLoop {
 
   public void run() {
     status = GameStatus.RUNNING;
-    gameThread = new Thread(() -> processGameLoop());
+    gameThread = new Thread(this::processGameLoop);
     gameThread.start();
   }
 
@@ -128,7 +137,11 @@ public abstract class GameLoop {
 
   protected abstract void processGameLoop();
 }
+```
 
+Here's the first game loop implementation, `FrameBasedGameLoop`:
+
+```java
 public class FrameBasedGameLoop extends GameLoop {
 
   @Override
@@ -144,59 +157,9 @@ public class FrameBasedGameLoop extends GameLoop {
     controller.moveBullet(0.5f);
   }
 }
-
-public class VariableStepGameLoop extends GameLoop {
-
-  @Override
-  protected void processGameLoop() {
-    var lastFrameTime = System.currentTimeMillis();
-    while (isGameRunning()) {
-      processInput();
-      var currentFrameTime = System.currentTimeMillis();
-      var elapsedTime = currentFrameTime - lastFrameTime;
-      update(elapsedTime);
-      lastFrameTime = currentFrameTime;
-      render();
-    }
-  }
-
-  protected void update(Long elapsedTime) {
-    controller.moveBullet(0.5f * elapsedTime / 1000);
-  }
-}
-
-public class FixedStepGameLoop extends GameLoop {
-
-  private static final long MS_PER_FRAME = 20;
-
-  @Override
-  protected void processGameLoop() {
-    var previousTime = System.currentTimeMillis();
-    var lag = 0L;
-    while (isGameRunning()) {
-      var currentTime = System.currentTimeMillis();
-      var elapsedTime = currentTime - previousTime;
-      previousTime = currentTime;
-      lag += elapsedTime;
-
-      processInput();
-
-      while (lag >= MS_PER_FRAME) {
-        update();
-        lag -= MS_PER_FRAME;
-      }
-
-      render();
-    }
-  }
-
-  protected void update() {
-    controller.moveBullet(0.5f * MS_PER_FRAME / 1000);
-  }
-}
 ```
 
-Finally we can show all these game loops in action.
+Finally, we show all the game loops in action.
 
 ```java
     try {
@@ -226,10 +189,66 @@ Finally we can show all these game loops in action.
     }
 ```
 
+Program output:
+
+```java
+Start frame-based game loop:
+Current bullet position: 0.5
+Current bullet position: 1.0
+Current bullet position: 1.5
+Current bullet position: 2.0
+Current bullet position: 2.5
+Current bullet position: 3.0
+Current bullet position: 3.5
+Current bullet position: 4.0
+Current bullet position: 4.5
+Current bullet position: 5.0
+Current bullet position: 5.5
+Current bullet position: 6.0
+Stop frame-based game loop.
+Start variable-step game loop:
+Current bullet position: 6.5
+Current bullet position: 0.038
+Current bullet position: 0.084
+Current bullet position: 0.145
+Current bullet position: 0.1805
+Current bullet position: 0.28
+Current bullet position: 0.32
+Current bullet position: 0.42549998
+Current bullet position: 0.52849996
+Current bullet position: 0.57799995
+Current bullet position: 0.63199997
+Current bullet position: 0.672
+Current bullet position: 0.778
+Current bullet position: 0.848
+Current bullet position: 0.8955
+Current bullet position: 0.9635
+Stop variable-step game loop.
+Start fixed-step game loop:
+Current bullet position: 0.0
+Current bullet position: 1.086
+Current bullet position: 0.059999995
+Current bullet position: 0.12999998
+Current bullet position: 0.24000004
+Current bullet position: 0.33999994
+Current bullet position: 0.36999992
+Current bullet position: 0.43999985
+Current bullet position: 0.5399998
+Current bullet position: 0.65999967
+Current bullet position: 0.68999964
+Current bullet position: 0.7299996
+Current bullet position: 0.79999954
+Current bullet position: 0.89999944
+Current bullet position: 0.98999935
+Stop variable-step game loop.
+```
+
 ## Class diagram
+
 ![alt text](./etc/game-loop.urm.png "Game Loop pattern class diagram")
 
-## Credits  
+## Credits
+  
 * [Game Programming Patterns - Game Loop](http://gameprogrammingpatterns.com/game-loop.html)
 * [Game Programming Patterns](https://www.amazon.com/gp/product/0990582906/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0990582906&linkId=1289749a703b3fe0e24cd8d604d7c40b)
 * [Game Engine Architecture, Third Edition](https://www.amazon.com/gp/product/1138035459/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=1138035459&linkId=94502746617211bc40e0ef49d29333ac)
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
index cbb456ccf..5f47ef1dd 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
@@ -36,7 +36,7 @@ public abstract class GameLoop {
 
   protected volatile GameStatus status;
 
-  protected GameController controller;
+  protected final GameController controller;
 
   private Thread gameThread;
 
@@ -53,7 +53,7 @@ public abstract class GameLoop {
    */
   public void run() {
     status = GameStatus.RUNNING;
-    gameThread = new Thread(() -> processGameLoop());
+    gameThread = new Thread(this::processGameLoop);
     gameThread.start();
   }
 

From bcca9beb4d650c447e6625d1820a55958f694426 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:29:15 +0300
Subject: [PATCH 064/254] Update README.md

---
 iterator/README.md                            | 40 +++++++++++++------
 .../main/java/com/iluwatar/iterator/App.java  |  2 +-
 .../java/com/iluwatar/iterator/bst/README.md  | 15 +++----
 3 files changed, 37 insertions(+), 20 deletions(-)

diff --git a/iterator/README.md b/iterator/README.md
index a98010c5a..71ad807cd 100644
--- a/iterator/README.md
+++ b/iterator/README.md
@@ -9,29 +9,34 @@ tags:
 ---
 
 ## Also known as
+
 Cursor
 
 ## Intent
-Provide a way to access the elements of an aggregate object
-sequentially without exposing its underlying representation.
+Provide a way to access the elements of an aggregate object sequentially without exposing its 
+underlying representation.
 
 ## Explanation
 
 Real world example
 
-> Treasure chest contains a set of magical items. There multiple types of items such as rings, potions and weapons. The items can be browsed by type using an iterator the treasure chest provides. 
+> Treasure chest contains a set of magical items. There multiple types of items such as rings, 
+> potions and weapons. The items can be browsed by type using an iterator the treasure chest 
+> provides. 
 
 In plain words
 
-> Containers can provide a representation agnostic iterator interface to provide access to the elements. 
+> Containers can provide a representation agnostic iterator interface to provide access to the 
+> elements. 
 
 Wikipedia says
 
-> In object-oriented programming, the iterator pattern is a design pattern in which an iterator is used to traverse a container and access the container's elements.
+> In object-oriented programming, the iterator pattern is a design pattern in which an iterator is 
+> used to traverse a container and access the container's elements.
 
 **Programmatic Example**
 
-The main class in our example is the treasure chest that contains items.
+The main class in our example is the `TreasureChest` that contains items.
 
 ```java
 public class TreasureChest {
@@ -60,7 +65,11 @@ public class TreasureChest {
     return new ArrayList<>(items);
   }
 }
+```
 
+Here's the `Item` class:
+
+```java
 public class Item {
 
   private ItemType type;
@@ -92,7 +101,7 @@ public enum ItemType {
 }
 ```
 
-The iterator interface is extremely simple.
+The `Iterator` interface is extremely simple.
 
 ```java
 public interface Iterator<T> {
@@ -110,19 +119,26 @@ var itemIterator = TREASURE_CHEST.iterator(ItemType.RING);
 while (itemIterator.hasNext()) {
   LOGGER.info(itemIterator.next().toString());
 }
-// Ring of shadows
-// Ring of armor
+```
+
+Program output:
+
+```java
+Ring of shadows
+Ring of armor
 ```
 
 ## Class diagram
+
 ![alt text](./etc/iterator_1.png "Iterator")
 
 ## Applicability
+
 Use the Iterator pattern
 
-* to access an aggregate object's contents without exposing its internal representation
-* to support multiple traversals of aggregate objects
-* to provide a uniform interface for traversing different aggregate structures
+* To access an aggregate object's contents without exposing its internal representation.
+* To support multiple traversals of aggregate objects.
+* To provide a uniform interface for traversing different aggregate structures.
 
 ## Real world examples
 
diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java
index b81e765be..053b5c4fb 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/App.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/App.java
@@ -62,7 +62,7 @@ public class App {
     LOGGER.info("------------------------");
     LOGGER.info("BST Iterator: ");
     var root = buildIntegerBst();
-    var bstIterator = new BstIterator<Integer>(root);
+    var bstIterator = new BstIterator<>(root);
     while (bstIterator.hasNext()) {
       LOGGER.info("Next node: " + bstIterator.next().getVal());
     }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/bst/README.md b/iterator/src/main/java/com/iluwatar/iterator/bst/README.md
index 816d1a4fe..07bcbf84f 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/bst/README.md
+++ b/iterator/src/main/java/com/iluwatar/iterator/bst/README.md
@@ -1,8 +1,11 @@
 # BSTIterator
-An implementation of the Iterator design pattern, for the Binary Search Tree
-data structure. A great explanation of BSTs can be found in this [video tutorial](https://www.youtube.com/watch?v=i_Q0v_Ct5lY).
 
-### What it Does
+An implementation of the Iterator design pattern, for the Binary Search Tree data structure. A great 
+explanation of BSTs can be found in this 
+[video tutorial](https://www.youtube.com/watch?v=i_Q0v_Ct5lY).
+
+### What It Does
+
 This iterator assumes that the given binary search tree inserts nodes of smaller 
 value to the left, and nodes of larger value to the right of current node. Accordingly, 
 this iterator will return nodes according to "In Order" binary tree traversal. 
@@ -12,6 +15,7 @@ return values in order: 1, 3, 4, 6, 7, 8, 10, 13, 14.
 ![BST](../../../../../../../etc/bst.jpg "Binary Search Tree")  
 
 ### How It's Done
+
 **The trivial solution** to a binary search tree iterator would be to construct a List (or similar 
 linear data structure) when you construct the BSTIterator. This would require traversing the entire
 BST, adding each node value to your list as you go. The downside to the trivial solution is twofold.
@@ -80,7 +84,4 @@ In Big O terms, here are the costs for our improved solution, where h is the hei
 * Extra Space: O(h)
 
 As you can see, this solution more evenly distributes the work. It yields the same amortized 
-runtime for `next()`, reduces the run time of the constructor, and uses less extra space. 
-
-
- 
\ No newline at end of file
+runtime for `next()`, reduces the run time of the constructor, and uses less extra space.

From 3544a8366f5f961337f4bb623e477cee53e795c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:38:58 +0300
Subject: [PATCH 065/254] Update README.md

---
 layers/README.md                              | 33 ++++++++++++-------
 .../layers/service/CakeBakingServiceImpl.java | 24 ++++----------
 2 files changed, 27 insertions(+), 30 deletions(-)

diff --git a/layers/README.md b/layers/README.md
index 1e309f92b..d29ad40d0 100644
--- a/layers/README.md
+++ b/layers/README.md
@@ -10,26 +10,33 @@ tags:
 ---
 
 ## Intent
-Layers is an architectural pattern where software responsibilities are
- divided among the different layers of the application.
+
+Layers is an architectural pattern where software responsibilities are divided among the different 
+layers of the application.
 
 ## Explanation
 
 Real world example
 
-> Consider a web site displaying decorated cakes for weddings and such. Instead of the web page directly reaching into the database, it relies on a service to deliver this information. The service then queries the data layer to assimilate the needed information.
+> Consider a web site displaying decorated cakes for weddings and such. Instead of the web page 
+> directly reaching into the database, it relies on a service to deliver this information. The 
+> service then queries the data layer to assimilate the needed information.
 
-In Plain Words
+In plain words
 
-> With Layers architectural pattern different concerns reside on separate layers. View layer is interested only in rendering, service layer assembles the requested data from various sources, and data layer gets the bits from the data storage.
+> With Layers architectural pattern different concerns reside on separate layers. View layer is 
+> interested only in rendering, service layer assembles the requested data from various sources, and 
+> data layer gets the bits from the data storage.
 
 Wikipedia says
 
-> In software engineering, multitier architecture (often referred to as n-tier architecture) or multilayered architecture is a client–server architecture in which presentation, application processing, and data management functions are physically separated.
+> In software engineering, multitier architecture (often referred to as n-tier architecture) or 
+> multilayered architecture is a client–server architecture in which presentation, application 
+> processing, and data management functions are physically separated.
 
 **Programmatic Example**
 
-On the data layer, we keep our cake building blocks. Cakes consist of layers and topping.
+On the data layer, we keep our cake building blocks. `Cake` consist of layers and topping.
 
 ```java
 @Entity
@@ -47,7 +54,7 @@ public class Cake {
 }
 ```
 
-The service layer offers CakeBakingService for easy access to different aspects of cakes.
+The service layer offers `CakeBakingService` for easy access to different aspects of cakes.
 
 ```java
 public interface CakeBakingService {
@@ -66,7 +73,7 @@ public interface CakeBakingService {
 }
 ```
 
-On the top we have our view responsible of rendering the cakes.
+On the top we have our `View` responsible of rendering the cakes.
 
 ```java
 public interface View {
@@ -92,14 +99,16 @@ public class CakeViewImpl implements View {
 ```
 
 ## Class diagram
+
 ![alt text](./etc/layers.png "Layers")
 
 ## Applicability
+
 Use the Layers architecture when
 
-* you want clearly divide software responsibilities into different parts of the program
-* you want to prevent a change from propagating throughout the application
-* you want to make your application more maintainable and testable
+* You want clearly divide software responsibilities into different parts of the program.
+* You want to prevent a change from propagating throughout the application.
+* You want to make your application more maintainable and testable.
 
 ## Credits
 
diff --git a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
index 14fee4dfa..4694082fa 100644
--- a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
@@ -35,9 +35,7 @@ import com.iluwatar.layers.entity.CakeTopping;
 import com.iluwatar.layers.exception.CakeBakingException;
 import java.util.ArrayList;
 import java.util.HashSet;
-import java.util.Iterator;
 import java.util.List;
-import java.util.Optional;
 import java.util.Set;
 import java.util.stream.Collectors;
 import org.springframework.context.support.AbstractApplicationContext;
@@ -72,7 +70,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
     Set<CakeLayer> foundLayers = new HashSet<>();
     for (var info : cakeInfo.cakeLayerInfos) {
       var found = allLayers.stream().filter(layer -> layer.getName().equals(info.name)).findFirst();
-      if (!found.isPresent()) {
+      if (found.isEmpty()) {
         throw new CakeBakingException(String.format("Layer %s is not available", info.name));
       } else {
         foundLayers.add(found.get());
@@ -114,9 +112,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
   private List<CakeTopping> getAvailableToppingEntities() {
     var bean = context.getBean(CakeToppingDao.class);
     List<CakeTopping> result = new ArrayList<>();
-    var iterator = bean.findAll().iterator();
-    while (iterator.hasNext()) {
-      var topping = iterator.next();
+    for (CakeTopping topping : bean.findAll()) {
       if (topping.getCake() == null) {
         result.add(topping);
       }
@@ -128,9 +124,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
   public List<CakeToppingInfo> getAvailableToppings() {
     var bean = context.getBean(CakeToppingDao.class);
     List<CakeToppingInfo> result = new ArrayList<>();
-    var iterator = bean.findAll().iterator();
-    while (iterator.hasNext()) {
-      var next = iterator.next();
+    for (CakeTopping next : bean.findAll()) {
       if (next.getCake() == null) {
         result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories()));
       }
@@ -141,9 +135,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
   private List<CakeLayer> getAvailableLayerEntities() {
     var bean = context.getBean(CakeLayerDao.class);
     List<CakeLayer> result = new ArrayList<>();
-    var iterator = bean.findAll().iterator();
-    while (iterator.hasNext()) {
-      var next = iterator.next();
+    for (CakeLayer next : bean.findAll()) {
       if (next.getCake() == null) {
         result.add(next);
       }
@@ -155,9 +147,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
   public List<CakeLayerInfo> getAvailableLayers() {
     var bean = context.getBean(CakeLayerDao.class);
     List<CakeLayerInfo> result = new ArrayList<>();
-    var iterator = bean.findAll().iterator();
-    while (iterator.hasNext()) {
-      var next = iterator.next();
+    for (CakeLayer next : bean.findAll()) {
       if (next.getCake() == null) {
         result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories()));
       }
@@ -169,9 +159,7 @@ public class CakeBakingServiceImpl implements CakeBakingService {
   public List<CakeInfo> getAllCakes() {
     var cakeBean = context.getBean(CakeDao.class);
     List<CakeInfo> result = new ArrayList<>();
-    var iterator = cakeBean.findAll().iterator();
-    while (iterator.hasNext()) {
-      var cake = iterator.next();
+    for (Cake cake : cakeBean.findAll()) {
       var cakeToppingInfo =
           new CakeToppingInfo(cake.getTopping().getId(), cake.getTopping().getName(), cake
               .getTopping().getCalories());

From 74360a7ecba4f226b867fb00fd84804ed9972efe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:51:32 +0300
Subject: [PATCH 066/254] Update README.md

---
 memento/README.md                             | 89 ++++++++-----------
 .../java/com/iluwatar/memento/StarType.java   |  3 +-
 2 files changed, 36 insertions(+), 56 deletions(-)

diff --git a/memento/README.md b/memento/README.md
index 8bbebd36a..720d0f21d 100644
--- a/memento/README.md
+++ b/memento/README.md
@@ -9,24 +9,30 @@ tags:
 ---
 
 ## Also known as
+
 Token
 
 ## Intent
-Without violating encapsulation, capture and externalize an object's internal state so that the object can be restored 
-to this state later.
+
+Without violating encapsulation, capture and externalize an object's internal state so that the 
+object can be restored to this state later.
 
 ## Explanation
+
 Real world example
 
-> We are working on astrology application where we need to analyze star properties over time. We are creating snapshots of star state using Memento pattern.
+> We are working on astrology application where we need to analyze star properties over time. We are 
+> creating snapshots of star state using Memento pattern.
 
 In plain words
 
-> Memento pattern captures object internal state making it easy to store and restore objects in any point of time.
+> Memento pattern captures object internal state making it easy to store and restore objects in any 
+> point of time.
 
 Wikipedia says
 
-> The memento pattern is a software design pattern that provides the ability to restore an object to its previous state (undo via rollback).
+> The memento pattern is a software design pattern that provides the ability to restore an object to 
+> its previous state (undo via rollback).
 
 **Programmatic Example**
 
@@ -38,23 +44,13 @@ public enum StarType {
   RED_GIANT("red giant"),
   WHITE_DWARF("white dwarf"),
   SUPERNOVA("supernova"),
-  DEAD("dead star"),
-  UNDEFINED("");
-
-  private final String title;
-
-  StarType(String title) {
-    this.title = title;
-  }
-
-  @Override
-  public String toString() {
-    return title;
-  }
+  DEAD("dead star");
+  ...
 }
 ```
 
-Next let's jump straight to the essentials. Here's the star class along with the mementos that we need manipulate. 
+Next, let's jump straight to the essentials. Here's the `Star` class along with the mementos that we 
+need manipulate. Especially pay attention to `getMemento` and `setMemento` methods.
 
 ```java
 public interface StarMemento {
@@ -123,29 +119,8 @@ public class Star {
     private int ageYears;
     private int massTons;
 
-    public StarType getType() {
-      return type;
-    }
-
-    public void setType(StarType type) {
-      this.type = type;
-    }
-
-    public int getAgeYears() {
-      return ageYears;
-    }
-
-    public void setAgeYears(int ageYears) {
-      this.ageYears = ageYears;
-    }
-
-    public int getMassTons() {
-      return massTons;
-    }
-
-    public void setMassTons(int massTons) {
-      this.massTons = massTons;
-    }
+    // setters and getters ->
+    ...
   }
 }
 ```
@@ -172,27 +147,33 @@ And finally here's how we use the mementos to store and restore star states.
       star.setMemento(states.pop());
       LOGGER.info(star.toString());
     }
-    
-    // sun age: 10000000 years mass: 500000 tons
-    // red giant age: 20000000 years mass: 4000000 tons
-    // white dwarf age: 40000000 years mass: 32000000 tons
-    // supernova age: 80000000 years mass: 256000000 tons
-    // dead star age: 160000000 years mass: 2048000000 tons
-    // supernova age: 80000000 years mass: 256000000 tons
-    // white dwarf age: 40000000 years mass: 32000000 tons
-    // red giant age: 20000000 years mass: 4000000 tons
-    // sun age: 10000000 years mass: 500000 tons
 ```
 
+Program output:
+
+```
+sun age: 10000000 years mass: 500000 tons
+red giant age: 20000000 years mass: 4000000 tons
+white dwarf age: 40000000 years mass: 32000000 tons
+supernova age: 80000000 years mass: 256000000 tons
+dead star age: 160000000 years mass: 2048000000 tons
+supernova age: 80000000 years mass: 256000000 tons
+white dwarf age: 40000000 years mass: 32000000 tons
+red giant age: 20000000 years mass: 4000000 tons
+sun age: 10000000 years mass: 500000 tons
+```
 
 ## Class diagram
+
 ![alt text](./etc/memento.png "Memento")
 
 ## Applicability
+
 Use the Memento pattern when
 
-* a snapshot of an object's state must be saved so that it can be restored to that state later, and
-* a direct interface to obtaining the state would expose implementation details and break the object's encapsulation
+* A snapshot of an object's state must be saved so that it can be restored to that state later, and
+* A direct interface to obtaining the state would expose implementation details and break the 
+object's encapsulation
 
 ## Real world examples
 
diff --git a/memento/src/main/java/com/iluwatar/memento/StarType.java b/memento/src/main/java/com/iluwatar/memento/StarType.java
index aa92bf6e6..58fd935f2 100644
--- a/memento/src/main/java/com/iluwatar/memento/StarType.java
+++ b/memento/src/main/java/com/iluwatar/memento/StarType.java
@@ -31,8 +31,7 @@ public enum StarType {
   RED_GIANT("red giant"),
   WHITE_DWARF("white dwarf"),
   SUPERNOVA("supernova"),
-  DEAD("dead star"),
-  UNDEFINED("");
+  DEAD("dead star");
 
   private final String title;
 

From b5c6a89ec9a14d39ad8aafa149710dc83ab21619 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 21:55:51 +0300
Subject: [PATCH 067/254] Update README.md

---
 multiton/README.md | 43 ++++++++++++++++++++++++++++---------------
 1 file changed, 28 insertions(+), 15 deletions(-)

diff --git a/multiton/README.md b/multiton/README.md
index 85ce3acf2..07a4bf895 100644
--- a/multiton/README.md
+++ b/multiton/README.md
@@ -9,16 +9,19 @@ tags:
 ---
 
 ## Also known as
+
 Registry
 
 ## Intent
+
 Ensure a class only has limited number of instances and provide a global point of access to them.
 
 ## Explanation
 
 Real world example
 
-> The Nazgûl, also called ringwraiths or the Nine Riders, are Sauron's most terrible servants. By definition there's always nine of them.           
+> The Nazgûl, also called ringwraiths or the Nine Riders, are Sauron's most terrible servants. By 
+> definition there's always nine of them.           
 
 In plain words
 
@@ -26,11 +29,14 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, the multiton pattern is a design pattern which generalizes the singleton pattern. Whereas the singleton allows only one instance of a class to be created, the multiton pattern allows for the controlled creation of multiple instances, which it manages through the use of a map.
+> In software engineering, the multiton pattern is a design pattern which generalizes the singleton 
+> pattern. Whereas the singleton allows only one instance of a class to be created, the multiton 
+> pattern allows for the controlled creation of multiple instances, which it manages through the use 
+> of a map.
 
 **Programmatic Example**
 
-Nazgul is the multiton class.
+`Nazgul` is the multiton class.
 
 ```java
 public enum NazgulName {
@@ -71,7 +77,7 @@ public final class Nazgul {
 }
 ```
 
-And here's how we access the Nazgul instances.
+And here's how we access the `Nazgul` instances.
 
 ```java
     LOGGER.info("KHAMUL={}", Nazgul.getInstance(NazgulName.KHAMUL));
@@ -83,22 +89,29 @@ And here's how we access the Nazgul instances.
     LOGGER.info("ADUNAPHEL={}", Nazgul.getInstance(NazgulName.ADUNAPHEL));
     LOGGER.info("REN={}", Nazgul.getInstance(NazgulName.REN));
     LOGGER.info("UVATHA={}", Nazgul.getInstance(NazgulName.UVATHA));
-    
-    // KHAMUL=com.iluwatar.multiton.Nazgul@2b214b94
-    // MURAZOR=com.iluwatar.multiton.Nazgul@17814b1c
-    // DWAR=com.iluwatar.multiton.Nazgul@7ac9af2a
-    // JI_INDUR=com.iluwatar.multiton.Nazgul@7bb004b8
-    // AKHORAHIL=com.iluwatar.multiton.Nazgul@78e89bfe
-    // HOARMURATH=com.iluwatar.multiton.Nazgul@652ce654
-    // ADUNAPHEL=com.iluwatar.multiton.Nazgul@522ba524
-    // REN=com.iluwatar.multiton.Nazgul@29c5ee1d
-    // UVATHA=com.iluwatar.multiton.Nazgul@15cea7b0
+```
+
+Program output:
+
+```
+KHAMUL=com.iluwatar.multiton.Nazgul@2b214b94
+MURAZOR=com.iluwatar.multiton.Nazgul@17814b1c
+DWAR=com.iluwatar.multiton.Nazgul@7ac9af2a
+JI_INDUR=com.iluwatar.multiton.Nazgul@7bb004b8
+AKHORAHIL=com.iluwatar.multiton.Nazgul@78e89bfe
+HOARMURATH=com.iluwatar.multiton.Nazgul@652ce654
+ADUNAPHEL=com.iluwatar.multiton.Nazgul@522ba524
+REN=com.iluwatar.multiton.Nazgul@29c5ee1d
+UVATHA=com.iluwatar.multiton.Nazgul@15cea7b0
 ```
 
 ## Class diagram
+
 ![alt text](./etc/multiton.png "Multiton")
 
 ## Applicability
+
 Use the Multiton pattern when
 
-* there must be specific number of instances of a class, and they must be accessible to clients from a well-known access point
+* There must be specific number of instances of a class, and they must be accessible to clients from 
+a well-known access point.

From bc35911475259bf2955fa1440d1d657ba15b3e4a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 22:02:10 +0300
Subject: [PATCH 068/254] Update README.md

---
 null-object/README.md | 48 +++++++++++++++++++++++++++----------------
 1 file changed, 30 insertions(+), 18 deletions(-)

diff --git a/null-object/README.md b/null-object/README.md
index f5d92a7fc..0e95453cb 100644
--- a/null-object/README.md
+++ b/null-object/README.md
@@ -9,20 +9,20 @@ tags:
 ---
 
 ## Intent
-In most object-oriented languages, such as Java or C#, references
-may be null. These references need to be checked to ensure they are not null
-before invoking any methods, because methods typically cannot be invoked on
-null references. Instead of using a null reference to convey absence of an
-object (for instance, a non-existent customer), one uses an object which
-implements the expected interface, but whose method body is empty. The
-advantage of this approach over a working default implementation is that a Null
-Object is very predictable and has no side effects: it does nothing.
+
+In most object-oriented languages, such as Java or C#, references may be null. These references need 
+to be checked to ensure they are not null before invoking any methods, because methods typically 
+cannot be invoked on null references. Instead of using a null reference to convey absence of an
+object (for instance, a non-existent customer), one uses an object which implements the expected 
+interface, but whose method body is empty. The advantage of this approach over a working default 
+implementation is that a Null Object is very predictable and has no side effects: it does nothing.
 
 ## Explanation
 
 Real world example
 
-> We are building a binary tree from nodes. There are ordinary nodes and "empty" nodes. Traversing the tree normally should not cause errors, so we use null object pattern where necessary.            
+> We are building a binary tree from nodes. There are ordinary nodes and "empty" nodes. Traversing 
+> the tree normally should not cause errors, so we use null object pattern where necessary.            
 
 In plain words
 
@@ -30,11 +30,13 @@ In plain words
 
 Wikipedia says
 
-> In object-oriented computer programming, a null object is an object with no referenced value or with defined neutral ("null") behavior. The null object design pattern describes the uses of such objects and their behavior (or lack thereof).
+> In object-oriented computer programming, a null object is an object with no referenced value or 
+> with defined neutral ("null") behavior. The null object design pattern describes the uses of such 
+> objects and their behavior (or lack thereof).
 
 **Programmatic Example**
 
-Here's the definitions for node interface and its implementations.
+Here's the definition of `Node` interface.
 
 ```java
 public interface Node {
@@ -49,7 +51,12 @@ public interface Node {
 
   void walk();
 }
+```
 
+We have two implementations of `Node`. The normal implementation `NodeImpl` and `NullNode` for
+empty nodes.
+
+```java
 public class NodeImpl implements Node {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(NodeImpl.class);
@@ -135,7 +142,6 @@ public final class NullNode implements Node {
     // Do nothing
   }
 }
-
 ```
 
 Then we can construct and traverse the binary tree without errors as follows.
@@ -152,18 +158,24 @@ Then we can construct and traverse the binary tree without errors as follows.
             )
         );
     root.walk();
-    
-    // 1
-    // 11
-    // 111
-    // 12
-    // 122
+```
+
+Program output:
+
+```
+1
+11
+111
+12
+122
 ```
 
 ## Class diagram
+
 ![alt text](./etc/null-object.png "Null Object")
 
 ## Applicability
+
 Use the Null Object pattern when
 
 * You want to avoid explicit null checks and keep the algorithm elegant and easy to read.

From 67d1d16e1f9f5af3eb21d44deed760b4aaca58b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 29 Aug 2020 22:13:55 +0300
Subject: [PATCH 069/254] Update README.md

---
 object-pool/README.md                         | 44 +++++++++---
 observer/README.md                            | 70 ++++++++++++-------
 .../iluwatar/observer/generic/Observable.java |  2 +-
 3 files changed, 77 insertions(+), 39 deletions(-)

diff --git a/object-pool/README.md b/object-pool/README.md
index 34d216a02..6a648ca3e 100644
--- a/object-pool/README.md
+++ b/object-pool/README.md
@@ -10,16 +10,18 @@ tags:
 ---
 
 ## Intent
-When objects are expensive to create and they are needed only for
-short periods of time it is advantageous to utilize the Object Pool pattern.
-The Object Pool provides a cache for instantiated objects tracking which ones
-are in use and which are available.
+
+When objects are expensive to create and they are needed only for short periods of time it is 
+advantageous to utilize the Object Pool pattern. The Object Pool provides a cache for instantiated 
+objects tracking which ones are in use and which are available.
 
 ## Explanation
 
 Real world example
 
-> In our war game we need to use oliphaunts, massive and mythic beasts, but the problem is that they are extremely expensive to create. The solution is to create a pool of them, track which ones are in-use, and instead of disposing them re-use the instances.   
+> In our war game we need to use oliphaunts, massive and mythic beasts, but the problem is that they 
+> are extremely expensive to create. The solution is to create a pool of them, track which ones are 
+> in-use, and instead of disposing them re-use the instances.   
 
 In plain words
 
@@ -27,11 +29,12 @@ In plain words
 
 Wikipedia says
 
-> The object pool pattern is a software creational design pattern that uses a set of initialized objects kept ready to use – a "pool" – rather than allocating and destroying them on demand.
+> The object pool pattern is a software creational design pattern that uses a set of initialized 
+> objects kept ready to use – a "pool" – rather than allocating and destroying them on demand.
 
 **Programmatic Example**
 
-Here's the basic Oliphaunt class. These are very expensive to create.
+Here's the basic `Oliphaunt` class. These giants are very expensive to create.
 
 ```java
 public class Oliphaunt {
@@ -60,7 +63,7 @@ public class Oliphaunt {
 }
 ```
 
-Next we present the Object Pool and more specifically Oliphaunt Pool.
+Next we present the `ObjectPool` and more specifically `OliphauntPool`.
 
 ```java
 public abstract class ObjectPool<T> {
@@ -100,7 +103,7 @@ public class OliphauntPool extends ObjectPool<Oliphaunt> {
 }
 ```
 
-And finally here's how we utilize the pool.
+Finally, here's how we utilize the pool.
 
 ```java
     var pool = new OliphauntPool();
@@ -113,11 +116,30 @@ And finally here's how we utilize the pool.
     var oliphaunt5 = pool.checkOut();
 ```
 
+Program output:
+
+```
+Pool available=0 inUse=0
+Checked out Oliphaunt id=1
+Pool available=0 inUse=1
+Checked out Oliphaunt id=2
+Checked out Oliphaunt id=3
+Pool available=0 inUse=3
+Checking in Oliphaunt id=1
+Checking in Oliphaunt id=2
+Pool available=2 inUse=1
+Checked out Oliphaunt id=2
+Checked out Oliphaunt id=1
+Pool available=0 inUse=3
+```
+
 ## Class diagram
+
 ![alt text](./etc/object-pool.png "Object Pool")
 
 ## Applicability
+
 Use the Object Pool pattern when
 
-* The objects are expensive to create (allocation cost)
-* You need a large number of short-lived objects (memory fragmentation)
+* The objects are expensive to create (allocation cost).
+* You need a large number of short-lived objects (memory fragmentation).
diff --git a/observer/README.md b/observer/README.md
index d0ddf3c00..cbde540ab 100644
--- a/observer/README.md
+++ b/observer/README.md
@@ -10,17 +10,21 @@ tags:
 ---
 
 ## Also known as
+
 Dependents, Publish-Subscribe
 
 ## Intent
-Define a one-to-many dependency between objects so that when one object changes state, all its dependents are notified
-and updated automatically.
+
+Define a one-to-many dependency between objects so that when one object changes state, all its 
+dependents are notified and updated automatically.
 
 ## Explanation
 
 Real world example
 
-> In a land far away lives the races of hobbits and orcs. Both of them are mostly outdoors so they closely follow the changes in weather. One could say that they are constantly observing the weather.
+> In a land far away lives the races of hobbits and orcs. Both of them are mostly outdoors so they 
+> closely follow the changes in weather. One could say that they are constantly observing the 
+> weather.
 
 In plain words
 
@@ -28,11 +32,13 @@ In plain words
 
 Wikipedia says
 
-> The observer pattern is a software design pattern in which an object, called the subject, maintains a list of its dependents, called observers, and notifies them automatically of any state changes, usually by calling one of their methods.
+> The observer pattern is a software design pattern in which an object, called the subject, 
+> maintains a list of its dependents, called observers, and notifies them automatically of any state 
+> changes, usually by calling one of their methods.
 
 **Programmatic Example**
 
-Let's first introduce the weather observer interface and our races, orcs and hobbits.
+Let's first introduce the `WeatherObserver` interface and our races, `Orcs` and `Hobbits`.
 
 ```java
 public interface WeatherObserver {
@@ -58,11 +64,12 @@ public class Hobbits implements WeatherObserver {
   public void update(WeatherType currentWeather) {
     switch (currentWeather) {
       LOGGER.info("The hobbits are facing " + currentWeather.getDescription() + " weather now");
+    }
   }
 }
 ```
 
-Then here's the weather that is constantly changing.
+Then here's the `Weather` that is constantly changing.
 
 ```java
 public class Weather {
@@ -109,38 +116,47 @@ Here's the full example in action.
     var weather = new Weather();
     weather.addObserver(new Orcs());
     weather.addObserver(new Hobbits());
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+```
 
-    weather.timePasses();
-    // The weather changed to rainy.
-    // The orcs are facing rainy weather now
-    // The hobbits are facing rainy weather now
-    weather.timePasses();
-    // The weather changed to windy.
-    // The orcs are facing windy weather now
-    // The hobbits are facing windy weather now
-    weather.timePasses();
-    // The weather changed to cold.
-    // The orcs are facing cold weather now
-    // The hobbits are facing cold weather now
-    weather.timePasses();
-    // The weather changed to sunny.
-    // The orcs are facing sunny weather now
-    // The hobbits are facing sunny weather now
+Program output:
+
+```
+The weather changed to rainy.
+The orcs are facing rainy weather now
+The hobbits are facing rainy weather now
+The weather changed to windy.
+The orcs are facing windy weather now
+The hobbits are facing windy weather now
+The weather changed to cold.
+The orcs are facing cold weather now
+The hobbits are facing cold weather now
+The weather changed to sunny.
+The orcs are facing sunny weather now
+The hobbits are facing sunny weather now
 ```
 
 ## Class diagram
+
 ![alt text](./etc/observer.png "Observer")
 
 ## Applicability
-Use the Observer pattern in any of the following situations
 
-* When an abstraction has two aspects, one dependent on the other. Encapsulating these aspects in separate objects lets you vary and reuse them independently
-* When a change to one object requires changing others, and you don't know how many objects need to be changed
-* When an object should be able to notify other objects without making assumptions about who these objects are. In other words, you don't want these objects tightly coupled
+Use the Observer pattern in any of the following situations:
+
+* When an abstraction has two aspects, one dependent on the other. Encapsulating these aspects in 
+separate objects lets you vary and reuse them independently.
+* When a change to one object requires changing others, and you don't know how many objects need to 
+be changed.
+* When an object should be able to notify other objects without making assumptions about who these 
+objects are. In other words, you don't want these objects tightly coupled.
 
 ## Typical Use Case
 
-* Changing in one object leads to a change in other objects
+* Changing in one object leads to a change in other objects.
 
 ## Real world examples
 
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
index fbb078941..d90219c92 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
@@ -35,7 +35,7 @@ import java.util.concurrent.CopyOnWriteArrayList;
  */
 public abstract class Observable<S extends Observable<S, O, A>, O extends Observer<S, O, A>, A> {
 
-  protected List<O> observers;
+  protected final List<O> observers;
 
   public Observable() {
     this.observers = new CopyOnWriteArrayList<>();

From b80b9354c6acaa7f581b54b982c07fad2b0fb165 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 30 Aug 2020 02:31:06 +0530
Subject: [PATCH 070/254] Update maven-ci.yml

---
 .github/workflows/maven-ci.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 19291fa41..9c9f4fad3 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -37,6 +37,9 @@ jobs:
 
     steps:
     - uses: actions/checkout@v2
+      with:
+        # Disabling shallow clone for improving relevancy of SonarQube reporting
+        fetch-depth: 0
     - name: Set up JDK 11
       uses: actions/setup-java@v1
       with:

From 3c4ae6c4ca897d5f741d5741f454a010646b05ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 30 Aug 2020 19:17:45 +0300
Subject: [PATCH 071/254] Update README.md

---
 pipeline/README.md | 30 +++++++++++++++++++-----------
 1 file changed, 19 insertions(+), 11 deletions(-)

diff --git a/pipeline/README.md b/pipeline/README.md
index fd03cd7b9..d7f0f749b 100644
--- a/pipeline/README.md
+++ b/pipeline/README.md
@@ -9,19 +9,22 @@ tags:
 ---
 
 ## Intent
-Allows processing of data in a series of stages by giving in an initial input and passing the processed output to be 
-used by the next stages.
+
+Allows processing of data in a series of stages by giving in an initial input and passing the 
+processed output to be used by the next stages.
 
 ## Explanation
 
-The Pipeline pattern uses ordered stages to process a sequence of input values. Each implemented task is represented by 
-a stage of the pipeline. You can think of pipelines as similar to assembly lines in a factory, where each item in the 
-assembly line is constructed in stages. The partially assembled item is passed from one assembly stage to another. The 
-outputs of the assembly line occur in the same order as that of the inputs.
+The Pipeline pattern uses ordered stages to process a sequence of input values. Each implemented 
+task is represented by a stage of the pipeline. You can think of pipelines as similar to assembly 
+lines in a factory, where each item in the assembly line is constructed in stages. The partially 
+assembled item is passed from one assembly stage to another. The outputs of the assembly line occur 
+in the same order as that of the inputs.
  
 Real world example
 
-> Suppose we wanted to pass through a string to a series of filtering stages and convert it as a char array on the last stage.           
+> Suppose we wanted to pass through a string to a series of filtering stages and convert it as a 
+> char array on the last stage.           
 
 In plain words
 
@@ -29,7 +32,9 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, a pipeline consists of a chain of processing elements (processes, threads, coroutines, functions, etc.), arranged so that the output of each element is the input of the next; the name is by analogy to a physical pipeline.
+> In software engineering, a pipeline consists of a chain of processing elements (processes, 
+> threads, coroutines, functions, etc.), arranged so that the output of each element is the input 
+> of the next; the name is by analogy to a physical pipeline.
 
 **Programmatic Example**
 
@@ -88,14 +93,17 @@ And here's the `Pipeline` in action processing the string.
 ```
 
 ## Class diagram
+
 ![alt text](./etc/pipeline.urm.png "Pipeline pattern class diagram")
 
 ## Applicability
+
 Use the Pipeline pattern when you want to
 
-* Execute individual stages that yields a final value
-* Add readability to complex sequence of operations by providing a fluent builder as an interface
-* Improve testability of code since stages will most likely be doing a single thing, complying to the [Single Responsibility Principle (SRP)](https://java-design-patterns.com/principles/#single-responsibility-principle)
+* Execute individual stages that yields a final value.
+* Add readability to complex sequence of operations by providing a fluent builder as an interface.
+* Improve testability of code since stages will most likely be doing a single thing, complying to 
+the [Single Responsibility Principle (SRP)](https://java-design-patterns.com/principles/#single-responsibility-principle)
 
 ## Known uses
 

From 9b71479d041fc303cc4cf6541b626c114ba6c44c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 30 Aug 2020 19:34:10 +0300
Subject: [PATCH 072/254] Update README.md

---
 poison-pill/README.md | 104 +++++++++++++-----------------------------
 1 file changed, 31 insertions(+), 73 deletions(-)

diff --git a/poison-pill/README.md b/poison-pill/README.md
index a6cd2fe80..05cd8c2a0 100644
--- a/poison-pill/README.md
+++ b/poison-pill/README.md
@@ -10,14 +10,17 @@ tags:
 ---
 
 ## Intent
-Poison Pill is known predefined data item that allows to provide graceful shutdown for separate distributed consumption 
-process.
+
+Poison Pill is known predefined data item that allows to provide graceful shutdown for separate 
+distributed consumption process.
 
 ## Explanation
 
 Real world example
 
-> Let's think about a message queue with one producer and one consumer. The producer keeps pushing new messages in the queue and the consumer keeps reading them. Finally when it's time to gracefully shut down the producer sends the poison pill message.             
+> Let's think about a message queue with one producer and one consumer. The producer keeps pushing 
+> new messages in the queue and the consumer keeps reading them. Finally when it's time to 
+> gracefully shut down the producer sends the poison pill message.             
 
 In plain words
 
@@ -25,43 +28,13 @@ In plain words
 
 **Programmatic Example**
 
-Let's define the message structure first.
+Let's define the message structure first. There's interface `Message` and implementation 
+`SimpleMessage`.
 
 ```java
 public interface Message {
 
-  Message POISON_PILL = new Message() {
-
-    @Override
-    public void addHeader(Headers header, String value) {
-      throw poison();
-    }
-
-    @Override
-    public String getHeader(Headers header) {
-      throw poison();
-    }
-
-    @Override
-    public Map<Headers, String> getHeaders() {
-      throw poison();
-    }
-
-    @Override
-    public void setBody(String body) {
-      throw poison();
-    }
-
-    @Override
-    public String getBody() {
-      throw poison();
-    }
-
-    private RuntimeException poison() {
-      return new UnsupportedOperationException("Poison");
-    }
-
-  };
+  ...
 
   enum Headers {
     DATE, SENDER
@@ -110,7 +83,9 @@ public class SimpleMessage implements Message {
 }
 ```
 
-Next we define the types related to the message queue.
+To pass messages we are using message queues. Here we define the types related to the message queue: 
+`MqPublishPoint`, `MqSubscribePoint` and `MessageQueue`. `SimpleMessageQueue` implements all these 
+interfaces.
 
 ```java
 public interface MqPublishPoint {
@@ -146,29 +121,15 @@ public class SimpleMessageQueue implements MessageQueue {
 }
 ```
 
-Now we need to create the message producer and consumer.
+Next we need message `Producer` and `Consumer`. Internally they use the message queues from above.
+It's important to notice that when `Producer` stops, it sends out the poison pill to inform 
+`Consumer` that the messaging has finished. 
 
 ```java
 public class Producer {
+  
+  ... 
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Producer.class);
-
-  private final MqPublishPoint queue;
-  private final String name;
-  private boolean isStopped;
-
-  /**
-   * Constructor.
-   */
-  public Producer(String name, MqPublishPoint queue) {
-    this.name = name;
-    this.queue = queue;
-    this.isStopped = false;
-  }
-
-  /**
-   * Send message to queue.
-   */
   public void send(String body) {
     if (isStopped) {
       throw new IllegalStateException(String.format(
@@ -187,9 +148,6 @@ public class Producer {
     }
   }
 
-  /**
-   * Stop system by sending poison pill.
-   */
   public void stop() {
     isStopped = true;
     try {
@@ -203,19 +161,8 @@ public class Producer {
 
 public class Consumer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Consumer.class);
+  ...
 
-  private final MqSubscribePoint queue;
-  private final String name;
-
-  public Consumer(String name, MqSubscribePoint queue) {
-    this.name = name;
-    this.queue = queue;
-  }
-
-  /**
-   * Consume message.
-   */
   public void consume() {
     while (true) {
       try {
@@ -255,13 +202,24 @@ Finally we are ready to present the whole example in action.
     }).start();
 ```
 
+Program output:
+
+```
+Message [hand shake] from [PRODUCER_1] received by [CONSUMER_1]
+Message [some very important information] from [PRODUCER_1] received by [CONSUMER_1]
+Message [bye!] from [PRODUCER_1] received by [CONSUMER_1]
+Consumer CONSUMER_1 receive request to terminate.
+```
+
 ## Class diagram
+
 ![alt text](./etc/poison-pill.png "Poison Pill")
 
 ## Applicability
-Use the Poison Pill idiom when
 
-* Need to send signal from one thread/process to another to terminate
+Use the Poison Pill idiom when:
+
+* There's a need to send signal from one thread/process to another to terminate.
 
 ## Real world examples
 

From 82842d614b0fb76c4adaeba7b69e656621dbbf0e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 30 Aug 2020 20:08:34 +0300
Subject: [PATCH 073/254] Update README.md

---
 priority-queue/README.md                      | 192 +++++++++++++++++-
 .../iluwatar/priority/queue/Application.java  |   7 +-
 .../iluwatar/priority/queue/QueueManager.java |   2 +-
 3 files changed, 192 insertions(+), 9 deletions(-)

diff --git a/priority-queue/README.md b/priority-queue/README.md
index 924d7169f..8481915be 100644
--- a/priority-queue/README.md
+++ b/priority-queue/README.md
@@ -10,19 +10,203 @@ tags:
 ---
 
 ## Intent
-Prioritize requests sent to services so that requests with a higher priority are received and processed more quickly than those of a lower priority. This pattern is useful in applications that offer different service level guarantees to individual clients.
+
+Prioritize requests sent to services so that requests with a higher priority are received and 
+processed more quickly than those of a lower priority. This pattern is useful in applications that 
+offer different service level guarantees to individual clients.
 
 ## Explanation
-Applications may delegate specific tasks to other services; for example, to perform background processing or to integrate with other applications or services. In the cloud, a message queue is typically used to delegate tasks to background processing. In many cases the order in which requests are received by a service is not important. However, in some cases it may be necessary to prioritize specific requests. These requests should be processed earlier than others of a lower priority that may have been sent previously by the application.
+
+Applications may delegate specific tasks to other services; for example, to perform background 
+processing or to integrate with other applications or services. In the cloud, a message queue is 
+typically used to delegate tasks to background processing. In many cases the order in which requests 
+are received by a service is not important. However, in some cases it may be necessary to prioritize 
+specific requests. These requests should be processed earlier than others of a lower priority that 
+may have been sent previously by the application.
+
+Real world example
+
+> Imagine a video processing service with free and premium customers. The requests coming from the
+> paying premium customers should be prioritized over the others. 
+
+In plain words
+
+> Priority Queue enables processing of high priority messages first, regardless of queue size or
+> message age. 
+
+Wikipedia says
+
+> In computer science, a priority queue is an abstract data type similar to regular queue or stack 
+> data structure in which each element additionally has a "priority" associated with it. In a 
+> priority queue, an element with high priority is served before an element with low priority. 
+
+**Programmatic Example**
+
+Looking at the video processing example from above, let's first see the `Message` structure.
+
+```java
+public class Message implements Comparable<Message> {
+
+  private final String message;
+  private final int priority; // define message priority in queue
+
+  public Message(String message, int priority) {
+    this.message = message;
+    this.priority = priority;
+  }
+
+  @Override
+  public int compareTo(Message o) {
+    return priority - o.priority;
+  }
+  ...
+}
+```
+
+Here's `PriorityMessageQueue` that handles storing the messages and serving them in priority
+order.
+
+```java
+public class PriorityMessageQueue<T extends Comparable> {
+
+  ...
+
+  public T remove() {
+    if (isEmpty()) {
+      return null;
+    }
+
+    final var root = queue[0];
+    queue[0] = queue[size - 1];
+    size--;
+    maxHeapifyDown();
+    return root;
+  }
+
+  public void add(T t) {
+    ensureCapacity();
+    queue[size] = t;
+    size++;
+    maxHeapifyUp();
+  }
+
+  ...
+}
+```
+
+`QueueManager` has a `PriorityMessageQueue` and makes it easy to `publishMessage` and
+`receiveMessage`.
+
+```java
+public class QueueManager {
+
+  private final PriorityMessageQueue<Message> messagePriorityMessageQueue;
+
+  public QueueManager(int initialCapacity) {
+    messagePriorityMessageQueue = new PriorityMessageQueue<>(new Message[initialCapacity]);
+  }
+
+  public void publishMessage(Message message) {
+    messagePriorityMessageQueue.add(message);
+  }
+
+  public Message receiveMessage() {
+    if (messagePriorityMessageQueue.isEmpty()) {
+      return null;
+    }
+    return messagePriorityMessageQueue.remove();
+  }
+}
+```
+
+`Worker` constantly polls `QueueManager` for highest priority message and processes it.
+
+```java
+public class Worker {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
+
+  private final QueueManager queueManager;
+
+  public Worker(QueueManager queueManager) {
+    this.queueManager = queueManager;
+  }
+
+  public void run() throws Exception {
+    while (true) {
+      var message = queueManager.receiveMessage();
+      if (message == null) {
+        LOGGER.info("No Message ... waiting");
+        Thread.sleep(200);
+      } else {
+        processMessage(message);
+      }
+    }
+  }
+
+  private void processMessage(Message message) {
+    LOGGER.info(message.toString());
+  }
+}
+```
+
+Here's the full example how we create an instance of `QueueManager` and process messages using
+`Worker`.
+
+```java
+    var queueManager = new QueueManager(100);
+
+    for (var i = 0; i < 100; i++) {
+      queueManager.publishMessage(new Message("Low Message Priority", 0));
+    }
+
+    for (var i = 0; i < 100; i++) {
+      queueManager.publishMessage(new Message("High Message Priority", 1));
+    }
+
+    var worker = new Worker(queueManager);
+    worker.run();
+```
+
+Program output:
+
+```
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='High Message Priority', priority=1}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+Message{message='Low Message Priority', priority=0}
+No Message ... waiting
+No Message ... waiting
+No Message ... waiting
+```
+
 
 ## Class diagram
+
 ![alt text](./etc/priority-queue.urm.png "Priority Queue pattern class diagram")
 
 ## Applicability
-Use the Priority Queue pattern when
+
+Use the Priority Queue pattern when:
 
 * The system must handle multiple tasks that might have different priorities.
-* Different users or tenants should be served with different priority..
+* Different users or tenants should be served with different priority.
 
 ## Credits
 
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
index 433a72d74..cdef90ab8 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
@@ -37,20 +37,19 @@ public class Application {
    */
   public static void main(String[] args) throws Exception {
 
-    var queueManager = new QueueManager(100);
+    var queueManager = new QueueManager(10);
 
     // push some message to queue
     // Low Priority message
-    for (var i = 0; i < 100; i++) {
+    for (var i = 0; i < 10; i++) {
       queueManager.publishMessage(new Message("Low Message Priority", 0));
     }
 
     // High Priority message
-    for (var i = 0; i < 100; i++) {
+    for (var i = 0; i < 10; i++) {
       queueManager.publishMessage(new Message("High Message Priority", 1));
     }
 
-
     // run worker
     var worker = new Worker(queueManager);
     worker.run();
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
index 0b4be910f..3a0761f4a 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
@@ -45,7 +45,7 @@ public class QueueManager {
 
 
   /**
-   * recive message from queue.
+   * Receive message from queue.
    */
   public Message receiveMessage() {
     if (messagePriorityMessageQueue.isEmpty()) {

From 20fac32ac20c098b89e479f6ec8007e4dd5468ef Mon Sep 17 00:00:00 2001
From: Mike <admin@xiaod.info>
Date: Mon, 31 Aug 2020 17:13:14 +0800
Subject: [PATCH 074/254] finish Chinese translation of observer and strategy

---
 zh/observer/README.md | 159 ++++++++++++++++++++++++++++++++++++++++++
 zh/strategy/README.md | 136 ++++++++++++++++++++++++++++++++++++
 2 files changed, 295 insertions(+)
 create mode 100644 zh/observer/README.md
 create mode 100644 zh/strategy/README.md

diff --git a/zh/observer/README.md b/zh/observer/README.md
new file mode 100644
index 000000000..8a4b80a07
--- /dev/null
+++ b/zh/observer/README.md
@@ -0,0 +1,159 @@
+---
+layout: pattern
+title: Observer
+folder: observer
+permalink: /patterns/observer/
+categories: Behavioral
+tags:
+ - Gang Of Four
+ - Reactive
+---
+
+## Also known as
+## 又被称为
+
+家属，发布订阅模式
+
+## 目的
+
+定义一种一对多的对象依赖关系这样当一个对象改变状态时，所有依赖它的对象都将自动通知或更新。
+
+## 解释
+
+真实世界例子
+
+> 在遥远的土地上生活着霍比特人和兽人的种族。他们都是户外生活的人所以他们密切关注天气的变化。可以说他们不断地关注着天气。
+
+通俗的说
+
+> 注册成为一个观察者以接收对象状态的改变。
+
+维基百科说
+
+> 观察者模式是这样的一种软件设计模式：它有一个被称为主题的对象，维护着一个所有依赖于它的依赖者清单，也就是观察者清单，当主题的状态发生改变时，主题通常会调用观察者的方法来自动通知观察者们。
+
+**编程示例**
+
+让我们先来介绍天气观察者的接口以及我们的种族，兽人和霍比特人。
+
+```java
+public interface WeatherObserver {
+
+  void update(WeatherType currentWeather);
+}
+
+public class Orcs implements WeatherObserver {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class);
+
+  @Override
+  public void update(WeatherType currentWeather) {
+    LOGGER.info("The orcs are facing " + currentWeather.getDescription() + " weather now");
+  }
+}
+
+public class Hobbits implements WeatherObserver {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class);
+
+  @Override
+  public void update(WeatherType currentWeather) {
+    switch (currentWeather) {
+      LOGGER.info("The hobbits are facing " + currentWeather.getDescription() + " weather now");
+  }
+}
+```
+
+然后这里是不断变化的天气。
+
+```java
+public class Weather {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class);
+
+  private WeatherType currentWeather;
+  private final List<WeatherObserver> observers;
+
+  public Weather() {
+    observers = new ArrayList<>();
+    currentWeather = WeatherType.SUNNY;
+  }
+
+  public void addObserver(WeatherObserver obs) {
+    observers.add(obs);
+  }
+
+  public void removeObserver(WeatherObserver obs) {
+    observers.remove(obs);
+  }
+
+  /**
+   * Makes time pass for weather.
+   */
+  public void timePasses() {
+    var enumValues = WeatherType.values();
+    currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
+    LOGGER.info("The weather changed to {}.", currentWeather);
+    notifyObservers();
+  }
+
+  private void notifyObservers() {
+    for (var obs : observers) {
+      obs.update(currentWeather);
+    }
+  }
+}
+```
+
+这是完整的示例。
+
+```java
+    var weather = new Weather();
+    weather.addObserver(new Orcs());
+    weather.addObserver(new Hobbits());
+
+    weather.timePasses();
+    // The weather changed to rainy.
+    // The orcs are facing rainy weather now
+    // The hobbits are facing rainy weather now
+    weather.timePasses();
+    // The weather changed to windy.
+    // The orcs are facing windy weather now
+    // The hobbits are facing windy weather now
+    weather.timePasses();
+    // The weather changed to cold.
+    // The orcs are facing cold weather now
+    // The hobbits are facing cold weather now
+    weather.timePasses();
+    // The weather changed to sunny.
+    // The orcs are facing sunny weather now
+    // The hobbits are facing sunny weather now
+```
+
+## Class diagram
+![alt text](../../observer/etc/observer.png "Observer")
+
+## 应用
+在下面任何一种情况下都可以使用观察者模式
+
+* 当抽象具有两个方面时，一个方面依赖于另一个方面。将这些方面封装在单独的对象中，可以使你分别进行更改和重用
+* 当一个对象的改变的同时需要改变其他对象，同时你又不知道有多少对象需要改变时
+* 当一个对象可以通知其他对象而无需假设这些对象是谁时。换句话说，你不想让这些对象紧耦合。
+
+## 典型用例
+
+* 一个对象的改变导致其他对象的改变
+
+## Java中的例子
+
+* [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html)
+* [java.util.EventListener](http://docs.oracle.com/javase/8/docs/api/java/util/EventListener.html)
+* [javax.servlet.http.HttpSessionBindingListener](http://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpSessionBindingListener.html)
+* [RxJava](https://github.com/ReactiveX/RxJava)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Java Generics and Collections](https://www.amazon.com/gp/product/0596527756/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596527756&linkCode=as2&tag=javadesignpat-20&linkId=246e5e2c26fe1c3ada6a70b15afcb195)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/zh/strategy/README.md b/zh/strategy/README.md
new file mode 100644
index 000000000..29fe2e4eb
--- /dev/null
+++ b/zh/strategy/README.md
@@ -0,0 +1,136 @@
+---
+layout: pattern
+title: Strategy
+folder: strategy
+permalink: /patterns/strategy/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 又被称为
+政策（方针）模式
+
+## 目的
+
+定义一个家族算法，并封装好其中每一个，使它们可以互相替换。策略模式使算法的变化独立于使用它的客户。
+
+## 解释
+
+现实世界例子
+
+> 屠龙是一项危险的职业。有经验将会使它变得简单。经验丰富的屠龙者对不同类型的龙有不同的战斗策略。       
+
+直白点说
+
+> 策略模式允许在运行时选择最匹配的算法。
+
+维基百科上说
+
+> 在程序编程领域，策略模式（又叫政策模式）是一种启用在运行时选择算法的行为型软件设计模式。
+
+**编程实例**
+
+让我们先介绍屠龙的策略模式接口和它的实现。
+
+```java
+@FunctionalInterface
+public interface DragonSlayingStrategy {
+
+  void execute();
+}
+
+public class MeleeStrategy implements DragonSlayingStrategy {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(MeleeStrategy.class);
+
+  @Override
+  public void execute() {
+    LOGGER.info("With your Excalibur you sever the dragon's head!");
+  }
+}
+
+public class ProjectileStrategy implements DragonSlayingStrategy {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(ProjectileStrategy.class);
+
+  @Override
+  public void execute() {
+    LOGGER.info("You shoot the dragon with the magical crossbow and it falls dead on the ground!");
+  }
+}
+
+public class SpellStrategy implements DragonSlayingStrategy {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(SpellStrategy.class);
+
+  @Override
+  public void execute() {
+    LOGGER.info("You cast the spell of disintegration and the dragon vaporizes in a pile of dust!");
+  }
+}
+```
+
+现在有一个强力的屠龙者要基于上面的组件来选择他的战斗策略。
+
+```java
+public class DragonSlayer {
+
+  private DragonSlayingStrategy strategy;
+
+  public DragonSlayer(DragonSlayingStrategy strategy) {
+    this.strategy = strategy;
+  }
+
+  public void changeStrategy(DragonSlayingStrategy strategy) {
+    this.strategy = strategy;
+  }
+
+  public void goToBattle() {
+    strategy.execute();
+  }
+}
+```
+
+最后是屠龙者的行动。
+
+```java
+    LOGGER.info("Green dragon spotted ahead!");
+    var dragonSlayer = new DragonSlayer(new MeleeStrategy());
+    dragonSlayer.goToBattle();
+    LOGGER.info("Red dragon emerges.");
+    dragonSlayer.changeStrategy(new ProjectileStrategy());
+    dragonSlayer.goToBattle();
+    LOGGER.info("Black dragon lands before you.");
+    dragonSlayer.changeStrategy(new SpellStrategy());
+    dragonSlayer.goToBattle();
+    
+    // Green dragon spotted ahead!
+    // With your Excalibur you sever the dragon's head!
+    // Red dragon emerges.
+    // You shoot the dragon with the magical crossbow and it falls dead on the ground!
+    // Black dragon lands before you.
+    // You cast the spell of disintegration and the dragon vaporizes in a pile of dust!    
+```
+
+## 类图
+![alt text](../../strategy/etc/strategy_1.png "Strategy")
+
+## 应用
+使用策略模式当
+
+* 许多相关的类只是行为不同。策略模式提供了一种为一种类配置多种行为的能力。
+* 你需要一种算法的不同变体。比如，你可能定义反应不用时间空间权衡的算法。当这些算法的变体使用类的层次结构来实现时就可以使用策略模式。
+* 一个算法使用的数据客户不应该对其知晓。使用策略模式来避免暴露复杂的，特定于算法的数据结构。
+* 一个类定义了许多行为，这些行为在其操作中展现为多个条件语句。移动相关的条件分支到它们分别的策略类中来代替这些条件语句。
+
+## 教学
+
+* [Strategy Pattern Tutorial](https://www.journaldev.com/1754/strategy-design-pattern-in-java-example-tutorial)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions](https://www.amazon.com/gp/product/1937785467/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1937785467&linkCode=as2&tag=javadesignpat-20&linkId=7e4e2fb7a141631491534255252fd08b)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

From aebdb88a83498eaeb82f6ae7c41107c996f72311 Mon Sep 17 00:00:00 2001
From: Fedor Skvorcov <43882212+fedorskvorcov@users.noreply.github.com>
Date: Tue, 1 Sep 2020 09:51:46 +0300
Subject: [PATCH 075/254] Fix typo in comment

---
 .../main/java/com/iluwatar/servicelocator/ServiceLocator.java   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
index 4e787d34c..fad1dafe7 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
@@ -50,7 +50,7 @@ public final class ServiceLocator {
       return serviceObj;
     } else {
       /*
-       * If we are unable to retrive anything from cache, then lookup the service and add it in the
+       * If we are unable to retrieve anything from cache, then lookup the service and add it in the
        * cache map
        */
       var ctx = new InitContext();

From 7aca64a3c9cd67958ebc4c22057834c8f3133ffc Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 1 Sep 2020 13:39:32 +0000
Subject: [PATCH 076/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 95fe7a912..e64d4c15b 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-129-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-130-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -263,6 +263,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4" width="100px;" alt=""/><br /><sub><b>Fedor Skvorcov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fedorskvorcov" title="Code">💻</a></td>
   </tr>
 </table>
 

From daa94c7b6d4d0f5dc61826b4e0c8ab86f8d5df69 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 1 Sep 2020 13:39:33 +0000
Subject: [PATCH 077/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 65eb0bf92..e0ef0200b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1176,6 +1176,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "fedorskvorcov",
+      "name": "Fedor Skvorcov",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/43882212?v=4",
+      "profile": "https://github.com/fedorskvorcov",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From b9b6777d15a8dff0bc304888bc1c122a74cb89c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 1 Sep 2020 19:55:22 +0300
Subject: [PATCH 078/254] Update README.md

---
 private-class-data/README.md                  |  5 ++-
 promise/README.md                             | 41 ++++++++++---------
 .../main/java/com/iluwatar/promise/App.java   |  2 +-
 .../java/com/iluwatar/promise/Promise.java    |  2 +-
 .../com/iluwatar/promise/PromiseSupport.java  |  3 +-
 5 files changed, 29 insertions(+), 24 deletions(-)

diff --git a/private-class-data/README.md b/private-class-data/README.md
index d4788d2dd..5d0e6eb51 100644
--- a/private-class-data/README.md
+++ b/private-class-data/README.md
@@ -9,6 +9,7 @@ tags:
 ---
 
 ## Intent
+
 Private Class Data design pattern seeks to reduce exposure of attributes by limiting their 
 visibility. It reduces the number of class attributes by encapsulating them in single Data object.
 
@@ -124,9 +125,11 @@ immutableStew.mix();  // Mixing the immutable stew we find: 2 potatoes, 4 carrot
 ```
 
 ## Class diagram
+
 ![alt text](./etc/private-class-data.png "Private Class Data")
 
 ## Applicability
+
 Use the Private Class Data pattern when
 
-* You want to prevent write access to class data members
+* You want to prevent write access to class data members.
diff --git a/promise/README.md b/promise/README.md
index 993d29a9f..73dce13ec 100644
--- a/promise/README.md
+++ b/promise/README.md
@@ -14,23 +14,25 @@ CompletableFuture
 
 ## Intent
 
-A Promise represents a proxy for a value not necessarily known when the promise is created. It allows you to associate 
-dependent promises to an asynchronous action's eventual success value or failure reason. Promises are a way to write 
-async code that still appears as though it is executing in a synchronous way.
+A Promise represents a proxy for a value not necessarily known when the promise is created. It 
+allows you to associate dependent promises to an asynchronous action's eventual success value or 
+failure reason. Promises are a way to write async code that still appears as though it is executing 
+in a synchronous way.
 
 ## Explanation
 
-The Promise object is used for asynchronous computations. A Promise represents an operation that hasn't completed yet, 
-but is expected in the future.
+The Promise object is used for asynchronous computations. A Promise represents an operation that 
+hasn't completed yet, but is expected in the future.
 
 Promises provide a few advantages over callback objects:
- * Functional composition and error handling
- * Prevents callback hell and provides callback aggregation
+ * Functional composition and error handling.
+ * Prevents callback hell and provides callback aggregation.
 
 Real world example
 
-> We are developing a software solution that downloads files and calculates the number of lines and character 
-frequencies in those files. Promise is an ideal solution to make the code concise and easy to understand.
+> We are developing a software solution that downloads files and calculates the number of lines and 
+> character frequencies in those files. Promise is an ideal solution to make the code concise and 
+> easy to understand.
 
 In plain words
 
@@ -38,14 +40,15 @@ In plain words
 
 Wikipedia says
 
-> In computer science, future, promise, delay, and deferred refer to constructs used for synchronizing program 
-execution in some concurrent programming languages. They describe an object that acts as a proxy for a result that is 
-initially unknown, usually because the computation of its value is not yet complete.
+> In computer science, future, promise, delay, and deferred refer to constructs used for 
+> synchronizing program execution in some concurrent programming languages. They describe an object 
+> that acts as a proxy for a result that is initially unknown, usually because the computation of 
+> its value is not yet complete.
 
 **Programmatic Example**
 
-In the example a file is downloaded and its line count is calculated. The calculated line count is then consumed and 
-printed on console.
+In the example a file is downloaded and its line count is calculated. The calculated line count is 
+then consumed and printed on console.
 
 Let's first introduce a support class we need for implementation. Here's `PromiseSupport`.
 
@@ -195,7 +198,7 @@ public class Promise<T> extends PromiseSupport<T> {
 
   public <V> Promise<V> thenApply(Function<? super T, V> func) {
     Promise<V> dest = new Promise<>();
-    fulfillmentAction = new TransformAction<V>(this, dest, func);
+    fulfillmentAction = new TransformAction<>(this, dest, func);
     return dest;
   }
 
@@ -246,8 +249,8 @@ public class Promise<T> extends PromiseSupport<T> {
 }
 ```
 
-Now we can show the full example in action. Here's how to download and count the number of lines in a file using
-`Promise`.
+Now we can show the full example in action. Here's how to download and count the number of lines in 
+a file using `Promise`.
 
 ```java
   countLines().thenAccept(
@@ -280,8 +283,8 @@ Now we can show the full example in action. Here's how to download and count the
 
 ## Applicability
 
-Promise pattern is applicable in concurrent programming when some work needs to be done asynchronously
-and:
+Promise pattern is applicable in concurrent programming when some work needs to be done 
+asynchronously and:
 
 * Code maintainability and readability suffers due to callback hell.
 * You need to compose promises and need better error handling for asynchronous tasks.
diff --git a/promise/src/main/java/com/iluwatar/promise/App.java b/promise/src/main/java/com/iluwatar/promise/App.java
index fb2f14bd5..6c0921936 100644
--- a/promise/src/main/java/com/iluwatar/promise/App.java
+++ b/promise/src/main/java/com/iluwatar/promise/App.java
@@ -81,7 +81,7 @@ public class App {
    * @throws InterruptedException if main thread is interrupted.
    * @throws ExecutionException   if an execution error occurs.
    */
-  public static void main(String[] args) throws InterruptedException, ExecutionException {
+  public static void main(String[] args) throws InterruptedException {
     var app = new App();
     try {
       app.promiseUsage();
diff --git a/promise/src/main/java/com/iluwatar/promise/Promise.java b/promise/src/main/java/com/iluwatar/promise/Promise.java
index e81cccb58..5b79ebcd6 100644
--- a/promise/src/main/java/com/iluwatar/promise/Promise.java
+++ b/promise/src/main/java/com/iluwatar/promise/Promise.java
@@ -141,7 +141,7 @@ public class Promise<T> extends PromiseSupport<T> {
    */
   public <V> Promise<V> thenApply(Function<? super T, V> func) {
     Promise<V> dest = new Promise<>();
-    fulfillmentAction = new TransformAction<V>(this, dest, func);
+    fulfillmentAction = new TransformAction<>(this, dest, func);
     return dest;
   }
 
diff --git a/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java b/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
index 7a12f0a0f..01e9926a0 100644
--- a/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
+++ b/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
@@ -26,7 +26,6 @@ package com.iluwatar.promise;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Future;
 import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -114,4 +113,4 @@ class PromiseSupport<T> implements Future<T> {
     }
     throw new ExecutionException(exception);
   }
-}
\ No newline at end of file
+}

From 25cca3547d9a7fa07342ba696ded72bb17f3d0f1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 1 Sep 2020 20:06:47 +0300
Subject: [PATCH 079/254] Update README.md

---
 prototype/README.md                           | 35 +++++---
 proxy/README.md                               | 60 +++++++++-----
 .../java/com/iluwatar/proxy/IvoryTower.java   | 80 +++++++++----------
 3 files changed, 105 insertions(+), 70 deletions(-)

diff --git a/prototype/README.md b/prototype/README.md
index 472e8330c..9128ccb2c 100644
--- a/prototype/README.md
+++ b/prototype/README.md
@@ -10,16 +10,19 @@ tags:
 ---
 
 ## Intent
-Specify the kinds of objects to create using a prototypical instance, and create new objects by copying this prototype.
+
+Specify the kinds of objects to create using a prototypical instance, and create new objects by 
+copying this prototype.
 
 ## Explanation
 
-First it should be noted that Prototype pattern is not used to gain performance benefits. It's only used for creating
-new objects from prototype instance.
+First it should be noted that Prototype pattern is not used to gain performance benefits. It's only 
+used for creating new objects from prototype instance.
 
 Real world example
 
-> Remember Dolly? The sheep that was cloned! Lets not get into the details but the key point here is that it is all about cloning.
+> Remember Dolly? The sheep that was cloned! Lets not get into the details but the key point here is 
+> that it is all about cloning.
 
 In plain words
 
@@ -27,9 +30,12 @@ In plain words
 
 Wikipedia says
 
-> The prototype pattern is a creational design pattern in software development. It is used when the type of objects to create is determined by a prototypical instance, which is cloned to produce new objects.
+> The prototype pattern is a creational design pattern in software development. It is used when the 
+> type of objects to create is determined by a prototypical instance, which is cloned to produce new 
+> objects.
 
-In short, it allows you to create a copy of an existing object and modify it to your needs, instead of going through the trouble of creating an object from scratch and setting it up.
+In short, it allows you to create a copy of an existing object and modify it to your needs, instead 
+of going through the trouble of creating an object from scratch and setting it up.
 
 **Programmatic Example**
 
@@ -52,7 +58,7 @@ class Sheep implements Cloneable {
 }
 ```
 
-Then it can be cloned like below
+Then it can be cloned like below:
 
 ```java
 var original = new Sheep("Jolly");
@@ -65,15 +71,20 @@ System.out.println(cloned.getName()); // Dolly
 ```
 
 ## Class diagram
+
 ![alt text](./etc/prototype.urm.png "Prototype pattern class diagram")
 
 ## Applicability
-Use the Prototype pattern when a system should be independent of how its products are created, composed and represented; and
 
-* When the classes to instantiate are specified at run-time, for example, by dynamic loading
-* To avoid building a class hierarchy of factories that parallels the class hierarchy of products
-* When instances of a class can have one of only a few different combinations of state. It may be more convenient to install a corresponding number of prototypes and clone them rather than instantiating the class manually, each time with the appropriate state
-* When object creation is expensive compared to cloning
+Use the Prototype pattern when a system should be independent of how its products are created, 
+composed, represented and
+
+* When the classes to instantiate are specified at run-time, for example, by dynamic loading.
+* To avoid building a class hierarchy of factories that parallels the class hierarchy of products.
+* When instances of a class can have one of only a few different combinations of state. It may be 
+more convenient to install a corresponding number of prototypes and clone them rather than 
+instantiating the class manually, each time with the appropriate state.
+* When object creation is expensive compared to cloning.
 
 ## Real world examples
 
diff --git a/proxy/README.md b/proxy/README.md
index ddcc4e784..edf223b23 100644
--- a/proxy/README.md
+++ b/proxy/README.md
@@ -10,16 +10,20 @@ tags:
 ---
 
 ## Also known as
+
 Surrogate
 
 ## Intent
-Provide a surrogate or placeholder for another object to control
-access to it.
+
+Provide a surrogate or placeholder for another object to control access to it.
 
 ## Explanation
+
 Real world example
 
-> Imagine a tower where the local wizards go to study their spells. The ivory tower can only be accessed through a proxy which ensures that only the first three wizards can enter. Here the proxy represents the functionality of the tower and adds access control to it.
+> Imagine a tower where the local wizards go to study their spells. The ivory tower can only be 
+> accessed through a proxy which ensures that only the first three wizards can enter. Here the proxy 
+> represents the functionality of the tower and adds access control to it.
 
 In plain words
 
@@ -27,11 +31,17 @@ In plain words
 
 Wikipedia says
 
-> A proxy, in its most general form, is a class functioning as an interface to something else. A proxy is a wrapper or agent object that is being called by the client to access the real serving object behind the scenes. Use of the proxy can simply be forwarding to the real object, or can provide additional logic. In the proxy extra functionality can be provided, for example caching when operations on the real object are resource intensive, or checking preconditions before operations on the real object are invoked.
+> A proxy, in its most general form, is a class functioning as an interface to something else. 
+> A proxy is a wrapper or agent object that is being called by the client to access the real serving 
+> object behind the scenes. Use of the proxy can simply be forwarding to the real object, or can 
+> provide additional logic. In the proxy extra functionality can be provided, for example caching 
+> when operations on the real object are resource intensive, or checking preconditions before 
+> operations on the real object are invoked.
 
 **Programmatic Example**
 
-Taking our wizard tower example from above. Firstly we have the wizard tower interface and the ivory tower class
+Taking our wizard tower example from above. Firstly we have the `WizardTower` interface and the 
+`IvoryTower` class.
 
 ```java
 public interface WizardTower {
@@ -50,7 +60,7 @@ public class IvoryTower implements WizardTower {
 }
 ```
 
-Then a simple wizard class
+Then a simple `Wizard` class.
 
 ```java
 public class Wizard {
@@ -68,7 +78,7 @@ public class Wizard {
 }
 ```
 
-Then we have the proxy to add access control to wizard tower
+Then we have the `WizardTowerProxy` to add access control to `WizardTower`.
 
 ```java
 public class WizardTowerProxy implements WizardTower {
@@ -97,28 +107,41 @@ public class WizardTowerProxy implements WizardTower {
 }
 ```
 
-And here is tower entering scenario
+And here is the tower entering scenario.
 
 ```java
 var proxy = new WizardTowerProxy(new IvoryTower());
-proxy.enter(new Wizard("Red wizard")); // Red wizard enters the tower.
-proxy.enter(new Wizard("White wizard")); // White wizard enters the tower.
-proxy.enter(new Wizard("Black wizard")); // Black wizard enters the tower.
-proxy.enter(new Wizard("Green wizard")); // Green wizard is not allowed to enter!
-proxy.enter(new Wizard("Brown wizard")); // Brown wizard is not allowed to enter!
+proxy.enter(new Wizard("Red wizard"));
+proxy.enter(new Wizard("White wizard"));
+proxy.enter(new Wizard("Black wizard"));
+proxy.enter(new Wizard("Green wizard"));
+proxy.enter(new Wizard("Brown wizard"));
+```
+
+Program output:
+
+```
+Red wizard enters the tower.
+White wizard enters the tower.
+Black wizard enters the tower.
+Green wizard is not allowed to enter!
+Brown wizard is not allowed to enter!
 ```
 
 ## Class diagram
+
 ![alt text](./etc/proxy.urm.png "Proxy pattern class diagram")
 
 ## Applicability
-Proxy is applicable whenever there is a need for a more
-versatile or sophisticated reference to an object than a simple pointer. Here
-are several common situations in which the Proxy pattern is applicable
+
+Proxy is applicable whenever there is a need for a more versatile or sophisticated reference to an 
+object than a simple pointer. Here are several common situations in which the Proxy pattern is 
+applicable.
 
 * Remote proxy provides a local representative for an object in a different address space.
 * Virtual proxy creates expensive objects on demand.
-* Protection proxy controls access to the original object. Protection proxies are useful when objects should have different access rights.
+* Protection proxy controls access to the original object. Protection proxies are useful when 
+objects should have different access rights.
 
 ## Typical Use Case
 
@@ -136,7 +159,8 @@ are several common situations in which the Proxy pattern is applicable
 
 * [java.lang.reflect.Proxy](http://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Proxy.html)
 * [Apache Commons Proxy](https://commons.apache.org/proper/commons-proxy/)
-* Mocking frameworks Mockito, Powermock, EasyMock
+* Mocking frameworks [Mockito](https://site.mockito.org/), 
+[Powermock](https://powermock.github.io/), [EasyMock](https://easymock.org/)
 
 ## Related patterns
 
diff --git a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
index 658b19949..2523af8b8 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
@@ -1,40 +1,40 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.proxy;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * The object to be proxyed.
- */
-public class IvoryTower implements WizardTower {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class);
-
-  public void enter(Wizard wizard) {
-    LOGGER.info("{} enters the tower.", wizard);
-  }
-
-}
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.proxy;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The object to be proxied.
+ */
+public class IvoryTower implements WizardTower {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class);
+
+  public void enter(Wizard wizard) {
+    LOGGER.info("{} enters the tower.", wizard);
+  }
+
+}

From 3f4d63751042d6cf271611721a751657b5271f44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 1 Sep 2020 20:18:10 +0300
Subject: [PATCH 080/254] Update README.md

---
 repository/README.md                          | 153 +++++-------------
 .../com/iluwatar/repository/AppConfig.java    |   3 +-
 .../repository/PersonSpecifications.java      |   2 +-
 3 files changed, 43 insertions(+), 115 deletions(-)

diff --git a/repository/README.md b/repository/README.md
index ad603ee2b..ab13934bd 100644
--- a/repository/README.md
+++ b/repository/README.md
@@ -9,26 +9,33 @@ tags:
 ---
 
 ## Intent
-Repository layer is added between the domain and data mapping layers to isolate domain objects from details of the 
-database access code and to minimize scattering and duplication of query code. The Repository pattern is especially 
-useful in systems where number of domain classes is large or heavy querying is utilized.
+
+Repository layer is added between the domain and data mapping layers to isolate domain objects from 
+details of the database access code and to minimize scattering and duplication of query code. The 
+Repository pattern is especially useful in systems where number of domain classes is large or heavy 
+querying is utilized.
 
 ## Explanation
+
 Real world example
 
-> Let's say we need a persistent data store for persons. Adding new persons and searching for them according to different criteria must be easy. 
+> Let's say we need a persistent data store for persons. Adding new persons and searching for them 
+> according to different criteria must be easy. 
 
 In plain words
 
-> Repository architectural pattern creates a uniform layer of data repositories that can be used for CRUD operations.
+> Repository architectural pattern creates a uniform layer of data repositories that can be used for 
+> CRUD operations.
 
 [Microsoft documentation](https://docs.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/infrastructure-persistence-layer-design) says
 
-> Repositories are classes or components that encapsulate the logic required to access data sources. They centralize common data access functionality, providing better maintainability and decoupling the infrastructure or technology used to access databases from the domain model layer.
+> Repositories are classes or components that encapsulate the logic required to access data sources. 
+> They centralize common data access functionality, providing better maintainability and decoupling 
+> the infrastructure or technology used to access databases from the domain model layer.
 
 **Programmatic Example**
 
-Let's first look at the person class that we need to persist. 
+Let's first look at the person entity that we need to persist. 
 
 ```java
 @Entity
@@ -39,107 +46,23 @@ public class Person {
   private Long id;
   private String name;
   private String surname;
-
   private int age;
 
   public Person() {
   }
 
-  /**
-   * Constructor.
-   */
   public Person(String name, String surname, int age) {
     this.name = name;
     this.surname = surname;
     this.age = age;
   }
 
-  public Long getId() {
-    return id;
-  }
-
-  public void setId(Long id) {
-    this.id = id;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public void setName(String name) {
-    this.name = name;
-  }
-
-  public String getSurname() {
-    return surname;
-  }
-
-  public void setSurname(String surname) {
-    this.surname = surname;
-  }
-
-  public int getAge() {
-    return age;
-  }
-
-  public void setAge(int age) {
-    this.age = age;
-  }
-
-  @Override
-  public String toString() {
-    return "Person [id=" + id + ", name=" + name + ", surname=" + surname + ", age=" + age + "]";
-  }
-
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + age;
-    result = prime * result + (id == null ? 0 : id.hashCode());
-    result = prime * result + (name == null ? 0 : name.hashCode());
-    result = prime * result + (surname == null ? 0 : surname.hashCode());
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (Person) obj;
-    if (age != other.age) {
-      return false;
-    }
-    if (id == null) {
-      if (other.id != null) {
-        return false;
-      }
-    } else if (!id.equals(other.id)) {
-      return false;
-    }
-    if (name == null) {
-      if (other.name != null) {
-        return false;
-      }
-    } else if (!name.equals(other.name)) {
-      return false;
-    }
-    if (surname == null) {
-      return other.surname == null;
-    }
-    return surname.equals(other.surname);
-  }
+  // getters and setters ->
+  ...
 }
 ```
 
-We are using Spring Data to create the repository so it becomes really simple.
+We are using Spring Data to create the `PersonRepository` so it becomes really simple.
 
 ```java
 @Repository
@@ -150,7 +73,7 @@ public interface PersonRepository
 }
 ```
 
-Additionally we define a helper class for specification queries.
+Additionally we define a helper class `PersonSpecifications` for specification queries.
 
 ```java
 public class PersonSpecifications {
@@ -189,7 +112,7 @@ public class PersonSpecifications {
 }
 ```
 
-And here's the repository in action.
+And here's the repository example in action.
 
 ```java
     var peter = new Person("Peter", "Sagan", 17);
@@ -226,30 +149,36 @@ And here's the repository in action.
     persons.stream().map(Person::toString).forEach(LOGGER::info);
 
     repository.deleteAll();
-    
-    // Count Person records: 4
-    // Person [id=1, name=Peter, surname=Sagan, age=17]
-    // Person [id=2, name=Nasta, surname=Kuzminova, age=25]
-    // Person [id=3, name=John, surname=lawrence, age=35]
-    // Person [id=4, name=Terry, surname=Law, age=36]
-    // Find by id 2: Person [id=2, name=Barbora, surname=Spotakova, age=25]
-    // Count Person records: 3
-    // Find by John is Person [id=3, name=John, surname=lawrence, age=35]
-    // Find Person with age between 20,40: 
-    // Person [id=3, name=John, surname=lawrence, age=35]
-    // Person [id=4, name=Terry, surname=Law, age=36]
+```
+
+Program output:
+
+```
+Count Person records: 4
+Person [id=1, name=Peter, surname=Sagan, age=17]
+Person [id=2, name=Nasta, surname=Kuzminova, age=25]
+Person [id=3, name=John, surname=lawrence, age=35]
+Person [id=4, name=Terry, surname=Law, age=36]
+Find by id 2: Person [id=2, name=Barbora, surname=Spotakova, age=25]
+Count Person records: 3
+Find by John is Person [id=3, name=John, surname=lawrence, age=35]
+Find Person with age between 20,40: 
+Person [id=3, name=John, surname=lawrence, age=35]
+Person [id=4, name=Terry, surname=Law, age=36]
 ```
 
 ## Class diagram
+
 ![alt text](./etc/repository.png "Repository")
 
 ## Applicability
+
 Use the Repository pattern when
 
-* The number of domain objects is large
-* You want to avoid duplication of query code
-* You want to keep the database querying code in single place
-* You have multiple data sources
+* The number of domain objects is large.
+* You want to avoid duplication of query code.
+* You want to keep the database querying code in single place.
+* You have multiple data sources.
 
 ## Real world examples
 
diff --git a/repository/src/main/java/com/iluwatar/repository/AppConfig.java b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
index 50a23026f..81d158d23 100644
--- a/repository/src/main/java/com/iluwatar/repository/AppConfig.java
+++ b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
@@ -23,7 +23,6 @@
 
 package com.iluwatar.repository;
 
-import java.sql.SQLException;
 import java.util.List;
 import java.util.Properties;
 import javax.sql.DataSource;
@@ -89,7 +88,7 @@ public class AppConfig {
    * Get transaction manager.
    */
   @Bean
-  public JpaTransactionManager transactionManager() throws SQLException {
+  public JpaTransactionManager transactionManager() {
     var transactionManager = new JpaTransactionManager();
     transactionManager.setEntityManagerFactory(entityManagerFactory().getObject());
     return transactionManager;
diff --git a/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java b/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
index 919b746be..823fa2d3d 100644
--- a/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
+++ b/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
@@ -60,7 +60,7 @@ public class PersonSpecifications {
    */
   public static class NameEqualSpec implements Specification<Person> {
 
-    public String name;
+    public final String name;
 
     public NameEqualSpec(String name) {
       this.name = name;

From 19378f3fddb407ad7a0c68cc51338fc980ce9823 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 1 Sep 2020 20:25:39 +0300
Subject: [PATCH 081/254] Update README.md

---
 retry/README.md | 110 ++++++++++++++++++++++++------------------------
 1 file changed, 55 insertions(+), 55 deletions(-)

diff --git a/retry/README.md b/retry/README.md
index 056674a18..8cf6bb94f 100644
--- a/retry/README.md
+++ b/retry/README.md
@@ -10,39 +10,40 @@ tags:
 ---
 
 ## Intent
-Transparently retry certain operations that involve communication with external resources, particularly over the 
-network, isolating calling code from the retry implementation details.
+
+Transparently retry certain operations that involve communication with external resources, 
+particularly over the network, isolating calling code from the retry implementation details.
 
 ## Explanation
-Retry pattern consists retrying operations on remote resources over the 
-network a set number of times. It closely depends on both business and technical
-requirements: how much time will the business allow the end user to wait while
-the operation finishes? What are the performance characteristics of the 
-remote resource during peak loads as well as our application as more threads
-are waiting for the remote resource's availability? Among the errors returned
-by the remote service, which can be safely ignored in order to retry? Is the 
-operation [idempotent](https://en.wikipedia.org/wiki/Idempotence)?
 
-Another concern is the impact on the calling code by implementing the retry 
-mechanism. The retry mechanics should ideally be completely transparent to the
-calling code (service interface remains unaltered). There are two general 
-approaches to this problem: from an enterprise architecture standpoint 
-(strategic), and a shared library standpoint (tactical).
+Retry pattern consists retrying operations on remote resources over the network a set number of 
+times. It closely depends on both business and technical requirements: How much time will the 
+business allow the end user to wait while the operation finishes? What are the performance 
+characteristics of the remote resource during peak loads as well as our application as more threads
+are waiting for the remote resource's availability? Among the errors returned by the remote service, 
+which can be safely ignored in order to retry? Is the operation 
+[idempotent](https://en.wikipedia.org/wiki/Idempotence)?
 
-From a strategic point of view, this would be solved by having requests
-be redirected to a separate intermediary system, traditionally an 
-[ESB](https://en.wikipedia.org/wiki/Enterprise_service_bus), but more recently
-a [Service Mesh](https://medium.com/microservices-in-practice/service-mesh-for-microservices-2953109a3c9a).
+Another concern is the impact on the calling code by implementing the retry mechanism. The retry 
+mechanics should ideally be completely transparent to the calling code (service interface remains 
+unaltered). There are two general approaches to this problem: From an enterprise architecture 
+standpoint (strategic), and a shared library standpoint (tactical).
 
-From a tactical point of view, this would be solved by reusing shared libraries 
-like [Hystrix](https://github.com/Netflix/Hystrix) (please note that *Hystrix* is a complete implementation of 
-the [Circuit Breaker](https://java-design-patterns.com/patterns/circuit-breaker/) pattern, of which the Retry pattern 
-can be considered a subset of.). This is the type of solution showcased in the simple example that accompanies this 
-*README*.
+From a strategic point of view, this would be solved by having requests redirected to a separate 
+intermediary system, traditionally an [ESB](https://en.wikipedia.org/wiki/Enterprise_service_bus), 
+but more recently a [Service Mesh](https://medium.com/microservices-in-practice/service-mesh-for-microservices-2953109a3c9a).
+
+From a tactical point of view, this would be solved by reusing shared libraries like 
+[Hystrix](https://github.com/Netflix/Hystrix) (please note that Hystrix is a complete implementation 
+of the [Circuit Breaker](https://java-design-patterns.com/patterns/circuit-breaker/) pattern, of 
+which the Retry pattern can be considered a subset of). This is the type of solution showcased in 
+the simple example that accompanies this `README.md`.
 
 Real world example
 
-> Our application uses a service providing customer information. Once in a while the service seems to be flaky and can return errors or sometimes it just times out. To circumvent these problems we apply the retry pattern. 
+> Our application uses a service providing customer information. Once in a while the service seems 
+> to be flaky and can return errors or sometimes it just times out. To circumvent these problems we 
+> apply the retry pattern. 
 
 In plain words
 
@@ -50,11 +51,14 @@ In plain words
 
 [Microsoft documentation](https://docs.microsoft.com/en-us/azure/architecture/patterns/retry) says
 
-> Enable an application to handle transient failures when it tries to connect to a service or network resource, by transparently retrying a failed operation. This can improve the stability of the application.
+> Enable an application to handle transient failures when it tries to connect to a service or 
+> network resource, by transparently retrying a failed operation. This can improve the stability of 
+> the application.
 
 **Programmatic Example**
 
-In our hypothetical application, we have a generic interface for all operations on remote interfaces.
+In our hypothetical application, we have a generic interface for all operations on remote 
+interfaces.
 
 ```java
 public interface BusinessOperation<T> {
@@ -73,16 +77,14 @@ public final class FindCustomer implements BusinessOperation<String> {
 }
 ```
 
-Our `FindCustomer` implementation can be configured to throw 
-`BusinessException`s before returning the customer's ID, thereby simulating a
-'flaky' service that intermittently fails. Some exceptions, like the 
-`CustomerNotFoundException`, are deemed to be recoverable after some 
-hypothetical analysis because the root cause of the error stems from "some
-database locking issue". However, the `DatabaseNotAvailableException` is 
-considered to be a definite showstopper - the application should not attempt
-to recover from this error.
+Our `FindCustomer` implementation can be configured to throw `BusinessException`s before returning 
+the customer's ID, thereby simulating a flaky service that intermittently fails. Some exceptions, 
+like the `CustomerNotFoundException`, are deemed to be recoverable after some hypothetical analysis 
+because the root cause of the error stems from "some database locking issue". However, the 
+`DatabaseNotAvailableException` is considered to be a definite showstopper - the application should 
+not attempt to recover from this error.
 
-We can model a 'recoverable' scenario by instantiating `FindCustomer` like this:
+We can model a recoverable scenario by instantiating `FindCustomer` like this:
 
 ```java
 final var op = new FindCustomer(
@@ -93,15 +95,12 @@ final var op = new FindCustomer(
 );
 ```
 
-In this configuration, `FindCustomer` will throw `CustomerNotFoundException`
-three times, after which it will consistently return the customer's ID 
-(`12345`).
+In this configuration, `FindCustomer` will throw `CustomerNotFoundException` three times, after 
+which it will consistently return the customer's ID (`12345`).
 
-In our hypothetical scenario, our analysts indicate that this operation 
-typically fails 2-4 times for a given input during peak hours, and that each 
-worker thread in the database subsystem typically needs 50ms to 
-"recover from an error". Applying these policies would yield something like
-this:
+In our hypothetical scenario, our analysts indicate that this operation typically fails 2-4 times 
+for a given input during peak hours, and that each worker thread in the database subsystem typically 
+needs 50ms to "recover from an error". Applying these policies would yield something like this:
 
 ```java
 final var op = new Retry<>(
@@ -117,26 +116,27 @@ final var op = new Retry<>(
 );
 ```
 
-Executing `op` *once* would automatically trigger at most 5 retry attempts,
-with a 100 millisecond delay between attempts, ignoring any 
-`CustomerNotFoundException` thrown while trying. In this particular scenario,
-due to the configuration for `FindCustomer`, there will be 1 initial attempt 
+Executing `op` once would automatically trigger at most 5 retry attempts, with a 100 millisecond 
+delay between attempts, ignoring any `CustomerNotFoundException` thrown while trying. In this 
+particular scenario, due to the configuration for `FindCustomer`, there will be 1 initial attempt 
 and 3 additional retries before finally returning the desired result `12345`.
 
-If our `FindCustomer` operation were instead to throw a fatal 
-`DatabaseNotFoundException`, which we were instructed not to ignore, but 
-more importantly we did *not* instruct our `Retry` to ignore, then the operation
-would have failed immediately upon receiving the error, not matter how many 
-attempts were left.
+If our `FindCustomer` operation were instead to throw a fatal `DatabaseNotFoundException`, which we 
+were instructed not to ignore, but more importantly we did not instruct our `Retry` to ignore, then 
+the operation would have failed immediately upon receiving the error, not matter how many attempts 
+were left.
 
 ## Class diagram
+
 ![alt text](./etc/retry.png "Retry")
 
 ## Applicability
-Whenever an application needs to communicate with an external resource, particularly in a cloud environment, and if 
-the business requirements allow it.
+
+Whenever an application needs to communicate with an external resource, particularly in a cloud 
+environment, and if the business requirements allow it.
 
 ## Consequences
+
 **Pros:** 
 
 * Resiliency

From e231cd8d1a859cfe17612adbf1b77b44e6381467 Mon Sep 17 00:00:00 2001
From: Fedor <fedorskvorcov@yandex.ru>
Date: Wed, 2 Sep 2020 12:32:02 +0300
Subject: [PATCH 082/254] Remove unnecessary word from text

---
 singleton/src/main/java/com/iluwatar/singleton/App.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index 319e077ef..2cea2edd3 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -33,7 +33,7 @@ import org.slf4j.LoggerFactory;
  * <p>One of the risks of this pattern is that bugs resulting from setting a singleton up in a
  * distributed environment can be tricky to debug, since it will work fine if you debug with a
  * single classloader. Additionally, these problems can crop up a while after the implementation of
- * a singleton, since they may start out synchronous and only become async with time, so you it may
+ * a singleton, since they may start out synchronous and only become async with time, so it may
  * not be clear why you are seeing certain changes in behaviour.</p>
  *
  * <p>There are many ways to implement the Singleton. The first one is the eagerly initialized

From 46b23f322fff5fc3ece1f92f126ac7dd4573aa33 Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Wed, 2 Sep 2020 13:46:53 +0100
Subject: [PATCH 083/254] Add Simple Factory Pattern implementation

Java source code demonstrate simple factory design pattern
---
 pom.xml                                       |  1 +
 .../java/com/iluwatar/simplefactory/App.java  | 16 ++++++++++
 .../java/com/iluwatar/simplefactory/Car.java  | 10 +++++++
 .../simplefactory/CarSimpleFactory.java       | 29 +++++++++++++++++++
 .../com/iluwatar/simplefactory/Ferrari.java   | 14 +++++++++
 .../java/com/iluwatar/simplefactory/Ford.java | 14 +++++++++
 6 files changed, 84 insertions(+)
 create mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
 create mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
 create mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
 create mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
 create mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java

diff --git a/pom.xml b/pom.xml
index 6d779700f..cc59a846a 100644
--- a/pom.xml
+++ b/pom.xml
@@ -195,6 +195,7 @@
         <module>arrange-act-assert</module>
         <module>transaction-script</module>
         <module>filterer</module>
+        <module>simple-factory</module>
     </modules>
 
     <repositories>
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
new file mode 100644
index 000000000..898efe6d3
--- /dev/null
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
@@ -0,0 +1,16 @@
+package com.iluwatar.simplefactory;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class App {
+	
+	private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+	public static void main(String[] args) {
+		Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.carTypes.FORD);
+		Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.carTypes.FERRARI);
+		LOGGER.info(car1.getDescription());
+		LOGGER.info(car2.getDescription());
+	}
+}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
new file mode 100644
index 000000000..82ff4ebe0
--- /dev/null
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
@@ -0,0 +1,10 @@
+package com.iluwatar.simplefactory;
+
+/**
+ * Car interface
+ */
+public interface Car {
+
+	public String getDescription();
+
+}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
new file mode 100644
index 000000000..33dbe7b88
--- /dev/null
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
@@ -0,0 +1,29 @@
+package com.iluwatar.simplefactory;
+
+
+/**
+ * Factory of cars
+ */
+public class CarSimpleFactory {
+	
+	/*
+	 * Enumeration for different types of cars
+	 */
+	static enum carTypes {
+		FORD, FERRARI
+	};
+	
+	/*
+	 * Factory method takes as parameter a car type and initiate the appropriate class
+	 */
+	public static Car getCar(carTypes type) {
+		switch (type) {
+		case FORD:
+			return new Ford();
+		case FERRARI:
+			return new Ferrari();
+		default:
+			throw new IllegalArgumentException("Model not supported.");
+		}
+	}
+}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
new file mode 100644
index 000000000..f9f1d8492
--- /dev/null
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
@@ -0,0 +1,14 @@
+package com.iluwatar.simplefactory;
+
+/**
+ * Ferrari implementation
+ */
+public class Ferrari implements Car {
+	
+	static final String DESCRIPTION = "This is Ferrari.";
+	
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
+}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
new file mode 100644
index 000000000..0adf4b66b
--- /dev/null
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
@@ -0,0 +1,14 @@
+package com.iluwatar.simplefactory;
+
+/**
+ * Ford implementation
+ */
+public class Ford implements Car {
+
+	static final String DESCRIPTION = "This is Ford.";
+
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
+}

From ac98b31b68fcdf3133041d64e38fd2478202c227 Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Wed, 2 Sep 2020 14:09:44 +0100
Subject: [PATCH 084/254] Add Maven Assembly plugin to pom.xml

---
 simple-factory/pom.xml | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 simple-factory/pom.xml

diff --git a/simple-factory/pom.xml b/simple-factory/pom.xml
new file mode 100644
index 000000000..e7d28511f
--- /dev/null
+++ b/simple-factory/pom.xml
@@ -0,0 +1,30 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>simple-factory</artifactId>
+  <build>
+		<plugins>
+			<!-- Maven assembly plugin is invoked with default setting which we have 
+				in parent pom and specifying the class having main method -->
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-assembly-plugin</artifactId>
+				<executions>
+					<execution>
+						<configuration>
+							<archive>
+								<manifest>
+									<mainClass>com.iluwatar.abstractfactory.App</mainClass>
+								</manifest>
+							</archive>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>
\ No newline at end of file

From b423fd30d4b0d1fd6db2681c35f7c49ce447b1e5 Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Wed, 2 Sep 2020 18:12:42 +0100
Subject: [PATCH 085/254] Fix bugs, clean the code and add unit tests.

---
 simple-factory/etc/simple-factory.urm.puml    | 35 +++++++++++++++
 simple-factory/pom.xml                        | 13 +++++-
 .../java/com/iluwatar/simplefactory/App.java  | 44 +++++++++++++++----
 .../java/com/iluwatar/simplefactory/Car.java  |  8 ++--
 .../simplefactory/CarSimpleFactory.java       | 42 ++++++++----------
 .../com/iluwatar/simplefactory/Ferrari.java   | 16 +++----
 .../java/com/iluwatar/simplefactory/Ford.java | 12 ++---
 .../com/iluwatar/simplefactory/AppTest.java   | 14 ++++++
 .../simplefactory/CarSimpleFactoryTest.java   | 15 +++++++
 9 files changed, 148 insertions(+), 51 deletions(-)
 create mode 100644 simple-factory/etc/simple-factory.urm.puml
 create mode 100644 simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
 create mode 100644 simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java

diff --git a/simple-factory/etc/simple-factory.urm.puml b/simple-factory/etc/simple-factory.urm.puml
new file mode 100644
index 000000000..77fee4b5b
--- /dev/null
+++ b/simple-factory/etc/simple-factory.urm.puml
@@ -0,0 +1,35 @@
+@startuml
+package com.iluwatar.simplefactory {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  interface Car {
+    + getDescription() : String {abstract}
+  }
+  class CarSimpleFactory {
+    + CarSimpleFactory()
+    + getCar(type : CarType) : Car {static}
+  }
+  ~enum CarType {
+    + FERRARI {static}
+    + FORD {static}
+    + valueOf(name : String) : CarType {static}
+    + values() : CarType[] {static}
+  }
+  class Ferrari {
+    ~ DESCRIPTION : String {static}
+    + Ferrari()
+    + getDescription() : String
+  }
+  class Ford {
+    ~ DESCRIPTION : String {static}
+    + Ford()
+    + getDescription() : String
+  }
+}
+CarType ..+ CarSimpleFactory
+Ferrari ..|> Car 
+Ford ..|> Car 
+@enduml
\ No newline at end of file
diff --git a/simple-factory/pom.xml b/simple-factory/pom.xml
index e7d28511f..ca7c0547d 100644
--- a/simple-factory/pom.xml
+++ b/simple-factory/pom.xml
@@ -6,6 +6,17 @@
     <version>1.24.0-SNAPSHOT</version>
   </parent>
   <artifactId>simple-factory</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+    </dependency>
+  </dependencies>
   <build>
 		<plugins>
 			<!-- Maven assembly plugin is invoked with default setting which we have 
@@ -18,7 +29,7 @@
 						<configuration>
 							<archive>
 								<manifest>
-									<mainClass>com.iluwatar.abstractfactory.App</mainClass>
+									<mainClass>com.iluwatar.simplefactory.App</mainClass>
 								</manifest>
 							</archive>
 						</configuration>
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
index 898efe6d3..f13566ba6 100644
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
@@ -1,16 +1,42 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.simplefactory;
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 public class App {
-	
-	private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
-	public static void main(String[] args) {
-		Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.carTypes.FORD);
-		Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.carTypes.FERRARI);
-		LOGGER.info(car1.getDescription());
-		LOGGER.info(car2.getDescription());
-	}
+  
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+  
+  /**
+   * Program main entry point.
+   */
+  public static void main(String[] args) {
+    Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
+    Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
+    LOGGER.info(car1.getDescription());
+    LOGGER.info(car2.getDescription());
+  }
 }
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
index 82ff4ebe0..b87070040 100644
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
@@ -1,10 +1,10 @@
 package com.iluwatar.simplefactory;
 
 /**
- * Car interface
+ * Car interface.
  */
 public interface Car {
-
-	public String getDescription();
-
+  
+  public String getDescription();
+  
 }
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
index 33dbe7b88..911fe610f 100644
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
@@ -1,29 +1,25 @@
 package com.iluwatar.simplefactory;
 
-
 /**
- * Factory of cars
+ * Factory of cars.
  */
 public class CarSimpleFactory {
-	
-	/*
-	 * Enumeration for different types of cars
-	 */
-	static enum carTypes {
-		FORD, FERRARI
-	};
-	
-	/*
-	 * Factory method takes as parameter a car type and initiate the appropriate class
-	 */
-	public static Car getCar(carTypes type) {
-		switch (type) {
-		case FORD:
-			return new Ford();
-		case FERRARI:
-			return new Ferrari();
-		default:
-			throw new IllegalArgumentException("Model not supported.");
-		}
-	}
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  static enum CarType {
+    FORD, FERRARI
+  }
+  
+  /**
+   * Factory method takes as parameter a car type and initiate the appropriate class.
+   */
+  public static Car getCar(CarType type) {
+    switch (type) {
+      case FORD: return new Ford();
+      case FERRARI: return new Ferrari();
+      default: throw new IllegalArgumentException("Model not supported.");
+    }
+  }
 }
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
index f9f1d8492..d6e865182 100644
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
@@ -1,14 +1,14 @@
 package com.iluwatar.simplefactory;
 
 /**
- * Ferrari implementation
+ * Ferrari implementation.
  */
 public class Ferrari implements Car {
-	
-	static final String DESCRIPTION = "This is Ferrari.";
-	
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+   
+  static final String DESCRIPTION = "This is Ferrari.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
index 0adf4b66b..19cbea2ae 100644
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
+++ b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
@@ -1,14 +1,14 @@
 package com.iluwatar.simplefactory;
 
 /**
- * Ford implementation
+ * Ford implementation.
  */
 public class Ford implements Car {
 
-	static final String DESCRIPTION = "This is Ford.";
+  static final String DESCRIPTION = "This is Ford.";
 
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java b/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
new file mode 100644
index 000000000..4465b3b8c
--- /dev/null
+++ b/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
@@ -0,0 +1,14 @@
+package com.iluwatar.simplefactory;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import org.junit.jupiter.api.Test;
+
+class AppTest {
+
+	@Test
+	void shouldExecuteWithoutExceptions() {
+		assertDoesNotThrow(() -> App.main(new String[]{}));
+	}
+
+}
diff --git a/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java b/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java
new file mode 100644
index 000000000..394b652b6
--- /dev/null
+++ b/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java
@@ -0,0 +1,15 @@
+package com.iluwatar.simplefactory;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import org.junit.jupiter.api.Test;
+
+class CarSimpleFactoryTest {
+
+	@Test
+	void shouldReturnFerrariInstance() {
+		final var ferrari = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
+		assertTrue(ferrari instanceof Ferrari);
+	}
+
+}

From fb890e80ddfd8ac5f4f8be4e84140b2eb1f61015 Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Thu, 3 Sep 2020 20:02:52 +0300
Subject: [PATCH 086/254] refactor

---
 .../com/iluwatar/abstractfactory/App.java     | 12 -----------
 .../abstractfactory/AbstractFactoryTest.java  | 21 +++++++++++++------
 2 files changed, 15 insertions(+), 18 deletions(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index e158ece74..21b4af305 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -58,10 +58,6 @@ public class App {
     setArmy(factory.createArmy());
   }
 
-  King getKing(final KingdomFactory factory) {
-    return factory.createKing();
-  }
-
   public King getKing() {
     return king;
   }
@@ -70,10 +66,6 @@ public class App {
     this.king = king;
   }
 
-  Castle getCastle(final KingdomFactory factory) {
-    return factory.createCastle();
-  }
-
   public Castle getCastle() {
     return castle;
   }
@@ -82,10 +74,6 @@ public class App {
     this.castle = castle;
   }
 
-  Army getArmy(final KingdomFactory factory) {
-    return factory.createArmy();
-  }
-
   public Army getArmy() {
     return army;
   }
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index f3db525a1..1506844cf 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -48,30 +48,39 @@ public class AbstractFactoryTest {
 
   @Test
   public void king() {
-    final var elfKing = app.getKing(elfFactory);
+    app.createKingdom(elfFactory);
+    final var elfKing = app.getKing();
     assertTrue(elfKing instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription());
-    final var orcKing = app.getKing(orcFactory);
+
+    app.createKingdom(orcFactory);
+    final var orcKing = app.getKing();
     assertTrue(orcKing instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription());
   }
 
   @Test
   public void castle() {
-    final var elfCastle = app.getCastle(elfFactory);
+    app.createKingdom(elfFactory);
+    final var elfCastle = app.getCastle();
     assertTrue(elfCastle instanceof ElfCastle);
     assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription());
-    final var orcCastle = app.getCastle(orcFactory);
+
+    app.createKingdom(orcFactory);
+    final var orcCastle = app.getCastle();
     assertTrue(orcCastle instanceof OrcCastle);
     assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription());
   }
 
   @Test
   public void army() {
-    final var elfArmy = app.getArmy(elfFactory);
+    app.createKingdom(elfFactory);
+    final var elfArmy = app.getArmy();
     assertTrue(elfArmy instanceof ElfArmy);
     assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription());
-    final var orcArmy = app.getArmy(orcFactory);
+
+    app.createKingdom(orcFactory);
+    final var orcArmy = app.getArmy();
     assertTrue(orcArmy instanceof OrcArmy);
     assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription());
   }

From e89042a782b55202c1945e445df4f73d2a09a2b4 Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Thu, 3 Sep 2020 20:04:29 +0300
Subject: [PATCH 087/254] remove boilerplate code

---
 abstract-factory/pom.xml                      |  5 ++
 .../com/iluwatar/abstractfactory/App.java     | 54 +++++++------------
 2 files changed, 25 insertions(+), 34 deletions(-)

diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index 2328c60a8..e10a9436f 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -31,6 +31,11 @@
 			<artifactId>junit-jupiter-engine</artifactId>
 			<scope>test</scope>
 		</dependency>
+		<dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<version>1.18.12</version>
+		</dependency>
 	</dependencies>
 	<build>
 		<plugins>
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 21b4af305..6cdaf865f 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -24,6 +24,9 @@
 package com.iluwatar.abstractfactory;
 
 import com.iluwatar.abstractfactory.App.FactoryMaker.KingdomType;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -41,12 +44,19 @@ import org.slf4j.LoggerFactory;
  * and its implementations ( {@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses
  * both concrete implementations to create a king, a castle and an army.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
+  @Setter
+  @Getter
   private King king;
+
+  @Setter
+  @Getter
   private Castle castle;
+
+  @Setter
+  @Getter
   private Army army;
 
   /**
@@ -58,30 +68,6 @@ public class App {
     setArmy(factory.createArmy());
   }
 
-  public King getKing() {
-    return king;
-  }
-
-  private void setKing(final King king) {
-    this.king = king;
-  }
-
-  public Castle getCastle() {
-    return castle;
-  }
-
-  private void setCastle(final Castle castle) {
-    this.castle = castle;
-  }
-
-  public Army getArmy() {
-    return army;
-  }
-
-  private void setArmy(final Army army) {
-    this.army = army;
-  }
-
   /**
    * The factory of kingdom factories.
    */
@@ -118,16 +104,16 @@ public class App {
 
     var app = new App();
 
-    LOGGER.info("Elf Kingdom");
+    log.info("Elf Kingdom");
     app.createKingdom(FactoryMaker.makeFactory(KingdomType.ELF));
-    LOGGER.info(app.getArmy().getDescription());
-    LOGGER.info(app.getCastle().getDescription());
-    LOGGER.info(app.getKing().getDescription());
+    log.info(app.getArmy().getDescription());
+    log.info(app.getCastle().getDescription());
+    log.info(app.getKing().getDescription());
 
-    LOGGER.info("Orc Kingdom");
+    log.info("Orc Kingdom");
     app.createKingdom(FactoryMaker.makeFactory(KingdomType.ORC));
-    LOGGER.info(app.getArmy().getDescription());
-    LOGGER.info(app.getCastle().getDescription());
-    LOGGER.info(app.getKing().getDescription());
+    log.info(app.getArmy().getDescription());
+    log.info(app.getCastle().getDescription());
+    log.info(app.getKing().getDescription());
   }
 }
\ No newline at end of file

From c9718a52277133f283a1bd6ff79423b4f5e162ab Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Thu, 3 Sep 2020 21:08:28 +0100
Subject: [PATCH 088/254] add README file

---
 simple-factory/README.md | 128 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 128 insertions(+)
 create mode 100644 simple-factory/README.md

diff --git a/simple-factory/README.md b/simple-factory/README.md
new file mode 100644
index 000000000..1d069a6dd
--- /dev/null
+++ b/simple-factory/README.md
@@ -0,0 +1,128 @@
+---
+layout: pattern
+title: Simple Factory
+folder: simple-factory
+permalink: /patterns/simple-factory/
+categories: Creational
+tags:
+ - Gang of Four
+---
+
+## Also known as
+
+* Factory
+* Static Factory Method
+
+## Intent
+
+Providing a static method encapsulated in a class called factory, in order to hide the implementation logic and makes client code focus on usage rather then initialization new objects.
+
+## Explanation
+
+Real world example
+
+> Lets say we have a web application connected to SQLServer, but now we want to switch to Oracle. To do so without modifying existing source code, we need to implements Simple Factory pattern, in which a static method can be invoked to create connection to a given database.
+
+Wikipedia says
+
+> Factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class.
+
+**Programmatic Example**
+
+We have an interface "Car" and tow implementations "Ford" and "Ferrari".
+
+```java
+/**
+ * Car interface.
+ */
+public interface Car {
+  
+  public String getDescription();
+  
+}
+
+/**
+ * Ford implementation.
+ */
+public class Ford implements Car {
+
+  static final String DESCRIPTION = "This is Ford.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+
+/**
+ * Ferrari implementation.
+ */
+public class Ferrari implements Car {
+   
+  static final String DESCRIPTION = "This is Ferrari.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+```
+
+Then we have the static method "getCar" to create car objects encapsulated in the factory class "CarSimpleFactory".
+
+```java
+/**
+ * Factory of cars.
+ */
+public class CarSimpleFactory {
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  static enum CarType {
+    FORD, FERRARI
+  }
+  
+  /**
+   * Factory method takes as parameter a car type and initiate the appropriate class.
+   */
+  public static Car getCar(CarType type) {
+    switch (type) {
+      case FORD: return new Ford();
+      case FERRARI: return new Ferrari();
+      default: throw new IllegalArgumentException("Model not supported.");
+    }
+  }
+}
+```
+
+Now on the client code we can create differentes types of cars(Ford or Ferrari) using the factory class.
+
+```java
+Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
+Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
+LOGGER.info(car1.getDescription());
+LOGGER.info(car2.getDescription());
+```
+
+Program output:
+
+```java
+This is Ford.
+This Ferrari.
+```
+## Applicability
+
+Use the Simple Factory pattern when you only care about the creation of a object, not how to create and manage it.
+
+## Disadvantages:
+
+The code becomes more complicated than it should be. 
+
+## Related patterns
+
+[Factory Method](https://java-design-patterns.com/patterns/factory-method/)
+[Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
+[Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
+
+

From badf0c6b8c89b7a28e2d2aa3432cc3b5ac30a69d Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Thu, 3 Sep 2020 22:08:54 +0100
Subject: [PATCH 089/254] - README.md is added - Change the name to factory is
 done - Local variable type inference is used

---
 factory/README.md                             | 128 ++++++++++++++++++
 factory/etc/factory.urm.puml                  |  35 +++++
 factory/pom.xml                               |  41 ++++++
 .../main/java/com/iluwatar/factory/App.java   |  51 +++++++
 .../main/java/com/iluwatar/factory/Car.java   |  10 ++
 .../com/iluwatar/factory/CarsFactory.java     |  25 ++++
 .../java/com/iluwatar/factory/Ferrari.java    |  14 ++
 .../main/java/com/iluwatar/factory/Ford.java  |  14 ++
 .../java/com/iluwatar/factory/AppTest.java    |  14 ++
 .../com/iluwatar/factory/CarsFactoryTest.java |  15 ++
 10 files changed, 347 insertions(+)
 create mode 100644 factory/README.md
 create mode 100644 factory/etc/factory.urm.puml
 create mode 100644 factory/pom.xml
 create mode 100644 factory/src/main/java/com/iluwatar/factory/App.java
 create mode 100644 factory/src/main/java/com/iluwatar/factory/Car.java
 create mode 100644 factory/src/main/java/com/iluwatar/factory/CarsFactory.java
 create mode 100644 factory/src/main/java/com/iluwatar/factory/Ferrari.java
 create mode 100644 factory/src/main/java/com/iluwatar/factory/Ford.java
 create mode 100644 factory/src/test/java/com/iluwatar/factory/AppTest.java
 create mode 100644 factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java

diff --git a/factory/README.md b/factory/README.md
new file mode 100644
index 000000000..42c8838a3
--- /dev/null
+++ b/factory/README.md
@@ -0,0 +1,128 @@
+---
+layout: pattern
+title: Factory
+folder: factory
+permalink: /patterns/factory/
+categories: Creational
+tags:
+ - Gang of Four
+---
+
+## Also known as
+
+* Simple Factory
+* Static Factory Method
+
+## Intent
+
+Providing a static method encapsulated in a class called factory, in order to hide the implementation logic and makes client code focus on usage rather then initialization new objects.
+
+## Explanation
+
+Real world example
+
+> Lets say we have a web application connected to SQLServer, but now we want to switch to Oracle. To do so without modifying existing source code, we need to implements Simple Factory pattern, in which a static method can be invoked to create connection to a given database.
+
+Wikipedia says
+
+> Factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class.
+
+**Programmatic Example**
+
+We have an interface "Car" and tow implementations "Ford" and "Ferrari".
+
+```java
+/**
+ * Car interface.
+ */
+public interface Car {
+  
+  public String getDescription();
+  
+}
+
+/**
+ * Ford implementation.
+ */
+public class Ford implements Car {
+
+  static final String DESCRIPTION = "This is Ford.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+
+/**
+ * Ferrari implementation.
+ */
+public class Ferrari implements Car {
+   
+  static final String DESCRIPTION = "This is Ferrari.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+```
+
+Then we have the static method "getCar" to create car objects encapsulated in the factory class "CarSimpleFactory".
+
+```java
+/**
+ * Factory of cars.
+ */
+public class CarSimpleFactory {
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  static enum CarType {
+    FORD, FERRARI
+  }
+  
+  /**
+   * Factory method takes as parameter a car type and initiate the appropriate class.
+   */
+  public static Car getCar(CarType type) {
+    switch (type) {
+      case FORD: return new Ford();
+      case FERRARI: return new Ferrari();
+      default: throw new IllegalArgumentException("Model not supported.");
+    }
+  }
+}
+```
+
+Now on the client code we can create differentes types of cars(Ford or Ferrari) using the factory class.
+
+```java
+Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
+Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
+LOGGER.info(car1.getDescription());
+LOGGER.info(car2.getDescription());
+```
+
+Program output:
+
+```java
+This is Ford.
+This Ferrari.
+```
+## Applicability
+
+Use the Simple Factory pattern when you only care about the creation of a object, not how to create and manage it.
+
+## Disadvantages:
+
+The code becomes more complicated than it should be. 
+
+## Related patterns
+
+[Factory Method](https://java-design-patterns.com/patterns/factory-method/)
+[Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
+[Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
+
+
diff --git a/factory/etc/factory.urm.puml b/factory/etc/factory.urm.puml
new file mode 100644
index 000000000..9eded6328
--- /dev/null
+++ b/factory/etc/factory.urm.puml
@@ -0,0 +1,35 @@
+@startuml
+package com.iluwatar.factory {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  interface Car {
+    + getDescription() : String {abstract}
+  }
+  class CarsFactory {
+    + CarsFactory()
+    + getCar(type : CarType) : Car {static}
+  }
+  ~enum CarType {
+    + FERRARI {static}
+    + FORD {static}
+    + valueOf(name : String) : CarType {static}
+    + values() : CarType[] {static}
+  }
+  class Ferrari {
+    ~ DESCRIPTION : String {static}
+    + Ferrari()
+    + getDescription() : String
+  }
+  class Ford {
+    ~ DESCRIPTION : String {static}
+    + Ford()
+    + getDescription() : String
+  }
+}
+CarType ..+ CarsFactory
+Ferrari ..|> Car 
+Ford ..|> Car 
+@enduml
\ No newline at end of file
diff --git a/factory/pom.xml b/factory/pom.xml
new file mode 100644
index 000000000..fbca994a7
--- /dev/null
+++ b/factory/pom.xml
@@ -0,0 +1,41 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>factory</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+    </dependency>
+  </dependencies>
+  <build>
+		<plugins>
+			<!-- Maven assembly plugin is invoked with default setting which we have 
+				in parent pom and specifying the class having main method -->
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-assembly-plugin</artifactId>
+				<executions>
+					<execution>
+						<configuration>
+							<archive>
+								<manifest>
+									<mainClass>com.iluwatar.factory.App</mainClass>
+								</manifest>
+							</archive>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>
\ No newline at end of file
diff --git a/factory/src/main/java/com/iluwatar/factory/App.java b/factory/src/main/java/com/iluwatar/factory/App.java
new file mode 100644
index 000000000..13f217646
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/App.java
@@ -0,0 +1,51 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.factory;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * Factory is an object for creating other objects, it providing Providing a static method to 
+ * create and return objects of varying classes, in order to hide the implementation logic 
+ * and makes client code focus on usage rather then objects initialization and management.
+ * 
+ * <p>In this example the CarFactory is the factory class and it provides a static method to 
+ * create different cars.
+ */
+
+public class App {
+  
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+  
+  /**
+   * Program main entry point.
+   */
+  public static void main(String[] args) {
+    var car1 = CarsFactory.getCar(CarsFactory.CarType.FORD);
+    var car2 = CarsFactory.getCar(CarsFactory.CarType.FERRARI);
+    LOGGER.info(car1.getDescription());
+    LOGGER.info(car2.getDescription());
+  }
+}
diff --git a/factory/src/main/java/com/iluwatar/factory/Car.java b/factory/src/main/java/com/iluwatar/factory/Car.java
new file mode 100644
index 000000000..6f564233c
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/Car.java
@@ -0,0 +1,10 @@
+package com.iluwatar.factory;
+
+/**
+ * Car interface.
+ */
+public interface Car {
+  
+  public String getDescription();
+  
+}
diff --git a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
new file mode 100644
index 000000000..01ad157ca
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
@@ -0,0 +1,25 @@
+package com.iluwatar.factory;
+
+/**
+ * Factory of cars.
+ */
+public class CarsFactory {
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  static enum CarType {
+    FORD, FERRARI
+  }
+  
+  /**
+   * Factory method takes as parameter a car type and initiate the appropriate class.
+   */
+  public static Car getCar(CarType type) {
+    switch (type) {
+      case FORD: return new Ford();
+      case FERRARI: return new Ferrari();
+      default: throw new IllegalArgumentException("Model not supported.");
+    }
+  }
+}
diff --git a/factory/src/main/java/com/iluwatar/factory/Ferrari.java b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
new file mode 100644
index 000000000..590167f81
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
@@ -0,0 +1,14 @@
+package com.iluwatar.factory;
+
+/**
+ * Ferrari implementation.
+ */
+public class Ferrari implements Car {
+   
+  static final String DESCRIPTION = "This is Ferrari.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
diff --git a/factory/src/main/java/com/iluwatar/factory/Ford.java b/factory/src/main/java/com/iluwatar/factory/Ford.java
new file mode 100644
index 000000000..13ae7a49e
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/Ford.java
@@ -0,0 +1,14 @@
+package com.iluwatar.factory;
+
+/**
+ * Ford implementation.
+ */
+public class Ford implements Car {
+
+  static final String DESCRIPTION = "This is Ford.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
diff --git a/factory/src/test/java/com/iluwatar/factory/AppTest.java b/factory/src/test/java/com/iluwatar/factory/AppTest.java
new file mode 100644
index 000000000..d29ffb6a2
--- /dev/null
+++ b/factory/src/test/java/com/iluwatar/factory/AppTest.java
@@ -0,0 +1,14 @@
+package com.iluwatar.factory;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import org.junit.jupiter.api.Test;
+
+class AppTest {
+
+	@Test
+	void shouldExecuteWithoutExceptions() {
+		assertDoesNotThrow(() -> App.main(new String[]{}));
+	}
+
+}
diff --git a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
new file mode 100644
index 000000000..eae75919a
--- /dev/null
+++ b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
@@ -0,0 +1,15 @@
+package com.iluwatar.factory;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+import org.junit.jupiter.api.Test;
+
+class CarsFactoryTest {
+
+	@Test
+	void shouldReturnFerrariInstance() {
+		final var ferrari = CarsFactory.getCar(CarsFactory.CarType.FERRARI);
+		assertTrue(ferrari instanceof Ferrari);
+	}
+
+}

From 2bb252e08f3dbf74a0a11cd443fc9ac8241fa53a Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Thu, 3 Sep 2020 22:41:55 +0100
Subject: [PATCH 090/254] Clean the code

---
 simple-factory/README.md                      | 128 ------------------
 simple-factory/etc/simple-factory.urm.puml    |  35 -----
 simple-factory/pom.xml                        |  41 ------
 .../java/com/iluwatar/simplefactory/App.java  |  42 ------
 .../java/com/iluwatar/simplefactory/Car.java  |  10 --
 .../simplefactory/CarSimpleFactory.java       |  25 ----
 .../com/iluwatar/simplefactory/Ferrari.java   |  14 --
 .../java/com/iluwatar/simplefactory/Ford.java |  14 --
 .../com/iluwatar/simplefactory/AppTest.java   |  14 --
 .../simplefactory/CarSimpleFactoryTest.java   |  15 --
 10 files changed, 338 deletions(-)
 delete mode 100644 simple-factory/README.md
 delete mode 100644 simple-factory/etc/simple-factory.urm.puml
 delete mode 100644 simple-factory/pom.xml
 delete mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
 delete mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
 delete mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
 delete mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
 delete mode 100644 simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
 delete mode 100644 simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
 delete mode 100644 simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java

diff --git a/simple-factory/README.md b/simple-factory/README.md
deleted file mode 100644
index 1d069a6dd..000000000
--- a/simple-factory/README.md
+++ /dev/null
@@ -1,128 +0,0 @@
----
-layout: pattern
-title: Simple Factory
-folder: simple-factory
-permalink: /patterns/simple-factory/
-categories: Creational
-tags:
- - Gang of Four
----
-
-## Also known as
-
-* Factory
-* Static Factory Method
-
-## Intent
-
-Providing a static method encapsulated in a class called factory, in order to hide the implementation logic and makes client code focus on usage rather then initialization new objects.
-
-## Explanation
-
-Real world example
-
-> Lets say we have a web application connected to SQLServer, but now we want to switch to Oracle. To do so without modifying existing source code, we need to implements Simple Factory pattern, in which a static method can be invoked to create connection to a given database.
-
-Wikipedia says
-
-> Factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class.
-
-**Programmatic Example**
-
-We have an interface "Car" and tow implementations "Ford" and "Ferrari".
-
-```java
-/**
- * Car interface.
- */
-public interface Car {
-  
-  public String getDescription();
-  
-}
-
-/**
- * Ford implementation.
- */
-public class Ford implements Car {
-
-  static final String DESCRIPTION = "This is Ford.";
-
-  @Override
-  public String getDescription() {
-    return DESCRIPTION;
-  }
-}
-
-/**
- * Ferrari implementation.
- */
-public class Ferrari implements Car {
-   
-  static final String DESCRIPTION = "This is Ferrari.";
-
-  @Override
-  public String getDescription() {
-    return DESCRIPTION;
-  }
-}
-```
-
-Then we have the static method "getCar" to create car objects encapsulated in the factory class "CarSimpleFactory".
-
-```java
-/**
- * Factory of cars.
- */
-public class CarSimpleFactory {
-  
-  /**
-   * Enumeration for different types of cars.
-   */
-  static enum CarType {
-    FORD, FERRARI
-  }
-  
-  /**
-   * Factory method takes as parameter a car type and initiate the appropriate class.
-   */
-  public static Car getCar(CarType type) {
-    switch (type) {
-      case FORD: return new Ford();
-      case FERRARI: return new Ferrari();
-      default: throw new IllegalArgumentException("Model not supported.");
-    }
-  }
-}
-```
-
-Now on the client code we can create differentes types of cars(Ford or Ferrari) using the factory class.
-
-```java
-Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
-Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
-LOGGER.info(car1.getDescription());
-LOGGER.info(car2.getDescription());
-```
-
-Program output:
-
-```java
-This is Ford.
-This Ferrari.
-```
-## Applicability
-
-Use the Simple Factory pattern when you only care about the creation of a object, not how to create and manage it.
-
-## Disadvantages:
-
-The code becomes more complicated than it should be. 
-
-## Related patterns
-
-[Factory Method](https://java-design-patterns.com/patterns/factory-method/)
-[Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
-[Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
-
-
diff --git a/simple-factory/etc/simple-factory.urm.puml b/simple-factory/etc/simple-factory.urm.puml
deleted file mode 100644
index 77fee4b5b..000000000
--- a/simple-factory/etc/simple-factory.urm.puml
+++ /dev/null
@@ -1,35 +0,0 @@
-@startuml
-package com.iluwatar.simplefactory {
-  class App {
-    - LOGGER : Logger {static}
-    + App()
-    + main(args : String[]) {static}
-  }
-  interface Car {
-    + getDescription() : String {abstract}
-  }
-  class CarSimpleFactory {
-    + CarSimpleFactory()
-    + getCar(type : CarType) : Car {static}
-  }
-  ~enum CarType {
-    + FERRARI {static}
-    + FORD {static}
-    + valueOf(name : String) : CarType {static}
-    + values() : CarType[] {static}
-  }
-  class Ferrari {
-    ~ DESCRIPTION : String {static}
-    + Ferrari()
-    + getDescription() : String
-  }
-  class Ford {
-    ~ DESCRIPTION : String {static}
-    + Ford()
-    + getDescription() : String
-  }
-}
-CarType ..+ CarSimpleFactory
-Ferrari ..|> Car 
-Ford ..|> Car 
-@enduml
\ No newline at end of file
diff --git a/simple-factory/pom.xml b/simple-factory/pom.xml
deleted file mode 100644
index ca7c0547d..000000000
--- a/simple-factory/pom.xml
+++ /dev/null
@@ -1,41 +0,0 @@
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion>
-  <parent>
-    <groupId>com.iluwatar</groupId>
-    <artifactId>java-design-patterns</artifactId>
-    <version>1.24.0-SNAPSHOT</version>
-  </parent>
-  <artifactId>simple-factory</artifactId>
-  <dependencies>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-engine</artifactId>
-      <scope>test</scope>
-    </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-    </dependency>
-  </dependencies>
-  <build>
-		<plugins>
-			<!-- Maven assembly plugin is invoked with default setting which we have 
-				in parent pom and specifying the class having main method -->
-			<plugin>
-				<groupId>org.apache.maven.plugins</groupId>
-				<artifactId>maven-assembly-plugin</artifactId>
-				<executions>
-					<execution>
-						<configuration>
-							<archive>
-								<manifest>
-									<mainClass>com.iluwatar.simplefactory.App</mainClass>
-								</manifest>
-							</archive>
-						</configuration>
-					</execution>
-				</executions>
-			</plugin>
-		</plugins>
-	</build>
-</project>
\ No newline at end of file
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
deleted file mode 100644
index f13566ba6..000000000
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/App.java
+++ /dev/null
@@ -1,42 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.simplefactory;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-public class App {
-  
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-  
-  /**
-   * Program main entry point.
-   */
-  public static void main(String[] args) {
-    Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
-    Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
-    LOGGER.info(car1.getDescription());
-    LOGGER.info(car2.getDescription());
-  }
-}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
deleted file mode 100644
index b87070040..000000000
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Car.java
+++ /dev/null
@@ -1,10 +0,0 @@
-package com.iluwatar.simplefactory;
-
-/**
- * Car interface.
- */
-public interface Car {
-  
-  public String getDescription();
-  
-}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
deleted file mode 100644
index 911fe610f..000000000
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/CarSimpleFactory.java
+++ /dev/null
@@ -1,25 +0,0 @@
-package com.iluwatar.simplefactory;
-
-/**
- * Factory of cars.
- */
-public class CarSimpleFactory {
-  
-  /**
-   * Enumeration for different types of cars.
-   */
-  static enum CarType {
-    FORD, FERRARI
-  }
-  
-  /**
-   * Factory method takes as parameter a car type and initiate the appropriate class.
-   */
-  public static Car getCar(CarType type) {
-    switch (type) {
-      case FORD: return new Ford();
-      case FERRARI: return new Ferrari();
-      default: throw new IllegalArgumentException("Model not supported.");
-    }
-  }
-}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
deleted file mode 100644
index d6e865182..000000000
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ferrari.java
+++ /dev/null
@@ -1,14 +0,0 @@
-package com.iluwatar.simplefactory;
-
-/**
- * Ferrari implementation.
- */
-public class Ferrari implements Car {
-   
-  static final String DESCRIPTION = "This is Ferrari.";
-
-  @Override
-  public String getDescription() {
-    return DESCRIPTION;
-  }
-}
diff --git a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java b/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
deleted file mode 100644
index 19cbea2ae..000000000
--- a/simple-factory/src/main/java/com/iluwatar/simplefactory/Ford.java
+++ /dev/null
@@ -1,14 +0,0 @@
-package com.iluwatar.simplefactory;
-
-/**
- * Ford implementation.
- */
-public class Ford implements Car {
-
-  static final String DESCRIPTION = "This is Ford.";
-
-  @Override
-  public String getDescription() {
-    return DESCRIPTION;
-  }
-}
diff --git a/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java b/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
deleted file mode 100644
index 4465b3b8c..000000000
--- a/simple-factory/src/test/java/com/iluwatar/simplefactory/AppTest.java
+++ /dev/null
@@ -1,14 +0,0 @@
-package com.iluwatar.simplefactory;
-
-import static org.junit.jupiter.api.Assertions.*;
-
-import org.junit.jupiter.api.Test;
-
-class AppTest {
-
-	@Test
-	void shouldExecuteWithoutExceptions() {
-		assertDoesNotThrow(() -> App.main(new String[]{}));
-	}
-
-}
diff --git a/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java b/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java
deleted file mode 100644
index 394b652b6..000000000
--- a/simple-factory/src/test/java/com/iluwatar/simplefactory/CarSimpleFactoryTest.java
+++ /dev/null
@@ -1,15 +0,0 @@
-package com.iluwatar.simplefactory;
-
-import static org.junit.jupiter.api.Assertions.*;
-
-import org.junit.jupiter.api.Test;
-
-class CarSimpleFactoryTest {
-
-	@Test
-	void shouldReturnFerrariInstance() {
-		final var ferrari = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
-		assertTrue(ferrari instanceof Ferrari);
-	}
-
-}

From 8b26452c75a8529ef3407d643fa33a1a2799a825 Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Thu, 3 Sep 2020 22:58:15 +0100
Subject: [PATCH 091/254] bug fixing

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index cc59a846a..da3084ab2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -195,7 +195,7 @@
         <module>arrange-act-assert</module>
         <module>transaction-script</module>
         <module>filterer</module>
-        <module>simple-factory</module>
+        <module>factory</module>
     </modules>
 
     <repositories>

From bd48d6ce1046c51aaf93ee48f4887ba4b04e89fd Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Fri, 4 Sep 2020 17:31:50 +0300
Subject: [PATCH 092/254] refactor

---
 .../com/iluwatar/abstractfactory/App.java     | 82 +++++--------------
 .../com/iluwatar/abstractfactory/Kingdom.java | 38 +++++++++
 .../abstractfactory/AbstractFactoryTest.java  | 47 ++++++-----
 3 files changed, 88 insertions(+), 79 deletions(-)
 create mode 100644 abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 6cdaf865f..71af19b37 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -23,12 +23,8 @@
 
 package com.iluwatar.abstractfactory;
 
-import com.iluwatar.abstractfactory.App.FactoryMaker.KingdomType;
 import lombok.Getter;
-import lombok.Setter;
 import lombok.extern.slf4j.Slf4j;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that
@@ -45,55 +41,10 @@ import org.slf4j.LoggerFactory;
  * both concrete implementations to create a king, a castle and an army.
  */
 @Slf4j
-public class App {
+public class App implements Runnable {
 
-  @Setter
   @Getter
-  private King king;
-
-  @Setter
-  @Getter
-  private Castle castle;
-
-  @Setter
-  @Getter
-  private Army army;
-
-  /**
-   * Creates kingdom.
-   */
-  public void createKingdom(final KingdomFactory factory) {
-    setKing(factory.createKing());
-    setCastle(factory.createCastle());
-    setArmy(factory.createArmy());
-  }
-
-  /**
-   * The factory of kingdom factories.
-   */
-  public static class FactoryMaker {
-
-    /**
-     * Enumeration for the different types of Kingdoms.
-     */
-    public enum KingdomType {
-      ELF, ORC
-    }
-
-    /**
-     * The factory method to create KingdomFactory concrete objects.
-     */
-    public static KingdomFactory makeFactory(KingdomType type) {
-      switch (type) {
-        case ELF:
-          return new ElfKingdomFactory();
-        case ORC:
-          return new OrcKingdomFactory();
-        default:
-          throw new IllegalArgumentException("KingdomType not supported.");
-      }
-    }
-  }
+  private final Kingdom kingdom = new Kingdom();
 
   /**
    * Program entry point.
@@ -101,19 +52,30 @@ public class App {
    * @param args command line args
    */
   public static void main(String[] args) {
-
     var app = new App();
+  }
 
+  @Override
+  public void run() {
     log.info("Elf Kingdom");
-    app.createKingdom(FactoryMaker.makeFactory(KingdomType.ELF));
-    log.info(app.getArmy().getDescription());
-    log.info(app.getCastle().getDescription());
-    log.info(app.getKing().getDescription());
+    createKingdom(Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ELF));
+    log.info(kingdom.getArmy().getDescription());
+    log.info(kingdom.getCastle().getDescription());
+    log.info(kingdom.getKing().getDescription());
 
     log.info("Orc Kingdom");
-    app.createKingdom(FactoryMaker.makeFactory(KingdomType.ORC));
-    log.info(app.getArmy().getDescription());
-    log.info(app.getCastle().getDescription());
-    log.info(app.getKing().getDescription());
+    createKingdom(Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ORC));
+    log.info(kingdom.getArmy().getDescription());
+    log.info(kingdom.getCastle().getDescription());
+    log.info(kingdom.getKing().getDescription());
+  }
+
+  /**
+   * Creates kingdom.
+   */
+  public void createKingdom(final KingdomFactory factory) {
+    kingdom.setKing(factory.createKing());
+    kingdom.setCastle(factory.createCastle());
+    kingdom.setArmy(factory.createArmy());
   }
 }
\ No newline at end of file
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
new file mode 100644
index 000000000..6e24005ab
--- /dev/null
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
@@ -0,0 +1,38 @@
+package com.iluwatar.abstractfactory;
+
+import lombok.Data;
+
+@Data
+public class Kingdom {
+
+  private King king;
+  private Castle castle;
+  private Army army;
+
+  /**
+   * The factory of kingdom factories.
+   */
+  public static class FactoryMaker {
+
+    /**
+     * Enumeration for the different types of Kingdoms.
+     */
+    public enum KingdomType {
+      ELF, ORC
+    }
+
+    /**
+     * The factory method to create KingdomFactory concrete objects.
+     */
+    public static KingdomFactory makeFactory(KingdomType type) {
+      switch (type) {
+        case ELF:
+          return new ElfKingdomFactory();
+        case ORC:
+          return new OrcKingdomFactory();
+        default:
+          throw new IllegalArgumentException("KingdomType not supported.");
+      }
+    }
+  }
+}
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index 1506844cf..db6fd04ee 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -23,14 +23,13 @@
 
 package com.iluwatar.abstractfactory;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-import com.iluwatar.abstractfactory.App.FactoryMaker;
-import com.iluwatar.abstractfactory.App.FactoryMaker.KingdomType;
+import lombok.val;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
 /**
  * Test for abstract factory.
  */
@@ -42,19 +41,21 @@ public class AbstractFactoryTest {
 
   @BeforeEach
   public void setUp() {
-    elfFactory = FactoryMaker.makeFactory(KingdomType.ELF);
-    orcFactory = FactoryMaker.makeFactory(KingdomType.ORC);
+    elfFactory = Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ELF);
+    orcFactory = Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ORC);
   }
 
   @Test
   public void king() {
     app.createKingdom(elfFactory);
-    final var elfKing = app.getKing();
+    val kingdom = app.getKingdom();
+
+    val elfKing = kingdom.getKing();
     assertTrue(elfKing instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription());
 
     app.createKingdom(orcFactory);
-    final var orcKing = app.getKing();
+    val orcKing = kingdom.getKing();
     assertTrue(orcKing instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription());
   }
@@ -62,12 +63,14 @@ public class AbstractFactoryTest {
   @Test
   public void castle() {
     app.createKingdom(elfFactory);
-    final var elfCastle = app.getCastle();
+    val kingdom = app.getKingdom();
+
+    val elfCastle = kingdom.getCastle();
     assertTrue(elfCastle instanceof ElfCastle);
     assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription());
 
     app.createKingdom(orcFactory);
-    final var orcCastle = app.getCastle();
+    val orcCastle = kingdom.getCastle();
     assertTrue(orcCastle instanceof OrcCastle);
     assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription());
   }
@@ -75,12 +78,14 @@ public class AbstractFactoryTest {
   @Test
   public void army() {
     app.createKingdom(elfFactory);
-    final var elfArmy = app.getArmy();
+    val kingdom = app.getKingdom();
+
+    val elfArmy = kingdom.getArmy();
     assertTrue(elfArmy instanceof ElfArmy);
     assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription());
 
     app.createKingdom(orcFactory);
-    final var orcArmy = app.getArmy();
+    val orcArmy = kingdom.getArmy();
     assertTrue(orcArmy instanceof OrcArmy);
     assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription());
   }
@@ -88,9 +93,11 @@ public class AbstractFactoryTest {
   @Test
   public void createElfKingdom() {
     app.createKingdom(elfFactory);
-    final var king = app.getKing();
-    final var castle = app.getCastle();
-    final var army = app.getArmy();
+    val kingdom = app.getKingdom();
+
+    val king = kingdom.getKing();
+    val castle = kingdom.getCastle();
+    val army = kingdom.getArmy();
     assertTrue(king instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, king.getDescription());
     assertTrue(castle instanceof ElfCastle);
@@ -102,9 +109,11 @@ public class AbstractFactoryTest {
   @Test
   public void createOrcKingdom() {
     app.createKingdom(orcFactory);
-    final var king = app.getKing();
-    final var castle = app.getCastle();
-    final var army = app.getArmy();
+    val kingdom = app.getKingdom();
+
+    val king = kingdom.getKing();
+    val castle = kingdom.getCastle();
+    val army = kingdom.getArmy();
     assertTrue(king instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, king.getDescription());
     assertTrue(castle instanceof OrcCastle);

From 6caf78e4e57fe98fde7813f9129437f530022f63 Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Fri, 4 Sep 2020 21:21:51 +0100
Subject: [PATCH 093/254] updates :

- Using lambda expression to create cars
- Using spaces instead of tabs in pom.xml
---
 factory/README.md                             | 45 ++++++++++++-------
 factory/pom.xml                               | 42 ++++++++---------
 .../main/java/com/iluwatar/factory/App.java   |  4 +-
 .../java/com/iluwatar/factory/CarType.java    | 22 +++++++++
 .../com/iluwatar/factory/CarsFactory.java     | 13 +-----
 .../com/iluwatar/factory/CarsFactoryTest.java |  2 +-
 6 files changed, 76 insertions(+), 52 deletions(-)
 create mode 100644 factory/src/main/java/com/iluwatar/factory/CarType.java

diff --git a/factory/README.md b/factory/README.md
index 42c8838a3..62478e4a9 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -68,41 +68,52 @@ public class Ferrari implements Car {
 }
 ```
 
+Enumeration above represents types of cars that we support(Ford and Ferrari).
+
+```java
+public enum CarType {
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  FORD(Ford::new), 
+  FERRARI(Ferrari::new);
+  
+  private final Supplier<Car> constructor; 
+  
+  CarType(Supplier<Car> constructor) {
+    this.constructor = constructor;
+  }
+  
+  public Supplier<Car> getConstructor() {
+    return this.constructor;
+  }
+}
+```
 Then we have the static method "getCar" to create car objects encapsulated in the factory class "CarSimpleFactory".
 
 ```java
 /**
  * Factory of cars.
  */
-public class CarSimpleFactory {
-  
-  /**
-   * Enumeration for different types of cars.
-   */
-  static enum CarType {
-    FORD, FERRARI
-  }
+public class CarsFactory {
   
   /**
    * Factory method takes as parameter a car type and initiate the appropriate class.
    */
   public static Car getCar(CarType type) {
-    switch (type) {
-      case FORD: return new Ford();
-      case FERRARI: return new Ferrari();
-      default: throw new IllegalArgumentException("Model not supported.");
-    }
+    return type.getConstructor().get();
   }
 }
 ```
 
-Now on the client code we can create differentes types of cars(Ford or Ferrari) using the factory class.
+Now on the client code we can create different types of cars using the factory class.
 
 ```java
-Car car1 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FORD);
-Car car2 = CarSimpleFactory.getCar(CarSimpleFactory.CarType.FERRARI);
+var car1 = CarsFactory.getCar(CarType.FORD);
+var car2 = CarsFactory.getCar(CarType.FERRARI);
 LOGGER.info(car1.getDescription());
-LOGGER.info(car2.getDescription());
+LOGGER.info(car2.getDescription());;
 ```
 
 Program output:
diff --git a/factory/pom.xml b/factory/pom.xml
index fbca994a7..2a422db90 100644
--- a/factory/pom.xml
+++ b/factory/pom.xml
@@ -1,23 +1,25 @@
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion>
-  <parent>
-    <groupId>com.iluwatar</groupId>
-    <artifactId>java-design-patterns</artifactId>
-    <version>1.24.0-SNAPSHOT</version>
-  </parent>
-  <artifactId>factory</artifactId>
-  <dependencies>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-engine</artifactId>
-      <scope>test</scope>
-    </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-    </dependency>
-  </dependencies>
-  <build>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>com.iluwatar</groupId>
+		<artifactId>java-design-patterns</artifactId>
+		<version>1.24.0-SNAPSHOT</version>
+	</parent>
+	<artifactId>factory</artifactId>
+	<dependencies>
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter-engine</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>junit</groupId>
+			<artifactId>junit</artifactId>
+		</dependency>
+	</dependencies>
+	<build>
 		<plugins>
 			<!-- Maven assembly plugin is invoked with default setting which we have 
 				in parent pom and specifying the class having main method -->
diff --git a/factory/src/main/java/com/iluwatar/factory/App.java b/factory/src/main/java/com/iluwatar/factory/App.java
index 13f217646..22c50d86d 100644
--- a/factory/src/main/java/com/iluwatar/factory/App.java
+++ b/factory/src/main/java/com/iluwatar/factory/App.java
@@ -43,8 +43,8 @@ public class App {
    * Program main entry point.
    */
   public static void main(String[] args) {
-    var car1 = CarsFactory.getCar(CarsFactory.CarType.FORD);
-    var car2 = CarsFactory.getCar(CarsFactory.CarType.FERRARI);
+    var car1 = CarsFactory.getCar(CarType.FORD);
+    var car2 = CarsFactory.getCar(CarType.FERRARI);
     LOGGER.info(car1.getDescription());
     LOGGER.info(car2.getDescription());
   }
diff --git a/factory/src/main/java/com/iluwatar/factory/CarType.java b/factory/src/main/java/com/iluwatar/factory/CarType.java
new file mode 100644
index 000000000..5878025bd
--- /dev/null
+++ b/factory/src/main/java/com/iluwatar/factory/CarType.java
@@ -0,0 +1,22 @@
+package com.iluwatar.factory;
+
+import java.util.function.Supplier;
+
+public enum CarType {
+  
+  /**
+   * Enumeration for different types of cars.
+   */
+  FORD(Ford::new), 
+  FERRARI(Ferrari::new);
+  
+  private final Supplier<Car> constructor; 
+  
+  CarType(Supplier<Car> constructor) {
+    this.constructor = constructor;
+  }
+  
+  public Supplier<Car> getConstructor() {
+    return this.constructor;
+  }
+}
diff --git a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
index 01ad157ca..76b83d0be 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
@@ -5,21 +5,10 @@ package com.iluwatar.factory;
  */
 public class CarsFactory {
   
-  /**
-   * Enumeration for different types of cars.
-   */
-  static enum CarType {
-    FORD, FERRARI
-  }
-  
   /**
    * Factory method takes as parameter a car type and initiate the appropriate class.
    */
   public static Car getCar(CarType type) {
-    switch (type) {
-      case FORD: return new Ford();
-      case FERRARI: return new Ferrari();
-      default: throw new IllegalArgumentException("Model not supported.");
-    }
+    return type.getConstructor().get();
   }
 }
diff --git a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
index eae75919a..fc823c6d4 100644
--- a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
@@ -8,7 +8,7 @@ class CarsFactoryTest {
 
 	@Test
 	void shouldReturnFerrariInstance() {
-		final var ferrari = CarsFactory.getCar(CarsFactory.CarType.FERRARI);
+		final var ferrari = CarsFactory.getCar(CarType.FERRARI);
 		assertTrue(ferrari instanceof Ferrari);
 	}
 

From b3ef214cd62f80368698929f8814099c0ad0a3ad Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Fri, 4 Sep 2020 22:02:19 +0100
Subject: [PATCH 094/254] Change tabs to spaces in pom.xml

---
 factory/pom.xml | 82 ++++++++++++++++++++++++-------------------------
 1 file changed, 41 insertions(+), 41 deletions(-)

diff --git a/factory/pom.xml b/factory/pom.xml
index 2a422db90..fff262458 100644
--- a/factory/pom.xml
+++ b/factory/pom.xml
@@ -1,43 +1,43 @@
 <project xmlns="http://maven.apache.org/POM/4.0.0"
-	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-	<modelVersion>4.0.0</modelVersion>
-	<parent>
-		<groupId>com.iluwatar</groupId>
-		<artifactId>java-design-patterns</artifactId>
-		<version>1.24.0-SNAPSHOT</version>
-	</parent>
-	<artifactId>factory</artifactId>
-	<dependencies>
-		<dependency>
-			<groupId>org.junit.jupiter</groupId>
-			<artifactId>junit-jupiter-engine</artifactId>
-			<scope>test</scope>
-		</dependency>
-		<dependency>
-			<groupId>junit</groupId>
-			<artifactId>junit</artifactId>
-		</dependency>
-	</dependencies>
-	<build>
-		<plugins>
-			<!-- Maven assembly plugin is invoked with default setting which we have 
-				in parent pom and specifying the class having main method -->
-			<plugin>
-				<groupId>org.apache.maven.plugins</groupId>
-				<artifactId>maven-assembly-plugin</artifactId>
-				<executions>
-					<execution>
-						<configuration>
-							<archive>
-								<manifest>
-									<mainClass>com.iluwatar.factory.App</mainClass>
-								</manifest>
-							</archive>
-						</configuration>
-					</execution>
-				</executions>
-			</plugin>
-		</plugins>
-	</build>
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+ <modelVersion>4.0.0</modelVersion>
+ <parent>
+ <groupId>com.iluwatar</groupId>
+ <artifactId>java-design-patterns</artifactId>
+ <version>1.24.0-SNAPSHOT</version>
+ </parent>
+ <artifactId>factory</artifactId>
+ <dependencies>
+ <dependency>
+  <groupId>org.junit.jupiter</groupId>
+  <artifactId>junit-jupiter-engine</artifactId>
+  <scope>test</scope>
+ </dependency>
+ <dependency>
+ <groupId>junit</groupId>
+  <artifactId>junit</artifactId>
+ </dependency>
+ </dependencies>
+ <build>
+ <plugins>
+  <!-- Maven assembly plugin is invoked with default setting which we have 
+  in parent pom and specifying the class having main method -->
+  <plugin>
+  <groupId>org.apache.maven.plugins</groupId>
+  <artifactId>maven-assembly-plugin</artifactId>
+  <executions>
+   <execution>
+   <configuration>
+    <archive>
+    <manifest>
+     <mainClass>com.iluwatar.factory.App</mainClass>
+    </manifest>
+    </archive>
+   </configuration>
+   </execution>
+  </executions>
+  </plugin>
+ </plugins>
+ </build>
 </project>
\ No newline at end of file

From bf41b1d9c98782dbb3368c44cbba934c257f483a Mon Sep 17 00:00:00 2001
From: Samil Ayoub <ssamil.ayoub@gmail.com>
Date: Sat, 5 Sep 2020 18:39:28 +0100
Subject: [PATCH 095/254] Updates README.md:

- Adding class diagram
- Adding Pros and Cons
- replace "" with ''
---
 factory/README.md           |  17 +++++++++++------
 factory/etc/factory.urm.png | Bin 0 -> 25438 bytes
 2 files changed, 11 insertions(+), 6 deletions(-)
 create mode 100644 factory/etc/factory.urm.png

diff --git a/factory/README.md b/factory/README.md
index 62478e4a9..9ab61b579 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -29,7 +29,7 @@ Wikipedia says
 
 **Programmatic Example**
 
-We have an interface "Car" and tow implementations "Ford" and "Ferrari".
+We have an interface 'Car' and tow implementations 'Ford' and 'Ferrari'.
 
 ```java
 /**
@@ -68,7 +68,7 @@ public class Ferrari implements Car {
 }
 ```
 
-Enumeration above represents types of cars that we support(Ford and Ferrari).
+Enumeration above represents types of cars that we support (Ford and Ferrari).
 
 ```java
 public enum CarType {
@@ -90,7 +90,7 @@ public enum CarType {
   }
 }
 ```
-Then we have the static method "getCar" to create car objects encapsulated in the factory class "CarSimpleFactory".
+Then we have the static method 'getCar' to create car objects encapsulated in the factory class 'CarSimpleFactory'.
 
 ```java
 /**
@@ -122,13 +122,18 @@ Program output:
 This is Ford.
 This Ferrari.
 ```
-## Applicability
+## Class Diagram
+![alt text](./etc/factory.urm.png "Factory pattern class diagram")
 
+## Applicability
 Use the Simple Factory pattern when you only care about the creation of a object, not how to create and manage it.
 
-## Disadvantages:
+## Pros
+* Allows keeping all objects creation in one place and avoid of spreading 'new' key value across codebase.
+* Allows to writs loosely coupled code. Some of its main advantages include better testability, easy-to-understand code, swappable components, scalability and isolated features.
 
-The code becomes more complicated than it should be. 
+## Cons
+* The code becomes more complicated than it should be. 
 
 ## Related patterns
 
diff --git a/factory/etc/factory.urm.png b/factory/etc/factory.urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ba39a571c4efd3d5cfd45854f0d26c843fafd8e
GIT binary patch
literal 25438
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

literal 0
HcmV?d00001


From 2e36a11e24b09f43c0a6983f29191596d50c18e9 Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Sun, 6 Sep 2020 11:42:39 +0300
Subject: [PATCH 096/254] remove lombok, related to #1503

---
 abstract-factory/pom.xml                      |  5 ---
 .../com/iluwatar/abstractfactory/App.java     | 14 +++++---
 .../com/iluwatar/abstractfactory/Kingdom.java | 27 ++++++++++++--
 .../abstractfactory/AbstractFactoryTest.java  | 35 +++++++++----------
 4 files changed, 51 insertions(+), 30 deletions(-)

diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index e10a9436f..2328c60a8 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -31,11 +31,6 @@
 			<artifactId>junit-jupiter-engine</artifactId>
 			<scope>test</scope>
 		</dependency>
-		<dependency>
-			<groupId>org.projectlombok</groupId>
-			<artifactId>lombok</artifactId>
-			<version>1.18.12</version>
-		</dependency>
 	</dependencies>
 	<build>
 		<plugins>
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 71af19b37..bebf5c894 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -23,8 +23,10 @@
 
 package com.iluwatar.abstractfactory;
 
-import lombok.Getter;
-import lombok.extern.slf4j.Slf4j;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.util.List;
 
 /**
  * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that
@@ -40,12 +42,16 @@ import lombok.extern.slf4j.Slf4j;
  * and its implementations ( {@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses
  * both concrete implementations to create a king, a castle and an army.
  */
-@Slf4j
 public class App implements Runnable {
 
-  @Getter
+  private static Logger log = LoggerFactory.getLogger(App.class);
+
   private final Kingdom kingdom = new Kingdom();
 
+  public Kingdom getKingdom() {
+    return kingdom;
+  }
+
   /**
    * Program entry point.
    *
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
index 6e24005ab..82fa0b368 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
@@ -1,14 +1,35 @@
 package com.iluwatar.abstractfactory;
 
-import lombok.Data;
-
-@Data
 public class Kingdom {
 
   private King king;
   private Castle castle;
   private Army army;
 
+  public King getKing() {
+    return king;
+  }
+
+  public Castle getCastle() {
+    return castle;
+  }
+
+  public Army getArmy() {
+    return army;
+  }
+
+  public void setKing(King king) {
+    this.king = king;
+  }
+
+  public void setCastle(Castle castle) {
+    this.castle = castle;
+  }
+
+  public void setArmy(Army army) {
+    this.army = army;
+  }
+
   /**
    * The factory of kingdom factories.
    */
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index db6fd04ee..54c3b68f1 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -23,7 +23,6 @@
 
 package com.iluwatar.abstractfactory;
 
-import lombok.val;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
@@ -48,14 +47,14 @@ public class AbstractFactoryTest {
   @Test
   public void king() {
     app.createKingdom(elfFactory);
-    val kingdom = app.getKingdom();
+    final var kingdom = app.getKingdom();
 
-    val elfKing = kingdom.getKing();
+    final var elfKing = kingdom.getKing();
     assertTrue(elfKing instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription());
 
     app.createKingdom(orcFactory);
-    val orcKing = kingdom.getKing();
+    final var orcKing = kingdom.getKing();
     assertTrue(orcKing instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription());
   }
@@ -63,14 +62,14 @@ public class AbstractFactoryTest {
   @Test
   public void castle() {
     app.createKingdom(elfFactory);
-    val kingdom = app.getKingdom();
+    final var kingdom = app.getKingdom();
 
-    val elfCastle = kingdom.getCastle();
+    final var elfCastle = kingdom.getCastle();
     assertTrue(elfCastle instanceof ElfCastle);
     assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription());
 
     app.createKingdom(orcFactory);
-    val orcCastle = kingdom.getCastle();
+    final var orcCastle = kingdom.getCastle();
     assertTrue(orcCastle instanceof OrcCastle);
     assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription());
   }
@@ -78,14 +77,14 @@ public class AbstractFactoryTest {
   @Test
   public void army() {
     app.createKingdom(elfFactory);
-    val kingdom = app.getKingdom();
+    final var kingdom = app.getKingdom();
 
-    val elfArmy = kingdom.getArmy();
+    final var elfArmy = kingdom.getArmy();
     assertTrue(elfArmy instanceof ElfArmy);
     assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription());
 
     app.createKingdom(orcFactory);
-    val orcArmy = kingdom.getArmy();
+    final var orcArmy = kingdom.getArmy();
     assertTrue(orcArmy instanceof OrcArmy);
     assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription());
   }
@@ -93,11 +92,11 @@ public class AbstractFactoryTest {
   @Test
   public void createElfKingdom() {
     app.createKingdom(elfFactory);
-    val kingdom = app.getKingdom();
+    final var kingdom = app.getKingdom();
 
-    val king = kingdom.getKing();
-    val castle = kingdom.getCastle();
-    val army = kingdom.getArmy();
+    final var king = kingdom.getKing();
+    final var castle = kingdom.getCastle();
+    final var army = kingdom.getArmy();
     assertTrue(king instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, king.getDescription());
     assertTrue(castle instanceof ElfCastle);
@@ -109,11 +108,11 @@ public class AbstractFactoryTest {
   @Test
   public void createOrcKingdom() {
     app.createKingdom(orcFactory);
-    val kingdom = app.getKingdom();
+    final var kingdom = app.getKingdom();
 
-    val king = kingdom.getKing();
-    val castle = kingdom.getCastle();
-    val army = kingdom.getArmy();
+    final var king = kingdom.getKing();
+    final var castle = kingdom.getCastle();
+    final var army = kingdom.getArmy();
     assertTrue(king instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, king.getDescription());
     assertTrue(castle instanceof OrcCastle);

From 87cf6b791cefcba99a5894141078464d2805c870 Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Sun, 6 Sep 2020 11:48:40 +0300
Subject: [PATCH 097/254] refactor

---
 .../com/iluwatar/abstractfactory/App.java     | 16 ++++++------
 .../abstractfactory/AbstractFactoryTest.java  | 25 ++++++-------------
 2 files changed, 16 insertions(+), 25 deletions(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index bebf5c894..05aa8d118 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -26,8 +26,6 @@ package com.iluwatar.abstractfactory;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import java.util.List;
-
 /**
  * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that
  * have a common theme without specifying their concrete classes. In normal usage, the client
@@ -64,13 +62,13 @@ public class App implements Runnable {
   @Override
   public void run() {
     log.info("Elf Kingdom");
-    createKingdom(Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ELF));
+    createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     log.info(kingdom.getArmy().getDescription());
     log.info(kingdom.getCastle().getDescription());
     log.info(kingdom.getKing().getDescription());
 
     log.info("Orc Kingdom");
-    createKingdom(Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ORC));
+    createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     log.info(kingdom.getArmy().getDescription());
     log.info(kingdom.getCastle().getDescription());
     log.info(kingdom.getKing().getDescription());
@@ -78,10 +76,12 @@ public class App implements Runnable {
 
   /**
    * Creates kingdom.
+   * @param kingdomType
    */
-  public void createKingdom(final KingdomFactory factory) {
-    kingdom.setKing(factory.createKing());
-    kingdom.setCastle(factory.createCastle());
-    kingdom.setArmy(factory.createArmy());
+  public void createKingdom(final Kingdom.FactoryMaker.KingdomType kingdomType) {
+    final KingdomFactory kingdomFactory = Kingdom.FactoryMaker.makeFactory(kingdomType);
+    kingdom.setKing(kingdomFactory.createKing());
+    kingdom.setCastle(kingdomFactory.createCastle());
+    kingdom.setArmy(kingdomFactory.createArmy());
   }
 }
\ No newline at end of file
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index 54c3b68f1..17c09be88 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -23,7 +23,6 @@
 
 package com.iluwatar.abstractfactory;
 
-import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -35,25 +34,17 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 public class AbstractFactoryTest {
 
   private final App app = new App();
-  private KingdomFactory elfFactory;
-  private KingdomFactory orcFactory;
-
-  @BeforeEach
-  public void setUp() {
-    elfFactory = Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ELF);
-    orcFactory = Kingdom.FactoryMaker.makeFactory(Kingdom.FactoryMaker.KingdomType.ORC);
-  }
 
   @Test
   public void king() {
-    app.createKingdom(elfFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
     final var elfKing = kingdom.getKing();
     assertTrue(elfKing instanceof ElfKing);
     assertEquals(ElfKing.DESCRIPTION, elfKing.getDescription());
 
-    app.createKingdom(orcFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     final var orcKing = kingdom.getKing();
     assertTrue(orcKing instanceof OrcKing);
     assertEquals(OrcKing.DESCRIPTION, orcKing.getDescription());
@@ -61,14 +52,14 @@ public class AbstractFactoryTest {
 
   @Test
   public void castle() {
-    app.createKingdom(elfFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
     final var elfCastle = kingdom.getCastle();
     assertTrue(elfCastle instanceof ElfCastle);
     assertEquals(ElfCastle.DESCRIPTION, elfCastle.getDescription());
 
-    app.createKingdom(orcFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     final var orcCastle = kingdom.getCastle();
     assertTrue(orcCastle instanceof OrcCastle);
     assertEquals(OrcCastle.DESCRIPTION, orcCastle.getDescription());
@@ -76,14 +67,14 @@ public class AbstractFactoryTest {
 
   @Test
   public void army() {
-    app.createKingdom(elfFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
     final var elfArmy = kingdom.getArmy();
     assertTrue(elfArmy instanceof ElfArmy);
     assertEquals(ElfArmy.DESCRIPTION, elfArmy.getDescription());
 
-    app.createKingdom(orcFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     final var orcArmy = kingdom.getArmy();
     assertTrue(orcArmy instanceof OrcArmy);
     assertEquals(OrcArmy.DESCRIPTION, orcArmy.getDescription());
@@ -91,7 +82,7 @@ public class AbstractFactoryTest {
 
   @Test
   public void createElfKingdom() {
-    app.createKingdom(elfFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
     final var king = kingdom.getKing();
@@ -107,7 +98,7 @@ public class AbstractFactoryTest {
 
   @Test
   public void createOrcKingdom() {
-    app.createKingdom(orcFactory);
+    app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     final var kingdom = app.getKingdom();
 
     final var king = kingdom.getKing();

From 29eecfd0489c79c8c86850039e55b3bff008d377 Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Sun, 6 Sep 2020 11:52:16 +0300
Subject: [PATCH 098/254] forgot to run the App

---
 .../src/main/java/com/iluwatar/abstractfactory/App.java          | 1 +
 1 file changed, 1 insertion(+)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 05aa8d118..2d49768ec 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -57,6 +57,7 @@ public class App implements Runnable {
    */
   public static void main(String[] args) {
     var app = new App();
+    app.run();
   }
 
   @Override

From bab48efd7c24ee74ba4ad599d08b9942814a57ca Mon Sep 17 00:00:00 2001
From: Vladislav Golubinov <vlad.vdlald@gmail.com>
Date: Sun, 6 Sep 2020 12:01:48 +0300
Subject: [PATCH 099/254] fix style

---
 .../src/main/java/com/iluwatar/abstractfactory/App.java         | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 2d49768ec..baf2d7569 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -77,7 +77,7 @@ public class App implements Runnable {
 
   /**
    * Creates kingdom.
-   * @param kingdomType
+   * @param kingdomType type of Kingdom
    */
   public void createKingdom(final Kingdom.FactoryMaker.KingdomType kingdomType) {
     final KingdomFactory kingdomFactory = Kingdom.FactoryMaker.makeFactory(kingdomType);

From d72206ba72736013b24803d703fffcab4fa1c686 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 6 Sep 2020 16:35:57 +0000
Subject: [PATCH 100/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e64d4c15b..4a214d770 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-130-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-131-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -264,6 +264,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4" width="100px;" alt=""/><br /><sub><b>Fedor Skvorcov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fedorskvorcov" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4" width="100px;" alt=""/><br /><sub><b>samilAyoub</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=samilAyoub" title="Code">💻</a></td>
   </tr>
 </table>
 

From b9db3c476306cde8090756490cb006bf56200bb8 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 6 Sep 2020 16:35:58 +0000
Subject: [PATCH 101/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index e0ef0200b..6b8a654ae 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1185,6 +1185,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "samilAyoub",
+      "name": "samilAyoub",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/61546990?v=4",
+      "profile": "https://github.com/samilAyoub",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 3205dc2cf022c9c0678413b42dd06992565b6e66 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 6 Sep 2020 16:37:03 +0000
Subject: [PATCH 102/254] docs: update README.md [skip ci]

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a11ce5f89..f0966bfd9 100644
--- a/README.md
+++ b/README.md
@@ -245,7 +245,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/nishant"><img src="https://avatars2.githubusercontent.com/u/15331971?v=4" width="100px;" alt=""/><br /><sub><b>Nishant Arora</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nishant" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/raja-peeyush-kumar-singh"><img src="https://avatars0.githubusercontent.com/u/5496024?v=4" width="100px;" alt=""/><br /><sub><b>Peeyush</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=raja-peeyush-kumar-singh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aravening" title="Reviewed Pull Requests">👀</a></td>
   </tr>
 </table>
 

From 8d6738b729b9e953e987149fd2f0e6440dba7b60 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 6 Sep 2020 16:37:04 +0000
Subject: [PATCH 103/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 7f632c157..5a1c8f57c 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1082,7 +1082,8 @@
       "avatar_url": "https://avatars1.githubusercontent.com/u/10645273?v=4",
       "profile": "https://github.com/ravening",
       "contributions": [
-        "code"
+        "code",
+        "review"
       ]
     }
   ],

From a1da1e4973d82ebf958175b34b27710a8ec0b715 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 6 Sep 2020 19:46:13 +0300
Subject: [PATCH 104/254] Cleanup factory

---
 factory/README.md                             | 51 +++++++------------
 .../main/java/com/iluwatar/factory/Car.java   |  2 +-
 2 files changed, 20 insertions(+), 33 deletions(-)

diff --git a/factory/README.md b/factory/README.md
index 9ab61b579..5fd97ccae 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -15,35 +15,31 @@ tags:
 
 ## Intent
 
-Providing a static method encapsulated in a class called factory, in order to hide the implementation logic and makes client code focus on usage rather then initialization new objects.
+Providing a static method encapsulated in a class called factory, in order to hide the 
+implementation logic and makes client code focus on usage rather then initialization new objects.
 
 ## Explanation
 
 Real world example
 
-> Lets say we have a web application connected to SQLServer, but now we want to switch to Oracle. To do so without modifying existing source code, we need to implements Simple Factory pattern, in which a static method can be invoked to create connection to a given database.
+> Lets say we have a web application connected to SQLServer, but now we want to switch to Oracle. To 
+> do so without modifying existing source code, we need to implements Simple Factory pattern, in 
+> which a static method can be invoked to create connection to a given database.
 
 Wikipedia says
 
-> Factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class.
+> Factory is an object for creating other objects – formally a factory is a function or method that 
+> returns objects of a varying prototype or class.
 
 **Programmatic Example**
 
-We have an interface 'Car' and tow implementations 'Ford' and 'Ferrari'.
+We have an interface `Car` and two implementations `Ford` and `Ferrari`.
 
 ```java
-/**
- * Car interface.
- */
 public interface Car {
-  
-  public String getDescription();
-  
+  String getDescription();
 }
 
-/**
- * Ford implementation.
- */
 public class Ford implements Car {
 
   static final String DESCRIPTION = "This is Ford.";
@@ -54,9 +50,6 @@ public class Ford implements Car {
   }
 }
 
-/**
- * Ferrari implementation.
- */
 public class Ferrari implements Car {
    
   static final String DESCRIPTION = "This is Ferrari.";
@@ -68,14 +61,11 @@ public class Ferrari implements Car {
 }
 ```
 
-Enumeration above represents types of cars that we support (Ford and Ferrari).
+Enumeration above represents types of cars that we support (`Ford` and `Ferrari`).
 
 ```java
 public enum CarType {
   
-  /**
-   * Enumeration for different types of cars.
-   */
   FORD(Ford::new), 
   FERRARI(Ferrari::new);
   
@@ -90,17 +80,12 @@ public enum CarType {
   }
 }
 ```
-Then we have the static method 'getCar' to create car objects encapsulated in the factory class 'CarSimpleFactory'.
+Then we have the static method `getCar` to create car objects encapsulated in the factory class 
+`CarSimpleFactory`.
 
 ```java
-/**
- * Factory of cars.
- */
 public class CarsFactory {
   
-  /**
-   * Factory method takes as parameter a car type and initiate the appropriate class.
-   */
   public static Car getCar(CarType type) {
     return type.getConstructor().get();
   }
@@ -122,17 +107,21 @@ Program output:
 This is Ford.
 This Ferrari.
 ```
+
 ## Class Diagram
+
 ![alt text](./etc/factory.urm.png "Factory pattern class diagram")
 
 ## Applicability
-Use the Simple Factory pattern when you only care about the creation of a object, not how to create and manage it.
 
-## Pros
+Use the Simple Factory pattern when you only care about the creation of a object, not how to create 
+and manage it.
+
+Pros
 * Allows keeping all objects creation in one place and avoid of spreading 'new' key value across codebase.
 * Allows to writs loosely coupled code. Some of its main advantages include better testability, easy-to-understand code, swappable components, scalability and isolated features.
 
-## Cons
+Cons
 * The code becomes more complicated than it should be. 
 
 ## Related patterns
@@ -140,5 +129,3 @@ Use the Simple Factory pattern when you only care about the creation of a object
 [Factory Method](https://java-design-patterns.com/patterns/factory-method/)
 [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
 [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
-
-
diff --git a/factory/src/main/java/com/iluwatar/factory/Car.java b/factory/src/main/java/com/iluwatar/factory/Car.java
index 6f564233c..d1d622b9b 100644
--- a/factory/src/main/java/com/iluwatar/factory/Car.java
+++ b/factory/src/main/java/com/iluwatar/factory/Car.java
@@ -5,6 +5,6 @@ package com.iluwatar.factory;
  */
 public interface Car {
   
-  public String getDescription();
+  String getDescription();
   
 }

From 8b5f532a50923cb334b06dd7507126f3572af4d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 6 Sep 2020 19:55:38 +0300
Subject: [PATCH 105/254] Update README.md

---
 factory/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/factory/README.md b/factory/README.md
index 5fd97ccae..8983f393c 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -118,10 +118,12 @@ Use the Simple Factory pattern when you only care about the creation of a object
 and manage it.
 
 Pros
+
 * Allows keeping all objects creation in one place and avoid of spreading 'new' key value across codebase.
 * Allows to writs loosely coupled code. Some of its main advantages include better testability, easy-to-understand code, swappable components, scalability and isolated features.
 
 Cons
+
 * The code becomes more complicated than it should be. 
 
 ## Related patterns

From ef326ee77e03077714f38df36f92ffa58ebaffa9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 6 Sep 2020 19:56:07 +0300
Subject: [PATCH 106/254] Update README.md

---
 factory/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/factory/README.md b/factory/README.md
index 8983f393c..a1b6208fd 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -128,6 +128,6 @@ Cons
 
 ## Related patterns
 
-[Factory Method](https://java-design-patterns.com/patterns/factory-method/)
-[Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
-[Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
+* [Factory Method](https://java-design-patterns.com/patterns/factory-method/)
+* [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
+* [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)

From f6942cf18dab21b354be69a3853c12f6d21b7a60 Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Thu, 10 Sep 2020 02:57:56 +0530
Subject: [PATCH 107/254] #1313 Add Separated Interface design pattern

---
 separated-interface/README.md                 | 119 ++++++++++++++++++
 separated-interface/etc/class_diagram.png     | Bin 0 -> 32651 bytes
 .../etc/separated-interface.urm.puml          |  36 ++++++
 separated-interface/pom.xml                   |  71 +++++++++++
 .../com/iluwatar/separatedinterface/App.java  |  61 +++++++++
 .../invoice/InvoiceGenerator.java             |  28 +++++
 .../invoice/TaxCalculator.java                |  30 +++++
 .../separatedinterface/taxes/DomesticTax.java |  40 ++++++
 .../separatedinterface/taxes/ForeignTax.java  |  40 ++++++
 .../iluwatar/separatedinterface/AppTest.java  |  41 ++++++
 .../invoice/InvoiceGeneratorTest.java         |  25 ++++
 .../taxes/DomesticTaxTest.java                |  18 +++
 .../taxes/ForeignTaxTest.java                 |  18 +++
 13 files changed, 527 insertions(+)
 create mode 100644 separated-interface/README.md
 create mode 100644 separated-interface/etc/class_diagram.png
 create mode 100644 separated-interface/etc/separated-interface.urm.puml
 create mode 100644 separated-interface/pom.xml
 create mode 100644 separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
 create mode 100644 separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
 create mode 100644 separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
 create mode 100644 separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java
 create mode 100644 separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java
 create mode 100644 separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
 create mode 100644 separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
 create mode 100644 separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
 create mode 100644 separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java

diff --git a/separated-interface/README.md b/separated-interface/README.md
new file mode 100644
index 000000000..11ad4a978
--- /dev/null
+++ b/separated-interface/README.md
@@ -0,0 +1,119 @@
+---
+layout: pattern
+title: Separated Interface
+folder: separated-interface
+permalink: /patterns/separated-interface/
+categories: Architectural
+tags:
+ - Decoupling
+---
+
+
+## Intent
+Separate the interface definition and implementation in different packages. This allows the client to be completly unaware of the implementation.
+
+## Explanation
+
+Real world example
+
+> An Invoice generator may be created with ability to use different Tax calculators that may be added in the invoice depending upon type of purchase, region etc.         
+
+In plain words
+
+> Separated interface pattern encourages to keep the implementations of an interface decoupled from the client and its definition, so the client is not dependent on the implementation.
+
+A client code may abstract some specific functionality to an interface, and define the definition of the interface as an SPI. Another package may implement this interface definition with a concrete logic, which will be injected into the client code at runtime (with a third class, injecting the implementation in the client) or at compile time (using Plugin pattern with some configurable file).
+
+**Programmatic Example**
+
+**Client** An Invoice generator class accepts the cost of the product and calculates the total amount payable inclusive of tax
+
+```java
+public class InvoiceGenerator {
+
+  private final TaxCalculator taxCalculator;
+
+  private final double amount;
+
+  public InvoiceGenerator(double amount, TaxCalculator taxCalculator) {
+    this.amount = amount;
+    this.taxCalculator = taxCalculator;
+  }
+
+  public double getAmountWithTax() {
+    return amount + taxCalculator.calculate(amount);
+  }
+
+}
+```
+The tax calculation logic is delegated to the ```TaxCalculator``` interface
+
+```java
+
+public interface TaxCalculator {
+
+  double calculate(double amount);
+
+}
+
+```
+
+**Implementation package**
+In another package (which the client is completely unaware of) there exist multiple implementations of the ```TaxCalculator``` interface
+```ForeignTax``` which levies 60% tax for international products.
+```java
+public class ForeignTax implements TaxCalculator {
+
+  public static final double TAX_PERCENTAGE = 60;
+
+  @Override
+  public double calculate(double amount) {
+    return amount * TAX_PERCENTAGE / 100.0;
+  }
+
+}
+```
+
+```DomesticTax``` which levies 20% tax for international products.
+```java
+public class DomesticTax implements TaxCalculator {
+
+  public static final double TAX_PERCENTAGE = 20;
+
+  @Override
+  public double calculate(double amount) {
+    return amount * TAX_PERCENTAGE / 100.0;
+  }
+
+}
+```
+
+These both implementations are instantiated and injected in the client class by the ```App.java``` class
+
+```java
+    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTax());
+
+    LOGGER.info("Foreign Tax applied: {}", "" + internationalProductInvoice.getAmountWithTax());
+
+    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTax());
+
+    LOGGER.info("Domestic Tax applied: {}", "" + domesticProductInvoice.getAmountWithTax());
+```
+
+## Class diagram
+![alt text](./etc/class_diagram.png "Separated Interface")
+
+## Applicability
+Use the Separated interface pattern when
+
+* You are developing a framework package, and your framework needs to call some application code through interfaces.
+* You have separate packages implementing the functionalities which may be plugged in your client code at runtime or compile-time.
+* Your code resides in a layer that is not allowed to call the interface implementation layer by rule. For example, a domain layer needs to call a data mapper.
+
+## Tutorial 
+
+* [Separated Interface Tutorial](https://www.youtube.com/watch?v=d3k-hOA7k2Y)
+
+## Credits
+
+* [Martin Fowler](https://www.martinfowler.com/eaaCatalog/separatedInterface.html)
diff --git a/separated-interface/etc/class_diagram.png b/separated-interface/etc/class_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0edbac8dac3cd5a0f1dd174fd1cfaa0bbc78e72
GIT binary patch
literal 32651
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
UJAQrvtRC`AO5t(-qZe=f5BA4?t^fc4

literal 0
HcmV?d00001

diff --git a/separated-interface/etc/separated-interface.urm.puml b/separated-interface/etc/separated-interface.urm.puml
new file mode 100644
index 000000000..a406acd40
--- /dev/null
+++ b/separated-interface/etc/separated-interface.urm.puml
@@ -0,0 +1,36 @@
+@startuml
+package com.iluwatar.separatedinterface {
+  class App {
+    - LOGGER : Logger {static}
+    + PRODUCT_COST : double {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+}
+package com.iluwatar.separatedinterface.taxes {
+  class DomesticTax {
+    + TAX_PERCENTAGE : double {static}
+    + DomesticTax()
+    + calculate(amount : double) : double
+  }
+  class ForeignTax {
+    + TAX_PERCENTAGE : double {static}
+    + ForeignTax()
+    + calculate(amount : double) : double
+  }
+}
+package com.iluwatar.separatedinterface.invoice {
+  class InvoiceGenerator {
+    - amount : double
+    - taxCalculator : TaxCalculator
+    + InvoiceGenerator(amount : double, taxCalculator : TaxCalculator)
+    + getAmountWithTax() : double
+  }
+  interface TaxCalculator {
+    + calculate(double) : double {abstract}
+  }
+}
+InvoiceGenerator -->  "-taxCalculator" TaxCalculator
+DomesticTax ..|> TaxCalculator 
+ForeignTax ..|> TaxCalculator 
+@enduml
\ No newline at end of file
diff --git a/separated-interface/pom.xml b/separated-interface/pom.xml
new file mode 100644
index 000000000..da7584a93
--- /dev/null
+++ b/separated-interface/pom.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>separated-interface</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-params</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <executions>
+          <execution>
+            <configuration>
+              <archive>
+                <manifest>
+                  <mainClass>com.iluwatar.separatedinterface.App</mainClass>
+                </manifest>
+              </archive>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
new file mode 100644
index 000000000..e0a385c9e
--- /dev/null
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
@@ -0,0 +1,61 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.separatedinterface;
+
+import com.iluwatar.separatedinterface.invoice.InvoiceGenerator;
+import com.iluwatar.separatedinterface.taxes.DomesticTax;
+import com.iluwatar.separatedinterface.taxes.ForeignTax;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * <p>The Strategy pattern (also known as the policy pattern) is a software design pattern that
+ * enables an algorithm's behavior to be selected at runtime.</p>
+ *
+ * <p>Before Java 8 the Strategies needed to be separate classes forcing the developer
+ * to write lots of boilerplate code. With modern Java it is easy to pass behavior with method
+ * references and lambdas making the code shorter and more readable.</p>
+ *
+ */
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  public static final double PRODUCT_COST = 50.0;
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    //Create the invoice generator with product cost as 50 and foreign product tax
+    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTax());
+    LOGGER.info("Foreign Tax applied: {}", "" + internationalProductInvoice.getAmountWithTax());
+
+    //Create the invoice generator with product cost as 50 and domestic product tax
+    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTax());
+    LOGGER.info("Domestic Tax applied: {}", "" + domesticProductInvoice.getAmountWithTax());
+  }
+}
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
new file mode 100644
index 000000000..f73ee32d8
--- /dev/null
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
@@ -0,0 +1,28 @@
+package com.iluwatar.separatedinterface.invoice;
+
+/**
+ * InvoiceGenerator class generates an invoice, accepting the product cost and calculating the total
+ * price payable inclusive tax (calculated by {@link TaxCalculator})
+ */
+public class InvoiceGenerator {
+
+  /**
+   * The TaxCalculator interface to calculate the payable tax.
+   */
+  private final TaxCalculator taxCalculator;
+
+  /**
+   * The base product amount without tax.
+   */
+  private final double amount;
+
+  public InvoiceGenerator(double amount, TaxCalculator taxCalculator) {
+    this.amount = amount;
+    this.taxCalculator = taxCalculator;
+  }
+
+  public double getAmountWithTax() {
+    return amount + taxCalculator.calculate(amount);
+  }
+
+}
\ No newline at end of file
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
new file mode 100644
index 000000000..aa4b81a84
--- /dev/null
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
@@ -0,0 +1,30 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.separatedinterface.invoice;
+
+public interface TaxCalculator {
+
+  double calculate(double amount);
+
+}
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java
new file mode 100644
index 000000000..ebe0e306e
--- /dev/null
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java
@@ -0,0 +1,40 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.separatedinterface.taxes;
+
+import com.iluwatar.separatedinterface.invoice.TaxCalculator;
+
+/**
+ * TaxCalculator for Domestic goods with 20% tax.
+ */
+public class DomesticTax implements TaxCalculator {
+
+  public static final double TAX_PERCENTAGE = 20;
+
+  @Override
+  public double calculate(double amount) {
+    return amount * TAX_PERCENTAGE / 100.0;
+  }
+
+}
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java
new file mode 100644
index 000000000..583f70d3b
--- /dev/null
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java
@@ -0,0 +1,40 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.separatedinterface.taxes;
+
+import com.iluwatar.separatedinterface.invoice.TaxCalculator;
+
+/**
+ * TaxCalculator for foreign goods with 60% tax.
+ */
+public class ForeignTax implements TaxCalculator {
+
+  public static final double TAX_PERCENTAGE = 60;
+
+  @Override
+  public double calculate(double amount) {
+    return amount * TAX_PERCENTAGE / 100.0;
+  }
+
+}
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
new file mode 100644
index 000000000..4114f9bb7
--- /dev/null
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
@@ -0,0 +1,41 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.separatedinterface;
+
+import org.junit.jupiter.api.Test;
+
+import com.iluwatar.separatedinterface.App;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+/**
+ * Application test.
+ */
+class AppTest {
+
+  @Test
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
+}
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
new file mode 100644
index 000000000..669fb1452
--- /dev/null
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
@@ -0,0 +1,25 @@
+package com.iluwatar.separatedinterface.invoice;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+import static org.mockito.Mockito.*;
+
+public class InvoiceGeneratorTest {
+
+  private InvoiceGenerator target;
+
+  @Test
+  public void testGenerateTax() {
+    var productCost = 50.0;
+    var tax = 10.0;
+    TaxCalculator taxCalculatorMock = mock(TaxCalculator.class);
+    doReturn(tax).when(taxCalculatorMock).calculate(productCost);
+
+    target = new InvoiceGenerator(productCost, taxCalculatorMock);
+
+    Assertions.assertEquals(target.getAmountWithTax(), productCost + tax);
+    verify(taxCalculatorMock, times(1)).calculate(productCost);
+  }
+
+}
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
new file mode 100644
index 000000000..e562586c2
--- /dev/null
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
@@ -0,0 +1,18 @@
+package com.iluwatar.separatedinterface.taxes;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+public class DomesticTaxTest {
+
+  private DomesticTax target;
+
+  @Test
+  public void testTaxCaluclation(){
+    target = new DomesticTax();
+
+    var tax=target.calculate(100.0);
+    Assertions.assertEquals(tax,20.0);
+  }
+
+}
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
new file mode 100644
index 000000000..86bf39e80
--- /dev/null
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
@@ -0,0 +1,18 @@
+package com.iluwatar.separatedinterface.taxes;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+public class ForeignTaxTest {
+
+  private ForeignTax target;
+
+  @Test
+  public void testTaxCaluclation(){
+    target = new ForeignTax();
+
+    var tax=target.calculate(100.0);
+    Assertions.assertEquals(tax,60.0);
+  }
+
+}

From 7fd7735527c987a3f65b6c4ec57acdb1d305c3bc Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Thu, 10 Sep 2020 03:10:58 +0530
Subject: [PATCH 108/254] #1313 Add separated-interface module to parent pom

---
 pom.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/pom.xml b/pom.xml
index da3084ab2..102668588 100644
--- a/pom.xml
+++ b/pom.xml
@@ -196,6 +196,7 @@
         <module>transaction-script</module>
         <module>filterer</module>
         <module>factory</module>
+        <module>separated-interface</module>
     </modules>
 
     <repositories>

From a2967c5a40bacc06f60b699507c3b66c60da6699 Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Thu, 10 Sep 2020 03:22:00 +0530
Subject: [PATCH 109/254] #1313 Add documentation and license header

---
 separated-interface/README.md                 |  2 +-
 .../com/iluwatar/separatedinterface/App.java  | 12 ++++-----
 .../invoice/InvoiceGenerator.java             | 25 ++++++++++++++++++-
 .../invoice/InvoiceGeneratorTest.java         | 23 +++++++++++++++++
 .../taxes/DomesticTaxTest.java                | 23 +++++++++++++++++
 .../taxes/ForeignTaxTest.java                 | 23 +++++++++++++++++
 6 files changed, 100 insertions(+), 8 deletions(-)

diff --git a/separated-interface/README.md b/separated-interface/README.md
index 11ad4a978..b26d5c7da 100644
--- a/separated-interface/README.md
+++ b/separated-interface/README.md
@@ -10,7 +10,7 @@ tags:
 
 
 ## Intent
-Separate the interface definition and implementation in different packages. This allows the client to be completly unaware of the implementation.
+Separate the interface definition and implementation in different packages. This allows the client to be completely unaware of the implementation.
 
 ## Explanation
 
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
index e0a385c9e..67eeec054 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
@@ -30,13 +30,13 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * <p>The Strategy pattern (also known as the policy pattern) is a software design pattern that
- * enables an algorithm's behavior to be selected at runtime.</p>
- *
- * <p>Before Java 8 the Strategies needed to be separate classes forcing the developer
- * to write lots of boilerplate code. With modern Java it is easy to pass behavior with method
- * references and lambdas making the code shorter and more readable.</p>
+ * <p>The Separated Interface pattern encourages to separate the interface definition and
+ * implementation in different packages. This allows the client to be completely unaware of the
+ * implementation.</p>
  *
+ * <p>In this class the {@link InvoiceGenerator} class is injected with different instances of
+ * {@link com.iluwatar.separatedinterface.invoice.TaxCalculator} implementations located in separate
+ * packages, to receive different responses for both of the implementations.</p>
  */
 public class App {
 
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
index f73ee32d8..c17ed5ac5 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
@@ -1,8 +1,31 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.separatedinterface.invoice;
 
 /**
  * InvoiceGenerator class generates an invoice, accepting the product cost and calculating the total
- * price payable inclusive tax (calculated by {@link TaxCalculator})
+ * price payable inclusive tax (calculated by {@link TaxCalculator}).
  */
 public class InvoiceGenerator {
 
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
index 669fb1452..ac75d3b70 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.separatedinterface.invoice;
 
 import org.junit.jupiter.api.Assertions;
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
index e562586c2..d070d8b0a 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.separatedinterface.taxes;
 
 import org.junit.jupiter.api.Assertions;
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
index 86bf39e80..df184276c 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.separatedinterface.taxes;
 
 import org.junit.jupiter.api.Assertions;

From 93aa1046aa6b277ed29a6a498271ee6da9c63a7e Mon Sep 17 00:00:00 2001
From: Mike <admin@xiaod.info>
Date: Fri, 11 Sep 2020 09:34:11 +0800
Subject: [PATCH 110/254] translate decorator and factory method pattern in
 Chinese

---
 zh/decorator/README.md      | 139 ++++++++++++++++++++++++++++++++++++
 zh/factory-method/README.md |  88 +++++++++++++++++++++++
 2 files changed, 227 insertions(+)
 create mode 100644 zh/decorator/README.md
 create mode 100644 zh/factory-method/README.md

diff --git a/zh/decorator/README.md b/zh/decorator/README.md
new file mode 100644
index 000000000..ef23eda0b
--- /dev/null
+++ b/zh/decorator/README.md
@@ -0,0 +1,139 @@
+---
+layout: pattern
+title: Decorator
+folder: decorator
+permalink: /patterns/decorator/
+categories: Structural
+tags:
+ - Gang Of Four
+ - Extensibility
+---
+
+## 或称
+包装器
+
+## 目的
+动态的为对象附加额外的职责。装饰器为子类提供了灵活的替代方案，以扩展功能。
+
+## 解释
+
+真实世界例子
+
+> 附近的山丘上住着一个愤怒的巨魔。通常它是徒手的，但有时它有武器。为了武装巨魔不必创建新的巨魔，而是用合适的武器动态的装饰它。
+
+通俗的说
+
+> 装饰者模式让你可以在运行时通过把对象包装进一个装饰类对象中来动态的改变一个对象的行为。
+
+维基百科说
+
+> 在面向对象的编程中，装饰器模式是一种设计模式，它允许将行为静态或动态地添加到单个对象中，而不会影响同一类中其他对象的行为。装饰器模式通常对于遵守单一责任原则很有用，因为它允许将功能划分到具有唯一关注领域的类之间。
+
+**程序示例**
+
+以巨魔的为例。首先我有有一个简单的巨魔，实现了巨魔接口。
+
+程序mple. First of all we have a simple troll implementing the troll interface
+
+```java
+public interface Troll {
+  void attack();
+  int getAttackPower();
+  void fleeBattle();
+}
+
+public class SimpleTroll implements Troll {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTroll.class);
+
+  @Override
+  public void attack() {
+    LOGGER.info("The troll tries to grab you!");
+  }
+
+  @Override
+  public int getAttackPower() {
+    return 10;
+  }
+
+  @Override
+  public void fleeBattle() {
+    LOGGER.info("The troll shrieks in horror and runs away!");
+  }
+}
+```
+
+下面我们想为巨魔添加球棒。我们可以用装饰者来动态的实现。
+
+```java
+public class ClubbedTroll implements Troll {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(ClubbedTroll.class);
+
+  private final Troll decorated;
+
+  public ClubbedTroll(Troll decorated) {
+    this.decorated = decorated;
+  }
+
+  @Override
+  public void attack() {
+    decorated.attack();
+    LOGGER.info("The troll swings at you with a club!");
+  }
+
+  @Override
+  public int getAttackPower() {
+    return decorated.getAttackPower() + 10;
+  }
+
+  @Override
+  public void fleeBattle() {
+    decorated.fleeBattle();
+  }
+}
+```
+
+这里是巨魔的实战
+
+```java
+// simple troll
+var troll = new SimpleTroll();
+troll.attack(); // The troll tries to grab you!
+troll.fleeBattle(); // The troll shrieks in horror and runs away!
+
+// change the behavior of the simple troll by adding a decorator
+var clubbedTroll = new ClubbedTroll(troll);
+clubbedTroll.attack(); // The troll tries to grab you! The troll swings at you with a club!
+clubbedTroll.fleeBattle(); // The troll shrieks in horror and runs away!
+```
+
+## 类图
+![alt text](../../decorator/etc/decorator.urm.png "Decorator pattern class diagram")
+
+## 适用性
+使用装饰者
+
+* 动态透明地向单个对象添加职责，即不影响其他对象
+* 对于可以撤销的责任
+* 当通过子类化进行扩展是不切实际的。有时可能会有大量的独立扩展，并且会产生大量的子类来支持每种组合。 否则类定义可能被隐藏或无法用于子类化。
+
+## 教程
+* [Decorator Pattern Tutorial](https://www.journaldev.com/1540/decorator-design-pattern-in-java-example)
+
+## Java世界的例子
+ * [java.io.InputStream](http://docs.oracle.com/javase/8/docs/api/java/io/InputStream.html), [java.io.OutputStream](http://docs.oracle.com/javase/8/docs/api/java/io/OutputStream.html),
+ [java.io.Reader](http://docs.oracle.com/javase/8/docs/api/java/io/Reader.html) and [java.io.Writer](http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html)
+ * [java.util.Collections#synchronizedXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#synchronizedCollection-java.util.Collection-)
+ * [java.util.Collections#unmodifiableXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#unmodifiableCollection-java.util.Collection-)
+ * [java.util.Collections#checkedXXX()](http://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#checkedCollection-java.util.Collection-java.lang.Class-)
+
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Functional Programming in Java: Harnessing the Power of Java 8 Lambda Expressions](https://www.amazon.com/gp/product/1937785467/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1937785467&linkCode=as2&tag=javadesignpat-20&linkId=7e4e2fb7a141631491534255252fd08b)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94)
diff --git a/zh/factory-method/README.md b/zh/factory-method/README.md
new file mode 100644
index 000000000..420653d1b
--- /dev/null
+++ b/zh/factory-method/README.md
@@ -0,0 +1,88 @@
+---
+layout: pattern
+title: Factory Method
+folder: factory-method
+permalink: /patterns/factory-method/
+categories: Creational
+tags:
+ - Extensibility
+ - Gang Of Four
+---
+
+## Also known as
+# 或称
+
+虚拟构造器
+
+## 目的
+为创建一个对象定义一个接口，但是让子类决定实例化哪个类。工厂方法允许类将实例化延迟到子类。
+
+## 解释
+真实世界例子
+
+> 铁匠生产武器。精灵需要精灵武器，而兽人需要兽人武器。根据客户来召唤正确类型的铁匠。
+
+通俗的说
+
+> 它为类提供了一种把实例化的逻辑委托给子类的方式。
+
+维基百科上说
+
+> 在基于类的编程中，工厂方法模式是一种创建型设计模式用来解决创建对象的问题，而不需要指定将要创建对象的确切类。这是通过调用工厂方法创建对象来完成的，而不是通过调用构造器。该工厂方法在接口中指定并由子类实现，或者在基类实现并可以选择由子类重写。
+
+ **程序示例**
+
+以上面的铁匠为例，首先我们有铁匠的接口和一些它的实现。
+
+```java
+public interface Blacksmith {
+  Weapon manufactureWeapon(WeaponType weaponType);
+}
+
+public class ElfBlacksmith implements Blacksmith {
+  public Weapon manufactureWeapon(WeaponType weaponType) {
+    return ELFARSENAL.get(weaponType);
+  }
+}
+
+public class OrcBlacksmith implements Blacksmith {
+  public Weapon manufactureWeapon(WeaponType weaponType) {
+    return ORCARSENAL.get(weaponType);
+  }
+}
+```
+
+现在随着客户的到来，会召唤出正确类型的铁匠并制造出要求的武器。
+
+```java
+var blacksmith = new ElfBlacksmith();
+blacksmith.manufactureWeapon(WeaponType.SPEAR);
+blacksmith.manufactureWeapon(WeaponType.AXE);
+// Elvish weapons are created
+```
+
+## 类图
+![alt text](../../factory-method/etc/factory-method.urm.png "Factory Method pattern class diagram")
+
+## 适用性
+使用工厂方法模式当
+
+* 一个类无法预料它所要必须创建的对象的类
+* 一个类想要它的子类来指定它要创建的对象
+* 类将责任委派给几个帮助子类中的一个，而你想定位了解是具体之中的哪一个
+
+## Java中的例子
+
+* [java.util.Calendar](http://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html#getInstance--)
+* [java.util.ResourceBundle](http://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-)
+* [java.text.NumberFormat](http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html#getInstance--)
+* [java.nio.charset.Charset](http://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#forName-java.lang.String-)
+* [java.net.URLStreamHandlerFactory](http://docs.oracle.com/javase/8/docs/api/java/net/URLStreamHandlerFactory.html#createURLStreamHandler-java.lang.String-)
+* [java.util.EnumSet](https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html#of-E-)
+* [javax.xml.bind.JAXBContext](https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/JAXBContext.html#createMarshaller--)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

From 9f3f5322d2226274b3e6a7b96bdc5ca0424bb9b0 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 12 Sep 2020 17:00:58 +0000
Subject: [PATCH 111/254] docs: update README.md [skip ci]

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index c60b27f09..ca3e8fbaa 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-131-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-132-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -246,7 +246,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/nishant"><img src="https://avatars2.githubusercontent.com/u/15331971?v=4" width="100px;" alt=""/><br /><sub><b>Nishant Arora</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nishant" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/raja-peeyush-kumar-singh"><img src="https://avatars0.githubusercontent.com/u/5496024?v=4" width="100px;" alt=""/><br /><sub><b>Peeyush</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=raja-peeyush-kumar-singh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aravening" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://github.com/vINCENT8888801"><img src="https://avatars0.githubusercontent.com/u/8037883?v=4" width="100px;" alt=""/><br /><sub><b>Wei Seng</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vINCENT8888801" title="Code">💻</a></td>
   </tr>
   <tr>
@@ -262,10 +262,10 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4" width="100px;" alt=""/><br /><sub><b>Michał Krzywański</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mkrzywanski" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aravening" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4" width="100px;" alt=""/><br /><sub><b>Fedor Skvorcov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fedorskvorcov" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4" width="100px;" alt=""/><br /><sub><b>samilAyoub</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=samilAyoub" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/vdlald"><img src="https://avatars0.githubusercontent.com/u/29997701?v=4" width="100px;" alt=""/><br /><sub><b>Vladislav Golubinov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vdlald" title="Code">💻</a></td>
   </tr>
 </table>
 

From c63af2ccbf6389d8c67e17116283d255ed977a24 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 12 Sep 2020 17:00:59 +0000
Subject: [PATCH 112/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index c7c53aae4..7abdd7ea9 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1195,6 +1195,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "vdlald",
+      "name": "Vladislav Golubinov",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/29997701?v=4",
+      "profile": "https://github.com/vdlald",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 9088ac51f6105f82e4c04c31de262e7e59f3fa8e Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Sat, 12 Sep 2020 22:35:40 +0530
Subject: [PATCH 113/254] #1313 Rename DomesticTax,ForeignTax and review fixes

---
 separated-interface/README.md                 |  16 ++++++++--------
 separated-interface/etc/class_diagram.png     | Bin 32651 -> 32958 bytes
 .../etc/separated-interface.urm.puml          |  12 ++++++------
 .../com/iluwatar/separatedinterface/App.java  |   9 +++++----
 ...ticTax.java => DomesticTaxCalculator.java} |   2 +-
 ...eignTax.java => ForeignTaxCalculator.java} |   2 +-
 ...st.java => DomesticTaxCalculatorTest.java} |   8 ++++----
 ...est.java => ForeignTaxCalculatorTest.java} |   8 ++++----
 8 files changed, 29 insertions(+), 28 deletions(-)
 rename separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/{DomesticTax.java => DomesticTaxCalculator.java} (95%)
 rename separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/{ForeignTax.java => ForeignTaxCalculator.java} (96%)
 rename separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/{DomesticTaxTest.java => DomesticTaxCalculatorTest.java} (89%)
 rename separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/{ForeignTaxTest.java => ForeignTaxCalculatorTest.java} (89%)

diff --git a/separated-interface/README.md b/separated-interface/README.md
index b26d5c7da..ca7a12e44 100644
--- a/separated-interface/README.md
+++ b/separated-interface/README.md
@@ -3,7 +3,7 @@ layout: pattern
 title: Separated Interface
 folder: separated-interface
 permalink: /patterns/separated-interface/
-categories: Architectural
+categories: Structural
 tags:
  - Decoupling
 ---
@@ -22,7 +22,7 @@ In plain words
 
 > Separated interface pattern encourages to keep the implementations of an interface decoupled from the client and its definition, so the client is not dependent on the implementation.
 
-A client code may abstract some specific functionality to an interface, and define the definition of the interface as an SPI. Another package may implement this interface definition with a concrete logic, which will be injected into the client code at runtime (with a third class, injecting the implementation in the client) or at compile time (using Plugin pattern with some configurable file).
+A client code may abstract some specific functionality to an interface, and define the definition of the interface as an SPI ([Service Programming Interface](https://en.wikipedia.org/wiki/Service_provider_interface) is an API intended and open to be implemented or extended by a third party). Another package may implement this interface definition with a concrete logic, which will be injected into the client code at runtime (with a third class, injecting the implementation in the client) or at compile time (using Plugin pattern with some configurable file).
 
 **Programmatic Example**
 
@@ -60,9 +60,9 @@ public interface TaxCalculator {
 
 **Implementation package**
 In another package (which the client is completely unaware of) there exist multiple implementations of the ```TaxCalculator``` interface
-```ForeignTax``` which levies 60% tax for international products.
+```ForeignTaxCalculator``` which levies 60% tax for international products.
 ```java
-public class ForeignTax implements TaxCalculator {
+public class ForeignTaxCalculator implements TaxCalculator {
 
   public static final double TAX_PERCENTAGE = 60;
 
@@ -74,9 +74,9 @@ public class ForeignTax implements TaxCalculator {
 }
 ```
 
-```DomesticTax``` which levies 20% tax for international products.
+```DomesticTaxCalculator``` which levies 20% tax for international products.
 ```java
-public class DomesticTax implements TaxCalculator {
+public class DomesticTaxCalculator implements TaxCalculator {
 
   public static final double TAX_PERCENTAGE = 20;
 
@@ -91,11 +91,11 @@ public class DomesticTax implements TaxCalculator {
 These both implementations are instantiated and injected in the client class by the ```App.java``` class
 
 ```java
-    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTax());
+    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTaxCalculator());
 
     LOGGER.info("Foreign Tax applied: {}", "" + internationalProductInvoice.getAmountWithTax());
 
-    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTax());
+    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTaxCalculator());
 
     LOGGER.info("Domestic Tax applied: {}", "" + domesticProductInvoice.getAmountWithTax());
 ```
diff --git a/separated-interface/etc/class_diagram.png b/separated-interface/etc/class_diagram.png
index a0edbac8dac3cd5a0f1dd174fd1cfaa0bbc78e72..10d509801f79b7c9172c87731233d6753d597efd 100644
GIT binary patch
literal 32958
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

literal 32651
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
UJAQrvtRC`AO5t(-qZe=f5BA4?t^fc4

diff --git a/separated-interface/etc/separated-interface.urm.puml b/separated-interface/etc/separated-interface.urm.puml
index a406acd40..eab2ad60c 100644
--- a/separated-interface/etc/separated-interface.urm.puml
+++ b/separated-interface/etc/separated-interface.urm.puml
@@ -8,14 +8,14 @@ package com.iluwatar.separatedinterface {
   }
 }
 package com.iluwatar.separatedinterface.taxes {
-  class DomesticTax {
+  class DomesticTaxCalculator {
     + TAX_PERCENTAGE : double {static}
-    + DomesticTax()
+    + DomesticTaxCalculator()
     + calculate(amount : double) : double
   }
-  class ForeignTax {
+  class ForeignTaxCalculator {
     + TAX_PERCENTAGE : double {static}
-    + ForeignTax()
+    + ForeignTaxCalculator()
     + calculate(amount : double) : double
   }
 }
@@ -31,6 +31,6 @@ package com.iluwatar.separatedinterface.invoice {
   }
 }
 InvoiceGenerator -->  "-taxCalculator" TaxCalculator
-DomesticTax ..|> TaxCalculator 
-ForeignTax ..|> TaxCalculator 
+DomesticTaxCalculator ..|> TaxCalculator 
+ForeignTaxCalculator ..|> TaxCalculator 
 @enduml
\ No newline at end of file
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
index 67eeec054..1951e738b 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
@@ -24,8 +24,8 @@
 package com.iluwatar.separatedinterface;
 
 import com.iluwatar.separatedinterface.invoice.InvoiceGenerator;
-import com.iluwatar.separatedinterface.taxes.DomesticTax;
-import com.iluwatar.separatedinterface.taxes.ForeignTax;
+import com.iluwatar.separatedinterface.taxes.DomesticTaxCalculator;
+import com.iluwatar.separatedinterface.taxes.ForeignTaxCalculator;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -51,11 +51,12 @@ public class App {
    */
   public static void main(String[] args) {
     //Create the invoice generator with product cost as 50 and foreign product tax
-    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTax());
+    var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST,
+        new ForeignTaxCalculator());
     LOGGER.info("Foreign Tax applied: {}", "" + internationalProductInvoice.getAmountWithTax());
 
     //Create the invoice generator with product cost as 50 and domestic product tax
-    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTax());
+    var domesticProductInvoice = new InvoiceGenerator(PRODUCT_COST, new DomesticTaxCalculator());
     LOGGER.info("Domestic Tax applied: {}", "" + domesticProductInvoice.getAmountWithTax());
   }
 }
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
similarity index 95%
rename from separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java
rename to separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
index ebe0e306e..788afb90a 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTax.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
@@ -28,7 +28,7 @@ import com.iluwatar.separatedinterface.invoice.TaxCalculator;
 /**
  * TaxCalculator for Domestic goods with 20% tax.
  */
-public class DomesticTax implements TaxCalculator {
+public class DomesticTaxCalculator implements TaxCalculator {
 
   public static final double TAX_PERCENTAGE = 20;
 
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
similarity index 96%
rename from separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java
rename to separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
index 583f70d3b..c2b12e2f5 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTax.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
@@ -28,7 +28,7 @@ import com.iluwatar.separatedinterface.invoice.TaxCalculator;
 /**
  * TaxCalculator for foreign goods with 60% tax.
  */
-public class ForeignTax implements TaxCalculator {
+public class ForeignTaxCalculator implements TaxCalculator {
 
   public static final double TAX_PERCENTAGE = 60;
 
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
similarity index 89%
rename from separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
rename to separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
index d070d8b0a..dac3ec2d6 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
@@ -26,13 +26,13 @@ package com.iluwatar.separatedinterface.taxes;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-public class DomesticTaxTest {
+public class DomesticTaxCalculatorTest {
 
-  private DomesticTax target;
+  private DomesticTaxCalculator target;
 
   @Test
-  public void testTaxCaluclation(){
-    target = new DomesticTax();
+  public void testTaxCalculation(){
+    target = new DomesticTaxCalculator();
 
     var tax=target.calculate(100.0);
     Assertions.assertEquals(tax,20.0);
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
similarity index 89%
rename from separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
rename to separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
index df184276c..22526b6df 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
@@ -26,13 +26,13 @@ package com.iluwatar.separatedinterface.taxes;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-public class ForeignTaxTest {
+public class ForeignTaxCalculatorTest {
 
-  private ForeignTax target;
+  private ForeignTaxCalculator target;
 
   @Test
-  public void testTaxCaluclation(){
-    target = new ForeignTax();
+  public void testTaxCalculation(){
+    target = new ForeignTaxCalculator();
 
     var tax=target.calculate(100.0);
     Assertions.assertEquals(tax,60.0);

From 74b968942f69a893d8f832e5482cf481429638a5 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 13 Sep 2020 14:23:52 +0000
Subject: [PATCH 114/254] docs: update README.md [skip ci]

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index ca3e8fbaa..51ed89f82 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-132-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-133-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -267,6 +267,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4" width="100px;" alt=""/><br /><sub><b>samilAyoub</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=samilAyoub" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/vdlald"><img src="https://avatars0.githubusercontent.com/u/29997701?v=4" width="100px;" alt=""/><br /><sub><b>Vladislav Golubinov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vdlald" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From 6f592f5e8a7c66116d8035e16a3d299b6a1c9e82 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 13 Sep 2020 14:23:53 +0000
Subject: [PATCH 115/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 7abdd7ea9..43103ead1 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1204,6 +1204,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "swarajsaaj",
+      "name": "Swaraj",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/6285049?v=4",
+      "profile": "https://github.com/swarajsaaj",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 2e98dcf2179f4aa13478d36fd8967d068a98eff0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 17:39:10 +0300
Subject: [PATCH 116/254] Update README.md

---
 separated-interface/README.md | 43 +++++++++++++++++++++++++----------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/separated-interface/README.md b/separated-interface/README.md
index ca7a12e44..35c9e5fe0 100644
--- a/separated-interface/README.md
+++ b/separated-interface/README.md
@@ -10,23 +10,35 @@ tags:
 
 
 ## Intent
-Separate the interface definition and implementation in different packages. This allows the client to be completely unaware of the implementation.
+
+Separate the interface definition and implementation in different packages. This allows the client 
+to be completely unaware of the implementation.
 
 ## Explanation
 
 Real world example
 
-> An Invoice generator may be created with ability to use different Tax calculators that may be added in the invoice depending upon type of purchase, region etc.         
+> An Invoice generator may be created with ability to use different Tax calculators that may be 
+> added in the invoice depending upon type of purchase, region etc.         
 
 In plain words
 
-> Separated interface pattern encourages to keep the implementations of an interface decoupled from the client and its definition, so the client is not dependent on the implementation.
+> Separated interface pattern encourages to keep the implementations of an interface decoupled from 
+> the client and its definition, so the client is not dependent on the implementation.
 
-A client code may abstract some specific functionality to an interface, and define the definition of the interface as an SPI ([Service Programming Interface](https://en.wikipedia.org/wiki/Service_provider_interface) is an API intended and open to be implemented or extended by a third party). Another package may implement this interface definition with a concrete logic, which will be injected into the client code at runtime (with a third class, injecting the implementation in the client) or at compile time (using Plugin pattern with some configurable file).
+A client code may abstract some specific functionality to an interface, and define the definition of 
+the interface as an SPI ([Service Programming Interface](https://en.wikipedia.org/wiki/Service_provider_interface) 
+is an API intended and open to be implemented or extended by a third party). Another package may 
+implement this interface definition with a concrete logic, which will be injected into the client 
+code at runtime (with a third class, injecting the implementation in the client) or at compile time 
+(using Plugin pattern with some configurable file).
 
 **Programmatic Example**
 
-**Client** An Invoice generator class accepts the cost of the product and calculates the total amount payable inclusive of tax
+**Client** 
+
+`InvoiceGenerator` class accepts the cost of the product and calculates the total 
+amount payable inclusive of tax.
 
 ```java
 public class InvoiceGenerator {
@@ -46,21 +58,23 @@ public class InvoiceGenerator {
 
 }
 ```
-The tax calculation logic is delegated to the ```TaxCalculator``` interface
+
+The tax calculation logic is delegated to the `TaxCalculator` interface.
 
 ```java
-
 public interface TaxCalculator {
 
   double calculate(double amount);
 
 }
-
 ```
 
 **Implementation package**
-In another package (which the client is completely unaware of) there exist multiple implementations of the ```TaxCalculator``` interface
-```ForeignTaxCalculator``` which levies 60% tax for international products.
+
+In another package (which the client is completely unaware of) there exist multiple implementations 
+of the `TaxCalculator` interface. `ForeignTaxCalculator` is one of them which levies 60% tax 
+for international products.
+
 ```java
 public class ForeignTaxCalculator implements TaxCalculator {
 
@@ -74,7 +88,8 @@ public class ForeignTaxCalculator implements TaxCalculator {
 }
 ```
 
-```DomesticTaxCalculator``` which levies 20% tax for international products.
+Another is `DomesticTaxCalculator` which levies 20% tax for international products.
+
 ```java
 public class DomesticTaxCalculator implements TaxCalculator {
 
@@ -88,7 +103,8 @@ public class DomesticTaxCalculator implements TaxCalculator {
 }
 ```
 
-These both implementations are instantiated and injected in the client class by the ```App.java``` class
+These both implementations are instantiated and injected in the client class by the ```App.java``` 
+class.
 
 ```java
     var internationalProductInvoice = new InvoiceGenerator(PRODUCT_COST, new ForeignTaxCalculator());
@@ -101,9 +117,11 @@ These both implementations are instantiated and injected in the client class by
 ```
 
 ## Class diagram
+
 ![alt text](./etc/class_diagram.png "Separated Interface")
 
 ## Applicability
+
 Use the Separated interface pattern when
 
 * You are developing a framework package, and your framework needs to call some application code through interfaces.
@@ -117,3 +135,4 @@ Use the Separated interface pattern when
 ## Credits
 
 * [Martin Fowler](https://www.martinfowler.com/eaaCatalog/separatedInterface.html)
+* [Patterns of Enterprise Application Architecture](https://www.amazon.com/gp/product/0321127420/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0321127420&linkId=e08dfb7f2cf6153542ef1b5a00b10abc)

From c204b242dfb84a1b6e43d2dddc56252ddceb47e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 17:53:50 +0300
Subject: [PATCH 117/254] Update README.md

---
 singleton/README.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/singleton/README.md b/singleton/README.md
index 60a103a3b..915b3c810 100644
--- a/singleton/README.md
+++ b/singleton/README.md
@@ -9,14 +9,16 @@ tags:
 ---
 
 ## Intent
-Ensure a class only has one instance, and provide a global point of
-access to it.
+
+Ensure a class only has one instance, and provide a global point of access to it.
 
 
 ## Explanation
+
 Real world example
 
-> There can only be one ivory tower where the wizards study their magic. The same enchanted ivory tower is always used by the wizards. Ivory tower here is singleton.
+> There can only be one ivory tower where the wizards study their magic. The same enchanted ivory 
+> tower is always used by the wizards. Ivory tower here is singleton.
 
 In plain words
 
@@ -24,7 +26,9 @@ In plain words
 
 Wikipedia says
 
-> In software engineering, the singleton pattern is a software design pattern that restricts the instantiation of a class to one object. This is useful when exactly one object is needed to coordinate actions across the system.
+> In software engineering, the singleton pattern is a software design pattern that restricts the 
+> instantiation of a class to one object. This is useful when exactly one object is needed to 
+> coordinate actions across the system.
 
 **Programmatic Example**
 
@@ -38,7 +42,7 @@ public enum EnumIvoryTower {
 }
 ```
 
-Then in order to use
+Then in order to use:
 
 ```java
 var enumIvoryTower1 = EnumIvoryTower.INSTANCE;
@@ -47,9 +51,11 @@ assertEquals(enumIvoryTower1, enumIvoryTower2); // true
 ```
 
 ## Class diagram
+
 ![alt text](./etc/singleton.urm.png "Singleton pattern class diagram")
 
 ## Applicability
+
 Use the Singleton pattern when
 
 * There must be exactly one instance of a class, and it must be accessible to clients from a well-known access point

From e6cca86e25c6571e2e98091cd4face248fafa019 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 17:59:12 +0300
Subject: [PATCH 118/254] Update README.md

---
 spatial-partition/README.md                   | 31 ++++++++++++++-----
 .../SpatialPartitionBubbles.java              |  1 -
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/spatial-partition/README.md b/spatial-partition/README.md
index 29d54533d..0114fadba 100644
--- a/spatial-partition/README.md
+++ b/spatial-partition/README.md
@@ -10,12 +10,17 @@ tags:
 ---
 
 ## Intent
-As explained in the book [Game Programming Patterns](http://gameprogrammingpatterns.com/spatial-partition.html) by Bob Nystrom, spatial partition pattern helps to 
 
-> efficiently locate objects by storing them in a data structure organized by their positions.
+As explained in the book [Game Programming Patterns](http://gameprogrammingpatterns.com/spatial-partition.html) 
+by Bob Nystrom, spatial partition pattern helps to efficiently locate objects by storing them in a 
+data structure organized by their positions.
 
 ## Explanation
-Say, you are building a war game with hundreds, or maybe even thousands of players, who are clashing on the battle field. Each player's position is getting updated every frame. The simple way to handle all interactions taking place on the field is to check each player's position against every other player's position:
+
+Say, you are building a war game with hundreds, or maybe even thousands of players, who are clashing 
+on the battle field. Each player's position is getting updated every frame. The simple way to handle 
+all interactions taking place on the field is to check each player's position against every other 
+player's position:
 
 ```java
 public void handleMeLee(Unit units[], int numUnits) {
@@ -32,21 +37,33 @@ public void handleMeLee(Unit units[], int numUnits) {
 }
 ```
 
-This will include a lot of unnecessary checks between players which are too far apart to have any influence on each other. The nested loops gives this operation an O(n^2) complexity, which has to be performed every frame since many of the objects on the field may be moving each frame.
-The idea behind the Spatial Partition design pattern is to enable quick location of objects using a data structure that is organised by their positions, so when performing an operation like the one above, every object's position need not be checked against all other objects' positions. The data structure can be used to store moving and static objects, though in order to keep track of the moving objects, their positions will have to be reset each time they move. This would mean having to create a new instance of the data structure each time an object moves, which would use up additional memory. The common data structures used for this design pattern are:
+This will include a lot of unnecessary checks between players which are too far apart to have any 
+influence on each other. The nested loops gives this operation an O(n^2) complexity, which has to be 
+performed every frame since many of the objects on the field may be moving each frame. The idea 
+behind the Spatial Partition design pattern is to enable quick location of objects using a data 
+structure that is organised by their positions, so when performing an operation like the one above, 
+every object's position need not be checked against all other objects' positions. The data structure 
+can be used to store moving and static objects, though in order to keep track of the moving objects, 
+their positions will have to be reset each time they move. This would mean having to create a new 
+instance of the data structure each time an object moves, which would use up additional memory. The 
+common data structures used for this design pattern are:
 
 * Grid
 * Quad tree
-* k-d tree
+* K-d tree
 * BSP
 * Boundary volume hierarchy
 
-In our implementation, we use the Quadtree data structure which will reduce the time complexity of finding the objects within a certain range from O(n^2) to O(nlogn), decreasing the computations required significantly in case of large number of objects.
+In our implementation, we use the Quadtree data structure which will reduce the time complexity of 
+finding the objects within a certain range from O(n^2) to O(nlogn), decreasing the computations 
+required significantly in case of large number of objects.
 
 ## Class diagram
+
 ![alt text](./etc/spatial-partition.urm.png "Spatial Partition pattern class diagram")
 
 ## Applicability
+
 This pattern can be used:
 
 * When you need to keep track of a large number of objects' positions, which are getting updated every frame.
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
index c0eb5ecde..c543da12c 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
@@ -24,7 +24,6 @@
 package com.iluwatar.spatialpartition;
 
 import java.util.ArrayList;
-import java.util.Collection;
 import java.util.Hashtable;
 
 /**

From 9c648cbdb86ba7e93edac9b36589cea4082e4745 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:04:30 +0300
Subject: [PATCH 119/254] Update README.md

---
 specification/README.md | 68 ++++++++++++++++++++++++++---------------
 1 file changed, 43 insertions(+), 25 deletions(-)

diff --git a/specification/README.md b/specification/README.md
index 6cc0c702f..5648a73b0 100644
--- a/specification/README.md
+++ b/specification/README.md
@@ -9,36 +9,46 @@ tags:
 ---
 
 ## Also known as
+
 Filter, Criteria
 
 ## Intent
-Specification pattern separates the statement of how to match a
-candidate, from the candidate object that it is matched against. As well as its
-usefulness in selection, it is also valuable for validation and for building to
-order.
+
+Specification pattern separates the statement of how to match a candidate, from the candidate object 
+that it is matched against. As well as its usefulness in selection, it is also valuable for 
+validation and for building to order.
 
 ## Explanation
 
 Real world example
 
-> There is a pool of different creatures and we often need to select some subset of them.
-> We can write our search specification such as "creatures that can fly", "creatures heavier than 500 kilograms", or as a combination of other search specifications, and then give it to the party that will perform the filtering.
+> There is a pool of different creatures and we often need to select some subset of them. We can 
+> write our search specification such as "creatures that can fly", "creatures heavier than 500 
+> kilograms", or as a combination of other search specifications, and then give it to the party that 
+> will perform the filtering.
 
 In Plain Words
 
-> Specification pattern allows us to separate the search criteria from the object that performs the search.
+> Specification pattern allows us to separate the search criteria from the object that performs the 
+> search.
 
 Wikipedia says
 
-> In computer programming, the specification pattern is a particular software design pattern, whereby business rules can be recombined by chaining the business rules together using boolean logic.
+> In computer programming, the specification pattern is a particular software design pattern, 
+> whereby business rules can be recombined by chaining the business rules together using boolean 
+> logic.
 
 **Programmatic Example**
 
-If we look at our creature pool example from above, we have a set of creatures with certain properties.
-Those properties can be part of a pre-defined, limited set (represented here by the enums Size, Movement and Color); but they can also be continuous values (e.g. the mass of a Creature).
-In this case, it is more appropriate to use what we call "parameterized specification", where the property value can be given as an argument when the Creature is instantiated, allowing for more flexibility.
-A third option is to combine pre-defined and/or parameterized properties using boolean logic, allowing for near-endless selection possibilities (this is called "composite specification", see below).
-The pros and cons of each approach are detailed in the table at the end of this document.
+If we look at our creature pool example from above, we have a set of creatures with certain 
+properties. Those properties can be part of a pre-defined, limited set (represented here by the 
+enums Size, Movement and Color); but they can also be continuous values (e.g. the mass of a 
+Creature). In this case, it is more appropriate to use what we call "parameterized specification", 
+where the property value can be given as an argument when the Creature is instantiated, allowing for 
+more flexibility. A third option is to combine pre-defined and/or parameterized properties using 
+boolean logic, allowing for near-endless selection possibilities (this is called "composite 
+specification", see below). The pros and cons of each approach are detailed in the table at the end 
+of this document.
 
 ```java
 public interface Creature {
@@ -50,7 +60,7 @@ public interface Creature {
 }
 ```
 
-And ``Dragon`` implementation looks like this.
+And `Dragon` implementation looks like this.
 
 ```java
 public class Dragon extends AbstractCreature {
@@ -61,7 +71,8 @@ public class Dragon extends AbstractCreature {
 }
 ```
 
-Now that we want to select some subset of them, we use selectors. To select creatures that fly, we should use ``MovementSelector``.
+Now that we want to select some subset of them, we use selectors. To select creatures that fly, we 
+should use `MovementSelector`.
 
 ```java
 public class MovementSelector extends AbstractSelector<Creature> {
@@ -79,7 +90,8 @@ public class MovementSelector extends AbstractSelector<Creature> {
 }
 ```
 
-On the other hand, when selecting creatures heavier than a chosen amount, we use ``MassGreaterThanSelector``.
+On the other hand, when selecting creatures heavier than a chosen amount, we use 
+`MassGreaterThanSelector`.
 
 ```java
 public class MassGreaterThanSelector extends AbstractSelector<Creature> {
@@ -111,7 +123,8 @@ But we could also use our parameterized selector like this:
       .collect(Collectors.toList());
 ```
 
-Our third option is to combine multiple selectors together. Performing a search for special creatures (defined as red, flying, and not small) could be done as follows:
+Our third option is to combine multiple selectors together. Performing a search for special 
+creatures (defined as red, flying, and not small) could be done as follows:
 
 ```java
     var specialCreaturesSelector = 
@@ -123,8 +136,9 @@ Our third option is to combine multiple selectors together. Performing a search
 
 **More on Composite Specification**
 
-In Composite Specification, we will create custom instances of ``AbstractSelector`` by combining other selectors (called "leaves") using the three basic logical operators.
-These are implemented in ``ConjunctionSelector``, ``DisjunctionSelector`` and ``NegationSelector``.
+In Composite Specification, we will create custom instances of `AbstractSelector` by combining 
+other selectors (called "leaves") using the three basic logical operators. These are implemented in 
+`ConjunctionSelector`, `DisjunctionSelector` and `NegationSelector`.
 
 ```java
 public abstract class AbstractSelector<T> implements Predicate<T> {
@@ -163,12 +177,14 @@ public class ConjunctionSelector<T> extends AbstractSelector<T> {
 }
 ```
 
-All that is left to do is now to create leaf selectors (be it hard-coded or parameterized ones) that are as generic as possible,
-and we will be able to instantiate the ``AbstractSelector`` class by combining any amount of selectors, as exemplified above.
-We should be careful though, as it is easy to make a mistake when combining many logical operators; in particular, we should pay attention to the priority of the operations.\
-In general, Composite Specification is a great way to write more reusable code, as there is no need to create a Selector class for each filtering operation.
-Instead, we just create an instance of ``AbstractSelector`` "on the spot", using tour generic "leaf" selectors and some basic boolean logic.
-
+All that is left to do is now to create leaf selectors (be it hard-coded or parameterized ones) that 
+are as generic as possible, and we will be able to instantiate the ``AbstractSelector`` class by 
+combining any amount of selectors, as exemplified above. We should be careful though, as it is easy 
+to make a mistake when combining many logical operators; in particular, we should pay attention to 
+the priority of the operations. In general, Composite Specification is a great way to write more 
+reusable code, as there is no need to create a Selector class for each filtering operation. Instead, 
+we just create an instance of ``AbstractSelector`` "on the spot", using tour generic "leaf" 
+selectors and some basic boolean logic.
 
 **Comparison of the different approaches**
 
@@ -181,9 +197,11 @@ Instead, we just create an instance of ``AbstractSelector`` "on the spot", using
 | | | + Supports logical operations | - You still need to create the base classes used as leaves |
 
 ## Class diagram
+
 ![alt text](./etc/specification.png "Specification")
 
 ## Applicability
+
 Use the Specification pattern when
 
 * You need to select a subset of objects based on some criteria, and to refresh the selection at various times.

From 9cbc509c3ad3a75f0935e01b2d3b636968cf5832 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:09:18 +0300
Subject: [PATCH 120/254] Update README.md

---
 state/README.md       |  33 ++++++++++++-----
 state/etc/state.png   | Bin 17753 -> 0 bytes
 state/etc/state.ucls  |  80 ------------------------------------------
 state/etc/state_1.png | Bin 33886 -> 0 bytes
 4 files changed, 24 insertions(+), 89 deletions(-)
 delete mode 100644 state/etc/state.png
 delete mode 100644 state/etc/state.ucls
 delete mode 100644 state/etc/state_1.png

diff --git a/state/README.md b/state/README.md
index a8dd2b5fc..7ee201be2 100644
--- a/state/README.md
+++ b/state/README.md
@@ -9,15 +9,21 @@ tags:
 ---
 
 ## Also known as
+
 Objects for States
 
 ## Intent
-Allow an object to alter its behavior when its internal state changes. The object will appear to change its class.
+
+Allow an object to alter its behavior when its internal state changes. The object will appear to 
+change its class.
 
 ## Explanation
+
 Real world example
 
-> When observing a mammoth in its natural habitat it seems to change its behavior based on the situation. It may first appear calm but over time when it detects a threat it gets angry and dangerous to its surroundings.  
+> When observing a mammoth in its natural habitat it seems to change its behavior based on the 
+> situation. It may first appear calm but over time when it detects a threat it gets angry and 
+> dangerous to its surroundings.  
 
 In plain words
 
@@ -25,7 +31,10 @@ In plain words
 
 Wikipedia says
 
-> The state pattern is a behavioral software design pattern that allows an object to alter its behavior when its internal state changes. This pattern is close to the concept of finite-state machines. The state pattern can be interpreted as a strategy pattern, which is able to switch a strategy through invocations of methods defined in the pattern's interface.
+> The state pattern is a behavioral software design pattern that allows an object to alter its 
+> behavior when its internal state changes. This pattern is close to the concept of finite-state 
+> machines. The state pattern can be interpreted as a strategy pattern, which is able to switch a 
+> strategy through invocations of methods defined in the pattern's interface.
 
 **Programmatic Example**
 
@@ -126,17 +135,23 @@ And here is the full example how the mammoth behaves over time.
     mammoth.observe();
     mammoth.timePasses();
     mammoth.observe();
-    
-    // The mammoth gets angry!
-    // The mammoth is furious!
-    // The mammoth calms down.
-    // The mammoth is calm and peaceful.
+```
+
+Program output:
+
+```java
+    The mammoth gets angry!
+    The mammoth is furious!
+    The mammoth calms down.
+    The mammoth is calm and peaceful.
 ```
 
 ## Class diagram
-![alt text](./etc/state_1.png "State")
+
+![alt text](./etc/state_urm.png "State")
 
 ## Applicability
+
 Use the State pattern in either of the following cases
 
 * An object's behavior depends on its state, and it must change its behavior at run-time depending on that state
diff --git a/state/etc/state.png b/state/etc/state.png
deleted file mode 100644
index fb1648238e78e123a3e2f60540ae7701dd45ee8c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 17753
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

diff --git a/state/etc/state.ucls b/state/etc/state.ucls
deleted file mode 100644
index e0be8d712..000000000
--- a/state/etc/state.ucls
+++ /dev/null
@@ -1,80 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.state.AngryState" project="state" 
-    file="/state/src/main/java/com/iluwatar/state/AngryState.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="124" width="157" x="98" y="310"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.state.PeacefulState" project="state" 
-    file="/state/src/main/java/com/iluwatar/state/PeacefulState.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="124" width="173" x="295" y="310"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <interface id="3" language="java" name="com.iluwatar.state.State" project="state" 
-    file="/state/src/main/java/com/iluwatar/state/State.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="106" width="136" x="138" y="674"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </interface>  
-  <class id="4" language="java" name="com.iluwatar.state.Mammoth" project="state" 
-    file="/state/src/main/java/com/iluwatar/state/Mammoth.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="160" width="177" x="138" y="474"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <realization id="5">    
-    <bendpoint x="107" y="474"/>    
-    <end type="SOURCE" refId="1"/>    
-    <end type="TARGET" refId="3"/>  
-  </realization>  
-  <association id="6">    
-    <end type="SOURCE" refId="4" navigable="false">      
-      <attribute id="7" name="state"/>      
-      <multiplicity id="8" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="3" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <realization id="9">    
-    <bendpoint x="345" y="474"/>    
-    <end type="SOURCE" refId="2"/>    
-    <end type="TARGET" refId="3"/>  
-  </realization>  
-  <association id="10">    
-    <end type="SOURCE" refId="1" navigable="false">      
-      <attribute id="11" name="mammoth"/>      
-      <multiplicity id="12" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="4" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <association id="13">    
-    <end type="SOURCE" refId="2" navigable="false">      
-      <attribute id="14" name="mammoth"/>      
-      <multiplicity id="15" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="4" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/state/etc/state_1.png b/state/etc/state_1.png
deleted file mode 100644
index 112bb9aff904f93f769583ab2a33d3f7b2181a9f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 33886
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
Fe*vgP8^izr


From b5fddd469a1e7139fac627785a7d8b15b1cf4b5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:09:41 +0300
Subject: [PATCH 121/254] Update README.md

---
 state/etc/state_urm.png | Bin 0 -> 34673 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 state/etc/state_urm.png

diff --git a/state/etc/state_urm.png b/state/etc/state_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2cf9f562943f5395185497621565f69e56f0f53
GIT binary patch
literal 34673
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

literal 0
HcmV?d00001


From e6ddff5f2525530a167a703e9e2f9e467b47aca5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:15:17 +0300
Subject: [PATCH 122/254] Update README.md

---
 strategy/README.md            |  39 +++++++++++-------
 strategy/etc/strategy.png     | Bin 15393 -> 0 bytes
 strategy/etc/strategy.ucls    |  75 ----------------------------------
 strategy/etc/strategy_1.png   | Bin 28839 -> 0 bytes
 strategy/etc/strategy_urm.png | Bin 0 -> 29282 bytes
 5 files changed, 25 insertions(+), 89 deletions(-)
 delete mode 100644 strategy/etc/strategy.png
 delete mode 100644 strategy/etc/strategy.ucls
 delete mode 100644 strategy/etc/strategy_1.png
 create mode 100644 strategy/etc/strategy_urm.png

diff --git a/strategy/README.md b/strategy/README.md
index 21ac1c94b..b2330ceb8 100644
--- a/strategy/README.md
+++ b/strategy/README.md
@@ -9,17 +9,20 @@ tags:
 ---
 
 ## Also known as
+
 Policy
 
 ## Intent
-Define a family of algorithms, encapsulate each one, and make them interchangeable. Strategy lets the algorithm vary 
-independently from clients that use it.
+
+Define a family of algorithms, encapsulate each one, and make them interchangeable. Strategy lets 
+the algorithm vary independently from clients that use it.
 
 ## Explanation
 
 Real world example
 
-> Slaying dragons is a dangerous profession. With experience it becomes easier. Veteran dragonslayers have developed different fighting strategies against different types of dragons.         
+> Slaying dragons is a dangerous job. With experience it becomes easier. Veteran 
+> dragonslayers have developed different fighting strategies against different types of dragons.         
 
 In plain words
 
@@ -27,7 +30,8 @@ In plain words
 
 Wikipedia says
 
-> In computer programming, the strategy pattern (also known as the policy pattern) is a behavioral software design pattern that enables selecting an algorithm at runtime.
+> In computer programming, the strategy pattern (also known as the policy pattern) is a behavioral 
+> software design pattern that enables selecting an algorithm at runtime.
 
 **Programmatic Example**
 
@@ -71,7 +75,8 @@ public class SpellStrategy implements DragonSlayingStrategy {
 }
 ```
 
-And here is the mighty dragonslayer who is able to pick his fighting strategy based on the opponent.
+And here is the mighty dragonslayer, who is able to pick his fighting strategy based on the 
+opponent.
 
 ```java
 public class DragonSlayer {
@@ -92,7 +97,7 @@ public class DragonSlayer {
 }
 ```
 
-Finally here's dragonslayer in action.
+Finally here's the dragonslayer in action.
 
 ```java
     LOGGER.info("Green dragon spotted ahead!");
@@ -104,19 +109,25 @@ Finally here's dragonslayer in action.
     LOGGER.info("Black dragon lands before you.");
     dragonSlayer.changeStrategy(new SpellStrategy());
     dragonSlayer.goToBattle();
-    
-    // Green dragon spotted ahead!
-    // With your Excalibur you sever the dragon's head!
-    // Red dragon emerges.
-    // You shoot the dragon with the magical crossbow and it falls dead on the ground!
-    // Black dragon lands before you.
-    // You cast the spell of disintegration and the dragon vaporizes in a pile of dust!    
+```
+
+Program output:
+
+```
+    Green dragon spotted ahead!
+    With your Excalibur you sever the dragon's head!
+    Red dragon emerges.
+    You shoot the dragon with the magical crossbow and it falls dead on the ground!
+    Black dragon lands before you.
+    You cast the spell of disintegration and the dragon vaporizes in a pile of dust!    
 ```
 
 ## Class diagram
-![alt text](./etc/strategy_1.png "Strategy")
+
+![alt text](./etc/strategy_urm.png "Strategy")
 
 ## Applicability
+
 Use the Strategy pattern when
 
 * Many related classes differ only in their behavior. Strategies provide a way to configure a class either one of many behaviors
diff --git a/strategy/etc/strategy.png b/strategy/etc/strategy.png
deleted file mode 100644
index ae7442150e3763d24c343597c879895e89544985..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 15393
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

diff --git a/strategy/etc/strategy.ucls b/strategy/etc/strategy.ucls
deleted file mode 100644
index 9eba02417..000000000
--- a/strategy/etc/strategy.ucls
+++ /dev/null
@@ -1,75 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <interface id="1" language="java" name="com.iluwatar.strategy.DragonSlayingStrategy" project="strategy" 
-    file="/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="88" width="186" x="525" y="428"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </interface>  
-  <class id="2" language="java" name="com.iluwatar.strategy.ProjectileStrategy" project="strategy" 
-    file="/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="106" width="151" x="218" y="264"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.strategy.SpellStrategy" project="strategy" 
-    file="/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="106" width="125" x="409" y="264"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="4" language="java" name="com.iluwatar.strategy.DragonSlayer" project="strategy" 
-    file="/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="124" width="284" x="574" y="264"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="5" language="java" name="com.iluwatar.strategy.MeleeStrategy" project="strategy" 
-    file="/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="106" width="127" x="898" y="264"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <realization id="6">    
-    <end type="SOURCE" refId="5"/>    
-    <end type="TARGET" refId="1"/>  
-  </realization>  
-  <realization id="7">    
-    <end type="SOURCE" refId="2"/>    
-    <end type="TARGET" refId="1"/>  
-  </realization>  
-  <realization id="8">    
-    <end type="SOURCE" refId="3"/>    
-    <end type="TARGET" refId="1"/>  
-  </realization>  
-  <association id="9">    
-    <end type="SOURCE" refId="4" navigable="false">      
-      <attribute id="10" name="strategy"/>      
-      <multiplicity id="11" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="1" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/strategy/etc/strategy_1.png b/strategy/etc/strategy_1.png
deleted file mode 100644
index c341e58c6d94456fcfd0215d4e454049b289a154..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 28839
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
NNlsn1SlTq`e*jXXzjy!u

diff --git a/strategy/etc/strategy_urm.png b/strategy/etc/strategy_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e15c3c36e402057e7a20f07956fce737fd4bd94
GIT binary patch
literal 29282
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
Oj}PywD;D3gc=dl2RxgAA

literal 0
HcmV?d00001


From 6cb5b4a6834b2da6b8b8aeae23949b25b94f488d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:19:35 +0300
Subject: [PATCH 123/254] Update README.md

---
 template-method/README.md                   |  23 +++++--
 template-method/etc/template-method.png     | Bin 17911 -> 0 bytes
 template-method/etc/template-method.ucls    |  66 --------------------
 template-method/etc/template-method_1.png   | Bin 34592 -> 0 bytes
 template-method/etc/template_method_urm.png | Bin 0 -> 36470 bytes
 5 files changed, 17 insertions(+), 72 deletions(-)
 delete mode 100644 template-method/etc/template-method.png
 delete mode 100644 template-method/etc/template-method.ucls
 delete mode 100644 template-method/etc/template-method_1.png
 create mode 100644 template-method/etc/template_method_urm.png

diff --git a/template-method/README.md b/template-method/README.md
index 695644488..23dd4d242 100644
--- a/template-method/README.md
+++ b/template-method/README.md
@@ -9,21 +9,30 @@ tags:
 ---
 
 ## Intent
-Define the skeleton of an algorithm in an operation, deferring some steps to subclasses. Template method lets 
-subclasses redefine certain steps of an algorithm without changing the algorithm's structure.
+
+Define the skeleton of an algorithm in an operation, deferring some steps to subclasses. Template 
+Method lets subclasses redefine certain steps of an algorithm without changing the algorithm's 
+structure.
 
 ## Explanation
+
 Real world example
 
-> The general steps in stealing an item are the same. First you pick the target, next you confuse him somehow and finally you steal the item. However there are many ways to implement these steps.   
+> The general steps in stealing an item are the same. First you pick the target, next you confuse 
+> him somehow and finally you steal the item. However there are many ways to implement these steps.   
 
 In plain words
 
-> Template Method pattern outlines the general steps in the parent class and lets the concrete child implementations define the details. 
+> Template Method pattern outlines the general steps in the parent class and lets the concrete child 
+> implementations define the details. 
 
 Wikipedia says
 
-> In object-oriented programming, the template method is one of the behavioral design patterns identified by Gamma et al. in the book Design Patterns. The template method is a method in a superclass, usually an abstract superclass, and defines the skeleton of an operation in terms of a number of high-level steps. These steps are themselves implemented by additional helper methods in the same class as the template method.
+> In object-oriented programming, the template method is one of the behavioral design patterns 
+> identified by Gamma et al. in the book Design Patterns. The template method is a method in a 
+> superclass, usually an abstract superclass, and defines the skeleton of an operation in terms of 
+> a number of high-level steps. These steps are themselves implemented by additional helper methods 
+> in the same class as the template method.
 
 **Programmatic Example**
 
@@ -120,9 +129,11 @@ And finally we show how the halfling thief utilizes the different stealing metho
 ```
 
 ## Class diagram
-![alt text](./etc/template-method_1.png "Template Method")
+
+![alt text](./etc/template_method_urm.png "Template Method")
 
 ## Applicability
+
 The Template Method pattern should be used
 
 * To implement the invariant parts of an algorithm once and leave it up to subclasses to implement the behavior that can vary
diff --git a/template-method/etc/template-method.png b/template-method/etc/template-method.png
deleted file mode 100644
index e197813398efe850f7c292d052b9efef8d9563e9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 17911
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
PkmRJ4B=f~zefs|ZY{Hvt

diff --git a/template-method/etc/template-method.ucls b/template-method/etc/template-method.ucls
deleted file mode 100644
index ec0ce620a..000000000
--- a/template-method/etc/template-method.ucls
+++ /dev/null
@@ -1,66 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.templatemethod.SubtleMethod" project="template-method" 
-    file="/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="142" width="174" x="-90" y="683"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.templatemethod.StealingMethod" project="template-method" 
-    file="/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="159" width="177" x="17" y="484"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.templatemethod.HalflingThief" project="template-method" 
-    file="/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="124" width="235" x="17" y="320"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="4" language="java" name="com.iluwatar.templatemethod.HitAndRunMethod" project="template-method" 
-    file="/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="142" width="174" x="124" y="683"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <association id="5">    
-    <end type="SOURCE" refId="3" navigable="false">      
-      <attribute id="6" name="method"/>      
-      <multiplicity id="7" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="2" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <generalization id="8">    
-    <end type="SOURCE" refId="4"/>    
-    <end type="TARGET" refId="2"/>  
-  </generalization>  
-  <generalization id="9">    
-    <end type="SOURCE" refId="1"/>    
-    <end type="TARGET" refId="2"/>  
-  </generalization>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/template-method/etc/template-method_1.png b/template-method/etc/template-method_1.png
deleted file mode 100644
index f7cd1a07771cc6da554474967af2418b13ef0112..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 34592
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
P1%FC%NZCATQ~&=1?cAFf

diff --git a/template-method/etc/template_method_urm.png b/template-method/etc/template_method_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..b7babccff96da7d88fb99ae5a705c7d4f025904c
GIT binary patch
literal 36470
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
U>vZmeO~f^#f|76Z__aR&f82J0kN^Mx

literal 0
HcmV?d00001


From 87093cf2214df0ff58eea3f07697443fd88a46e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:23:54 +0300
Subject: [PATCH 124/254] Update README.md

---
 thread-pool/README.md               |  34 ++++++++++-----
 thread-pool/etc/thread-pool.png     | Bin 14796 -> 0 bytes
 thread-pool/etc/thread-pool.ucls    |  62 ----------------------------
 thread-pool/etc/thread_pool_urm.png | Bin 0 -> 30120 bytes
 4 files changed, 23 insertions(+), 73 deletions(-)
 delete mode 100644 thread-pool/etc/thread-pool.png
 delete mode 100644 thread-pool/etc/thread-pool.ucls
 create mode 100644 thread-pool/etc/thread_pool_urm.png

diff --git a/thread-pool/README.md b/thread-pool/README.md
index 62a2a3339..de6403fe8 100644
--- a/thread-pool/README.md
+++ b/thread-pool/README.md
@@ -9,16 +9,19 @@ tags:
 ---
 
 ## Intent
-It is often the case that tasks to be executed are short-lived and
-the number of tasks is large. Creating a new thread for each task would make
-the system spend more time creating and destroying the threads than executing
-the actual tasks. Thread Pool solves this problem by reusing existing threads
-and eliminating the latency of creating new threads.
+
+It is often the case that tasks to be executed are short-lived and the number of tasks is large. 
+Creating a new thread for each task would make the system spend more time creating and destroying 
+the threads than executing the actual tasks. Thread Pool solves this problem by reusing existing 
+threads and eliminating the latency of creating new threads.
 
 ## Explanation
+
 Real world example
 
-> We have a large number of relatively short tasks at hand. We need to peel huge amounts of potatoes and serve mighty amount of coffee cups. Creating a new thread for each task would be a waste so we establish a thread pool.       
+> We have a large number of relatively short tasks at hand. We need to peel huge amounts of potatoes 
+> and serve mighty amount of coffee cups. Creating a new thread for each task would be a waste so we 
+> establish a thread pool.       
 
 In plain words
 
@@ -26,11 +29,18 @@ In plain words
 
 Wikipedia says
 
-> In computer programming, a thread pool is a software design pattern for achieving concurrency of execution in a computer program. Often also called a replicated workers or worker-crew model, a thread pool maintains multiple threads waiting for tasks to be allocated for concurrent execution by the supervising program. By maintaining a pool of threads, the model increases performance and avoids latency in execution due to frequent creation and destruction of threads for short-lived tasks. The number of available threads is tuned to the computing resources available to the program, such as a parallel task queue after completion of execution.
+> In computer programming, a thread pool is a software design pattern for achieving concurrency of 
+> execution in a computer program. Often also called a replicated workers or worker-crew model, 
+> a thread pool maintains multiple threads waiting for tasks to be allocated for concurrent 
+> execution by the supervising program. By maintaining a pool of threads, the model increases 
+> performance and avoids latency in execution due to frequent creation and destruction of threads 
+> for short-lived tasks. The number of available threads is tuned to the computing resources 
+> available to the program, such as a parallel task queue after completion of execution.
 
 **Programmatic Example**
 
-Let's first look at our task hierarchy. We have a base class and then concrete CoffeeMakingTask and PotatoPeelingTask.
+Let's first look at our task hierarchy. We have a base class and then concrete `CoffeeMakingTask` 
+and `PotatoPeelingTask`.
 
 ```java
 public abstract class Task {
@@ -88,8 +98,8 @@ public class PotatoPeelingTask extends Task {
 }
 ```
 
-Next we present a runnable Worker class that the thread pool will utilize to handle all the potato peeling and coffee 
-making.
+Next we present a runnable `Worker` class that the thread pool will utilize to handle all the potato 
+peeling and coffee making.
 
 ```java
 public class Worker implements Runnable {
@@ -156,9 +166,11 @@ Now we are ready to show the full example in action.
 ```
 
 ## Class diagram
-![alt text](./etc/thread-pool.png "Thread Pool")
+
+![alt text](./etc/thread_pool_urm.png "Thread Pool")
 
 ## Applicability
+
 Use the Thread Pool pattern when
 
 * You have a large number of short-lived tasks to be executed in parallel
diff --git a/thread-pool/etc/thread-pool.png b/thread-pool/etc/thread-pool.png
deleted file mode 100644
index 9e88a91962466ff5df7768abe04e8f5a9301625d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 14796
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
ZnWDj8L-gf<ztY5#lTnr~mwX=l{{cDy4sQSe

diff --git a/thread-pool/etc/thread-pool.ucls b/thread-pool/etc/thread-pool.ucls
deleted file mode 100644
index 9a4be91b6..000000000
--- a/thread-pool/etc/thread-pool.ucls
+++ /dev/null
@@ -1,62 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.Task" project="thread-pool" 
-    file="/thread-pool/src/main/java/com/iluwatar/Task.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="343" y="579"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.Worker" project="thread-pool" 
-    file="/thread-pool/src/main/java/com/iluwatar/Worker.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="344" y="389"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.CoffeeMakingTask" project="thread-pool" 
-    file="/thread-pool/src/main/java/com/iluwatar/CoffeeMakingTask.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="124" width="156" x="194" y="717"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="4" language="java" name="com.iluwatar.PotatoPeelingTask" project="thread-pool" 
-    file="/thread-pool/src/main/java/com/iluwatar/PotatoPeelingTask.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="124" width="169" x="390" y="717"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <association id="5">    
-    <end type="SOURCE" refId="2" navigable="false">      
-      <attribute id="6" name="task"/>      
-      <multiplicity id="7" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="1" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <generalization id="8">    
-    <end type="SOURCE" refId="4"/>    
-    <end type="TARGET" refId="1"/>  
-  </generalization>  
-  <generalization id="9">    
-    <end type="SOURCE" refId="3"/>    
-    <end type="TARGET" refId="1"/>  
-  </generalization>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/thread-pool/etc/thread_pool_urm.png b/thread-pool/etc/thread_pool_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..3d433824f95a5f9a9076e7094ac81a67a1d982e4
GIT binary patch
literal 30120
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
b{#@VRI%#Toe)9Ys!sQBbs<OE<kA40R?Z3$p

literal 0
HcmV?d00001


From 9017975276b72a05bf70865a7197d577c547e521 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:26:52 +0300
Subject: [PATCH 125/254] Update README.md

---
 throttling/README.md                          |  19 +++-
 throttling/etc/throttling-pattern.png         | Bin 50223 -> 0 bytes
 throttling/etc/throttling-pattern.ucls        |  88 ------------------
 throttling/etc/throttling_urm.png             | Bin 0 -> 53754 bytes
 .../com/iluwatar/throttling/CallsCount.java   |   1 -
 5 files changed, 14 insertions(+), 94 deletions(-)
 delete mode 100644 throttling/etc/throttling-pattern.png
 delete mode 100644 throttling/etc/throttling-pattern.ucls
 create mode 100644 throttling/etc/throttling_urm.png

diff --git a/throttling/README.md b/throttling/README.md
index 257bce54a..4a77638e1 100644
--- a/throttling/README.md
+++ b/throttling/README.md
@@ -10,12 +10,15 @@ tags:
 ---
 
 ## Intent
+
 Ensure that a given client is not able to access service resources more than the assigned limit.
 
 ## Explanation
+
 Real world example
 
-> A large multinational corporation offers API to its customers. The API is rate-limited and each customer can only make certain amount of calls per second.      
+> A large multinational corporation offers API to its customers. The API is rate-limited and each 
+> customer can only make certain amount of calls per second.      
 
 In plain words
 
@@ -23,7 +26,9 @@ In plain words
 
 [Microsoft documentation](https://docs.microsoft.com/en-us/azure/architecture/patterns/throttling) says
 
-> Control the consumption of resources used by an instance of an application, an individual tenant, or an entire service. This can allow the system to continue to function and meet service level agreements, even when an increase in demand places an extreme load on resources.
+> Control the consumption of resources used by an instance of an application, an individual tenant, 
+> or an entire service. This can allow the system to continue to function and meet service level 
+> agreements, even when an increase in demand places an extreme load on resources.
 
 **Programmatic Example**
 
@@ -77,7 +82,8 @@ public final class CallsCount {
 }
 ```
 
-Next we introduce the service that the tenants are calling. To track the call count we use the throttler timer.
+Next we introduce the service that the tenants are calling. To track the call count we use the 
+throttler timer.
 
 ```java
 public interface Throttler {
@@ -134,7 +140,8 @@ class B2BService {
 }
 ```
 
-Now we are ready to see the full example in action. Tenant Adidas is rate-limited to 5 calls per second and Nike to 6.
+Now we are ready to see the full example in action. Tenant Adidas is rate-limited to 5 calls per 
+second and Nike to 6.
 
 ```java
   public static void main(String[] args) {
@@ -171,9 +178,11 @@ Now we are ready to see the full example in action. Tenant Adidas is rate-limite
 
 
 ## Class diagram
-![alt text](./etc/throttling-pattern.png "Throttling pattern class diagram")
+
+![alt text](./etc/throttling_urm.png "Throttling pattern class diagram")
 
 ## Applicability
+
 The Throttling pattern should be used:
 
 * When a service access needs to be restricted to not have high impacts on the performance of the service.
diff --git a/throttling/etc/throttling-pattern.png b/throttling/etc/throttling-pattern.png
deleted file mode 100644
index 59e590aaf6ddf262b0f036cc55655cd4d4e5819b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 50223
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
IU%Tt^U%{#Sh5!Hn

diff --git a/throttling/etc/throttling-pattern.ucls b/throttling/etc/throttling-pattern.ucls
deleted file mode 100644
index 8d4d8a5a2..000000000
--- a/throttling/etc/throttling-pattern.ucls
+++ /dev/null
@@ -1,88 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.2.2" icons="true" always-add-relationships="false" generalizations="true" realizations="true" 
-  associations="true" dependencies="false" nesting-relationships="true" router="FAN">  
-  <class id="1" language="java" name="com.iluwatar.throttling.CallsCount" project="throttling" 
-    file="/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="211" width="256" x="656" y="228"/>    
-    <display autosize="false" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.throttling.Tenant" project="throttling" 
-    file="/throttling/src/main/java/com/iluwatar/throttling/Tenant.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="465" y="524"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.throttling.B2BService" project="throttling" 
-    file="/throttling/src/main/java/com/iluwatar/throttling/B2BService.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="464" y="192"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <interface id="4" language="java" name="com.iluwatar.throttling.timer.Throttler" project="throttling" 
-    file="/throttling/src/main/java/com/iluwatar/throttling/timer/Throttler.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="167" y="174"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </interface>  
-  <class id="5" language="java" name="com.iluwatar.throttling.timer.ThrottleTimerImpl" project="throttling" 
-    file="/throttling/src/main/java/com/iluwatar/throttling/timer/ThrottleTimerImpl.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="166" y="396"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <association id="6">    
-    <end type="SOURCE" refId="3" navigable="false">      
-      <attribute id="7" name="callsCount"/>      
-      <multiplicity id="8" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="1" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <dependency id="9">    
-    <end type="SOURCE" refId="3"/>    
-    <end type="TARGET" refId="4"/>  
-  </dependency>  
-  <dependency id="10">    
-    <end type="SOURCE" refId="3"/>    
-    <end type="TARGET" refId="2"/>  
-  </dependency>  
-  <association id="11">    
-    <end type="SOURCE" refId="5" navigable="false">      
-      <attribute id="12" name="callsCount"/>      
-      <multiplicity id="13" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="1" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <dependency id="14">    
-    <end type="SOURCE" refId="2"/>    
-    <end type="TARGET" refId="1"/>  
-  </dependency>  
-  <realization id="15">    
-    <end type="SOURCE" refId="5"/>    
-    <end type="TARGET" refId="4"/>  
-  </realization>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/throttling/etc/throttling_urm.png b/throttling/etc/throttling_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..a9824e24b5a4da2e24fffd0e96903c138e55d6c3
GIT binary patch
literal 53754
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
ZdsM#qrnOo#>`J&lOG_do(!{i0{2x-4wGsdT

literal 0
HcmV?d00001

diff --git a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
index abfd4d351..115d6781e 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
@@ -24,7 +24,6 @@
 package com.iluwatar.throttling;
 
 import java.util.Map;
-import java.util.Map.Entry;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.atomic.AtomicLong;
 import org.slf4j.Logger;

From 24e8fa1bada5092885c37f6ac3d5230e02172966 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:32:12 +0300
Subject: [PATCH 126/254] Update README.md

---
 tolerant-reader/README.md                   |  36 +++++++++-----
 tolerant-reader/etc/tolerant-reader.png     | Bin 20514 -> 0 bytes
 tolerant-reader/etc/tolerant-reader.ucls    |  52 --------------------
 tolerant-reader/etc/tolerant_reader_urm.png | Bin 0 -> 46129 bytes
 4 files changed, 23 insertions(+), 65 deletions(-)
 delete mode 100644 tolerant-reader/etc/tolerant-reader.png
 delete mode 100644 tolerant-reader/etc/tolerant-reader.ucls
 create mode 100644 tolerant-reader/etc/tolerant_reader_urm.png

diff --git a/tolerant-reader/README.md b/tolerant-reader/README.md
index 922de90de..30517b7b8 100644
--- a/tolerant-reader/README.md
+++ b/tolerant-reader/README.md
@@ -9,14 +9,18 @@ tags:
 ---
 
 ## Intent
-Tolerant Reader is an integration pattern that helps creating robust communication systems. The idea is to be as 
-tolerant as possible when reading data from another service. This way, when the communication schema changes, the 
-readers must not break.
+
+Tolerant Reader is an integration pattern that helps creating robust communication systems. The idea 
+is to be as tolerant as possible when reading data from another service. This way, when the 
+communication schema changes, the readers must not break.
 
 ## Explanation
+
 Real world example
 
-> We are persisting rainbowfish objects to file and later on they need to be restored. What makes it problematic is that rainbowfish data structure is versioned and evolves over time. New version of rainbowfish needs to be able to restore old versions as well.     
+> We are persisting rainbowfish objects to file and later on they need to be restored. What makes it 
+> problematic is that rainbowfish data structure is versioned and evolves over time. New version of 
+> rainbowfish needs to be able to restore old versions as well.     
 
 In plain words
 
@@ -24,11 +28,11 @@ In plain words
 
 [Robustness Principle](https://java-design-patterns.com/principles/#robustness-principle) says
 
-> Be conservative in what you do, be liberal in what you accept from others
+> Be conservative in what you do, be liberal in what you accept from others.
 
 **Programmatic Example**
 
-Here's the versioned rainbowfish. Notice how the second version introduces additional properties.
+Here's the versioned `RainbowFish`. Notice how the second version introduces additional properties.
 
 ```java
 public class RainbowFish implements Serializable {
@@ -104,7 +108,8 @@ public class RainbowFishV2 extends RainbowFish {
 }
 ```
 
-Next we introduce the rainbowfish serializer. This is the class that implements the Tolerant Reader pattern.
+Next we introduce the `RainbowFishSerializer`. This is the class that implements the Tolerant Reader 
+pattern.
 
 ```java
 public final class RainbowFishSerializer {
@@ -185,18 +190,23 @@ And finally here's the full example in action.
     LOGGER.info("deserializedFishV2 name={} age={} length={} weight={}",
         deserializedFishV2.getName(), deserializedFishV2.getAge(),
         deserializedFishV2.getLengthMeters(), deserializedFishV2.getWeightTons());
-    
-    // fishV1 name=Zed age=10 length=11 weight=12
-    // deserializedFishV1 name=Zed age=10 length=11 weight=12
-    // fishV2 name=Scar age=5 length=12 weight=15 sleeping=true hungry=true angry=true
-    // deserializedFishV2 name=Scar age=5 length=12 weight=15
 ```
 
+Program output:
+
+```
+fishV1 name=Zed age=10 length=11 weight=12
+deserializedFishV1 name=Zed age=10 length=11 weight=12
+fishV2 name=Scar age=5 length=12 weight=15 sleeping=true hungry=true angry=true
+deserializedFishV2 name=Scar age=5 length=12 weight=15
+```
 
 ## Class diagram
-![alt text](./etc/tolerant-reader.png "Tolerant Reader")
+
+![alt text](./etc/tolerant_reader_urm.png "Tolerant Reader")
 
 ## Applicability
+
 Use the Tolerant Reader pattern when
 
 * The communication schema can evolve and change and yet the receiving side should not break
diff --git a/tolerant-reader/etc/tolerant-reader.png b/tolerant-reader/etc/tolerant-reader.png
deleted file mode 100644
index 45f0302a2c7bd80c975f20ed67eb700d0224e368..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 20514
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%0APyX
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

diff --git a/tolerant-reader/etc/tolerant-reader.ucls b/tolerant-reader/etc/tolerant-reader.ucls
deleted file mode 100644
index 92e069f8e..000000000
--- a/tolerant-reader/etc/tolerant-reader.ucls
+++ /dev/null
@@ -1,52 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.tolerantreader.RainbowFishSerializer" project="tolerant-reader" 
-    file="/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="123" y="415"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.tolerantreader.RainbowFishV2" project="tolerant-reader" 
-    file="/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="389" y="685"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.tolerantreader.RainbowFish" project="tolerant-reader" 
-    file="/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="389" y="404"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <dependency id="4">    
-    <end type="SOURCE" refId="1"/>    
-    <end type="TARGET" refId="3"/>  
-  </dependency>  
-  <dependency id="5">    
-    <end type="SOURCE" refId="1"/>    
-    <end type="TARGET" refId="2"/>  
-  </dependency>  
-  <generalization id="6">    
-    <end type="SOURCE" refId="2"/>    
-    <end type="TARGET" refId="3"/>  
-  </generalization>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/tolerant-reader/etc/tolerant_reader_urm.png b/tolerant-reader/etc/tolerant_reader_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f5499172ee92da0597eb18b04d99fd0d5b71abe
GIT binary patch
literal 46129
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
LZI!HJ7XSSp3GkwA

literal 0
HcmV?d00001


From 82eb41b6412d6e5df0d9903ce0a145dbf77c5524 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 13 Sep 2020 18:35:23 +0300
Subject: [PATCH 127/254] Update README.md

---
 trampoline/README.md                          | 45 ++++++++++++-------
 .../com/iluwatar/trampoline/Trampoline.java   |  2 +-
 2 files changed, 29 insertions(+), 18 deletions(-)

diff --git a/trampoline/README.md b/trampoline/README.md
index 8831f41e1..4226fc89f 100644
--- a/trampoline/README.md
+++ b/trampoline/README.md
@@ -10,22 +10,23 @@ tags:
 
 ## Intent
 
-Trampoline pattern is used for implementing algorithms recursively in Java without blowing the stack and to interleave 
-the execution of functions without hard coding them together.
+Trampoline pattern is used for implementing algorithms recursively in Java without blowing the stack 
+and to interleave the execution of functions without hard coding them together.
 
 ## Explanation
 
 Recursion is a frequently adopted technique for solving algorithmic problems in a divide and conquer
-style. For example calculating fibonacci accumulating sum and factorials. In these kinds of problems recursion is 
-more straightforward than their loop counterpart. Furthermore recursion may need less code and looks more concise. 
-There is a saying that every recursion problem can be solved using a loop with the cost of writing code that is more
-difficult to understand.
+style. For example calculating fibonacci accumulating sum and factorials. In these kinds of problems 
+recursion is more straightforward than their loop counterpart. Furthermore recursion may need less 
+code and looks more concise. There is a saying that every recursion problem can be solved using 
+a loop with the cost of writing code that is more difficult to understand.
 
-However recursion type solutions have one big caveat. For each recursive call it typically needs an intermediate value 
-stored and there is a limited amount of stack memory available. Running out of stack memory creates a stack overflow
-error and halts the program execution.
+However recursion type solutions have one big caveat. For each recursive call it typically needs 
+an intermediate value stored and there is a limited amount of stack memory available. Running out of 
+stack memory creates a stack overflow error and halts the program execution.
 
-Trampoline pattern is a trick that allows us define recursive algorithms in Java without blowing the stack. 
+Trampoline pattern is a trick that allows us define recursive algorithms in Java without blowing the 
+stack. 
 
 Real world example
 
@@ -37,14 +38,18 @@ In plain words
 
 Wikipedia says
 
-> In Java, trampoline refers to using reflection to avoid using inner classes, for example in event listeners. The time overhead of a reflection call is traded for the space overhead of an inner class. Trampolines in Java usually involve the creation of a GenericListener to pass events to an outer class.
+> In Java, trampoline refers to using reflection to avoid using inner classes, for example in event 
+> listeners. The time overhead of a reflection call is traded for the space overhead of an inner 
+> class. Trampolines in Java usually involve the creation of a GenericListener to pass events to 
+> an outer class.
 
 **Programmatic Example**
 
 Here's the `Trampoline` implementation in Java.
 
-When `get` is called on the returned Trampoline, internally it will iterate calling `jump` on the returned `Trampoline` 
-as long as the concrete instance returned is `Trampoline`, stopping once the returned instance is `done`.
+When `get` is called on the returned Trampoline, internally it will iterate calling `jump` on the 
+returned `Trampoline` as long as the concrete instance returned is `Trampoline`, stopping once the 
+returned instance is `done`.
 
 ```java
 public interface Trampoline<T> {
@@ -68,7 +73,7 @@ public interface Trampoline<T> {
   }
 
   static <T> Trampoline<T> more(final Trampoline<Trampoline<T>> trampoline) {
-    return new Trampoline<T>() {
+    return new Trampoline<>() {
       @Override
       public boolean complete() {
         return false;
@@ -110,15 +115,21 @@ Using the `Trampoline` to get Fibonacci values.
   log.info("start pattern");
   var result = loop(10, 1).result();
   log.info("result {}", result);
-  
-  // start pattern
-  // result 3628800
+```
+
+Program output:
+
+```
+start pattern
+result 3628800
 ```
 
 ## Class diagram
+
 ![alt text](./etc/trampoline.urm.png "Trampoline pattern class diagram")
 
 ## Applicability
+
 Use the Trampoline pattern when
 
 * For implementing tail recursive function. This pattern allows to switch on a stackless operation.
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
index 7b5a564cf..36ad73e3e 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
@@ -82,7 +82,7 @@ public interface Trampoline<T> {
    * @return Trampoline with more work
    */
   static <T> Trampoline<T> more(final Trampoline<Trampoline<T>> trampoline) {
-    return new Trampoline<T>() {
+    return new Trampoline<>() {
       @Override
       public boolean complete() {
         return false;

From d2e070d21d5f6365949c36891f0fa78dffd29db7 Mon Sep 17 00:00:00 2001
From: Christoph Flick <ChFlick@users.noreply.github.com>
Date: Wed, 16 Sep 2020 13:44:50 +0200
Subject: [PATCH 128/254] Fix links on the event sourcing page

---
 event-sourcing/README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/event-sourcing/README.md b/event-sourcing/README.md
index 6d24a40e5..94f293872 100644
--- a/event-sourcing/README.md
+++ b/event-sourcing/README.md
@@ -24,11 +24,11 @@ Use the Event Sourcing pattern when
 
 ## Real world examples
 
-* [The Lmax Architecture] (https://martinfowler.com/articles/lmax.html)
+* [The Lmax Architecture](https://martinfowler.com/articles/lmax.html)
 
 ## Credits
 
-* [Martin Fowler - Event Sourcing] (https://martinfowler.com/eaaDev/EventSourcing.html)
-* [Event Sourcing | Microsoft Docs] (https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)
-* [Reference 3: Introducing Event Sourcing] (https://msdn.microsoft.com/en-us/library/jj591559.aspx)
+* [Martin Fowler - Event Sourcing](https://martinfowler.com/eaaDev/EventSourcing.html)
+* [Event Sourcing | Microsoft Docs](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)
+* [Reference 3: Introducing Event Sourcing](https://msdn.microsoft.com/en-us/library/jj591559.aspx)
 * [Event Sourcing pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)

From a1515b3b523dd5b9d5efb0ab7c1e58e3d3aa9949 Mon Sep 17 00:00:00 2001
From: Mike <admin@xiaod.info>
Date: Tue, 22 Sep 2020 11:13:25 +0800
Subject: [PATCH 129/254] finish builder and chain pattern

---
 zh/builder/README.md | 139 +++++++++++++++++++++++++++++++++++++
 zh/chain/README.md   | 159 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 298 insertions(+)
 create mode 100644 zh/builder/README.md
 create mode 100644 zh/chain/README.md

diff --git a/zh/builder/README.md b/zh/builder/README.md
new file mode 100644
index 000000000..fdbcb08fa
--- /dev/null
+++ b/zh/builder/README.md
@@ -0,0 +1,139 @@
+---
+layout: pattern
+title: Builder
+folder: builder
+permalink: /patterns/builder/
+categories: Creational
+tags:
+ - Gang of Four
+
+---
+
+## 目的
+
+将复杂对象的构造与其表示分开，以便同一构造过程可以创建不同的表示。
+
+## 解释
+
+现实世界例子
+
+> 想象一个角色扮演游戏的角色生成器。最简单的选择是让计算机为你创建角色。但是如果你想选择一些像专业，性别，发色等角色细节时，这个角色生成就变成了一个渐进的过程。当所有选择完成时，该过程也将完成。
+
+用通俗的话说
+
+> 允许你创建不同口味的对象同时避免构造器污染。当一个对象可能有几种口味，或者一个对象的创建涉及到很多步骤时会很有用。
+
+维基百科说
+
+> 建造者模式是一种对象创建的软件设计模式，旨在为伸缩构造器反模式寻找一个解决方案。
+
+说了这么多，让我补充一下什么是伸缩构造函数反模式。我们肯定都见过像下面这样的构造器：
+
+```java
+public Hero(Profession profession, String name, HairType hairType, HairColor hairColor, Armor armor, Weapon weapon) {
+}
+```
+
+就像你看到的构造器参数的数量很快就会失控同时参数的排列方式可能变得难以理解。另外，如果您将来希望添加更多选项，则此参数列表可能会继续增长。这就被称伸缩构造器反模式。
+
+**编程示例**
+
+明智的选择是使用建造者模式。首先我们有一个英雄要创建。
+
+```java
+public final class Hero {
+  private final Profession profession;
+  private final String name;
+  private final HairType hairType;
+  private final HairColor hairColor;
+  private final Armor armor;
+  private final Weapon weapon;
+
+  private Hero(Builder builder) {
+    this.profession = builder.profession;
+    this.name = builder.name;
+    this.hairColor = builder.hairColor;
+    this.hairType = builder.hairType;
+    this.weapon = builder.weapon;
+    this.armor = builder.armor;
+  }
+}
+```
+
+然后我们有创建者
+
+```java
+  public static class Builder {
+    private final Profession profession;
+    private final String name;
+    private HairType hairType;
+    private HairColor hairColor;
+    private Armor armor;
+    private Weapon weapon;
+
+    public Builder(Profession profession, String name) {
+      if (profession == null || name == null) {
+        throw new IllegalArgumentException("profession and name can not be null");
+      }
+      this.profession = profession;
+      this.name = name;
+    }
+
+    public Builder withHairType(HairType hairType) {
+      this.hairType = hairType;
+      return this;
+    }
+
+    public Builder withHairColor(HairColor hairColor) {
+      this.hairColor = hairColor;
+      return this;
+    }
+
+    public Builder withArmor(Armor armor) {
+      this.armor = armor;
+      return this;
+    }
+
+    public Builder withWeapon(Weapon weapon) {
+      this.weapon = weapon;
+      return this;
+    }
+
+    public Hero build() {
+      return new Hero(this);
+    }
+  }
+```
+
+然后可以这样使用
+
+```java
+var mage = new Hero.Builder(Profession.MAGE, "Riobard").withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER).build();
+```
+
+## 类图
+
+![alt text](../../builder/etc/builder.urm.png "Builder class diagram")
+
+## 适用性
+
+使用建造者模式当
+
+* 创建复杂对象的算法应独立于组成对象的零件及其组装方式
+* 构造过程必须允许所构造的对象具有不同的表示形式
+
+## Java世界例子
+
+* [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html)
+* [java.nio.ByteBuffer](http://docs.oracle.com/javase/8/docs/api/java/nio/ByteBuffer.html#put-byte-) as well as similar buffers such as FloatBuffer, IntBuffer and so on.
+* [java.lang.StringBuffer](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuffer.html#append-boolean-)
+* All implementations of [java.lang.Appendable](http://docs.oracle.com/javase/8/docs/api/java/lang/Appendable.html)
+* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder)
+* [Apache Commons Option.Builder](https://commons.apache.org/proper/commons-cli/apidocs/org/apache/commons/cli/Option.Builder.html)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
\ No newline at end of file
diff --git a/zh/chain/README.md b/zh/chain/README.md
new file mode 100644
index 000000000..00d9ef012
--- /dev/null
+++ b/zh/chain/README.md
@@ -0,0 +1,159 @@
+---
+layout: pattern
+title: Chain of responsibility
+folder: chain
+permalink: /patterns/chain/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 目的
+通过给多个对象一个处理请求的机会，避免请求的发送者和它的接收者耦合。串联接收对象并在链条中传递请求直到一个对象处理它。
+
+## 解释
+
+真实世界例子
+
+> 兽王大声命令他的军队。最近响应的是指挥官，然后是军官，然后是士兵。指挥官，军官，士兵这里就形成了一个责任链。
+
+通俗的说
+
+> 它帮助构建一串对象。请求从一个对象中进入并结束然后进入到一个个对象中直到找到合适的处理器。
+
+维基百科说
+
+> 在面向对象设计中，责任链模式是一种由源命令对象和一系列处理对象组成的设计模式。每个处理对象包含了其定义的可处理的命令对象类型的逻辑。剩下的会传递给链条中的下一个处理对象。
+
+**程序示例**
+
+用上面的兽人来翻译我们的示例。首先我们有请求类
+
+```java
+public class Request {
+
+  private final RequestType requestType;
+  private final String requestDescription;
+  private boolean handled;
+
+  public Request(final RequestType requestType, final String requestDescription) {
+    this.requestType = Objects.requireNonNull(requestType);
+    this.requestDescription = Objects.requireNonNull(requestDescription);
+  }
+
+  public String getRequestDescription() { return requestDescription; }
+
+  public RequestType getRequestType() { return requestType; }
+
+  public void markHandled() { this.handled = true; }
+
+  public boolean isHandled() { return this.handled; }
+
+  @Override
+  public String toString() { return getRequestDescription(); }
+}
+
+public enum RequestType {
+  DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
+}
+```
+
+然后是请求处理器的层次结构
+
+```java
+public abstract class RequestHandler {
+  private static final Logger LOGGER = LoggerFactory.getLogger(RequestHandler.class);
+  private final RequestHandler next;
+
+  public RequestHandler(RequestHandler next) {
+    this.next = next;
+  }
+
+  public void handleRequest(Request req) {
+    if (next != null) {
+      next.handleRequest(req);
+    }
+  }
+
+  protected void printHandling(Request req) {
+    LOGGER.info("{} handling request \"{}\"", this, req);
+  }
+
+  @Override
+  public abstract String toString();
+}
+
+public class OrcCommander extends RequestHandler {
+  public OrcCommander(RequestHandler handler) {
+    super(handler);
+  }
+
+  @Override
+  public void handleRequest(Request req) {
+    if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) {
+      printHandling(req);
+      req.markHandled();
+    } else {
+      super.handleRequest(req);
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "Orc commander";
+  }
+}
+
+// OrcOfficer和OrcSoldier的定义与OrcCommander类似
+
+```
+
+然后我们有兽王下达命令并形成链条
+
+```java
+public class OrcKing {
+  RequestHandler chain;
+
+  public OrcKing() {
+    buildChain();
+  }
+
+  private void buildChain() {
+    chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null)));
+  }
+
+  public void makeRequest(Request req) {
+    chain.handleRequest(req);
+  }
+}
+```
+
+然后这样使用它
+
+```java
+var king = new OrcKing();
+king.makeRequest(new Request(RequestType.DEFEND_CASTLE, "defend castle")); // Orc commander handling request "defend castle"
+king.makeRequest(new Request(RequestType.TORTURE_PRISONER, "torture prisoner")); // Orc officer handling request "torture prisoner"
+king.makeRequest(new Request(RequestType.COLLECT_TAX, "collect tax")); // Orc soldier handling request "collect tax"
+```
+
+## 类图
+![alt text](../../chain/etc/chain.urm.png "Chain of Responsibility class diagram")
+
+## 适用性
+使用责任链模式当
+
+* 多于一个对象可能要处理请求，并且处理器并不知道一个优先级。处理器应自动确定。
+* 你想对多个对象之一发出请求而无需明确指定接收者
+* 处理请求的对象集合应该被动态指定时
+
+## Java世界例子
+
+* [java.util.logging.Logger#log()](http://docs.oracle.com/javase/8/docs/api/java/util/logging/Logger.html#log%28java.util.logging.Level,%20java.lang.String%29)
+* [Apache Commons Chain](https://commons.apache.org/proper/commons-chain/index.html)
+* [javax.servlet.Filter#doFilter()](http://docs.oracle.com/javaee/7/api/javax/servlet/Filter.html#doFilter-javax.servlet.ServletRequest-javax.servlet.ServletResponse-javax.servlet.FilterChain-)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)

From dac8e659cef14281244f59addbbcc34fdaaa25c5 Mon Sep 17 00:00:00 2001
From: Mike <admin@xiaod.info>
Date: Tue, 22 Sep 2020 16:50:46 +0800
Subject: [PATCH 130/254] add facade pattern

---
 zh/facade/README.md | 207 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 207 insertions(+)
 create mode 100644 zh/facade/README.md

diff --git a/zh/facade/README.md b/zh/facade/README.md
new file mode 100644
index 000000000..3784a5be6
--- /dev/null
+++ b/zh/facade/README.md
@@ -0,0 +1,207 @@
+---
+layout: pattern
+title: Facade
+folder: facade
+permalink: /patterns/facade/
+categories: Structural
+tags:
+ - Gang Of Four
+ - Decoupling
+---
+
+## 目的
+为一个子系统中的一系列接口提供一个统一的接口。外观定义了一个更高级别的接口以便子系统更容易使用。
+
+## 解释
+
+真实世界的例子
+
+> 一个金矿是怎么工作的？“嗯，矿工下去然后挖金子！”你说。这是你所相信的因为你在使用一个金矿对外提供的一个简单接口，在内部它要却要做很多事情。这个简单的接口对复杂的子系统来说就是一个外观。
+
+用通俗的话说
+
+> 外观模式为一个复杂的子系统提供一个简单的接口。
+
+维基百科说
+
+> 外观是为很大体量的代码（比如类库）提供简单接口的一种对象。
+
+**程序示例**
+
+使用上面金矿的例子。这里我们有矮人的矿工等级制度。
+
+```java
+public abstract class DwarvenMineWorker {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenMineWorker.class);
+
+  public void goToSleep() {
+    LOGGER.info("{} goes to sleep.", name());
+  }
+
+  public void wakeUp() {
+    LOGGER.info("{} wakes up.", name());
+  }
+
+  public void goHome() {
+    LOGGER.info("{} goes home.", name());
+  }
+
+  public void goToMine() {
+    LOGGER.info("{} goes to the mine.", name());
+  }
+
+  private void action(Action action) {
+    switch (action) {
+      case GO_TO_SLEEP:
+        goToSleep();
+        break;
+      case WAKE_UP:
+        wakeUp();
+        break;
+      case GO_HOME:
+        goHome();
+        break;
+      case GO_TO_MINE:
+        goToMine();
+        break;
+      case WORK:
+        work();
+        break;
+      default:
+        LOGGER.info("Undefined action");
+        break;
+    }
+  }
+
+  public void action(Action... actions) {
+    Arrays.stream(actions).forEach(this::action);
+  }
+
+  public abstract void work();
+
+  public abstract String name();
+
+  enum Action {
+    GO_TO_SLEEP, WAKE_UP, GO_HOME, GO_TO_MINE, WORK
+  }
+}
+
+public class DwarvenTunnelDigger extends DwarvenMineWorker {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class);
+
+  @Override
+  public void work() {
+    LOGGER.info("{} creates another promising tunnel.", name());
+  }
+
+  @Override
+  public String name() {
+    return "Dwarven tunnel digger";
+  }
+}
+
+public class DwarvenGoldDigger extends DwarvenMineWorker {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenGoldDigger.class);
+
+  @Override
+  public void work() {
+    LOGGER.info("{} digs for gold.", name());
+  }
+
+  @Override
+  public String name() {
+    return "Dwarf gold digger";
+  }
+}
+
+public class DwarvenCartOperator extends DwarvenMineWorker {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenCartOperator.class);
+
+  @Override
+  public void work() {
+    LOGGER.info("{} moves gold chunks out of the mine.", name());
+  }
+
+  @Override
+  public String name() {
+    return "Dwarf cart operator";
+  }
+}
+
+```
+
+为了操纵所有这些矿工我们有了这个外观
+
+```java
+public class DwarvenGoldmineFacade {
+
+  private final List<DwarvenMineWorker> workers;
+
+  public DwarvenGoldmineFacade() {
+      workers = List.of(
+            new DwarvenGoldDigger(),
+            new DwarvenCartOperator(),
+            new DwarvenTunnelDigger());
+  }
+
+  public void startNewDay() {
+    makeActions(workers, DwarvenMineWorker.Action.WAKE_UP, DwarvenMineWorker.Action.GO_TO_MINE);
+  }
+
+  public void digOutGold() {
+    makeActions(workers, DwarvenMineWorker.Action.WORK);
+  }
+
+  public void endDay() {
+    makeActions(workers, DwarvenMineWorker.Action.GO_HOME, DwarvenMineWorker.Action.GO_TO_SLEEP);
+  }
+
+  private static void makeActions(Collection<DwarvenMineWorker> workers,
+      DwarvenMineWorker.Action... actions) {
+    workers.forEach(worker -> worker.action(actions));
+  }
+}
+```
+
+现在来使用外观
+
+```java
+DwarvenGoldmineFacade facade = new DwarvenGoldmineFacade();
+facade.startNewDay();
+// Dwarf gold digger wakes up.
+// Dwarf gold digger goes to the mine.
+// Dwarf cart operator wakes up.
+// Dwarf cart operator goes to the mine.
+// Dwarven tunnel digger wakes up.
+// Dwarven tunnel digger goes to the mine.
+facade.digOutGold();
+// Dwarf gold digger digs for gold.
+// Dwarf cart operator moves gold chunks out of the mine.
+// Dwarven tunnel digger creates another promising tunnel.
+facade.endDay();
+// Dwarf gold digger goes home.
+// Dwarf gold digger goes to sleep.
+// Dwarf cart operator goes home.
+// Dwarf cart operator goes to sleep.
+// Dwarven tunnel digger goes home.
+// Dwarven tunnel digger goes to sleep.
+```
+
+## 类图
+![alt text](../../facade/etc/facade.urm.png "Facade pattern class diagram")
+
+## 适用性
+使用外观模式当
+
+* 你想为一个复杂的子系统提供一个简单的接口。随着子系统的发展，它们通常会变得更加复杂。多数模式在应用时会导致更多和更少的类。这使子系统更可重用，更易于自定义，但是对于不需要自定义它的客户来说，使用它也变得更加困难。 外观可以提供子系统的简单默认视图，足以满足大多数客户端的需求。只有需要更多可定制性的客户才需要查看外观外的东西（原子系统提供的接口）。
+* 客户端与抽象的实现类之间存在许多依赖关系。 引入外观以使子系统与客户端和其他子系统分离，从而提高子系统的独立性和可移植性。
+* 您想对子系统进行分层。 使用外观来定义每个子系统级别的入口点。 如果子系统是相关的，则可以通过使子系统仅通过其外观相互通信来简化它们之间的依赖性。
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)

From a125879d15e82af50b757baa9f7d81efbd1c3235 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 26 Sep 2020 13:01:58 +0300
Subject: [PATCH 131/254] Update README.md

---
 object-pool/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/object-pool/README.md b/object-pool/README.md
index 6a648ca3e..2f49d6f47 100644
--- a/object-pool/README.md
+++ b/object-pool/README.md
@@ -9,6 +9,10 @@ tags:
  - Performance
 ---
 
+## Also known as
+
+Resource Pool
+
 ## Intent
 
 When objects are expensive to create and they are needed only for short periods of time it is 

From ad435dd2fd079563ad1c3a7bd5c3f2379393ef50 Mon Sep 17 00:00:00 2001
From: Mahendran Mookkiah <mahendran.mookkiah@gmail.com>
Date: Sun, 27 Sep 2020 09:26:19 -0400
Subject: [PATCH 132/254] issue 1500 - using Junit 5 and resolved a build issue

---
 trampoline/pom.xml                                         | 5 -----
 .../src/main/java/com/iluwatar/trampoline/Trampoline.java  | 4 ++--
 .../java/com/iluwatar/trampoline/TrampolineAppTest.java    | 7 +++----
 3 files changed, 5 insertions(+), 11 deletions(-)

diff --git a/trampoline/pom.xml b/trampoline/pom.xml
index fff117bf8..d78236473 100644
--- a/trampoline/pom.xml
+++ b/trampoline/pom.xml
@@ -35,11 +35,6 @@
     </parent>
     <artifactId>trampoline</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <scope>test</scope>
-        </dependency>
 
         <dependency>
             <groupId>org.junit.jupiter</groupId>
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
index 36ad73e3e..16e34ff10 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
@@ -98,12 +98,12 @@ public interface Trampoline<T> {
         return trampoline(this);
       }
 
-      T trampoline(final Trampoline<T> trampoline) {
+      private T trampoline(final Trampoline<T> trampoline) {
         return Stream.iterate(trampoline, Trampoline::jump)
             .filter(Trampoline::complete)
             .findFirst()
             .map(Trampoline::result)
-            .orElseThrow();
+            .get();
       }
     };
   }
diff --git a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
index c5d6571cd..664a95634 100644
--- a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
+++ b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
@@ -23,10 +23,9 @@
 
 package com.iluwatar.trampoline;
 
-import static org.junit.Assert.assertEquals;
-
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
+import org.junit.jupiter.api.Test;
 
 /**
  * Test for trampoline pattern.
@@ -37,7 +36,7 @@ public class TrampolineAppTest {
   @Test
   public void testTrampolineWithFactorialFunction() {
     long result = TrampolineApp.loop(10, 1).result();
-    assertEquals("Be equal", 3628800, result);
+    assertEquals(3_628_800, result);
   }
 
 }
\ No newline at end of file

From b29bd66369d917eed88ddb4126beb9cbc18ec341 Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Thu, 1 Oct 2020 21:09:39 +0530
Subject: [PATCH 133/254] #1510 Improvments done in Circuit Breaker

---
 circuit-breaker/README.md                     | 206 ++++++++++++++----
 circuit-breaker/etc/circuit-breaker.urm.png   | Bin 44822 -> 78626 bytes
 circuit-breaker/etc/circuit-breaker.urm.puml  |  52 +++--
 .../java/com/iluwatar/circuitbreaker/App.java |  76 +++++--
 .../circuitbreaker/CircuitBreaker.java        | 118 ++--------
 .../circuitbreaker/DefaultCircuitBreaker.java | 153 +++++++++++++
 ...Service.java => DelayedRemoteService.java} |  22 +-
 .../circuitbreaker/MonitoringService.java     |  39 +++-
 .../circuitbreaker/QuickRemoteService.java}   |  16 +-
 .../circuitbreaker/RemoteService.java         |  34 +++
 .../RemoteServiceException.java               |  11 +
 .../com/iluwatar/circuitbreaker/AppTest.java  | 129 +++++++++++
 ...st.java => DefaultCircuitBreakerTest.java} |  42 ++--
 .../DelayedRemoteServiceTest.java             |  59 +++++
 .../circuitbreaker/MonitoringServiceTest.java |  41 +++-
 pom.xml                                       |   8 +-
 16 files changed, 754 insertions(+), 252 deletions(-)
 create mode 100644 circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
 rename circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/{DelayedService.java => DelayedRemoteService.java} (81%)
 rename circuit-breaker/src/{test/java/com/iluwatar/circuitbreaker/DelayedServiceTest.java => main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java} (77%)
 create mode 100644 circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
 create mode 100644 circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
 create mode 100644 circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
 rename circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/{CircuitBreakerTest.java => DefaultCircuitBreakerTest.java} (70%)
 create mode 100644 circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java

diff --git a/circuit-breaker/README.md b/circuit-breaker/README.md
index 8d2205f2b..f8c9aca69 100644
--- a/circuit-breaker/README.md
+++ b/circuit-breaker/README.md
@@ -52,40 +52,105 @@ In terms of code, the end user application is:
 
 ```java
 public class App {
-   
+
   private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-    
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line args
+   */
   public static void main(String[] args) {
-    var obj = new MonitoringService();
-    var circuitBreaker = new CircuitBreaker(3000, 1, 2000 * 1000 * 1000); 
+
     var serverStartTime = System.nanoTime();
-    while (true) {
-      LOGGER.info(obj.localResourceResponse());
-      LOGGER.info(obj.remoteResourceResponse(circuitBreaker, serverStartTime));
-      LOGGER.info(circuitBreaker.getState());
-      try {
-        Thread.sleep(5 * 1000); 
-      } catch (InterruptedException e) {
-        LOGGER.error(e.getMessage());
-      }
+
+    var delayedService = new DelayedRemoteService(serverStartTime, 5);
+    //Set the circuit Breaker parameters
+    var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000, 2,
+        2000 * 1000 * 1000);
+
+    var quickService = new QuickRemoteService();
+    //Set the circuit Breaker parameters
+    var quickServiceCircuitBreaker = new DefaultCircuitBreaker(quickService, 3000, 2,
+        2000 * 1000 * 1000);
+
+    //Create an object of monitoring service which makes both local and remote calls
+    var monitoringService = new MonitoringService(delayedServiceCircuitBreaker,
+        quickServiceCircuitBreaker);
+
+    //Fetch response from local resource
+    LOGGER.info(monitoringService.localResourceResponse());
+
+    //Fetch response from delayed service 2 times, to meet the failure threshold
+    LOGGER.info(monitoringService.delayedServiceResponse());
+    LOGGER.info(monitoringService.delayedServiceResponse());
+
+    //Fetch current state of delayed service circuit breaker after crossing failure threshold limit
+    //which is OPEN now
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
+
+    //Meanwhile, the delayed service is down, fetch response from the healthy quick service
+    LOGGER.info(monitoringService.quickServiceResponse());
+    LOGGER.info(quickServiceCircuitBreaker.getState());
+
+    //Wait for the delayed service to become responsive
+    try {
+      Thread.sleep(5000);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
     }
+    //Check the state of delayed circuit breaker, should be HALF_OPEN
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
+
+    //Fetch response from delayed service, which should be healthy by now
+    LOGGER.info(monitoringService.delayedServiceResponse());
+    //As successful response is fetched, it should be CLOSED again.
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
   }
 }
 ```
 
 The monitoring service: 
 
-``` java
+```java
 public class MonitoringService {
 
+  private final CircuitBreaker delayedService;
+
+  private final CircuitBreaker quickService;
+
+  public MonitoringService(CircuitBreaker delayedService, CircuitBreaker quickService) {
+    this.delayedService = delayedService;
+    this.quickService = quickService;
+  }
+
+  //Assumption: Local service won't fail, no need to wrap it in a circuit breaker logic
   public String localResourceResponse() {
     return "Local Service is working";
   }
 
-  public String remoteResourceResponse(CircuitBreaker circuitBreaker, long serverStartTime) {
+  /**
+   * Fetch response from the delayed service (with some simulated startup time).
+   *
+   * @return response string
+   */
+  public String delayedServiceResponse() {
     try {
-      return circuitBreaker.call("delayedService", serverStartTime);
-    } catch (Exception e) {
+      return this.delayedService.attemptRequest();
+    } catch (RemoteServiceException e) {
+      return e.getMessage();
+    }
+  }
+
+  /**
+   * Fetches response from a healthy service without any failure.
+   *
+   * @return response string
+   */
+  public String quickServiceResponse() {
+    try {
+      return this.quickService.attemptRequest();
+    } catch (RemoteServiceException e) {
       return e.getMessage();
     }
   }
@@ -95,76 +160,129 @@ As it can be seen, it does the call to get local resources directly, but it wrap
 remote (costly) service in a circuit breaker object, which prevents faults as follows:
 
 ```java
-public class CircuitBreaker {
+public class DefaultCircuitBreaker implements CircuitBreaker {
+
   private final long timeout;
   private final long retryTimePeriod;
+  private final RemoteService service;
   long lastFailureTime;
   int failureCount;
   private final int failureThreshold;
   private State state;
   private final long futureTime = 1000 * 1000 * 1000 * 1000;
 
-  CircuitBreaker(long timeout, int failureThreshold, long retryTimePeriod) {
+  /**
+   * Constructor to create an instance of Circuit Breaker.
+   *
+   * @param timeout          Timeout for the API request. Not necessary for this simple example
+   * @param failureThreshold Number of failures we receive from the depended service before changing
+   *                         state to 'OPEN'
+   * @param retryTimePeriod  Time period after which a new request is made to remote service for
+   *                         status check.
+   */
+  DefaultCircuitBreaker(RemoteService serviceToCall, long timeout, int failureThreshold,
+      long retryTimePeriod) {
+    this.service = serviceToCall;
+    // We start in a closed state hoping that everything is fine
     this.state = State.CLOSED;
     this.failureThreshold = failureThreshold;
+    // Timeout for the API request.
+    // Used to break the calls made to remote resource if it exceeds the limit
     this.timeout = timeout;
     this.retryTimePeriod = retryTimePeriod;
+    //An absurd amount of time in future which basically indicates the last failure never happened
     this.lastFailureTime = System.nanoTime() + futureTime;
     this.failureCount = 0;
   }
-    
-  private void reset() {
+
+  //Reset everything to defaults
+  @Override
+  public void recordSuccess() {
     this.failureCount = 0;
-    this.lastFailureTime = System.nanoTime() + futureTime; 
+    this.lastFailureTime = System.nanoTime() + futureTime;
     this.state = State.CLOSED;
   }
 
-  private void recordFailure() {
+  @Override
+  public void recordFailure() {
     failureCount = failureCount + 1;
     this.lastFailureTime = System.nanoTime();
   }
-    
-  protected void setState() {
-    if (failureCount > failureThreshold) { 
+
+  //Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
+  protected void evaluateState() {
+    if (failureCount >= failureThreshold) { //Then something is wrong with remote service
       if ((System.nanoTime() - lastFailureTime) > retryTimePeriod) {
+        //We have waited long enough and should try checking if service is up
         state = State.HALF_OPEN;
       } else {
+        //Service would still probably be down
         state = State.OPEN;
       }
     } else {
+      //Everything is working fine
       state = State.CLOSED;
     }
   }
-    
+
+  @Override
   public String getState() {
+    evaluateState();
     return state.name();
   }
-  
-  public void setStateForBypass(State state) {
+
+  /**
+   * Break the circuit beforehand if it is known service is down Or connect the circuit manually if
+   * service comes online before expected.
+   *
+   * @param state State at which circuit is in
+   */
+  @Override
+  public void setState(State state) {
     this.state = state;
+    switch (state) {
+      case OPEN:
+        this.failureCount = failureThreshold;
+        this.lastFailureTime = System.nanoTime();
+        break;
+      case HALF_OPEN:
+        this.failureCount = failureThreshold;
+        this.lastFailureTime = System.nanoTime() - retryTimePeriod;
+        break;
+      default:
+        this.failureCount = 0;
+    }
   }
-   
-  public String call(String serviceToCall, long serverStartTime) throws Exception {
-    setState();
+
+  /**
+   * Executes service call.
+   *
+   * @return Value from the remote resource, stale response or a custom exception
+   */
+  @Override
+  public String attemptRequest() throws RemoteServiceException {
+    evaluateState();
     if (state == State.OPEN) {
+      // return  cached response if no the circuit is in OPEN state
       return "This is stale response from API";
     } else {
-      if (serviceToCall.equals("delayedService")) {
-        var delayedService = new DelayedService(20);
-        var response = delayedService.response(serverStartTime);
-        if (response.split(" ")[3].equals("working")) {
-          reset();
-          return response;
-        } else {
-          recordFailure();
-          throw new Exception("Remote service not responding");
-        }
-      } else {
-        throw new Exception("Unknown Service Name");
+      // Make the API request if the circuit is not OPEN
+      try {
+        //In a real application, this would be run in a thread and the timeout
+        //parameter of the circuit breaker would be utilized to know if service
+        //is working. Here, we simulate that based on server response itself
+        var response = service.call();
+        // Yay!! the API responded fine. Let's reset everything.
+        recordSuccess();
+        return response;
+      } catch (RemoteServiceException ex) {
+        recordFailure();
+        throw ex;
       }
     }
   }
 }
+
 ```
 
 How does the above pattern prevent failures? Let's understand via this finite state machine 
diff --git a/circuit-breaker/etc/circuit-breaker.urm.png b/circuit-breaker/etc/circuit-breaker.urm.png
index 9278ce216665a5088e3f9b90ad310087e0dd9108..cfa7214ba299aed397545b69b7efb3b23b9b60ec 100644
GIT binary patch
literal 78626
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
Tt0PBtoDvh363Tq|%>DlXOs-Q`

literal 44822
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
Z^W<-=fBomR1_J45x$8>Ta;1&D{trZrTqFPh

diff --git a/circuit-breaker/etc/circuit-breaker.urm.puml b/circuit-breaker/etc/circuit-breaker.urm.puml
index 214719002..8128c539a 100644
--- a/circuit-breaker/etc/circuit-breaker.urm.puml
+++ b/circuit-breaker/etc/circuit-breaker.urm.puml
@@ -5,32 +5,51 @@ package com.iluwatar.circuitbreaker {
     + App()
     + main(args : String[]) {static}
   }
-  class CircuitBreaker {
+  interface CircuitBreaker {
+    + attemptRequest() : String {abstract}
+    + getState() : String {abstract}
+    + recordFailure() {abstract}
+    + recordSuccess() {abstract}
+    + setState(State) {abstract}
+  }
+  class DefaultCircuitBreaker {
     ~ failureCount : int
     - failureThreshold : int
     - futureTime : long
     ~ lastFailureTime : long
     - retryTimePeriod : long
+    - service : RemoteService
     - state : State
     - timeout : long
-    ~ CircuitBreaker(timeout : long, failureThreshold : int, retryTimePeriod : long)
-    + call(serviceToCall : String, serverStartTime : long) : String
+    ~ DefaultCircuitBreaker(serviceToCall : RemoteService, timeout : long, failureThreshold : int, retryTimePeriod : long)
+    + attemptRequest() : String
+    # evaluateState()
     + getState() : String
-    - recordFailure()
-    - reset()
-    # setState()
-    + setStateForBypass(state : State)
+    + recordFailure()
+    + recordSuccess()
+    + setState(state : State)
   }
-  class DelayedService {
+  class DelayedRemoteService {
     - delay : int
-    + DelayedService()
-    + DelayedService(delay : int)
-    + response(serverStartTime : long) : String
+    - serverStartTime : long
+    + DelayedRemoteService()
+    + DelayedRemoteService(serverStartTime : long, delay : int)
+    + call() : String
   }
   class MonitoringService {
-    + MonitoringService()
+    - delayedService : CircuitBreaker
+    - quickService : CircuitBreaker
+    + MonitoringService(delayedService : CircuitBreaker, quickService : CircuitBreaker)
+    + delayedServiceResponse() : String
     + localResourceResponse() : String
-    + remoteResourceResponse(circuitBreaker : CircuitBreaker, serverStartTime : long) : String
+    + quickServiceResponse() : String
+  }
+  class QuickRemoteService {
+    + QuickRemoteService()
+    + call() : String
+  }
+  interface RemoteService {
+    + call() : String {abstract}
   }
   enum State {
     + CLOSED {static}
@@ -40,5 +59,10 @@ package com.iluwatar.circuitbreaker {
     + values() : State[] {static}
   }
 }
-CircuitBreaker -->  "-state" State
+DefaultCircuitBreaker -->  "-state" State
+MonitoringService -->  "-delayedService" CircuitBreaker
+DefaultCircuitBreaker -->  "-service" RemoteService
+DefaultCircuitBreaker ..|> CircuitBreaker 
+DelayedRemoteService ..|> RemoteService 
+QuickRemoteService ..|> RemoteService 
 @enduml
\ No newline at end of file
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
index c3465d801..0a88e4e5a 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
@@ -36,17 +36,18 @@ import org.slf4j.LoggerFactory;
  * operational again, so that we can use it
  * </p>
  * <p>
- * In this example, the circuit breaker pattern is demonstrated by using two services: {@link
- * MonitoringService} and {@link DelayedService}. The monitoring service is responsible for calling
- * two services: a local service and a remote service {@link DelayedService} , and by using the
- * circuit breaker construction we ensure that if the call to remote service is going to fail, we
- * are going to save our resources and not make the function call at all, by wrapping our call to
- * the remote service in the circuit breaker object.
+ * In this example, the circuit breaker pattern is demonstrated by using three services: {@link
+ * DelayedRemoteService}, {@link QuickRemoteService} and {@link MonitoringService}. The monitoring
+ * service is responsible for calling three services: a local service, a quick remove service
+ * {@link QuickRemoteService} and a delayed remote service {@link DelayedRemoteService} , and by
+ * using the circuit breaker construction we ensure that if the call to remote service is going to
+ * fail, we are going to save our resources and not make the function call at all, by wrapping our
+ * call to the remote services in the {@link DefaultCircuitBreaker} implementation object.
  * </p>
  * <p>
- * This works as follows: The {@link CircuitBreaker} object can be in one of three states:
- * <b>Open</b>, <b>Closed</b> and <b>Half-Open</b>, which represents the real world circuits. If the
- * state is closed (initial), we assume everything is alright and perform the function call.
+ * This works as follows: The {@link DefaultCircuitBreaker} object can be in one of three states:
+ * <b>Open</b>, <b>Closed</b> and <b>Half-Open</b>, which represents the real world circuits. If
+ * the state is closed (initial), we assume everything is alright and perform the function call.
  * However, every time the call fails, we note it and once it crosses a threshold, we set the state
  * to Open, preventing any further calls to the remote server. Then, after a certain retry period
  * (during which we expect thee service to recover), we make another call to the remote server and
@@ -63,22 +64,51 @@ public class App {
    *
    * @param args command line args
    */
-  @SuppressWarnings("squid:S2189")
   public static void main(String[] args) {
-    //Create an object of monitoring service which makes both local and remote calls
-    var obj = new MonitoringService();
-    //Set the circuit Breaker parameters
-    var circuitBreaker = new CircuitBreaker(3000, 1, 2000 * 1000 * 1000);
+
     var serverStartTime = System.nanoTime();
-    while (true) {
-      LOGGER.info(obj.localResourceResponse());
-      LOGGER.info(obj.remoteResourceResponse(circuitBreaker, serverStartTime));
-      LOGGER.info(circuitBreaker.getState());
-      try {
-        Thread.sleep(5 * 1000);
-      } catch (InterruptedException e) {
-        LOGGER.error(e.getMessage());
-      }
+
+    var delayedService = new DelayedRemoteService(serverStartTime, 5);
+    //Set the circuit Breaker parameters
+    var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000, 2,
+        2000 * 1000 * 1000);
+
+    var quickService = new QuickRemoteService();
+    //Set the circuit Breaker parameters
+    var quickServiceCircuitBreaker = new DefaultCircuitBreaker(quickService, 3000, 2,
+        2000 * 1000 * 1000);
+
+    //Create an object of monitoring service which makes both local and remote calls
+    var monitoringService = new MonitoringService(delayedServiceCircuitBreaker,
+        quickServiceCircuitBreaker);
+
+    //Fetch response from local resource
+    LOGGER.info(monitoringService.localResourceResponse());
+
+    //Fetch response from delayed service 2 times, to meet the failure threshold
+    LOGGER.info(monitoringService.delayedServiceResponse());
+    LOGGER.info(monitoringService.delayedServiceResponse());
+
+    //Fetch current state of delayed service circuit breaker after crossing failure threshold limit
+    //which is OPEN now
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
+
+    //Meanwhile, the delayed service is down, fetch response from the healthy quick service
+    LOGGER.info(monitoringService.quickServiceResponse());
+    LOGGER.info(quickServiceCircuitBreaker.getState());
+
+    //Wait for the delayed service to become responsive
+    try {
+      Thread.sleep(5000);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
     }
+    //Check the state of delayed circuit breaker, should be HALF_OPEN
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
+
+    //Fetch response from delayed service, which should be healthy by now
+    LOGGER.info(monitoringService.delayedServiceResponse());
+    //As successful response is fetched, it should be CLOSED again.
+    LOGGER.info(delayedServiceCircuitBreaker.getState());
   }
 }
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
index 18268b1ce..b05e72104 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
@@ -24,114 +24,22 @@
 package com.iluwatar.circuitbreaker;
 
 /**
- * The circuit breaker class with all configurations.
+ * The Circuit breaker interface.
  */
-public class CircuitBreaker {
-  private final long timeout;
-  private final long retryTimePeriod;
-  long lastFailureTime;
-  int failureCount;
-  private final int failureThreshold;
-  private State state;
-  private final long futureTime = 1000 * 1000 * 1000 * 1000;
+public interface CircuitBreaker {
 
-  /**
-   * Constructor to create an instance of Circuit Breaker.
-   *
-   * @param timeout          Timeout for the API request. Not necessary for this simple example
-   * @param failureThreshold Number of failures we receive from the depended service before changing
-   *                         state to 'OPEN'
-   * @param retryTimePeriod  Time period after which a new request is made to remote service for
-   *                         status check.
-   */
-  CircuitBreaker(long timeout, int failureThreshold, long retryTimePeriod) {
-    // We start in a closed state hoping that everything is fine
-    this.state = State.CLOSED;
-    this.failureThreshold = failureThreshold;
-    // Timeout for the API request.
-    // Used to break the calls made to remote resource if it exceeds the limit
-    this.timeout = timeout;
-    this.retryTimePeriod = retryTimePeriod;
-    //An absurd amount of time in future which basically indicates the last failure never happened
-    this.lastFailureTime = System.nanoTime() + futureTime;
-    this.failureCount = 0;
-  }
+  //Success response. Reset everything to defaults
+  void recordSuccess();
 
-  //Reset everything to defaults
-  private void reset() {
-    this.failureCount = 0;
-    this.lastFailureTime = System.nanoTime() + futureTime;
-    this.state = State.CLOSED;
-  }
+  //Failure response. Handle accordingly and change state if required.
+  void recordFailure();
 
-  private void recordFailure() {
-    failureCount = failureCount + 1;
-    this.lastFailureTime = System.nanoTime();
-  }
+  //Get the current state of circuit breaker
+  String getState();
 
-  protected void setState() {
-    if (failureCount > failureThreshold) { //Then something is wrong with remote service
-      if ((System.nanoTime() - lastFailureTime) > retryTimePeriod) {
-        //We have waited long enough and should try checking if service is up
-        state = State.HALF_OPEN;
-      } else {
-        //Service would still probably be down
-        state = State.OPEN;
-      }
-    } else {
-      //Everything is working fine
-      state = State.CLOSED;
-    }
-  }
+  //Set the specific state manually.
+  void setState(State state);
 
-  public String getState() {
-    return state.name();
-  }
-
-  /**
-   * Break the circuit beforehand if it is known service is down Or connect the circuit manually if
-   * service comes online before expected.
-   *
-   * @param state State at which circuit is in
-   */
-  public void setStateForBypass(State state) {
-    this.state = state;
-  }
-
-  /**
-   * Executes service call.
-   *
-   * @param serviceToCall   The name of the service in String. Can be changed to data URLs in case
-   *                        of web applications
-   * @param serverStartTime Time at which actual server was started which makes calls to this
-   *                        service
-   * @return Value from the remote resource, stale response or a custom exception
-   */
-  public String call(String serviceToCall, long serverStartTime) throws Exception {
-    setState();
-    if (state == State.OPEN) {
-      // return  cached response if no the circuit is in OPEN state
-      return "This is stale response from API";
-    } else {
-      // Make the API request if the circuit is not OPEN
-      if (serviceToCall.equals("delayedService")) {
-        var delayedService = new DelayedService(20);
-        var response = delayedService.response(serverStartTime);
-        //In a real application, this would be run in a thread and the timeout
-        //parameter of the circuit breaker would be utilized to know if service
-        //is working. Here, we simulate that based on server response itself
-        if (response.split(" ")[3].equals("working")) {
-          // Yay!! the API responded fine. Let's reset everything.
-          reset();
-          return response;
-        } else {
-          // Uh-oh!! the call still failed. Let's update that in our records.
-          recordFailure();
-          throw new Exception("Remote service not responding");
-        }
-      } else {
-        throw new Exception("Unknown Service Name");
-      }
-    }
-  }
-}
\ No newline at end of file
+  //Attempt to fetch response from the remote service.
+  String attemptRequest() throws RemoteServiceException;
+}
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
new file mode 100644
index 000000000..1d48c142a
--- /dev/null
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
@@ -0,0 +1,153 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.circuitbreaker;
+
+/**
+ * The delay based Circuit breaker implementation that works in a
+ * CLOSED->OPEN-(retry_time_period)->HALF_OPEN->CLOSED flow with some retry time period for failed
+ * services and a failure threshold for service to open
+ * circuit.
+ */
+public class DefaultCircuitBreaker implements CircuitBreaker {
+
+  private final long timeout;
+  private final long retryTimePeriod;
+  private final RemoteService service;
+  long lastFailureTime;
+  int failureCount;
+  private final int failureThreshold;
+  private State state;
+  private final long futureTime = 1000 * 1000 * 1000 * 1000;
+
+  /**
+   * Constructor to create an instance of Circuit Breaker.
+   *
+   * @param timeout          Timeout for the API request. Not necessary for this simple example
+   * @param failureThreshold Number of failures we receive from the depended service before changing
+   *                         state to 'OPEN'
+   * @param retryTimePeriod  Time period after which a new request is made to remote service for
+   *                         status check.
+   */
+  DefaultCircuitBreaker(RemoteService serviceToCall, long timeout, int failureThreshold,
+      long retryTimePeriod) {
+    this.service = serviceToCall;
+    // We start in a closed state hoping that everything is fine
+    this.state = State.CLOSED;
+    this.failureThreshold = failureThreshold;
+    // Timeout for the API request.
+    // Used to break the calls made to remote resource if it exceeds the limit
+    this.timeout = timeout;
+    this.retryTimePeriod = retryTimePeriod;
+    //An absurd amount of time in future which basically indicates the last failure never happened
+    this.lastFailureTime = System.nanoTime() + futureTime;
+    this.failureCount = 0;
+  }
+
+  //Reset everything to defaults
+  @Override
+  public void recordSuccess() {
+    this.failureCount = 0;
+    this.lastFailureTime = System.nanoTime() + futureTime;
+    this.state = State.CLOSED;
+  }
+
+  @Override
+  public void recordFailure() {
+    failureCount = failureCount + 1;
+    this.lastFailureTime = System.nanoTime();
+  }
+
+  //Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
+  protected void evaluateState() {
+    if (failureCount >= failureThreshold) { //Then something is wrong with remote service
+      if ((System.nanoTime() - lastFailureTime) > retryTimePeriod) {
+        //We have waited long enough and should try checking if service is up
+        state = State.HALF_OPEN;
+      } else {
+        //Service would still probably be down
+        state = State.OPEN;
+      }
+    } else {
+      //Everything is working fine
+      state = State.CLOSED;
+    }
+  }
+
+  @Override
+  public String getState() {
+    evaluateState();
+    return state.name();
+  }
+
+  /**
+   * Break the circuit beforehand if it is known service is down Or connect the circuit manually if
+   * service comes online before expected.
+   *
+   * @param state State at which circuit is in
+   */
+  @Override
+  public void setState(State state) {
+    this.state = state;
+    switch (state) {
+      case OPEN:
+        this.failureCount = failureThreshold;
+        this.lastFailureTime = System.nanoTime();
+        break;
+      case HALF_OPEN:
+        this.failureCount = failureThreshold;
+        this.lastFailureTime = System.nanoTime() - retryTimePeriod;
+        break;
+      default:
+        this.failureCount = 0;
+    }
+  }
+
+  /**
+   * Executes service call.
+   *
+   * @return Value from the remote resource, stale response or a custom exception
+   */
+  @Override
+  public String attemptRequest() throws RemoteServiceException {
+    evaluateState();
+    if (state == State.OPEN) {
+      // return  cached response if no the circuit is in OPEN state
+      return "This is stale response from API";
+    } else {
+      // Make the API request if the circuit is not OPEN
+      try {
+        //In a real application, this would be run in a thread and the timeout
+        //parameter of the circuit breaker would be utilized to know if service
+        //is working. Here, we simulate that based on server response itself
+        var response = service.call();
+        // Yay!! the API responded fine. Let's reset everything.
+        recordSuccess();
+        return response;
+      } catch (RemoteServiceException ex) {
+        recordFailure();
+        throw ex;
+      }
+    }
+  }
+}
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
similarity index 81%
rename from circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedService.java
rename to circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
index 13861923b..f4add64fc 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
@@ -27,7 +27,9 @@ package com.iluwatar.circuitbreaker;
  * This simulates the remote service It responds only after a certain timeout period (default set to
  * 20 seconds).
  */
-public class DelayedService {
+public class DelayedRemoteService implements RemoteService {
+
+  private final long serverStartTime;
   private final int delay;
 
   /**
@@ -35,22 +37,23 @@ public class DelayedService {
    *
    * @param delay the delay after which service would behave properly, in seconds
    */
-  public DelayedService(int delay) {
+  public DelayedRemoteService(long serverStartTime, int delay) {
+    this.serverStartTime = serverStartTime;
     this.delay = delay;
   }
 
-  public DelayedService() {
-    this.delay = 60;
+  public DelayedRemoteService() {
+    this.serverStartTime = System.nanoTime();
+    this.delay = 20;
   }
 
   /**
    * Responds based on delay, current time and server start time if the service is down / working.
    *
-   * @param serverStartTime Time at which actual server was started which makes calls to this
-   *                        service
    * @return The state of the service
    */
-  public String response(long serverStartTime) {
+  @Override
+  public String call() throws RemoteServiceException {
     var currentTime = System.nanoTime();
     //Since currentTime and serverStartTime are both in nanoseconds, we convert it to
     //seconds by diving by 10e9 and ensure floating point division by multiplying it
@@ -58,9 +61,8 @@ public class DelayedService {
     //send the reply
     if ((currentTime - serverStartTime) * 1.0 / (1000 * 1000 * 1000) < delay) {
       //Can use Thread.sleep() here to block and simulate a hung server
-      return "Delayed service is down";
-    } else {
-      return "Delayed service is working";
+      throw new RemoteServiceException("Delayed service is down");
     }
+    return "Delayed service is working";
   }
 }
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
index e91367175..3fb8d8396 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
@@ -24,28 +24,47 @@
 package com.iluwatar.circuitbreaker;
 
 /**
- * The service class which makes local and remote calls Uses {@link CircuitBreaker} object to ensure
- * remote calls don't use up resources.
+ * The service class which makes local and remote calls Uses {@link DefaultCircuitBreaker} object to
+ * ensure remote calls don't use up resources.
  */
 public class MonitoringService {
 
+  private final CircuitBreaker delayedService;
+
+  private final CircuitBreaker quickService;
+
+  public MonitoringService(CircuitBreaker delayedService, CircuitBreaker quickService) {
+    this.delayedService = delayedService;
+    this.quickService = quickService;
+  }
+
   //Assumption: Local service won't fail, no need to wrap it in a circuit breaker logic
   public String localResourceResponse() {
     return "Local Service is working";
   }
 
   /**
-   * Try to get result from remote server.
+   * Fetch response from the delayed service (with some simulated startup time).
    *
-   * @param circuitBreaker  The circuitBreaker object with all parameters
-   * @param serverStartTime Time at which actual server was started which makes calls to this
-   *                        service
-   * @return result from the remote response or exception raised by it.
+   * @return response string
    */
-  public String remoteResourceResponse(CircuitBreaker circuitBreaker, long serverStartTime) {
+  public String delayedServiceResponse() {
     try {
-      return circuitBreaker.call("delayedService", serverStartTime);
-    } catch (Exception e) {
+      return this.delayedService.attemptRequest();
+    } catch (RemoteServiceException e) {
+      return e.getMessage();
+    }
+  }
+
+  /**
+   * Fetches response from a healthy service without any failure.
+   *
+   * @return response string
+   */
+  public String quickServiceResponse() {
+    try {
+      return this.quickService.attemptRequest();
+    } catch (RemoteServiceException e) {
       return e.getMessage();
     }
   }
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedServiceTest.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
similarity index 77%
rename from circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedServiceTest.java
rename to circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
index af747f794..1b73bc0e3 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedServiceTest.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
@@ -23,19 +23,13 @@
 
 package com.iluwatar.circuitbreaker;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
-import org.junit.jupiter.api.Test;
-
 /**
- * Monitoring Service test
+ * A quick response remote service, that responds healthy without any delay or failure.
  */
-public class DelayedServiceTest {
+public class QuickRemoteService implements RemoteService {
 
-  //Improves code coverage
-  @Test
-  public void testDefaultConstructor() {
-    var obj = new DelayedService();
-    assertEquals(obj.response(System.nanoTime()), "Delayed service is down");
+  @Override
+  public String call() throws RemoteServiceException {
+    return "Quick Service is working";
   }
 }
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
new file mode 100644
index 000000000..3c2fd9c78
--- /dev/null
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
@@ -0,0 +1,34 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.circuitbreaker;
+
+/**
+ * The Remote service interface, used by {@link CircuitBreaker} for fetching response from remote
+ * services.
+ */
+public interface RemoteService {
+
+  //Fetch response from remote service.
+  String call() throws RemoteServiceException;
+}
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
new file mode 100644
index 000000000..f384f5a41
--- /dev/null
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
@@ -0,0 +1,11 @@
+package com.iluwatar.circuitbreaker;
+
+/**
+ * Exception thrown when {@link RemoteService} does not respond successfully.
+ */
+public class RemoteServiceException extends Exception {
+
+  public RemoteServiceException(String message) {
+    super(message);
+  }
+}
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
new file mode 100644
index 000000000..3b4041103
--- /dev/null
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
@@ -0,0 +1,129 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.circuitbreaker;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+/**
+ * App Test showing usage of circuit breaker.
+ */
+public class AppTest {
+
+  //Startup delay for delayed service (in seconds)
+  private static final int STARTUP_DELAY = 4;
+
+  //Number of failed requests for circuit breaker to open
+  private static final int FAILURE_THRESHOLD = 1;
+
+  //Time period in seconds for circuit breaker to retry service
+  private static final int RETRY_PERIOD = 2;
+
+  private MonitoringService monitoringService;
+
+  private CircuitBreaker delayedServiceCircuitBreaker;
+
+  private CircuitBreaker quickServiceCircuitBreaker;
+
+  /**
+   * Setup the circuit breakers and services, where {@link DelayedRemoteService} will be start with
+   * a delay of 4 seconds and a {@link QuickRemoteService} responding healthy. Both services are
+   * wrapped in a {@link DefaultCircuitBreaker} implementation with failure threshold of 1 failure
+   * and retry time period of 2 seconds.
+   */
+  @BeforeEach
+  public void setupCircuitBreakers() {
+    var delayedService = new DelayedRemoteService(System.nanoTime(), STARTUP_DELAY);
+    //Set the circuit Breaker parameters
+    delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
+        FAILURE_THRESHOLD,
+        RETRY_PERIOD * 1000 * 1000 * 1000);
+
+    var quickService = new QuickRemoteService();
+    //Set the circuit Breaker parameters
+    quickServiceCircuitBreaker = new DefaultCircuitBreaker(quickService, 3000, FAILURE_THRESHOLD,
+        RETRY_PERIOD * 1000 * 1000 * 1000);
+
+    monitoringService = new MonitoringService(delayedServiceCircuitBreaker,
+        quickServiceCircuitBreaker);
+
+  }
+
+  @Test
+  public void testFailure_OpenStateTransition() {
+    //Calling delayed service, which will be unhealthy till 4 seconds
+    assertEquals("Delayed service is down", monitoringService.delayedServiceResponse());
+    //As failure threshold is "1", the circuit breaker is changed to OPEN
+    assertEquals("OPEN", delayedServiceCircuitBreaker.getState());
+    //As circuit state is OPEN, we expect a quick fallback response from circuit breaker.
+    assertEquals("This is stale response from API", monitoringService.delayedServiceResponse());
+
+    //Meanwhile, the quick service is responding and the circuit state is CLOSED
+    assertEquals("Quick Service is working", monitoringService.quickServiceResponse());
+    assertEquals("CLOSED", quickServiceCircuitBreaker.getState());
+
+  }
+
+  @Test
+  public void testFailure_HalfOpenStateTransition() {
+    //Calling delayed service, which will be unhealthy till 4 seconds
+    assertEquals("Delayed service is down", monitoringService.delayedServiceResponse());
+    //As failure threshold is "1", the circuit breaker is changed to OPEN
+    assertEquals("OPEN", delayedServiceCircuitBreaker.getState());
+
+    //Waiting for recovery period of 2 seconds for circuit breaker to retry service.
+    try {
+      Thread.sleep(2000);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
+    }
+    //After 2 seconds, the circuit breaker should move to "HALF_OPEN" state and retry fetching response from service again
+    assertEquals("HALF_OPEN", delayedServiceCircuitBreaker.getState());
+
+  }
+
+  @Test
+  public void testRecovery_ClosedStateTransition() {
+    //Calling delayed service, which will be unhealthy till 4 seconds
+    assertEquals("Delayed service is down", monitoringService.delayedServiceResponse());
+    //As failure threshold is "1", the circuit breaker is changed to OPEN
+    assertEquals("OPEN", delayedServiceCircuitBreaker.getState());
+
+    //Waiting for 4 seconds, which is enough for DelayedService to become healthy and respond successfully.
+    try {
+      Thread.sleep(4000);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
+    }
+    //As retry period is 2 seconds (<4 seconds of wait), hence the circuit breaker should be back in HALF_OPEN state.
+    assertEquals("HALF_OPEN", delayedServiceCircuitBreaker.getState());
+    //Check the success response from delayed service.
+    assertEquals("Delayed service is working", monitoringService.delayedServiceResponse());
+    //As the response is success, the state should be CLOSED
+    assertEquals("CLOSED", delayedServiceCircuitBreaker.getState());
+  }
+
+}
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/CircuitBreakerTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
similarity index 70%
rename from circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/CircuitBreakerTest.java
rename to circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
index 98b59a6ae..4d300b36f 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/CircuitBreakerTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
@@ -25,56 +25,60 @@ package com.iluwatar.circuitbreaker;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
+import java.rmi.Remote;
 import org.junit.jupiter.api.Test;
 
 /**
  * Circuit Breaker test
  */
-public class CircuitBreakerTest {
+public class DefaultCircuitBreakerTest {
 
   //long timeout, int failureThreshold, long retryTimePeriod
   @Test
-  public void testSetState() {
-    var circuitBreaker = new CircuitBreaker(1, 1, 100);
+  public void testEvaluateState() {
+    var circuitBreaker = new DefaultCircuitBreaker(null, 1, 1, 100);
     //Right now, failureCount<failureThreshold, so state should be closed
     assertEquals(circuitBreaker.getState(), "CLOSED");
     circuitBreaker.failureCount = 4;
     circuitBreaker.lastFailureTime = System.nanoTime();
-    circuitBreaker.setState();
+    circuitBreaker.evaluateState();
     //Since failureCount>failureThreshold, and lastFailureTime is nearly equal to current time,
     //state should be half-open
     assertEquals(circuitBreaker.getState(), "HALF_OPEN");
     //Since failureCount>failureThreshold, and lastFailureTime is much lesser current time,
     //state should be open
     circuitBreaker.lastFailureTime = System.nanoTime() - 1000 * 1000 * 1000 * 1000;
-    circuitBreaker.setState();
+    circuitBreaker.evaluateState();
     assertEquals(circuitBreaker.getState(), "OPEN");
     //Now set it back again to closed to test idempotency
     circuitBreaker.failureCount = 0;
-    circuitBreaker.setState();
+    circuitBreaker.evaluateState();
     assertEquals(circuitBreaker.getState(), "CLOSED");
   }
 
   @Test
   public void testSetStateForBypass() {
-    var circuitBreaker = new CircuitBreaker(1, 1, 100);
+    var circuitBreaker = new DefaultCircuitBreaker(null, 1, 1, 2000 * 1000 * 1000);
     //Right now, failureCount<failureThreshold, so state should be closed
     //Bypass it and set it to open
-    circuitBreaker.setStateForBypass(State.OPEN);
+    circuitBreaker.setState(State.OPEN);
     assertEquals(circuitBreaker.getState(), "OPEN");
   }
 
   @Test
-  public void testApiResponses() {
-    var circuitBreaker = new CircuitBreaker(1, 1, 100);
-    try {
-      //Call with the paramater start_time set to huge amount of time in past so that service 
-      //replies with "Ok". Also, state is CLOSED in start
-      var serviceStartTime = System.nanoTime() - 60 * 1000 * 1000 * 1000;
-      var response = circuitBreaker.call("delayedService", serviceStartTime);
-      assertEquals(response, "Delayed service is working");
-    } catch (Exception e) {
-      System.out.println(e.getMessage());
-    }
+  public void testApiResponses() throws RemoteServiceException {
+    RemoteService mockService = new RemoteService() {
+      @Override
+      public String call() throws RemoteServiceException {
+        return "Remote Success";
+      }
+    };
+    var circuitBreaker = new DefaultCircuitBreaker(mockService, 1, 1, 100);
+    //Call with the paramater start_time set to huge amount of time in past so that service
+    //replies with "Ok". Also, state is CLOSED in start
+    var serviceStartTime = System.nanoTime() - 60 * 1000 * 1000 * 1000;
+    var response = circuitBreaker.attemptRequest();
+    assertEquals(response, "Remote Success");
+
   }
 }
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
new file mode 100644
index 000000000..21fd80d03
--- /dev/null
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
@@ -0,0 +1,59 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.circuitbreaker;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Monitoring Service test
+ */
+public class DelayedRemoteServiceTest {
+
+  /**
+   * Testing immediate response of the delayed service.
+   *
+   * @throws RemoteServiceException
+   */
+  @Test
+  public void testDefaultConstructor() throws RemoteServiceException {
+    Assertions.assertThrows(RemoteServiceException.class, () -> {
+      var obj = new DelayedRemoteService();
+      obj.call();
+    });
+  }
+
+  /**
+   * Testing server started in past (2 seconds ago) and with a simulated delay of 1 second.
+   *
+   * @throws RemoteServiceException
+   */
+  @Test
+  public void testParameterizedConstructor() throws RemoteServiceException {
+      var obj = new DelayedRemoteService(System.nanoTime()-2000*1000*1000,1);
+      assertEquals("Delayed service is working",obj.call());
+  }
+}
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
index 71ede3e1c..f6b802b96 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
@@ -35,28 +35,45 @@ public class MonitoringServiceTest {
   //long timeout, int failureThreshold, long retryTimePeriod
   @Test
   public void testLocalResponse() {
-    var monitoringService = new MonitoringService();
+    var monitoringService = new MonitoringService(null,null);
     var response = monitoringService.localResourceResponse();
     assertEquals(response, "Local Service is working");
   }
 
   @Test
-  public void testRemoteResponse() {
-    var monitoringService = new MonitoringService();
-    var circuitBreaker = new CircuitBreaker(1, 1, 100);
+  public void testDelayedRemoteResponseSuccess() {
+    var delayedService = new DelayedRemoteService(System.nanoTime()-2*1000*1000*1000, 2);
+    var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
+        1,
+        2 * 1000 * 1000 * 1000);
+
+    var monitoringService = new MonitoringService(delayedServiceCircuitBreaker,null);
     //Set time in past to make the server work
-    var serverStartTime = System.nanoTime() / 10;
-    var response = monitoringService.remoteResourceResponse(circuitBreaker, serverStartTime);
+    var response = monitoringService.delayedServiceResponse();
     assertEquals(response, "Delayed service is working");
   }
 
   @Test
-  public void testRemoteResponse2() {
-    var monitoringService = new MonitoringService();
-    var circuitBreaker = new CircuitBreaker(1, 1, 100);
+  public void testDelayedRemoteResponseFailure() {
+    var delayedService = new DelayedRemoteService(System.nanoTime(), 2);
+    var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
+        1,
+        2 * 1000 * 1000 * 1000);
+    var monitoringService = new MonitoringService(delayedServiceCircuitBreaker,null);
     //Set time as current time as initially server fails
-    var serverStartTime = System.nanoTime();
-    var response = monitoringService.remoteResourceResponse(circuitBreaker, serverStartTime);
-    assertEquals(response, "Remote service not responding");
+    var response = monitoringService.delayedServiceResponse();
+    assertEquals(response, "Delayed service is down");
+  }
+
+  @Test
+  public void testQuickRemoteServiceResponse() {
+    var delayedService = new QuickRemoteService();
+    var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
+        1,
+        2 * 1000 * 1000 * 1000);
+    var monitoringService = new MonitoringService(delayedServiceCircuitBreaker,null);
+    //Set time as current time as initially server fails
+    var response = monitoringService.delayedServiceResponse();
+    assertEquals(response, "Quick Service is working");
   }
 }
diff --git a/pom.xml b/pom.xml
index 102668588..2e1f904c3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -63,7 +63,7 @@
         <sonar.projectName>Java Design Patterns</sonar.projectName>
     </properties>
     <modules>
-        <module>abstract-factory</module>
+        <!--<module>abstract-factory</module>
         <module>tls</module>
         <module>builder</module>
         <module>factory-method</module>
@@ -181,9 +181,9 @@
         <module>bytecode</module>
         <module>leader-election</module>
         <module>data-locality</module>
-        <module>subclass-sandbox</module>
+        <module>subclass-sandbox</module>-->
         <module>circuit-breaker</module>
-        <module>role-object</module>
+       <!-- <module>role-object</module>
         <module>saga</module>
         <module>double-buffer</module>
         <module>sharding</module>
@@ -196,7 +196,7 @@
         <module>transaction-script</module>
         <module>filterer</module>
         <module>factory</module>
-        <module>separated-interface</module>
+        <module>separated-interface</module>-->
     </modules>
 
     <repositories>

From 4f62070eb243564b42940fe685be5836f6cdd02e Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Thu, 1 Oct 2020 21:13:30 +0530
Subject: [PATCH 134/254] #1510 Revert pom to include all modules

---
 pom.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/pom.xml b/pom.xml
index 2e1f904c3..102668588 100644
--- a/pom.xml
+++ b/pom.xml
@@ -63,7 +63,7 @@
         <sonar.projectName>Java Design Patterns</sonar.projectName>
     </properties>
     <modules>
-        <!--<module>abstract-factory</module>
+        <module>abstract-factory</module>
         <module>tls</module>
         <module>builder</module>
         <module>factory-method</module>
@@ -181,9 +181,9 @@
         <module>bytecode</module>
         <module>leader-election</module>
         <module>data-locality</module>
-        <module>subclass-sandbox</module>-->
+        <module>subclass-sandbox</module>
         <module>circuit-breaker</module>
-       <!-- <module>role-object</module>
+        <module>role-object</module>
         <module>saga</module>
         <module>double-buffer</module>
         <module>sharding</module>
@@ -196,7 +196,7 @@
         <module>transaction-script</module>
         <module>filterer</module>
         <module>factory</module>
-        <module>separated-interface</module>-->
+        <module>separated-interface</module>
     </modules>
 
     <repositories>

From a3753807aebd228faf57f4fa7a6dd18f9e9879b6 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <contact@subho.xyz>
Date: Thu, 1 Oct 2020 22:23:43 +0530
Subject: [PATCH 135/254] add Caching of SonarCloud packages

---
 .github/workflows/maven-ci.yml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 9c9f4fad3..f7bc81695 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -30,29 +30,43 @@ on:
   push:
     branches: [ master ]
 
+
 jobs:
+
   build:
 
     runs-on: ubuntu-20.04
 
     steps:
+
     - uses: actions/checkout@v2
       with:
         # Disabling shallow clone for improving relevancy of SonarQube reporting
         fetch-depth: 0
+
     - name: Set up JDK 11
       uses: actions/setup-java@v1
       with:
         java-version: 11
+
+    - name: Cache SonarCloud packages
+      uses: actions/cache@v2
+      with:
+        path: ~/.sonar/cache
+        key: ${{ runner.os }}-sonar
+        restore-keys: ${{ runner.os }}-sonar
+
     - uses: actions/cache@v2
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
         restore-keys: |
           ${{ runner.os }}-maven-
+
     # Some tests need screen access
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
+
     # The SonarQube analysis is only for the master branch of the main repository.
     # SonarQube scan does not work for forked repositories try changing it to xvfb-run mvn clean verify
     # See https://jira.sonarsource.com/browse/MMF-1371

From ebd38bcfaaf61cc4c2a3616212cddb119526babf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 4 Oct 2020 14:09:36 +0300
Subject: [PATCH 136/254] Update license header

---
 .../com/iluwatar/abstractfactory/Kingdom.java | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
index 82fa0b368..cffcabf68 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.abstractfactory;
 
 public class Kingdom {

From 21ca47a22e4115a232b857343a90a5885302bdac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 4 Oct 2020 14:17:10 +0300
Subject: [PATCH 137/254] Fix build

---
 trampoline/README.md                                            | 2 +-
 .../src/main/java/com/iluwatar/trampoline/Trampoline.java       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/trampoline/README.md b/trampoline/README.md
index 4226fc89f..d2ff7386b 100644
--- a/trampoline/README.md
+++ b/trampoline/README.md
@@ -73,7 +73,7 @@ public interface Trampoline<T> {
   }
 
   static <T> Trampoline<T> more(final Trampoline<Trampoline<T>> trampoline) {
-    return new Trampoline<>() {
+    return new Trampoline<T>() {
       @Override
       public boolean complete() {
         return false;
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
index 36ad73e3e..7b5a564cf 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
@@ -82,7 +82,7 @@ public interface Trampoline<T> {
    * @return Trampoline with more work
    */
   static <T> Trampoline<T> more(final Trampoline<Trampoline<T>> trampoline) {
-    return new Trampoline<>() {
+    return new Trampoline<T>() {
       @Override
       public boolean complete() {
         return false;

From e5d219609df3a4b34233debccd8bed6081ddc783 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 4 Oct 2020 14:17:28 +0300
Subject: [PATCH 138/254] Add missing license headers

---
 factory/pom.xml                               | 24 +++++++++++++++++++
 .../main/java/com/iluwatar/factory/Car.java   | 23 ++++++++++++++++++
 .../java/com/iluwatar/factory/CarType.java    | 23 ++++++++++++++++++
 .../com/iluwatar/factory/CarsFactory.java     | 23 ++++++++++++++++++
 .../java/com/iluwatar/factory/Ferrari.java    | 23 ++++++++++++++++++
 .../main/java/com/iluwatar/factory/Ford.java  | 23 ++++++++++++++++++
 .../java/com/iluwatar/factory/AppTest.java    | 23 ++++++++++++++++++
 .../com/iluwatar/factory/CarsFactoryTest.java | 23 ++++++++++++++++++
 8 files changed, 185 insertions(+)

diff --git a/factory/pom.xml b/factory/pom.xml
index fff262458..17c6863af 100644
--- a/factory/pom.xml
+++ b/factory/pom.xml
@@ -1,3 +1,27 @@
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/factory/src/main/java/com/iluwatar/factory/Car.java b/factory/src/main/java/com/iluwatar/factory/Car.java
index d1d622b9b..22b615342 100644
--- a/factory/src/main/java/com/iluwatar/factory/Car.java
+++ b/factory/src/main/java/com/iluwatar/factory/Car.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 /**
diff --git a/factory/src/main/java/com/iluwatar/factory/CarType.java b/factory/src/main/java/com/iluwatar/factory/CarType.java
index 5878025bd..4855cb89b 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarType.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarType.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 import java.util.function.Supplier;
diff --git a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
index 76b83d0be..0274ecc2e 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 /**
diff --git a/factory/src/main/java/com/iluwatar/factory/Ferrari.java b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
index 590167f81..03a91ec28 100644
--- a/factory/src/main/java/com/iluwatar/factory/Ferrari.java
+++ b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 /**
diff --git a/factory/src/main/java/com/iluwatar/factory/Ford.java b/factory/src/main/java/com/iluwatar/factory/Ford.java
index 13ae7a49e..9a94bb04f 100644
--- a/factory/src/main/java/com/iluwatar/factory/Ford.java
+++ b/factory/src/main/java/com/iluwatar/factory/Ford.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 /**
diff --git a/factory/src/test/java/com/iluwatar/factory/AppTest.java b/factory/src/test/java/com/iluwatar/factory/AppTest.java
index d29ffb6a2..1bc16a734 100644
--- a/factory/src/test/java/com/iluwatar/factory/AppTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/AppTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 import static org.junit.jupiter.api.Assertions.*;
diff --git a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
index fc823c6d4..f69bd1632 100644
--- a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.factory;
 
 import static org.junit.jupiter.api.Assertions.*;

From 5674f3c52eb243f645a1c7399c13530a390ae683 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 4 Oct 2020 11:23:49 +0000
Subject: [PATCH 139/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 51ed89f82..00ebf5d28 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-133-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-134-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -269,6 +269,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
+    <td align="center"><a href="http://christophflick.de"><img src="https://avatars0.githubusercontent.com/u/4465376?v=4" width="100px;" alt=""/><br /><sub><b>Christoph Flick</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ChFlick" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From 578b3528d5ceeb788636ab6d668e0ccd1fb03ba9 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 4 Oct 2020 11:23:50 +0000
Subject: [PATCH 140/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 43103ead1..f39016a28 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1213,6 +1213,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "ChFlick",
+      "name": "Christoph Flick",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/4465376?v=4",
+      "profile": "http://christophflick.de",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 633d45aa67076231247db0faf1ceebd8ab50dd3c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 4 Oct 2020 14:32:50 +0300
Subject: [PATCH 141/254] Fix typo

---
 event-sourcing/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event-sourcing/README.md b/event-sourcing/README.md
index 94f293872..06b7ec0c2 100644
--- a/event-sourcing/README.md
+++ b/event-sourcing/README.md
@@ -29,6 +29,6 @@ Use the Event Sourcing pattern when
 ## Credits
 
 * [Martin Fowler - Event Sourcing](https://martinfowler.com/eaaDev/EventSourcing.html)
-* [Event Sourcing | Microsoft Docs](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)
+* [Event Sourcing in Microsoft's documentation](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)
 * [Reference 3: Introducing Event Sourcing](https://msdn.microsoft.com/en-us/library/jj591559.aspx)
 * [Event Sourcing pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/event-sourcing)

From 195a735814b0b59a43998d9b0bba051d4b43ebcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 4 Oct 2020 14:50:48 +0300
Subject: [PATCH 142/254] #508 fix SpaceStationMir logging

---
 .../java/com/iluwatar/doubledispatch/SpaceStationMir.java   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
index cc61edcdc..5b6535752 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
@@ -45,7 +45,7 @@ public class SpaceStationMir extends GameObject {
 
   @Override
   public void collisionResolve(FlamingAsteroid asteroid) {
-    LOGGER.info(AppConstants.HITS, " {} is damaged! {} is set on fire!", asteroid.getClass()
+    LOGGER.info(AppConstants.HITS + " {} is damaged! {} is set on fire!", asteroid.getClass()
             .getSimpleName(),
         this.getClass().getSimpleName(), this.getClass().getSimpleName(), this.getClass()
             .getSimpleName());
@@ -55,14 +55,14 @@ public class SpaceStationMir extends GameObject {
 
   @Override
   public void collisionResolve(Meteoroid meteoroid) {
-    LOGGER.info(AppConstants.HITS, " {} is damaged!", meteoroid.getClass().getSimpleName(),
+    LOGGER.info(AppConstants.HITS + " {} is damaged!", meteoroid.getClass().getSimpleName(),
         this.getClass().getSimpleName(), this.getClass().getSimpleName());
     setDamaged(true);
   }
 
   @Override
   public void collisionResolve(SpaceStationMir mir) {
-    LOGGER.info(AppConstants.HITS, " {} is damaged!", mir.getClass().getSimpleName(),
+    LOGGER.info(AppConstants.HITS + " {} is damaged!", mir.getClass().getSimpleName(),
         this.getClass().getSimpleName(), this.getClass().getSimpleName());
     setDamaged(true);
   }

From 36d0a3718c7f162f58413d0f01a1695b0028bf1b Mon Sep 17 00:00:00 2001
From: Domenico Sibilio <domenicosibilio@gmail.com>
Date: Tue, 6 Oct 2020 18:24:47 +0200
Subject: [PATCH 143/254] Update README.md

Missing word in sentence.
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 00ebf5d28..0a344a231 100644
--- a/README.md
+++ b/README.md
@@ -31,7 +31,7 @@ This site showcases Java Design Patterns. The solutions have been developed by
 experienced programmers and architects from the open source community. The 
 patterns can be browsed by their high level descriptions or by looking at their
 source code. The source code examples are well commented and can be thought as
-programming tutorials how to implement a specific pattern. We use the most
+programming tutorials on how to implement a specific pattern. We use the most
 popular battle-proven open source Java technologies.
 
 Before you dive into the material, you should be familiar with various

From 7aea765dd168c8d1c817cab0f4374f44ffd4de6c Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Sat, 10 Oct 2020 23:57:53 +0530
Subject: [PATCH 144/254] #1510 Fix review comments

---
 circuit-breaker/README.md                     |  34 ++++++++++--------
 circuit-breaker/etc/ServiceDiagram.PNG        | Bin 24371 -> 23591 bytes
 .../java/com/iluwatar/circuitbreaker/App.java |   3 +-
 .../circuitbreaker/CircuitBreaker.java        |  12 +++----
 .../circuitbreaker/DefaultCircuitBreaker.java |  20 ++++++-----
 .../com/iluwatar/circuitbreaker/AppTest.java  |   8 ++++-
 6 files changed, 44 insertions(+), 33 deletions(-)

diff --git a/circuit-breaker/README.md b/circuit-breaker/README.md
index f8c9aca69..f1792cb24 100644
--- a/circuit-breaker/README.md
+++ b/circuit-breaker/README.md
@@ -19,12 +19,15 @@ cannot bring the whole application down, and we can reconnect to the service as
 
 Real world example
 
-> Imagine a web application that has both local files/images and remote database entries to serve. 
-> The database might not be responding due to a variety of reasons, so if the application keeps 
-> trying to read from the database using multiple threads/processes, soon all of them will hang 
-> causing our entire web application will crash. We should be able to detect this situation and show 
-> the user an appropriate message so that he/she can explore other parts of the app unaffected by 
-> the database failure. 
+> Imagine a web application that has both local files/images and remote services that are used for 
+> fetching data. These remote services may be either healthy and responsive at times, or may become 
+> slow and unresponsive at some point of time due to variety of reasons. So if one of the remote 
+> services is slow or not responding successfully, our application will try to fetch response from 
+> the remote service using multiple threads/processes, soon all of them will hang (also called 
+> [thread starvation](https://en.wikipedia.org/wiki/Starvation_(computer_science))) causing our entire web application to crash. We should be able to detect 
+> this situation and show the user an appropriate message so that he/she can explore other parts of 
+> the app unaffected by the remote service failure. Meanwhile, the other services that are working 
+> normally, should keep functioning unaffected by this failure.
 
 In plain words
 
@@ -65,12 +68,10 @@ public class App {
     var serverStartTime = System.nanoTime();
 
     var delayedService = new DelayedRemoteService(serverStartTime, 5);
-    //Set the circuit Breaker parameters
     var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000, 2,
         2000 * 1000 * 1000);
 
     var quickService = new QuickRemoteService();
-    //Set the circuit Breaker parameters
     var quickServiceCircuitBreaker = new DefaultCircuitBreaker(quickService, 3000, 2,
         2000 * 1000 * 1000);
 
@@ -95,6 +96,7 @@ public class App {
 
     //Wait for the delayed service to become responsive
     try {
+      LOGGER.info("Waiting for delayed service to become responsive");
       Thread.sleep(5000);
     } catch (InterruptedException e) {
       e.printStackTrace();
@@ -166,6 +168,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   private final long retryTimePeriod;
   private final RemoteService service;
   long lastFailureTime;
+  private String lastFailureResponse;
   int failureCount;
   private final int failureThreshold;
   private State state;
@@ -195,7 +198,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
     this.failureCount = 0;
   }
 
-  //Reset everything to defaults
+  // Reset everything to defaults
   @Override
   public void recordSuccess() {
     this.failureCount = 0;
@@ -204,12 +207,14 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   }
 
   @Override
-  public void recordFailure() {
+  public void recordFailure(String response) {
     failureCount = failureCount + 1;
     this.lastFailureTime = System.nanoTime();
+    // Cache the failure response for returning on open state
+    this.lastFailureResponse = response;
   }
 
-  //Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
+  // Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
   protected void evaluateState() {
     if (failureCount >= failureThreshold) { //Then something is wrong with remote service
       if ((System.nanoTime() - lastFailureTime) > retryTimePeriod) {
@@ -263,8 +268,8 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   public String attemptRequest() throws RemoteServiceException {
     evaluateState();
     if (state == State.OPEN) {
-      // return  cached response if no the circuit is in OPEN state
-      return "This is stale response from API";
+      // return cached response if the circuit is in OPEN state
+      return this.lastFailureResponse;
     } else {
       // Make the API request if the circuit is not OPEN
       try {
@@ -276,13 +281,12 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
         recordSuccess();
         return response;
       } catch (RemoteServiceException ex) {
-        recordFailure();
+        recordFailure(ex.getMessage());
         throw ex;
       }
     }
   }
 }
-
 ```
 
 How does the above pattern prevent failures? Let's understand via this finite state machine 
diff --git a/circuit-breaker/etc/ServiceDiagram.PNG b/circuit-breaker/etc/ServiceDiagram.PNG
index 661f1a1058181b689b0724418e598f7b5b245c31..885320a4d9014d18f071638d7075e6987c463fd6 100644
GIT binary patch
literal 23591
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

literal 24371
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

diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
index 0a88e4e5a..302930585 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
@@ -69,12 +69,10 @@ public class App {
     var serverStartTime = System.nanoTime();
 
     var delayedService = new DelayedRemoteService(serverStartTime, 5);
-    //Set the circuit Breaker parameters
     var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000, 2,
         2000 * 1000 * 1000);
 
     var quickService = new QuickRemoteService();
-    //Set the circuit Breaker parameters
     var quickServiceCircuitBreaker = new DefaultCircuitBreaker(quickService, 3000, 2,
         2000 * 1000 * 1000);
 
@@ -99,6 +97,7 @@ public class App {
 
     //Wait for the delayed service to become responsive
     try {
+      LOGGER.info("Waiting for delayed service to become responsive");
       Thread.sleep(5000);
     } catch (InterruptedException e) {
       e.printStackTrace();
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
index b05e72104..92884258b 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
@@ -28,18 +28,18 @@ package com.iluwatar.circuitbreaker;
  */
 public interface CircuitBreaker {
 
-  //Success response. Reset everything to defaults
+  // Success response. Reset everything to defaults
   void recordSuccess();
 
-  //Failure response. Handle accordingly and change state if required.
-  void recordFailure();
+  // Failure response. Handle accordingly with response and change state if required.
+  void recordFailure(String response);
 
-  //Get the current state of circuit breaker
+  // Get the current state of circuit breaker
   String getState();
 
-  //Set the specific state manually.
+  // Set the specific state manually.
   void setState(State state);
 
-  //Attempt to fetch response from the remote service.
+  // Attempt to fetch response from the remote service.
   String attemptRequest() throws RemoteServiceException;
 }
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
index 1d48c142a..6b2f401d5 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
@@ -24,9 +24,8 @@
 package com.iluwatar.circuitbreaker;
 
 /**
- * The delay based Circuit breaker implementation that works in a
- * CLOSED->OPEN-(retry_time_period)->HALF_OPEN->CLOSED flow with some retry time period for failed
- * services and a failure threshold for service to open
+ * The delay based Circuit breaker implementation that works in a CLOSED->OPEN-(retry_time_period)->HALF_OPEN->CLOSED
+ * flow with some retry time period for failed services and a failure threshold for service to open
  * circuit.
  */
 public class DefaultCircuitBreaker implements CircuitBreaker {
@@ -35,6 +34,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   private final long retryTimePeriod;
   private final RemoteService service;
   long lastFailureTime;
+  private String lastFailureResponse;
   int failureCount;
   private final int failureThreshold;
   private State state;
@@ -64,7 +64,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
     this.failureCount = 0;
   }
 
-  //Reset everything to defaults
+  // Reset everything to defaults
   @Override
   public void recordSuccess() {
     this.failureCount = 0;
@@ -73,12 +73,14 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   }
 
   @Override
-  public void recordFailure() {
+  public void recordFailure(String response) {
     failureCount = failureCount + 1;
     this.lastFailureTime = System.nanoTime();
+    // Cache the failure response for returning on open state
+    this.lastFailureResponse = response;
   }
 
-  //Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
+  // Evaluate the current state based on failureThreshold, failureCount and lastFailureTime.
   protected void evaluateState() {
     if (failureCount >= failureThreshold) { //Then something is wrong with remote service
       if ((System.nanoTime() - lastFailureTime) > retryTimePeriod) {
@@ -132,8 +134,8 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
   public String attemptRequest() throws RemoteServiceException {
     evaluateState();
     if (state == State.OPEN) {
-      // return  cached response if no the circuit is in OPEN state
-      return "This is stale response from API";
+      // return cached response if the circuit is in OPEN state
+      return this.lastFailureResponse;
     } else {
       // Make the API request if the circuit is not OPEN
       try {
@@ -145,7 +147,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
         recordSuccess();
         return response;
       } catch (RemoteServiceException ex) {
-        recordFailure();
+        recordFailure(ex.getMessage());
         throw ex;
       }
     }
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
index 3b4041103..d28d316c8 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
@@ -27,12 +27,16 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 /**
  * App Test showing usage of circuit breaker.
  */
 public class AppTest {
 
+  private static final Logger LOGGER = LoggerFactory.getLogger(AppTest.class);
+
   //Startup delay for delayed service (in seconds)
   private static final int STARTUP_DELAY = 4;
 
@@ -79,7 +83,7 @@ public class AppTest {
     //As failure threshold is "1", the circuit breaker is changed to OPEN
     assertEquals("OPEN", delayedServiceCircuitBreaker.getState());
     //As circuit state is OPEN, we expect a quick fallback response from circuit breaker.
-    assertEquals("This is stale response from API", monitoringService.delayedServiceResponse());
+    assertEquals("Delayed service is down", monitoringService.delayedServiceResponse());
 
     //Meanwhile, the quick service is responding and the circuit state is CLOSED
     assertEquals("Quick Service is working", monitoringService.quickServiceResponse());
@@ -96,6 +100,7 @@ public class AppTest {
 
     //Waiting for recovery period of 2 seconds for circuit breaker to retry service.
     try {
+      LOGGER.info("Waiting 2s for delayed service to become responsive");
       Thread.sleep(2000);
     } catch (InterruptedException e) {
       e.printStackTrace();
@@ -114,6 +119,7 @@ public class AppTest {
 
     //Waiting for 4 seconds, which is enough for DelayedService to become healthy and respond successfully.
     try {
+      LOGGER.info("Waiting 4s for delayed service to become responsive");
       Thread.sleep(4000);
     } catch (InterruptedException e) {
       e.printStackTrace();

From b689fe0a2635210b0c570bee4ee28209d564a52d Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Sun, 11 Oct 2020 00:11:06 +0530
Subject: [PATCH 145/254] #1510 Fix comment length

---
 .../com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java  | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
index 6b2f401d5..7e45f5709 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
@@ -24,9 +24,9 @@
 package com.iluwatar.circuitbreaker;
 
 /**
- * The delay based Circuit breaker implementation that works in a CLOSED->OPEN-(retry_time_period)->HALF_OPEN->CLOSED
- * flow with some retry time period for failed services and a failure threshold for service to open
- * circuit.
+ * The delay based Circuit breaker implementation that works in a
+ * CLOSED->OPEN-(retry_time_period)->HALF_OPEN->CLOSED flow with some retry time period for failed
+ * services and a failure threshold for service to open circuit.
  */
 public class DefaultCircuitBreaker implements CircuitBreaker {
 

From 242ae6a412702f07c0626ba59153453732cfcc7b Mon Sep 17 00:00:00 2001
From: swarajsaaj <swarajpalsaaj@yahoo.co.in>
Date: Sun, 11 Oct 2020 00:22:28 +0530
Subject: [PATCH 146/254] #1510 Update class diagram

---
 circuit-breaker/etc/circuit-breaker.urm.png  | Bin 78626 -> 80659 bytes
 circuit-breaker/etc/circuit-breaker.urm.puml |   5 +++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/circuit-breaker/etc/circuit-breaker.urm.png b/circuit-breaker/etc/circuit-breaker.urm.png
index cfa7214ba299aed397545b69b7efb3b23b9b60ec..fc90318ec8daa0b4115eafd65cfc710110a374bb 100644
GIT binary patch
literal 80659
zcmbrm1ys~)8$F6*AV?^sAYc#z0@6~0qKGuojYxM69ioIvNrSX>Hw-nDfOJSRbi*)o
z*Z&>-&i8pd=YQ{7_p;Vmt~1R1c<Xtd{p`Kp`6MGHf{RUtje&uIEBfk%EC$BaZVZeI
zi&z)ID{)CPec&H@TVZ8e9SciGQ$2lK3=utZJ!@@SJ>9!+9q$_2+FJ6muvnUEo7+Oo
zOqq2o%x*m9xr2dmanDFz+4is3F)o0|IK+4<j!MluCU6bxbI%`&cu|ejZCo;X^-}0X
zq1Dn+B25C-@=gwAN#yj9@JBBTEk2`Ob;Nyz45W>I6FY?Rh(AdA6|o4Dfqx6O&pWI@
zXAaps<p%;nmtV^>Uz#Mw+8(zixPL?Hrfq?y!E?_FLyq$D+nq90{tmau;_Mjd4}Pqd
z-mBDvd}P&QCei+O04ECd3Y6Atq&|_MefEg;0>=*$D-}&oE6)^92PT8{Z+C-omG+;n
zIRw4(`1DAT;Qclf<4OC?r!cJCf=;b>(LGhw{8~3IicXK*5~XB08MsYV$*Wm+Gwaoe
z&GCyiQzp#Z$UeqF;T99P@O;<BU<1m_obsZWy|=bqzN<uH@}?tbpM22mP`M~9yqQ1~
z(D(s^e!Tsd=+fLXT*;@V4_Ud`KbBt-Bqz<M7a@~5TL_Wmn-NpwcO7AzF+b@#zz}&Y
zAeJ_tS(GLgD<JBiCC2!`<#~QxP%piyF!ZUuo!KX+)oOteW2{WsXL*UKST)aN=vz^d
zSFYqNe-9<}w5WKhlQpVnUrD3#y0Srv$8PG~B2%_PW@uX^J45*e<fo^Tq^en;sne<-
ziYfYtuIk^~!&!@MaPviGnr}Afzkc~0dXJ+s?8y&CpRwnRVQYcfYF^!?Z%`4@g)7a@
zF$34lnD8S%vrnPguOxjEtTI-=T}GO;QWLVYZjV_Y^>qd-B&E$#omcLFwcsaV*<F4}
zKg->dqOy7Oz3Yid=1$iGHz5Ok%i)T|b+4a)@X?u7EKxM(Ufwy4?OzjXD6#bnRgE>~
zA*thVWLmhR`~`9=#>g|OiYo96Wc}LQ_1JBxK<Pkdx*C$Z8}@r~Ik(*P=7kGVZzNX_
z+aRKsu=G?#F7#t3;?R_oEFh+EU$VRQ7->>P1@Tci|Dc)=G5o<LZ%Kj~(mB@f<Uyhu
z^9g4J{Xz2{iYDxbbR~h)t%Z`_RL`qU?uUzRZeu4)evfg&+}5^B9>#7v5nGUL#h$r%
zPK7<BQqRZ0c!weS;+edICNdUBU3%}VIZ0N`OP+xt%=WcV3r*3zh#!w^qS_wMaKAm6
zBVqUJp!GhmXg77s?U8J){-PfIDmp4k!?g4ZV(nYrStZ2IE~e`s4xZs!v+XKC)g=<R
zb>bqpu*I{m&%0ow84J<+&<sNCx1aRKS9;Mg{M%0`)g{z#|BHd~l;&M6#ot~@zeE7T
z{M##GPY*8cnGELYVXVKEm6xYJdHVbBpU%C8*9ts%(17udG-P$OOk5CTkN^G1IP!~6
z!W}lI)2Jw}Ogc8Vwi?g=2<pY>_}^PFFytw_Zo+;_FOg&LPgHF*k=xnXH8wW(a{vCG
zgy5%>c-!yy_Z<!wo4$Y7)z_b&n~N22-fi+H?-l#~oiZ0Rf7HfGwg_m~UmA{32y=&W
zbDF9*7>5bX?Lt=um<S0&y1Tpk`uf`2+e7H2Nk~Y<7}443ub-!v9qwW7CCG+9QmNNe
zG-u1YH?k&QI2eXA0Yl=olAMamJ85ZD*k&l@X_}gv8XFrcDh>=68LUmzu;g6&>mlfW
zyIOH>!^G3KbrlI2#+Ry{_mYK)6Rg#ov-Pj);q<?*lVniRS|+e)Xboe`sKbZsznN+B
zue4j`b=;)Z5Bq&Y^7q3CVD4updnZSGd0I8_#6<0}3TUPM8go@xSeP&i*c>xcQ{?h8
zuU=~?pFJwSOgV<v90B|I5ldWLoR6>aG7gD47_r3!Twh;*+j^?rONj3#_3P|;mb1N@
zv!23?jHM4(@fT@!gjsy>sifKlb2YLwt9h#>BqWj}ngglUx)U*1LxX~XK7IO>mbMVX
zV?zmXd1x+oopDe%rzc4SpOQav*J{2!DqH=1#Y~H01d?<@wOmojjsB%N<?Y*|XO`P}
z`Z_x77UTT8;p@4&A*k_cKIpRi;b2-9hFO0ktB(12Rm-x8HEf7>Zf>qWL(WHYcj;$Z
zditwG$ziiM>Ts8+08wS-p$h1Vtel*Uwe{ny>%T2^!p#iB$+(aZxgvc@1`am1&8;mP
z8yoh0zL<{ob`CDC)CjQgJ3Bi$iaBIVWndX#u>FmRx^ys|4<A0n#!@&hA(6<%MME8(
z22C(E<;7Rmot1bVg}WXct<@AoWa~LQJF9{fWo5D$s|X7>dZ2<89TTHo?F1c(efJJy
zgt}DG)|SJB{o%upVKO+TY$S@gRV2<TNiT85#oP2dzIH^h`-J(veiCO2ZE+J-Wn5cc
z*32Azrf3L`u`;%Exqb)PMrE+%GNPQFF?m&cl;qBxY}pJ-6FZn;h*T_ZBjo1E;f{_~
zl~A-P6ZC4i*=T9s4Kqtw*_*Bq)_<<Vc!nGuLxx;hC-_fUR8x~uZ4qo>_1xm3!^t7k
zsoZp!jl|o0xNr`=29=dZW0m&qCp$_TZCY*zUe(9z4ftoM1^S`N<@&dC5zNfY+t#PY
z2ic_HEFG%I$PiFaNaDcZ@a&OBU(&`v!J5P6tZnlKZ(OgNqD9x|N`@FpOH2DGs&#7|
zz9d-k(+ISdDvtN}SBEm)z}C>vSPPq;ntH~9iHX^`_L<vgZM^zQN=?&`j*gVzHTY3L
z|1jM3NT&mD&?K*Vesc0D4(3%nm+i$HVT@%h;r$e|U63Qc@srsQ=|4_DFE|0_=H^l~
z7Bwfkf?=mk?d=lB13N2&Dz|ubn*5sGuO_WkZFSD{%F7?irpOjV5YkBzmF(doHK5uB
zn{87KK0n*WtDW;yOFomNN<;|>h6D${|L_4<EDfgJ56+VhF8M&d_VWi19t>R6HZ=S(
zJ{PU`Ft1Uw@V04R;vcg-+loKSj{tv_^<nHck>gy4khgE&DkplX6zK~LAT3#Wq07`S
z7Fx{;^`KV|x&+U%6?0T4;I4n{WN(kvWG?f1SXF3(dQ`RF=g;5fqPZ=^#x<&)IID{b
z3KDVISy_49PhCok`|sbsFCi(J;qo(8GMlVz;u=1FU_!!Ot^>ciiJwJS)vror9GQj{
zs2|>uZdoqO2`jItXs9o1ioo&$gVbix!?fREcyx!GgF|<#7weHq;cS7vPZk)|l@vMr
z)$wYz5UycW?5pKq{JFWgkqTFS3q6@7c@9eho5;Q#wY{`>x3@HOQZa9EzDm$1p@(iN
z`+5B&rZsH%5i7`DX>;Gdzi6pk=#15&QB+i19Vtl)PL+%<lrK{)F;>b|*X|!eZed=z
zo-p_A+x=3OE8l8k1wxtlS2|=geVN1y-?Ze?|C#`OcCL%^{(!Fi7lkBTxE40kElau9
zkL21vYi@mnu;Wuf5G5vqUO1%a0BQ=Pq9P&Dm-$*{U|<k2OzSLu&+-f$@g*uJkO%*m
zOgWegsk^vAk$wkaY|N{cgPlFZs}!9)wzfh}dgY-W7Q&i^F5wj`eHnz}QH^Ui!GdI4
zZqBxBZ^qh>YqJ;~dGTJja6w)cof@pw)YME&OcX`ZCs$TXWGV)kREx0=kNAYc2H&;?
zKT?)W2M32!Pfbo);~;-Mrv-I4i}s+mPa#V&!(?`2Ld#O@#L3aIhql0AeYky-j4~JG
z_G0s~k%a9Jwwtq}b6j2}FQV6p1W&dJ6>jl6JpQ9<Fcae<KCRW9!QIbJK}q%Y_68GK
z9mt7Z2a8WqU0hhm#>Hg^g~qb!wZ`(<52*#eDZZ%{C*WMFQEAtg6cM2$CiZz&<L&p4
zH?kjda)xQ<YSqM5`}z41EyqAy4^tvEGhZjY1c}L@Gv+oiapN);F&jI(tE;P5OEag6
zFB9WcRA4`qw5X(;uy;j&7(UL#S0rBHoc)BWJpyJG9v;54+#k(npPP?8fn~La8rvIp
z?&|39ui)b5wgAbgFGFsaO2E(!#;gTLE-i_&tgf!2)07vNUfHwvm6d!Hm)aSAha&0f
z4EHRrPBy*;+W{sU?|#bj$BNv?LU@b^MMsNM&D?nK@{Qu{-wyIqn)kI7ix2Sd@H(Qo
zo3q(|`_((KOCEgPA}<3eHIiQXv(y~lENcDj*BA^qmrzfshHKmfU4xtbZhuhG`~A0J
zmoM5U1QL;w4(6zFKYVBij(tl@i;9ZM!NI{F$c3_%6b7c=SX=w1=bP|tjH*dbPtVB6
z$QQ!G9iZrf^9oA6q_}v9;@^OsKfTr@+_2~V?~4IOu>Oi2DqLzlCYJR`v&w-AgXIZ;
z45`v=uE{Aip1(ifoxwL359b!_$cDdT!AStQexC`3{6#Fp@4y7(ofw7(-{0OMbM3C>
z)xW*MaN++8=)|~a|F@?k-2A@`X3_7P2{#U#^*v7lA>|UL3O8|Htn*K%e>)#Z0{bGK
zOVTq&Ebs<JGnUo1FuY%L&wO}3nZ@fQuz1blgu6Nqz!R{t;?hW&|MRD+FP={>w(g>R
z1-Vj2z;p17{AEY0wU@tU)XjK~mAh|aA;81yGnsG@_RQ)*0Fy;T*aI|le0)sKZT_nH
z7b;Y^eEuohD;Mq2&oOShxVNtopPHJA8ZM%vqg!Z?V)yd$>SaA&;HL@~e*JBaS_&a3
z#K{)fylP_a?<cnH$~2y9BdV@Yvqf98UcDx9tYe>@`6NQ?vJh7MbCpTB-7;cmXlQnJ
z7GUF90Hzie#Q$XgdM6M^y>EkAR+3JQA`)WiHIG=$G<xkbwnM@*s5^_4tbdNXBbD3o
zz(~8IA6aS<p7dlYWWCkVk&}}vDlF`b6JVquJYQyc;{Po|=zjj<P-j__h3)d!{KvFQ
zmGaQuN-L=`JpU;9V}ihn=UDM3DwCAlHg(`(ig}t8R8%zvU2*INo&UB-jSz;`F@)7C
zm-X7@>`M^ch_7K!Ie%8-ip=BPbBPoFbv9iw|F=#Bl`s8RL`Sz|lZPvKw`6aQ;I~rp
zMOk2jl_9)w-qk#vIN#c*26rueWY*im`^jS~XeoLphwTb{Zr+To)Oe-V#jR|$&`F_G
zS?X2p*r8U2x3SjhwA@GgykXg;JUdOAPEDnMx{b4Jn#s_xd>2RPA<3@@*v9?e_Qos6
zM9*$92wFJ5)ofji($T0!T=&23Z*r^Bv635id&hj~LGE)CGZPXirdOjxj^OEJ^-<A-
z#rcmdx@*lRYf*I4w443kHEY~zyYmkN1<j`?WM!~Y4?LaDPQzmPuBxc?f9t@yzO7P*
zdf>KWpooagFVf9X)z7QC`HJS4VJ>)r0xQw`{&^t2gM%XkdeKfW^Ltx?V+B@{^~pv@
zW%MjQ(B#AjD_osC5=h*sruR$l?cVJ0sAT=Zy{yYe)BF0D8yz?1+HSM5&g5hpyPmmT
z)RJ4@UYa%d7}<XrRcX(Xr#8sIwL5dP7s&5qYdQhX^TAzd%#$J^rkKNNlfMbWY3m#F
zy!QMerYrSM+h`m6Rn*)nR(&SjugG2`|4;Z`LJ_dBzmyjH7)kx9hps(dXoh*AsZ%Q@
zN0+9}-c4?B;440Y+dtZc-<WJ7`))j`h%heY;{--EICQ1^N6^&3fMSV>TGh@#mi?N(
z`<_NsR203l6hCz`XaB*pZ-$iAPR8Sh=}S@U^ub(4!{3v=Vcp~Kxb;X!b8}N)k~l3l
z9*wFC)2*i3jh}CKcJ6}JecjTZ74_kYSMRQ}O8?uQs`)V*8YY4@WKYt{a51|J%W*)F
zLa4pn$zi!a8BZL8tFdP3W%vWE9hLuN1@8X^gs%B6j<ot-3iV5iVaU5C4XT_tI_5h!
z1Tsw~P{Ch|QJvv=TOHV&9?mbDK6~S?4sCw9CvdofQ*Jd=+Yx=$dDm3XaZ|=EthiXu
z%j-5i<*dwHclR67%a9ACHO@Q6w5vZ-#GSncJWD)V<+a-*-S$v=MeV%&RSz6jM^3+e
zOHxtEYU_`6h*I_SyE9bn%r~s5Yp<RHD-w^8GC>S2l}(fuel28Lr+Aj$^)H8oy)IX7
z8l^1iH(pzE&%bioCWL0Ls@S~H)c~&Y3}Pv0bsw(C#ICT!KJxOVxBF>%NEj7wacg7a
zGdp5^yInF96GqX?bC-@6;^ndwvYNPQt|4%+ck?$_2Jz+dG*6JjW`$wHg+lh(oQzqj
z)Wjnr1H^H%q<i1Yn;XUK>`(|RI2^UmmBv_hcL_^Kfb^eH7DaASEXhlYJ3yg+#|RM?
z8BtG%lntb5jt=Gjo+AYjn5f)i-1R)_5=_J1;4m^W(o74WscGGu`#Cm7uBsdvlA0>*
zHD;=E??R2W9u@Spa^$^n3}{#jyMgTfJIyWB_cr7;`_mwoutN%^jA50LWTzeDJZ09T
zc9Q)h+(d})FXH47q;rr5c|jWTY=2Qshp1NF?}n`u&9WqK@Y3Z}4nsUG6u$(%qm#H*
zKW|y%c7jnYEJ&<K|EN7-uG+bVfw@z_T9*l@()~aW$87xMNW_qbeT!W5;^|DF^v=*X
zuZ7Jyz4j^Q&<WV<O;6B_T97IYRPl+Lhy>>5X^g&SQ7W4$<ZBxcaB~5D?9P0LZ>ZX2
zAeZOiqkoCAvi-fO1xu=(aYHhD$9+zf0_XmaHz%W^_WCb4Hf=S+$~Dz(w!G(zF1Q|m
z;J>jR#&`rdv3;MCa$rBvSQPAmSs8e%=V-ZKLbbC?T3q@}wh)`RH{9jO3{mYo{M>u{
z&F$?ES9wTC<_ij_<h0LDHK?!cH~Ll@h1o3F<&)U0X_}jvl~~PG{mK}~$+|PpREcX$
zN`YP<kP~0P$si)85O8sjEUzFedpRa7jEjf09=<AU*Q{r+sJyq>vr}3MEi*e3^di|0
zxZ7v&&!qk(itu(U0juau7~QOyIbm;rH#)IVx=9|7mgd`ACqxX`?F{Id5e-Vj?`vxI
zallpT<Wh=0N1rEOd)s2y8Gmy+DSpw>meI1J`}YrrM+R~f+S(f$95<##O^L0H?@$OJ
z+S`j?KWL7O+<5eXw&v7He|3ZeWDZ{v$<RwbXNL+-n3y_1#-tF0KT|kVc1n}VN%wRz
z>d!PXMK)u59D(Fg93&q#LItT(Dz6wVUXm*<GIi&(yPj-ZSp5S96EinxT%m+iH8rJn
zcE)O@n|Q2Y3Az4Dm5BmbI=IS7^rAf*D~lcy`AXWIg-|XenCJVdS;g+kX-8atu(6t}
zvmA~~5rI&;%|BOb{ZnK4=y3xfNz;0ib5tseT5*;zmGQF?T2BJV)qiG$#7VE>9Z}}7
z5Imaopo;ey!=EzD1q?Od&#>;fP`>z=dR)Ht(gOAP2|bG!{(zq3DHkV`?$E{$LpVM7
zfYiTzpb_7O-P!MztKKVF#o?}U3!Xyy>bCq70g-N17dZl<{g{vcjJlh?RP&U9e&a~8
z3TVqkh^~P-Z_w9+egidxlZ<5YDnb2%`actM=#J3HVQj~d>4qzl>vS>2HAdOpCh)-u
zCY_maNya_ND0sEXe(rpp&bS@c6wbYWMpI_Vld?Bj>Y9DU#kFo3xD~x;M2Dhn@<Mal
zxy2B$ei8p%zjFlo&s{*H&eC7NI>F*Un3VvA2Ac|Me~kQ*<(W~>#R_sC@EPs?t?l~D
z|M{HKe?F%Siu^eg{m+2$e-&9jI%yb7oYt3u8$#&EcEyu)i2T~Gzc8)`&o2zSD%?JG
z4*CUt16Ek~vPb@ZO^4$eqDzaXo)jC8f^2?j3ISl$Dbwb3<5*qYX|W{=fd@)}i`Qm_
zb_1P<2c+Yxqk|*o@<7fiz997mv~_N0<?4JVMRP<O12Q0c&KLl?dwl_atXS)HgnMP=
znC&s|VM~oL==dX}q985~e(vJm<~=HfOc<3qv9E6*tmJ7R^%Mt|1)RgT`dd@x$rV$>
zhKSI;gUTN>l)*z#5ijhXQhSKD1>0L7o=mQ;s#ZJg=y&jgG@BfJ8Rr{-HZCrRix;bE
z&LGcdS`!W~mztWH(GW?+?9=AJZI_D0BX;p_b@zAWv6fJgk%3akr{Zd0aD+f8x9ES7
zAF3*++Zip;nLOB9YOSt1JAF06PfF^uz0H!5uat*pN(yL^*0M*h3rUHM{&miwn0tA>
zy-x1I>+3yM;Pkm%Zebr&%0=qneENjL3pJ+6t!2sAyN8{YHR_EUpTGI#%Ya%Lvv!-w
zpxZ4nG6|dr7K6yhK7zxWD>E}BR8-G#ex}t37|J{}k<nnGr}tHGmzI2xL9b}Hduv0}
za2&l#>CgW-zYi~=rdxFTBp*Ha6d4jidgU_b&W6?2u3bq{5sA_y=};ko7dbh(fRn9+
z0xw}jqIQeTw1k$Hy=)4^GR^wIgXg8FmXJ>Xq!Bx@a=P}`4;PJ^nl8UG4$p94VL0EH
zbc#RzVmc0DSeI=&ZDjZ-D)^J$_ZwTWd_EoR62qY^g2!K|;~Isl)(5pJA3bUxW-#bX
zew7)dl&4QdPCiyihr6ecBG-BcBxc!%<gkcg-zQ#!{4@*pK1_noL3+VTwEH6|B{Ews
z%s?UUl>{hQwJJ*|hK3gFy@KiclD=KZ!a-2+|6t|LL&JAfz?%4(%8!-Xbo<>-`Yi5T
z<9_x^b3CL&t>Ep;l>zv{fpqCTKIe|{YOM^hv`|s8!%z~#oVpL<siE{mr1xkH@H<I~
zDTtkvzD&d#nE&fu>tgOrFzZ(aXzB>QC1wfpr3(+bG)Lv~c%-h57U0`#l{K(1EqZO^
zHnzoPV<QoHO<)BawmRZ8HT{o|$$oZ$dR4EsGT=%?FgcbT<x^H>vWHq#PVRI!GLEXo
zqUYhUHH?f_!))P>4d?NxoR<Vy-IJH-@370;^jCgic<|4Jh|Wm=Ql-$X?!RCqbhG|1
zE!@9knskRr2pF1=k4-!zcE9Y0FRA_2t4BZU%We3wvyC^1Im#r-Yd}y|RcmA^<w@bp
z0u0SCo}Dl+*)otU1W+iPEzeRyx7zKb7EwO4Zw;okKK$oC6Tl3d54OaXiT;~6v^2h%
zzGBL<HVL+CHB~I<EYRahQJ34Q)leC3LZ?`RKj!LfJ(;U+J=1hy%5lqa>wboA-TU;~
zr&Lr_W$!T7)@r0>K27Vmc`y}y`AYo%kRH6G^f34KCa6RODqv5N)7&#0O{m<D&1agV
z02-E;8f6(Jii##51&L!-zB#}H;A3(0!SV;I(-y87LW|q~*fQb{wrC*WAK&;CD`ce}
zSD<T!;~#7NI;d8ov2o&`xx(__bHyXux~r(-w_>etRa5&hF<m)KR{;(L@vHs8=vgU!
zZ*wyf1maDSD(&vvoggy+&&M4f&#kX?nPld3_S=_P7Z9@p!?>57@JH5W;I@>O(!52~
z*Vo+KF*@4c*{Q1Tq4lOsXwux&bbGOfRbh#G-rHMR--yoDbxag0&?_$Ylg#u0bPrry
zP!7`^*po8Xqj`;r;!mG$yDxS#KqWQcG1|JiKfdxhvh}oNz#Yh`*ET&Wv!|ce?E&-v
z)?)7S-$6vuP0T$$dpsbw&d)dXZi1TgY2ot?mgAj4W*i)w(pGfqXq?$=(B<#%j~Z(W
z-)@}6v>)Er3>o<BYZFM}3&cQGuon$Jd%<R6JeHuF(7KFi4;KNAtq>NY(jO%}>=x{Q
znM9@Y-!n-o;y;<h*T(4J^yGn~<C&?ZBc?qxXRONcOJ)J~Rs7Sg{{Gjc^a@L%Y@(v^
zy%#yz9P-;k*^pyV>}PWH9!H>ar={im{5fEg5nc1U?*0+6bG5NbvLZLl+}G<2uU?H#
zNJuTxuTEmNq>Es3?&|3&g_>x=$%^tH&vbA*J2`T0Zkb33>bz~rT6xV?G>}|!e9Xah
zgiBm%x>TamOj;<J(R$e1*WfeAVU7d|M!>PKJt7sIM@$2s`*@d^bJj+rqW7QZk7N$Y
z$N9Oq_($<YlND&b?vJ+v+6KJ+{}nBrj@4E#j&!{DQwK9=i4h*O5batzy9mG%I&vA9
z{#uGN^U2O&qVxAe?9Pdy-$RU#@WI2~TDL^~Od~uaaXdNnD7R_en42s7XO>~sL{Qv8
zb}8k)=!zZH)>H6hL61)B?q7rMemUvp)bswmpFjF#ENK??b^c4JVa?O3U|!JA>+7fD
zQ&G++8H6(yDH@6>bfz*0ukL}-5GYps6()ucEF&ak?*cp-Ur0W)aL-bS8IS|-*82{s
z9D}AEzJ}-I<QOIbu#hd3r6{S#m|y>iaN;^(hAM1F05@>;`r`7!V5BM@F7D}8SFDhI
z@V=Tu3yFUFEny~D1#fDaI}dbOtr$5yoo~=(t*DZya=B3eL;;rtYH4O>;1@KhuUxAU
zWV>4%efZ5yrQ^AeBBwd>1vvqQK+GzdGW{DQ0J)WZ*ngwbi?Oh<aC38WG5m?3;2Bz@
zmvhleu#9@hZV76sDC6u>EAe7QDZqQ#fU4OU$Ppjf94Vpl_P$c2*Rnhvk?kcJ4M~~v
z^gIBol#vnNW37&;Qq1`pKKw||?md}RAOvE*vB6sW*!6G}P&I}2855zQjl~k9RJRrz
zjGde+sA<AX+pkjjy+j`*nT6kumk`#J99YX=+-onBm6R0T7%?eu0Z4CzdDQE@4;(zW
zDY?1L#(3*5+%i>}I2EEYB8tW>r7Robs*gEyUaQB5w;6PqvvcRQFmxCCOUANAE66NP
zZ_ZsuqnaSV;PLYG8?4FJWT$pVz~(_#xraWye`~{_OGzTlZV0&D;E(hd6NA&Myb-!C
zJA4+KI1@*m-v#ZOGsQ3;VI_v^aW|Qyb%OLGDJ7L!IbBs%b$slyL=R_^fk~`y@M_)1
zt2;Y1iSY8`QG?jfdf_A5vMqOvQws`uKx015e2Ms?J*1hGg^@e!O_T@U1j{)C-4%_6
zsPh%-DT(Ib@FJ-HtZaJ{zCC+!`{pH-jDcHx6<g0rKa93|`T;FXu2y(tDKnsR(H+js
zg<-~WqcuUh>^UV*g3~OpmYh9QJ^og|yCG82_FJD$vDG!NxO{qI>$ZNk8BsN#As21v
zxQk>J!Z3R)o0PtoUV$BatJ-EE;Wqorg696U3Bllqy)JJ7o5@^6_WS8@R~N+43)a5Q
z$vWxO(4f^aQNoDXS+C;922z*KXTS?cA&1v*W@JHP`8aaG%&~s_p_XE~)<?M64$kS8
zBsb{k#VR_Hk{L4YZ?kM?*q%J?<IqPTw3^XDuH)7AqBKG<FFAnvl2$2FKtyD8Ajj39
z!%5`FSC9Z~Y)ooX<rWxUsXqJ%idsHoP@2r`epJ-XgXniP%9N2?T&eX4L!odnFIGKx
zaJ9EnYy>SOlw@-?6Jy9<;$jx4HoSl<36M}#oF)t?CIle8m8>RxLv&F1e7}k>(JD6i
z+%7}qnml{;sHHB7z*y33{MHQH>!opcY$M5h*O`U#khsfbkQ!v7jcwE~JQc2m5eX^Z
z7~aA2;Clm-;)vbg#|;`IXU)$XYDxy0VnRpHhIQz+0ERomEpgQGYkQGW>3Xz)Zmb-h
zT)lD_1Bq={dWRlk#;-B@iQn@i4$@e&`%AwNQL6Zle9^`ER1iJh<tU~sZeFM)Z*pDH
z>RWsoYF_)wFQsu7>sp)JOS&6~8*_#CR}^!*y25Ko#m~oo;XH+x@Z@47+<&8v4K@ks
zL@K!Qv#(FSqIYg~w!1MmKVQZv_rl?Yi}vZlzBVB)nsW<g((U561#GgjBBB$65&=KW
zZLyc?0Uu{_{SGzEG3%&TNYUa+@03g9>RBk#6K6@BMU5dxN|+=hjMu|BLq|9`vO6Qr
z$meIXaqxDz+1X3-AMb6MQ~^u|$MaN`iRNyCNjwEhsi0;Sz=)BKbt@u#bQ<yA)vEc7
z&&;`PkekP|yC*4LO|8m}!<r$CaiZ$E@{aCcWr^HEQ&STy9o^4HW)>C}K|!s*MlNtR
zL_t1CE%CL~J$lnxS>#at_Tb}P<EfdYH9bS!S1cXIQKH7Q&NZsm!}DK>b*Es_Y99#c
zrd3)FcWk0Lta|h(HRWwXS^B;MVr*z+K%-E%74T@FHneqWhD06UYDo?lpooN2&Uf+>
zx>qgfpNCz1_xYWbQF+yuQa2y>c-{DMQ5`zE^GMB|MM2Ccn3{pGv+V@+)!O$eh8}+=
zP*fP+F_+vHv90z6nM6{uqqUXSc{h7o9djEK#Jsb<UtB1fI!ls{6!e0~clyWHh^e)R
zg|8i_=H_rx!7RwQ4;;{x*)x)WuCF_tfZJCVef4T35JJXy2?YvTUd{M$Z!cnG#Q1pM
z<58Nv36lnIM^mcQhbwl#xI~0)R5uQ%G>a>Dlw{-PR!sCFX4HSeH)@Z%L!Hey$_5xV
z6cD#%KS+Lsbyu2hxdBELYP+Uc>JS)NW==uI!xrO|tuZ>CQ>Iz%T$UV={4-F{txP&z
zs-6KDN19+(nBQxdU{0Ji0Dv0TwPpglMm3SDH+sW~t0ZFh%97N#Xf<lw-T-R3zM?-%
z$zq`WL%DIkDIA`;Eof?)FPNp33wQ9MtghAo2p4{$xWxUjtK3$|<Y!Z$U9yp!{o!p=
zZt0!vDPqPuXm-Xa{XBL&u>-_+nx}or%Y)>&IG5wTpKMeNfyA@XIff@9@$Jy%0fC}`
zRW;^Y!0D`(53}%FjYR~vS+?z7*iJk&+~K#H`ndR7<H#<eFBxiI>Jkg+;yH9>DJsiT
zlDFMPlvCK*4NSO_vRp!GYqRXEP0a1CW}};+OAcKz2UMjbX0^_1{to-=w@yrdHc1<b
zRmte%=rnBuh2{t~X1Y<~(xw|oxq1~J52V_4018ISEIPT?>ORC=!9~_L@TDd{N^SC@
zY`OQ`X?ukfbTA&#-1xi5VYkiMM3=PUK~9seG89g}6<Jynyo@F#4l@~gpj4mO>Mk;Q
zh2QI&fBI~SEogPFi!noPoIqW@=KczU_}SG1q5hvtkF+2sjU5RfvA;Dl3k%tr4Wi*K
zI6k(?6g#;mYyT9$n&l58ca$(>ZV)x4$mH*9o9hSOh}NPE4o#^eEz+Z*zJxEf#&su(
zukY$#3mElgklxBZdzK6VL<!e)AWEbR>Px9|55w6fvJ<|r)NG2qF<v&XnSW7rgd&&!
zadQ=|H)JWU?oE^xwaV9xRo_$d<(g~_b1jaECO6U6W;Pd#QDH2Tk;xY+yj{pt^s+N{
zw2r}Ibl1Ip4b$xe+Lr!$%G?|`UC1*340HmSy*}Oke%H^AZRoOWK)*psdKE5LsKMvH
z`w^9^A+Di8(WoXA3$)G6EUd&rp*8|zn*@M+CTF1V7cuM1$^^u>7H0t4LNIx9vUe?e
zeI{_i3^CL)ST;+K1S!gSXSp_x)uKN$!<4t3`@Z}PU{Fd*!epLUO-C0W_NM$~))?V?
z^HfQ&rm4@u(D3n5Ag$&`T09rulc9XQ;Z_Fonc-zy)ugX|zB2w&EFIC#y<GOlTMnl#
z72Q2YYk|qt31@>#OIod5>D?uTwyK2j0+$XN+VFmW&iK1ez{F$Tvu^L#9gB-oNCz}r
zXZuxcWNt+W)y)L;(6iu+wu(<#49#_jf5NAXBxe0&fnCo)n`{5{I>_Jx+yjQuwi0C7
ze6T0IJ`ArzaCQr39YX9}irx#stBm`R5Le#vO78X!f8vXKKxP3VFs(e~myEQbY8s^w
zj*H+ldNx*p9bG5Q>OLiO`0j$nFyV&aS&Ue7b89Ba&)(iDDGG7Xnf5NhK-54E6Vr9_
z0h7b+vPLL%EL(rc^+c|#*w_)*Aesx}-*0do&5=Y!!V=`t6f=9HLjC-%ds(Y~(Vd&7
z*BjCbU-w_<sjR4tJ$-IAw0?~d|C&)XbmeAgmEEdOVq#q|vETu9q4ORc9mjBMA-S{$
zHFbMh#J0N&5NDB0psC;AzoqyDP-QD0jnM(5H<ApR{oyP9P$tDO)5mhD*Fo!))=wu%
zR$;%Ulr3Ye>xp?EVtecz6c@*g?$_%7!lnumzseByjO-7P%OT~j_mZEJ@sBd^$_Q1-
zmDSj3L+q6s8+Y(NJ_AMA;2VMvrOD*7_<ToYle9OB?JtQ*=0}9Z7_Y985enda;#SBM
zT(3>AD{ZR)CbK^iXdG`DVfO4;wp4H6<GOD8{x$o8^74XWoNNfEkRT25er<Kao4^bs
zToTih_2<E`PJeP5X&8=Lr~DwB=g6Ih57lY+9b#E-&{egx;Cy)h^>82N=v+B6tRg3B
zWo3S}+fiw2L`cYf+MTEnd^oN541NP*phOD$5AnCN=gxeub#Dhsr$Rxp0Zyt6PR((l
zaAF~{iTw8MLT0Hr30vz-X*3(T?j;}6dBqf`D{f3*M^2>l8C1i>(9KO1fPZi%i}_65
zm|B8v;C<Zh-XNzPzszfo#?<u;slPysmlge^f+zL{TaXstg{`t>J+uj-agP%y8v2d1
z7M~f#r%tPloeyo<+@D{HS5aSkcMDzj%s18=x~3q@)jivZo9iZpZ}%7!gZIr^`PlE1
zIacJhs<Y&lJ2q?<zk`E=Jl(bmbYS;mD?&!1+)&_^qI!~lv^uJC`LZ)$YZ=;WJDaD4
zrqHU_R_BQTrbHCeN3GUU3DDT!Q;^y1ncHb=zx2UlQaSL#S+ZFO(23dyde8$AZ;-d{
zW=RVK-0F$OR!F%<8twVa&a@{-ZL~A?!|_QpRxCF3aC@n*%;E<i!$DUM1frLTdRQeq
zGJo{|)a9U(a<Q`m3zdQZ#Rv)M0wo_wB_N>#C@_8S*HZ4l+PLZ$knSfXz8wT93@2MR
zL^&0f+_iOd9-Q)h@#5W{u<T1;2UXyqykd(Pe|!#LI1jY0t>ZG-YA^@hQ5nrojQzY4
zp%p&%7~Qo0g+US?GkfXQ!C^%4<H4f`!AE;lp*`%)6;9>1$!?PkKDOJkvmjes8S531
zWrB+i2{-CEXWI74+iZR1=r!-I4L~UvS+*&KWY<p+DSe*SeP^c7@s$>xw_p)@>Q<bH
zpqLma5D9D>gnWK<<!u1weV<px$9UCA$##`CHg9svv}Z>R3z4|n{>e`YSP05dw7-Nu
zh?1@2?z+kJM5$MG2xfJ0X;vAtNfJ!|@cZ88x73Xe>{iW`@1pk4>f+Yd18l7_)dr0b
zunRzAe>E_TX>W}jIt>q>S5zzspqc>nbULDtDFm=>_Dj9q%po9#&-UDVY&R6c+*aNI
zq4Uli(?ub)zPz*9OeHOQ`cLsN_+U-f-fm}^$98e3uRWL-aMJLNm)s*k0J(aD-RWlY
zR3(4NuUPe~p}Pdz7X0yxZNA+OIHIEN-T96W3#X@M!*w6dY@pC87oHENbiivtoX7ZZ
z6pM=Fr@PCch4@*`d57gPDP@Pc!=clZKHZz<fI>G`N`)V$d5g^emOwg-=rL}QyXV?M
zNVs;e`wfbk(*Y@c1CUB?Y$?~{O}20|S1Kfy`U=cO&k7n|F>COyrbMWwizV3%H?&bb
zFMXuD0x%ji9ZRwokIj9wRHaQU7d?ZG!SKEwMigwz4&SMfqbb|^G?7|$XCSC4y@}Hg
z$l?x%&ONRI)f`!RwACAdk+zmdB7h|~#u)t>0I~EF_Ih8RRz(klsW9ZW!}j9P_L2n-
zewjk<S0t8y|5B%GOEA4H`{w#o0TRg>6*aNmuS?vtx~`>QGRS9F_`a(MP&oHND^vtj
zxnL!h7HHY*{n!XLJ3DHPXh{i4wBx92Jk_KIHGx!N$|&tG<1VS?J`#!!E*$E}xuAuY
zh}S>zbgE!l@BV08JfOzzOuGF}jWr03qB$=?zj&>gaHeWI<o<hX&?qLI*)GF5!Yp2J
zJ<|Md8+l;dUSIFWJ%L=B>;G7h8gJWBJE&4@ct4s}vy`o7!xY+4!x2`^I6LC<VYz~Y
zk<SO6K>%ZGX>YN(vVvM#x=FHoGn!H)Wq!St^10Qd+hnbnG1J{zJ~r#S6w0FZXgbO8
zS6}rIbZ+HYdRnLW1He1;_RX6~#Lz)jaagwQL8ry?i0YOHUru!IqZoiH@ngY3!oSrW
z#xzj@HJtrnNhUCmYql|<mIo}po7`Wg72x}CGehKD+1cgDHsW|fglM+rg}r_3iBy4&
z4Ffm1pEHHQ6~e;7F@&hn520o5BRhK-_joO<;-&Ijig+5(%2WJ#9M;`ACe!rDCVJV_
zg1jd{PY^Yd2nCl2etffZK5|0xI0ZWenZ-1X%8Tp<%IU2X`KuJX^)4!MUFdv<rn&*i
z@2RjT(|sX`{~I?buq96$cC;Iu=!>uSXOyf^@TtUV7QgFMT6g@VekKkub&kzb#pOSK
zX}#3{eOu4hu4GYeDFnXsJ%o;M_zp<b1xdm<U7{i0o6x&`iRd6}()-5Wdg`5E>~Lg9
zq82H5Rs(?b1~Gu6aM)k%wfu0$?!9BB!V*)eH*emo_bfY3*Wc(#s@Pp+&JbOp9XTP~
z-#qv2U~^gA<I#N;=yoDxj(B3ZHD4DeFe)9VZcWIfNyB8OqOIKonmKuP4i067L)a(a
zPKth70=N&r7$u1eW|@3We!W=hF}8-_QJ2Y2GaJ<pu8mdw7(jWt*><6I^tp)6NbwEO
z3P$s62?hj|0)eh0e6+-Q6ANdjx5k~6>_oE)#&@??%`RMZxXEacj3XZhe=Rb&FmiyH
zAuFqkOaGTGXremWbr)Isl~XbuuUa@-z6K6e95A-3>0<*{A-54ZC-FqRbg3MTHOoS$
zI6W$KKRBxSN-cg?7L~^--616bU3s>$i3|UTnyBe*Z1l)Ifi5e9Vx{)#>s=SAJ`gyp
z%!G4*mqv}2xsL;R2?!Ez61tXtww%)zEV;j6{$pkZuFhn$-U8j094E{{?<-fXY?Sv}
z-wvd)$nFV8pHYN#%*Q;1HVK8pn3ABN#Pz*cAH1Az<i^7aKS0>m$G^5)9nnA7Tq^$Z
z^)M<z>48^ju9l!ojw+|N>L8OEgs^K$>VqXHX~yBMOJC6klTm56XR~agsfUfTEqpj>
zBb#&pYm~u$&)Za3TcnRu>hy3W{B=_O7=ldZ0Vp)cXKv7);U*#?r1qR{rQK<kVn?c%
zMrC;65{;LeQA4Iup4%>x3yth$VpS{0r*wDt+aOo?NORE?i5aT0Cz|iNRI7N9=DYsL
zV>4sbANc?`1Mfn;`|})JBFY)Ib5aEQ7b%jNjU+_jF$aK!_(X;n6Ko(vIq$hO##x>n
zEXapDu>&i~N?$=}cA?9GEf_QK)+A>vh2%-A)wnSqWhS1URJv^UD0`)L#)xJBdbE4z
z6X8ZM9Rggm0Rk_-*$9@`%kQH$V%tpS^=uP3NB-{}grWYv)t2{MYv1LXjqKC+Ed(ws
z#EaOkC~oovf;f|mKP`m?=r%+yt9mc@jqKpjWi6=evVM%;p$7=x40tW{cW(t9wth*@
zE{wOCu-27xiqJlC4oE23Prd7T=KU+aE~1-<Wn(k-*Pu%KGrmzMSv+J~5_Hs)duNsL
zt<VPMT(Zvk`0@Uu1DsP$&1v@bDTsDG0hiAa05^+FyTvdh1K<;i^8t2lY%CWE$R-X(
z0f`3ObF!L#Q3VKuUG?&cRBCA$xQ^o)-*D0%MP$6tn^L_@M$c{;!H)*NA#@1$<BfRY
zeop4skusVZuBQ$pL`YW7oVruva7k;%zH+Oi*=zRN|D7qSoKJ;#fduKxcRFD-ss@L*
z-198;cQZHJIPCe6L8J9unI_eHKz)~0nGebg)&lcyzLQh2c7*MH&aJGjQrJ$y*H@$W
z`clzrF@R*VI&HlH|DrOkqG(w4#2)oTTZ2rI%VfSz*IlcH(Z$5j@o3r%Pz=1AyLQBf
z6l}>p$g*I?T;hpyr82621oj@6;f=yhFI*kHf=Mkf`S=dsuchZTb~S07+zcfBsX^UF
zl!Em89Sgbfs2e>$enJ)Iovb=MKZ;&$mYRwtCc63^XnjZ9Kd%8)1IUCfu`75;$lDhd
zT=$#-zIHl{m{v&l<eC|^m;n-3>V?uTwjssgd3i^Sd6%$h3MGTkNSFUfXvdV)j19z+
z?zxa^SDe60jR$&HP}!uad%LTTmQ#S*Xo_cF@gQL}?HOOzgVB9}acv(ouvs~ofNG<i
zrn>^F(eQsUZGOZwuj`@h@+h~bdBlGqZMqbb)*86W)epQze8)%BN83_ld^}bsh2M*z
zGz%WZ(BeB(tn`4JW^$V%?H$-)1hiK38$fFT5ZIY~7S0#FH#~i$didRl@1|lh(tphM
zK2)u#sXAH_70u@AT(qvyp_RwBRr-AYVn&Hay$&ujVU0$+Ij<YV$?Sw|n4lQRVBU|4
zR<w15g{ZG8wpI2>04<=sS0z`<f7ZApjAN*NAuIUYC4S1UoX^7Cm{vw@Dg9#<L7N=w
z;o$*DOCK%5vr;Bx?48Aw5{+u83V9>vOthzlJb!7L*uoud?mQ!HZPcRSQ4{%?RE$G#
zX-Jucf$)p%qLLi7tZ<M!x279Ih8To2|7JFut`z{zK;zwL3w?U-6b8xaN~nprzk^eS
z%SNO8aIL^SZFse7^;LXpUGg4kOO}U2gp}h!y9MSNSynSwWaP44enDCeLqXsbG@TjD
zT?JPbeLsAV1b`bPbJ+*=Tl<AOKz{DeTIlYH<Yti_dYsq^x)a-WBXZ-x(p!+Ki1Vxm
zA747wRXBdk&28P9`f@CUr0G@Xb?I0dlBVx`_I!6(MWrcIh#^<Nen>H$G=x;88yR_=
z$dcQpNaLI&>oN2+2=aTZ^Sm~}^lH}Apr!ofu{n5!^1K@mO#0{}aOrGpSm9u;pPn9F
zQrzEYUgI)H&H`Apx+?ad4O~miPis>Htrq$7Eq|>3{mZ58@X$~Hrm63claW1g8T_IP
zg%1OT;WbWfZUEpuq+$<Am?~jUki$hW3W|n`&#VGLFN|(E@a%q3CF>|ORicp!_gqlK
zqfiz03E+B%()47Bdk=tDTh>4maq9={{pnVS5EcSzVTJ0PcMT@(ibyv4<Vde$AmViB
z92NN$a85aK)slm5V>QD?s==_7eRygJ`LW>X(CebqYxBY$sxo=G_NIl49V{jsDjfZy
zSd^jTW-y2@>RhF4%>svWrjVIXD<x&;lzM6^X$E-n53r{n9susj^d76#Ghi%~PYE=-
zb^A8<T=CtO)<(Hj^(vTJ>96Md=Z;l_x3sb&AZT;cBJ$@-Oa!mv;_9~r_tSL9;zV<~
zW-_?ifm?DMoIC8Q0lv|LnF>GIqV-y(WFDY;{x0Y5GVcJC92stO1b9(pNonbb<m6!g
zgUJs)=R<`QfzWt}&oJrBc!ag84!h6D$jHJH2;m18T)52<U)(M-T!#qhIo&gJwN65b
z`f&Uh{7xzM(SCV%ka?_~o>ja43xLWk5zm#Emiu>54!X9jZO?-__UmWq=2L(?(*8O9
z(48865dtf*>OW1=N4k*L+y#D5#H9Z29{4H-G<iU9j;Dx61H%iz4#9m9mnN3Urflq>
z9+f~51B#oxyL-(Sg1Mu^iVz`EY>&zeBme2%tL~kEbTHQpQAp4ukLK0m%1Y>N1R^@{
zHk&?>KBp+U##7u>BokSzI;h-U3896>b#!_b(w4cPWjHMI&}|?sBO_yb3S93=?2^{j
zPTVGx(O$pN`<?WmUL|zp3()8Mm)(!d7|)nJ!*Wm6*EGLRR2xa2OW<?o&BtNerD%zl
z$MSs6BN}W4egrfV<u*fLj{sf1WBXKHJ;oWSj07wouif=KARMhHnMbkWi_U;kfvmDf
z0f2xYdATr%iiN4E?ONRSAf|*@ZEV*@V_RzngR=f)=N>TP00V?xMv0YI#j{4i@J{`x
z6Z7qX`8*42ti;w9JPo^Ir0?*fc$;An!_~g>f`S4tm+ga=wzjset_ZM^62nyYJ~~q0
zm0z>5tv*sxV6P0NUADBN&&lYoJxLSBNf!jElEo7lol*Q)#v$7+yA~*bm-23UHG+J@
z&Baw=nW!tfnVw$v=q}uG>#o8ZPJGJa_^hm%|JoHk4-$u(dE$TnySeH*6)Xf;^E)D0
zKMUl#ot*|%Rk_=(M`7B}=@S!`A!lZqXg?>~T|qanex@~lbf@=R^jRQO7rtxp4faU7
zRT<>%e-!<+5<!!ilf>r^B+ZsJsbNI%p41rx6qGGSq1ZNvkjXc}Z-Fv@lQiSsVJ98m
zc>jJs^#zumt5mN2S!v-!yt=h$$NxpIqV8`!KGm%QDFoeTUB{1EQk>FB@JH{#6iyn+
z73{!%KVrAa$W>k^|C5gjRr1Vn$}jJb{LPWkaB=$I+D@QPCZNRS4qobFZv4CFE8XPq
zHX*yFL)LxZek^KdTd-8xOUV$DOw7Z)s#sCUeI08(!0*m0K1L%#P~Q4vVy_Ya_w8N{
zJ8Nf#$@{lYU<XA9(HhSKMP5F*<1*fNAcEBjBKQRF4AKIr4r!7KKfakYJE*FeXTE_`
z^F^_7A>f@%c3ez0AXm&z*5q3_IW|T^BN}+gZr!@|FKXBe3En4m*b~{`C)`Gjja8GZ
zbkblj$K%SbB2`?3yDEP?<SM$$#d25W(BcD?qJom~>1B(F&bK&Q3uoMqkTmd%Xz#(N
z3f#M&spidbZj({*%QP&pltNu>+`Df4K*Tdbk8Zpd3zzz7dtCFgw9JJ~lJEpEGQE=&
zB*!XA*!O&AR<|TeZ{j;tON=>za9$eVQA=~=vBHR$Vxh|dH`FZWpf+|u(uky!o6%|@
z+ujM>#&F(^q!bt_3I^iiZ8F8P!<8sp@(~r~$Urh;a42thS!;ke&`_ef2%?}XVF2u~
zRg^=(82n@l7}WUrV?h3tikF&aMC*@V(?Jv>6YlHuc?K7Q?-E&uCH?FM&BAfOQ;m$#
zKmtz!<8-i|T%$hJsDLna0ku;6#{e?_p%@Xa@@{m9+1i-oJMG-5z~^LR(+z>g@s@n5
zxW(~s8z@EZ-wS~5D3(<xRH!@`*xrDKtogT2ge!OQDshde2E{@j=hBxeU8TN=(6BGd
zB%cou@l??L8=&ZQ^oN8f#E6b2>$C)m8~jV(hCDrCl$0=5uPluZKRG6IKU})hKT&rG
zt}7ToOHB{j$Ep+muYdgu9>Zs}@~aS6rV(o-PP%H`lXjo*En1>>SMa-gbYu^&!p?Ge
z8rnZBf(7bt5?B=7cuRXrD~`vHU-eC{wQxArpRAT?5z=zTveSK2VaHckN+|+ttWYda
zSxx%c<Q@)&{jaF%sMCT@zdkb;)bZeFjVzS|jhxp)#upY+{Ni{9`rA6Xe{{pV3!=-M
ze?HY(3x~Me&+p$W2^LKk<_nHGkObr{)1!8i!P3RCqp;8IWwhk5B7^Pr4wHdwqu#3W
zg`fu}2gHoIrh`>HJS*=%oB(I4kvmuui}9+Dc}bil$2Sgvg?kwovD;Rbyl{#g3w!$|
zi;;KES^b;4fYm?Vk$)Ry14F0&-rks8Z$Q~mYuIGWRaN;1(+!uIYfR4%JZ%&JmqJ!r
zeOca4x&i+*+UBUPJ{9F|mYV>ZI5|=(HJVviT^%XT;5*5lESm!?L39(Vi(}(h{!~cq
z(|ELBvWg7c2j2Ce3TEhy$VdIhV~xF(4{qngRwO*1T3Ra9Ycn|hJh!QJxbT4>Txkk>
z!vdd(QfXIDNO9v+mc-I^=`>E>>Y^=jGy(ECMlh=WT8OH7f94YCLR}~{JC2yP4j<-z
zVrK%OYL*F(yRJ;oY5cWoH$vhnTF$uU=JEq<1x?f&hO)c@(`q6TgYH$&*7W)#_#B<U
z-3)D(UDQdYxdvm!5hDYy(~;f4`^&F^>(6uaXp<q@3CAmtk|G*%V&;BEd;FPLsnq1t
z-WpXwNlvA1ODKTBlo0;#*lJpUnc-ivZC&>3u`}n;QKk4ICpP=EKicr}(liX+M3Hv9
zUh_{~$?(w%A+A)qHi-D`K1>L6$FBxTy~fQvmN(qiOTZlx3%;XZ3thvM(?)G7u(c|R
z%b+F`z_poi$Y;6G2Bo>UXZ>(n`~kk|j~12YR&Y<}Y^y87#Z|>9xt{b?JXf8E@p1P;
zUX5Kr1h}EKhg9iQk_&Us`Yxhe6%$@6vCI8x&iHKj^q{r>vZoATiJj6GOqPXkx%0|$
zC)4sWWA<kIXY%8kGvCx3m|8wc+Bh`fj;=(5*$9mfAZ3Q35eZxRt4&wQO{{Ux1Gz>0
zf%1YaB_l?amd)6SzLFB4vf0zP#gcR@4fz6ZYL}q<a<sgNKQ<Ll;p}YzD^JNbU>v0O
z0t_`C8Ifvb>1B=g;AS6<qy4WNZ?d0Y0QwJrqlxAbKk|OV5hz(dClRBWit}xkIMhZf
zfT0`I^@(r7ghs<XJ>lWQpMTi{{*4Mej?gNViFMu+3#VxvFd#2_+jt#V<bmt~Io%(F
zxSmEaPmbA7+~PKWw|U|9Ae&qpRbo6zSDN$<PlE74aFJnfz9ln(&HP(@9q@3_L#n}k
zdRBFq361oWG=NZU$ou3zO0p}3x7|CEJ6@6PKmBz>vYwg2+!3$|-@aY(73VUK0bdP(
zmSb%x4*r|c!PiKbfb;bF#1(hC4Vr?&+%siy*MzHzb|5(^DLa|eoFu<;$YT-xPml$U
zSD+k%i*Rx~wgLHXp2@#S2n-A)_xE4a@)85W#U1ukD(Ag=FI%zz1Uxn+mwwnSPkq=x
zSNEYj0plpvXdJNaB{N;aS$UdtM={D9(svh^{yX{c(b{OGy~P4xlF6cg%e;b%Gw2F0
zheI$Cw(F;|&)$Z?ZZtu>qgILND+9=T9e@S;Y(h)jZZS5Zgb3<}S5!})d3atiG9Ap*
zdZjyCD-syclFPjGo)a)MkIv6leZ)0MsVB#ueEZ#3O9Bc>FDI&qvH<@2c9J1fNvRoJ
zM@W-$^$pihzvDS!(rW$zR`)Y4WJy!0oOTqLu$!-$^r%!j+DP*n{A!<C%8IjQbLI3H
z#&5zUch6fXcJ@`G)w@}ai`|(`{;`H3-;#VxhQR&_{pdSCtRIV3A4chx>K$QJM4kLr
z;7B7Lm!W*ct+2Eud(7_UC<BeYN(=ZJEc$-DPI)#-2^!ogJ2Us!Jw4gk{nPeF+d@i1
z08cP5CmY+=xgN}6lpX>z_~QIxlRqZ61tsYCPG(!4s{paq=;up*7YEb%_OmCvBU16F
zTx#Zns1^tMN5~YwsdcZ<gS#oVdZ4i<PtDx`$prAKNoG=_DiSN$Vg3CE<j)%zDgrB=
zxsQMm`P?9(u=EpiXGQI&CL<LAl!+a>1L|hIbp{Jv)-(d#GoogRV<|VMolo(LrC0*C
zptr`dIjSX2yIdMa&@=rmW2;!;7@>#f35+Twzsl9p3twpko<)`-&!yE>GW5+14sQa~
z7GPb_gcnnu#u4}qlKkbRJ035E|LO$|r-1j6kI$sS?dK*Cmr15AhEwH@55c!PM1sa6
zhs~(B8(cVi>$OalxSH5d0<4#rz5KD>WXOW|U65$78Z3&>h9<epj!BqfeuNJ<wUvUK
zAEg&YB)NWsJjC<!%#pP^`OLj^hZH70u6H{;FfbZW*a}(tICImx{i~PH@V}F#S(B*)
zi$h9&MKTWXS!beKSZpm?4xXu3QtCpkP}0jS4AT*&JHXqi5O(^l2i<*^=yK%%<OeW{
zURWE#8wg4jwnj-ZazjEJs<x@b%%W&}r_k_9XabV+{}A?;aaDfZ)-VPlAfVDMqSU5S
zT0uc#(<$BE-O|$1(%sz+(y&PZ=@6w`x_Q@z|9zkPobx`<^U)9fHrI8nIp>&Tj5(J;
z9dw*~POacNIX?L3;i0XFD9w}!mz1k8$a`sUg688R?AxKx7~19`i(k`U>23bjNn+=-
za5~sDig1sQ0RzWx23?)NmSQN`?J(vXYZ7k*w2|J$;cnoxZTE+=DKypyFv#`O<!8p`
zb6l_7mo|a0O;3+5pl2_3v|VFWDNbCbcWlVhlxc=T(UkTqsKG@r%|s!$*lK@5qb8UD
zduL_*GeO$oL*jeB=cYOxEnf{M22<upcBZSwejep%i1m>C=NaLrEI>8dj3l&^<cj*P
z!5hsJ^>lY^yF^V=AC0<X!^_TYxqjald6q$AFjZ_9w6BI|OTF*yQzUVXxZ+Li)gt_;
zGr>t9<8;!Jl9DAQ<*=|&1jj((jkWG6u7)@r4cByO+MFc6nS!BcwTAw`)pT@p_ARD+
zb|J&Z!-fHD0`?nYfo?P6U?lqD80;AMRiMaXGRBA_>6lYI!2I)-C2n=#u405ZHPTKS
zbAo|oSFm)%G4`?74N^L`$vA6TESUMM;M!1#B~todU;cLml85xu{5;fIDAWWi_F5p>
z9BW{}q#UKv6o~vzgg%_J!1uB@W1)g=jG{ty2&sF;$@y~?m94)udPbMK#~6kCb@5p{
zh6sWELtrUnu3|5yIzV<n!WFKMgZ7Js3n5q=@B46vkjm*H?v!is0yXPUqiGtV(Ek*-
zT;BZOT==JJIH}(D52-FUk>{v9QnFQoG{#1M+~#|D??F94O*v927~Fg}JoPFy)s>8<
zN(}XqSQFvAFE&2uZ)}i*-(Qv~kx=L+&yZCoiO8IKUDeSTb^6Ow`B~&?HfvPNI92Q>
z441;vprZEUeP8erfou0vWZ8#kaWJVJc$rN<VOw$S%{lx9^Bl;?2UDZIDA3+x$lspu
zD%0Ss;%6edVE2sw;v%sT;p{9yX`@i?ccg`l>9O~qCjRN>_=wW!8D1*y+5%+!zP8`J
zww|nbBaD`mz>py8{phu@;7Ie9de8NPAAziuz%h3j!ckuam8q%EH2Lpeg(|W3G|0=8
z&2IJW;>ZhHlX5h1s4+@k`C=`_1hx7yyPm^SFwhKK!SE(USE_Yrapz~7zqvlY*tJ0X
z{T}ML_9kGxbVol)6Kt3B7;+rc4<6{h6nb6@pHqHYv$QEc)nMDFZ(uM$()+w5ou=s-
zFiJbEkEkCLIv*c$EqImoBkcg8qQ=w-e7U(QWJtb=YC2<DWBs}7q_k9N_gLj4LdD@<
z?^K14Kj)gn<rTo8TZ~u}moheg|G*ZL_5t9C%2^!;c_CzEj#ADwi<LMFa@YqTP~@{b
zn1`+-+(2@Fd~)^=YtT8)THD(PSr_<-Qmi%uCrB0rdNo$Th%rvi1BMo&;Z)Bg#zN_d
zDAN`|#+m{9mjF)_Fi*s)8>bC_d8L*1bMt2bw4Is#Lqnzj(1jwX^>k;(I)H_-(tJB1
zC8bMU-=Jg)Oq@@B|JZqS@#`IW$hINRdj=!!*Ph%iuF1srM7Y6(u<pSVQJCI|z%l8U
zqK|CdA%w%=znJ#ZG;oosy?YFihIeL)r_5=+$ij;qSrH9XK;<4vSzWsC5FKy!>*8l-
zw&PTHcZgbqVKndo#L4)z@X-{^X4ey&j&!`{bV|#&<s(AlhVzthcj<8bChjXRb-K3m
z1AmJx%jTU>Q1}Wo=l=zBBha^!cz78$QW%1!n_Qd#&IR6j*7RE77tBeKNQJBb9WQ?b
ze+V=_Iy(H#4h#(*H}sc8J9q5;()rPY%ALh_la5^y-un6RYWg`HQ3dH}3EpmVLZn-n
zVHX4f_$;Oa&01Og-;+Qg<}DKANV_x5z^>n1z{~B^HJYJ~9(IWuqg!Lln<h4p!GQii
zGq(D`p&W!G>)78Di#Bzd|5jlwK!yFc_p*{vD84jETnP_zcXr#d<CWXT8F>bUUlJ3)
z0PX;Dnv{~)t73~Ns4VlY6_gkGlD8Dek*&;LD^dnAk*Swg{9yc1=o@0ChGRj>ob%sP
zA9WKVwqqYb{)ad}!q8$WZRjJZWcY;a+O7H3bm}`~wwc1XZhumtToc*Ct;@!KyG_1y
zI)hPM+uixlE{<}~XD-z14pZePM8sw)HOJWKNsiGVc;G?4OQOs2s#G1+z4lPQOgB51
z)|&?biiym6N&uo7(n1=zJT%FCqI2PV0>m|Lc+ZEN&q`#F<nn{3g~IWrlLYh^eFK_n
zOZ*rX!-0lnenf*rKy;H3RZX5b5(bfy$OPX86>tuyy?A8?S29q5E=PthcUf+trW#qA
zvvYR9UW05Td{XiMHz^<W@S%#E24oVKay~pb7@MJKtgWpr(cEieq6X(i<nM&W5b)%-
zO-;G~NDpxR<$h$mLTF)IQOTOawN=pAu{-i}w(E9`{iF6K80I)WJ|f}iNlO_1^2HsD
z@`K(SOxl3nbZPf5+wFP?AAg5TwBkE2&KMSil)IYW?1|c6BV1j=7J&4C)n-k<NFN%>
zWk;JA&VTLre7J8s7Hw9sBw4WAe!lUeRy!8@m-?8v`t!%~@Bh9LRhVkkLX0N9KnA;1
z;KpB9PM^|p*JqLn*e75BocP);!p)g7Bq_1hU0HjYtKM%!@>6Kox2UzF4V;!eRHLCc
z78gNlU~>Lo|0m5{IC(q&^{HC(<;|1}<|%#P#mz#>tH3lWc0bKG2@eF(2OoaqM0|&i
z$z=BIS->+d#b=qSGLK&@_K@9+mKv6M!p`~-*+=Xh`U4-qmoj0`8BT>|3Z>1PWf&7~
zxKmoU8Ce=q2CB|pIW>Xpo+Ob|aVPzQgM*DHS5rw~CD8ZM0VygwPow*hUf65+-w-1r
zHG+e;=qTYkc!Em@il2rAMqE00kq*|MRW%%SvtRvPM)oA0nVa7`E|(wMJ#w}@{nfJL
zEVfs@`%%oT<Y1SzThWmD=5n>ZVYk_4ApYUm(_D1pLR70Bp}ab^PvqzhHd_qOKA-zR
zo+z*hid=gf>$@NR4mMMBZ)r6^_!)9-zJ7UuLD?vGJX+PN`$;j+$-m($k?%^~vQ%Rz
znV3P1>jf#|KYw=75BQ&LS8e9fB<NoamKUO9VCbg|!PiyclnoSr4GAo%Zj7GVXmvnW
zQc{o65mZ+QUHHnveNCSdG}!9B4j4b_`5;6&B(_OkTiug-B3T?Ks-&$f(0W1R_FGCY
zT5jA=zC6RIwjh0qwZyIaamb>@O|fC>Dk*|FK%BN*ti8>P@9b5O_H#^1o|9Qi`@{aY
zBxu6*Cy$HPhl?5g$`!vqY9+AqnYtzC=JIW!9u=zzE;S;2hW$bD#?H0c$bj#~`iyPL
zf+flXg}-n+;+ZX!Ea@_X*_81kqO-v=Xt|EsKpAxAqT7{qG5bpT-GEGm+845hiDkTj
zvX;SmI}xmJoHm6!mZXfS7cq1t<$LjL$Y5i}n7Msz1>NkIqfOcKlihsI>KFUR$Bm9w
zEh|bvcE3BqU8&<+H<%jRuVPfprz(w*eZgi<EE1A_@M`5Siy4(X36Rj?>qm_L*WV^>
z&FiuG`5SYJOS13D>_K_;F=5ih@Hgl3G8MBl{f4K4_9cBx{FkNO!22|Vzcwm4!Qy{$
zc5p$!T3dF2|BPTm(vYK}rJ@4YVH4*$(H1V&(&qMd@5?{G)4_b;`g9eBO7$T<)g)C^
zmXAX%hpD3u^-UyYjkD9-!2j!SBhN@*a(3TgiDXgXr7B#dFSRn-7g``Ag?>Y~Xef~W
zqxMm@ZesZxsmCmYdv+-K>igUrRNd{PgNH_)^>BNJmb?2SU;c|N;;W|9Kiw0)e&+^y
zuQ7=5$d=dylw^d$bh#ESky7i+oJwgvLerjm7FcOpiK^MuLiqEwsd8dwXXT$g+xGTy
z6%@E!x6s#5PyE3}k)`<j7+J|5-E5}nVj%ThOBQD>v);PX880l)ZPM6$49nBgjNL+=
z#()+V_6P}K45zuG4>*$?;u&+81q+^?uZdPX30WfbNTklmdv&R4E?^e755CG6uW1FO
zKO}H;x4DV>Fx<{ldNVnt{Cc-<V%PB^=?~{&Y}*ur_zWHx+6--B(WoIF!zv#3g&*(?
z&X_2t)g(nKMwjE!`prvEr25Y8Fo=~Yq2tlUqE0vLa5Jobb#S@9p&^O0BC;)#BII|?
zr|lVz!VjpsA%wEaUQyq;XFX1}hPG=KfMdqrS_t87wB~^(qH0{cZEc^6E5x9X=H2nl
z2#;{ZU^ux&g@;kZ#eN?VXGX;4M4x+kwZDA9ijO~13f~pU1qZ`!ky?X7PjBV^gy=W#
zqrFh#zN^bmJ?nj08s?UesDj4`Z;!MR(xg5Kj{2Bopz-4sD=}4YC5|a{%}g^dgY1<X
zIjOJs4G)`xs`qASzF&|*d|_n$gwXYo)Nj)i&zXkH#mP*3tP;-4wC{*kzVxpMvqT#X
zf3+Td{;Z&-^-ebD+G2F<_ix?|Vg9k=Ig9BUjMNqp5zMLtXl<QM%F*Ay8{>4kgNX)?
z{udywKr5+J(vM2D;Lhk!i^;?kepng?mA#isVM<bn67y=*5m7b7Yiudrp_V(O?is`O
zVNoLgX^(79H5$pRH`EC1_e*qN%Sk~;BjwX<^9k?lYyjq<(yLZP@#Ci{JWjTbj+VN*
zq;8|n<GJ$=#bVLFMVV)gq7<nt^zqUEdA1_0P*7QkFJv$vgHqJ7D?OOg4-?&)=Z#|c
zIALLnv!A_T?Hw7N+E0(wigh2s7-!~*?@0bP3LJV@PZCoB!9Mj_3Gu{K{3ms6%)tj-
zs3`0s8Ca;0s<Mv1fB)qAH8&49>|FMVG4Os^WH)m?O!;Iav^GZlwQI)xs_o`#x11yG
zv~~6)%f)wPWdpr)0wV}KU15WCg_&`G%y`2LH!vuOLQpXj389wa$iDPGk26OuBKpY-
zqZ|txMdoMEez^br-AjA<C(LDv4CQc}Fb1U1PRWF0U9g<^(UUbkJ<<N1ImprP;Nzz`
zm>LcC;VYK(tR^eHe4U@_ZH-M$qny@-xSXQ+r7A3%eLimM`!}dVpfnSW(LNdd8kj^|
ztIKvL8$TH~|2Dd3RD9)-S7fhcZjgG2@Esdo;EE1et&X>lz`VtwbdPRNQMgv(M4jOe
zpH^>|(oz}1f<-?xy%aJK@Gg$5{k_yGzaT6u(jLzOgpAw-TrdBU2|N>uXTwdn4L%46
zKJj1_se(LzwY9_blb#Lonf;Nh2m8_ppG{;ikRUH)O^9}2NzDUly#_<>mNRBMm(#ko
zYoXlc7%2M#JxV<g2Ab*cxVSfN&V^xN6I)Y~CfP1u8X6kbNo~LwPIOV`c%99!`6i3_
zSa1NS6^M46i<YbhR7Bq7`-{x<$Laj}(~W!%9Tb?CQ!}^B*b->JkDz)F{=G#dF<-wv
z1DKNF4dY8{qu-tn3fTHGLU`L97a8~sMrZ|LE$7A+0qml)rHf{!ZbKlmvK!kX$qHyO
zlr*pz37G!O$M4I+_$3sNPtSK7Uj=vZm8#%P{}3S;TeI~3Cpzm|h{HKp)Y$~aZ_6HP
zxR&(>wqFf$6Lxlf;6I*xu}neck5OVYHIlH*wjh`Y1{0nV&+VT6wR3l;`)1RTX-l4@
zU^sU^AIA3y@_s|_Z&gGeo5gFs5=;A=^9es3I@l+{;SwIyW%z+6)WZ#Ygiw3G8XqM~
zo(Veq!u8Nl=+ksCIFvd%8MLA7$4~y$ON_9as~%!XKKU73h1||eC~;OQ>)#Nre=j!a
z_JfIl5B5!3`fI$vYp?o_fKF<Ad$KGwa4~_z+2H&cx_7imy2ArShgy^Tq~@E81@aJr
zxxZ(tgjARNeM7w^O<+Bgw7P0m<|~iO(`W5|a~>d5_Qf7lo4Y|zo@HhYtj#sBpeF2+
z4W@3L%#OaIpol0^G*Pb)mw+_>6>>e<N&E1Dd$PqJJqxTPmSGUfjg~5Qg8X%fLUopr
zr99atr09kW3Do7)&;Amc@_mVbQ2g1<PrxWECm;y-WR$V3?c(HSV4|i@->kCC0B_Y!
zM!u<ucWN+8)Xep_Ky<sB4J~y$#d{c^vD{PyGpG@nb=BfdAUHQ(RZn5}=fZ=u{_6-m
zz)U%lJPTT-)=<^9MS60|(I@uj>dlu!U@PhNJg?kBkBX)I6N1B;@88*pxhkO_9h3Q4
z&88zU`0%7v8!2h>!&*H0hNV12aqy=S+}2B!Cj}Fk^!rOyESiqS^30qAgt7?Nm!#>h
z`y4N}&un)xX{dS}_I{D1cr?F*KeQ@%=yjJU-0SkSdl0=}-ye??c-=*6Ea4?A+8efI
z4UVxf(Lcu+{>~y4SOM)n0_H&U;#)Oehq1Fi`6G~)mlruDgez($fEb1D;4~^1Lf9X|
zs?nUdDkDn*(3G>UnSEyn$87AYNVR(#&k^%_?d{WUa<^nAUU4|czkl!I?1O>)H>V{o
zE+AgVtpyRat1lpWFF*v_=JDE~CuK5TKC4v$&eZ<H)EMmpSH;Cv*jlzqqa!n~(MS_e
z&R)z&h#PEAe>j|l4mq&CANF2dxM}`=`E*zR)nTl&@~f;T7#P>5f5hw1nT4wCl#S;X
z)$cjx07UxPxQ$&ftuj9c8GIXrS_1HK7-=?WKwVy{dAo%Bj;8BqQ+W9!L=}LM(F6M9
zqs*1l!^=Jfn@Vf09Es#vidXcC$26_i&q2L0?$gX_T#uoR8!1qvBoJZkrq{l{rsF^T
zRkAglFK^S<?hQl+wd38@6pN4IiJI;ol^>GUX?KbT@vl(J%X46p#Ie1B?_0&Yt*t*t
zZ}*6*qJd<Nhi!+gxF%5EEgDJ&DhJt%RCz<gsf(5V&BLpc2H{}GuT2*~lapMD(Z0^;
zjTH9xM-mn~j(cPEs!v_Dv3vBO7}PDL-ft1iy#qy_JF6oBfgA1fWO^z5GR&ex0Pf-7
z9QINwdp#c+q8ty~m_GDSe!=HXw7h?0)@-w?q3*m+jZ$Our@~|cB}PfvAZPD2Ov9!;
zqe8z^`YMl>CN_)5Qj?91O<wc-P^mWHbC8tEBS;o%!v|Cgce>%jL!X|WdD_|fqbAco
zLiibiu$QMjUS1)5eCpOh_*pbgg~Lz$5cM*xOMiEFfl?|EFrF8E3v<~u0muk6g70t5
z-2@r$dv0z)tpIKWuYz^|R0U~m9h;`gv|-DZ8H?uI6FL=jJtmX!S5NRqWNm8g%<Gn8
zs!VXDPeBxbIq32x`xyEpuokHEIrl&=XN-l}Z0)nGMCRA}Cp*!!GL{nSN6IaHzC~s|
zkZ@jQ3Umipm6qU?zJRiFF9`|SR3IienDrIv$_6CM_t{(nT3g*W$6rfpuJo6M@vB#B
zJcBrlX1|WtSq|LW(~MzeEJd4{GTfOp0N9jXzzn}|iLj-%)>Ma)FFRFJr!QuHn!&{n
znE;Q%AH_ml26(o$Xk{22exxINBb_|8<|KY;yHqB?f`=0o4r>*~(}X-Bg5TpXHmOe)
zr5z7Hs2g1Wbx?J~qKRZ>A{Gi1b37lAM?_GNyea);Q}}g0we?0-A}#IOXT@@}wxQwb
z@<2MK%;Tn*kRw|r)n@g3lgmP7vb2q<Vbp&Xy$aSw8yapGrkTG~R6P?jGqO@IUCPCY
zcF+jtg;v3vOE4T;Ly!5~rmpT_(q(5KsNR9WzhwpH=V^}Db2fofuPaohjy6jjCuP54
zXx_7(xb|_CUTK8IB>;5iAzh5twI^Fs;cgu|?jPyBJ}@)zgecm|EhzRADMwouN};2|
zK4!Fvl4wF6{lA_$gVS|KI7}a&>L(a@*x5I>rZB)3Z};={uV2OYNV9S%-wU5`ySpZ(
zXrQkAsQwndy0^&I&)t<%XT6;2FDzL7%X`Q4H)anClxWA5ey+R7KV)MIORZugAe&Zk
z{r!W~t~@&LXxBfOAQiKHlJPSax_-)kACFiDCrwzr;drsu>W3r`libJD_X=4=kf?Sq
z<`Kiv2-JMMYOYyS8QEMO@SUo>FoR^bn6N~lX1;+|*O$%k#P)X_Q|T`2U8KHP`1-Xx
z<u3~hCL1a&iQ@L#;w?;Ve*RuzFxSpLI@UoS4L|OkK^Lf~H5Gf;R~`pPW)hxABx^XN
z{GoL}O4ND#d1Sp*z~ab8mmQ<$n3!jvKCXvLu*eh_sc7h!{CH|)#NvFiQ+TyMNFBuQ
zKtC}zx7{CCju;B26<>3=opwA)Ge2(;?XGzWF1Da<T=}KRUw!&u9iMHZD}otjz1vU%
zwLjKI=}$P}A=>%=;S?0-;x_N-k%~sgzq$m1li7JW5@rVnCS?Xggj>T27J~r&$}L2v
zrD|rlkK%*Z)hayl8R%Mh78j;oGSNH=hL6CzlHpXMM$JcX<|u84FQ7{u*YZx2+UQsK
z8Xk%KCW#`6qV)a%j8$dx_}<iO4fnVVWvLxjkQ))Cx=W|--P@q4wo5~q$%5CT-*nqE
zNdGEGI%$4CGDwXlb~vy^JR&0~jA^_rL3q{7J8$O6&K%<9-~(MHC~)J??gBIG7(Zhv
zR9Dx+&CT!Iw~zcSIHpENcMV2*;6U6#@W`_+%9yZ?8v@Sev(oZG9tm8-7!Cne8i$2u
zd0Q}@{SK2N*mS-zFBS7MLF)?qtzgfI-t697@z-17nK~f7<UH#HUl^Tu8cb*PB#v=e
zwD9ut@O%>@B$x$X<Z>mUVgLhszR{1{>grrt%TWZHRERskNbquL8m8l`&qzx}9_<~?
z!>ss3g?I;1EFzB-yntM6tW1g-9jYj<3hczLr>MBiPoEA47U9Hxd*eyMGdVU$LMS6c
z@#9dEg$Y`g;u`URN#OqSqh*P+zuip$XfJgfN5L2VjlDFrfBS2yVn-{%$XGk}zT%(#
zWgeW567JF(r}sa{cdoz@*k@}cDIo<2IM6>peN4rH7basaXwQxv=L$U9W(h7&|EM1`
zAo?t19SLqu<dl-O`#yxB!9Yh)fjOGZJ5_5%4*RExP}Yr(z5QkTe<AgExc8Z7s+;E1
z1ZS$vR6x;6c@qvOuJ7)QN<V2~TJP|ci@w7T$J-D9z4F#s;RMUKh=@yI3PvNs3y)&`
z``z<r{L+uXLG}LTZ8VhqqvK<&=XhpP=Hcn-#2{mj=5(K*Iu0aXRq9);gNJ@w^qsw-
zts@tqioli({42Hki9*d=+Ap)_I3Q60G(Z4wj?Ac$0Gus}Z(nu)Pgv_1b{q{s;^iS&
zSv4@6&0cc7pMeJJ16N6ye5yViH&-xMf&av3h)#l<mbTpIPiXZ|5mFUCx1tzY!k1Aq
z!hyz^ZT#1{&HowB*X<ZC<}Fv%CKG&PL@sf+UA}B}04!4^<6B>XWGcR?)K1ht*j6zj
zhCRb!cW`<DR#0LKeh~gu{_j8NpcqTM1CNyW|A-VUd`!&s)d{a{Q7(s_3Q&uq^g&1c
ztxx4+>TGJFaGf96DCHzA?RI&k;^%jc^r$)@c<bt?VuIdsGy`~32)Wz;YC&{taBr!X
zdkCqGiAsrHtte}A-+vN=4G}YW9pU6in@k`+*UV9a)^;KeR!``Z7}X_G->>UhiJI@^
zfBAC!?p-q(+4Uh<-61WZlN9*VGgTENls`JTuLowJO3t<UzxwRLyR2Z-RY3qkaoZZs
z08Zc$+WEFYN|S6{dDL83{PMU;-?({p_Twj}6;1~-oH}*6*?k6~A{A7d-sr!Ki8W`c
zCjgbTe7d{koKIbJ2PqJWgU#$eMB`xx;Yy;TACr?8ftr{|#DY4|!54+bGIvZ)_-(5{
zjDIl7M*ewFSUtV=*NSd=auvDnE1>B@h`#5IeJUKnJzImNYkMYU`sYj<5IolR2ejg6
zoeap!AAvc_w>J?+BV~WwRzh_!bw|5>HYdVh;Va-CnQt5ROFc7N3pT6PEtkx~64{ye
zJMqhmMkAy%{2qt1?N~a%pBR9~p2wi0<2|-epI2$HFZvp3v|NI{(B|sc9l8wqwxz@6
z5sk7w#p0JRUsY0Dgo!N#)^zuS0UWaV>YR8PgF6Um%niW8icshI&^(Hho9&;oa4kqO
zv-7cPxvnVie)WiF?e#{gTwSTGtQ1E?a(-a%Km7)TE`@#(vryIC;2^xE%Rl)eIM}6i
zsMxe3+3Miom$P25;d^5bH@pksob83xah#p#u!{#QaK>KCC>fnFHfVv{P(ZdzxlUq!
zO+jsxzVl{qXb3PDjBh5vl}39WHw~sqsxj{4g|(%nseswA-?<DT5%Glcu><#y=~|?Z
z?_ey05@YhR%*HEpA|+yw=42#NNc!>*0bKz&8rO^MhD&P3=KsM4OUC#y&@-10bp((r
z{|2BVa}TfpjZ?N8W7Tk8AsR{D{fv`5siRcuWV1wvh%0Ko+H4bW%hIFk+u8j+vC)76
z$$w8Lm~#mrF;?WaH;Z+veia!8gIlK4hZC_3tN3{`F`F+#{zQ!z?dl~E?XQ7mSyU{6
zEUHg2Z!cDZ0Gvq4xaerGC7DX&Yw^Mw?GkDx<Z?Ynu-zZy8>80J5I?EBK5n2U3gS|q
zfxB_ME%MSi7VfSPl4UFU+n>q27e?6%-SF=>dJBCK>=17GoR?RVgvmjEpv)R@G>vUU
zFTxClaOfJ(uH;5WF?-xc^V^<hKXm?mhpcH$wTl3SNNxgpR8C&^=ED(LtZZTFs}E1l
zL=+sy<c;maDVeXW<c)$*0HOv6I|pzG1QTe+{fqNPXOWUkESy>n_r2S&$SHMXPjga=
zbMWgkU!|<<Vp5jdbu%gB{RjL#CU;8HL5_ze#2B^|qNYI>AFNDKXM7bK7kT)o8cu7n
zcGEODM`uG_%B}tgJ$PiBatFJem9Z-H`U+?p^`ZBZLZyiCso+38>F^(*KH>T0i(w1E
z7&sKNy&oy7WB}{g`$+q*?(EuXuA)p_I784n<#>tY`a(;=%H-P6%nX>Lxr+beYNsQX
zC(1%q(?#ene0D`XGbHt8EOYR?ahAyPzC2BosnsGC%a=S%Kwg9Ou6@otCAXibBTCkF
zp;?QXI#RqG^#fHnL&{m6(IY6?7!vV!MDFhwyCrKs3oubZA3_xsFL8SrLhggR9Oy14
zv^SJ2yO1<$wyZ>k#`_l8Uh`dR7Z@96>kTaU{JNh~z0$DlS1Yg5WXC5kSHC5~0)b4m
zXOP)Q8t79n8`SIXy(+-f%2c+w=dJ3fDnFfmA2gsqO`*ms{JesKe$s^;USU7@GlT?1
zHaJl{rLDc)`{r+02fQs#cyq_<w}MlZ1?1aeuuKGBY@u`!jeC8mw+Nv015ros?^J-t
zA`Dux>E$}xN^v_5-H{z9N;nN?V!b81a4+h>l}~PH1W}w5c<_!vis(m+#{^)OsfX`4
zuYJ2WF2~+8<~9b$Xzd><cbTvT!{tY)$QRyBO$C9a=OBsC&nMF|)6+XomB;3y>pDan
z8KsLV(`V=tc2g@{7Qwl)Gxjm={PK&xS|dV!)~=Ut-nH~9_uzhEp111WKC}?(5{T)d
zY8WnMhQY%Emi=_2{Vmd0*>O{(H&!njoDQ;S3w7=Q2&g{@spy)wb<eS%5XSE^IK$i0
z>*epu+S%!H=+F0vcfZnbadxq|5*e|*a4$BNuIEv<s%eQGrb&pgj7&rcCka0xTfH~6
zG+*GpWV!R}5LOoB@fWyTW?6JJzfjb`l_Ky$W?1~oa`!6^dE=r4lQpv&ilk`#>88d)
zmD>gLT!)phK~L9Hk1<hu&e(F>*2Q9*(>;P?iHB39x_Os}qhw_FN|bF}EAjq|W%Jb2
zZpB+)qQg5LNd3jh2Fs1LTZX;E2=g<QN4p-&)z*EbcdKo*Y6r_v_hILTca;fjj-R+6
z{`f>DGljooEt%q80z!!PvJ*E!ygucYntL=A&%uSdj7Vd<W&acx_i9qdTPZpi9N|7H
z_z~`fl1&IB5P$!`g>WNX5qbxtw0sX{uQg#MIQhuUsyT0(Zh;FID2KiQ(pt-C4(Z@!
zw?!~-$=lixN>(H5wTnxN--Ht4UUgs!DhuU|e_CV+OL3iCk1Pz=_atEILG*6`^}*5?
zUKb@=H4#}AEo&{Pdko|8ib@tGw3fM?&#~NB`UgJ*Q2=9YR1GIEN>8TK1B!dH86vv*
zK1{cw!5rz$K(TG)de(x2M#9!sC)PKPT_+r;Gwb>BqLTIV(GmT_ow+z)QpZ%n=(eqh
z0!0iKF^N)5steu|R&cSKuE{(yvh(2@m1{=Mn8;0pQ#S*3`ygPKbB^L6EE{@B+_7TS
z&)DAhg082tq3_}t&E!X0LeqpMIHbi8)==zuNAhNulVJcHw-yBbM;vz5^R}ME%k6mF
zxMWIa0E>{T_li>JaOMRvoFJ5)f&GP5NU6Vw36}{a<=37py`V0Wwr_qclg<#{L9W4f
zAUm3w{S^*Byof(fR+%6s`Cc=$-$B4PW5pT4UxnTf&rm7WEsMghwi{!*1I0lmwUKJV
zk7#CC;q)D#kEYTgE9}V>Q$FQdU6jp0Dy*rYoT(ejt5V3d2Gl5}@}e}jt^oVVenbMP
zVsv%xXNWBs1nYXASTIMz6NK`QA6NVP^AVBA%K7c0V-11oubrDSR-56l22=5QP)XX-
zN^#&9L&=|y|DoTk2{z?Uc?n@3YL2VTO1e8g^a<a~eFa+h`#(hoxMu?f5b@Lcgl=fa
zBCgF9lzHNfAN}5b;#7i{W!EMg;r45FqRn+wF3m7YLK}2Rx<0<Xh|q705pGDr6d&c}
zNCPv^*zTIH<Eqq^)Av?~YyOiY%!eERBc#Rw=8`e~nGyQajqh#VkFH|IMqJ~*?lp!>
z43udNt_*P4r*S$m^1evLmbcy*yD^K;2j!aW4!+LS`}W5jJlVC>sGvv#HpNThSEBMT
zYqd-(TX70-^+mEIn}K~V$iY3;3igkVOQd%8mp!rvfk!fT-WIl_cp9|cE{gw#(W}ZY
z^{yTmB(iV!0%v6{pbMC}Q})+>JaKD~AUWGN8kB$<qSW!p;oBl8ZX(40Ican3HfHC6
zv*FpJK3nRsI#DV=%HKAwE9eL{IC3W8DtV(`M8vh5FpgO0X_&*47rXXt@_M?-?*dsm
z`Vq1!>{sL{x^8BWnJJ!b6mK}W$6o!Bt9`Z$(^O!J@#1$7wDDd{JXf4q`=7B-qh=Un
zv?^HB17Y=|1N8gvyZDP~%%tz(t_w&!ix29T*kGxvD_DvWQqD(dD%d+$Ec|A4cq)ru
znArBSz(0>~OPFHd@AYu3#!63b6o^N;&_cWfb~>#ViD$&z^CtrwDod;ga(>gyN=$}d
znzz|caMc~f`E;LMdS!LICfcbYE>~1~!Fl$9Sz+lR8zO(W9GxvLo$9F<5r#2!N#j1H
zR*2ob`9dVS=gx8$=bMBWpSb?x&G>Zl%q{NN7BDT-tH)Q+^+ZWB@W4o|Pdh}fYLw<<
z3Bk+BwYw{;;4-6>Fo|!B%v|-P7sgNJ=<Z;sWjKB1D~mjhjmKd={sQVA0%r*!rli+L
zB{qKO+nsH&8s1Y{P{n)DU#T$B(ym2HmQztMS+&^=p&1AdB~DFMu9w823gn5}xF&$M
z6OR0#an^r|sMYyfoWo=uh?!mw240GV?GXgZu&7kXl~9H;^A_|j^=9N9_Vn;!QikdV
z1O=T8JApmGpZQDv(GjnT+nbxDHeUImHKg!j8HP&APd<8tAV)^etW<PusQ0TN3`9)1
z>~tioH4tn=i1H`h0Rp>nSsZ$cCjLEt7wl5AnN8M`;V7Ze?*W)o)?V@H0B&6kzaq_N
z%#myn9;M04T8HwXY|vQNPM8@!CFDMS#yS6A9c6HM`<!b5Q>0pBzv6ql4NJvzO7;<r
zVz)ZLnS7oG<U7dh_f%1?tbX>~ChDkikFwP^!h+{NG*Xrp`pjvk_;{>dCKN@K;5Tl!
z8fb0qJ%zXP7%zHW9R6cbaC{(m!VQr(3blK8gv+fPX$Sa9Q_1_}Xude}%F@l;Z7EeU
z6)UG>8K6Sh+QOpns%0WYoE0Jg3u}b#;as7gY)YI7_J(wI2_gFmy|2U_XO`K>RG-Kc
z`SV+2oZ0#23L8jd+FA(tD2jN6F{H}b7z#QSIn^J}ym^$Exa=D(ZmwH?prteX?Eo|A
z>W+nO7oP#!dX2<LCezNK)b+op0=!njV(wWzTuxH<sZKHbFA2Mm`iQ(`GA-rRw;g#d
z%fDLKKPYNz96|mE7dxQ~Jc9EMiq#mBi9Pzq$v<XDTw_2n0@>vu(gh;onX`*ac~5Qa
znqHrJz5RAOfOtT%jn93)B|fLCSCVpZ>L~rr6p;+Pl)-srD`Oaekv<moc2B=}A|G!I
zO}nd&(7Fia)W*4J_0@%g-b|0(4pFVcZh~vtzIl@nm+zeO`beps=e=A3Rjtx}s9O|i
zq53SB7)c>(_XN$odqu3>9OLlB_yLE@eG>)~9Vg<?4<X{5q<Y?>8HeBxznhKiKY|UU
zAsV$w0j0X2*z9R9@jA))QieEAS2x`&p{nSUW%$L8#^j(mq!2>P{R#Sj{cjw$<AZhe
z7$%GJzEB(<+RSj`9k3F^X)Ue%wO;W2@o)uP2)T7-Oa<j$_ThAgm7t;>4Z%c7K<ezo
z%hT?w?m>6RPAMF>`jejGsGS?|h&)3MgWIl_&<N*^t0S7r-vz3s;fVEhWKfxMsV^@-
zF>b0!zTln>u|+|5aQ7qzpC6Z~@cD6nEE42*n1^c=UF)I8jl<eROS70qoSIWuU-&6v
z-@{v_B)1HR$ZSaz=vA9k<dlDE(yMkXIi@?s)W6BdZbx>-7EJh9*84RSF6374H_w8n
zeQVb7F9HbYDV`;KgDtG}nidh4Be}mQ<{M7n;}qKqHyp<$`(_xteRVc<J3HnEgHibY
zaLa{8_1dlF!s0lvCV*z3Ec1y=nGQf0i2mGGe}B7MSV&ge<jHu4OT+w^9fW-*q@v;h
z+c;By#KsE+>L|DbHz5=EQ$+cKjU;AyQ=Es?$KecNVJ#8-EQ#|IpwzB2ECJ8B7xTsk
z1gY1xZJOAnhfMCJfgT>sJW5vpQP$_J<5$>ix&&xk!F1*u%ae+uo9*;oxwkT>DR9l6
zd8!96(ko)S)`9H*^5yiXIL`Cmk{(A{p)`IYY&sH)45Yr&>x+x6x5gDKVw!4$vhwhu
zl!Y42R!2@N#ObF9ns9t*Brl0+ha5Y1n~SM%!SOi8!#*d^+1m<0O4(?~t{?95Xquy4
zcL2dT=ybE}<nnwbGxTfhhjG%M+;%8W(2l}FcO2HF>fPnes*x6gRtDY1ySociYMx%B
zVGNX^IDrFocqAVz_Y4Um8|h&s3My(mmwcHKO*p7;Md&4Cnw^XEE!^pIm+%Z6S9M21
z$y9)5lB_R=&Ri!--F_<=pCx!&VIf;0cLNxBURRCnBO~ic2xbAK(6R}TLQG;Z$L`tb
zsg>(9aNjh@C*yACF^a#*P0>#H&B832PNkhn&%61bACWeF0Ryt5+j*Qj*(&CBA8w?f
z3pwvXI~bHGYJJ+1ik&a?GCZQ6ig+xOylBTb6kW2a6CLgYjUyxCq(xi&AH_9>mj3Wj
zNS*tY2d1vxuOX|>z_?;lYkAWl?F=FI`day);A(JUIIn0h`rfTe?=I|M@RVF9U3Q)k
z4NjrNP;$~pa^?P(k<YbU8-Mbz)|^jP;q>q4vNr>n9OxWtXJBQ~>jKNKL3_2>hP&h_
zrG9!*DVy`Xq@{WB5Ggg^GQ8E;=AF>$a+$+m*oHBq5*m<<ftKbPTw-y+>oTud5!MNn
z{fip&jBOXJ{NG8!E3!C%YU%O6KqnTpn5njlrQgmLulvhQ_xB$`vDiWC>n@n4IdlL1
z9F9qfpZ;4W{9l~N*44W#8ofGGWmevMVKT@CL-1lr5gzV#sMZNe<<~Z#KJH=j*%{9O
z{53gLx+P1EnM8|v^V5%+>79+u+qVV7!{r<lxro8$*k`fEG1lXSZ;ZeH!wSiyiTuEx
zshG?SU)R^)MO{M`F7;C@)#S0*hhg&p*-`!*oD?#-_C`ba{0~130{!3ZAuWG-zs(}!
z@fIh$i*ZmCKUE6vG9~j_n#{Uox3^@~Zxpp$p*MhH+i>A^v2V0p|Llqt6&n%ZdL<TB
zrb8Nzi6A9ne4&|jS*M7fw}?xt1Ek}5GCDsE#V>GfWRwUJ4%RJXavrz;-1Y+#1r}5L
zG^i!Yk&Hl%-ClA3uCV(OP!w7z(5t<65(|qVU>-0D9jdZDsga4+m)fZ`l4LiZ{ZcL-
z_q+m(#NilaW)A;d?gUgPtN+n>VH~9j*tkEES5_uX>#4p7$kMhE9U-nGT3{`I5%kqJ
zIsh2vKAXO2qNe(u|7we&kaJvnR5Iqq)W@7`pv;VE%1qQ(=!42s#pGJXM?LZb%0UiV
z_<N(c|6ryxOk*v5;&lV&=Z$~b68LL-OMJ(W?}6ImaqMcfN$UhvfgZi5;Fp7;JMf&!
zas0zfRJoP@HXuFthz9VB?7=NXaXDCrm5s+4SNe>-f^aZpVIuY2l*M&0a3=^f)RF2M
zFzk%ey?Qgra4RcDe(37_z@TzGQe{F4o>5Jz^vC<?a#bPeAEEvI9qXeyZmx}!eW*gB
zxqKi6pBtO#rk52-a5<pQHk?44+xAzcDY&LC(B-(6^-NOmUuP43E^PX@{28yOXzuVr
zSO(^YX0hc7?(0<mMw)1pkig=l<W6gHRQsIy(#APz#c%v<?llewpONos=B?nqfpA+8
zeY+deE-MV$lF#nyU`h|`Pr=tWhpqP=_wvkD(@^gre3oTYx;KDLv;$%nYu+*kj}!l5
zP$F7aF$7>P1d;de<SbnyncnMnOY##xf4)i4^Dp@z){U}9h46otPMH{p<>_8LfE3WE
zz3k_A2A!}C&{27r#hLxKbjXi<9(LD*L!X<V<DUJ<zz5PExIZu~B!nimJ*np45a%ft
z0k)dF3(jT;?U*n+1fuG{ErF1a0k>~xWCwVSVbNg0KeJsJT$e0^h$r(th~ewvcj;>3
z*KluFbAKtzCkK-xg+C)OJ+iW`3m_o;!g`|c)&|l4BE~D&CDJ43pO!ve#|ZaWZx;BZ
zHtpLVVAuwQk#^6HE0&P(*%uZ*p4)%(Z>h1W2i|n65V~FXRT(Z0%(HSxXVIPj!4e3R
zqamdrPn~x)i@t7r-2pF+kwA;9ev$e$6^t&nAq7j=0mJyh%uJ+NMTWRIG8L~_qsPsH
zt6KtY{xR-2kr-?(+!UW83!f6gN>ktFf<ws0%%ZE@Xx9)~yW7kT*eSMdc67VmorkIC
zaLd`1-mQTCcCPDDL)+4n&0LO!(`&xAWZs)f-sYp<!qG#?ZJ2TUX)^BT-@PU6bbvZG
z;#(+n+Sk37#Dxf?5MkkyzCIT*2@2gs-beDj^N>RtfD8Tnk-$t&c4BQrB7ciTtJh!a
z#<zF!hFl0xc;|jGvtTZ>jx&AA=%qGAe8SmWFP+@nnXLo2xHM#M{eBLl<jOWP?Ih!k
zV&==z>`X3W?fK8H7ho~5v#M%kqEG>^w|pm~#Y;cXCe@kKLvmiEhNX9hjUI`ozf@YN
z7=bgl#Xu2HitT1kCKd6B#=-dW-yM~5%!Wc??qAFd1#g8>js-iLRX%VN)XyT7o<z=}
zy_1bQGv#Qk6O&99ZLD}YVB-M;VRZiFi76(q7Zt5(XTB#v><Y#giWS}U@XBK~9JUal
zQ|s~ZS*6<$hbHyoV9HU@(@eMWd1m&2zRGN&Iasfz*(hI~WBh)(Kt?(nstXR}qF#i&
zyW{=&S=I0fx^}p;lCl<@D##2e{^Ns8-Us%^A{@bOk}_9lC$D>1W#Q*FbqDywOvBW)
zuD9x@{%$#~Ugj1<x(Rq)V3NA~f?50P4>0(C2AXB(IpL<80~U6&0f%RHAQcrkYy-$9
zsRdsX8bl?GqO$UbT@Xt=K!vsj7f~okEN=X4mm@vSPF->2-v_3iC0$XlUXDgs;fZ@#
zH;U9^JV3irPUi~o601wSW&*#h^-7+bLc&SMqb3zFiPJhliFYqn66ma%aq$a{Q8sIo
ze0M4CWt4U1`pc!NzQevL88w%RL_Z-Q`=@T7I(tdi6rii>4rw#%D#Lr|a_wc1b>J>R
znb^cz`CrNxbR}b{(w;~u#+?9cW#56VKjk^ijVAM6O(JG8!aaNrXUZ2P9!V^=h734h
zanc;Q5YJ?@+uOUEJyl@g8WR;I0<a!1ssNq(Rt63Tz)W^Af5Ytzh`4O1#{hkq47Syp
zl=Dn=5!mO;p$7|5eB^X>sVyvuMr#Gw*?d2M9g?_j_D94drE8&tDZmq48oVFm3;@~W
zCis^ho{>K4@y5}TbhZIo9FG%gGztEc0kE;tT3P)i;VOYw{Z+evWS5hh$xru1Z&jDo
zrP)(0Q-EXc-~Z(67t{1yY}+)d&j?zmn+Yl4aZ6iYLjMjSyK>dO$}NW8Ou+2qfG@!{
zz*<sM*kB+q<6Kr*j$X{^*LP!M<NWW3>t!qEwsj9o9?2I?hUkP2e{KtSj2q-kFk>zF
z9s3bPTV!6QW$YOVGKO#CwGWSs(KuJYZ0QO#bIvsgU(eu*lg`YqT&IU4n^Q;!)uZXu
z8kZK&!X3rBDA=5JK!77x82w~4XCWhKuEIc=opxN(r&*?`wkNq$j%!Yz)pC^A=J)&R
zL<EEvaI4aW_MPCCPc*X?NWe<7_e-`2bX6#>M^^5HpFfbk>YG968Jf1mo~*y@_<U~;
zOv6R{P85pZF=ys{^(}&k6>6lkHEZ82`tt%Z9hYHef{0XQZC*VK^cqw<|C%b;qWN^E
zCWy0QamA#}m8O|yO%)dE0v@^FAto*^m)ptP`|9xJ<auSAGKB44GCUX8otJlDv?9Jx
zt>L51>1YDmfi8p=Z0%=bXBVYneVN`=%3dNvIhP4W-Sx%zlXx#Y!3|+etx#*uqJZe&
z_||n)D5V2}dcbT$@a1QP;tb%4fQ4C~K9A=0gw4U{74imIQOcr#eSUJkbIgB$c*h!P
z{7L?&GD6|*%dIHNmzBqNI!a{fJDZSJ8oe9sA>a1H<p#G14~C1`BHQP6S_27RS~`Qv
z4>){hnW8wdL-+HIaLnnK-7<L)q4JQ$k%Jqq?MFvFa9_Z86nNeK1`nIh^`U0=h{1vN
zfq?%Ea}qSzPVD2H#bs08EBz|8*Jp_C?*iHm)^4vhG=f<r^MuD}N0dIaaP4Bh=)Y?h
z#cCI&dSbgkMx)3-RkPv0vTfR-(JpZUMgq{<54<Eti>lRXpP8IDrIa)`170WvBor5?
zIXc`{i4cB7@`2!gTMuOPCQZ^nzn|04kkE{735J=bC|tpO;?CR!g+^}UL|M3myNwQ4
z_kXi9P}C)kcW4Vi?al@K!?_Vk-tVXhxxdYs_>ns(@gs<F0~wtCye*cM1WpKdskA)A
z^3R(OhHr85QoamN+nPXPx2=6!H{e`G3p$+3INMBhqWmF;W-|Z2?RpWm<?Nwg|KzNz
z^2^ykR%2MO#Jl2X%k?vlB>M-q4fU)KXaK3Rf!PBgwHO!~?q#GG1Bl#{jv;0lQ2dE)
zHO(Iu6UFIr{J_DXCdHjgH)<J}M1e!@;Gj?a{qj}B{{%JKVh}hVa04btx<i88e+Q&d
z5In?<R!8DBUDE$)ga3ad1#r`n-`dv_u46TNX0ERN2nHbG>fE=xO9+42`V(dlzSH68
z>L?ZWXUh){egEqPv2kxB!}xS|EEVlFGx9g|sAr(Eb8jS=EZ(M7ogv0M0#@a@JF#l5
zL)ux1H%ubkROx`?w*}L|7HwI%&SMUWpvutw6&b&f|9CIJfsDGUz;w!9v;(b&cn2v;
zzP&LXF*Hzr{j<rN5g~OSE(m@~pt!#Jqs1AKhLHeZLWJ}O97`bCTQhrp`_==zEjK$3
zSIdGzYX@I=)XOY}bJ4e_uk?pg7e;1P<I2Q_`fxK-C_)lJ+#H%s(TMA<jMFSQH{T!l
zaPT+*qFnKG>)y!YGlE_t)(5ElM1&OPb$!&*5+&H#_i;ZUYn<he7$F9Qbd|c-LHy1>
zXK;uu7o;^Z(3B{2*VE|11PlmM*S|SLTdS#(!?NB_m99ir-sg9=-6q%{@+giR?NMTw
zaQ23jC?YaCQGv;_Qs7;g{sOU0TXKt0F#5Hd4QztIfIbDBXF4~0dvC!ie5-yjFu)C;
zOA-B1k;ompxwB)xB0lwL5>ArrE;PHff2!QmXHZDU9U+2Pmv%nYA9DX>kF9ox<F@H@
z$G%gpbU)<-&eQI|)GgD6`zv~*YV)E4KwLMQJC9GMpfeNNolk;}pwfv<?bhWW59F8z
z*ps~j8(@52>qT*`FL3Xgc8oWqX1_qAMOAyDv9KZpj~h{;jM3EuiK%;zuLZbKh0i>S
zRE71DlG;pST)d>~PUa>kxLwLtCZ*y(j2LY|9QS&Nl~{7~)nm%%@b*FNaC(5U-2yzW
z8;<4A0cGHGRD!bwWxlbKni7eEN6;mmesU6-!;|F@qtNICvD~6wYQy|b$Uj$Z?55E+
zlG@cK6rc&VeM$?DYJ~C?nNHn2gY8$M%e0WR5Z*4ssj4bQ=+^aWvpqxM*-C@pJ{gpN
z*Kp8ezR}2hhlVo?9seGPq(1IOs?}!$e}6xp3Ifb;_w@ikn+pa)sco-O7KyoIF3zgH
zj>d|${Kz#y$JTP&bb7s<pD9b5?0aOQYa0zM)%sm6gP*bf6Gh%d`eC75GuN%gq^e$s
z@n*b0s~9@`N3N)jog^o}Ul!-n@lAY&oVm}BDST=sQHzMIwmlRL7qfb6G%5T@0u&{S
zJsKXi4FCJUf1oc1yghKI{zElc?grpor=#xmSbm#tv5^64D<a{pAXVdIYdGr@rSAhQ
zc-k&5BMX_C0klEx4+fJiz(j>&jX9ak3Qzk&3vlUH8vhK|NPM3c_~us7kylb09?J`a
z$_9*$^_nv2Wj*3!;`iIraw-rX_&dt1oMXCfkhKCVQ0eLCrx!Ju`p9>X^p*`GiG@Q_
zvx1fbGC4aCR1u$y&j2J1u{92L!<sUIz^zZ(xKXKMvGy}H3@otaN(u$$_(Z-1TWh4J
zqN|vF!bf)p#VM*~cRzkPSyOJO*{xu0Hcthp4-rKzR=@@Z1_r#Wp+7y@yz}?<dbhj2
zS`ZN*RIqS8Yra|?aN*-~PfUGR;npmRu0Tl4%@a0|%(Z$IySgo6Ti;$GO&Lx&ZiKmB
z^UcZL?_X6-xvtJ<IzGiq6_Pf6*&@;K4$3vl;o6)%XA;IC>i7ltXe3hST$%Ujit>&#
z*{7c<4zJionnSAui&c@9?X<(sj~lFCN557mcc#5SW#AE_&Qs-$lTKPjb6P%NqlsT|
zn*=!upV0m(kReF!=%<dKCc@s`H%X3;TH`~ZCj<|D&ccA6z50as)A4$7HbE=B>SRt!
zR*w*8B(=9M;>Fv^v}QmzPSsfRv}NkB;wmwGfg4*2RdT)D&s>$6BW?b1wY+fg3YONh
zPkZdXSMx@1kKiTw#o7!`_>p*y>-xyO>n&P|*e7QjeFsVUmLaU8`r&MZtvR+_Ruvt(
zG17Hl#>t4@Wj!m0O8g-Hn((tLia@NaF?+mv$cW;?hi6juI*@HmIiFcRS9w&Ax-cIh
z7XJy&%oc5&k9CiTIKQ`vwvXhx`D~rH2wc$_%TC8x%i^&Sa68{2+x0vnSkw(KPXals
zuT=VIkje7aQgZJI|Nh68)nvlK!$i)C3ZqetQSU@4$f5>L?pu!)?BqA$Zo5q<-*T`_
zb)Y}@KP?le=E*u?vwEw1UrPh@h!;L~YO%HoE_1n<NnmZQA;H&WK*-UY{eGN_cP<{E
zc&QCMr6`U2uoPxy92j*$jB%5dVeuu9!a~(Z5>~l0T8+it2~A+@?0nj@tcljqvv4_*
zE>;oW!7Ki(3L!_8su+fMbIt1-7A~*((mf(SXa$Bx{-wmE-S#d7he5&IuWzPfD|ZxH
zAI-f4v-@R-V?FfY^55s7a2TM$0qG{-y{iy}arF`I!vOU`U*~k9wLI7e(@3e@Sa^qr
zAms#~B8BE4zuY+@YROsH;ilu(p5|BBnIxlpy23xOSgna#WAupp+t*HAn5I@M#vm#7
zxYyXTF8YkR@6PXhTN)WZ{Hcqbm@80hDeOKtk6!JAY2RBUqHeZWC<WaI#njo$)7FLa
zs8*9VcE&0||JnM}4D_FJ-?LMesyAxPr@>F0npx_F;;kz7?vX4vcHN$d>`4G<r_+0<
zfj{Qr=p}FkIuOHhUdRdMDYJb0=S)1UXY$baR^u)GY-L-PYEJmR1Vg%vhaT<IGztah
zq#yXobyL1u&O&L|3YEPlwSZ|GHgqQT@^U@OuojHdc%~O1gd01wbGYRrG(I}|WpR5O
zTt?+SV5N7oknTf!*+T1rc+OH{Ip4TC^|C^U`iNk^ZYgGhX5yD<609H<fA&7i|Nekb
z!|&-cv4!0MgDvHlW~){c6NA@Tk|`RBX$sNgn~WB88X{^`<mBX(l#~n%yGy;1+8DW&
z-)6FoZO#u}Y!ye$TtH}?QBg7I!j20!vYvU$f`RFzWbNr{Gbqbr-n?Gq{KSoBtF_>+
zP`CG?6Q+r~s%E9yQJXjwEjmi?isb=O=Ca%5|1yj;XEP294Dbpoi{{Lwb`kAt$A+v-
zV5c*7_Vn6fO4ZSMH-7NbFU2o5$7D(IjfU2XWfEIQ+dUPxzpDGV@JO*ZQ#v5JkVG%G
zz(CHxNl;xmP5Ot|O&iD_<oS00E?q!nvA?m==&P-9mT+IaHkxwFHj|>KZ4V=PLJ&Ur
z)_~OuSy?>$2@d;TZ$eI+vknRy&m*r>Mxz8y8`=xU5HJhb9N)@$>+~tPwhw??C9YkI
zB=H*`rGt?KQ@YN<qz5NEZjrAw4JbLn!zCUq(8jmA8rX)gdh3T1E+n??i_iLo)&&>6
z6R}aw5OQFA4ReAT>4O%uXS6{2e4~NtKFoZpk~lcfa+=R~#7!3{ec{(Ir56Iw!b7eM
zmU8QgzSlIH79SE^!yxkbZ1LqHP=Y{z3zWL|Ik*$BDddp;1#~N`AAK=R@7<d38i2-6
zX<Cq}6x2Gl*$i;87w}a^MwOctnx2WW*UIGV)8NhB7s5capT@2y;<gVK?FIAuJw1*E
zp(s`Pc=8jz#T06?_2ss1L4koC1?omjWn%Y$rK@_tA)2Vr+*7V<Z$Jf3oF0&$CD~Am
z1A~zbrj$E6>%tR74AqKKks6BauLXte>!Z7DfFjPi0Um(;$YfQKjOP&Lrndbzv&#mY
z|MjhM<hs$@zzqAXLy8Al+NsOc{MG5E(p2asZgbgJ@3hsk%=l-bKM9SBOqb!qKNVCt
zPY$HjsLDWs=RY?r0-*%|Vm<;lM<r-<pT2nK{5Yc-3TK{oGROdWXEzC9N4{=U5`zHV
zC7lGm!1CxQW_rd2F@N*mPzj=q^g8kq1@lPWSYhHWtG9{n7_If6gp8a@W-HVQxs>X|
z(tWH#RlR#|&TOI@Znz)bzR|05iiT(Pa<~3na>!ah^m%kumAU8M6x}gbj)CqN-;>4J
z=%bokXf=zT{7T4ihE7=q%7sVtYZOW<o#m~E1C0Xp&jbXoD#|0KAgeGCv@p?qEr^|_
zl1QF^G@VB8qyLYy_m0Q9edETjjFedlWfx_WolVIqTcnKaD0^j#gzS(#%1$WC9wFJA
zD0}Zq_U3ndxYzf2p1*$ge|Im}`8m(yJjVN&r^dWmVsa<j<8`IS8QSmg=EQ6!&yYlf
zhZp4jU-uIbP>0-4K5{>}a6gwmLff=svE$+0#b^RmJ6|CmCMks<6i(G$q7AWM7{2Zp
z7nk#8#M!YpHbgG`89Aah?U@a37aK_yAZ1q*#eXn(v+PYTi=FFgmWJX{p;~T1m)%<u
zh|AV2iGIAi+`?i|``@dY4QQMtbeyW;s(D-nsbFYlPB|ZVkWE>=&Dz9N>#8<W&oUmw
zKVIfY#Kv5zoc&jA5@i{WDf=g#&}0T)dmE@*v?*V8jht!VQfXS5kjAHQ5WB|L)J9fK
zboes^|J@s&^Mii{R>_M)zm3~5nHV-4TjP7Ncd~w+5l!p%k5kmjv}rN@pn9$}UZtRO
z-7KO~kR6vdz4GVF;CzZlrZ`6DV?Ve>Y=w0^nf|j8wn5RWUML>H_RXZIe<8wzUW+Sb
zGfed#0W)nQXJc%LqJkKLsYrl;P28tXuGR^KCB{|`O^I2zF`osH4lfoE(S4ncyjasD
z*f8}_w$XR$Sjoo9WptixD)KbmKfbxU%F5?StQY$~!!xMb_G+2;>oQB(?Re*6yCTyT
zT*hj!S3YPw3|v$}p+0$;uTh<5(MX@BLO;Ugip|&`n+xh5cWg_mx~QHz)lT8G$|uVD
z;uFKyM&n{H)2EfPMK-=#MpSP(j%?Sa<>#Dq*gG@dG=X@DydBz2&vG7mkYEJ)lc)U4
zq8|riG)kmW353pIqL@RFD!OW(l~zaJ-@@VU%hA1DmF?+kc+F6EB`X?a!}AI0JhEfd
z7W+V1{W45Fk&DM9MX>6&$jauxn(0OTW(<7l!HKnYe#UzC&Ac0A4_IZy<kg$Ly*U5u
z&&73?b`8}8x+Lr0Ul`!M_wnN<%v<MoM=jl&&heZx_<^6&-Knv4LFze6cUpYdm3Bw`
z9dgt3)~io{;!pElN!$6(7N6C{nIVi_+04WncQ3DLef6yR;d@Gv*mssQ&2;U{>c1s4
zUmACauDX4P47p^1)p;YN9)Rtf5#AYj^Ur;aCiJtMW;6n6`G4Eb>5rX+)c1(aJh?-_
zYyUx?NO6rtU+ulSb<UTP)kW~NoLfIXcZT>%|H6QjS%Uf-B9;Z(sHfMi(Y$@6lda{=
zVo#os?27l~G!b@eg@X?}8M_uEJ3Biwv!K)JB-#IUryKM4kvolWFpW&16hBkAx$;*b
zT1j9-t2W8`&P3LDh^dR@B3)DU`s#S3fl(J&a89Ab@9Pb?)}PLX+(xG4s9A@7mY#3f
zW^-E!Bt_p>$yo|9lF8Lp#Ev@B@coYIJ3UGD@)Rm^MyTvKH;ZM(+w^rqI8y@wZtHBP
z<}vfJRYo3uBgstX3ke9&DgJ{kK>erTZ@yH{d-?EwpqH9L%TgB`_GJjW4-1HWK=QQK
zx{Orla{pea`yX*FxYNdHyD_h)*k0D(XCFJE`T^3#oq-~leR(76s#j6TW}nR~4ZKOL
zjLiDS2tSafn0^&x+%ekH3r}z|7a#ryrg6&m@U2(tieiaZV35irOhSV@)KET&fCs-I
zV~K35@%D=ZhdUK-6lcn>NJ%g=Tz8l&Rn!0g$z@y{v7KO>@hqv^c_l?IN$8ghv>84g
z$@=8;8|f4>zh!V2+%JYCL(|iQTY9zV_QsMGYyl&~xFjK;rNLy6-?<k^dVSp}vpnj#
zomQWG_~C^;vGX1Y#XkHBO`*^r`rrrT&>@xoJ_0&!nsggcs1`UDjLquWa#_2)%<gV5
z6tD5K{0ptyt}8QnF|Nm5U!>jUoBV$}8o`d9lQH`Ko!z`_{d2}}%tuQJvZ|-<0Fb8)
zVTOlKkYc~C{=x3WLUjD16$ewJWml^83WrN-#nItw2%(*g4N~`xfs#FFe<!%q;noxp
zJyfQVFQdnq33+`ZXbyH24j4p&lyjk#G*XWrQxt~P4wkgnj1h`EWrgh^kGuj_qoXt6
z{a%N4+<(fim+{W?r2TZD-&8}KHuC(1vL1us4o#t%dBUw77g8Q1zKFC!S(LSE_vZ^C
zeUrp=Cw-Hu0)xL4+MM4)#eDNuG0p!;Y-X=`)ea2}1ufmJCW8^ZLBxuQgY#4NMbnwD
zAmaM=ug*!&RTa9mq0a{OnGuVNi-CcGMYOr}$E8cfXN3r`?;%C#kjPRf!@$T2jP6gX
z%nDhxELMbqAxPyp6#p|o<<~fODc(R<Exh`d5)u-XJcxTT3E)vUCEDhJpCO5NEtRJn
ze2eN|D@iymr{YM7mKu3r%CE>E*tAs65-2+-rIgcOW2WZ({P~}H8j~hdEu6&|Lh*xY
zh1>50)6cqxa*|sy6XlissJGqW;d}yJPgds_zp&7THu?E$m+m)kLA1A@9KBw2r->%w
zX)(0$hv}+J50+>_G?ClHp{oi4NL)6>Q4y0P&_d%T8v`kaP-@MR7U)HKR8*N>wtZ3t
zthra`-9DZJ)u?;ur{M_|(HLvfB1BOBG?gYbUH1O{Rp#;j&jwCTPGvwa`}#2puSKW}
zY8$}4|Me@sZZ<Txl;#g$xTIq$<$dZ_$_zHWwWFmxbtzJXZlc60_R<$9nky#!iysHs
zwIi#>D>bC~<op(+H&eR?as@u7OL)6eT<TAU`9^2Ywm%K7>wt81sXbl{_snHF-?Hic
zX}h&)in#Q)xGh(t(7j;wjxR(n7*kHV^_h9N^0zc}&5eEa^{>KcmD#xTd>Nz8@>(|}
z5yr;K`UD1%Og;R08kOAJ;p#Y6;{%N>@87=<XHaxMWqmD676zY8SnhIM9^<rRJV^T#
z@A=<Ej$Gi4JD)#MGCd>ArP)1cJ4tR#DSlpLBV;+gx9k{lX@%AZA9oero?*CK%kwFx
zf{t$QUi{5BP+l^8J59IL?pvyz?QwxdG#BS*t1&#NJbS{Nw*CG4*}r2A>dyK5`+*7x
z7?5g!4D``fRkQnD6Q(J)25g_}cMRI?Q1c`X<ha+nzqeo8k=@hTk%u_Z8a1x7d5^I-
zP8_(0Jggnb(sVx%wZl)u<@$j8(o}!+Z6dzZdgxdQ65yy<zvyGS|Lf~hpG5IXmQ(Kn
zd+VE?TUhIGchcgI)|l#dK=s<F;6GydrF3lMZF2n%QW3*n6a&OYYE<i>^V|jl68zE2
zwB<d~wFe39!=)yjN0p7o?vWpKXWB2kVZ32G{oq1977dWBjZiuH#D8VgDM{d$;CxhA
z-c)naS02vPSF{ObEXTg=-p7+##+WFJ_p0sre@`vpS~=-V?<l%y!f@yQag81ux6R~Z
z2gaNIik7+cG#qgSnsR!0HVAg_=ca<0TM4hc8hOHsIed=n`WSY$nxg#It)Ct2MjRfL
znRU^o`0{!y2L}mI@I?@C@MJna=P?|fZ)uU7u2K&!l1jTt)y~_z78`cj2{lt-a7+~y
zph^$Rj$Ipt{>4-qef=nPe#5G{g;T*)dw%iXs5950BNgUy#kQ1yZbI^p7jBG5JkR3v
zb(ziY+|Q*$syHrJS=U213BUEd*|1feYyUGRC8}sm)WcoZ`?S&W3MYW@v*{8ezvE^{
zsuq3(WnG*d6tG$z&Uajsm*ekj9KM{|#l*3<-OR`-|LuQ9plCW&8o|`|blKLrt9bVx
zg*HQw;z!~fs)v7(=i<F|e?CZJbbqI@HExJgJr9|hGJCwUgqtZ6!_bo+e)_V=GoGf;
zoW4?bS~;hAU|P!Eyb!Ub6?MkC-RBl=I^12fM5C?__`g9#YT*hky>`CV^WiUQ06(by
zePC#YLpp0jn2yi9SEFqOm6``SF#YC%7e{5kVcnSfOhOO{AC1eib2ND=mNW8Bptz5l
z%sn0X&z;mU2Gi)yK$*tQlY4UiN0kOq^M9)}R0KT(Dbe{f(&|stcsB3hBv*okdCVn`
z^sp#i@TXxl%OBOd()v%GNX1TW2!7LxJKWTdBMk^?;J%wwJ_gSGoZ+P-h~@EIi>yv2
z05h8QsXI4Q1H;!PGQj_MfJ(J1&R7~m0`xqb<^clRDdHj?OuB$*g~>=Nlnn8>=pQY6
zgaFy<VHiaRWp;NHHL0Ghl|$x#$EoP0ES3BJ(`e2#_1VBEawhU=a9S(6Bt!PzJ^DxQ
zhsy0(1UYmDmtj~~;Rn_0=~xko*M_T(EFq|eN0s!a;O)EhXB#jSEj5t3@$C!M(p!cA
zsG}Yu`r-1ievmBdqn;VDQXGt8tr~MjYvq=e4a9I8?cKi@%OmHwG4G8}^Alf6Aca$!
zh^78f%Da}i=ee4ReStg;m^XDV|Mz~aiZx2W2qN_=Esp1OkO*2DZAvdoZAPV#W7{4_
zw=OOV+03;QAWK3@%40tt)H>xi)qFHq?$nJQx;@oesTn;&8ULRFEA>x=ECqR-*Ka>-
zR^5$@;89j;yTonWp9B5m^F4eOk||v$g%9d9>c@o-Kkp^~pM?)v$Au4wnG~s2xLs`+
z+iy3%ymkEu9V6d;VY5ZCMcy=A@Ropl%W;sLjNr+xU9z=z;5qeR8!3ZeYCdwy$lEc~
z&xHF}+n-92M_}Ic_>Y0wkQ=qiv(a;ygYh{%rbq{F$Lxz8!uNNfEtA)`y#nwkln+K9
zG7m9g>>CK5+ZXD^Mfgr<B_W9D$9*ArwF|xc!|L7TuOy)I-g5z5W#v39!YyVp<0uT2
zxY0LP96c4NU|3a=5B7g3w;|wZDEG-k5Vdhuh$b-GAvW{+2g~xDbSDCDJ`l9NYK5}*
zI*nqmC$p0OC-|GMNWS`=!DQ2Ul|~-j?rNO={EVky%SadJh=knJsN)uFg8rSyf&YT8
zfArWq{l5S$RX^W#YD9>z{S0N{?$@dDD`!%v&jeBPyy}p#S)G)%c74%9bllJl2y^H0
zGo#pI_oZY?B&+H95KuBUmdbs2@s)Ev^VhFmmoHzolxSj_lg-QBaJn(^g3~f*H|{w;
zMi$PkiPI-*s;H^a2Xln(Uilk)(F7(aT&VMz6ME~&%&tX8gG?y#TrkMcKJ`K^Qi)6i
zLJb?e@$i&ws7>QMZ;azsv#WFZC88HS6z{CPrHIIHKcQ!0XD6*ElQ}piM2YU72I8BY
zcR=S_K<DrCfdRLTvD)4l+q`ePi!<%Zk3Kyvr{sVV7Urw(-IPKtW&FgDXC}V9=`+Qk
za*N!A5cCcs>|pe&D~_*FDybZJ%o|+>&>}oFwd56{>X17^FC{^{A^T)7xzqc{IdWNc
ztzz2a134ULeR~8Koo?`17js+g5shpzvbl}=S{h_G&gh)-EsJD@imuJ|@`Z-5qF+@o
zgU)@&C^)iQ;ld3*^M_n!J?BW#{VSE0mA|fLAmbUdPTd^5@>Ll=proaxrKV=LI@!oU
zd+toC@ITbF0srp!hO%^gg$j30f3q-VWga+lX!;C`h&hO@ESo}L(8*G$wqfS*q!#rP
z6#9dqhNp_%q2u==GT%Zz{^shd591<<iH=AcMh*0PKyNr;k(%Stk9Q|12g@_!Y9f4m
zrdXj|#iC;4Co+X$iCkap1xy-TfPvjUPA|(zR23jp;-S!{LYf|qgeu<A!Wq8Z@vNo7
zcp*-EPR1>K-oAM4mIH~VhM_@NTIAUm;vW>RUo&(T2`yQ*)ECB5QTRMo{a_A;i!UV`
zT#LCeG|;v^U#ka<LA<F%^}o{}Q@_Coidfz?cys(VE=<gXs*Bgx;K8#B)=%zka!?+?
zi$~}f&Wdk@?PuDZ_zVWrP(k-JGN7i^Sk$sE0$?$}X;*RabD{u`lV*vo0@yB!9h(w;
z?hF>}cs{Ow#;P4&Z-Qr>8X6uDz-~2%gAWZ}dGtK8JiITAdJ&=eq$B-Z-0436C12M%
z-}mbp%Z;oUqpmV=`qpY$yfye)SnYZ3!AUb{1yLJPC()0*J83Z(E%)ND80{V7|E=Xz
zEf}@pZ`9X0^*-~7w6XCx)a1ZGfyHZf)k!*>Q_!C}vpHbd9T|T!Y^dBx^*|S)ahfN1
z;*;G1mVV0T{FYWXC@6^b$F6abBB!W;Q;5Oq0x{};%O`E9S!8cEcd1BX=fqh~Y7C~3
z4l8+YK7t`0Pcjk`f8-!xwc2IBW^&gHFTixSQ8aq9ThVuN@xS&N>8R0%*EnX!I&X-H
zdDlQ6ETL`I0wEd-e4YZeoA;otvR`?PHP#gSIU$WscYaz?Xi-fQwy%pswG<5v#}zQP
zAZ6dibmVX4FoQ_(y>>X5Nol`k{*-@zoXlsO6K)}EOFyYLA@Bp8ba1GBB*YsDF<z(@
zl_#tajWo2>GX$)h^D}xk7JJ&9ywnuM0b0O!<HNZN5T^)eKgcGkjU0CP@mDdW*8FiX
z<>IRkfM!oj?qoBESiOE*LbJW2qmZpJ1JccS?Pl?R#-s7nf0$j&<icBXEZ8s$WEM}e
z{7*vNr<_Dx;Rr&yfB9DH;DGrcVyl5kxMfBRqRY#u5zxMb-n(ZpnUt$rewErA#K13s
za0{HO{On-JKSxCs;lYWj7F$}{R>?oP9dfOpu=M4h6sJqXy|N(x#sRv8aN+)yX+p=P
zSM5U`13GV$pSRC;5`BHT6}P#BIcurXC3(;h%~^{`CA3e?asE#oVuNJ_hwkCbbZeZ$
zGW7@Ol)rM~BYkp{k0dE}72x=L=GhU9L<<Y6Kt|`q7wI?g)(?M(;~(kgv4^}3jN<!z
z1Gy|S<gze8E2d8l*6TjASo<S(RIbIsbUs7^w9@x0n*xKd;s4Q9er&5NyGzT@MXg*H
zEReHF{ByQEoeE~;YzkE9SOcQ_0{MxMJVa(Te6oUWOI;7Q+BhQkYB4!rk#Oio%7Xcd
z>`p}!nKkyy0XXnMtQvneLdP>$Ds(pU%gYukZj)v!0`QG-4E?$>LPI&ZRhP}h=TI_d
zKA=N`w0I$xbHZ`Qhmb5gEVzUXswp%M8`eohH;b91F3qpqYy7$}e(FqWI{YjABH04d
z*M;}&UuvQFBW&eG4`%0=gOGb7Tn?3pCHivQE`{nb2V;Hx#8p5v2<^GPbHE0n&R6<4
zjz-F;s5u_262S&lQsDcrvQiP)RgA1&o242fPF&;%Z4fItlUmsjd9>Ve9fmayi!f4q
zikm4c+7&0Al)~;-oiwE2K$+~z?d}oqT?B#xyRig!$rm8wvZ_qibU%B!(j`eQYyvrN
z-zj9p&8Dh1Kg$QktaDN&L2<#(RF6L`t>QYmEwwB`c4)5x|K1Y{lTU3G_A8*b4(WX;
z)o*$0g)bmc!pJ)4-ltuqKL(w`F3!XD|DCrXlk(jZ<43yuU8x}Qnwo!_9=WD+dXLAw
z!6py|1qTgUT|3ei*?zts{3)7c<WO4pG_n&DAO@C7)#T(n+apYOcnOHZ4~I517R1<P
znjyP_nC5bUo*b0Jb65l+ttM&h2Qa7xoM^C78Hynr>*WD=+>Z{>=jo`Qjfm31M81a5
z#1Z#B_B&E{HcB>rK0=0^e0|ywB8Iky!CK=^+dS)*a!vGI|Bh<2!7!3QCRof&vKoy=
z>AG7$8<LM##Dgpn+e*bm;aKKEXzH2vGYLaxw22ISS@~76#=)ABZw*I72^|yC-ezjx
zXz@&dz)iEw_9MspCr86OKHBo+1XCV*?x@`1zyuM2vgn(Gm~VwQdxXL-I56BWM&Fw)
zwD}m%dgD{8&~o{$7ce!c*R2UgJB;K{-6z#4xUL5$id|3K{;R=3Md7ao2c}eH4$<ER
zZwjl)3wS<`$5czJ+_$dkB$79$c}Xg}`eqJ^kLgvNGKcdt?N|BDAKuavL`ESKvryo`
z5k6f&xb*k6x;?Ss9@kl56}SPAFMZ8XD_`;XgeTXol@Q4b?mm0}9EI^&8|If$uf1yf
zEdbSA42v-%hSjyVVrks_C#HXn&LlOftM4opI7Tb({Eyw^Y1B~or+E)rm;x$ZvZpq-
z=?vyPl7X?;N}+j0MH!*rGHE~b!r0w(7J-u~1+FF2(S5ILple|<!pYaA_7%UJu#-(T
zB+6qYCJ^%TVItg9HmTI2wYY}}bL2(jFuRO>96G<KSNo%y^S@)B^Q+Jwx7tG5Flybp
zerm2#pyiTQk=O!EazmyId|tHb6L5Vl57Xps#j<D+LR_Gwo#RoxltvrF4Q3guVzP_R
z;AK_ft_KpDEJhIJyMLb#8Nc+H8&OWKf-?js@_Wwj=^0QIG9r=9BNxq|@okrFg&?$~
zsQW%vxmr7wi0Av6cd*`A(R`=LYKk0vQbomyJ>BY}v&AHKQV<5?O=Arh0CP62bBk?5
zONYw#NqN74-qn*@E+3x%onPEl(eI3r;x&s@a;0)G!DzwP)FKzN>l+?qMcVt88F$=-
zy?Q46YikjNV@+_(xmBwNI5g(#)OITYw-D}x(N}~1yfjt6&|mAJSL>IP)5op>g~frQ
zrjaTm2yH`I`9|cU*8y9B)CWps4ppWjqMnD>ugM#(z_ef(qf_cYP;zWoh>W0njp(?v
zXfHdD56_gRzH0`c%t>>3Ao|nvg-axoP5hRXpH1h>o!aZ`Lk#q&fGFx__t|~R{*kVV
zSVSoz`czB(m><8o9!#g_Y#ogKE(riV{hgH4vG@@@;B!22i<2wAC_Y)L|BGp3rt<9v
z#eem6@fTh0dqxRV*ucFxm@NzIsQGJcFH)RbTO{c*&#>3)+#3=a4f)-E4blI*X{&@=
zU^|vO-of1U9GDXVeXMUU^qheUg8n99dozmrmW%z;lUSRhu|W`@O$LmAY$-zJUaPCD
zwu^C$?8oW#aU3Lp3xu%dv7GI)!}>J%iP2)BcR=T=RjCal^|yc<AY*Wh8zRG=lCjT7
z9hy3hnB<ZsT{t$csa=RN!C<NYU$8J)x@x!iG-66x|1~AYgp%=@0`N5Oo1oo8R2B@}
z$(Qegw{@E~l&fUDw}>K+;IJK?f}BwBzZR}B!*=*w3hg;Oo9Q8Mia612fRS~W2&ZHT
zBAoJKF!X4#aiss*pEQmt5+ZTh-s`!`RvfH@=s71cyg}!M9GIzU^ik&^KR$XJUA6_r
zx1npqzAtYQYsx1Fo1?x@(8gBdj^r1Z5KQpbe1wZme~t0;-!T5t_E%<V1!!T0+{n48
zH+kxYWXnen0)4<x$VB2IMtIWW)^uN?Lv3C{6+IZo57I4E=mk-2s@2^KRk1XeH={BN
zFB&$Seg0STfes05G759Z**QGc^7j|Rp3EyhyUP$qEZtbxX3~6f85&cOp?H^zRO;Fw
zKd@K1V;n#U&?EWu@v)IFyB*)$QBuVo>goJ^ElQ`z(}mW{g+yY|@24i2*Xx2OPkSGl
zEIeB%B#FPT_OWa}<EzEFEBM|`4xYHDzOcV#^ke-cM86_rwPY^LFQJBUd3o81Cb3q4
zVMa$yp<$$%pq$QbhuUM!h&U{o8l~jPg^Tv^rFvRwFs?OopQ3_~Z8FEapg#7Itx3~Y
z7L7J8US4=(+fDBE^7`ELP?;ki*ZgBs0Y=e7X6~gO+e)9hZ}3h__`B9P4|)-d>K&a5
z{GcEqLK=(R`A9OyEFnh)$GNUT#iU%wGP0+P!laINLs88POWhQBfQ?=xXyEbhuI!4f
z76yg=u2ys1otdM<z5KR>f#~Q6ty?g|)Mi?_`K_D0@f)1{?n$?ussp|x*DFiE=Uki)
zm~17w=$1Q-7}#2?j9bYE8`afs$Ba<S_T|N`_Z7SCsmzIqp#6s`-CoCEiYakeqMQzi
zc)36IyPtKEno8mvR#r{&C?X88r?DMT&wVB7H~Do*OI?XXP{}Bxi-SVwgu{cW$VYBP
zT$*mZKNtIj%@nla8JyHht@Lo#<}#HJM1(iFm$*#|A3h}1{|z>@s7SZ*OLy0PqqM<9
zaB#3g>dHdinsEzb$;<eMO%0itLK4$#MsMDf|LT>Ak9P>U)EN?^-sZLE(yqly%44P`
z#@m}0zt-K2Y4-DDbt19pjgV41)2P&Syq#$ZJY$*RsO9-x9MkZW=veY*Ev4aiX>`jL
zH=h1<)u^f@blU!Kzrf8cgfpRshH#Hp?r6?hG4OlGr=h847a4=@beevzvZAd{n4=|2
za}hcF>VM9je3sjG`_)g*dac=0p0CxVs<mC3`$x+8K4WjORSuAwCyBTE2dsUBXX9nm
zZ1%!hTH<)k_BGD&bIwU#Wy&Fkw+`+y;v3U!?0(g4jpdD&7IB^JNe`m_dXe{CAj_b(
z)?#Z*>17H>9<KS0_jgq1Ob1VQ8*8{M$Aouh!UL^)-?rMw0<a;qNiO2-nK1Nvph%H3
zWZXS%wQ|4IeuSEZZ&Pk<I>?Bfak*pa-mMyY9N&beeQlk6mTg+E6%NKe>87kFQEz=u
zt$HaP!d`&Am7%DOk8hXdef5kN?R|=igQq@p+|}`X@ZjDS1dzSn!JTtWO4hBdv%WdN
zT1ScdFsF<T&xJVVT0sSEcnizmFB@}bXK^U!z{5o=**57~nMCQMJywUkTy%6o3mvpy
zBu`55Kl>H+$i!o3_2I#;V9V{RblN4^jY75`Mh}N~-gFT=$u#WL`t}jgSO}T~_u`NY
zmK?Es)BY5A+d~P4Y<5G!>FiALU}4LJa1E;vztOn`{wUFNUbJUarX;GVlI3Jx-?<|8
zd!_8*Ox3-2^^hy9R<goD{d(he`?)izK<5hVx{fJj)P3{N-}q>__CUJG-hA_3xFeC{
zW_K7}D~#`^CB>spTkg6{y6N!i1*VIQB~$HS=*t$9;mC+%R^+b!VSJ@XvW=c@LJCfL
z;lf??i^H|{ktUX6GLoV0&Q9n3eoYnUaO;@tMq%4kQ}5G)i)=>2LSjODq%lA4727Z5
z5mMog%PrT}xTm!Y8PG59t^O+IbChuMb+@#!#mv(Z_;y%SKUTZoi$BM<vn56neYi?C
zC@XqYo)8cqV*2b?e)Q7%ih$f<ZVVqB{5`!ywYCKHZ|aOP)ZzW;*fF7Jok1&AX9{fQ
zIKg=lhFcWRofS*ik?MXKBLL^ehVv`f?5xb8eT{oZ_=eYKwJg4B*D&4ANZ$n}40f_r
zTkUMKz!oxZiRQp37}%KYG+OvsN4&F4-o#FF(XP~XhR<z}JV!_SXI#3)?{)7=cU$fP
zi^9TyNs>X?V9H;QA14n~Rh@Mtzu;tIVZ_@rbWp`F&*tI|3^;wrms$WSEiutIS~~Jb
zUNuI!Ft=6vSR~h|(Iq7>CZEp1q#u7-hE+07_x;e>CyvHXHWyc@gbMXXcp^n`&@?G_
z)d$n9;fB1cWM5o&_!rF$3!iD0TTfujcL3YU^ny;pzT)x0j!Zl&@Q=)v!v*SRH?N)#
zK&X*<k+B$4TodcABTk?u`}r{wUM0VLJhWf-0!<6aEDc%Ak!&(`V=I9nd6~ljkNf_)
z^r7r1y?ZSKf};OW8u%$jXBFdl>9lq5@H!|#wW~nlWLDy^evkF84w6kE@g4E%ibcOV
zF9~mFQIED6!bk=)EvuO|qRrXPw7XG->FGZdlS*%hKn2cto8&nxi4S~?#VluV(X^`0
z4dH=St{$gQYMij@sL0F9zg%xGL>sWLqrNfRu11uvM32zPU&FWM@DK%D6`%P$G4amp
zDo<+EHV<Pl9nitg83*V9G66DRib(F%n?;J6?t%t?Cs`ttE5;N@@!cxrnIH-V9Q;`e
z!=87KiWDYOylWNE`%U<^MVCd7M)!BZOHyE|Gw<;c7DEIHrSuS?pwpeBxfcG|>n$zs
za8RP^*rbC20k?}2XvpT$`n_EA#<aU&!Ut=2QkXRzb5qb>zg)ojUe@N~&Q5^|^`HQ<
zBqFYVajp28<YGnW9_tG<Hp=tED=#6GE2_F{=oBdn{Z&p8)F0(0_Tr>-`#U?8mUe}~
z3r^cYA%1IvXItXDAh6Zk)3g0&Y=eoZvO6Qrae4SxL#B7yRPy$AcFUKU_8n4E%rXaa
z#aDcmhhghyux4B~xOn)`H(iV8vNd!D)6jzgLuq#hMBPfE(I<|nI3sPR@1v%-cDNu;
zVXF>dy9i^E^zhmL*j4E&u&Xg57Z}{<rVB%26x9npYcjg29}@}WkV^c#<c^O7H=oY3
zkPwGx3^nFIC-RqB6mvG6#dUE;jiy8>TZy@DJ?<W1XtUS(+WGXtPQTff#$c?=|4%Ea
z@RyZ*k@GH3b4?o*>m(zfhRqF;A9kRZY>Aqd!klX6=1%cG{rUL%4ek;V{m;qDDZ5!&
z?)O4Yj2ovp7Vwtx2QY3*W2@ugd0PooJO(L@RiSVQ)HP4!S}y5H@r`r{PTvdxKC=Qt
zKd_vz`M06Bp3*2VSj!Z!wod$N)_c)k4vh+raVn4snip}l)6>`Q@|RS3Se2_?_Ezaq
zi|G8u)2dkBr#C{Jw>z@rDMZYe%rG9^W{{OBMvs27UHUDsyW1KQ&}2k9Sb{UP*&w9%
z`N56nR(YK%IQ_qJ0HH**P}{tMMoZ%;=iQ#VZ{kr0h;5dLU;y@1``GhnEcdiQQhx%l
zC$K+auxVHsm=iNh!p1q0fn}90V>>Rf8F;My{!Thrv}11h#SMd3y0kwbky;4|=jA2T
zLurxrNT)hM`*n#+V2hVfT$yA07mFb;9-Yc^b$|`smoLvfJoG9nzwkCfz5n*DHX6}#
z_id|gcmt_eM6Funs#iwdNPHO~@Vb|p6Ua`cxW9%sXpKoa5fI!aED+r7OR}QX!Xg3j
z(NQ4YzKmc^jYj&qG>QkdpM^X52tB&Sa9N=1*~AZQ{m<emyVMzadX`aCH$O3Kz2%DH
zSiVBQmE^RbY{o>FLfC>u5$AJ{K!l(FPg5l3v$}l{ircT&uLr$<?;<GpFoZ_vuH153
zoBGT#Ifcg-7avU;Mw=E{9Q3~PK2_u^oGO7ywfUAyR8+cg{2s+IEtwHo((0*ODA)-P
z;eoP2(B8I8r!@OoP<mL>4nQ6o7O<srV<V+P44hk5x^DKWkM>NtmdDt&uPMrJ#PL3*
zT+2<JOi38Rb@(04se6gMaG^7$`DaeRwN=pO+RTizb~A0}yPLcZD|VOS(x<0SKhz{x
zIxztGJ=-g{-=_@4G)f0QyK$pqX=LR4Plxl5tY)Yq2I$saULekmi?OGhkrLcnpPQd^
z@*B9F9u{ux=&_fc^{9|_xY+uX%j&UY3LmRM6b}I|8ue!d>#hU#gO8zp-$7CDfFv@k
z_}v`YYZo9W)Qq8utIsKX`dmx<=y7f<!(4CkjqB6q8#I5DgQem2z=Rzc+#e$jqMj#Y
zCH0S#@4}nB-I%B;RflRSCOZAkk2{hR+mqII_Pr4WuOJS5dCmy5JMOJRwK;b9u@WIr
z_8Y@_W5YFq9E0FBgplI@tJ}>Kuab)OTTP|~h#~AEM}&}GO+b02oYX*N9~;<ZFL^W=
zc#C$P>f#^?aMQ;1mZl2ML$VRQ09;k>S;Y1`Bf1(}X7%j!oaW^B@>CpD(@QTQgd;N@
zm8>+*T^#Iv;9y8umHqYc=Y-S;k|8kQff+V}VwPG@YI997t!bfjMu}I-u@sva4-Zzl
zG40L$KMV$?#jwx|0$WFWiz63}=gTi`q^xymlRT^r_ZtV@5v>w-`DBask<WSkGM)wt
zIbfhNc@V2vbLK6Y@KS-+Rbn8ZjoQO%5%#tMy;|pcWuN|7bf*(64+%B9#-5mwSUT?I
zgm2$_H$p6{zD{o5ZTei}!Vtmm`VhlqbASIAH<5)Hax^P%uQIRX(cHIP*oxW&KhlSB
zGY}<^hA06NsjI|$Av)xxHHp-y(3C*0vImr<dvD!*E4sfF1#*kt?4}zRb|h?EuHsl2
zED7?LZL}X0a%5)^`NzJ*tUq{2_&TIYPB7==D|HBt18_drwZD6JEl;!HbT<dpoWNxF
zP?-lGFQmHA{Y815Vn<rz3ZYK4Z~QM*+1U;-tgSQ8pEHu~)E%8}6+8B*$Po4_{?{I|
zU94zJErUJx9`9K;I;@rdOR&K7Eh1Edid6LwdO9(^N-=(++$^Q<`l_-=pPEIhh=@os
zcygwuhb<ZR40<vTsj2s35>Gs=H&(erIt9~ZyBqcmEifl=Z<pFYFiT)DUqJyL(wMDJ
zpj{LH#~u)CW@udT4OLKivz06%lBM8(wMv}WaybQ@4E>BNz;7~_|07LG)i&?Pot#M<
z-7%a|o<L9+A(w?^j=aJ7vdBi_tqtS)X=U5*`qiV=6;dJ8k4=ikH<wi3bd`nnWh&bQ
z@m;tOu0T($z!XD&WvtY@w(aZFnb`$?lia@a>EhykkZx{1^b^1)cLLITu$*w54}Rw<
zB>Y}g$h$?T+{QSINAGl^{9PmwHXB3q6AIM<2nbWW?(QbR7_hx$J#f}CI4ZdnMvIm@
zas6I<!Jbq>g^HsJ7Xq-aT$v%F(GdeY5HFw(_7N->D`W9(`3cg&Uogx#-F|_zC%(L#
z)_kcHL!yy)BZOMp;`f&;yb{ANQt{BlZFBb<u88uG>|wu=l>D>45of!19(M8)ah;m3
zhIN4GChsD+$;a=oJ7%Q!VRX!GB9sgOaEoG(SL-BbA<M;aow39OHx~A`aMO{}4Gmwy
z)2W;`slR>%;eFSCk-ENgyS7G-)MS42mfj81nd#FyB{rU>;gn!(8bXJA;sXOIV9)pN
ztzTVA@;H2(C4E;h)RFes>u6y!Dn{<|x#h)O>^IxnlvFpBez-kDw9)Yf4c}Z0zzSG8
z{PjEno~uFi`htmPl$*^LIc4znuB1NT6kRa!+DY-f1#$VIMaBWkKbH<2mNpe;hHFKx
zj0xJRMxcj;w&uEfyVuUm-8)wIT79`ovJ5*<Op3f>gk3hbgQ*^EEcCJQ^LI3vJ;_kW
zk-sN+nY@rf%w5Lrix98x7k=|y3Ee6I%@I)Ssv+su8-&hj4h~gJ%BvbB>iAH41+};o
zv+Uvx<{Pa5K{AgWQ@<7vi*Nt8r{f0K?)hFuQXc{|@0zzdFi}Tv?F!@Pt%n!;%U=yJ
zgoX^7m3962TY+TDJ8y6W`a3<UmIj)H=6l2Wuh9v2RSdnvp$L}wUd(kCB`$(MXI%Q0
zmNCb#!J_jZf)UJRqq*<TgWG+2!}Tz}ol3>~&koK^YuxuGWSw&{{|Yk6cLC=$yVgc&
zXP|EnSO8S=15n{$@eRdJL98Sl+Y#YgiGEO5w3CXFXpA(C(CyffUO_s_qr+3E9!lgV
zR*jWc5RfqY+!@6~jf*}uX~QRoTtm4y2p{En{a9(=URNe_*LbRDOelhiB{*4Ic^O$7
zC<7*o4bix7Ua}8NSXSP<TEk2AhbDdWu*aR>iTBu&`0e@#H-n&@`R||qP0!5^%;f6m
z6YFtob65uNTpYYFq5P0^2pfeWM}h2R3WLFL*I1ZM0e9sI^Qz+2I^A!R9}cXg2SiMM
znu}F9P&jD@tKIv#Tz=CoxVFK`PRvV9JGzU)E7Oo~(eBBO9=%akU*4+j+cLj)7I<*c
zB;ej$V`$>Q-~IXOCBmcx2o6>I0JH#qC*Sgn2#P$UeE&K}P2*kbRj<KQ%->Z80_3G{
z;>RvoZF{Vr6YphWD#pyr6;srq6j;{x)+5U}TD00_6~SG7H>&gb*lQLyovdTf1;GB~
zhm^AW6%i=1JUPuX&}#4*1vO!yCmSG;*4Cx{owbb7@Py&wHCKl0HL4#;hxRxkr<Hoy
z-G7FlF_d^cmIobkj{*aNDuub9PGwzSn9~dO7H$roab69ip`f^XM2SjfSF!XdBM)@b
zcYKAMDd+`qrWfGjx!yjxJaSf6)|UGE`no!wa`Gbz(drUTJa(SL)kUujk0_nHXOf@&
z^*MQy!bJf~t_?4AW<dbo<7PLG)qRD;sYY87ryq(kGRYo<C?!13dM9D+weQ&yh_m{H
z7-0glm+T`GV$NBT^yxU_s&}NMhRYm7%Hcs&Tich4qks0?>$zuUbx>*6D+TU$WS(*Z
zhRc6;=zR+fsD7f8eZ_H|+!@+eCrc8ACo<C0yTou%nWD-PojHw9^XVpLA)ncC15v@f
zfU!WA;Jrm7U%5t4AF45`r>FPg#S2kXa^+t~a7%ndB>1(+W`48xs~f`{C*z&Ok;VdH
zr(A~iZB0$h^>!pZikinj*ozC;tFrS81T*GNb;wM9bu=?$b~;Z@K|ygAHNP-!axlw|
z`g(3<-86Jac1GP`=l0BqBZm`Yt)%{4)5qsIgDkA5^a$DF{U-n5nK@1Ry;q<v{)q16
zsVut}39L!*fOHQ2wL`k`t9p~Cq*o{8I|73yXDFR7Av@}!0@+lmgFx8i9aDviI$;<Q
zQN^ETJAa0^$xDko@F>116heJk$%3)i`#NJ=tH+nAmv;*~uZS(O%DBoCVY=q~7S_+P
zXKE3DzB%E35rNkTYcqQP#RgJ*U^^(S33bp**9Q;Hw9y4v&iLXap!s4`7};1{d);TQ
z(=F!-y-c!A*4N|6d06+$iT}qD@#D{42u~sUAVLzn&7;n{*AOonbwoTxvW>4}m9y0n
z;i&{`*(b|j#a=%$YO2^7a4MY+aolHXs;_8%r~jBE=hm+<Yk+?cNt1njXB{~&qKN3}
zuUdQ7;eu}toFpS#?jU{j$I;yvX1Bx6@TfX`4;c8lpuNGCa%4w}7ci&iN%XSf%LjTL
zg7LZ7dditj&_Jl8TgbkAZgBfr^04hT7@g?F*OJMN0M-tqIW}f_cItMXTGA6cUrHYQ
z6s7LZP}WvT9w=WyqJUHx$RN-oLPnwGF39B@#Ty7Tp2xUz)zeVyg~rixp2N}g>IqVi
zN74Sf+21FYGQg3Y(*e>tB5J(p8mJ>A0`eLVA&)GCT42Z4*}6)18HrEb&?z1Mv$*+n
z>)XzA6T<B?{m>bQiXcVKZKof+20`AMz-Iu4F(<3!D)xqq``*57S12BHSW14YM33<}
z%<XXJa;0>ABQSi1uV|X@sY#b7F7arjOm6D<W>X+EbeIw)Cz;9Tb^1IRsmO2Vu9CUT
zy#+!NlbO!i6Bd8{-~pw5f8+g;)xwS4#f<hjJ@`FJi3xbslk3gD;)Lo^bNG%2u`LTl
z?KlXXP-7}_z~3~`H*vU@Pgo}A?o^aKS{r{etB1<edZXXDW~*^b2b*KYi1_OQ6iwhj
zRQ^77Sw+j;6{z_$*p8lDXSnlep4}WDv{UO>bio5p0+zTqS=R2@|DIyPos{e>5=ish
zI=%@F@C+5(um0jcR?d+=UP9koNa!;_;vFmm=aYh@eKbqfZ=e`eq@Jg`l$|BwqpU8Q
zgF=J)<6l3_Px1th`~rz0+^we>@J4dHO%lWKfdzM7T{PVMYuwlHbtTW6(r_Yy9T|iL
zA}Ek6S=0|M`9qN7bNSag{L<NaY&S<XdqjpF{?8bWIO=UE5?sM+6qH^4VD&;6xHd$9
z2%U;|JV2ZbUrKi&%t(Xi6s1!D6}Cfkn9q+z2}*oT8*-Txu{!)JTA%_WA`DREm_U+{
zP}2Q=kDfOy2^r-#JqV7B@V+0rfv)-Vd1XFKb9NkXBpigb)jTEX!JQGd`$Y|uy)(&>
zIviuP@WFCtk;Cz#oOms8;h#>3MVIe-czmr7)X=c#Hb~a{1a+q;)>)kQ4CE7}y5Aq!
zrQ@I?h8Mo!AljtgD)lBq5;bOrFfgj?`>0%g;WD=+ktgnQ;*27v$uV7+fPP)a8<6_X
zjVM`w=0dMYmXe99zLUZFGe@t#vc~NiLKu$mgH@4CIL%iA^Dze)@8h7JC$sG4g+J@8
z0O;p{^_9-Ux703v{&W-MRKu-#KsTq^nfNY|_rqG9U4KdJJ6nBJ%x!Hc;9H?YFC%xN
zkK9SwLp*L<FacAv=O>2TPBnR5JuhBIJVhq@%PBVFsk>vF@&2vI>2Er_O#j4~=yo=d
zNc~@{INyp|Ug6ihe*WFZvrTs*H2!pKZrgV+!;+z}mgiL<5Fpl`k~v1uL)eXT>o+o~
z7Sm|hHa6Wfygw^0wt*r?p%8}{r6d9|*%4RG*;Ns6^?RM%UoHQ1cJ1J=nyUEL>w_|q
z2s<NgjjP&K>;8LT&~Vb5KpLX0uwK})YG(9}o)AvVbsF!bMbuRCIO2>k%SOl4E}K!=
zw)jw^GVSs(X`aWlUb#ZxjE}krIA7^Yd2y=CT44zfzeo8&1Y@2j_2~{ZP_6Ph5{A-0
zj&&djF0!@z|G|Mu{wkIuj!${fJC_eB{9i)6O%sV1QGybF(aj%9^Y$vy&DQ}h*Kc@E
zH@bu|wlt-=zy&drBSfzOZfa<5I0lEw#A8c^C{YAwMlwyf_XK?wD=CWm1H4y$gp~1#
zUqhr{?a_aHdypq$<j*;Pd=NMQEr$fPj}4p}BOnFwsk7jqe|qpDpfH*E;>={XHtNp{
zWOK~^eajH!+<UkjlP8Rcs04_vBRJEuDctY-VanT=2VbIqL^n&?FJM+3_F8U-fYETJ
zg*88@?;Gh>cJd@$!Be$-)op;9e}7YG8T4I?FDC*~JjW4bJue;|<~FsKr++vj2l49s
z@xgtZs>8WKyPjJ4quQn4r$iA0d|%-zY5k#FUB$t7Q~=4`JH<IYC2S(|kZ$cid5aA<
z0W5^lEYa6ph5JE?uOOZnuY~)j>93c<iO(U+^7zwlM)+n|_X}~Guj;0Eq(HbCxkqAs
zJ?kDl22k=vIejJ~{vawPdK{4qD`w{u`-G1Jpm1Jr6)`<`WmYTe!K%2u6^8{cuBx=|
z1vr^H(twWna~4d467&208U`Una0Hgye#P$zhf$w4@~Kcu|J$_r3|vF{I6-{H-LP<Q
z!k0V7$Mu~@bz5F~d0{vwdzEiti7G#Nk{KMVpr@y~weBbUys==Q4-7sMG_1|Lg2{;S
zS`sBE6CJbG{v!nx#@V-v%rbH*z7ji+Ii{Q)YL*@*X*#VmBE%J+I{r?1(Xe(5_SUy=
z-#99_Z{59{E#Z9{GSrR^4(TQ=_Zo<VECcs6uabi64ENo%^If^k6#t?>Dneb)Osbz_
zFFr1?yb7(P?93;E--PAD6jdzaS2O@jX#}Rub5|+R%f-UNB1J05VX<HN!2?Fp09g-l
zag@lTV5q4qUBCoX;Z8^DoA(<ue*?q$0L0Abpn{-`C)h^80DwvIB-{oTM?bo2a33I5
zoxsle4Mv>BG&sR=%A@yfXy^@_Nf~qVC5xfbrID&6wqg?#llB<y4B7DO1QdMnQ2L>x
z)5xZtig#5yn39u+=Ofe-#N06LO8x%*%_9eDQP*OZE%f4eXJ;p`S<mys{gQI*sf2F_
zdt0(}Z1O*r>6*2C1wMCYC_17CAp`!~Fo9ac`4f@T=A!1te6N9lL0Y>Q1A|HD`#Ytj
zrGkQjQc_ZYZI@Z$2}-}y<}@^AE$kRduOcY)`gU7zwe{ejPcFH*xL{&pvazwbxg7wt
zO^l7-@cnvjFGnS4HyiXZgD9rk5WR`eS?!jBnk%49aQpnk*k9v`Z8)FFwE7p4d@zTk
zNBDL5rq)(@IXS2^Fv3Htrr(3tPxaN+)g2r*{m#?9W!K)F9`b@ma9r%{cueUT7{bp^
z)Q2#bbLmP;&kR?%w2UwO%;DzeH~Gy)=1Mn%wYs_*%Wo-aF?f?Y1Rk(vF*d%uaD#!*
z{5MZm68x8#sFR^UmHtWrs<gu>eG-1eiwVq*R(nrOOvnl`Gc&WZ2S0Rua`eLB>p=Q&
zWji&wCky{(uld3T+B`=`t5_lA)RXA`{s;N>Fi*aU$xX1>qss7TQm2%CZO&Ure%hj4
z9MrLo;o${0+Zwr|pA!%l{qys>+|;`z>(aZmGLpqF=)p=dfdWx`0OheeZ(aAdIoGmM
zQs`8d73Ae})N>w6N@8`l&#Xb%c~eSV;^o-FLUvkO-ItlRgfgqKTV3b;C3kms6%-Uw
z*(@cT7{q@Ya%q0hE^|oD(5-S0p%!5_pql;;Er-$WHNStun?6RVSHfhVYYa+cG#$tV
zjv^v1cAX(2GMT9g`}#cmbdc5t+nP><RymP4Q(L3Qr^8RS-O3?_@#jcJYeYQxAvX9y
zIps&SHx4&9_b&w}MN0h5Iq%pXL!mK4iQw{iHaWS?yc_YW(<r^?W_?J$GZsjFI@8W4
z>vCl+X`RsCv9XXt+-j2A{Tfk;-@smzkGS~xqb}p(;_A;2jg5_^cK*>NAm_<^RK#w}
zVP8mVv$JZ%&0PTPz~P<F8}niAVVRR3(tyvy63fel`T6;^wYA?V$p}udF)m|8E5gH&
zmGL*N-~0Q^US6=m6HH7@gak01^w#F)b?&vbyJ(sw1%sb@A<dyB+u;>txtr0-@c{!N
z7;LUnl|lvlQw*t~<YFav1*YWZRBJ!!)i#9Jc%H(HPTDHoD`?3eGK*~?h*{ihVFXRh
z%-qP(pMA8YQRWdo>K;ywnJIaBEDYe7aKDx0>M}Rt0I2{h6!&Q?`zFl9<j+G)Ogx-$
zs5|tsBygq12hYdHCv~L0Ub<9iI9mhWpiqD}R`fs=?}Z!-Zdt+bV6k-yoZ50Sua<4r
zPx2}zrgw7`hsWMhQ47gdS9dhaV9Ws3r%5(<%i+RD;p!7+tSC>LtBM4Ce0=h8eAkvj
zL(k0}XbyMd@X8OrY5`j*o_4Kx=nv1%@2B4e4M)y_)3h>9Spm+{Ne(BO2Qd}qwXX=`
zxQyg<baZTN@?&ByKUyx#&)=Pnvy3iclZVLM>Z&u{{ZGOE{#OVT6&1U7#_Iy!-S(9u
zYYL$h(AU>j$yU#4Xpq?yKas*jF%PKpv6w!+5EB!_4KJ|uEt@;tnHC)M+KcNFY6!p3
z{qraM0ed%{h&eQxOm^Jk^{wzNYpJWN(NB68K>bmyCAWpxxWYC_7~(>}x|e_PA=6m&
zS0MFfXKz2U?_%IMUHJHAIo!{03IPf(fVikghA@D(OL8+z?sQS9LvAu57>utZS>69E
zBpoB>qphoe6UEPhWlsJ*J~81-M3bA7GnDhF2oz?4{o2QmA9vPf_@Dm#s8it#?J1v&
ziagdVs-5eDso*JDhLrU5bkM?K?1+*MKh&#zB}*l}>18<?FD@t7)RUzOGrwhbDflgf
z^=e+4v?oS>4sP*sF*Kx~<Kg2oc1g_$3pecJ<l@pt&#>FB@Tc)Rt<T<=+bPLjR0*6h
z*;XUUOdF5ifB%KGlngaYa{j!Yv9WrUyBix@4s7SM*z&>lL`X}59w80;PSRZ`MVcO-
zIf4?^vdzU;`>#~3+MS764wz7xxU!!ar*F3BY;4C}&@ehwUDatq;YN;g{Glq$ym2i7
z@vD`%z~rOkuZDfG961~;v0e9MZg#y?+s&K7UQ=qi5wM<-%#8a+E;oja%zyHiE;@Jj
zE$5MKnlCCjUwFut9sEysW^F5m1H*`eizv0=;!lkF%h);roX|`<DH*lzK!@O;SCHpN
zJ%KVPXJ_Y@1E*eDuRZx9^$D<upG2bO@xN;usVO}CV-Phx?ZiPmcPh9iZVZgfD)mjV
zrD2bv5}1gi5&Z_;^^6A!(eTizzUvbY@1S^<;=_-gG@o6?qAGt}w%-0Q`Q|ZBf)6HB
z0v~%i&d$%z&&`#TlyqX6jWxD)!<xiXRR>is1CllZ4)&VLRK>HVMDJSl7L{{uW`OHF
z$H|1Cy9{$H%cmRT`@8_MK6q8t;W8w=yVsh)R2;sUR_eXnI-;P6jf%V<k?7{JbOoXo
zweG((qGKh9Zu`{i>A~lZ<C5Y9gE6KTZkpFp_)p5u;gKX&ugzUf{`k5pA26x1Zvv#%
zfe~d!-gyykZ{!j2A1SISNfM#NN&Nd=#`Jj$nhAWvm$mY@-h>3(<Af!CtpB{OhElS|
zmNoUdRu&%@ylXO{j08sUNhFu>(33M2<BP(;EU*9q>tpX|J(%QujIM1xa#7vARrk4#
zcJRK`wa}`Y08(o;Xda6Ol}*}yt;hG5*+;XYlvF0mHs1UU%@(Penu`su=#w?^Q>}Oh
zu7CF$N?dzVRIyyhgnQ?$NB$bmUbBzVi=ML4M6x8;isePW3NmnIP^kMzOyEhpS1Qj|
zq56tK<)qJR+llk-?SJ6Z&*<NLGo|R)m4CeLzH=L3XqGH0xyOraiM9+qw9FSCLSO!t
zR944v4*ppuKk@r;q0aILOWDMHPyx=DL|>4T4XXZ6gb{o>1gJJUQ&N;a-h)etW)88V
z{1As7s3|3einzBuk12Ya^flf{$(?)C-cNuZCsP>n#7k*V5#cvjqMnts3@@aLytEV!
zN<4)!V-{IAg)q?8<^_YJO0N-xY{vPARv`jy6LYZ)It1?#hfoa%G=4G@<RK4#+3nk;
zoLAU*CD%8|VM<i3Z4{viN2+{h50PV$Khr^wdff6XX>_--oF+uc)s47bE?6loO4?pb
z6%xTmnXzpc7q^G{Kr{-dw0_C;<_1gg-Pd;}rG+5S3=sbq*&iqOkW0L1Thp4;y8UKr
zfhA|J_$zftSrcOp)>a(IVM#mj><g7UrkX8x(13&)(-!^62$Nz2dS=_Zscs*%;i8`S
zL68)<{wjpFe5t*ORysCs4yBE+>d+6zn0hZf25uohxP|<6c}v;Pr|Gv_PX&LiDmLA~
z6Tz3GW!wII*VcA5j5?GUA~;*kG=ON8)Lkd$2zht8m$e8`<SghnM38H3@3@myRCD4o
zksK#o&g)4z<R>L_UD%7NhtLE29KL+9O`OncH5;hdS`>RVXmS<~a2Cy<cKD)!_Pl@I
zX0(J(5rFf^?A0O;lGgBq430T`r@8TVs$0cj!z8DA@SRSFh)j(QyX$*Sy$<|z<~U|4
zZiF~ia`e9xY26&{CA;5@A8lGJ0!5(0D6>{!`4BTKNVutD2n&gVqm=wVxm|gEri=w6
zlf^ph#_H%b@P=M=^BIb{DG(t(b|&J?iTmFm$<A<bWZ2V|<Y87^ax6%@W~~<nH#U|{
z)Nv#_S!P~wICg#T9mWUZLXK2@x(ZlNL|LbLg31H&h}^5LE#J8+f<K>mQ;1`sllxdE
z*$^trz07)WZBIKw=GOTjxi`yoMQPXk>8*aBChkf;ax1?JnY3x?ee0FBMS1Fk>$(<y
zj5-(YITMQ;Rd4#JJv$sAImL6@$=Cx77&t^e>?5k7@d`xV<c-0B6OLaGK^q`Wz4*zO
zut->f2vi@Int8+@EeZAwb6=$vm6MTaXli<MI1_fn%nJo)DdrwSvE@HfCJZy2Z&#dd
zAz>Y&vW<^of6mO#`X&)ysS&6}LgAo+5C7re1q238qF<xTvTj@xvGb__U<k1<$oF^G
zChrpGonC>YP`l-^vs-!`kvqezPEL{jW%9-*PQCiuVc`(KY!H?gt)e1#Y-DilJp}KT
zy;Uka^z=@Iov}!8+R+9|jp>=LOx>$rBvj^G#U&;1^2?1feTax3a1e>hPt{!;iYtrE
zczU?KrTV@c!}-#1xf2qQRKZqsNU-O<6z9wme{9j{5ZyqWmHImJ!JpMqgKzOc?5}in
z&5V^*I-i(Xmo)SDRSvKBSEoH_hzVg7y=OY7-+D-Powbr@Q<@<qEBLp!lX;GXyw2K_
z0bStGHQjeDSaLaU3iFunSzFcAi7m?~EdR2`&s$Mity_)7-&lNhS$Lve@^HjZH*JP4
ziPTs_xWHl$z=O7ymaD64O-&8pzF7|^kbI%>JEQ9axom87L^{L}chqa8ZD}b{b5v>!
zk)1jdBRk!Fmk~$VU9Y2vuWzrdEkH3H2_yAD?I|i*lKGwfM%S8G+`F#^Wu|SqOZEfv
z%MP<I>V2?Q!@kId7z~(#Gc$73EXztbAxf&O^*(r!&SQhjPC9{tXQAd}Z}}3Ah4z+z
zP*B>DKZ-G1uD|lb4eN}}wSicdFXT>^i-FOR%@ai*Wknv}7Jb7vcjX{4fmOHUpw5kU
zwNnolozZ6@1m#I^uA#v}3{1?=EMCS<XF~8lX(2+n$VB8XbI<wK?c4TtcJLU`T$b7V
z&q?0)Lz@g2fd)#haCFW^Z2!DDcEZn}w!!~>?<&9Z2xLwksg7ej@1y?ld!1LA*vGP-
zuGd@P;czIYD=CD|>ibN5K2Gbne&ehAHP)*d%a05809--mY*9)IjKNU^M0KEuC9cV2
zxA&pO4|jPeVZY+(nqJ5>+dYxTbR32~_qUoyomd(anzgZZ{K_jjNgeKZdZZ2GZe7j~
zg^>MWK8Hv;dYpY{JLKW5Et^mQ!|OxY&r3e%X~o8wyfpBJIOcPtB2nq;>+A>q0oauW
z)4J%2h6BTkMGXo*E!Oip-gm2Llx*|9B!9vBpkO_qK_aDfaeTlrKdQ6;yEaAf9S3H^
z;HZ_GN9VbfZSz7OYhW=lzgcmZh0>|qjYOxR^|J2^j&qzF*O(b?EQH_FG6hkG-jZqr
zicu?-Q%rcA{q$gL*y5I+oFJ0MOAbRKKG)tCzrO$H%~y6eQm6QUnYVpLGg{@U?KIn}
z=HK<5nIz9kn4VQj7zd7R8T$Vi`|7AF*XC^-6#-EJ1px&CC6#VaK$Pwf0qJh(vQdyO
zi490?x;qu5yBnl)Z=@T(*?7)*J@0ydYkmC1TCnzhp8KAA=9+7+nLBx{>~n46Qk==+
z>LYz8dlK@TIRms@y~nvyilnRmmA<nepjFpqrWq)Or;q~xY(<2IigH6scEe)Je~5#<
zt>tBqt(CUs8nmSV2SGxzxU#3kj9O?voB8$-x|UV*4E-}QG63)S`vY0>rL0DA5HS!z
zvBlF~E?0jyOlXUCRJ@O5KcjboVqBn-bmK;uAU%De0ob}B*|7`0o1`7=a1d#;xPqn`
zbvG-0S?_|ym+CI1Il-tB1u|52vvrKjT4-AOJ-u8j%prbsi?a=t8F{=34`CB#5~`y!
zT0E!*%Z~=_=KXfe8AScmLrZV1KK!0>-k6e|J*4a%+=)kx0-O);!*cMOY@nEj`Hy4|
zw10Fah>z{7Sw^#)5zn`^wLzK#2^y}v5Dnb)!|AeZX*U=sfEXTnhGR6~C}`2Oz3tFR
zPC!6FL_}j@6&&KgRu75c%gk%cVl(aK7pWWREG;;04{*d!UHvrG8{hLCyMRRq@?u46
zcNiLQ%rRjOfkN7kQ*Z^by8GAVA^t9>7K5AB9umP()q4#M$&;)dd*;4=!L~LdCCfZ^
zrU`LzJ+UHP%azf7U*>8Mo1Y%sZ`Z?~0J+SRX~X!Fyu1Y!Rh*XQvIf^DJ3@qMvT;ss
zhooqk=`#sbGPV~7;OuLktgOC1zgHkIyeUqJDp^n5VVV!;aqR9fzgmBBJ$!j)v^*CS
z0o}bBYLyjITWEx1S$X{0ijF}Jkrhp@<MNsO3w9zhB>!dwTD!ZujeAl=goW=%ukP&Y
zw}hAP6b6tH5Y)8h6%=R`m<~h)SZBmTUlUlD9+KeNwL9e!x4Z?yaW3xmQq#;(tzCBX
zN@abT{jpD50#hQ4xi(J|r;E!M^J1%yjKY0&2?^9$6t$)(Sy>Q1+5D(^l>mwFAqN43
zzQE%kD~wN&s_Tx`*EV)9jwM^wbuh2*d;qs?UVUqAUTE{sQ%M_B6Vh>)uu}Sn_4QX|
zd?hX$JxL$WlkKoFw%UAu(*Q3z-3pT(aL4UJXh0<e0@J&99n>ywt#A$I83`pK{4CX_
zGv^NvOp-iY+Ozi$j<$AYQAG!Ovu|-_?PQ*vQbc}4rCtoIKN_lj@$Th~gPN!f`Q32C
zo(#B?UA7i6aG$T+7QK&4sJlGP*p!&{D+6Y_=2#IBj8O74Ab60cPf0y#l$Cb>YkiHl
zkF@#AU3ON1j9BPN<#_S!#7w@fg9GOPH}N5c<g{JvCGe^-r9!ATc6H^d=ITHC+CDTC
z(cIkD=1!?-Y0%psA?5l{t+v@cnAXC|PLhC1#dHe-+)ImlozjozHO>N*Zi1u_O|L1p
z+n0M@W7|1Wr(u~Db0n#MAIVs4g3UFjw&hJrY_#dKdHXv&B!$tRayQ5|SWJtXa(2)>
zsUX1h;_9;|6R5DNdZ#6!Gxa1F4744*3EbQp7!@b#jvCA__wiARV0Qvt=F_$hI5we7
zM;{ztJdZ>|H-&#vd`JuZ70{s;nxo)t13mmi-c|kNb9TGI9M9pLc6cDUgi>zgC7iby
z8x<5!ZOzhh)hwqiM)Tim7^>2Kk*n`rA3ig4TBCB460x_H8OE%4#%OBhoZG?1m#2Xh
z&8-zwYvaR03QzvormMU*R=<jFDBM8A2b#+#mPHjU7xGjx_@n)$>VK$e38c?5Hc@jA
zmglKFK2m}<%@+Q>tv>rRZ`M3;(<%4v3|xVBmIoYtvD8yj!$5RcgTjx5Ek$}Wfp(t_
zaS;y=hyc($fAcZ%@po3sBmD$5Gg}yny#C~Ku!$Js6BFX&{m$7$gvaKk{p!I2N_t&=
z6?hOu^##;k)JR35v$($-v)C5xm*p%Ge=Mes@~I0Q9Pf|@x0khDV520DtFrha3TYWz
zaJOJ7d0{|n;?kSaMMC$`w#pgCrl}h2He$Avrm~Hl&V()w^XK1K7kauj*Lm;UD^IfN
z%ZP@nmsfv%4UAuxYw7Q&i`O#Zn)~soP|wwV%M}#<-4s~3Y54_YHH`c=GyUXl+n%iN
zs$PhS@~DqcGiho}l9@nLh3oE1Dvw*JVjG&)D88t5QIX=ET{1dGTt`s4xw{84s1XLX
zp2emf>Zkww$!d9E&8G9k;gR4>b+S+va{beB;G)0;uAa8K$45D_pWp0lChI(@HrRNh
z-c=hQ(^apNxe-;R9wI5*Q4R#DL=^8Z$e-fxSQJE;yn-oal%N3DWgb|s=Wjp=?lz2m
z3ASb7+3PK`daIln)xsCzi3xn(;Cx`P960PxH50&>&Mz!59{|rh=CUUF>{-J`2j(v7
zRua{-_Sz#Qwn84bJ^!MpAU5hWF3QTv`hOq)j_tmztY&ZOd)Tl-g;<(+e#Ku*eUs6@
zs4&9M>Zo!Lb^i$-crb;^M>SD1pvh6AnB6)@fv2&`x>Lf5oa)1ejbpuh4DhbWW>4hb
zoOav3{d?nh9Mg2J+MshJq$0D-MoP{WM(ct?4kV6YAG}*0C9-f0Al+O^XJ%MBq5p~O
z=Kdz%xk7VwUVF5#vH#8*4crL$4q>6)`BXers`|qQcx9lLZBc_-cKpt1uwbA7#Pn=L
zk5;&*K&!;kMG3b(vqR{z5*N$#*DSIW8!BLceyt|AqV?Of_wO>iPLcnysrY`J?Z&S4
z;xosy_90yXVZ&T^rm}g<12n_$Q9gKp#wL_N_h&1DfbSg6Lc{ZKjLSX`?9q|>=r}6A
z+cdLwK*ml?W-><yn5C%mxT19wS^Ehdnh6UFe+dig$<)+@x{Y$C#*#_H|DxY0kw2vl
zrvs&+R8b)6^vuqVy%Ym5z!%QD5Nzr`LXP63^z~-Q7mCleHcvcXX?1%UYF%2ndHJa$
zH-Xp}f7D<nGsE@+zFSld-#39SRbF++WPNup{O#YSRSaV4!ia{&xFev4W-6P=1ZRq|
zNf)g8G}h+SW+0|754t~$?)T*eM)DLMcriK2umlE_C5&Zt4?1<jbpy#F5|ZASRzSqr
zv-X(Qy<zH#BF=Y_La9m?UWeV;^*J~sy*iySuW@aN!lB<Su%})kQNw*TK3#=ANm*J=
zxe%k&)oBwOtxmv`ef`gI_^gwDvcY}7Ha(u@to>^CC#i-~&3d|`z&h?;Q0%8Q-=TJr
zj5g<gA!vUA`O|HEE)&6>pP{Mg5pO;+*nK94&rQiXV&<qI8F+NdKIINTq1!KSY{i|T
zS1u}yzU~~(wDxQXXvb_M@0<n|^`y2PS7<q%LcOouotMj{KY)k*j(xa;vm9{|IwV0;
zfq}zGD#Z)F6XbgyjB%l*KhbX6;|Yn@nU(@>E^*D+v^qMO-Kj_hLhL6(qM}~Kw|N>y
z%jv>ODW25zZGHJVKEy#!aPe&fhsDyY{c|V$RZE6+?q*4yCvV=i^<=1fl_SJu+ULPy
z39b!~lZo##vPuk(Y}ulRsae-gg+2Dsdl4f(*wKNW65Lwm2@uM)*rHt<@BX)yk}A~_
zpyRVGJ}7!G^q8mZY1Ju*bhS9ifd^4n^O<6#V}cIVb2u-bOg01_EzE=4h?lf`l7j<v
zq(mu1z?;(bchKAzFUfCBr0^CNEa`4CN44uYreCa4hXF)_I2UrQ5fPu8oz_1uDC>8l
z2AhhqOW(ww6|gfiy4PHvh{XwY_>m#WkEK%}kOgjm=Wi>sEnily*efp%e#x#!G^}2@
zT}mtoQDzGIM?mj9&`;mof^#RD-*q9!bf6Ca2=A!IjF?^L+}PMV#4^e?@8M}gR#pJh
zeeS^n0AroM0GA|sN6B2LC&X6Dh!l~cW@w3aq|bdK)oRum_C;kiD&bC@&p|IzS~(FB
zxugT_YgMsR#4Zae6%}<*9%~-fjEW?ScK1uG)TvwjDztZvaFoj93!k$K^a4H|8gRt3
zxz%Y1kPe#N9PyC2e^_O+B4ujM@_1Cv7`5FN_dMA=uUcimQu(mnfFF+8-ev-{3_RuG
z<9h+Jc}+JX+It7y<T=lvA;>7O{9|5qHR;8R=;lbSkb6bq(zl?m)eC|~0Ku0X4Gni|
z--K8I>N43H>cy_WQf3~G1)`pnjO}?9Lve{<y4>a}iQXpQmp3&>>grO1@w1g$X9GXh
zK-TQT*Mh|21UZLQs7u+oW?OUSoLgK7GDx0eOpb{GS>YPmrP&RR5cHH%r<qbTy3aY@
zC==gyA!zveYt|<r&2a|YYDZSi;}-BD!<Ea1=KL|xN<vDS-X>sCXgy8eS!~pW2bXsS
zn`dQbtM->U>VWlr_<(x!NUU){L}UvN*>JW_Dx^q$J4**z@#Nyf8;gtAug?W+PSo_W
z87t6u=s3CUcW_fqerVQ#`}Okln)Ihspg#ySx57@)j>8TIc~u2k5Otx7r=ElrU{~oj
z@?~$xlDw5qSmZ1Q!h2%U_ct}EZ|Yk7GQL*!=eikdUQHj&um8Z+Sj0k-=s{cL;a2$N
z_im`04CZy{THNN5n5@O2mL@x#s2L*O4WR0(_ZiI6DsOMc#x&9PW(-x7zlP41#Gg`<
z^<ac*u^HxpP8)e}v)o=Cd1_Ie9L94bIb3M~^%WntB=ks!knIM|dx4U_q7U7i=W3s_
z+UOec&E&yjIeH2+3@?Gl_f!iL?nnzhqJtkv-CG$%K%q_DoVChgD!{<K7#q4eG3vzy
z+`rul)gI3;$;4lzb8q&R<`?-VuXA;WhtG76ayPWSE~S^t{>Ld^8sN&zV+qapipgMv
z(vLHkl%HrLT@j_9jBrbAKf%ds!u0e${MG~c33@=hfc&H??YYN-z7)5R;+#HO<DgQy
zj98d>iqfd7`l7sFP;D1mo6}8kydbf10!9^6QECUAFC@iduO)uxrk8#n;dpH-!sm;8
zRF-{?DFGT$zuc^?ISxJ31T#M=ygUY$et`ce37@ltZ5xhKVE#ooLtWBNeJL{f`jY2~
zi&Twt4xptGw^{r7zH$wxl48tUYNJviIHFh-ZC}LVeAUR$H(nBtP6B8kNP1$qS;&RQ
zH0|rl(}R&K>!NDXGqn}5)UalTzxm3)l4a+*><Xf2Yw-oW9|yugf!`fgRnTvqyvI6D
z_y)mRbhm6+t_K?yzE+cCqI|k%I>Mv!Vs?KWv!!Q5<_EU=ZoV{UjdUsH>fNo1o4gZT
z6z2R;E*wbwsi}rKu~I+Y0gfNQrEa#-Kp8wPorcdFSz4H10<wvjw{!MLh^2;@78t=#
zcQdpJN?g+0l8XBnYpk#rb8Hw#6PBxfQkfKs0|6^09<y+*&{a|EQE2+gJRg@Hxw>L#
zXwcgNx9SS2JqG)GQ$lam@dd4ZR82Hvb%1>5Yt!a)6j$|A=leT$bj9`MqggST?r{cm
zRM4q(3TbwWeEww3Wugl^>gk##qj#T(c?~cBWP8CV-S<4JpK(KplMk}P6Byzo0f>{}
zA{9%W;pbzrHm;<UbA#M8Xqvd^dkpJ^k)mWZ>KA2&kGHT0woqvE+pBCF*F8ze;f=$^
z;XpjoO%ndVrM!MFx;tQ7w8M)$c;prW(;zz*@;;P!kBAV@#~RhNd1X2;7WIn_t6?C(
zclfr*)Myzhlmxf3*PuYYT<dVADQby3Vv4jGq0|b}uenML1F!-8c_;4rgXLm)u=Z(_
z5gwm%6Zh7x6{^D4Lv|C!;yh9sl>$PxxW-Gz%U1%+H;RrlYl)^;Yh}o(Y<W0zcSw_u
zTO}Y29*-7d`m{{^TnyV*Z}wV#1@9H>*$aPtx<b_MPL4TjfKDKW2g_uOmARpxWhU>V
z<;@w!tQO~NGXu4ve3<xrN45qRQEcv^r5)X=e8>rObuf8Qh+vOm6+pmy16<BhE37#e
z56oBA7#6QCxk>Wr?ipvIywnS{yp$ZmB`Ef2?OHu?fNN{~zBDSmg{CIqjCe<fOb}3P
z<?Vk_jZzTSZo8SBB;beKER}_w`73$x7fVt3bhhCTS4$wX(%cx;+ZcJ%-{p>3r_gT0
zT|RPI7tH1;KLvv49FM^?KzYGwnWGW4u&O0fOd0dlAg0h5bRM`{Q_O#Qps<tsG4_44
zznqSxxz(=c(BZ|47b+^(2fBci&B@7`tHjvGUqy?unT~!8gM>RoB$tf|KU`VP%KBdr
zEgg2g5fLN<FkiG(v>?B`TVdA%Q#`IYu0EW}bYx}6z~gERPoG71O2KDqc{G8eyJT-N
zlWYXZRd`*9x^yngc{BV2iLtBj7X+%g1U1_hZEt0Dd+3>piprx$rw$5%X^fdTX7{Sf
zW<K?oM(lI?7%F_>=y(KV9ucO}0EZ&RI!N8pecthVOZ#AQHS28VW{KH`J<s~L$w#Ml
zR63)w>w12rrt+<XbddYScfQ%1&mXF9wL9E*<lra-X%whc{(SOxjxBGG7pmty3R_kf
z9{p~3*_%>0AZvR#J`Cv&0$h&IpZG=eggT&V-!p28&)6(BohL~A>4O0ET{m=Y04+VL
zL9tuMxSE62ktDn{@}B5LOy_ao06bl=kp6e|=k&jBmb53&;=wtayU0VMi|gLLPck_Z
zJ99XSA#6?%AFEa=m^IgKg<mc^ar%#4W45<AQmy3P*#AEHoVT!yk!N-y6E}>!#D!tY
z`G!BP9n33jzkD3j{ddB#I^O*}dp(I8Q$skmjGySyj!@E@8)?JRWk-XX_SVdu=?9#{
zZRJZZ48U38V7e6U;-gK-goWO~V=w&k*l$P6YfjC!c8%JM*>SC8+ZOdYUsQd)N1E;i
zO)_SKb0UvRtUVgf|MB%-;o*s|{`=v((WH}h1KH_pg<t+5^AZx(A4CN#Eq`;PgwE_h
zBWPp={-(Ffq{Mz%49(&E{>L{#Wek-W3KL-};ZIN1O3k79S<|J15~i%!`^3J*EIsR)
z<E59$?(E0BatZKxaO;<rvGH)6Xef+e@x8HD1HVm9@RG2n)gg>5Dm(j&D8mLy3%^DT
z@fRG`dI!RY5)PQbk*-Fw+VNeBX8w+sLZ${nLZ8`GMRUFtCbvLilVlVx@BLpE=+}NJ
z7cocqA!?ML#Vj)Y=qKSY04H`7+nabPQifH}FGfsZg@NHSmHmu>td=-(eA_wz%RWHm
z8Wbv~DoNt&p@XiCL3i{u!1K7-T$V3Tv(bgvxcoGP*v!o4k=*%Q92|Z;-VqZMm(6EI
zv3S5I8lFFnCHFHODK^p60zQ<)!Qd-aPF+$ML=p{4N9D1xvAON660aG(_&Ek-5;RsH
zZR_+vUmkp-pPlJauoU7M)|tp#sH&<`P{Wi#|2~Vi#79r-z@XmVVlNrQl*+ktB^>6F
z@rkz;gYN_-oS;3M@62PrGid82Q24VoG1yHMUTvuDhkfPNMulefSUt35GCQrGNJM;@
z6CvAPPsUzLE<b48MBxD4dWocWtA~!M(`JABF|%VwY%<)xx-?weQtct-yp>@(R6sS5
z8g|4N95h-#y)_n^Zxn}2SGV8az73SEzkdeob%sWHiH{GVV+>$<n-yr`517T>{1IP`
zkZ9HY&7=tu4(H8dSr0;1(5!2%R8k^YzXs##wW{tXuFZ95Vg>_9y^6f<$nIa5cIJ2y
ze?t~n#LM0|8n0e2K&uz}kM^<n7KC7DftffO=cI0LqguW(KH=urYpLi_ZWtBubiN!L
zlf#y~$jwj;w_c?&1@Vi7q)-a&UGb9&xW-#{rrMDA{l!-7Z3N;y-w=gWVlnVhFGM?c
zK9R=z!cynSP+>7rQUoJ1va^*hVlTHMc&uRjMZC>?=R7RYrSqJ(ue=8ur%aNh{4`c?
zz$PS$u+EW=KL_(|KH#DP{Ve$ej(mc9+H1VhsS=bk)zpscWx~9CiF+!6w!p>Z8R&Gp
z5!et0`6g=K@rm57W-+LEer+9*v$#+EV6tC63=7MJVH%zN`HM*4dwE^vga@I0JTPI3
zf$n=NBnB8wJcL7wOv@u3BFBNZh6-SERoM4sjG$eRkD|43jAw+V_Fn1zj}VH?TMi&o
z<F+-nA#Y;vLMC>yP*OO+7rq$$J$|PZh5;$3hocsqKdTGxhA`XAN(B|Kb|D#;xSs@L
z>D@a%M!+nrbFRHndujkJ)(Cg>dmY4UI5wXehMW@vJwB5QyenQ5mkZ#S*JZM;blp=Z
zG)Fwq0rJPrj_ynAm|H~KAzo5wUv%@kP^QeDR3zfd_NMVl7qSrddOL!3rY*Y6Z0Jg&
z{OH6~ws?pHWrPb5GR-Ym_r2;PBwByKw3n`@+FB2O)%)Yb<HPt9m{u^8ddmjp5Yf==
z`DOa>;$#OlsTAm*KQ^Ir$LBCeHv3UGkHg7xDH)$pO)vl{(@=C%zLT1-I}(q!s4tza
z@TXLOpXJDRty$PNXdGoBxQeD==85LFHR^io8~#B-5fd75Yt+XzWGs>39h%e288t`c
z!9C;%1a21F44HH%N!h)i#vz`&bfYt3ox@n+2ol_x>_8ek0heu5`Ohts+Ch&pl?jX#
zCY+Jv{Bn~!&u3?YT3%iU&-XwASynRu12Gzuj$n38$b+!R3pO>}fzTbyq_)Xsbcx*D
zY2qD2*V7q4ChxRgHAH;zeM~y47ml6y_2U?FFHZY?lKn66FzPpkl;coWb1uH^mwtLu
z>f6ML6C9pTg&!(JtXm@U&4!qPhUjTv@Ct;auCXlPQZS5Cxc}ZE%*&Do91|%AZefsY
z$T9BlEcI}<{8bD|RE_q@H6ti4;N4UaCkBrYRB`%JAh4{1gSH~EmuI?Qgib$4P85el
zCuW#Hg2m6<u9HkQYbSxmzKz$>nNnSG<k4J{Eb-;O>3G$>Rq8+%5c+Djy_@PzZlM$n
zSFd#Y0b`}s$WnB1*An~*=ozqN>FS?{{C>gTLGs@(=$K&{8dULA{pgUodBgV(&~%vT
z8Vp|IVq>4o!Pc515@FQKa({Mk^q5s=YYR@9_4J7~AICdz?}z~-ZBX&~p84gYN+`vd
zkL-H=v%$t&n_)(irUzJmvCl`^rCHHq8ewir{TBNABmEW&Y$g>t#$CD=7Ncbk))Gl|
z$7a^>JZnyoSupW%v8?HP6ZbS+UQ13+&Mw{K@4ThPYNPH5WUtv!2n<`Gw6V4}4_wn)
zW}&pP;wdGtUyj26^azLqh#|!qe5jb1F3i&0mVUfs6!`94WM7|!lvFj47+pd$_lXLe
zoypDG1wD2Ie!>`@nTxJrP0V;dj$OcS5Td7$c6kFA9Ayff&K_+W-*8wYUuilFC<DK7
z{f2E;*7fb}Y@6qi25_KYu2k4(%-pVGlRjx(+~ep9<BYn(B1jDN*z)9&z0}kQm^S21
zE^vo?P`#?ygXgK0)%l@;)X>{u0*<S{c<jX%m_7!a!Jya}yXEVJO+IGnKnq3mAon)N
zj0R1F5!}zF2p$;u(PN^kU5$fSPUY#`ZXglXW~KEjlVQe}kx@@W8&mPg-A$A@NDd$K
z_w-rtTa4c6gqgN@&5E;kAinMIuh~gN6u&~aaxB4UHc&f1jC;HR(&vUlEEEjkTI}n)
z-G<+c9IjE$h{O!fn1?IR_L`U^p%j&6Py^xT9eusjt=qE_QB3ivzdCJ9O$pg8M!%#9
zM%h1lG|FFU6{`2<4_MNeq~faW>3KLdS}rJ}h;lzs8D=5!>l6h==J@UVr{0uFtaxAe
zloWQu@%H;1wQ%42<nF;iqOl*gU%5<6uE%aax_nmT8msJOZPnCMVh@@aYpJLh@W<1R
zd<RClSPeL1s#xoG+<Glq26G2&TBA<y_YMf)8hFliYxbL0%Z$>e>p~S{X2ICP%#2<8
z$BV-p%9eM(a6Y_~cp@#WQfdb?n<&P&XC}}i*fuj|OLK;(B~$UmJO;J!L%e52R{SX`
zQoiIzky({&ug_k8f^gVvq?cY9CCeZu5%z6S9Kt_8EvR&+{Zh};h>G<O^mH6HZn8qB
z5R&O2;#)tyJ8jEsMYL1rfe6}N*@p7n>t={9+!)hpr${l0D)5SpE#DVdpe-D_AH-3r
zCG>+X^E2|Xj!wf|M--iM#qFD8ZeLf=^<^Lg?9nf!tb$XYn^WE#dwvFMuW}D9(2u%@
z9xeaI7_8{LPE72%<4)*S_U+WA_>6;2qDLI3Rq+K`-VN*xRVQQZO7U*4aL}@C5o#-o
zeAsw*6uDdYtMA5lEM@>!bH~8S>wF(?qyO`gYHBT~!X%<O|G}!0^cOGM;oX>+n3;K@
z*Tclm|HcXC5xp=r*45UYTQELq<@xTy!)|9TDXH<K{tPjFU>L)5&bMac<y(&on$J6o
zpVh?ns>szpi{Q$29WJ`9ukT7hX^?wTJhU~O|6u3UE3MvM{WwwQ!__8aV`)rFCwp9M
zIRB`p{C>2Bu<&`4)Dd;Xp7~E#MeC>8SyAon-`GrMWM{>hc2HyFb?4e|+AXOJ3^%bb
zvzL_ez$}G<0o9wFSxS1;1O)RlGt~L{vjZ=5CP(3__Ye7MmnbRUMn<ML^3jqYPZQi+
z5^&qMVcpr?ZCZZ`g%sA$GmqCUUAieHzq&=<D7GnZ_(e$c^J5?4>8Hzg88hb1R{z?2
z;|B^%5&NkZ3_iA7-l98Y_+fAfL6o!K9^<ZmxaZuH;$*Y3yqxP%c{os(cyw0y<C#C!
zH%Wahi*tS2yqYbr%7^}0Sgt2ovLs)X)-{2n$gy@A3Gbo8wvD9$gl)ynOgCysIVlgC
zsewAQUg#F>&d99fb;zPDeZSJ5J=&GHBP(r&+R0GoVS@X5AA<ro&3;+K6nmZ4{pf4u
zq0`EE^@LXSx$N|N%i2E$hpIgy_?1)A=vz8FgIrC621jIP+rPfuM0<a2U0sc9<6XOy
zYSpBx59?-Xl992QcQ&61dEq+AR)sBHsQh#N){BdcEEljNeuN(0qo?16+A03wJ+G-L
z!wQ$oo8#kwrM8P#uCYR;v*x9ODsr`UUa-UJg*~O7w2e)ntWNh`Y3^5eWY;=^&Rxo)
zWf+kT+*+|xa*Hs%L$31bb@!)urZW={PGM}dTYtIMgG!ZBpPYETO{er(MJse*T;JR+
zzM!>EJHE{Ph|6yPl59~-lK4y*74GqVEyPdNgEF>FI5&oU<GhEg=}5_NUEM%UjTB?y
zxcF35l=Y!a<hGriUF_@EWJmYjgoGr%fA5?Gt9?|uoRb6-7>S(M=j^u7XN@(>og}DP
zbkt%_j=2PW9|TuW=63LCy5(?lD8Yv`+V*8$L1E!iX95dcS*B208b}lP0ngsx^j%Qn
z%gP6ee$5;U9EqPkJP>E~z{2zFu86GV<QbBRn6dx$le^+qOWV5&F($3TH(!%d=^zQX
zs>y93>9SJueS7=7y*(Bd7Tu=7rD@8ibzjT&?+WzS*S|80#NFFiq)|cU=MQ+3sIIfS
zx{hr7ucOh!I|s4Og#Wd4;Z397c;c;XyOpOCufE^1Ig&54|CQA9u5E_lVSYK=pKhlm
z-SO_a_9^A5v<Yl<cOuz%*1_K7<ImTdGq$B9y-8SVz2se54Kg+O78Wil4rXWDgfb!$
za^5#KPAVxKs6>n)KIG$(J>TjSck3>)W9a%O=u5tg;=9jefn3#R(vX0WFfA3t`1n;C
zHEg*&3(vEDD)zz}j+yKtr7hy@zjLpx3E0`&8=|KpCrI@SXg+*6H#nf0h1{2@*kcrT
zOi@++WNt1Q;nW>dDA7<^vYUpnCsmd8>AH4#_MKE^U)5*fIj!O0W&Ey(tp_`1ozRVu
zreJq`KA-FwOG4*PLgtwKPV(2U{6|4<d))Tu^;VutR*tBRmvil}k0OR?qSKTPQ>=f~
z9s89J*5Z$A9|wo>a5a>bopU?fIT?)Ob94Ut2U+&>c+t(3VvbQC*)QpeoM^e+HY%Wt
zYO?%d_hfU`Ka^cpcvkO@TU7BfH6MGv=E41u@r0#^@>XM;y?=Vuk7<s)1uaf%bJ`U@
zrOX!aalJlAwiwHShtaXHD0WyeiHxl>F+13+nQufPcqsXJBhe#tKd%wx=6dDhkskss
zt;;$Y!NH_O&LNg<s@ji5UMA!XX%YXPsfS4)bMiq0O{yxsm}BmzPvWOfeaPO#6Np^u
zO>aUC&4v%D%XQ{F&?zG(5l^ZcbHAI~x;#{<-x$;pInn!|O+esXPXQPz*}(f>FxKkF
zj~_C6)T~cga{1FF@vpH4RFX(|`6CeZjA8EESzmloLY2F)5@;<Vaj!+(IeNL!o!!m(
z(vZ*ngpGB95Bbr}t;)iIb{UtW!-NZ0UEt0RMLQ2nynM17TmPSc*-eOhnW>284t?yH
z<}Rs$JNk-`@=zSRp?pP!IsH9FC9=YNwzjq-mFelAUBl0VIC2JCXmv?R@5aW?et8(i
zcFzw)uR^@e93nam>1Ewjg&_tdWiCH-d2yr`_gq4Tni8->Wd*i$$%!*f{xo_Dlc?s^
zYhHLr2Cib-U5QJ4a%yHB3((}&+FJ1T9L{;%O>(|L7PkC(8_~r@roEjV2s!@#xxqtQ
z%bMX_HnGLU7reJN$?DOx6)uhr63sUY*mh~%gXgwa+7P^9!roNk`mIq1v7vo}G&HI*
z?ez-_xwNGi`*AO$t;y1QYlm`*mLI<PxTq8^E%LoNucgx^aNlyfJ6T6nGP+=X{vO`>
z>x6{tMi3=oA0wQ(aI$i9Ev>TSqHJdEE{vst`$}z}o^@ZEnfb<Fslb(_S!~{lRgN9j
z{24c~yj;)F@P%TJQLr~1`CX~`qI+AJsw@@*Irq`-7J=;BRoE4Whe889a=7&01Q&jE
zg>HP9FIL7okhAwEOJ<PJoH%R0n|`$3<t{7rf=iN9!_0SZZfq<*Z{7DPHI1nJs;r}<
zs%m(0vi~4XPAd)xML&7JjHN~8G3@bQ@-|!()CcyA6vLhw;;*ntdxd^9rmpqb;CJ1X
zCf^=V`tD9`O!C+=>!=~{DMV#3@pt5*DcLW!z9YAna$Pq!L)h3HX-{XJIGud;sb)})
zbp_uyfduxAq|e1GvwMY{Tn*cg?4CZoSgHjTb(8+e&si%~Z%S7Q`^g&=VoP>S!9fK(
zH#Yf(M?@r<-lttK6BDH+xdibFFEy1eFK0nnA&=<n)+YAxA#ND`$d0Fr;R%mB1_=Fs
zgx9spM2~oXZFyU;KX$~f&NTKxRw=}8e;Yyof{2M4yD}wP1@1YIi_3p*KDoGPx04gD
zhR{BFPL3v^;*$1T<3+|*X^7;sI>H&2(JZsmJ*i_8*U0Plw<;Iik6a5Z%Ld7`6qKVu
z=``?$#~p7A5Y6+_kYu~JF0&cx%V2CVKS$kOr=5?vK`}tmG4rS0s;teKzWDu3&m7;E
z4!+qt*b7b4((kQ<P#$a0hL)AJz^+S0$&%zH6T%qRNBwcba0-{E?hKXlTs*sFcM<c_
zF9u3os-1Qdg!1fzYBEJJyQO~IoPqD}NiZ?*LkmRygm7nH;Bd9;(P7be^~la4HW7bz
zJ{!^T@tl~XG<>@>_7VnJgW(=64UigZGA_x^!_;aax>UEjMTPPhFm$eI^t|Lb4C3M4
z!0^@#6mr>*ct>7$Ucta-;}y!g;dDiSrJu`nGEe(6hYbwm@)&+&Y2($=@Aatp@<79Q
zane`^;Fy#Yv$C?Yy}d_Xo<r|FmmP0`v1-J`c(r!07C(RM-(Od|tXxEs7I((SaQW_7
z7H$~Opf68iXi$+KbV_Dq06A)ETlG+-_Ds!TYdNrcxw+{Q`UQGTSAtI($JLyqfAokt
z9!Zm?&LePJ%l}tuOHG_qa>@eh(QD5DY*>*6*2s#>(yqsEmQzT5`uGcuc~+4heY|1Q
z_cVs8ool4ljc2ZOh{6!U^3l=Lsyv+iM<ez}vYPH;@(LxD2b*6SPvmz@obZIXUu_5;
zg#2?x+R&l%Sgb_p(Q-mURysPLEU~X#{CzNqPOT&z+d=(k_@zH=6kl~sHw3w^dDOWS
zC$2P;7AtDZp=@)sQWpsr+Pb(UNj3^lc1=x7940XO`CTwK$A#ssde4$H3!@Sf6CYDk
ze*j<y!QA`vC2Q*fS_@G<!H3_`w}qY?VnbMm4Ssj}U1>~G(i7;QOit%(iy|i3I-Ezc
z&|WoXd=}a1y!`$g)*kHL&GLc&faXmpmJ63|nj095FAD?(FZGZSqAp<GM7UGgWWu78
z#zp=k%>|4BI#exrJH-F#Cj8mjex|cj`_OyxUu}6a*iCt}w_gRi?#k>fF6B2h`SPzd
zvlJH(CE0*SL`t~|BQ`cdvGDB5Ufv5Ew5Z^+-P<HsdjBu%2`IXaI~YsGKuG8ToB0@j
zU#@|D@W~bw1-+@9LidpA{rB%h#xg7Us|57?BX714%>~ER-18<~L@f)f7mhKmNYA&(
z0a$G_>e?scy&HQ0@A?bHXC;~_EqwF})1}|91sinz|Jb0pnll;osx?Hz$C#c*ntErq
zWJP*o!+EsWhM$M018~yOuz<LDS5+0?x}vnSqtyy|XoLHo5Ku`?nJmk8(VCpxfQX2v
zcsLO-eOe%Sj2)4;H&u6o`B@=ZW#xX*L{z*S4Zj>6@b#;k<BqIbmcReWAx_EV-Hoeh
zU4w&5wchmk9wLsS?v8(Xj>{kG&SQ2#aI;tURxS)c^uaV_<bA9UucLaP+dF>#Z)D<)
zD1GrgHO+NnAsaxI%4}ysuEJw}2bpewT_q)tf)4?3-0M(Oj#ebga(5s8i2v4Nq%pw`
zstj;=Y1L#(y_PGQnD4hwM(gWQl@xO&eKwLzLdfY&TR|SUf8B{TFwDx+-pt6Tk=w+0
zb$5M-r>|M7BL$PPO5JhI=La*KvL^X`^gn<0PFt(>PQxYTmO%yvHaD5Tl^*0jomD;`
zgR|IUaMsu^qgjOgPT@FxP}yW0%ZhTFzl<W)TUqqSqzXj8Q-yf#;KL1#Nwz?+xBui_
zPoFl`eqJ#)yj$UZ)cNj0#rN-r-NiNr@g5#s<<4ij4>$U}mQsFU5T_c4ViH%)#{5z(
zJsvrs=;PMSRpVU+x#^SLI{+;$J$b$k4XH6|?1#fyFU5f3<}^GK!M`z7$3ze=`JpAi
zu6+k5ZrcSFW1uMyF}SW3GSbO9fjTxDl|0%Ms84=^_!l`Lf48jAW3ld>Bgau#+l32W
zF0LbB&vo|>-|3r}L`5GxK;A_xE^g`Suv=(6(g||jj%kHDWOz7naBxC4@@|nhHwGoW
z)w6i_+i68%hGf1X#LrYAJ+v;YPE>XlmW~lM#>SF?_D;8{CwO7aOYezX4h}r1sTmVm
z_qLc?BDp$-hjrUyPJ&MxKsEh|iK?q<y2K+9W+)VckkIMW6sgopMNS*nU4u2qAgy-F
zGcY!eY<x9ir}ZMHj`0bAx&D@x*RF2K)-sjWBayy@$h_YO%8mC(q1e48+_5R-y;aLi
z!t{$6p9`)--_i3=fRbJ?Gg?{s)M%cZNm|MW_tMSQgW{hWN+J5j#@)}qBe*$CKfZ8x
z7W%HfaC|Z=HOHf}e6DcDmdCkNb00g=v%g<IStXwtLzfUoyB4&Kj^-p%OLIOB#J{=Z
zzN#x{hH}KiqZzMDFs9E#Wt~5rK;_5nzdl{g$2&W8dSBjH-na1!fI8^=RYKom5->J5
zuY$)QBiPt1vJz4-zju|8{S&#8va+FGPiB%K(?zr#-v5Lfj;m~Ka9P|<()4L-5>3s*
zrqCmXn=#{e>BM>5Tx>K(TfK+^-)r`$7!GOSpCf#6%a&rk=@xrZ0h;0{Xs|nuIT7$q
zUq%bz@Q!nlbR_4*V7`Pu-EeZYN#CBE8$awl-!VeI<4ifo`$x8X#)J%k^S5ixuteTx
zS?ro%&{H|@9K=IH?1_lfEwvZ@`jc_~e}lR-$CvDX!L#%-4`&ybAHT-YOG5IQ{{Vu>
zlGTzd(S)^nf4uax-T#kIlGcO>IyzLnq4Rc5)+`@U17q(aBXuE4q0zWTMk{IZDjLeb
zkk(Xt)X-MDxJ1fYhQ2(eTpTtZ=b8QK$KLhw_VgI2KA;mgnvCKrUDL}1=TY_jnxZ1I
z&ez?CZFhr(5Z9sm{Dm;Ts3^-V^m{HF4ZD|lc6J594b3oE{gI~Aub8{+b{W5@B0E{1
zk%RO}`iaV&C5xeB&-7>>`}U{fb@A4-IJ_h?t>A~~;9HmvIoEn(i1Lp`7ItX~RE=VG
zSd=LL@@f69^{2b!I5;)nyQ>cC&W|VhkdH0R&I)-0g4S?0i~U8_BBDP-ZKtWfav3el
zWvIvw6rb^5%-+HxlZ|IWU*Q;8++*1e4U6U1zIhM*i>xTc84K|@3(bx_dsM~ckD@ro
zX4W?9Q8CPCDgIGIBBriDHJxkc+68#j9R)vuIOpyz2As%~1)_hhS$((%Ay?vJ;s;XI
zJZ1v|KDp9jy*7yQofNwJ+p~rvj~4y@3rh5V(RABc_vT2vbklHg>P`fEi?5UUNF##(
zz!9Pqae+~nc78-k3OAoo=Uro8GSp75T2}}oqUK(PxVAFEimXhQbNywa!MI?>N+3Pl
z<QIDxVruu6E1y2}4%Jv4sub{Xwe3xdA>~oJxRqqL`VWbhY^JO07nrN)xU8IU^FA9J
z^MeO3ZS#G-5ve&3-H7wp2AR{hmX_%E4?J?t4*3eqoH=tT&Oh$4V`mWXmf2>1;h08e
zqqV=|4E14e)Voq4L-%8Ida^0SIHFage}!jf-(Xh`a>Qi5ooi8wDSQM|Z6|g<tll8q
z`iN8u=Q?fruSCb6&38yNvxWO6zAJV3+5BWt&d=IQDi+TK_BV&9j5*jtK9g`jDaJQR
zlFsw{TT&)<u|z3iA#r@Wa%o7_HWPq9ld{VE0_sv%Op+iEqVmC9q>+T<P6xz12oX_(
zc@?n)*rn0U<JIJHZEXUx9IV&mCpS?xF!*KGAULAbn>eqkp?O#s2hu>oXG^K;g8>1F
zRL{Kvk#;Km@kvRA1K8lL?H7Bg?ix-dN_rVprmeMbAkD|1r<tkp;j~fv8_(W%7;a7h
z>o+%7y0&69TFUW3zU;d}l;a2Q_^hnCy^TIml~Tkh?E4s(_+F6r@n7p!@bpWD%j%BC
z<{q45#oF_2w8i>TXLncxE55oshM-m=Vu0MIB5M2^#`5i7ITzsBIT0)jT*`DzI;KEB
zeAvx<_5!uEBz*cb-{HB%-$b2Ml*H=lZr9O}zOHHfG}ck~z`$m1+h($<rv}^0xm#|R
z%r*h^<b9qW%wId$t7Otw0Rk|xmw}Pd&bnA~d9+*w3D`&tcVp2&!YeyGoY(ar%GB&J
z6Ev%lq`N3=f|;#fS<pS=Y@YC9!mX_nh4h@0Qzg3xfkc)SZEw+K1#u+t;)GvsiMD;F
z7BN!fFJjT&*XK?Cw5!wxIUkT(Qc?xg>lKq?yJG||-1!ecq!=i5?#6DUiIz3ch8$7h
z@6{Q&acfM5E6(|ISNbOZX;a^SV`5(uxuiw{G@xN6Rmb6~Sf(RZc00z>6)$U<+5MgG
zjeH#)7ECI?Xidh-onMFC-9i(b=cuU!W;b0rx>9~}qDD8E#2h_F&Y}I|r&^(PG9sLq
zL;o`o@=LIU{$p=)H%=pS^GDuL7Vfye8L+?aYn1)tLq6vYptjiQFfp2%e3P)C=+xA<
z-<S{YS-}O4dg)1^Nnk(Haucb2%ZUa_-7gz{dv#JN4G|nXH`B{nZg(75RCZ}G=<5sq
zM;hOp?TvcR6U4WyR|mrBhTj_m8%zH-3+u;Q{YW*G{keWJ+4pNO+OQqxcWnNh;Czax
zf<$l7*doqx`<I7&;^&!Y^ze=O@$r|-8YlDJ4>l-DI}Pf5f`KeriV9wmi<9P8m2CR@
z;lqRno)_HHC?+iY(NZ38o#BqKjv>!vEzZgoxflW%72u<SX)fR3+C$iDj9;^_&MPc@
zURE?;!I77oEMF%#IoE*`NaGt@i{Te)jfjC8yTj{}W9e&5Bi%#`jF_pQogKxVv{pDf
zDpdW22pyHlVj^3x<=cH$T+(Mp6J9zh22!oPE0fWa*DU-<-vNY@{PMG@GBYN|f4`EZ
zP!r>?>%clX3IL?Ej|xlitJ&b$kE<pO%0E23<Y#d=y2HxXp(FuL%I5jV<v%gH$ApTb
zr;YZLwmCs3UTT$JSt=F0ywv)*M?p%sECy1n92_@T4PO;*3EGK^J&P^dHGUPWD6pX0
z<O?*ke)IXPd^UUFkr=Yvn-mAS5j?Y^KI<{Tml#A6CD+ulCv2sxPPgFkJBT`-${Vz@
zD@b7IvesKSZ0qh$^c9)r5XtoPF)vXyu-#CFltu7cR#w(iSk|W!&uNF_1{=COTOqGe
zuMl<)ZD=;M&x^#y!O?BvCH^@(OBp)Ueo8{`?Y{i<A=GW4&8PNY8K?7{ro;C>pdusW
z+z#s?O*OqSkb&WDM}8;smp%ycItE#&cmNx6a)KuMUs0{fm<NeYlS3unaz9tk5!5yp
z&NCA0HeJF+PRx1Q6!~ojn!W$3WqkyF3%%ii-KuUt*3pGYsO_b#3>fSg9w^BNDyun<
zR#!jW-cd*4V`%i-uD1u-F{o*hsd;qivs55b%~;6c+})d9N`F!@?&IO2kA4$F`dUX<
zYyS(yN%A>5@&Nx$=ws@O2{gF#*vFe4bHiP0Q{UiaIPZuYNfm4__8*D;4t5{!$I4@9
zCA9kpPz{Df`7f>^Yo=r1-yis2?7;VMQG?SM=N!)@JajIH;+6g_XA|Z>amgc-D8R1Z
zV<RU56K9$o2Rb?i2L_a=S%z}-K3QhfQryvf<m6NZUi9h}!V8rtEyrwnZD$`89(H&6
z-XElYf{<N2T-(z#Ix=#bQipPkoS4|q!eR$3zrPDAO&~USw7pt+2kz!#)BWfb7-;%a
zP|XQiU*cMU@T{wCCBV%{;g$>}+VuMI>8hHByQ^nbWwAs2&M)9bw2oi9X%w=y`B2=B
z(T8<6{!QipQe^yen=kJ4Jf<i~+tDsF+^<5h<o@}x`NH-}3jp74U~t{HM%=smG-s~W
zY*|$DQM(lDYoi8tKy5R7ZG*FT_%WwoMBGKd^_(l~`O9nSt1U+{>ue5-&AstV{tioT
zoS_a3fE<c&vZXnzMd|5|V4;x{Z5}Yj%oPZ59C2ysFApdMF|P@w5geQiFVD>!B<qev
zMZ?c<f%E&N4)NDn4Znd8t#Z@iU2xepw0d>_e`jLJDtaNvFFzzN@Z=ckwbDAp+u4Yu
zZjEB&01qv2$OWl?#i8}@swxKuR#-C#JZ_jaGgZ3m){@BgZ+yZO0Nc{lio1{k%M;q7
z)o^Kdnw>o0UAQ<{1l1A8H|AtA2-&;gXMg{PQmsnCTxIJ4W6&%a$|u(xPLQWlCzj7c
zu$hD~gW3nwpTZ*$h?>`@O?oyJ6yhTyBD#B{4459UqYt{I4HWbfT8=5aC%c1+IW3kg
zcS0&gpE$SeR~uEW=R0kvt<7TPvhQJq1JNeqe6af-s%~ODWMopBE>?c>v?H{AmdP!L
zvmf5LZK<-y{kU@Z{?guZuBtnzOcD~@C78IlxbItXQsEHyeigz}R^BTra_p8?^-<q%
zEvVG4S<Ev5hS4R~#9R#O;SUdjN)7KMh#GgLTH6$UY7^tVOJ%pToo4y#$0y4E$nvst
zIpw0l@7l?9bY^MEZ;nqfJ>P!UN$veSN0-|D$J|dy-3ig^*VDuBkm$?Fmke7vFu4Bn
zE|0x?Bb}B%Y31a%J#w@vaYWgj4{m#xQ3OX~kAW?Hg*=|fDk4m)l=1XyF0QC>^e6p?
zm|{-cb)Md#G50x(O7&PfDBD9aD23SlIQSp7irYxSbm_TWhtofxPj+Epq?CxxJ;~H~
zuKl6&CaX6jl!GuYOUR>Fo`=`P8hZBLym<^m__t@H*9LCtGUs}FzU;NL&1bsz6d$c%
z=4)91Gz7`t^;ttrHD`@}A#ZTazy{~?$*HKUAM7qt?#rX_ey7x-Eg$9^=jkZuI-Q-1
z8ow;|Nw1?!>JOFmCu_I#TO;dtfsIjld!-dvoab~G(Qux^!Xi{6<dg)z-IwwoD0w;G
z%&jUz27~lu2XOUn14JWk-kncl;^TWgxVM?UvL2NCz!)h^>3eg>Zx9PFV-Xa4bOXr5
z+U#BCzUH)`xZ=|9^gxe9Y2Z2S#EN`1Xf-uJ(89$!QY;E+3-eW6TqO@YjuxAq6!%rp
zrS*9;2=I+O(@`(@pR;&8aTN3teJiANW}EKXwQIV%y7BSxE~ikwJ}jhW+%v(!!6{=G
zK(YM^BlOPu_@qXRiQ7`7m9|1#<amSbvvxBv2{eMg`*iM{6Qq~)^bC^N*jtgjVL$p_
zsp#sO-ehYGbYEC9-Gcz3z%G(W%)RbAfo&F2S+_!@dGoWcucf`crDYZnMH$HrU46?9
zjdM^HTIh%ydW$7eg}CV4-5OFLv=+wRvi$SAt;@V-zYx>ZvcCLZT-`3yCqbhN7=p{z
z*Xbdbs|e!LgO4~@aG}z=2(Y6&MmHd|FwizJp~l%6FQ~~3l3-wKpNpT}0?#S1XWA9q
zO@CKe#?teRb6*An(J<T!F0ioL-BuY7UMkzlqF0HBint+w%sW0FxtcPg-_uy+xTXM{
zTmTiz-Uf?)Xl!cPmK1_p4y}k*=5chgC*|R9dhE6{tyOVMqv-dF>LDp^^OI+U3H`t`
zoIXAhWu2XJyCUN7^YrNe4(gN7eNqGN!I#aT&`RD#z;gR>Vnl#m9~IJu12p7|s}N4_
zs%hzb)u2!tT?@23hnp<!!j#3xHwx}u)LCqeV;=rG@xoZC@~z=(M=3cuc~HR3$Qi&;
zib6`t(R{8>LqI618i3aY27s1{$lPxkzcpmy``g&1r629>f;>Ff`Fvxpp?W|p`L;ER
zy|ghIOn!IjH&de*@e4^e92)hEp{xoaKRl@ibQ|Q0S=sY#o_(N*$OeHO6_w;x^f>kp
zm-$T(a;b&+jTf2eNly$k4|ZnvVSz>~$JUXY!9a~rmL+^%J;w$252&;gMF*@tnJ%bL
zBfEDId+YqslbC{ZJFymmVIZkD7Y)+N;*>rN?&LXqeCEiCarVA$HJ+ZHbM_3Bl#?g&
zXt=9hM$Q{{J;=<+P&$x;g?n;*;Q_{#KvYXy)R<Zxmogid^t<;rN7(g86<Fl5UGc6D
zDIL`Q`_oB4iPSX-)oU`A+SIRKw?X64rx|?(AD?1a0qVT?l;^sx54M5_f>hYr)1-5N
zZDzfyzJ6fIbHjD7H;br~G0NTTiNm(;Z`aSjm(w|<tVyb+EOya3L%m4>#`!~<xQU|M
zMh2Y!i;HWVE&bdpp+9ee&YligVM>+MTraiI)xAti44j`@+AJia2yWZ`Hh1f!a?9~c
z!JQ~L6L1+;9PhV#=tr%gzI8qu8pW$PAyg1DcPRcBbJR#Ob?u0;3-0qi3}LPc&)*IT
z5>3gAhzNFQf57GD!qOBNNrBg;_VaMd<7DsH?i-#ONIrld>i+2I6tUdgGLpEDCqdB>
zzLUf!+<3aEm-LtsDRo?<J_rd82_d|8ZR(M8ETu$Um=8PY+Th@`p5-$zf$j&URpXg(
zymrk!V>Ft)rQ7R5ylDP3t><)8wT|}8FX`p6N>-a0VH=x3n5p34jHgRJwl!oCs^QA^
ztuck%77QjtzB~O-guO_v$Zk8^y5mpDmzLf_E%6J%-eOVX*~e9bGpxtVVql==?A!!~
zti+L-!N2%lHQyezLVuiHK^{JsdHD4W=q467lXgAOJAJwwsCOwV$?}MZ)0(~hV$hEw
zM-x@iSuwa6el3NFrNc%|#b(}1e&5a>^bM8j1jwQuhf25F^`^taJ&TK}L*%aO?jXGa
z3T-FT+Vk4AE6m?JI>K|#@PT|NdTj7d-YpHCmh(_*WhDywLsz~g?_YP@n~*oo_{qpj
zM`*kp<_2k4i$?%Uf+`kP>bGy>`{lWJ;l|YUSpnAIu{ekC2m3qfd2D!iNXNA|JC*W}
zMas*qr%7l_-IjJN7jXR>UlIDA17!b8IVn9oJtL#SaZO)OPw(s>rzAC1{?Ahag}n3r
z0PO@EnUf1P%RD>+^Y|Hq&x(oPvXz$H75fdy`j1|o*(0KmS}DY`6D7UK!Qqjr?4B86
zA`P$-4%~?+*N%&VQQ@A!GjVD3C_s#VL3KC9Jq*!Xf~0n3V-LAR!v183b`N<^Dzbk9
z<boC!P?tyMH8}NqSLQLm*~Wa>9n5I!b_!|9nu}1YgUaT})x^xollv%(Mu97k^kROl
zz>xS8hW<2ZD!1cFpbzMu3<LAWzdj&5O@+@v<{Al4Xg=^1_YGQ`e0+LAi~wc35C(CD
zb4lKWSXsXr%XX>KzhsJ9l~c#=&O3oAxQ)}b>V>^8mz8$YVx}~{TYfR8y?LMCZAK}n
zoY$w#<{z-J`N+HE<T+FrTb)2U*uwx`OWXWP>-U}Co((#XRHz!A&7r_N&@18JCqajR
z&hvj1F|UnP9u&-Xtp#CW9ton*_Hc1mvE5J&<ObHo-dUQ~$KbHGQ<;QtI9Pz(7K#Ra
z8G0A%&c|hBv_oY*=c=>Q-exfdB|m$RO^9{AE^mfP+T`Dx0~;+`F*sSY(?iyA^|$np
z`QN&}5GP~fRjAk&6?4_=>SGhN#(+Q)7jC-^`*OXcWDrseHfHAfhJlna{NR&k&z5>z
zvii!PqPpSb>w6jZGWrcnWri_T@dcZ_`9nrT*J^9a-FN3duZARC$L!E2WTsi@RTM|X
zqxmMbd#t&<BAhQa77AzD@bpo?Qzxj!#Q@uc&Br$luMIUKzy?!6#_f$YhQ?juDiK$z
z*5}*gabH>ooIP`C?{Lqw_vky;vW(J8JM$81K1Or04T*48&nwgdufZj!F^~m$aof3s
zjM0-{rSW+|gmiXfI|!5Ew1Lv}?58(8<o_}yDAOzM_Bne`QhWSO*G53RCF7?DwUz6l
z5@SAa_$DT8e~^yIio?~P-+e+EspR+mqWsEf{~KF^SntF_e7cpV2^UOJ&0vlxR)6<i
z($mwaRNelemR85sVy16a!OOpjA^G#2)YW*@EAvgJ2jW%X7<C%lYNva226`!+fr-#P
z02xP`)m-~7NREn>t_>gTyD+nGWN$|Cb(}m|%_;I>zJEp4&7?afP5VWRvbt-?MkIfE
z3-D?AJ4wJBoA%!dmh!Ce((LM5e8}@G@9uhY7%ELZfs>KhhVXx{O0c+geOfhshe52W
z3}!_@=meE1q~scpgXIVYlSln#6rrR@cuXluD%UwXHF|j+B{{nOtMt09^na9I)4tT0
zlXgj!{=BwjH-{1KeGfH1cEJG^X_J~tQkrYbq0Sa~ME}8a^#1?BbMbjUr|z&kcrf*h
zwrH#v#`+sXWKbA9-0^!OKlK>0O{>Wdpg%aOdM}+cTY1Dclpt>4wydXT1pay($xz!8
zfs~V<451Gj$c%na%Bpd^78yH^u|Hd}{(XAmwG)W07Eu@wXlBP^q>xsgc*HHOQkQUW
z@^W)ykiTVoR5u~a{-=`L^k*e^KoJ!7R!ee{(<hDXS4Qkr0WH%a%u2C6)6#??3H{sm
z_^<cyEu5WRC$M4fy~X~7lb(yq=^v~$*01u2?>}hE-F9!asX8sbwJ*kfdpsWC|K=d1
zGMhco&_>XmJbADu>29uYVNl=7N(>MT<gEs+kx6ov0N4jJqqBc0GCbBAC$q7+if*g1
zS_!jhX}fyXp8wyTn1X<A>sUxIL8o-AW&}lRn#@LzvS>eBFpvFXCkM`vQsr;=j0IU=
z5yNb<+yZtTriNB2-M%UT7nPegxFSZLt2myptypWNgWDMEZbFO(8<f8RWq0sntD#;6
zU5s}jA6w-}@PGN&&M$GCqthI(SZKyF&a^~oT7tM3<jJ7>(dH|(h+c$Ob3Y6eLcPZ}
zND4|P=e-Nb0?9PDlogg8U>uz~r_AR&=bGNx+P+Unkd)t@4wasNZ~6@xeJD=N5_huP
zY2&BGy}*c4vpE?ydtdx>Eo%_6me3s6fY}7m>Fl9>1Mi|TkInSS=PYZ&-w~KfBj)E5
z=6VcF3PhXBTLWh_*OyTPqcZLpJrgEB%s$fET2)iiI^_Jb*rqgT7Nn~G(1#~%XJ*VN
zuN6MrT3hpPG6R*ihlg}XL-YS<nKwh)0;xXrTb-tyd584aqsC`eYf^0irHdY~SnoDY
z-JUn@B0|=`fIw8_c5r4a*SJRj@{`1|-K{Zqc?ZO{DEUEjm?}A_9}ZI^Cs>q)9#M00
zKa;19uLJFjjVI5yERr&rS#WCqZ@?v@z)5nSe%arDor4!Ix(8}tK0R4*_RitI_x3VX
zEnK_SGF2DRLfL=w#+UT^V3Bh%sSUTVW*txyFz)uDs-r$jjz2pU8YK!`3IJTe!TI~P
zN>=vy>Iw^6R{80tKvnN9vCGqsUyIzEq+XTJe|_GUsq^L;B)c(W@7`${v-j8WbiY5L
zz-4e~rT53KsZSO`8XkxKnRP-}mHk$g0)>;OA++uB0yveS?w7;KKVL^?!B1cxZVGV4
z-RjkUr)p1OySAyGM~LroD{!;|6wwpF_f~X!Y)op+m<;M%zT>=n{r&>gL(ShxP|JlU
zoWK^;OEyr0$s@jF8>ndv0+5sfJdx81SNmi|#LFB|VsHP_nsFP|+6`Tyk$--zGX5=S
zCHlqJJ(E*~7dqAnGFl-JJffc{s@-x9WN$3c-fy7gCm?VVbScgjkH2$w+drMU;Y8p4
z!Uuo(zw7k+#tBW9+9|hC_~ZH%V9#UGgna^UVXdhk(4}=5E1Q~{dU|@MOqt^EaQuS#
z+<jlaFb70NuKbnEsKDwGe_<P}Q~=$Iav^Bx(xt#to-;EuH8nMNJEmXQK6~HGFKd^}
zHvmtVS@kc1!GrOV_!dQ|t1`i^3UPIH1)kuPmzU?}c8u|Y<d?V0@~vuLzhqyqYgg3Q
z<4g`*6ZS3ORfM)F!6$Go&AYcJ5~wFCDk>mg0=HH3zPn$1m*?C5Ww>(f8ZK*cb8|~e
zzXFd8*9HOyB&PxIShy<B&7kS<tI4co4F@Q^6m)@s31UFN7DiyF8^&Q^xCOeh3ITFK
z2kFB>gBfUr9~?MHgVy}O!2<9pzi{paHqd%KILKh`4=w;+u4Vx|u^tY*<d%arXT!m&
zknC5BfK!QQr@u;0N}2{dXCIt4q4LvoDz`N4-gM{Aoh@6o0AuYgTpw`%%lnVq?|`8V
zj3G%$NhEt2O71-tzoV_C<>l?o&BaxO<X5oF>eZ`(0}#L~(;|^%7JU9EKSfIS;KylV
QK_E*!UHx3vIVCg!0CxMjSO5S3

literal 78626
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
Tt0PBtoDvh363Tq|%>DlXOs-Q`

diff --git a/circuit-breaker/etc/circuit-breaker.urm.puml b/circuit-breaker/etc/circuit-breaker.urm.puml
index 8128c539a..951ec02d3 100644
--- a/circuit-breaker/etc/circuit-breaker.urm.puml
+++ b/circuit-breaker/etc/circuit-breaker.urm.puml
@@ -8,7 +8,7 @@ package com.iluwatar.circuitbreaker {
   interface CircuitBreaker {
     + attemptRequest() : String {abstract}
     + getState() : String {abstract}
-    + recordFailure() {abstract}
+    + recordFailure(String) {abstract}
     + recordSuccess() {abstract}
     + setState(State) {abstract}
   }
@@ -16,6 +16,7 @@ package com.iluwatar.circuitbreaker {
     ~ failureCount : int
     - failureThreshold : int
     - futureTime : long
+    - lastFailureResponse : String
     ~ lastFailureTime : long
     - retryTimePeriod : long
     - service : RemoteService
@@ -25,7 +26,7 @@ package com.iluwatar.circuitbreaker {
     + attemptRequest() : String
     # evaluateState()
     + getState() : String
-    + recordFailure()
+    + recordFailure(response : String)
     + recordSuccess()
     + setState(state : State)
   }

From 4ff196ce35df38080abfec2a4b15407eecf918bb Mon Sep 17 00:00:00 2001
From: Rakesh Venkatesh <rakeshv.com@gmail.com>
Date: Wed, 30 Sep 2020 17:56:12 +0200
Subject: [PATCH 147/254] Refactor the command pattern to use lambda functions

We can leverage the lambda expressins of Java 8 onwards
to implement command design pattern instead of traditional
non functional way
---
 command/README.md                             | 192 +++++++----------
 command/etc/command.png                       | Bin 77145 -> 51106 bytes
 command/etc/command.ucls                      | 201 ++++++++----------
 command/etc/command.urm.puml                  |  41 +---
 .../main/java/com/iluwatar/command/App.java   |  10 +-
 .../java/com/iluwatar/command/Command.java    |  37 ----
 .../java/com/iluwatar/command/Goblin.java     |  21 ++
 .../iluwatar/command/InvisibilitySpell.java   |  57 -----
 .../com/iluwatar/command/ShrinkSpell.java     |  59 -----
 .../java/com/iluwatar/command/Wizard.java     |  18 +-
 .../com/iluwatar/command/CommandTest.java     |   4 +-
 11 files changed, 206 insertions(+), 434 deletions(-)
 delete mode 100644 command/src/main/java/com/iluwatar/command/Command.java
 delete mode 100644 command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
 delete mode 100644 command/src/main/java/com/iluwatar/command/ShrinkSpell.java

diff --git a/command/README.md b/command/README.md
index 28c7e88e9..87dd48824 100644
--- a/command/README.md
+++ b/command/README.md
@@ -14,14 +14,14 @@ Action, Transaction
 
 ## Intent
 
-Encapsulate a request as an object, thereby letting you parameterize clients with different 
+Encapsulate a request as an object, thereby letting you parameterize clients with different
 requests, queue or log requests, and support undoable operations.
 
 ## Explanation
 Real world example
 
-> There is a wizard casting spells on a goblin. The spells are executed on the goblin one by one. 
-> The first spell shrinks the goblin and the second makes him invisible. Then the wizard reverses 
+> There is a wizard casting spells on a goblin. The spells are executed on the goblin one by one.
+> The first spell shrinks the goblin and the second makes him invisible. Then the wizard reverses
 > the spells one by one. Each spell here is a command object that can be undone.
 
 In plain words
@@ -30,8 +30,8 @@ In plain words
 
 Wikipedia says
 
-> In object-oriented programming, the command pattern is a behavioral design pattern in which an 
-> object is used to encapsulate all information needed to perform an action or trigger an event at 
+> In object-oriented programming, the command pattern is a behavioral design pattern in which an
+> object is used to encapsulate all information needed to perform an action or trigger an event at
 > a later time.
 
 **Programmatic Example**
@@ -48,18 +48,16 @@ public class Wizard {
 
   public Wizard() {}
 
-  public void castSpell(Command command, Target target) {
-    LOGGER.info("{} casts {} at {}", this, command, target);
-    command.execute(target);
-    undoStack.offerLast(command);
+  public void castSpell(Runnable runnable) {
+    runnable.run();
+    undoStack.offerLast(runnable);
   }
 
   public void undoLastSpell() {
     if (!undoStack.isEmpty()) {
       var previousSpell = undoStack.pollLast();
       redoStack.offerLast(previousSpell);
-      LOGGER.info("{} undoes {}", this, previousSpell);
-      previousSpell.undo();
+      previousSpell.run();
     }
   }
 
@@ -67,8 +65,7 @@ public class Wizard {
     if (!redoStack.isEmpty()) {
       var previousSpell = redoStack.pollLast();
       undoStack.offerLast(previousSpell);
-      LOGGER.info("{} redoes {}", this, previousSpell);
-      previousSpell.redo();
+      previousSpell.run();
     }
   }
 
@@ -79,84 +76,7 @@ public class Wizard {
 }
 ```
 
-Next we present the spell hierarchy.
-
-```java
-public interface Command {
-
-  void execute(Target target);
-
-  void undo();
-
-  void redo();
-
-  String toString();
-}
-
-public class InvisibilitySpell implements Command {
-
-  private Target target;
-
-  @Override
-  public void execute(Target target) {
-    target.setVisibility(Visibility.INVISIBLE);
-    this.target = target;
-  }
-
-  @Override
-  public void undo() {
-    if (target != null) {
-      target.setVisibility(Visibility.VISIBLE);
-    }
-  }
-
-  @Override
-  public void redo() {
-    if (target != null) {
-      target.setVisibility(Visibility.INVISIBLE);
-    }
-  }
-
-  @Override
-  public String toString() {
-    return "Invisibility spell";
-  }
-}
-
-public class ShrinkSpell implements Command {
-
-  private Size oldSize;
-  private Target target;
-
-  @Override
-  public void execute(Target target) {
-    oldSize = target.getSize();
-    target.setSize(Size.SMALL);
-    this.target = target;
-  }
-
-  @Override
-  public void undo() {
-    if (oldSize != null && target != null) {
-      var temp = target.getSize();
-      target.setSize(oldSize);
-      oldSize = temp;
-    }
-  }
-
-  @Override
-  public void redo() {
-    undo();
-  }
-
-  @Override
-  public String toString() {
-    return "Shrink spell";
-  }
-}
-```
-
-Finally, we have the goblin who's the target of the spells.
+Next, we have the goblin who's the target of the spells.
 
 ```java
 public abstract class Target {
@@ -203,33 +123,73 @@ public class Goblin extends Target {
     return "Goblin";
   }
 
+  public void changeSize() {
+    var oldSize = getSize() == Size.NORMAL ? Size.SMALL : Size.NORMAL;
+    setSize(oldSize);
+  }
+
+  public void changeVisibility() {
+    var visible = getVisibility() == Visibility.INVISIBLE
+          ? Visibility.VISIBLE : Visibility.INVISIBLE;
+    setVisibility(visible);
+  }
 }
 ```
 
+Finally we have the wizard in main function who casts spell
+
+```java
+public static void main(String[] args) {
+  var wizard = new Wizard();
+  var goblin = new Goblin();
+
+  // casts shrink/unshrink spell
+  wizard.castSpell(goblin::changeSize);
+
+  // casts visible/invisible spell
+  wizard.castSpell(goblin::changeVisibility);
+
+  // undo and redo casts
+   wizard.undoLastSpell();
+   wizard.redoLastSpell();
+```
+
 Here's the whole example in action.
 
 ```java
 var wizard = new Wizard();
 var goblin = new Goblin();
+
 goblin.printStatus();
-wizard.castSpell(new ShrinkSpell(), goblin);
+wizard.castSpell(goblin::changeSize);
 goblin.printStatus();
-wizard.castSpell(new InvisibilitySpell(), goblin);
+
+wizard.castSpell(goblin::changeVisibility);
 goblin.printStatus();
+
 wizard.undoLastSpell();
 goblin.printStatus();
+
+wizard.undoLastSpell();
+goblin.printStatus();
+
+wizard.redoLastSpell();
+goblin.printStatus();
+
+wizard.redoLastSpell();
+goblin.printStatus();
 ```
 
 Here's the program output:
 
 ```java
-// Goblin, [size=normal] [visibility=visible]
-// Wizard casts Shrink spell at Goblin
-// Goblin, [size=small] [visibility=visible]
-// Wizard casts Invisibility spell at Goblin
-// Goblin, [size=small] [visibility=invisible]
-// Wizard undoes Invisibility spell
-// Goblin, [size=small] [visibility=visible]
+Goblin, [size=normal] [visibility=visible]
+Goblin, [size=small] [visibility=visible]
+Goblin, [size=small] [visibility=invisible]
+Goblin, [size=small] [visibility=visible]
+Goblin, [size=normal] [visibility=visible]
+Goblin, [size=small] [visibility=visible]
+Goblin, [size=small] [visibility=invisible]
 ```
 
 ## Class diagram
@@ -240,26 +200,26 @@ Here's the program output:
 
 Use the Command pattern when you want to:
 
-* Parameterize objects by an action to perform. You can express such parameterization in a 
-procedural language with a callback function, that is, a function that's registered somewhere to be 
+* Parameterize objects by an action to perform. You can express such parameterization in a
+procedural language with a callback function, that is, a function that's registered somewhere to be
 called at a later point. Commands are an object-oriented replacement for callbacks.
-* Specify, queue, and execute requests at different times. A Command object can have a lifetime 
-independent of the original request. If the receiver of a request can be represented in an address 
-space-independent way, then you can transfer a command object for the request to a different process 
+* Specify, queue, and execute requests at different times. A Command object can have a lifetime
+independent of the original request. If the receiver of a request can be represented in an address
+space-independent way, then you can transfer a command object for the request to a different process
 and fulfill the request there.
-* Support undo. The Command's execute operation can store state for reversing its effects in the 
-command itself. The Command interface must have an added un-execute operation that reverses the 
-effects of a previous call to execute. The executed commands are stored in a history list. 
-Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling 
+* Support undo. The Command's execute operation can store state for reversing its effects in the
+command itself. The Command interface must have an added un-execute operation that reverses the
+effects of a previous call to execute. The executed commands are stored in a history list.
+Unlimited-level undo and redo is achieved by traversing this list backwards and forwards calling
 un-execute and execute, respectively.
-* Support logging changes so that they can be reapplied in case of a system crash. By augmenting the 
-Command interface with load and store operations, you can keep a persistent log of changes. 
-Recovering from a crash involves reloading logged commands from disk and re-executing them with 
+* Support logging changes so that they can be reapplied in case of a system crash. By augmenting the
+Command interface with load and store operations, you can keep a persistent log of changes.
+Recovering from a crash involves reloading logged commands from disk and re-executing them with
 the execute operation.
-* Structure a system around high-level operations build on primitive operations. Such a structure is 
-common in information systems that support transactions. A transaction encapsulates a set of changes 
-to data. The Command pattern offers a way to model transactions. Commands have a common interface, 
-letting you invoke all transactions the same way. The pattern also makes it easy to extend the 
+* Structure a system around high-level operations build on primitive operations. Such a structure is
+common in information systems that support transactions. A transaction encapsulates a set of changes
+to data. The Command pattern offers a way to model transactions. Commands have a common interface,
+letting you invoke all transactions the same way. The pattern also makes it easy to extend the
 system with new transactions.
 
 ## Typical Use Case
diff --git a/command/etc/command.png b/command/etc/command.png
index 5564b0ec52280784242f384c1f9f4ac154772f7c..0f026464ecc4ad0218a06f388d259368f971d1d2 100644
GIT binary patch
literal 51106
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

literal 77145
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

diff --git a/command/etc/command.ucls b/command/etc/command.ucls
index f0e0857d2..afc7e1762 100644
--- a/command/etc/command.ucls
+++ b/command/etc/command.ucls
@@ -1,116 +1,89 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.command.ShrinkSpell" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/ShrinkSpell.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="178" width="141" x="-30" y="681"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.command.Goblin" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/Goblin.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="129" y="1223"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.command.Wizard" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/Wizard.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="129" y="362"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="4" language="java" name="com.iluwatar.command.Command" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/Command.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="129" y="561"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="5" language="java" name="com.iluwatar.command.InvisibilitySpell" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="160" width="141" x="151" y="681"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="6" language="java" name="com.iluwatar.command.Target" project="command" 
-    file="/command/src/main/java/com/iluwatar/command/Target.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="129" y="1014"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <association id="7">    
-    <end type="SOURCE" refId="3" navigable="false">      
-      <attribute id="8" name="redoStack">        
-        <position height="20" width="67" x="140" y="451"/>      
-      </attribute>      
-      <multiplicity id="9" minimum="0" maximum="2147483647">        
-        <position height="18" width="25" x="221" y="452"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="4" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <generalization id="10">    
-    <end type="SOURCE" refId="2"/>    
-    <end type="TARGET" refId="6"/>  
-  </generalization>  
-  <association id="11">    
-    <end type="SOURCE" refId="1" navigable="false">      
-      <attribute id="12" name="target"/>      
-      <multiplicity id="13" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="6" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <generalization id="14">    
-    <end type="SOURCE" refId="1"/>    
-    <end type="TARGET" refId="4"/>  
-  </generalization>  
-  <association id="15">    
-    <end type="SOURCE" refId="3" navigable="false">      
-      <attribute id="16" name="undoStack">        
-        <position height="20" width="70" x="-17" y="451"/>      
-      </attribute>      
-      <multiplicity id="17" minimum="0" maximum="2147483647">        
-        <position height="18" width="25" x="60" y="452"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="4" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <generalization id="18">    
-    <end type="SOURCE" refId="5"/>    
-    <end type="TARGET" refId="4"/>  
-  </generalization>  
-  <association id="19">    
-    <end type="SOURCE" refId="5" navigable="false">      
-      <attribute id="20" name="target"/>      
-      <multiplicity id="21" minimum="0" maximum="1"/>    
-    </end>    
-    <end type="TARGET" refId="6" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
+<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true"
+  realizations="true" associations="true" dependencies="false" nesting-relationships="true">
+  <class id="2" language="java" name="com.iluwatar.command.Goblin" project="command"
+    file="/command/src/main/java/com/iluwatar/command/Goblin.java" binary="false" corner="BOTTOM_RIGHT">
+    <position height="-1" width="-1" x="129" y="1223"/>
+    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true"
+      sort-features="false" accessors="true" visibility="true">
+      <attributes public="true" package="true" protected="true" private="true" static="true"/>
+      <operations public="true" package="true" protected="true" private="true" static="true"/>
+    </display>
+  </class>
+  <class id="3" language="java" name="com.iluwatar.command.Wizard" project="command"
+    file="/command/src/main/java/com/iluwatar/command/Wizard.java" binary="false" corner="BOTTOM_RIGHT">
+    <position height="-1" width="-1" x="129" y="362"/>
+    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true"
+      sort-features="false" accessors="true" visibility="true">
+      <attributes public="true" package="true" protected="true" private="true" static="true"/>
+      <operations public="true" package="true" protected="true" private="true" static="true"/>
+    </display>
+  </class>
+  <class id="6" language="java" name="com.iluwatar.command.Target" project="command"
+    file="/command/src/main/java/com/iluwatar/command/Target.java" binary="false" corner="BOTTOM_RIGHT">
+    <position height="-1" width="-1" x="129" y="1014"/>
+    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true"
+      sort-features="false" accessors="true" visibility="true">
+      <attributes public="true" package="true" protected="true" private="true" static="true"/>
+      <operations public="true" package="true" protected="true" private="true" static="true"/>
+    </display>
+  </class>
+  <association id="7">
+    <end type="SOURCE" refId="3" navigable="false">
+      <attribute id="8" name="redoStack">
+        <position height="20" width="67" x="140" y="451"/>
+      </attribute>
+      <multiplicity id="9" minimum="0" maximum="2147483647">
+        <position height="18" width="25" x="221" y="452"/>
+      </multiplicity>
+    </end>
+    <end type="TARGET" refId="4" navigable="true"/>
+    <display labels="true" multiplicity="true"/>
+  </association>
+  <generalization id="10">
+    <end type="SOURCE" refId="2"/>
+    <end type="TARGET" refId="6"/>
+  </generalization>
+  <association id="11">
+    <end type="SOURCE" refId="1" navigable="false">
+      <attribute id="12" name="target"/>
+      <multiplicity id="13" minimum="0" maximum="1"/>
+    </end>
+    <end type="TARGET" refId="6" navigable="true"/>
+    <display labels="true" multiplicity="true"/>
+  </association>
+  <generalization id="14">
+    <end type="SOURCE" refId="1"/>
+    <end type="TARGET" refId="4"/>
+  </generalization>
+  <association id="15">
+    <end type="SOURCE" refId="3" navigable="false">
+      <attribute id="16" name="undoStack">
+        <position height="20" width="70" x="-17" y="451"/>
+      </attribute>
+      <multiplicity id="17" minimum="0" maximum="2147483647">
+        <position height="18" width="25" x="60" y="452"/>
+      </multiplicity>
+    </end>
+    <end type="TARGET" refId="4" navigable="true"/>
+    <display labels="true" multiplicity="true"/>
+  </association>
+  <generalization id="18">
+    <end type="SOURCE" refId="5"/>
+    <end type="TARGET" refId="4"/>
+  </generalization>
+  <association id="19">
+    <end type="SOURCE" refId="5" navigable="false">
+      <attribute id="20" name="target"/>
+      <multiplicity id="21" minimum="0" maximum="1"/>
+    </end>
+    <end type="TARGET" refId="6" navigable="true"/>
+    <display labels="true" multiplicity="true"/>
+  </association>
+  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true"
+    sort-features="false" accessors="true" visibility="true">
+    <attributes public="true" package="true" protected="true" private="true" static="true"/>
+    <operations public="true" package="true" protected="true" private="true" static="true"/>
+  </classifier-display>
   <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
+</class-diagram>
diff --git a/command/etc/command.urm.puml b/command/etc/command.urm.puml
index c9c172226..f85949c56 100644
--- a/command/etc/command.urm.puml
+++ b/command/etc/command.urm.puml
@@ -4,33 +4,11 @@ package com.iluwatar.command {
     + App()
     + main(args : String[]) {static}
   }
-  interface Command {
-    + Command()
-    + execute(Target) {abstract}
-    + redo() {abstract}
-    + toString() : String {abstract}
-    + undo() {abstract}
-  }
   class Goblin {
     + Goblin()
     + toString() : String
-  }
-  class InvisibilitySpell {
-    - target : Target
-    + InvisibilitySpell()
-    + execute(target : Target)
-    + redo()
-    + toString() : String
-    + undo()
-  }
-  class ShrinkSpell {
-    - oldSize : Size
-    - target : Target
-    + ShrinkSpell()
-    + execute(target : Target)
-    + redo()
-    + toString() : String
-    + undo()
+    + changeSize()
+    + changeVisibility()
   }
   enum Size {
     + NORMAL {static}
@@ -62,22 +40,19 @@ package com.iluwatar.command {
   }
   class Wizard {
     - LOGGER : Logger {static}
-    - redoStack : Deque<Command>
-    - undoStack : Deque<Command>
+    - redoStack : Deque<Runnable>
+    - undoStack : Deque<Runnable>
     + Wizard()
-    + castSpell(command : Command, target : Target)
+    + castSpell(Runnable : runnable)
     + redoLastSpell()
     + toString() : String
     + undoLastSpell()
   }
 }
 Target -->  "-size" Size
-Wizard -->  "-undoStack" Command
-ShrinkSpell -->  "-oldSize" Size
-InvisibilitySpell -->  "-target" Target
-ShrinkSpell -->  "-target" Target
+Wizard -->  "-changeSize" Goblin
+Wizard -->  "-changeVisibility" Goblin
 Target -->  "-visibility" Visibility
 Goblin --|> Target
-InvisibilitySpell ..|> Command
-ShrinkSpell ..|> Command
+App --> "castSpell" Wizard
 @enduml
diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java
index b4e54fd97..1e4e78758 100644
--- a/command/src/main/java/com/iluwatar/command/App.java
+++ b/command/src/main/java/com/iluwatar/command/App.java
@@ -32,10 +32,10 @@ package com.iluwatar.command;
  * client. A command object (spell) knows about the receiver (target) and invokes a method of the
  * receiver. Values for parameters of the receiver method are stored in the command. The receiver
  * then does the work. An invoker object (wizard) knows how to execute a command, and optionally
- * does bookkeeping about the command execution. The invoker does not know anything about a concrete
- * command, it knows only about command interface. Both an invoker object and several command
+ * does bookkeeping about the command execution. The invoker does not know anything about a is
+ * executed. Both an invoker object and several command
  * objects are held by a client object (app). The client decides which commands to execute at which
- * points. To execute a command, it passes the command object to the invoker object.
+ * points. To execute a command, it passes a reference of the command object to the invoker object.
  *
  * <p>In other words, in this example the wizard casts spells on the goblin. The wizard keeps track
  * of the previous spells cast, so it is easy to undo them. In addition, the wizard keeps track of
@@ -54,10 +54,10 @@ public class App {
 
     goblin.printStatus();
 
-    wizard.castSpell(new ShrinkSpell(), goblin);
+    wizard.castSpell(goblin::changeSize);
     goblin.printStatus();
 
-    wizard.castSpell(new InvisibilitySpell(), goblin);
+    wizard.castSpell(goblin::changeVisibility);
     goblin.printStatus();
 
     wizard.undoLastSpell();
diff --git a/command/src/main/java/com/iluwatar/command/Command.java b/command/src/main/java/com/iluwatar/command/Command.java
deleted file mode 100644
index 83010f160..000000000
--- a/command/src/main/java/com/iluwatar/command/Command.java
+++ /dev/null
@@ -1,37 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.command;
-
-/**
- * Interface for Commands.
- */
-public interface Command {
-  void execute(Target target);
-
-  void undo();
-
-  void redo();
-
-  String toString();
-}
diff --git a/command/src/main/java/com/iluwatar/command/Goblin.java b/command/src/main/java/com/iluwatar/command/Goblin.java
index 72ddc43b5..791bd94e3 100644
--- a/command/src/main/java/com/iluwatar/command/Goblin.java
+++ b/command/src/main/java/com/iluwatar/command/Goblin.java
@@ -23,11 +23,16 @@
 
 package com.iluwatar.command;
 
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
 /**
  * Goblin is the target of the spells.
  */
 public class Goblin extends Target {
 
+  private static final Logger LOGGER = LoggerFactory.getLogger(Goblin.class);
+
   public Goblin() {
     setSize(Size.NORMAL);
     setVisibility(Visibility.VISIBLE);
@@ -38,4 +43,20 @@ public class Goblin extends Target {
     return "Goblin";
   }
 
+  /**
+   * changeSize.
+   */
+  public void changeSize() {
+    var oldSize = getSize() == Size.NORMAL ? Size.SMALL : Size.NORMAL;
+    setSize(oldSize);
+  }
+
+  /**
+   * changeVisibility.
+   */
+  public void changeVisibility() {
+    var visible = getVisibility() == Visibility.INVISIBLE
+            ? Visibility.VISIBLE : Visibility.INVISIBLE;
+    setVisibility(visible);
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java b/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
deleted file mode 100644
index 33e053cc2..000000000
--- a/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
+++ /dev/null
@@ -1,57 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.command;
-
-/**
- * InvisibilitySpell is a concrete command.
- */
-public class InvisibilitySpell implements Command {
-
-  private Target target;
-
-  @Override
-  public void execute(Target target) {
-    target.setVisibility(Visibility.INVISIBLE);
-    this.target = target;
-  }
-
-  @Override
-  public void undo() {
-    if (target != null) {
-      target.setVisibility(Visibility.VISIBLE);
-    }
-  }
-
-  @Override
-  public void redo() {
-    if (target != null) {
-      target.setVisibility(Visibility.INVISIBLE);
-    }
-  }
-
-  @Override
-  public String toString() {
-    return "Invisibility spell";
-  }
-}
diff --git a/command/src/main/java/com/iluwatar/command/ShrinkSpell.java b/command/src/main/java/com/iluwatar/command/ShrinkSpell.java
deleted file mode 100644
index 3f21fc7c1..000000000
--- a/command/src/main/java/com/iluwatar/command/ShrinkSpell.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.command;
-
-/**
- * ShrinkSpell is a concrete command.
- */
-public class ShrinkSpell implements Command {
-
-  private Size oldSize;
-  private Target target;
-
-  @Override
-  public void execute(Target target) {
-    oldSize = target.getSize();
-    target.setSize(Size.SMALL);
-    this.target = target;
-  }
-
-  @Override
-  public void undo() {
-    if (oldSize != null && target != null) {
-      var temp = target.getSize();
-      target.setSize(oldSize);
-      oldSize = temp;
-    }
-  }
-
-  @Override
-  public void redo() {
-    undo();
-  }
-
-  @Override
-  public String toString() {
-    return "Shrink spell";
-  }
-}
diff --git a/command/src/main/java/com/iluwatar/command/Wizard.java b/command/src/main/java/com/iluwatar/command/Wizard.java
index dd469d3c0..b4568eebf 100644
--- a/command/src/main/java/com/iluwatar/command/Wizard.java
+++ b/command/src/main/java/com/iluwatar/command/Wizard.java
@@ -35,20 +35,18 @@ public class Wizard {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class);
 
-  private final Deque<Command> undoStack = new LinkedList<>();
-  private final Deque<Command> redoStack = new LinkedList<>();
+  private final Deque<Runnable> undoStack = new LinkedList<>();
+  private final Deque<Runnable> redoStack = new LinkedList<>();
 
   public Wizard() {
-    // comment to ignore sonar issue: LEVEL critical
   }
 
   /**
    * Cast spell.
    */
-  public void castSpell(Command command, Target target) {
-    LOGGER.info("{} casts {} at {}", this, command, target);
-    command.execute(target);
-    undoStack.offerLast(command);
+  public void castSpell(Runnable runnable) {
+    runnable.run();
+    undoStack.offerLast(runnable);
   }
 
   /**
@@ -58,8 +56,7 @@ public class Wizard {
     if (!undoStack.isEmpty()) {
       var previousSpell = undoStack.pollLast();
       redoStack.offerLast(previousSpell);
-      LOGGER.info("{} undoes {}", this, previousSpell);
-      previousSpell.undo();
+      previousSpell.run();
     }
   }
 
@@ -70,8 +67,7 @@ public class Wizard {
     if (!redoStack.isEmpty()) {
       var previousSpell = redoStack.pollLast();
       undoStack.offerLast(previousSpell);
-      LOGGER.info("{} redoes {}", this, previousSpell);
-      previousSpell.redo();
+      previousSpell.run();
     }
   }
 
diff --git a/command/src/test/java/com/iluwatar/command/CommandTest.java b/command/src/test/java/com/iluwatar/command/CommandTest.java
index 81f556010..76b8c9e58 100644
--- a/command/src/test/java/com/iluwatar/command/CommandTest.java
+++ b/command/src/test/java/com/iluwatar/command/CommandTest.java
@@ -56,10 +56,10 @@ public class CommandTest {
     var wizard = new Wizard();
     var goblin = new Goblin();
 
-    wizard.castSpell(new ShrinkSpell(), goblin);
+    wizard.castSpell(goblin::changeSize);
     verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.VISIBLE);
 
-    wizard.castSpell(new InvisibilitySpell(), goblin);
+    wizard.castSpell(goblin::changeVisibility);
     verifyGoblin(goblin, GOBLIN, Size.SMALL, Visibility.INVISIBLE);
 
     wizard.undoLastSpell();

From af1b611136e417c0c04f491bd344c5b73207d779 Mon Sep 17 00:00:00 2001
From: Rakesh Venkatesh <rakeshv.com@gmail.com>
Date: Tue, 13 Oct 2020 17:36:59 +0200
Subject: [PATCH 148/254] code refactor

---
 .../src/main/java/com/iluwatar/command/App.java | 10 ++++------
 .../main/java/com/iluwatar/command/Goblin.java  | 17 -----------------
 .../main/java/com/iluwatar/command/Target.java  | 17 +++++++++++++++++
 3 files changed, 21 insertions(+), 23 deletions(-)

diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java
index 1e4e78758..77396d37a 100644
--- a/command/src/main/java/com/iluwatar/command/App.java
+++ b/command/src/main/java/com/iluwatar/command/App.java
@@ -30,12 +30,10 @@ package com.iluwatar.command;
  *
  * <p>Four terms always associated with the command pattern are command, receiver, invoker and
  * client. A command object (spell) knows about the receiver (target) and invokes a method of the
- * receiver. Values for parameters of the receiver method are stored in the command. The receiver
- * then does the work. An invoker object (wizard) knows how to execute a command, and optionally
- * does bookkeeping about the command execution. The invoker does not know anything about a is
- * executed. Both an invoker object and several command
- * objects are held by a client object (app). The client decides which commands to execute at which
- * points. To execute a command, it passes a reference of the command object to the invoker object.
+ * receiver. An invoker object (wizard) receives a reference to the command to be executed and
+ * optionally does bookkeeping about the command execution. The invoker does not know anything
+ * about how the command is executed. The client decides which commands to execute at which
+ * points. To execute a command, it passes a reference of the function to the invoker object.
  *
  * <p>In other words, in this example the wizard casts spells on the goblin. The wizard keeps track
  * of the previous spells cast, so it is easy to undo them. In addition, the wizard keeps track of
diff --git a/command/src/main/java/com/iluwatar/command/Goblin.java b/command/src/main/java/com/iluwatar/command/Goblin.java
index 791bd94e3..a2311dfd3 100644
--- a/command/src/main/java/com/iluwatar/command/Goblin.java
+++ b/command/src/main/java/com/iluwatar/command/Goblin.java
@@ -42,21 +42,4 @@ public class Goblin extends Target {
   public String toString() {
     return "Goblin";
   }
-
-  /**
-   * changeSize.
-   */
-  public void changeSize() {
-    var oldSize = getSize() == Size.NORMAL ? Size.SMALL : Size.NORMAL;
-    setSize(oldSize);
-  }
-
-  /**
-   * changeVisibility.
-   */
-  public void changeVisibility() {
-    var visible = getVisibility() == Visibility.INVISIBLE
-            ? Visibility.VISIBLE : Visibility.INVISIBLE;
-    setVisibility(visible);
-  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Target.java b/command/src/main/java/com/iluwatar/command/Target.java
index f5ac4344c..419ad6f54 100644
--- a/command/src/main/java/com/iluwatar/command/Target.java
+++ b/command/src/main/java/com/iluwatar/command/Target.java
@@ -62,4 +62,21 @@ public abstract class Target {
   public void printStatus() {
     LOGGER.info("{}, [size={}] [visibility={}]", this, getSize(), getVisibility());
   }
+
+  /**
+   * Changes the size of the target.
+   */
+  public void changeSize() {
+    var oldSize = getSize() == Size.NORMAL ? Size.SMALL : Size.NORMAL;
+    setSize(oldSize);
+  }
+
+  /**
+   * Changes the visibility of the target.
+   */
+  public void changeVisibility() {
+    var visible = getVisibility() == Visibility.INVISIBLE
+            ? Visibility.VISIBLE : Visibility.INVISIBLE;
+    setVisibility(visible);
+  }
 }

From 2332520d678884357de5ed7adbaa4ebec624eb9f Mon Sep 17 00:00:00 2001
From: Pavel Manannikov <pavel.manannikov@murka.com>
Date: Tue, 13 Oct 2020 20:17:25 +0300
Subject: [PATCH 149/254] #1284 Implement Version Number pattern

---
 pom.xml                                       |   1 +
 version-number/README.md                      | 169 ++++++++++++++++++
 version-number/etc/version-number.urm.png     | Bin 0 -> 22183 bytes
 version-number/etc/version-number.urm.puml    |  32 ++++
 version-number/pom.xml                        |  66 +++++++
 .../java/com/iluwatar/versionnumber/App.java  |  84 +++++++++
 .../java/com/iluwatar/versionnumber/Book.java |  78 ++++++++
 .../versionnumber/BookDuplicateException.java |  33 ++++
 .../versionnumber/BookNotFoundException.java  |  33 ++++
 .../versionnumber/BookRepository.java         |  86 +++++++++
 .../VersionMismatchException.java             |  33 ++++
 .../com/iluwatar/versionnumber/AppTest.java   |  46 +++++
 .../versionnumber/BookRepositoryTest.java     |  72 ++++++++
 13 files changed, 733 insertions(+)
 create mode 100644 version-number/README.md
 create mode 100644 version-number/etc/version-number.urm.png
 create mode 100644 version-number/etc/version-number.urm.puml
 create mode 100644 version-number/pom.xml
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/App.java
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/Book.java
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
 create mode 100644 version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
 create mode 100644 version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
 create mode 100644 version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java

diff --git a/pom.xml b/pom.xml
index 102668588..e7fd2e4b3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -89,6 +89,7 @@
         <module>state</module>
         <module>strategy</module>
         <module>template-method</module>
+        <module>version-number</module>
         <module>visitor</module>
         <module>double-checked-locking</module>
         <module>servant</module>
diff --git a/version-number/README.md b/version-number/README.md
new file mode 100644
index 000000000..f95b1bcc7
--- /dev/null
+++ b/version-number/README.md
@@ -0,0 +1,169 @@
+---
+layout: pattern
+title: Version Number
+folder: versionnumber
+permalink: /patterns/versionnumber/
+description: Entity versioning with version number
+
+categories:
+ - Concurrency
+
+tags:
+ - Data access
+ - Microservices
+---
+
+## Name / classification
+
+Version Number.
+
+## Also known as
+
+Entity Versioning, Optimistic Locking.
+
+## Intent
+
+Resolve concurrency conflicts when multiple clients are trying to update same entity simultaneously.
+
+## Explanation
+
+Real world example
+
+> Alice and Bob are working on the book, which stored in the database. Our heroes are making
+> changes simultaneously, and we need some mechanism to prevent them from overwriting each other.
+
+In plain words
+
+> Version Number pattern grants protection against concurrent updates to same entity.
+
+Wikipedia says
+
+> Optimistic concurrency control assumes that multiple transactions can frequently complete
+> without interfering with each other. While running, transactions use data resources without
+> acquiring locks on those resources. Before committing, each transaction verifies that no other
+> transaction has modified the data it has read. If the check reveals conflicting modifications,
+> the committing transaction rolls back and can be restarted.
+
+**Programmatic Example**
+
+We have a `Book` entity, which is versioned, and has a copy-constructor:
+
+```java
+public class Book {
+  private long id;
+  private String title = "";
+  private String author = "";
+
+  private long version = 0; // version number
+
+  public Book(Book book) {
+    this.id = book.id;
+    this.title = book.title;
+    this.author = book.author;
+    this.version = book.version;
+  }
+
+  // getters and setters are omitted here
+}
+```
+
+We also have `BookRepository`, which implements concurrency control:
+
+```java
+public class BookRepository {
+  private final Map<Long, Book> collection = new HashMap<>();
+
+  public void update(Book book) throws BookNotFoundException, VersionMismatchException {
+    if (!collection.containsKey(book.getId())) {
+      throw new BookNotFoundException("Not found book with id: " + book.getId());
+    }
+
+    Book latestBook = collection.get(book.getId());
+    if (book.getVersion() != latestBook.getVersion()) {
+      throw new VersionMismatchException(
+        "Tried to update stale version " + book.getVersion()
+          + " while actual version is " + latestBook.getVersion()
+      );
+    }
+
+    // update version, including client representation - modify by reference here
+    book.setVersion(book.getVersion() + 1);
+
+    // save book copy to repository
+    collection.put(book.getId(), new Book(book));
+  }
+
+  public Book get(long bookId) throws BookNotFoundException {
+    if (!collection.containsKey(bookId)) {
+      throw new BookNotFoundException("Not found book with id: " + bookId);
+    }
+
+    // return copy of the book
+    return new Book(collection.get(bookId));
+  }
+}
+```
+
+Here's the concurrency control in action:
+
+```java
+long bookId = 1;
+// Alice and Bob took the book concurrently
+final Book aliceBook = bookRepository.get(bookId);
+final Book bobBook = bookRepository.get(bookId);
+
+aliceBook.setTitle("Kama Sutra"); // Alice has updated book title
+bookRepository.update(aliceBook); // and successfully saved book in database
+LOGGER.info("Alice updates the book with new version {}", aliceBook.getVersion());
+
+// now Bob has the stale version of the book with empty title and version = 0
+// while actual book in database has filled title and version = 1
+bobBook.setAuthor("Vatsyayana Mallanaga"); // Bob updates the author
+try {
+  LOGGER.info("Bob tries to update the book with his version {}", bobBook.getVersion());
+  bookRepository.update(bobBook); // Bob tries to save his book to database
+} catch (VersionMismatchException e) {
+  // Bob update fails, and book in repository remained untouchable
+  LOGGER.info("Exception: {}", e.getMessage());
+  // Now Bob should reread actual book from repository, do his changes again and save again
+}
+```
+
+Program output:
+
+```java
+Alice updates the book with new version 1
+Bob tries to update the book with his version 0
+Exception: Tried to update stale version 0 while actual version is 1
+```
+
+## Class diagram
+
+![alt text](etc/version-number.urm.png "Version Number pattern class diagram")
+
+## Applicability
+
+Use Version Number for:
+
+* resolving concurrent write-access to the data
+* strong data consistency
+
+## Tutorials
+* [Version Number Pattern Tutorial](http://www.java2s.com/Tutorial/Java/0355__JPA/VersioningEntity.htm)
+
+## Known uses
+ * [Hibernate](https://vladmihalcea.com/jpa-entity-version-property-hibernate/)
+ * [Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#index-versioning)
+ * [Apache Solr](https://lucene.apache.org/solr/guide/6_6/updating-parts-of-documents.html)
+
+## Consequences
+Version Number pattern allows to implement a concurrency control, which is usually done
+via Optimistic Offline Lock pattern.
+
+## Related patterns
+* [Optimistic Offline Lock](https://martinfowler.com/eaaCatalog/optimisticOfflineLock.html)
+
+## Credits
+* [Optimistic Locking in JPA](https://www.baeldung.com/jpa-optimistic-locking)
+* [JPA entity versioning](https://www.byteslounge.com/tutorials/jpa-entity-versioning-version-and-optimistic-locking)
+* [J2EE Design Patterns](http://ommolketab.ir/aaf-lib/axkwht7wxrhvgs2aqkxse8hihyu9zv.pdf)
diff --git a/version-number/etc/version-number.urm.png b/version-number/etc/version-number.urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..95a5819b4b6e8b72335eef595efcfaf3413c5bb0
GIT binary patch
literal 22183
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

literal 0
HcmV?d00001

diff --git a/version-number/etc/version-number.urm.puml b/version-number/etc/version-number.urm.puml
new file mode 100644
index 000000000..6f3c3364e
--- /dev/null
+++ b/version-number/etc/version-number.urm.puml
@@ -0,0 +1,32 @@
+@startuml
+package com.iluwatar.versionnumber {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  class Book {
+    - author : String
+    - id : long
+    - title : String
+    - version : long
+    + Book()
+    + Book(book : Book)
+    + getAuthor() : String
+    + getId() : long
+    + getTitle() : String
+    + getVersion() : long
+    + setAuthor(author : String)
+    + setId(id : long)
+    + setTitle(title : String)
+    + setVersion(version : long)
+  }
+  class BookRepository {
+    - collection : Map<Long, Book>
+    + BookRepository()
+    + add(book : Book)
+    + get(bookId : long) : Book
+    + update(book : Book)
+  }
+}
+@enduml
\ No newline at end of file
diff --git a/version-number/pom.xml b/version-number/pom.xml
new file mode 100644
index 000000000..b5748c93b
--- /dev/null
+++ b/version-number/pom.xml
@@ -0,0 +1,66 @@
+<?xml version="1.0"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>version-number</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <executions>
+          <execution>
+            <configuration>
+              <archive>
+                <manifest>
+                  <mainClass>com.iluwatar.versionnumber.App</mainClass>
+                </manifest>
+              </archive>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/App.java b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
new file mode 100644
index 000000000..8049f1352
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
@@ -0,0 +1,84 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The Version Number pattern helps to resolve concurrency conflicts in applications.
+ * Usually these conflicts arise in database operations, when multiple clients are trying
+ * to update the same record simultaneously.
+ * Resolving such conflicts requires determining whether an object has changed.
+ * For this reason we need a version number that is incremented with each change
+ * to the underlying data, e.g. database. The version number can be used by repositories
+ * to check for external changes and to report concurrency issues to the users.
+ *
+ * <p>In this example we show how Alice and Bob will try to update the {@link Book}
+ * and save it simultaneously to {@link BookRepository}, which represents a typical database.
+ *
+ * <p>As in real databases, each client operates with copy of the data instead of original data
+ * passed by reference, that's why we are using {@link Book} copy-constructor here.
+ */
+public class App {
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line args
+   */
+  public static void main(String[] args) throws
+      BookDuplicateException,
+      BookNotFoundException,
+      VersionMismatchException {
+    long bookId = 1;
+
+    BookRepository bookRepository = new BookRepository();
+    Book book = new Book();
+    book.setId(bookId);
+    bookRepository.add(book); // adding a book with empty title and author
+    LOGGER.info("An empty book with version {} was added to repository", book.getVersion());
+
+    // Alice and Bob took the book concurrently
+    final Book aliceBook = bookRepository.get(bookId);
+    final Book bobBook = bookRepository.get(bookId);
+
+    aliceBook.setTitle("Kama Sutra"); // Alice has updated book title
+    bookRepository.update(aliceBook); // and successfully saved book in database
+    LOGGER.info("Alice updates the book with new version {}", aliceBook.getVersion());
+
+    // now Bob has the stale version of the book with empty title and version = 0
+    // while actual book in database has filled title and version = 1
+    bobBook.setAuthor("Vatsyayana Mallanaga"); // Bob updates the author
+    try {
+      LOGGER.info("Bob tries to update the book with his version {}", bobBook.getVersion());
+      bookRepository.update(bobBook); // Bob tries to save his book to database
+    } catch (VersionMismatchException e) {
+      // Bob update fails, and book in repository remained untouchable
+      LOGGER.info("Exception: {}", e.getMessage());
+      // Now Bob should reread actual book from repository, do his changes again and save again
+    }
+  }
+}
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/Book.java b/version-number/src/main/java/com/iluwatar/versionnumber/Book.java
new file mode 100644
index 000000000..93b35880b
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/Book.java
@@ -0,0 +1,78 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+public class Book {
+  private long id;
+  private String title = "";
+  private String author = "";
+
+  private long version = 0; // version number
+
+  public Book() {
+
+  }
+
+  /**
+   * We need this copy constructor to copy book representation in {@link BookRepository}.
+   */
+  public Book(Book book) {
+    this.id = book.id;
+    this.title = book.title;
+    this.author = book.author;
+    this.version = book.version;
+  }
+
+  public long getId() {
+    return id;
+  }
+
+  public void setId(long id) {
+    this.id = id;
+  }
+
+  public String getTitle() {
+    return title;
+  }
+
+  public void setTitle(String title) {
+    this.title = title;
+  }
+
+  public String getAuthor() {
+    return author;
+  }
+
+  public void setAuthor(String author) {
+    this.author = author;
+  }
+
+  public long getVersion() {
+    return version;
+  }
+
+  public void setVersion(long version) {
+    this.version = version;
+  }
+}
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
new file mode 100644
index 000000000..cd993b147
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
@@ -0,0 +1,33 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+/**
+ * When someone has tried to add a book which repository already have.
+ */
+public class BookDuplicateException extends Exception {
+  public BookDuplicateException(String message) {
+    super(message);
+  }
+}
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
new file mode 100644
index 000000000..f832f350f
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
@@ -0,0 +1,33 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+/**
+ * Client has tried to make an operation with book which repository does not have.
+ */
+public class BookNotFoundException extends Exception {
+  public BookNotFoundException(String message) {
+    super(message);
+  }
+}
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
new file mode 100644
index 000000000..a0f46c30f
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
@@ -0,0 +1,86 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * This repository represents simplified database.
+ * As a typical database do, repository operates with copies of object.
+ * So client and repo has different copies of book, which can lead to concurrency conflicts
+ * as much as in real databases.
+ */
+public class BookRepository {
+  private final Map<Long, Book> collection = new HashMap<>();
+
+  /**
+   * Adds book to collection.
+   * Actually we are putting copy of book (saving a book by value, not by reference);
+   */
+  public void add(Book book) throws BookDuplicateException {
+    if (collection.containsKey(book.getId())) {
+      throw new BookDuplicateException("Duplicated book with id: " + book.getId());
+    }
+
+    // add copy of the book
+    collection.put(book.getId(), new Book(book));
+  }
+
+  /**
+   * Updates book in collection only if client has modified the latest version of the book.
+   */
+  public void update(Book book) throws BookNotFoundException, VersionMismatchException {
+    if (!collection.containsKey(book.getId())) {
+      throw new BookNotFoundException("Not found book with id: " + book.getId());
+    }
+
+    Book latestBook = collection.get(book.getId());
+    if (book.getVersion() != latestBook.getVersion()) {
+      throw new VersionMismatchException(
+        "Tried to update stale version " + book.getVersion()
+          + " while actual version is " + latestBook.getVersion()
+      );
+    }
+
+    // update version, including client representation - modify by reference here
+    book.setVersion(book.getVersion() + 1);
+
+    // save book copy to repository
+    collection.put(book.getId(), new Book(book));
+  }
+
+  /**
+   * Returns book representation to the client.
+   * Representation means we are returning copy of the book.
+   */
+  public Book get(long bookId) throws BookNotFoundException {
+    if (!collection.containsKey(bookId)) {
+      throw new BookNotFoundException("Not found book with id: " + bookId);
+    }
+
+    // return copy of the book
+    return new Book(collection.get(bookId));
+  }
+}
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java b/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
new file mode 100644
index 000000000..94ea0fd9e
--- /dev/null
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
@@ -0,0 +1,33 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+/**
+ * Client has tried to update a stale version of the book.
+ */
+public class VersionMismatchException extends Exception {
+  public VersionMismatchException(String message) {
+    super(message);
+  }
+}
diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
new file mode 100644
index 000000000..7b4984901
--- /dev/null
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
@@ -0,0 +1,46 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+/**
+ * Application test
+ */
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
+  @Test
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
+}
diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
new file mode 100644
index 000000000..869bd4b44
--- /dev/null
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
@@ -0,0 +1,72 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.versionnumber;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * Tests for {@link BookRepository}
+ */
+class BookRepositoryTest {
+  @Test
+  void testBookRepository() throws BookDuplicateException, BookNotFoundException, VersionMismatchException {
+    final long bookId = 1;
+
+    BookRepository bookRepository = new BookRepository();
+    Book book = new Book();
+    book.setId(bookId);
+    bookRepository.add(book);
+
+    assertEquals(0, book.getVersion());
+
+    final Book aliceBook = bookRepository.get(bookId);
+    final Book bobBook = bookRepository.get(bookId);
+
+    assertEquals(aliceBook.getTitle(), bobBook.getTitle());
+    assertEquals(aliceBook.getAuthor(), bobBook.getAuthor());
+    assertEquals(aliceBook.getVersion(), bobBook.getVersion());
+
+    aliceBook.setTitle("Kama Sutra");
+    bookRepository.update(aliceBook);
+
+    assertEquals(1, aliceBook.getVersion());
+    assertEquals(0, bobBook.getVersion());
+    assertEquals(aliceBook.getVersion(), bookRepository.get(bookId).getVersion());
+    assertEquals(aliceBook.getTitle(), bookRepository.get(bookId).getTitle());
+    assertNotEquals(aliceBook.getTitle(), bobBook.getTitle());
+
+    bobBook.setAuthor("Vatsyayana Mallanaga");
+    try {
+      bookRepository.update(bobBook);
+    } catch (VersionMismatchException e) {
+      assertEquals(0, bobBook.getVersion());
+      assertEquals(1, bookRepository.get(bookId).getVersion());
+      assertEquals(aliceBook.getVersion(), bookRepository.get(bookId).getVersion());
+      assertEquals("", bobBook.getTitle());
+      assertNotEquals(aliceBook.getAuthor(), bobBook.getAuthor());
+    }
+  }
+}

From 911cfd64afcffb22af17d5b381fa4ac92a9f5aa8 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Fri, 16 Oct 2020 09:36:02 +0530
Subject: [PATCH 150/254] Update maven-pr-builder.yml

---
 .github/workflows/maven-pr-builder.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index f970c0ee5..a451f4c86 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -29,6 +29,7 @@ name: Java PR Builder
 on:
   pull_request:
     branches: [ master ]
+    types: [ opened, reopened, synchronize, labeled, unlabeled ]
 
 jobs:
   build:
@@ -36,20 +37,26 @@ jobs:
     runs-on: ubuntu-20.04
 
     steps:
-    - uses: actions/checkout@v2
+    - name: Checkout Code
+      uses: actions/checkout@v2
+    
     - name: Set up JDK 11
       uses: actions/setup-java@v1
       with:
         java-version: 11
-    - uses: actions/cache@v2
+    
+    - name: Cache Maven Dependecies
+      uses: actions/cache@v2
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
         restore-keys: |
           ${{ runner.os }}-maven-
+    
     # Some tests need screen access
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
+    
     # This worflow is only for building Pull Requests, the master branch runs Sonar analysis on the main repository.
     # SonarQube scan does not work for forked repositories.
     # See https://jira.sonarsource.com/browse/MMF-1371

From 38cc490e3f2cb309659a3f5bafa4b843f049cace Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 17 Oct 2020 10:14:49 +0530
Subject: [PATCH 151/254] update namespaces of different steps of build job

---
 .github/workflows/maven-ci.yml | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index f7bc81695..048a1bc80 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -39,7 +39,8 @@ jobs:
 
     steps:
 
-    - uses: actions/checkout@v2
+    - name: Checkout Code
+      uses: actions/checkout@v2
       with:
         # Disabling shallow clone for improving relevancy of SonarQube reporting
         fetch-depth: 0
@@ -56,7 +57,8 @@ jobs:
         key: ${{ runner.os }}-sonar
         restore-keys: ${{ runner.os }}-sonar
 
-    - uses: actions/cache@v2
+    - name: Cache Maven dependencies
+      uses: actions/cache@v2
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}

From 26b5364cbd0c4f2a2cdf54df0b0c74ef9394c9ac Mon Sep 17 00:00:00 2001
From: rrhodes <rrhodes@atb.com>
Date: Mon, 19 Oct 2020 10:39:45 -0600
Subject: [PATCH 152/254] issue 525: attach tutorialspoint link to iterator
 pattern

---
 iterator/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/iterator/README.md b/iterator/README.md
index 71ad807cd..c0e166b69 100644
--- a/iterator/README.md
+++ b/iterator/README.md
@@ -140,6 +140,10 @@ Use the Iterator pattern
 * To support multiple traversals of aggregate objects.
 * To provide a uniform interface for traversing different aggregate structures.
 
+## Tutorials
+
+* [How to Use Iterator?](http://www.tutorialspoint.com/java/java_using_iterator.htm)
+
 ## Real world examples
 
 * [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)

From ac432968ae9c6e1edb9cc85804cb106f6a38f3f5 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 07:47:41 +0000
Subject: [PATCH 153/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 00ebf5d28..56d8539fb 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-134-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-135-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -270,6 +270,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
     <td align="center"><a href="http://christophflick.de"><img src="https://avatars0.githubusercontent.com/u/4465376?v=4" width="100px;" alt=""/><br /><sub><b>Christoph Flick</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ChFlick" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/Ascenio"><img src="https://avatars1.githubusercontent.com/u/7662016?v=4" width="100px;" alt=""/><br /><sub><b>Ascênio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AAscenio" title="Reviewed Pull Requests">👀</a></td>
   </tr>
 </table>
 

From 2783251d00fb9d06fbce15a10440275eba6766c1 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 07:47:42 +0000
Subject: [PATCH 154/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index f39016a28..732c17ea4 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1222,6 +1222,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "Ascenio",
+      "name": "Ascênio",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/7662016?v=4",
+      "profile": "https://github.com/Ascenio",
+      "contributions": [
+        "review"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 6a09b909f21791b8be390984cc5e14afba85bcaf Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 12:33:10 +0000
Subject: [PATCH 155/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index d5d543851..346880be3 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-135-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-136-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -271,6 +271,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
     <td align="center"><a href="http://christophflick.de"><img src="https://avatars0.githubusercontent.com/u/4465376?v=4" width="100px;" alt=""/><br /><sub><b>Christoph Flick</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ChFlick" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/Ascenio"><img src="https://avatars1.githubusercontent.com/u/7662016?v=4" width="100px;" alt=""/><br /><sub><b>Ascênio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AAscenio" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/domenico-sibilio/"><img src="https://avatars2.githubusercontent.com/u/24280982?v=4" width="100px;" alt=""/><br /><sub><b>Domenico Sibilio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dsibilio" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From 80ba0407db74bbf3e61a1cf6c5eee3f7e99b95d3 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 12:33:11 +0000
Subject: [PATCH 156/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 732c17ea4..e407ec1ec 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1231,6 +1231,15 @@
       "contributions": [
         "review"
       ]
+    },
+    {
+      "login": "dsibilio",
+      "name": "Domenico Sibilio",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/24280982?v=4",
+      "profile": "https://www.linkedin.com/in/domenico-sibilio/",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 77b2ff2150684393eb057c5830fa0497e8dcf4c0 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 12:34:35 +0000
Subject: [PATCH 157/254] docs: update README.md [skip ci]

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 346880be3..e1e813d45 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-136-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-137-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -273,6 +273,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/Ascenio"><img src="https://avatars1.githubusercontent.com/u/7662016?v=4" width="100px;" alt=""/><br /><sub><b>Ascênio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AAscenio" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://www.linkedin.com/in/domenico-sibilio/"><img src="https://avatars2.githubusercontent.com/u/24280982?v=4" width="100px;" alt=""/><br /><sub><b>Domenico Sibilio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dsibilio" title="Documentation">📖</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From d42bcab9fc7144ccd8185132cd4181c8552a5c0e Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 7 Nov 2020 12:34:36 +0000
Subject: [PATCH 158/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index e407ec1ec..1130cb81b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1240,6 +1240,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "akashchandwani",
+      "name": "Akash Chandwani",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/3483277?v=4",
+      "profile": "https://github.com/akashchandwani",
+      "contributions": [
+        "review"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From dc319607109fa7d666f9375910c3d1bf1f28876b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 8 Nov 2020 19:37:15 +0200
Subject: [PATCH 159/254] Remove unused logger objects

---
 command/src/main/java/com/iluwatar/command/Goblin.java | 5 -----
 command/src/main/java/com/iluwatar/command/Wizard.java | 4 ----
 2 files changed, 9 deletions(-)

diff --git a/command/src/main/java/com/iluwatar/command/Goblin.java b/command/src/main/java/com/iluwatar/command/Goblin.java
index a2311dfd3..e430b65b5 100644
--- a/command/src/main/java/com/iluwatar/command/Goblin.java
+++ b/command/src/main/java/com/iluwatar/command/Goblin.java
@@ -23,16 +23,11 @@
 
 package com.iluwatar.command;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
 /**
  * Goblin is the target of the spells.
  */
 public class Goblin extends Target {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Goblin.class);
-
   public Goblin() {
     setSize(Size.NORMAL);
     setVisibility(Visibility.VISIBLE);
diff --git a/command/src/main/java/com/iluwatar/command/Wizard.java b/command/src/main/java/com/iluwatar/command/Wizard.java
index b4568eebf..f63831c07 100644
--- a/command/src/main/java/com/iluwatar/command/Wizard.java
+++ b/command/src/main/java/com/iluwatar/command/Wizard.java
@@ -25,16 +25,12 @@ package com.iluwatar.command;
 
 import java.util.Deque;
 import java.util.LinkedList;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Wizard is the invoker of the commands.
  */
 public class Wizard {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class);
-
   private final Deque<Runnable> undoStack = new LinkedList<>();
   private final Deque<Runnable> redoStack = new LinkedList<>();
 

From 7eee54620846df6055ec40e5981c0c2b7c701377 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 8 Nov 2020 19:39:21 +0200
Subject: [PATCH 160/254] Update README.md

---
 command/README.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/command/README.md b/command/README.md
index 87dd48824..08783679b 100644
--- a/command/README.md
+++ b/command/README.md
@@ -41,8 +41,6 @@ Here's the sample code with wizard and goblin. Let's start from the `Wizard` cla
 ```java
 public class Wizard {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class);
-
   private final Deque<Command> undoStack = new LinkedList<>();
   private final Deque<Command> redoStack = new LinkedList<>();
 

From 43ed09015d5b78215cb4e0ef29042e7b14053581 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 22 Nov 2020 21:14:53 +0200
Subject: [PATCH 161/254] Add missing license header

---
 .../RemoteServiceException.java               | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
index f384f5a41..b34f0b3fe 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.circuitbreaker;
 
 /**

From 97e3a3debcb6f09ed5738e8cca94234a68e9c56c Mon Sep 17 00:00:00 2001
From: Pavel Manannikov <pavel.manannikov@murka.com>
Date: Mon, 23 Nov 2020 19:42:50 +0200
Subject: [PATCH 162/254] #1284 Use local variable inference

---
 version-number/README.md                               |  8 ++++----
 .../src/main/java/com/iluwatar/versionnumber/App.java  | 10 +++++-----
 .../com/iluwatar/versionnumber/BookRepository.java     |  2 +-
 .../com/iluwatar/versionnumber/BookRepositoryTest.java | 10 +++++-----
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/version-number/README.md b/version-number/README.md
index f95b1bcc7..9a7468a85 100644
--- a/version-number/README.md
+++ b/version-number/README.md
@@ -78,7 +78,7 @@ public class BookRepository {
       throw new BookNotFoundException("Not found book with id: " + book.getId());
     }
 
-    Book latestBook = collection.get(book.getId());
+    var latestBook = collection.get(book.getId());
     if (book.getVersion() != latestBook.getVersion()) {
       throw new VersionMismatchException(
         "Tried to update stale version " + book.getVersion()
@@ -107,10 +107,10 @@ public class BookRepository {
 Here's the concurrency control in action:
 
 ```java
-long bookId = 1;
+var bookId = 1;
 // Alice and Bob took the book concurrently
-final Book aliceBook = bookRepository.get(bookId);
-final Book bobBook = bookRepository.get(bookId);
+final var aliceBook = bookRepository.get(bookId);
+final var bobBook = bookRepository.get(bookId);
 
 aliceBook.setTitle("Kama Sutra"); // Alice has updated book title
 bookRepository.update(aliceBook); // and successfully saved book in database
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/App.java b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
index 8049f1352..cffba50d4 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/App.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
@@ -53,17 +53,17 @@ public class App {
       BookDuplicateException,
       BookNotFoundException,
       VersionMismatchException {
-    long bookId = 1;
+    var bookId = 1;
 
-    BookRepository bookRepository = new BookRepository();
-    Book book = new Book();
+    var bookRepository = new BookRepository();
+    var book = new Book();
     book.setId(bookId);
     bookRepository.add(book); // adding a book with empty title and author
     LOGGER.info("An empty book with version {} was added to repository", book.getVersion());
 
     // Alice and Bob took the book concurrently
-    final Book aliceBook = bookRepository.get(bookId);
-    final Book bobBook = bookRepository.get(bookId);
+    final var aliceBook = bookRepository.get(bookId);
+    final var bobBook = bookRepository.get(bookId);
 
     aliceBook.setTitle("Kama Sutra"); // Alice has updated book title
     bookRepository.update(aliceBook); // and successfully saved book in database
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
index a0f46c30f..ef41e79ac 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
@@ -56,7 +56,7 @@ public class BookRepository {
       throw new BookNotFoundException("Not found book with id: " + book.getId());
     }
 
-    Book latestBook = collection.get(book.getId());
+    var latestBook = collection.get(book.getId());
     if (book.getVersion() != latestBook.getVersion()) {
       throw new VersionMismatchException(
         "Tried to update stale version " + book.getVersion()
diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
index 869bd4b44..325dea87b 100644
--- a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
@@ -33,17 +33,17 @@ import static org.junit.jupiter.api.Assertions.*;
 class BookRepositoryTest {
   @Test
   void testBookRepository() throws BookDuplicateException, BookNotFoundException, VersionMismatchException {
-    final long bookId = 1;
+    final var bookId = 1;
 
-    BookRepository bookRepository = new BookRepository();
-    Book book = new Book();
+    var bookRepository = new BookRepository();
+    var book = new Book();
     book.setId(bookId);
     bookRepository.add(book);
 
     assertEquals(0, book.getVersion());
 
-    final Book aliceBook = bookRepository.get(bookId);
-    final Book bobBook = bookRepository.get(bookId);
+    final var aliceBook = bookRepository.get(bookId);
+    final var bobBook = bookRepository.get(bookId);
 
     assertEquals(aliceBook.getTitle(), bobBook.getTitle());
     assertEquals(aliceBook.getAuthor(), bobBook.getAuthor());

From 9ead3adf735d654d8f81081335d117487692eda7 Mon Sep 17 00:00:00 2001
From: Pavel Manannikov <pavel.manannikov@murka.com>
Date: Mon, 23 Nov 2020 20:59:00 +0200
Subject: [PATCH 163/254] #1284 Divide tests

---
 .../versionnumber/BookRepositoryTest.java     | 39 +++++++++++++------
 1 file changed, 27 insertions(+), 12 deletions(-)

diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
index 325dea87b..6b7b2b39a 100644
--- a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
@@ -23,6 +23,7 @@
 
 package com.iluwatar.versionnumber;
 
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.*;
@@ -31,40 +32,54 @@ import static org.junit.jupiter.api.Assertions.*;
  * Tests for {@link BookRepository}
  */
 class BookRepositoryTest {
-  @Test
-  void testBookRepository() throws BookDuplicateException, BookNotFoundException, VersionMismatchException {
-    final var bookId = 1;
+  private final long bookId = 1;
+  private final BookRepository bookRepository = new BookRepository();
 
-    var bookRepository = new BookRepository();
+  @BeforeEach
+  public void setUp() throws BookDuplicateException {
     var book = new Book();
     book.setId(bookId);
     bookRepository.add(book);
+  }
 
+  @Test
+  void testDefaultVersionRemainsZeroAfterAdd() throws BookNotFoundException {
+    var book = bookRepository.get(bookId);
     assertEquals(0, book.getVersion());
+  }
 
+  @Test
+  void testAliceAndBobHaveDifferentVersionsAfterAliceUpdate() throws BookNotFoundException, VersionMismatchException {
     final var aliceBook = bookRepository.get(bookId);
     final var bobBook = bookRepository.get(bookId);
 
-    assertEquals(aliceBook.getTitle(), bobBook.getTitle());
-    assertEquals(aliceBook.getAuthor(), bobBook.getAuthor());
-    assertEquals(aliceBook.getVersion(), bobBook.getVersion());
-
     aliceBook.setTitle("Kama Sutra");
     bookRepository.update(aliceBook);
 
     assertEquals(1, aliceBook.getVersion());
     assertEquals(0, bobBook.getVersion());
-    assertEquals(aliceBook.getVersion(), bookRepository.get(bookId).getVersion());
-    assertEquals(aliceBook.getTitle(), bookRepository.get(bookId).getTitle());
+    var actualBook = bookRepository.get(bookId);
+    assertEquals(aliceBook.getVersion(), actualBook.getVersion());
+    assertEquals(aliceBook.getTitle(), actualBook.getTitle());
     assertNotEquals(aliceBook.getTitle(), bobBook.getTitle());
+  }
+
+  @Test
+  void testShouldThrowVersionMismatchExceptionOnStaleUpdate() throws BookNotFoundException, VersionMismatchException {
+    final var aliceBook = bookRepository.get(bookId);
+    final var bobBook = bookRepository.get(bookId);
+
+    aliceBook.setTitle("Kama Sutra");
+    bookRepository.update(aliceBook);
 
     bobBook.setAuthor("Vatsyayana Mallanaga");
     try {
       bookRepository.update(bobBook);
     } catch (VersionMismatchException e) {
       assertEquals(0, bobBook.getVersion());
-      assertEquals(1, bookRepository.get(bookId).getVersion());
-      assertEquals(aliceBook.getVersion(), bookRepository.get(bookId).getVersion());
+      var actualBook = bookRepository.get(bookId);
+      assertEquals(1, actualBook.getVersion());
+      assertEquals(aliceBook.getVersion(), actualBook.getVersion());
       assertEquals("", bobBook.getTitle());
       assertNotEquals(aliceBook.getAuthor(), bobBook.getAuthor());
     }

From 4c7f1b7822d581c899a1fcaf512be2e303e12d45 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 23 Nov 2020 20:37:48 +0000
Subject: [PATCH 164/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e1e813d45..cebbf838d 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-137-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-138-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -275,6 +275,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="http://www.linkedin.com/in/manannikov"><img src="https://avatars2.githubusercontent.com/u/7019769?v=4" width="100px;" alt=""/><br /><sub><b>Pavlo Manannikov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=manannikov" title="Code">💻</a></td>
   </tr>
 </table>
 

From 6c95868b8de922d65005d01ce8bfa26f4e96c739 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 23 Nov 2020 20:37:49 +0000
Subject: [PATCH 165/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 1130cb81b..b76dfca20 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1249,6 +1249,15 @@
       "contributions": [
         "review"
       ]
+    },
+    {
+      "login": "manannikov",
+      "name": "Pavlo Manannikov",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/7019769?v=4",
+      "profile": "http://www.linkedin.com/in/manannikov",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 6f979d0cb2a461a75aee1ed202c7d0f68d67a4bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Tue, 24 Nov 2020 08:10:34 +0200
Subject: [PATCH 166/254] Fix version number class diagram not showing

---
 version-number/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/version-number/README.md b/version-number/README.md
index 9a7468a85..cc0cf7601 100644
--- a/version-number/README.md
+++ b/version-number/README.md
@@ -139,7 +139,7 @@ Exception: Tried to update stale version 0 while actual version is 1
 
 ## Class diagram
 
-![alt text](etc/version-number.urm.png "Version Number pattern class diagram")
+![alt text](./etc/version-number.urm.png "Version Number pattern class diagram")
 
 ## Applicability
 

From 13c6de036fe6ac991aa558d162016ada078a4bf4 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 28 Nov 2020 12:24:57 +0000
Subject: [PATCH 167/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index cebbf838d..acbd0bf80 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-138-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-139-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -276,6 +276,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="http://www.linkedin.com/in/manannikov"><img src="https://avatars2.githubusercontent.com/u/7019769?v=4" width="100px;" alt=""/><br /><sub><b>Pavlo Manannikov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=manannikov" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/eimanip"><img src="https://avatars0.githubusercontent.com/u/20307301?v=4" width="100px;" alt=""/><br /><sub><b>Eiman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=eimanip" title="Code">💻</a></td>
   </tr>
 </table>
 

From 4b18e223cd481423e288e52d460e98ab45ba2a1c Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 28 Nov 2020 12:24:58 +0000
Subject: [PATCH 168/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index b76dfca20..4fbe28dca 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1258,6 +1258,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "eimanip",
+      "name": "Eiman",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/20307301?v=4",
+      "profile": "https://github.com/eimanip",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From dd599595ccf17f1fd2b200d81f86e343409c0325 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 28 Nov 2020 13:04:25 +0000
Subject: [PATCH 169/254] docs: update README.md [skip ci]

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 733bb5afb..f67e40b8b 100644
--- a/README.md
+++ b/README.md
@@ -222,7 +222,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="http://vk.com/yuri.orlov"><img src="https://avatars0.githubusercontent.com/u/1595733?v=4" width="100px;" alt=""/><br /><sub><b>Yuri Orlov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yorlov" title="Code">💻</a></td>
     <td align="center"><a href="https://www.linkedin.com/in/varunu28/"><img src="https://avatars0.githubusercontent.com/u/7676016?v=4" width="100px;" alt=""/><br /><sub><b>Varun Upadhyay</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=varunu28" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/PalAditya"><img src="https://avatars2.githubusercontent.com/u/25523604?v=4" width="100px;" alt=""/><br /><sub><b>Aditya Pal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=PalAditya" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4" width="100px;" alt=""/><br /><sub><b>grzesiekkedzior</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=grzesiekkedzior" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4" width="100px;" alt=""/><br /><sub><b>grzesiekkedzior</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=grzesiekkedzior" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Agrzesiekkedzior" title="Reviewed Pull Requests">👀</a></td>
   </tr>
 </table>
 

From 96fadf3bd775f3fbc930b6416ab20391d7eb91d3 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 28 Nov 2020 13:04:26 +0000
Subject: [PATCH 170/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index c7a0d5b48..03d451d9a 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -945,7 +945,8 @@
       "avatar_url": "https://avatars3.githubusercontent.com/u/23739158?v=4",
       "profile": "https://github.com/grzesiekkedzior",
       "contributions": [
-        "code"
+        "code",
+        "review"
       ]
     }
   ],

From 7931471b995d4d47e23783738b0d88ab6ea07d48 Mon Sep 17 00:00:00 2001
From: Girish Kulkarni <gintellect@gmail.com>
Date: Mon, 30 Nov 2020 15:26:01 +0530
Subject: [PATCH 171/254] Word mistake in factory/README.md #1601

---
 factory/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/factory/README.md b/factory/README.md
index a1b6208fd..0112c92c0 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -81,7 +81,7 @@ public enum CarType {
 }
 ```
 Then we have the static method `getCar` to create car objects encapsulated in the factory class 
-`CarSimpleFactory`.
+`CarsFactory`.
 
 ```java
 public class CarsFactory {

From 90c6cf94d58137e0cf979b3aa90cfbc4d7fb7708 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 30 Nov 2020 14:56:59 +0000
Subject: [PATCH 172/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4211060c5..192b5f03c 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-104-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-140-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -277,6 +277,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="http://www.linkedin.com/in/manannikov"><img src="https://avatars2.githubusercontent.com/u/7019769?v=4" width="100px;" alt=""/><br /><sub><b>Pavlo Manannikov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=manannikov" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/eimanip"><img src="https://avatars0.githubusercontent.com/u/20307301?v=4" width="100px;" alt=""/><br /><sub><b>Eiman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=eimanip" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/OrangePants-R"><img src="https://avatars0.githubusercontent.com/u/42976136?v=4" width="100px;" alt=""/><br /><sub><b>Rocky</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=OrangePants-R" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From ced7a9deb011980c5b0f7f9289434188a2704aaa Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 30 Nov 2020 14:57:00 +0000
Subject: [PATCH 173/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 6c2bbadbc..a8b7dc895 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1268,6 +1268,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "OrangePants-R",
+      "name": "Rocky",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/42976136?v=4",
+      "profile": "https://github.com/OrangePants-R",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From e185c497ac64f632b25c4969867082572de8034f Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 1 Dec 2020 20:47:32 +0000
Subject: [PATCH 174/254] docs: update README.md [skip ci]

---
 README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 192b5f03c..46387b058 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-140-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-141-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -279,6 +279,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/eimanip"><img src="https://avatars0.githubusercontent.com/u/20307301?v=4" width="100px;" alt=""/><br /><sub><b>Eiman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=eimanip" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/OrangePants-R"><img src="https://avatars0.githubusercontent.com/u/42976136?v=4" width="100px;" alt=""/><br /><sub><b>Rocky</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=OrangePants-R" title="Documentation">📖</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From 1edfb446424338e89d7cc627d4dbcd7d98c150d3 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 1 Dec 2020 20:47:33 +0000
Subject: [PATCH 175/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index a8b7dc895..3e0200276 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1277,6 +1277,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "ibrahimAlii",
+      "name": "Ibrahim ali abdelghany",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/21141301?v=4",
+      "profile": "https://ibrahimalii.github.io/",
+      "contributions": [
+        "review"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 8b15c247538cf498478d90cd99b1d88fcd88a377 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 4 Dec 2020 13:47:57 +0000
Subject: [PATCH 176/254] docs: update README.md [skip ci]

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 46387b058..84c94640a 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-141-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-142-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -281,6 +281,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/gkulkarni2020"><img src="https://avatars3.githubusercontent.com/u/5161548?v=4" width="100px;" alt=""/><br /><sub><b>Girish Kulkarni</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gkulkarni2020" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From ecd1a5d07fd604b8ac55fad50ea2d6ff3443c0cd Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Fri, 4 Dec 2020 13:47:58 +0000
Subject: [PATCH 177/254] docs: update .all-contributorsrc [skip ci]

---
 .all-contributorsrc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 3e0200276..709e8ffe6 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1286,6 +1286,15 @@
       "contributions": [
         "review"
       ]
+    },
+    {
+      "login": "gkulkarni2020",
+      "name": "Girish Kulkarni",
+      "avatar_url": "https://avatars3.githubusercontent.com/u/5161548?v=4",
+      "profile": "https://github.com/gkulkarni2020",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,

From 1e10951c23845b4a0d8e628fce940c482d32966c Mon Sep 17 00:00:00 2001
From: Mike Liu <657829312@qq.com>
Date: Sat, 5 Dec 2020 02:03:14 +0800
Subject: [PATCH 178/254] Translation zh (#1597)

* add state and callback pattern

* add command and template-method pattern

* add iterator pattern

Co-authored-by: Mike <admin@xiaod.info>
---
 zh/callback/README.md        |  79 +++++++++++
 zh/command/README.md         | 253 +++++++++++++++++++++++++++++++++++
 zh/iterator/README.md        | 134 +++++++++++++++++++
 zh/state/README.md           | 155 +++++++++++++++++++++
 zh/template-method/README.md | 145 ++++++++++++++++++++
 5 files changed, 766 insertions(+)
 create mode 100644 zh/callback/README.md
 create mode 100644 zh/command/README.md
 create mode 100644 zh/iterator/README.md
 create mode 100644 zh/state/README.md
 create mode 100644 zh/template-method/README.md

diff --git a/zh/callback/README.md b/zh/callback/README.md
new file mode 100644
index 000000000..a70a6a7c2
--- /dev/null
+++ b/zh/callback/README.md
@@ -0,0 +1,79 @@
+---
+layout: pattern
+title: Callback
+folder: callback
+permalink: /patterns/callback/
+categories: Idiom
+tags:
+ - Reactive
+---
+
+## 目的
+回调是一部分被当为参数来传递给其他代码的可执行代码，接收方的代码可以在一些方便的时候来调用它。
+
+## 解释
+
+真实世界例子
+
+> 我们需要被通知当执行的任务结束时。我们为调用者传递一个回调方法然后等它调用通知我们。
+
+通俗的讲
+
+
+> 回调是一个用来传递给调用者的方法，它将在定义的时刻被调用。 
+
+维基百科说
+
+> 在计算机编程中，回调又被称为“稍后调用”函数，可以是任何可执行的代码用来作为参数传递给其他代码；其它代码被期望在给定时间内调用回调方法。
+
+**编程示例**
+
+回调是一个只有一个方法的简单接口。
+
+```java
+public interface Callback {
+
+  void call();
+}
+```
+
+下面我们定义一个任务它将在任务执行完成后执行回调。
+
+```java
+public abstract class Task {
+
+  final void executeWith(Callback callback) {
+    execute();
+    Optional.ofNullable(callback).ifPresent(Callback::call);
+  }
+
+  public abstract void execute();
+}
+
+public final class SimpleTask extends Task {
+
+  private static final Logger LOGGER = getLogger(SimpleTask.class);
+
+  @Override
+  public void execute() {
+    LOGGER.info("Perform some important activity and after call the callback method.");
+  }
+}
+```
+
+最后这里是我们如何执行一个任务然后接收一个回调当它完成时。
+
+```java
+    var task = new SimpleTask();
+    task.executeWith(() -> LOGGER.info("I'm done now."));
+```
+## 类图
+![alt text](../../callback/etc/callback.png "Callback")
+
+## 适用性
+使用回调模式当
+* 当一些同步或异步架构动作必须在一些定义好的活动执行后执行时。
+
+## Java例子
+
+* [CyclicBarrier](http://docs.oracle.com/javase/7/docs/api/java/util/concurrent/CyclicBarrier.html#CyclicBarrier%28int,%20java.lang.Runnable%29) 构造函数可以接受回调，该回调将在每次障碍被触发时触发。
diff --git a/zh/command/README.md b/zh/command/README.md
new file mode 100644
index 000000000..2c4f03a25
--- /dev/null
+++ b/zh/command/README.md
@@ -0,0 +1,253 @@
+---
+layout: pattern
+title: Command
+folder: command
+permalink: /patterns/command/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 或称
+行动, 事务模式
+
+## 目的
+将请求封装为对象，从而使你可以将具有不同请求的客户端参数化，队列或记录请求，并且支持可撤销操作。
+
+## 解释
+真实世界例子
+
+> 有一个巫师在地精上施放咒语。咒语在地精上一一执行。第一个咒语使地精缩小，第二个使他不可见。然后巫师将咒语一个个的反转。这里的每一个咒语都是一个可撤销的命令对象。
+
+用通俗的话说
+
+> 用命令对象的方式存储请求以在将来时可以执行它或撤销它。
+
+维基百科说
+
+> 在面向对象编程中，命令模式是一种行为型设计模式，它把在稍后执行的一个动作或触发的一个事件所需要的所有信息封装到一个对象中。
+
+**编程示例**
+
+这是巫师和地精的示例代码。让我们从巫师类开始。
+
+```java
+public class Wizard {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class);
+
+  private final Deque<Command> undoStack = new LinkedList<>();
+  private final Deque<Command> redoStack = new LinkedList<>();
+
+  public Wizard() {}
+
+  public void castSpell(Command command, Target target) {
+    LOGGER.info("{} casts {} at {}", this, command, target);
+    command.execute(target);
+    undoStack.offerLast(command);
+  }
+
+  public void undoLastSpell() {
+    if (!undoStack.isEmpty()) {
+      var previousSpell = undoStack.pollLast();
+      redoStack.offerLast(previousSpell);
+      LOGGER.info("{} undoes {}", this, previousSpell);
+      previousSpell.undo();
+    }
+  }
+
+  public void redoLastSpell() {
+    if (!redoStack.isEmpty()) {
+      var previousSpell = redoStack.pollLast();
+      undoStack.offerLast(previousSpell);
+      LOGGER.info("{} redoes {}", this, previousSpell);
+      previousSpell.redo();
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "Wizard";
+  }
+}
+```
+
+接下来我们介绍咒语层级
+
+```java
+public interface Command {
+
+  void execute(Target target);
+
+  void undo();
+
+  void redo();
+
+  String toString();
+}
+
+public class InvisibilitySpell implements Command {
+
+  private Target target;
+
+  @Override
+  public void execute(Target target) {
+    target.setVisibility(Visibility.INVISIBLE);
+    this.target = target;
+  }
+
+  @Override
+  public void undo() {
+    if (target != null) {
+      target.setVisibility(Visibility.VISIBLE);
+    }
+  }
+
+  @Override
+  public void redo() {
+    if (target != null) {
+      target.setVisibility(Visibility.INVISIBLE);
+    }
+  }
+
+  @Override
+  public String toString() {
+    return "Invisibility spell";
+  }
+}
+
+public class ShrinkSpell implements Command {
+
+  private Size oldSize;
+  private Target target;
+
+  @Override
+  public void execute(Target target) {
+    oldSize = target.getSize();
+    target.setSize(Size.SMALL);
+    this.target = target;
+  }
+
+  @Override
+  public void undo() {
+    if (oldSize != null && target != null) {
+      var temp = target.getSize();
+      target.setSize(oldSize);
+      oldSize = temp;
+    }
+  }
+
+  @Override
+  public void redo() {
+    undo();
+  }
+
+  @Override
+  public String toString() {
+    return "Shrink spell";
+  }
+}
+```
+
+最后我们有咒语的目标地精。
+
+```java
+public abstract class Target {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Target.class);
+
+  private Size size;
+
+  private Visibility visibility;
+
+  public Size getSize() {
+    return size;
+  }
+
+  public void setSize(Size size) {
+    this.size = size;
+  }
+
+  public Visibility getVisibility() {
+    return visibility;
+  }
+
+  public void setVisibility(Visibility visibility) {
+    this.visibility = visibility;
+  }
+
+  @Override
+  public abstract String toString();
+
+  public void printStatus() {
+    LOGGER.info("{}, [size={}] [visibility={}]", this, getSize(), getVisibility());
+  }
+}
+
+public class Goblin extends Target {
+
+  public Goblin() {
+    setSize(Size.NORMAL);
+    setVisibility(Visibility.VISIBLE);
+  }
+
+  @Override
+  public String toString() {
+    return "Goblin";
+  }
+
+}
+```
+
+最后是整个示例的实践。
+
+```java
+var wizard = new Wizard();
+var goblin = new Goblin();
+goblin.printStatus();
+// Goblin, [size=normal] [visibility=visible]
+wizard.castSpell(new ShrinkSpell(), goblin);
+// Wizard casts Shrink spell at Goblin
+goblin.printStatus();
+// Goblin, [size=small] [visibility=visible]
+wizard.castSpell(new InvisibilitySpell(), goblin);
+// Wizard casts Invisibility spell at Goblin
+goblin.printStatus();
+// Goblin, [size=small] [visibility=invisible]
+wizard.undoLastSpell();
+// Wizard undoes Invisibility spell
+goblin.printStatus();
+// Goblin, [size=small] [visibility=visible]
+```
+
+## 类图
+![alt text](../../command/etc/command.png "Command")
+
+## 适用性
+使用命令模式当你想
+
+* 通过操作将对象参数化。您可以使用回调函数（即，已在某处注册以便稍后调用的函数）以过程语言表示这种参数化。命令是回调的一种面向对象替代方案。
+* 在不同的时间指定，排队和执行请求。一个命令对象的生存期可以独立于原始请求。如果请求的接收方可以以地址空间无关的方式来表示，那么你可以将请求的命令对象传输到其他进程并在那里执行请求。
+* 支持撤销。命令的执行操作可以在命令本身中存储状态以反转其效果。命令接口必须有添加的反执行操作，该操作可以逆转上一次执行调用的效果。执行的命令存储在历史列表中。无限撤消和重做通过分别向后和向前遍历此列表来实现，分别调用unexecute和execute。
+* 支持日志记录更改，以便在系统崩溃时可以重新应用它们。通过使用加载和存储操作扩展命令接口，你可以保留更改的永久日志。从崩溃中恢复涉及从磁盘重新加载记录的命令，并通过执行操作重新执行它们。
+* 通过原始的操作来构建一个以高级操作围绕的系统。这种结构在支持事务的信息系统中很常见。事务封装了一组数据更改。命令模式提供了一种对事务进行建模的方法。命令具有公共接口，让你以相同的方式调用所有事务。该模式还可以通过新的事务来轻松扩展系统。
+
+## 典型用例
+
+* 保留请求历史
+* 实现回调功能
+* 实现撤销功能
+
+## Java世界例子
+
+* [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html)
+* [org.junit.runners.model.Statement](https://github.com/junit-team/junit4/blob/master/src/main/java/org/junit/runners/model/Statement.java)
+* [Netflix Hystrix](https://github.com/Netflix/Hystrix/wiki)
+* [javax.swing.Action](http://docs.oracle.com/javase/8/docs/api/javax/swing/Action.html)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94)
diff --git a/zh/iterator/README.md b/zh/iterator/README.md
new file mode 100644
index 000000000..0b9db9e43
--- /dev/null
+++ b/zh/iterator/README.md
@@ -0,0 +1,134 @@
+---
+layout: pattern
+title: Iterator
+folder: iterator
+permalink: /patterns/iterator/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 又被称为
+游标
+
+## 目的
+提供一种在不暴露其基础表示的情况下顺序访问聚合对象的元素的方法。
+
+## 解释
+
+真实世界例子
+
+> 百宝箱包含一组魔法物品。有多种物品，例如戒指，药水和武器。可以使用藏宝箱提供的迭代器按类型浏览商品。
+
+通俗地说
+
+> 容器可以提供与表示形式无关的迭代器接口，以提供对元素的访问。
+
+维基百科说
+
+> 在面向对象的编程中，迭代器模式是一种设计模式，其中迭代器用于遍历容器并访问容器的元素。
+
+**程序示例**
+
+在我们的示例中包含物品的藏宝箱是主要类。
+
+```java
+public class TreasureChest {
+
+  private final List<Item> items;
+
+  public TreasureChest() {
+    items = List.of(
+        new Item(ItemType.POTION, "Potion of courage"),
+        new Item(ItemType.RING, "Ring of shadows"),
+        new Item(ItemType.POTION, "Potion of wisdom"),
+        new Item(ItemType.POTION, "Potion of blood"),
+        new Item(ItemType.WEAPON, "Sword of silver +1"),
+        new Item(ItemType.POTION, "Potion of rust"),
+        new Item(ItemType.POTION, "Potion of healing"),
+        new Item(ItemType.RING, "Ring of armor"),
+        new Item(ItemType.WEAPON, "Steel halberd"),
+        new Item(ItemType.WEAPON, "Dagger of poison"));
+  }
+
+  public Iterator<Item> iterator(ItemType itemType) {
+    return new TreasureChestItemIterator(this, itemType);
+  }
+
+  public List<Item> getItems() {
+    return new ArrayList<>(items);
+  }
+}
+
+public class Item {
+
+  private ItemType type;
+  private final String name;
+
+  public Item(ItemType type, String name) {
+    this.setType(type);
+    this.name = name;
+  }
+
+  @Override
+  public String toString() {
+    return name;
+  }
+
+  public ItemType getType() {
+    return type;
+  }
+
+  public final void setType(ItemType type) {
+    this.type = type;
+  }
+}
+
+public enum ItemType {
+
+  ANY, WEAPON, RING, POTION
+
+}
+```
+
+迭代器接口极度简单。
+
+```java
+public interface Iterator<T> {
+
+  boolean hasNext();
+
+  T next();
+}
+```
+
+在以下示例中，我们遍历在宝箱中找到的戒指类型物品。
+
+```java
+var itemIterator = TREASURE_CHEST.iterator(ItemType.RING);
+while (itemIterator.hasNext()) {
+  LOGGER.info(itemIterator.next().toString());
+}
+// Ring of shadows
+// Ring of armor
+```
+
+## 类图
+![alt text](../../iterator/etc/iterator_1.png "Iterator")
+
+## 适用性
+以下情况使用迭代器模式
+
+* 在不暴露其内部表示的情况下访问聚合对象的内容
+* 为了支持聚合对象的多种遍历方式
+* 提供一个遍历不同聚合结构的统一接口
+
+## Java世界例子
+
+* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)
+* [java.util.Enumeration](http://docs.oracle.com/javase/8/docs/api/java/util/Enumeration.html)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
diff --git a/zh/state/README.md b/zh/state/README.md
new file mode 100644
index 000000000..6b46510e0
--- /dev/null
+++ b/zh/state/README.md
@@ -0,0 +1,155 @@
+---
+layout: pattern
+title: State
+folder: state
+permalink: /patterns/state/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 又被称为
+对象状态
+
+## 目的
+允许对象在内部状态改变时改变它的行为。对象看起来好像修改了它的类。
+
+## 解释
+真实世界例子
+
+> 当在长毛象的自然栖息地观察长毛象时，似乎它会根据情况来改变自己的行为。它开始可能很平静但是随着时间推移当它检测到威胁时它会对周围的环境感到愤怒和危险。
+
+通俗的说
+
+> 状态模式允许对象改变它的行为。
+
+维基百科说
+
+> 状态模式是一种允许对象在内部状态改变时改变它的行为的行为型设计模式。这种模式接近于有限状态机的概念。状态模式可以被理解为策略模式，它能够通过调用在模式接口中定义的方法来切换策略。
+
+**编程示例**
+
+这里是模式接口和它具体的实现。
+
+```java
+public interface State {
+
+  void onEnterState();
+
+  void observe();
+}
+
+public class PeacefulState implements State {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(PeacefulState.class);
+
+  private final Mammoth mammoth;
+
+  public PeacefulState(Mammoth mammoth) {
+    this.mammoth = mammoth;
+  }
+
+  @Override
+  public void observe() {
+    LOGGER.info("{} is calm and peaceful.", mammoth);
+  }
+
+  @Override
+  public void onEnterState() {
+    LOGGER.info("{} calms down.", mammoth);
+  }
+}
+
+public class AngryState implements State {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(AngryState.class);
+
+  private final Mammoth mammoth;
+
+  public AngryState(Mammoth mammoth) {
+    this.mammoth = mammoth;
+  }
+
+  @Override
+  public void observe() {
+    LOGGER.info("{} is furious!", mammoth);
+  }
+
+  @Override
+  public void onEnterState() {
+    LOGGER.info("{} gets angry!", mammoth);
+  }
+}
+```
+
+然后这里是包含状态的长毛象。
+
+```java
+public class Mammoth {
+
+  private State state;
+
+  public Mammoth() {
+    state = new PeacefulState(this);
+  }
+
+  public void timePasses() {
+    if (state.getClass().equals(PeacefulState.class)) {
+      changeStateTo(new AngryState(this));
+    } else {
+      changeStateTo(new PeacefulState(this));
+    }
+  }
+
+  private void changeStateTo(State newState) {
+    this.state = newState;
+    this.state.onEnterState();
+  }
+
+  @Override
+  public String toString() {
+    return "The mammoth";
+  }
+
+  public void observe() {
+    this.state.observe();
+  }
+}
+```
+
+然后这里是长毛象随着时间的推移后的整个行为示例。
+
+```java
+    var mammoth = new Mammoth();
+    mammoth.observe();
+    mammoth.timePasses();
+    mammoth.observe();
+    mammoth.timePasses();
+    mammoth.observe();
+    
+    // The mammoth gets angry!
+    // The mammoth is furious!
+    // The mammoth calms down.
+    // The mammoth is calm and peaceful.
+```
+
+## 类图
+![alt text](../../state/etc/state_1.png "State")
+
+## 适用性
+
+在以下两种情况下，请使用State模式
+
+* 对象的行为取决于它的状态，并且它必须在运行时根据状态更改其行为。
+* 根据对象状态的不同，操作有大量的条件语句。此状态通常由一个或多个枚举常量表示。通常，几个操作将包含此相同的条件结构。状态模式把条件语句的分支分别放入单独的类中。这样一来，你就可以将对象的状态视为独立的对象，该对象可以独立于其他对象而变化。
+
+## Java中例子
+
+* [javax.faces.lifecycle.Lifecycle#execute()](http://docs.oracle.com/javaee/7/api/javax/faces/lifecycle/Lifecycle.html#execute-javax.faces.context.FacesContext-) controlled by [FacesServlet](http://docs.oracle.com/javaee/7/api/javax/faces/webapp/FacesServlet.html), the behavior is dependent on current phase of lifecycle.
+* [JDiameter - Diameter State Machine](https://github.com/npathai/jdiameter/blob/master/core/jdiameter/api/src/main/java/org/jdiameter/api/app/State.java)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/zh/template-method/README.md b/zh/template-method/README.md
new file mode 100644
index 000000000..f848552c3
--- /dev/null
+++ b/zh/template-method/README.md
@@ -0,0 +1,145 @@
+---
+layout: pattern
+title: Template method
+folder: template-method
+permalink: /patterns/template-method/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 目的
+在一个操作中定义算法的骨架，将某些步骤推迟到子类。模板方法允许子类重新定义算法的某些步骤，而无需更改算法的结构。
+
+## 解释
+真实世界例子
+
+> 偷东西的一般步骤是相同的。 首先，选择目标，然后以某种方式使其迷惑，最后，你偷走了该物品。然而这些步骤有很多实现方式。
+
+通俗的说
+
+> 模板方法模式在父类中列出一般的步骤然后让具体的子类定义实现细节。
+
+维基百科说
+
+> 在面向对象的编程中，模板方法是Gamma等人确定的行为设计模式之一。在《设计模式》一书中。模板方法是父类中一个方法，通常是一个抽象父类，根据许多高级步骤定义了操作的骨架。这些步骤本身由与模板方法在同一类中的其他帮助程序方法实现。
+
+**编程示例**
+
+让我们首先介绍模板方法类及其具体实现。
+
+```java
+public abstract class StealingMethod {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(StealingMethod.class);
+
+  protected abstract String pickTarget();
+
+  protected abstract void confuseTarget(String target);
+
+  protected abstract void stealTheItem(String target);
+
+  public void steal() {
+    var target = pickTarget();
+    LOGGER.info("The target has been chosen as {}.", target);
+    confuseTarget(target);
+    stealTheItem(target);
+  }
+}
+
+public class SubtleMethod extends StealingMethod {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(SubtleMethod.class);
+
+  @Override
+  protected String pickTarget() {
+    return "shop keeper";
+  }
+
+  @Override
+  protected void confuseTarget(String target) {
+    LOGGER.info("Approach the {} with tears running and hug him!", target);
+  }
+
+  @Override
+  protected void stealTheItem(String target) {
+    LOGGER.info("While in close contact grab the {}'s wallet.", target);
+  }
+}
+
+public class HitAndRunMethod extends StealingMethod {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(HitAndRunMethod.class);
+
+  @Override
+  protected String pickTarget() {
+    return "old goblin woman";
+  }
+
+  @Override
+  protected void confuseTarget(String target) {
+    LOGGER.info("Approach the {} from behind.", target);
+  }
+
+  @Override
+  protected void stealTheItem(String target) {
+    LOGGER.info("Grab the handbag and run away fast!");
+  }
+}
+```
+
+这是包含模板方法的半身贼类。
+
+```java
+public class HalflingThief {
+
+  private StealingMethod method;
+
+  public HalflingThief(StealingMethod method) {
+    this.method = method;
+  }
+
+  public void steal() {
+    method.steal();
+  }
+
+  public void changeMethod(StealingMethod method) {
+    this.method = method;
+  }
+}
+```
+最后，我们展示半身人贼如何利用不同的偷窃方法。
+
+```java
+    var thief = new HalflingThief(new HitAndRunMethod());
+    thief.steal();
+    thief.changeMethod(new SubtleMethod());
+    thief.steal();
+```
+
+## 类图
+![alt text](../../template-method/etc/template-method_1.png "Template Method")
+
+## 适用性
+
+使用模板方法模式可以
+
+* 一次性实现一个算法中不变的部分并将其留给子类来实现可能变化的行为。
+* 子类之间的共同行为应分解并集中在一个共同类中，以避免代码重复。如Opdyke和Johnson所描述的，这是“重构概括”的一个很好的例子。你首先要确定现有代码中的差异，然后将差异拆分为新的操作。最后，将不同的代码替换为调用这些新操作之一的模板方法。
+* 控制子类扩展。您可以定义一个模板方法，该方法在特定点调用“ 钩子”操作，从而仅允许在这些点进行扩展
+
+## 教程
+
+* [Template-method Pattern Tutorial](https://www.journaldev.com/1763/template-method-design-pattern-in-java)
+
+## Java例子
+
+* [javax.servlet.GenericServlet.init](https://jakarta.ee/specifications/servlet/4.0/apidocs/javax/servlet/GenericServlet.html#init--): 
+Method `GenericServlet.init(ServletConfig config)` calls the parameterless method `GenericServlet.init()` which is intended to be overridden in subclasses.
+Method `GenericServlet.init(ServletConfig config)` is the template method in this example.
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

From 68308dc550cbb3ac2d9b65a00c4c8d5c0d93bca1 Mon Sep 17 00:00:00 2001
From: Anurag870 <anuraag.sharma001@gmail.com>
Date: Sat, 5 Dec 2020 14:04:49 +0530
Subject: [PATCH 179/254] Update README.md (#1590)

---
 factory/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/factory/README.md b/factory/README.md
index 0112c92c0..e2f324541 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -119,8 +119,8 @@ and manage it.
 
 Pros
 
-* Allows keeping all objects creation in one place and avoid of spreading 'new' key value across codebase.
-* Allows to writs loosely coupled code. Some of its main advantages include better testability, easy-to-understand code, swappable components, scalability and isolated features.
+* Allows keeping all objects creation in one place and avoid of spreading 'new' keyword across codebase.
+* Allows to write loosely coupled code. Some of its main advantages include better testability, easy-to-understand code, swappable components, scalability and isolated features.
 
 Cons
 

From 7255c2c5e7515214d3e6245dce22e2c920c11102 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 5 Dec 2020 10:50:09 +0200
Subject: [PATCH 180/254] docs: add Anurag870 as a contributor (#1609)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

* Update README.md

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Ilkka Seppälä <ilkka.seppala@gofore.com>
Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 .all-contributorsrc | 3 ++-
 README.md           | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 709e8ffe6..032a3499c 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -315,7 +315,8 @@
       "avatar_url": "https://avatars1.githubusercontent.com/u/6295975?v=4",
       "profile": "https://github.com/Anurag870",
       "contributions": [
-        "code"
+        "code",
+        "doc"
       ]
     },
     {
diff --git a/README.md b/README.md
index 84c94640a..b17f901e9 100644
--- a/README.md
+++ b/README.md
@@ -119,7 +119,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://amarnath510.github.io/portfolio"><img src="https://avatars0.githubusercontent.com/u/4599623?v=4" width="100px;" alt=""/><br /><sub><b>Amarnath Chandana</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Amarnath510" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Anurag870"><img src="https://avatars1.githubusercontent.com/u/6295975?v=4" width="100px;" alt=""/><br /><sub><b>Anurag870</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Anurag870"><img src="https://avatars1.githubusercontent.com/u/6295975?v=4" width="100px;" alt=""/><br /><sub><b>Anurag870</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Documentation">📖</a></td>
     <td align="center"><a href="http://theerroris.me"><img src="https://avatars0.githubusercontent.com/u/1685953?v=4" width="100px;" alt=""/><br /><sub><b>Wes Gilleland</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Deathnerd" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/Harshrajsinh"><img src="https://avatars2.githubusercontent.com/u/22811531?v=4" width="100px;" alt=""/><br /><sub><b>Harshraj Thakor</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Harshrajsinh" title="Code">💻</a></td>
   </tr>

From 29ceac2fb06a4ffb85bdd327cdf3824ba6ccdaec Mon Sep 17 00:00:00 2001
From: Anurag870 <anuraag.sharma001@gmail.com>
Date: Sat, 5 Dec 2020 14:26:00 +0530
Subject: [PATCH 181/254] Update README.md (#1592)

---
 factory/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/factory/README.md b/factory/README.md
index e2f324541..321ec337a 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -98,7 +98,7 @@ Now on the client code we can create different types of cars using the factory c
 var car1 = CarsFactory.getCar(CarType.FORD);
 var car2 = CarsFactory.getCar(CarType.FERRARI);
 LOGGER.info(car1.getDescription());
-LOGGER.info(car2.getDescription());;
+LOGGER.info(car2.getDescription());
 ```
 
 Program output:

From e9f73bcf0b79ef90076ce0bde93f85b8cb6a7557 Mon Sep 17 00:00:00 2001
From: Mike Liu <657829312@qq.com>
Date: Sun, 6 Dec 2020 22:13:48 +0800
Subject: [PATCH 182/254] Translation zh (#1610)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add state and callback pattern

* add command and template-method pattern

* add iterator pattern

* add bridege and DI pattern

* fix issue #1600

Co-authored-by: Mike <admin@xiaod.info>
Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 zh/bridge/README.md               | 205 ++++++++++++++++++++++++++++++
 zh/decorator/README.md            |   2 -
 zh/dependency-injection/README.md | 101 +++++++++++++++
 3 files changed, 306 insertions(+), 2 deletions(-)
 create mode 100644 zh/bridge/README.md
 create mode 100644 zh/dependency-injection/README.md

diff --git a/zh/bridge/README.md b/zh/bridge/README.md
new file mode 100644
index 000000000..cd9f40ac4
--- /dev/null
+++ b/zh/bridge/README.md
@@ -0,0 +1,205 @@
+---
+layout: pattern
+title: Bridge
+folder: bridge
+permalink: /patterns/bridge/
+categories: Structural
+tags:
+ - Gang of Four
+---
+
+## 又被称为
+
+手柄/身体模式
+
+## 目的
+
+将抽象与其实现分离，以便二者可以独立变化。
+
+## 解释
+
+真实世界例子
+
+> 考虑一下你拥有一种具有不同附魔的武器，并且应该允许将具有不同附魔的不同武器混合使用。 你会怎么做？ 为每个附魔创建每种武器的多个副本，还是只是创建单独的附魔并根据需要为武器设置它？ 桥接模式使您可以进行第二次操作。
+
+通俗的说
+
+> 桥接模式是一个更推荐组合而不是继承的模式。将实现细节从一个层次结构推送到具有单独层次结构的另一个对象。
+
+维基百科说
+
+> 桥接模式是软件工程中使用的一种设计模式，旨在“将抽象与其实现分离，从而使两者可以独立变化”
+
+**程序示例**
+
+翻译一下上面的武器示例。下面我们有武器的类层级：
+
+```java
+public interface Weapon {
+  void wield();
+  void swing();
+  void unwield();
+  Enchantment getEnchantment();
+}
+
+public class Sword implements Weapon {
+
+  private final Enchantment enchantment;
+
+  public Sword(Enchantment enchantment) {
+    this.enchantment = enchantment;
+  }
+
+  @Override
+  public void wield() {
+    LOGGER.info("The sword is wielded.");
+    enchantment.onActivate();
+  }
+
+  @Override
+  public void swing() {
+    LOGGER.info("The sword is swinged.");
+    enchantment.apply();
+  }
+
+  @Override
+  public void unwield() {
+    LOGGER.info("The sword is unwielded.");
+    enchantment.onDeactivate();
+  }
+
+  @Override
+  public Enchantment getEnchantment() {
+    return enchantment;
+  }
+}
+
+public class Hammer implements Weapon {
+
+  private final Enchantment enchantment;
+
+  public Hammer(Enchantment enchantment) {
+    this.enchantment = enchantment;
+  }
+
+  @Override
+  public void wield() {
+    LOGGER.info("The hammer is wielded.");
+    enchantment.onActivate();
+  }
+
+  @Override
+  public void swing() {
+    LOGGER.info("The hammer is swinged.");
+    enchantment.apply();
+  }
+
+  @Override
+  public void unwield() {
+    LOGGER.info("The hammer is unwielded.");
+    enchantment.onDeactivate();
+  }
+
+  @Override
+  public Enchantment getEnchantment() {
+    return enchantment;
+  }
+}
+```
+
+这里是单独的附魔类结构：
+
+```java
+public interface Enchantment {
+  void onActivate();
+  void apply();
+  void onDeactivate();
+}
+
+public class FlyingEnchantment implements Enchantment {
+
+  @Override
+  public void onActivate() {
+    LOGGER.info("The item begins to glow faintly.");
+  }
+
+  @Override
+  public void apply() {
+    LOGGER.info("The item flies and strikes the enemies finally returning to owner's hand.");
+  }
+
+  @Override
+  public void onDeactivate() {
+    LOGGER.info("The item's glow fades.");
+  }
+}
+
+public class SoulEatingEnchantment implements Enchantment {
+
+  @Override
+  public void onActivate() {
+    LOGGER.info("The item spreads bloodlust.");
+  }
+
+  @Override
+  public void apply() {
+    LOGGER.info("The item eats the soul of enemies.");
+  }
+
+  @Override
+  public void onDeactivate() {
+    LOGGER.info("Bloodlust slowly disappears.");
+  }
+}
+```
+
+这里是两种层次结构的实践：
+
+```java
+var enchantedSword = new Sword(new SoulEatingEnchantment());
+enchantedSword.wield();
+enchantedSword.swing();
+enchantedSword.unwield();
+// The sword is wielded.
+// The item spreads bloodlust.
+// The sword is swinged.
+// The item eats the soul of enemies.
+// The sword is unwielded.
+// Bloodlust slowly disappears.
+
+var hammer = new Hammer(new FlyingEnchantment());
+hammer.wield();
+hammer.swing();
+hammer.unwield();
+// The hammer is wielded.
+// The item begins to glow faintly.
+// The hammer is swinged.
+// The item flies and strikes the enemies finally returning to owner's hand.
+// The hammer is unwielded.
+// The item's glow fades.
+```
+
+
+
+## 类图
+
+![alt text](../../bridge/etc/bridge.urm.png "Bridge class diagram")
+
+## 适用性
+
+使用桥接模式当
+
+* 你想永久性的避免抽象和他的实现之间的绑定。有可能是这种情况，当实现需要被选择或者在运行时切换。
+* 抽象和他们的实现应该能通过写子类来扩展。这种情况下，桥接模式让你可以组合不同的抽象和实现并独立的扩展他们。
+* 对抽象的实现的改动应当不会对客户产生影响；也就是说，他们的代码不必重新编译。
+* 你有种类繁多的类。这样的类层次结构表明需要将一个对象分为两部分。Rumbaugh 使用术语“嵌套归纳”来指代这种类层次结构。
+* 你想在多个对象间分享一种实现（可能使用引用计数），这个事实应该对客户隐藏。一个简单的示例是Coplien的String类，其中多个对象可以共享同一字符串表示形式
+
+## 教程
+
+* [Bridge Pattern Tutorial](https://www.journaldev.com/1491/bridge-design-pattern-java)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
diff --git a/zh/decorator/README.md b/zh/decorator/README.md
index ef23eda0b..6163017af 100644
--- a/zh/decorator/README.md
+++ b/zh/decorator/README.md
@@ -33,8 +33,6 @@ tags:
 
 以巨魔的为例。首先我有有一个简单的巨魔，实现了巨魔接口。
 
-程序mple. First of all we have a simple troll implementing the troll interface
-
 ```java
 public interface Troll {
   void attack();
diff --git a/zh/dependency-injection/README.md b/zh/dependency-injection/README.md
new file mode 100644
index 000000000..061a55425
--- /dev/null
+++ b/zh/dependency-injection/README.md
@@ -0,0 +1,101 @@
+---
+layout: pattern
+title: Dependency Injection
+folder: dependency-injection
+permalink: /patterns/dependency-injection/
+categories: Creational
+tags:
+ - Decoupling
+---
+
+## 目的
+
+依赖注入是一种软件设计模式，其中一个或多个依赖项（或服务）被注入或通过引用传递到一个依赖对象（或客户端）中，并成为客户端状态的一部分。该模式将客户的依赖关系的创建与其自身的行为分开，这使程序设计可以松散耦合，并遵循控制反转和单一职责原则。
+
+## 解释
+
+真实世界例子
+
+> 老巫师喜欢不时地装满烟斗抽烟。 但是，他不想只依赖一个烟草品牌，而是希望能够互换使用它们。 
+
+通俗的说
+
+> 依赖注入将客户端依赖的创建与其自身行为分开。
+
+维基百科说
+
+> 在软件工程中，依赖注入是一种对象接收其依赖的其他对象的技术。 这些其他对象称为依赖项。
+
+**程序示例**
+
+先介绍一下烟草接口和具体的品牌。
+
+```java
+public abstract class Tobacco {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Tobacco.class);
+
+  public void smoke(Wizard wizard) {
+    LOGGER.info("{} smoking {}", wizard.getClass().getSimpleName(),
+        this.getClass().getSimpleName());
+  }
+}
+
+public class SecondBreakfastTobacco extends Tobacco {
+}
+
+public class RivendellTobacco extends Tobacco {
+}
+
+public class OldTobyTobacco extends Tobacco {
+}
+```
+
+下面是老巫师的类的层次结构。
+
+```java
+public interface Wizard {
+
+  void smoke();
+}
+
+public class AdvancedWizard implements Wizard {
+
+  private final Tobacco tobacco;
+
+  public AdvancedWizard(Tobacco tobacco) {
+    this.tobacco = tobacco;
+  }
+
+  @Override
+  public void smoke() {
+    tobacco.smoke(this);
+  }
+}
+```
+
+最后我们可以看到给老巫师任意品牌的烟草是多么的简单。
+
+```java
+    var advancedWizard = new AdvancedWizard(new SecondBreakfastTobacco());
+    advancedWizard.smoke();
+```
+
+## 类图
+
+![alt text](../../dependency-injection/etc/dependency-injection.png "Dependency Injection")
+
+## 适用性
+
+使用依赖注入当：
+
+- 当你需要从对象中移除掉具体的实现内容时
+
+* 使用模拟对象或存根隔离地启用类的单元测试
+
+## 鸣谢
+
+* [Dependency Injection Principles, Practices, and Patterns](https://www.amazon.com/gp/product/161729473X/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=161729473X&linkId=57079257a5c7d33755493802f3b884bd)
+* [Clean Code: A Handbook of Agile Software Craftsmanship](https://www.amazon.com/gp/product/0132350882/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0132350882&linkCode=as2&tag=javadesignpat-20&linkId=2c390d89cc9e61c01b9e7005c7842871)
+* [Java 9 Dependency Injection: Write loosely coupled code with Spring 5 and Guice](https://www.amazon.com/gp/product/1788296257/ref=as_li_tl?ie=UTF8&tag=javadesignpat-20&camp=1789&creative=9325&linkCode=as2&creativeASIN=1788296257&linkId=4e9137a3bf722a8b5b156cce1eec0fc1)
+* [Google Guice Tutorial: Open source Java based dependency injection framework](https://www.amazon.com/gp/product/B083P7DZ8M/ref=as_li_tl?ie=UTF8&tag=javadesignpat-20&camp=1789&creative=9325&linkCode=as2&creativeASIN=B083P7DZ8M&linkId=04f0f902c877921e45215b624a124bfe)

From 759c99d078bb4e2f5864f9de1b556f0a7c0bfa12 Mon Sep 17 00:00:00 2001
From: Omar Karazoun <59054172+omk13@users.noreply.github.com>
Date: Mon, 7 Dec 2020 19:55:13 +0200
Subject: [PATCH 183/254] JUnit4 to JUnit5 (#1589)

* Getting @Test from JUnit5 instead of JUnit4

* Changed FixedStepGameLoopTest.java imports and tests to JUnit5

* JUnit4 to JUnit5

* JUnit4 to JUnit5

* JUnit4 to JUnit5

* JUnit4 to JUnit5
---
 .../java/com/iluwatar/gameloop/AppTest.java   |  2 +-
 .../gameloop/FixedStepGameLoopTest.java       | 15 ++++++------
 .../gameloop/FrameBasedGameLoopTest.java      | 16 ++++++-------
 .../iluwatar/gameloop/GameControllerTest.java | 19 ++++++++-------
 .../com/iluwatar/gameloop/GameLoopTest.java   | 23 +++++++++----------
 .../gameloop/VariableStepGameLoopTest.java    | 16 ++++++-------
 6 files changed, 44 insertions(+), 47 deletions(-)

diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
index 0c027028d..b163fe47c 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
index 5c8614fa1..6999f44ae 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
@@ -23,10 +23,11 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
 
 /**
  * FixedStepGameLoop unit test class.
@@ -35,12 +36,12 @@ public class FixedStepGameLoopTest {
 
   private FixedStepGameLoop gameLoop;
 
-  @Before
+  @BeforeEach
   public void setup() {
     gameLoop = new FixedStepGameLoop();
   }
 
-  @After
+  @AfterEach
   public void tearDown() {
     gameLoop = null;
   }
@@ -48,7 +49,7 @@ public class FixedStepGameLoopTest {
   @Test
   public void testUpdate() {
     gameLoop.update();
-    Assert.assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
+    assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
   }
 
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
index e8eb922dc..0f2d58237 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
 
 /**
  * FrameBasedGameLoop unit test class.
@@ -35,19 +35,19 @@ public class FrameBasedGameLoopTest {
 
   private FrameBasedGameLoop gameLoop;
 
-  @Before
+  @BeforeEach
   public void setup() {
     gameLoop = new FrameBasedGameLoop();
   }
 
-  @After
+  @AfterEach
   public void tearDown() {
     gameLoop = null;
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testUpdate() {
     gameLoop.update();
-    Assert.assertEquals(0.5f, gameLoop.controller.getBulletPosition(), 0);
+    assertEquals(0.5f, gameLoop.controller.getBulletPosition(), 0);
   }
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
index 3d057d830..19c4df1c6 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
@@ -23,34 +23,33 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
 
 public class GameControllerTest {
 
   private GameController controller;
 
-  @Before
+  @BeforeEach
   public void setup() {
     controller = new GameController();
   }
 
-  @After
+  @AfterEach
   public void tearDown() {
     controller = null;
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testMoveBullet() {
     controller.moveBullet(1.5f);
-    Assert.assertEquals(1.5f, controller.bullet.getPosition(), 0);
+    Assertions.assertEquals(1.5f, controller.bullet.getPosition(), 0);
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testGetBulletPosition() {
-    Assert.assertEquals(controller.bullet.getPosition(), controller.getBulletPosition(), 0);
+    Assertions.assertEquals(controller.bullet.getPosition(), controller.getBulletPosition(), 0);
   }
 
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
index 4873cfd47..963c8d0b2 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
@@ -23,10 +23,9 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.BeforeEach;
 
 /**
  * GameLoop unit test class.
@@ -38,7 +37,7 @@ public class GameLoopTest {
   /**
    * Create mock implementation of GameLoop.
    */
-  @Before
+  @BeforeEach
   public void setup() {
     gameLoop = new GameLoop() {
       @Override
@@ -46,26 +45,26 @@ public class GameLoopTest {
     };
   }
 
-  @After
+  @AfterEach
   public void tearDown() {
     gameLoop = null;
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testRun() {
     gameLoop.run();
-    Assert.assertEquals(GameStatus.RUNNING, gameLoop.status);
+    Assertions.assertEquals(GameStatus.RUNNING, gameLoop.status);
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testStop() {
     gameLoop.stop();
-    Assert.assertEquals(GameStatus.STOPPED, gameLoop.status);
+    Assertions.assertEquals(GameStatus.STOPPED, gameLoop.status);
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testIsGameRunning() {
-    Assert.assertFalse(gameLoop.isGameRunning());
+    Assertions.assertFalse(gameLoop.isGameRunning());
   }
 
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
index 43dd4f732..39ea03aca 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
@@ -23,11 +23,9 @@
 
 package com.iluwatar.gameloop;
 
-import java.lang.reflect.InvocationTargetException;
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
 
 /**
  * VariableStepGameLoop unit test class.
@@ -36,19 +34,19 @@ public class VariableStepGameLoopTest {
 
   private VariableStepGameLoop gameLoop;
 
-  @Before
+  @BeforeEach
   public void setup() {
     gameLoop = new VariableStepGameLoop();
   }
 
-  @After
+  @AfterEach
   public void tearDown() {
     gameLoop = null;
   }
 
-  @Test
+  @org.junit.jupiter.api.Test
   public void testUpdate() {
     gameLoop.update(20L);
-    Assert.assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
+    Assertions.assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
   }
 }

From a118a995eca26713a9312d32ac8156daf9059504 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 7 Dec 2020 19:58:05 +0200
Subject: [PATCH 184/254] docs: add omk13 as a contributor (#1611)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 032a3499c..f75b17c63 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1296,6 +1296,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "omk13",
+      "name": "Omar Karazoun",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/59054172?v=4",
+      "profile": "https://github.com/omk13",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index b17f901e9..47ca010c0 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-142-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-143-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -282,6 +282,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://github.com/gkulkarni2020"><img src="https://avatars3.githubusercontent.com/u/5161548?v=4" width="100px;" alt=""/><br /><sub><b>Girish Kulkarni</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gkulkarni2020" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/omk13"><img src="https://avatars0.githubusercontent.com/u/59054172?v=4" width="100px;" alt=""/><br /><sub><b>Omar Karazoun</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=omk13" title="Code">💻</a></td>
   </tr>
 </table>
 

From 428cbc1027594794cc0aaab17be35e3cacb2b117 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 7 Dec 2020 20:25:59 +0200
Subject: [PATCH 185/254] docs: add jeff303 as a contributor (#1612)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index f75b17c63..b95c726ec 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1305,6 +1305,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "jeff303",
+      "name": "Jeff Evans",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/3521562?v=4",
+      "profile": "https://github.com/jeff303",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 47ca010c0..d58a50a72 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-143-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-144-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -283,6 +283,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://github.com/gkulkarni2020"><img src="https://avatars3.githubusercontent.com/u/5161548?v=4" width="100px;" alt=""/><br /><sub><b>Girish Kulkarni</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gkulkarni2020" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/omk13"><img src="https://avatars0.githubusercontent.com/u/59054172?v=4" width="100px;" alt=""/><br /><sub><b>Omar Karazoun</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=omk13" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/jeff303"><img src="https://avatars0.githubusercontent.com/u/3521562?v=4" width="100px;" alt=""/><br /><sub><b>Jeff Evans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jeff303" title="Code">💻</a></td>
   </tr>
 </table>
 

From 14c4710435e89218404086816682012eff023497 Mon Sep 17 00:00:00 2001
From: Vivek Singh <viveksbhadauria007@gmail.com>
Date: Tue, 8 Dec 2020 10:34:42 +0530
Subject: [PATCH 186/254] Implemented Registry pattern (#1543)

* #1310 Implemented registry pattern

* fixed parent pom version

* added empty line in registry.urm.puml

Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 pom.xml                                       |   1 +
 registry/README.md                            |  86 ++++++++++++++++++
 registry/etc/registry.png                     | Bin 0 -> 16875 bytes
 registry/etc/registry.urm.puml                |  21 +++++
 registry/pom.xml                              |  46 ++++++++++
 .../main/java/com/iluwatar/registry/App.java  |  27 ++++++
 .../java/com/iluwatar/registry/Customer.java  |  28 ++++++
 .../iluwatar/registry/CustomerRegistry.java   |  28 ++++++
 .../registry/CustomerRegistryTest.java        |  44 +++++++++
 9 files changed, 281 insertions(+)
 create mode 100644 registry/README.md
 create mode 100644 registry/etc/registry.png
 create mode 100644 registry/etc/registry.urm.puml
 create mode 100644 registry/pom.xml
 create mode 100644 registry/src/main/java/com/iluwatar/registry/App.java
 create mode 100644 registry/src/main/java/com/iluwatar/registry/Customer.java
 create mode 100644 registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
 create mode 100644 registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java

diff --git a/pom.xml b/pom.xml
index e7fd2e4b3..86cefa133 100644
--- a/pom.xml
+++ b/pom.xml
@@ -195,6 +195,7 @@
         <module>strangler</module>
         <module>arrange-act-assert</module>
         <module>transaction-script</module>
+        <module>registry</module>
         <module>filterer</module>
         <module>factory</module>
         <module>separated-interface</module>
diff --git a/registry/README.md b/registry/README.md
new file mode 100644
index 000000000..699c13318
--- /dev/null
+++ b/registry/README.md
@@ -0,0 +1,86 @@
+---
+layout: pattern
+title: Registry
+folder: registry
+permalink: /patterns/registry/
+categories: Creational
+tags:
+ - Instantiation
+---
+
+## Intent
+Stores the objects of a single class and provide a global point of access to them. 
+Similar to Multiton pattern, only difference is that in a registry there is no restriction on the number of objects.
+
+## Explanation
+
+In Plain Words
+
+> Registry is a well-known object that other objects can use to find common objects and services.
+
+**Programmatic Example**
+Below is a `Customer` Class
+
+```java
+public class Customer {
+
+  private final String id;
+  private final String name;
+
+  public Customer(String id, String name) {
+    this.id = id;
+    this.name = name;
+  }
+
+  public String getId() {
+    return id;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+}
+```
+
+This registry of the `Customer` objects is `CustomerRegistry`
+```java
+public final class CustomerRegistry {
+
+  private static final CustomerRegistry instance = new CustomerRegistry();
+
+  public static CustomerRegistry getInstance() {
+    return instance;
+  }
+
+  private final Map<String, Customer> customerMap;
+
+  private CustomerRegistry() {
+    customerMap = new ConcurrentHashMap<>();
+  }
+
+  public Customer addCustomer(Customer customer) {
+    return customerMap.put(customer.getId(), customer);
+  }
+
+  public Customer getCustomer(String id) {
+    return customerMap.get(id);
+  }
+
+}
+```
+
+## Class diagram
+![Registry](./etc/registry.png)
+
+## Applicability
+Use Registry pattern when 
+
+* client wants reference of some object, so client can lookup for that object in the object's registry.
+
+## Consequences
+Large number of bulky objects added to registry would result in a lot of memory consumption as objects in the registry are not garbage collected.
+
+## Credits
+* https://www.martinfowler.com/eaaCatalog/registry.html
+* https://wiki.c2.com/?RegistryPattern
diff --git a/registry/etc/registry.png b/registry/etc/registry.png
new file mode 100644
index 0000000000000000000000000000000000000000..6c1c5b986d72cb33d1806c8d43ebc4a31e4927c9
GIT binary patch
literal 16875
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
Nla*AIs1`E{{$E%5hEo6l

literal 0
HcmV?d00001

diff --git a/registry/etc/registry.urm.puml b/registry/etc/registry.urm.puml
new file mode 100644
index 000000000..77c6441fe
--- /dev/null
+++ b/registry/etc/registry.urm.puml
@@ -0,0 +1,21 @@
+@startuml
+package com.iluwatar.registry {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  class Customer {
+    - id : String
+    - name : String
+    + getId() : String
+    + getName() : String
+    + toString() : String
+  }
+  class CustomerRegistry {
+    + addCustomer(customer : Customer)
+    + getCustomer(id : String)
+  }
+}
+Customer --> "-addCustomer" CustomerRegistry
+@enduml
diff --git a/registry/pom.xml b/registry/pom.xml
new file mode 100644
index 000000000..852bcacfd
--- /dev/null
+++ b/registry/pom.xml
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>registry</artifactId>
+
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <executions>
+          <execution>
+            <configuration>
+              <archive>
+                <manifest>
+                  <mainClass>com.iluwatar.registry.App</mainClass>
+                </manifest>
+              </archive>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+
+</project>
diff --git a/registry/src/main/java/com/iluwatar/registry/App.java b/registry/src/main/java/com/iluwatar/registry/App.java
new file mode 100644
index 000000000..a593ce5cc
--- /dev/null
+++ b/registry/src/main/java/com/iluwatar/registry/App.java
@@ -0,0 +1,27 @@
+package com.iluwatar.registry;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    CustomerRegistry customerRegistry = CustomerRegistry.getInstance();
+    var john = new Customer("1", "John");
+    customerRegistry.addCustomer(john);
+
+    var julia = new Customer("2", "Julia");
+    customerRegistry.addCustomer(julia);
+
+    LOGGER.info("John {}", customerRegistry.getCustomer("1"));
+    LOGGER.info("Julia {}", customerRegistry.getCustomer("2"));
+  }
+
+}
diff --git a/registry/src/main/java/com/iluwatar/registry/Customer.java b/registry/src/main/java/com/iluwatar/registry/Customer.java
new file mode 100644
index 000000000..354999fdf
--- /dev/null
+++ b/registry/src/main/java/com/iluwatar/registry/Customer.java
@@ -0,0 +1,28 @@
+package com.iluwatar.registry;
+
+public class Customer {
+
+  private final String id;
+  private final String name;
+
+  public Customer(String id, String name) {
+    this.id = id;
+    this.name = name;
+  }
+
+  public String getId() {
+    return id;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  @Override
+  public String toString() {
+    return "Customer{"
+        + "id='" + id + '\''
+        + ", name='" + name + '\''
+        + '}';
+  }
+}
diff --git a/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
new file mode 100644
index 000000000..406d616c6
--- /dev/null
+++ b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
@@ -0,0 +1,28 @@
+package com.iluwatar.registry;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+public final class CustomerRegistry {
+
+  private static final CustomerRegistry instance = new CustomerRegistry();
+
+  public static CustomerRegistry getInstance() {
+    return instance;
+  }
+
+  private final Map<String, Customer> customerMap;
+
+  private CustomerRegistry() {
+    customerMap = new ConcurrentHashMap<>();
+  }
+
+  public Customer addCustomer(Customer customer) {
+    return customerMap.put(customer.getId(), customer);
+  }
+
+  public Customer getCustomer(String id) {
+    return customerMap.get(id);
+  }
+
+}
diff --git a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
new file mode 100644
index 000000000..2919390b9
--- /dev/null
+++ b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
@@ -0,0 +1,44 @@
+package com.iluwatar.registry;
+
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+public class CustomerRegistryTest {
+
+  private static CustomerRegistry customerRegistry;
+
+  @BeforeAll
+  public static void setUp() {
+    customerRegistry = CustomerRegistry.getInstance();
+  }
+
+  @Test
+  public void shouldBeAbleToAddAndQueryCustomerObjectFromRegistry() {
+    Customer john = new Customer("1", "john");
+    Customer julia = new Customer("2", "julia");
+
+    customerRegistry.addCustomer(john);
+    customerRegistry.addCustomer(julia);
+
+    Customer customerWithId1 = customerRegistry.getCustomer("1");
+    assertNotNull(customerWithId1);
+    assertEquals("1", customerWithId1.getId());
+    assertEquals("john", customerWithId1.getName());
+
+    Customer customerWithId2 = customerRegistry.getCustomer("2");
+    assertNotNull(customerWithId2);
+    assertEquals("2", customerWithId2.getId());
+    assertEquals("julia", customerWithId2.getName());
+  }
+
+  @Test
+  public void shouldReturnNullWhenQueriedCustomerIsNotInRegistry() {
+    Customer customerWithId5 = customerRegistry.getCustomer("5");
+    assertNull(customerWithId5);
+  }
+
+}

From a94615ac54300326b8912a5a365418caed9306bd Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 8 Dec 2020 10:58:39 +0530
Subject: [PATCH 187/254] docs: add viveksb007 as a contributor (#1613)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 5 ++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index b95c726ec..18e5aa4af 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1314,6 +1314,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "viveksb007",
+      "name": "Vivek Singh",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/12713808?v=4",
+      "profile": "https://viveksb007.github.io",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index d58a50a72..18f41c29f 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-144-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-145-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -285,6 +285,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/omk13"><img src="https://avatars0.githubusercontent.com/u/59054172?v=4" width="100px;" alt=""/><br /><sub><b>Omar Karazoun</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=omk13" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/jeff303"><img src="https://avatars0.githubusercontent.com/u/3521562?v=4" width="100px;" alt=""/><br /><sub><b>Jeff Evans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jeff303" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-enable -->

From 5bc61c8c28e770f9b2805a3dc56bfde5fdbbc238 Mon Sep 17 00:00:00 2001
From: siavash <siavash.solimanii@yahoo.com>
Date: Wed, 9 Dec 2020 10:51:24 +0330
Subject: [PATCH 188/254] #1569 DTO pattern implementation using Enums (#1570)

* #1569 DTO pattern implemented using Enums

* #1569 DTO pattern implemented using Enums

* #1569 adding some java docs

* #1569 some changes in java doc and code style

* #1569 some changes in java doc and code style

* #1569 some changes in java doc and code style

* #1569 some changes in java doc and code style

* #1569 adding suggested extra line

* #1569 license added to pom.xml

* #1569 more checkstyle problems resolved

* #1569 more checkstyle problems resolved

* #1569 more checkstyle problems resolved

Co-authored-by: siavashsoleymani <siavash.soleimani@snapp.cab>
Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 data-transfer-object-enum-impl/README.md      |  54 ++++
 .../data-transfer-object-enum-impl.urm.puml   | 129 +++++++++
 .../etc/dto-enum-uml.png                      | Bin 0 -> 123167 bytes
 data-transfer-object-enum-impl/pom.xml        |  61 ++++
 .../com/iluwatar/datatransferenum/App.java    |  59 ++++
 .../iluwatar/datatransferenum/Product.java    |  91 ++++++
 .../iluwatar/datatransferenum/ProductDto.java | 264 ++++++++++++++++++
 .../datatransferenum/ProductResource.java     |  71 +++++
 .../iluwatar/datatransferenum/AppTest.java    |  44 +++
 pom.xml                                       |   1 +
 10 files changed, 774 insertions(+)
 create mode 100644 data-transfer-object-enum-impl/README.md
 create mode 100644 data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
 create mode 100644 data-transfer-object-enum-impl/etc/dto-enum-uml.png
 create mode 100644 data-transfer-object-enum-impl/pom.xml
 create mode 100644 data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
 create mode 100644 data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java
 create mode 100644 data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java
 create mode 100644 data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java
 create mode 100644 data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java

diff --git a/data-transfer-object-enum-impl/README.md b/data-transfer-object-enum-impl/README.md
new file mode 100644
index 000000000..7e6dbc365
--- /dev/null
+++ b/data-transfer-object-enum-impl/README.md
@@ -0,0 +1,54 @@
+---
+layout: pattern
+title: Data Transfer Object
+folder: data-transfer-object
+permalink: /patterns/data-transfer-object/
+categories: Architectural
+tags:
+ - Performance
+---
+
+## Intent
+
+Pass data with multiple attributes in one shot from client to server, to avoid multiple calls to 
+remote server. 
+
+## Explanation
+
+Real world example
+
+> We need to fetch information about customers from remote database. Instead of querying the 
+> attributes one at a time, we use DTOs to transfer all the relevant attributes in a single shot.     
+
+In plain words
+
+> Using DTO relevant information can be fetched with a single backend query. 
+
+Wikipedia says
+
+> In the field of programming a data transfer object (DTO) is an object that carries data between 
+> processes. The motivation for its use is that communication between processes is usually done 
+> resorting to remote interfaces (e.g. web services), where each call is an expensive operation. 
+> Because the majority of the cost of each call is related to the round-trip time between the client 
+> and the server, one way of reducing the number of calls is to use an object (the DTO) that 
+> aggregates the data that would have been transferred by the several calls, but that is served by 
+> one call only.
+
+## Class diagram
+
+![alt text](./etc/dto-enum-uml.png "data-transfer-object")
+
+## Applicability
+
+Use the Data Transfer Object pattern when:
+
+* The client is asking for multiple information. And the information is related.
+* When you want to boost the performance to get resources.
+* You want reduced number of remote calls.
+
+## Credits
+
+* [Design Pattern - Transfer Object Pattern](https://www.tutorialspoint.com/design_pattern/transfer_object_pattern.htm)
+* [Data Transfer Object](https://msdn.microsoft.com/en-us/library/ff649585.aspx)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94)
+* [Patterns of Enterprise Application Architecture](https://www.amazon.com/gp/product/0321127420/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321127420&linkCode=as2&tag=javadesignpat-20&linkId=014237a67c9d46f384b35e10151956bd)
diff --git a/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml b/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
new file mode 100644
index 000000000..e6426c392
--- /dev/null
+++ b/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
@@ -0,0 +1,129 @@
+@startuml
+package com.iluwatar.datatransferenum {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  class Product {
+    - cost : Double
+    - id : Long
+    - name : String
+    - price : Double
+    - supplier : String
+    + Product()
+    + getCost() : Double
+    + getId() : Long
+    + getName() : String
+    + getPrice() : Double
+    + getSupplier() : String
+    + setCost(cost : Double) : Product
+    + setId(id : Long) : Product
+    + setName(name : String) : Product
+    + setPrice(price : Double) : Product
+    + setSupplier(supplier : String) : Product
+    + toString() : String
+  }
+  enum ProductDTO {
+    + valueOf(name : String) : ProductDTO {static}
+    + values() : ProductDTO[] {static}
+  }
+  -interface Cost {
+    + getCost() : Double {abstract}
+  }
+  -interface Id {
+    + getId() : Long {abstract}
+  }
+  -interface Name {
+    + getName() : String {abstract}
+  }
+  -interface Price {
+    + getPrice() : Double {abstract}
+  }
+  enum Request {
+    + valueOf(name : String) : Request {static}
+    + values() : Request[] {static}
+  }
+  class Create {
+    - cost : Double
+    - name : String
+    - price : Double
+    - supplier : String
+    + Create()
+    + getCost() : Double
+    + getName() : String
+    + getPrice() : Double
+    + getSupplier() : String
+    + setCost(cost : Double) : Create
+    + setName(name : String) : Create
+    + setPrice(price : Double) : Create
+    + setSupplier(supplier : String) : Create
+  }
+  enum Response {
+    + valueOf(name : String) : Response {static}
+    + values() : Response[] {static}
+  }
+  class Private {
+    - cost : Double
+    - id : Long
+    - name : String
+    - price : Double
+    + Private()
+    + getCost() : Double
+    + getId() : Long
+    + getName() : String
+    + getPrice() : Double
+    + setCost(cost : Double) : Private
+    + setId(id : Long) : Private
+    + setName(name : String) : Private
+    + setPrice(price : Double) : Private
+    + toString() : String
+  }
+  class Public {
+    - id : Long
+    - name : String
+    - price : Double
+    + Public()
+    + getId() : Long
+    + getName() : String
+    + getPrice() : Double
+    + setId(id : Long) : Public
+    + setName(name : String) : Public
+    + setPrice(price : Double) : Public
+    + toString() : String
+  }
+  -interface Supplier {
+    + getSupplier() : String {abstract}
+  }
+  class ProductResource {
+    - products : List<Product>
+    + ProductResource(products : List<Product>)
+    + getAllProductsForAdmin() : List<Private>
+    + getAllProductsForCustomer() : List<Public>
+    + getProducts() : List<Product>
+    + save(createProductDTO : Create)
+  }
+}
+Create ..+ Request
+Request ..+ ProductDTO
+Private ..+ Response
+Supplier ..+ ProductDTO
+Name ..+ ProductDTO
+ProductResource -->  "-products" Product
+Public ..+ Response
+Id ..+ ProductDTO
+Price ..+ ProductDTO
+Response ..+ ProductDTO
+Cost ..+ ProductDTO
+Create ..|> Name 
+Create ..|> Price 
+Create ..|> Cost 
+Create ..|> Supplier 
+Private ..|> Id 
+Private ..|> Name 
+Private ..|> Price 
+Private ..|> Cost 
+Public ..|> Id 
+Public ..|> Name 
+Public ..|> Price 
+@enduml
diff --git a/data-transfer-object-enum-impl/etc/dto-enum-uml.png b/data-transfer-object-enum-impl/etc/dto-enum-uml.png
new file mode 100644
index 0000000000000000000000000000000000000000..57e9a1ab520db212a7ff5635c5b1b2125af7ffe6
GIT binary patch
literal 123167
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

literal 0
HcmV?d00001

diff --git a/data-transfer-object-enum-impl/pom.xml b/data-transfer-object-enum-impl/pom.xml
new file mode 100644
index 000000000..74c8a3a6c
--- /dev/null
+++ b/data-transfer-object-enum-impl/pom.xml
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>com.iluwatar</groupId>
+        <artifactId>java-design-patterns</artifactId>
+        <version>1.24.0-SNAPSHOT</version>
+    </parent>
+    <artifactId>data-transfer-object-enum-impl</artifactId>
+    <dependencies>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <configuration>
+                            <archive>
+                                <manifest>
+                                    <mainClass>com.iluwatar.datatransferenum.App</mainClass>
+                                </manifest>
+                            </archive>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
new file mode 100644
index 000000000..9c80d07cc
--- /dev/null
+++ b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
@@ -0,0 +1,59 @@
+package com.iluwatar.datatransferenum;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The Data Transfer Object pattern is a design pattern in which an data transfer object is used to
+ * serve related information together to avoid multiple call for each piece of information.
+ *
+ * <p>In this example, ({@link App}) as as product details consumer i.e. client to
+ * request for product details to server.
+ *
+ * <p>productResource ({@link ProductResource}) act as server to serve product information. And
+ * The productDto ({@link ProductDto} is data transfer object to share product information.
+ */
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  /**
+   * Method as act client and request to server for details.
+   *
+   * @param args program argument.
+   */
+  public static void main(String[] args) {
+    Product tv =
+        new Product().setId(1L).setName("TV").setSupplier("Sony").setPrice(1000D).setCost(1090D);
+    Product microwave =
+        new Product().setId(2L).setName("microwave").setSupplier("Delonghi").setPrice(1000D)
+            .setCost(1090D);
+    Product refrigerator =
+        new Product().setId(3L).setName("refrigerator").setSupplier("Botsch").setPrice(1000D)
+            .setCost(1090D);
+    Product airConditioner =
+        new Product().setId(4L).setName("airConditioner").setSupplier("LG").setPrice(1000D)
+            .setCost(1090D);
+    List<Product> products =
+        new ArrayList<>(Arrays.asList(tv, microwave, refrigerator, airConditioner));
+    ProductResource productResource = new ProductResource(products);
+
+    LOGGER.info("####### List of products including sensitive data just for admins: \n {}",
+        Arrays.toString(productResource.getAllProductsForAdmin().toArray()));
+    LOGGER.info("####### List of products for customers: \n {}",
+        Arrays.toString(productResource.getAllProductsForCustomer().toArray()));
+
+    LOGGER.info("####### Going to save Sony PS5 ...");
+    ProductDto.Request.Create createProductRequestDto = new ProductDto.Request.Create()
+        .setName("PS5")
+        .setCost(1000D)
+        .setPrice(1220D)
+        .setSupplier("Sony");
+    productResource.save(createProductRequestDto);
+    LOGGER.info("####### List of products after adding PS5: {}",
+        Arrays.toString(productResource.getProducts().toArray()));
+  }
+}
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java
new file mode 100644
index 000000000..96758baf4
--- /dev/null
+++ b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java
@@ -0,0 +1,91 @@
+package com.iluwatar.datatransferenum;
+
+/**
+ * {@link Product} is a entity class for product entity. This class act as entity in the demo.
+ */
+public final class Product {
+  private Long id;
+  private String name;
+  private Double price;
+  private Double cost;
+  private String supplier;
+
+  /**
+   * Constructor.
+   *
+   * @param id       product id
+   * @param name     product name
+   * @param price    product price
+   * @param cost     product cost
+   * @param supplier product supplier
+   */
+  public Product(Long id, String name, Double price, Double cost, String supplier) {
+    this.id = id;
+    this.name = name;
+    this.price = price;
+    this.cost = cost;
+    this.supplier = supplier;
+  }
+
+  /**
+   * Constructor.
+   */
+  public Product() {
+  }
+
+  public Long getId() {
+    return id;
+  }
+
+  public Product setId(Long id) {
+    this.id = id;
+    return this;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  public Product setName(String name) {
+    this.name = name;
+    return this;
+  }
+
+  public Double getPrice() {
+    return price;
+  }
+
+  public Product setPrice(Double price) {
+    this.price = price;
+    return this;
+  }
+
+  public Double getCost() {
+    return cost;
+  }
+
+  public Product setCost(Double cost) {
+    this.cost = cost;
+    return this;
+  }
+
+  public String getSupplier() {
+    return supplier;
+  }
+
+  public Product setSupplier(String supplier) {
+    this.supplier = supplier;
+    return this;
+  }
+
+  @Override
+  public String toString() {
+    return "Product{"
+        + "id=" + id
+        + ", name='" + name + '\''
+        + ", price=" + price
+        + ", cost=" + cost
+        + ", supplier='" + supplier + '\''
+        + '}';
+  }
+}
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java
new file mode 100644
index 000000000..49d08d896
--- /dev/null
+++ b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java
@@ -0,0 +1,264 @@
+package com.iluwatar.datatransferenum;
+
+/**
+ * {@link ProductDto} is a data transfer object POJO.
+ * Instead of sending individual information to
+ * client We can send related information together in POJO.
+ *
+ * <p>Dto will not have any business logic in it.
+ */
+public enum ProductDto {
+  ;
+
+  /**
+   * This is Request class which consist of Create or any other request DTO's
+   * you might want to use in your API.
+   */
+  public enum Request {
+    ;
+
+    /**
+     * This is Create dto class for requesting create new product.
+     */
+    public static final class Create implements Name, Price, Cost, Supplier {
+      private String name;
+      private Double price;
+      private Double cost;
+      private String supplier;
+
+      @Override
+      public String getName() {
+        return name;
+      }
+
+      public Create setName(String name) {
+        this.name = name;
+        return this;
+      }
+
+      @Override
+      public Double getPrice() {
+        return price;
+      }
+
+      public Create setPrice(Double price) {
+        this.price = price;
+        return this;
+      }
+
+      @Override
+      public Double getCost() {
+        return cost;
+      }
+
+      public Create setCost(Double cost) {
+        this.cost = cost;
+        return this;
+      }
+
+      @Override
+      public String getSupplier() {
+        return supplier;
+      }
+
+      public Create setSupplier(String supplier) {
+        this.supplier = supplier;
+        return this;
+      }
+    }
+  }
+
+  /**
+   * This is Response class which consist of any response DTO's
+   * you might want to provide to your clients.
+   */
+  public enum Response {
+    ;
+
+    /**
+     * This is Public dto class for API response with the lowest data security.
+     */
+    public static final class Public implements Id, Name, Price {
+      private Long id;
+      private String name;
+      private Double price;
+
+      @Override
+      public Long getId() {
+        return id;
+      }
+
+      public Public setId(Long id) {
+        this.id = id;
+        return this;
+      }
+
+      @Override
+      public String getName() {
+        return name;
+      }
+
+      public Public setName(String name) {
+        this.name = name;
+        return this;
+      }
+
+      @Override
+      public Double getPrice() {
+        return price;
+      }
+
+      public Public setPrice(Double price) {
+        this.price = price;
+        return this;
+      }
+
+      @Override
+      public String toString() {
+        return "Public{"
+            + "id="
+            + id
+            + ", name='"
+            + name
+            + '\''
+            + ", price="
+            + price
+            + '}';
+      }
+    }
+
+    /**
+     * This is Private dto class for API response with the highest data security.
+     */
+    public static final class Private implements Id, Name, Price, Cost {
+      private Long id;
+      private String name;
+      private Double price;
+      private Double cost;
+
+      @Override
+      public Long getId() {
+        return id;
+      }
+
+      public Private setId(Long id) {
+        this.id = id;
+        return this;
+      }
+
+      @Override
+      public String getName() {
+        return name;
+      }
+
+      public Private setName(String name) {
+        this.name = name;
+        return this;
+      }
+
+      @Override
+      public Double getPrice() {
+        return price;
+      }
+
+      public Private setPrice(Double price) {
+        this.price = price;
+        return this;
+      }
+
+      @Override
+      public Double getCost() {
+        return cost;
+      }
+
+      public Private setCost(Double cost) {
+        this.cost = cost;
+        return this;
+      }
+
+      @Override
+      public String toString() {
+        return "Private{"
+            +
+            "id="
+            + id
+            +
+            ", name='"
+            + name
+            + '\''
+            +
+            ", price="
+            + price
+            +
+            ", cost="
+            + cost
+            +
+            '}';
+      }
+    }
+  }
+
+  /**
+   * Use this interface whenever you want to provide the product Id in your DTO.
+   */
+  private interface Id {
+    /**
+     * Unique identifier of the product.
+     *
+     * @return : id of the product.
+     */
+    Long getId();
+  }
+
+  /**
+   * Use this interface whenever you want to provide the product Name in your DTO.
+   */
+  private interface Name {
+    /**
+     * The name of the product.
+     *
+     * @return : name of the product.
+     */
+    String getName();
+  }
+
+  /**
+   * Use this interface whenever you want to provide the product Price in your DTO.
+   */
+  private interface Price {
+    /**
+     * The amount we sell a product for.
+     * <b>This data is not confidential</b>
+     *
+     * @return : price of the product.
+     */
+    Double getPrice();
+  }
+
+  /**
+   * Use this interface whenever you want to provide the product Cost in your DTO.
+   */
+  private interface Cost {
+    /**
+     * The amount that it costs us to purchase this product
+     * For the amount we sell a product for, see the {@link Price Price} parameter.
+     * <b>This data is confidential</b>
+     *
+     * @return : cost of the product.
+     */
+    Double getCost();
+  }
+
+  /**
+   * Use this interface whenever you want to provide the product Supplier in your DTO.
+   */
+  private interface Supplier {
+    /**
+     * The name of supplier of the product or its manufacturer.
+     * <b>This data is highly confidential</b>
+     *
+     * @return : supplier of the product.
+     */
+    String getSupplier();
+  }
+}
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java
new file mode 100644
index 000000000..5940982b1
--- /dev/null
+++ b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java
@@ -0,0 +1,71 @@
+package com.iluwatar.datatransferenum;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * The resource class which serves product information. This class act as server in the demo. Which
+ * has all product details.
+ */
+public class ProductResource {
+  private final List<Product> products;
+
+  /**
+   * Initialise resource with existing products.
+   *
+   * @param products initialize resource with existing products. Act as database.
+   */
+  public ProductResource(final List<Product> products) {
+    this.products = products;
+  }
+
+  /**
+   * Get all products.
+   *
+   * @return : all products in list but in the scheme of private dto.
+   */
+  public List<ProductDto.Response.Private> getAllProductsForAdmin() {
+    return products
+        .stream()
+        .map(p -> new ProductDto.Response.Private().setId(p.getId()).setName(p.getName())
+            .setCost(p.getCost())
+            .setPrice(p.getPrice()))
+        .collect(Collectors.toList());
+  }
+
+  /**
+   * Get all products.
+   *
+   * @return : all products in list but in the scheme of public dto.
+   */
+  public List<ProductDto.Response.Public> getAllProductsForCustomer() {
+    return products
+        .stream()
+        .map(p -> new ProductDto.Response.Public().setId(p.getId()).setName(p.getName())
+            .setPrice(p.getPrice()))
+        .collect(Collectors.toList());
+  }
+
+  /**
+   * Save new product.
+   *
+   * @param createProductDto save new product to list.
+   */
+  public void save(ProductDto.Request.Create createProductDto) {
+    products.add(new Product()
+        .setId((long) (products.size() + 1))
+        .setName(createProductDto.getName())
+        .setSupplier(createProductDto.getSupplier())
+        .setPrice(createProductDto.getPrice())
+        .setCost(createProductDto.getCost()));
+  }
+
+  /**
+   * List of all products in an entity representation.
+   *
+   * @return : all the products entity that stored in the products list
+   */
+  public List<Product> getProducts() {
+    return products;
+  }
+}
diff --git a/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java b/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java
new file mode 100644
index 000000000..bba131e64
--- /dev/null
+++ b/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java
@@ -0,0 +1,44 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.datatransferenum;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+
+import org.junit.jupiter.api.Test;
+
+class AppTest {
+
+  /**
+   * Issue: Add at least one assertion to this test case.
+   * <p>
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
+
+  @Test
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[] {}));
+  }
+}
diff --git a/pom.xml b/pom.xml
index 86cefa133..b6556245b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -199,6 +199,7 @@
         <module>filterer</module>
         <module>factory</module>
         <module>separated-interface</module>
+        <module>data-transfer-object-enum-impl</module>
     </modules>
 
     <repositories>

From 86329623621ca5db67973b600570efb110b61f8a Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Wed, 9 Dec 2020 13:11:15 +0530
Subject: [PATCH 189/254] docs: add siavashsoleymani as a contributor (#1616)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 18e5aa4af..d754c2f7a 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1323,6 +1323,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "siavashsoleymani",
+      "name": "siavash",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/18074419?v=4",
+      "profile": "https://github.com/siavashsoleymani",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 18f41c29f..923e40702 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-145-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-146-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -287,6 +287,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/siavashsoleymani"><img src="https://avatars2.githubusercontent.com/u/18074419?v=4" width="100px;" alt=""/><br /><sub><b>siavash</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=siavashsoleymani" title="Code">💻</a></td>
   </tr>
 </table>
 

From 2aa4c963eb465cf61ade0f1b4a5c31f4e3e41fe2 Mon Sep 17 00:00:00 2001
From: ruchpeanuts <dalsaniarucha@yahoo.co.in>
Date: Sun, 13 Dec 2020 10:33:43 -0500
Subject: [PATCH 190/254] Update README.md (#1598)

Factory method is updated with real world examples
---
 factory/README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/factory/README.md b/factory/README.md
index 321ec337a..0037a9b51 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -126,6 +126,16 @@ Cons
 
 * The code becomes more complicated than it should be. 
 
+## Real world examples
+
+* [java.util.Calendar#getInstance()](https://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html#getInstance--)
+* [java.util.ResourceBundle#getBundle()](https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-)
+* [java.text.NumberFormat#getInstance()](https://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html#getInstance--)
+* [java.nio.charset.Charset#forName()](https://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#forName-java.lang.String-)
+* [java.net.URLStreamHandlerFactory#createURLStreamHandler(String)](https://docs.oracle.com/javase/8/docs/api/java/net/URLStreamHandlerFactory.html) (Returns different singleton objects, depending on a protocol)
+* [java.util.EnumSet#of()](https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html#of(E))
+* [javax.xml.bind.JAXBContext#createMarshaller()](https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/JAXBContext.html#createMarshaller--) and other similar methods.
+
 ## Related patterns
 
 * [Factory Method](https://java-design-patterns.com/patterns/factory-method/)

From 801006337a980b401857a163ba86ef9609a46f84 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 13 Dec 2020 17:35:37 +0200
Subject: [PATCH 191/254] docs: add ruchpeanuts as a contributor (#1618)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index d754c2f7a..afa307512 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1332,6 +1332,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "ruchpeanuts",
+      "name": "ruchpeanuts",
+      "avatar_url": "https://avatars0.githubusercontent.com/u/29301900?v=4",
+      "profile": "https://github.com/ruchpeanuts",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 923e40702..e07f2a4bc 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-146-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-147-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -288,6 +288,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/siavashsoleymani"><img src="https://avatars2.githubusercontent.com/u/18074419?v=4" width="100px;" alt=""/><br /><sub><b>siavash</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=siavashsoleymani" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ruchpeanuts"><img src="https://avatars0.githubusercontent.com/u/29301900?v=4" width="100px;" alt=""/><br /><sub><b>ruchpeanuts</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruchpeanuts" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From 0c66e48d8103e60331be42c9a2a1d5b96b75425b Mon Sep 17 00:00:00 2001
From: warp125 <48073115+warp125@users.noreply.github.com>
Date: Mon, 21 Dec 2020 03:18:23 +0900
Subject: [PATCH 192/254] README.md translated into Korean (#1582)

* Translate README.md via GitLocalize

* Translate README.md via GitLocalize

* Update README.md

* Translate README.md via GitLocalize

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Translate README.md via GitLocalize

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Translate README.md via GitLocalize

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Translate README.md via GitLocalize

* Update README.md

Co-authored-by: mt-gitlocalize <mt@gitlocalize.com>
---
 ko/README.md           | 263 +++++++++++++++++++++++++++++++++++++++++
 ko/adapter/README.md   | 134 +++++++++++++++++++++
 ko/factory/README.md   | 128 ++++++++++++++++++++
 ko/observer/README.md  | 165 ++++++++++++++++++++++++++
 ko/prototype/README.md |  87 ++++++++++++++
 ko/singleton/README.md |  84 +++++++++++++
 6 files changed, 861 insertions(+)
 create mode 100644 ko/README.md
 create mode 100644 ko/adapter/README.md
 create mode 100644 ko/factory/README.md
 create mode 100644 ko/observer/README.md
 create mode 100644 ko/prototype/README.md
 create mode 100644 ko/singleton/README.md

diff --git a/ko/README.md b/ko/README.md
new file mode 100644
index 000000000..7bc004db6
--- /dev/null
+++ b/ko/README.md
@@ -0,0 +1,263 @@
+<!-- the line below needs to be an empty line C: (its because kramdown isnt
+     that smart and dearly wants an empty line before a heading to be able to
+     display it as such, e.g. website) -->
+
+# 자바로 구현된 디자인 패턴
+
+![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)[](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)[](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)
+
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+
+[](#contributors-)![All Contributors](https://img.shields.io/badge/all_contributors-133-orange.svg?style=flat-square)
+
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+# 소개
+
+디자인 패턴은 프로그래머가 응용 프로그램이나 시스템을 디자인 할 때 일반적인 문제를 해결하는 데 사용할 수있는 가장 공식화 된 방법입니다.
+
+디자인 패턴은 테스트되고 입증 된 개발 패러다임을 제공하여 개발 프로세스 속도를 높일 수 있습니다.
+
+디자인 패턴을 재사용하면 주요 문제를 유발하는 미묘한 이슈들을 방지하는데 도움이 되며 또한 패턴에 익숙한 코더와 아키텍트의 코드 가독성도 향상됩니다.
+
+# 시작하기
+
+이 사이트는 Java 디자인 패턴을 보여줍니다. 이 솔루션은 오픈 소스 커뮤니티의 경험이 많은 프로그래머와 설계자가 개발했습니다. 패턴은 높은 수준의 설명이나 소스 코드를 통해 찾아 볼 수 있습니다. 소스 코드 예제는 잘 설명되어 있으며 특정 패턴을 구현하는 방법을 알려주는 프로그래밍 튜토리얼로 생각할 수 있습니다. 우리는 가장 널리 알려지고 실무에서 입증된 오픈 소스 Java 기술을 사용합니다.
+
+자료를 살펴보기 전에 다양한 [소프트웨어 설계 원칙](https://java-design-patterns.com/principles/)을 숙지해야합니다.
+
+모든 디자인은 가능한 한 단순해야합니다. 당신은 KISS, YAGNI로 시작해야하며, 원칙을 작동 할 수 있는 가장 단순한 일을 해야합니다. 복잡성과 패턴은 실용적인 확장성을 위해 필요할 때만 도입되어야합니다.
+
+이러한 개념에 익숙해지면 다음 접근 방식 중 하나를 이용하여 [사용 가능한 디자인 패턴](https://java-design-patterns.com/patterns/)으로 드릴다운 할 수 있습니다.
+
+- 이름으로 특정 패턴을 검색합니다. 찾을 수 없습니까? [여기](https://github.com/iluwatar/java-design-patterns/issues)에서 새 패턴을 보고하십시오.
+- `Performance`, `Gang of Four` 또는 `Data access` 태그 사용.
+- 패턴 카테고리, `Creational`, `Behavioral` 및 기타 사용
+
+이 사이트에 제시된 객체 지향 솔루션이 여러분의 아키텍처에서 유용하고 우리가 개발 한 것만큼 재미있게 배우기를 바랍니다.
+
+# 기여하는 방법
+
+프로젝트에 기여할 의향이 있다면 [developer wiki](https://github.com/iluwatar/java-design-patterns/wiki)에서 관련 정보를 찾을 수 있습니다. [Gitter chatroom](https://gitter.im/iluwatar/java-design-patterns)에서 귀하를 돕고 질문에 답변 해 드리겠습니다.
+
+# 특허
+
+이 프로젝트는 MIT 라이센스 조건에 따라 라이센스가 부여됩니다.
+
+# 기여자
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+
+<!-- prettier-ignore-start -->
+
+<!-- markdownlint-disable -->
+
+<table>
+  <tr>
+    <td align="center"><a href="https://github.com/iluwatar"><img src="https://avatars1.githubusercontent.com/u/582346?v=4" width="100px;" alt=""><br><sub><b>Ilkka Seppälä</b></sub></a></td>
+    <td align="center"><a href="https://github.com/amit1307"><img src="https://avatars0.githubusercontent.com/u/23420222?v=4" width="100px;" alt=""><br><sub><b>amit1307</b></sub></a></td>
+    <td align="center"><a href="https://github.com/npathai"><img src="https://avatars2.githubusercontent.com/u/1792515?v=4" width="100px;" alt=""><br><sub><b>Narendra Pathai</b></sub></a></td>
+    <td align="center"><a href="https://github.com/fluxw42"><img src="https://avatars1.githubusercontent.com/u/1545460?v=4" width="100px;" alt=""><br><sub><b>Jeroen Meulemeester</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://www.joemccarthy.co.uk"><img src="https://avatars0.githubusercontent.com/u/4526195?v=4" width="100px;" alt=""><br><sub><b>Joseph McCarthy</b></sub></a></td>
+    <td align="center"><a href="https://github.com/thomasoss"><img src="https://avatars1.githubusercontent.com/u/22516154?v=4" width="100px;" alt=""><br><sub><b>Thomas</b></sub></a></td>
+    <td align="center"><a href="https://github.com/anuragagarwal561994"><img src="https://avatars1.githubusercontent.com/u/6075379?v=4" width="100px;" alt=""><br><sub><b>Anurag Agarwal</b></sub></a></td>
+    <td align="center"><a href="https://markusmo3.github.io"><img src="https://avatars1.githubusercontent.com/u/3317416?v=4" width="100px;" alt=""><br><sub><b>Markus Moser</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://twitter.com/i_sabiq"><img src="https://avatars1.githubusercontent.com/u/19510920?v=4" width="100px;" alt=""><br><sub><b>Sabiq Ihab</b></sub></a></td>
+    <td align="center"><a href="http://inbravo.github.io"><img src="https://avatars3.githubusercontent.com/u/5253764?v=4" width="100px;" alt=""><br><sub><b>Amit Dixit</b></sub></a></td>
+    <td align="center"><a href="https://github.com/piyushchaudhari04"><img src="https://avatars3.githubusercontent.com/u/10268029?v=4" width="100px;" alt=""><br><sub><b>Piyush Kailash Chaudhari</b></sub></a></td>
+    <td align="center"><a href="https://github.com/joshzambales"><img src="https://avatars1.githubusercontent.com/u/8704552?v=4" width="100px;" alt=""><br><sub><b>joshzambales</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/Crossy147"><img src="https://avatars2.githubusercontent.com/u/7272996?v=4" width="100px;" alt=""><br><sub><b>Kamil Pietruszka</b></sub></a></td>
+    <td align="center"><a href="http://cs.joensuu.fi/~zkhayda"><img src="https://avatars2.githubusercontent.com/u/660742?v=4" width="100px;" alt=""><br><sub><b>Zafar Khaydarov</b></sub></a></td>
+    <td align="center"><a href="https://kemitix.github.io/"><img src="https://avatars1.githubusercontent.com/u/1147749?v=4" width="100px;" alt=""><br><sub><b>Paul Campbell</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Argyro-Sioziou"><img src="https://avatars0.githubusercontent.com/u/22822639?v=4" width="100px;" alt=""><br><sub><b>Argyro Sioziou</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/TylerMcConville"><img src="https://avatars0.githubusercontent.com/u/4946449?v=4" width="100px;" alt=""><br><sub><b>TylerMcConville</b></sub></a></td>
+    <td align="center"><a href="https://github.com/saksham93"><img src="https://avatars1.githubusercontent.com/u/37399540?v=4" width="100px;" alt=""><br><sub><b>saksham93</b></sub></a></td>
+    <td align="center"><a href="https://github.com/nikhilbarar"><img src="https://avatars2.githubusercontent.com/u/37332144?v=4" width="100px;" alt=""><br><sub><b>nikhilbarar</b></sub></a></td>
+    <td align="center"><a href="http://colinbut.com"><img src="https://avatars2.githubusercontent.com/u/10725674?v=4" width="100px;" alt=""><br><sub><b>Colin But</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/ruslanpa"><img src="https://avatars2.githubusercontent.com/u/1503411?v=4" width="100px;" alt=""><br><sub><b>Ruslan</b></sub></a></td>
+    <td align="center"><a href="https://github.com/JuhoKang"><img src="https://avatars1.githubusercontent.com/u/4745294?v=4" width="100px;" alt=""><br><sub><b>Juho Kang</b></sub></a></td>
+    <td align="center"><a href="https://github.com/dheeraj-mummareddy"><img src="https://avatars2.githubusercontent.com/u/7002230?v=4" width="100px;" alt=""><br><sub><b>Dheeraj Mummareddy</b></sub></a></td>
+    <td align="center"><a href="https://www.bernardosulzbach.com"><img src="https://avatars0.githubusercontent.com/u/8271090?v=4" width="100px;" alt=""><br><sub><b>Bernardo Sulzbach</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/4lexis"><img src="https://avatars0.githubusercontent.com/u/19871727?v=4" width="100px;" alt=""><br><sub><b>Aleksandar Dudukovic</b></sub></a></td>
+    <td align="center"><a href="https://www.yusufaytas.com"><img src="https://avatars2.githubusercontent.com/u/1049483?v=4" width="100px;" alt=""><br><sub><b>Yusuf Aytaş</b></sub></a></td>
+    <td align="center"><a href="http://futurehomes.hu"><img src="https://avatars2.githubusercontent.com/u/1001491?v=4" width="100px;" alt=""><br><sub><b>Mihály Kuprivecz</b></sub></a></td>
+    <td align="center"><a href="https://github.com/kapinuss"><img src="https://avatars0.githubusercontent.com/u/17639945?v=4" width="100px;" alt=""><br><sub><b>Stanislav Kapinus</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/gvsharma"><img src="https://avatars1.githubusercontent.com/u/6648152?v=4" width="100px;" alt=""><br><sub><b>GVSharma</b></sub></a></td>
+    <td align="center"><a href="https://github.com/SrdjanPaunovic"><img src="https://avatars1.githubusercontent.com/u/22815104?v=4" width="100px;" alt=""><br><sub><b>Srđan Paunović</b></sub></a></td>
+    <td align="center"><a href="https://sideris.xyz/"><img src="https://avatars3.githubusercontent.com/u/5484694?v=4" width="100px;" alt=""><br><sub><b>Petros G. Sideris</b></sub></a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/pramodgupta3/"><img src="https://avatars1.githubusercontent.com/u/2184241?v=4" width="100px;" alt=""><br><sub><b>Pramod Gupta</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://amarnath510.github.io/portfolio"><img src="https://avatars0.githubusercontent.com/u/4599623?v=4" width="100px;" alt=""><br><sub><b>Amarnath Chandana</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Anurag870"><img src="https://avatars1.githubusercontent.com/u/6295975?v=4" width="100px;" alt=""><br><sub><b>Anurag870</b></sub></a></td>
+    <td align="center"><a href="http://theerroris.me"><img src="https://avatars0.githubusercontent.com/u/1685953?v=4" width="100px;" alt=""><br><sub><b>Wes Gilleland</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Harshrajsinh"><img src="https://avatars2.githubusercontent.com/u/22811531?v=4" width="100px;" alt=""><br><sub><b>Harshraj Thakor</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/MaVdbussche"><img src="https://avatars1.githubusercontent.com/u/26136934?v=4" width="100px;" alt=""><br><sub><b>Martin Vandenbussche</b></sub></a></td>
+    <td align="center"><a href="https://alexsomai.com"><img src="https://avatars1.githubusercontent.com/u/5720977?v=4" width="100px;" alt=""><br><sub><b>Alexandru Somai</b></sub></a></td>
+    <td align="center"><a href="https://github.com/amogozov"><img src="https://avatars3.githubusercontent.com/u/7372215?v=4" width="100px;" alt=""><br><sub><b>Artur Mogozov</b></sub></a></td>
+    <td align="center"><a href="https://github.com/anthonycampbell"><img src="https://avatars3.githubusercontent.com/u/10249255?v=4" width="100px;" alt=""><br><sub><b>anthony</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://ccygnus.com/"><img src="https://avatars1.githubusercontent.com/u/9342724?v=4" width="100px;" alt=""><br><sub><b>Christian Cygnus</b></sub></a></td>
+    <td align="center"><a href="https://about.me/dzmitryh"><img src="https://avatars2.githubusercontent.com/u/5390492?v=4" width="100px;" alt=""><br><sub><b>Dima Gubin</b></sub></a></td>
+    <td align="center"><a href="https://github.com/jjjimenez100"><img src="https://avatars3.githubusercontent.com/u/22243493?v=4" width="100px;" alt=""><br><sub><b>Joshua Jimenez</b></sub></a></td>
+    <td align="center"><a href="http://about.me/kaiwinter"><img src="https://avatars0.githubusercontent.com/u/110982?v=4" width="100px;" alt=""><br><sub><b>Kai Winter</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/lbroman"><img src="https://avatars1.githubusercontent.com/u/86007?v=4" width="100px;" alt=""><br><sub><b>lbroman</b></sub></a></td>
+    <td align="center"><a href="https://przemeknowak.com"><img src="https://avatars1.githubusercontent.com/u/3254609?v=4" width="100px;" alt=""><br><sub><b>Przemek</b></sub></a></td>
+    <td align="center"><a href="https://github.com/prafful1"><img src="https://avatars0.githubusercontent.com/u/14350274?v=4" width="100px;" alt=""><br><sub><b>Prafful Agarwal</b></sub></a></td>
+    <td align="center"><a href="https://github.com/sankypanhale"><img src="https://avatars1.githubusercontent.com/u/6478783?v=4" width="100px;" alt=""><br><sub><b>Sanket Panhale</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/staillebois"><img src="https://avatars0.githubusercontent.com/u/23701200?v=4" width="100px;" alt=""><br><sub><b>staillebois</b></sub></a></td>
+    <td align="center"><a href="https://github.com/valdar-hu"><img src="https://avatars3.githubusercontent.com/u/17962817?v=4" width="100px;" alt=""><br><sub><b>Krisztián Nagy</b></sub></a></td>
+    <td align="center"><a href="https://www.vanogrid.com"><img src="https://avatars0.githubusercontent.com/u/4307918?v=4" width="100px;" alt=""><br><sub><b>Alexander Ivanov</b></sub></a></td>
+    <td align="center"><a href="https://github.com/yosfik"><img src="https://avatars3.githubusercontent.com/u/4850270?v=4" width="100px;" alt=""><br><sub><b>Yosfik Alqadri</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/7agustibm"><img src="https://avatars0.githubusercontent.com/u/8149332?v=4" width="100px;" alt=""><br><sub><b>Agustí Becerra Milà</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Juaanma"><img src="https://avatars3.githubusercontent.com/u/7390500?v=4" width="100px;" alt=""><br><sub><b>Juan Manuel Suárez</b></sub></a></td>
+    <td align="center"><a href="http://www.devsedge.net/"><img src="https://avatars0.githubusercontent.com/u/9956006?v=4" width="100px;" alt=""><br><sub><b>Luigi Cortese</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Rzeposlaw"><img src="https://avatars2.githubusercontent.com/u/18425745?v=4" width="100px;" alt=""><br><sub><b>Katarzyna Rzepecka</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://adamski.pro"><img src="https://avatars1.githubusercontent.com/u/6537430?v=4" width="100px;" alt=""><br><sub><b>adamski.pro</b></sub></a></td>
+    <td align="center"><a href="https://github.com/baislsl"><img src="https://avatars0.githubusercontent.com/u/17060584?v=4" width="100px;" alt=""><br><sub><b>Shengli Bai</b></sub></a></td>
+    <td align="center"><a href="https://github.com/besok"><img src="https://avatars2.githubusercontent.com/u/29834592?v=4" width="100px;" alt=""><br><sub><b>Boris</b></sub></a></td>
+    <td align="center"><a href="https://github.com/dmitraver"><img src="https://avatars3.githubusercontent.com/u/1798156?v=4" width="100px;" alt=""><br><sub><b>Dmitry Avershin</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/fanofxiaofeng"><img src="https://avatars0.githubusercontent.com/u/3983683?v=4" width="100px;" alt=""><br><sub><b>靳阳</b></sub></a></td>
+    <td align="center"><a href="https://github.com/hoangnam2261"><img src="https://avatars2.githubusercontent.com/u/31692990?v=4" width="100px;" alt=""><br><sub><b>hoangnam2261</b></sub></a></td>
+    <td align="center"><a href="https://github.com/jarpit96"><img src="https://avatars2.githubusercontent.com/u/10098713?v=4" width="100px;" alt=""><br><sub><b>Arpit Jain</b></sub></a></td>
+    <td align="center"><a href="http://joningi.net"><img src="https://avatars2.githubusercontent.com/u/6115148?v=4" width="100px;" alt=""><br><sub><b>Jón Ingi Sveinbjörnsson</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/kirill-vlasov"><img src="https://avatars3.githubusercontent.com/u/16112495?v=4" width="100px;" alt=""><br><sub><b>Kirill Vlasov</b></sub></a></td>
+    <td align="center"><a href="http://mitchell-irvin.com"><img src="https://avatars0.githubusercontent.com/u/16233245?v=4" width="100px;" alt=""><br><sub><b>Mitchell Irvin</b></sub></a></td>
+    <td align="center"><a href="https://ranjeet-floyd.github.io"><img src="https://avatars0.githubusercontent.com/u/1992972?v=4" width="100px;" alt=""><br><sub><b>Ranjeet</b></sub></a></td>
+    <td align="center"><a href="https://alwayswithme.github.io"><img src="https://avatars3.githubusercontent.com/u/3234786?v=4" width="100px;" alt=""><br><sub><b>PhoenixYip</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/MSaifAsif"><img src="https://avatars1.githubusercontent.com/u/6280554?v=4" width="100px;" alt=""><br><sub><b>M Saif Asif</b></sub></a></td>
+    <td align="center"><a href="https://github.com/kanwarpreet25"><img src="https://avatars0.githubusercontent.com/u/39183641?v=4" width="100px;" alt=""><br><sub><b>kanwarpreet25</b></sub></a></td>
+    <td align="center"><a href="http://leonmak.me"><img src="https://avatars3.githubusercontent.com/u/13071508?v=4" width="100px;" alt=""><br><sub><b>Leon Mak</b></sub></a></td>
+    <td align="center"><a href="http://www.wramdemark.se"><img src="https://avatars2.githubusercontent.com/u/7052193?v=4" width="100px;" alt=""><br><sub><b>Per Wramdemark</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/waisuan"><img src="https://avatars2.githubusercontent.com/u/10975700?v=4" width="100px;" alt=""><br><sub><b>Evan Sia Wai Suan</b></sub></a></td>
+    <td align="center"><a href="https://github.com/AnaghaSasikumar"><img src="https://avatars2.githubusercontent.com/u/42939261?v=4" width="100px;" alt=""><br><sub><b>AnaghaSasikumar</b></sub></a></td>
+    <td align="center"><a href="https://christofferh.com"><img src="https://avatars1.githubusercontent.com/u/767643?v=4" width="100px;" alt=""><br><sub><b>Christoffer Hamberg</b></sub></a></td>
+    <td align="center"><a href="https://github.com/dgruntz"><img src="https://avatars0.githubusercontent.com/u/1516800?v=4" width="100px;" alt=""><br><sub><b>Dominik Gruntz</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://bitbucket.org/hannespernpeintner/"><img src="https://avatars3.githubusercontent.com/u/1679437?v=4" width="100px;" alt=""><br><sub><b>Hannes</b></sub></a></td>
+    <td align="center"><a href="https://github.com/leogtzr"><img src="https://avatars0.githubusercontent.com/u/1211969?v=4" width="100px;" alt=""><br><sub><b>Leo Gutiérrez Ramírez</b></sub></a></td>
+    <td align="center"><a href="https://github.com/npczwh"><img src="https://avatars0.githubusercontent.com/u/14066422?v=4" width="100px;" alt=""><br><sub><b>Zhang WH</b></sub></a></td>
+    <td align="center"><a href="https://github.com/oconnelc"><img src="https://avatars0.githubusercontent.com/u/1112973?v=4" width="100px;" alt=""><br><sub><b>Christopher O'Connell</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/giorgosmav21"><img src="https://avatars2.githubusercontent.com/u/22855493?v=4" width="100px;" alt=""><br><sub><b>George Mavroeidis</b></sub></a></td>
+    <td align="center"><a href="https://github.com/hbothra15"><img src="https://avatars1.githubusercontent.com/u/7418012?v=4" width="100px;" alt=""><br><sub><b>Hemant Bothra</b></sub></a></td>
+    <td align="center"><a href="https://www.kevinpeters.net/about/"><img src="https://avatars1.githubusercontent.com/u/12736734?v=4" width="100px;" alt=""><br><sub><b>Kevin Peters</b></sub></a></td>
+    <td align="center"><a href="https://llorllale.github.io/"><img src="https://avatars1.githubusercontent.com/u/2019896?v=4" width="100px;" alt=""><br><sub><b>George Aristy</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/mookkiah"><img src="https://avatars1.githubusercontent.com/u/8975264?v=4" width="100px;" alt=""><br><sub><b>Mahendran Mookkiah</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Azureyjt"><img src="https://avatars2.githubusercontent.com/u/18476317?v=4" width="100px;" alt=""><br><sub><b>Azureyjt</b></sub></a></td>
+    <td align="center"><a href="https://github.com/vehpsr"><img src="https://avatars2.githubusercontent.com/u/3133265?v=4" width="100px;" alt=""><br><sub><b>gans</b></sub></a></td>
+    <td align="center"><a href="https://github.com/ThatGuyWithTheHat"><img src="https://avatars0.githubusercontent.com/u/24470582?v=4" width="100px;" alt=""><br><sub><b>Matt</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.linkedin.com/in/gopinathlangote/"><img src="https://avatars2.githubusercontent.com/u/10210778?v=4" width="100px;" alt=""><br><sub><b>Gopinath Langote</b></sub></a></td>
+    <td align="center"><a href="https://github.com/hoswey"><img src="https://avatars3.githubusercontent.com/u/3689445?v=4" width="100px;" alt=""><br><sub><b>Hoswey</b></sub></a></td>
+    <td align="center"><a href="https://github.com/amit2103"><img src="https://avatars3.githubusercontent.com/u/7566692?v=4" width="100px;" alt=""><br><sub><b>Amit Pandey</b></sub></a></td>
+    <td align="center"><a href="https://github.com/gwildor28"><img src="https://avatars0.githubusercontent.com/u/16000365?v=4" width="100px;" alt=""><br><sub><b>gwildor28</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://t.me/paul_docker"><img src="https://avatars1.githubusercontent.com/u/2404785?v=4" width="100px;" alt=""><br><sub><b>田浩</b></sub></a></td>
+    <td align="center"><a href="https://twitter.com/StPitsios"><img src="https://avatars1.githubusercontent.com/u/6773603?v=4" width="100px;" alt=""><br><sub><b>Stamatis Pitsios</b></sub></a></td>
+    <td align="center"><a href="https://github.com/qza"><img src="https://avatars3.githubusercontent.com/u/233149?v=4" width="100px;" alt=""><br><sub><b>qza</b></sub></a></td>
+    <td align="center"><a href="http://tschis.github.io"><img src="https://avatars1.githubusercontent.com/u/20662669?v=4" width="100px;" alt=""><br><sub><b>Rodolfo Forte</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/ankurkaushal"><img src="https://avatars2.githubusercontent.com/u/2236616?v=4" width="100px;" alt=""><br><sub><b>Ankur Kaushal</b></sub></a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/ovidijus-okinskas/"><img src="https://avatars0.githubusercontent.com/u/20372387?v=4" width="100px;" alt=""><br><sub><b>Ovidijus Okinskas</b></sub></a></td>
+    <td align="center"><a href="https://github.com/robertt240"><img src="https://avatars1.githubusercontent.com/u/9137432?v=4" width="100px;" alt=""><br><sub><b>Robert Kasperczyk</b></sub></a></td>
+    <td align="center"><a href="https://github.com/trautonen"><img src="https://avatars3.githubusercontent.com/u/1641063?v=4" width="100px;" alt=""><br><sub><b>Tapio Rautonen</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://vk.com/yuri.orlov"><img src="https://avatars0.githubusercontent.com/u/1595733?v=4" width="100px;" alt=""><br><sub><b>Yuri Orlov</b></sub></a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/varunu28/"><img src="https://avatars0.githubusercontent.com/u/7676016?v=4" width="100px;" alt=""><br><sub><b>Varun Upadhyay</b></sub></a></td>
+    <td align="center"><a href="https://github.com/PalAditya"><img src="https://avatars2.githubusercontent.com/u/25523604?v=4" width="100px;" alt=""><br><sub><b>Aditya Pal</b></sub></a></td>
+    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4" width="100px;" alt=""><br><sub><b>grzesiekkedzior</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/sivasubramanim"><img src="https://avatars2.githubusercontent.com/u/51107434?v=4" width="100px;" alt=""><br><sub><b>Sivasubramani M</b></sub></a></td>
+    <td align="center"><a href="https://github.com/d4gg4d"><img src="https://avatars2.githubusercontent.com/u/99457?v=4" width="100px;" alt=""><br><sub><b>Sami Airaksinen</b></sub></a></td>
+    <td align="center"><a href="https://github.com/vertti"><img src="https://avatars0.githubusercontent.com/u/557751?v=4" width="100px;" alt=""><br><sub><b>Janne Sinivirta</b></sub></a></td>
+    <td align="center"><a href="https://github.com/Bobo1239"><img src="https://avatars1.githubusercontent.com/u/2302947?v=4" width="100px;" alt=""><br><sub><b>Boris-Chengbiao Zhou</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://jahhein.github.io"><img src="https://avatars2.githubusercontent.com/u/10779515?v=4" width="100px;" alt=""><br><sub><b>Jacob Hein</b></sub></a></td>
+    <td align="center"><a href="https://github.com/iamrichardjones"><img src="https://avatars3.githubusercontent.com/u/14842151?v=4" width="100px;" alt=""><br><sub><b>Richard Jones</b></sub></a></td>
+    <td align="center"><a href="https://rachelcarmena.github.io"><img src="https://avatars0.githubusercontent.com/u/22792183?v=4" width="100px;" alt=""><br><sub><b>Rachel M. Carmena</b></sub></a></td>
+    <td align="center"><a href="https://zd-zero.github.io"><img src="https://avatars0.githubusercontent.com/u/21978370?v=4" width="100px;" alt=""><br><sub><b>Zaerald Denze Lungos</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://webpro.nl"><img src="https://avatars1.githubusercontent.com/u/456426?v=4" width="100px;" alt=""><br><sub><b>Lars Kappert</b></sub></a></td>
+    <td align="center"><a href="https://xiaod.info"><img src="https://avatars2.githubusercontent.com/u/21277644?v=4" width="100px;" alt=""><br><sub><b>Mike Liu</b></sub></a></td>
+    <td align="center"><a href="https://github.com/charlesfinley"><img src="https://avatars1.githubusercontent.com/u/6307904?v=4" width="100px;" alt=""><br><sub><b>Matt Dolan</b></sub></a></td>
+    <td align="center"><a href="https://github.com/MananS77"><img src="https://avatars3.githubusercontent.com/u/21033516?v=4" width="100px;" alt=""><br><sub><b>Manan</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/nishant"><img src="https://avatars2.githubusercontent.com/u/15331971?v=4" width="100px;" alt=""><br><sub><b>Nishant Arora</b></sub></a></td>
+    <td align="center"><a href="https://github.com/raja-peeyush-kumar-singh"><img src="https://avatars0.githubusercontent.com/u/5496024?v=4" width="100px;" alt=""><br><sub><b>Peeyush</b></sub></a></td>
+    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""><br><sub><b>Rakesh</b></sub></a></td>
+    <td align="center"><a href="https://github.com/vINCENT8888801"><img src="https://avatars0.githubusercontent.com/u/8037883?v=4" width="100px;" alt=""><br><sub><b>Wei Seng</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.linkedin.com/in/ashish-trivedi-218379135/"><img src="https://avatars3.githubusercontent.com/u/23194128?v=4" width="100px;" alt=""><br><sub><b>Ashish Trivedi</b></sub></a></td>
+    <td align="center"><a href="https://rayyounghong.com"><img src="https://avatars1.githubusercontent.com/u/41055099?v=4" width="100px;" alt=""><br><sub><b>洪月阳</b></sub></a></td>
+    <td align="center"><a href="https://xdvrx1.github.io/"><img src="https://avatars0.githubusercontent.com/u/47092464?v=4" width="100px;" alt=""><br><sub><b>xdvrx1</b></sub></a></td>
+    <td align="center"><a href="http://subho.xyz"><img src="https://avatars0.githubusercontent.com/u/13291222?v=4" width="100px;" alt=""><br><sub><b>Subhrodip Mohanta</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""><br><sub><b>Bethan Palmer</b></sub></a></td>
+    <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4" width="100px;" alt=""><br><sub><b>Toxic Dreamz</b></sub></a></td>
+    <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4" width="100px;" alt=""><br><sub><b>Edy Cu Tjong</b></sub></a></td>
+    <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4" width="100px;" alt=""><br><sub><b>Michał Krzywański</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""><br><sub><b>Stefan Birkner</b></sub></a></td>
+    <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4" width="100px;" alt=""><br><sub><b>Fedor Skvorcov</b></sub></a></td>
+    <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4" width="100px;" alt=""><br><sub><b>samilAyoub</b></sub></a></td>
+    <td align="center"><a href="https://github.com/vdlald"><img src="https://avatars0.githubusercontent.com/u/29997701?v=4" width="100px;" alt=""><br><sub><b>Vladislav Golubinov</b></sub></a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""><br><sub><b>Swaraj</b></sub></a></td>
+  </tr>
+</table>
+
+<!-- markdownlint-enable -->
+
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
diff --git a/ko/adapter/README.md b/ko/adapter/README.md
new file mode 100644
index 000000000..8ef291972
--- /dev/null
+++ b/ko/adapter/README.md
@@ -0,0 +1,134 @@
+---
+layout: pattern
+title: Adapter
+folder: adapter
+permalink: "/patterns/adapter/"
+categories: Structural
+tags:
+- Gang of Four
+---
+
+## 또한 ~으로 알려진
+
+Wrapper
+
+## 의도
+
+클래스의 인터페이스를 클라이언트가 기대하는 다른 인터페이스로 변환합니다. adapter를 사용하면 호환되지 않는 인터페이스로 인해 같이 쓸 수 없는 클래스를 함께 작동 할 수 있습니다.
+
+## 설명
+
+예시
+
+> 메모리 카드에 몇 장의 사진이 있고 컴퓨터로 전송해야한다고 생각하십시오. 이들을 전송하려면 컴퓨터에 메모리 카드를 연결할 수 있도록 컴퓨터 포트와 호환되는 어댑터가 필요합니다. 이 경우 카드 리더는 어댑터입니다. 또 다른 예는 유명한 전원 어댑터입니다. 세 갈래 플러그는 두 갈래 콘센트에 연결할 수 없습니다. 두 갈래 콘센트와 호환되는 전원 어댑터를 사용해야합니다. 또 다른 예는 한 사람이 말한 단어를 다른 사람에게 번역하는 번역가입니다.
+
+평범하게 말하자면
+
+> adapter 패턴을 사용하면 호환되지 않는 개체를 adapter에 연결하여 다른 클래스와 호환되도록 할 수 있습니다.
+
+Wikipedia 말에 의하면
+
+> 소프트웨어 엔지니어링에서 adapter 패턴은 기존 클래스의 인터페이스를 다른 인터페이스로 사용할 수 있도록 하는 소프트웨어 디자인 패턴입니다. 소스 코드를 수정하지 않고 기존 클래스가 다른 클래스와 함께 작동하도록 만드는 데 자주 사용됩니다.
+
+**프로그램 코드 예제**
+
+조정 보트만 사용할 수 있고 전혀 항해할 수 없는 선장을 생각해보십시오.
+
+먼저 `RowingBoat` 및 `FishingBoat` 인터페이스가 있습니다.
+
+```java
+public interface RowingBoat {
+  void row();
+}
+
+public class FishingBoat {
+  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class);
+  public void sail() {
+    LOGGER.info("The fishing boat is sailing");
+  }
+}
+```
+
+그리고 선장은 `RowingBoat` 인터페이스를 이동할 수 있게 구현했습니다.
+
+```java
+public class Captain {
+
+  private final RowingBoat rowingBoat;
+  // default constructor and setter for rowingBoat
+  public Captain(RowingBoat rowingBoat) {
+    this.rowingBoat = rowingBoat;
+  }
+
+  public void row() {
+    rowingBoat.row();
+  }
+}
+```
+
+이제 해적이오고 있고 우리 선장이 탈출해야하는데 어선만 있습니다. 선장이 조정 보트 기술로 어선을 조작 할 수있는 adapter를 만들어야합니다.
+
+```java
+public class FishingBoatAdapter implements RowingBoat {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoatAdapter.class);
+
+  private final FishingBoat boat;
+
+  public FishingBoatAdapter() {
+    boat = new FishingBoat();
+  }
+
+  @Override
+  public void row() {
+    boat.sail();
+  }
+}
+```
+
+이제 `Captain` 은 `FishingBoat` 를 사용하여 해적을 탈출 할 수 있습니다.
+
+```java
+var captain = new Captain(new FishingBoatAdapter());
+captain.row();
+```
+
+## 클레스 다이어그램
+
+![alt text](https://github.com/warp125/java-design-patterns/blob/master/adapter/etc/adapter.urm.png?raw=true)
+
+## 적용 가능성
+
+다음과 같은 경우 adapter 패턴을 사용합니다.
+
+- 기존 클래스를 사용 하려는데 해당 인터페이스가 필요한 클래스와 일치하지 않습니다.
+- 관련이 없거나 예상치 못한 클래스, 즉 호환되는 인터페이스가 반드시 필요하지 않은 클래스와 협력하는 재사용 가능한 클래스를 만들고 싶습니다.
+- 기존의 여러 하위 클래스를 사용해야하지만 모든 하위 클래스를 하위 클래스로 지정하여 인터페이스를 조정하는 것은 비현실적입니다. 개체 adapter는 부모 클래스의 인터페이스를 조정할 수 있습니다.
+- 타사 라이브러리를 사용하는 대부분의 응용 프로그램은 adapter를 응용 프로그램과 타사 라이브러리 사이의 중간 계층으로 사용하여 라이브러리에서 응용 프로그램을 분리합니다. 다른 라이브러리를 사용해야하는 경우 애플리케이션 코드를 변경할 필요없이 새 라이브러리 용 adapter만 필요합니다.
+
+## 결과 :
+
+클래스 및 개체 adapter에는 서로 다른 장단점이 있습니다. <br>클래스 adapter
+
+- 구체적인 Adaptee 클래스를 커밋하여 Adaptee를 Target에 적용합니다. 결과적으로 클래스와 모든 하위 클래스를 조정하려는 경우 클래스 adapter가 작동하지 않습니다.
+- adapter는 Adaptee의 하위 클래스이기 때문에 Adaptee의 일부 동작을 오버라이드합니다.
+- 하나의 객체만 생성하고 adaptee를 얻기위해 위해 추가 포인터 간접 지정이 필요하지 않습니다.
+
+개체 adapter
+
+- 하나의 adapter가 많은 Adaptees, 즉 Adaptee 자체와 모든 하위 클래스 (있는 경우)와 함께 작동하도록합시다. adapter는 한 번에 모든 어댑터에 기능을 추가 할 수도 있습니다.
+- Adaptee 동작을 오버라이드하기가 더 어렵습니다. Adaptee를 서브 클래싱하고 어댑터가 Adaptee 자체가 아닌 서브 클래스를 참조하도록 해야합니다.
+
+## 실제 사례
+
+- [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29)
+- [java.util.Collections#list()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#list-java.util.Enumeration-)
+- [java.util.Collections#enumeration()](https://docs.oracle.com/javase/8/docs/api/java/util/Collections.html#enumeration-java.util.Collection-)
+- [javax.xml.bind.annotation.adapters.XMLAdapter](http://docs.oracle.com/javase/8/docs/api/javax/xml/bind/annotation/adapters/XmlAdapter.html#marshal-BoundType-)
+
+## 크레딧
+
+- [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+- [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
+- [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+- [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/ko/factory/README.md b/ko/factory/README.md
new file mode 100644
index 000000000..d020a9edd
--- /dev/null
+++ b/ko/factory/README.md
@@ -0,0 +1,128 @@
+---
+layout: pattern
+title: Factory
+folder: factory
+permalink: "/patterns/factory/"
+categories: Creational
+tags:
+- Gang of Four
+---
+
+## 또한 ~으로 알려진
+
+- Simple Factory
+- Static Factory Method
+
+## 의도
+
+구현 논리를 숨기고 클라이언트 코드가 새 객체를 초기화하는 대신 사용에 집중하도록하기 위해 factory라는 클래스에 캡슐화 된 정적 메서드를 제공합니다.
+
+## 설명
+
+예시
+
+> SQLServer에 연결된 웹 응용 프로그램이 있지만 이제 Oracle로 전환하려고 합니다. 기존 소스 코드를 수정하지 않고 이를 수행하려면 주어진 데이터베이스에 대한 연결을 생성하기 위해 정적 메서드를 호출 할 수 있는 Simple Factory 패턴을 구현해야합니다.
+
+Wikipedia 말에 의하면
+
+> factory는 다른 객체를 생성하기위한 객체입니다. 공식적으로 factory는 다양한 프로토 타입 또는 클래스의 객체를 반환하는 함수 또는 메서드입니다.
+
+**프로그램 코드 예제**
+
+우리는 인터페이스 `Car` 와 두 가지 구현 `Ford` 와 `Ferrari`을 가지고 있습니다.
+
+```java
+public interface Car {
+  String getDescription();
+}
+
+public class Ford implements Car {
+
+  static final String DESCRIPTION = "This is Ford.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+
+public class Ferrari implements Car {
+   
+  static final String DESCRIPTION = "This is Ferrari.";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
+}
+```
+
+열거형은 우리가 지원하는 자동차 유형을 나타냅니다 ( `Ford` 및 `Ferrari` ).
+
+```java
+public enum CarType {
+  
+  FORD(Ford::new),
+  FERRARI(Ferrari::new);
+  
+  private final Supplier<Car> constructor;
+  
+  CarType(Supplier<Car> constructor) {
+    this.constructor = constructor;
+  }
+  
+  public Supplier<Car> getConstructor() {
+    return this.constructor;
+  }
+}
+```
+
+그런 다음 factory 클래스 `CarsFactory` 캡슐화 된 자동차 객체를 만드는 정적 메서드 `getCar` 가 있습니다.
+
+```java
+public class CarsFactory {
+  
+  public static Car getCar(CarType type) {
+    return type.getConstructor().get();
+  }
+}
+```
+
+이제 클라이언트 코드에서 factory 클래스를 사용하여 다양한 유형의 자동차를 만들 수 있습니다.
+
+```java
+var car1 = CarsFactory.getCar(CarType.FORD);
+var car2 = CarsFactory.getCar(CarType.FERRARI);
+LOGGER.info(car1.getDescription());
+LOGGER.info(car2.getDescription());;
+```
+
+프로그램 출력 :
+
+```java
+This is Ford.
+This Ferrari.
+```
+
+## 클래스 다이어그램
+
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/factory/etc/factory.urm.png)
+
+## 적용 가능성
+
+객체 생성 및 관리 방법이 아닌 객체 생성에만 관심이있을 때 Simple Factory 패턴을 사용합니다.
+
+장점
+
+- 모든 객체 생성을 한곳에 유지하고 코드베이스에 '새'키 값이 확산되는 것을 방지합니다.
+- 느슨하게 결합 된 코드를 작성할 수 있습니다. 주요 장점 중 일부는 더 나은 테스트 가능성, 이해하기 쉬운 코드, 교체 가능한 구성 요소, 확장성 및 격리된 기능을 포함합니다.
+
+단점
+
+- 코드는 생각보다 복잡해집니다.
+
+## 관련 패턴
+
+- [Factory Method](https://java-design-patterns.com/patterns/factory-method/)
+- [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
+- [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/)
diff --git a/ko/observer/README.md b/ko/observer/README.md
new file mode 100644
index 000000000..7f27e3fbf
--- /dev/null
+++ b/ko/observer/README.md
@@ -0,0 +1,165 @@
+---
+layout: pattern
+title: Observer
+folder: observer
+permalink: "/patterns/observer/"
+categories: Behavioral
+tags:
+- Gang Of Four
+- Reactive
+---
+
+## 또한 ~으로 알려진
+
+Dependents, Publish-Subscribe
+
+## 의도
+
+하나의 개체가 상태를 변경하면 모든 종속 항목에 알림이 전송되고 자동으로 업데이트 되도록 개체간의 일대 다 종속성을 정의합니다.
+
+## 설명
+
+예시
+
+> 멀리 떨어진 땅에는 호빗과 오크 종족이 살고 있습니다. 둘 다 대부분 야외에 있으므로 날씨 변화를 면밀히 따릅니다. 끊임없이 날씨를 관찰하고 있다고 말할 수 있습니다.
+
+평범하게 말하자면
+
+> observer로 등록하여 개체의 상태 변경을 수신합니다.
+
+Wikipedia 말에 의하면
+
+> observer 패턴은 주제라고하는 객체가 observer라고 하는 종속 항목 목록을 유지하고 일반적으로 메서드 중 하나를 호출하여 상태 변경을 자동으로 알리는 소프트웨어 디자인 패턴입니다.
+
+**프로그램 코드 예제**
+
+먼저 `WeatherObserver` 인터페이스와 우리의 종족 `Orcs` 와 `Hobbits` 소개하겠습니다.
+
+```java
+public interface WeatherObserver {
+
+  void update(WeatherType currentWeather);
+}
+
+public class Orcs implements WeatherObserver {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class);
+
+  @Override
+  public void update(WeatherType currentWeather) {
+    LOGGER.info("The orcs are facing " + currentWeather.getDescription() + " weather now");
+  }
+}
+
+public class Hobbits implements WeatherObserver {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class);
+
+  @Override
+  public void update(WeatherType currentWeather) {
+    switch (currentWeather) {
+      LOGGER.info("The hobbits are facing " + currentWeather.getDescription() + " weather now");
+    }
+  }
+}
+```
+
+그리고 끊임없이 변화하는 `Weather` 가 있습니다.
+
+```java
+public class Weather {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class);
+
+  private WeatherType currentWeather;
+  private final List<WeatherObserver> observers;
+
+  public Weather() {
+    observers = new ArrayList<>();
+    currentWeather = WeatherType.SUNNY;
+  }
+
+  public void addObserver(WeatherObserver obs) {
+    observers.add(obs);
+  }
+
+  public void removeObserver(WeatherObserver obs) {
+    observers.remove(obs);
+  }
+
+  /**
+   * Makes time pass for weather.
+   */
+  public void timePasses() {
+    var enumValues = WeatherType.values();
+    currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
+    LOGGER.info("The weather changed to {}.", currentWeather);
+    notifyObservers();
+  }
+
+  private void notifyObservers() {
+    for (var obs : observers) {
+      obs.update(currentWeather);
+    }
+  }
+}
+```
+
+여기에 전체 예제가 있습니다.
+
+```java
+    var weather = new Weather();
+    weather.addObserver(new Orcs());
+    weather.addObserver(new Hobbits());
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+```
+
+프로그램 출력 :
+
+```
+The weather changed to rainy.
+The orcs are facing rainy weather now
+The hobbits are facing rainy weather now
+The weather changed to windy.
+The orcs are facing windy weather now
+The hobbits are facing windy weather now
+The weather changed to cold.
+The orcs are facing cold weather now
+The hobbits are facing cold weather now
+The weather changed to sunny.
+The orcs are facing sunny weather now
+The hobbits are facing sunny weather now
+```
+
+## 클래스 다이어그램
+
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/observer/etc/observer.png)
+
+## 적용 가능성
+
+다음 상황에서 관찰자 패턴을 사용하십시오.
+
+- 추상화에 두 가지 측면이 있을 때 하나는 다른 하나에 종속됩니다. 이러한 측면을 별도의 개체에 캡슐화하면 독립적으로 변경하고 재사용 할 수 있습니다.
+- 한 개체를 변경하려면 얼마나 다른 개체를 변경해야 하는지 알 수 없는 경우입니다.
+- 개체가 다른 개체가 누구인지 가정하지 않고 알릴 수 있어야하는 경우. 즉, 개체가 단단히 결합되는 것을 원하지 않습니다.
+
+## 일반적인 사용 사례
+
+- 한 개체를 변경하면 다른 개체도 변경됩니다.
+
+## 실제 사례
+
+- [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html)
+- [java.util.EventListener](http://docs.oracle.com/javase/8/docs/api/java/util/EventListener.html)
+- [javax.servlet.http.HttpSessionBindingListener](http://docs.oracle.com/javaee/7/api/javax/servlet/http/HttpSessionBindingListener.html)
+- [RxJava](https://github.com/ReactiveX/RxJava)
+
+## 크레딧
+
+- [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+- [Java Generics and Collections](https://www.amazon.com/gp/product/0596527756/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596527756&linkCode=as2&tag=javadesignpat-20&linkId=246e5e2c26fe1c3ada6a70b15afcb195)
+- [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+- [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/ko/prototype/README.md b/ko/prototype/README.md
new file mode 100644
index 000000000..d15e6daaf
--- /dev/null
+++ b/ko/prototype/README.md
@@ -0,0 +1,87 @@
+---
+layout: pattern
+title: Prototype
+folder: prototype
+permalink: "/patterns/prototype/"
+categories: Creational
+tags:
+- Gang Of Four
+- Instantiation
+---
+
+## 의도
+
+prototype 인스턴스를 사용하여 만들 개체의 종류를 지정하고  prototype을 복사하여 새 개체를 만듭니다.
+
+## 설명
+
+먼저 성능 이점을 얻기 위해 prototype 패턴이 사용되지 않는다는 점에 유의해야합니다. 오직 prototype 인스턴스에서 새 개체를 만드는 데만 사용됩니다.
+
+예시
+
+> 복제된 양인 돌리에 대해 기억나십니까? 자세한 내용은 다루지 않겠습니다만 여기서 핵심은 복제에 관한 것입니다.
+
+평범한 말하자면
+
+> 복제를 통해 기존 개체를 기반으로 개체를 만듭니다.
+
+Wikipedia 말에 의하면
+
+> prototype 패턴은 소프트웨어 개발에서 생성 디자인 패턴입니다. 생성 할 개체의 유형이 새 개체를 생성하기 위해 복제되는 prototype 인스턴스에 의해 결정될 때 사용됩니다.
+
+간단히 말해, 객체를 처음부터 만들고 설정하는 문제를 겪는 대신 기존 객체의 복사본을 만들어 필요에 맞게 수정할 수 있습니다.
+
+**프로그램 코드 예제**
+
+Java에서는 `Cloneable` 을 구현하고 `Object` 에서 `clone` 을 오버라이딩하여 쉽게 수행 할 수 있습니다.
+
+```java
+class Sheep implements Cloneable {
+  private String name;
+  public Sheep(String name) { this.name = name; }
+  public void setName(String name) { this.name = name; }
+  public String getName() { return name; }
+  @Override
+  public Sheep clone() {
+    try {
+      return (Sheep)super.clone();
+    } catch(CloneNotSuportedException) {
+      throw new InternalError();
+    }
+  }
+}
+```
+
+그런 다음 아래와 같이 복제할 수 있습니다.
+
+```java
+var original = new Sheep("Jolly");
+System.out.println(original.getName()); // Jolly
+
+// Clone and modify what is required
+var cloned = original.clone();
+cloned.setName("Dolly");
+System.out.println(cloned.getName()); // Dolly
+```
+
+## 클래스 다이어그램
+
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/prototype/etc/prototype.urm.png)
+
+## 적용 가능성
+
+시스템이 제품의 생성, 구성, 표현 및 표현 방식에 독립적이어야 할 때 prototype 패턴을 사용
+
+- 인스턴스화할 클래스가 런타임에 지정되는 경우 (예 : 동적 로딩)
+- 제품의 클래스 계층 구조와 유사한 팩토리의 클래스 계층 구조 구축을 방지해야할 경우
+- 클래스의 인스턴스가 몇 가지 다른 상태 조합 중 하나만 가질 수 있는 경우. 적절한 상태로 매번 클래스를 수동으로 인스턴스화하는 것보다 해당하는 수의 prototype을 설치하고 복제하는 것이 더 편리 할 수 있습니다.
+- 복제에 비해 개체 생성 비용이 많이 드는 경우.
+
+## 실제 사례
+
+- [java.lang.Object#clone()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29)
+
+## 크레딧
+
+- [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+- [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
diff --git a/ko/singleton/README.md b/ko/singleton/README.md
new file mode 100644
index 000000000..8875e56eb
--- /dev/null
+++ b/ko/singleton/README.md
@@ -0,0 +1,84 @@
+---
+layout: pattern
+title: Singleton
+folder: singleton
+permalink: "/patterns/singleton/"
+categories: Creational
+tags:
+- Gang of Four
+---
+
+## 의도
+
+클래스에 인스턴스가 하나만 있는지 확인하고 이에 대한 전역 access point을 제공합니다.
+
+## 설명
+
+예시
+
+> 마법사들이 마법을 연구하는 상아탑은 단 하나뿐입니다. 마법사는 항상 동일한 마법의 상아탑을 사용합니다. 여기서 상아탑은 singleton입니다.
+
+평범하게 말하자면
+
+> 특정 클래스의 개체가 하나만 생성되도록합니다.
+
+Wikipedia 말에 의하면
+
+> 소프트웨어 엔지니어링에서 singleton 패턴은 클래스의 인스턴스화를 하나의 객체로 제한하는 소프트웨어 디자인 패턴입니다. 이는 시스템 전체에서 작업을 조정하는 데 정확히 하나의 개체가 필요할 때 유용합니다.
+
+**프로그램 코드 예제**
+
+Joshua Bloch, Effective Java 2nd Edition p.18
+
+> 단일 요소 열거형은 singleton을 구현하는 가장 좋은 방법입니다.
+
+```java
+public enum EnumIvoryTower {
+  INSTANCE
+}
+```
+
+그런 다음 사용하려면 :
+
+```java
+var enumIvoryTower1 = EnumIvoryTower.INSTANCE;
+var enumIvoryTower2 = EnumIvoryTower.INSTANCE;
+assertEquals(enumIvoryTower1, enumIvoryTower2); // true
+```
+
+## 클래스 다이어그램
+
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/singleton/etc/singleton.urm.png)
+
+## 적용 가능성
+
+다음과 같은 경우 Singleton 패턴을 사용합니다.
+
+- 정확히 하나의 클래스 인스턴스가 있어야하며 잘 알려진 access point에서 클라이언트에 접근할 수 있어야합니다.
+- 단일 인스턴스가 서브 클래싱으로 확장 가능해야하고 클라이언트가 코드를 수정하지 않고 확장 인스턴스를 사용할 수 있어야 하는 경우
+
+## 일반적인 사용 사례
+
+- 로깅 클래스
+- 데이터베이스에 대한 연결 관리
+- 파일 관리자
+
+## 실제 사례
+
+- [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29)
+- [java.awt.Desktop#getDesktop()](http://docs.oracle.com/javase/8/docs/api/java/awt/Desktop.html#getDesktop--)
+- [java.lang.System#getSecurityManager()](http://docs.oracle.com/javase/8/docs/api/java/lang/System.html#getSecurityManager--)
+
+## 결과
+
+- 자체 생성 및 수명주기를 제어하여 SRP (Single Responsibility Principle)를 위반합니다.
+- 이 개체가 사용하는 개체와 리소스가 할당 해제되는 것을 방지하는 전역 공유 인스턴스를 사용하도록 권장합니다.
+- 밀접하게 연결된 코드를 만듭니다. Singleton의 클라이언트는 테스트하기가 어려워집니다.
+- Singleton의 하위 클래스를 만드는 것이 거의 불가능합니다.
+
+## 크레딧
+
+- [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+- [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb)
+- [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+- [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

From 85a05dd7182dfeaa5587e56ea143bf6ea2f12ac4 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 20 Dec 2020 20:20:51 +0200
Subject: [PATCH 193/254] docs: add warp125 as a contributor (#1619)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index afa307512..0851efc4b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1341,6 +1341,15 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "warp125",
+      "name": "warp125",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/48073115?v=4",
+      "profile": "https://github.com/warp125",
+      "contributions": [
+        "translation"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index e07f2a4bc..a25b13bf5 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-147-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 # Introduction
@@ -289,6 +289,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/siavashsoleymani"><img src="https://avatars2.githubusercontent.com/u/18074419?v=4" width="100px;" alt=""/><br /><sub><b>siavash</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=siavashsoleymani" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/ruchpeanuts"><img src="https://avatars0.githubusercontent.com/u/29301900?v=4" width="100px;" alt=""/><br /><sub><b>ruchpeanuts</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruchpeanuts" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/warp125"><img src="https://avatars1.githubusercontent.com/u/48073115?v=4" width="100px;" alt=""/><br /><sub><b>warp125</b></sub></a><br /><a href="#translation-warp125" title="Translation">🌍</a></td>
   </tr>
 </table>
 

From 829cd41455cf142e528bb71f590392bdc6a38d6f Mon Sep 17 00:00:00 2001
From: KHADIR Tayeb <45130488+tkhadir@users.noreply.github.com>
Date: Mon, 4 Jan 2021 14:57:32 +0100
Subject: [PATCH 194/254] #1620 french translation - initialization part
 (#1622)

* :rocket: init fr translation

* #1620 evo add french translation - main part

* #1620 evo add french translation - main part

* #1620 evo french translation - add french flag

* Update README.md

* Update README.md

* #1620 add cn and kr flags

* Update README.md

* Update README.md

* Update README.md

* Update README.md
---
 README.md           |   6 +++++
 assets/flags/CN.png | Bin 0 -> 310 bytes
 assets/flags/FR.png | Bin 0 -> 100 bytes
 assets/flags/KR.png | Bin 0 -> 413 bytes
 fr/README.md        |  60 ++++++++++++++++++++++++++++++++++++++++++++
 5 files changed, 66 insertions(+)
 create mode 100644 assets/flags/CN.png
 create mode 100644 assets/flags/FR.png
 create mode 100644 assets/flags/KR.png
 create mode 100644 fr/README.md

diff --git a/README.md b/README.md
index a25b13bf5..3b58e2df7 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,12 @@
 [![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
+<br/>
+
+Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),
+
+<br/>
+
 # Introduction
 
 Design patterns are the best formalized practices a programmer can use to
diff --git a/assets/flags/CN.png b/assets/flags/CN.png
new file mode 100644
index 0000000000000000000000000000000000000000..edd5f1de864017f0edc1cab1b6f30f4670666d00
GIT binary patch
literal 310
zcmV-60m=S}P)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0002}Nkl<ZILl-B
z|NlP&C76LK2HevW_)iYTYQSAJAguwx_x1Syzli7le_sd4S0`iuP{SQ*!T-;~c>dov
z;QxO|0ce0e(11kl{|}7#frdd1#$~_*6aN3N3%LIOJiz?_(+u|iPXl@W-&F+~DkJ#+
zMFRK#7fIaz?<(Oj;I4|`|JOxa|Nnns`2Xt=)Bgvi{QvK%K@@_$phLh5ca;SHKab$~
z|E84d|C<U<h?9Z-z9SD5kKzI2yUK(D5opUD1wlwaY6EQs;>S*W{~y@{u`M4)Kw=u8
zfkXopKQQF~|E8Q1>;+JG5EYH+_^uj>>44&dM3w;qpP4AZ0FAYHg6YcW1^@s607*qo
IM6N<$g3i~HiU0rr

literal 0
HcmV?d00001

diff --git a/assets/flags/FR.png b/assets/flags/FR.png
new file mode 100644
index 0000000000000000000000000000000000000000..0706dcc0569404b481255d721df7348c5e0f5bc0
GIT binary patch
literal 100
zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`+MX_sAr_~TfBgS%&#XG5QH#x>
xMek>S-^GK~?!i1ZSqD}yHlJx|Jnu6lfuYLt0%J<%y&j-822WQ%mvv4FO#nZiAFTiY

literal 0
HcmV?d00001

diff --git a/assets/flags/KR.png b/assets/flags/KR.png
new file mode 100644
index 0000000000000000000000000000000000000000..d21bef98a8ecd038aa65566dacff85b01fdf411a
GIT binary patch
literal 413
zcmV;O0b>4%P)<h;3K|Lk000e1NJLTq000mG000mO1^@s6AM^iV0004GNkl<ZILpP8
zu}cDR6vq!N914QwXvnt03Y!{j)EgAFt&kuPatY!pg8qQQp&Z&8BJD1MRy7-hq@c+}
zrSSAO3N4j)q#&OL2?~wCf*w40!+T%&e)v8KkbcwBUkUVDUj@?XG^(m%7)HmYX_{!7
zMk<x+E+B-!=kqb|bdt;G+eZ%-%#sd3p;W@{b`uJPs8*|;0@-X9S(e$0M4-{+ae0gE
z;54@bcJ#${cx!STJHh30k;!DbTM$C<VjAd&8rRYYch(6m2WGgCY&=DdcsA-(DwXdU
zeAG@j%DH6{b$AY&eU+i{5b>p*pCJk%FpWC9r#JMCu3(*7Lvm~)jfIIGU18K;Kl|@w
z;PrZm9_;hhY~kNlvCMAJ?@;h7Cm4+uXPSz~<LS;o*L8xyAhIlTpUVMI)N2&Vwf0;r
z5C|-wC<^6rxx0mAGD$2J`!)yhc$`Ec@iW9;lKB76)N{WBh?O}6HGr6Q00000NkvXX
Hu0mjf;e5D|

literal 0
HcmV?d00001

diff --git a/fr/README.md b/fr/README.md
new file mode 100644
index 000000000..8d0cee739
--- /dev/null
+++ b/fr/README.md
@@ -0,0 +1,60 @@
+<!-- Cette ligne doit restée vide pour des raisons de formatage
+    afin qu'on puisse avoir un affichage agréable comme sur un 
+    site web par exemple -->
+
+# Les patrons de conception implémentés en Java
+
+![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
+[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
+[![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+# Introduction
+
+Le patron de conception est la meilleure formatalisation qu'un programmeur
+peut utiliser pour résoudre un problème lors d'une conception d'une application/system.
+
+Le patron de conception (design pattern) est là pour accélérer le processus de 
+développement en fournissant des paradigmes éprouvés.
+
+La réutilisation de patron de conception aide à prévenir des problèmes subtiles mais
+qui sont à l'origine de problèmes majeures, comme cette pratique augmente la lisibilitée
+du code par les développeurs/architectes familiers avec l'utilisation de ces concepts.
+
+# Commencer
+
+Ce site présente des modèles de conception Java. Les solutions ont été développées par des
+développeurs et architectes expérimentés de la communauté open source. Les modèles peuvent être parcourus par leurs descriptions de haut niveau ou en regardant leur code source. Les exemples de code source sont bien commentés et peuvent être considérés comme tutoriels de programmation sur la façon d'implémenter un modèle spécifique. Nous utilisons le plus technologies Java open source éprouvées au combat.
+
+Avant de plonger dans le matériau, vous devez vous familiariser avec divers
+[Principes de conception de logiciels](https://java-design-patterns.com/principles/).
+
+Toutes les conceptions doivent être aussi simples que possible. Vous devriez commencer par KISS, YAGNI,
+et faire la chose la plus simple qui pourrait éventuellement fonctionner principes. Complexité et
+les modèles ne devraient être introduits que lorsqu'ils sont nécessaires pour
+extensibilité.
+
+Une fois que vous êtes familiarisé avec ces concepts, vous pouvez commencer à explorer
+[modèles de conception disponibles](https://java-design-patterns.com/patterns/) par tout
+des approches suivantes
+
+ - Recherchez un modèle spécifique par son nom. Vous n'en trouvez pas? Veuillez signaler un nouveau modèle [ici](https://github.com/iluwatar/java-design-patterns/issues).
+ - Utilisation de balises telles que `Performance`, `Gang of Four` ou `Data access`.
+ - Utilisation des catégories de modèles, `Créatif`, `Comportemental` et autres.
+
+J'espère que les solutions orientées objet présentées sur ce site vous seront utiles
+dans vos architectures et ayez autant de plaisir à les apprendre que nous en avons eu à les développer.
+
+# Comment contribuer
+
+Si vous souhaitez contribuer au projet, vous trouverez les informations pertinentes dans
+notre [wiki développeur](https://github.com/iluwatar/java-design-patterns/wiki). Nous aiderons
+vous et répondez à vos questions dans le [Gitter chatroom](https://gitter.im/iluwatar/java-design-patterns).
+
+# Licence
+
+Ce projet est concédé sous les termes de la licence MIT.

From bbc4fdfc242553c232a3246d1b909fd447a29e3b Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Mon, 4 Jan 2021 19:42:58 +0530
Subject: [PATCH 195/254] docs: add tkhadir as a contributor (#1623)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 .all-contributorsrc |   9 ++
 README.md           | 304 ++++++++++++++++++++++----------------------
 2 files changed, 163 insertions(+), 150 deletions(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 0851efc4b..9310e5e1e 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1350,6 +1350,15 @@
       "contributions": [
         "translation"
       ]
+    },
+    {
+      "login": "tkhadir",
+      "name": "KHADIR Tayeb",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/45130488?v=4",
+      "profile": "http://libkhadir.fr",
+      "contributions": [
+        "translation"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 3b58e2df7..cc1e1bc3f 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-149-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -76,229 +76,233 @@ This project is licensed under the terms of the MIT license.
 <!-- markdownlint-disable -->
 <table>
   <tr>
-    <td align="center"><a href="https://github.com/iluwatar"><img src="https://avatars1.githubusercontent.com/u/582346?v=4" width="100px;" alt=""/><br /><sub><b>Ilkka Seppälä</b></sub></a><br /><a href="#projectManagement-iluwatar" title="Project Management">📆</a> <a href="#maintenance-iluwatar" title="Maintenance">🚧</a> <a href="#content-iluwatar" title="Content">🖋</a></td>
-    <td align="center"><a href="https://github.com/amit1307"><img src="https://avatars0.githubusercontent.com/u/23420222?v=4" width="100px;" alt=""/><br /><sub><b>amit1307</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amit1307" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/npathai"><img src="https://avatars2.githubusercontent.com/u/1792515?v=4" width="100px;" alt=""/><br /><sub><b>Narendra Pathai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=npathai" title="Code">💻</a> <a href="#ideas-npathai" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Anpathai" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://github.com/fluxw42"><img src="https://avatars1.githubusercontent.com/u/1545460?v=4" width="100px;" alt=""/><br /><sub><b>Jeroen Meulemeester</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fluxw42" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/iluwatar"><img src="https://avatars1.githubusercontent.com/u/582346?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ilkka Seppälä</b></sub></a><br /><a href="#projectManagement-iluwatar" title="Project Management">📆</a> <a href="#maintenance-iluwatar" title="Maintenance">🚧</a> <a href="#content-iluwatar" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/amit1307"><img src="https://avatars0.githubusercontent.com/u/23420222?v=4?s=100" width="100px;" alt=""/><br /><sub><b>amit1307</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amit1307" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/npathai"><img src="https://avatars2.githubusercontent.com/u/1792515?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Narendra Pathai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=npathai" title="Code">💻</a> <a href="#ideas-npathai" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Anpathai" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/fluxw42"><img src="https://avatars1.githubusercontent.com/u/1545460?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jeroen Meulemeester</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fluxw42" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="http://www.joemccarthy.co.uk"><img src="https://avatars0.githubusercontent.com/u/4526195?v=4" width="100px;" alt=""/><br /><sub><b>Joseph McCarthy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mikulucky" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/thomasoss"><img src="https://avatars1.githubusercontent.com/u/22516154?v=4" width="100px;" alt=""/><br /><sub><b>Thomas</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=thomasoss" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/anuragagarwal561994"><img src="https://avatars1.githubusercontent.com/u/6075379?v=4" width="100px;" alt=""/><br /><sub><b>Anurag Agarwal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=anuragagarwal561994" title="Code">💻</a></td>
-    <td align="center"><a href="https://markusmo3.github.io"><img src="https://avatars1.githubusercontent.com/u/3317416?v=4" width="100px;" alt=""/><br /><sub><b>Markus Moser</b></sub></a><br /><a href="#design-markusmo3" title="Design">🎨</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=markusmo3" title="Code">💻</a> <a href="#ideas-markusmo3" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="http://www.joemccarthy.co.uk"><img src="https://avatars0.githubusercontent.com/u/4526195?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Joseph McCarthy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mikulucky" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/thomasoss"><img src="https://avatars1.githubusercontent.com/u/22516154?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Thomas</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=thomasoss" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/anuragagarwal561994"><img src="https://avatars1.githubusercontent.com/u/6075379?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Anurag Agarwal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=anuragagarwal561994" title="Code">💻</a></td>
+    <td align="center"><a href="https://markusmo3.github.io"><img src="https://avatars1.githubusercontent.com/u/3317416?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Markus Moser</b></sub></a><br /><a href="#design-markusmo3" title="Design">🎨</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=markusmo3" title="Code">💻</a> <a href="#ideas-markusmo3" title="Ideas, Planning, & Feedback">🤔</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://twitter.com/i_sabiq"><img src="https://avatars1.githubusercontent.com/u/19510920?v=4" width="100px;" alt=""/><br /><sub><b>Sabiq Ihab</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=isabiq" title="Code">💻</a></td>
-    <td align="center"><a href="http://inbravo.github.io"><img src="https://avatars3.githubusercontent.com/u/5253764?v=4" width="100px;" alt=""/><br /><sub><b>Amit Dixit</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=inbravo" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/piyushchaudhari04"><img src="https://avatars3.githubusercontent.com/u/10268029?v=4" width="100px;" alt=""/><br /><sub><b>Piyush Kailash Chaudhari</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=piyushchaudhari04" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/joshzambales"><img src="https://avatars1.githubusercontent.com/u/8704552?v=4" width="100px;" alt=""/><br /><sub><b>joshzambales</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=joshzambales" title="Code">💻</a></td>
+    <td align="center"><a href="https://twitter.com/i_sabiq"><img src="https://avatars1.githubusercontent.com/u/19510920?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sabiq Ihab</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=isabiq" title="Code">💻</a></td>
+    <td align="center"><a href="http://inbravo.github.io"><img src="https://avatars3.githubusercontent.com/u/5253764?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Amit Dixit</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=inbravo" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/piyushchaudhari04"><img src="https://avatars3.githubusercontent.com/u/10268029?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Piyush Kailash Chaudhari</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=piyushchaudhari04" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/joshzambales"><img src="https://avatars1.githubusercontent.com/u/8704552?v=4?s=100" width="100px;" alt=""/><br /><sub><b>joshzambales</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=joshzambales" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/Crossy147"><img src="https://avatars2.githubusercontent.com/u/7272996?v=4" width="100px;" alt=""/><br /><sub><b>Kamil Pietruszka</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Crossy147" title="Code">💻</a></td>
-    <td align="center"><a href="http://cs.joensuu.fi/~zkhayda"><img src="https://avatars2.githubusercontent.com/u/660742?v=4" width="100px;" alt=""/><br /><sub><b>Zafar Khaydarov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=zafarella" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=zafarella" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://kemitix.github.io/"><img src="https://avatars1.githubusercontent.com/u/1147749?v=4" width="100px;" alt=""/><br /><sub><b>Paul Campbell</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kemitix" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Argyro-Sioziou"><img src="https://avatars0.githubusercontent.com/u/22822639?v=4" width="100px;" alt=""/><br /><sub><b>Argyro Sioziou</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Argyro-Sioziou" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Crossy147"><img src="https://avatars2.githubusercontent.com/u/7272996?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kamil Pietruszka</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Crossy147" title="Code">💻</a></td>
+    <td align="center"><a href="http://cs.joensuu.fi/~zkhayda"><img src="https://avatars2.githubusercontent.com/u/660742?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Zafar Khaydarov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=zafarella" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=zafarella" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://kemitix.github.io/"><img src="https://avatars1.githubusercontent.com/u/1147749?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Paul Campbell</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kemitix" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Argyro-Sioziou"><img src="https://avatars0.githubusercontent.com/u/22822639?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Argyro Sioziou</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Argyro-Sioziou" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/TylerMcConville"><img src="https://avatars0.githubusercontent.com/u/4946449?v=4" width="100px;" alt=""/><br /><sub><b>TylerMcConville</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=TylerMcConville" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/saksham93"><img src="https://avatars1.githubusercontent.com/u/37399540?v=4" width="100px;" alt=""/><br /><sub><b>saksham93</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=saksham93" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/nikhilbarar"><img src="https://avatars2.githubusercontent.com/u/37332144?v=4" width="100px;" alt=""/><br /><sub><b>nikhilbarar</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nikhilbarar" title="Code">💻</a></td>
-    <td align="center"><a href="http://colinbut.com"><img src="https://avatars2.githubusercontent.com/u/10725674?v=4" width="100px;" alt=""/><br /><sub><b>Colin But</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=colinbut" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/TylerMcConville"><img src="https://avatars0.githubusercontent.com/u/4946449?v=4?s=100" width="100px;" alt=""/><br /><sub><b>TylerMcConville</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=TylerMcConville" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/saksham93"><img src="https://avatars1.githubusercontent.com/u/37399540?v=4?s=100" width="100px;" alt=""/><br /><sub><b>saksham93</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=saksham93" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nikhilbarar"><img src="https://avatars2.githubusercontent.com/u/37332144?v=4?s=100" width="100px;" alt=""/><br /><sub><b>nikhilbarar</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nikhilbarar" title="Code">💻</a></td>
+    <td align="center"><a href="http://colinbut.com"><img src="https://avatars2.githubusercontent.com/u/10725674?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Colin But</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=colinbut" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/ruslanpa"><img src="https://avatars2.githubusercontent.com/u/1503411?v=4" width="100px;" alt=""/><br /><sub><b>Ruslan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruslanpa" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/JuhoKang"><img src="https://avatars1.githubusercontent.com/u/4745294?v=4" width="100px;" alt=""/><br /><sub><b>Juho Kang</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=JuhoKang" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/dheeraj-mummareddy"><img src="https://avatars2.githubusercontent.com/u/7002230?v=4" width="100px;" alt=""/><br /><sub><b>Dheeraj Mummareddy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dheeraj-mummareddy" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.bernardosulzbach.com"><img src="https://avatars0.githubusercontent.com/u/8271090?v=4" width="100px;" alt=""/><br /><sub><b>Bernardo Sulzbach</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=bernardosulzbach" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ruslanpa"><img src="https://avatars2.githubusercontent.com/u/1503411?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ruslan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruslanpa" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/JuhoKang"><img src="https://avatars1.githubusercontent.com/u/4745294?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Juho Kang</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=JuhoKang" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/dheeraj-mummareddy"><img src="https://avatars2.githubusercontent.com/u/7002230?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dheeraj Mummareddy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dheeraj-mummareddy" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.bernardosulzbach.com"><img src="https://avatars0.githubusercontent.com/u/8271090?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Bernardo Sulzbach</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=bernardosulzbach" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/4lexis"><img src="https://avatars0.githubusercontent.com/u/19871727?v=4" width="100px;" alt=""/><br /><sub><b>Aleksandar Dudukovic</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=4lexis" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.yusufaytas.com"><img src="https://avatars2.githubusercontent.com/u/1049483?v=4" width="100px;" alt=""/><br /><sub><b>Yusuf Aytaş</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yusufaytas" title="Code">💻</a></td>
-    <td align="center"><a href="http://futurehomes.hu"><img src="https://avatars2.githubusercontent.com/u/1001491?v=4" width="100px;" alt=""/><br /><sub><b>Mihály Kuprivecz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qpi" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/kapinuss"><img src="https://avatars0.githubusercontent.com/u/17639945?v=4" width="100px;" alt=""/><br /><sub><b>Stanislav Kapinus</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kapinuss" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/4lexis"><img src="https://avatars0.githubusercontent.com/u/19871727?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Aleksandar Dudukovic</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=4lexis" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.yusufaytas.com"><img src="https://avatars2.githubusercontent.com/u/1049483?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Yusuf Aytaş</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yusufaytas" title="Code">💻</a></td>
+    <td align="center"><a href="http://futurehomes.hu"><img src="https://avatars2.githubusercontent.com/u/1001491?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mihály Kuprivecz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qpi" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/kapinuss"><img src="https://avatars0.githubusercontent.com/u/17639945?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Stanislav Kapinus</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kapinuss" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/gvsharma"><img src="https://avatars1.githubusercontent.com/u/6648152?v=4" width="100px;" alt=""/><br /><sub><b>GVSharma</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gvsharma" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/SrdjanPaunovic"><img src="https://avatars1.githubusercontent.com/u/22815104?v=4" width="100px;" alt=""/><br /><sub><b>Srđan Paunović</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=SrdjanPaunovic" title="Code">💻</a></td>
-    <td align="center"><a href="https://sideris.xyz/"><img src="https://avatars3.githubusercontent.com/u/5484694?v=4" width="100px;" alt=""/><br /><sub><b>Petros G. Sideris</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sideris" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.linkedin.com/in/pramodgupta3/"><img src="https://avatars1.githubusercontent.com/u/2184241?v=4" width="100px;" alt=""/><br /><sub><b>Pramod Gupta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AIAmPramod" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/gvsharma"><img src="https://avatars1.githubusercontent.com/u/6648152?v=4?s=100" width="100px;" alt=""/><br /><sub><b>GVSharma</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gvsharma" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/SrdjanPaunovic"><img src="https://avatars1.githubusercontent.com/u/22815104?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Srđan Paunović</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=SrdjanPaunovic" title="Code">💻</a></td>
+    <td align="center"><a href="https://sideris.xyz/"><img src="https://avatars3.githubusercontent.com/u/5484694?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Petros G. Sideris</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sideris" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/pramodgupta3/"><img src="https://avatars1.githubusercontent.com/u/2184241?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Pramod Gupta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AIAmPramod" title="Reviewed Pull Requests">👀</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://amarnath510.github.io/portfolio"><img src="https://avatars0.githubusercontent.com/u/4599623?v=4" width="100px;" alt=""/><br /><sub><b>Amarnath Chandana</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Amarnath510" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Anurag870"><img src="https://avatars1.githubusercontent.com/u/6295975?v=4" width="100px;" alt=""/><br /><sub><b>Anurag870</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Documentation">📖</a></td>
-    <td align="center"><a href="http://theerroris.me"><img src="https://avatars0.githubusercontent.com/u/1685953?v=4" width="100px;" alt=""/><br /><sub><b>Wes Gilleland</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Deathnerd" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Harshrajsinh"><img src="https://avatars2.githubusercontent.com/u/22811531?v=4" width="100px;" alt=""/><br /><sub><b>Harshraj Thakor</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Harshrajsinh" title="Code">💻</a></td>
+    <td align="center"><a href="https://amarnath510.github.io/portfolio"><img src="https://avatars0.githubusercontent.com/u/4599623?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Amarnath Chandana</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Amarnath510" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Anurag870"><img src="https://avatars1.githubusercontent.com/u/6295975?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Anurag870</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=Anurag870" title="Documentation">📖</a></td>
+    <td align="center"><a href="http://theerroris.me"><img src="https://avatars0.githubusercontent.com/u/1685953?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Wes Gilleland</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Deathnerd" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Harshrajsinh"><img src="https://avatars2.githubusercontent.com/u/22811531?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Harshraj Thakor</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Harshrajsinh" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/MaVdbussche"><img src="https://avatars1.githubusercontent.com/u/26136934?v=4" width="100px;" alt=""/><br /><sub><b>Martin Vandenbussche</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=MaVdbussche" title="Code">💻</a></td>
-    <td align="center"><a href="https://alexsomai.com"><img src="https://avatars1.githubusercontent.com/u/5720977?v=4" width="100px;" alt=""/><br /><sub><b>Alexandru Somai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=alexsomai" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/amogozov"><img src="https://avatars3.githubusercontent.com/u/7372215?v=4" width="100px;" alt=""/><br /><sub><b>Artur Mogozov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amogozov" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/anthonycampbell"><img src="https://avatars3.githubusercontent.com/u/10249255?v=4" width="100px;" alt=""/><br /><sub><b>anthony</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=anthonycampbell" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/MaVdbussche"><img src="https://avatars1.githubusercontent.com/u/26136934?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Martin Vandenbussche</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=MaVdbussche" title="Code">💻</a></td>
+    <td align="center"><a href="https://alexsomai.com"><img src="https://avatars1.githubusercontent.com/u/5720977?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alexandru Somai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=alexsomai" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/amogozov"><img src="https://avatars3.githubusercontent.com/u/7372215?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Artur Mogozov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amogozov" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/anthonycampbell"><img src="https://avatars3.githubusercontent.com/u/10249255?v=4?s=100" width="100px;" alt=""/><br /><sub><b>anthony</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=anthonycampbell" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="http://ccygnus.com/"><img src="https://avatars1.githubusercontent.com/u/9342724?v=4" width="100px;" alt=""/><br /><sub><b>Christian Cygnus</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=christophercolumbusdog" title="Code">💻</a></td>
-    <td align="center"><a href="https://about.me/dzmitryh"><img src="https://avatars2.githubusercontent.com/u/5390492?v=4" width="100px;" alt=""/><br /><sub><b>Dima Gubin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dzmitryh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/jjjimenez100"><img src="https://avatars3.githubusercontent.com/u/22243493?v=4" width="100px;" alt=""/><br /><sub><b>Joshua Jimenez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jjjimenez100" title="Code">💻</a></td>
-    <td align="center"><a href="http://about.me/kaiwinter"><img src="https://avatars0.githubusercontent.com/u/110982?v=4" width="100px;" alt=""/><br /><sub><b>Kai Winter</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kaiwinter" title="Code">💻</a></td>
+    <td align="center"><a href="http://ccygnus.com/"><img src="https://avatars1.githubusercontent.com/u/9342724?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Christian Cygnus</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=christophercolumbusdog" title="Code">💻</a></td>
+    <td align="center"><a href="https://about.me/dzmitryh"><img src="https://avatars2.githubusercontent.com/u/5390492?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dima Gubin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dzmitryh" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/jjjimenez100"><img src="https://avatars3.githubusercontent.com/u/22243493?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Joshua Jimenez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jjjimenez100" title="Code">💻</a></td>
+    <td align="center"><a href="http://about.me/kaiwinter"><img src="https://avatars0.githubusercontent.com/u/110982?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kai Winter</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kaiwinter" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/lbroman"><img src="https://avatars1.githubusercontent.com/u/86007?v=4" width="100px;" alt=""/><br /><sub><b>lbroman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=lbroman" title="Code">💻</a></td>
-    <td align="center"><a href="https://przemeknowak.com"><img src="https://avatars1.githubusercontent.com/u/3254609?v=4" width="100px;" alt=""/><br /><sub><b>Przemek</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=pnowy" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/prafful1"><img src="https://avatars0.githubusercontent.com/u/14350274?v=4" width="100px;" alt=""/><br /><sub><b>Prafful Agarwal</b></sub></a><br /><a href="#content-prafful1" title="Content">🖋</a></td>
-    <td align="center"><a href="https://github.com/sankypanhale"><img src="https://avatars1.githubusercontent.com/u/6478783?v=4" width="100px;" alt=""/><br /><sub><b>Sanket Panhale</b></sub></a><br /><a href="#content-sankypanhale" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/lbroman"><img src="https://avatars1.githubusercontent.com/u/86007?v=4?s=100" width="100px;" alt=""/><br /><sub><b>lbroman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=lbroman" title="Code">💻</a></td>
+    <td align="center"><a href="https://przemeknowak.com"><img src="https://avatars1.githubusercontent.com/u/3254609?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Przemek</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=pnowy" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/prafful1"><img src="https://avatars0.githubusercontent.com/u/14350274?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Prafful Agarwal</b></sub></a><br /><a href="#content-prafful1" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/sankypanhale"><img src="https://avatars1.githubusercontent.com/u/6478783?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sanket Panhale</b></sub></a><br /><a href="#content-sankypanhale" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/staillebois"><img src="https://avatars0.githubusercontent.com/u/23701200?v=4" width="100px;" alt=""/><br /><sub><b>staillebois</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=staillebois" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/valdar-hu"><img src="https://avatars3.githubusercontent.com/u/17962817?v=4" width="100px;" alt=""/><br /><sub><b>Krisztián Nagy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=valdar-hu" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.vanogrid.com"><img src="https://avatars0.githubusercontent.com/u/4307918?v=4" width="100px;" alt=""/><br /><sub><b>Alexander Ivanov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vanogrid" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/yosfik"><img src="https://avatars3.githubusercontent.com/u/4850270?v=4" width="100px;" alt=""/><br /><sub><b>Yosfik Alqadri</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yosfik" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/staillebois"><img src="https://avatars0.githubusercontent.com/u/23701200?v=4?s=100" width="100px;" alt=""/><br /><sub><b>staillebois</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=staillebois" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/valdar-hu"><img src="https://avatars3.githubusercontent.com/u/17962817?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Krisztián Nagy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=valdar-hu" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.vanogrid.com"><img src="https://avatars0.githubusercontent.com/u/4307918?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Alexander Ivanov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vanogrid" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/yosfik"><img src="https://avatars3.githubusercontent.com/u/4850270?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Yosfik Alqadri</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yosfik" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/7agustibm"><img src="https://avatars0.githubusercontent.com/u/8149332?v=4" width="100px;" alt=""/><br /><sub><b>Agustí Becerra Milà</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=7agustibm" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Juaanma"><img src="https://avatars3.githubusercontent.com/u/7390500?v=4" width="100px;" alt=""/><br /><sub><b>Juan Manuel Suárez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Juaanma" title="Code">💻</a></td>
-    <td align="center"><a href="http://www.devsedge.net/"><img src="https://avatars0.githubusercontent.com/u/9956006?v=4" width="100px;" alt=""/><br /><sub><b>Luigi Cortese</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=LuigiCortese" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Rzeposlaw"><img src="https://avatars2.githubusercontent.com/u/18425745?v=4" width="100px;" alt=""/><br /><sub><b>Katarzyna Rzepecka</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Rzeposlaw" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/7agustibm"><img src="https://avatars0.githubusercontent.com/u/8149332?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Agustí Becerra Milà</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=7agustibm" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Juaanma"><img src="https://avatars3.githubusercontent.com/u/7390500?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Juan Manuel Suárez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Juaanma" title="Code">💻</a></td>
+    <td align="center"><a href="http://www.devsedge.net/"><img src="https://avatars0.githubusercontent.com/u/9956006?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Luigi Cortese</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=LuigiCortese" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Rzeposlaw"><img src="https://avatars2.githubusercontent.com/u/18425745?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Katarzyna Rzepecka</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Rzeposlaw" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="http://adamski.pro"><img src="https://avatars1.githubusercontent.com/u/6537430?v=4" width="100px;" alt=""/><br /><sub><b>adamski.pro</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=akrystian" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/baislsl"><img src="https://avatars0.githubusercontent.com/u/17060584?v=4" width="100px;" alt=""/><br /><sub><b>Shengli Bai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=baislsl" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/besok"><img src="https://avatars2.githubusercontent.com/u/29834592?v=4" width="100px;" alt=""/><br /><sub><b>Boris</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=besok" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/dmitraver"><img src="https://avatars3.githubusercontent.com/u/1798156?v=4" width="100px;" alt=""/><br /><sub><b>Dmitry Avershin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dmitraver" title="Code">💻</a></td>
+    <td align="center"><a href="http://adamski.pro"><img src="https://avatars1.githubusercontent.com/u/6537430?v=4?s=100" width="100px;" alt=""/><br /><sub><b>adamski.pro</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=akrystian" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/baislsl"><img src="https://avatars0.githubusercontent.com/u/17060584?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Shengli Bai</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=baislsl" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/besok"><img src="https://avatars2.githubusercontent.com/u/29834592?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Boris</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=besok" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/dmitraver"><img src="https://avatars3.githubusercontent.com/u/1798156?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dmitry Avershin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dmitraver" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/fanofxiaofeng"><img src="https://avatars0.githubusercontent.com/u/3983683?v=4" width="100px;" alt=""/><br /><sub><b>靳阳</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fanofxiaofeng" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/hoangnam2261"><img src="https://avatars2.githubusercontent.com/u/31692990?v=4" width="100px;" alt=""/><br /><sub><b>hoangnam2261</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hoangnam2261" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/jarpit96"><img src="https://avatars2.githubusercontent.com/u/10098713?v=4" width="100px;" alt=""/><br /><sub><b>Arpit Jain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jarpit96" title="Code">💻</a></td>
-    <td align="center"><a href="http://joningi.net"><img src="https://avatars2.githubusercontent.com/u/6115148?v=4" width="100px;" alt=""/><br /><sub><b>Jón Ingi Sveinbjörnsson</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=joningiwork" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/fanofxiaofeng"><img src="https://avatars0.githubusercontent.com/u/3983683?v=4?s=100" width="100px;" alt=""/><br /><sub><b>靳阳</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fanofxiaofeng" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/hoangnam2261"><img src="https://avatars2.githubusercontent.com/u/31692990?v=4?s=100" width="100px;" alt=""/><br /><sub><b>hoangnam2261</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hoangnam2261" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/jarpit96"><img src="https://avatars2.githubusercontent.com/u/10098713?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Arpit Jain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jarpit96" title="Code">💻</a></td>
+    <td align="center"><a href="http://joningi.net"><img src="https://avatars2.githubusercontent.com/u/6115148?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jón Ingi Sveinbjörnsson</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=joningiwork" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/kirill-vlasov"><img src="https://avatars3.githubusercontent.com/u/16112495?v=4" width="100px;" alt=""/><br /><sub><b>Kirill Vlasov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kirill-vlasov" title="Code">💻</a></td>
-    <td align="center"><a href="http://mitchell-irvin.com"><img src="https://avatars0.githubusercontent.com/u/16233245?v=4" width="100px;" alt=""/><br /><sub><b>Mitchell Irvin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mitchellirvin" title="Code">💻</a></td>
-    <td align="center"><a href="https://ranjeet-floyd.github.io"><img src="https://avatars0.githubusercontent.com/u/1992972?v=4" width="100px;" alt=""/><br /><sub><b>Ranjeet</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ranjeet-floyd" title="Code">💻</a></td>
-    <td align="center"><a href="https://alwayswithme.github.io"><img src="https://avatars3.githubusercontent.com/u/3234786?v=4" width="100px;" alt=""/><br /><sub><b>PhoenixYip</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Alwayswithme" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/kirill-vlasov"><img src="https://avatars3.githubusercontent.com/u/16112495?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kirill Vlasov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kirill-vlasov" title="Code">💻</a></td>
+    <td align="center"><a href="http://mitchell-irvin.com"><img src="https://avatars0.githubusercontent.com/u/16233245?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mitchell Irvin</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mitchellirvin" title="Code">💻</a></td>
+    <td align="center"><a href="https://ranjeet-floyd.github.io"><img src="https://avatars0.githubusercontent.com/u/1992972?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ranjeet</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ranjeet-floyd" title="Code">💻</a></td>
+    <td align="center"><a href="https://alwayswithme.github.io"><img src="https://avatars3.githubusercontent.com/u/3234786?v=4?s=100" width="100px;" alt=""/><br /><sub><b>PhoenixYip</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Alwayswithme" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/MSaifAsif"><img src="https://avatars1.githubusercontent.com/u/6280554?v=4" width="100px;" alt=""/><br /><sub><b>M Saif Asif</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=MSaifAsif" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/kanwarpreet25"><img src="https://avatars0.githubusercontent.com/u/39183641?v=4" width="100px;" alt=""/><br /><sub><b>kanwarpreet25</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kanwarpreet25" title="Code">💻</a></td>
-    <td align="center"><a href="http://leonmak.me"><img src="https://avatars3.githubusercontent.com/u/13071508?v=4" width="100px;" alt=""/><br /><sub><b>Leon Mak</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=leonmak" title="Code">💻</a></td>
-    <td align="center"><a href="http://www.wramdemark.se"><img src="https://avatars2.githubusercontent.com/u/7052193?v=4" width="100px;" alt=""/><br /><sub><b>Per Wramdemark</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=perwramdemark" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/MSaifAsif"><img src="https://avatars1.githubusercontent.com/u/6280554?v=4?s=100" width="100px;" alt=""/><br /><sub><b>M Saif Asif</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=MSaifAsif" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/kanwarpreet25"><img src="https://avatars0.githubusercontent.com/u/39183641?v=4?s=100" width="100px;" alt=""/><br /><sub><b>kanwarpreet25</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=kanwarpreet25" title="Code">💻</a></td>
+    <td align="center"><a href="http://leonmak.me"><img src="https://avatars3.githubusercontent.com/u/13071508?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Leon Mak</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=leonmak" title="Code">💻</a></td>
+    <td align="center"><a href="http://www.wramdemark.se"><img src="https://avatars2.githubusercontent.com/u/7052193?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Per Wramdemark</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=perwramdemark" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/waisuan"><img src="https://avatars2.githubusercontent.com/u/10975700?v=4" width="100px;" alt=""/><br /><sub><b>Evan Sia Wai Suan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=waisuan" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/AnaghaSasikumar"><img src="https://avatars2.githubusercontent.com/u/42939261?v=4" width="100px;" alt=""/><br /><sub><b>AnaghaSasikumar</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=AnaghaSasikumar" title="Code">💻</a></td>
-    <td align="center"><a href="https://christofferh.com"><img src="https://avatars1.githubusercontent.com/u/767643?v=4" width="100px;" alt=""/><br /><sub><b>Christoffer Hamberg</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=christofferh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/dgruntz"><img src="https://avatars0.githubusercontent.com/u/1516800?v=4" width="100px;" alt=""/><br /><sub><b>Dominik Gruntz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dgruntz" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/waisuan"><img src="https://avatars2.githubusercontent.com/u/10975700?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Evan Sia Wai Suan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=waisuan" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/AnaghaSasikumar"><img src="https://avatars2.githubusercontent.com/u/42939261?v=4?s=100" width="100px;" alt=""/><br /><sub><b>AnaghaSasikumar</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=AnaghaSasikumar" title="Code">💻</a></td>
+    <td align="center"><a href="https://christofferh.com"><img src="https://avatars1.githubusercontent.com/u/767643?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Christoffer Hamberg</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=christofferh" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/dgruntz"><img src="https://avatars0.githubusercontent.com/u/1516800?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Dominik Gruntz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dgruntz" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://bitbucket.org/hannespernpeintner/"><img src="https://avatars3.githubusercontent.com/u/1679437?v=4" width="100px;" alt=""/><br /><sub><b>Hannes</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hannespernpeintner" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/leogtzr"><img src="https://avatars0.githubusercontent.com/u/1211969?v=4" width="100px;" alt=""/><br /><sub><b>Leo Gutiérrez Ramírez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=leogtzr" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/npczwh"><img src="https://avatars0.githubusercontent.com/u/14066422?v=4" width="100px;" alt=""/><br /><sub><b>Zhang WH</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=npczwh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/oconnelc"><img src="https://avatars0.githubusercontent.com/u/1112973?v=4" width="100px;" alt=""/><br /><sub><b>Christopher O'Connell</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=oconnelc" title="Code">💻</a></td>
+    <td align="center"><a href="https://bitbucket.org/hannespernpeintner/"><img src="https://avatars3.githubusercontent.com/u/1679437?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Hannes</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hannespernpeintner" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/leogtzr"><img src="https://avatars0.githubusercontent.com/u/1211969?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Leo Gutiérrez Ramírez</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=leogtzr" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/npczwh"><img src="https://avatars0.githubusercontent.com/u/14066422?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Zhang WH</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=npczwh" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/oconnelc"><img src="https://avatars0.githubusercontent.com/u/1112973?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Christopher O'Connell</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=oconnelc" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/giorgosmav21"><img src="https://avatars2.githubusercontent.com/u/22855493?v=4" width="100px;" alt=""/><br /><sub><b>George Mavroeidis</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=giorgosmav21" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/hbothra15"><img src="https://avatars1.githubusercontent.com/u/7418012?v=4" width="100px;" alt=""/><br /><sub><b>Hemant Bothra</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hbothra15" title="Code">💻</a> <a href="#design-hbothra15" title="Design">🎨</a></td>
-    <td align="center"><a href="https://www.kevinpeters.net/about/"><img src="https://avatars1.githubusercontent.com/u/12736734?v=4" width="100px;" alt=""/><br /><sub><b>Kevin Peters</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=igeligel" title="Code">💻</a></td>
-    <td align="center"><a href="https://llorllale.github.io/"><img src="https://avatars1.githubusercontent.com/u/2019896?v=4" width="100px;" alt=""/><br /><sub><b>George Aristy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=llorllale" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/giorgosmav21"><img src="https://avatars2.githubusercontent.com/u/22855493?v=4?s=100" width="100px;" alt=""/><br /><sub><b>George Mavroeidis</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=giorgosmav21" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/hbothra15"><img src="https://avatars1.githubusercontent.com/u/7418012?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Hemant Bothra</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hbothra15" title="Code">💻</a> <a href="#design-hbothra15" title="Design">🎨</a></td>
+    <td align="center"><a href="https://www.kevinpeters.net/about/"><img src="https://avatars1.githubusercontent.com/u/12736734?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kevin Peters</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=igeligel" title="Code">💻</a></td>
+    <td align="center"><a href="https://llorllale.github.io/"><img src="https://avatars1.githubusercontent.com/u/2019896?v=4?s=100" width="100px;" alt=""/><br /><sub><b>George Aristy</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=llorllale" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/mookkiah"><img src="https://avatars1.githubusercontent.com/u/8975264?v=4" width="100px;" alt=""/><br /><sub><b>Mahendran Mookkiah</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mookkiah" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Azureyjt"><img src="https://avatars2.githubusercontent.com/u/18476317?v=4" width="100px;" alt=""/><br /><sub><b>Azureyjt</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Azureyjt" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/vehpsr"><img src="https://avatars2.githubusercontent.com/u/3133265?v=4" width="100px;" alt=""/><br /><sub><b>gans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vehpsr" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ThatGuyWithTheHat"><img src="https://avatars0.githubusercontent.com/u/24470582?v=4" width="100px;" alt=""/><br /><sub><b>Matt</b></sub></a><br /><a href="#content-ThatGuyWithTheHat" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/mookkiah"><img src="https://avatars1.githubusercontent.com/u/8975264?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mahendran Mookkiah</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mookkiah" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Azureyjt"><img src="https://avatars2.githubusercontent.com/u/18476317?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Azureyjt</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=Azureyjt" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/vehpsr"><img src="https://avatars2.githubusercontent.com/u/3133265?v=4?s=100" width="100px;" alt=""/><br /><sub><b>gans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vehpsr" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ThatGuyWithTheHat"><img src="https://avatars0.githubusercontent.com/u/24470582?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matt</b></sub></a><br /><a href="#content-ThatGuyWithTheHat" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://www.linkedin.com/in/gopinathlangote/"><img src="https://avatars2.githubusercontent.com/u/10210778?v=4" width="100px;" alt=""/><br /><sub><b>Gopinath Langote</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gopinath-langote" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/hoswey"><img src="https://avatars3.githubusercontent.com/u/3689445?v=4" width="100px;" alt=""/><br /><sub><b>Hoswey</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hoswey" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/amit2103"><img src="https://avatars3.githubusercontent.com/u/7566692?v=4" width="100px;" alt=""/><br /><sub><b>Amit Pandey</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amit2103" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/gwildor28"><img src="https://avatars0.githubusercontent.com/u/16000365?v=4" width="100px;" alt=""/><br /><sub><b>gwildor28</b></sub></a><br /><a href="#content-gwildor28" title="Content">🖋</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/gopinathlangote/"><img src="https://avatars2.githubusercontent.com/u/10210778?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Gopinath Langote</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gopinath-langote" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/hoswey"><img src="https://avatars3.githubusercontent.com/u/3689445?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Hoswey</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=hoswey" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/amit2103"><img src="https://avatars3.githubusercontent.com/u/7566692?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Amit Pandey</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=amit2103" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/gwildor28"><img src="https://avatars0.githubusercontent.com/u/16000365?v=4?s=100" width="100px;" alt=""/><br /><sub><b>gwildor28</b></sub></a><br /><a href="#content-gwildor28" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://t.me/paul_docker"><img src="https://avatars1.githubusercontent.com/u/2404785?v=4" width="100px;" alt=""/><br /><sub><b>田浩</b></sub></a><br /><a href="#content-llitfkitfk" title="Content">🖋</a></td>
-    <td align="center"><a href="https://twitter.com/StPitsios"><img src="https://avatars1.githubusercontent.com/u/6773603?v=4" width="100px;" alt=""/><br /><sub><b>Stamatis Pitsios</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=pitsios-s" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/qza"><img src="https://avatars3.githubusercontent.com/u/233149?v=4" width="100px;" alt=""/><br /><sub><b>qza</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qza" title="Code">💻</a></td>
-    <td align="center"><a href="http://tschis.github.io"><img src="https://avatars1.githubusercontent.com/u/20662669?v=4" width="100px;" alt=""/><br /><sub><b>Rodolfo Forte</b></sub></a><br /><a href="#content-Tschis" title="Content">🖋</a></td>
+    <td align="center"><a href="https://t.me/paul_docker"><img src="https://avatars1.githubusercontent.com/u/2404785?v=4?s=100" width="100px;" alt=""/><br /><sub><b>田浩</b></sub></a><br /><a href="#content-llitfkitfk" title="Content">🖋</a></td>
+    <td align="center"><a href="https://twitter.com/StPitsios"><img src="https://avatars1.githubusercontent.com/u/6773603?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Stamatis Pitsios</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=pitsios-s" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/qza"><img src="https://avatars3.githubusercontent.com/u/233149?v=4?s=100" width="100px;" alt=""/><br /><sub><b>qza</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qza" title="Code">💻</a></td>
+    <td align="center"><a href="http://tschis.github.io"><img src="https://avatars1.githubusercontent.com/u/20662669?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rodolfo Forte</b></sub></a><br /><a href="#content-Tschis" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/ankurkaushal"><img src="https://avatars2.githubusercontent.com/u/2236616?v=4" width="100px;" alt=""/><br /><sub><b>Ankur Kaushal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ankurkaushal" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.linkedin.com/in/ovidijus-okinskas/"><img src="https://avatars0.githubusercontent.com/u/20372387?v=4" width="100px;" alt=""/><br /><sub><b>Ovidijus Okinskas</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=okinskas" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/robertt240"><img src="https://avatars1.githubusercontent.com/u/9137432?v=4" width="100px;" alt=""/><br /><sub><b>Robert Kasperczyk</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=robertt240" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/trautonen"><img src="https://avatars3.githubusercontent.com/u/1641063?v=4" width="100px;" alt=""/><br /><sub><b>Tapio Rautonen</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=trautonen" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ankurkaushal"><img src="https://avatars2.githubusercontent.com/u/2236616?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ankur Kaushal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ankurkaushal" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/ovidijus-okinskas/"><img src="https://avatars0.githubusercontent.com/u/20372387?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ovidijus Okinskas</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=okinskas" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/robertt240"><img src="https://avatars1.githubusercontent.com/u/9137432?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Robert Kasperczyk</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=robertt240" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/trautonen"><img src="https://avatars3.githubusercontent.com/u/1641063?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tapio Rautonen</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=trautonen" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="http://vk.com/yuri.orlov"><img src="https://avatars0.githubusercontent.com/u/1595733?v=4" width="100px;" alt=""/><br /><sub><b>Yuri Orlov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yorlov" title="Code">💻</a></td>
-    <td align="center"><a href="https://www.linkedin.com/in/varunu28/"><img src="https://avatars0.githubusercontent.com/u/7676016?v=4" width="100px;" alt=""/><br /><sub><b>Varun Upadhyay</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=varunu28" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/PalAditya"><img src="https://avatars2.githubusercontent.com/u/25523604?v=4" width="100px;" alt=""/><br /><sub><b>Aditya Pal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=PalAditya" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4" width="100px;" alt=""/><br /><sub><b>grzesiekkedzior</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=grzesiekkedzior" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Agrzesiekkedzior" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="http://vk.com/yuri.orlov"><img src="https://avatars0.githubusercontent.com/u/1595733?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Yuri Orlov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=yorlov" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/varunu28/"><img src="https://avatars0.githubusercontent.com/u/7676016?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Varun Upadhyay</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=varunu28" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/PalAditya"><img src="https://avatars2.githubusercontent.com/u/25523604?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Aditya Pal</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=PalAditya" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/grzesiekkedzior"><img src="https://avatars3.githubusercontent.com/u/23739158?v=4?s=100" width="100px;" alt=""/><br /><sub><b>grzesiekkedzior</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=grzesiekkedzior" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Agrzesiekkedzior" title="Reviewed Pull Requests">👀</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/sivasubramanim"><img src="https://avatars2.githubusercontent.com/u/51107434?v=4" width="100px;" alt=""/><br /><sub><b>Sivasubramani M</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sivasubramanim" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/d4gg4d"><img src="https://avatars2.githubusercontent.com/u/99457?v=4" width="100px;" alt=""/><br /><sub><b>Sami Airaksinen</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=d4gg4d" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/vertti"><img src="https://avatars0.githubusercontent.com/u/557751?v=4" width="100px;" alt=""/><br /><sub><b>Janne Sinivirta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vertti" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/Bobo1239"><img src="https://avatars1.githubusercontent.com/u/2302947?v=4" width="100px;" alt=""/><br /><sub><b>Boris-Chengbiao Zhou</b></sub></a><br /><a href="#content-Bobo1239" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/sivasubramanim"><img src="https://avatars2.githubusercontent.com/u/51107434?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sivasubramani M</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=sivasubramanim" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/d4gg4d"><img src="https://avatars2.githubusercontent.com/u/99457?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sami Airaksinen</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=d4gg4d" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/vertti"><img src="https://avatars0.githubusercontent.com/u/557751?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Janne Sinivirta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vertti" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/Bobo1239"><img src="https://avatars1.githubusercontent.com/u/2302947?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Boris-Chengbiao Zhou</b></sub></a><br /><a href="#content-Bobo1239" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://jahhein.github.io"><img src="https://avatars2.githubusercontent.com/u/10779515?v=4" width="100px;" alt=""/><br /><sub><b>Jacob Hein</b></sub></a><br /><a href="#content-Jahhein" title="Content">🖋</a></td>
-    <td align="center"><a href="https://github.com/iamrichardjones"><img src="https://avatars3.githubusercontent.com/u/14842151?v=4" width="100px;" alt=""/><br /><sub><b>Richard Jones</b></sub></a><br /><a href="#content-iamrichardjones" title="Content">🖋</a></td>
-    <td align="center"><a href="https://rachelcarmena.github.io"><img src="https://avatars0.githubusercontent.com/u/22792183?v=4" width="100px;" alt=""/><br /><sub><b>Rachel M. Carmena</b></sub></a><br /><a href="#content-rachelcarmena" title="Content">🖋</a></td>
-    <td align="center"><a href="https://zd-zero.github.io"><img src="https://avatars0.githubusercontent.com/u/21978370?v=4" width="100px;" alt=""/><br /><sub><b>Zaerald Denze Lungos</b></sub></a><br /><a href="#content-zd-zero" title="Content">🖋</a></td>
+    <td align="center"><a href="https://jahhein.github.io"><img src="https://avatars2.githubusercontent.com/u/10779515?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jacob Hein</b></sub></a><br /><a href="#content-Jahhein" title="Content">🖋</a></td>
+    <td align="center"><a href="https://github.com/iamrichardjones"><img src="https://avatars3.githubusercontent.com/u/14842151?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Richard Jones</b></sub></a><br /><a href="#content-iamrichardjones" title="Content">🖋</a></td>
+    <td align="center"><a href="https://rachelcarmena.github.io"><img src="https://avatars0.githubusercontent.com/u/22792183?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rachel M. Carmena</b></sub></a><br /><a href="#content-rachelcarmena" title="Content">🖋</a></td>
+    <td align="center"><a href="https://zd-zero.github.io"><img src="https://avatars0.githubusercontent.com/u/21978370?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Zaerald Denze Lungos</b></sub></a><br /><a href="#content-zd-zero" title="Content">🖋</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://webpro.nl"><img src="https://avatars1.githubusercontent.com/u/456426?v=4" width="100px;" alt=""/><br /><sub><b>Lars Kappert</b></sub></a><br /><a href="#content-webpro" title="Content">🖋</a></td>
-    <td align="center"><a href="https://xiaod.info"><img src="https://avatars2.githubusercontent.com/u/21277644?v=4" width="100px;" alt=""/><br /><sub><b>Mike Liu</b></sub></a><br /><a href="#translation-xiaod-dev" title="Translation">🌍</a></td>
-    <td align="center"><a href="https://github.com/charlesfinley"><img src="https://avatars1.githubusercontent.com/u/6307904?v=4" width="100px;" alt=""/><br /><sub><b>Matt Dolan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=charlesfinley" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Acharlesfinley" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://github.com/MananS77"><img src="https://avatars3.githubusercontent.com/u/21033516?v=4" width="100px;" alt=""/><br /><sub><b>Manan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AMananS77" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://webpro.nl"><img src="https://avatars1.githubusercontent.com/u/456426?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Lars Kappert</b></sub></a><br /><a href="#content-webpro" title="Content">🖋</a></td>
+    <td align="center"><a href="https://xiaod.info"><img src="https://avatars2.githubusercontent.com/u/21277644?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Mike Liu</b></sub></a><br /><a href="#translation-xiaod-dev" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/charlesfinley"><img src="https://avatars1.githubusercontent.com/u/6307904?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matt Dolan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=charlesfinley" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Acharlesfinley" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/MananS77"><img src="https://avatars3.githubusercontent.com/u/21033516?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Manan</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AMananS77" title="Reviewed Pull Requests">👀</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/nishant"><img src="https://avatars2.githubusercontent.com/u/15331971?v=4" width="100px;" alt=""/><br /><sub><b>Nishant Arora</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nishant" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/raja-peeyush-kumar-singh"><img src="https://avatars0.githubusercontent.com/u/5496024?v=4" width="100px;" alt=""/><br /><sub><b>Peeyush</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=raja-peeyush-kumar-singh" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aravening" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://github.com/vINCENT8888801"><img src="https://avatars0.githubusercontent.com/u/8037883?v=4" width="100px;" alt=""/><br /><sub><b>Wei Seng</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vINCENT8888801" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nishant"><img src="https://avatars2.githubusercontent.com/u/15331971?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nishant Arora</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nishant" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/raja-peeyush-kumar-singh"><img src="https://avatars0.githubusercontent.com/u/5496024?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Peeyush</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=raja-peeyush-kumar-singh" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ravening"><img src="https://avatars1.githubusercontent.com/u/10645273?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rakesh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ravening" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aravening" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/vINCENT8888801"><img src="https://avatars0.githubusercontent.com/u/8037883?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Wei Seng</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vINCENT8888801" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://www.linkedin.com/in/ashish-trivedi-218379135/"><img src="https://avatars3.githubusercontent.com/u/23194128?v=4" width="100px;" alt=""/><br /><sub><b>Ashish Trivedi</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ashishtrivedi16" title="Code">💻</a></td>
-    <td align="center"><a href="https://rayyounghong.com"><img src="https://avatars1.githubusercontent.com/u/41055099?v=4" width="100px;" alt=""/><br /><sub><b>洪月阳</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=RayYH" title="Code">💻</a></td>
-    <td align="center"><a href="https://xdvrx1.github.io/"><img src="https://avatars0.githubusercontent.com/u/47092464?v=4" width="100px;" alt=""/><br /><sub><b>xdvrx1</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Axdvrx1" title="Reviewed Pull Requests">👀</a> <a href="#ideas-xdvrx1" title="Ideas, Planning, & Feedback">🤔</a></td>
-    <td align="center"><a href="http://subho.xyz"><img src="https://avatars0.githubusercontent.com/u/13291222?v=4" width="100px;" alt=""/><br /><sub><b>Subhrodip Mohanta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ohbus" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aohbus" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/ashish-trivedi-218379135/"><img src="https://avatars3.githubusercontent.com/u/23194128?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ashish Trivedi</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ashishtrivedi16" title="Code">💻</a></td>
+    <td align="center"><a href="https://rayyounghong.com"><img src="https://avatars1.githubusercontent.com/u/41055099?v=4?s=100" width="100px;" alt=""/><br /><sub><b>洪月阳</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=RayYH" title="Code">💻</a></td>
+    <td align="center"><a href="https://xdvrx1.github.io/"><img src="https://avatars0.githubusercontent.com/u/47092464?v=4?s=100" width="100px;" alt=""/><br /><sub><b>xdvrx1</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Axdvrx1" title="Reviewed Pull Requests">👀</a> <a href="#ideas-xdvrx1" title="Ideas, Planning, & Feedback">🤔</a></td>
+    <td align="center"><a href="http://subho.xyz"><img src="https://avatars0.githubusercontent.com/u/13291222?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Subhrodip Mohanta</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ohbus" title="Code">💻</a> <a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aohbus" title="Reviewed Pull Requests">👀</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4" width="100px;" alt=""/><br /><sub><b>Toxic Dreamz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ToxicDreamz" title="Code">💻</a></td>
-    <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4" width="100px;" alt=""/><br /><sub><b>Edy Cu Tjong</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=edycutjong" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4" width="100px;" alt=""/><br /><sub><b>Michał Krzywański</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mkrzywanski" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/nahteb"><img src="https://avatars3.githubusercontent.com/u/13121570?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Bethan Palmer</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=nahteb" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ToxicDreamz"><img src="https://avatars0.githubusercontent.com/u/45225562?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Toxic Dreamz</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ToxicDreamz" title="Code">💻</a></td>
+    <td align="center"><a href="http://www.edycutjong.com"><img src="https://avatars1.githubusercontent.com/u/1098102?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Edy Cu Tjong</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=edycutjong" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/mkrzywanski"><img src="https://avatars0.githubusercontent.com/u/15279585?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Michał Krzywański</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=mkrzywanski" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4" width="100px;" alt=""/><br /><sub><b>Fedor Skvorcov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fedorskvorcov" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4" width="100px;" alt=""/><br /><sub><b>samilAyoub</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=samilAyoub" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/vdlald"><img src="https://avatars0.githubusercontent.com/u/29997701?v=4" width="100px;" alt=""/><br /><sub><b>Vladislav Golubinov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vdlald" title="Code">💻</a></td>
+    <td align="center"><a href="https://www.stefan-birkner.de"><img src="https://avatars1.githubusercontent.com/u/711349?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Stefan Birkner</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=stefanbirkner" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/fedorskvorcov"><img src="https://avatars3.githubusercontent.com/u/43882212?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Fedor Skvorcov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=fedorskvorcov" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/samilAyoub"><img src="https://avatars0.githubusercontent.com/u/61546990?v=4?s=100" width="100px;" alt=""/><br /><sub><b>samilAyoub</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=samilAyoub" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/vdlald"><img src="https://avatars0.githubusercontent.com/u/29997701?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vladislav Golubinov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=vdlald" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
-    <td align="center"><a href="http://christophflick.de"><img src="https://avatars0.githubusercontent.com/u/4465376?v=4" width="100px;" alt=""/><br /><sub><b>Christoph Flick</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ChFlick" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/Ascenio"><img src="https://avatars1.githubusercontent.com/u/7662016?v=4" width="100px;" alt=""/><br /><sub><b>Ascênio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AAscenio" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://www.linkedin.com/in/domenico-sibilio/"><img src="https://avatars2.githubusercontent.com/u/24280982?v=4" width="100px;" alt=""/><br /><sub><b>Domenico Sibilio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dsibilio" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/swarajsaaj"><img src="https://avatars2.githubusercontent.com/u/6285049?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Swaraj</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=swarajsaaj" title="Code">💻</a></td>
+    <td align="center"><a href="http://christophflick.de"><img src="https://avatars0.githubusercontent.com/u/4465376?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Christoph Flick</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ChFlick" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/Ascenio"><img src="https://avatars1.githubusercontent.com/u/7662016?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ascênio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AAscenio" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/domenico-sibilio/"><img src="https://avatars2.githubusercontent.com/u/24280982?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Domenico Sibilio</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=dsibilio" title="Documentation">📖</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="http://www.linkedin.com/in/manannikov"><img src="https://avatars2.githubusercontent.com/u/7019769?v=4" width="100px;" alt=""/><br /><sub><b>Pavlo Manannikov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=manannikov" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/eimanip"><img src="https://avatars0.githubusercontent.com/u/20307301?v=4" width="100px;" alt=""/><br /><sub><b>Eiman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=eimanip" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/OrangePants-R"><img src="https://avatars0.githubusercontent.com/u/42976136?v=4" width="100px;" alt=""/><br /><sub><b>Rocky</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=OrangePants-R" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/akashchandwani"><img src="https://avatars2.githubusercontent.com/u/3483277?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Akash Chandwani</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Aakashchandwani" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="http://www.linkedin.com/in/manannikov"><img src="https://avatars2.githubusercontent.com/u/7019769?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Pavlo Manannikov</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=manannikov" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/eimanip"><img src="https://avatars0.githubusercontent.com/u/20307301?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Eiman</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=eimanip" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/OrangePants-R"><img src="https://avatars0.githubusercontent.com/u/42976136?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rocky</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=OrangePants-R" title="Documentation">📖</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
-    <td align="center"><a href="https://github.com/gkulkarni2020"><img src="https://avatars3.githubusercontent.com/u/5161548?v=4" width="100px;" alt=""/><br /><sub><b>Girish Kulkarni</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gkulkarni2020" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/omk13"><img src="https://avatars0.githubusercontent.com/u/59054172?v=4" width="100px;" alt=""/><br /><sub><b>Omar Karazoun</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=omk13" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/jeff303"><img src="https://avatars0.githubusercontent.com/u/3521562?v=4" width="100px;" alt=""/><br /><sub><b>Jeff Evans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jeff303" title="Code">💻</a></td>
+    <td align="center"><a href="https://ibrahimalii.github.io/"><img src="https://avatars2.githubusercontent.com/u/21141301?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ibrahim ali abdelghany</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3AibrahimAlii" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/gkulkarni2020"><img src="https://avatars3.githubusercontent.com/u/5161548?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Girish Kulkarni</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=gkulkarni2020" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/omk13"><img src="https://avatars0.githubusercontent.com/u/59054172?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Omar Karazoun</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=omk13" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/jeff303"><img src="https://avatars0.githubusercontent.com/u/3521562?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jeff Evans</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=jeff303" title="Code">💻</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/siavashsoleymani"><img src="https://avatars2.githubusercontent.com/u/18074419?v=4" width="100px;" alt=""/><br /><sub><b>siavash</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=siavashsoleymani" title="Code">💻</a></td>
-    <td align="center"><a href="https://github.com/ruchpeanuts"><img src="https://avatars0.githubusercontent.com/u/29301900?v=4" width="100px;" alt=""/><br /><sub><b>ruchpeanuts</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruchpeanuts" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/warp125"><img src="https://avatars1.githubusercontent.com/u/48073115?v=4" width="100px;" alt=""/><br /><sub><b>warp125</b></sub></a><br /><a href="#translation-warp125" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://viveksb007.github.io"><img src="https://avatars1.githubusercontent.com/u/12713808?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vivek Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=viveksb007" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/siavashsoleymani"><img src="https://avatars2.githubusercontent.com/u/18074419?v=4?s=100" width="100px;" alt=""/><br /><sub><b>siavash</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=siavashsoleymani" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/ruchpeanuts"><img src="https://avatars0.githubusercontent.com/u/29301900?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ruchpeanuts</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ruchpeanuts" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/warp125"><img src="https://avatars1.githubusercontent.com/u/48073115?v=4?s=100" width="100px;" alt=""/><br /><sub><b>warp125</b></sub></a><br /><a href="#translation-warp125" title="Translation">🌍</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="http://libkhadir.fr"><img src="https://avatars1.githubusercontent.com/u/45130488?v=4?s=100" width="100px;" alt=""/><br /><sub><b>KHADIR Tayeb</b></sub></a><br /><a href="#translation-tkhadir" title="Translation">🌍</a></td>
   </tr>
 </table>
 
-<!-- markdownlint-enable -->
+<!-- markdownlint-restore -->
 <!-- prettier-ignore-end -->
+
 <!-- ALL-CONTRIBUTORS-LIST:END -->

From dea7ecfb7a1e5acbfb1cc1ccf4f8edf5ea8872c4 Mon Sep 17 00:00:00 2001
From: ignite1771 <59446563+ignite1771@users.noreply.github.com>
Date: Wed, 13 Jan 2021 15:36:21 +0800
Subject: [PATCH 196/254] #1317 Special Case Pattern (#1624)

* #1317 Add Special Case Pattern

To focus on pattern itself, I implement DB and
maintenance lock by the singleton instance.

* #1317 Add special cases unit tests

Assert the logger output
(ref: https://stackoverflow.com/a/52229629)

* #1317 Add README.md

Add Special Case Pattern README

* #1317 Format: add a new line to end of file

Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 pom.xml                                       |   1 +
 special-case/README.md                        | 368 ++++++++++++++++++
 special-case/etc/special-case.urm.puml        | 119 ++++++
 special-case/etc/special_case_urm.png         | Bin 0 -> 459244 bytes
 special-case/pom.xml                          |  22 ++
 .../java/com/iluwatar/specialcase/App.java    |  47 +++
 .../specialcase/ApplicationServices.java      |   6 +
 .../specialcase/ApplicationServicesImpl.java  |  18 +
 .../java/com/iluwatar/specialcase/Db.java     | 150 +++++++
 .../iluwatar/specialcase/DomainServices.java  |   4 +
 .../specialcase/DomainServicesImpl.java       |  46 +++
 .../specialcase/DownForMaintenance.java       |  14 +
 .../specialcase/InsufficientFunds.java        |  32 ++
 .../com/iluwatar/specialcase/InvalidUser.java |  20 +
 .../iluwatar/specialcase/MaintenanceLock.java |  37 ++
 .../specialcase/MoneyTransaction.java         |  12 +
 .../com/iluwatar/specialcase/OutOfStock.java  |  22 ++
 .../com/iluwatar/specialcase/ReceiptDto.java  |  24 ++
 .../specialcase/ReceiptViewModel.java         |   6 +
 .../com/iluwatar/specialcase/AppTest.java     |  16 +
 .../specialcase/SpecialCasesTest.java         | 120 ++++++
 21 files changed, 1084 insertions(+)
 create mode 100644 special-case/README.md
 create mode 100644 special-case/etc/special-case.urm.puml
 create mode 100644 special-case/etc/special_case_urm.png
 create mode 100644 special-case/pom.xml
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/App.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/Db.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
 create mode 100644 special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
 create mode 100644 special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
 create mode 100644 special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java

diff --git a/pom.xml b/pom.xml
index b6556245b..38e702761 100644
--- a/pom.xml
+++ b/pom.xml
@@ -200,6 +200,7 @@
         <module>factory</module>
         <module>separated-interface</module>
         <module>data-transfer-object-enum-impl</module>
+        <module>special-case</module>
     </modules>
 
     <repositories>
diff --git a/special-case/README.md b/special-case/README.md
new file mode 100644
index 000000000..e40ca3b7f
--- /dev/null
+++ b/special-case/README.md
@@ -0,0 +1,368 @@
+---
+layout: pattern
+title: Special Case
+folder: special-case
+permalink: /patterns/special-case/
+categories: Behavioral
+tags:
+ - Extensibility
+---
+
+## Intent
+
+Define some special cases, and encapsulates them into subclasses that provide different special behaviors.
+
+## Explanation
+
+Real world example
+
+> In an e-commerce system, presentation layer expects application layer to produce certain view model.
+> We have a successful scenario, in which receipt view model contains actual data from the purchase,
+> and a couple of failure scenarios.
+
+In plain words
+
+> Special Case pattern allows returning non-null real objects that perform special behaviors.
+
+In [Patterns of Enterprise Application Architecture](https://martinfowler.com/books/eaa.html) says 
+the difference from Null Object Pattern
+
+> If you’ll pardon the unresistable pun, I see Null Object as special case of Special Case.
+
+**Programmatic Example**
+
+To focus on the pattern itself, we implement DB and maintenance lock of the e-commerce system by the singleton instance.
+
+```java
+public class Db {
+  private static Db instance;
+  private Map<String, User> userName2User;
+  private Map<User, Account> user2Account;
+  private Map<String, Product> itemName2Product;
+
+  public static Db getInstance() {
+    if (instance == null) {
+      synchronized (Db.class) {
+        if (instance == null) {
+          instance = new Db();
+          instance.userName2User = new HashMap<>();
+          instance.user2Account = new HashMap<>();
+          instance.itemName2Product = new HashMap<>();
+        }
+      }
+    }
+    return instance;
+  }
+
+  public void seedUser(String userName, Double amount) {
+    User user = new User(userName);
+    instance.userName2User.put(userName, user);
+    Account account = new Account(amount);
+    instance.user2Account.put(user, account);
+  }
+
+  public void seedItem(String itemName, Double price) {
+    Product item = new Product(price);
+    itemName2Product.put(itemName, item);
+  }
+
+  public User findUserByUserName(String userName) {
+    if (!userName2User.containsKey(userName)) {
+      return null;
+    }
+    return userName2User.get(userName);
+  }
+
+  public Account findAccountByUser(User user) {
+    if (!user2Account.containsKey(user)) {
+      return null;
+    }
+    return user2Account.get(user);
+  }
+
+  public Product findProductByItemName(String itemName) {
+    if (!itemName2Product.containsKey(itemName)) {
+      return null;
+    }
+    return itemName2Product.get(itemName);
+  }
+
+  public class User {
+    private String userName;
+
+    public User(String userName) {
+      this.userName = userName;
+    }
+
+    public String getUserName() {
+      return userName;
+    }
+
+    public ReceiptDto purchase(Product item) {
+      return new ReceiptDto(item.getPrice());
+    }
+  }
+
+  public class Account {
+    private Double amount;
+
+    public Account(Double amount) {
+      this.amount = amount;
+    }
+
+    public MoneyTransaction withdraw(Double price) {
+      if (price > amount) {
+        return null;
+      }
+      return new MoneyTransaction(amount, price);
+    }
+
+    public Double getAmount() {
+      return amount;
+    }
+  }
+
+  public class Product {
+    private Double price;
+
+    public Product(Double price) {
+      this.price = price;
+    }
+
+    public Double getPrice() {
+      return price;
+    }
+  }
+}
+
+public class MaintenanceLock {
+  private static final Logger LOGGER = LoggerFactory.getLogger(MaintenanceLock.class);
+
+  private static MaintenanceLock instance;
+  private boolean lock = true;
+
+  public static MaintenanceLock getInstance() {
+    if (instance == null) {
+      synchronized (MaintenanceLock.class) {
+        if (instance == null) {
+          instance = new MaintenanceLock();
+        }
+      }
+    }
+    return instance;
+  }
+
+  public boolean isLock() {
+    return lock;
+  }
+
+  public void setLock(boolean lock) {
+    this.lock = lock;
+    LOGGER.info("Maintenance lock is set to: " + lock);
+  }
+}
+```
+
+Let's first introduce presentation layer, the receipt view model interface and its implementation of successful scenario.
+
+```java
+public interface ReceiptViewModel {
+  void show();
+}
+
+public class ReceiptDto implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(ReceiptDto.class);
+
+  private Double price;
+
+  public ReceiptDto(Double price) {
+    this.price = price;
+  }
+
+  public Double getPrice() {
+    return price;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Receipt: " + price + " paid");
+  }
+}
+```
+
+And here are the implementations of failure scenarios, which are the special cases.
+
+```java
+public class DownForMaintenance implements ReceiptViewModel {
+  private static final Logger LOGGER = LoggerFactory.getLogger(DownForMaintenance.class);
+
+  @Override
+  public void show() {
+    LOGGER.info("Down for maintenance");
+  }
+}
+
+public class InvalidUser implements ReceiptViewModel {
+  private static final Logger LOGGER = LoggerFactory.getLogger(InvalidUser.class);
+
+  private final String userName;
+
+  public InvalidUser(String userName) {
+    this.userName = userName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Invalid user: " + userName);
+  }
+}
+
+public class OutOfStock implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(OutOfStock.class);
+
+  private String userName;
+  private String itemName;
+
+  public OutOfStock(String userName, String itemName) {
+    this.userName = userName;
+    this.itemName = itemName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Out of stock: " + itemName + " for user = " + userName + " to buy");
+  }
+}
+
+public class InsufficientFunds implements ReceiptViewModel {
+  private static final Logger LOGGER = LoggerFactory.getLogger(InsufficientFunds.class);
+
+  private String userName;
+  private Double amount;
+  private String itemName;
+
+  public InsufficientFunds(String userName, Double amount, String itemName) {
+    this.userName = userName;
+    this.amount = amount;
+    this.itemName = itemName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Insufficient funds: " + amount + " of user: " + userName
+        + " for buying item: " + itemName);
+  }
+}
+```
+
+Second, here's the application layer, the application services implementation and the domain services implementation.
+
+```java
+public class ApplicationServicesImpl implements ApplicationServices {
+  private DomainServicesImpl domain = new DomainServicesImpl();
+
+  @Override
+  public ReceiptViewModel loggedInUserPurchase(String userName, String itemName) {
+    if (isDownForMaintenance()) {
+      return new DownForMaintenance();
+    }
+    return this.domain.purchase(userName, itemName);
+  }
+
+  private boolean isDownForMaintenance() {
+    return MaintenanceLock.getInstance().isLock();
+  }
+}
+
+public class DomainServicesImpl implements DomainServices {
+  public ReceiptViewModel purchase(String userName, String itemName) {
+    Db.User user = Db.getInstance().findUserByUserName(userName);
+    if (user == null) {
+      return new InvalidUser(userName);
+    }
+
+    Db.Account account = Db.getInstance().findAccountByUser(user);
+    return purchase(user, account, itemName);
+  }
+
+  private ReceiptViewModel purchase(Db.User user, Db.Account account, String itemName) {
+    Db.Product item = Db.getInstance().findProductByItemName(itemName);
+    if (item == null) {
+      return new OutOfStock(user.getUserName(), itemName);
+    }
+
+    ReceiptDto receipt = user.purchase(item);
+    MoneyTransaction transaction = account.withdraw(receipt.getPrice());
+    if (transaction == null) {
+      return new InsufficientFunds(user.getUserName(), account.getAmount(), itemName);
+    }
+
+    return receipt;
+  }
+}
+```
+
+Finally, the client send requests the application services to get the presentation view.
+
+```java
+    // DB seeding
+    LOGGER.info("Db seeding: " + "1 user: {\"ignite1771\", amount = 1000.0}, "
+        + "2 products: {\"computer\": price = 800.0, \"car\": price = 20000.0}");
+    Db.getInstance().seedUser("ignite1771", 1000.0);
+    Db.getInstance().seedItem("computer", 800.0);
+    Db.getInstance().seedItem("car", 20000.0);
+
+    var applicationServices = new ApplicationServicesImpl();
+    ReceiptViewModel receipt;
+
+    LOGGER.info("[REQUEST] User: " + "abc123" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("abc123", "tv");
+    receipt.show();
+    MaintenanceLock.getInstance().setLock(false);
+    LOGGER.info("[REQUEST] User: " + "abc123" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("abc123", "tv");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "tv");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "car");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "car");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "computer");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "computer");
+    receipt.show();
+```
+
+Program output of every request:
+
+```
+    Down for maintenance
+    Invalid user: abc123
+    Out of stock: tv for user = ignite1771 to buy
+    Insufficient funds: 1000.0 of user: ignite1771 for buying item: car
+    Receipt: 800.0 paid    
+```
+
+## Class diagram
+
+![alt text](./etc/special_case_urm.png "Special Case")
+
+## Applicability
+
+Use the Special Case pattern when
+
+* You have multiple places in the system that have the same behavior after a conditional check 
+for a particular class instance, or the same behavior after a null check.
+* Return a real object that performs the real behavior, instead of a null object that performs nothing.
+
+## Tutorial 
+
+* [Special Case Tutorial](https://www.codinghelmet.com/articles/reduce-cyclomatic-complexity-special-case)
+
+## Credits
+
+* [How to Reduce Cyclomatic Complexity Part 2: Special Case Pattern](https://www.codinghelmet.com/articles/reduce-cyclomatic-complexity-special-case)
+* [Patterns of Enterprise Application Architecture](https://martinfowler.com/books/eaa.html)
+* [Special Case](https://www.martinfowler.com/eaaCatalog/specialCase.html)
\ No newline at end of file
diff --git a/special-case/etc/special-case.urm.puml b/special-case/etc/special-case.urm.puml
new file mode 100644
index 000000000..07bb47eb1
--- /dev/null
+++ b/special-case/etc/special-case.urm.puml
@@ -0,0 +1,119 @@
+@startuml
+left to right direction
+package com.iluwatar.specialcase {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  interface ApplicationServices {
+    + loggedInUserPurchase(String, String) : ReceiptViewModel {abstract}
+  }
+  class ApplicationServicesImpl {
+    - domain : DomainServicesImpl
+    + ApplicationServicesImpl()
+    - isDownForMaintenance() : boolean
+    + loggedInUserPurchase(userName : String, itemName : String) : ReceiptViewModel
+  }
+  class Db {
+    - instance : Db {static}
+    - itemName2Product : Map<String, Product>
+    - user2Account : Map<User, Account>
+    - userName2User : Map<String, User>
+    + Db()
+    + findAccountByUser(user : User) : Account
+    + findProductByItemName(itemName : String) : Product
+    + findUserByUserName(userName : String) : User
+    + getInstance() : Db {static}
+    + seedItem(itemName : String, price : Double)
+    + seedUser(userName : String, amount : Double)
+  }
+  class Account {
+    - amount : Double
+    + Account(this$0 : Double)
+    + getAmount() : Double
+    + withdraw(price : Double) : MoneyTransaction
+  }
+  class Product {
+    - price : Double
+    + Product(this$0 : Double)
+    + getPrice() : Double
+  }
+  class User {
+    - userName : String
+    + User(this$0 : String)
+    + getUserName() : String
+    + purchase(item : Product) : ReceiptDto
+  }
+  interface DomainServices {
+  }
+  class DomainServicesImpl {
+    + DomainServicesImpl()
+    - purchase(user : User, account : Account, itemName : String) : ReceiptViewModel
+    + purchase(userName : String, itemName : String) : ReceiptViewModel
+  }
+  class DownForMaintenance {
+    - LOGGER : Logger {static}
+    + DownForMaintenance()
+    + show()
+  }
+  class InsufficientFunds {
+    - LOGGER : Logger {static}
+    - amount : Double
+    - itemName : String
+    - userName : String
+    + InsufficientFunds(userName : String, amount : Double, itemName : String)
+    + show()
+  }
+  class InvalidUser {
+    - LOGGER : Logger {static}
+    - userName : String
+    + InvalidUser(userName : String)
+    + show()
+  }
+  class MaintenanceLock {
+    - LOGGER : Logger {static}
+    - instance : MaintenanceLock {static}
+    - lock : boolean
+    + MaintenanceLock()
+    + getInstance() : MaintenanceLock {static}
+    + isLock() : boolean
+    + setLock(lock : boolean)
+  }
+  class MoneyTransaction {
+    - amount : Double
+    - price : Double
+    + MoneyTransaction(amount : Double, price : Double)
+  }
+  class OutOfStock {
+    - LOGGER : Logger {static}
+    - itemName : String
+    - userName : String
+    + OutOfStock(userName : String, itemName : String)
+    + show()
+  }
+  class ReceiptDto {
+    - LOGGER : Logger {static}
+    - price : Double
+    + ReceiptDto(price : Double)
+    + getPrice() : Double
+    + show()
+  }
+  interface ReceiptViewModel {
+    + show() {abstract}
+  }
+}
+User --+ Db
+Product --+ Db
+MaintenanceLock -->  "-instance" MaintenanceLock
+Db -->  "-instance" Db
+ApplicationServicesImpl -->  "-domain" DomainServicesImpl
+Account --+ Db
+ApplicationServicesImpl ..|> ApplicationServices 
+DomainServicesImpl ..|> DomainServices 
+DownForMaintenance ..|> ReceiptViewModel 
+InsufficientFunds ..|> ReceiptViewModel 
+InvalidUser ..|> ReceiptViewModel 
+OutOfStock ..|> ReceiptViewModel 
+ReceiptDto ..|> ReceiptViewModel 
+@enduml
diff --git a/special-case/etc/special_case_urm.png b/special-case/etc/special_case_urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..03ca646f38161e276ac30adbf955d05d6ede106d
GIT binary patch
literal 459244
zcmd431ys~q`!<Xn)KR)cL_`_{q!mOIq<e@_>6UIV2<eh80qGcOXc!E70Lh_IV(1(?
zzdd?X&UyaNyWVfD_xsj6Yn^pm!!P!}^SZD5-s7hrCxw5R@-hw%4*ugu50r3lF4=&8
zLN1;L->eO_-U0t(wv*Jb)3bWvY;Is^ha+WRX<+lr&Ora#bLVTuc6KiWIXGUJKeM#6
zw=iedv$D9tDL{>ba~8)$MZ@mb_c*7(W1JH5)wQgK`G`Hpz8&8?>mC}`{357~Dv;h-
ziT}QmE7w(iSMt4k%B8X@*U$MEhZ*j#Ffb~mKH9zd^xj_@y^bBb9f^AhxXqGbH*2qb
zWI1*AOhO+2=`UV-H!h~tUVAgkq^<W-L-5+;qBlzVp+@9aVy?yLtq$Sh+`ELdeGzHU
z$AEJsMs#G%!~Lutr@;a*`kN{x(b+?-S~2x+g;ummkBl$w3P$fReY~V|e3&+VmHGI}
zZBFQYuSh%bzf`D`ImfSh+3M|4-)MdACWV-Z>BJ4@3pdipuKhZ{-~E;0VT}Gn?6=Xt
zhP$U=FJf^C!i-t_gDd-&yID;Vf@0V2%_qDQGY_4%iY6d>b1~HIlf#D38ik67(xWQ`
zB%O?UmwYzfJ9@kA5M@*ZkDt4CIx|0wJ()&|sjZPo++c_C!gOEvW2lN5UAsU4?u{F!
z=S#!_t=(NrzWI;OUZz)5IHP*N@lw?6luYeBJWYj0Cyw(;l<aQa#UOa<0-5*iN&56Y
ztLZWilS$ss3(-PLj|V6?@k<yZyIY?yqrK~3_*AjHq>h472BNjbNpGmz0;MsczPO>*
zN{p{a+RkoUgbk@moy`#Jhziu{5G1tEp>fkGCSfP03P(`w5r5EAPuHJTlW~yxaufZ6
zOmIV0nxcUNm%xNzGt{Jr=bUPZnHlH#JBxo+R$jHM(DZ4&>}rn-BS=$JIbT_ps%);A
zjhnLKXP6<P3W<MSOlf^xqsh)pKFmLDG<_`8#4!1|AeJ*$gv~Cj^?7!+(#$@7TH5r~
zG4GoiW~V)+xw!ZCpUnr@?X>Rm85TjVJm4hZKNo~iwpcQWYj)f<e&tLpXFON%mDbu0
zm*{G_*-=cug<Gg0LG<|j>uQ!6c!$D?f$$Jv8iG5DzGD-1AH=Kuw9f1m?%7smvpA1G
z2$tN<k*&vl#e)-qH{nk7Rh7tvx4TG?m6FigNkhc1obh{m->8Ow#XV})Btz3Axk@3Y
zpqq{oG@93FM&dp$L79iIACV{@MT$^J&P(^;BDZ)tE!iG+G2$47nfUOOYq-9u(RI3(
zZZgiO_9mBQQF8{rUz;2++db#}8&7s27&<%>Q6gPhGEe-K>X`8>t_8=c@3x0N&*9dy
zJcoe`MXgqJQ#={gyOJbGqDKwegT&@sovP6Yx<H?_?@u?FwTW$-^v*tH;B*r^TD2BF
zz;|<o;B3~>d6i?Bn`5<eH9Y)UZ0Os>B}?c=KC_(-;U>D#ptl<O%tdV1kf2_@iZP)}
z<sn0bXA<vAdAd}y>n|@CZyY<5K3Tm?>KA(TZA0<gl<HG!qC?sz^g3kgW>$C}7Oy#O
zPahcIk$RpxJ~ab}KywTh2yt*;;yiwEU&TpxarBag%H~m%H7N;d<W_sJd0&+-3kzFx
zZ}%NGD|XHP+Da`*hQoqsylaM9*$%3g^udV6h=TR~dhsjeZ*Q>mzGx}%dRQ@W`T+5w
z01-UH`8na01ZNGjb7t)$W<N3V*(Z#NVGW30zdrTM9Fy2E_V=gaD*XDdf8)G7t-$i<
zZ?|y%zx~sI7K_WNdns^}p2nT2->>y2gI|9c-ho2#^YZrX9Q^tI3iw{>8>Ul?Ulj3c
z#V?<$Jb|ZL<KSqot~Jq_b<!saIr0T#<0|&^^0~g%cd7h~?>Px*g=d$R*gEMwJUl2U
zC>o#ryZ{GBL3@$yAdBP_ad++ZSguIWlSD!L&Loiw1k`tJrXHD^n!32`#qt=j>s0A$
z|9ULWK>gUK5XhB#^s;ex9=lSS43}AGYmam!3Pps6gBxFL%yw;TY#@<OCb1dh$EW`M
z7O6+CKhEVjUpkMkNe^$U=9Jn@x5mW8?Ck7(`SRt=1%eM58A$@RjTOIlT==Tin+|OH
zli5IF%GMKZmyOxg)z#+a=8B36aLc=Q?>08<#x9Wj{fd{*pZ?tK>cbG)e31y@jjs|P
zKYnCUF9-ymkdW~bBY9KP+beH=E$SXuVfkvB8gWrk(Ik7o+qawqXS~sCAw^5W<z}5X
z`f^lp@$m2n2nYxXL;U<6KY9cta`9hxvoOFX@-#~*wfP(tH9pU}uGD50d@g+U887Wt
ze1e!^-uh0HhJ%B{;oc^k=%CZ{h=`b&`0CZGSFT(kBa2Q*K<>Z)wOa)|pa_+|XVj~#
z9WpdC;C}xtMa5Drme{G9QX=#5I`^kfzfCj*s26Bc5D`Vh#5Di!+?$$~1}Dl>%~iX1
zul|!aZZw+~DFsEP?Tp;N#Fm*uF!|ER`l!VrNo99&xZLW?+bbe28^-;4n!p-@KEH^?
zGzF?AZIIheb*IZ59UTn`1k(ud-MV#)mDPM{2)?$q222L1hO^*rZQ$VezpM35&Jhee
zW8lZ6D!S00uRPP8qslVLd2}87pj0TrV@SYZuG`?~U{@xJ^%5cB@!kRqm{50j_l}d~
zujiN>SbhJoyfYUFX#-nI>=*jSJ@(u0x(%kwL~kt)rnQfhTP0gpTqEPqJ=hwyG8kQ{
z+h-RN8s>EQR)31ZKO}@BN8XHuB(l?wh^fqCI76p<wA#_gz<|PNsz`;Us-oR3QOwh$
zDVU}>m1W%fvoE2U>tLx#gs@lO=ioWIOXp~HA3pSP5G-y5atr*tYrVF%=oNta+O3C-
zOtY~@xTqm;EwwvWS6?hqgH2MAlUEpbrB1g+OG!#H-nc<6;?f)G`^)5TUc~2mC%a<x
zT%jZ_-73RTYq!~_p1Vt_d6k&>L-Ouqh}h8r^f*T?Kh7f#fjDmCKpcSoW{pfY?Awfz
z-EYbmB4e!Ec~M#3<s&w28M5)EEkX{9#$z>=lsTFu=o)8C!9c>9A0}iYXsRM4&PY#x
zAAi(kA>VYjoqs%!t!BAu!LG;FVx&SbpWAxk!DnOOz6O;rm=y#PS2k6>Qb#51RH%Ix
z9+ly;Id79SH#fJ}2b{<}CW9GTSK|?vZh@Y1bf0onsdliiX!-ux7atReL?Ru>-OD`=
z_e||&8~jOtF&M{~j|FI395STHB?^`pwsYsD4;CB9_!7{xMzUnyY)hXVM|hf==2)B3
zs?&C&C%ae<c<<OwXXP#PH%&O+*V}ZtJ=2k>EVduPB(Gce^dqo46by=R-**rY64kx(
z%RID56n03$bMOPt2-4Hj14~!s!5?$q*5S1UW<|oHcBi8v&#*m?iqHJ3#og!>HEKTd
z7|WpJuv$7{rx%;^edwV5y}jj;%AP`5o|*Juj3U2j1HFV#*7UgNajj)g!WD*xSt)!L
zL$kgf$A^yj%_d!`-jKU)J1=<07YnMFyAgrN21r*opY0Qr5i*9WYL39H0W;HCZaE4O
zQ(pP*OUH-gUo==8D5{$Cq!e)}ebzA7lexdMLq0QIxl}fcl#K}pF`5bS7uS_I3~g*k
zE3Sg(j(bxtpnBe`!*qwHXhmF_iNs&LC_I>IY;0T}EMXE6N!-4F?(hBAi*{T_d{Xv)
zW&N!fpNem1Z!gCLZib@eGauMrK^*sMS&8gUMev&St9VO2c;HnR<g{ElqXyHhH6JVn
z9-QMH$)bL=T)na}j6$&unQcBu7dEY&1r8E<TeTF{M;4bN;XBVC!|_WrK%!aGJsGk+
z`C$w_y$ar!N#v46^L<F!ARpM0g`JCkh^ErGQy7C>94vu57AEkTMID{9;4wrhL;wdK
zNs+j~tCA^~Sm%5mkNiD)N@K*ZBN8?9>H;mNom{YKLx||!qxQ<ftzpE$y3Amh@Qtb0
z!dnA+*t~}9bmUm)%u-DAfw0%q)*_Df%;0K|9=)Z^fg+C7q3&?&$;SI{&S!hO?``bb
z(y7sQcF>V{SNfpyD?L=yw#_!HpKiLuvFX-m#1Fo||E9kF-tGdhMT1N~Kfmnk>>9$`
zzl>_jT4RUgQXeV#g>~(U7vCGHtW<2{?wCB^`B0vh$GWs6*qJN_^Nel?W01-b7#tiN
zt+H2^AQWD$PhNm(mOD+?a&mEUD)70kPqhFoK*gpeCovsDD+z-3^B{!p<-jb4%l7cm
zZO++~ZoNSeMS?oF-Swe$DO%?TY#>dA#KAO641*|_Myt!qIJvkK*+z;D+SVqU`k=fr
z(d?>Pp=P;sHq#{}`IbGaBI~USfqKuMD=8^G*VEf<&q}J33-<Tt4vd4s4F}p()pbZf
zWO3Jj3M7@BoJ=`C1kWvN9V{_g=*>=Jdxv}UnNTb%-+p;SQ%ko%Tfn}!KrG4jvWp5a
znv$~2a1Qt*s@w77{3cQzgu$)$^{uU=)z5@v?AjH;gh0dxnxPf2@j7XeyJQ}clBxua
zuY^JVHGLft5>jW#sZp%&7pDm~?F0TiFSWfgzOuBGf75)pOcsA`A?h;8?JtduIVqiD
z$J+SLI+}Ct`%C4fyYAbgnNdO$A9|TzVC7V5((_Pjd1fZlzucrJ!vwc4vp@T26NnTT
z_&Y}aF{iYlw+zh8%tP}NDZaGbgq2Dx=(ZL<eD85&EYD_IaH;vAQa-mKl6<nz&w~S)
z{utaW+QY6lOVLz?eQp;sW4k_Pr_Q$6ogU!faqr$sN=V_;S7l!}n{4IohxofyI^pAM
zmDs85+7v@&#?R%Vdam@{7u{bhxqtsY2tFXITU%SVw6vVGq!z>~%k7-ooCH%{h}{$n
z*|~Wm(X}r`jo%Xz8iS~EFYWQ~_M+IVYB!@mumRi1qW@gYODp8?1b-BuiM<pz0cQKl
z)b=p7ceW}LxoY{{q@n=VtfQ*z7es+)4~1%zTHF#8glH*!bFDhsMjVe88w3nhqzKu;
z)a>eH4>!XYP=o?&>unsl@CP8tF<if1s!oTNK}3TnNB*!JB*fu?W6`2wkd96Lj_xx)
zfBwApD{!(>@4pQprqbi*whcSB&E~K^B$#^S`_c!WYF#wzm&XvtAK)TVQ*%yF-b(@q
zPeaye362W<EVvg7LmX9E-(|`)>P#|yeUx^zVIPoEs#WcfPwDdAn`}b@akv#vc{>(9
z0q|qrSC9~I$jBw!O{smPDCY^_$53c_`8IgQ?KB3d;NGYQ4<5{xGk};QVv9zC05&fs
zE^iG}D=n3sK{bU*_!9IL=xCMqX>Tr|lDQ3}fyr7s+;@E}FORZlWDyh;l-dqg_`b3-
zes5;T45lhk>$2I+H?cP<kokVHg}KVicrMF^^>2f>yTQw=x}WukjxJeV?C{+m1Ap%{
z1>GSbQ6&N4;f}?SifqgslW=PdDKXoFoi(gt>)iKqE&=$Y&?W*`Lw0o3q2tUpBydSt
zzaCWqM^E<Hdz?>BOnf7aTdJ-=DIE(eHimZr_yPDK_hx*hA`4_R1G6ysB}v3}gAh-$
z0O?P{f)|mvGJUX%sls=%7$~HlX_ZPOnolqIp(Mei>oq=6!L9Qiws~%3>xqVjPIE8n
zR3rvrP_Yw8Zz9a|ySj>s>Qn0GG|x??I@o=c4IYep$QPp|=ZCVhC|ELNIUAmeO%c7b
zU=yV*-)3eU=X;qcYQOtXm8OWg?=6m2tM6Btp$hic4mNt^RdZCjd_W9kLRqX$G;nco
z?a5D;Kv=4Zu<ED;v2xG@r2bygJEEeZ3n&<>)2=QWBvzgBtz*$7<zqpF<!DvA?Y#oO
zvMVUMP64@)Ok-Heg4A@Q2QRw^S)Q&uljzZoo`n!7G`_nl{3<|h(f)`q@QWbAfLO0c
zGz2#@qVDhN1SuyIYip7Lq^6%LtS5WdyH!~_;&^4mKCG-F;S)f7eX~+@?kZ^y@nJQD
z<vkDkW(IT|N9~m}<@)N9gd7VzaNk@YRMWbMho{m;NF(?mN-LjabO5W2R4*^D%p@0S
z3n^?A68pHTJ25%gmj$d71ZIQp^{>wKeFAc9EcB0E2$`YIY*H>oecep6(L<c?K;Wvu
zGKoO?duJ7)u6xKVhB^@<8m=9Gf@Niqe!LsXbnV(b+10f*5S>G;8x8hiLAd0up`7c@
zRtAYzg$V1L3SlUJAWC(P+#!Hc%f3F&R{k~%szTVq%@xJis3?aXS^jK#+kB_R0j_+_
zEAv4t0GFf$fq1QuuZ8e%ht-rVMngTitiA*IqGY=v8yG=p^4SO9bT-L#xr@+b1iRaa
z$!~Ep3qky23i07)sdP4V(T-!zQb7P!C}>saw_Jr6n)c<aXI0oRGW<(#nCaOcA%aOP
zW+=l4j{?A2Vp7tZVqHH=1WwO9hF>w`R?Ux?0XYj|Mo*^v{{DWh!1jnO7N-YBtdkqc
z#d1rE33?nj@!HKKIvN@nWT#w*kqFt%zV}J;*fX(6iBQU{?^4%wmJ9*_O~vd9Vt=_>
zXt_dyZMzkwMr_ltVf#Q@+Mn+O2MurW8jD&-i%D-*7$r#7xsan4rsS+?EM^5^SEt$`
zn_f%|QCfQE&^TCY*v`Y<hFaUU@_~9sE8Jz%lozw&d0g%B2oXJOh0qx<Y()XRD5ViG
z$@NAhi+SqSM&}uW0<F%y51?T<hqkBi%w3U%)LNecx=5;h_=ZlQi%4QT2ohz90E)JQ
zTUx>yzkmM@^*pp!QVJJl-ThPU_-h||LlqTCUIRb}5DKr9w(Alcyh$6pGMrH+Lq2(|
zNKdLSY<3(|qFrgTQiJIr6gyZw+#V01<ZVTv)V0{5<^bCx4#S}==g*zXR)p24lO8Qu
zdG=7=-*jQ+xByR0*iSZdaptug(GVN@@R;auHik=YBTYOQ8l($+fzI=wNc;Ms)SC0O
zPIp598J&R511)UiQP;7Lq^vzY+MgC8AtiN~{Yqb6K6kJ;b+-b|KkkNMD<4^(&xNsT
zm6@-M)q*U%j^CHO?sbW1gQ{z#fn|jkR(#{;O~bBK$zmF~Htj1=SeWMb<*EZPoYe)=
zSui=5xa;T?aL-<Z=ka-b%2JDAwRXqDwZ*BtfCI`ZCl$*@)I1i7*ok`_z=KrsG}Zz*
z>Oxm0*QeXkQd2=)9ZW0I+Vq>jQJA78^^g?bywG?m5olU{{0=!Dt*}OW0?@>F5+@gu
z+bS0?Ufi**c9!<YcLJp(cxTon|3!X2KD9&MaR?VktK~kZ*{-zBAIT@g5`Y!4+htbc
zx^-^Oht#ql9hYv)s%~%)Cf>D9^>~yvq|IOUM<OK<<E^g}gcSaahq{&(-+kQZYyheb
zm&t*$Fs;ZwI6OEARJO<C#TEceMix!HcGFoS1F*go@!-vcxd*@{;i?Y<$%~$Td<`ny
z0w_Ya<2oawcZmAgza8j(vjEG%WqH+ejjvcFrKGSWhpgJc!2ur3VF(1jH-w_bG3bSb
z{VzoFH*VYjB_!D9t?=-0%jzXQ-lnFeOsnxaKnB@7G<{YFp8)6w>?a2eVA#AADo-=b
zXTCo_J~1($u8&oxs?=d=$P|(;9XaN)zl2N1ZVo6J>B!rryFx29X=*L4t&}{5fk>4!
z-6}{|kOire`+6;Uoh?@#mINu-+20SL5$Yc?q}VD3-gFp1T)RFt)-zILS_h12d9->)
zt5V1FaI;wGvl}P{J36bHVb6liqzvp4pthz2Fe|JpP0Gxy#TmGc*xkDtb@}Vcg#b_d
zlm1Cnz4u-HQ4Sk`T1>pW_U&=JLqgYqHL}vve^g|%2BZ|I(Jjybbzu&@_}YP)huI9a
zL@;eifJdoHG=<Qi2o1172DqiFm>me8yc@vZO>j3|xjbJaVieoGami9sQ>W}+zj?E{
zayLh<*OT;plJ;d@spFLJ34lUPXA#GTFpozo0BsI6Xcs+i$X3qmwGrqI4gE{A&g0PK
z&?ZP5`S$Ha3cxtjRept+wx5Q{*P*m+SHFFXi6O5v9(wa^e{0F6YlDc`b}cF~vDSV;
zP1Ee->vNAEKW-#>0&veEDB_KUt`<W-e<Z)_DNN?nFX@U;G9wkKXN{mlA#hzlriopA
zwC|&q58=Ib?I}phpm=|`1YEDxM9^jHSMbGIw$5I)jlXRZc;?<3H_HFkQgKO1Uv)_^
zC9moCPu^`&Yyp9RBLJCz8pnxF<=1WgQGnF>c~h#|#-sK8-nvY{ml0mReEHHPzqfDS
z1_a2+$)Qi=Y6u|ya+<jaa2f(2T@1iZ&Bl8maMSj9{*XVAs$TRTSLsyQwTzEL_samn
zi~1k0V&UU+7%>2dyYbmO2%y(`lJu+W=05%5#GcZ*;)<C{;*?z`Bt#|Y16u~n%n8oy
zDbe457j#_4#@5oASYQj7KZthV%MX(C<tSi5(nUJ$R>n@2-8X;InTuskYtNUQGeFsS
zBBS#aVR^-~Ps;-X@x;W$oRijm7ER87<hb}ZS4nOM3NP0j=dD4bH?LoR`t+&4K!=Ks
z&huOSD{%9q`7gOYO~jIEB)<?44$eTk28x7+ia${z|KhKUaEKZ7bkyz4N9+hrFxLu!
zf%ZCGMb<q6Ze`bhU-}gB+;|#XDOZ&6`#T(kMiL1Yqsa_g|LI>r2C&H7a&Q}|5L#LA
zk&%&+m+x$DzH5tqVrYm4aVd~R!{`U?`uiyZvT&PAmo5Q|1*H&31K3+-WZFQfh(z8g
zz-|PPy1%b}%HP*2DJj{|*l0OkCjt<pfWU5Z7=ww4iBU%a*Z+7q8?;XN`t|F#Z{KET
zX9sl`xC6v!EUitFSMo#hzn{LC0jUIF&>MVweWe~gY;0&?ym>R@!-o%<nN;e99Y0k3
z`|84Y)9KS^&XBQc`~{K;EiEkx3EX{uYieo=AcM)v{exONiodf94vvFzzBb@h0p&&t
z?jR*41?EUa6%TmnxHwbokAgo9?AO!lEpsAqft!GogNLVGYTR`)YyD4`1GfD4=kmQ1
zT7Hl7f9ap<BiPnVA6~SkoeaVMd+AfYkSi~lc=&I5{Us47#`pKPp>)7AlaM3t{}RXJ
zIvV)<+j}0M5#hwGnxJpwDRZ$4-1+klFB!ppg(=|I>4U|8iJ|@~_6dQIu)m~I)c&^B
zr<Z_T$v@10^foOkIXEpkJtHF{Jv}`$(@0-GLBRGV4-W>Ah>di=XdVNSlh=E-fz%it
z5uvQ4G$nQn><<`JY;5d*yF9B6ur1|Q<4K@}k&xgv)f`q@TFPV8LGJmhCVr>-d)cWT
zf>BUl9`wh%Aprpq<2c|w)6p-n9!~go`{HG>KUPv{YOI`0+g5k0439cb@pw9|)Q;*g
zH7BpbS;MB$EngzQlSp-dsgVNf1PcUR1n_>a?xZBkgOtB}2?}b!N>}xJ{daF-zMv0n
zMF%%RKBn{yXUXUX2ewkjGGp4Q=+i~!sc4)AU!TJj7Z?BZ`7>A!h~rF5OquEF6#ub@
zRC<JGHTPCF{YMf=77Nkh@r&j+^1cUp3dYA*QY3UE#HP(OueTj1D5rSmF)qaMKa#fU
z-RA#R?2JLPX%t>#Wn~2p%g4tD!U49cCGj_X`93dI?d-RfED}{Ynt{UXh4;rge<h<o
zvbp#MCzF@48=E|@NNdhQhQ)G2wG_*)4Rcu~ylVuyecxujC-S$|yfk|M^BJ}gaI?<R
zY<dzcw61?En?#Z)qxs}@Tff;G+|d4Tdjs5Jn!z~po(eLhq5m)=E{v1;lT42x$&1cz
z_cS)1+nUWj*Vh?*UB*0^VLn(Rq~!mvTk--?{+Wc5`IZ|GmPxV(+3nDFw#u^)^@WOg
z!5x}qR%6V}Z2z)MwJ5WO9^X{8-jy3Ov~K&8G7MyKxZ>MHl?r9dT2V_qtWjgX+mD4_
zSZiP@fj>vD4fF+7p&k4kw>7F5dk1hyMYY5Y+MHpUi>=iuQQiN(B@O<(zd$x|Z^pqN
zKe;enxwn{6rHsQh%)Ny+sOg@x8}PB8lG6ZNs*i|lhgf&^GFKYul;{ljoNHwNdSCS7
zQN^+6dHaQNOqeAN?ZW7E^5^})gguw1i`Owv-1YZ|W>{Nk+kNj#JN^4%A0cbKukh(3
zA?$0Gw1T!(l^5@9y}rca8|XfWC_uQd_pv}z4&Kl}I>u`TYEu0dCASz|-yOyg`n;R^
zvyTU(B4sNMsUYDAo|?qLdDjBr+G_b|Q%4^{$f^F)=d6XMO_PXYj*+62VL_apt~%Xd
z^rGUHnJBqZ`0r#`f7O0`pl;X?r0MyyfoE_OwoDtw5jvG$s&~U%**>Qx)_zeac5)ra
z_pFu`@fK8knty9QT%^^*U<EC4ossW%fMr$O4qB>CGzL8=x%#^}I0i7aKv%=81asqL
zb>wt1{h=;hR+3mEOQG7kW?BP8u_K0_<mLs!hYzGWBeg3EKMPA=rT~%Z=O-#_zj13+
zuC#nrndvDtNUUlshDig|6DS)$c}#j3ZhL#OsEh+^zP&x$=0SF4j^Sq0@!;n8%CS+e
zl$8Te$6ow`S({Eai9tv)bg-KG&2IgOoG$^PaZ{n)oG)5YsrjT3<^LhXB8c_)qWts|
z3CI?ogGUCQ3r2EtDtisKAjWXObC~cgu`Ov4H9FihoDSjQ(%xcmjn?C&i*Xfr@iY?f
zw+>E;Lgn1@*Szt5r*4^EHiLajrXj7JY$8qqoO=|xB>aw4tVWc49;ua>9wydj>7F{C
zn^Vj+?ls3&edd@aEv1q@WLAVc9Q;zhpYM!mKQ({R-QAslPS-3+;xf?*VY!x_6jrec
zi=oa?WuDsb2*g?^6ue>v(~Pr;%&x4KRL0!N4LfWdn<k%ng!DDyC1YQ#*cuvHwjC%m
zDt$vO=JD2<lKIIWV@+MYJ?tpdHTFq9@g-=Uw<_g3&DZ;k@YJHO*nT%^o~k#Qk5$I3
zY)i#vR$jphn%Zx7HP3Lcm~grt5FZ{}<_CZ^Vuy~~_1J4_R^#;$&<4&9m*-CHti_Cb
z1b9qGjs;Qj8h?GS+mjI_dayb^(`m&q<<|KJmdW(${6l)0IV2$ur|L8~D|UO(Wu2j6
z%24&rgt$(IGsvEiw~IQ#_k+K<IjQwj+Oh}~s_V|NK|S~8ZY|yAH{U^WTA&IfhZM{g
z)d2&ZFUTO<6ildFQJBVw5fM6J$d1bYFyw5t5wRH}f%ed4j+kLli6eoU5EnG@*w`3-
zbyWO`ZL>~)`*;xwr4uL{t(KUEA&!si)1^JuQJKjey`0K@UVs?F1o7(%IW7zBZ^QP!
z`=-A+Z;y%s*EN4aZZDp&$m)=JNf2@vA`>CjD;Iif%o=8(T;=XQb}m&V;MIMmDm<Om
z9L0_T=LN1}zH7F|aJ`wXhm=;xusI*?HW~OOL%o4;`#V*5pT+ZSXJmS&(V3!_Jv2Qg
zgHWV~bw(!u!_c8B2e2gC?8RRH$3!<<OneBA$}5+6J~X6Nu5je^R@N0b2fK#VwsAFw
z#SnIGYS&bhcpM7aJcYXR%CQ~nEpWio5=9Sr5A{`vXzv!b7AA5as59}G#*b%0`*xFP
z{#dCozhW&GwtOg7W~n+dZD8*dO-T}vj5Jk6+K$MC)j+s}4~PVE=KFG!L}@ai9!)g-
zE$fKGCDKE2@MvN3X9FGm`51UgR+fNe=Rd{e_gh?Do1JQln3W@7l_mO3N|-zRN;i`8
z2jFH@0v{G&u%2=&b@x(;qWK`VysU!~(M?8g6A80^<O|n-3Po1sw@{=QUQgY56E9|A
zxsT_(^hOapna6dM3~gfhV2i!!n$&YqVKUpP<|><MH+)|s&ZqSergaf<FPehAhrXiQ
zPyP3$V&i|MkxM%R){3(OL{)$lr%d{sbR=!0*CmN*r{%ipXLcLfwt|iwhbqlrGQddx
zizz0t*DEDurOn35YNfQ49R79wA6`?spR0>SRZ4@|Bqi)i+G@Fp2_^$o*KEIMc1Cv{
z@Bejwdg~^Bdr#iO9}y;$fr~DQrP9vC=*{`fDJRgXVZ&tUAMR-mo$5^74=(%iSaxS3
zK*YcqxakINe#bxMkN7Qr#p250Zy@X(Jg}WHdUU8|sUV*e=XfSFF7vT&;?~~l3P$ua
zx)~%78$9$GTP`zH$41q9!&@JHgQaelCUiTMnT(3;&PGoN)@TiZdQ=Ov6{9-i`R^mn
z<^ID<yOv=tSoHSDAV+P4e_vUkCp4<IJu#V{A+xR^Ntib>M<s5j&vj4WRQ&5Wk%O0b
z?b^IeHRo*gLFy4Wk9k!Yvph-{HHuF?&@TKTwN@tQ(G$Fu{ys0bnL1)`K91p`Fx6k2
z9vibByrwD<-XUURf-Il|X8+$8ffOzh_yU{0I*!J|6*DpSPgm9Y&0ZwB9QD3~Db$%P
z>?gVJCLdFFZNJ)L%TepJ7^>0EBVi!JrqUnMU_=~IYSy_44C=TYxM8wd!x%u*6%%Rl
z*;gz+Klc*96@k;v_kE6J|7aMj^V`SK&V)fzjnRLqy;nr_U#W)Cx)U!l0)GkPU$n(D
z9qA~QGb2Bv{VOx>hH3)}M$7Za*<QMp5)(@AO9+dMl?t(J=5tq@2oYl^ycAnz+Q$Tz
zW}@2_^bd#rSB@@LXE{1rYGoX2f5TFKIY8H({kY)PX(Bb_6>G@*(`J%Cum_7PKV5h}
zSFhK(#(yo`UGL<=2Xjdni{uHSF!;`HFDs9EZs?=d9gdwIhy(~K{X!t^7xWzS`n}X<
zTpdm(EUJGbEd3t|>#H<dv=cvJqQI#3sW_hRZ7rTw{a;Z0+h=g`4`8)bP4$_i4Zblb
zrLfwm<y<A1LD=ro#o)fUfB97J=s(sNn@7UvnjsgaOi<9rZvOeS?UfiSw3Y5bKeC7;
z$a5OXutz{HvLi-UyLNxI>DhSxoz7mVzwu?euOi-KIo-jsCHHW>CcZeS_9DUYk`tH=
zgw3Qp^M3z9&FVUjJVb)M@n@ze%S*hdSCSEIDaG!C0gEzQ#=_^7CjNa>Ah>DVkTxW!
zBF)UQ#7SOWE3N_DVK7(+Fr<Mfj?((S??CqZhXb_z$!c~3fnt5g4uGil<0<hadw=YE
zoKYWC0L1=@%YGJ^nwkY9C73wLCEfsf_>gx;f~EO|QGau$8!H%MgEl+=biqH#6d?O=
zEv-)ZF^SujSpW`8e@Y@JC#@YAA+93VR4;pPAzjwunjE$DC;R=t^J!{G+5Q5No(vx~
zQ)U$X2kG3eqA)KDZGB7p#0Tg$NO6Jr{W1ov2n)(>acQkT>i>b%6<Kl;1Pkc_6dvlk
zxMfjS+E<b?$>fud%N_mJv&?VdwSF-2-R_Wo@wvfZ=gALueEzvT3i!_=Zh0<+-lGzx
z-FwwRc7K}9m1AK`T;n+GPZifk9m`?XQiaA3@22{b=fF<>QBsZ^dZ+Ua<@~dx{Fi{T
zNN|xYhg87@vB$RcNV+jstL=eH>zQtBGWwOy+-o2HLpnFUDE`N$uTI?hkH=oJCjO6=
zdELGI2b*FuGPkLuIJNh`h48;eB4qdziN8(zy}lRcuuOrWrNTvepZ}dN!R?p}ZC8{U
z|7Dc_m9O~y(4Tc*n%e(0lK4TV{A+ppZDtK*(8a-WE0j((X{;|^3vy&@E;DVYtQMx0
zKfj*f(5I?O>sHwEj`_2E(ujFdp3Tw0R;L&pfUmhOn+5$zc(Cf_xSO(;3**Oh$?jWf
z&(LO4mK|SHYN^}jP_TsybTw60&<bb7a>Hh>)X2p@idA7T8ee(<m^J&;ji+#Koq|7y
zo2pJ-GHvh=K}uk|(~D)pmZ7nAb)ta(UmiRBPRh2NqmWX=nytPvzq7N8R=rW}=sV_O
z=Ds9QsF-#hWWXxh8MPp)@%hO~1{wX$Pe@eo2$&elP3UA+?{FL{z2c)&O-2TzwdVL^
zhKk#-PGaePvj(vVGMZgPQNdJ*ML>IQ{G>FO!_MkZF06pLXQ<rDWA&*QBq@%vuf)hz
zQ#V~YeFZ_tl?V4c&WYoNg?Cl2SXSsYi64HY^ZdfDvj=*~qnCNcBN<TW2M-RQhUl_n
z&|?JYicoamL6noLE0x1{U2TE$6DJb{MBqfCdASK$Yd#JNLQGn!+vqoHVCK;kN`dx^
zJMWQ|$47`nAu=oSDm#-Iy%6}jE}(|C)}eGd)6qRz&9TB~Z#Fipki&PH=H1kTwfp={
zTe6k4O8r4UgbazvZ;aHtW_bc==R}sADAg;pSeEB7$S?{$8iP)ZJlV7S3fr0MOOF@h
zt?IZ#q_>uEQDYzMrdvb$KDEc6DTQxDCPio@CNF&o%N6jkC^NBzu~PFbQefQN%PbS=
z{^A_l4WQH!IL~JD+N!1tVKrU=N{eKX{iVq!J)~_h#&oE#kkE%<iIFE$-gD`TpRCwX
zg*JiSXjQCbC$e=2?zU^Uq<5_;*qxryAn2L+qvkuBYXe0=v9ZIa&oI@kiiddPGEt!q
z82|7zeh$fl0f2dtvH{aGx)fF1Qt9>27xT-{H+#ifR&@w}=+5aI<pzzj0@Ie+u0#En
zO%#f&#;Z#)ucOo9dvhPPM7~oS8>;OSp{P@zFf=(@cb>6lsvaqEyMX$0OGJFKTXEtR
z-RXSK&DMRK=IORfD#N6^McD>zBP?@~+kE-!Mu~#(3j~Wdp?0&YFI{<#cNn(5`>vo2
z)pDk0BDaI#VPPekww4ts1+36=%Z#npid@gXl<ZydRQ(e-Q%ApVU}?25(C!<kbGMCM
z1;8`TS4G!-Gnsp)L&!=^ru25MQRf!AWw&wuz?>{tyS)qLFBA17k`YW9+_f{#cdiqq
zbKigrmu<JlV#=H!HAL!t6>PXbXI|{;n02s;jLk1Gti^)5$J*NOJu+NM25ViTTc9B{
z!#n+2XWZOv;~z<A&h8-#bcUNhg)t;Y9JWH=yvdAWnb9h@T#8`g&lP~=-_nYh22D5@
zPy;L}9IyY0F<%zAPuTK3lPr?sqiwC)br)t#XltnngT7ooqz~V$@+g%*7gNGPx66y_
zHU0WNNgAv-cINEa!0~bpx6OHZs9TZI?)tQwySu)h^Bc<#^|@ebjEwt!Mta7>x#$oI
z9*wASOZO1SRSE&ED3t>3wP<Mnf{|RpPB<#kAZ39^@44u9Yp&}i>=YQpi(tjWOUQ~c
zhCi=$Q9nMwm>!=0U#}Tnj%R<Q`##xioeoyBJy2R2C8{=Kq?Jvw8OLWqOcj6Z`=Bc9
zG;E9owh?tnUZn41q1$-f3velih=X}rnf~n8k!|gzuE{H(kpi}3TUEuZcJAoHXPwRA
zp2z#pJ(CrLm=Y-g#riu)YM*}qX|2(~Hz@6&tf*Z_^aK>!M3D!OwYvS~cb7P7d)u%j
zfn0%ZZEjz9hAfq{&Y;d*iBV^9oqP4XSU}g`w&1*6*`e1|_r5mXY_hRDNrcKOX-@aD
z@cE^79fK90X~1_J9NcbJQ0b+%cwFtU+j%G2Tg|9H&pEQrIbWx`iq&ns#lbXAjfM2t
zFhu2qYoQEI(m8;)+?wyZf3wtTd<3{vW+xGMrfP0=-_@lv=Y~rwQNo&6X+%&gD{vRf
z&Y!NeR6-)3FrWe(>sv=X`<%qpX~%JnRszgP8hq-_{@gBst!PprS;YD~6Sy1h_Gptr
z5(l#s-;`Ob@Bl)8E-mAC?`9QGH+t{{|06Ate^;;3I935}I<1^p79&-H(RIq)R02T<
z%9g-wP{Eq5QS`|QAsMgEg#yUjsQSf}X|NiLv>NP4Wf;sC@gO5cAH8Z?olPTb^(r5y
zHP-N0o9F-yo|dmDsAo3Y+yIwjM%_}+b9P*v<UzpUXmXo$%lO3p0TchjlAI2lo<!b`
z)bGel4hF$9ifv!vp}U)#$ANVv#A)^EgG!q^-Ca0zaJTRGl5$8G5BKaN8SUqL)#yw$
zVu+paYy`Pe%uswj)8p=Bc{-(F_zI%M?P4dU*`24UcUT%g=D0Px_V%a2gBJL88A#ay
zM)kw)AM|LnT7^8xq*9tnwtxcOKyGth6|v7g!1*q`7`?Z!&^-J8{wThLgpV*|8zA&Z
z*%QpkTgz{j3W7|=kMf_J8}EfByViqQ0=~}jxYHr@^w0dL9l)@-$B{GKV>f_f>khSq
zl2S}UHLKh4VHmJ8{g$!XHd^<M`%AS-)42SGw4ya?`)8X#*j(7Q`~wO)zuCvSmlG|q
z9rRuzzkpLe3K(sSd>dKt^)xlJ20)h4fJ_n!Qf?O-%kuzfa4+TL=76IvZYyI3fGgaY
z%Opwm5NsVs_^?`aO%(KGPU2~a+8XAvqLOgHv|iWdf)R~K)%SzlrQ)is+kz6Z#`bj)
z4C=7>J1GBfFniXTQA3S5Qfd=g!NUfkT?V{OYa6`zd3>6oHkOq$1gQM@-33^f*g@gO
zCdwB2Ndp*~h-=hbIiDf&>Cy%mr}G%KM>Ugysm0hkbBwzaYfZ3Q_jQt)XKvvh9^4M3
z+D@hJ1|wc_k2JW=`s1;#-~QXPzEPA?W&U7A!d>C1EZ|H7+HAg8j0%oR=1{Zt@c1%G
zD;4@32Xr|-+9gq-q_4)HWw2z8K}uA;==m}(8mW)+j$N5*o<TZmi8U#(NT0`_XK!Os
zT_3I$>gD`!eTLEYVaT!(t<sMj>C{x%?yMTYQDnEv#~_{y{kv#<kKO4C5KdaA1no`5
zjt?fKg7e~e7i43{s~wrjjXD6)vL*ho793u9A`4nIKTED}6uoQ;C!#zSu>j~4f+Sy%
z*3WRZx2@Yn=g!Vn?xMe@z<pW}2gM#+i{-uqOMQUr+QpP~j&XN#fiaKUw~V`UVMogS
z;eq69i@;O-Ly|qee<Hx>qh^Ez*3+c;XJ@FzX!QobD27&Ptk_}cC$J|8?q|nGs%Ux=
zrlzMA++xQykdEg7-`spcUS&Co#LSe(mq%HZlHIJ^8p5FIQAS5=Qi~G}%K9r;cMFzA
zDj&IStFT#Hzp|<4ZmOAp{<}(2Gm})xu$k-bs9vtpIl{e4y7kJrw>CEYKkFDj>3j7%
ztE=+8xD+6?^&*bNro`y@N9{&|f|lD^`+n>AXKQmSy4Sy}%ND-<`3B={EZ4g=9sr2N
z{w&4zrY5br0tmbtxZr4#X3Uo_Zk8Ua#72KmflcK*Fp}`i?<gE%4Yt~=O!V!oupE*w
zY2qZMza)D?C-qPjmPYJ@OepDnR)43KbX;sPgk6i*JO4jf`|kqx|7_u+n()`j8jc0*
z$BEnajrc{bKgIk1;!D+p7%`3DQ0^0X5iA&6$NnF!7XPOj>Hn7!E>#qS6gvzWXLlkq
zSq-c7q<gI@f0X{S!<PlI{^XTnF+2u_D-+u#8bU3GU+1X9z`Ts_I+#Dy02t}hCs9s$
z1_P!)B@QsXZ!MQKS(Zgf*BS~cC!dc+gC;NLEXsC$3Y}Y!lPUsT8YucI{IQ=}w5ER?
z@elyJ;$jCAnTJ91S}EeY*jlUQL*O4ZG5)huAWl^qu`zZosXXJ>WZx|n)og>&SLX&z
zg!x_5=Fm(ek-6;tRy&A{Nl~O}Q3+y*TI)$ItIFv;+nI@W%wx?z;UBb8EKgYN%WC-Z
zr=OxpnC#YQP}z-Bo_7*A4;W6pp^NG1^pxfYZEAzw8tGRi{dq;g%5Y=r=mX7Kmp%~k
zk+$ZoIjYIca!m5Hh8lH1I>iTv+fs4r^ak{Q<f53La5C5AL#*3UrXiUFTWzl<`Q&1V
zMIHyZjdHC@=4+Pj#Wi?&F|OaSKiss(<~SHE#7)F%>@4O^%f=imh-Uv&iiBBbV!$!t
zm})dv-M5L>Y!|?1&<R`ELOLuhZ?CQGu6Q!ww{hr>IJfh{=TR^QD7nw0lY9T+5a7s?
zp{>pMe(6&58P$|5`OF%_qTP{KXp+P!5c6Alda<391$G@s8!BIGTrcTn<#(Sd?kbnf
z%%NPWNJ`!ui(%5KMkLfj6P(F#?-U6_?uQFwo=9mj3c3_HzjZp%GfuU9aFU43L-~)>
zX)Op9C~rDe&qFh_LRb+l(vGnVJngwN@j$4iy;)!c(H7Ld2lj)-BjvQ4TU%q*j<L?g
zYNULYZVMLWqnw^c9}f4`-7)Rz+ao=XNI`La2vV0uA_e(f#i)%rjF&Ss9L#TOJ{)&3
zd-?Zr-rt+g4*yI1BE47WM93OS8BhWLqy`FgSvp1qnjEz=_YJqX$oy~TBgk*rg4D9<
zM)Vh_Zc-YpYhL;m3cN_$H6Ow1e7Gr!Zh>g-00=iP=C=0j<6A6zTUX5$EfQ4Ty6y?i
zqZ~kW1w4;#P`FR{`64C0Os07V0`b>h!6edP7xI_5KU*VI{?z-k3jeebm;AfC@pE;P
zg7AHt&`Mbq=NnH8!At|X4<p+a<=AH1+nr9A!)R3}a4!lBdhY|2;R9AePPMOEN98;j
zbfjhkjs)sV!IU!z_@DF?KW~uY9s=ME^Vix=Rx$yI%P+pT8TtMc#`A#xB8;katdZ<t
zTU6LS-lh2=v%}35XqD&jZ8|zSO<Itop4FulE0|pX1Bj;fhA>^4DHxsGYR<E`sJ>jW
z$S#n~Mui^;i_T}h0h}6j(O$q=?4B>udlP~)y5UdYHYeac&Vu6^on7+=$co6^o)HTH
z-BF(KebDqMy8p&yZ)XqP??0cYs7f8_eYk%t5w*R5>YGQtI#b;OWs-Gi;gprp7`VVa
zRJAFBrk_{?k?7@V%|pr8KX>>Eun+ehXZ(}z&~iL;EQ)a+w@w`L5coR6EUjM|$d?>{
zEJZ?Tvt{lE>c!gH+TpU=&QNfuMk1*K)Pw{yRjEmKDx?kz{c=$ulzpgqWJ`o^3sfrD
zt%Fk*oVBc-wx15T_IMCGRYcqz1ikS?#}}FPfzsdU|1+9Z*z>=@e4Hj}bnK6lJTxPn
zHp^GeyPMJ$CDGQ-5=TUQ=W$XZt;dcB=4++x+R+iOzTHR#*=8F}q&GfgFQ#f;R#_*3
z0+gXgdtZnMDKbp3=EyAwY7(rHLCU)KYGmh^0K^|2lDcdZ_xARJi6d~%8XRs0b4U7y
zhPq&Ca;J?2hZwi7^<;T7QcJbd&>;XR(Ks9}kTnuHepLT-SGlfVu%X_Iqdj*jp3h=A
z(kQbbAT!4I2Ec_(X<$*+b|#sStVnNQbf`}4YKIKgjcu6qmU&Gd7>XJO=>q}+eqNr=
zUMz&xB`dqU+!5Pp`MuixU#tD};E*)#g(f(iW@BRmrtuGiMA+Ea7#J9MczXV)#a_1N
ze*q%uP<6_DkNGkV88q|OAcz;>m_?sD3W*#sq>a1*+MDvwh5mLGTzK(U6l!LzNec$q
zYyo|p<B5PG(CUizK6PqxGq+k)dEZS6vq0&2$Xo2TYXi6yPF5y^8z7o1Tr2ksyY|C=
zzbs{qi>I*%1O<)Oxx0cR7B)8PVCWT`LheWq&^wqW!SVMtonAaK1maysRk5$}g{&GK
z9N-K+dIxJKN|+iyK8hCRt^I)*BLV9eE&z)9`)pmUpJI8&E0)TrdNJ{!gB>F3(q34w
zz(Yu<s|AQa(5>TR^#nr@V`F3S{1?chBDk@WZMPKYe=jcxEHC=!^q3rWddxEiOlh?t
z`gypy0}(Z+?-eO*r=DaZJ?BR2p`JkpyEA>6@=dY6Dsl+}H*7&x$&JdAe*#2U=CFhu
zEE(6Wc(GojN7cSiC92GAKmP)BTtS_a%?L=e8YM==sWVA;<Zu2I)_cS%*(LEuVN+8_
z_);k3vA|O_;Yw|}>*85pM^TK$Bf_!3IhpAd5#H=oVAzXQSXh{wn;VR0f`Lv(Mn(~l
z(Vw~oTT9C89mQ8MNO5jniVX(_G+G7E)hgdgk*Fj=1B@Pbr!pU$uj$Z|pBVh%`H@vv
z&kIKq#cy}+>i3A9_f@k>^YCvEQv_MYpw5{AD6ttzz6s5(Z^O=E{+QfkKZbw<8Lq(O
zz@g@~Xmy-hq(JGyn%UJ<vo3&{dcro-(Xc(c_DJFDja`@FviBEgcU&QmKrkjEq$oxM
zuKo5X8`y9tcM_NyqS)^Z{dSqHm(Z&4_%l7BD9w7v{ggu~F9K&-pnL;A)?-^aZ_?tZ
zJhQQDASSLyKRA@S{a=UQet76FLD<y-S|>vkaY)MM37W$Zv6bz@(yc1J@)tnVxvMnq
z5q9kZ5)FFl@l^zS<DGf(m~W)D5>4`WT4benxJDH9RnW~(Vqt(x3tfugmjfY+*mmcF
z(97_^AM<1Oj%OsqGtQk2blkY&x7>c?#`r3X7+BYjy%opg>9}Ud;%5(VZ)d`7+Cpcb
zmxe2vwXX~MA*12g@i%j+vYW$qmc6mcZCoXEz+nVam^ku{qxS$R_e{sR_X<R%(5p$v
z$s(@AJrl7^Frsx4^hho7bprEPw7&8&4!>iIca*{|Oa9NYCM~bg2Y*5+;k>_haQ*(H
z#~pJLin&xGVfzx05}jG(96IA`P_u)+S+VS3vH5t7GDtEX$Ulh<fUt|zB8B4_&;UA$
zJdJa10+^+=xg4E8L=h2j;B<ccXs5f`8~yt0;RE(}7OhbR`*#9>eH?}V*Tsj&g2m@j
z*|#qduPhhY$z&CgvAUIcwMIox)fpDCtoTTSm+yQ&`Enh=dOp>kGRN2uHUm!AafM*C
zoI{uw{_Zdt%?26idw*Yqtu4y^mJIkE0u8pX1Q9A&`xEKQxVZcEHQuK`|JnDG|HYsl
z5ZM65(MN*!H?U<}i|~=<Q;?EDhh=4dMFJ_oZV09r09&h3V(8<Xr7{DkOR-HAUofuG
z=XnzVMGQLr43Z~5V-+<LIr2h62juv{F#XRyoj*90QUo|1peZ-AF?ZJjEiaZI+LIu%
zZ-IH3;QK?V!be!K>TNwq4BvmF`Tu?{5W9A=A8S`G*IIIQDE>9@CO(co;?6n|pkv$A
zP{ZNbib7xVbjGsT!lxP=Jq&1V7+ts7!6_7JgojSMM7m&hwjxMH5iGVdiTof%Z@2Sb
zu$%8q1<^?@f0<9dEKXe4mW;u54U_v+m))d$ijPAl|5hv@?7+xczi1Wh4;#5X#c|au
z^m=FZ87lGHaP5gvVeGKx730NoL}~;S`^8{N&3^nI%*}h9(7{;16Z0J7f4i9M*GwU>
zy)PL*tS5FaXsFJJ>38qx%V<5DZxnyLP`#rz6QGz``Q?vriO9&vX+*X|#71_%M1$xC
zjyV*7&J&=#<E3QmbzPU7cUQ#0$R3ytlwcFKH<bZ2>R~CF?rhhG77LKl?pS?%eA%{L
zCnO!R)}5ZXo)3Pm!Hm_NWmo+&03l1*P{_v!TEOcJ6ze-Uw&#o=eT`yt9I?%;()-qo
zRJBDe%rpELWNg16fmH+XPc<N9hPM~NkHP#LVq6}>$9u9<JmJL-K&h%{xmk~9r`T1_
zox0Aweh*kY7&YcL)lI)+xHiGOKD7(DsCZv#*En9Ygl)RA$7p)@<!X*?xrnV6Z$`E#
zKn7OX^B8=uu;z%H5xRUVed^`u%58uRzhoTzoSTSNv7{hfT4eM&?i_P|DQR75eSlN+
z(%--FY7lu4W7L4_DJ^2EEm{?oMaHemx3|VppWkl~m-<WQ0sY0Rl6a(nyKfnzZrtAT
zKbN%P-PKZMd!cEREotXi1kp6JoH!UeSX*uH0Ck8Sp_)`Lu$h0yEW!PRMG4x=uqjg;
zAn}@W*l9(#!ncWfeXfV-IkOjMK*K2^ocfsWwkFeCa;-NHb}l#L;^5rNEP2ILZ~-md
z#yn(6v*==1pcO+Ep<BNG!Z22H38tCAnR5K{6b;eU*SdAWmCqZ#kg|azC0gKz9YnWR
zj>E$p!eXoU^FZ?x{60&W;|d?*nD&~^R%4JvuDbkkf4;%to~l`I7MR$=UAy$Q#+_>&
zEo(YC?m7M*82jPgpv(g2LSJq;gD(Y@U+<Gm*Zr-owaI-Y<x+?4%Y?KKDk|;{5B8;u
z(a;Dbh%C_1*2R))7V9VEWsg>q+0E-~<qz=(QK@IvIV{C-<X)@NYZ5kXZ8GxH_@Zwj
zN%=wJON~=kGUS$a1&*rOSPen#&9qcu4U;{y%uYV}E|)fazWkU3w+#K3RLKAc6Jz34
zGDVhP@SAVfB<x}y-MbjcQ-!*?C$c9Pd?mt@`+^)LvXkV4ypM@wxXTBRY)9)yvEk@f
z&z>!(MzfzY7W3x0nk?-1{7vR(>LL{?`NZ`E;lU!;Z8i7(Aws$__x3nu#9>)9y7akh
zdY`AxMl?a|06Dk)_La{rXe8}c+Rg%pp4-6%ujKf<PcPt*^SH6+kBmJY^rC~Fat3qD
zvvz!i9T~l@$v{a+B7Y?<EBSWTep@<L_AIq6>bf%*`ulUE<7QjKJ_jxp&o1Sva}f|Y
zxG_B>X4n3<Jjyv(40Tg%?k{twv`N>X;ea(f-|wC|C<5nAsN(ox3?^EtA0B=5Ji0X9
zSD=fZ@^rLH^+Ucv8I&%W(V*3>1@N#a-)O)EK5Yq?WR4L-7?c>ovzQ@kWfoM~-Ih;o
zTNw3bB@rVdn8++b<9J!R14P}2S{oSzZS)Btrt`h8o?o%uvt!D6YMG>mK@UD>c3vE~
z$!E?i<bc#mpMxcK3=1>zXx%I^ku3H+b|4nBdo=7?HE|2f%5y*P^*igOKp(LzwL4`x
zWdP|Evn!9;jhMF|LMViZcWY|SFXp~i-S?njVoek_nBM4kQx$ozH_ECWUwVD>(V^1H
zo%7aDhg>(Z;+Su}xmn=gVE_8Hnx70s=H7?*V>Ny>!W9@_s&6zvgKsw@)spSG-T@+)
zi0ZQyVu?hi<e}aG!C&I+1OumV8u8+JvO)oit1rXt%C~y3B(XS_*}XuVu2i#{+FPBX
zBx`N081>>dw9XF5IG9$}y%1`?NNbCsCI+WcT~fr=svX)r5BD}U7kvFmN;1BIU(VPq
zE-}RS3&2cRH3ct8kWk*qx>?4NQE^+Xw5Y6XsH}bS`{zl1OX}NNWjD^vv{SX@S`1Ez
zhuwc8_*hHNbQ~5W>j#AG<6SA{dBlR44^zuD?XyuCN|R#oFZniB8*rJpIdhNG*#U!o
z27Wl{V3*Cri*<co71@_d-yPgbd9@fE3KF<um!|Q>ZR1w4&2;gir!Uax;hOJWt_<(!
zS>8nWWV)ca?NT|O8Bd8xgJeLXlH0nzl=T((PvzVwA-Z%i#pbBe8vl^oopLj3=HRUF
z6S_w9tAtMtmtpv0*YYQ6sJ?L)2KZ(BshKp`e(dGgl+*j`LPo7{{y>U^vO_suu^EaK
z{Hzf#o$2w>(g*nq{E*GZ_hn<bUy^>PTuu=9+?l-X7qUHEVw94mcY!6h<`K*F{EPJZ
z6EA6So+1kc-dr}3#JN{?qr~XUs2+c8Wm$G@m*SIKHdIy=PwcZYDk^Tt+y!U#Z*p-Z
zT%fv>l_6ctr|5#}Idw)br@Q@9qTqD4boE;W%HDSq#bssTv=Jo|+ee4PYt1`r?#!U$
z@Ry01schzWj%u5q<J{Uh1lcdA22O;k^!c`wKs`qvhjAO!sZ1D3Z7+M5<l?BBcpi#a
zPY_P<h<D4g<md?L=6vQud9)Ss@x-f*z|BM(mX@dj0<uV?m~n7I>0=Xr1eqL+!XDRN
zdn^<B;KN?SITCiY7}?VlH#2T7Y*`VTh0AQ^4Ny%oHA-ef=Mx*R5j=5qhOBMOjTWck
zlDSdw=5$C)1<um5$6I_5a844gH0A}rW^j|mWo=?gss?|qiNr+mV#*Wh!ZSF56nsVs
z^xzy(bCmv;`M1}TEJ*F)0SlVzhD4QYW%%iWD$3g0?-&#GQGH;vB>6Q6;8EwLLYC8|
zx2<0qb-E~fpFX$#_)VOWw(Az_J2gF2(dPW7NXW*5(f`BRTgOG&wNaxOU?5@;3IYO(
z($Y!_NO!{^Aw8ssbg3XJh;*04(A|xIlynOSDBaz8u0fyYjqiEScm6o@H$P_XeeZq6
zTI*U{#;?w+K|C#mEy|_NkRh?W-G`IY#<z~cEIbAF-`0$rUZqno-a>cMVum`Om(=X?
zCz5qfLRVYO6ah@)ffzo3aKTflT=AV*=3($NGXr)oiOBaHvz}8V_&XvqbNRixLZi1f
z^!=4UVG6RYHd?1mW^PIrmwkI&(Lz-rJy`8zfgV#{eV2rqO~6;^@;Ba`S3$|c-XCu`
zjxaW0(bXND%+zZSI&Kj{Tot%~{oDcuhOS5JO+`@{Zp*zJ#zUOk+UvQ=j?=Qx>)C~;
z_-#LbEK!OD#b1D|+p*(Q>3^nC%34&Ap^+r5ALOwS9XjT}S!|cXT?g_O6Hhwzt@wN*
zm3J;BQsF(a&UWiEiGveiFmC5Kl2BrQnP}uKcBKv)1+u(jro_UcFo$~bfx>p_*0>O`
zaJ`vPgYr!Napn<*#?3Rn%9k#v39iod(!T%C-GaY18$_AHSI>xee}OLy+lEfgxzQb^
z@YR@8w4(cl(VejsnB>pb5g)wsqleYH59}eZ)jEgEo<W>RQOk?-mbw6wNt}F#tcSg6
zH;_?PN1To3=?=@9J6?qM2<eF=SOim_W@+N{j>G)zv|PMHFr!wf-D(Yl&965to_y{5
zaNQNe{Y3N0!rq=%Q<n%CDFV0d3PT{(C^DxpNr3o6t0Fy7bnlVt$U8H4Z(_cOMDmc|
z$pzop>`p~wp#z_F>;)V7E^0LrWL3UR?K|6~0+WH<kx^H&XREHqhd-Z9OS&FUD&~Wg
zoEml)C)60su1EL7YxAV!GM}bgCJFBfR7Z$JT=kcUeo|8Wu)AJQs`F}ao|Os`lPM$l
zIEmWqbtRu}{YIwfVG_^Gv)#1|xr{OwyF9NDh5b&frfr`E0LSyCZ(105Y!;oNY7{GI
z5R;KCi152yH!Ir>277~p#w$PDUf!6U3*Yk%z0~cfb4N(S)9aIq(wzKL&h2K@84Vgl
z@$-*#ne6t#{#)mo7YEs%Ij-G$)WWLIxyky_j*Ux%vSQhUAPJwPK>wvE?cN>($_{eo
zSD_xycsvY@M&B0cJGb30?rvB2cwtt|Z{p=SGdD0sf29hJY>g$=VIxTxL0)3LW@(2A
ze}?eOFUXL>Uz^NJKt96l;?9#Lr}dm}K^`p@X@xLoL>4H-3)i_G?J^qHcMHHd&EvzF
z=-7y!swHIDS>v*Q@M5}+y29AE=y8B+xK(aa)pgj!A>Im-{Hu+1UPth1znioz3@k5^
zNz6l}lv5hy{3idB8EG}yY7#5H-~AY&u;sM3TxD^4n7PZvhitSSp^V~jf8z;6C9Oln
z%UQb|%dOisP!x0#B+Rl7PC=#dzHYX$u|Cl~NJ-OSacrz*-sn-ybh~SYX2lztMN5Cy
z>=%>boztq>+Ac^ErVOJmG68*WT@4?yN)IS-_nMzO|EuBJ@3Yx{KX8bPI$~v<_BJE%
zr%`QK%IeETQ-k$3^V&>FqVkdA^Ch?hgo<f{?g8w`y0_R39YgirX?#w0kwRT1H&ZTC
zXWo^lm(zo4wab{=VWWAmBbFN9`)0Q~fl37Tc-N`t(``1X`EC>7kmrTJ5ptJtC?DBK
zsTQf+(i7ZCo>A;_$m+@U=+VE9A*Up~IB`4sZsWbXdoL{s;Kl8GTPuovE<v@2J<bWg
zj4nBdK0M^6@1@FsX<=>UX&=7RY7<Zq(<PzHV3$Y3u<YoRhl!5f0jk{eU<)?+26NqF
zU~Fy2aw5hRD{lc&=gF=&kb8G~QC*CsX}qCG4KXF>Z1>~}*)oTzYLP<HkwjEm44-F#
z*rI3yb>e5c1b#Q;M^@qOp}(Gh7{%sGHMzCF#WTPC-E}Rs)}KFn7nCX76VomrGiEW|
zd3h1o1hI*xrs5qG5DPRGMN^gOMHFT-)HN8jMu3%BjE^g^63H%3x8(fs*{(CLZ^4tt
zQey^lXe$5a;bF+S1bvE{izEJ`NU^2voGIF?uh@S5fmgYmB{R)8LBzeN{J6FlDvQ^s
zxZz>L&fr*!Hed1-SMAhm*D}X!UR`l{V)^AV#sh=zk^FD-DKKuU$JGvex!!-qsx8Mb
zOlX$PYa@IT&#K)_#QG~{Zz}t*1Sy2yA^&`}+q@kn{h!lFOQAz6G+1bMCnGpcr0S{7
z-0RD>C|A_}jNBbZ#gB>k6am9jJ-ybUstHxK9@g>oTsEfllyn(0^JR+4EKvmt>NLXg
zJ!b2YW;aQ?JjWZhQN?BZbbnVizst@GjP&aM;mQZkK87v^3?v%PUH|%M_u|C$`57uG
zV?O)6ukDsM>++<-6k4guCuWK}S5c5dO<q<8<Kd_19yJ)|!K*E|dlnsZhmh_@>lkEJ
z|B>lD=m}`7Mb64=l|O7++Rd>T6-PdW!zhYQ-ct6h3Q62*k(X)h9z1xCS+?WT7&H2!
zGcG6B@kMTd&GYO4EM#1oc$u&Q(Zpde9RBIW(EdykZMP7!mDgt!$n1IbzhS6hJ8686
z(vXyt6cFSPCk#wIJdds~tEHn%>x7FTHCi9B+GDqd_l~);eA5dF=pqQfs$0Y$KY0IN
zRn?QCyw^i*rqBqc?UI-rfs>O@>;_|n!J|47OZ7S-)|5Z520wKJ7ZQNA5^DI-yW@iN
z!L2$`&r-bp2#y>fPrUrXLWlh=H}#E~AB-WFrv_raT_)=J@M&UJwZFko4EFdy%#zEo
z^BK*6%jWtVBeAvGsd+kePjUt%srSc61M}5!oewudQgM%|itN{WYLT4GAxhGQi#@@f
zet6bHPxt9-2U|=LIWC8(1_p_)#~F+3F3$sDBKT(9(38^wM$gBmOFJ1mZD-Ch4c*Io
zHeXM3K}dq&zuzG#sg-Kf`}elzNEVbMyOX#+1QBy&N(+H+p^k+;VkShZP&CbKgj+o*
zcrjpviEYwZCtb+vl8q(!L?jq%YI>pgnK0`p59WBLpv1}B$*NiktVi<Ou;2=N6X8Si
zY)4I!D(frEpy7U45ucI*R*3iPe77BURveJ}R1quPu>?Nc4tQc#FRov|J`!cBF_Zl6
zlmCoa02SL;tdc<=-{E^6Q(M*5M2yx__cD^#lbY0vU+7om8+_Xr<Q`j_JofzBjwi5l
z^>>T^%nA#?%M;_3>4!GMGcr$c(<{k0&6DNlOSzD)Q4|VhHDVF@V=KRgXU#^+3Gxil
z?{02;l%p}E-JfK%w5)y1)r_W)5zYsyxDnZnB`3Q@Sj@RiYdtN^;i5$;3@yD%hPZQ^
z_l8dOmoNAzar`LOCZ_vFz0gg5Cx8trzok+iM=6p>$|4iRDNCo*^{P3DR)|*g-4b-m
z0CefJQ>LhP3Ol$jPqE7f*_cprW+oaR>^wRwxGn)Z$HOdh5?uz;WY{eZo-$T*T9D%W
z(+y5TH`tMF>{_5x#!Hf5Mc?cctV1%~5}t;yk{Q`J7s<CA;BS*8wWS=~tD7q+zq^JS
zP?ti+(yKpJL<VRMjG4-3uxIQ{$5fv>)y%^^)e^zMEOME}5<^Ez$9=b*FP4r$f|ePV
z^r^_WA^t@|hA*Tzjs4-DBCsyaG=kYHrdOV0Wa22J)&5pVy1q-sv<D8$eH}v;5e4l2
ztg3m9Jz1NuFrr@-j=%0oR65S+b|<nqJBNHb%4NAbjE;zji3Fm1bgG>>y2lzS;nL3M
zpY?g2vB7x7R6BKvCIQBi2d?q7V`&yUKX1Ni+rNT>vqnIxm;5`oox`R0PQrf^huDRX
zY`KBV3@l7>!v_f|sfpyDLKR6XdmES`vZr^Ftg4u2ML}Y1<4vTL6r@qO&;Y3yU7yhl
z@N2#!Fm!cl1wYgL!EPL87D-y=bR$Z$;9ozr@9hVS5Hd>Vw!f(+%MCpm{D6Y0rxtJ$
zb9Da_q<o7du_!DI`7|;_RV(13_$iE6mpZK|PLZ<)4)UpYS_;f*wTZ2AE;1^2SEt(-
zQj{GUe7a?@Am%>Zwwo=~qv^@vTpB<_Z&*KKERKzgc~5b85Ui9U|EWMBKe+(vQrP!F
zI!Gblo&(~AH}$NI{39vUOr%zRsB<1NgX^6iM;2z#-hNfYTz{(4hmoa`ipL7r3!Z{H
zi-RdTZY`4DzU2;V3CQm7a<q3%-_d|4r)zjPLR8H0JrynIbL|ZFO>%cN#{X*NdG`js
z5OZAaWV%B_BjI*@L@Zu?PbMy*+Ht#v+V1#>vFkR8<MJR|%wY;M3%ApHCE$??tY0C#
zi4SJD+_#%<V?z4=$fw>Mpy%aXt19V>9lZo+K@PRFB?Z;j-Y)%6N%tZ&YhC;4iSdJG
zcUj2E-}jmPs$qiSd9=du^~M%2^X$$*t**3cD3?qRs>((u<%U>id8<&bd6*;$UsrcK
zG-CSaBP4yD99Ze<HHySQ&lu)PwvnI}XIl}iQz$d_RbOF8?R0&8t@?ko0k!!QQXT`&
z`_T2)Q?MrKd!5D1xHjLt;p1sE()i~kAS#_s3(?W9)2T5pZ7s&rg$_h~hVH9zp{FTW
zsm$f@iq!CciN$gqYdk>^uYtTm)l-p%9&FWt41QI86BF9m9*w@!%g(D~IXWijHy|N$
zD~f9<r-5gx1=+T272!XL6xzeer9j%SMD1OvNhkcThU+15XsopKWz35c0V61p3-Fe!
z8D;~9t?-QpnekXT+JF6GdZ+iOv&^>k`;a_JemVAQw<mytPLK{-Bl_((X@pJrNGwlc
z{Tm1j!eiaEBJ!>uweqh(RYth1*4BRQfpGCBg0$J&f9310OWmIPTN!%zI{{EW9kUrq
zTY09du?VG)q9m+njQi3F9Mh=j6Z9!O4T9+08W|UK4Wtm3+e?_~gDDEptQq<tH^j-j
zGR340U-*zn3@@-2fL-8y$FW)f47!o8w;4uk-6K-2e*5@gpw4`tD_5U~v}G(mE^Ard
zGa@wf4prrTUgyTV;Q2hw|7yv9nreGgIulEX^n;^?j$d0_G*3^fncmaLez$X1Ek?cy
z3!Ce5C}*e_U97;LcjYy%(pSw~Jv{D6iD`o$#vSLMfKP31F{--PBKl{qoTs{Wh3G?*
zh3=V)1D!sd%h^exD*>f!3&Vor4=2-<uB7QJ&xJT7G2OwIsp}ru==S8WAT?n5vNkCp
zk%dCTrI<qnCKPGMV|7hXoGSRG%|9UM3?%4czKRbxEd9}pTtYsP1TENDi4x)MU!#<y
z@AgEe(SrGY+|Hq;VfD^=@t|*db~~R_w9H?u-6W2<rub~>$5mxz`&l8Ua;-i3?2+|}
zChKwGIqe>(QG}*jC7i!Hg5|}UD0EKmaOQ<q0pAjLo9%gb#h~K9y0_i?hG%MPerP<6
z<fBiLBEExVU8vX8(>$veNTc-fV8=ygvR!<!=wm>D8{kG$?iUWJf$DusN^aOr`psB6
zX6dVz1P<;foy#NC@6<98k1p(uz2~@D*)kp)Mu)BksHHBb<j(dTka*P@PxwesEqZQU
z8;|=N!V2&5gdTL2OI}rNGKhzs>yDl`&0<Zi;5%Ns@-Z}i6wMfO*VU;wG2b`%L-NcF
ziRmhjBSCKCP*ILazqCHbVjz!^?1IF{2l~jm&`=F1BJ{V<J8#j2^Q>jtELx~dET~!7
zgn{yXSkJypB}+%Minn#tcur+5T}@CCxlN)};p!Bxn1ksF5#qBbBxO|p`rUgmB{qu~
zjv0sNDJhGZNWDe?nLuPi&(9ragzzhcg5#l2L&LtB>O|ts)}j@P-e~Tsz>eJ4Q;vOK
zidftSly*Z#9{&xixi1UWQHQ@MEq=JJaUFvUdymvpOFHGC|24Xa?f5DZ2EnLzZ@Qjs
zLw5t&qu#RHbgRnF-&8ZOfw{fh3>#(5?XsFaRL+Z^F<K>N${)Cgg0^<-OMXZazDaMY
zo{4&d>0o{$;F!=ltCj--Io)=+{nBbFl&L}qS+shKHMx7LH4nVhB%9^k2?9qV6crGn
z%};vf`;!I&NK)d-T#WdP72Bbkga<OXz(+I$J;F|WM_uLD^9sSrdPSpjkQPTPw@msZ
zS64#wj5@!=_Evacp^1&G0f#Xamb{*i1}Jg;M9G`kW)br>Z*@zpO~h!|ph74QPjo?1
z-8mZ;8k%j~6Q8bVhCSaWrSFADqsR7KyCIC_-1fZTaj#09(f9IC!Ia>@X$>e>g<}y|
z{dURlN!dQnju$eju6=jhe4RF28LD6!`GlXvmd-}QNzx>u#4&FchdBIrzH2J@T&eM)
zxcog2t1^nbCG%U=2G*OuF)1f98tKkJ$US*>vp3w;=rYkd;=|qhXy6s`7b>oNf{Jei
z%n=eQ)=;tWP}OlK*|$;^?0=l=cm45dkDhp{K)f|QIbV|2V<{1+3nI6N4;CRf--Pn~
z<@4+zbSApS5tgPbg+@Uclu+W2jAaobu-N-gdP=OIsW>Q_C1O8dU}*Ew+vdM(KEj=z
z!pKw;h{A_62(n?ltJHwC1!*LP`4`ruD(wp^=gFg((I$7NTVL)44HR2iD<L=)Y<_8T
z((mlj(`uAHTviFPQCAGXJ$@+@ag{;!0jE|au5t-*F|S|KCM@0$SN`a^rd`yf9~u^R
znPhMh`dIyc+pM=+D<6l_2f5DToQ+YrUt}xK{;NUdu_j;y4~fsm8ti7BL1V0+FTkN@
zrHOa+{yZ9=HGac>Q095d!Ro<N{yn1r<pfed3^i`aCprOG3LusI?x94%>gIem824I1
z$mi!zJKCX?P4^9a>B&Z0c5gc1o*W*Yl@Nfv3Qxl^B*e;IPv_`HB!>VHYww#XH_;Nt
z!%YErSm;J@-R>F6(MoS`ul2Q!mk}(6#a>?P!SoDWl~0iR$RH>^Z}F6VsHdat?a7iX
z%r)k)<D|cHFXqFCfdboQ3gBmQavY7u-+LwLvDO6UD*@C~F*4$1yAUdZ<GHJQH2kyZ
zT`w!mBA=96xG&c1c%I(zQLizFfaeq`xjUKAt!zV_(8byXnq%{3^loZL1^qjU(t>-t
zhweAe^}z2{N3zq3x^IXWkA+vg%QMHiiP3W(z7#tzkS5*q2kdDt?)NHPa~Gz~<aJ*O
zAUL<6cE(`;LD{#ep*6;e*FXQ0PsCV1bDquX1mwDcUVL^+5|1vKuB3{9(BptvE2@r6
z1#Fl4$JcKr;-@gq`R(DKI}^*~l~3UwlmAe=o#?^Py8)%6;oy@OD?$73FE*6yakAPi
z6i}8P+7zc^b9OhrT^;52E|;9!&D0`K#1NV`*N`nRXJcVuahZFiP;BRy=~lM<XqJ+p
z4y7r-|E>G||M;?_eIDDTA7YY{PCF~V#v6RVrZgI^*w|WB-<1(C+4+blsR+ouz*l*C
z4Z6xN2N(jazf;CpIE3CEqlAocS}0p`t}4p1uTMTBY=sx2az^wgBAE^waGr;AzFhl;
zY%W*Xjl#KRB97WhA)NDaz<YNp)-S^M3OWLoJMSl}UL<FIVfiJRO}h{`FYTa=WIGye
z2Laz*kO6mQQZg~Eg4Hhg%B{t?_uWP#_-!lB_uXYr%5V&+6%CYKBo_IB5mn3wBd+%@
zp_TZYJ25Nx-LE}X-5CpHDrB{K;+-ymmId4zU-6iHF(orl*|pvO?npsN2?pxmKON%h
z`+R+>6|m3g_LyeZYX~<qF2hy39eYJU>f~uzt8IhEEQ#D#D8pYeu4$t_Z47N>bV~WP
zj9t(&4jW9;OlGviKz~KtzkLPQ3J-YyCTNJfe95}V0|F(Zb89=Ry69y+q0$U@c<}_1
z#n3PH71d6rJh!yl6_=+m8hiu?O2mvdtvWO2_L{O}g0^|{cqz_vLJLHoN>D_g_cvC|
zB43Hq#PS)gEQj<e@T$iQDS>_|@qAs~w<|RFj?I_tePUv?o<DzXWCYi8Z9t=*sZqAI
z@=NfqZ+Ft{aPi(U&-aPvAz55D$`aY<<&`+|(@Hqj9>R!I>5YRYXWTnp@s_!K)X1Ar
zXl%1Ryl8JDdoP6~CV!e*zPXVae$0U?MMfyw4ZXscmwa>WI3}M4aJQR6INx?8Xt@lD
zzIztJk&(EkLwSWr`KWGaH5!mP5Qv{Wcdq*~_)=1VhaZ^S9|d#}p}W5rLf|1jUwAtO
zeDBJvj_-AxD*}^}rG!n<d7%!4nYG$g*%dm8vJyx&<JW9LW@95su-<%eP6VE3Y=k<k
z3Xgvlea`+AU(rguYU6a#X<5bky=z{|DH1|VxDe{N%fwSQvVXO0;C|`!d4#g*6#>Df
zDhtx(0VrT$Wxzfa?#j6V)@oqFINe6_uT_E#_lgQH{2c84B(LauM7Q15o~?zAhR|)b
z1~>?}H{|9(WUY#K{F?rZQ{EZj8H^%GCNcIN4BS2qnlOXdKflku@Oa~!U&r#h3iTiP
zl@@H%&TY}vChZ;zhw1@};?~Jjy@uGroR?5GU+c+xv{2jRXi|ok5pJls4jP`DH|<w`
z@`F_|tf1LwWz_L6EQ}ZykHgx#fTm;3IK`b32(9C-cyXue+5P=$hlt*FiysZPZQNDB
z6J1-aG97y+lPbuT!rQjQf1aF`CP?}Mh6h95;RMU{k6?#s@k5h4SwEx>hgwIE70N@O
zNQ$J&NOb0E?l@8<hl(!?qBpCPCi;!txdUgU!<^ya!|x3ZhW(iu$f8iJpH>aoMQY~&
zaCyamULUgdb5)o^+qZrN%vU-3?K*cdXUi?WYHM?GtKYvIBl_o6#O@Un-UN+Sy!>n+
zhPIv!Y$3)q!y(%u$!!Z}`{Q~qoxVTs`fXX3pj+Ao?^)nFzf9M`O)Xil46rgYGcz3>
z9Y23+!@}@jyy9`3DSBLWeovz#%gu#yLn3z6>);;L3o+Njcseo2S+SsC&=|?*O!dlh
zJ*9p`OMsF`FG}V2^YAlvt}1cf#kdg`zQ|YRVmjJ?S#f~NHO*P!O`T-yWqGb1q5}JD
zc@bl+1w4UaMF+As5Fmc8k3n3@H<1t({p|b{ea08id+0pI`AZ3-rw=J+Z27A$?|FAH
zzI9<-i@5@aN?LCYeW=bmzu0XYJ!hl2sp@L^s|K6FYF5iZ>Z+$#5L#JHDTiJVBfcS5
zo5N67Cdbs-b*1gYdB*n_1fo!V$x_CTcGB1z=>!B*{$3Kecmx0hi;?m$2xPD@;0*}2
zo4OdUbQ}KHk_^Tey@K;Y?%p9w6Lk&a620NR*fzz0wPz*%t!;}#1xcJa>H;x(N0dh1
z`?6R8x8%RROh{h73$g@!AM%_nph6I)Ay_}ec>MI%A;AnGe--wgb%%w!3-yMh-?2Le
z#!oAOX7o{puew4ci&8lKDz?{@Z}*a8bezmAsrUq5SPyf-a?n<!(3~7E)_IncuKg>&
z!vWY7ONom+z<n<8ePp~&@KgXfL{*)_a6Oi)!rT+;SbpO|vOyfHb@5Phf{z>nV<)l$
zy}&15hNX0}j4VTZ92Or`2G{Z2`eO*YUrQb@hV;|(rlQpQBk|O4r#Np#)<F)t_U_cP
z#6R!#_oP}ff5hKETN(Yc{eGDq1N}HsLgX0MGsJOMRr2hMq>lq%0`P9GS<imc!IqqR
zySLW*C(mxtRN(#^HFPU#k^8$gJNd^BzP~<Tp%+8oJWgg8^{Fq7&kM=+4j<5LS}?0g
zo)TwMMEE6CCO3$_iyhOx-J=Pi;9%c$CHT?bnx&I}^B9+z8#Xoi-^5m*Y~9)REwTfG
z34Qr?THEeJVn)whz7#C9Bx=MyT)wKO?BSjB1&XuI=Z|@b%k@9~ozYMJTZh|*4C~{Q
zUzO}Go^%$2@^HXKHK|h(ufwG>^dJEFC7(i!N4~1FLioL)zx}qks%mK244LcMN*8BD
zx<w1G-IZ#r<0+|h)l~0$(xx$>{V{CsgKpp^d-~8|fkJ!qCPAA1>%A<mqyM=sUvTSx
z3$t4s@Wn4+V2!rvC{xY41Qyv-GIsCn_iJ5Yab@P9+ebMj$^9@6B3_Hc^kXqJN6x<I
z$F3ttkoW1ylF1ZC3tr?y==bFY{Q|+p*k(?Tm~i?ogMOs>(3E&BgJPpN-M5aRBA-I!
zdNsS@M61c_)}n~$!fYOchdeCKXd{+ISiEVCPu8pQ-}?XqW8*P*-kFn?eiob}D~|DC
z$A%z}`2t@?Z1JdV?bm!Qk54!9eW&T(Q@pLhn@`AcwKkkPZ1*<#`dVzUJBhwPD?M}*
zG-M_8>V3^IqyE-Wv?^`BzL$uYu8DZhiJdX;O|4W7tOTl8zS0SaC=?HR0a}@==hYlk
z2K`;AaiGaYpn=G7AxK^?y&;R<5A$aKuphp%aQ!}I24NRbXEEF?44G)H(ifk5E?bRI
zPaQBT9)l)GqC&))l;*Oe@!N~+J(U0t&>gK!iUG9`!Cet<JvjoL^{alKH<~o+O;<=-
z17=)b2$zhMaNd;){pz$V{%K3M{k5g>PolX|_~N}P@6CeTc)OLsJe@X1!A%)j*n^Ib
z$;<Rww^u-L)78@xI0$!-gsX~ka@p#iQ7v2$$zgTeS(|Jsx2HEEfxEqEgI(JG=U0B7
z{p+BAOL+<Jgtc`mM)Q#X|FVGDSN9n9xfta;&R+SkOdX<Mv(7;S$zpOm(G;aay$kf7
zE<UGqZV>+Ay37oK383fG(N%Z@tvGmuvy7JS-hOMpyXIn}()$kAhtK|60kqA71y!hT
zKww?Gtl2sTQxV!Np(FUTgLsUZV7NY)>sRhfOiVDvi}cq8%0gA7H`RH3Z0ulf6FFd)
z;QYZaAwdC+d3b}_fX(JylT-DmE3Wo@vH7r~T0~qvzX$HJX6zfO9GyO;)IfC*_?ZSN
z@GgY(nNKv5=G)LCdMW^m^ct-orYc-mtO)gFw}_@U;YUC$)LozU$<0fvWfub6sL-T;
zV&&In7w6zdU#FGZI&G1^7RGOz^reeRG|k<wz<m~>f#w^3e?&W9LeX$?;wKf+nJ?U6
zAC0Siwg{>QSd|#ZU-?q<(i1ezr-eI}tIsDtJ~j2|YlQ0yY=RaUYqVGk$9!N+=b2x`
z7(iOIDh%ogqWtV_TZ<8*0jfiVCGy#_<Y{?^72qh|r1GvYtovYX@(`NaWK86N7vsgd
zccc6Z9-|i!QD6a5t%i}((#rwf0o!+hCAyf5D7dBWJ3d|XQK<|7#<G5s57&f}6VugF
zU>#9rLTt#OfxH_ZK#$?8G=4}5&7>Jm9LO&Lk;?h>>DIt)^$A!U#el-5<*IX{>b`vg
zrM*EKN@9U@YCZLdXM2<SkB*w{N$5p(U^~z%r6$uXj>ps2YJ%F*Pf5Xnti~e=t&;ft
zNigF4E7HC=$(2%hhs_bn3LT^79-)if!fpxpXVj&Wes8rrnV7;JyUjWLuN3C!-z+^|
z-)pZ2@<+U!?8XXxFYGE~U(LKoP>s@QTA^iw)CyD06hapZP1TlnR?QSgn@yP1Q$WxO
zu-5aJ3(u!oqB$&dl4NXkR;{L;?65(WqzMR1Ys9;OA;b2#s{Ksv-kgGr)_Ku=aHy>O
z?g+amh&E(%<7K=}T)b`e#E+lVQTDBHJ5F{cAQeAKdzJc_13dWgX_RPcnO&)oX_9^r
zCwU$4s56@O=ru}<LA7A~h_2;uuGbg10lBL<9-hkSq4!OGG&S+xZ94ui4_dh=>@^^j
zTm3N&N=rF8QixqOBgT9+4x6d6&_ymWYE??yyGP{_!!u8x5fFF4>z?6<R;vB}_{RO8
zXZJVNY|5e4vW1N2@A5pgIDI1M>336$eS^ccG%<0TfN8Y+gMP?Y7*=Vgr~)ym1}@>1
zl~JJ=Ey48ja^S{&%-~=G>Kq|pehKJqL`6DzV8-xx8PMv(9@SzNCFQI1uFHBlz-Xd2
z2Wyfd9l?&HZ`s%1lX6D?s?y-awS${#plrGb;b_ti!l0eL5`uSmZ?lK)HU|JdeVj7U
zPhF30wzyf0)=#xX1<Z+vEc+@ONQH%mn}2^GNOTXbPpqk@!~r5ZfF|U=+(c8reI#(v
zIyyF!jn9PrNO=$yy(<Zliy}J>WUo!xEQa^gOhr<=_I<a9i2t=X{}9-K!j*gQxtW=1
zD9Ia3j26pAL-_Z(T<eS%RZvhcb~@Zc>QJwb3AwVr3Zfm=&~CV<OOI&m4>?$Ea8cBQ
z=vLu;xW`&12iK74qI%n6wx5}OBfVJcy#G{baPtlKsgyp0R%1D~ISHZ(=iQz1=Ge8y
zj#v#n`fNuRak4DYN;}IJuvZt}NYo4t(tz}U(X5}rI^*3XKaQY#G7O&Y-dRjt9a;WS
zLa7%7wn69Q<v>DfH?cUR8axHUzshvXN(Qq*)`TJe+yZ%w<x;mO6E=0`A6krv=8&X7
zhw=Tvi3sgvf4stzLU$49T&5@ug_m&MB+ilLxXK70J|m+nsZ^e`ZZX1AtD&bSF)<Cl
zww5EW9?YhwgP8{or9Xg9&B1ZLubu9Cla;o7!^c@EA-LAzuA}49kFt%}g*ic7pGT?r
zNqbFQ?@U+WnLp5LmE!$eu8Jgx<gmC?_BO@zgbalW=Z2Svko|j-w{J`G_5-i&uBibS
ziW2QB1&-|u*2{^lMU!@8&GMO;HqitJhf=w#8K<>uZMW6Z^`+>4l-q~i<wC>q?2Row
z=V22vD7S>y!NqHIn%3WxAiUI{h_L=KygZ;8)8NPp!l53TtXYuqVblodm%W63XuCq4
zj_vMpRz7vhfn2f_ebCmz&6l=rvSAD4PH@dhbj5IvE-7())v<?X&;X_tlpDGhMP^p0
zqPG{-no_+<hrPyZY>tO%gTNley7yfOITUXWpb%qczpI*rk|3PkeQ@N&pZGoG#xqjR
z{OB>z6SPMQHG78okO~zV$%Sk(>pbznYeJ;mHI!b5ly-Bg`J>mmj)X>KWH@uV>v0H#
zv8l#qRL+qJ>6jz?tK&movGlEbD2U1J_cqL<dF~oD=ZWxrgDSh`oc2EyFsxC3S`yhu
z(4gMH2f2!wa!l4{JKLTXVr=)I-ppP}FdkWWyv;9jaZmXsoxy&7=L2LN!p#W8VypA~
zTeIE42(Y<%qxzNG#`OC9aINlTuWUy<msKJ1oHZaG`uda==RlA}0UWC$iYG}{IqzBR
z@_k<5lDmF_Tq8KxUeUk#3K@^5p3jYRtt#W^E5^b53GzyV-tziBH%@3Cjv_z2EO}HU
z9mD3RtKdN1C9pPnY+=~)Jg$H8TTrP3+Y`lL-|im9b)a(7CqW>vVFPJ=!vQLW+59gK
z_pV*9t;0fD=ied^5Y7dCRrJ$zL_y?Ek1!N==_Y95!tc**q3*wmsvw2gz*lnBU7myn
z7Nyq-h{q=gWV11~4t1rX7%f(0#GUSI)jx)si?8B^`<s!sgYO4;%~(YdoyT6wXc-->
zjB>KJAU#^hB{VVK;0Nw9awz>xyPBqf5?Z1A41Ksb!=ge^0ZzA9m92cbiwOw*{fzqV
zcW9++J>%0AeUopDg0~)KQ&zwQhF9rp(sCL&JUPVif%a-)&<I!f(V62$$B_5<wUeUR
zmsg)Q9DWq@Zj_o1`0KFA0aZAl9K~S)TwX|6*eszIo<9$hT;J*WsA5|gT?CT?WnefU
z%w|`{T#twD(V|bso)TK8`}-sRf9?v=<J_XAEX~nD!mGn39$7*Pg;$+gh=srV>^HCf
zj4)*6eX6Jh<zT>Q{T_by?+Uc$KPu2)H2Hz~CZ`6vcltmq9L(!-YoOHn3=RF$;xEwB
ztQA982?%KaKG>HS2Z=bl5%?B*x)%yx8>ZdvaYgeTFIB(Jz0(K$krFb5JonvYUMD+l
zG?RL8urAYO49cRopFn`2_;Y|GfQ<UE4k#QtFNq46#=z<7x23Ltdrr73+Wcx4U^XEq
zx98>Fq|Ne(C(XvfKq*{a7EuYkO1KNQMDRylH!$MP_)es-f7P>#Kp8a&$%mJQRvs3q
zPvU<TbJ~iHU7nE~?V1OZ_77@YB7N)y3)!6L!-coQElsqZtflqmek=8BGv&(-V5!@F
zw2Wuva?|(~Xktiu92KWy$G$YKthA<22Hdk1ABVFKzXp-{lv)X~_ki8TCx2t*SI@cY
z*T~6D5>~|mZc&4d@hDA2P<7%*iS2AHt%^JuMdRj5s31Sc)#;oYNkBLu{^F*NWD7&#
zPFs}ui3T59LaXUEv1+(MPCVpf8v)C$%1!glZA4gPd1XtJu7Zg9t{HZA5_ccy9W)Z{
zXXP;@sy$U~AQj0wEXztAid$QgB#JwZkRJ|x=4TtQxuRYS>$|C0;ea_{?TsdL8S}}0
zF;<yEG4CdVgm|4LZ+ptfb8Y`hVd9D0<Ya?A7U%ps+lZpG&07%9-J@Rp1xcqNJaK9_
z^c1H0*M}v;7rdmzq=Wn0F3q-V9sely7;_oLxeg1L>WZ**JtXhp^5(yFqr`N;Cw<Zb
zrz#ILt6kW@`NFB9Tl%TJ4eFY)HwzB@*j_(CZU^g=r(Hb*{BGi>Y|(09N6SIXmx)IQ
z{b}LOOlQS?bI{cg7>1RTxh^z}j8r-Y^0;+$F}H(kDJt@ocrYEJ^yO++C5>=33?xNA
zTGy&nKy#_MB;rzD;bCFCjs#K`hHbYbExhpaNSPCwp|e3+8?+M1$33}v5oFDKSyh+U
zFb7&yK5$yol$BnN4+nA!7`fPQUFDyF`2+2SF1oV$mRlH((B6)|>q*GS4f8B>;Lqqd
zc-xE6XA(l#Gw34Wa-`3TCC_R<Dy327$OKTJC!mPM(96uO{cq9iE!jta9wDoTZqfu^
zdq4xjS}&qUi=B}lrXjwsFJ4!y;Wa<_wx2XMsZ`)rL}{S!za(NmZ3;s#uE%@WI)gG(
zxh2&FX&looY6m9Kd9tX)&n*e4%Ugn9(Y^nO!KU*Iwm7EuXDIhKkhEqoek{NNhU4Fp
zoN<NJKTYX5Qbq{3eqs;EpE+kUq0+{L?!AS;ARvT(B>R^wUd+SQb4Xvl=a&7MyWGW2
zyJvwLrCoW?ZU3S(nUt5ijlt^<+`AVl4N9rmDR%!c=+tyAVDz9G5db}qBLuwM`O`po
zSzB5rJ`*+R3QfU8vcWE`cuD<=p4U{BBL^7NEX}%)w+7rM)gHlI5p_kEV#L)hn@o*;
zbtERp^goeAteQybqg&qE2X@W3^sl=(VNPKF351`|jfIi?#*OkM-^#;A-9ierjZ5@1
zw2a`%7h;dfZiG|dg{VjoRu+c_k)uh!xK~^2buBS1)Vk~|cZ58gG)i;7*POG75`n>>
zG2c*_^nq)+-uLup$$0g$+K<=A`uehg{KC&~=zEYWGejD3Gb$<%FKqb(s56l(P|mSq
z4IDnA&UM^=Q~R!;&)MOP5QyJVE^clre1HI@eQ^G8l}hOT5!^tm@z#D>^I<`uPTdni
z!fE|xmmgKGY|9dXeXJBZ^IMCw9oqMS^}rB&!mns`=5#Q+Q>ZApub@yR51}_Z2vjw0
zL9N+uxokg?Jk0K^)olZHT|(Mzw%V(S31;qs@A?$D^2dxBMJN9!o^+ch=?`i{kR~hs
zCAot<qp`%52EEHZU)yr>I(!;`jJg}$Zt){nMd_TDc*{3mTo>#$=9KB6ve_eV!pX2I
zTsCc>0M`mk1x{A%c8~o3MB}>n{^}90L67)=W<!jYS>8Wj*}bm*VF@OlX*I`iPGVaK
z$IiXGyn+3}zQ0WQ0ILt$;|QahI!+*Zka45S;WUhFdAhxpbqpGLx3Zj9tv+@CZ|(QV
zF5qcg`3v>HQbE@Qv91WefP=Zs4Ckwz6$U#9R(;}*hVp0bhs9OgxRv%>0-EYx14p0>
za$0AFCo8fL&*nb9XSui2$}Q$cJ{p+8Q26BsALZtr=pQcf|1)eEU-JsKA7tC3H88X1
zYilScAM&pxkcxL~EiPcB*zGmZl!_QQTJ|E8!(2Ydcmv?;_19Q|gWHTf{y?hMJ$oEV
z4UdVY^L~GfJEs16HV=Sq;n|+Rvjy&~tYIBPp|eYcbN@R<ebb_}s;T&kTxB$Qan<ac
z97#+U&lVc5K1cM#_))R|2Y|3~q?5X@9t6P7;Qzac@A=&OS2=}46Z3XymN~qn`Psx$
zTl|&{$#}m>jZ4F<$h+2k>l#nH{?>`86_z!%bgX15^*e%jxvh40yFDYPIn2>@sFnAT
z(-2lrcK?eL$^y7R#nz%X@z=tHj9GTddS1&h_JlmdIL|_RY)+YxOp3;`Pd?(GC;$Eh
z_ha4~$8TMD6#S*TKHZeX1k$zo>#DP=MgHE4b&Ka$6@2#=_Huq^4a!QzWR)&!x$*-Z
zPgg*oSV>zTxv0RX(|={|_J99>08qb<v;Gbd`2OtzmIZOK9n;1_Q+e|Z-`TuIcGVXn
zuF+AQw|;*7@%9$Cknzn&LPn2wZK3(x{QEt~zLET^4DYyovXk+oXo-FfcwP%w63U&X
z^FNZJS{}8NYr!){&gEv@%T7#|`mv8kqzoqmO<A3MUJ)@n{)H|b0ywR$c;8RiX?>wi
zEBYMeLc?w-hn{*@e;o2<*3F_Vp*vL$t!cB&Lo&SU`~G#6_C%fX09o%9MN}Op*)f@f
zeo}OG?YFNCmXa3<O1fGgZ1&CZwJhI%ZJx=$HqRcwfnSmzXd{?*d*{{nDdHSkR|<^2
zv48fluRXtS>1t03KjdwBA!*)WlFFwioR^%7ijmG$%N|QsTbDE)l_e=&q_7(8wEc7t
zEN`95!%V?67BRgga0rDdn)LboN#>sha=@i@Yo_yCU*Xp7I<HPAKr*0L?C^qGs14w5
zS~Q&gX9+iCXcO<;8@=G=ZTSNG{`WT)rT;43v*`KT2aeoE-^4k7T4@S$n55`#-`oE}
z<aQ=P=E6+z{m(<5pBb>-5YiVi7bmoe*|G#Tk<`Bl%s&Ls@1G>=2IS<1?e}bRXioz<
zUmAt%u8TnI+^X{m&~Y9IE3hNhLHDy7(jnze_AdY%oNNwBjOPX(2dWgv`~$glLg^{_
zd+BeFx(uZ%8tUvn2zl<I1wPFp!sY>Wj2aj3E4K^+JXMh>2jduzY)k`+AEMjz&EKI&
z2C;gSvQxZD>n8qvoqh|BNl36AZ<VFGrV<HO*y6ompVD%qwIZS6@#(^HemNSLxC@x`
z@_uZjx=Sb%>wNz2&gV0hTclA(gVQeE?&_zH&{RSJO2eRY$5>oSe+KYqV)lbi!JvSQ
zbKa-g+VYkNyf0t@a&-n}Wkghe&20pTyGFK`wde_`QwIww9XZk!Q{vEqNkBlnE|Cnr
z<&6iFAO{nDQ07vAfr%G*mp}GTiPWuqE9NQh+V<-x6`nq=r^PF8nxF24Xezjm>FA$_
zrp);~A0692Bx;9fqvGfLKZ9A8GJi<`wMVbqC>yN&qsZcJg|y_QDhD>SREC(NE&XW;
z9oPAAE?f8FK&Il~nG)24AB1Mhp8vXm$bz{`u%-z-2iwXN#P{jx`J7pA`B_u*bwU_g
zXNT-yvX#{S=%7DWUqU%;3oHk6fNBTWq(|hWkljMo{aeV|KO2<oLtM3XlwxPEwAf))
zh#T9Py20yiIC*J=S>*3Y>yyni^SbRG5ykPv<nqjzFcabwYxYM`#iaL@rA3ekIb->*
z6p%N{`GJmqb)0M(!TA<Od^s~hn6%!9=@ZEynCM!fC|C?H2lxIc>GmEYW^cJd{2G2&
zEbmD?fy$5SE^m2x^|7jgVWryXi-qqkUzA-Zi13f3%Zj@BGI~+aXab$p)gJu=)$n=f
zgNIZS$5f=Q1<XMiyEKIJ9d^{{-anMcqV{(*FZ(l^L7gEAHLylvONioNs*<ysoMK=@
zKGF@8><{%sL%fL%p&VpjSQ^j!3K&5d#RJxt<DgATUW2A?m!1Leq(?4JTE==u2Xdge
z6%BD-r(&mTaULo6Td?$jN_njN9BR?)s<Bho9T9{LD1f0&5+_WTi>JuIv!*eTWqq_O
zsr~cf){YoaZGp)-J$ySKF|j0@h0y7RAJ(9)!h;blp1R}hDrcRD>gu$VnWIB3J^IGf
zy85LsF59!}hfwwx>3cN;yxMi~<|l7%$3DmUOZWO3VI;V2BRf>NXIf#rxvOD%xyor{
zMpMzOH&qNsnvhM}M0}8~f|(J8W`P)SAwcjJmAjsOD#|COUCw~?YbzRw(?V%5#@Oz5
zb!!|t=iH26CY`LM{U0G(`fF7LEA`<F8|+^pssdonPPy$Ty;Y#p&MLky;h*65igf0A
z9Qj%nMzBKuFz5HpnWse$IH*8-(oARU+N#5e6ao{>)zo}!0(*lQ071{4<FavjV!0Kk
zU3~xqfL?QMPbc(cyT9ITEniOVn(3W)q=|ZDmCdSJ@?rqQ`jgGDn{m9>8P+D6?lyaV
zNTDW(HI5hAb{Kt517&yovvp%MJ*EBn^ln@ncLL5g^!zqxJkv4fqK*pkTdot8$|2ru
z+U>0DQArtRhmY59#_qhqjGwgzDP%7D@gYag4{i~d<=@rdsVn##yEWtI5S4rhIVTs9
zlcB~^*FtAKziRe9Nk$#{7S9?f<jl)fNQX1Nzf3He76iEN_UM^}!*6|i(7Y4T6i{W<
zqGuzNcrA6xR8Lkp>LlYq3;urtDPD#y3hsyjv+hnNb>si!WY3UDvns0f$4uhc3&_zl
zgWo~OsHA)VjLX7ZDYcj1*3|q^bDzWmg}cqKHx}Z9-OF%0b}7u-GIKh-d#M)833_hj
zqk~|WNj(_%`O+F;2pVkJj;1DZk;{32(nf=&#I15pP=j7v`p)FTIFzB@yf`!s_hf3G
z-GwpT`F!hnES-HFM2?VGDQhU&nBpp%xtW<zHJeG|igAAy8Av*BV-DO%xG9oC!o?oX
z*>kx$(%z9Vaj(u(O=3Qe6cA6zRp<*lm31N}VFVBmMFN5neM0fv22N0TEB3v4Nv~Q3
z+N7s2f&()_@?BU9lLes_!F^(erl2#N{uUH4L3Rs=jzYlYW?Eu?oOuk9dZA_o4O~wR
zcQK!~mO2BM+~Q#Z3vw`2bj(90SJ(%bRYK9>UQ=Fn3k>nerg(Yf{rhXl&L4X_5V7=k
zS*`+6Xu6sBAmAF=w-BZ)oGn}A2X_FXjC1h$r}}&0gU5OiZjNJ&c$Pw-`05*MPC1fP
zY6gaI7q~u+DU#&k?hajS5!lwg)$B%3HwP$3@HpPDi(pM5$I0!H`&EMp;QKFrn=@T-
zi8m>C@uzc+n|sl3z-=v%fq{+r1+mh7&GKy4`&1LE?nLMyf%}PM=-nH1N@pM@TUG&v
zxX`#~0j*s|fwtU$W^ZdK3$;B0Hz0V6YfxmsOtnguM<c?hH<cH^1ZJ788qc9k_}SQk
zMzR$P3E(aqop}E(3WbQA!@YTF2ld!D-o?d=Qb?g;*yW}G+k;8W_z6ErC`I}xmtQ#`
zi;Ydd0>JFAw4x}Pcj8>Oh1b2%@O*L}2n9Y~3|8J?Piybrn<hGBq+fM%880kPjcr;m
zC99DUf|_t4TlC*>s-}exSli#F3^L7(EnebX_xw>BfhGIb0<J=rX>)%9NWYO!H@hP=
zZI?&Hl^5Ij+^EeVo>j=*lOWmMXAJ4nYbvx~7Z!J0h(=wf+6ZB5=5g#(53(7ON6IQ7
zEFlth884jXx51T3k%@^8Wo_#G!F^7h-*Lab>mFt*$+fb(3xJ~7yKfd7whO3@qi=-8
zXET2qCGv?xLh5EAvRf7*RY*W7vh}$Lknt}2z|ZWu@wgN)DCJ3~`T(&dE1Uw__fltL
zQ?=C#pFl<(y8|q;9@{R0i__+Fkr#n?5Pc(D^%^T)c3z$i?Oqt$c9Qs15q_8c9o7HX
z(gvGN@&9$RVK%6QmK5d;aXx9GdZBLjP~q>z`WAG!AbTH(?FzVZ;kt!LSfmpbOo1uF
zg$=GHl1z&sYrHVH-z|xhm6Sy#pbm``d-_3zz-67Qgp5)SgvtF?)u7UR3b-2;gZ)k%
zOtdp<M(SB|mG!XEt3IfLnIwj?m{hk~*O1nfMZetzwU-b|0L{8^fuF7mVq@?A*^ER2
z)hZBqTqT|`e#Acb(zF7AsZ#A~qobFSf7Zx2<nI1fLDJ5b*CcGcdhPyCE1lk$@*9XY
z5-AOuDb`V(6k+M;B5Vx$JSZNQ;X)|F`?#ZRR}56}2j6Au-uzDx>BF=`Pb%0HNEKaX
z>gn}d5MWYJ=yu$eC$nl~;8HJFZB^2TftvWZ&!3gJ<Jg-L^xqf{m!@E1PjN6Yr2x_*
z)a}`Vi7lK*$s0YOV}i(u^Ug3c3k$f%wT9Wd)oA_V#pkXt7KIoqG2#cdOOX)AnlniP
z3%=};u%}0SCsJw7@#C^B9rzxoou&+)F#wq4CgxIQG!~-gETq`Z;mjq7mu1Tr-tHcC
zeH6rQyfJDWb5fFNp(RA*Q`)y%3~2IkpNTO28w7cg@5c4^&19trLs|m0o;q2$^lh|?
zB&aX*klt|!km=ri?yw$Ufd_`4P*N1GeIC3Mz<wb$ic7(Q41n1btLYJ*5k>_L{$BD7
zQFhqLsn#<cffWTs7LpdjKX{85ladEXOY+&01Lr_wtyc1aq9U4E|1k`pxPaRuLt%aI
z3)2<=f%f+pGM<*C(=7ga4~8(J5_weUtLCshWg>Un62q;gKl!rV?HzU|2-=!AWF$bN
zd9sElO2SaL*AF66I(VOKlKw-*hHgu(c*4`mnwnY)ychebb)^0BM<2a`+4W`?*Ko;u
z8FovNxDo`wqUAJBG=17A)NL@x4X0Z)G&ZJj=8paSw1BB9INRlQ(23H1y5YAcD+uR#
zVG+t9CB#$mq(TuGu?d4ZSpIEChd1!wK_gd`6tL4rYu;j)JMAvnq{ksXNzFm?kfunT
zbS?9IOL)ExfS0MbF^{R!?0<eiI1H7nyV^bv;xrq)O{0;c6ZfyAfpO#ik`+3BJ*oXL
z|GH$lQ1|co?UcZ|_t>dQ3J4~48{Fo@??W8Y(!8~AEG;$R3_-?&alI!9d+62_^EAq+
zy8gV=tg0jb5f~|Yud=f{9djR$MfK9a@0B;i<U*9ot)@fs1;i0YaMzAFP1D;@@W#=R
z@q$Q0o<^r+<|D76@lNh7e5HZ|bURmR8xb(RFWVM5MPuF1_M+e>@o{7E!tPr&U*$k0
zFVD5l+HjshFVSSYrU{%zZx^#nio6gC`-OU8x=7IRj^I!hE4sTYIFTdHfHHk0Kz7#o
z{T$CfDWr<7<8X}?=C<fmV@4TU+~{y<$gYn#m**G*9tAKe-PGj?rW9Mi3S_D>Sq|p&
zgYN>+^!G;!&EiFTC{UXNO3t9C0ZZwl7*_#C&5amV>dkBQpagO`<^c<a>9b1PODPw!
z<x!qsCV_)9{17NRVCz&V;QE)v+5D4fU3|d0m%329OT*aT3*1;2Mk<D6NlZ-AT#s=k
zd;8ME;>61=lhfw2*QcGq<_V04_GXi2B|<*QREeahWG)!0`+p{_yQqWR!<#mm6>}IX
zI1e^f8*7LkNisvDE<?@pdJhYM&jTWRW8>xi=<(L!;kF;Ts*0Fy^sA-g9g!I<yM`2k
zcvS7i6~kK*v4?X(O(9oL?qcTC-Rc4l9Y#Tqm$9N?i-ar)%r}(pGG;eJC=j3>d}E^_
zLttF`yX^kX^dEYO^$#B44=`VvG=if<Ba~ky?FS3W+|nWmwO=8Cu|*cT`kSDRAmJ*+
zRr2j)RLSf?k6`!WDTq)H-c8PYI-r%RXw2X#mmX>@+mQ;+Cb>liZv=9j!E%Km!^q66
zj(FM$e3-k+NxFxfm7%cKV*?mH!o`O<f-Mcz<)o!hKo15lx=TM&kc!kyOl1kyU1USB
zLi$4R7Is=qOT-iKVai`4KbdX0zo!S>`d)WIK=t>%63CLYi_4cE()-eiSd0zqPZ_<?
z4t26JC!wP)&-uLfQ#7jjs^*^>4g0uXHH&WQZN+6Cj40RH0#$NB@ZcaIm}1z3`LF?e
z&p0S|V1lu(uFf8Y>p&Xp3UiU^*GVee5CLpL-U=(rRX(C_khJg)*4wp7?RQpoU~D=0
z5DHyhX9tSAi?gplQj@qeHdfAB0Nbd`oK~EFR>{G3*#nA=7|;|$(rmIE--G#4hr_-6
zm(&aeVDv^obU{qe(|ee*q6&hmzGg{o%v>bbG$jG5yN2)B-F%QW!0Z|LhvgHD<<9yn
z_GQE%s~=f;D9pk@7c!%cfP$h>e)+?PU)*sv+z1zAZnYh-z5oWOXW9SmI0&G88R`^=
znm^u@hLTzFD`kEkXskf`O<s5+`Q$kfd^$k+z>4@!9PG;ntWYz&EdG|jEUlPA@almM
znC{FTsOp5hQ^9Xm1*AF@${zpPaxGiWY?J`W_&4+=(&*KIFi*GV1PuHX78VS&BH$dP
z!^HZce)zv~+3Nw`mdyWzSYKVoc`%ghieS3C7+y!rA+PWOp3sM^c^L;A&HM<S2=z`z
zT>cX*d>(hofLJ9xbY^Vq<2?FLYh(n_>GGey0{s)*AIzUD0eZ{_6f`G-;gjz4G0ww3
zIDDSw|L^~T>CDc#Ka$%V>X`D=ZZ$=Dc9C0;hQM=7eQ0pHegC~s{ZFtr0ZEk3EjZQJ
zMoKr=5BICyTgGn!yG=-1srFGY83i3bl7bZ?n2y|@fiYH{VJup(Dac*^<|K`tMb=%q
z!gm2(8VQ{DezH4(e*>>Fs?LfhCQr**>Eov=3d*7nLS(~Wm64IYwztnn=*6o+#>;Jv
z9;b1#uTtd%T@6hQ^_uAdC~{^fmxlT^>E8U1j7nEggsjQxPr^0zL1+SoLQ^)toTV;K
zMtYFV8!jmW{(d3hDa@^d(h-5yV;UGJ?R9_j*=B)Z<mn<wx-PY?5-Zq-Oz_+9$t>ZS
z7@$0c{h=U|Gl6>fidQj=Gb>IH7M!8>Skee^YL0oBqd|99tCAbducvmvjB$=42l!%%
zjqZYFqL<KYM9NLPn72R(Vq98XxmaVGD6oGeI*0`@HPkhiOX!iKGvqGUPTn{S^R6|~
zKDh71<pm|+-poXF#Qf9z)y|ZPv9TD>Fiz^=Adtx>KmT<ahOl7}^r{4(#_|Y`ZbLbk
z0(qgphfu-Kr~O*ad4n@xRQL^qxX!1fV@BweUrCM+Faj95XWyA*bGS#Ilds?GFfbnf
z#}zK0;jTE|Y=8SmXO1Aq`ew{P&{y{@j18N&m0AI7q6KOGC7*2nhY*$23p`rGFjx;L
zo<OP&gL|om<^iA>lf(y0yJr?SLuFLE!L~16T#*oiq4IPAQ0nQVn8N@~)D_&UKXqZ5
zGL*aFKgnJdyQ1>~x%*0d<8<=LgNN}D6qmG3>Y?Ta?W{7qig%K95~V%$QK0k5D=ZY3
zyad|->8E^f=cT2kd1u_x>NwVsMlrO2_jo{H%AnjRJ(q_wd++BjrfC><=Z=#x*=r2A
z1psPYmuY}<B($j+qHb8d(J+SY2K0Hb23_V*(ruS;tnJ>kP#UFgLG<cqdjg%5%en1`
zKdY@b_F5yp!{jd7{b|(w{re1^!*sbA`jo9alkY2B2ucvj=r|Xi4{D3p&Qy#UDF`_p
zOHW^`w2PhUHXS`0KKDAGLRP}SaQ})64TO<rzn}a|8z%axuMkBzeWF1hG5-PGQ^CsR
zvU#0B!WnF0C{bFPUq^>&NJVUdj|5)4*60ULhq`|6_UY4?oX(7tTBph8Ehtt7DUE<U
zvW{~=xYk^-wlJ{*6kOpj%R0IM8iZW*6PtooFynoqW5o-;zNF9IAP7a8LN!3>^-?xm
zS&!;&6pdWmc}x)YT$?AZGUnq7mfi;sudjQ0U~o9o+`jZGT)!)rgM~#u0&$SF0!#Yn
zMX2-cBq0>`ud$f9pk7jtgTNXw2fm3tXKffxUT4Sm2`fePi4JTb#Re<_9xCSLOp+K)
zFK@=b5a0?x=%H%?`xWD%!cNEn9Oh2Xk8>s_SQNdT4j#%AjRKj9DJaO1Y8F7lh+r*L
zxCf|Tk~ppJxy$KrV-ewIZ=BFDxco6_aw|JvzS>AomF=KO)izOg?7GtcMwdYa>l0!<
z(LC5GDR2-KqOMXpeEquM-%IX8I?Vdgh%ogr52$F}Jm~wtX2763F$~<g6O4O4hid2L
zrRf?Q?=4r6eI!><r>c8Q*=c|+0fkPy&4Z`IU7lq68czxiE+^=1WOV0Vb{=zaY4(6o
zc6_*YaA}THk{g7V7MP=_sl%%lq2@~BTu88KkIqmVhr+naCc$9mgH_5^<2;yyg}e?&
zsB0b)wP$bfO>;7{Ij3twvWkNe9vR5vR@Z&@;L0!1e9m^n&cfg_l(0ccpYh?KMiY>6
zWVQnvgKC~?HVgxA)eNdlfUWM9DN0Dv8m|*~8gf%3(zA>_M!OING@YI;;cQRnbP|uL
z6RIryT*7spbQissIM&V7;>!TDA~0*!hJw}g(At;%Aw7e{n@aoZ`*nnG#e-<X8NUiA
z7!<RCQw)9+T0r?6L|(by5H1uqj}R=T_oC>-+R7=S+Lr*>0Nn>3Vb)`BD7@{!7^SW<
zp||ViI><6oDi^40pl(S5qf+dI>LeK%SzpxR0OL{v*}mK|*qDNI7gG204s=E|<Qd7W
zm7l~S&~~c-4`FW|l?B^u4~uknNh94If`GJ=N_TfR(%n)@mw<FhH%NDPcSs}MzYE{z
zob#UZy=#3g{&czIzUP|RvuDp94&!-c;MDVxQ^u^zaXK=zDhoY!ZcZQ|BMi{CipQ+~
zo<n`p5T9!a83)%5;l=S4(ECz@rOLIA;3yJ7ugCk(V5J9$SGN>2qTjQ*Gw7aFk@G!Z
zVN`5C9i&0KVo4D6a6|ZEroP;=u$@^SCl~v0N*=h5!iW;6-?rq}Xb~XfBLoix4}~ae
zMnL!h5gEnzh2CAW3v-gS@#WDrlS=~B^3$37A5CN99%pA4<K-p%d;L&a&)X_$*<ypX
z<rZX-E8sdR=I&ai&G_qdCxb8C4hG6KjwXgAYHy_#`RrjQV|8z8Aj`eMu|V*Sf$wp8
zIKlv_txZa!y3oIc2JZf3?VXi6xMuV63X67;pWj|6ea$77q7-aVOaz^BlqPNO?IGyd
zVpPhclvP9cv_7HGsa5#sr)H1D(G%QDCUb;FjX2`GKmZu<Q-dSfkx-F&Hxuti#;KpZ
z0JsLQ0J0gQ8I52t>{JN{J&B8SVvnLjvEb7ORw{@-qv2FyFHj0=EayzE?3Jq#lBQd{
zpD;>r`v+AtaYlG>?az0QP6%)nfk$u^o^)I(NfJwF7K&Ka*Nbg~uQoUD-i3p8>oBg^
z1}FMvcb5i@T4QwyxckjM?`<Uxd!exklM$pAumLdL&5(?3R2oyaDUsVmj-x@lh(Ib-
zs7PC5lkxhtFn-wY#y#BBEyhf&H;vCd466@P+uFMC`-h1i@1d(K)ilP~UwU3?X+^|4
z?EF+ED1@&hHwKE>Om&GQc5;X6{!W8Js-Y|T!HmWlD`Zq6yVo7*Z&Up5#&fa<e^?8Q
zxI*e#<db95<ETVvxSA8$HHvD6W0%$a{P`v9^al`rSdcmH;t7qBqJFTf%-U?0<@7pM
zEmjpc0Y0X@0Rd8+PJ7>MwdjSz*>v8B7GtvW%u@&nt1T>0hjjX7ACrBEI3Q;KnvLW|
zqx@pILpCb~@f{iz_=y?S^_;9^1?P%Bxw>9|A>jTFOM;FLygw)M^J!Wvq$)m5M?w=C
zDl;fE=sey(X*4>wPZjZjdk1RZOSBzKU<L+Uc`S*@3io1Rn|&!)6UYQqT8%Xu+e1R<
zZdXSfUg~Q{>D@Cf;*M2okda_r4i<$0vsIZvrPOq9k`{cY?l*s?F{!855P*}>#Y`@6
zxjX|77NTNlJ}c20_a1p}7ZnU31Kq_^*vZ7v0r$P--9M{szU(GkX0LrU*ADi6y!Tw?
zt|NR?1!kDFNciLBbDNwN-6B3HM6b+I6-x^6-M2(JH98uEwlj@8N09NSld(6-8OU)K
ze58xMA}LfF^TH{VX&YUR6@mcGhgDITX?Djg$J){eq??&1L!Bu*7Txb%?|Qw){e8(c
zvSS@zLc0l0CPRQR^+WMli3TzvS3_Oh{pEr((+|Uk-hlTEPBd9*#oU-FN{l4dH5neU
zW*gmoQN%<Da3}4k;sl(x7<7i)gYT}6j|H7A842?{xpKb8h<s5q!2GdfEzd!(-Xy*r
zOValzOw}?cny}L8o#c^}-PD1aJmZpv=tQ_QSl`v#*ejMFi53|QN|=$8Hxy%e34uxd
zm@moj$-JCP@onXLdtgT!^kQ|55Qx0b)#?!voLXPE@36N=wB$$i84@lLJTLZKyCaUG
zAxu+qKh-Agfc#HWu9JSfUq)JYLnE%$usN_e))2uh;@pMJluAGdd^_9x(gcr@nU)&4
z{pn@L60x_Aoy-S07qY~xs-^|KJZ2{<B`OTx$IUYK>;FbOjYw=8qk_QbpI;VuM}b4=
ziQ1M@DQqmJ@V^7^ffWHBp7%5GK|kB+=;#32c1(11bbS0i7pwQm{qyBM{)1t_p>^Ck
z-}%g#bl9Zah|wx>eI(^dA=Q2g15I}}9j(f0!E#tCg3M}uvL~v{DAFIM8nWl|kRW6Y
zKQq&URJz9U$&<<UU{<}0Cyo}z7z$=Mn8m2S^A-c$WO+^nS|kW>nwx;Pg5IUrV`!G1
zx^V7Q4YI{h7<@g0K0&mZ6Pw;oQGB)^?)TR}r#<_>d97;KSfX!}uh1!4s5c%77~1Jg
z6_%r|&FHAKd9O6_2I{oFv)B>tpNx`D6x9k|H*B`HRIc{8F4Dp(*R0Q4O{9{cvwAmQ
zeFsAb&h7PTCdNSil1pCgWNq{_Ro+A^L+3=fiD4+ST5PCJ@jQjeNq<vK;yxFc>5ii)
zb%k?k`JslqN~*pwZ%sfgh1KADmWeXhlX_XlZFvp7V-0Dl91u>)<NAAVY9pDmr~pq;
zc&n5Lgn)N-a@2DO;M`#s{syiSOJ-Fx7BhyI7ipPrE8F%38iQwNI}$*N>OT-XN0q=t
z1l=+_Xgoq35y`AW96ZmY%s}!uP+E7o;VrMPK?#d$9fiL-820C?p(7YMgV(r!bGUhn
z#q;(BrE_?N>Kjr1*T%M0?|lL)YHH=sLZKyAM84t8y)~wiz`vI-e$f=1Cd!TLM+ygi
z$TQn+^B-9ekdOk1Jxon$9M?e<WRg6c|5o_7+=G>uVY|h|<zmx;)!O>Rz$E)ZWt?7q
zm3>Sq0(h^giY4;bGxK<X%*)EZu~^R-W|zac4RQp;eaH{*C$2>*D<n-789s}$?t}Qr
zW_R{`T$AxU*~1<pdL8!5{!sIpAgd1bN_}Cb@L3o`^)zWb2J}go9WM}Y)5Ht5vMoya
z(^bw23MX9t3H6sEwQC)XG~)gf`!m$lWJY@uRMJ_cBB#~`1mL}AXoLde=CH668Rrav
z72l2T?+z2gr;A;Wms_Nh7RiM2WWS7dWvP8^5})MRl&EOp0(J<ry+RF+FyXKAg#-09
zzmC2|EX;8acjcngK(9HQF4?z3Po9UjS*V!{8#C{!UwDy>UF|0Y_V-FOS^hs?ENlev
zl2+)0%(J5(RvSux4&_%9%c+CV>7Q%3X5&BRYe#<4Sb*kZ6n!K)&jj^8K?~?G4{cfZ
zZZFabPr2e=OW=5P1hLciuk4RHGM17v)zBo37YL^%_WYlxOpyCuPnkj}U2DnRWoCZA
z2<QII=Raa2b|<)A{)lzqzVP7tUGMO}_{iPeJ2S&gN=iyYL&L#wet&buZN2Dvf6cm5
zO{qp}(eqN4ojwb@#Gps~x(w72{nQtwD^oR$f@9s81RawFK`!@VmFr85?jQ#No2~&I
zM)QqY&PB(1ko&+5oG`n)e6NT3pY{AO+jIuvE~rt2NT~%jKr0c{=2>Yxh}TPGp)@p0
zNnIFv8;S^${}hxm&Y6`^?o?keK6`H7ZlL(|_wQZTWlAN&wJ?qvjY+hw1VH30!Rob@
z`*6R%H$_xO{JrcL$x8R;HU|Ey<i5PL7<Wxwl?R6_ur&L$Z@OHZ-|c}4JF@|hz9Ocv
z*x5|TtKfUdc<#vi3l+4ZTG;-KC-3<*BBv2Q^DI$g4>4S&GVHbaOoN`wb#kmPLcPOj
z4sFebeJ@iRk-w{<Tlc1?zqO^F1fp2;qL(qeum7kN-MA_?yJ2dfmFi?B3%C@XY6rkH
zS<E>9YDGtfU0jR>_$b|d!&gd*Y6K`kKIwzoZ>QuOM*W*ZDc;bv?_91p<U8=Z?=F!^
zku<h6+`BUEu&y*aM_^Bbx|5#sI7qRdIH;t9X0r@G<RLie6HBB(Nzz!j-$BKw+Md4^
z4UJhcFt-2JhT4Vj%YF8}qXSt8l<;K7Yn237BFn|4o(Cysy)Yl<0N-dd?TCQqmo0!a
z>u)0yF<qtuj@}WWp}lyx{z@$u6dWueDte-&5gS+G%&^K)slPM)1$$_R*)C&Uf=-d8
zn0>m^#9?eeA8GyksL>@47=wd7FO4uPYv4!-G571<c4F%nb1MT_0cckZ0O#DyXOt8S
z?3Jp`3nGaK>{$5pXG&$_5|cz3m8T-iqf+y!_NbZo-5lX6I}f8ms;sr-!0RB0Me8S@
z_}5F<q?EhY$M)I$WpQ`O`%egTPM0R9`PKS@pc1ky_>?m`EDu?iMy!F49aHd(D;rR{
z6deu1r3MmMHwygJ(1l)OrnZ=jMA{mQC0U4m5%HoJu)tL=CCtXl0WNCk&{LwJgV$k9
zh1&G(T>M4|D?wtf(fp)b%oB#H@Hyz$m%~OfNQOW~yROx0w5ii&GZEc3j|-KUD&ii4
zUb}rx*umeSaSyG|c2NCS1n);<5j()c-Wf=!6;4d$t!%gPeo{MeKb(g@X*5&ln282m
z4%k#P3_|*ifOD=}U|PnrI8q@Q!(Vv1){B&ps`l|w+l21Ne}C1}h)&V}f4Mrug*a`F
zcsy$cr?&sVZ85e!*Cj`J`Ag%C<I(Yi1<QTl%IeFbr$D<RB#E|i{eZu?a#nAoQHfQ(
z+3n)?Vjo;AhJ*yil7yMSQpVGx=YJ*lRAc4N8_t?(<;A?~81XMHP|Vl#ZfX(lQkT0v
zcYn%3SZ--1&~n7RG9cuyYXS#Y(MaE8sFXYu>vb?=HQPW}NheRjwj<%4yxp-@8e&<G
z#hem-=nUN5Ww{r(dU~YHVpeCkJkp|YD>&7{`P)+%woewRs9mLkr7UnHnqvNw>J*)$
zg^=Z8VGgZpk?YN$XH*2T%2ZLpmXHE#>X1h5vPuD+iXfXFh7(a(!EQHBLOioUx5C9>
z*yy8O(kO|yWmgjD8U88U&G|}2{1hs!UP{|ppk`xIvTe{e<hzx?#lj@`LN3^&hl!IK
zj%A^LIFLKH6t_@@LLpN3y*dP-+04H$6+Nj)iHcaMY*`dHU|%IacZA3<rPa-K)Aj1e
zu`8@=?W)|sqMk)lJ@zxO)1ijq^ImRr*y*;VUE@kJWezYnCFlgj>F3EjJxXgzzzfj3
zDdb8&ZY5-7^O-1rYn@qxbOe2prewL;`}kqShy8Z9OcXZwX!+^OOL+3~)m`@xjMt4l
zgPSz|Bw^S-S3ke*ZVRKG_MTa|qjK$CKC(HM{LHbp$SB|NyedB9Bhf`T31mUTXy5Qf
zgY0}QF8kb1gyKq|Vt~}~H>rdFxjY9VSq1H53OA%$qC^x5AONM%sfMMy;H8uF6SJIL
z<jxL~>Xk?w4bbvj>}XqkUNCQG@oAMpBlt;tA$eNqVM;7wGeQVm!v`%KnRG{xj_r~1
z6q3t#E8dSXlX8T#ioGJ}TpvaLY_bmiT37zm&}pD%IR6an;o0pCRsI6|;fKw>i`8@v
zGYseAzd0T}@NVfghk>v2-3?AbM(h^T4AgGTZch9T+vgt+w(bo7DeA1)OS9|ae~boQ
z3)9umRhwpY18kj~9yY&9hjkazIDE;s>y0w}d?<Fj%!oZi>{=LF`8}B?2481PY|26m
z<nUiPuBYGzcA9ad?Ub%osBssW$Qz%#rq3NbE(8ER2|Yaq*+i}>F4vWZ^Y;IT@BZcI
z4st*{wRd%ixll_oG4}Br&?j>g$kkXTnNPZU6EwLw!SX1VYGUA0!yzv8wmYa0zA`H3
zv1FGWE~fD=+n+5*uj4TL<d4YvFK8CakXCRz6X<p~98=xw=_kp+b4#4n*?Yvw&fC8l
ztPj2V_JE?H9!>QA<mi0MOrcppkyX>DpwPAUc)!sm+f<YTG9Wm6RW$@+-FH@TX!I|F
z!{Cf0rT`HX2|ZfuS}q-Dp|qFy(xZfv-oD7@aJl&fA-jp})1NK7?Zh`uAH*sNMzbY?
zTduQ^P`(-FUdOm!UFz{`HF9Bl4)u`A9<O8A7Ab!*V)F80Zv!`BHV4Htpr8a3N9RY5
zR#q|qa<<hh*GIxlM8|e&UwS)4onbgGOZhsM)1d5crjJA-oK<GER>#5rEWPiwJBnZ%
zTsZyaO$md;4$8&(LAk3PLs8IwrGfj$#@3=D3(&EEIp|nJt=SnT;cSJGRY|sCk-W^L
z&+PnEA|=FO#ZL-xpzpvML&RfQb?@RaBPJpWVq&{^jY-uuo!J$iyO)ziprNVW5`iy=
z9YF}Um~1{t6MT_vIvB?G4-A-r`Ce_yWV4(~_lY73;|>{S>EGi-rR?Ze)Kn14;q|&$
zzWKfW-Ps7D$$;_CZE*i6R0{4@NqBhp^nnR`761k_&<Gy6c(~n$Dn*0%G4<+3>mM)n
zWLk9e_7+*+II$%zelMYOyHhI^-i!T=0(aua;@S^D{NN&3l7v=K&Xqm_6Y<HQozl9Y
zlsr1|oDXq+hgN-m0RRD)^vi_JzNN=&0|JNhi!|RH0F)@DsMFEe<!x4Y{|CsQ7#BsW
zjeUDg48zoW?|OaR(oV+DtVg@JUB8-geuIh(#ABfg!PLk3`Wm2s5YgalSa^zW)dmn8
z^!>VVYOL=uW?+yD4`<gd?v5V^65K)WP}-Ruq->zv&hUw11oW*Ekq5VZ)JXyl92#G#
zU<_ghu>=je!dU+zy<4Y;+tBD;@Py2#=)BiE-<+|AOf(X`;ZTg2_=e_RdsS6qwVx-Q
zL`bb&Yn>K)DF{j<aE=Zzh$7N(U-P@VJ{7EMXvmdZbG|6lW2b=Ggj&obcDu5!2h&|0
z?+Zkv)Z^cCB8^P=M`G0RQWeGriI_{btR49umjK@tlHzMt?_eSa3M=Wn{Z^Rpp;l|l
zS(IQ6qc%Ud;u5i1=lGk(N;fYKu-V|~`On?J-YN*C(y6|HHdOi5`%>+<C`|GGunDy`
zD=#!xW5>J{^FGufOo<|gl%(aPzjfc%YTRy{1A+wIk}{k#ll$708sYbVqea7Z5<Z7!
z()yzmF<)r{;qdJlg}_&$FxGG=F=H!~&n^B<QM#MDn)MjbbV>+aG{(x`{*nkuf5H-N
za$azR7Ai>%C9<+GSiWA2K_OIC&Xc8-e4|oo31|uZHt96zB@9+kkheI;!nOzT{o;_?
zVNgr3S{XN5OrQ44z8m(%hGi6osum+FjTFNHQ^8kPB1GJ!+z#J(U$dzcN%QMB_g&FT
zr}4oolBmAjzzHJM-(&mibxMv!tcq88DdM4NfY0G->uyE2h>eT?8EJ;ldScsRyEh42
z>9;%4VsJRlP!Zlx>T7YwB(4&{DhC>yB4sD6wL6uh@lYpyn7u<jiT^H9aLZq@+31ro
zmNeno`<m*iy-hNMg7%q2kTakwMWr&4h4|43I^kJG?)9_&!jL-Kb5h>`fHqGyJ9GKY
z_>Fv`*Vo8-9;$TPMsCiYqL4jesa+;oTBE=ce+__B6)YfNkWg2cT1S%Nt1YMv2Tc?8
z4DB7Ha+l)exMA$vuF6{dP6n_QeP3n}@m3(P`9H10$lhHs>s1ElgAuv?L`6vJ6VRMj
zn2GoSpU>`>i!IH3fSUsgtD7j_it+ijMQgnVPdZS8pjQBAPvK_9Yo|}-HTwfQ^_3kp
zbzWRoR=GqjGAWKmnqeZa-sp^yOzcl!cE0(e%w!N-BFy;_Qr`lWSWrMSSDFkbuK>AE
zQOd+)^t*Eyi_P%Idi(cq6Io)#Bd~v4)0f2};fyj<QeBFcg(ZwS;}ItP#c+eEyl@lx
z#$tUI6ihcCDf{X5TjE~w+8eHsLn#%j-uK77uwqd#c~>inG^XPCQKpJqcW1aB%tYHd
zUQ2{x+yo>2J^@^?YlLv`acfx_GM9%dF8Gsgdt{3qUY(iDLSM+bUo8A})cP%rgScU-
za`<V;1=UI!i_;MvsD|B6QANs(U7yMH_X<VRAviuJFsKRb!{Pt>1?ZZpqjhYTtE1)p
z8J7w<Y^ArAS#+Ldjc!iCm*jyx`xQpnUCr3&;W-l}m<rE%N&i9`jf4)RA^2xw>i_Cc
z4xmD=T>MB6hQl@PYPSkuRTkr4BH#OQg}?|ez|X(16COkpRKo!sYDj0~bB0oEih`a!
zS5TY`U24Q-(B`-A2zq~YbciYPQZ6INa*hqV9caa%w8+U(G{Ku+>+qk~t+hFZ=}{@W
zc4Dh;az)=e7PNT0*8}D2t*b2{vm_Y1Pd4Af@hrEJ6eR!z+-J35EE0ctpmqW}{;4|3
z6p*Wo2E;4Hc1TMgVdLKkpKT)}!ku8?o=kSbh-tJeIslNUQ9B%9X$z4nd$_Z{{%3$0
zk=La!xm-ooalZ!%m3Y@s95-JizYiYM3y<e#325l^yZKx$L)sKg;-Ei`fSz-zFb<~~
zkIm`@>&o6{2k3)(draP7!M3NqZB#?@k*q;jdNpcwSa=F`xXA0W*1nd)Ef+Y;qZ4$)
z{y3xaZZ&+LJNac~Aj>)>slqe<RVV7N;#dN`kBFt|jrWrk59gw@%lcf?XZF#_tmLsV
zJv6*guP{1?FP)Tv4A|^j*sR#7kYTo)y@mA-!C=tk1cDTBygLzZkw6L5AP?FF&^T8k
zruSq`>)UJ@8z{-%{one4T8<nBryLOIr%fVw)@kNbs%Ng_CFZ^%gHz@L#O2Gydn&u>
ze2nrpXo8bbyE%I~k%=RfuN2l6uVRX+>ZgW>H0_XR7zkbWaWbMen^9te1~B&#9H3{2
zMB!$>TkEptuq#nF{IBp~Df-XhBQ@zCofi12ZL20{verw&)3s4|k#`T0)rQNXayCR+
zgc8)ae-O~A0M5_75@*0uOvt26UjvZ1K1sF)_r0Cn*ztI(C~#K{%{f5*6*_KKmh38Q
z8K1Lj<^Tv2sc*eH;2ob`-l1absZfyT*B%p=yHSOpV#6+pBq|O6FL37kvh$Ab9opsQ
z(r^EZHyzbAIl3ajvsf|N0%(FiUYZq@uh{*o>IQ(ACh>XXb=;1$IZ5dmaYePjIyQhv
zeyogFDU0;Jvnp}grwY*ySUUZ4ORH3fmB4fprVXVhk)MP92V@7+8~YJ3D}sIk=GD)p
zSgx@+jLBCQ`(Jlm*E<`+u*3Jgysp|r9>PSSE-p8u<cs8M<vZj@<QL?3<j)Qmq9sFB
zE}Mh@?}vIS5GRC20-um4%c^OCZ+?BGHL~zhhQ(kYby(2JV!r-!Np5wk^@GfU7ZHp!
zQ3aJ@Hr^-1&Zs*E;V^x!zhvP@Axvbp+YXD$T8+5otvBf;HLJ(X)LA;>r(_JY%RMhS
z9!v-p`^^IU6WMY|)ZE~xg&4m?gL`$Kc-{kwP@};y=mF&&G@=^_G(p6(>r=hMH&rCq
zlVy^k@-~7kqQ+w5!E|@aBKi^bhRPh7t{ERlL!x|lW-i_GiYw-F{6_rLvdE%q5!08J
z2hMs1GYpLrT9x}2W0eZEj1FUD)_svAp~wBO$h275|CXMU%uty3VuZZ4ZzVj7=`%K!
z{4LIJo!a|hdzcExj<3JFg<X~VfIOg7)SWzk9`ctEWn5cZNMODKE)Z5dkzagTJT>la
zhB{^F;p1+xLlO24dlGt!C2!@8R@~uI!fM?Ir6bv{GgTp6QTb?>^DyAn4M=~ycd6@d
zB5*{P@gdxgv}V$5fNMOFF>8yYTrXEAWt2o8$7UCKZq?vPl1-y$iri8Ci>?eggRXOm
z(8o>XulbMj5^PRjO+^hL{vv$1_M7KV2XyTZQVC3f0Rd1jFt@k2rNC9}VsENQ@<%7L
zY2Rpirjp1)5Dv;Ap*o*8gk-o(JKxdK|1^@ObiSm7L)q*L+>MH}sfA%SKkMa?d}XLT
z&#;F^O5NBi0CQbMDkh2h3AgfFK5*guRj6d(yE76M)&jLgm`{WekPSY}q8}|^1h@@L
zr;GEA+%Io?=H0Y)s$c)Pe0wDH3i0_@0zbpSZg;0SAt50rCntb$5~hTOf^v0tF9ZKw
z<j`-|(2V%=>{aHb3#09sX(ARo%rDH!-@EoKr4bsPh?KuPA$G=)p+pPFhJPsK*3=gu
zx((|VjFc5=sE}H20<%E~@bLvsb}@7Xf{xbTKjGzR^=SX^34(GAQtI752Xp9y<3%bx
zT_=$pNx##1%8&9g-c*@>yt_NzzuKG92eUwvVM{O-tHK)}<Efm?1<Ny}+YoH8Z{NU{
z6JbE<>6m7<!7QC3UP_tF>U<8jfL8X^(0sf@KA;=rFP@p?YiY9~7Q9R7e)+H8Rn$YM
z`QiH6Clb(|cEG_A_;h~%{@ustg^te37m82oxK)OxBcp|xRw9VO&L|~mtuKCbQLPcV
zxcm>7#{nKC3gzA!`tha`SEKR?;ykJPW0j@ARsyS(xN~3jxRI^RXwBI7--5_#Z=1|^
zwllW-0*}~?#r}R0WT^VxmbrlPPJ|U~P0A|6L>uDG3U{!TZLnDhayp#H!dwTJGBm&k
z(#@O0H3F!+PJRHg-k&?6z-JNzdN_#cmE}a`ip>$z?UJ#-Q8{^$NOwHND~SXI_W`FL
z<uCp<q+IjJuO-oOyFI5>v~+dlnFMybG>T5Ty59x=^H;j|BjYbYT>#~0OQV8ApiFUA
zI-Xp61Mf(%{8j5XAH3ak+@F#J#!|D>RB6febq$h9*dwq)4bg8l-wh^OX*Sk$Oif`|
zKJz%NKL7fqmO>*@8ofMC6er<JvN6Y@LCXgBo<i=3%h|FF5x0q1>(5f1oqaG0^3u{o
zv|7wy7}P0*2qrSu{$Y4R=E@gc?ELVxw7glSb=vF10?qm#!4i=Qd0Zjd@V=v?oPgaB
zb0ODuy*vQt(gajWp%z<Pb<Qc_79=AM5xQwxTG&Nh{G!2y>Gvlmz#OJ!*C-w8ags{9
z%`J0s!KDINEWaive|E7YCI(7_n`f#uAmD&H2BY;mrHFfwGO`tcI!~2@>ES&zDP!un
zLT|C@hri$amgK~dt>;Z75%c_g)phz(`pwtD12<Uki43lkt0KWmFYs7Qyw@4if&y{>
z_uDqOK4D@Aeji&0xH%1^4bxPc;d*x$=3GGNtB=iO@_Tzd6VK7-e$avr+F*PX)ng>N
zfy+jZ(b@AthNJT%?%M=6>Jr0z5!~h6{BTzU0prK3R=HIa5{!yZ=V30ZWQpW~3#D3T
zqGeFR;NC!y3Nu*Kv<3Y)M?TT@Bk0<9<94slMs(Dx^3wpPbAaJvzts=ZY{dGb8qDAc
z%zw8-+l&qLQKY8IH)4pWhi8v$1CGw$l3APo(|H9x|FJrlz8QmoioT?Y{z@`%k)rDa
zy*B$;I7Chm3k!qNVOj&N>JTg}Gq$JFhETO~$se@uYL&@ZWmbUh$9Uy&IFBvHd`7XE
z$E62alb(dEtgLha&sXT^5L50O-Csc70eLcw@;`s})0hs6OMM?<1hME}9P3e!DZYHi
z6X`Ohr@^iqyg%SF@@8y1&q!^Q&bd7MgA&tgm`WUw6NCAMWIGSk2Ee4f!i0NP;O_he
zg&k}LGqWaU+qLjg6Ay*y=^Z12NxJgbRd(QW=&^!Q8S8d&<qw;QYi)JEH4|DS>zwBL
zeHxYTjB7#*BCbPF;c!92Z?<)vHhOKn`PWunLL@H>(PO&}s}MP5o2>lf<-&B8nS#sS
zq~!Sr9wC&>%TGUSC#p|9E|j289$vK2)_Z%m21}sONX3wU29JTq!!^O}f(~@wO`ziH
z>sq|$VPsj`4499@n^jM><;s)(y|cI107SiG16(IfCIj*Cg_IW4PtHhYD=ofwvu3lk
zRAo9V@NwJg>)_Uc&u-BxLCC;OAOH$^n&);>&>ixhuewn`hn_CRkAe`mq4>IML13tS
zKdaj;4?0A(v9Ym_A3w&##K>g`c-~*ziHdeU++7{VN`~r;#%8`1DGI7VW+a^Ft#W>R
z8I2>bjRm^MPlTXm`muBXh7);4Wm-L}Ey`d#+3Y}H0y$Yg5y==5<O2wMa^n&88tXK8
z{DH)=hpmAPN+}$l6+oqU0C@xM!S>KEFnfSNB_;$XpH@M^#--bY*!Trl%b`@>T>zTw
zkeHJls#r}$fPs<idM8Pd5<PM`1Q61g&z^**@jYo^T#ja9`@`0jDHcG%&}cP`&XzaV
z$-USa#2+tIB9bl#NB0s(w}%vlejw)HaTXG6l4O^tRW1Uqq~6ao%JYuP5_BGkU)H<M
zhSJ|APVE7SL}JyTMJo$AVBpk%Xv05~2#N1`;#o3Z*ewf8a=d>}6^Vfc*7HIsu+ilz
z>u$vxHk1`04X84)aB*8!(+<^QD<!7jLc1|)xe;R9H!OvK@VMMPE#dMpRi4~NnBVzE
z`#|c&Qv-&Uqt>iQ->!N{G~Ru#G#Sy%7U#8|#lLcvL<{f)HCwif<gL5o?G>n9ts|=5
zx4~w?dsnCo<Nee|oXQ^w7aY7Wqk&kAh<Dj*a6dT6lPVG9gh7Y%c<-AWt=NcyJZQ~d
zT1ct8l8Kn#M&J7Es7Dg2t-hnZr6Qa)<Tyv@j9iB`c=Q$cp`ZHbb+(P=;PH45)_kR^
z+P<SIWQjfkDM<)xA{mFHjP1!dfCHk;)UUTYYcRTq%vI)fYto=kE$7p~yr52IYcOd_
zyOx&!*w^>$bY-E|<(a3^Xg^w-#$Ji+%%O4`Awt5-6n!n>jNJhV#7Zw$@Y!M3TkYO!
z5j%I~$fkX|vRoI-1DQVrvKaS6vnNLAw-<p?yx=wF8lHh?j)qfDV0x`;D;21mRUKvU
zYmy9v86%=PB}^rRB+;K2yy%rCjNraSV8q4Y!Yi+lG(M~|+LrMCLB`RNr-RCaV$pn{
zUNVF2vx6TQ<jq2SQC^O#&TeFXb<ztIHZWf9ZkMZ(AAl?c=}?y^;K{zIj>B4$XsH^k
zU!WL|4<(Kf5iTvpV$;S3$K^Zz7WRI)$mohBy4x@F;xxw#ic$YU{NS}TUu)CxoKBfo
zN;jk(3GXf$-+!gT4j7Dijrb#uLG4qQsymuL7oODB$yyv9JCFe{uEq&IJ*{4y|Ay@B
z1w0O-cAZLC!KaimE2THVF)=;h`R3!*ehr8K%s-+z8(7VlXUS5F+1dkh`mKKKt`!<w
z+ytK&W#PD<CmI^LKv`C`;?v#y7Yqr^hX(ETs>m^EH8#Gc@HmREgxn!CyPZh?Wc4sk
zpp7x!CFqa_`T$}p-uwH}8x`D}hvuExN<r&p_lM`k$2b8&|Jp|r3_YbH>%;SYAz2KU
zO0piMP#Emh%ULQK>)ojrH6&<FvQBK~g89`dJ#lQ^bC{)Y$@ppxC9#X1e~=f-gC=gN
zBe;5I?N?B{?-g1+Si4vTSl*qFe*!`fxNdFx+ZQ2a7#|zQF?3Ac1%Y@ITJDbcP3t!I
z!bDl|OT5%U5h}s-d!&q$v9~V3R`rF1>$xamIFc`7#5|BRbz#e=!AyFL|9H<Iu`(=t
z$+MzS>)g?m$mb#pB1e=^w|O+Gq*jhR1|#qr9`C<HYRi-lq;SGPMN&<x>wm1LMXE0C
zst#v-wGP6@(AGWYb^a}T(OEAe1+*b;9<Ga#Twjf4i`4Dt0EVqDdT`NCygElpLaVu9
zV@Brz&{aW4scZe)C&q(eCy-X|K=^WYmeRLu`nVBgmFPWHmnc1wJ_I(^Mpob0tw-TS
zIX@%;4*wmV<JDCL;AUl40X5R_`*~_N@o>4IeqbO#gNTJp2-d;6q)iWIKg4~gtEU7<
zED<+%y1!_F6UHxkfW}W$oVX(z0zzB$j8s7fQ@8;fE(|oT^r)w95K`oU+jRb}_Zx>f
z9aUV1UOB>dKFA!R%x=Rin-BM9EV~GMV_f9AD_s?whln3pTki^LGaOD;J6@dgX9D0u
z(B3ePD+0e#zusPqj3ByyB9F|LcuZM6KN>cg`#5i*W(cs9z-le7Kp_w6>RCp>v$2c<
z@As3L<X+VOmh1K=j?eq}t({Zo(@h3$fEPD;zHpwE+J1$f1L&8^^F&jkyZuMbGcI~k
zhrF!??>F10YDaYboW8m^xJvOdLmv2PF}JRM>X?DQNH(a#51q^7HXv9(maFP1Hp6<?
zEd!VC^XquN$nCq)$H$becmDHj6O8;Ge2$F#Z{0m^wsvf(k0%Sz`Ejb-va&l)QtaV!
zophSr2zlJx<tDyh60bwTc<5vbm#bC6SU~>5wA$)t1rvXza{bc^qwvWRjRGKl0n=q8
zh*>B~{<^i$7Z3tZO|}a)7i6+lU>*#yvvq+ft^|a9yDxT+-0Ji?et^5S2{bXSpn{_r
z1Fl^^5#-EOHIUTn^}GJO3%I-Ny5)iQ@uQGQhT<bbDl!+ZR*)T>VUZQ@5K(4r!G)Id
zI4sY)k;p|+3oFwm3a$b?y$*OXk}oYF=^$hk0CoaN0&H8pwfpTFPKlvbY20KD%{F=u
ziI3Tgwksxtl*FDFtjlQ;-!akIz_Gm_eG|rnv+%?GAirY@YAcWhaQ*x))&stf1FI)y
z6Sv{ML)k;2Hy8yN7la9Cl7|Sa-Z&V-jeh07@-mG5%l(fEDbyLJg9=TQp;q5#b{_S;
zW;5wrf6$>KX6H29Rx{pSY=fiJdL!~)FR>#Bx`4jhg|Mrts%>x+{}1F^eKX#g+Kb4=
z4s<ru$ZItUZ98yDdhL@0mCRl?-b$bnR3*8l3`+}e!&NW%1Py@dLXirh!kw~^JsRXB
zb}F3Y)xq3Q?qHblhu~;6))+8tB{8?j5GAKHr)9POcN93s0-CS@iq@e-7~BMxyB1I%
zvbBqD5A<PkWHOYI3<&-UhS1p#$^(XX+i!mabRL%@f^GBQ4ZnOH&=ZAf(R@<bG$Jry
zo$&m6ml_GA-+`G4Xe_FGl6L@VxrRBfv8t>-%Dq&^nmAl)q`co>i}5EAdjiTu4&>Ww
z>77WRB&~PW?37MqkvEBae5^d#5JW@b0l=-Nq%ZV0m)R$g{pT4+*LB>F>6jeE>iz@g
z-Y*1=Kd%?VmsyBmdNM`$>{(Tn7XI*d&Sil}3XfqKOvDDDpm@m+R-)<qh#+&ZR&}*l
z`26bi#f(y-)ZzjeptH6_l1)RJJdZOvOl*qhoXiF*Hi){9p0Xr_N`s1h2$%bcj_79B
z<(s|qnsXnytd^{fJyGSfydGBJNeaxGJx}dj#*R7cUbUzpF)XsJ?|v4@mof0QmqN10
zP}UiX!^f(gRI~cYpsZTh8k+(q3w?Vt#GpC~d0dqLTy3J_K*<|@0GMcuco}?uw)ZzX
z!}_Vq%M&Le2=Y&lPeTGL4b_cclDnHuuTlfv)#?B%poTZ}XB%D6nWTHZQA)ua&O<U7
z0$d7WAca|n2`MN%hu!PGJWk(ZT_s<>SUO4gL}amWZ@!u+5$Gk)*6AfqbOT{25p6-r
zJYm#n!E^bp#A%R_njdeDN1dG^D40wg)s~PFg)=0`<`kj_>@i_^gGtZ?Vf?)_6#{IG
zSb^Y2dx0;GHU?;?@fw(n1%lh>F2R_FNrMX@<jZ4jJV+j3vO(-QG?U3A#<W6}`TG2K
zUJy3z_X)V>SNW>>OuJ_^ZeK5O#<n{>LJjwLnRa64vGpGrD59OGN|(69I>~czEJUW*
z>BS|2*IrR9QlUTVQXZKxqY9Eao*3A@j~bk<3U{pxXUnto7;+!9<)xQA(le21lDBNp
z@cd}IF-x>Q;nhlYCeWUSbyyLt!CqN|la%#qv!L4r0%r1vh?Bs1Fr8K^QAYrO-Hsfo
zzbd$>o8RCan~{AmxCH5`E}5g<+#fcYHJE^cz8@fo^;3Hnc65O{Mv^4`|JK69=UNym
zwL$f(Yiq(Y+VpTEU$f_D3yngJoFIC~EX)s-&pxRkb6<lQyXx(?@U~sSba;^QD)u#d
z?XMR;;U-|fxa)MW=dH~Z%x$C`kco~Yi?uOKuNi>j>zhG7$kUsGZAUf=#1$c|9X}D8
z)N6`|hz44gMIP_Za2*Am8I;wdMS(csdxAbkmzj=y;5#B7`%2WEVJip;6&01k{aOaC
zrDj!I;Y_)V<HUil)MTLE1jG<X4c9zZttztz?CknCq`#yhU|9{6`CV=6xhQ_*<L$`R
zC!upVOc!3PR5BkOMw7zb#o|%F(q8gDU%k%JNV(EZZ@N{ydJk*yR7d|*s}ZZLZ?rbM
zHpWvYUWS?0^Yq56Yv`i!b!4jhXKuf!Nw+{RZsC+Lm+^jFaVD>;TV#@98XReU=myQY
zT7nsYDX+YI=tXup*5V)pvaSv>Te|1n{H+1pg+`aLaNJB_23`%s*kPvwPBm-gO5N-c
zm{&c>DB7>^KSy}3!JhhL>!-p@4GU_wG%4NnqjbxIBFn$={R|MTYXDB~4BgT4M3OxD
zbCrC|Zb*CEnDh|N+@n~i=vTj3UkOW`{d+to2yYY`qruBFj|-!BY9|9%nS-bVAj9!o
z8RRHkt~q2P7`V}T2ZKXj*J8te#Jb7`RM~41K-Dbykszhe<gr{e*jzdc49bE1CX)vV
zJs5d1<)dg7N8m5blx19R4;27_wNY_-w$rLZp->@8&gU`=!~uHSakRUy*XT~ePQ@q>
zHDuHsarqS)r=B0r991U9sQF7z*_!jNTp0!6%1{LN^@1&gcZ@N{@a=*Jv68t;`Pf@T
zb3Zc`h1_!m{hBW<{$2C(Kp|Au{$YFYcXfv80FZawwMz3B{!XsCW>ApH;0uvqMbW5Y
z<`L$Pb_1dg$JV?aZ^mu>gq$fbjN8C%3K3$-*E@PfNG={sKj~4Bqbp6GxHo%n_3kdM
zkW~n$sR!WWOTn%M+0HK9&0sWH8b)O%%uA78K+pRd0F-8z2hRhIh>Oz0$X@l2BpWUC
z<usy<=yPv!ehNqO4Iv3zrf(jQWTcxhPwJ<@seP^s<wF`*HC{K@!Jle<As^h${-w9b
z1jMA*w`543)se=7j6IPhVr36^Pj}#K(i$%=-pxj9wz$&<`6TdVet|brqRxo}GjbhU
zVP!0a7qHQ~xCS?0j(~M7eWlv1;|-k&lt`kwqR6beFYu%`)TJ4;@O;+P-}Kh5Obfec
zZcKVK^aAlRi}7XkR+iZ7UpeAm>~r;_3#^LluYsV~1N+r^7p{?qM{c-AL?SD_{Z{*X
zRci}z&h0Hzt;#G__SnCV1mh|+2#}&ttaNN_u~*?K%lw}ouMbFEYKX5rr@JRSjR~z;
zY+cHyTMAkYKX1>bH$S%YYejhq-nNH`&BWWZ);>+1S$IDd6?!yXj*@7nRKGuFTv$83
zq4yyDqAGccwOheq`97BQqMzxA^c5DqQi2Q6L4D%agvxsfmSwV++Ao)zJ+HG+Qv$zn
zr<e1D<Bk9%fL_A)(`Z03f||#bc89V%n)d6RO{<krq)4zcRFCsv3wj5;Z3QRL5e!0;
zkUtAGywKa%cDOOypO;|vXR~{1!@46_b$?xjEl()77$3x8PFW%sCHI+fZr>5OqE%kG
zi=Lqd|Be39vxtyun?qj!w`r1z(fxETS=@sRLoFe}UBv2m{re`%lhw<`Pho{-n0_~J
zu=08-7bwn!%Vq0KcZLXZcayvs$ia|WH1@*s?6YElRu@XPJI*B3L@DrbhC2c+>eiyw
zi=i+`*qXq$`N@I@Iu$1Pr(C%VKx3$;Tt6$B{&%RqfOTVe)Mrxty66xrwWOa8HdWJs
z8VDrD%X-Fi9*=A+b8Mou&0L_{s0e<lptrs~hX@1Vi^J=6O^j0$!%nX+TVXWNX*trn
zST7Pc`xS;Kc_965<@9R5u(`&!u5q$;d@>B^Vq9~FXLuDuNKGjo*~s@lq9%)HmM2=m
z%ccv(|4n5$QT5HY47@>@gNj=HY;hgoc%U^&nWlmQ+FPKHGsl^YsE5Y=_%Xr)d5)ET
z$8Y7AuWnPPST6)*lYZASvp?hp3D6i{&*xehcb)AtpXw~3LfDDD#{05QJiuZDdcG8;
zRUz3>e4TPfnfHw;fd!5+V34s+pT*)Og6qNS2uR$2LOTD|%;&rHaJIo(AkX~cPXDI8
zm}c&8_hFY|3R*xW?YyV^Gt^`1yj_*D4DFWFnbK?(oa<DA1E<Y}%+_yawVWF&3^s(T
z7Xv$oQCuW2zH8B~FQWt=4q-&wdn}Yu!Md{U<V2p_XF;hj9{XWFGo!%>xk6^IlostT
zUOlj3jPajAG_(CaDF!|9l<JsF6&0I#$pMNU=?~Yskb(lC`(A_I=&P^Sf4bRm^6H|J
zUl|afabs-%!sD_|Eq3ZWwrRO5EyYXsjp_mmLu?74S+G@a0!gWUko}E|H4=n)L`d~~
z+rgYa5c!5$Exf`RG&yTUx_KUAD^_wAcXK`QdwKAf3>Tx-0g823f9(GCbmptC<X1}1
ztwP(_z&>?}0g%$uCYSuCkix=!=KiGE{D81^G}%OPf(q))iAEbY)(S(z6)^Aha59Ig
z#^|in4V1CPCMhG?9}ek0Ru}!<Z9)FX<?q5+LdtuJLIqR_M^9|0`MDP3>y^@+o<}}F
zX8~0PGABE(Cf2tF+n8r1HS#M(1*FQXV-=P{g*=RiC|x+z$P)shG1oz5dLtFWNiORh
z-!Ck5dr(MbdT7Y4yp_N&P-ayp-y|M6;7jgYA&ci-jq;}YH|gJsnX)0B!i(;A6d0kK
zJZl|NWR+R8YJAV2pWg*?rmd?wN0@$WzK7K{XswyQ1m{?d>3>Ke>OQb*HY@%*7fJ*U
zXBmVhEHP<G91Y052}LR{tF7ykDe>S=?7KuDhn7v5&M5hgksv1D(NVk6$`ZXj{t^b+
z99ElUb?j}t-dJ(SGbiK^)=X34Tn6F`z-|-PnDx0Sofb^Q(XZN%+01IIU{RsEEM{JQ
zL3t}0ov^9OY~oejQg(_4+aZ0QEEoNU8WEtYkXodERSbk4dmv9PFSz`f|8s~d&hTd1
zSW!NQX`yn)<n!u@%){1^ehDf!p=0jx;EIXW{lwGihQpdoddq5d^?UcrgEq_HprAiq
z#ut0bBJn$`dv7yznmd9=G3md#A~?p}sF%0L%1(Qg(8xlspM?zZ_7jW@cEYb(&;uJy
zv}T6x7jkdJMv7g3#~vrLz6AyvYRztQfTg7K`>ns!06!ZCT#{%By-u@Gas4liUddjI
z!l+jlLOu;AvPSbw7bcfW$tq%Abc`l@PvSxP>n|S5aOypyhX&fL8<W0R)w?3QZIV8W
zu9!SI5mK?#&m%Ff2OjS3k`ib!{jC2{bf-M;8<I0j746APOOfXmX^{81;TR}v4gV8)
zX?(~dD?r9<f5i3uK^@)2;|b^j<_m=kheHORo6vtLecj^=a!1n430*dRKVGN^PVvA6
za-rrCADzwXYO1q+P8amXyI-iW@|?O3gO4a_d1~=;bW{bnLLujauR(J>BeMHQrIKNl
z3Zb^nbv^&4W+?uxopBd)>pkJ)vr6l+2>R2<h(=fQ*8u}x5vl&!=|Bq&th>5=Pl3^A
zr!PnN?*q`-Y6W<xcfDu#^V%I3an<nvOeZ#sjq=SDUL^|Xvk>@zIZ!kvt9$I~B{mBK
z5{fq6r`8rdm0kem+v;#TQdn!RuccKY+-odwUxm554sQVt{JJlV=d{Q5d>2g}ZO-Jg
zq~>54AP02=V4i@GS&;zAY`U1rwM|v(N;T+*njOfHcn6)KPQ^_Vd8lY2_K6=7%E7v4
z7taFNq!CDsAp}xPcGlj>8YSLMp3nAgk5u9P<+gVXE3*vwDB#*#Iz6-A%@kk%u@>!&
zap0bT)_zrcFS>Ku#_4u=Vmdg!ej=;<S>@3Nb^5nMVbA8kSCy6drmMA3sgF<m;}rVd
zbH>Vw*(--n71Wz^BhA~@Igd@XX65Z+c|y2J&DiX+*7}FbVe5*dvLux@=*4X5Nnx13
zhEm<mua(a$@cenEQ0o2iS0Q3(zq*5M1kgQm8%xWHv1sLYBQLbvbf1*N(E#OnsuP+6
zIDt%Stp?{42uyU6vbalZl!o#zdqd5$yzo+QU`>HWuB(o%(;pU==Pb&QXfKz>;4y|F
zMhgxs63%2+SxhCfk?qF!MwIPl?N#?7V2Ak*Z1#E9!*%t!z3+5%lA=%>(YGvId@kXX
zh0cL#CR`_>h^ES&&Dhylvfses@1xc12_jSCvzGK}pfh`KDrMKtc7$!}yk6wwOjOev
z_fx<Mm`m)m+nV)l-pq4$Xr!|ghDD-ulws6bvLd;zF?1Yz-o*nq48m>;`DO;}L+o16
zUBSguN9iFS=E_)5yk8HKBOERcIfP>3#({^dT?^=rc*;uB@nBT4{K%H05cq}+1JUmI
z@T(+6?8cAIUON}+|6UR^JbY%&|1^c8EF_o1XzH}MPlv(?GSd64*erJ|eiwbmnpiE=
zkb-PcG382qAWIF8#1B-OH04*WqwPriz+*rdmwh|_dBql-dk?INv_oZXs4~@aonZs>
z$y%HJ5i??*pGc@+`LLN2>s{qK!1h&<-cJw9lP=e`#lB&QOxE(JL)=qUZHgN~ICTnd
z-6<9Labh^=O98|MIn;=TG`<!v;EP4Y<hkQUzf{pjuIucY!T9%AlvIMpP>*hTjT&AO
zVORucdh{0&!|HkF{=2@Xnz}x$_I+y$TGD&>j!1%}aK=WZ4QJU}Nwta);>n`wDV(^6
zFQS>l`Q{5}<0G#J*Pmfeflqn8HDdB3$XvyZ#N)0f1C8iS8EWOP(Byn+KQQb@8%j6t
z(St2#u@{SNwe91j>%I+%$q1d$vvUn5%J?HdbkAX>E)p|)Dg|_mg`R&lTUI}T%^AQQ
zWrrULhev>o5`7p=P0cFA-t5=4y#&C@^?^*f)ys;<rN}%89nce0d%<MM-j6rbJW}yU
zVRpeR!}qV%K*sD(^rnz9WF9rt0E@KS`uzbw-NoLL6<#<)1#E<0YTjO24T;gn{>K~%
zjp(JUUuI&!u3njCe&9<j6_2G!3UBqi-RAI=@Lzi{=|<0cFu!;dS*_o|U0s5l+J0PV
z!tJ0}S4DBA2|7(EzR&g#S1U8XR2F#!zPo(<r(W9qg9&Z9Ajzb*9gAU5dAh!4T+a}r
z+ET;u44C$W&B{M-U{Zn$Tz2;e>>Q5B4XZ9+^wYa=DAnF5T*y(_uFpP`4HUs2LSr_L
zWdB=e(--u&W8xjJ;sZfx&=bxj7^(UBsi)LsvXfJxOZV3=Gm+_FYn&x9QY|ppAvKnc
z1)@TlazXJ;UFCf6OfwPLYpcwag1>AkZLo>fUH5^Gr;2r!a5+LP2APLmnW6Nd9myWd
zl9{d{L|*X+SW#jS5pmfpvv}YpE>QhN9L>Kx!6dQzNWY<OH7YzDaWaK#(+6V3pD$wQ
z@s_@KvK-DtIly-X3=Qi!g>{<Xx)@RQ<inT%A<>3P>3(TBJa?$wDsTg|h?ivrj@1#b
zres)4`3gHNSMtRo+Vri8rZ>^V{pE$MUT9vH7!TPGc4ZoirTk^<#O$-y4l8@9aZ4ZT
zA5KUdxH5hV(*HPJeM>oiom+we>#QiyvF}*$DX6Q4QKR`gLYi<Zf!*T{^i2HiQ}b2l
z8NCaGwNT<Oryg#+ekXS+v|}<dg6@|RHaCr5N}}S$4!Ofm2&}?ryFDTGIw76L(hvfu
z;jB}ETiqQq!7A$)ldo^p6gNcJB_bKZbol`Z-iDmC+WolN=8ejLzJ%9V;GBA9bhcCo
zKLHKPM4g}3+@%R-Ua$yEK@woq212jpu>s+ES;%%a{&`u5Mf5D{6}t*bf8v<d7>MG1
zd2TU$kZnT`pj*OzXeFb{zzGOU)JHe`v&dtGab-O4yv}zt4OpD(t|-&T@{q(*>rje)
zwFsFwz9_otBGIW*+k=kfH(wA_)zDAQ4>IvqOgrO*(f>W7#issNeWLbd@idMC)cYwf
zf!@{e*g^Jmto*lis)?bumxoJXcJgz8j5`r&WaDz_TEi%qt1$9w-Jg*Yl^8DO0rUUs
zTJbMW;#P2m*o%5XL_k@s^_P`Pa<xmNunGtJ9@Y<-@Fac90xO>>K_ur%{>MnJuW)73
z)LB+ie~x4bh2Wq2L~(3R{ipQQ79GWJ>PkIiI)q$+eoP;UJemnGX=v<J@Jvha4_;&8
zzRljFH)qR*-HWlH+{H8C-(J~NnorH@b-Y>Yrv?amBM1smY6hSyB9N@BtE1^w3zAKH
z^@VV*+G^pJW%>Hiy(1n2>_+r|rOwmWJgoG*gAsh31v3LpmR?Z@t+A}ndIyCvxcg*c
z2;9ARhNyxXlQOth8NsG}F4j%J4T8BWqfmvp2yX^|qO_#Yy_hZ$+YXv6AEEaWw2EZE
zX%%j<X>=25<i1kHIX@+0(|4~*eGf$30hhNn`r{0!<c=1aZd6#9n(Zln={Kmichnk8
z`I3qat8l}dRezD({;5>-h9$&msbM*lR|JQNaQR2*8nhCR?MV6)Lp2H~{ruwJcI{rY
zqj0K-dPJMs^*(pF!z20fqHNhoV=Ueazg53&n?A>lrapz9w~@Ynho16bd}i;VU=7iJ
z^t5l__=x|{=6E$2a~7lCgUwhUA0IINiUOl$aX6Jy%`wO5C(NtE?}depF30Jt2HgPU
z1ARjYGCnbJi|v|l#9<fWgC`CNzw1xWJ7*pozoBH#eQ*-b1CC6L{U{if<nqs-S7R=#
zS=~!If>rAi;w6>@h{gQPNQ~h}m;`ZZvn|twM_^$$TgGl^4tt#}_g8^X-HN$QWu2%7
z7^CU53iJ_9<giOK9WUOrsGRL&w1V4?FERxF7<YkfuC)k8exJG-%`8qSzTIw8+3KAU
z8&_(ibmc*4V&^csKi{x-PB%K{YfXI0T1#K*fx|e1nxsgt#Byc!%a9A8?GdA>T_w%V
zLM5jon(eca^GSkAZzQG;kV;Gk0q>okEcvk;)E9Ds(WAPE=NaKqj`Ng@X21UU4*^Zx
zC5)s~Y%RrRuFpHe>EL6b>lVYcS)9E9G?C4*+2=E_FdK*pn+UYJqc_f$n_#VDznAR)
zAoSBJ`l&iw%Jb#p<!Vm?lpr8N+!6jg9*DI;MPv!-`fu;`#w4l0p=Wn#fkpPc`68@}
zCY2)gr-VUvl<&5t+07i!Rv^@f>8}G3KAUzps4Rj(3wAasMJ0+oAi;3z>nR<aoTf?}
zA+cY+riFv?7u^ma;1Iso(<4aQ05YkK#zIj041agB3sWFmFSm419X;c6m^FX7=SFdk
z>+f{vBWjc@by)@Pd+65h$XRo8;m31_y!=S7#Y<xADd`nTEK^7pYW7#k*Hz*s>Ii}$
z!hWc+nnM0SED#~?jOaT7g6`SMolC4uA3G`(cUwIsV{6}!tdYs`ESkTUoAC((SS(R&
zmW$!8Z-=je+JHg0>sp;Y<qfa*GM~%Q6J3-2R;<a0HH<BhBHFibv5TvfccyltGKspg
zbG?cU4%<k5-}+dt_2`rtR$4rzs`R9Z29mIWKyqD^j2f>fe1A;{qi!ig89cq9K@I7I
zY%pL9vzzVn<T0gserdg%Xx+0sp1;75Vh&Vovkkj^wXyBL8WKIv$uH2aZ2EOoKWgG;
ze4BE{vYtDrj4fq77Qri9q<FZ!NZ}m#nU#RyZqw!cCAX~)WD+TpM2*S4{j$~;r~P=Y
z&DL_4H%+dm`kBH(1=6{|kVhmDh&wKimIzv1Bs_sYVr^}0-gR|_xrK#+yr;l=sR5kU
zoDAZquFaYT|NcHU9iH;Nf#0Bnn3!3IRR4DQuQ83s92|UQk*QB!X1F)USm>z;(&>vO
zKn+u*66FuO(itk4E1QO~_f_LH%FM)Y9Q{HFx)vC($5Y7^`a!?7)uH(e&`#=5r<W9n
zx78SAIRqZU^vQWM`M)Jh^Z)Vo7EoDd-P^D&3J9Wr2#BC`x3mgKOLs|^bhm*ZAl)D!
z-QBHpH%KEL(%roK)|q*pndf=e`~AQ5e&4KFGqVP~@89p7ea_kE+She${ks+n4p#ez
z+a3d1$~PWp3|&_!x4P?ce9MondE1{59}H;<fJw#l@@t*yXorLk@`E3Gr=TzyD>S&-
zUsrB@$6@bvw(9QPts58Ly~8p>lSwja^kwVGB5)_)?gA;j`3q$@?X;IAm;>TJ9SVd{
z1|ZpB{!*h5`nNb8T0BF&e#P$DXLQCjEV)$wCLpRS(k(JkG-d<5to88TPnN~dkAz1E
zQFGLl!R+Wav=;QwYHmlCV;ozuUYL}5Pm?_uz$^M)21-kaW0BjhKN~}&qTE~y+s)0e
zhkaS|mrY5$AzqWl92(vbwB7y#H3TIQPa7zS8a?m)%yo~uUv^x;LT!vt6YVZP8F5#I
z?9^L#e|_>=5H1_T;PM;@iZHD&<vd*F4uHcpoVjhooG{pAr0~oim5f8h`Nt*uYFAet
zWGqna;nF{+Fe|DJk<Hh>D0r(zbGF(wggjb-lrR3x?(>#RLEu<?**Hu^$lG4W{HiB)
zuRGw*b8+m<b+}w|CcX74tkS+E9Fy=jP5H5q_G}*LR1ClOGc>G@RuDd}4rq-~b~zuP
z9CaM=#aDZMDt^nTuFn5j@1-G;<ap#6kOq*7XM0RFL0VQ<%VMa0SJr2}d~LD@!Rs8^
zReSir?5&EY<hOgKU?~FT=IEr4+7pi<N4ppOoO86K>n(<PwXW|6*PiGqN96a}kp9*U
z8LSMcfz<TXPDV!-(&Ou%&$;(km5H)9v?x?>JwdNsjJd=}AD(0Eeu$UeNEFLfU;wBO
zV9Xv!W#W`FGs{oIuNQM>rm1i_+FZeFm}1B3{`76Y{nxsiYWIjzrFh+{<fs*(8)ay<
zcjzMc<D+8J;KBG4#~Tg>ldh%;-;w(Pm<5~oF0dPM*j@ITn$fD0QuTTzw=y>TDoPS%
z9jkw9YfA}gZfHCw{w!G<a_j=Wcwqm~eNDHqav(##0{$v5AB1ukug5J&Z+Q2|D{M=Q
zN9E}6SzCbcGFexw?)&POoa!UtPbms{nwPJkC{#Ngg5j`YbHF13FG9>d*kaqYTQn6W
z^Iv^?N3B%Y9K}jo?gxEfan+>E@sL$2u}e>Odg-qx*Qp;+U(1CGaJDMPMeIIaoo0XE
zth~lIoiCs;sR#m9if`0Pw%4C|_jw~YV2^MCksd4hxwM2h+IYZ4;QMWU*=&`qUSf3>
zYIKC4ZJ_i(86Zi;dlEpVTUz^qLI^{Vf*L`k*c<Dz{PhyBczM8qOTujJDF}D8K)B<f
z(Rz~5Sh)rQ(Lav3-jf93V8QzMZ<kpqX8IF_P_q{<L}Rs+dg0u&5~)XbMz}?Y5t%8C
z79A%Ghe-MFe8RaLC&J@;M%Pe!J&q+D>MYX4QpA6)v%-JV^Z8g-ERU90gG<*mu0IhJ
zbeT2eWVBe+Jv<mtI>Hm$aq{dCSFB9dU*}s&lD=eJ&}l{v#YeStHH12AAe@V#EsQqV
zx?Yv@ZpU%t#|TPa!bnWnncZ+UO9$hZi2l?g0vZpKs|2UeL2C(S1|J)Gmj-VHY!DU@
zdGZN2Yog)*JGS(jaGBfuhY}z#J>7JJq~`#;4c*QLH{0A$605_@A1e`Q>G`r|D4ti5
zy1625%tO43MZE6>^>ewGkEWytJJj^kDbZ>sd2q0)x^2wCSD-+b`L%vxJqu;+)Z!D3
z+ACrkt~n}Y?~2QzSF^!*1bx@|IG1<~r(Wl0jj5o=^iG=>(jXW8bf0;7_viP;-PMvw
zibh(JSRU8T=^JQhJT@!$j<I*ZAG$XQ^^PIGH`YM8G7}{fIJm*Qpt`zx@eFhiCx@s6
z@9NZz?SvYR6`pcn+O3U+`rwkTPu9%Nwe7DDn*BI_s$48uWz~WWvN4n#PfjO030#y(
z8%^59#dkTiuZQRiehx-Zv24?G+GAYu9a*RL*J>IBJG{->t94Qv%|LM}Hjc`2ww?#p
zmii<PaL1ll8@@k8jdwX6=$dpLgkAojl6l94&lbCTF^y#+gP#mjJ}(ZUU5-iARTG|3
zLwQa$7-!<;dX9g^w=1SWDfIFr9tLuDBz3^Y2)lcrGnrC>Gs_k>knYfIwQ)lCXJ4Z7
zAb0=qBMGY2e+WXyN%%qU`sE&X?pnNcC8%Gkoyw|Dwk+v6d0ACubNEmgcQbLLX6+Mg
zh>2qUl#%)<SKLHqTq)}uRu?0b#x<KD{8Va&<cKZZp3=amd4^ySD45D|waHXjrZn`U
z;@y_k3vXe(aJ%*`dfDJ+N0hWekjkrVdAxV)iW2};TY3m!s5w{I($dvnt-)<$q`X%C
zc~OpwA-yy^qxJL0+8~L6%{$+0CkwH8PdkIyg!|g_NGp$w_KIiNJ!ef*&LcH1W|UTH
zS&6+txqvL?X4TOC<i1e{<Dfe!lE71_8e-fJyn`y6At(Du{bG80>#jvrW#vXWsGz;E
zS)E=;q)Nm=qXdK6`%I=2oG1hs7`1p2^t85XV_>G#cjcT_y?URv6F8glKdT|pu&M#d
z#-OSUXl5`IzJWzdPbO?HhPvZ?rw0jBckozQS+f!nr=6*us^3!pwzwD+m5-YUM)_#p
zb<Z7cC)mZAQ!Z9J<Ib<eB)hs=dfQ;Qk=NVoF80KMDa>G|VrPFOF#+8U)gvTa|CQD4
zXn71zJ`1nEzkiJS=+B`1Rv<xgBkOvSJPk0XB*COrzr^$YM=+aXsA)y<klmOvr`N@_
zd%ePnS3wmtqo2v#rSPxy)-1|&a`ZEYrjZ)c0~NP%-~9X(@xnhH=nJM-M@xF<7Ghm}
z@dqE?yZ5oWJ-ozrT}@2kefM)kkau?CGkAKKjZ%6+auxefAzdb|&=;0A>?PmJ-@ov=
zpLFm0yO}YaU!pXxqR_>~T(v5tOl8(*J48sYz@y?0$%)zC$~@dLs+@7JVPj`A!LCnl
zGG_y9WE{qF^$OiBttanZH5X=pb=*LXx@^Vu*`~`}ZAi7(v>lFZB1#d!4X#^)DT01`
zcO3xj%>Xm|<-4Wb#oC!u6}DCSNc{-S)*~#tGrD5aiZlEQl%HpPE3ta7BW9q#5kh%}
zmiAQ1KRz6l6#YRpxR~T4Oz8O3ZyVL!aeMRyj>sEsTXWv_cC#1q$yx&1^9E{MT?a$<
zcXu0HwqSoa<j#&!q^F}pR~^h&#pPIWEUTz^Z(8S$8sSa;XtIW0w}C_~(rj(M!)u`{
z7ASIu;q+SWsJL>O3iJ&Q1@YlQJz#eX^!DZ-a{7;vK&(%^p%y1Q*Gk+_)e%a&e;5D8
zbL<G4-D!S(s~v&zr6<4M{f~v9;L-H&K<e-J&jVM7xEzkUqIv1uxJgNZ9z1;l-=n7|
z{x=hoBFAYx5b`sOhr<PWx>f3`pzQLto(rQ<_40+v!_0B1gKh&VF3Xp;z12}I4`<k2
zEy(jq<e9YE3kEYwZB|D(?YF+jL+eg1PR?$x!+<Evs;U&A0)(n9Jw$TcoE2(@ga|qW
zodFs7^tdDf^m!5NA4_>xTRDG4@x$MzMQu+BLbv0!4+z_V-A4y>429BwZ}|%4WxQ10
z0?rS0KN3j2Ev!dD2)+0;pXtVHOx1oE65re2{`H9bPta8>tEvzWn5kIs&UC!oI>H-A
zD@Ing0dfV37j5bw4RASLWwk0azAZyf>N%1r_**vS<kq~ix5{7+L|Z`?B!Ni;Gr}_&
z1F1FwB<4InTz64I8{VOwzGK<2`BsWvc(F#>?SK%I-T<MH6Xb)1lAD7D^Vqd-4y=z9
z@z@t(5sZ3`w~QpTwG%TkC=XzSLf9hd=UbvMr>-}`NrY!C2$GoJGA;sAhAQU@(J=%F
zj{3(C#3Q6j474VzO{Q2?jDs7BblxSmMy}M)7>|kH)+C7{0%6qV#fOYNW+2#KAuTZ(
zk6fQQJ2vf#;pz#Cz)VO;fU++d4fr`CR%r1yQDQA#$Gz>@4li$P+81Gf3>fkTDhB-0
z9KJhv60o#7sxut}#q-zbzSX}3_6Ql=wx<L7yJM<L)u<Im*Gw^}KLmcwL%;mus(J57
z3Oswg$J<#xUdY<wVprzpL7}cQSmO+qW?$c4R-}!Lz<l=pI@-0cM4_M<XfVolW>ok@
zE=vis67cuCVDUHh`*|$E3o#7Z6Xd@Fjo#UOl<D0BHgqYywPY!#xii`bOoWXXLZ|Jn
zZ5q2?83<z}{l~iIgJpf2r;@|jenciVSoX*A_Dj`)6khd7XI%b_IGl%^cvqXAqoAYJ
zUo+oI`xP?Nd=~K<5YR)ioq@z{!Q|3lD9Ye`1X?9z@Ni@@8M{|isM`SZH{TL;9nW&M
zd1_{6dwGD;46I>9;U-8=SAVW9Fq}y*K9Ok$_LWvGkZWomOgDJ9g;G<>r20oi;g+wD
z6nW#DQ1DByo&Pn$g0BVl_6|EKJ^6^(_@5lf{i(nDWv;^;Y1L$8CK7nlMRxSy6aIRI
zUbH^nNmpd49zMcR>j9eEy@wCzEq=vXWwSUF3NFhh>u^b6clITV-PxDpQ>}5S5)2^9
z^P?k!YKAu!b+7x$_g@c*wA`D7EP`~^9{SK|?yU?@+2(7vEDvUR6N)A2x1Os16@#9r
zhZEe0r&FiDYzxX5beMj=%I(GWy>7Xxsvz8I6+Wi|mpS#M-N9roCl0iYCFXme6*9YM
zi*>EGPSPy%9xyqtJbP@D8L2;1<+xum=@QkHI^PjR@Wku_-urj&*ntu~%xJv6uRcSO
z2BT#(l&djOX%G8Fx?C2!)4@g*tEt7er`R+qUj?DLe5<_=9vjBkLT7Ya83CKc6|^$j
z^#_(RverHE{Fsz-ZnNp~IS2r(`En@%w^J$XNB%zGp`j@#O&)1+9RNGbF)&@IFKhca
z!1!B3`0NQm#P3&B)RrrJXmbZ!&l2gK842JjDyq}giHc}7I|B_SSeKm$QQX`%G#?`t
z=cWees5%3N`hG8zhe#>Uek(ipb@`DsS<TH^JRW{Lm>wRevbD{ssy6(V6GW=MgLmC^
zina7j#l3LEALHf(RVN#Uo(=pr;_q4miC-+>rvZvR?}o%wK6eoQ{>ewXw<Pzc|BIX&
zXale^1%1(Xp<pXjdpiP?`Xh+Ee!UmpbFj$VBxaz5mGSG>KGQBkIW5uc5d)<X`d`b(
z?OFupjEJ_}V>lNPzs9ECk0@^35I~H@Ur}%am4UJ`3~r>ZK*sa;_y79!DJV%HNzPHL
za=`rc5C{r`;Ir5}4l&*5ZfayZ{BZ&|Po=6egy8{S{+B2F-$`*1FZ4hDtS0D6QEEN|
zIB8s5+_PuTE?&F{`8Y11Wxt<I;O5ci?rpa-(w*mVv^Tk=7Q?nwW#MNQUa;Vv!Q1~H
zXpH;Xa-V3qoR98OuyAtX89rfRx|_~UN7s#D5B(Y+i^MNoH@L(Xp-al$qxkMeA6&>M
zWq(2FFz{IQ$*=#IOQN`Ey8NV+3=9lJMAJ~p1|SKJ0UrA;Z9&0imp`5gqb1-SH|Y*%
z-1&_viAC?{es_<Ooa95`yFL@aB>6wF{iVl-`Mhz3fs$PjWNdKP@cH=h&2p9b%nPvP
zO%e&~{BwQ<eedqD#Vy=86<_@DT>Y*?VmIwvMLJ?A?;--Kz6|$wn7tEx2-$Fpm#?p{
zmzUS4PfkZWOF)W4=tN<D!~P$?X+5>^pD(NS>zMvyh!Fo;@P^R<-Td!w{52SVzVojM
z>BRnzQ2leNe*NBO+W!dBzvdG03vBBD5uSey1LA`$s{dnN{|xZo(dC2~63B{vpYo5H
zekDkMEEM=x%OO!g{MCRz&p|<bkZ=7tFo^dH+(xW(q5{Ne3x5Z6|GydlGL1;g%a<yl
zPQd|~L67%Cq=jy9nkq%1RoTF*LJV$g&wu@5;c(psVv!fm1B||BlQ|Gy0V>b;JgtO{
zjn(+D_lv^?Y>BB!j{CY`{ab4Ey)ul}&wJ|5E%USt@ObdUAI*6Bw(AQ$Ty*X1X7#(j
zjBL%tXbKA436rYFfAZb`Xt*GXpVnim=G^%b^Dpf!5#mV%cy;;zF@*)KY$i0de@Rwh
zM6Z1|H4%zpVK%z)8IF@&DEV*tUwPMIy}LEH*%~5Jn+Im2hM<Z7`7WHHm(JnT7e-mp
ze@*j2RWO9&YGSpPN7&+=#B@nNjB35Wtq9D2%zFF5bZHsVznB17ikmH)KDP6Yt>EHA
zvS}uSQL1P@nE4HmFO%^RY6mtXCQ6f07F-trKD<&F=LJyYW79rREYw$f{Q$B~EI(nS
zAr<)`()|w>n6xqLz|L%^r+Phu@RRxK+c+;ZboKWZNI>|n9rBL=qR;p|Gf(uFJ3wHO
zZUe_Qmmf9_ab2{1F|Az0*AA~v0VBD73{2~IgtB37dD-D$<GRjSno`l-U`j&Qk4uQK
zg8*`J`;S>}$h7c{@;3X+S+h6-lh*cNt&>w+TE%3tm7+k?$|@WzBH(re9q06cGX?!e
znSdg0p*_&WW9#leUe2ssX*UZTk$O7xQ7}!|q$~k9Q^>L3eg!Dn5hRh<p13%zLUEY)
zF$BuNVh`bJ9*Fa=UZ=(9IlDeq+uc{-QJN6L;?i@Kh=3vSG9HJuVGR)ZO11cX@s*LA
zz=8PLj%GLm<t17*xB1R!>5_5`Yt;}MRiv9&J;Beg($RKg(iO{u=Z1YL;JeswlI~$z
zYj#9#ayd9vXw*G6n*`IU((}zG7Wz)G_uF`v+}!Z>Dl+ou6B89vs<W?ejlu5%3@Z~^
z-ZWHRgbFnd$irSRKy|Z+6C4+2ECz@2%#Kb@boZ9F@vlTN>NU?ad6ZcJU<*T9|LD&N
z+i~6NyiDaab2=k{$)ER%_D1ng_mJba38Tz=$}9I18t*5(tJ=SbwQ}|DU3AJX@nkpi
zj5JpoCzSa<9G|P3OrH!!S7@!5a-dhoE^Hr+b+o@66*JLOxB1nL_3PF~>gU63{&314
zO+POC>xCoD)OsE9x(m0OsaJmj$45Negpd%-Q+T*yXor>R_GI|y_ok7;v^HTSW#s}i
z#RB%LSK7k{T51WwoO5lW>MCX9;#e8|oG-zoKqTCbr)<|>ZWu#C+S+S>2kL)8{0{YI
z$Rcr?pqD&TF~5|Z&7V4&zt#dSn2$p6IEur<8wT#kJqCqvcCS^qfV<Q;71Vp(F&N+$
zX0;OTSNJ@_>I8f)JqMm<_0{<LE}=b8Ay+EM?YVH_%>^O8XEM}vO3)`6ho{#a)iMQ`
zn;zW@*{V@3%T60VzC=eGpPiI(J9~u=KE%IjU8L3IcFd<E$m=J3RBX3-4>!tfc*b&Z
zZ9+!rX%=;6cyLu?agqtp3dNMDOegTdXpcokF$GYexrmae+n-I@FI;$Kf52?Ht?ErD
z|JCo?^@m+_w_6^_olJQgF_nWKTrT$a@yas2A75`#Rg)o8=08y^GSs0_*+|F%!zj4<
ze~yl(#=$95QwsdRyWF4lV|KRm)wgDza}<RlL!u0*gs>DBvw)p0yQ7Wcs~_>7a2O?~
zk9MUGih(MqP-3zbM0$gD4>Fi<_l^5gBNb}yQDmssFj(szY-9)Xhj4J{CD%82Hwl(t
zCOs%Glik_6PpfOb>w&4IS)BX+F;#n1QsTR^_!&Y0-^}3Vqc4=~u+Z=+cz1J~hxb+s
zQk~YuI(xS=8-Q*tc~tu$K|ge;5F`!X8ynequU#MZ30x`iy+gVeGyvmi^!?j6m!;l3
z7%F)q_DbVXsy#)e7vhsK+^FJVoiVc<zU(%$&G*$VOUo<tl)~6%Ni{Hw$E<A6`+P}G
z)8hBK`=x%p<{X+T*9cP3dgc;A8z=4C8vK7W4Zd(e;lY4jyDfFC%0-@Q1aCO&_#T@o
zfSZ2@6B8+^z*(Wte4@~0S#@_zXb~nx4xIzI9qv+4g990laE@%oXQqG;ywD86;;fQZ
zTpMjbG^~^Ru{OClbU4ZrUXOlv`?gWq(-_X-Bu~xK4@nYppbwt$<n<_*)`adN^@gaj
zt_qtiL1s4oP(_qWi7zX+GjFn;bZ&EhF_5jysu(Ha?vWFp8Ay!W(A2b1Poo-{T6nd0
zYrX@roZQT7?2Tk?qmGxv<I=sbP8&x?l#aei4U^r%-_ooKEGCi`ntb_r=&8ClrsZwc
zuyo2y{V_GIQMv4uqXYAM;+0OrvExk8V(_M-kQ*jMABi^-<)uGI<?B|i_c?_drgcE2
zMnj&KV^249ZYLALp3FLEqg5>oJvm-~8Zy6>*6SgjZw7YE+lj=A7Ytg1zxDF%;dS1A
zRNj(47sFMdnq+@Bg-H^nBscg2vVf3xUev^pC3#TlS?+XO*zJ{v!+BcS?A9FvQLIe@
zKFb<<dTrN+G8M&^qAnHLcyeLbKzwt4C@R%yLs6WYZS;{Q&(Q72=OkugBGevA6tXs;
zA0`{JG*VUB66SSh2-)$mam&g=O%jde=G&8ckyc*o)ws%BoON)msWn8E+_~1RIzJGJ
z5*m((V%?Uz^5?t0nUi#Gbox%zj=7<=aj}_ElyA!&Gm0fE?r6&(NR&Rac|vkwsz+Up
zft#B|mEE!RChG3Ar&1ju)gqDOVCp?9Nu%eA6*kmgilKx!0O+f*d8+8(H1uAT9eJ+v
zB9$l8?$p75{+{Fqj~uC##<FsYhFEJ)GWqO-n)4X#CGeH{#AGB#iXB#|vd1~VV!XU;
z8gRI0oEQ`YTjan%MunnRg`@Pq!iB8t`wA7R<xICJXDL>2#qe?EVcSU-C#aqDC71mb
z{K?kJ`9|M$gF%*;!6$-fScHZCw@9~XQ2US@PZP+RsgNXGiz-#1iyD&Tt-)_Y8KMx_
z9!Pvg2MiGWQ}j_i$WY3uRM}bJ!6+#+yf8%~nPqhSkLtWGUfd@CJ~DE&)aUjcFL|&m
zlH2*Ca9ySSBZZr|2Ak6~CMK9Vz7NLVo2C}=o2*Y5li8jea2s~C-NMIPv0ShT9p@m+
zcw5Br>ZxNMOLlE_0QhKHo42&NhdvS*{PCk9Kb`81oc1=Dp0@q>7s&eS1qyT(LyC`=
z>vKVpFd!4F#UsVz?4>K-3@1IRc>n!dk{DLQxr9>z;jjffv0bZ?AH>;tCI0BS&dmV=
zxs|~zwmE<f1D(YhEE{fx!}Yo#2g<>TInpUEn?vG~S=1H=EM#G=^-WFCT{n>152sJs
z6*Y6*W_8)K$Q*Oe=WuhzfTxBHybt9J)O_vcylR-fGiWprxTK0Nf#rdC;bUlRqkr-L
z6lcSh*c>*&HCN4g;(O9*>%5?!_?KYlebg+RFA-W)RJ0S~2%#qY4*Zo}bB?wyhGQXx
zkV}dyY>u(1V^M*L5rv3QgC(=RM6C!aP`X>HUq&+dR}ZFc*04S@lr{1mJ2(ih{je?l
z_WgDFPzqUvqo*>e%(*roG2J>lb@kK2lpSJCJ3n*m9Vq%Jyq(T(P_9$!)!<c@TJ3Z>
zDLW9l^Tb`{Q@H)-TDcG^u#5BeQwdj2rJym$eSR_gY;D|`b8}+~T5m-6=1xa2j%H?N
z;^D2Bjv<8((!rEdfb|`<LHwZE$G|TlanBDIe-36b+P^(L4wDvkN4eFTRe#iQw`f`-
z0>k<PAaW(S$?!@z1O#;$(oHH{h<*3VVEs9T3|U;@*hgTosO=Ruzj<?*Un^BqOg7MG
zc>$A5m7OqAK1Yo>?@gxrXvzM_=xAEu`1fYnUe@ZiQfLM)qxd+Jj1oHDqY<;Sv4N?z
zsGL++C8BBU{GGoom46%x_ps$E$Exl)cN5Q1pin}kK{5B$bE|Z-sS}aVPrI8DJ2QSA
zuU}{W+BO(6Q_q}IlwdW$c3<Io{v%0*L%>J4lp1WXQ4r_7h#@Sn8|7Au{^<SW5)Z>-
zCqKjVfZ^YG4?P$1EqtEpm*S_IUP{WTq8ZRi8WsqLWpb!Ip@pKtW|(?;_uYW)1;3Nk
zl2`zyv~_g&mzY#()n5p<rMxR^jUFvit#ANiLcRT4QYByw_+006G$W6lnLjq<y`O})
ze@KXTU4)*16Q#GE=G%+s+M2+*LB-WuDn}hnlTk>*Tk~Sxwe;AKlt(t}6FQQTxFyC>
zb88dOlCOA+!E=xL;VYLQk^xqe&qv?YE7rz2at#OgI5?D*m7~0|Z3UHC1r&NlM#{xw
zi&Ml+lWpF=$A<g8HwHA}Bp;VEqC^Cg&ffycL-kOeFf$byGDKk+3^^GilPsuukP;*p
z73~%p@OZDo|58JJVwGCq<HJmw*;_ffUhj#T&tBxt8+=7ITOEx;;vr#mZFBUfJ+x-$
zIUn<Mo?~tC-1R0mG>&7)y7k~Q`la6)ppFJV4ihGLJVF>c052lbi6Wd*Z=t=?;$=_#
zq~MH=sOkERl|4D~wKcKb60(Aq(Kji^yO;-*>c+}y*q=OhlT7-|UL>US!WF16sw8a|
zR-#=5x^2t?3g$;Ugk=_N+crxz9Ggh}BR3IiALnmte=4k_<KMH4d-vs>aEf-<Fwlsl
zgv>3oAQao1^a4Eu&JVW*@|F8wWYMwao%dF3@-}>Mzj<T(#nlFpqJiJYum@U7Jwrgi
zPXo(gR3{l+VyTW^K0{xO^D_?rluA2uFg~A5JA-qj#@<pT%YJ4&o<AY23^MJdbahcl
zqX!{Ep7|VIeCJ0-*qCr`3ARr^;3^Mo6-=6Hj=Xc4zOcMGlN-&kAoh7EN3Tn6Hdg~0
z3(%e%Y!+Hk(hL+^{}f%mAp~WP2_om})IlsAwVDTfI*<Wi7VPw!ou56U&DnhI?(D4B
zM^<mVyT2Oiy4U9(M1q<)CYwRho7!+6>}Ytic<eDcr3?22rqpJ>)yn4(4QB5q+URvX
zuz`KliZXdn4$;ZI?PD&{UmFh<TCJDoD}9CA&ktn19nm3Sals_YMEdLJZSQk6i5_Mm
zX+&aZ@WXOe|M0hT=3!<y5*+>E$q;+bk*4GcYrX#Zqq&?&lq8pGz0i}%7rF?R;H>{?
z^bo$FHu%wh`z^$|N|ywg<X<1~>)GBQQcFZ`VesD`3qI~Sl62&MdnWie_$reBJ72XS
z!h(1RH}qtte-FQgrwa79>y23d_!;{D=w}DSxSJt=eC$86#6O1h|LQBiB>w+3TK^w>
z6{NJhtR+yRJoZvd8*n`vK3^HupvRAt<q{ZybHEROI}XkDw1|?^DMaA{B3z{ZBU}<w
zbEjup-j9t@Kov~1ogrh=DJV+!36UnXc+Z_P`k+vQ%?9rT*y+ecLPb};<QEmCNyOE|
z9_2;ck)_j^(FRTul0Tuh)189$bh||Qgm@O+&d=rxo%TD2(+&7GHpLt^?U<~HMxK4X
ze~ZX}+}b}rcE_aUL{Y?_S;gV@I7{l%yf}y0r&?M9Q1{@9qzTF3HOKn9mPT)};9gHA
zn@(30$ZF~f_Hl!d!GZNd&-X~?Hm?sISyvk~now}?Qg^?6;nxgR9AIAt=Uv^dm?Y!T
z^36?pDxLQ5n7ut4QgIV>qc?~L`}ns9%OwlBsll&$4_}Vch2u-UttoC7i4^&V-iBJ?
zoxPZ^*E!5yUC(=Sc=tV5b#;NW6A71-ogmd`J}%Cq?>Xv+i<0(FI-IC2NMEi9)PVx6
z9qt?UU_5&~BxZp%cxh%p%j+g3i@rp|Fxz$z=@jQ&org3a2sg1ifsY`RhXL_ONB#HB
z2u&tpUCFKNk_!s=1$%c-I-1PVv-bNQEgi<3QQ8p`<tJNfyUs_lyUQWYy2`?FR;`$<
zLj7<HF$jl5PW&9^V{>&>Fz-`D|NRyEAWX{8#Nw0FAi_ZTEF~O6Xy{C?DW}9Z=Z2Yv
z77X<^bVblKE=V3hU-<@M*cxjKAO3B-;H1#2Ho853^ML-~!YmF+?Z@2d&C!cg$&1Cw
zehYCe(sjuUOO`Xcmld>ox*f5)J`capYLDgl4(AFB%ixavczKH^y~Wu{z=H>;rjrxL
zXQwSmB26|cL%E=3tT~@J?u@Q_5e9?nq^#J&<rs>B(;Kmzre0$KmssE^L)XpoirAIi
zpIXYr?O!fIP2Sov<B7gR6WBFwj{W@pKDD#b-cmw2nw>em>oKZ|xHrr=gdjfM7cS=S
z*{WQSkg%Gr1z@3<j8{1lT7Oa^U`}s3J-(jQ0J+{XG4b$j`OIhYaO_o9HUbaz&2ron
zI5Mlsy(u|ZmaT7(;01>Q<$P_bB-61cA-zT1bvAGWlK<>UkWfU;*F4fw$ogVB8^^15
zdQ_BfNv7+^H~fZ;xO;N5r=H&4$<aeeB0-S<cZF}ZRoId$T#Ouo_<do03wPdSe~sI~
zSct6`k!KkjLw8whN3W9|a&|B!y?S#t9xb2hzl4Tg>)%6zC{tmWa%wom#OP?_O?*E|
zWV0sbI`_1@0|K1#F`uq?*(tN%R@y0(%d*g<-(C1BYPO+iWBUk%J))3)1xZPrS6~wG
z+_JRHXf`ynuz=2aoGS%8^f3r*<L>qAj&ODCzv*0@mp4(MccTpzbyqV=aBBaSp>f^|
zpL_~2Vi^sv(O$GHx7y2)6PwjZ9CiO-k8mkeVzb^FE~u-7!s1$RIN|#`==7<>Ea<%P
z<H!D_s{nCyG$S^dzc=^L$jHHA$8BX46cw3dQOQ9p+3dk9LyORHc~{$dq8#&i0-4Ga
z9#`itgPSDmb;3vUQ$4Z0Sy^{Te6E_0k4Fh3rxty{RCK-dKxMel0CkWi!F<NBf1%oW
zROn9H2H*hs#y(Ga&kpr!LPBKAEE<w@N~1Yg<qT{x!mlC@G6y)U(r&nLBHFWW7)hR4
z-nww%VaL~;ji`TLfj@Xcrw8z|Vq8nVHx>xZ8)PN!lM5&9;4zL$;!u#AWDk^>J_58)
zTT9FNryP>=?!LI)3F3ksLV2dCffa6UO)XWp$O_ldDjVv>#hxPYT1%;i28m85b|Z^{
z4z*qov(WWP!XT!zT&roUwA2l^d7_Hr_Je9+2ioyB7gvEsiiL~IADea-!=>Cq0vBOL
znvhEKN8t@q(A!8nR_H8}H?IK<A0>q$e?H85?c!p|plz00T+D6u>Z)n5sdAbWxj@qn
zqwa~tVZN(Oe<RR}rKVSg>+JFb{GQuq`W}%?5H^kI<W&Lwn2Y`+;E@qrt_pOm17DCS
zdV|Lzh02rj`HntB9)G+xRmTe(J#4AHtXI={JdP6mj_x)^Euv5^;ab1B^*AzVd%;-|
z?7gO3!FH#ltshe^vF?$r$pW>qE;y1trZc-;VO|Vk4jGq;%G*qDNngJHGEdes>iF)p
z@+05E-JdDl-+?jOTHf@TWmT{B^mKnh6AN;j@a4IMR3yrGGH>jXFc66dxyoS|8^EYc
z@0S_pE3h=O-w?b<dm5ubbl{g{$1IRB(WAx^BSw+ELU`?NS&`g+9D|J1m`VmWcaZ)Y
z@CARR&f~%vO)739jKiGnp%8vm_datviSyxfmNFr{ABFK-qB-JSH_XeI@2I^ISQ#mL
z6DHK(+`L;Tl&#X)%cr_77hH4?BR{xWw_|x{x<S$)FM`oSid~k-B#Jy}rX>j1Zu;Zx
zak4zeeXQO<aHyZN?Uy`MEN~ZoueRK^8cKWKaB4}#O;IHhSfo&D=5i(>Z30GcWJa6Q
z^qj;rG?A@+g(3v4hV?M6qn>wgWg=h2l$Ob;YVaS)AB7Ji08Y)uPdJHpMzfSHh4G+!
z8e;gE*lU-59&C=7u8!wwP|OuWC)D<LaOg=_o#0_=@cZ9H&yhil9o+}YbGGXjF8J%d
zio1zf>s9_okiX<%pM)SEXLfGTCn~8H=b_*wZs;g#eXt8Q80SRL3Vc`2;F1La_vb)N
zEZ#T0!a(664GIoU%GG=2vOivupS}ZXa+{EOq3~Y54;l>@FOT%WJ{;BJ1vG$oHawZ$
z@5gz@@;Q6{p`Ynzu!Rw5W~RFzfjE$55QqPObduLkp7WK3vP@NjcG1(ro@CfsXUH=f
z5V!Hx7HH%yCHLVbv7IpNWWolc#o2}7w;3}NO`$gc$CIH9CNv#rr|H^79+F0x*&M6T
z_IfBceYuT;y9FBlNFydhd-T3}Vjj{QplCX{47RIEPs>6mE4&n8kTlYvJrm?iQWxE`
z%MjOuaFt&f)YE?e6YezTA!Atz!x<@C6_`*sOz4?w2~u?!9V;?=HaK{rD|QUP$IQxX
z^jqHDJ1fJjkBN22SB9f_&dAWVJSQq_U%?r29d&sqj+fUaC(2xde=t5};esN4;D-*_
z$<mCJ=Q9;=>@$05@Xy0hW$=UomEYT?Zt`yPNJl7jfwzcSc7dg?@ayprF<0;Qp&>H4
z7#??My;)8{sF`A235Sx#Bo_63V;!BO-pViLixRd5Cm|V>nPj-PktrSQeZoj6&?re9
z60KK;{Hr^ok27BLk{~y^0Hg4ab;hr7JCOuM)e?bS(3SnVQos4f5<^j)rm!#3EXFYo
zu2DvO#eG!-%%X6+Ma`%w_EYNsX6@lp${+$Sq(p>=Oj_W^k8X&Dw)DXJ1O$xcnl)BS
zD}dZ77iXT1n)0CH4L#F&tq{PKF7wm*wG1HwEtL3PEP4uKFj5plfhrBondGk%!HsTp
zxFAH-U`GTHsBiB%q}G}P#s?w~lAtURqL(AmFZ(_aM{bDK;{0q5lOp&Puceh}jmfyS
zqHO35#7plk^~n)OI7O^fcPSOMdj6hvY*-nQbXFaRL!ovSZh3J3qRRjBTtO0?6wF0v
zf11n;*Bgrw&?gH@vCqkE4xW`ii2!Je0kRS~IXMI}nV;+L;{$G?>TaagAIyfR&8KnK
zKT(p4fERG0tB$M?(3Pn|$d!wSz-89@2|3y`<KD#b<+cSq1|Fv;Iz~nbH6^0N8vOY#
zr>!zTn2TI7Y6~q|%J2|y%}bO4$PhAZDHAAe5b(r+!|}(#n?B(hADm|%a95VY;ZD&Z
zxdX1RNs7N;GOq=PyAq~#-V3uPqq=e!?xlpH9Eixi^CI(iWK(UauR6xs?=1F!LA4qv
za)2iZtlEag#>R$*7T1-F7cL|c$;3imNF>XvC-<B#Y@yuIsK?kJ%DQkY)S;j)>Ci>w
ztV_=id8yyzEp*nq;J8hJnx$4HtT}kRPYNhtJjR17>6C6W(}D84bG*`!Y=kmc>OTKS
zV>$mRN1Y&Opi#$<6BXq|JyBR(fxgG10xEDG)!=NWD!0;~CKhaBWb|m&bI7%5I(PcZ
zvm3Tp#rl%o&N`34qpegyDt!<uDU?c4FsUpF8tPrre65iAtObQ~C8}RMHh$P8f?>{^
z;}Z29Inf<KsPq#%8xQ9f!+@kpa*^4#1m^vFq<>QQ9qEd*H6wc5mYdTJP_+j>RM1QA
zSm08^zzhv39Qtv=Q6uB_k9F`#c{<y7PcxvQy-z7beWD6>%%d>wg7E1hMx%PMLZy_K
zSMQGi6xl#!fhchOguysE5yc7*;KH{83@kVta$eVSE(0qeE{z5cG&DB$<dk4;=MiC}
zASE~yD1OW^dZw(5vH3{>Et!<M(VYqayus;M*J}#O%A>=>YNbC&spr=wg1ulhOLP@O
zQ9;mJ7}+1fM0b<tfwkif852N*!TGvADVeztNWwaVU!Q;2>Z$37I>#>Pmqx6XUe+ZO
zoqXkMfRd1iF#*c<@ewr(3kA$mnI%V46BOfgfH*tR+PXa7!S%P1Q~ot_-CGb$-CcZq
ze4p8^!A;f@U{c_ntwCf>R5_BK=OGRnFNwdGLfm>p#%4+`5A{hT$?dIWZE*8%wPLzL
zNdS*6zp?R!XW49nH^<Nr<UWme6kkDDmh*cnfraAP3FE6>Lo@)_(rI}eUIh0;@%4M=
zX5xgD=1e0LIU-+R(kL<%!#aWtSMe=m66s7DkA?SlqfY@yg;5M64@wZ;ZkB$)s#!t^
z<U;4J7-G0K|J<CRQ>D%igoZInB_<5kXMi@3SCo9Yd%qSEg39ng<AIS{uR@KENS%ew
zQ)YIDHn`(VO=UpR@IvS2-R9ks!`o_~Ug#Mci*3V&uc^v0Otrj_@v(Lq0B@dmj+aa&
zm*HU3Gi}nY!$$td{FuGY@TxO1Qn-5YYx?`gaKd-S?ng7|(1qBV<<<arHd4+8RVI9c
zmGSs#(R^DeuaXSJ$!);rhWX5}c99tyf%{NXoe$hP5ET?eigtSO;zjS_0tk7Q?(V=p
zw+I|z8%smN`Yr(=sP|(U^M72pxqR>S_%t$GXxq|zD_0%u%Ovx9oR5EQy2RKPdMXDg
ztCK}<Qh|EztHjsJydukJl!1`L!U;quSD#l>GDEux0QAF(ZNJTN+sOwU^V_hE=jEJS
zb);3pgEjhuwvpFFNf~mu1*mFo*7D7@W+M>lw#5-S6iQ$t@+x71^spB+5o8&30R6tb
zRHjV~hH5D_{1Gd={=nNh2V^ijqv+ZxV|)K(Nw)+o+(-=MIzJCTe;(SZgn)xfAFaX#
z5~}K>MH!@&Y`|imq@-kb(_TWH=J%l%>mMmN9f|yWuDaUh$3zS&t5c|IB>l|0CT&=y
z(l?X5KfsRf1<^|#3+Rf#t5-k1y}u3y{-7SP1@bI5ty=RRTj2q}%ioI=rS(;Sze5a|
zPQLI`9MkK%B^|+Gd$zC3{UF@a$7iI%cDOZUhSf9%0*TOEd5$>E#c&S1+PE^ML^Y&L
zFJGFcRb?M+((9e7%YbIpG##fKQ~lYh$f<E)<B_K@k|N#%fP;KiB$;zCu?|o~)T*5j
zV%8YW8{a3VK?QhnGM}li$x&oC-_D|#9b*hI$(MRWI)AgHE>DXaU|k%Z>MqE5pzj<O
z6zns7gtTs;?kZJ{ypP=5k0l+yYKTwWniwOElXWLM<@X@7rW0~HVH#I!w+wy#%0I0o
z*`i$XJardAiMX3}YQOPt3O%H1ZF8y5OgQmTP|D*uL208)U*QOZrdtc-u4g#@+|K1d
zyZFfb^si7Q!uhU3M}6;jWr#V4-$VJ<hNZ>K^(eAADI5x+xnGzA!{Is0cUN6t&;o<-
z?c29jHywak0Glwk{TAPu78+d2Fux^O{4K|?E+@{ms|lkC33H<(C)pJA_Va^m5OG45
zn3C2Dz=*0Pi}rvj;HO_H;(C{+?BeT{OC)&J$=ZnKpy=SlZ~XS^b<>iZZ+`TXR6e%B
zYZV2Z3g>c+r=wjdu1kzb6700Ra|V<na+wfIgy%I$U3$=(paf)a_#8HFZf>yKslc%b
z(ttk~+Jg|re?KiZ2dK?MJj{ZBJ>aRJ<N4Vv8c#oPCMleKy+(j7Vc>#GiAXY8;9e7T
zU2KTSWWG_+dyra1*H_y90@YXflKFS!ldRv-@Jxo+Yk1qr)72x+DvnH1R4iEResZZw
z(S*bW%ETB8GD~o2&cO$T&ee<@%&=UzAXtEa+gz^xRd=qJFR7P(P%Ej1QJbir{%95U
zx}y2jsJuK$O&Y`_B+o9SS`_q;$K)(^u5+v!a4wpa+`#6NS5;m*=bRTmWTUx2?wMoK
zaaFo-lRgY8eAcNEW)f`u6T?nQ-CN$8=#qXiF~#x5Y1h&{3=`PrvYsMoD21FGK0?6g
z23UxZ$$9e^q;;?yTKXGIGjKMK?ja@=^?K5a$hU*qx+F_vmdcCxMzhLrjV;sb?&zpR
z6g_kC&3Nxet5#ES`ZVU|n~1~ZK^3}&`^QW~mFA{4PgXOT+4bj$=?zmQMnVl=$x24c
z6b#|P_5Rsm4hsUz^4EO^7<F#_2gFRek&8uRTZLwAsaG0Ko(u>iJMxRGJNH-)q*eD3
z5cmef&Mg1%)7VxlI#c|4y{zz77URSCfsd&%LA0V9<qUd#9oFB_Zt-z>mmloSpO)?u
z%;LV!iT#;jD}WYxy4)&e?;i0j5;?NIq=fgqcTw_Xg9_<7Rjo@6f^oN{xMXk#gqWpI
zH4|XS2m9@@4408xVUL!gLR1MtOMg8cU6MgEGP|BTEmHgBJNfLU43X1cUxEB!;`R9h
z1NIe{W^?=E;U7&QcF=LG8@|VO&Qw?+V4W5JU8pMhWw#e1MKA)41Afg=HP})&?u+>V
z<ck9@1Wy02F|btcKHS)ui~4!adDHKZ^v4Fg7fg6GPW8j|h1rdx_h>RJw`Y5gvRzA^
zaPdFmR=gI^yQN`r*|&rMcen3u`f|>P(bP@>jh?QT>MoAkE+-y-TgFcrZf|enx#$NF
zHgKF(wbQPRJKD2Jzh}l4jn5N*H012%(%^6<>rfd5l|(W<$Z#ULOz*Zh?+5f`^A2aM
zo3PC15T%w^p2&Zo^y)oVqqU3$wkMW*yW({HMSi;4;0KtZP>E=VZ5DE5(`;5TIBLCm
z8~S?vKrhSHrhnSj_Cc#i)Ge3CA3fOJJaGvuOIyUPP7Yi~d+_M_Nd`oBr78QdipbV4
zLv-LA=Ge6IAYTPS6bZVV=oKn+!oozTeE~sBh=4{7?r=>ic~7M>)lLyG7?d2b3aDOf
z72kq8QOF^tYPbFQ#&AX(E5V1Ru?d?WN9n3Cd<`fOj`>ZAbR`#$+pLi-464S9@8f!J
zrI?(t+4f<ZI*r**w`^LPnogYW%&Xf=zC!ZAMUBIMwk;Gp5Ieng@ZmxFgvToWh*;C8
zUy^;Osn*Th`FBE_TbU6zJW{3WzUnMAm_4*zC^r((!<Sl&Y#?p8pX#y~!*3|Lat+?-
zc1?VN1jLi>C5;9?!98M=CSTO?F^U+TbxPeOFeZ;I3~Aq6#f7e7J0nF8^PGewjAB~=
zpY;9^L}p4!)vnx5jMz78Ty!Y90XwCa_iJ3GZ62#}Eqnj|G=@uLaa-MW6>0*CWfqkR
z?fNx`B&?@3L`0fd;W`(CN~{sPY`cujGt#y3;}X{OrmFLYUER<0qc1vLn^ls%0i%)g
z$uWHN%^e<x%CqfIC#^40moe`=*gja<(J>%$=IXJI&v8a&sgs!>Os-0HwxXVNo{qZ}
z=Q63n^W&$)`?I=9W)caME5i8OZ8u$ZA4=YIRu;~Dn<$q`Z3u?R9G4+CdUlo(&EEMO
zE-&{k@))!H`=&!@<$1g{8(Ja46@0*8m{D4mY999yY%UElpb1i0=`8W~Y)dC;Yh$Cs
z5Zyii65h(hIr-d{HBkG^GsDm^z73_@1{Djy&oiIGDWjSFz-Lt5zY-`ndm=e%S$3@e
z7H4H;q2VbIVzG42j&rn(vcqjsM)!Wrm+e>QE$0&l2S00JA3<Y1Ieaw``%XpaSSPhZ
z&;4+EY;w!T+N^0Gec(|1>y*G0y=nHikMoI&8WAeGOfIU}$SAIo?`PL_9yT5qou|Hy
zuQhEK3~UTq?@M<C#u?EdmEATz>Io<)7}Te~Le}?KgFkR29xF{Xj}f*REYTUgIEaZe
zG>8d$D^Ew;w5Apeoe(=)Pmj_veeKz!T)OozT2x1BPUNUn0J%~CmOMJxgoaTAT7A2a
zGS_DX%I9^>2YF!P<M-77t%0ih%QH;5uid%v=EvT{HRoucAsR0+jR+4}_VM#e1Ckst
z>Uzg-V`GbXLTi=&a=%Y>_Lm+17!MMf#l`3N*ypf&V(Xnb+<jnadHP_^j~_LM^<x)>
zt^8WDW3>^%Jj;(EG_81tm(`19%Uy@cYU)*wCZ81L_NCGI9L=<`Zhh*iZ*nQkBQaCQ
zv1Q?Lxy78|5*g2FlYz|pT?L&X_B_uqN;bs!R?&MoHH;Zo1~C93i&Oax!<4Wqf(<#H
z9SZ!q9`8NGK_U$H`n6_G3WuF)F8!;{(M?Q)OsPhuKI7o?qC8P$PJ@4@|4#fdfRV2o
z!SR83o+QEH=(R-}wX!lU0wtezN0rto1DLO<xR^$PF1B?eS5qoeA@6a~;yRCbyYQ~b
zID1ed$YjVAkE)&9$j19D-;{dZCNX_QYp)FTvhddWtN20N`wTS@B9D}OkSuXw?tN-3
zYjOJv9h&z2owV>P50BR}C|SX}i7zIA$n$)Iern0rW?&9y#O|I0d;D(m>Y(iKXSV_T
zgRbmH%LjJ$Y&!SK=im9`46{w;Ts%=0z4P8RKKUkPU_VijNS3!MgQvN9kA}v?EM&2o
z**d={plERC`9Y3AZp(M}C*Nvn6d2~&fD3xQ#oPhhON$MpOQ3WQl^YH^GjO67Xb8mW
z)=Y5kMuM{zvG5*t)QU%S>{Gt_3ylS+C_i_4_r8x>$%$lGa0X}Q6HPu=_5{#zdh@tJ
z&nJhUgC-C{&_{<Vdd+l%Nvt>|1|6ST5>cTk+sR=%Jv|O;3-dGTiI*GBZ-Cn6Exe((
zFSV1da&jI?i))*rCdNoipBz3)^0Z=q>1nxemL9ru-j|{elnWnR`2-tynTXeXhE>j?
zk@`FlmE&;DMkSai62_D_AXQW_A1if3qO=w&Ufo&ZB?Buj7X(?#c5OwqP~Yl!4>etm
zS~Xk6JkoyCkG0`6N&6a&>WGjI5Hp`s4+5>1JE+O`aN`n?WJF^)Q%%N&5&YoG9=Gh5
z4CTcsMc=;&&^Mli`V!C(v@sF1u$ySO^JhS_G>G6k7U%f5*Ic0Ip|b=f0JwOzhP1J<
zun30|Tf#QeuctmatcewNeQyyxX{HP)BOw$a07eYJy|}*irXSNBagjUbooJk(by~#M
z%d66zhjKpQxV7Bc0egt86WX}K9Xm*D2zVE&D(zI&US2146rFaYc<7k$<GFF&*fqXF
z9LxdBtq-1RuAQS!mZ}?d?<Kq9X<QsmUsmTe*q{F(-?fy_CfPy(La<F3iQD*$;5BTM
z{qMEL1nN~GVInAqwHBDy<$IW%k=Idf*qx88IV*0}Fjj}Jbly%aoz7kp{&Z-RL(ua2
zDHCtzTM=rhihlOpXDbT5s>Lg;gOmm`UA6f&-$KsDQ^GZIsQcE+t%IPF@|cb2Osnye
zdVMWcHv`1h6LUmz@FtcjVqO00Uu4>Q<@L<=3X&-NCnuJq!b0E(5JHg+7U?Ny)5w>0
zJr*mgNOOe{S5%QQYsy6Jmgm8NAnS#qaVVLjKew`?qF5}qn<?|_@CxBOuY=^kO~PCl
zn(G)jIiZMa(~^8<)GIx*Jcs>U5=dWzWbav~vKV*wBhnIMMF+EU)?eH75k5OzD5J`>
z+nl~7oPvh-z^Ug>dT2Q|+_iRf6aof7cFF?vdZ?wn8Za5%YY>Z_K9gd&92ck7OLa}`
zQCpP@*GHdtnY3Eq4Z(#vfw1r8-O+(bufoJYNwT!nz16BD5p0bzC<mr1<Y_~v`K9eT
z4-Y$t8`qf^baOzrrO1jvp#QDo6|4bzb+;aj1$g=3kBYQU=bJ+t*&GG>uygmsZ{NOw
zC0j^uU@IbI8nhnuL`*417`g(wE6P0mu2cTop?TZB({~rxdYxRCwgwx~4;!%-<{EzX
z2l)p^&*FG)ZVrsrV3{D(jQRTLq)3nRxOX~Qu4Y$$HaXx#BwFPsj&qvqx;9QcPf?D^
z&AY`JtDjhQ#)wlT2*8G$!u=6nB;Jp}BaawU5{i6zZ>}bCch~X}D^`9aCt-z32bTN#
zWNa{r(ic?=pkw#DMMtmF)>yGQSgis__4ITBU{zn6E7bY*Tl0g6c+mgXUegu-&%Gv+
zBhwCwtL!ya78YQVKr3>%F%^8EfA^HITqMjUUud+(mCgBdhdh$YrEk1yX|yCD6QwAe
zIpYrT+7NwMQf`x^uoh2=$%ot^RU#5yWO38JWSXP`wY)QI+O_GG&-SZIUD&j~QeDW{
zo#LL-$ta<F!mhCcUdJuktL3G$0DRafgzrPOH_^5>FE{?kQo-umyYunpdzeK5Qu=H_
z=h7Vr(`dMH=O~7)z{eGOs1SB4L1jKB9%~O<T$16k62Uv+1YO&(-eRh`+N(UvH3?b{
z28%E4DO&|#E9qyARAUk8B~-6o5%(ab4bne{TFRG8Jg5CiBiGj;1tGWHS$v=w+7FCZ
zD7owOJd1d(aus<#p)P#T!|JYT+4TCnTmS}ip>L7T{S^@QKb_)(+dqvY9wP&0Vu*ol
zRn0!Z<8XGg9F5pTY~98caD&ZeW^xZDxkx>}<63>u^lS3an#EoGp}#%#_E33+dVsCn
z`0I`R8$FlxBxS!>UNSM|cp5^=X}Mb+(52$+^mwZDX4ZgsOdN`}(+N+7FC0+KzU^>U
zJyP;>y62#z_7WFSZ+Yxjv?|clo_&T}A0CSlbWbkPCe3>J{ZQUxz(SNKD1iy67~a8<
zUsU7cQ?x?JG#?bo`MP<!0oBs+r`*S?DtzYE1y+I3-SryMAe}Qp(Wz;wyO8+ss5Ac~
z4K!NIo&Hr&EB&~$_EZuA13bZVg|zlLVbS<;FSO2`tc~9=$O9QdD$~AXUXGRU>SFi=
zP?O=>9Gb5!R6DtohnooWgjNi2WeWw!18B_oIhp63oe?=In+wc9=?%iD0HDFxcXt@*
zuTjeUCg3b#ck#oicD@amOgujgNM^KGFz@_4C6g(YB*p1Hj&dKriXVltRr_KyqATYe
z;HieRzZuLW!nO9fuao2n(9u&*a8jKkZ&eOR)4S_ASnPaE72=*tXPT#*9C(ICFcDJy
z68H>bpTT+R{u~gjrP~=~ShB(6&-uhIk`!9rHGli2M(lZsf~Pk)Oa{5hJuu?7SnC<o
z2g4)luSPSqy=|>JnD{=E{n-b#T;0F)C&5eH7lk;)U3C7~3unGZ241neVuL}>I%B4p
zH$M5DKBOgmYpcxJPuOqhq*CZw?3S{AjfRb~@gz9BJ{OT<NE4)zYVLp9n{7cYoKCjh
z7w0L`#RpAOkV5;|%V>55Vk*6Mier(!mEnSqit{$D!EWEMsKUjeVrdBA!3<*ldZ|vR
zM*fkRWtY`?!GW8*5mn*X2Rta+P(45=xgBl7#gv|Ybvgp<4fklQK#x)pim$hFHNWRv
z&kM$)HcZ3t4M|%u0#bLrt~I-h6FzaTUTCSY^7B+ro{NFIu5F<>y^+JGdcY9~CCTSr
zXpiV<Af_#W`by=SEthnj63XfizAbfLOdh~(kqK<j($q@OC!SeWa^ohwFURR<!-3fx
zNF2l@DX$>ef})Q~nZG-`Ub7!c0tuni?%b;LpELL3_<54&c<XX-dg3`)EQ%6)infha
zImRuwb?5YWIeN61DBv+K*WeO`5E!(Iq<<I;Y5$}zwFiiAZU1AM#YCNnahHv)lOkB4
zB`oeBnRZ0r7u<cmwg=Sh#!qV*<t>>tnqI5~VQ*0v-QG7{+4P-xxgT}b)NNllkTxMb
zNBoIsZ*yBjdT^z)?~^sjLxGv?8TsY%px$nPl})n=zFgLIEGE(XDjp|<0_h_A?pp^U
zo31A_)A0raywMTt)^y5OZs*HCrUNKEWbon7K`}X_P?0R90gbi=xM8YPuf*<b@tjDg
z@6JWxCov1c^#CU+49;Cyg>02g;Ad=(9q*%MD{MM~RlG<jRsBtgzQXR%L9<mQ^Z^L~
z?%b;UA5l7!IPMxYoMFhwSAaOcAW1q^f;)Y?V!e8`FJ%?3qJbd+CL(QQN)?!t^R-70
zRg<lk`#(l@29X}8h<oyVO#8Y#@WA?~Tx%Gu9)QcB0dqX7%ux^>Sp&TXv>Nugc8x}<
zP@gF&M~PW-Y!*mUk*xQbk8w>@69#!k4I8)~0~7$Ta2;?pB)FJ-fHQ!ErcR9YULxZO
z0yg;iUk{(u!O!6%BO|Fy;(T$8OUT$K^;tU}n6NGA1tGZM&RNnamz-lb?fn%PK#>$O
zA8ous={Wb*kB0@I)X%`GP_1A|Xb=ZpP3mJuPNe84DIAxVw0p6inMFjt^1@N$z9XHL
zph^R9Ja~FaI#<hfPV!7$W5Am1y)OqGU5}K7Hy|bG8F@o}Sa{8@J~uuPr~AHKrfNl{
z@byAGhIq^($%Jkt+@DcaMdT2FuL%W=NX;#a=9iL#m7x?t-zHJy>%G#GK%CT9vy!p(
zNX%ZSsJlEcLL>5b&LB4Z?pAl#@pbWY@vP7k!<p5r>njR3O*a@%9c^|n>^&c&pHIzX
zi8%s*^eu9uD91ehXT4quZJQSk+(kCjnqRQLI#D_P*u(vSgez0<&po2A&4_b1QNPC&
z*3{bAa2q?+Pz3T4q1fFT$!dDV5v?jXQ!(0PVoWP=3mMzDH^^dr;$m?yC?puguUgEv
zzlcTL)Q9Cjv3I;yVG4wCjSmLY+rZ0E(_K{(52g9g`qOa#?DYLg&U4wwuo&>pZ0_uo
zOETc!L&vYCrcNFrzU#Y_6v9+TWnTZ$#NokBYsez1u@XW!Dx97b*dFh>=A;A^ap-k!
zK!9&x!Gsd9<#RZvDsFo>4bZusSCuSphhV9_k1NQk^jP`ELeX)hyc|n|__mx|Yl9*g
zoJ2M>afpgCum`Bo<sO3wfyp$+Z06y!g(gkT7p@;oW*XBd#AE`i$m8H@a>Ne2e8+}G
zr{Mfcm$CD5U=K@UV!hkgz+X^-QDQ1?_sMXf(`RWLxMxs^4(v2fT3A#%&SCx$SJP$4
zdz3cVLnD7*PP;Aq`3H;`%F$wDRa{&n8{AZ?%!4IqtMfA+1w}<R4!yO$6l&}DSfmtJ
zFFv5>&(gY9=#B}VL0P?=6hWuM$udhW@<U!dzv2Z~mW-N2TIl?E*C?g;6zeHSRDzYE
zzWGPM3{XxL|1Z|wGAs(UYa7<>Hc?O!5GfTAX=!OiknU~;h7Rcl3z6>bk_H*NEkGDT
zh8O_>r5U<&;9G<D{XF-6j`w@M_s6$??!Av;=8AQ#b*}R~myCC4+J7Gy_QiicEmTh#
zg&T0&TLY&s>I;HBov%Z3QJff*Ox!E_)@~|W5$8H<Zs(r>e$9j!<nF0ZqPU?K{~Ou`
zjvp5a_v@}Ns+gg_1pGS;ol6zI1auLC%{!onlX+$bX6a3_(Vhnnf=JIX%1JT+`T!yZ
zP@x@R`$s_a^3;f&zi;Hu)b5_BtlQ4YcTmB}Fq9+pL9gg@@^^#BS<te56mD|0E7z%-
zhV1;{(zONAH&|4xnIb#(BEcn~Of&)63NOeUaAwHXWG9n0|M3A^VR<xS=L)p+N>&HE
zw*B8<81y5obs&|~-X|hQ^W8N;;c1}jChwptL{O>3Z<%a{&f-^ym98LR*$b9-pk<)w
z0*V^ci}w&etJ$bUz6`VI)k=b-kBsGpT$$JEct~}%8BMAb<1+?{L!8S~VA;vbhj4kI
zZ(K~Uo)Urw&R=@{Ofb;zOQS%G6G_io??u7DaweVnPrZ~Zkat<V&o^C07xjiD-qC#s
z4ncc%WY<J1MyhPXZx(z4^Uz7}%1W3;`M?%mi=AHwL3A!SNVl7KaO^s0jq^b9<+!wu
zReQ6y9(cJWWRc|Z{ZwIBcfwy&6<Y?D$I<A_mWpMauDND-S0%XINce*Dl$ot9rh3&!
z!6Dk0#I$2aJbSlS^e{Hsom#^D^M~8R%}5DE0Ham&tddz#@TT064pB4+h8LbOKI2B=
z%fj~Tsnj?`u6C<<rG=Wrkkph!!diqyx)U9z(GU(88uz*V3HU!wCSir5LvrT}oZC2M
zTk8afx<j-VQY(Z7+)ojd*K>GG_|24D0t$;OV#$jCsWVUN-6#9kEM9#uTsQAKi}n8@
zL`w-AQKw9~#9F~@sYq<p_-vf;5(>k+G+Y(5Sp(k3<#Ev_(Tr+wXmh>zjkWTmXFk4#
z+`fBx=$|*QlOR5JCLEB;&N2E6I+#$%!1>TjV68+g9TlkNsajb@mEU3U)w~1>;~1L)
z^nn_ehcq$gJ+mt^rtE^#@cOtJ_q4UyO|`G0+xt_8qlN6E8eT>iJbb$5%%pnH?#Ns8
zc@(Pn{$=Fw*};s6BlElm7IgTqf|uyYh?<4{d49SqRL?PCKYynyru!1m0c@7M#-Pc(
z&9}4A9z~MlSr0PtT;?~uplcOTct?O6M6HJ-b;N>pcqYQ^?;a6guatK^^S5$)Sa4-a
zmSoOB>(90-q{g4w{Ijh}xZO`hpg-wtf=R4K{>Tr80Kuq6h)}695w5&ru%P1n_&EUR
zhFSg#2oE3%qSs+S=D2zgweP@?<`|F=UH7<jwUzTD4k22;ZO5D5cPRS^PnI{Te8s;r
z{4g3!UOI>5u8fj*76V%zskR0O=lc-@XoaXmR;Qhkl^07?augfcB#JeSOQ?2PKGL5i
zQ?92Kc#Grc<H1LX=C<=n&ySoPn$1#0BdOK12J(pdh)X@*LOKm(7JjciM|Aa2wcUB5
zmOI8JBF3c|SLrSU%)cX~x=LCJYP35Io_Wf?PT5HhN?$q!p%EllUar2tN@QhajPT!T
zxZUn3pt9U%Vzb-^PD&w!lPS~zs7f>kfR%){E<>Q0J!*dCs}ZXucx)PTe>cp3`pL8K
z>gSOLhNe|^MvF{o;+aU_Q-fnKK+GI<7wHULWzezR(jtboF|tW$1bDRy7ca`5b3o^Z
z@tS_MqUigwx5=b(`;z*+SNvthE63pNk6r&`j(Y7^#It6CDNEgw9?94!OGmhMO}n&W
zagdp${RJ^E>aNA5p5|up5*=PXJnLg~y*t@;59kY!Ryf*s)1;*jeAU)2m)yy$0T%-)
zra^%ArHT8~d}7&XT6^aN<GKu!lPCkpjtu281b?MhbSq!N<_tL3AV1vZZV$PQ6$w4n
z_Bmj||2FzoiPl6O`b|g{inCPj_~8I#O3WW-goNKkQ|DA%&V~pro4~5_jOj_JsHHVb
zK5a|rm&)F)(-_=e+%@Q9oD;E5q?J(D9%?%zj0KIkIe&SUkE}(xl`e?KBM4)Jy1>XU
z$@5mufuxGQGD}B(MErj~DE6Y3o0+uO)o_tX^7qpdftaHOetVOhS5zTRJK-Ik4ikZi
z9yj|C7PUIz@(VELJM-$H`VWi?&-`!<3uo3GJ~z#txU_9WuAJFIX1gro?xuCY!%rNH
zS&Vxg6*am!9DEDs2C69dsG|}xxkCysdel9G2~|H;b4Z5}ypC%aR%wt>-A^n4!m8Ow
z3|u!+or4}ZWvB?ZVA+41l2nU`_4*DOp7zUyev$?KZWv82&D7J+8d<cwBf~Y?B%%cj
zpXg~{j#>*vj^Q(#&zF8044wdx{b+AK^sbiKm-4&Et&9)7=l{*nT+UV3(p2(q@dXo;
zX<$%W_T^H8gi7%F(`J}Dr<Ty$3M0g&stj+{0vmXhxE<u4A2hhXYpu=p2pO*??yeKt
zB(*2>n?tw--1qQs{RVIG6NbLMOo?=KgyXo3X=)+$7NO`g(6+54g1`|$Ti@*?ZO?~{
zp)hX?>sTfNCZOi<3DE!Tx--1lC#q=&GHS-o;U17bR5{LRTEsFw({b}q_?5F`SO+S@
z){7rRWU_jSv?io7>ztV0WS>3DRtZQ~Atb2QfQKVtbd|Iv<DAN4l1jskd*uU9(5z|k
zSsO4qh)wr_#im8*nD>4g6wq89@3W4|qowW7vTOqf3CgeXbY{J%BBIuiMLH9^!D=%p
zbs&xce3(by`yMCTS_T4Fs4D+JURrXFCbEr9&|!Xm!|u`9xFmqJX5YEHt=0;DxmNG9
zvk<bJ9+x_^z%;=cOuILPd7#=5itnqa^wyCK(hwq5T+C&25vU>N<bh@M8Y`<CLpZ5{
zq1wVFu*&dS^+aXG0&XO!`TC67*9+O8O>Y1$<{WxZ<#$Isr!pNO;rUb$OWtN`8x4|_
z5!I?4a5ne9!}R{pvo1y2o;LHrg}WYK8d8ARHv8j7@Id+k!}~%#Jy+L_SexPky}KSs
z=2bSGgBWl@%X{-7bwFu8)%vyjbuuy>$mLx(xS)v8HV<$T&6P;P_j!Mr-k9De`EP3n
z$Tkh0SU1#tee92CKdX}7Pa|6BT%^=KFZuX^ENMohQm$en6l85FCqL@}HKdt}k43vL
zLYyhy%1xyPS-{2qz?FR%8!FOxJ$CJdU&MzDZ99>QN)){96^sN-!am+_gluD!fIbBH
zSR4?xx11)wEfvQ7D2~e*U_S-9De~Eu{QC3eX@NXIc=_!#PYFQI+?w*g0z*ewShm&F
z7dz)J&pEU_9uz-<#2|(_{;P;$_Gu!PnH|*RX0BkNWb(5>sV4)4@&|2I$|TfK7F#5%
z;W&*#j#C1scleZGp}qf2NbWXKN;_xJ)JU>l70;s3h%LX*C_^usR}nO2$?m!fT@<3)
zUcw!bHy#%wEpLq4DnkF6U@Fu&erD786)348g-0!4gjM%}aN#CusMhKIc@#<+Zmzj?
z^2!~Bxl>_c=DrA9+gN~r0MXO0BmH`Hu)!VaR{>45gn+y^RWH8{WjAx|=X0NF(ZBy_
zQ<2?Hr<BFOz-v1W{r&2+UN*mT2R#o@Kro(@$ZPX=AZVb1Y;z0rmUdRXR1-wn)GSjx
zBX7Na4Itp$7s=o_*!pimE?pRSUxx4ZoPVkKuMnYf4j&?*=gXRGi1xpkEGJD2#N^>p
zqb2A|DWr}vH{N_y#P>KlMFRcm5i{-H?=N}8^gQ4HdI}^&cWU2NP?F`Zw?(q)=Sa}c
z7P4qPE5iBga=f~V*tRbfZi2M3;E}2ne&4ezp$4OUFOyy7kpF1Q{;z>zE-nh{Mhi^w
z>4T|P|GM?}!L0)ZPhB8bC(Rj0XD37T4ys=1k+7*7eF0Z8zpEr_um4N|4UhGx;K-QI
zD88fdm#h$uzM;MaHNe@^qqDF8@n`m~I-PWK&Qi}O1`|74T1>Cx;7pk*$W%FK;f*d5
ztjM3lzYX(+9Gl%iZQFQwMD-@??1{(;OARk*|LqXbOp(7`nI0OUuzW4Q6?YAqsUp&C
zROIuNHV3F|b76(sT`jHNVb;+LzzOQ#o!&di|FqK7@;0Q32^)Z5$$O=xyc<zr^*B`g
z@>b3K<UQ?D!?rh#Q{UQA%fnT&*)`!yorx33{1}#fx$GJ?#f0dMHDnaP!$|UdaO^~0
zsL?1{!UsG#LK^)}V)MtO_cQIJ2*CS0Sj}|;6?h)$Y#!bmU_Hzuqa6hEx3!|DM<}(c
zrjTU)#F&yJvbjD+0_Ce9U~)S=IJe(HQ<5*Cw`gBwlPq-_^ci?l0wRHAxN}0>_u}DX
z+*=2A$pWde%l3Pq_0)d-Q+4hgSDl*UqGs$K+cuGOGVhxXhq4C>LoSfC<Mr%^?Rb9F
zWqW*Nj0t5M`~JJUH?LUm@yQa_k?KlAQ{Y<Et#i*vn21`(&r@0RjkhPsL6<0hVtgu5
z>SF@IjX&UDtz*aE0REl%5AbiiqJdgJ9TZIvjita*rRas2AJH-hJ8aF2*t$T|_o2|(
z%IaDj*~<2qhfHszzJAPAGP1?VsFkE!gA;*S;P&vCt{%zG)hCnf78|fY_0kgKuI&C^
zHUuecya-BpbEC-TmdUPFhMIA_*)j&MY$31OQh4VVlC)x2%T#insCK~Hq0ON`$0X>O
z2bap1z?<<B5aX20sfEM^L=`Scn+&H>2cT^-tbvbz&*V|A%yAHXn!|;6D0xZ8`i3-8
zUF_6Z=O5K}`P%F5K_;CR*gZ}KSg`xSfe>@b>l^Gs33Jk3Sx=JlyV^~cG?7{hY<-D)
zK^eT;BZ=0K&SGY~IrfAXD8{sc1C=yXoIv2ZY~(F1Yp59xyO2j@*m?~J@n4ooBTsK-
zf#tNX6WjfjCf)}~ou3>g9UoklIrM{Kl)$+>djm4pc2dQbXfVz4O^NDCrYO_j-I0y3
z*@uL3i$1+G5tH%LuvvFpxK;P)fHTc`agDK);$Bu_n9BP*f1@E84-@hfx2n>v;D~}@
zQ|9_C1$;h-x={cOYX}W<3<h%E;3;fBRs`%^&RiTeEtPnE=I;(u20)}#%>POqf9+<h
zkN^ox?6hA)bvTaVDpFPbVd1TwL3O63-=I|JPTn6+en7^$Q=0PTt$Q2K8^zFnRVoVj
zO64yZUEr&FY@aIf$wJ|U)R(23Pg6bBPDyT*_3M2ZAT&vys?^#n5?Jes=z5>YBC*h+
z8%pzXa>=ukwl1it(r~6ghIcZN;glt-*&A>bmu>9`Sw8!YU4-r~u$~u{=ljl<8eKr#
z`eNJI#?turOF;YB=10L}2Qs^Y29Qhuxfrk;W&>fM2^v75^(nvB-KnbZ%tSk68`28x
zz^eW*Jn;@Ru5xkTw=o7jjt&KJpjxVYg}=?r#|zj0;h7pBDWs3HZ6Lx$G}gZIlLsq_
z8k1mpABML-mR_D>`f({xtsn+C^+8qJZ{TSyb)nmu?NP3Ey;g-lzl{<GJFSXoL@;QK
z`ciA1m|)U-oV$2rFI49PZJ@teDFWw#jPqHJpx6TKi%zZM0?6#)d}?Nhed2R?D>IMj
zFYZHU2Yy(sv{}469RO5fJX-k^N%uPrjDskt<he$lefbHER56CvXD8If&Eo!SgS`B|
zw*k+uibDhA;HftCg1{rc-rr9iXZf#|(xiwbHE?y#JfARdHZJ@UT5FxKe?ws_&e6#F
zd!nUFcH;H31G?YO8KqLK%V`)TI`yX^$i99^o&DMNk_0s{F^y7rXCSLcCn(zcBw_fy
zmO<$m){1}cjI`%2$8E4r>MKqiqhycW2bU949&pp6_VNPgrXl6|SR(=u<Z#DPXw==^
zUZ#n%wsG8j_pYK=ISzX4*BF#vXyl^n+2Bg>FmHc){hCht+N2hU=|mv=g~lk{mXFG}
zX)){h03iZ@^dkY$_3!!$b-*+PU)vUf0<LW_WX{NQCu<aaq&RDd{zx*P!xMA0AP^HT
zjy37l-f~+?vIUkhGNR8>wj)MtI9iHR0g+3Obdkd5Jvy@DjNX7D@eG2ZZFonB-8DNT
z4A08_v$P8I9skLB_-~$_?)Q`Lrv|3I93O}~lhZ)v@#T9jq#?dFmsVs90%^>RC09do
z_T`!?%$EVgm>Q<PR9KT{_r#f6%rDp{&>Y`S?_guv>3=Q8uwl)BU(dLeF`1c1hOyW7
zmPY(3cwaTsKMxqKDT|c`Wzh>^c$b3qOpJ^=Q*_;@0*=5F>(y&A5!ahUmpLx6(1422
zIy_Yv=R%Pbcbl8hVgf{cV5lG=Vf&kC(in{auMps=sO)LV=livTPn^1z5HJ&f6bHiR
zp1TX3f$l@Noz)HKo&nLG^ji6Bx5z2u8u!ZV66RzPYi{V}@|Stzt`UVEPC_o;?DtMO
z`#h+kPHu7vdiH}N5UH!T*zO5sQ}h+1TK|DG)5@AXkKBQafR+&~#$KX$52%y>T@~h2
z&ochiz56GL>*G~2JcSc12##N?g21ZY-{qVRLI(Rc4rXs}N85$&x^+>FJzk~}j<hx6
z2liacE--zE3-hfM3<U5b(H;6;)o0=sf!g@)VyTP?v<%*0F5~@cI?(y)Q@7qI`u}T3
z|H)$cA3OTWk5?e0a#&SJv9vYbfb6hr{#z?q$<$QGDYzeIv_l)2w5Fy-J%$Gg@AEzf
z0OwG0F(8?}3d+vZy#W{*!Y)(rHU?-vbpJO$(~=3-9jxapGP#q3S)O#8J_`Y`9J(}c
zf{Y-|!P84Gr}f!=(O4}w>#tn?T&wg<gmyZf?xe90R0AF_GG02>&!gh9)gGfBpG&{`
zFFFNJ;(yX9?(ARPPPDZzc%$L$6AX}N&Py&UO|_0!)11CEBA-45zJ5jOKX+dX<kkxC
z+PX~zi0GG{l$*l1>caeZFSrec{BJIB?<KXS8Cb)i&+|7naQIX*geo&Zf0{_FdG-sr
zZg}(i8)aPIg$i+&fRXzkw|)Yk$Q{TP-_>LsuZHiR)xgV~|AXiO-wcyRAj_at6#GLu
z>fY>l#P;`FY^C+ysX_v>6cHdQ2&};ypQ(c+kRA0C_A<^XNGnV7<#eZIXR62=q-ciE
z2;w3_Q;T#=p*8d7?Tz|vmb=4=DJiGEG9TMo;TuD7oBi;sd=`hMc8}!G<Ad-1(ajjH
zK0udqwD^HB7KeDIBCqgV*PrfE|4)zgmf&9?Vat&vXEq@(TEM)t0znr9e2^bCe<tlM
z=d5wBINLt}vSjwa`Dyi1z=d3vmsApKo%Gh?i7xgXYA^#Rl1^jEs0iv@cFco{l=XW(
z|5&`?oj6)KpNt7pKbh7vZlA#44<jXkK771@?fWNy@A%|T&4=0hNA!sRZNkcZW2c}h
z(;Z3>Is~4++W+qbge)LUjCM)G17hytHe}O*VCut@$&BY3#ng00wS@y{^FB9Grx~&h
zla9ETn`N$cv5?XROm$iZ2zkq=jwZ1t<3LvMwJ?fyI1yek?W50Ck6trISuPQbldgas
zgU{YLyR<J~%?6yOpjU(K$wYu;7NmP51QZtSe1H8}Mc+&Pe|bdWOm;y4UKXUXH~+Bd
z93kP>0wx`ps;g}-=IC-xH)!$z!7hIVm=Nq5MY|#*Q($14;Kgk{Uu(>%P;RNA&_SnB
zEc*i^cFf7Nvk;n5%6R1Pih%znclcLmW&-b6RJvUH9W&|jvyg9wqOzr~MER+3JH8SE
zM}6pD_?quEeED?W-QVND`5|I?6m-K`%6NImrrGz?@1qI_WUTVI3-M}Sui)TdZFt(j
zW0Foj*`l4o;93GlXe#Wwo?hTJ#;9c=s~Os~hZ_X3Y7|%RthA^SACe1JXG%MK(z`L7
z=H&=#4f9gy$xn4Aei`#g(R@t}m5raTTa#z}0hz(ql<T}1S%DMM+8xymH<#obG$BI=
ztrN&w1GS#q+jnxs?frno{}KLlc16xi*+hB1(Q>q&G*}Xo8g!8gD_;W?0fa#$y4HTz
z#|}UU5g%_cX2r}WTIwf2));Xm6DV8uW21zZ4&F<N8uw&B#*?<pzMJLo03rMRULHxQ
zIo>(s&qb^Y%fNT6T3GBbsag~FYieNR<9`X=nl3Q88z=U>Rlb*O-z?{7{$C3vT==aJ
zAZKX@nE=hvpYJ;+OhK=Ojjr1Mo1IBq%A>cvy?u04KAVLx$>OsJXf)GaS^?>=BLa#m
zDK%t^h^&o$@VVCLzR4j1X}smyru8wU<%$K)>7Momg)}91JC~fMX3>6#w;Kby2CFH%
zu{=YRyu@K7{d@mD#we4~fr0nXr73C>0CADzkq{8R6n()|r!Bw^P#r{L16BKy)&>gw
z6chK5{h`?#Rige%IfvBSh5?sFb6bw9rZ*(S&F|=z!0KX-i(R~m+e?s0F69PKv{dSR
z(IV=0VEeLGpZm)>@HhaL4VX%G>67)PKmG!KV}ZkXu{Rh{c!BfN2h0OsUpGI$66|1E
zKj`g)Sm8v!1lcNHE3JwI69w&(8!Fb2<}rcKfk&sZS#B(xHA78&53+9-=ucw}0_=$P
zUy!3HU4q`dN@5npjVtQlnY00nM<xwtMC218gVJ#qyJ0bjRu9)jZN=>+7O3oa&Cw52
z3N}C60XO+xDew|E_~3Qsp+{`X!fcQDs|c@wF;bWk@HL3M39f3$rF_}=46xCNXlxCq
z5!suG4Dui3u+aqrebhRr)>~B6TT~q+aphH29=N?YuAa1bb~S~K?)!Dug}|^fdYXr9
zFi^00B{YI>k_FvJ0dn*L%PWjha%H^1%`H!QY#6~lEu1h8^z+D0Vyf_2umt^jJ_^r#
zx^WIS!)C(H2DD0U<L(sS0MM@aFTOWw_0%jr<eRK9l+I|)8VWmNqsuR+-;>Bvzuzr2
z82X?%Zf{%k0$=e3(vDbQZ}l^%-{$TaRGi;&db*rK3G&y%4-rBUvqwkKeVL|r=YElM
z<r>-X_dIVKF4XFzl{nlcQ*z&;qOt<c4ucoidm$@lt5VQl_dz@yLE76plc#c4WfwpH
zlBL_5)_6Ze{^~tDh-cXDqvoE~$3>Vtl}Fk^#z%DWU<pb0hU5}IM%lhAb3lOq{Xm(p
z9`wj1<*t`bzfvr~D<3>arH=SBUjY{x<`QOuOh%og-`_M9av9=dfFCck{SSf6eM5hp
zwt0F|mC2Lhd6zu*lx&V|J+w*K?&|@yLd1tvI;(J?Xe3{a>C2KkIZuaPrM2Tm3^d5^
zp_=JzK{*T@BSQp2?eY2tw!v)HDZ1|D_0DkGf{F^KWPXyN%A)znsOQNLi_*~?;3tGE
zz#H?Gn<*7Q13tGBUOX~O;x7SK^)FurwnsC`)8w9DiUd;w;0f2qfvOGwhA7G899C`%
zRTk*BM%^A(Y@5|2!jz;&0Ov9KF5}H)w<59-&>koo!g1_NFg<}xIa=@bHjjUKN<eYk
zwh5P2&%%GT5ywN6J^VvcBX3-~2s-lb8le`IRDYbY-X@Ly2$Kn(oXQ!}#G^tos5oOn
zC~99Q&$@<Ln|<$y%c94AHHp&;3JDIjcVhXxM@dH3>2Q1ijal~gyP5QV`U+nIkC7YM
zMCHpcV7JBaVxKj<>WrN>hR<%jkGSHGG*t@0vn37X<2iPY2J46)Bw~+3CtOUf*OiKk
z-fH40l9mjlqeIA<D-DD>-}1?O#3&sT5XQZKy)Ntu;`+r1^s+`Iom95eH}vJ1)uRs2
z&Z-H|<pzi81k0sl{qENN-|Xu`V;+?rOG2hyt$Y&v-^|Wla&K>Z!4G_y7~3=4smP2z
z@~xenbc@_0Co}KYHDh;2eAsIIz2pzr!V@<=S(j;tqXUjyZi!VEgis~Q?7uqwg=#Ux
zxQ2(>*5mBp8C8T0I_u<Cip}U1-mxQ_mI+Ha`P9QFz84TvXK@!L<HNjN4w_uL1=qvM
zQP&oUksLM&SiXI`=;=OOx5M)2;v^<k-@=xrNc*{)0)jq+qBYn<{Kl9^Noe%0KR}12
z^*tQZG~PQik1(Kq$y3gL#XJYSOCi%(k`Wrq8j<PMCP&6;{#9c6*_&+Vf7!B%dQNY|
z95r$q%cs{O#hXbQt@V2`WTB%r>X&e0d#HlR3XU`6p+TMP4QFo=i%RDDW-6X|L9ep1
z_17oH9R~N4NvG^3osYiauowh(G-qr6+G6+?$7>yFnmO~vpFtCU_xcmJVGCC|y9KkB
z?{9VTIzZs14F)G|hx4e_2@2MR@(lV3!z*6J)|*%&HHG~=)@`9)G>^Ww+tjyj-^2sE
zuKl&Wpru~xDC_8WNaG_|_JBhJqZ{d6d@vO&Fh>Sf2wkViq8x)d*Ywn*eCV(n^S{6N
zV<-0uN}PK}kUHv6$@rH?F_Jj^`e<6)W2cssm|ey(^Fg-;ed$J@YAktMVuoJ=eTc}B
z=c^!<8~qFzE0XR5S()iAB#JdWeQk8G#CZ?5-M_VKS0hYEE3sACt!!nb0rpA38rYa5
zZ9k)yEQ2qrUx|wr*vgS*CiWKc%uSX*+6Bp3M67<SD5<LMB|h+URS@c9J~FN$Eb3qY
zK6&wzV5Y`H_mF5if<{r_3zC`jZ0JV&DNUvcMshXI?<$TpVkR-nZW_~fZaoX)lN4_}
z+2@PM0Lv0MgFO41!ZxmEhzi0^l}XkrsqHZtR--O|44r*V$|-Lemdb*%iA}u^q9%1W
z_{;rThXGy3pFN}Hn<^SaHwsnrl5kfa^De(jT=wCeDD^Cn(z+#=@N=(U!_K0dMQ0$k
zg##h|!?YjcQRTLN(LDD2;@DAl@;D)tbkrsAsvqBy!1BLOnGyv0mHeK84{pl+A_D_~
zQ2ap2kz^IGjb~txgxB*8dU@+G+s56(rL95J2_bSP>D{kxRtWL!R_&!wH>55<$vV}a
z6WF#iru)V?o>oBPPUUPyWx-&0#Z3P!GHt$3eA&yK^oo;l?nZbD+Mq$P<>mytggl5k
zr=MTDaN@hE(W@%5bLyWIdI)||hCN2^(=Szb8fEVBHk!){l%?gWY=4nQOSmVn@lHJW
z#AQ7+pAu9SwnbbR0g%6pM}IzvBWkkkln}Y;nZ=xyJ2ajv$e9Hdy(N$QJYFl;fgwc<
z-9-xL={uWnd#5lmtPHkIHXrAIFpnXc14vMVZ13H6r{vK;Dy@k}B1VuIwU-|aB<_~e
zQ}N1}BD$U>^JCs;TXRWdC{Us(Ha0O1`aU@Ge*5haCwbEYGL7wK&ZA!CWo<FBHyE7*
zzLv15J+92IQvK(Tq(&lC<`t8rLW38vu0{LYktz;`yLw+@7LCiJ?aGAbpg>Ab79cAi
zEjyTacYK;gJ=goU%GR;c3|hDM+YnCiQQor&D7p*G5}|i1Y*W1p^ruQ&m!d=CGDAzQ
zzJiFAa@(awuJ%aZp4>sco;4h`Nx8CbR;rgg(mG%F)VIT#+o&ZmC5Y|0gvSY`{a4gN
zLxeP=Du-%LkK%trB{o=B<0kRb^QewIbjm}novZ}s>vOPLQ`_gXx54X}S+d>LUfo+U
zv*2Fio(1e#Q=H$`*1obN)4|e~uh*haW9rVUZCm%;ZouviS(>J(GCELDB^y-wY!)1T
zZ8-9#QFxNB7h129LyAUvdDLeX&K_!_aO?^(GC78gwBDc3Q%%wh;t~Td$L>x9`bt^X
zwvtFT*(=dCc8n0%EYzp{mRV11;w#y_zpLRLLu!uk%4({Y*0&4^17?B*2&xp`|5`l#
zN^M1D<F5y2C&LyF{r6iEo+;rdFsUnVwB-8CAF$(ubJ4w?HRP@5-?!2<DR?jbtjW$y
zWQDofi}5);`9L-8^&Ab|PYD%rE}@?gS%zFoOhS*pw^&c5UxMT%45<sBIzA>adUmkx
z67@k6m+;2-ky^SsL^F6A=XpepIB6tX52M+d?oXJ^6?X7#IH?8j+gXv3lQURO%=X;r
z|KzpWu_nM$5yU&<7|r*M@^Q?3Z&0D;oJxim`|<hctl7QDxovqjXZq_}-P@uvlt^nx
zQHgp{gk$4+mv%lKYAy8mY<O=Cx_V@KvS!)!<sOys=J$58HSWai^-o<*mJ!}HF0Xyq
z8mZ(m2q?K%?*Do?eEXd%p8q}<8fdG{%f3x0mpJOZ^6Q2K?|+7ovcl}j4md7YQiJ7W
z;~yVVIA&|-S$kQqCcn1Ma%s1e|LkxmP`@;(fphH<SgJ0y8dNs$WLLR?xSDU*9)+32
zxQx0f;qpc7>?gxSe1yrfq-)mZ0{t2C)ieKn4niSx2RV(4Bz=FRA2HHYbFNJtO;|X>
z?mRi9t~V2to5Rb)$)UO@sW4|70$Az03-~>Ea{u~Rt0xxrdVboXS=&h9Z_kQx>#C7o
zrMOs6kG|-?L8YYJH0o}-=fwE>44+3rPAzh{x8S{;t%etj=VWLC;gS%lRI3pc5JGJ6
z`0WFQOQuzYW{96z@^bRuWQ+B2=@V);F<ooye*D<4rOYP#Tb=waHhhL+C3>bJ1E@cn
z$z8=k;-DB~bRUxwP#Bq$YNL|VRT0f(;MgNh<{E?+4=H>cUwi<j>O`%UWfdm&#`4TG
z^AfH4hou|?p|z=tel(31yZ7)fNQ1mmv=5~M$|1@}m$ip)`m4Y3pkQBbpL7hfO;dZP
z#`#b4S9i%RDm6zd|GW+InE9(Uy4}-1m|d1Lo1ID2hocu#vT$!Hil3LCy<FjPU2vyH
zt)K-wb{-W42zeyABsi^yRPP?Ta8jd&-8pqs`+Re-w>~j8jtaCL;!^Yf8U-@OBxa;e
zBqq3CI{E@O-;1ghcDKykZ2UD550Yc4i;*T9QXiBVJoUtIzx9fS>)jgOy*r1yC=PMD
zao=X$SieZXYmZ`W{abhg%m3^Co`2x8q*=N=5$Y^=W3w~S)|*N|@i00yTYRXq3pTjp
z_$8R(`kyaBaiS?xjC+~*$8KQI?%(JhR5*k7_h-PCM$dX~aw#~~Ea#=j^p(#omX_*K
z0WUfXs{*!ZbDYNC9JE3@`TdaN>5u)%ZR<?er#Dn$Ldwk@Vq1r6U^)?*%k1~Uhc7o&
zhEsxC83z4owfIr3l-SwCw1n5HNHxKAP8RN}5Q_HrRsJ&$UWc2QGfu=cjB1P<i^DL{
z<s`JEwy$RsFwqY@tFkE)8kPTSV%e$5$4(y;x|um~??^MAleR$I1g&&vhu`NOx!u;O
zt5cFNA396=uPq&yJ;qzEdbdR$caoxpdFBp1+7KOc?s~Ul=LadllG&^LNAYKix&$GQ
zcje%6+1o??aKXb5`n6;BD5te~Dwm)4M27z(d|NlfvoNlC&GYRe1>wpD4A~$&B2yvR
zmG)l3l$2$L8fn{1L*+Yl<;oQxiN)%@t!1?P^y;_z^rkP;{pi5K`qQf(-Z9ULlmHxY
z&XR>rsUe@%Vlc(nRoL>8IE<3|Mn$q_OKHr$5j8xE<nv#B9;Cmnzf<SqfVVcfQ}tQt
z-ieQq46Yt8pOPG0YdFz$lJCw75xWwK5!QU433p=tL~e2aa@2S2i6nZAXS3a_JhyfC
zl(KHc0`PCv*IUj=Er;pJd*lsEBQ%a1$NReb@l<eDw#%|l*SW+z0}-6h()L{MryiR>
zyE@ma(>G^ca=N~5DWCSWdeIG2!U!19*<P%-ylwnp>{)jwT1$9Zk^UDlgR!!PjVZr|
zTj7<!xYNbyy#-j2axQcG0`Ji{3<V1|3B|9<+v>45#}l$;RYacb5KoM1-RogTiTDxG
z=f`qcI{RfFOxRPoCubzCg`()%^Ku0)wM$4<?fl>Dq5JkoY?fZ5G3DaPuca<KTf@5+
zM6=b7=uUz0>HV=zS7zJ!PAjFF?a__-14HZ3=FQE~yj(xR7zUNwEY_K|1WQMUyxl#m
z>@2bCh15S`ykyou(Q=g2y;c$Q11IcFg%%-gn4q}OR?VooUF9<#LM^9k`(`7yg_H$b
z;4GolgFD`|SeY41oW~`4$FSJHS9r<r?I(LWO5m#q#{c8S{k22vGLo{}b1EUXJp-2@
zzN^)LjexKo4DZ-BZnU1iyP1`%V^h=BV?EVgiq?k=ro22jA2Iu#8hx7$!xE9|BVUcp
z&rd1CU(DT4XW3*>*|F*{r!~^XQB2Rd_d~ivaGpowl&Y2z(7s5}JJ<rfg<$n3&8wdY
zWKd}a-crvmB4?KBdSyblIJ5p0iM3)#6q5N>1cz%JN^PQ2WugOCuQzjw^eQ{(q&+Op
zJU8<W!yY%kjx8vVLeZxN4Y26TkcIqRNeB)6Z$?(<)p;;Mv@bjTr;Kp3aZ@z@^)(j4
zFcxs3G}=eE_;HDfqY7M6F+LdLqun;CU15=?qk8_6o$WJJ>;G5m?eA5n3f}@=5dYAr
zcQr1GN3FMg4n4PK<ZAybufktU^_FdiL1cE8S91UnKCO}$f3H)lyVnS0O6Ro_+}a}u
zxw>6t{7C>eB^RQnJLmJB3{FUZy@|)754Gq02KQ~;cA%qAE4{oPCYO~zNnl%6u1`tb
z(Wh|gFs^k9?WT9sc$`n2Jm|!?b;ESe{~t1>kB48A>zzDb2DKY@%y(J@dDs8WVqGga
zD6|Mrsg%EOFwPW0EZcMtp$NMQ@qJ%wnwUPqwyEJQ{kn}2V-v12A4-OlAd~@*ZAz(^
z#{tMdREu@zm`Vz72fK{nx|?q=c~A=_sHTf*g+ejhWHoqi?lKIjv7d_flSmP)Vc@B>
zZ1hy3p2%9Pi6ZHj>u0S_%bKXqch^SC@#-OLqc*o@QY{x*HnAgjMn<6swy`U7j0xrI
zV^^R|RI>EwN~-EF8S~_<vgp5HfvaX?qUJ*uLrarmqf5Xt&yrj9@X({IF~1FSy<-zH
z`snPb#VUj68~!0(CAQyVAr*ge&&$v-pxt@?`lNm5WM7h|@IYt?W-T<@O<lWZiiUUo
z`x?7A?-Wg}jPdmLm<D8nlOJDpcRXTTpCKxX)x3k&k^{QmQE#xt-A>U)4BZ-MpH*qS
zb>vc0Y+(@R4vg0+!$fz+^={URv0}>jcu*twWZbvg8G$%BBJoO<6=}1#)*Rg;TqDf)
z+V(kgC_R*S_>bpV1=#21NFVV6&@vUMw>9?fx-UDrZ<x)uJ)jQrK?o&MQL4D`br)#(
z-1F*N{qp8K&S`%WW56mQfo2u?u`eKOhl<Ui$$p2<Hrlw0y~k85GGOo1F=0Q~;qq1C
zI9z{#JPWSA{oxk~*AJ7mR~6Ma=zfXVVHV>JjAZ?C4}%wL+;r);F%0=}^l^6;sIQZg
z14r^xiV#gIm-$DJ<xM4xi@Hu~{g3^wE|%!kyBdFbWtt+G1Hp8De|dY=I7#VJVNQoX
zKd*Mx(kAVbjR^AV{N)m;n9bn|%l!RZm0-|VgN)pJxKfT$otd82XQ@U)kWX7((DOm5
zc7=3G(E1B_SVKc;fHq8_ATn~7pWjDJ>?_PBTSx}~c97SEZ!IPUQ;%p&YYBOlLg610
z*$iP~o)Q~JAJX~lN0vgKGCRzIi0x-$!nRP9s0J^g0wNSdsC04_PtGaUtcf>xR0Rev
zGSV^|G<NK5((KZ_t`SD)DBEhmGrqsI=!n~ljb+i1P6h+B%^aVdXL-??^NK>0Hore#
z*&@>}#>f&vfeuf6!NL0eazQ^yDYedSYbSrXr!4-Bx33a2NpZ(M3a#?kn2TbiqMiGm
zK6sX<zTT|o+wU(PhchB%9vsE2$XMULXtlNY=;m;#<sWv_8OkLxSw@81I?T4iS<%VM
z*(laJu^R}>QeJ*Tc?{-ijTS!V!vGwmR&Av*<}F~bbr(ri#_KK@WBFwbo|VIWagaGj
zIPao+ga3_285Q&P-ySPnE4?AO!{^q&-Ys%lCr#{bew|k1m_Tw#V}OdKratJib3)SH
zwYT!>;%7j?kY{-*GvoGRrdq7Hdywfizpx!BYjz>Q4BIprD|*l#pza(}@snn~T8rNy
zdFTA`gL3faLFsaMaN+ccT+aK{?E#HR6RFh(N41UzF?KkOCYGc2ZWBM|iOs)zKl{@5
z(J@OyzLCsdvErWm)n$xjcBD=(@@`e7^{_Fv?-3Y<yDv9vMCMHI8g2_U?J+Jb)y;$3
z(=7QtE#wY`tzf1AC4W?I%B?Kb0`<A|Zu+=xa%5Lg;l05sTk$dzm)Y|SV7lEKTQ_Gl
zDwyfMDYH0&9cVaAw4LU!)nYw9EUrR!3z8OCtd4Diez2fHV{R*ToyI_1ZMb%2dqBh`
z3gLXMvf30iyJnJT6=l*r{22+Q((yUMUFyGXJP4MVO{U$*p3MFH7^sr8`DzIfZm4J`
z>rsQQsf4yqe5<wIj-JszcaXt(SFmfLiB4v_aT!p_O&R)k7;CLmPlQlx{)qbPbVjOc
zM)X8qjVJv#fsFmxv-xg%x2YU*2MyhZ@2cr~v*jT(CT<`kI_CDYZ=;&sd0I_sylDoD
z7e+iA2=rqmTPdM5n5owT=RrY!&|5p#|CGg_hXxnL$gLzVUM1dT$rwB?i9ZP(E=vMH
zEX9=M>+are^%*GjY;xJkRo3l&UzPZp*;b`Wx1%h}X<i^3S2=9+f%op6ASE1C-6@gO
z2UKN+W;Me2SYlM8$zL-6RRbSPCMl1m@lz4Lxe?$W8!v6ze<XiV03*VoEKm;~hME*d
zZKm}EN8~Qz!s0Nv4pCJYAi9o^#d<Ow>FO=L`Np#tgKj=A_dq_bvt_np0Z?$uC2&1N
zx~&I+s%(bTI^>&RiJpMew6wwa1d|r)NR8=m<%4)J3#^5MqBCtEZCOGTSF_+qd{Hio
z^yq_;HNYk@MTu5T<@a(1elH9@HlDx1yF}s;hQh-z5oLB|gxx}XjbeU;bnWe`G#Sl-
z64Zj#Eel}sS;^LvM77XeQL?kAU%S@M2*@JWzA3qgOw`0Y->(mPrv;{+E8I8z!o$Nu
z=1036e%904G#-rvL4h}*yl>}b&|$;>$bA{f-Tf#SWmIHEwLaO0wi7+;CUx)V_;tSQ
zfxjlR`MUprU8(npw_#miVq{aBe$3I8Q7;A2zhqK{sV<N(ez4X_;(K?wWOcK_5vDfx
zWcV7m=QZqJ6-5Ts=mDlT=SvpTcy#!7OXB>YOhi$^l;qM|V*YP38(XsYY~VRQ8(1mH
zF0lVJOz?NXubkP_&k4WXayK<k={%1U-2O@1Exf<7HkH|kb3TMEneK4gPq55ytF`#C
zV$yo_-eoK@j8fLh3S-`@&pUj+6uI7TM~F#{5%>ca9PYe%Fm6%@`VNaaXE}u=Ngjig
zna5h}LC5*Xbi6d4E%L?{e(?(*7QJYKQT>~mr$xlsUN}4?>=BSzx00Wo*&4Q--OQ}8
z(i*E*OW03&GifEC^3#~-sv%;=!yLjc9+cucBid0tSbUg#TAZXk;Mp}i;?3TzinpP@
z^A-P^9azq(Sp1)UAB=V3<8vDV78<~7gFk*0gORPYl$Mz@N?k$p9G}Q<5C6YutuziJ
zqqq?L`F3z35?%u`j$gmedjP4QyESP*5+Zu?L=;Kc$JA;#@$e`6j(^^tZ0n5-em@n}
zJO1(+KeojVQzXEL#Xo8GRo374uAO+O#ZGYGFN1%4MMYWgn8#<pN-v8_R=)uV{sf|#
zd4--8{~yntuXqk;<@}$z>i5<EKmM@0snqcw{`0F&ZERVk)Zr&sNlN1JfBYYho3T0m
zKhB*G$N%*gqbZ#ZvB%#g4_}t26~>)j|A`-C2*3T-RakqX@55zoOZX8|w{HD=apcqk
z3U6pVLM9j^+885Aa$K@Oa`|zWEbFn`FTu1zN&G>Oxd(IT?lGBAAn*>qZxU`&wV#?f
zi4e!HsjjHj75qXC<Nu!%H~apcQ>1=CbdL$YroXSYgN<B!z+k1%(c$8775&}2tf0jb
z7WN)0HwTx~6#T@uNou~^(G$vi{Lx0Le9F-iYJ3(>)ZhNPC6$_X{Bx_{AaBDtQBv=y
z?Ca}`ii(<?G}e-UQXn8OFp<Z42ya$!bNkzsJj&Sio;=FT_V9ell6Iwn^@pVAr2gwD
z!?*j`M2cv(5^!DlwFG88*26LISz%!x%z83*c6P|&Qywmb(<<|^MrW$<J&C4O<I|7M
zRG)dtd^w_nGx~U0A@TYfE(H7_=be>jT5Jpq49Hgz5fR36kOMjj!$*X9OukbMk(ruR
z4N;nsR149V%I$Z%N$}>5*DJK=3*zI0#25uLCE-{u{wOud%gY19S2-!E!Aff#dwY9B
z!||N|?VJ3Mb&ZLMfp7A=uTND=pbp$7;d2_j_SOHl6^SA_e;i!!TZvx|aM0J*9s<)g
zLKs56^6L|<F>Zf*`4oJHeJEvkyIme-ayxrIWnTMgK4k?zk@3qgF|Ba?k&lJdfD3dy
zwQur9djS4y9&gqQ*f9K8z$mKYcknaapC5b@|1WFaB5%VgTxCrMi^H@((}KQn|Km&H
z&)A8F#p(YzdvLbk3tjrhnLD0=7G^1$QwWKa7q-7{u3>vG?)7IT007!wNy1noQ$o5&
z((i0V=;iOQ>FqTR%8POWvF1L-dAs-*+ke?Kw*EQTe?DApHj0FTJD<fzJA{VDlJG)_
zCxEwFVS#Lo-$!?RjxeQO`zA~pA>8|>@%W<C68Pi@!hk>znKLXpJnfX%7U~b|>Ep}g
zTSGeiF1oSuxg`v)AKZzmN(D>XG1rOcQ)dM8bRb4<jCy!k3=~q6kT8_#HG0Ma6sx43
zwmY<7@;xnQa#6GCkk;Y5oBR&zM5)m{n5xn%P@556co5PZC>AqbP%_?;GQ-JNcNbF_
zf6vHcwYjz95kEA=VuTI6`G(u)^7aGt*Wvx<^pgh8(d~6+Du6WaQWOo|df_@kQ0<?%
z%#Od5e}a1TX%Rf=gJ0VhVPyP>W+*}?6=X`9%U0S2mh0~kppgi#ku{6~MMmbjOlHaY
zkT=p}yA>O{L?u9)_&AZbg#LBc5#l+lFWJ4zMGEJB2;m$l%8uM5zuAbuB&$5tJl#Oj
zO+<EHOkZDrg{1+lgHFDx>_khI<mB01HShZdDI;&bxu4rccut0UTmTC6L@27`(aEov
z89GMBwbw-YJo~9tlM4y5vPrq5*dL{v(~50di>te9;(AbJ%O?+6O>Oiwv@}iwMc>pp
ztRrsqJ@)xrHc4mt%jTa1)j^3)`0$jrr3=aJ@vmH8rbGq&j|}&0>>ywi2YN6-&QV^E
zIU>+)qvtM?xujt$%0@~)<t_^(4fqEJhocwv&ZW=fF(QmmE!32Md$>0*?VzX#YQ~Ed
zVm^m8Ti?Q+;8({BY$v1GN(#G(zLiYNyh;cg@g}6)DTGSN39IXIuyba_wOhyuVFT3_
zj9HFf{N0z=2?r~gcbRHLLVdxZTWIYY?e<Roch}CIOesJ}>1rCOKYNik;hepptcp|+
zeoA=ZW=J<Gges6;?uKHe6@z(@Kf~Vk*c^A|da8p~r2bgl>$8||(viLpXlr+`N<o_5
z{+)zL_(PX9b}4h99$h#{WpXzD2-<2T{DM1AY0DlzWrrIvzUC1GxA)=l2p(Uu`J@0(
zK7QR!+?+hEt1f%+On-BG_{pZNl|pA}^1x!et#cQLot<slSagMjo;BfxI$b+)ME9V^
zW$%?wD75_`A~r6$Om?g>d9uP~R0~D9fnqzK@?xpXWr-XTyZDW04fRr9R;{&SevuF0
zHos2yNDfX8bT{-1HN&BYo-^L~?280P!Bl&+yv(rK7DkCz35;J}@!i{q<c)!8Dons^
zd|$#Y6zhts4}t>IOCLr77&YGcIx*j%LRSk0(ur(Zjh;~#Yqv*-J05)s)LzejHNQ!*
zQ-Mi|ctobFsC-Bz_~7i)_X5ME(?7pXZC{7L_=5k<%D)0zlF!R%l2)4=#6oFOsz)vC
zCA<afd#i6FYri$Em6czkbX|@rBJPOYfob<tlgsUR9JG9S6u0`}nUH{^qz}iyi<1h6
z%RcKJn0#Ps=?OgsdtT?^s#Y4I1TJ&*3IEz*{ii}rJBB7>jdMbXmVv@}GkH~{-Gu7q
z&#$8my{*nW&kc=@_aY~^mXB1o-NyaZ(Q7MTf}LcP(bwX~r#m?dgU&8rq8fVKvU0E<
z>bYN3cFzNvoRbx74Sl0MHi($jj{OB3AgtlE9x!1>RA{CHLpy%Jmh44{Fbk!&UJR9m
zk&hL!wbsLTw_-il+RU81AI3=H7>%AY_k@bDMz)+LcsopiQ;?a;Nfjm+sx5Kv$U0!s
z@oi8y9rHdYQE1~G>xkZ@P0sEHe!-n}^R2dUrw7pNrOpJuf1Pd_qfKmVf>H18Z04iI
zA?|1!jGjyU&;yN<L&ZyLO~nh3J7btJLD9(yeyNke2vwS4=G226o;j!_;$J(~d+URG
zo<11S9(8|zf2>&bz~}bQpw^>=pGd@$Chz2a-eI33f$l?5k!3w7h-CH&*aWe017kk6
zjeA%N2oh~M-AOS*jni7w5__oaq6R3Y=_NCFSHXcei>qC%Kfz~f&~M5hzBaR~0qU0w
zae^@?4Jx(MvXa-0Xt3VP6DDkF<Cb%(dpkdf`0<hCSKGDvhKJ7yyz#7y<BM^N?FG_s
zoM>HDu5|QG7fyqavfLsp;DDJW9~n1dNqYRCXuyL~pmVrq`K7E|IEl?5ihg4HC6-8G
zcN4e0|3Kek@>^}Cb?@>6`aYH&2(;S^yVb4L5#3(h6Ro_CuxXpjs<|()BF{c+#r~3{
zak3c^t|T+??4Z;MzM&yGF>KqErn9joorz1g1aANS?#$o&mN1C>)?%3{Q7Lc!#p^3s
z7jHcHP}g90c<>CG=c_-|hk|+a=UmehvsD}(xH}p&1a1EWZUR^d)|OwS80bBW05fVg
ztL7|=e#W+vRB!%)QPZ836!edLwNoCMN9JuYFb`H|^SN|gx5!bB`=Ym(@XAA4ZpjiF
zg+224M_a;tNJ2y<6JSN0D|mE}Eh_rGK1@vNW0#Lk_1+V6`Y=CS6?p^eqZgk_yKUKm
z%b`W#x1a2SN5e{23Y=A$DpHoDe&|4Z>-SMT0v#yAw!^*-`O^!305AzKw`B|;2Py3K
ztob&-;hJ0;i;LAYtVA~ZL{4)$U=L^9zJ<+XWjoBoZ1uDcso)UFvn{rb@f0K^c}r&b
z0|$GXbFtk4B~2+tK5l-5oyMsVQC#A}a~wq?hda6zbz}S0V+1<}{3H&^u8?$`crldj
zdYs^%IMLMv8LdXsQCvO)_Em;ZK2p<C*L2<2Te;RT=s>T=X`Xp=9#6O#v~n3y!`Hh^
z6M`lAYGUHzHe=K!25~W!rQWy%^yr7*oml?3F>jsC&jg|QBC3lTYc<OZDjJw`je8cc
z(5TiT*O>WMGKGr8SJ+qwY@dl5Nf_DED6X^|B)SX0Dd29s>ri~*1ibcuZn`1l14vm8
z&@zj}#PnUMBC^Srm8oVi>;+erew1qRV!3SfyB)T?wz8UnvQ+b~d##2QGU3Vs{%~=C
z*rHaT?z-F{%(0FQRy0y<rtlz#lQl!emZBe^vVPP`lPY2S-4v_V$9RKlwooEuH$JA`
z5?W2SAA=7OXmdo=GKTA1c7w=m^W&>R(;vM~IK<>cE2&3KscBqkyFN*mQie+6t03$j
zA**w47&{c@J_LUtH;zhUw;H$5PJkv6m%im@b+7yunlf!`^kV8$6q%PM>QAK|iI_^T
zJDPhQSzj8&!D#L?Uo-=3u6o=S0btIPIoBpP*Kc#)W#O0+Ijrs&<wPyEchY}`4$YV)
zQoX2vt)YAzI-H2k?j*h)XjjM>Ee>IFg%8IB;x8$*;A}S^^vkrzu&6<2U+Z@xo>!v)
z5QcX&n~>03y}Fpm?$qwcPx>PGLLDDacq6pekr~Dpu{=2r)AdDlpv0u*;8<&;r%~i}
zj20ho7`I=Z@Ma5}Lg&RTzk>|;?-RLR!G3=-;$H_S8?Ds>gV;Qe)S(iUa)}|C#vWbh
zmak9gmpRNBDzuzt2N+G61<PL#{TlhI+@E%>!RXPFF%fQ*hQ6DqwoT)%MeE4oQY{mX
za>=p;r_yLYrXn|@bh&mmgCI+3%;Y&Vb=Kw=t1!=hJ}7<mC6UTVMm}Y_t$K3md%9SE
zMvR88w;N(Vc(b_a&>r4tiRM<K=osZ}!-dH2d77n37jc`I=vu_euMGlsN{k5KxXIiG
zWqW&1S<#;)CqK(>Tx<=$$wQCl2VC;YCLwW&HYiXlm~>rK(@=}vLZF_^kskHBZ}zit
z<hrijHt^b1c-D4hd%m|L?a`cqx@GS)E1p8}K|a}%N+!ST`R{k1eF^g2@DUrlGF%)L
zd6k0Ry_1yFv$oxCD(>hG-{+n<?ETH*_LN+}*=ngRH;HekjAFBq>$@>zttX_!9;v#8
z(?wgm4p&ykbDpg-QyPm@QXcy7yHKF8cCh%TCq80yC%}B^&DDt`-GiJ9lS)eAwLKUQ
zQ$*jdeo61$sZ{<{#_vOH7@i#1e!wj}*2+8!H@?d!Yk#|rXUCP#Tcmo9wFl(|-sn$=
zT{hm;YAg^kZ9<_l7?YRl*E23EYw&6h4&q~magAe4mD4yAzT`=f#UmS4zjDYv!n`f`
z=kgk`;V7%ztRR!%4K_C=z2;;?J*@xd01%UH$Iwq)CEuK<@$u9zH+yC-C7m!nJJ_)Q
zntGVF9WqGSXjW)MPtNA0L}!;wI>5#Yad5!Izq0lWpo2%-01IqtCQ~93cnC{Qgj7al
z9Lt9;kb=#UR@8$B>i%4g!a@m)PGwa2Fb(zee8{T^=-jPb-yWQY)~bc0Ac0&fv|r;L
zc2bXYt(tBtN<@>xYlJCqQNdrCecx#m89r8FiN~=azC=QfRXAUc%G`T1w5<oS^U!)J
z2pm0#b^ckRzzI#2Na5pp$KIIgaBDdK-Me=OyX#Z}m7|oejpqlnGz|1QBhw$goCR>I
zibyS1K`l@D(<<XXZ~QlPNP5-C%?Fs-wrRT5`(~Qug#{YiD<V6GM>{*6r>2R2n+V1%
zbAtldsr4MxL%Ak825t-U4Uyk?U(|9rK;upo)s-Bmw%V=Vxw)6T?32Q4ov>7jQ}BiI
z1vN9jJ42(S;2<k2xSsSG-;j<}nNYH9g#MoTbR-9j*G5O95wx#_;-lrwH;jc(_2Wic
zarz%&jaq=ci7zPru$gpLdVv9Vyu;_*23eRIOHDLkhd1d3pQ#f&-H^vJdS&J8+LwUG
z*6RZ$*wFY^n_wE6`L<l9I3cwwk|O#t$=sD13#xt1T+o(i_v$7R@$8SZGnb!gCmYPP
znKN(lNp3VxNiEfi&ncq;`(_(E=92c&22?gXzH{mKCU1YbVME!&Lm`?@W_0tqi_O6r
zYVb6{`_x`Ae77E+9JWnXsCN9*mz#rhkN)w?zk1e&07q}M9g`pPs`@yZBbQj0^(E}q
zoGI2x)oVOLrX8|AS(ye)UjniX?PqHuXG-Q(*0#qI;dKFyQy}shk}sM`L%X)Ey^jiZ
z8UNz!{dDYA3&9LI0Ne@bnOd^iVMVM+|CCCR&e)tQ5F|H`dv8VL+o>T7cRgcQH|ALK
z%_e6u9>yxA#)7X>Ym2iNHg5wRWko-aNp(ujn6jx;_WG0ctyPY8kdipXKTQ`sy|Kve
z)!@R2<yV@^^!8f$w2>1(v@C2v-fPd<?XkriDa_6;-Y+xxg=zlxOe%4o{Ii~naCEgr
z|AXCKUovVnuf7Bg-)ByUba%;oD-wA4!t{dj9rGEVihjP%B;Y}_?Q!xCT|xo>=Ktxn
z|DzT{R29wwm1&q>FubVX4``r@^^43iRRLYx=LN00EpF=J-Y!+}E=d%q%?mVNz(4N0
zI}_V(9P*@aqatbdxN5ORUFm#0Qjo;Cb~T<%GjdZSWxmcD%=`1XZ-Wv^gGm>qm945j
zbiH2V$%_*EGpP#I0BxsS?CII1Qu$Y#H4k#Oi&Q)vGn>j0kgZ9jDu@VKQd}1n#O)ey
zoh8@y&dHvJrdYys8guI}C$E;~2DNPI)8<WwdniPtVueEYAg@)qy&+Y8AUD*b7Cz~i
zj^urL;6=_XP~6E!<&3&ckW0XTFsv!Q!J)&sBtrF)jxtthq+|URf%FiK7nvqyDp@>}
zLJNyN)yPjP4IAMr(7JHbu{8+{7>e60BVic>YD>aP=m55L`}-456*X-R%u{($;x`Kh
z2z`oF3YU`^j*CFvhmH>PEMvEzJ0rax#Zc1LUG>vmuhdZ7QAnX^ce%;H7(t3h{+MlZ
zYkO7?cE2zWU()NZh+EngUV`E^ri)|1KNbJv{y)6Eby${p_b<w*7$AtGAZ5^{gmjBE
zC@F0a($WnI2GZT#jdX*ENO!k%gLK1Q4>;q@JMVAreVucz!yjJrIC4MtH&%VtXRT$;
zh-}P&G3*?zjx>8JmwfeLc{^J2a2Re3Q>(No(5i7fI!+lbwFuhZ3R21P*BG<kP!cYJ
zpcxFl^hL1hf(6}~b``TroKMqIew|+`aW%_}hYZ5fcHPr#`-iz+?1j)000X!-1d5pi
z$v26b(&LCjlNjFnLZT~Vt*@}oo<1@G_MX_-$~*uNZJXYVTWOBu`pu4JB5=X>LIeXL
zS>Gdxj-WoX%T0Up@+jg>%$1R+rO0l(T#Vep;6(5x4&dH|y5tf<I!oAlWwC*h(rCzX
zW<L)Gii?Zax=lBmL``zYUGs+osUA9G`~!-Et&D~BRB0ak<+*ta(W9$~1m&rd{o~yT
zBl^uC^>bESR~g=fMB@!)ap4n2ld=v4hD*N-Uwb;*8$J*hmlaxQ+zezhoV^#DnyPr#
z`<p@G#+4k5>lx{C@^EhKZ6IHXL!f}P(6H&0p9Ws*nS25*3QAsei0tu?+V&`A?)j0q
zr+@wIXsT(to<C9R&iv|i5_5XmoBcS!ol^ljrM844P{7BWEZ0tfWq_T7fyp~HlM@-Y
z&zi*=o2Mijz`U1Ib~TeFD{oIA`-zSnDy~Pb_jJ1aqMj~3kgMZo!MEeq(RiC6^+&qC
zg1O`VJl593qCWM5Wc%q#oth7<;^KflEO8SdyqirMaB#i0fr(@8K?nF;{=-L)h#@Db
z+&nE0RGy&(ht0XlQlXLhj>+YRc~_wUW|~Z*DP&Ry?u+QOMQJUl+XMZ(*As49A7Pro
z0HYvXN3>HG%g3|~Rd$7axlG&M_`X6zcgV6FmG43N+Z<x0)DpwaDFp=c@O4Jp`Aa-B
z%K5K>M-MRV9M5Xyf#0U?Xn7R7a^Rc3SZbPm8>A@io^*|c9C^k~No-kJ#i6o2Wf=`1
zoZ*;>o1M&GW_w=b(aC%Jwm_fHIj=n%-?k+LC4qSq97U*TD5PPHzRWs#zYmV_HpyGC
zxuTAc4A)!R8lA7dH0*EE)h+6O(c0kJo$mX|)7nvFdKE1Z>}-Iwog8P!>&acqb^yl>
zVsxeX&inh}3Yj+edHY*{Pce#jn)b-cPfr8Ns8Wzl{R4Q0GF7Fgani4(G9pYmt4g5T
zorhf2so=dUhiGYWyP1LQr@FjSzD6D;Z+ckV)j*yZ)CzL?6}mllgp+O|4r!>wX<y-$
z9IJ!zkBNZGFv1eK{}4|U58kZ9RY-ZP5V_9dXpf*z0E1Rw%Ye%c45hR@M(KoGBfyVC
zI$xsnvqTw$%;(xAiU_&Gx-0DVWxKw0Cax}8S~LzFKV&ttk*6>JoS#3$un3iwk+zg0
zK<QkV%b-8V8++Q*XiX4tq$rQ+kK8>wKxYNSD|Gp8riHBXTsL-+S%}lE8Hvf0Rd|lf
z4S*HYy`RJTt@R||c1v%zfvu+!K+&1UCx{ca*%)2ZG(ak?Y48sZdr+Z9aIkfdd?5;m
zENY8MBn-*xL&oXNQMuZh>GX0bUqFQ9-JA0O4@mclstoGxdz>d!JKQ<!#9_JglnVf&
z25(;5DqQw!wDEy!_L8CF(4@2F{vguC)<zrwcWB!Nm;tqty@$p4-X)`Q;!v2jbfU(`
zgPta`J>l*>{|H!xt<t;>aY6LtNw3DgB2NoW%{`MEY2i`{4USMZ6@}^J?uW+*p>Z=y
z1M`YbV)3&}`j>jdAVCsoRI*aq)a}8&_K;>I#b}Ph`e$hJmwz4j;K)DXVm~Ssij>9|
z4Xj~foBRi5N#<o+HLXyT(n&Aa61*#h0Ld5-AXzt^es2P=7Y&3?kyh%5Yjs+FK*&-^
z3vkqRog6hsT(Xg8_rSRUg038JK=z&w7c1UoB4qoigv5;~MoAF4CH=joO;gHpS$TcL
z3Kfz4gdnUv_+sVHukoF?sHt-SX!9pWn;WZA0UfzglALAxCZfV%`y1AL?bU+{l9uTL
zMh1xhrTxWhwC(MSXq~I(%1IKRAcQzMK3D+c#bB6C{yVuRV7B_aq7Dn)Gr*Zz|9-Qr
z-Vb^m3e2c-e{C@#kzy5}wLrHhwa{N)vqbjeo~*00Wkk6K)eP&K^TxniRRr>sULiwC
zLU~2<i7s&2pUOL=$*03~!SLKA@u2ddYz>`*mqZm_)vD3JSlZC^VbzC(CgV%c0%=+5
zw!m*plSa>~=}G6^j8OCN<=SW#R8*7S$}EZsUTadJ8fri=y2`Du51fN;V%cS>=^5Yp
zbB-MM$oMs|W-LT4nq#%yrwv=44(yqyP}sVi92rMB<a0nYMFx#e{LvW5v|=kdnm?eC
zG^8|Nx->Yswc!U4g~0pVC=clzBlEvqFL$4|_Z}Mn1N!dFy}d*r>P{QuAh~b5y5yTp
z+f%2WXC=|ZW5K#Xt2>ZeNsw9Dl^SScm`@R}ZNJoSJCfCV2%}@o-ED)?3_PojOJ!Ko
zZk8_C#vW97A5^>vPh{#lGu<f;(SJqDs2RZWR?V~CDBdiK9lS%gk}WHz+nrK)D8%k)
zpHTtDp6Uzy3d&HpwM^k^fr<IOJJl@Hyz+;$AC%FI<?HSzM<+#VWj&dUF6%*Vm(@^C
z9)UbesUT2D0G~G?8O&5!1S?6$t7^aYe)~y7Jy;TjISU&++8ZnE2k3Ux2+GcgUK{_6
zhDJs_RJ>yfM+5!i68h3g@nNfJj=B2m<79wN7`xTK-@CJz474`eDMlC_K8g?i*SSjI
zxAxoZM+XI(1U?5ZW-}!Ksv}RSOF&D>HnK{Eq9`U)O=F9ff*qw>kqTZ}HE{0&D4#T&
zEc=#TOLi%*Vl3J=N|rKIuzDef@WgsnexGPc@u7LjBBwhZ!)>Pd8!lqRPrpM=Tqotw
zhskN}?(MF)_ZuZ1+q?VaR{<WTJMbf0UHDF0MAKA@Ku4Oll9bgQ3fyg@QntapAmR?w
zBq@Q~5#p^W#kvA-FJ1Q00@_)n&Vt3G&ZoJWCI>Ll-6%4V16s7Vje>axXDmTwY8F`Q
z4o6#rBXLG^3)UzZO{a%B{bIg63rhoG+uQB@5%nJbh>-pW#*wc)wwT|go7~TKQ~@@5
z3%Zha%?ED;9hf&g9g$&zgqD}*^8TQ{G@S+yH85)Tl(XkM;xp@tzc%Y1ZXRy56?7$6
z-Ez76^84lxq&Oz2K0vjNWJJHl2Pl?-k&0b3sX&S(MP0AOV_F`;#G(Lrv=Jv8=E<*`
z*6kTZzO3s7oF_)5s235dUWFo&y%eE9Ai}!3+oe057%?h>BoAiSn|wRzw22gqEYPQD
zc$~dcnlGHh10@3ZClTz%Ff7zD)t@8Tn77GTi-itHDF;!+G>EBb;5Ec+OXSkGWwZNw
zVy?qMi%T}CoSat$AJ4O4h$6mcRaq)iumSQsnAfjAkN!C3q`?g|ABL)7(Tc#_Jvvpk
zuZth(RQifdvg<=WqAjM9Tm(1nOpsr;SbO$K3xiVysk)WQGOqy*vf*HpgY8{RGPeT#
zzV0Q1M~0op40@YeHompNmY*g|+u+b?(h=@m$fD$^g7o*7s@{Z3tj`7ZS%&~S{t2X;
zmisC^qnvif2V*vjj$5^_zDJb0o!AsIu2kz+=B=Zp_9jfGzSD!zrxag^x9BsJpw-w4
z;9RDFjyuiUXJTcap0#|*zs`F0slwF)m;s*fH0Snv6r7)1OGQYwn3#N!&B!;O53yTq
zc{{rid9u52ZZJl?x@MguVbfwS+Fz^s$in1x_yeoZ!1D4)VEx-M5)aI!H2bz+MR<y5
z-XdStm9bo?iOpOXs~U>pJ_+E4sqQKTdiz9&A0Yqw87L{wf*42uSzyoOPMA3Eg071?
zkcCQr5<ghE@`fPSq{IVSh|L4|ak4nHt~oI=>L)*5tiy0+01-p{qWb*9m-$IY<AvWP
zeZ-<1_b{h1kO2w{j>sK>9eI;^F7=HareEFw)H)8_kO92%>E~y=kOguW!C(xSG{qM@
zX+e>JHkqU}33fY|TKMl?5JY4q(G9o|P!ashYU~E#SgojXLD>q#N+UKpnYLR-rGPsM
ze&8yyT3t7r7p(_M-UsQrs^|D^WO>?X5F3^{9tqEoVmkjLoj$H|ns`4p{Kwz^ze=+I
zlX!r5-#4m)|BVOW;C#w2Ii-I5%oc(*!jF&szbF)Ek9ZlCil7LHxFU2ug5+_^CU}Rj
zCn$GJ7|1I&EiJouUjA4jkXK=AUK|iK4rg-#d?bwAUtqkzWyD?hD&!+Yc^*js_t(X^
zj952c@#W4dT1b5Lac3+87+D1yeHo9RBlarNWu;%ceoOP@_-F_kgG)%LmYVC@+aKoZ
zc9Ba*aa{qT3-N$(Q<U;{Uv6KJL(x*T7VpY%!Fi;0j9<BA48O3jFra@#M9?|~LrZ*0
zdU_+sx5@&0Vb0efe<@YViO$Y&z^aK@b$hZ^jT4FV8sf#^=kl#f*N9<q!47aI;Q^SK
zn7DMx*d!#pkW>0Uek)8we!i!|OhzVjOerZQ=2s;ZOs~d4@_+N2OZ_>(?||=3N=Psm
zDx_m)XTN`c4PF?-R+EIzPH#Y?NnK@oB==JAQL$McI#RvhpZhEVB$4r&kFv6|(+r&>
zWmd`XfH6SnVJ+Ob-a*_2OW9i4bO%NQE=`WZCHj|;rcSpT)_QBIJ5^R!SGUfKh|_-e
zCk%>(hwQA5Rl$7H|HE1lTZM#_%XfB(PCxMB{(7U+Pxa@{PW<!(lF~0e$>}Fj)L$oj
z`bqQc83KR$;SKGt<nHMwALO&+JpJ%rzKs8VlNl3GRwj5_iQrNoelT9ZOYlFBVjzdR
zd-$#7&Zz(+AqjwXBBgBJsD;0Fjb^jDd-l)yT;bR+yyuZLP(n0lzEz3HB%c0^JLlfU
zz&;hs;wyhH<sE9H8{gwo?#u-FpNqhtM|>qeLgHM*=Z<PCC4i(OEh)(jbS5|#Zz4_v
z7igiIYS!rD*|XVJ|M?re5{PRK3?ZOW6MjrgN+Ra5XQQKQDGC4e_N|<M`(9h8HQl6d
z-@Z*vO&JaqCMF~-!LTG2mM!2cwT@gp`-az}Ag|7_1lS$cjstf{3DK)j*F6^%6*Z*{
z^7Feb{PN>963Z3svw!|(!|QCd4K_{DoC-?^yYXuNj~q5;!Zqs91DvLHbbT%Jn1H1h
zw}Z#TSX)=e03vnk)-5V3m{4m7hMULwXN(!^S=tpT!YTmgZ4409oWt_Z>sxsc?I~^0
zo4r_RzZs5?j{saZS%rb5^nUKzQh)@E$aQyjSIK|nOXx{PK>?RHAt{N&is|gdzSsyW
zUB8Ud=yq2GQPleB8W%g~K5m6)3w;-9mQ;B0jCAw-?qLLlT_YmrFLD6!l(Da3gMQ0(
zOaW8YeKQWKuBirp08nvBNUF@|J7L>^>;^Y{?B9FK9tDNg_PtA=n8Fn_GY5*exOBeg
zuQesNjuh4_{%56iLnfSbw*)^2>90k%UPoLoN*ce2=6Sjk2YnIM>eBg}^5dl@-n=)f
zOg|_++{Bt^$oA`NyrId(_y9lIjQX9=@TrbOEcLIO#U7YHhNZ~567wLr_<*A}J4{yr
zP3@67&CAE}ekP3}Ee+QNTFw3xG*VR%7sN3)_!5q6%=^)VB^is8Ew<saG-qI6#DLBO
zlHaLb2Cao-k-dv(`%|>|ia{DLAZrPkuCSNRb|D86G$}A2<Q~kBOR%E8drR@W)I;_=
z?PPMU2+&^t6wa^k?@!lfCNa4BNj&RSkh*O7@o~xG4BMjfY?OtWW;1>t?So09ly_4I
z89Y6|zuu2MIbw8OY0_(+rM4;jVq#KCu926AM$+vrKPrydw-~1C|B}0glBp`ei{QYK
zE!Jg+%w!<%*S8Pc;n;SJ)2i!5Q+ZH2J8n0`)3@^eRz=d?)_Zn?cP16vlme*2^7t>a
z|EbK8-n{1jb$@;k4wT%^dOV_Zy<o<JKpXd5q(yZmYP5$#Y4dxn&EQzI<GDi%f}W#S
z%Mu&!IT&$5gCw3L>9=0Jb+`YQWq^mpO7mP=rB(PvGI*mZq~v=c;v24-X49v#Y=5P5
z=9&woN{XYe1CI$dwYn#AX7rbRbsMm?N@toe1e}Tf)Ml6Q_Vdktw!T3Am4K?355N(9
zhPdE)xAj`6RaqSatHiI8G5JrX%b$23qi^16%8io{PonG!ObyR_c=?Ln?+u>oYOUsU
z$N2@Qk}5t?xcioDK6WK{pjme(L+Q{gK`^^@AGN)Tw#f}MG)_V>$*8rnWa=YHP!=>P
zFkPP_H>14u?Ux}&dh;_@n)6>v^Z_xRMCp#iQPMa1YM!^Q)0QD=Ca(5a%;^v6TJi70
zeT4(=#ygI>)?-0LDvBA(q6KACG>x!qMvKr(X5Y_A#Xl<O;R5j5i#-72#V=0+iEp<(
zIo`zzm*yAMjV~)ML*!ij&dbq2L-MSZn%1yrUy6Opt}#ckP}HXKqPg>S(F5VL1#|7x
zw;8|6E13-44$YEKo2ib-`I2ikJ5gUR!eR&A8uTpd#n~<NHh_5D+4&&M<?<TI-!|UE
z{69AyNogq8-GFKBygHM<<MuaWwWl**8TW^zA3l6kUS;huAiLh{@f^;g#gd6pEwr@R
zh5hB*M99t9qC;JW)1gV|0EMyUSS60$eO80rdO|VRliz~Yo^1c0E6fe=N`BBrBhOHg
zQEZ>4w2?Pk^G<X>UAp8rh(Nn&=}{7mY_N?F`+XgTGIkqN*}e7of;OEf8<CbN;46iV
ztUm%BWA-<T<RHUgt&{U-95+P`y0VNt*Gy>tfox%{(oeG~Pb%a2Y@X@bA`QkeWDLXt
znm@7I4YZWotk!!3Lhp~m-4BadWfG2AGKpWI3bZ-O53o=>DAqA9TmAs9v>#N3r0RAJ
z1=F%GT4osSA41j;Qr>Yu@sf+ah^7ZkZFiv1+AiAjW^$qNSO$XG@u&f+P<$*KqMf2_
zN?}Sktvp@TN#*`(6>HUrV>E|FR$zy^nPdS}@GNNI-;Yy-fFhN30*aqy8A4g~U0)u)
z+eP_pb^qHM2a1@FUQ`bh42JaZ2&>=d6nEO9A|aRf#~LLO<T?-TgQc2v#E_+g8ARf-
zISNu8(1|CJ1ImeHp@0bx^XXaOu@5ZErpb9QKN6m;f|AQ%RT=fIs__prj>qi$R_^ZN
z42@zWbp{Y&J=v0$RLfL`@rAL<m3!JoNBb;2ZG-9AQ6(w{8#7ykE)Ss-4dEokH^sk+
zscg)Dis?X$SI!+RmrwdVJsI2Vo!cdra0{R+=bIsL_fSa@vJ;ABww)VD;`o#R7^xfE
z&?{rA4_Gkek7LiR>my<?Zh5-TP()}pTN%&r$KgsD@<IXq!Qt*CW6$jI!OdfU4@-Xl
z3#<ax)A<xC$ed0bW?HlU2*6qFE>YO8Iy6mQ9-6dTJuVh<-|u`1g=r9cix+7)sg(fF
zt;Y;VNkE$P1#B<$KTgErb~gk`_28?ET5eRu8Yc$hkT~@s)=?~pb<{)Q7D%bReTDY-
zA`~^2Z!=jo(e=#-AzDW$qhPxpFBi#gM?s0+x~AMCEX?mAlO|)y5P>C1Lvl4S(J;U0
z1n7BkZ_OanD=!X|Xy^umK=XIHg}y;eNv5)O;cfO)sx!ja@D)F%5a0&SBLcLtChO28
zbU!q0sbIVoz34kd!-0-YPcl_&QCoQ43MJ8Rkea<{jXF3y+L;jxY;5pApcAZ)$9or8
zifTS=b$dc{ASyMEBg~p1qq1s3?*kr83-|6y2hLCzqlztC{LLROp5587i*?@K1v`h3
zyq7!J-_mh&4ZvwAL2%+vf4;uwxV`|kV~Q3bk|s_C6BXXfJsJ*iB00CUqrdpwQKX?)
zW|o<uCQq6JGU@g<qVN;uLu#a{Y%eJ#;f@C?M%}BMtZeh<jhbiD@5L}nDfL-{#yd}{
zE<RR((YA@(QM@M+F@sbzeuRHh2!B7C$>RaHW%Z?$s{H_^@R_iYb0S_`Dlj*jQ!@z4
z1^X%;nCzf(7}}>PZ6Wf~Y10UrHXH+j9Mz+<xBg_N9hTh?18r|oG~jz4qy84kzkg4j
z@x0u?GwnXTmkI}j^X!{sM?J|NN<5=WxO|!mjMo?`W|m5t0a4$Wb~kN~5=@q&lbeM^
ze|pd@!6+u-=}Kv_Mu8q3C{3AZ2l|}EMKwVE78GIMx_>(c0+E-uK(m@cDCswXu;vco
zR734><rp=;bAss1kDlP?sUZ2LHgVNQgyhXKLg8cZUI}DVAqA+DB<jDJEC8__kn$hS
z+fO{q1tK7VDZx&S!|LEgq(TD8!u|4t74eyNK)dQ=5Zv#hh4hS+l@T~akyg9k!kmH?
z3#4VfR<KupYIBXk(A{a-7UyVgECpz+vJb;<Du$PWM(WMA{#<_pw7R2FtQ47<MUbaI
ziXobegpHd_sz0H-#?>z3NC!y=pmj1Gl&yBf@Jr5{tyUDV4|<b~JqC~uzq`tbwFi@g
zSI*JX)pZwu@lqAQN&)3au|bW=*ll9aQARLSS4CaJf197bNyG)80=lw<V4O?k+P#N_
zspj*wVB%~X8Zq+16Y5kdlE_*Zhg#0wcE+Qm88T#Ch3?l|B6uo<dWiIUN|g&Bsdfio
z|4tc5p_fJ_+al<02Rwk2L)sI!k*hx$I9%Rhc7UcLG-knFGRY_U2J@Xe@=ZVsS5$pc
zBH}BM#toEA<-zX&)h14F^+gx%-2Eo`w~dvJ|8ryi<_KuFwE5zF*z5#HAoliq_3+)K
zinfHdq|xD+!m9)Y)*0*<|1!+<@kXqJC6JEu@hTNh>o25}Dkukg1J&2MRPxkGf*-Yy
z_AQKt3L9$iG<N6WB{$QDH*J7unkaaDxW{2>a6JAo+lz3ZOuZsJfedoqN_ijVjDYu*
zrp$8m^&4blxS(B))v(D+Ik^N6%fsELEH6O~WHxItJiS*c9gPlIjUTx}6Fk3T!|v24
zkU}NZ0l(~zyUSk&i_cl;2=#=8-y5Ml7{IEs7#9j`8_t()B8jZ}Zpg~LZa!2OWvp?~
zs^az?TXs3C(d|mtpMKQv6oN6q^8PrQ0V>_s?f2pmh5)IIyE!@e5fVl=2f5hPa-<Im
z(~sU8?R(tlNH?FqVHcgAomB|kv+B4E2AL}$cTg$~lp*__5oZ>C@-&U}G&INS;$MMt
znmSk;!!ONFF6Ns3`vSEm^Zlp)a!$Nca6~IFv};94XP~V<FS{zH3hBs9Rw00@5ia`-
zZAmi}M_4T@$E}JjPyq2y!WNP;Uq=zC>ZvJRCLQ!B7X5mlM@u1U+vbwmAR7n$v0g!o
zBwTvJwdJCX7If-5Z{w$x_T5ltSb1n#sJ93Aol((GHq<*vLVPGi84O#-N6E(Qw2@=;
zM>H?D9~cFw&A)+s0Zg?ZI3N``{F@TyStcycds_VqEHuT@62g3Xy!&E2!&NyCb&Q}&
zFG=Z;GaaMY;%#Z2Zcr{QO=G^M8^Y0J7k}py^E>`||6d;T8dJsGmkye?NNFFn`4-b{
zEV3G>R9$pv$jzXH(5BJ6CG^(23!J}i!=~=+kH}h-UyK!>bnxZgm}$<svA<tvbxUE<
z>AshD;g$A}cdS_@dxI${o0o7o0;rs-k0MDza&EQS2YN}6IVith_%9D`_}7EY8k{~}
z4f52nOx<6jNeX?>m%aCDxj9(4mWSoX09>-MRO#T+niJ!>rR!@N^vs9|Dmb+s7C&Qv
zA<+6KyoB`67;cZ7Nb4Zf%%%$hzmVxK5e=p6jE<ph5S+|KT!PZozuBQ*ki~2W1hm2G
z1GE*n)`E*Ma=3jhzW1AUwWt~C%r0KOHB0e(cR&#!aFhr;ua!OXj#|$))x3~<BT9H&
z!FMGT`=}b>mu3>K+?u8P*RM>8z^}-u<=s$BJC1l#6VX%s=Jw>LChMp;kI=B&w@QB1
zm;fY(_Y0darPi&YNSmb<n+Uh`(qQSzz%KPDSNI<Dh-`9dH2K{-f!|sQ#Njl?Zh#ne
ztms2Cm7HQ>O7ZQYR^1(g!$y4Vo_6WeR$4SKeb(yxH6vP6p%=)Vf4`%(*OIDlf1LYZ
zmbP$DnBC$Xvy0`pRS*L_JWLLQSm2+%+!``}i{Y<$9W&u@t@dlegON#;1dWmuOpWc<
zJqwbkzFd9#I=mUK0ok+mKNcjXKttG_yYHrq{<VxNdjFfYP?#vcgWX?|^HlkC8xhU6
z!(m63Xndv3Moad~OJ`_H*+3`;rry7P0T8y~-}3hhHh`K#lT%(E!ZrHq5H8>PyY~OJ
z&j`rs|J#QOM3W=nz~65rK=^kw@UMM#jYoiiHkBa&1)i}8Pv6!Aab?<*Keg1oLiFb0
z_}9rIfWN;U@+Y_g|I+BU^YZ@;P5l4op?;ZAW&~yZM*9otY-W$Ya9_Fg{QB>Z`AlGL
zJOXy21+?#4n(s{PS<L1=TB}<n;;pP+BJn`vXxF)eLfAS8v0qCIh&=t*@qc*YhC>rq
zB}xb_N~XSjI%)}?vL41m9of12?w!!@D>~;t`;RCI$b8nXYCI}d>q;A9J(*g9Plg!J
zaxj@n{!EE1@(QY-pA{cQgq7O%Ws$+~zZ*<R8c@}emL2@|q;1sZjgY6sbL*6CuhK#_
z+H`#-MYY<>7pqTu)pK^#`!2qy8NG?SB&NvsIo|mx2F(LG?40;Fx19q9PQDzmeh+_s
zmF<p;{ptoc57TUfo&WINyZ&u=AKXdIWTx5Ejy)8+?9BN7*)O0AaZlbfJO60ZU8N4P
zMB{z_$L<9rd@*Ii+RqjWc+?91@t+G6I%kw5S@ad+Dn@%ON|*!DKN$+;Oia*QE)Pb?
z?C<Y~<=&I^x6ga*NOplgRN(Vj>Iv~+BtC8a*VFk{IO1g=qCX?qpL=ta%%N~%`I!4_
zuX1A2&{1hq5e^n6eKdy_tMMr1b}k=H`t$1QkHrMSb!6MyW*U`T{L$b?GCSI5-xB0l
z?SGC%Lh=QLUbUa)xqz`=<+JKJS68Oa)ZM)S=xEDF9rGdlL5uCi_m4CpVkilsJ}+Lh
zx=$V-b5dFFt@D^X=Hg|Zr;^>5ZG*8h?r!TidQrT*QY^p*im7mH4k6CiIM^AfJ#w`;
zKBT9<e7T=S@`_lC!d-{mA8koJ<u*k0i33`A%>v3M^z==-9Vw8fPI~w#YPwWjm!>m+
zcv#_c@Wakh$IZEWeJIYPkvImYHK(WBfaIfup~}9jR@<31PC<(ljYKLa8l9Ok$`~Mf
zCq=JEV<0OwJG+f%s@~VLY}yN74x+f_zU;`)G}pOp^Anablw4}78v~o%mUDJikHFb$
zmic-Y1-pK6rci+E)4O*~v|F3=PfYB;xn^M>&PKoO+=~r`VwOw#wJ9=*gpyu85nLro
z5igd8*`<fQpT<A3h<Bdvx+Eg&+}-b%kSI<;DHHVM^=^LA5;!k<1G)72wUp}RKbMEH
zI>mA_Z{SQ1C5X}~Nb83lw*=B$vLG`;=J#nuDf|^IA{JOrd$}*G;2+0aV^~YC7Pbs0
zMjU023dx<y=8MqoC9C)YzMLn)Q7Ef%Rv-<<SjA$YRudsNH#Z78L3c-c`?LMcKl-xR
zi_5a1FI)12_>Pyw(;}muaMs8<eTn8hw42({hsN*l$O=Vk{&R2G1D1Fxa*4U+#j;3p
zHJC_^lBLAt+4JyW1iM9JmH@J>P$SK?d8YYV_sI#zZ*kL%tl2=Mpw$)gu~oT$?=^|a
zg)j{FSH=S{`9vloq+xy9|CKU2x;ymm5US=qri>1;4o$}%a>K>-q!hUG-CjdaWN{@q
z8s&;Q?FIf)+Wyn(&$9z2&HF-cO9Mg`qr^C@Ff|1)Wa<B+R^l7K_T$iysVbA2Czlnn
zk8dL9X)$fDD^pys+kBOZF|uK`zp1bvMj@T0m@VbT8NsAOS$p$A2K~d%=b0S|kWpv2
zQ0KWQ#4j$6YBIfJQ*>L_y7-#P1&|IgI)<`PrNF*y=_}PkMQUhQ{Z>D4SsL6?r0RF$
z;Zd2>PZZPg^E>xGEQ(u&s(bX?6@H(U%l|yH&+elru!dK-YI!)>YGyGbcb$&8CP<l5
zR8=eQ&4#gN3s&1~Jo@Cal$zjAzNMuB^Zi6M$}A1(vu=%4txB1|sckzx)GEy=07-Cl
zamV$PKipAO;2-N!@Niq#a{sYZE|EH|H5(-(&d8K5ur`qQ@pYhcW_>0B`SuTmFpR#N
z7x+0S|A$>PuU7Ez;<5VqLkv_xP!KK=M+l8f4o<Cim)x-qjj1%+bUDp7Iq!m!s-Tz{
zN^?+4hzvwK+P>yb^@k5>)w!g6V+$v0J`x*Tx3@2(tXj?Wx7{%kT>IlZtxP(QuxuPb
ze)RQ}RWa;L4eGo+OGZgAck)-CrHapvG!)sgL*);Z>qsqr<AoEY7G0>=_36pUih0^(
zo<nX+xTUr3b)WP@USS46F*MG>{&KJKhaop3BO1!|?Cg^n$#r+?s@Yusi)afXYmg33
zR%n=+EgF+(Y0)<g<0#<$->#mq7t!FDXBiu6R3RIG!XPQPfzfT=?*?sK60;#okK0En
z>%n~Ij-Xg1d!D50XKv<^)30|pC`_c4^mRCjYLePNSWUu?<|@(93p5;Lj>+Dbby{mz
z2IcSjPvw8EY%cRn=H)lq4Np~a)GK(gPbyG-MDq$Kx>Jwl)87l-G4WilN}XF=6n+@-
z{Cc%AD%uuqBdAuGC&>PuOJCA6lT!VQu`hwj+P;ObHtxzOceGF?tejfzUgB=0gS$+6
z1gF&nhfIwsf<6rAnC9F6!;!<HX=RfxEMp(+459eO3$s4HtJAtP!5F9zM5wa1&~x6_
z)^;H8=Erx|ZcQJqtqN!X(E|HYs>H3*kE@e)s7s$RP;7d`#8jX}X#ra`Pdkh)#3)gl
zM!mA!yG17a0UC&d(&O}|R<yF{Xl`T}{<?KsL83_I(dkbyx)kXJC-=?p*5yW8=giZ5
z`q?dDL|xi1JO_dkc51mCN9G0f;xZ&ua`gLV@?`_4<+~en=hr5~$)#6<X%x}5c_KNB
z1Sw^8CmV8bMDGY&$|jU|uGaf*!F-V_izX;Kof_IToo%%_C`>Ol^d~Q%G}2b6t<~CF
z=#fnojTP8aE|hQ#ND<SQ^vV<we^?Fhm1=qM0VuGJj@fTYIofT+FZ7g$dlhQaF_7=8
zm@M^2ft?hkQIJT&*B>qpii#qxRVm6M!I`GX>Kn~nTwDZB02S%8)jXX#F77_)>mJ}t
zqbL=m;3llw5~hnCyQOc)efS-%&Ibd!iCr`3zxQ&!^UA~rj0^Kg|GXv66TJUv$m0lM
zkt95ul=9RAzAp|pWn%?DDnLiBNC%uzR7#eVfLy~`uuhZTw;1oW<0Zw3*o05+ZIpdO
z6Mg&kV12gjPWR!ucurIBPJ>fbjF`&WbQ6|VQxNvP+=gH6lXyS6FK1RNB(t91T>-2>
zg&iI_x%$jPLD3Q{8aVrRyJ3Oiv#QgS0|PC%(ykrpiuze}|JEv`s!qM5^0dnYj$hCH
zyn@6SkU!}51aIeKW`W<Gw15Y})Qsy(-#wW!Gd_U9sxg{5*j@Vy2V!XONWH@LP0#MZ
zDwjp0R~gRgAj>5b9y?13!mH>!539jlC`pBuHVC7WBrpO^=#IOR#Z~|4+L)~iW{7^M
z<>e**;w8i5snH6TZb+yT!(HCMB3O{Djv>{_Y6DviNW7qfOj|c^FwQsf%^%fxSQF;k
zOO|QZ-7mfkM@wZcTM8&BiVhFJ-d%}Y-CpjMtI}-P<+M^wBuXPB!xY+HElT`wS9vR#
zVHJyb7=_=59`&Cp{)@r|KAMCcg?FTvopb-=K+l1Lk`I4eb|w|^`sZ2ym;Xh|6f5Uw
zy&18&-yEpO^ERRVd>!%fPfZl{Nes;jGM16BDz%iWBUS+{P7d4Di$2j9r{dEtiZF>d
z&u9cNF7TUP0A&h4rGiWDtj6>gxXpNP=C*Lx+lqgAtx{E$9LWg9`F&N~5}a&veb=Sb
z^6&0M)1e2i3dnA*^7to7ZTxI+T@L+dJk?`oGVXi0begGsvx<&bhx5;P5nE(@XISTj
zD|M)68fMq%Zmok`=^APCboa6l=eZB`TqCAS<0xv8xvW0>_A)jhmZXt~`u$WJ<IN{!
zuXJm$*|bA9$%Xh?wGA<;kL+4sv`91G@Eaay!0o&uIvo%{KCW?+RDwoWFty_5Abl;;
z6UA1f=_>>A*;)y}^KD1@+D1H&qY0aO8S^e7!`Z&_iQlcIc&Lu*nBTOx@GekiNa`nT
zpVC7A{Sq7_n+$EIw31i4Seg~n$F|87QWP3{7b>gp_QyNSv|eD26(sHb+^sF+^!AI+
zEM29PjGP(o{DG`9=&^HLk*xnVsS{r+NZl~oZRC(cvf{qkB-Y2tC#=Mj{`ox7r>~`i
zi?H#?<9J@1D2x~QF)m!e^ujyy(PO9ru6(-w*2<-iO?8fUN2Gwq>-!cvO>1?Gmtw6^
zB@wwsc<#*c#o1Z)+0hXcQIAj4oSpYEdF<`2W;>XqtL)ORsp6L%N`$X{q%lv_8V_ov
zn$@V&zjm20k5;oxcxvmwp5gQre%wTu7X|nOzP{o5nPdFwo%Hq98dZlZDOHQOV~k`%
zH1_0{beSD9wWP7ak-g3K0V^wFhmQy7RX0V~uE3JGOt?&5&OEA;l1<!sQ97k>nzXg6
zvQb#Uh41ro{La|fAtWH5uD0I|?wb$cnLXz#{p9WDXgjwQxJKi3*b%<bSx&Q4%=Tpl
zw!0|UX#UvHHSGO|>FI_yWlh@=iw|nz&4t%Kvk~<1?)80+DN(6$$R?|$_(^w4Y5CIk
zU)GWkSg&7Qgxeo&z$SNiD4iVPw8u<@!)&$aerI+vK5p-UQiyk3O-+Qf8h+KpQ#$cA
zSN2(>siEiVHJKk%-WZ<|F=YM#*;VF09J_T3ZqHo$FEhjfSEroK7IEkw#qx1lNeJ^;
z*tB@KUaj=@>15q?aGM=Mx^iXpWmHLY1*2t&)im)0Q_f44gG)-rpHOV;Sx-*@N#h*I
zUM6XU`c*gre!X9kDC0N5!@aQySASADCiV5;5B0R8#9OG*#9S_{$d0Ha(eHVOZR?9_
zG-p*k-{owj^)Dv{5*?n#HE+64_rXV<;RDDVDa)_7y+1yib?K_gT}v!)xn<Y^{cg`o
z_EftM;EO8QOpjp^M(<S|iI;h8$J8oWx2IJq2@o$xs(=3U{SL8xD<7erO7Yp*y$K2V
ztjPaBg}ccDR|?ascg{}#t;6Qgy-Ms?1X?dTo3MiE(Uj)2JDt%gU7nBR8B)9}iI5?`
zyWVrUY$eS9avK=Mrp=6<G~7keFIx1MytQkv>`TsevO2h~aV1|`#{O%Uiw=mA1#?!L
zLS5{Hp^@@{gZ+LO12W=?^)F5}>X%c6I(6nx`_#hqs?0O@)(Mqb3ixtg#bu*HyNb(X
zUL(<u0eLJ^+BnX+kIh<frMlP4<+&Otx(aqD|LoI4uV?%(&(r#J#m>TFf_j!~W=Zo)
zym=j`yH)Lb;dKkXOV$oEZcaO)Ut8QM7SPbmww{oaty!Edm6zjG`+UYhTpsqb)6nDx
zv1K2tYwSoN=0sx~dC|O4GyB>uZUyULqNRXJ{{lt-Vv&)zl^qq<b9#g}B}GN}yO~HT
z*Wn2K?wo2-zMzSbNa15{9rihjD!z`6l+nFWv)kFo8$x_Vd)RBoz2$~R<aGT?!{h5}
z#LHY)%}#Z^(uIHTeD39rotoC29MgLu_p$R>E)!NT&oqcvUe+YWeEDKElLKxaH)rq$
z+_L%DJp0qfe7Sb%-&Ts3D|)oDjL{L<j*jHW&SuKbTUuj7h}6svI~pUmWhBo)$MTU?
zT(uADG3)MWkotz?^1t84@tGe_?U-6&T>+mgM=$4%?h@u#JS&e6Z^hy`=rkAw+e`M_
zjO_6!kVJpnIE&<YFZ_Fp4^ztFq+jpRFY!5*)`q0qyta$-^W}9sV*GmszHr*gldU$*
ztF$Bj*wJ6`P8Eoz>Ay|l?wYH^+Khenz!Ju)e9jPPjXji~lb9A8Z>94(43_N_=l5m=
zFf>ko-zW6#nKDg*@pVnLZEflVv)!30W@Z~<tVV2NvIKpNf&NfUK<X)ugKx7v!l|Ll
zl_!4uswrEu)M_=xyA4;D(Aiw<)B?OA@wgN|(qD5g()8HEt^<8IJBY<*X50>}@U;Z4
z!)>rtpYG?_pI&{wnG2`-DcL~iX1MRn3=4Eex+AGYrB+_dsZlu$m`Ea(6z|C)){*?$
z)(E|%iCB6ESueQO&@g0g(tEwuEp&6C$9DYdeQ^E~v=WwwG9k{cJ?@pyQtfTfP0c5F
z(CbS2qowMp)5(bW=G+Q%Ed;lsiv_p#;_0gVs3_|P>VZgQ6UvOtUwU>mzg!b+_76^0
z@zN5u1bHSQuKGd4r*M1i<#3=$6Vc{k`}Pl|B-!FImdaCCffVa@vFTu$TcTQx^iw3B
zKlnbZdlpW#1goo@U(Rp{>a5ySQYO_{9Xo(=aPG_GfBa#Wh^+KbI?6gcWNNiL)kH=n
zhPg?!(t)hX&mSTP6^0VCSz3kWsbCGa91HC0CLhuxxa}_2iU(4|xQG)`|9!~Wx>f>N
zNoY`qBY>jqqzH`)io}31m=Q6)|EPgPa4*m~NivW5!GqG*&x2uI9A}}?7jJ&oic4jp
z9W4p9V9xCcH09N!(Kjha*7zC?-N89QXgHixu@6NVKbO0m^+LDrCl>A-X(XT6gdqhk
zyajD-*7`4{flskxi}Rm)EiGxImNmFuS4%|Z^~=ckz+$Lpxt)PB1a-cH?@^{vukHBC
zGK^K4nybDr=G_4|yfc7+j0`!5PDMsq+PDt==J>6Yoz=3oP^QfzJ6@ASxJ1-6idg~o
zX4|5OXw=I;zkPdLppV`e)kUpM1Kl%aTpypng#aX@wJ_9V(pFSOS7BXP#W68PI+`B1
z^InfQA8b1_qw<%Mp6M8EisO+>Co4<?e~c7O2J{CT@1gh<h`Ju%xHlYRc&koN=@GAe
zqvGj`HHj~j@!Kip<m>NVLH$C3RR6eBhi0X`l&(xt<@}<;9-d`NPOOIPL9E4tYxi=N
zA6|EpRT!K~M<5WKA{Dky?Nxj0)5kxnHIz4MQnXvd@<Xz+4qr-fb1BH$!{uaL?0T+|
zC|YD(CUfF>vrooxdBn}>NZy4S3dBg!voubwA#++8-OiLwPbj=C`(k4HdCjr5lUhZ2
zujoy^$ES;Y3QJGz=}g2*pt{_Nd}hZOS&Yvc*#*r%{Adbl-P_V;O&95SvbF<tC2_DT
zX~M5+zDrPNj~TH-KJvF}%nAs*ke5({ILq%`LK}uInbQ5uye!e5c#4MEBiP+_D|8Sc
zalRFVbj)|Zb$#KB<^g>44jq>H?$5#dFKzRU)T(r4nZ(820jF>{tRI`)>Iq9o;M1Aa
zs`+RY>)aX{{#50f69TTh((_aa?M{W=ERC0)bw<(;2xq@l<Is@H-ec|#=ON+9cO%y`
zQa5W1IEE+|Pmh>qGbU`J7PX7fa&^?%Ldv}@7j~+%ug_^sz^J0XQq0gzV!{T?eB#?o
ztRSZ>7D3{Z_|gsmlgxfwAl=5wWM+ztEX>d26A(NUj>f9feUM^PXz<<FS0^#^f{ksK
zFFJX0w}FsWqk|(fn20rSx!Ci~#4}stdH&0n3_$p(P$`;WHiB%d?fR7a6C6c17v|`2
z*0zPtM0_+h!_dxfHb9i|sAN9NrN(W(6^Eecmz}n`qP{ryO3vGBQdob}vy$X{@*lf?
zyD4*d%M@hM2lG9Z4=m`2T~Xi&-Za;raI+(9Mi5{w+Ts4u4tkY_pPx~>^-$L;Wf-zP
z9enKh$aCS5U0npb;Jn#TA=<oI&4->utpw0nq2Ya+cCw@8CGQlEK9Q_a<s~^D>0vY9
zYiDJlGkW2t;rrr^;Q*sBR|&+%8OvSC!nJGH@07~?gpt>7F3l1g0A1Sc;AY^sX#ZFq
z>dKgzYG|3jehHXCK%D5@{Jebjad@#b%NAoYWft~LH3fwl%DC+4^4;dbrJnSH;ww}S
zwgrw4ZC*XiQs<8Ot}t9R78ItKCif`p1$TPU)q%li9)~x~WFnrKBFbf!99p`Y?}R_=
z86Vl&W<9s+MQO(Xg|4DZMZ64iMo-p+ZBTHj1F{iYS>4|L1@v?=PO7kXkXrywW9=;w
zyfa6#-U9-yQnoK2h`wces6=g2MP(!Lk%>)9(v+RIEzoUR(|y3fv(Bw?D!?&Am-~$W
z2^MD-PIv~7UhK_Wr~8aCmQ0CTi#lYPL;#_=V(K-L!;RUtm(OBOc60C?EG#4)u@j=A
zMk6`1RJCMep2a_MqLzvBTUaWmy?=i%DJvvo1K`hhoY%E_nRR8{^^^<JD255<rt+Bq
zOM+ZQotGhYQV9A`szPQX^rL^8|7r<<Zajt+`X_Ohk%MXR+w@)$3kYzfD;xznLpC9<
z?XIQ&SZm}4Wq*~Eok_Ibf|k@1RjM0m3>r}}e<V*=nAG?Rjh3&Km}*rOU%|5Tp+eJk
z$F-2n!wD4>Mef8l`vK$@a>*-k$VK^3qpf;d@`{Wxje6BeNN&*as)nA$kwU7>3d}bj
zEzm!9xkRkfW|Xad#EKF`qe#ue^ClhpQTWWqy<zAu8QX@<Zl(<ktMAAtQ`5s^$f%EG
z2bx1&zVTn~y#7ne5P{21lFj`FeXO;FfZK$v6|Oje^tC9HhM|xLu{AiQmDe1<CZGBd
z<~J<I70=*J1(lAKb!||dEUa6>1a8g*Mnn=Ua#V&{G61va_PrV@<vAcAA$gn;az!Xf
zV!lnjw2Y$4_OWki#ofH`P5MMQFxxNKjx9NJna!;)LrK&%p~kY&pQ7(QYT3IV38D^E
z{n;9vCW(z!WS#3WuX|~6SZ&iX6qB^vB03Pc79ltM?-nUC>59@UjEo8U1T2n|#PN;H
zMyd>r$46GOx^4q@4<LJ$$}C!uxjW-2y)Gt0Nl1uGQ&8@xlAl83xHdakr*822o43#O
zqwtn%o>9e6ppS}TY9+lg$P(?mJaj^aF5u(!OAC~^mOGw2{#0nbw0&<G!-g(I`h2Fz
z$*}_o2?;MRFOM&~jnzR1U<A5?rgZI_Tl0K8XozbYll~dC>J%;y0`Lg6E$iNAqaN!a
zjMQ+-l+>fgX|ZCuW`QrRrJI}VErqs(+;_b#<c<raS$@T)^**iG3>wFHx)i!;_&nvP
zJ)0{dAKZBzmuk1WK7YPL>xVw1yQn~8^134~2Yaa_K9Mb@lYD8Yhz=Q#ftUh4E%j`x
zwqWUS_}KWom3TYK{DGy`CRWppS~yg=GvGuNFV*`tNZ()X%`C}(o~K=abHY8kt&%XR
z;Nig)Uha2%^EQmKU-A6Zc=F(x$$iC!8J$69ag%g}mWTFEtrMhlq{uDJX|66933q-)
z54Y8$ioY2#at^$*R<*txeQ{88seejC6B!kE3M({d*NUXIFkB?uUv~TAbNb}nQ`_}M
z>MQ*rHNwGF>eQoYEK%t&$V)sd!!aH;k2{KcdLL_z=`IP^&-T8)<l?*yMw9z?ewxud
z<!S+y1p15Po!Cr6@2viCEL+aEHd!Y!H8rR;8VQqqJ&^lpA|}jMOF4-$Q?<f2Eh;MN
z_VkuN;EI?Lh28n4(^I)x;<;<%248i%XsKR3?+_VG<9E?)^0d3H&jDLd?lh+6`!$ql
zC}7O$i27v1g^rF+CS7ww_VY6y*{%s^7||+RjZV~Ds|MyL_6Lbmz%2P6zkQSOHDY7o
z$$j(g?NuHosuis0i^?-~c{o=<{d{SEpZ|pYMz_u9hCu1lh;EK}>1*~GUYuDN7hy$%
ztJ?kKxD01tg9#?z(_5;FT)fy&823|CE@`m9U!$AV-WpGrS2yiB!=bE=#xqddlor4f
z-`*NBqzELB77Ks<^M@361g}#7TS}68Xb@Fe2A8dQO|+AOCTa-u$s*!3_@*QUkS;OX
zXP2rIsWfJ0X6yB-jeWHuBaW@d$*rrM3ecB@DG{*3z@*N*TZM5hH7^=FA7J4G+Rsk!
zs8-!2z;(NJ<C(8A*%0|n<`ivR-Re(fzLAl^Pqe_Km5B2FWk9KltEvb1tI&yZv!ztG
zvSk{Q-)`?6U*k{Q$kBt*dkpGa4;}=y=?0|xE97B)<rLrfdDfze$VF{e{>-82QMh|l
zSsDG-f(Bfg#Hib!CIT`IlP8ehLPs9!SeVNV7(c`o?Dxx>zVK-rGV-FjKXQ{>aTAx7
zOjp>##_V$4obMtN6g>aF9%J8fNHnn_xszPA`1Ms}3W+(oU$R0?6AEo=2R}cz5Ndp-
zQIe~n{N<a0(6keM*si>@qvJL<l^i8W-@D%IoSf^4E5jy%mLcS+MK~wNWvK#F-yPbv
z#230#b0(T}B1{88dkAR&Fl>UB2%XK7CYo-N+!C=mGkfh0E14Xx`LZ7nWv|k^Ec(Cy
zTu`7@rJrv|gUN4Jlxy~N$ldbS7N|K#l2V<?#dDf{ZcC=9p%3it6Lz@sOdHsFL;2iz
z3*?5BJu4#{y2-CP6M~p=ZrW9UyIVEUB&;+zNPbfroL0w^QR%^ljxCT5PEC?ew^cpt
zOytI9WoE`0L@De79Vnpm@LQ<qv>4UYfE2YPk2aR6w>7t;Jr?p%(TO;roNTs46Slkp
zN?dJ*d^#geb9nNEx+r<I0^x%t<1{Xt^$kIzR2%3hPiegz=2G0y5q}d~!>%n+A~gr+
z=x}M^jv4aMmR**HU#hN2ZLt2wbj=}6Pl77gm@vjfUimCFPPH)Sn5%fF@E%`XNuIUh
zdbM))_R*G<J-WTHOqq(Wd)@c%9PI2c2;Ql|kF3aOWIuPCsatQP)S{QFeE{qQ9#k#9
zGcY%2-eNbOd%RsX1Epa+RKq1^!rj7*&}1HrB;KOV<abYRV(tl)<3R3@R*Fk6SGF>d
zw`teGB~=iO%zm2VEQRPhP1)^UV!bwztJRcZQ1bx|$}h*eP92aim%p8bU!nSFb40B@
zDy^QuTwk{%<&k)FXmas}-ul7vRLYZhUYu0kTV`M1jRvr=&_zK)SV+B+%NH^|DCoq)
zqRI?aGb?JW4h{}??$kh%`rDd%g|ci7Xf1b_4AyZ&`|H<rj`!0q4n<D)BaWo-$ME@k
zlN0naO~D6{NQM~8Z8Eiori)Q1YaLQps)|cNoGWCm;G|r=w(~qXG;?=1C-{>nP&_vf
zzOo`D#ht^h;dd$#8bGX!4DHFt(UYW82i!(S7ekLE7NstOLt)yckcb~c+Tvm@QqtkL
zwV=5&%ubbS7+z4EDaWkK&0QhvjV>;W5iowH=jRxA6i8xf@?9JwKdPXwv;TAug_vhz
z7m_&=5)%EZ=+2H+w95Ie>E1Am<=(S5kMF!*9p#QCzjx0^I=Q{bSR?j(b@h0#hT}NO
zD>ulhVd>pipY?gbbjf8(XZa%SU~jetub^N}n_BYYSb_I#M@bmCxY|ZW^jY^GJWwyU
zzOQ&%TNp$2E)V@b84@BK5dB1bpbiQhAr0N3@&j4z>FT0UE#^}l7SavE#-3{44uh_i
zsMUr;8L2qPFpZ;3r|sM|?;ia=DdWNJrHR@RP_3-_fwW5Ib?D(`RwD?-0N#jDqd!+I
zYnJa|p`pkcFzF%j<)VDFDSJz=C+B7EmE=xKznAMdsdzNnP#HUDw}W2k=-^g65Kf-B
zQ<JE`;N+&77(V0%y|EroLq^MJ_;m!UG4_#IbJWOg_4#Wi=@4DrxOtPsSp8#AzId=U
zq;cccVjUq4cW)AbOx`Qk6f8hdj7N9hy(hv4s)l@6sQljMJf>o^?)K8Hq@-FyL-}%)
zCm4A+y0H+j-|yH@dzzDf8+o7b=E3_XX%$=g&tk^1)C7TQIh3iA+5e`0s4Y;ztq;}k
zBQsmK<y5^9+z8_l)3tSFVe$Jqt&d}8_BJLTJ^IiYPJ2s4_?P}t5?JE)TP5yFC(3P!
zY<s)fs%TgXg}j{%3g^$eTtp+-TpIAdjh*aTRaI5&2+j;PD<dNTx9uia9cYrz?0C2f
zfRC&J4Ugkte`lwk^HT5=sNbcN{hXJFrT40|TNH{_@aU8u9?`<dK#QA<V-RHl{PX}A
zr&dHfn3nQH!Z*@FzS4fr>3HwsKBxu9+1AL^*px}9nwlE%V5#Fh1#r??^m`vGLD<sY
zX33F=t#}INyh5=IibFuq+M-37_2wIieZ72~`q7D-3=ToKDIMT->UxK8l|(a>r9etM
zB}u=J!H5BxkvUd7H>i8P0nNW7!^h47t)E(b?}QhBZ_a3hIADUHv%>C@cmU<?ZYUkP
z#kT8nXtkQkym$LfTW`u*czg2C%~lHOa<l2ijuJC0lbkTyJ=rO0>8Rld?y{WrTTc>1
z_!+V-Cdd=uQd-S-(gLAEK&in`2*86cf%m!X=hhBZryr_OFZ5+^AMTmxk|jfE`~+Io
zoll_RZ&sM94`)>bHiC4-?jf5(PJX`Q$cW;}{$iVe14PJR<Y)HfO4NaB1bJt<SM?ZU
zW9%=#lkTf6&+4>oUHlV1dSiq+vrw~gv#iLJH~KvOTU(Wm{(d%LFG3c*Zj2~d+l?7X
z?a!V!S*27p;vQZ>k&5JyCzSiNZ$-1eyIXF(CO~)v4NYqY4<>O75lSx-7G|jWOBUtX
zxbN;-o4CabdrzHMz-+XhkdPa<L}ZhHNb?@ub<BXGZHSwbo>5SrImyQPI8{Ob7hJot
zb_ifg80O~ovTmBq`nPa*SsK<N9O!vfR1|Fo^p};l5$pQ5Z@03s(~T6HkoSOx$EW;d
zb0sp{rDj4hT>A<GHYmeb{P+Q^;0}8kpE5&w>c(K_Z1u>geGl(zKQ~qLp4WJszl4i=
zjX*vr#Cg+Yd9DM^bYWWhiL&VA<YeA^T>It0`IVLQL~kLS#euw+W;0i(iAkt?lBI)R
z#T@VH#02)-gJb*JrQfsIaudg;VSeo;L)vv3=72HkgwCb?t(`H^JJ3Z!HM3~PHf^lT
zYP>0!B7sOuIQ-N1kK{QP={PNZ>5Hao9~^eFRDgsJln=^fG-vaNXK6N~DbEwM<R!E@
zB!{krjS*eamrsmoFyT^rczNL__ea_jaav+u^7QbaWPADjs>x%r1w*000EjOa?6#Mv
z(35o0U0hrS#8=!YbC=sj?oBkRJ=w#1_wL<iF%DzwIzd6ffhnm7wp(7O{^zR;mPxUv
za?!x2a$P1hA>oTuB*6)2Hul1SodEC<=hM+{c~WxhtM;T-AuhFTFp)E(!r7~;O$yfM
zxd<tDcCbGyri07#5r|SMg$A*)v8rj0Jg0Wbia@gxGBYv7Kl37FFEkkN3kji=G6A3}
zL$!pl2kyKOp+py97Ie9lG@mnW_`V&BX~@gtK&Q7BigxqCXR-N`7g?$e-ib=Nnpf~H
zAui3XWk0^_smF|57>7>%VEgNs6YEHYT_rQ}kq;usiR7q)3AOJ@iLlRHi)2@C`&Ic=
zPNFdBBEobDiHR;g!3)U9p@{kt;Oc^h%PjRd_>O5|99XQJwG$1sC#B}|(DS&;=|o+X
zl(bGEp}QkqSTRdg*U*q#v)%`+D}r03)jD49duQOGG%>qvc`M%_ws-Gb`0jnFZr5ys
z?iAm>;Ln_l6jBlOMW^xeuJ+$vyLDk}QMQwGQxKR01_;~q7sQT4B#_EAWOSP-xFUVi
z!)fPj+qstOH*Qd>wuyTF{Q26%zq`4ld*URGarp+K8=N$aR!B%lJNpgAjnzJbTKI2h
zv!8Qt?$Zmv&%?qPYt~f^YDX*V^3aV(%klAu=asUU41MtS+i+MWXk=f0bG>eV^HdUz
zAF&Oz|DE%I{g0fe`A3zFqAvb{g2x-zyrVYQeL51fTN80l6a#fBd_qFzrlz`M_|K2$
zb}sa!mk_WNzED*qv<uN2|N5TQXqa;NY3j_a6vo-tP?BU2hsU6vknO9un$u@LI`-qR
zBs7H)E-n<=d&{kDFRNsoHaPfFRMRStjYy!-{v$^<cbUOk!~9;#WQ@jaNfGEP4nDmZ
zRlPMQ`A|!l@`{R7x<G*AS?O2Ybv)B@aNy8HO<um7<g{9Gog6cwq1UL4knC=4^%7b!
zew}0{RA+#8o8IYuCh$md8pBzQ-6j#cfu#IC@-5}5`~43pLOb#cjdBy3VLz{W*39G8
zX(Y8fEN1ityH#ltoPjV~!A(u66c|-(^!;umJU^ws8IDzQ*FtOirrN3zg{vqion2k=
z&yM!D-v1~uVtO^nrCKTe^`m!ZW2$U23jd=QS65yBv{lXtr!onto8KvLK0LNAZ7w1&
zhcHhC$m6lc-2Cedf_;2QE4E%Q4;IKJB`5E!Pm7z_gV(#{Cd<e7hD|E}RfqEg;0riA
zxC8`Z*WJLAR+bAdWWNh~xi+cHe$N#56I`_l&9%;$y@^I>2qL2d;tF$e?s|PBW+OjF
zfSgD%{QaNYehJ=fU<TY3K1&K+{m8A^S@0~+yY1^9VLQGI)2xj9N&5dH>@A?Ou)qIt
z3<Lu~2?G=XX#}Mk=?3Wr1?iHI4o4~7Al)S;-C)qEgmiaz*Y7^y_TTpT?)*7tJKNdh
zc|Y&G_Z9ax7hXq4r;$!>3?Y{}Iy%zS)Z}#78=IJbf8fy;k7C4T5TBW8i-IA-gh2Q$
z6bQEFu>8EdR~f&uRpQvJ+k1O=<D5^LputC8-m|ECkpVv>BWKn|vFw95!b9hvxB)bb
z(OW=aTAtI^J18KW1tQk1IZZN-mWa-J1rRXm%D0R1(99<Dv+iQlP85gzjt3epU)A{(
zU->f}_#^vc&(vzo=H9ya76Fh(z!()iD#(N&Kup{l<?<3F!D=9eynQB=3HVuw?lcjy
zNyCc6Wybz>_8oO#BulvRk%nBVnvG5An+L*TP}~0dw{LvnrycJuT&mU9s`q)dZoN8^
zHyh&xwRbz<uYOlyi`jN#L&FxYF8cRAxJ-yjxiqS$KD>1UwSv`mD4=QsO$=r|6oKJW
z`#sw6*S!DWF!JNGneBHlfW%X)U<^-nvU$K!PGD~}`Tc!w=PZPu_wU~a7nG=Sm`Ra-
z*Sq>KnQ-bhBjW}Rn=yjyUJo#Uk{*aIE>@^TidcgPTjZQo5wQ5Qj>?LmF=tpu`pz#;
zx8tFxXp2;mK$8#VuV24Hl*`OhFoZ=!SfRcwWYxe+!9A%jBh#hR7MZPF1m)^FR;jRf
zw_(FWgNcW7ztW{#C3@UsWo5hJt9+8pkcPnRA&1=$eO&KcrGixH6p@}!au8$P@lMvi
zi3}TqY~+(1Wn>4fcJq%LlCkvq-1{?yW$Jh@iE_k*gyQclcBWi!yV0h*KSW~elwGag
zl?tov)q>cYNc8`fq&G7Scrj_%8KV^z>?nzxcIxW?kuwkYI528jY?J*3N-dJ*77YxN
zv8tD@D5Bm{88kabdqZ&2B)hrLi~<Rf#l^jYy|6`{_|U(9dG36)r@p>^p;JCG^tW{V
z_pEu`)?DQl9EVrX$qut_7U>5EVb0Lor&;#Tb9Y*Tj}{-^12M`E5=UU@InQ2#cmg-k
zu7B`~K_)8es_9XXwE(E9DdjfNIkB1wL{X0Nb}vMRqB3Ftc4Auz08FXRt)pN-6cB=?
zSYZ_k8ElR7D(PiROd6Tbe4d08V<jK@y-?6|un1wOv+c`sLuFTSH#r>#gb<8c8_#|y
z#%1zXXHx!qf<ud_y*y33P8=i4h+)g+NGJ;9W-FwufPThdWz_kSAWh1WI3?SkqrOb^
z{2zPppFA3lVt3z<+>GNNk+@H;KUw(AqaB`6X5nS!)ZwWgoldLpunP_3{1L)%LD`Vp
zLJ}FuqFa5yI80>9i;qtT`emh+7Hz-LSC|jzmdB#En0d6r^yBNRJo-%TCZ_At3OpFe
zZf9!C*LdL`RLQ(+Q0CoP<snjpi`$(43YW@{RD0|Ght#2WF&Bes^vw<S)v3?O=y>wJ
zX+2~J2k1pvjp{5CO!}q&Ns=*@;MYgj(GM5gy=7M4Y@j$<UvzR*pa~trK<T`;-mj^z
zpZB`SCWn@yxwl^Du^fQ#IgqE3N*Litmzb2jz{CtbDhy`;27xp9=xC{~?fBSQ8WHY5
zNXx{?nAm~K)ILS>6(|M`gNJwyWDvD@VFyPsGSJaw(weB|LRB0}8Iz5If~et2+ZfR9
z?=1B%>=-NLuoM9<B~W372IcKv0;vX?eTAH*S%Y*;#^A!ei9Npuj98XH6WqME85|J6
zJ|FgEu~QM6xO))t_#WI!SF7+!NVpK?oCji7=#ijYsFzS$>aFV41q?+pUA-`{IxV7`
zVoC=Jc)fdyS9J&mbM7-76ad))r{Xd)i^cG#LhK$REsT&lWRQA*q6LF6chnl*Up?8?
z<Ej^&DDQ5r9az4cXkg}yL`Y%gmVOeOP68uaXSVY~qm!47$?U8u`Eys)oalcN&kzF^
zvF!J!%?w_-?vbeY#Og7dchT|{QQS}6!xbjbYdl4b$aF*%)c;D5C-L&S{>omINw(c&
zooIfK&LI*`&Akp21&>8fU!RbqWJkLRV+%A3R_bfHY_$?iy7Fr5%S|i<*5|kaT%Ti(
zQo(H|F0s}(tPVED%L8(Am)dSG22?v8SY~K7)W@YIy!iNW%K7*p<j2msRxafDFW9YD
zqS5ZlW-8{<JEkgWcVUMFyoq3NKG;fU=G5d<xOM^_lKCU(LY^latQ<$0^#Y4pbqvzx
zEP*yuka>3M(iKola3XIn4~FHBj2v0Wu=w8Z@oi3(#D4^=juvH*o_1c@?HMI|t?7yU
zO0XaN@(SdrSO+>aIaE_c>X`8gx034bH}-4VJQ?eW`n{59Nu+q(+A2TLbREq^x8>y$
z?hVzP#u{^ZGLE$ng@15uSiGr88kT_K=XoB>+~+H$&8o^&9AG$dLmtCKdQGNZgl$^6
zrPINQea4-M8wJOCh=g{|L{Cg!>XQ+!cx(6&(;^mmceMnNH~$Gym1hLwr@Q6Gqb6;H
zOs1^UO~F9s<3YlK(JXC$Ih}Tznx2A@miBdQSc&z<cP>v51`BydjLTLZ(EyO4xtpm5
zlIj8J&)lvC$k%5E3v@5EIq0SDN^)T*j)6{Ii8oS`5glsk1Ir$V?C4l>2k0S}_VyMx
z;pFcWhs#V|JnkDmQNcUoxKUdHX9^3zlaNyBX;h<O1OBgnTw?p+>H?3O6qKGi=?qbf
zjWq-a#H<~Ubh~&WTZP&v(Es6ZeD{VT^y&Tvd3&A~ZpJK#VnJCijkq=Q^6r$1e3cI=
z^W}aKc5cHNJKSvT^1oS~;~wekWzzw-<Gl%WK^ukn`H(8^FQ55`jEkB|1{X+2O>iB#
zeE1Vh*fAui;_x|1sn5WvACH!T^8W($ho{?ssx&ZJpkcs5X6R%6Xpk;F5Z(31C2wqU
z>%%Iz!2O^>soHu<_S{5%G~xE50%kZG?oJ8MYj7Vu>-orN^pQIQ0HV*io}S_GCds@8
zwM(a_4zpaAA}jllASxVz(6;Qoj5P2)Tni*^m?_Zv$>Sp0T&UAV&)>}PhUf7Ec_q+_
zuMF+8&m$<0z7kUv;MZ<_e44<749`5=9s{r{+EB&vk$8&Sf^i+#q>KXft0;@u<)KgE
z2Y+-77g+Dc*kQ%>6qTlaFWQo4sLlE3fS`kENOO|&PLk{DF!tdd782_f3mkomw?A?x
z2hBu4O+)ZDXYhvCp><qS^%XyLifF}ZPJ1~hl?OjRsQxxl6W<CbZ)B-3j4<*okX$n;
zcO>h1ky6M)I@7ehIvVS3I>IgrbJQ5C!3yt!SwF~@ur)^9(mG|eJ^=$NVr!d?NeILr
zxpe&V5r2HH(XaKjH%M37*(33<0ktiMhp;#ylZr32RD*XYu)5RS>;Y)AeU6cB_I|kX
zcfJDbzC;M`we`K7xu4Q_vMd)J4+;~;Ch8_@xw+rp%uY1QRt`<cC=>x!5wMBkMlb+`
zC_khGlI*e7_lXelIMe1S3T+d(E49z>%Dwi_yPXdxMo6CRV8&f~zKapfpE~*WiU&e+
zNL*EM+z7&1KvAtrctFsmw!wgHfY8ZRAtnY%57kOo=})><s(sk2hzUKwwnP&s7VMw~
z8w$C8gv^Au&y$&o>i$)23UP+c6j6IJ69Z-TXY2VGH?FgNQ;#gQ-*w1QPhqGt;*Vr9
z3n+jt0SCd=1ARVItdFN#Bh&&nocMq_%FeIzo*wXmg^nM~*T$^l=7u9grjo6UtWS{*
z?DI(3WHU}bD98348@!-AgMD52Lq-L13tZQDD$29a@ryNo2D@}N`U6|g2CtDLSz@;<
zJ+=*7#H(y?s%fA)aH!sm#;`{>V>}p_slI;p1<?pphkO2>a3VzZ<|EmPZ=?hxR^_wQ
zDy}VKfk$Y1LRuwHB4!ku96i0TuyE|LRf}w-K{6;st{=u@K>(~;C1NPzm)#iF2rdW5
zKbG7B0lMk$H7#kL8uT(+PuY1A9NZ<{%xJKcMjt8<yp8p0tfUg)?{jk&&8uwk$rmmK
znfhXnS~toy57j>+YdN>7t#Q~o?cqJJ8Wt@U_4=Oe^@xt(Esk&wawN-KFXv0eU7_vj
z2?Wo1E+l@=`&qR4FS<AR)8ZknVhQaiqv8U25Sc{(fR$?sT8hEw3C#dGbQ5c;ODWb&
zlkmk3LXj0o>6EoU9if3h^vack<HM5KB|;#vWOLKf?%+8H4e_Ng5I4v}p+o}57{)ef
zRbDUOs^@gi$(>JQs5X}6BOFxBnu6A`@R)MKnaT8y51h%^^j-*_FI=&H*K-2p>`{v>
zAtN<!CW0L48N{1%4&J<5^_1+Avh1s>FhY+*dOj;PPxT2))#7aPq5rx02&3CXb04Lp
zLdaBaG5Azh%AteMQ72Z@DymqP2nZ+_<RtyHJ*aPid7G0fiXMQrVJ4Dd?0(7>DA*Ak
zf<?A0h(XsA9UbQ7YGqYG-Ukr0zN3S~^YsaLayG{UBs0~suXkqnF$O<MsRy5$6uS!J
zB<M1zf<Ep!X9B_fou?lh68%SwdClE@UPGwSECs$U*($wvP>{tx{)oz_7wME$PN|pQ
z+E8u?Q?SvR-o>LFFoLFhJZ9+rr=u6hv(NAL&^MKkRU-~p6zH!}whSt!jPdZX+h&m(
zZzNAp{lam6`}9-8d2zoVcz@kY4~hx(?Z<FtsAg1NN@?-dr0(#}YaFz)*TpE52uG#M
zD)t4cmYI`DKNR1e`#H{J>VWqkJmiT=XLlhpf?=SP6%dGhqWBaap%$T87JLCNo^&0M
zj!nczC~bUal(SPyzDIXOs#x(^@ZKI0L3(FokQPAXOWH<8$+@}Cpm<0iAt(Q=Rx!o4
zdF94uj1s^%`rS6SRKHhqI@)ddb2Tr{&y!CnX;T0WNE8t8rtHo5MUd%X)+kHA05A;q
z?i?3*P$ES#We2?Ie*yyxh9cpNpGg(h&9eP^08Fl38H3k|TrrU^5CnH-q2JQ~aT110
ze>hV=u*j8AYy$lpJ4}^RnCJ+}IdX*5mavEZZz3jLtV}m=pnfVX!Ao0*NodB=%f)Ir
zvLn`p9KkR{te=1mCdt}RxMzHPeaS}3EP{^@jU{992dnH)*2dLpJ9dD=#zF{1tOpql
zDQu4V7D2t{g~cW8z?-ay{?O*Bb#t4sJBIAJaf(v@@#vPoCRB*Bi9}K8orcoeDX80E
zk`gu>%u$PysRTh1D8TO1CR+fxMJfAq8DtZL*qLH}*<=qc;H2HePGmzy=CHH;SRdyR
z;w{QxAj{-FRV*RVDsKer>fW;g5|Vvva>+<&JkK?2XkeOUKGi4>85m4v`XDH4W}8EK
zH8kSv8M7>9rxD@upHBd%gBP@COiF-z{tP%nqQzc_sdKFxSUZ!6Akn}7w@+%gn6T?#
zB2&THj@5<1665289<W&!81>h}@c=|TEymqNH6?d-XVjU7bV=MTFc8{!9=p5v<I_Cd
z^dDa+cbIB?O=kq)TIc*VgMn_b^=TRD6pvu(;%uRT@*Xc+{fphUihZ}t(B_*kS0UBC
z&H#o%$CIPdqg`YO{8Na&OaN})8pnk$&Z8=JpRG6zl$$-7D5a&c8^-*8;5NH)uXDd1
zO;Eo|I!deVVM+_xi$|-m9M?-Z<@^>D{vIUYyY#YlUf8v4$pc%r*oXVN>u=n192gMS
z&AS;4>NSJE`^gc>yK-j;`LVuk#51h`dVYj-xy`r^`0kFl(d}{9n!-m<-^5iN56Pr0
zksU7e=LKL$jz4jvzy?{Z0S|ALdm|``u{?dN9#Pw`PcS2o*6d=Uj8?8Ej188gm2q-8
zmh%;q0QG0Ox@{0kBccsnP^&kJct8*mj*nBY%Cc}tNmXM_tt@EW_J4;lRB4Oj`zdMi
zHi0=9!@)(_jwvpl@gzghAKzZe_tE`l`o6M}4=CYE1}$0NtYI%6;Fx^bKyzu%eU$a1
z=sKGTm*3$MKEhOTvs5x#VgtNoq!}#Uf`;3(qG#9u{h5B<<>r7Fuzr2UuRBStct+E?
zU0G*3;%31X){I40Bo=X7JhJ<CjR}U!BQl0_C0F$&@a4?wEy|Z_cc$5JqC8LKPbrw|
za-i2Z!_4DZ&P3#3H3rM@+|hm#1Vk9O%t#2v^I`XRpk;Q&YU;=n7nKn3%*%sF74(G&
zTPCMQWod<Y)D;*@vNrfYr2qV|-qf6wq~*}Omi@~}5qKE|bEC#rG|tK<|9_v9rBd?g
zvo&gW=I;BgWxIgX+Stj1aaU(eLLU`Wm#OndHvVmh2zu8|%R;o>iuyF9#-lgw6JRLW
zKf@c5+6em4{)v-}7i$7+@V>zS$WWQI9el3pa1fDcj4pT5f{lSpYr9{5s2uKV*i`Xo
zBdVy0yxH~{JEs((4maQ7U(748L4Yvl`mDcZ1mSg~b$6SryWq-t*kV1@`>MO0eACLL
zKXo0G7U+gQ_K!-i5Ehe1_a@L&5Zl%0Y%<+28U8eGZS9v-IT?>{I(;ucbY7h5cAN;r
zR>@Vp@uTr7^z=UZB9t43FtlML3mhdNT7?Io0TfZ_@+Og_%H_;p;{qQa`($ueBDN;C
z?XzR5G5VZi@!bdcJ-azfPaAa%OIM4MCD)JE5!uC=0}oXsX^)p2{_PPiLUxKg&L{pi
zJKK(C-DzBa@j$-whJ&v6&-Q6nFXtn+>7zx<&7WX9s#&i|5EGj6=YWyOeJx``xV(Pb
ztVYk=ao^A#^e1QIoD(_Pd#x+zi3LF~n+RZSZ(u4dAKcmO?DC?M0rkYrErA+MmdlYK
zm!L~FLv6;AHm3BFXrzu~v3AT99s8&~QnQPt;?rJ+8>7##(mtVPN^^xgIB0JY+<vc#
zoyIIoVOCK)<6%A#yv}6>2|H|rBXORzOKl)sVHF+JRtQ-=xrBa^1M_@HcByksc0$5e
zD5R8<VH$F@e#H4nwT!9_JuOwdjYMJz%J@<1S1~?58yD8?iHIjr>y@@i$r+ZScb{2X
z_vBcd3tptS5uv<Nj5G*wQw%jeRXYxf4C)|j?~NSDsYp5S;M{q*U%OsA9Vl8!VTGyU
zLv4#2XUw#|lFtFB>{O1ThMn*N(ieZpRJL7&n<@Urxkqi(Z>%|^#%ueD-e2l^hshM*
zD4MF`D+5Z0R4LB$1%=NigG{Fyb7jeg^RO>n+|g;#VFyr1e_?RjH!0Z+a%=CIG?7qq
z5H$&7Q-(1<Yoa+i2BGfud-M|o_IUIxP=ow~v4VtzXiCPGr|(?^v8*2k6~8yIJmZ`w
z9=9!oc-)w8{lz8&-?2Zs7mgn@r>!}c{$N(TrIBf*T%-~Ivpkwnj}<PQr<UX3!m0jz
zcavd#`RV@1r%QpotDDA1NMk6|xE)mpYY>^Y5VI!dp}#_|y8HY0f&v22W`>%CgoK)!
z`q?d071)9CH?8!g&NG!2QQTRc;nt-q_Y_NRdlO=X;~2hxavJciBg$tGLV^K>B0dB4
znX`dQ^L6n<_D2X-;LC!|`2$?lZB7-*lM#8EB>i7qDeJxh$Rpr0*L>mze8f|7@)rXy
zT!U(+8*{NT0d9f##(uM2FjD0GWndf`ClPf$Tn@G~^DYjTV6zNY&ezTyfeX5G2|cU(
zBo$UR(nLk7wIMARe|5c@UauO=SDM~Gi(XiOzY00m!p@q~4dJWf!kFhgUsEdL@ej7!
zTrTkA>Wa@{$H&F`?fdsp@D$&<(}1ssxUFw3btax?`Hta?R_eoH!>QSSyv_Ve8#EV(
zdw55+I}juhS%scEvQP<NpddMXtV?$vB)BSOAmWTfW2@-z>_#UKg;yUC!F~;?`<VLj
zzrW~WYlLyP0Rq*KW#uE%(bId8;F8h2Jayt|4YC|~uc3m3&cl=)rYGN1ZmCF#iOqQn
zva!=_#VxLTyZ33bD<-Fa`wN}1th(m#BjW2tL~q5|^TJj1LO%FSE&D!xb#*lqZikWq
zc5mLiQB+j4v9S>oyWt#<Ku!5Ri+Z1@G?uCZ%y$;Tp47?Ek23ZhxV0V0Y(~sk1TXV`
zEFhbWt=r!eR8m$}1?3#xP~LYB7tt`EJ1818ocv#VGSfO|!P?R}J2u9<wg2nMorBhg
zLH$r5<Unj=vp_fdatkTR%n=+?=tuL?K)Dj&y>RN~Th{GZ_ZK)U^=3h-DJ{PEYa28Z
zS)KA&sV8H92-Y|)H;0fvvtB_Zz`a{)TJOV+a9mVf$N}B_V6oEm{;embKvv(!#YKQC
z)Gxed9#btfHU<tm9kzv}_N9uu(&^erDjc(WH^{t@4Ova(*FsoNaNK4RKuC`;&NF~d
z1-d4y>~GY3CLRW8gh?#}Fh#*Gu)H7?*$C_|j7%j%`koooJ?R2Xy+QY$Z<}#%P8(oN
zUl_#1Dq9)RSDZK*Pll+js<bOK$fsnJ>AnWgQY!wr`T%VTdERTkj{wbP%R~kX_?}GV
zgUBFd@0+_8)@>E3_EK_wl@HO!LT&lE$_(xY2^YeP^YiWrXCNHpdkV(<+k?di$AOFE
znWA^_@jq+Uy#}O_#}t7v8%&8wWmug`pE8M0k9_jo{uoJbLh0q{w6`_>i+9$(gGDwm
z8+L|lB^ok0_VFX1vt1Ej8GXJha6;bHS{|a)(9j(G9A90PtYL%AKcChBh0pgcJwZG-
zE^5lM=hDo{PJ!&UOA%>gcfB+j3h+hFlUx?@n1Q&R4}db&eMMlXpP&CxdG%_zdwk5W
z(KUqTZ$BjvV(^=Av-juUlSvi|bXodT4%*&dULX_C%>g9mAb?KS>b4_9a0)^n(rgmJ
zrUsq@e`#!rkHv<)YoLAq)zy^=uY-H7{A)*u=lx02glw0l_SUOvl^h+9L1hIEt4pnx
zDU8BLA#!U;)v{e3c?*>l6eWiEKH{Y8tf)b%bL$|0!+zrt24vmeP(M)iv=&T=YAx*;
z_i8wi*Ow=zJY~vl(%ArW6HnXrq914t<K2zB=OmT;Ds6+So&#SrF)xD16DXq24H8vQ
zfZ;0+9av!a^-KV37rCVz03u;v!wig!_%!NT(#34Us0{ZIrFWt^RJPCT8~P7a*5{h=
zA^^lBlhzR9rWI`c@nZ}mVFP;l<^K52PIdZVTA1%7)+47@AIjeAln-GsX)at6TnKkO
zv@$#p!NfLQcpUlaexG#8Ua7Q4_Fj*%O4|w93U_<w_CinOMB%$F(nNl5C_Zv0^@F8T
zH7o!2VR&?n{?N#$_3d;4<s$65N-&SV49;}+k3jJ*zOCW|JPO#mnQBKSzfaylBzcXG
zlP8C8T^@0-;^Wy{*(iKCK2Y(-87|CEaGs~*C!>Di@rX=Dlv#7-5M5VS*V=k_vcdoG
z@KB@1=@@hqfq{WXf8fC0!T6ff{#(;(r$1RQYPz!|v+n4nDK%7EjER8y$`sQi`hPx@
z0^o_@HeerpGVO7r#I-6#pVFY*(G7xm_wDY7cN;0@HG;x>S-mRlXH`-}Sgy54(8-c{
z`=jq2?@o<@!ND!wyJZ9V`I3P~1ByO$Cktmo#T)Vs5CRia*lo+^8ER`Y_;{Tj6%Zaq
z`b`fPlJEO9LAj{w<lIIQUf6WND}MFG^~18=tWT3ktH+{;H@Lds#WB0Z<h?uAc@Fy;
zWI*i*%eV5yT+dEV1>8Q8*Lt^y>h}EwL`@+rtt3*(?rclR4hDJ>sE`ztdKo~c)nT?q
zkCs9EDq3xB#5Gh6JzQLW5oMOWZE^Q-cNr{ku9l*DP@H&_hwUHR8mLrkM92{RG@*o<
zEVT6&9X)+KI*{2ZoOhnwr%VP-;wK@qe25+>_~1{N$uy7nSC=o*o3!e^jzNuNFno%v
z|E!LiB%)Xo?!$v)siE%*;na_7g9!nCw?Et|#0aTw+Q^g%DR3sQ*<ljz8!60t*t1yC
z@1+R_;If*LdDZZFfWEz-2z1cKP~VK+wJGU^r*oeXUi<IK+prhnOG}*48FM*@U!}`b
z3rqxGkO)b+|0&r{pA_S=HtSXU-S*SI0$u;4q@;=pw&Sf*%Xw*dU~Fude?KjcH5A4E
z<;t_u|NakG$%5%UK7^};`WNV~;2dVBrID(B&{Y?0@M}7On%+r@PYEY{^75o0EACTR
z`BuJR7(NE)?mmtcA8LCv%Lf<0Z*LI-8=BlmQ-d{W5{3|D6Jo36nGAn2GrLn~7OJT(
z0sZLudM&9|OU<gVGMK52Bp~FVxG6n&hUlymPEyE3>6)-xFMUqPr4KfE=vxX&<0t)r
zEpKBTC;^70nx~mx$SDpWDS$k3$)6!U-Kb$9m;0377ert@s3X1(IWlS>xWYCX<nMCq
z6BU?_5?(7dQc}PZi@U61He5d6ts6=)?FRCh2jsUQ|LlkVQ=HtME2v<J*TXV3cetG4
z&NU!ryzbD5ZRU0cgy~bJ78_ek><F5nYpAhWRgn6A92;p0wDdCHp_%SINi`dc(&<gI
zyV~Hrst-4R`TE$%!lmj5X{A%96xBX9;MKk4L49M`nF`^ihg@jxu0F@EM|@V+2g>&j
z6@G7?=8!Hi-y{*oTePxXdRnVLW|MX+7yvJ^TVBpN&vFE_)3XbC5mkZQVg^pQte~9>
zFbHt&;nC307>$pQhfr}HMHvqKbG{AtI;?+IfyoYM#EDgV^>X;rdNF}Clhli@<)#kq
z6mY{x#IP|X#PHZ0L&Y&?9CGQk=Fnp-dbosLmde6g!X-5|x(q1G%d#<0jDhR<45l(3
zw|k<lSKdxVW;&D*F3KDaYq{h=U8)JtXQ2ibQk$-h7|+q|&hV4WGe3oLbWszSq&wq?
z1<k={<i9VipArv&KZUeOz_qLEShXgt(8H<fd@-wSCzFK6e<a9l6=~F1ZP|jSLKQkx
zrz!RiSDZRG=&~B|?`u)YHsjxmbgt{IS4zFC5*Rkn*ceb=Ww(vw=<CT6N26iFc(q+V
zgv&&v|1dCG8?>t7gws+fg%6c#`)%*>4}ivgsO-_%8D%7$KOx&%>q+tU<7|ix9!lgN
zUhEAveHltLk2Srd(VTlMj#<oPoF%vowK(o+!>XcI+FS3B6fBdJPZ?9S-fha%ECKS5
z-HdgAUL0!_(nQO5g|YU$FMi2xeb-8R;&J5c{4;m?MQ&QxkZrr5RfVdxr1<%X{S{yr
z@01+FixEPeEK|b?%l2BjkC^tHELWy6ZY)#D+nKpwz9KKS@?@IWWoab^AkG_TXjg77
zA!G<yA3Z@FYd`S%{mmILV|>G%Ob+vJ6<rhazOxzrGm1Wg{}v?csum2ziQR8*PfZqR
z1A7H`8OY;7&Hbt_Je5Z|JbWg2A^b@cS<DLq3!vJ$*PV_B9E+s2i-9uS3S|wHzoyAR
zA>4)^M6+G2`67TW3d3FpMEX70iMSkfn$|cES%QwTWK%qh>T><Ej{?`%6ve+T^f*tF
z1m3(_Oqiio;nBSeXwv-VNY(ZEO(@k93Q^WcDLHXV<Ktof*VJtG3p0@nU404zHFK1{
z9;FuCw8s4Nk++kboW-(H<~zw{9tyRn3kdzdM_W*e#!hxZ9JZ9D8vOx9|Amw&uBA|6
zVN;sn@&cRQ2>Hoq3+Hts`qfc;btrd|F*v`Mu2&5>z-x@NgGQB>{AExShfN1em}yg4
zt9_<fo1Tu+m{Pv!vC2{^3x6CWjHF9CQ9wzhO3Te&z;E8QB3Fc@or{+jQ_xse<*7>3
zlfWw!^zEA;I6Se*0+<NKX)8qi_l1|J@j#jirgZHN6C)jYem%k}X6nt`?7>^Kc90N~
z^O)t>Lb1lazUxb7sZh%BBfx7_$EvVIUNqwFh19EnzG8i%lGI+Xpndr~f19{^pSDOO
zRB6YlI)PWNvP}vjQy*vyD6$r9wHiy4Eg9Sm#m(mZAeeJLviYO>SH@<=L`%ulYtXp1
zgl9@YzgGTep$`rU%KJLm{!+6iCb#DU`s81C$Ujla*8`|YK6~LF1nN$XBIJ44)BaJ?
z`95Nu$3iptG#Z?q%?8~<J2I=I*1g~WJ1Lt*zkYxN;ql2wWprpgX9v7p@r8k-K2?zY
zlD9WUBt{>Lk{_BzGX6@kn?FIf*XEhPJ;epY<B%SA8B|-ZJkaNQIF*xDdxSINZ1+ei
z{l}s4&=>2+*|Q@UAt_k9^}T65NX7ol#kf-r1~uIbA>;<49G`R2B^Q)fSx{XpmC8>S
zA&q*s@|}9(cPL|~Kk1KljFx4@uE`Al1xc8XTUI5)6qjlnOBgH7$hhKbrw4^x(L!#a
z29%vdh`hmA`s~>(If9(yZ|))inmq-*xHyi3Yrf7bB77_&Is7Mxt*cec4o>^nFiRsl
zPyI)|K78%-c-Ff2%Hvtf=v}%U$1Gkek2ptNBQ5+Ew}?EtotUKsc|ECAGLZ}{LY3Do
z4@JnccXv;J(Z#aF&W6eK%FS;&RcWZ(7H>v(m9=k}wa0J@&BgX8n*GX3knO2<Ou9qU
zd7CDtTH(<`erYw_wy8A`poprg3efGZHx$nHWMOGEe3TNcDuN1=LA}ZWMG>qF%Ymg#
zCNp`OU8$qe#%U65eH!y92aCzV$8I`>a^irHdO5qQ3FHx8H<7FN${j9VC~5s9*Ofl~
z;nwifr>svt*l}FDTDSo_WE4w7Wh|6;G$F4MC(S03Il;?N-4*m_Z)>}5&^g-8s@;rq
z@TxsJ(3~!nATP1GBWdK;RFTZV*w<SJb$OoTqcxv&JPkNCSbI)W?@jK0EVEtw#>wz(
zK5#eUN0|zHly4#B&<DwpUs<t-yRJN`*=4gc;YaN1OK?pJkl@17&tS%lvMxv`X$_zx
zzqY6-YMD-cirdLdf8SS_sB3S7hrq4uSLNGn$oU^xe_I*T$Dq8prqfiPjW()+(mGqL
z+myHw!G92;?d3juEMz?8XBWfi7(jAd<O^cJX|tclhYtZU(SZKx9kKe><GJc@Czhw9
zCYNw3<tr5LDw$+-S>wiV<o?P}DMjw9?QZZ|TK0p6&wk;J2`<#$i!IgO5~ipL)<6Pr
z<2$_YY91c$)g7Tt8rWXcHR!}g!J1%7$r1-cU2u>@Q_+=3;jG4y1$_g9h1n9<(9fnG
zhCjwm-NFR@jFLAJ`JddreNpkM@jY?Y@$vS`d&jDuWC!ldWO#zeM`c?DVjA^s^TQom
zb2)ifv+{7s>iqXTcz7pGDQ=2V$5vg!i;W>%f(yOi`oK@0hLjo{8^Uxoj%?o>BGEjt
z<(wXF`#s8yF^Xc`X2{iPH3&<e*-Vi+HjRAd<R1}bO|vAU{+M&?1}m5SWT3$J!kKv*
zIZ*|b&tC(t@OHGRo_-;EM9j&3wlI&*76t_t#_qGU%7I>=)32{zwfylgbTs@q=t+FV
zCW(~Xo}x!s=OW&$sfYA5&qmB@OaH*vxR7`89UifL31e|wzcd+#64iQ|_VU|f6=n1^
zu6f-s@)hO+xs{+mb@ixui?7v%MvK2#Dl6d{f;Ezr;36ArVQT2_EjZp8eDmscS&GD{
zu_aSUQRLR=g~mYV>KnA=^C6)<A1)%d(n}|&S&QjxFN9_oGzDqcTvZ7xv;7(p;yk+k
zF=ac&58rW%+w=A+G07E*@DzKN;PLMj6q$Y2O!ArX!ezB$GgQ6x^#{-y`yR#q`1|rD
zVG$j3a}4Jzi~AN_k)Z;0N&3L!*sIm7Y)myhEAz@^l20b4R%MRmm`=T6zB0N?rrhmP
z97WrbfYzBTY;3?{wItchEfPj0;cjIm+NVLI`X*g^nrKJm7cQla*5Id6TIkF<W=ht^
z7pfw5kMbdBbTJnuJOE=EK^T-e`W5rT&Ql$M2XC$4swD}Z*8YqO3lpEdqROiY9Z3bN
zh#CzAF+X^+Bp7vNDLpVKu-mp&PyFYhTdj9@6dCe9T)99{le3-9)K~o6v08e7$JdYX
zp4o^&7jN!Zw;Nv`<dc;I`PM6F;}yo=wD804hi#R8&hBaZ+AGnDjMm%hCr~VGuk-V^
zDX;s}+&vRjM_AoPrGKyPU<spx>4WsDR{{Oe#UeGM^nAw_UaiT=GD}SqbaY+s(NB*@
zlVs9Ts~$-aITpk_SVUKm7YYS_b3S3IAFx{~GCXDXBPr?DeuEn`TuY<)`T1;n+u@F}
zMxJKbH}|#%|J9@>kt}9gb7w{bZlv3KR~qc3=$vGAgqI`x+M;r@l;nHE9XX<sCa=9R
zGa`ZP`go~863Y5ZQgXiH!B=Lr-J0XtPtQ*oVOh*hS;4_^PycK_eT^QPpx$ytu};K>
zjz^@Xyvs@_y`NuYV^gO7=nSWh=}Qsayl{!N*?a8d$U@S$dbf>2`+Kq8`tX-O!d}CX
zTKsh!<QVnfIHT3*<6ub#9RowkD5tS=Wc@-<SAVcN#JHY*PSar*+I*X#stk9gmVSQ-
zV|U4@Q~R~;dM{{~ONBcq-xgNpu>a1}^XjsGbHdgqb8m93x~Zvn)9MWF8n$VXt9gmk
zl!M~xf@)Xdh!_@gMA2KIm3*48;Qq98zDKPW1(&~_U_kH6mp`Vrl#(8p50~F7gsO){
zsaHVjC4c2RML6QfpN!IL9X+I5AFlW;>E~NByI^nCOtH&)$w+*09lNkVZ>dLf%YC#&
zAeK2QGK9(s-qcHtJ7r96t63Re8wPHsqPrV!`w28*MO0hSb3Sno;}^x6MIvZ*thQHx
zCX+}bocc^SUH>@nbzf9)XYor-u8z<*7+yUV=4wIfZdCW`D_v)5=0W#ITOzU;cX7>E
zt!9Z0vHYY_gTF86<4h1SBpv?Mcxz4%e<w!Q2aqEu^v#etntk_<b-qeTm=Q>8gP|_*
zX!&%p$?y$%S~E?J5n9njQ43JO6&}U%GGd~<*M`JJ_W{E^w|mr}a@CXVc9tY%paMr7
zcaibKz!GY%_%SKJt;}M8(RiUNa)S|+jo@6%szl9c4p<sZNtH?9=|9-6fo2hUe6_F2
zIOgX{T{y_<$yECspcKFcrc+>`ItT|fjjv%nO>*=oeqxWDGolzM|I~hPr$|Kya+8@E
z<Xlx2G9Qvm#A@<aHRmNtY+H3z_}Os@vSKf`L!F_!az7iJnoc>H$qa?E(l<8KtuNay
zySVH)t@F$M3jg`})syk0Pv)Mi*m1d3$5A>yqgn#hgLig>J7P!QZg6h4XuLPvo;DO2
zxMOUWwcY1^y_jnUy(cBvYZ%@{@4GgL<2+l(f4z$ni#TeqVil+0%MDe73eC0dS87+R
zP5V>iDn__=9&n9?^UGN6ErqI3q^$SvQgz;*)_;y_5w*J0gNSoWF4bu1R8D>{yTny}
zQ4<-7rJ2pbaB@amL9#<!w__kxXO}B(q+*tvD4NSOeEC*mrb3J!#(l4F)zYys5VP+S
z>nip9vbuHLm8aijq@6(f_$6K1+wjBtgoDXWPHa;jTtwvnkV(<$&8=uGGL<QwzI4%w
zeDn!9?(M{stAYY{O>#qnCBr5|%(YJKJH>5!EjG5sj0_CevBGWKawa8I5kJc<`U}b|
zW_&_2N3u+JHiZ`7PPj3kHR5xG$ko*LI#uUyojrB=`?KFT*Y(BRTy@tz5}Rlo)%Hdf
z()?PoIlLMkw&Zl*a^9IWrVo;D*|m0nUiSoi(5!ov=?kA_7?xO-;a&DB8@tyaC9l;S
zB59B7CdR$#vaP}}WUCoB6eud1p#Af<e%Z$BM{Z@!M;3^v<crOk1^?s&K_A?`b!-eu
zq(-SXhD4Igjt7sfd-D(wD61##_7i<<aok(e+uuk5eP_mzUCoh>SgYsmD2;slJ0$`C
zxNoY4CzYQiZML?Gvl}u3ucOPYCivWaAX2zCPru)MEh;@AQxlF}<6RhUdUx99n*(M&
zwi|&&&%dfwGsZaw@8s{cDlJw@tz?G4X-%GP4*mmUhGKK}Y+;$MbBWUb{dq<%VchVN
zmnX7XJqbR=&eK$<fAq5V-Gv93n3twM9Zh;+%joqkcV|SXB3qP|e)g}ywYBIN|B~Qb
zF1y@Za;2=sG81z+)jd1U-fFzO54MgvGK6vFaj{m2DU?Z0sM6K(zZ-OTaXHg*oxCO^
z=xVMnw!Ts!pEC6mwb)LTH8AWME|$GE%F0!}PB1mGfC%cx*9!RlJ&EWMA(mdJK8nw1
zB0Dbe(-IRy`E{?t#q!duAj4PGckb+nOqdMU<P8(Q9AlrAqzb(?`PJO`*eTN1`1{F6
z%92`$P2K^^iG6TPAIW*$>Qa5vc-&Y#Iq&|1&{kXHETK+V$wEt85hXw;Cu3uyUel-z
z(9|Hs;o?<>i!%i8F7TqhEj@r6Z;fP3*R!6@?=I8YB;_M{q=2NcUjh$%I!sa2@&yDB
z8|5%&lo8>ywaUh(;mggO($5_q`qtRSRq!NFc9|Odou*VglWSs^4Bt9tc5N>1n-w4-
zZMneEBCbkG=v`+he3rd9mM1825;72NP9|53Rg?6MOg*3PeRWuHm{`nCuMf3rg+i9J
zXK1D;w!UYfsxoUEckD+yf4u&^h2)czmtQZoMLEyTmGZ2(E8gM>{c}pY=>9dOmv~SU
z?wh^J^?>QgG45OKHJtg1K0rn!0MmErN_$1#<cpzY6xeFdoi4(f(&m~d^5b7N{yw5P
zL&{=QFXY7LE|uyK(Ic@KYHZ}XWBstZr?#6<F6-_DUrS0#7v7X-MtFl47>@5T{|M^O
zR%wZ3$Xv_VS=>$92&H4K^}_gsbM}PXcpn#fZ<Sed=!<{uJH-pn{ajRVp&LfehwFz~
zw;$YpSX{rtSE7F?di<s2;k<OV;n?T>lAV(W&NR|Xmym3Ffi`z*#Z>d?Liy^nvT8n)
z)_vlm6|tecw~Y0zw)?g3=9MzyGMm*6$3J$=%c!1&he=ojkfy3Xq>N=P5=>`x9?5z2
zT{+8YYc95#0x>A8--C*=KF=<`W}~4JxEa*CR}t{VpjB-2a^klL-y~LEdm>!^YwjMs
z!B6AmK(|J+JanWnwaYM3K^f%ShoTHg=q|_OYA_zlg7*wH;os7G;){o<GCR%n=jq?e
zUK(kQ6V4K<Z#V>A7`rF(<3}5N)5+-%*aWiVIfyv=?oF=u|30XX+%P`fy0c??C1#~5
z!#f;jm373##WAmt?UQOrt{sZM+WovyN^%N;C1fNUg)cBKuZ>FW2T;ac!_3D>nVlOn
zooL*j={M1rDKRF)0_l-#Y{^F2W(j$C3`9jnO1pv?ZG%TUYi}-a7EoBj?sULj-3N*c
zsZ<!rpFMl=5arv^|Nr3d)XbYFgJ)^lN1d{I?p6?r@8OV~<_xd4)?!=7I0k7=)S4i@
ztGv-(MeumFJe7k=Po*S0dgtm%zTP#MrM{(CPncRf3N0fqwSmAvL<5&Hs4cQ5;R+;h
z;u0sbc|s4t?QC>76^y=b_iUgrgT~<wk=wrfS#<go&nZm%@2}Q16XWNo1hPcbOTHoo
znw><ebO{zEHjMb%3Z=J32a0vJhidS#XpP&Bzmo>XHF(1lYKsQ9s*w6%X%Hv!Kn~GV
zq2%Y)y$eU`UL?ovi34Mo%nOW!MAKM)h)vCB$ckq%gTejR%*OPkEVl+Pi2C+nTujE1
zj?0mo?$>XA_js#4EgE)2=zr-I=U@9u<9uI@lN!J-N1Q-YBk6zUVrctey*Ng1lE412
zpzGygzWwob+#`t0rjYkYm8+evy*gR%?5xvoC_0%$jL#Sx>FU>{mX0;eqn3pKHn`GP
z->H7p_gb@2j-NpT0{pg=xJ;%e4?>+cn%-|PW6bcHojqD_`fS6m<Pjp7;*9G&gRV6n
z;ih+vO0KOcU44kLv8e2C=W2Ytd$tDII6*)#%I`)@!T!&@-#Nsil5bpf8^<!JoBj!#
zC-IVh46g~B50Li7za@g*My8NgIYeUL*{Oe%9@Ey2LJpHsS*1hU*bjfSS;Qvm?!y%-
z`jPUtH#5tv#IszU;(KL6A8;g(?-DumAFwaj6reJBLvNmMt#$5>5`lQQ&Z_~d{Y{jo
zC&e|s!fGeDd5HLRWA?hUk@ptbPvW!>u!3b*Pntqk<9I$g%bpfa_&c(0*pu`9)a0LL
z?B85w&))0R2v&-+m@P!C7?WxFHD4gKn?CtH9413Ye&vMu=jm5PtkO%Pxk)~JiUYl$
zC_bDzTd$J*@wj~9g+jV3z)En*K*-ClYI4re?kNAe#;%k{_0B2-$B5NY3O`%iWw!-s
znL60%(J--Y<yj6T6Yqpw_p7ix+Q?Dh{5i0VW-~k33^0-4kiEpYV;vOw`Zgt;!-7vx
ziM@rF`{O7dqB;DRH+@Z^h^47V{0#|-;qJWKjn|>Iq#cAy9InplOUeb|w3?P=BSRJ6
zYg<}&*f|`P;8tuTz@X$28hJa+A9r!Eyb5;7n~hF=*d<!u$DjOt3vU(WX&M;338lc7
za)rou#yz6ei~eRNtJyc@hiKo9NHqEXwj56xVNH;b(!UCkzW#!t&TeCF7<ZU4zKQNQ
zupIhf{Wy%YTntS`8`tq95+Z>$9PTVsf_u0tu{+#*@hNb`sRt^2Mnzxw#L~%|grUJT
zh!W|^&JkM8D9>)QM)T_>BrugvgB5?an_LZz`uLF#!oZ}zO~m;gt)GE<?BHtW<mAlB
z$=TW20Y-eJ+OYzmUtFWGw2arf{D6GUhFcJg)#}GBKKAr?(L^WhNl_KxE<9a1ifeEF
zu>QQCv6@3yRb>^!Vm}pz`tmhmx>BKo0ZmUdC+g07>!v^AI<sR>9flvx7UX8OwB=Kr
zJsj~7ja@SO0JQPdjzizXIL7e~PTTcwapAhRDWQBoOf&Q&A@IKfhy84|zT4Vf^HjWr
zM1*<o-aQ-~oV$00;;2bUNweiE>~~ilz=*$O{`mQa-!04J_(|jk40C<lf*9-Z7tK*R
zOou9}+xlzbLS^c1Hh=h;$8#9$sPo>G^RE399$4U~7vZIN9Xm(M{zN|dup)Z@s{E&e
zXEib3_AD9*%kHt5t%nRdG5+nn8}ZQuPdd0qEg**!lp_|Yw4U+t%@1qvf{fA6Yhz|Q
zAz_E#3oCVFd2sgXb(g2kUNCS7#VXmIVJE%|^z`y7H=7g?68aDq7x(`C`{3Z<s;Xmk
z_zq)ob92udP+6sath@N#w_J)R`e5_oLYaSG=B@Fln|s@_Z$CS*Y1hte<)xgyD`P6I
zs2wh+*|`AV1I&73W%(;?M~p%=`<95fF&gjGwL$V5-ibIhrYiA9T8>7&yH6IRdX#5<
zH&FBc3UzF=_LfWHm<;9LgC^K&x)~etF|BD02PuZfe3V-gc@rr3ArvabQ*Kusv$AI;
z;yCAycfF-vy}#)zBjY-)&HWLb|M%hgb5Hdb=x%vlyM8^%KP)Z|-?3g*O$~7oA?5N2
zqOc152z2qgW7!?Ah4O&A*7aKBFnfi~<bpEW=t|daxJio7UA0eEXm|&+ZNnz(*6Wuk
zkW6nwBteTA8~p>vKu=4)7Xg<Yk{5AJDkf|Q9{F8Minskb;JdhWud8I#?T>9Iy)|{u
zLNSRXTKTO$-oFJ;7r_k=i0pnW$0h<&tWwO{8?om%8L>3}Il(s4(%K3oLvzf`NT;bW
zW+ZPRw0rOb=KTE$Eb}QXEp2RU{P5w!=g*%50s_8#d5(`Cm-L@|Z{wyEfkJLp;rcv%
ze*)ii?OL03JAWCXJ0r#0LN;5nh|7f#_TJQAakOV%+*B!-^SHGvt)O_85F{L(ozvvn
zO?x({i@j<gkR=i@VfuKojL(-fjXIMaE>5?g6b{t2w^R0Pxj)rFoR9yF__ZHDe#~ya
zLq$s)#Hj#<3sA3LzmA5+fw+1ruRVA$cb8l68msybDObM-mX~j#Q#_(c?BYNJ6Lizc
z<T7dB9m7<gyTjE>57@2rYn^hF)9>cpL3)mi7&j-!vYwW7Z?O=OeTSp@-mVCS&CDbF
zhIvCo63~)JjEK)RLLj3PtVMJQg5Z?+{@;RAY9eA{VyKWnO}zqpMoLNwL>1`xP#f?+
zN9La-D(tv~Z)f&(M=QGl()Le2cTZ1JM<YBbS6B}pbJ$bE)BYMslOHwo!1AF4K8o>s
z0`n8nbTrN%l`^7E8pK5ExRjmwdJyT`(qep5CH{RUcii^1#(QQm)}Zh_3qBlv9`y!C
zhTzRxFj|h_bj&0zU1OTqwKHm4D0AkTTk7uF9Xbj+4|1--!AqxS92#y<On`S30kfmN
zup0Tbui<!F6cKT+=Ib}|%~$;<y!K1mz0Fmng&~F7O7wqbl7H<py}yN8X9KYH3c2Hn
zUggqpTD-0|Ij+3vaa8SJ{L+;O%_BCd?Br|Umk^sutUE}z;B;J5S1o+H?3^BAV6s}R
za`WPL`DSf(gkiQ*EL#qo3EounxP#tYQDcR^xVIq)kV2olkV-j`9S!xB3Fi6j3h&F=
z$3D*?B3`L;+<h0I(QDU@Yoro?Qgch|e?ygh#HsX3y@GGb^pO+Gs)vnrZ=lI+Eb3>k
zUwvB2518T!JXm<i^Myw_`w;kmvdF2vJ^S|#9TG~@>bmc;^*Nll8ru`|6k6hFj`E&#
zGVz7`td3pYzXQL$nS_1E?0ATF`Q^H}b<$&R0L^H9B>^aC!hDA@!}ELU&OQKs^VGed
zM6Fe3ySRrnOKZK3d%gsnCsnBpgMKxIdb7b_u9tVq0!q6Ip%6j$;--pV45vv{7?u3$
z9OQ=p(f-szx0eWnp*MPaV9ZGT`<Dyfj$`-!ynExsHqWq49UhSc8;e!HU}~Dd&8;nM
zNLN-72f4Lzw!|-A7pEvCaxhzsI@Ps5sQzcFa~z?skJznmmA`kJE8>*G&pY-GZxl(B
zWeY9_hm!=!3UZ?QV`7!qIo2meMU1TUs!Nx?R9u9uO!sU&5B)Hfzq5Ms1>&4Zr%Nx0
z5`9k46RSML`o>OrzK8$%t=3+pAKo)rm0!6LIs1P;(U35}Z`IH;SgWh^UZT3+*}$h#
z7&!dSY)5dXIpY<HwEY6Vqj6_-e+hxFfR>jiARc!Anvco?_8PO*14i9bCwU2MHpp`u
zt}R1KUb6PYFK^r$0D>t7#JQ;Ndt)8f{=NTw-LI@1-Xu;d3+EE9O3|CQPQ@|NR}&e#
zg9Zxx=r8&bq2DBE#Uw;Do_fiA78t?&G~TIo8?G*1e>W;ghaP5_>2o)REAPf#=GA(u
z@KTlCI`|M|#D|Qer9C*d^ZkV*Vs9R(fBF?2<^ImdsJ7ejn8uQTcq*_X6ba@d9s@Eo
z3zX=n1g*UP{v7N7dV)CKPp<NNIU+S?KazKQnn}XWVrD$qjHxEbTsbOci-nP_Y{2^@
zqlz8X?P*67*YMfEU*rC@BMlRIa@3VxO?K($^LpYmS2X1?*j@2ewp6iyJpNM#Hci>p
z>aONpNdmWAhMCC2VP3XemE5Y&FTdJm+HR2^ixJCGGr?xm|JUTdv$QNv;|`~O((hP#
zeECo_m%V0UM|*WFPn2lKo|wPxLlsgZ1l-WT(#_y^;0xjR*_K1%vn0>(myE4pc0SCL
z*IM$TmlE)C?p?9gneeJ;=WKdrrpbh4ei05IBAfd6=e7!oi+OFa;If)}>uyR}x#O<m
zO8*~upN$I4)*0w<{v18}v!7Tx@ihMgZ%6!Q0n<Z$dNIS1fYInqL~b_z*`k1vo!O4!
zj3#^c3=!-i((`{_O-PM5$<1h1Dp1^x%6}z|yd1o^ed>GnIs@x~<?FfVHh;f3330L8
z6&Kc0|Kra;4Vn5_dUpA!@9&lz8;dP$M9Ew6N7@`eo%t5`%m282K1c>K>dLGCF?%DA
zg@5K*-+ai$;nY8#d$?AikbG<}?qBl2S^sA{=^uA2GcsWQ@~^}3B5-@*d$u3$-aI>>
zi1VH&<bdZmxT5!Ct}Z8TS60C1W?huMb+o1J{zy8V0vwvxx2AKD5jk4#S-|+b_|IDz
z$p*Kw^mOkR=dR56S^R^-sEztxCqYjnEn{$sm2n^3r{1~n9C>3{8Zm7;gl8Yvf1c#P
z=Z+a;-dSI(m*{=Ry%|kuEj=>Dy2p)MqfVEbZT+FlL1yXF^DB+kqVPv~K6?IZ55J3^
z+TX6|En(f?EinJo$8Gz)1ra`<9zSvL)-u|A0Gs&Q9w(8rCl+GG%l`F^pPLYnEbSEe
zq8tHs_*qp20@owYe*~`k5C3DY4K)^A@6F9A+Fa&zbe@-o8#l$E7ogISAq(acljJ^>
zDbfE}By+a2pzHI023;Fya8<)_8UA$-AlahCtmywp5f!z<H|6?Ttw;ys{e7_T*fHbk
zKU95TL;Jti_IWH{c+f!~*Vcr~a)Yve5zT<?y=N!K;x%-b3PW!<B<yxnm#&Pk{Kt?t
z*fWHi0y%YgXN}j5IGfuOpVb)Z7%F!hSNx%ymQxMHJ{~TO)uq+T|1t1YEOMIL_;$!~
zr^b^%>%SMxpzS}PH~xA>@cs=BCavL1{_jHeF6ZGk7W~J-tSmUkC*GLUv-%(K8eQ)`
zWzwYTp3@7yHJi=I!HN?d89-)r$@bcRES3YexzQ1a!f1hvd|B_kmxjvzqe=z;ONW*H
z*J3*eb{5Q9$5eJ4ZS;<x9@5m*37k<fZKdAVt=WH5GS71^=V@{l>UPKjhQ(qH)qc6*
zG8g(+fbmEpcyCJSFNR`Eq*gI2V%NV$RlWRBe{K47-cpk(z_4*$(X2Ds=@N>vhdWEN
z+=~?GQI}?%j>rIjOP%?V(6hdNVtxo|Y3@%w2Z!P&IoREFxBqn?A)T&GjCZLpuA~W2
zF>fhZ!**G75{+w@$pK>or?vRfCG$u;e=zUeGs)BB-|wk<-k(ogVjM+O*ueN6<D1ck
z-{Csu+rOd7=lAp%q={95k)dTA<|*`W3bl}1lP8_o4i%C$<-b<?>u@#k12A7R$ouS!
z;^x(h`2M_bIJJ@w`j+DS`(}$_QL5VlAmMBVesyGI)!eOKv(6ReG%=2ds47Rp`s&S*
zidWyWXsXkjsrP5waI=m40oq0_Aov{%%dq^<XvWaik7kY+f3=@nnqhS`%J8|19%eeb
z+tq4_iw<uz&f&WfetE6B4-E1ralO)7wFZ=Bhl3>&F_D&S70#!$WeYJ<_b4gEg;3{y
zCSl7#1vd&;ImA}_i1z!5iEaKHXnj5dNCJ;`l==2%TuBdGt+IZo-+RU?w=_1|v2egR
zJKH<@<t^3=NpOUDUvlzNG!6~CbGR#wPiau(ot-_)Y4e89)U)Qaom}S14LrRvy`OtP
zg_a%m7ZihC_LT-1v-Jv@whbt~P<%JzP96AqE43O<__%@<a#`~RrluYNF;{bXLbqtB
z&A@Zw)IindcH`Oro9T!i<5;byV~J6oh}aETMj>%D&NnYv4k`GQCwy_=PjO!c^h?-+
z`K^J!YF!(d{9^=jp%M=@iYo&eyb5pO;f4LIPuR~=d`3*stn%;zJkY;`@9~W2bw8qd
zw4=RiAI>|PKpga1lX|qWc;suztj{IwK?If19CPtXTSZ<M!^+O3Jan6`*EI62?6k67
z9+X@x4I-6QCB6?1F>CaQtB>-P#agdwk3vV%h=>S-&bWFl<AW{z21BrMq%XDi<xN`4
zAA-F-|Mp1lx5R+89NBHUgqoeDh#l4VceK>LemnY*6U$4qByxG<6s@iG#p4O?%*NSE
zw?HpKpcBP3`OQHaLO-9`B*R;*UN{FF@MgwsY>JR78?zeri*UI<INMF87oAp&|DD+&
zRq`kDe*Z3S2+vn>&1+FOHh(b@#}g-7@YOJ<1{CwOTUM{*P_4DloTgBariCIp6n}$n
zw5|gJ5^Rds5_Wbbn#8jmgFtSFGT9t#G0Vy2sw)MbOuKB+*`8LTWG;^!zXt?{U%>8X
zM@Q_w<;qZWWRZzloV5ZMW@l$UIW`WpQMFFnR-d8<1t`|r>UC}%D)oERdwR18I~NtH
z$pVK6%%Z!S^jdBW2|y%Jb6Lq8n`u+=8M6&d#o8>cSGK}%xdy0RBD7mbq*%mLm5W4V
z_nc36l|)1WAS}e-IlrFX$3z(Z6@z_=B3x(<ZE4xHvyPs6QCS9<WA;xvz3#-p0ivsc
zQgF7_%#E`Y(*yR$zZ=?)@2xwgzZrWjs&2k9B|(v)UX{<DDjhnSErc1bgYTp$pp<S-
zBItLtsrc9#OZr!fAss`yQh|tp!Bd*0;R@rKDg-NW_uhP6YFZDq4zW>H_323qsL*T+
zyzlH52y%h!s>Kz6{XZenh_b%|2c$|fh-f4w)G7;Yde^NmmqraC-yW`B_!|^}+jy;v
zQ66p^ul#-&<jM54w77w_AQW^zEV7pZ?whmz*wx=&WHc+TFDa=Q?3^6dg}77bejAa2
zvTMlNugMzKlUVhoxwHxFIp)))IHq=#Xkm6)2i~jg4Gz+16CX|I@U*PfoCY<69Ge9F
zBD~w@m+&jynfreR+DI>DEt|+8d{c|AIabVk1|c08QGHF#{Qslut;4e1wlC0aC!$Cw
zEl8J0Nef7KH*D!f>Baz5Qt3vzLE@uBy1QGtyZg>h-Fu&X&hOsmx&DptzUy6Ut~tjT
zbB^C>Eztd5W8aq>5jk<WZff}kWpjN`{PJ_Lt7r|W6sTET&y>!_-ik1M!qC=sM#Vqz
zx(Xy)u57Yi_-(Dafp(b9ly5EuYnl0^LZ&}Sr)esPO7TbTKD17as+q-*F!*8A)I<#_
zY;6s<itJ=z9ZsAVByaJ&r=H~jj_G%fvC^vcSAhmP5A4)W!hU5PZtWveLr#I}lL9Bq
zF;EKcuV0OhDmjXd(6lfq8$?+kmTd5xX^(Q1%Tjx*J_tTU-F3P_orLj9uiL^GL2toA
zPak{rYQ5*mqslMDrMJAKnumK+q>GjF*xtz|-}yYE-_)vIcj;QNY-Vce;&g+d=Ht|s
zKg%1TDMa=VSm}Q~Uo-zd&u8KG-_XOkfcKRp$6f*pv-*;2_!l4zuQmHYV$Z4Y7@)MF
zA)3P}ue9);b)GUS!^&I*^Nb?Pc>+15OqImXcWJ1aW=K-9qlAz5d{PpO2QZuU-et5A
zxSmieK19kaD_yu{XiTqZ#MzcN0%s<3IMa0cpHCJZ^57rH==arN?-N*rh01ZUy-jIe
z+V!L9+oO}cnEtX!$bFD-Nvz_lX0I1Hs%LX}A2Gt<Cf9UP77sX+_iDDlq}s~H&|x;%
zaOI7ClruG29G{XP7PhZhwxL)c*F4N<q9mI26yjUm=ewp=@2)T!7Sf#kaCaE+%Frl(
z8nixE`W*in#O+^KWxV~T{|VclLxhpapgCKcB_sHr!{PnYg%?+EvTT`fQCf`$3y$l{
z+z+TVJM=5Vp-M`+dW&y&Wk`g$&eI3SmCqeUNXTL;q;B2ASQ{z)9CC8H&qhfhlkhD!
ztT}A7WLD2i<MYjAahw#B)SW%kLSFaQ)V8;mT4q%)!EFOKREt8a^RYm4Tis0-v&cjf
zClGO9VA5$YlFqq3x$_?}xlPpjztFBf-q^Y)=y$BM9Y=;0O|6?BZ92X)yr=zzv_ZwE
z7-~iBO3RWNbXZYB$DFCUv+{)x-U-8ncd5W`q0DsTYN^fX>)GZi7%UEqSSFC>S8j&7
zdkj;tOGJ;xu)zySKmVR}yw9nn?VJiN4*7rN$|PEVo{xirSt<h5n@TJ5%cY#@439#n
z58c((_E$&7+e~R_TI%(rW4KnKF{oiALxl-GVR%2Qr9d=$a=FXcZ0o}a>t#JD%~`2;
zV6K*~R$N`}K0QlG>xBVk;V{xRM6JSUE4%WJ+4u?j{rmSR%?GkxTIKuYf@K*@cZ}sL
zjbuZ7D2VoIN%O>Lk)G6a6%TIsaF;iQ4~c~R5dWTqjik+f?Knco&*&KUfe^M^kpXs?
zidf)yKOEnjWwJXiO7bGz0+OC8j_7r(g}QvLB=Y*i)B`qs29RsX-U#v%C&|U4O6wZT
zi325-i*O4_9C;7ZB<J2=6HHUcY#jMUr+gdLHcO6zhF=>79uIfDt_!6vAJo)u!wydj
zdjbkNrJ`3VPf{O0c~zL(1}-NPu9cykNs=)()lwp^XT@ZQFc9Xd)#>KMy$K65JU!A}
zA7bDpArUg@=x-TzFoOY?_Kxt%tsxLT57mC(NHH!r|8uU^+2H;uL<qhUps_eDOa31+
zEFeP21>e=OFhVms4EQ<u_Ly`g^B=o44*&+KYp0v^nLSQ+@VPUHl`|~j(<`$^yF6c5
z(_<O1^_s2tMaWs4G$nfUi!#f3^GusfIC>cw0w&`pBk_XK)jwK+P>~Zg4W@~(g0zeZ
ztkX3rT}Uy^Cb;}Ks~-@oS6a;Wf)9HPt9H$BO3aObs}n`9F@1#Jch;sPj(P};6q-Lm
zJTkn<!{azxSWH=NF-u4TzBl^Cp3AG{KEvdkj{ORu1v23gh+Q?6wLE>Uk%G3^FmOnp
z>`pwj5QVx~&87C|6-YSpH(v3^_AS;v!Nl<K{x4!qJgk+qY+~z0NUEa3@QavI(!C~D
zxOfx?h6tz!f;+ZfWmb%HpP@b5>F8vQSd=_E{BiBPUq;j@d!IjB*#}v30_XoLbo>)+
z$C;*x@W)4Iv7a2+&YxQ;2zXy>&fi<*I$csJ)yFdb=sZs3cglzA+#e<06hHnWeR;*O
zS}Xqi6j>bh62g8os=-DgTa2)8;V=9TX!6JU(+>0TO0(6K30Gg)L|>rn{wywV;chD{
z*nBQFXqw|kU!2p^m-UJ`{LS(_Cm^U^eRRT}z6hrDWG3@awEcHyA~Zu@8mV+XUroYf
zbK;WcN%x4PLXCH~hN;h|2;H7c{ARcQS+^736~xDlwri4mVXI29<*<)V78(MaGqcRC
zJy9x&_w3`{+Q+Jc?Hop*s*9v4W&ZGuXJKL=*11d<yVvVwo&4I)UZM^uq&m1l(HPaa
zE_7DMbNyun#;>b?l5FHZBtyTigvQX&78U?BHkO&Te_S&SycfSs7JT8-{Mg_cn(cDM
zV8au$HH*Ye#1$Mjb1w3J;Yj?LU_y`fA?iR`P3*U628;^+@NOXkdWW0OLepz|pgKwU
zO+5Y$!u)X<wa~fojmd_rM0`YZ=^8R|O%(m{ncHm5#;bB$XeEFjKZc`Y+&PU@_VH-N
zintGfeat<o?g0LXox<4e(DRmJWTo|}RrSA-hd)k4<r@2_s7##L#BIpCcpuW^A7vov
zVDnYzy7}>GaNc^sUpA#w{HRp2j?KBu?x43mAxr%WDI^kF>TD~fDWDzq{`t%0i2r+s
zz2O49uquR(Zfx~*nhr202wwvoj#qs&oB)Y@^i*Ue(GRv&k3-)|qNv2Z<(=0p^-;qF
z#+(Wnb~k+Z;-ztzpZ-KWHW2^w++|nQjg|u5bc%Y};G46L1L6)y&1(91m3D~0%D#vb
zHnEK;*`fVO)z)gtY}EUPx{}+^n4Gu}l|`>UD8;@Jh-Ws@sr6icBP~4+^2NuGFE`2;
zzkp;PO8hX6;!3qEJ~L75uH5z(VzeJTyiQsFVp5TNZAKuFC5_O{o_ACGHbm?({*cJ6
z!Szvh?o2-fwzguzr>$47iWDXoDo?Bjn%EbIEXU90qHE-4A!E?;9{3@XNo8%1X2+9Z
zhk-3yY;}0HI08L?e}fC<x)4)dFbqMhRO}ham`c#6QQ`DFtC<I8px(jOQO?m~wJ|i;
z(}O{#nU&`nWQ97$4XYECHTi~@Ks`oY$mkD^>v0bYjN~P=nxnR8=0M7sMFNS2IT(pC
zEes>v)gs=5ip1|>&oVHoIpuNBFXWk5o;oddf3j%F2p{3f9E_P%4JM%fStB<x)A6xF
z=zcTmwzYTH?TIA0i#J?OGpLYG;M>RCh$^hhJ0xfKsy`_L{H3G3{Y_qg;yC-v@{kF7
z&}Bbmf3$txm2AJF5!94&0HaF+<#N{Kv$7Df_}(+fp#3i-fxuNQI!o9YiF=q2!OZn;
zG3e8DKmrTLHK^99d%dZg7V>vgD$fRzl9J$49qtZPRh}}#n1gi#e`q*>;CfFb7ZI@7
z8M`@RUr*mr_r%Ey1q@rVNK8$!a<0M@`e0+r<^_WoKp{l((xhTdCMs61-Cj^iSFk=Z
zju$}8)GIR;I;-e@<K~NR_6z-uO1g||{YNoLNEctmc^P;EPXcX-0*8LTvsP78wqYH&
z0x9CdKVzB9?eaHY8Eq^aEcVtu&N&w~GqH`W=L!y}z4-}f5@u3sQ?av$niZ~T1OJI$
zlx8TD4uYZ{u4ubY&=(O*Q@OwAGSYPgm2$Yy{PDnCyAmWksnBfF><_j)hTSz?`W;Sz
zvnH!*>I2^@Aw$7q&Y)7AfCQzHxbpP`@9k~9ecTG}K=Mrur?Se?uY4csGkCH*F<g&L
zpNXfsoMuDmVgC|@(jdHU)*Bj8*h*$fu06YL`NHLe05TyV9Qnq83E<-&&$HgeEH;x>
zA=%6G{NJx05qRKsP4FT#o46jFA9cT+dOp;@Hi44Ql-_`f3*`{5G1D9%laQ)hmn1pb
zkKsef%J?RYspmGLSf1yw)cD^xN^^gzY(SRG{<<s475iJ5R0_SdwQlOf>!XJsq$1e0
z`G>IRPH3oa8lr!?CHwJZ=!BE(`<ta!hO~a$_0G5GTO-CS4ZHw(P)LyquJ1L%x`jZ+
z$EA?^z7p@p)j4C8VRv$%pzEdv`-d^ndwjOVId5cXH6mtT-+bM)+7<hax%l6gae}%@
zg7&{YdO#mcb*PT?cU7tLqlfSQxm{hKfKANKHdKh4jK5+0^$r)Oi?Rx)flLU&3tUk8
z=0sZQx{L1=8=v<qMpD{*t<H~;e@?8w+xrFF1Oz>dhF^uy#hB<ay(_n6<QNTe(c_WG
z*2rAc-)en`GyaU8{uNaH&>-8Hp&XT??aJoZ&m7++Bl8aCEp(RJj`-q5P%AwF3j49~
zkA<Q*^NGD)=V~{ud-pyBIeTGHseFAi1UOv&4h*uq?x)j~qXo!}%4P9*fQ1-;EOc>R
zx@1dLx^O$fPonN<Y4<&<NSB=9>t^0^`rE2QN#d2duCsa0d#(DD)tgalOseG$CArQ<
zM&HU$yP@POG&yu0$fB8ReP};j|48?enN!(0^r9KetqwCq(raI53ebLl?Q`ns?hVbk
zBp42MCZ9jR_z@=4YuEv#&jU2`4LBTqHxQ1#Fk2wa8?#FHxCZbo!`Akwx&+Sxj3CJ<
zw&&YM8KH^gFq8Y7$vA0$WyrJNV6OF1q4~1?u^A~oKraQC#DBC$RoYKNM}`Cmq~ZZ1
z3=9(rVe6NgCDYY-*%?k{3^J3&9==+S{!nJ1GJ!C5g*kQd(D>ncYP|tnCp&NB*0ND}
zbho$9IP6}L9bH@U<8~1!I@p^P6#JR1=K9Q${O66o^;Ef>1r9#NVY2+m1Eh{&(aoIg
z`G-$Hj@+8P;TH}1if2q(Rluok#@{Hel%qQ8sZh!TX|5ZsL+lsW@F}E7*ev~|pden5
zWh-6ojvp@c9vxJkABzP<AIhi6`MQuxeQ#|y`@|9cp~1su6`S%J3{Y?ZRK-=C=smWe
z;JKq_be)i7H16?6%~LtZVX0;tEi$0wC84BH8!Usa7-&rKc41~<fCb-;2=@!$4JvmW
zh~l(-c=wyAau$n+;Y7tfjJ=h^j_}+eHrC9Oqh-mVKvJ=V8XRtinIULh5I-{NrVOFj
z<~mgaENHH+lA@tEk-KSsHl#15zdG(NB0*d(Kjn(4WLrAD7&KX_dOpP<7W7%-aj!gM
zQ&JWZHSf>3W2{+b*Coky`1!Q8d!lt8cPPenO&A4+H9uB-J#=;#JwHSxJOaz<WKdN3
zxQ&HrAw=RhbFL4%;xs0wa+i+RE9E3Yhi_FPyl37{Ij&=bF`Itf8o9ivC@>2GCmSoZ
zN4CA?W~#assEreujUpVJEHIx#g+AKDg=a@vhL(kB>Q!5~JmVrx0P~%;$OLD}fK2_f
zt?jcF$jVn)uVYPAoP7MLT6tbDdCm4efoJ=$jB%WIcjp36dK~siKo;T+|2#b%_EwbD
z)YN!+c|}A#4<3O?{<C?}Ggo#zQeGEzDh2Y7UUqic4Uf(*SVmD=&j@06r)ph0KeL3e
z|Ecu!`N}pLHfwsauMrU+lW9@&S0b+Q^CN4l;0xe<<>f*;q*$AnbTzMZ18}Rv80*C*
zk;&>g09q82uuSryl}Nh6X%R*xaX34SHW?;{g;8Lrs4&yWBy8mB2H<mXfEBOAl8`(2
zrOr7kd%xg*_KaFvvAH=rK0vz;PAe!|f=Sqfg_8#ZWEh3VzkfbVQPUivknN6+IR^YB
z1545OWtN6@+=WzR#K~}LE6{7BluuU}&C_?WE80f(XL$-312CIrI#N(|dVJ3DQBS|n
zO`)o{w|C6B+(H?89T&Ph6B8hrg53EgCiT}Qv)g>4=EFOx;zt9x!y|O!!Z+foi;4oE
zOK_-1J#2;5VGQz{Bj=`UX8Gp*4;|d+s3@f_r(zly&^zJ}t$p2RU+tL`<SG@N4s{XW
zab!2&&JEKD_V&i>HGU|=ZeL0?p>DiX2St361m4ENm*mbjHe}J#UEPOtUJ-`{%{l}>
z5EdB+W44-|PMFjWY&WOQ-n>y?8T;miCHbRmL9u?kUF7&`+h=iYxKB+`orrU^Tt;Hl
z)fBq)1_;%hO1FrA=_ZFfqMjHaAyf;DzYqUzt0*scs#RB;jTZ4F-vjkfM>MCXkkDQ3
z8Hfp6C=WR^L+>?=NPgXOb!GnnLd6quz7n}*k@usyuU$7cQgfZn996!g?&H+Ktu6Hu
zf@YvQb)GbrdaXb_cMu(e4$H)ZWA;aI3(^?Op74`<W;*;_qgwm1Kd0x;<Of|l53&YN
za8hJX;VHJrc52fon2)z`zQW1D92yn|qaKu^lb?DB3*WG?(NG4oQ`}*pI>uT%4@@P9
zZn*^J9)f2z2M__u6|W}kD3diG(rxZZIKIiYT14Z$nXA)87rs*eL_&f}xdq4@nF93Q
z(s>=#3htA$;|@lX>H3L{w5EV#<8E6ORt5A{oow)@J=>mlDcgX?qF}kMYyo`1WFo1V
z@sip4nD+??u=p**mDkJ9d^&W^E)$okTPBcw8=9I^zPX;?DXZ;z?M}+ce;@xyt;8y>
z{)ZAh_j(7M&fLFG=gZ^^NWArp8o$Ci3eR;*kuyWiBQ#LIegFO)lyIPj163So<BE!&
zZSviLd}ZS6iCNu1d`}J|{hra~Q(Wh@;UElV$h_c6{vn8q6HsENxeGV-5T4+A!ouL_
z#+avtRP4Uq5p*UpWhcEU37IelTTsQ9jFV9TnJRrfWk)OM$aYY<X8;&$#Cc;7a6FSK
zvASXO#Naat6)4W^_A)X_PdS5|t4%rtXOAd%cSa#T@_!+6M<vjp8pwT+q*mMw*zH&5
zaI2-hW06B=7n6c(cc?>3^A1n;D_7mOB3RUiq)xmZDJS$MOR~o%o~T<bX+PL280_FW
ze(^w7YCSr@^ziI1{+fw@`|dJr$&R67ic|q${yW>o+I3=kH)pvzbk=9k$AeP?F7mTJ
z4iFb%<7ZdeoHDGmiZdIdbN7kt`s+v(>9$Z2>|ME4FFh&AjhG}^VHqs7Rekx~K3j@n
zPd^bPefMZ9@DA_&q=?>_)JQz|2}c!s{u35|kbr8}3VU*XUQi$H<;#~=Pd8VF7=ADR
z2IIj~JkrsMB^reV;-gU}qZPT-c&RMV&!O2(PF3R}S!$|oHv(r6wGAmVwlAf|hc`-z
z<7DB=EtH3~k6%|wll#;hMD<E}YamrNPfVbv+<WsN{a#quFHl<Q5`b#K-HSdLFog<+
zBF#ZA<G5o`XSSSv<8yB-d;p8pm0)yAowKTIi6<vEjffIO?a+Fk%7<+EUh&hOGc);x
zbQZhq!A)}v`t3r+p5^x4HQJYsjbSX>Vm8DtH$9KqCnk%|$DWTqe;wx}8=>64hIw$h
z+0aoEf?ARz9?PQ8I<67xcv!mx30Bz*5Db{);o;#Dp`C)_UsHC*IbqzC39;+ZVneg}
zTC0JoE@Pp$(JY!pS6sgSSzr#4<NQ2;P;M7y%Xt$AV|1gU6uZrp1Mq2)?a1Y-7!}I@
z_u@Ct*Q;4pIvUJdFC(xpsh^oM`JE-iq`EcF*58HylWe^%y0W?&6&cCF!2uRQa8p5e
zx`%;5;?jsL*l=X-qpf-|<<Y0&U~Nie1Qg{~d-zfSvFeF&^RHSi?+_G!!|zZIz6hQE
z^;w*jHP_pAz*s<IX)r}P^X(;?D}W4!HW{#4(?`RArzQed6ERat#jLycEqOm;fH)Uw
z3%gj}Irm!;wqRL2pm{BC<GJ{o1U)XwfskSV=oz;u<+(~6`h-)ankV?l(rpXG_GH@l
zz3N-!^PA;n7mA3sgOQ)W*c*39{rBz<I<6_PW?)>T8%&6C+&44U(n7;u%Lvfo=i9q!
z0X>`8b(eBWc0SwzmRlBK#7}vS?BOs84GMigzT=R|cyXki8dDb;g~C+@5Eh>#G&36a
zJl$_;Rw|~TALspPkiu#DN>)~O*w7HGc_!wf!N=c<684v!KTCefTnBS<g7A%*T7(ak
zpEb6bVqEH$SvX;z433fTD)0u3Y882_c1>$zr3jVGfPni^VwbO8^>BCR7ZC6yut1iH
zHzx2ayT43<<T!`7y1@bsQI<3PS?S9K#k1jbj_oggvJUe1AEp`B1eu>Mmxqn#Xy5m#
z(D%4J+hw(+#SvAZw7F->vWMM7ukCOnX9~uvEM_B&<mc(s<<3h)nYN{iD@t|*16y0g
zfLdzM97$2Uq#asdies=-9>YLS|Cu>FR}q4DrzU)zqR#Hm59)!44C;)j4t?jaA8C?4
zN<c(h-r9Dn`v>&RQB&V!GCiU}&X9oh%@qxq!(MDFEMd7vn=6P9@I<ZX(_w{&Z8Y&J
z#V?ZS6cYGln;?I8|GlG&L4^*2bb+r2HZy-^(kTC0NX^5Y{CG(}>4LfQvk9k>r!@Jy
zj)v?gc{m(ZX1zK`0WL{sl;?#$_Lo2qID6p{<BJME<w~97y;bNFC@3tnwYJ{f+ytLQ
zXu;g|ONPa@`%qjw{{)YMV+r*hl?H!^e{%(&bepBmZR`MoPrWg0X`gQQ<xe&jo(;8G
zIUXlA>)paix`F{M{GSD-DE*RTv8ESy>O5yWPz)#ErluMK`O4&}^rd{XyUCEmJeBLY
z3<E*Xvg2wvgLp(zNLQ(3@zwe#d3q>`X|TfAXWzapO^qy26>Ehw#vB+^%Ei&*;?AE;
z^~2gH(4VqZoh<362!jf?jc(Tz2*4PF&BO(HWK?%Qeap`ScS9$6g^1Kg43r@%A!a*)
z?U0%}H@82E!!!i_)`ZL1tPEQJz2ZP3@{njc%hND1g<@6MK?lPvb8ZDEmOcH;p5~f=
z7qQ>&U;S0O6Q%EaY<<d^Tx+2IaGLj8Y<ZY@!IWj+_PC}LmpAgMzfmd*B4ICs*ys6l
z<9ohP&e!TNGx!JMF}EMLQUx9!^%^b*Z9jz_+FcRTJI=%68I6Bn`wZuO$+KE&B&zW`
zb?icYD2#x1_7&qnH$`VIC%c{UeNU;w{!Ggmo~IARlWFUFgz3?s!@dZhngaw-m&zsD
zK$R3)y;2e&fqwqLu{=&#;+AOM<?+*N#Uh>GA0Ruj0OkS1^JlK(63XLnGcI-K=~HRs
z0^~tSA=h})9Q3}dbKHf(^q~(rAqI_6thAHgSWj{Tj7f^BNYwoF5})H)waOj5Vg4cY
zpLeMHX%%qo5lV11ABLdc%+U(oyE$1NZf0hj`VH8)>FLv;*>}7}MUaU;QcIW!98H8w
zxc6*-;@tU$k-!LLfb(<nOtrWkEGmuCxmNuBNM_R?ko(A4tPBPNgjS|joS$DI9&yyX
z28>!>E_Tk#8Y+UjRZbP$#8RykuMc5F3N!;1zeO_Lgo<APP*|@>t-^w7F_>nd1<Ia`
zy?X@ut~%McM0!MsWR2bsfv>L(7^9{thj>Fxe}0qaD1iF+R8=GN=+rGdmG=FicU(3?
zmKgIR#u4&ojXDI{yHkn1F#1AQmA-HaA@jvMcq-1ok^%Rwe7H8|3RhKlSQzw5^|YC;
zLW5gY78tw;kWWaG|2hZ>4?a2Wrpdw@4Iw`ipkpb*sBaarqqF*GfgUV(=YNE0y)seh
z&F!z-=%i6v5kg1sXI`4>zUU#<gN|r~ys!D6x8ofT9aEKZM)y{?4Z6Tkd2yohQcxhR
zI`5&K0x$1(EKRw@E%3_jh-B5-oVo$-1HdUS_N5~PJYNnLD)wh6>p~+DqYE5F!;|)?
zp7AS`WnV2|v<TxzQqFgAG}9|({sm4g!4qI9ho(oq&YJs+ihFk=?<(Sc`Up@FM`APJ
z@a$rd<2bUvPMARBh#|j$w%L#te}we5(c`dByhSiQ^0fy4G^3H6F`%Eo;bd#tZf*^W
zjl_gQEiN%c9d8<R$VE8NOv2`zLsYC)hu$VSnC<Vfz7kdm_zStJ%ia)~9I}sv>edy2
z5z79odUn~9m4tQzV$uVNqai8m|G^J-%px`h8`4(^3wZMJJO&-t0%ZAuWPl4m;n(hN
z+?pb6^)Eu&Y<;~7J(#f_B|V!{J4L!$W1_wYY(5mT5r>~&I)xsF=>U{O&-SM#$ex&F
zM2kx^oR+yMn@a&SII)mF?9+l2Gg~edH(TpAPCrvXmsOf}nKuY%hH`~XlsOd2Y&+g_
zUZ_8SK^qd0-_8I@UCBOK-n<>=2lK?Bg&!j=5SJ}qg*9-J{`TQ~jP@X(N+bv(z~}pv
zH_vz=G6*O6)k`Q2T>~n;d;xd(AxPl-U9~?=o|C#&`iz!s4g>^&ltIDeui;jS<~m(B
z3vP-gKG^Osq`QI~=%ZE_wEqE^TUhc*Kgy*9C3;cEx?x163*=2@uOWYMJ!Mi3<(u1j
zC4H#t0urBDZ3|@f+!zCQ4}d%ta1dJv6&^#$cDlhg1{tH%>29)Y(rvq~nFpqqjgWE(
zMP^5K7{Jl7)=~4pmj7$0?9>)a34qr0_oe?qpuZ^-gW96JhO5%LH&LJ=KT|rlcx-sq
zLM9Z&5Et90KH-a@lYQ*nG^_#SymGm%gBknMYM+JA_bLv*D(zRECz6s5VHj#@%djBT
z)e`T19$M^e*Ww?&aAy}n0}YI3o2~PM3S3Q1Aybv52KZ&2gpgcHdisrpE+5qbrA$q3
z%kwkc-cv;USmip8d-Xslr^^bzJK#LiByfR@7rho5@`&(9d*LHIdyCAF^cw0J0>pGk
zgF-j!Ma`_FKHBlJLl!RIN86L4O$N@Xo^2x8&{PyO-8tOk{?0+43c1(WOGy|XLZ`ld
z`(PtVC?m@-b^dEmUv)(1#_c9n8IHLJgIsBFm^LmrKRm<DW!iz|%Hc`z1aSS}buJ;w
zZDS$|J^r190i1${0;;Npq{o*+_O4;i_h%})P-Kr$*^Tm#jg6iSi2&^Sr9qLH#vQZj
zTtqwi*~@aHzI^384~g(zb2#r0o!67b|2kSaR{5wH;AVMbocNHz!vOs)6$8-}$a!2w
zVc3X;qnXQi41*@If!y!#`Lh-$W_2+q4>>sL?|L6J+->viG~@mI27Fe+)(U(_12OEd
zdcoZ5DEEGTuU<>b5GuT<`B!ino2KHY4I9vbNWV4v6d7FW8L_FVQi<KnhX%O#LnOt7
zuK$Tj%Eq287o41QHH1=Lt2YJT0_(b^f?5Tn&`)rG@*vmOP!_u<oR?&3{F&dGW}4lp
zu+gG5D1t7LT=8KBuV6bI%GQFPNBA=d@4VT|YrZ|x!HY67_J{WA;)d?i3{L!%JgY;c
zlET;@LZ*A~RTr9^d1Ju5zI<IT3|CEKrBH2{{$;@Kw8`IBTl-wMC5S2+s`_V)y&CwJ
zt0OT&%wZSa{*Y|(@6b}jk|2u0)o=5}^uovzo{vApQ|DC!CzYEtUcuz;7kDwIN?=z0
za|PgBgUV6*cDJK#am$sF%9T{Nb9s-nlyW4;XLwl`Ljv!SQ_Eb3QjT=I%F0zaIEi&$
z$<7Q!(&Y}opP*i+!J@_W6T3Gj@%w|=QR@E-Cx7qAhlNEWHgfU*_vn%Xm7jMUAr44y
zIYHNIb9pm`<)GQq8A=kU7D@OUZqiH>;cKYtOPVTaLvHBK{LI>IgC@O?wxA$7VwFy|
zH6C=e5aO9$Yr(FiX?i{Fzz$%TCijh(8uxxJ9I_>dkj1}a9i`5r)R+c)IJ6g`TB>&E
zVx8KC_cVDry>4^J<T*Yig@ML5mvj$y$&~<hi=TZ<L^O)gx81_LmSx}r4Dp3TT3AP&
zR#_No61U}3b=Mv@XkPqq_VAbff*`9eWB@35$@1E_Tc@zafYz1yy^CDthwK{eO<#3!
zx>9@dkLMbsF%vjji;;V1Pmo<>m&uD-2IjWSjka8GFlc3N3lwL|s9@5338s>~3O&@;
zNSgw_UvdZ>$I?`d)d}OJ0b^1`Y_QgR$jr8^Ah7XLiA7ETPyhMsBs%ZkfzG9ZWe0L^
zXc&tiLRsZxaIF12ie;d=>Lq!|{XT4CSn12paU;m?zgcNnnRn27>0fAG+Jx8;|Mc^{
zJ+?t?zA_WUQb16$Y(WHSd}x7yrjZlI1sNmWxIq;n?ie=Un%$P_W|3aVHIw_1|Jma<
zqr0_T{-`oWpvQ9r<pJ3T*LUxeZqJ@y)oVA_=JyX4YDr9Nk!|*ujKSaE8GQ`?kxFKU
zCil@U4lc2?X9pTjMxgyX)fSN_PD?*^2Ux$)!-OUCKO<58_#DzyxbK1XyLnRu*}NHf
zLV;kNl}a<AI5Q`Vw`)SfJ5rHQd1^hZ$xw28O(REyL?Me5rh@$(?r_asYl+iBXF5IL
z=mW@fz$1taCY6oW2@xqcvHv<sz5(WvcnmBgBnwB@Az#0i@2}Z6B0#Ra9sAefyJY`+
z@hi$%tgLG&RgC|czj2027%z7CG(D=HYGm;0>N-bC`lr-SX-f39pMphU3_#<3Svo%q
zc55T%S6@kna%cCUs?MvHj(2EO_nuMp!WiOYSBX>$BB({~i#NDr6VYsXGqHT>t|vJ;
zkf_<vzK}~-Fa+>)CRhZNjF4DG;d81q$v?S|WSK{Nc3_bQ{Bv?DthmHbN^DFY4a@}s
zjB7GHkj2`9K#Gy&?d?s2(=8$f%^yK#@_SoR*8F=1PmJTRb?H9KM4XOJ%(hCVo<3}N
zI@_}0`p1p?vH?u(I5WXBQ{^rDSB6_=|FZ-50b1OwJ8Un|&xYNE5r=@R5$!+qFeg(e
z1ImJ?Zo)NLE#mKY1N^+}%#pZXDHXDwm{HDsRUq=9c5v7;L6{6B_~7V+Q>Slx)q<5S
zlFQbf3m|K-yS=ztE^hV*L#|RzoJnbyO|Wqj9=nS^3Jlbwfp_)8x6f6M;xwijI0Gau
zRU}=VT5*;#XM#6W{;za>=;v64-|4!?uel(iUKptB{tVoS5u6!^l`h^YC`SM8FHeP$
zQll^vfeHq|5yLBe#F+5?btg>gK-Q+^6Ldb0=zRcsrM2keF~qVTnWQg;Xg}Pt$yD%4
z_}qK`Bj5`up_|ND3n-Jtd)p>(k#U9$=L2eXP<rkoKN!Z1`1q-7+w>y$iBt&F^NfS~
zI+t5775+MQWPkqqegO1($Ls-g@)z_I<Og2jt~zAL+;%;E0P|=9B6Rs+0L@!HB1y@_
zhjpH7Ys<>T?`xhaSZpUzIf{Z6v4-v138#^qAK;NQ9|)Ex9XTClSRMDi!CVofNYtcj
zsuU>a$D~)ATTpIU;xaboiUj$kC<EYNGQmX`uS8GyCl-y>LMLtYb?~~>*}k`Sjnm#@
zrGvYnGt}fxUz+^VV9qBm(cyG0#f;GIbVcKWz&m)@d27tfUT$9|ew99i4NXhP%7*UF
z0fiPqUO;1If@;0qGZ)e-PfWyD223)t)AO;V^z1Zg;3-fT7dMqab~ic~1%7wo`QgX=
z=aw=?Utt6ZjnsGVb~Hn=L-9N?n}x1`vw3cUQ*KB73;1=LXPeL&Y;gU8%-4J+3YAfs
zXZ-JsU)xfciNCT%MT`7=`JFM2r>YFO0*_~4L1pko(=Pwf^Yb~4P+E4|kaBk4Qn&T_
zLoN<mhV}NfcDy0mIY;*NXMGCZUS2m)V_u)1y_EK6G~stL7iJtRb{yE7#M#NZQNsdp
za<9fP;Uaj#{*X~(X9;AqvXwk(dl%7?A2`P4b5$IN^6ZGd1=XYRCG*EUiH7HbL<G?i
zVR;yJW1eJ^6=mskq<X|5xU9L9jyBvbQQWQ)IZa*h=}&bwl6WO0{Vraya6Wj6=}VzN
zJwaEAE63up@uOQVwJe2FJY25#ou4F|1Nh{M`wk3xzI?fvM2$$Lecbi()d`4Y_o-ai
zJX*sTUKM9&+xp@vmzVc+E`R@yFE{cnmRm9PA#=w2q}c=-Z=~PSGdyEi!2%2#RSyR(
zrJS6ulO7_3KA%dt0|!QPeX9pb0EPR(On@Jy0`+jd;qLA-S(7Os1y&~q<MQdjlyc;f
zd3sFbmED(b<B$4cpKms-R-W$7e&vY?qL4KJ(=7{jBi+`}XtW@}V4CI0Br;;tMvEts
z(Y-7lJCy4*8L)cqo*ahBr@vcBX%41Q%hh>1jA%i@9h{4C^;N~$-dRko^AhaK)=V|%
z@;f~h-COEAi7?L>ZCB|ljFZ$T`*`OLz9>75G?D8_fpzMOTD6KYcda5Su+XmaAz;Uh
z8_MnsXSzRwXINV>l_IU4B0ij&WV1EnB6n7YH5N2rS~pU--yXr@UHZ{q^@wz3y!?4y
z<}+e8XA!P+IST1CxhjdMi?r&Voi9}G;&_@=o}O&GNSj4uE@YTz3r{+>AYkm>&ej&x
z)l9AYLVizv23qb&0ZOD}Ev-Akl24d#Ah<1F_KtBkpUp9&5&PHo2g`zwVMIGMsmz@`
zo_t%jt88e88&=H;nL_VpEM~c4d9iPwAFnIZq8DgQR@-wO{3s8idY`2}a#({pQna_X
zTE0TTY^tK3(a%r31bamKrTb0(RB_sq)j~Q}e}P^<f*8gJu6~s-Yi6jGHMm^5^;9?K
z+BipZ{Ul3hRQ2lW>Rz$p&D42KmM!-r4{R!Y`I2WoI>_Ih!5Tc{{u-I5Bx{>4r8GS4
zy<Za-=@xJScEeI%Ix7ZD*-%yo*HqEEq6dayPu)GSIt1xvu5GDTRs@)vQ7JuP(Ul6!
zm&(P$<xs%mD-O`Ia(?Fj;Mq5yBs>H;KQwL5^UkV>#HAR)^6!)==V9-Z=rmol2(7YP
z$HS3(vA5!aUf<+@G&$s;Mcy)%KnuGZg9;PecaybR4G$l<Wh|+#1%N&su13#7t*5$M
z_bP>sm(oMR(qP&@Y08Lnx?~I{`V*}eWW^#MP3uHMh{*jlfG0PubcvUZzx3xNF;l9o
zF1_~1s)<USXpW&nAx1BaSGRRzPd;0`4GEdAdN0cK;gP5*`O)EFdpMKQOvlv-6MlVX
z$F>_2s#%GW-&{^bJU6{ASl$zndVs7fz7c%+{A`VFN~uON@=d|TKR$=%*qD(UE|iA#
zOq<s2o$3}!#<S5(HypmpU+ih7FZlF#3}`AKLP-X^tKR(<ruW@1)e0vYHPp6iD?Rx=
zrM4%JCE&=$aI$C8p0AZ=uC1BLVc>JU7xh5#Vo~0nX`;O?3TC&C#m*5(FSrQu`ml?)
z?z7kx5Y;0K-AG?VYCL|6l;myEO84hCP-ig~yAvy%9qB?iTwUhsebmGIMFJZoak5k}
zYDuu@Jd(vDz{@_+$nkyV_2xkMrdSvlCkLCtE!-wcUGWrk;EW@b<#4b;&a^i9C6dz{
z2<^?q#;cF<a8@PghqVR$ve0G~vrI6IdzZZ@XK_dJ4|lra@2d$_mHl|}qE>7d-+C`|
zQa)y;C8TCxAi`n2>OFC9N3mt4r2Bo+9cjUERWX_VEcNY6mmHOZuApR_@H<FnD4l%j
z2-}|Uu{}A?J3Cd4;VgZ7{6fwLZ$x~o=F-*t*f(%Yqzha10~z$0kAB?2RpNE#5BpZ>
zDooiLOtamSoZMSwWO%zSjDdT8VmwthGjpN#=W$K%3S(G)Nz3ctHi=Afk0<2>-+~wB
zD~gOL91-jiMi-(e3%mWQ+>vDILlulVP44P-u+w-j^1?A$`z!GmRLNww%)xK5uB*ed
zkX?pw6qjl-&U>J)r}&~5OjS60&Dhv2c1g#VG|I!qO-#e2G1^jf@%O<sTpRLaGp#Es
zdVoFBGa?e?X-L%fF7xAm9ky=sN0A)G3iKr}v~FBhRxN0i@xH~7a%%|eyEiIh^m8zz
zi(cWkF~o`+ZO<77emXozD7DZ{S1YyKBsWSE4lp`lW@Zi#NUv~KZC>376X3tnvbx|m
zX}Pn#-Dju1J&&sBZCm^a?bO-Wu8%CR(s_SOL0agL45PqUQ4-H^C^|=>S^-o*cbQbv
z<ang(3itU1%>zyOeFonoTvk$V)bGvJrP=kHcR5}arK6LawI&c1@{4WE?N_ksFC2*6
zC}*Mw^^$s5jkI)pbNVVR{yS(ci_rVqQAki0D^+teBCbwl6MSKVA-(m?<yEB^R~CDc
zP5U$IzYw3Fu7r@7)J3rD8>E>{xY)<X>XDFRPBezHtbf=!^5eeqdZyk-mhq*{u;-Ls
zLymUo|J(9$IN33p4)=O)nvscryPLiI%wfm4G9;Wq|D%@Lx_aO@j7Qu)k_xaZMI7Oh
zWe!Q-;Ix5BC+H;84f}A}f9JN}8a{o6$9|PufJMlxHZ7D^9b5V~zfm*4iuLJ{1Z~$u
zp@*V#T+@wY3B2d-z%nafE#>I%hz@#MeJ)G6ddwH-1;e8&q+$=UggO=Ayya<$MfABl
z2`oj-D>>Cnb;jcLx*wtN2O|pNWGl)s-PSX&M6u>oXmEyleKve~fCQRdp7lv1t>Dyd
z8qa(9d+czl=G6RXho!skVB>|W_kR3G9>)Hfy47@jmTI9!mjC0HcbNcXzEsoQ5~zp0
zM_%8+i0v(@ieB2|He^V(HRHQ=RGpdoCzX~OkOSWrl_J=da&GU|e#^+c+n*WHc#GA}
z?lCw;F>_}sXEq0USsFjRa6$e>C~J*yJc+14X=y2#B>Tva7We;|Pk=sc5tx&6&S|~g
z9_8%x*(!hOPp*Q!)#a8|B@Ed_ksF>5xho3Qf+&MRw4B;;D-mht;(JZ`hBiYC4v$Uv
zWqh!80~NVN;`bJr@ZMB;XWA{wypWRWAQewLJPx6jPx~4-qOj8W=#0!`C!73mE<${&
z_>HDh*I4e)ea2X}Yo2{&(lK4ISJZynCFMaIzr8NjLKKDv5?WdLAd7beZ1cV+e)}1O
z*P^Yhntx|v9<AP*hJtO~&Qvo`aQ->WGx}8F0asKv8wd(5`}S5XXHl-9nhDA?UQ8aq
zqAg=2v|SC)zLD3XP-bIFRyo^5X!*ZqHn*9V5YEXA&ZmzvO=J4)Cu-`d1tu@+ioA6i
zd@o?95{s+c!)^;>c&wbO!|yqBx;t?2p(6|&T!(Sb&Pe*IoJ=?!7=uP~D3ip(c+nZG
z(>|e7fn$ptLc5`5rY)_4X^70cHadqIky&IUe-{x+rFbF|>w}|cZEHJC42hqWMlb))
z;=z%F?dou72@!cpGI9xfDbD)Yc28Xs#!9gQY4Ij<xVRSUeU^7OCZ*dHusQ8sxg7^v
zSQH04wCZ4$Bh0gPCmkcc0^gv4Frx633?S|McrVK3oKwX2?YQ{=xhv0#T?o%I7!*Sw
z%}p}(K3~lXALlv!*W!+U%shZ=L{btpEu7o6sO%;D+LSbrAheyM5Y0Ol#4W)-U2e+8
zRBMCue$zt=PG={#QK~TvIkLe<@SnVtGdMQ-L9jgLyUrjgRUDSAv<ETV&L;;(((Ufy
zx{r0k@`-v?N^OV`Cz}ndXD8dn#lgG#6Aj%-;;U<G{jq$Pd~TrMm2&r6g-`5d$5l{b
zP1P)}j8Rh&IF~w-kSr;=NfZYu=_FeEQNK>ipn1n*azy6A#$;C@g)DjfM7?x@a;Xg~
zEiANb(oS+AM0MwlAJ;>a5Z5VP*+?rNV_Qn+(@{a#U0=PwKbX3^n2eF)iRM_`{Nv!~
zs;1KhS}$~3Xpmxg5b4PLP8uYv(UE@PA=Sghu?ew7gA17t)4G)fS5(PxT#PckRj8n7
zu;)Hhx|64nuQ|+)#}{eD^vHNu01gnsXtOdav8y!cq$xlaK57ajc?wyGPLuzaab|N3
z+51hmBq{teAKastrI%pga6X#QRy;eHmTHe2dKPWUkA@I7mrW9TeOxe<sOEaQo0v_(
z&9Q}d@4xZ}D(1aJ_l+LOQvOLOJ6gk;0*I8aV*|4yCauflp@<qsB}J&Hrsj=Hr_=3u
zH;%EjrKP8a_|W}U@K(-`A3423r$@t9UOVfR`iBRC-V2X!9)d5|R*CJpZti1I$yOL|
zNuFfXClhYLhDRy+rCK&)(olXPeC7VFJu$n3+t#sdG9#V|m^4%Og}Avjk8Dqmgw;}z
zCRV3P_NT>fj!gNFv~*g6mA}ZSA*{l^%FLF4#GXl889GgA=DlO`YOs)n2Z98x+$|5H
z1i}Af%^$~W`;<0}cutcxM#l&YS-KLQ{qZ!QUo4<TC`OW?<m^R?8m-r!DBSs<QN=39
z!En=fz^TsQ%n(2PnL($%Tr{((5q4O*=;+v3ZEtIyesZ!Tfe`&@g<kt??I$KR+9^79
z&&Cis!KGe`Vl_CTZut03sR<@S)p4DFMz-CvyquqnPQgK;*PT$YR9?njT?7d4o1PqI
zYn_%2k>lW<>c|v@<V+#3$>UnSE1G+LvVBIxza@hmUuO0Q6t6QAt{rJCGmh1I9r$s+
zO`oeGZc>Cv3mPFm##A5n2qK+KF}1F}2mFy{C~MM_mGztarE#}Uk3Sp^sDt|6ZgUEu
z8T(0abn#Q{Xh%;^O<UXQOw&20<JXfkm(zpNDmLqzQs#+y<|ukcwF#Ux+?o*_#W5wF
zdWI(aOOkch@rpOX7z?HZ3F`E>ys-SxR5R5cCOpWbKs;*DXN2V2`lZ1F<IhBFdtU!V
ztZ-^u-Pf<txy8@)#1zxoqQ@jHMXBZ|!Guczs{&z87iA8C^6gvB8A{BG!X;h>Ik_jd
z`Gt~yS5nPXxVCt&GbYI-o~vH?L#P#5W$Rd3FFLU;f4iBf+aVdx)8paE{YI?0mx3%K
zJkIyVp@aIOk#4F{SG%sotz3gjWPx?~eP>yG$TI<QN!iQ~f?MrTIJBB)b!GN7cKMKU
zIl=?q6R6Rvc=_e(p>8vJ+*{6bj!4B2na8S|u-J3W7_QnxK6{248gRwg+7{k^Sf-e9
zeZ~&)zUbBDb^LSL=gATmwCk+^zo11q<37&F`Z&q2Twcauc$)z2>6&_}>Ah(r_$<*d
z-226ppR*gT<(t=r@{WD*#}ZWwNe#Objt-`APpsGw?sp%uMre85S^egGJPNhW&hmig
zeSdb_y;Ri^gfUn4RY}(RByrjJxOW4Y5nwKscj40T#|HrlmzTF@X(GFwcDk+wvKv0e
z{Q|`nMm&2Wy|f!tj!nvU@e0TR*uu<?RL)SUD7O3{bM%5tDMbn&(G^Fgx3_W-QRC#)
zEgr-5S>iJ@SOrCDIoa)<pX~=7J+a!$tP+a}&DRHS*&0X9;-???%xJMl0JP(^Kka8x
z##Y@N%Im49*z6BK8v1~(`UR^d!4f)r*8)wui)D$+<X>$lO`dN)Oca_FrdV6*n_iS6
z6JLU&Lqx>kzS<30AyeA4Jhk`qUUSFuTXUzc7Q5+t&lELjAlhS{Ka-3y#~JT040&;l
z4?!X_6Ow)#TuhI~W!~R}T~he}wM%wZI<#L>P`Z_b3|YK-Z*rW9@!HI>AD0em72VFx
z0X<tTSA3#i^{NfEYP=KndcIm#ivmZ{+keje*G!?fN1Pqst{a%panH`e`oaZ{K~Eu@
z6v}4(rdXc}+na&C%nn_)z+{rZWzc3u=;VmMdAT62s>opJ1A*SXD$g9}UDOl^w10j=
zJLJ!7a!>I8_5?{1|FFss$0LXyx6<eNiZ7i|R-6GS1ejaPKE8x73Ob$*dB0`Z>x-`*
z#A<o<UebeAT!dk)@5~j-D-cOOpez$!6jQlJ-CWg+V>DRqc;UnD8lHJ5vN|&3NpaZi
z_RJri0rzpsnZ`7;fLtb#`V1fC9HJ-M^*c)shQHLuKV4W;eILd}Z`i?MZ;__gb}%tc
zk4epjW5OTMJ?Oc=PB4e@B5Z5cORWT*9$a}{*mZ;)?@Tiw?^%*`qQM5TC?!?-%0abW
zjwQdH)BP_dY-u1x%`@l{5}z44+`~r8#n>#zF!fwFJwMBQNzQxZ{;S%$cjMD^7O^kW
zN$m{-sz3ht^bncg`b*?5iId@v$5!_51@yXh6K=9}K6NnRA0}Q6*`p=!myerV^T8<<
zx{=kgvod7p%eb$q-Cubg4LIZ~U{i(WF~{%-7H>LPCQRbKnU2hTw2mxt&N&HGv5Gw2
zqZux<A3ofUD4tpD2@#}KU_<lt@?y2rJB2gE$Cr$(a3p;$O2i~BFBF{~W3}88BQbsX
zD^D)sT@qTXf_)g@JJp?do%V3rk1tTsAUNc)df5Z~d-Rs8!=Lm!%)XsmFKG!Wd?C=T
zQD{aq%j<_9C8ao4Q67S=$W5;D(br8DI{?kTYpnEIYoahOEN)V$YGFR=;B@cDt*lH{
z{ZHG7M;>>AB*4~Q7)*uZroUWz5gLum`%nq+6M5UBbTUFieFDq)`L7rsDP%hCi>(O7
zL#32L5UVc}xo_m)-=Thb(!%#4SeB9se?6Hwl3aJJ==IIrOC&iK$85T5#{xdGikGkM
zg|gc&_~LD!osFzy-^M##B^fKuqmztYkxvW!{QFR;oDmWV5#L6tAO`(HEp0}vYjZqe
zo?S4#@&_UP^i4~?_U=>jf)Aurd93nvA5+A05BJ0G*_q*FzYZt7G3=R7_xq!vT~@yP
zE2n6Ou4!IjCDL_m(JhBfqTvztw(oDxX~J*vbmE}@O4|inS=s-Eq1ZRfd-yUhNzCIb
zRC=wP8=_<0S4O<F-VEu){p*h?ay_`7OZ_WLjI!mhcJogg7gwc!@=eg=HZ%sV2c{EV
z&(-{W_0!L<6fJ+$M&W*aaTs_ztvS3HoTK@pw;O>Nya7QsG#OP3{?PT&WG#NRC<#}3
zUCaxfdg`!n8`FwSxzMtpyQ?HFniN!>F0=3761M!ltnC|Q1<6yF#_}=XA_ydqzs}Pc
zf%ez?aQypyszy753}qL0SoBk{U;kNdayh(rSUW<1?&b<ZmTT!-yi)H4E|d1gu!wnq
z$O&4(H2&2d4Fk=5!NVtn<UGGOBO$zELUnc02RH9yfca)AufHQ4`3++HL@@ZDu;_gB
zVm&d`UwXUYhhxHuPdoC~T%e&Q)p_{Vs@Gl$=hf@okACOX3BEsl*#F9nkjbdxWlO#U
z{e9oHCW5=`)R@L|cl9^zo*~43KFijH=b!Qac@i-DCgl8G=l?A7i9&I-I7@c>d{LKb
z*}Vu@1|i<|W9188W7%-_?B!bJA7{F}i2iFw+>sH4|9-vu_clWX5BN7!?}{JA3KmvO
zIbuR{3<`Xa<vYWVjmTOLIQWeoMic2I|BjlU*^mzM@GQS7<)3Bpy;hXe-IZ}^mv$nG
zIGzFIwv<hg&8I<p7nhDuI!1?m5CYTeUa<+`1$eKGv0Fh{OiB5{px+N>gaUWosEKf&
z=0|W*ciT>wp6*ZNS^ROCCyVsgA^7|0GN-h%#9}a`b1&`+D=m3W;vES(6-(Qo(0rUS
zq#6!Z`D&BGWF%XPbv;+(@4v=Gsq_Siy}y6w&@7+O!IdtGz@l|)l9%W$vA!<~R-{)C
z+_JOxy&t}x(vVb!EYFzD4)o@#vjSId8}P}O+O&nFtI3`Sf3aB!B^&Txo8XQlleD=>
z4rQ|1@(X}(`k`7+=g#g;mEBwDlJm`1m~Fv|-R5+(d9Sw198_Cjc=z$|EpqSS*MCRe
zR+O+_?g3O>)7~gYy*$S-8jKM)zlggz=20d@XY-_Ms)F?B!kcA}5YJZ|efU0`{*$9R
z*%?hoxxaPT+1Meqw;WJ}G4O`oE0bS1NcG~?RO1C6rdgMm#!DAl#OSm~#sVN~+%I+=
zHHQAxpEztTZ0%j~r71N~T6*gL0k*c(EL%hR)~S@#CM9aK;Zu^H2HgqaYN9G7R=2N}
z?MG*;EmK1%WsxN%V1vrh6X;x%wb58SHpY$Z?M$Vd6kL-`fX6wF4i~!QE&4{}(2kRM
zKHvQf2lPDt8xB~ALI$oFgCTZm{*x%LjE}8ML{$0X!$pEG=6NQ|Jvu9Q!bMWlYNa?#
z`A3>jct3Og^TK6$Pd4Pv;vA57by@MUXsCRh=WIYol9jmX>;1JWk}=UTAsL$7!t~+s
zm1ho8=%n;{f=)6NGIryYu1a@Oq+-dh6$NGvCQII`GjLB^Cvn~+IvOpOvQ}ydM&#<X
z<y$XP7hk!>_F79^PHv;-gM^C`-~a1t;PvKl`>CrkuPX)Mt9BoIt@-mK(D}Zg)3IFS
z*}L^0Ic6Odp30c=T>}Zl;X<+A0xjqd;o#&nNZ@#_MIfGOJnWgPr5!(H?d2Uwb2A`x
zh>t9kqxiUiVE$_j&?)Ju<qp=@oP7_s=j9@esJI+$944#p!O(0p63D=k`BW-h{BbiB
zn*6Vjx2mXi@z3N=<fGt_YL=is3gP=K@fTnqF7r2xHU9e4dG-6)n6bGVbqR-VbKUpN
z9lCN*3x~Xaw9t0*KOUUF1zGSbn3z~WRq(iNOfOy0FPYb8a|5bLAi|-6<B^MrDi9ta
z)DLM2?f2K-ayhHav>iWcXgq8CQMH<~N#Hu_vO3%jpwxVGkm+cVMqF@P8ePRg)&ukR
zJsh|a1sK{|%)Z!ti59a{Qz;5rx1Sa^d_eWPLol8r70ZDxTv}nNA5*o!As*V9{A%)`
zI!#_Q>RFCJp8Y$09hrwu?RsK8JS6UuFo$xQCwJ&(Dl_n$T{NhTK}Ya?P>1qBoW}KC
z0NK8*Mj=M#QQ5+!rLj`}3MW?bT(dDx;DCF7@<{8I>w?!dwmXjb?ctzE!N8%m8F8f$
zI&-jW0j>=GCRN=zk1yV>NtG5(3Zq&720zK}fec{47S)XUsU7E99qb1R%~lgH9WTVA
zk|#+-ZAnX4eYiuD+y=EM`8CzgEiOH5wq^@+bNztY0=Q`U7cLu~@HZ~Yb9aXNcU1oy
z6a+$Tjy`qR_7U{uMcx$jUCE#|>6w$IYz=Hm2KocCQ?L@bA7p@ivN!VN<||9fbeY5#
z)AjN_iC&f3=1aX7mL9mAjlz#S)o=g$puFborIC*+%<0jb?BEKGpGKouA!K5bpAuxs
zZ{%a6n7`1FU;0${=H?>UTnLO$_h;sT$1x9GuKs>}RJRw9Tc@Y{IS}Ty?Gq)U{53i+
zd>d=*wiL+CQX6U(v^d<tls0%jv~6>whMA4d_KW!8PBk8|Ar%ew-gDWW!<WXu!U|x}
zFEAN;8pBmCVLztOdv0$!_#{l_E0%`FCIRN;+8QRnC0uAey&go)Q_BOAGOq5>R>?PO
zbsL;=r9*DPyf8LF-;5KK*fp&P@s$A!$>t7)8Gk(XISi^`KaB*DS$-LB%{&|y8)yx~
zEAMI`!;|k?!)8oT1Gs)kNka(w@^Y6NFVDg;Sst*pS?q4CA!cpmZ)E;IP72|5i{O7s
zgk2>hCwpXC2ftie7;+oevqJ=V@96Zw%Fv=8cl+erT!D522W_#nadvigVRCZA>WCx%
z0~}Nrmx{i$ps9#^G2Gn5Mnf5KSjiHZfEmU&vRZn4R2fo;WHApt`T?Yi)N^EQ@@cXU
zf5LSl+iuedC?OngQ7gbB-`%{0(abli=~C={bFr7}<cXJqA6tiz!g9ZLO4L%H=CM*H
zljFEbObf^fxOQiNKAWX{v?;uK>Iz^Pmb|8G`8yFHM}%Smw@NZo&bOQWNwmjGFzD2-
z$NM|(-(fOS3%bdmCw2~Ug1#z{vhyzmTQ8G#v#8w%l8b`t&p5f%cMX2o!6WpcnwR@5
zB*XJC7B#z}vPqrEuJp~-MKZYj5AfvIM%St8N672w3E1)@*?3-;WgY}q8a}~#6!E+8
zm}C_Go91~(*r@zZaPQTAxb*4eVj;$1K^_1|XQ%raqj!uU75AJ;+=bHnrhdm+2e!_1
ztXi=o>|q)fqE^cHuX*@A#iH0|cbD0VUld?4X%SGt4Q2gkJ;!R1*GSNF{Zc%GOau`y
z!wJ=~eC!*lQThp8Q+4s=gm4!Ynw9Husu=H;A-D>~rvg-pUb$&88t}`9(E6mzK%Ft9
z(A!u&&#%dAJ&8nYY`P(`0*^zF?vBsN)|I3Ehb!ibQk&g{_^w)|0*toZ1Xk5Acf_1;
ztt@n@r$GHv5~s7fwCUL;?0mEnSW*QDK9z4FM%0#g{CV%r1j-zdPS9T@H7Uj4B=z0P
ztfIdYm;NMQ2Wmb}dg{}HDeiOJ{aqhdr9U%OW-Csa&#pdIULEd>f8%nhGFFr$`q5l)
zxij|db?xb@(WqBOs+*hB0rp!u$v?3FAIiSMud1{Q*BKi`R8kO7kS<X|T0pw%&?!iR
zlt^2k(hbrj-JLRsbax*{nuCBKop&8z<{Q7b_jmsR*k`}*Uh%|QY%R~kUzbcm=S6!P
z;B1s2a%xZ~SB?OLOko(XzCE4EAj;s!pU?LZb2rnAK?T6UQMxs;wFh)(B%N7%Z0W#U
ziMWe`oi-XeI{+*Lt3kGXlv^5d&XrtEA<U9Qk4{O8j{NOjsGCYqf|*x@i#Jzv+Po*}
zMEF<M7wl2$ttE-&u_6A^lH?RdnRVbcJtl1MDfbruDp&3Ov%v5PE`WeC`zczL7i_N=
z2>yi>2LFxD-nsNTn)2VVXg7^+T}{GZGE7n6p;284Gm!&y2%nmx&bwGdO89yO8;M~f
z2v)+uS9Z4EIvDmlYs^=knhSd^jFuWgte<WQWP@Aa#TVseA>6Kbz*>^n@!$pq21;Bx
z&SfpInNk71sVi2Qofg5n!LXn&Xbr{G30I(Z(ebC}&9))05?AfJpX&h~+D)8>GJ+i!
zZ;CF93rjd*uCr4riv4BW`219`%t5+Z3Es?;2P*X80mi8SN|3wzK{V@T-F|K^{HCzR
zL?w5*DQZioe!Hy|K(W@}u6;dC5btj_SPx!rByyWPSA=)w<yRk&F#NaMkqLjtdi)Eh
zBNUR~m+Ik8)&1-%-fyb7fJJxl!e$rPOFxje6|BbR<6-4qrGh(P7XU!fLa(APQ9Zv6
zvr&h6l8F7~%QrdPT&%7lN_B1gq3Mq?`kJ_$_$LH>ewP<YiuH*$%cb-4zBU$6E8!~g
z4QR~UjwT-_vs*?d5{B>k`1<B3rdFk<USy`v$j4jSsS@kMRziM~q_DrU^japaCEXjQ
zSSDzjDW#%QX(eO*WT|JVB|S{W10)&zw4>(rkJqKWy}gI49EteNgFaJ(9l>#Jy4X<n
zju_)<3y{i%f$mWx^_Iq<_vpCsZ(w<AbT+_n59&j*n|7fy150BIafS-FIkJi>^a}B2
z9LE!dFyD*Ai2cRfq$=@8kMMl6(Lkt^MyaLn>SL}0Z&Or0o_*|flaA;+xN3=y4@LcD
znu@c4DlW+d?>fyONb~(N5))s~(7k!HH^!dMPs?TIl=-!@Ln`@;h;N2Xc>|(o?k9PF
zCV{)GfvzsLba}0%Z9dS!Ue=f8<k!M1>KlBg#s`qq8pcFL?FcE{30AJAt}YWa0IN$Q
zSn*ek<T<6nAE#gn$mySQ0v=_A%|BDAJ{^leynJ0v=(TG;E8_MnUb#6*R`j$3VbGsL
zVkMKt8w-I(Q5+&MTDiih-Bhr88$f(sXZ$tm6!BmQ`C%`Y;NHUnZ{cLOC<*`Uw4XkH
zWIED~-)Cmhmqmi<w0X$bwjrFe%~)HrtW?iQDx+&@q(qZ|t7Q~xoYLOrh6w=@X)-^-
zsG(h9O{CEs+v)u|^Wy`f_%%RD(^~s`BD|@>6WP*15YdGI<p>U?IlU<YgDrxS9TS{`
zwISILZD;3{1Zz8EWAHs{_HFVWz0&mB0JN?cas}?+xk6t1+b?K=$a4nB$<`-zlG=Ok
zKpuBf1@oKQCKEy05jg#*B0O>6VL-eN3XKWv&sCJ5g=h}0q|Y7of}a3otA9Gj`WCY|
z3tH$w3FuH$7-L~j7o#-Xir|vOZ=q)Omo!$V{B65NZ$7y2;U2p=6zcj<j-1<Kn|a}C
zY(!sQdOuzOKdY&jNIH7x9r**pweB&}mQD%=wSt!wKe9K<vml#7JYMYNuL;Y1%No}Q
zQUo6|zsbc##wr%yY~%hp;e(z1otyH6w|K%ZAi3uFvC<Zo4^@^9X!`g>XO}FC*+q`M
z^TzkZ_1NDCu;7HE6U;Lg6iX&oYD8C$zP@}(*WFDFv_=Fld2w-8hx?rAdC!-QER*i~
z5_YFQX*?6`V1ZFS%Yg+n*Z+d<oBYn76JTOGiKm#>EJ1U!(hvmEX!!H_u9pqTP+U7K
zkKMZ+?*$P34azm!gb@ThUJR2K%8%qMJ~Juajr)FNowIXut^Qp&Tuyd)%${lqg578|
zd%Epo90wE>M7S*QVr@$%tDWC%Gtmnh(qFyV6N~I&fl(ypeQ8X>-fq!Q0x_uFSNN7J
z?rMb`tJ9;}N^3;0&Oc1@CaBv<b8)RkBd38+)0<%~MkKV{_4DaIWE0%v`m+Ey!hYO^
zg@r(P_aKBxe=`B)52`oye7!$mw|LHt9v1~>?Z*UA7s{v|6n77KAzZcXmVvB(XpcI>
zl?2sr7a}?LvpN;o2Q)8obg)7%FGGftu9*4~KA@E$7Apt?urm2Kk5G`^Sa5X2lGJ2a
zWGHFd>Drwc%&D%zhB~O_<UWgyl-tIJ54O$`-M3#vK(YB&f1Rj5u#eHpx?amZK_q8K
zdJ$x4WH+w-tJHj)GxN*sZWt;5HOV!;OXYyZF-;Vg){1Enq!-Frsv)8&aHC7jR93##
zB~?4IsX%X&l*F;dEAkox&kOFnu;q_09v~`hrIZYldc3=xj3$gO<(czD6yk}0`}Uwr
zK#!i!&85Jk7o{oYY(7?o0{IdFGig0#oI5hCPHI^`HQQKh-UmtysgPE*25%g9VR`&4
z=nz=-pjV={B*b$vb7gA1pwXQS8B;lK5I!OzHZS+d+rbo~2;ZA2qUKB)D?`wXyfqFM
z5ByRHtjc<^iq$r>jSEMw-(Sa8D;f(1?~(q!C-gxufOj-cj|4T4Jyc>bj;=Xb7*wxW
z(PzL0Z+Z=R+r|V2g8h{4I9x(6Kmtw#E$><XuX&Lvh|6uyV(42P{n7SRfaa%xICnSK
z@2X--N_l1ZZP7GAM9EE1#5WgPAt3d}lN_wIx_5e2x;VD3PGz#0X^o_FIEy%}kiPec
zCV^XyOH#dBk6DQ6T=6t+H0c~ab1|E+9xia?Ps>T7&@?_uVR=7>dk(1l$9{V9aX*n$
zlls#mrSU)q(WDIMgJ{mE*!0u%3$>Ls4lD_$U(h<H`yA&4K&f-WI|`sK2@t7$o?063
zhG$-yBdGb2n?fJU&mRo3jBj<^Em4o;dhky$m5XS71zs&ALQ4F9;DNpXzFPnBlKo(>
z6j^H3y)_|<EX$|A)W(FC0-X_mETF{WA_7vzG_nj8=InBnAo4<^Em*_#a_rJMz}tTX
z^Zrgg$V=9+ch~=Lc{%6F+&iZCYb%a!^Da)(lu9{Rp^wl{T^&`TKhsiQe=9KFdMX3m
z8&Sd9_HqE(!!%yT-(@~Uvc-yi<q&l(FTK9uecWZ~Vl$KSmY2J&d<aXT=ux^ph+CW%
zZA$A&UQAr`dpgBA6T8W;k$@HgK+vKrj#kGSb!1^f)nX`d1ajKN0cj8(EZGpAt8V?}
z6-N-ij{i!29O{NVzX^ZuufIOJk9sfJ{5jFWzmK@6<^{J?b<GQB_%(@P<g~FRJ?wA$
zt^+Rmdi_*ad=@P#_WI|ep52ns8i^^rsUvVTY{|vm`s)<;(Nu=_t6HTOw8oq@pKLNd
z5nfHnHXc19y8rt0k6k(uDgWmmW8}{s$5~bm%pq}JE8TY7yDpvGfWVczTd#;`A<3AQ
z`9F}>zYiyCvZoBs<=b}35rdF<bje6nwitkC^-+r4iMQar30yn3aQ)XiBX<Mgjn4)O
zUhT4LR4T)_E_2EscN|@v?e@;|LDy&H4|mrrMk-WP^YCt>Ayq<CU&;UW7=d>maIn63
zRtY)5ZQr_5a|Rb?;`;cBW<!pYitKYhgL1LaK~p3N*nBVi4~@xqD<pCXIB(b_9v^vp
zuroFD+DIxsPyJD^9{pilx7ro998U?0L!BEEBoGa6HzoXXmf}w>oBDn7i%b-~`J;$H
zcB)oPCx)E%m2{7r_kSBrb9~D4wLi$8J0PDXG!)Ag+vg@VBJRFmQ!))!$0wjb<K3^<
zPmY3}Vm6rM7e@QNl*;BkDb%-gUkCgPsP4MnsOff+)ZxN+z}b{RUk|@8KfBCg^p?{>
zBiTF4u^~L1LTlhip?;gK`2@nXuu`YO9xHs*zn<kAYVuNr>UY|%o*(20jV&%NKwI9a
zCy80!L_f*xgOi`veo3X{*HXX9&JepUd70q~PiRdVDWm}!tHWh63;GOr!3(qPW(uKE
zQKNwre#NWnQ69S#cc@R0yUS~n-N6<st`Y>^ait^!1LE^Vc$ZCm$;%B-emUmxC1j`2
z<ZRRuy=Auj0jCRb=FE);<h`N1SAz95Rwdpc9PrOY_J(dUZj6GKy;n%E;b3z#98#&(
z@cm4k8U#r4+G4oZK|4B24#L>#r|oY^c_S@{?y2SUo8ysGTZ0;X->$Bc->Ony7`)v^
zeZN5=3CiXj`S+kLaN9L0O*yYdEt~VnHHNoRAm_$?Bl;j{r~^Sjnvtzmn3V!fhJZi{
z?%qJV#Q_6&y#ROioa^fD$q@%VwNiN8!+cMS1%rN%FAP$7R?;J0?CV#i<&I<EZ2?Qm
zAyE~tH!~H+^il~Eh`VXh8+X%PVvb+7*y$(uAHN=ik@?xi!=SRJ`06<T;ECBF6ZK)o
zHMPR06(H-pRc<wr2$;8Z+aIqiSc^@ce1}r9*!a4;PW*-94YWkbv|qy7u_c6degYVP
zp4zl6`eXew=P?Y{^g3HClI2N&ewCj5Ll?UuUn1ohiUb?CZ&Sfc_iaj?>Ij$<%TaT2
zTbZrS8>TWIu+RcQpgvlPLKbEl-F|m^ur^gYVigLSTDUpc_dJwK$cry)90w^ojFY%R
zkz)JnWd?ahGP+lQpM(H~IKa-ZrS(q;pzTqqGtI#<7~Z(e#KgqeA3*H)r}N5AM+|oe
zIkWba!M+UNe5f*&CTC{KpM84|TQy`T0pP^KifPF0XL)nMwSnWPJ13ahAr({!dlByg
z*^D}_xgQ0AiYzemEyJi63k&fMGhNL2@Vr#joH1&^4tPMEvi3tv2B3A{p{@%W^6nEY
z)kYSbkFMe!_izk2Ti+cYs~>e47?Mux#Fcd5B8I*CsEThfo1Jh}P8@&rMvl5CRKm0C
z8fc8C=7^LMBUf`6wM^>Xh<tTck~I*0YSvG}%b&kx*_;V)-Ig6dyAE_gg4RkK51j_w
z#>71PMXs>Y9@^HDNiz3alXaMwQ8HH0B%H5Kkp>%6Zl4}#9b;NxNhFnoc^=-zR`xva
zyUi;Gg(s=%;~vXIuc5xxw}BCi2dakjH~I>SPeN^V)M>!_!ISs58Rf5Y7zm`u<?Z)Z
z0_2>IjJqU?%4Vv8)`lVxLHMLf#sv7O{)PyVgWcl9h}t)!>6ng=J=)cgt*eOU0<;iL
z{?MD~I!iEeb7dk@n*%K|d%l6XN+%n}@KLp_|M;bPA#II2AF-d%4`Jn%KWVh6{Q8bG
zHS{i+LEsr4ImtzTD+ynas{W0}^`P;$>p|fY2CkcGT68OYw6|-;f{T?i8~6#(ugfO+
zTI2S1a%&((W<YK(2OhhrlCoc^1T?jPq^{}o0qxzZ;pU}>?t4`=HKn|8W0f}gRa(ow
z!lNzcpW7Qq;5|Fcuv%mPB-kx$!*|!*c+5eu_wai5g_ZC3P_3~zGFM|=A$>x|TDL^C
zu4ygY&#!sB2U*o=T{$!smuzN2G3P$*KYm5+@zybZ9_*~Yf%FBmp7zqm!q2b-@$n4M
zQ)2ge3>YT@1_2o0RCxacFzs(EItod8bzDuyFP0EQKBnViV?ak5ys*F9n}QWU(VHqO
zsXSWRIRkTA5D;TXMjiyT-#F4Z&PWSExr%7c_T1$U^i%*xoH@f@_w$dxfr$XL-rpyH
zb1@T2Y$ZMevAuH?(gR=;09l}kg0vs*WW)y?SdYHhT97@Iqs5!Ss8(>MCR;i4RyE0k
zluWAc_1?zV{?khK+dm}azqorX<>TRe*Eqg=Uyl%D*_Yryf9z9fsKmn#F=kfzs1(9K
zkv#;X@6*qgokWE7%TOAk74?68Dj>oY^EXVR7HNv!*Z^^6$Y5NuF;kDh63GANEgF0l
z;`n$eFJ?Xg0}-9dFf(S!Wa)%wzFL{(_+uupC!MXvx|Ejq;aEalmA-m-P^U?5UawKQ
z>6Hgu2tHG^XtxDD)llixrJGGpPfF4I;DA8CqVo5r0Ox-mQGNnA4hikQ<v+Qj1ln#?
z%@JS9hY;!e!Nm}3HrChUVTK)dOD$TBvlfg=L1ENd{JbSPn~<bB5W5%%9QcYgUo2}H
zLtLw>;sMvpr>n4v@}}@Wri!?hn4TBvu%230hRuAw(>?AuM`Q~*Uno#Ju5<F*4kA|I
zc9lLev+%f?Rg9Nz2)-+HhWuBYq1E}DvV6~2N57=egK3)xzEfd<M{~4@!3XgT+9F_v
z-H%-P>7qf`ek;8fako8!<^7Rqv4sY#;}uSo&Beru8AxeQop31>|JoME9}N)Qk1H4`
z$8Ul|Af@Su!PElTk_G*Wpz-%1OHLbu7_R=WN!L7v5MX1n7i)Uh^L<!I#P7Riv1vL;
zOXYV`;}9>lf247Jc38ppTDA5BUCl0Nlz^|g$;Enz-@t03pjBR=OacS`Xz7@>D!QOM
zn{6i+i2_~nU=B%*PlmWgcgg4Ce`S`i56+uB<k{}V1^4||_GLAUFaS@4YN>?X{w<U!
z@eYcoXl(2l;%^pl2+>E8X<iRw>~?l`ylNg;T3S+w*xkRG4k@=idWUmjG<CM^;|3}M
zM5y2`=>J+|@-w{(Gl9=_lJU{brG9-4`8So78i2yW_(o24c6FSiN#XUEzgf^cB8j7x
z-3+E4G$jXeFavwL4!iKNs8!Jq^ZI}Q>ynLZSbxf?bbO3r0aNXwJ)x7R#Ag;Bv{?ms
z>C)DeJ#k!IT2#TeS`)`;d0Z}3KXiUB1R;s@47vok@t4p=s+sE-p$nLW=D#gSL+OLM
zE(}uj8@9YK;?%A`BOY3d-c;;;K*MdOKj4@F`p3qxL#evg%6u`Lkyxl5R(Nv*XTBTw
zR<Niaq)fD)MF!3DfRySxDg^I-duLIU3nW;JvLNtQiG;;yrkyNSgv0VXD6t=sEde|P
z{T)Rkp$|2H(YhE(4<-R|xuaEcIC4kc0xkd-LDb&BNbIXybjQW*-KKV|y?F`iJWYbX
zezQs*-i(grC-Go9_rqw55f@XN)#qjw^}^mF6_u61n2qRa;>SMc(0xSAc?JCv7*2}7
zO$rfSze>M{13z%6<Fn74x%)JlkHcU|6Z>3s;c-9u=ylbLb%RmoxSsmSIg5A2_BTN9
zdt6I8D>Qo7EU8_`xn*a3;XpEX=H<Ei68!{0$NdAz0u21N7@l%&e`T{inxAuVI+;`1
z5^UHc>dVW^>;N#!-@s>&VaL8oN`Dc+Y=MCDr#<Ie`ng}>kdE>@dxrh!$2nE{kmfMK
zwA=dF-x;x(_0ffWFCrPV9$wR77Lp|X6J87?WA(gge(FksGd6kWPYQMWZ!ib?_p{DF
z^w;p{a9vj?Yx-w5QX@er0Mkx1YG0T4M+FnHucyW!tDPSq&!JyW+iBPLA5|iICssA>
zLfqo3cn8gscIgeYlgm}@^G>VMM`|M#gWV?d3f#CN77DE;pZv@^vZYu)$2!ZAtcd?s
zPf(gm+7olQ@o_9bqN-sqN!=00_Pz;y!9Y$-69ufs@O&?LkUk44SQ;Ckydu{MjX2~S
z<M<e-rQwloH$|Vu(J!I4zbL_;jE;2?_d$$+-x%RCednBj>2U;pM7<@WePt^{EZk?Y
zwbW!$X+9q>{k&JgKwA4zA+0@+8+{P3@KLDNo6ooSSxm{jwN<qGePe_Vwiwj&@WkWX
z)L)s}&a_ZTyv>IBpJ=f^YAU#6d^{VR5nzVuF^>W}5U4L<8g%lQIdJMd$>JM>IwPra
z$7jm<zs}V27~(o<#^>i|D|qdiFa4yks#TK$EY9Ni0n5I6_T^9abbP195R%U}6*0<}
zdZywi6kK2qd*NlK1Qv_UxXa&K)Sm<vds|y5NX#niRvE9+BhJB!f&+FRi3}y$JEh_%
zWcB5KPY>yEP@uspO#Uks*_?WMh-W<kPWC#f=<vcDvj4<v<Tx<8sXtZJk8dIDHCHS<
zb+#e<+6>Te1a70PW^oxSib~!s4`eK)SkRapWbhYDBQm5#%gE}Nl0%5~Rq;V!1^LO)
zB3v}(C}@g;Y<a6hxAqd<!f@foF)B2*pfsARLtl=8zH3r{74QGvk3mQBFG+y9n|kFt
z6`}Fqn)=RBe`C}3VJ}bwq1)T^^Y)>|=}(@m-`|Soq6~i?0OZqJ>y(vIvY4Z-8kA-L
zmaN6w_ok$4emVBs_UQra{bN%`Xy(qHsj_6NiLiBcFsh7EeNayt0jjV`8C}}^ZIAfY
z!ujuE5?-az<ztly`?Hn4PveeJt9aA8!yPIFqCB5}^5=kTRY|58x30Db&tgwUNCeci
z)MOu*NR?7iEtUmQG)flA4qgeTk2m4&KPj*XQpmE$JR0&iYN;}gbY%D9v1%+p=-|Zt
zq~UhC^o?SX;(G77;9pPiKR$$iQbOi+Kgc&xlkY9u?7x08(CID_MPZHTRFPC8b*gwl
z>mn~1h%2jMLR`RS-)CE@Km4bR70R;y=N!k+cxbP&H1#{szMYpXpx<w_(kRUV{~S6M
zBLC-C_|Jd-{abw!HOJrzZ?}!z<4C&6$VB{5MaFu$<mXc=Xl;jMN#aU~h!tws3!0+D
z5ipTM0;r>$HLv$00jsLzc;t^!5Ylvw!sL}^iy%RvRC$XHlv5`W`ojE=FhJ2s1J`Bp
z1V-fj%IoaLzYA_LzZfzu{+1d72+=U)vN++!r2gH`xJbqPdXn)ssO{YEbk1IP=~74T
z*J{mRNw>VtCL|zG1jk{9MSn&K4XY77xIz6|8vR$=t>!w(WUQb)W#W*G<aVIx-vr5d
z4*H312cI@P{{dlqSAF#NGZkJVpm03wi}suFl48kW;`T;4<1er|dudNC%KKC$h^yt{
z5ik%6C<Djb2^kUtDz?tJxYbp0(HT(cOb1zg9)4_<iD0DUkVHY1*Kaw(s{H@|?_Uo@
zYczKxZY95*^d42gUXVHJG26sVM<BmOOO1Ge=a-nLEG8<7SQ#)|O)W@iKWEv<_;~0r
z(5?~>Acf_@YD3conFIVJP&9u+Ml0v(F2fPRm^^Y7D0l?|#Q#_9D?!IT<mcmX^QWD;
z%yG)fFA9bPQ7m!Mp&NEhdt1~CdaP~lh2I6rfd&FCk6e2|t#f<i<;WK$c(hcuvscbu
zEcwXmEC#xdAVB!J>{~!QnMncrhNJ=$5_(w~qqzwrX2vUPTrhq?{zS`ce$DmfvBa-$
z&olldRO{$lowRaBd_8xOBvJt03g>MBJcbBvs98+q#X(bq)(LzjlLsqzoZHBFwgwK^
zPDy*hn6&1B;E!yAJ^+CHutZ^gKVM%&I5ejZz{gx_wGvAF4t+;#|JNOfK{MLbY^MPB
zT~yyHj2f5#{tSF+Ey`K0d-&z$<<e2?k3wJyM!4r6z}yAAIc~%L`V`Q*i5#&+_&M<o
z631!z8J9SpeKhA!AlJrsv>Sleh=cEm!5st6XZZF%)uchwbDp<pnlGJ*-sZH#NYG4(
ztSS$v(tms-VS_Eu=p+3_;~MCo2bgt`=jk~j1N&H*m_+t5(TC6e3&vYT0Y5I}+}jgt
z@tgk#4E(3ve*;)SQTsQ}8~wlZx|bvv{y`wXbNuD0{!5O0PT+&^>8k;9<ZySf7D#7E
z03gShfV$^uo(?oI-@%VwL{X06G`Kz~T%>uaS|H(F!d=>bzOPAgTOpY~2-i^O0hgzp
z<78F=v<b9uHsvCW>V3&V)z9uo<v2}&%~x!$18c@c4aS)50Nrlms2_fa93X2(SHvKW
z3vb0a6(Rf4C;Nd4Lk!GkKC)0U3c)m+m1^rJgJ2z>elc1EO`>TPsJ3kI79p3el&!n~
zDH-ZFe9E^rFG=egL~Jo3Pz0K}gN`)=P{cbb)ogHIbkV?y<76o2=FURzqSJ=y@<ZF}
z(7>nu1p)q-+E)o=003hNE{zVty!WYa9j0IklH_x9KDQW&gq@vJhYJkDG(UA;B&!mA
z=d?agS1v(e=F3!UIf3MUZe9wuu&2#I`O;Cc)UwM2IEC_8DYDh^LV&aU%!&)25|4}L
zttU~e6Br7;DgD4)iaW!OI2umm^`42*T?(~uCSmaY`oE8$RZ+t~)iv}gHtM+Z&d<yM
z%PF8%+Z=3GY7tdvV;E4o+iLw<;+}98A{+O-L0iNjmea=%lISf5oT9pSg)ut8F_NXh
zA@5goTVm<OPe^R7#c{5P@C=Zxw<=qS3JCBnRJBpoeNbW=np;1LJf!c=L6cVMdmcyG
z0g9(eWyg=Eb;rK(=N(vD`xc#E5r4)DJ($;VV!U{lrrqUjJctm1!4I37D7z8;z$Oh|
zgyhs{gKsA4rr=^6b1zvsXr%5e^whhPgR2S@XH($B`Q|?b#~9fJ&T)B17&B4lX-^12
zH!hC3I)>XJZ7c=r{#N#Fg%l|kLkV}@al_R0t%O6d1i%8EoSb0o8zQIR_HiThkR&w~
zeR1Tp#}m@Ru)?3T7DSVS!EzJYWNVunL|oEW#q`mw@!FDEbe=qc{dYn+C@)$_%Y{Hv
zNKvXQ!(?oI*<zIa9pB7(Opzw#59&F?b9-CNDM&CCzSJ~K{ZWGl0>INLB6Tz;0<Csi
zp++m=u&c|Hq)MWUu$`WB==BRe{mxjA{Y@ZV(b-!k3Z|qquUct_&G{hTLt(CztG(NF
z9p|Sen`y}E#>OGISDYp{I>S9Yq=CQM8nx1CQO3swaU}QF9xF<_+NnzQ9B4jC0D?R~
zixw!Ldy>%uH5Y-X8>nov)E<;qR(_0*%|q;?SyMlngw0a(kILx^EQgj?2)jg(sCEf=
zt3`iYr^9_I=*rScvv=!R|8=RLYwtGPD(pnHC|e=I6u-jDRbX_+o7E5UkqBdWlv-||
z`P>9cn&{}y+UxK^KtFYK=!~#zOxEn3yiZ7$Bi?MW(Bpypk~@qn&@Aa3Ey-S-nQ;VD
zet8S&H+OnavYxu<Efh}xgV9+}$h-?|=x!)xJ(w6@XY8|+*j7O+mtpisgapuhGtzD1
z56Eg^unid=yQQYGpZin+kI}k_fu&uk?HmtX9I)6OFNnX>XWGrQAWUn(v+DUaHe0pa
z#@b60G|&~#x)TGHhLXkEIFafw(F1(I6{7wrE-XDRM#!@Dt&&5r;u7<Z!Ww|jh~?a;
zKD|OwijBApecjFqXHxyvnLh=xC;I`5lY(hHT2eCP1sreyX1~+!dSA6Ov-^F+JHo*F
z`heyFFegCGBv=6TfJQ#3j<v%5=m*-Nr)g=?mRm#Wvi8+0j&dQq{E#I)vc+T{VCjdl
zy+>2*&I~z#XYsj2{DJd%;XyU1n>CphK|q-iN5BX7eWW;c4)-q2JJM7vn_<2hJKEQW
z8gOrKi;ghtTX{s&{3V03I7J)l#=2HD0>9Jl=6)wypV|HZ74&+=W@Ic6Z}QQ*xiyz_
zA1(wdse%&PjoW!M0FVr{PFZiRFa0d^yn_rPaOZHYvlJS2KJCv8x9mw)hXDYP-x*iD
zA5T^6{Co#{bEkS`>3xWRYnkSx0GY68kI#_9a<r(&MQo<fsPSrNff~2$G-<9gT-zqS
z7k->s+uevM5{DsN#srKS1CviXV=!m3GZ2iz6dFVpUe6g|YHKF!_3iOPXAqK+Z{a$J
zX0Irnq_nmHsjqOb5{&AyhSKu2jA$X=()*EImE54(#B8zlo+j|eZ2=XL!<1Sl=i}e+
z_~Xy_RiRxlt)$&PDS#7%fYC%Wa<>Wk5m~BAS~+vvy8YDjPJ1A7!zA!C?oOoI7zI@(
zOti>W=?_E+a>?wPc60c0MSmt<%WC%~fMFy?O|j$t+Qu1eC*6%qV@V%NeOU#Sq9|Q=
z99K^$FBC%{FT$NNU0RR4J21+i^Z8OW+Trn@fYNR$WwGp?sLjYd5IYld$OIDe+ZZSh
z7kEs)t88FH(q31uP>LeQ@Oal5k2X)pe-6L%hNGGkD1ciHz%ZG?yd)S4^=v9c01x2Q
z!m6s+2uy-6L>xJhbfE-|$4=5`rj{6>vYWN+E^`8ZE7;N2f}D2ewpaUcg@#F#<&j@}
zz2}5lO?XDVV8~3$dI|u9xIE^n7dK?oKn<CaVO8Vnj!}k%KL~OhuoYi3%TcKDg)u_N
zO>jzw(i6-%_w@ko%@VnMgZBsE_81^I);oLgvnKYNAQ6cl^XF)j6s`1?v1>f0SZR0J
z6?m{Br|H7XHaRoJ0;{yOW50}Zq@L@PzjUP0zx2pT?Jo%@^{Ir@vpk`vb&?=&O=noS
z4I^E-ah@UU@-m&3u>#!FbO3af#Du8aT1(oYyx`lJrZ^NzCUx)mqfF2vQE7g8S>#Eo
z&&^(X5nD4*akB0uvJhkIfPY>fkkvpshRYBN_0YjNAGBn?dVl|?+r})2V^Rg%uSITl
zfP$)l6L<BVASqeT%a0Qozz_YdEI-9M&4gfxt6;-i^;9{yhKDx>>U{e%OY5NALX=Vv
zYXMh@JGElF@O8KZExX^Kx-iA;ZL%+`<*=-oc3#68n(89QSHG7}(^*1gfHswQ-DF7&
z)}%D3Mcidny(h@RWN<f3w||Eu4;4JaH&$%s22t|`y=MiwX0}PLC`G$b1IZoJy9Nij
zVd_}@!>Mbed_vWD>B^ZSUaM#OL!xj_gEm(BlMkO_7?b^!RqT5|av{qL{eyC%ISae{
zdpkSBwS(~)iJFVoW+EgJxumkSv9Y9|B=7)jhG9+k`T(M8AS)dL;d;`|k=e7EDEJ~3
zL=qzM@qpz_t!n84i&GL|j973D4%ai?%Z5?7KakF!$1B)w@>WQq=ZUFW+@1fBFzv<Y
zrC!|9eO-Yn8uU?4lA?*5bmn6A3|rXM@iMbteF}`1e?q-(ogLj^>(_!Hr?l~6vF;hm
z-hhE9V?;H@wUc!4#o#G;vOhQH7#Rd0dmdT+;i(W8oy2)pm!9s6kG0hEbS+2TR;ZBF
z@q$J6HkYf_3TucIOuP-x?1)yARqoF;tC>S={LpwP6D)CW_<1{@(Q0ij6gs_SB9~*6
zt{s+UjJ`q^{FSrso#t$i&7$!eOx1LE^Bnw8qsWoB`ZNki%`hG^YhcirbGLQWm^9cu
zC12c9j(?N`Bhe=E^wvO9j+Ue;1JMBb{lpRIwY*0UztkCZsdlut`(AKEx%Q{Ydy+?S
z<Tgug!7zZgB2N2HWJkd->l{i)i95yooPzvmLqh|$92q~KBaEJieU#u1L`A*je9xyR
z^K2ii){<%&@j!6*s2cP57Cx#IBWjoV*mKkpnho4RYZ&7LJefE?xpBXzPkk>`u+Ap)
zl|Q?4sPYZ2qF>F<(_kkYd}afQRG~Uu+Y)l_5Zv1;`DbA%_A?l|B~t}bKwC`ud>~|b
zh(A@WF>knETz4;kp*dnt*8KT)b-^?{n6t!VV}Qrp83lFfM)J#)(uEg8Cb2x_Wc)sJ
zKfZ;ohi<Nlr&_y%NnBDdNz_4}K>gHB>PMj<IzhXNxv(fj($4tWv;&cxoanMcUiCep
zY0UGA3G){y#%pW56I-ikk{P_+@7x{r>cgcZv{OqB@keS`5q1pML-1w`3^Co^ZI~cY
z&exZ>T@*omNLYhed2&8K<ggmf6YdP!^xaA9@>HU(Jp|_gA`qtpNPwapWVJV#I;5;d
zOLIFNw&e@HT4ETkpt7B|{5ak|t}xE72dy_gUBWq4Te1Z8z9%2=@4Rqwdfyk`vj86r
z^vyne%-0)uAKj!N33__n571XRWx!fl85dW+mD)yAZNPLl0QzYiLNisNC}h~xmpikO
zs`&}=damiq5u&O5w4HtSCH`;X@w_OrEp~>YjmbqvgjiaS*Y-x%@f`!*q^~cs+?Mo+
zy$Z-@D41snNkwNm4nFU1V~hl37-yxay|4whj*?6roxII-6J7m_t%#@R(BM}+Lc_Yz
zZ~Gku-7MC<u;%V@7+RF}tc?(-rk&%am7FiNY>YZR1`NtcB{X_AEyhv^)AZEqjXh0>
zSkpnHp5L!t^@6Yceg?x~j1_bpGjt_eeP^GJ8Vtke@|9~2d$aAmR|Z^8Zv`xHEC<2!
z`!C>Vem0jD9?-wePKLb^TfwG1sA9V{JyML5o+t381to}i+HG1tMyXml?l1XpDT)H&
z05Z|Sq(3HgMAHY&RbgadC@$0f+AQZC#~7CZv?HPl#3PBx;NHMh#6BMf#lF5~{v+*(
z@r(!$Oi?*00OQ$aT)1_ivZ~KkVNd3|yy;)-V%l;!3fyYag)}qJk%tcM1+4wBTTn=q
zn4!e?EgG2Ig~>!-t66NVG8y%}DUN?~kol;x4gScu_;r`Y)Y`w9Gy9O#jl0n#O0%$2
zEd;4}#+P=Qj`%IKIktZ(3f>C*&4EX{7?ePXnn7RLtSBhhFI1s;1<eLc?p)&MpMc?z
zUURY`pjbaR$4x3KED~v)2c?seaFUMnPJ5JdSvt&yu)aKMwbl~179DuV0xopvw7XVF
zY&Hv10~@<RV0-EMc-ZR%tG+4oXQ^IKV~W22i60O4jB5DdJ}?8B%Ovrmi&xE)9JAuZ
zWB985!Wk1~jTU;sw|p>Gt=gnzF8(-(ho(R)rvOd6U&Qt!<c|y2N<QL_KMH0ObEWy3
znVs>5EzpGrX0<C>u{l5Aw?eXI3a{=9Lgwl7z(0i|rr!7EkI>O8pbw3?#-%+w8HPCV
zT2ICut}l%$^u|Y%6Zts&xti@e8OG4l5-OlH`7KcM;16?j=Ze=~_eEMl_Db$hZi$F$
zNZ+c^_qUt|LK(rjM}%#uDbabZhmNE0jS9Vc{wF2tyymtgT@Q#5d#+cMmw)gODN{-B
z6s8zZ*Mz3MIcCqbe)~;1h(5jI?qu|5sbL`{L8K`MqY6R?8-E`=E9z$)%v+ZkiZW^=
zOr{;2sI!`TXb}u0huK`mwvL5qERJ3jx=XA0FA?9#%|_cvP4s}DQ)SdEln!rkq<9tP
zO4a8+R9oW-yq3#;6Sq$>N1sBPXD%0!y*+0N8n3Rm&9)-DjW4Pk9Q7qBf|Dv?@=YU9
zyKXrTkh&>kQhwAkP4Hc<%CT!z^uh4E>oQTC=z&rW%Uk8xZ0vWAmLGy*x(ZyWt6@=3
zg%QN)FU`qbbiXl)24GB9)t@9?N6kc18+W`9bT{lGsDk{dg)Ug_N?@*fiDMD(W=5gy
zTX^`iK`Moqw*UCbn1)_C&{IV`Toru1R)?C#4a5c20*38uTgs-){A-BU+@WU6{Zo61
zH0Aw8<`!4@2P|Q*qYd7Sy;8CB*6(g+?imzY=&vcmF|2l~ks2^<Axcp5ZtbneYl<!K
zhWZc>dQXJW1jZp@FQhuFes;ZZ1wc7G9Xt>$0d)J5`uZj7+{k3@Y6<c-1MIw!q8%lc
z&|dZaI;(FdN8(NJCSm1+reXH~JP^`=U_A+n1MH^mHqnTXW@}t;vRR|G*qZf)UIp~X
zFGkUp<F{|v^0jmr<QmdZL?3UBcfSw8pqAOUlE2-$df~x=t__dLeVe1hdY(|BWSJNn
zFj%3~ePNAePq}R!4)uWCUEk_{4*#_gKEqc0u+m-dWTu%ysb&+Z3=GoRq!^5F+?T_#
zjmr|)y*htn0E2Y`9*+yo#BiOD@Se63uJ;n=etxA(Y>Hg;aa(c|dOqNDJ(*MR%ukHO
zHCvoyqAXh#P;%il!Ye5Xj}@w&LLY|T`|$KU=JP&Kog|wKj}U6p)+Wm*h$k<}+D}8~
zl9ireJ%nBa=FHG$=&X6X^+_r%w=o2}3#Y4740$%k9vJU-B08hha!n?FppeXgt(Re{
zhUq|7ElkLmvRJT{KcWkCE(WVnk%Moa>^S@I*(`8=rFRN8WstHzJUsm@0QK_v_^wQY
z9^Ec7owkeASN;~KTuc9vxVbD~zpwH<l-g4ah#JG!(meOOlBahrsZlk`XF-ue-&5AA
ztC{)E{XJdDq;-51Un-ALvbzt#H927x+lg3pDp3d4k>oD|Z}@s|THWi#rfLkPqEJIS
z3@g8kk1s`8u{Zz5Py$vXP1cR1bN(cl@;<WZedcT6BSa4%+eI_!Z_tvaCd_M>Ib@C;
z9vxAe-J5s^lhl;8b*7YXhT{bc>-%^@ve1UP+=*@D6Vb*qF6hqd!|j~jq)!o-;?Z7K
z@}YM$B??je3Q`n>UD%9*g2}b44bAHdXE__=A4`6904sw8OsP&ZQDfv~fqqm$im`VW
zKn-p0NdR4PR*jkZ7y4-35>$B8{l@q&{7g@8W{v$>1e3|uMj;jckX8pPZ?tj;umQbS
z`7hQ^|GfI*`Xx@XC*3<t>a0OOdEKVjGvQ2>dMX_-9dU}KHqV%?PRc9wCy6Rbmn-vT
zAzK6*O$s&hI-%#lLik`?24rU4fGQR9j?rH;i!Z-9k%<l6<FNbwG<mM90=oCZZ=BV$
zAMWI?ZUA8t!of-#{PQ||45ImH*g+Yf^}&!h&cfIhldpR)Vy)~gS#)ojyt4E(3^2fb
zP?GrK%9RB`*#I$8(I%Ucjv?X?`?)DYv8k`XQ{nwSBAp4URa!iDV>vaWs#+=jh+DFe
zKDdcE(`2)<5xSGw;$eAsV4ji))N$RIs4yrhkBiGC&yFf`KhhW8oyoO;0fwa9_>;4<
zDQP0DyESKb`PJU+@U?+3Y;89+=>vR4u%Lqf#?$$(tGMOBeU`T*|HXQUk<c<qt<EYm
za#*6>AljdwHP+YXNhiu&2mdQgN){EOJCRJ$0$i1k#f^>kcQHar)5w-m0%HjeNfe;j
zVx0jGLmCedA^MyWPPGH|{`{5%dVOd2>zI$v&{KuOuBBBzLTbtzuT|7TItoERIbPYw
z@56ID9%y0hWJsFEBj0qYHdZFo6%Rp6i;g~XO;Ks}4uk3L+)dSyw88!}xZ@Dxm~@bd
zgamP2AsYR4M4XckEy6H2IlT$&@+a`>ju7^D{>HgNRQ_%9te)ljB66pj+}_CG-@TYE
zb$FAxfr4|?H*PQArbaG=H1AyUmGVncop2`;7vcuB7Z`mrTX$a30EUiBNz5*l5(HDp
z+_&|jXnfvBd<0jvu=+PTd(@H93eO*j50U(CcH9HTeRuDMJ$~Yil|MN20ngnuYlyA;
z>y0O8FK^yp%h&s@^0n7_0bzmK*O&6IJFir$yxlv}v79XH7$d=KY)+Wy{OS5)8R=-`
z@YHWSX4t`js!$}KYT{t8(rkdCv*T3@3$i_mJ0f+JjeRJR_sh8mR$~XdHbnfR*sotz
z*$&muF2y_W(7xbvC#5v^s<xqKAS{F-S=<g^hK=wMRWDc`S|P#P^VEIKAh*Z%`_Si*
zYS_;%@dV}$vhBt`lJ&UafhQ#RRMC;<gPV?}(h+~W@<FTVL{Y-MQaZesK1vr1gE6vQ
z7Y91bhYJD>yUAq@wbhEu=;<>t2}+v8osLH%zqF&a*AhkDDrib9Sd6fBF|F`3Aw|H=
zK3`dW1pB6V=WRDoC5UWPK_=%4`DZthx|FTE?lTw4hZt5tVXzvpz5V8sBmw1<4>xq^
z$V>o+S%g*58)bdlJZ@EUy|O>)B-8pC{kJv-Wr$3a#b!B;IxcOp-PXmh&rIt~XX)w}
zFL5ohda6G^q2qF0dcHxiewae>>sUEOxrS1o!qYy&h-5uvRWgB4`T|VFO(`mzP>;Zd
z8QQ)rOcR+Z-H@KBOY6NSHY?{F^+iyte6AI;A7hwz)7ZLx*PL+EczfZhAem}rg~x;j
zr(w4)HACCn_u+P%8{vi}oG^d8GmT~DDS<(i-$V78Bs>X%6Ufz$)#~1a{nx7B__cpy
z`Rz<Vp!j(8o$TdWTXy0Mg;3YAetz=~1ASHby;;NJFCIVlb{u1PZo)`C!A(2ISRTKY
zRb*@U#m@&Nmxh1Nbw033-kWZIWBiA?p<(^gjPA;3GR;9c-S_-UbmAY8j<|W_izhtP
z^C>kBq^`v4&r4`so0(#_irpF1sax#N%(|6Wc%!Gxx;3oE_)6QmfwLE%cWE#S9XgE)
zth`Y8apg+1cFx$~bh-OcPm<`t(RNZzaj|`h)aDntD&@?I&CTb1xJr%e7O38|*pYye
zDVTY+kkX&sB<L$dyt;-GO)@5uEW|UWQ(@XbDHr|8V7xvbD<gA$2G1u%{|HZs7TX^w
zwI0=TMmy;ZU(JhEnRum{qnGTIH4J7##KenF+fBPVC8D&-y56w8&s|X+R@|xVa{ry}
z>dew$C*xg%&6=Z}q@!mU9%~<$7YBuwzMId4Gx(nHgbRMOT8$DvE2EJ1Qa|$&H`~Xq
z5RKn>3Fn!L$!cFWB&1a3Ef(|Ju6lytWkZoqq&)9+aU|*LF2ig~X4QLfA_RZLlM3%`
z`bNh{%2U6pFrZya_zV;O2Xa@W#y@;^9i43rmrT-_VB$NBFCc_MzIXnq*)wa}x)fDF
zrGLweN9OoNZtAs;%lntYD*C=a?+<Ft-?QpOw9H1jspF<)Oa(}k=n{mWLQ%NqIaE0)
zYhvVdz~w1jCC(_TC5O5%PwiVR6V7J#RL|)OY9J`ajS3}pw5c(8-_Xm%ZjlW`wp*S#
zJo|UCm}(gM-^0G(?#Wf!M>HmCh50Ohu;Z<E9Ks&6rqredH8J74pB{aDBX>T#O0r(S
z|8VX9eIYlh@1#88ctg;z`@&N;p=Mp}xfmkl9UhR(Sh~z4HgKT!``b>nz6}+Wl5X{`
z_YDhl@^pQwp7|lR&X^|%#y#t_nfc7;>Xd}U+ZK}ycbe;n!L^ti8Xct#XH0$t=%Dyd
z0haA7zHsJuU1im9mA+iS+F7)?SUn|PYdhDmqonp(z}NBuX?c68Wz2Yr^Z_6Owx#ef
zFzfKiJbMC@IvzM{hAU>Pm&3su$_g~B{C+S02;&uWe<jB9MvZ=@z4>&X*4!T*Ft?68
z>rMGs@8#NYKyvH*(Z22bJn8BhN!>r~HbaVT%<RQbh?Modbnhh9(K8b{?!6#pjaT|T
zFuH1MLr240jVLx%E1=hr31Wm1^6!2457zlVt!^w5%69UZ`#BI3o1v^U%km7NotSQ(
z3h#TBklQj?Xwdz%In}V$A!V$_$zH>slyP|X^|=k9k>b5WfQ@K3611^4dWWhozm`tm
zC!}0U#8n@EW7n6j7n3N<-_Gs07XS8b1Z+Q%t9{E!*jMV082n~{ts<}U-pQv;%<#5R
z3Xu4jT9xE%Dv$oab)>smGXLn~{rYp<gFolwDMTyip9GhbuwxNdpf{WSNdBw|OX1S}
zTgK9+MsnjutDP&SEs)j3e6S3D`6HtSKHaw<O7~|Ms~P`*&vcz*;vpXMp~p3H<>4<Y
z+0g}kJawtXP3%^EX>=BvJI|Bu+{~r$L+luP^avlr$M;AEV!Cc;T{@FTBUQy=P{E{q
zh0mRDez@?!=EmSm>z!$es(7mT!-MhPep57lHnYf$AiZK+?Sv=&Ce!h!NVY0VES4G>
zKT?Re##+ed9j_B^`P25hYtyY5$Z{N+Sf_VgvT@6pSE6A%VV%iJ<#Wc6xupa>1G%m&
zPFs;IZQc*EtQq~jyIEOTB^FUh4LVjp;u4BCXp}yu^DUqby~pG78{SH8ji=QJt70s^
zG7LK@@xR$C8NsK7&ql@8y;9?_^<$po);@<0?botpB-@aW=Jy)Gbjff*0}cVYql-$1
z1t8x|!0$y}*uQh<=%90~s$2*eKQ<!O$5-U-fytXD1~X77IAZPA40LDPt}ZV#PG{dd
zv4i)-*sX9yDmM%UKalU6h?ns&mreJNjQ2(iG6(rmNz6aXP${((H;c|xlZ~u!k(Za0
zjTyP^ka}L;3Nf6{PEKS@xZ+53W8(sZHc_8v;lV{28r!@fy^qzzq97}D^M6R7CYmVh
zyY<1;<^E(h#;1gn7Mtr5jKgLK#NI;&%+Ry2lo+;hoyVA#$6<Gl8!5H=P*rp%gvx2n
zzzVKROZbt9>I*8h6JyS}z~FU>bjz_z_RsP<gD8X5l1iQiLF9#CtW}BMA}&XS`r^U(
z@d3Bbt#tm^m;yJIPH(_l(07Ev!mv-30PdTPS0D=vkv2Eh1z>ZqA<WA|>|~WH9Jgm;
z4qf(d6*9V$oK0CHEyp!ylCLDZd`bK2Rj(m;h^LpY7N<Qbw}9mJ{i1*Vl<Q-}1=rG}
z?_AtHv;L>R<AMiN3n!M89uhl}1YA(<9qg>l^cb_kNd+o`@`O+KG}T@MZd{eT4E&on
zPs9}`50D(rjGbp+Fmo5A)7TpS_9F!3L{5(n{yJL5BIf&V5A!<S=R_Wv%sqcHVU6hj
z`v1`C8nzQSa^d((dHl@k((C&ts>Xn2Rk1;c9e)5f=lo(_yQt~s_UcB#n*~@?<g6Oe
z`K``uI@vD7FbqS2fEP+R;yW~It^r4!VUCtxkFB<+f0AJudF?Truek9%&+avX(&tMf
z=><X}D*YLTG0_;LJY|A162)_(C-XUyxx>2bqxoFl7Z<aU#i7$$Lu<HDM;tZ`9c;G@
z?~LR3Vn@ac;C))1tk)g!R<IE%l(0%i`oFE1s3vCGOS?YWQE0R`lf1=%2uhXRY8Fo>
z<`AUam}xz0qfh~N?m6r#ZVhv^m5e+(N>#sEs;rm*b*HO~h(GCgZ(R}$aT9V_QjefI
z8k#+1!@i|DP+?zPgvI36HYY-H`l5cw`|spX%wlb?V!Xe6=B1Ah<ruLOwrNkY)6xiD
zC~BbH9zyQw>P17NY8zX#N9BH`8{xq{k4H<|n?su2prV=onXX7|Zean+ddkXA>Nc1G
zFnf*Pdh!pD?Y17ycFn~R#CwYwOzU&f_Q#Ti9(O+h%gN4zt398tp{NWyzCWr?`8oF{
zF)=JhhhN&vv*Qgist-VqnJInGH*Z{fQ`q$N5iJ_`-mQnB4#aZy!gcT?*)5(43i^CE
ze+=`>6RV;)Izxhyg{r=h9J#dAfv7=;6s1;|7K=Y#K394%<6L2Kcob)9IEIi;4`U_^
zhfq9oT>yj#GMiHAZ3ku$qh%_M`_fR0gS6Z)e8u?qU3mWSe#|m|eLo+zJpIP6XcI0@
z-Q@E)>@gay75v)32}8-OZRk{?7<3b~wWfVCucj{Wlw=%6bj3;xWk=DMN<}~H8X0i{
zA8>&!>Z|&n!Ll}rm;rnTtjt#D;KLVq!<FWrm!ggum8<^O?O8zDYgP>fb6p0X9Nu>m
zq+^$JaHM@2*K_m9Z{5yK0Ua<=qO`P>0=?=<Hug#gN6>7KMn+LT^eb>qHLl!JdGw3O
zbj9A+=YQtMPXAdOGwn+lcniT=Bx>t@Q4o<u$egNfex|LnQ!?02XJIMROWpP8$XL11
zD>AY{4w74Jtn1|D0N`M53koZnOT?EOpQ7B(?+i-WE=|;gVDRg|t&9%ga{b4B%8L!X
zpa+9Vgac8|Le9+R5u4VftLDkLYE4YsH5?nu;}udL^)*U6@V}c!<3K*xbK0`pZVFuf
z9?fnsqU*?Au(_mh1Aq4C5544QgTxy+Phw&uL4LQgI>kE{5pYeYLC}Lwo=Ez-*()sK
z!|5<+T%5OdVRdzQah*Rud!X&7>^}d1erGqOW61DP#S@9a{GR>g6bF(<U*h=g@v5-k
z9)y#X0;ZNkPawr1gUsg7&ZQaO<nr|}ItyT4#7E9MUsR$^SZ3BCeP*969M<-cM1eK+
z(_b&`4{%M{FAm7u>A!zgm({B|xDggYN!SG4F3M2rFR?hA@%~mAPHdl4u8x53?xuyA
znVIc()tAvB82|kxRX7VtUS({V?(b_T44is6xMs^W_;X3w+H#NwM?J{ndkCG8Bme!r
z!SF^-_3_``i0TyAt2naN*#f;-o;1kSezspUFK~9+3@l6*v{4Q87FC7Sns-xE68bJ;
z{^KPCqjHkosNfh51|H7dT8Z?^NeWltm(C!4S7C29_whlLkF28gs{Xy5Jj%v(Wb(l1
zC+Ic(X4`N0zrJxp-}sGF_?^2`3%$ghao7^iZ*&_-hGOtSUpQ9YuJkgB!{L%Rs<Ky4
zk1q?G*6Qnfh3kka7tZOS{4;F+TUwPR2hges8qe)+bd{AA!(dmu=yZ{Rfq|W$)Y1lP
zHAif?3Rvg=h~*uXtr=+!eq~B}C@Jq)=F{f@O^i}Tz_rzz5^BcE0;t7I5p-MOwY}rm
zEG|L0M{n#KOL;}SefT?sku{cr0gB=~2MU&!SkuW$@Ch69N7^P`KTQ`wPNQ6H4kRpA
zfB36Bk~(w7z(B#;%6R3|ql;Qn`J0KPvD{TvbyXkdZO=|1zi-NUk@D2IyO+KbUE#8)
zQ%;jhgpK6@SzpH1=_<}#gf{S;EYU?L#|?^3g->23CW`Kjemgu16YhiZVO5T{Jti5J
z;}Yv1i;Vo4CHuKM76#fweTvOg40JAHFF#frx;7cE!^OoN9?9o=$ze9Vg|W&Bulhwk
zb!f6gXb)?f@lcmxSNzp4#sgv>KN^d|H@LODbmRMn5BVOLbEzzj1=uf{)z&VCwokYh
zM1M8Bn<aLZ-PBRyQ;o!)H-WtEtdH?PmPomcjw1cW(&%QKJEGZ9O|jQMt*Dn!gXsn~
zet}LEA{!%=&Q-ETP;*ROuh6N^tGQ(QBJ;5fD49F`JC~od7j27{XhGTvmv&iReRH~Q
zjwWYXZ~z2O_S`)(_jMy+<-<PZwmdsuD#sk?bl?156s2T}TA^Do$7i>LqTJ7PUtNr+
zpyKb0J*X6^5YH}^94@zg@QHfD3JPg<MVbxl(8Edx<_zuXTcZR5Y(!i|-pFU~BNgP0
zeAqmm;kdw}RD)<%llZ*$YUcxVIPailegsXq!}8tnvDCXQlYi>w%C|+=JYP}@lh4@;
zV|35|u5<y#6I_TK3`#2su|xG;*i^oWVErt5qulkN7>7Q!x|(Ez*h3D(YH5CcCQC?C
zuJD~_M^Yact>xbZ-+W+Lpt8ACTtOtyE$1G}dFjA_^9;M~Y+g&Kq?(4t19ynfut6?W
z&#|bve+#-2BBCySpQ^jDYe!_+8Eu)$@;YisqFc$lGSM`oe46Vz+1<WeGZU|yw{vy(
z8T2NHeKr+}=8f9kbr3_}z^sLm9-c{MF=i0qAMhnkSQ816C}Atw?Z6)KpB*!Pd|D{E
z>D~Vozo@THkoXxq%a>i9cCm&&xo^u&JW$vuj?_k^n#=Ki-m`D}c9zY76!ch^(xYUw
zc0he-lDzkDuEXMRtu?u}4tgMKYg(Zvg7ozCWO3aL_Rs<Dv(~E>Ok;;-I7HWpyjdFM
z(AQC;@oxCToH^2=k<%uAvFB4j&nNHuot=EGI{Es|W91}lD}1>YRc*<TvS~sadd3o!
zQe~vs=wd~ep$Q&?!Fp8G);BNH2c?N+kq_n`aby4lR%Xzg%L?<6e3vCcwuAT-zcu<F
ziGK{d(8Dm*pE(+`39Ww6>efUhy>Av443KZQxOs)>s4(jH*Qo`?!4}Q_0;g52Lbp8w
ze`!=;4uv;E#sZfDL8h6?;L7Jc&)u`aUbs)O*|Rk{Uwvwcx%hNvZ{=Gbrj1?OEK1#b
z+%J_0mOgR&GeP9+9vK;_t^KUSUkaTKAfBEDumcKabBWF{8S3jZEZ$#zPc*s`!BTA;
z)#q#ianMG=3u@=SK}!4OG4svu6TG~8dD{3J7d*DSl)~tQV^~o0Bg4Z%F<ehVSoOYi
z0=N?|!w{8qUs!gb+YOd!$>3Y9BsVR?-UHSOx2Yu2l`5<f_ag-ax23!%p6^Pao2Kb2
zNNNd()Wv7KIbfcHPPyyA2pH{}qlaJd{XDuxx5R&xl{lMt$honpHuS;G$uQ0H{2%jY
zHE`o~YhAEOAOBF|JR>s7tei0q8Gg2tZ01{clyI5HCrW8r*@BHvVRt0!JegW}>9$%A
zkGeBxO_i%9p1-J{jq0A)u1}Ir_^!LJa?dU7-i&z(#G#uO=2?~YwxB?rX0EYIUM+S(
z>L%93ea9qly7XM2xx^E}1<^I-U(t1FM(Rx-3}8tVTc}P*;t(1-hiG}%9!l<v{2*SK
z5R@9NCFim)fdA3f*6a^aOjenuj}IzEi16}66-|=AGBo;~@7lg&Hqh2`FE-($__TEg
z>>C|!(pyllda5^di#ql7OshK%{;bf9{AU3gpXD^3X_2ts&#%$EbAcg@?i+NGdv`US
z64eI^Z7uWvV5DKQo_r)h!k*<Fovb9+#X$5HGmujt>pXz0CdtX%wPxt{wLdhvIC)J^
zFN2DBj-ISds@vGN_>S)#lV@eFdzvF_A8;0j10p<knYHgq>m;o!l{_zC++jIEyiC4~
zr<K(SJ=Oj(YQt#US?)nR#Y51gv+Ke?`*^ZdC2^}VB55(gNDwnrOEmkNxE$8_dxvLv
zRs&fV;!OQ{D^pzTzSq9Fv}r(SpH{XyQoO{lA7HL(y*4dikY7?V8+fHe$Jv=1Fpn=h
zz7ET8=b8eGJo+;yI(Uxu9hE}qKC!Jl-{}jNa5eIAk_M&KohMKo`$&1}RdFvZaz7u;
z@o;m~hS*%3pHIqFB&n~Th1k;XBG7Tk2o%KCs-$YaTA*7?XerNm8MQR3*N2#PIdr*J
zC`T6MaWgR~+?L~z9-FYs&;Cog<W4hnd9xUaa0acviTqKp&;AA?oBYi411B0Y3x_Ry
z9_6bqFaIC9zB;VRZTlL<1Q81m5Ks{5E@>4>3F!vu2Bn*001DDA-QC@Yba#hzclS3p
zc<w#--tWgh=XuU~&ffc7YrS*LIp!E+Zo!O#+4Rn<PyFkog7`%o5`_<VHQvRu9Uy|D
zw6ZEln2e$}eh=n`&OFU{!oy}@{uaB=b0yWPM7+H6Q{TM&r^JLwL(3^XQVhOW>mr%d
zQ0yegrEnGu`3~Xr)m$6Q4S0tYm%zj|`~N>}Pa=a4m?J#M+m;B&F(y+gXcv;rHvMx^
zW7Lqtr8j3=$<ksr`c(yq9?c}Z8!ge(OqNLx>q@s;>%$q<2pv&R%FKK;*U_N=^Ap{&
z4IfU@`Zt4t=ZWSEF}6Y5clfLf`kn@aMLh{zZi!21sXXrTsqn-fm24ALsIY$&5Bhaw
zQK97Tt{}9Pvlw{c8NlIm%2B;;-Iq4bSh9DunD<0i<R}4cIR8k6^?RJSQi8DHRwHR_
zz$=4Py}tt*txvyLq^c7BJ*8?7Rmm&qtuh9xr9RU<5$f7_v-4~v`{uHP7Ci|ZX>z5O
zyfc)}8uh!qq|Z_xw}uAg5n}B;aYkEIPIk9QdM5hl;lt++vn^`N+ME;c@*icL>@LR7
ziJtT%SL(;<&4ImBkEMA_U8Ja_D)~-0*zoyA$eO*+V&R&L-dJU<@9WbZDZ12D+n#i{
zL8bg~_%`kiZLVgcKbTm}FuIWca!X79QhUJXu^8RiKh#4dRg#_92eTJjhW&aH#c*3o
zGk<O%J#6f^O5@vG#d3Np28V;qT$hP;x@{$iF`<M*f3exNvgsjy(D9j<Om9ktNeb_0
zCd|pMdHitye%+3XWX@WjyiI%gA&p`|QP#_YvY!v`&^jB*WF@{L*edS)Bc5klHcfab
zcNgiMc-;0_$Ntv^*#1SzMY8dGlPQHoSO?w^ZSL4P7DLANNf{r*eC-rjp3l=<w&dhs
z?hgFUL+r(++z+Cs$2M|T+@tLWB#*Sia<!UOU#V!36O3m2!c;-2-DwHQSpp}+SE@7d
zc)?)m_%a#NB?^*wsk&cokc_Dty_$M)xVSp@i3>)16#~-50KDu|J2`3Ca*F&XSfymN
z=JUgeZ?B3m{VQ%H^Bu8Gw1nm3Zn8|u`u#=8MD*kI-l&FB*xcpAH<5*bM?Q(ZBnOhz
zYV5G_ebS@n+m7f)#N(Daq}^gLUk>iU#(lmXPF#_9SQ4v1mY2|pz)X8z$9pN=%Lt@e
zdfNrz`oS{5cp3)HwKZv)m^<+j<Jd<Nu0yX>%IU|#Bc6YFr#oNP=yx3kp)pQ1Kt8}~
zZ;fVF^j;0Mx4Nlmak}w^b_ksY>A_n;|6y@#8BHTzCkKam)9i@c&AIO3AvALeytj&E
z9tdpKV*=@6vUqF?j`I7jS6_NuscM)wK8X7LyRz|#PTO)*+<8EN!yi#08h)5+$}YU=
z*qNfxyTil_VQp`9bg1sx!hU>ZHIbLC)7A8kIM{;HHq09JMfNT}?YP3`4}Hs(iZid;
zk#EyQ;(A;NRT6$t>);?DFic*dHMC@#=@A>pE)+I>eAZ0yDRz$ve&ZSOm#sf$4&()@
zdh;=@7<&43rosTq@6Axo*6YTBe3amMmhd_qeVdP@ybYk+&+JT-$#Q*4krhUl6Mit_
zEnuTiL_o!k@tx}KPt0e~TOqN_VSfqk7h0;lUVV8IxTY2hT}oTV=JF;6OS}h5PU{y{
z=3)^pMq#`)uI1gE>0Kv1-=$A2rTYh@zB%o`UbnZL=?h^sXmn+jq;5(zr{(YO)cS}$
zF7tp5f78Rd4-Z4et8a11Q-9n%$?;@|Uv)ei1~q?mSEQKk!Wp3PbAN*^^n-RnhqbYj
zE|l-C;rR<p#~dCtChP1EyDF0bjiBenX6!1(IRV&}XJfp@k_9<GXq)4kvIr^CRs0!j
z=8cS)E|H`^Kq|GS3-0ydrJP0@7%iQEOcV<c=p0%-3?xZORZR3y4jb=(?3A(;QGs<?
ze*Vr_x#LL2o@@tBl8=wnU`($Sv&K$9JME^;=Wm?9$SV(m{<F4i4*3HBblLIfV>UFV
z+kSkcGZ)uOGrjSdgZ!PtiGFWW_SLQciMr`qJ3G!tk8QOy!-x`dHg8C7+>nse#wpj`
zzA6(kPzLrw(%ya&<Wp+A1#aKM!>Q~%gHNdMlPub}`cl~y>vcO#vF*e%rT4ffjg}CX
zA12$cy)`kwHTgTd3S7ksymnnPMKs9k_dR1-7CzdkHk|T?>dL0K_d+QGHoGv3Mjt8j
z=Vqh_FMC)QJPiG@n$$N<O{{p*Jgg{I@0Gp`&W@oD(uj~rw;P7JQ~JdSMPfWWK^coo
zBKUjdNne2cz~$@CC=Ra#0Wptjm%6LQ4#9Gntnec;`xobf8*HXEk);cNFMoH1ynY*C
zK+ptvf@HZMabp;3hdcS!T>JHv5mr?{%S*IOJ9vyq$Opjgep8J1%%)OTI(_jl;hXX3
zPzZ@w*Ow&ygsx6SBBJCR-qbb2x;EO)+-Sruq!)D-ePH?-fzmj4UEbE<r+;+22j7Kq
zsaq|G0j(M)X}A-{@3{zQX<KD)7)sfRqaW1W`L^u8xZKUtMhYE*ALcR#2XniKpqXVO
z{zZ>g3nFFc^Yb_5JNHaVLW?1poed^d!eFjbq7-BRrV>J09BBd=;>^~NgD|?Wzg7ZY
ztZZyYz;CK47x@holF^Ellnrj8#TVv#6i(M)NR{IJi?UG%^QR&s6ZP)jD?SN!74!Y@
zo6$M*1_Zyr@Pc38ljqrFf`b^noTD=|!u`$h^0jYJ<Ot&Qn)ByBvmzVZb^z1fyUP$o
zNGuW=e@xZ)Gq@j0U@v~pb|7QdFbuS_*`a?)wkTQ%d35ZJH*Zyacx4I<4}hA&x2*;@
zeYK^O3x>R&-^#V6i+!m;l7qA#mDZnhgV>JD?RpiPg}#ugEBabpI68q!tY9fp@Q=g8
z{qN5rVbpz-;GZ}qLXoXQ3}!#Gn21#7g~#`}Cd~ATTx^4Os1s3f0nEzcV+++Azs2i%
zYk_h=@=5vJ^_TzW)?n<p?5d#T5e$DB#h2i+7LAk_rt_1P-1K2+!eKE+3YT`nI6BT(
z-#BnZCmI~qYZAYtD3A#?m97%GiL3k04)W!M8<zK>U?ZnMSRnbQGN8a622&RGZgCSH
zHq+pd_15d;h51WBVU|NI{I#RQriI?pQ1wtDQIz<nUrJ_Yy7t-fprf{+z`jYI<wP~+
zDx`Y4KR+EXE>^qsJclD5149jb$NHGZd<i~ZV7P?T)TjxmE|to?W~j_J1PiT5lx1EC
z6=E&Z`v(=gXv@n#dt=n!`NX5dQ-R?N2BNc4iVZ;WPDX*2dQext6(unSyhgTfg^r*v
z=6#aezPUx8M1#Sam0vF!CfDxKldjIErSo0HI!T;^AVGFnD++_64%M=FHP3*#H91rf
z+4#|O+69jipeTuZb#~I>hTh~MV@*r4@=D9gb7r@?Wm%AaO+itlN-&iMi4S&_2l__S
zdRkiX;#aD4t762r1M^KTzms~UwR?VBwMUE!b1}a4^_xD4k<L$93YAgcAfKVf{`-Oo
zpi*$qVc6Y$a&jezrqbbn{i!Ci-Gta}ikx^-IAL!fQ`tOt891gut2O_Re3e(|PjysV
z{-kSi;3{R#{PVW_<FK|Jd%I56!xrOPRIGUdZ85Uo(A)ZhDVL8$w#6A$adixBZ!c09
zdgY0qGz|wjob9-*@A$A=b>+6(%HE$yQ7rW38&^Pm=4m$FbF^m#LnS^_!i-tjy4U$7
z0=P#}2`&CCsufB$o6k{*NE67Vg@y;@R7(pGN$a)?hF&5R3Wi~<?_RJQS6b5zjE#Bn
zDS_Z`h7Tv0$slkWGnSTH*z=K~;%$^4wG}GmCFzEPlgoi0$Fe5ZCr150zu=MwbD_>p
zBqm1x&T$rtOV1vL9!YtU-TRg~iJa4;WHfWUx$8hD@~I$8fd!Y`h~b>2!e-5cQR2y3
zf9Bnl5!-hQrji!rFH`3N-Ueu{CaY;pB_LF3Yd!^PwO|KVahP&v7>gx>o1iAA<;M;#
zOG1(qCHoSR-`2PjI@DHY(|#jAtk^YrE@_|!`<y}bSbPGo*Jw$;pOaSZYf`Lo?R$%&
z#F}(B)f;`ei*N({u)jH;jC}FX-Eqd)S@jWWp5;wbE}eveXhbx84gjHzOj||7u`zgz
zl;E(1g7x`&71%*VcUpXw=MJ<jgZa9>^Rv75$JXfWp^KYIX(qL9#LzoTHc1=tml?mv
za{_ojKZdKkiRtlGG@PE7H(v7cQfWm?!aN_GeT=+o`kGIr3v_qFTU9DJ)>jI78^C2c
zQZ#sd3pzGV`_arE&2kOtkX|({_dL%78*npV7scl_BVeMggO{1xeV@p9{+$@b+I;?x
z9)<AYDw>`JdPGoYDC57$E_vq3ETOV~Fb`J`=W^$D*?t8fF`VeZ;bEU}zR*+|kz1%+
z@&zrWVv)>E*ssgWkNkK5_QRyweCi5(){xPf51wN^J4=b3!6Dzr9rn;LtS4Tf<AnK>
zOG{z9NlI!r#oO$WDJK9c>232{zMs^oPEIVXrQO#X)v4YV8WUHLKVhOlBVsB^bb(QE
zgf&bs<<$12w}L6uzEXxMhJaAujLN-XEh5Y}8h#OL=VCrBuouCpsMQ=evy>UGYoAJY
zM<#BgAlHnHo1126x#$BjjHwYO;!&f=F3#`G`y0VbdVR#E_GW`Q)xs>&P0wVY_Z<?e
zlFEJZXY-$1U789)7Bh$}9*C^5CD;J<CxM~PmJ3=po%6F@?;`YYWuDg7WwZp*V6g(V
zJ?u~er~=Vnsg-|FM3#0X#7U(gr*-bs4{WKN92PHx`<wzeHd$NQF<;^YBRAj-sZUfN
zETrZfmDp?v7cljijO5k_4a$#dHSo{#$)s#ky^$D;n)ChT=CW%I(G~i_j3qZ;LC;E1
z5D1@U<}G~TViB??2B|ln>!Dq*QmOQukp3O*e-*Wk_DyF@WO0#yc5ZIEWa2%K%Zw#j
zcdLJ4(XvQ3#U@lRniIN$`CrDL<0q`YNI@|;ff2eK<oSHav((NVI6iMD0Juv|W;&*r
zPrn-!My{B5txX$JkIujRSNx+SI(0oo?vQ_{uv!*Ss59+JnkI=7g~LX$_m9$RG4@aC
zbvSmXJ3I6zs)hrQ76AO9WKX(l(Z_C~uaK_5igQgk{BQ}{mU>CTI=J*G5sWv;ln+;E
z1!Hl^&~W>l**To>Yx#n2;iu6%gvGK1FgK{AO?TXYx4ECp!Ix?)U6CEg+%WROM734(
z5ONY`=001K`Wq75UHA7FQ(tk~6|mX%sP2+bDb4?!^n8Rvs|qGx?@R4j<6eKGDMpw6
z!nbD2Z%~Fd__XjA4jMI3Sq2iu`a}zexvek!fQWTw)8dzS-#1zg_1{z<!u1qeCyM-B
zPV)8UVbn@T-+lloUa9Asz+-W!x=q$jKaIAgUm6T3#~FO3P;7b`yWVq!LNk)ZL<)hj
z_oo5`2N_AR1G^y*V5Z5^*!toGE$I1p%gZ|{->f+X#Ed<#7#pBk2Iv&1V8Zdfqj@QB
z0=(}`O>~yN_{eel_AVSA&9&R2q0GS?&cIq=xp`%$Ln!dLsi}!vv49fbFCGU`7<>4X
zn>#bJ(lTaprah8`aI*6BVJf?<JEp}o^wqe+xt4@XD@$r(5+599^XO&hiII8O?g_+v
z_!%dNoGgK8lU|mL72hJ~@wHV99diBNBO^2g!KU%K-R|1RE2fw_*~9mp*W{VRBJ6Q@
zBiOB;T0|s2+>Y(gg?S<m$@Sr6Cu4*4N432$nU@T&!$M&~<T6~@+z6_k_!<N~;l@5$
z%oFtfKCAurFhJDr^q2gIdscpavO<1Z<(cN7<XUD_A)k_IieV=XS12%3%At3qj{-r`
zaJjBeChh~lp4!?62_Jl}?+<d$Bi%m_Us`VT#o-IKHfa!sh5>505g&rAA#iqDN=^Iz
z5U3Dve_`<T2xn(g=-t7<oc$#U4xYe~`I>nnNfszj-tF#Kha?~A{DpXOpa(!9^If&l
zQ2}}&tVDhr^tsms0+2g{g99ur3z|rbJmyzN-;<w{c%D-CT~=Z-{?f#iqx)9qs!D~u
zl0btYky*Cya9j8m^xJ9_f4AXr@&YN~rqeu_Q!+6M#VOh9jMDWC4NWU-{<`om=vhBp
z*h0IC)4emf=rXGQ<C9(InQwa_$P2C@ck~IPQ@kSh48)}f+X6sZ8w9-<*udf+jLRL4
z3IhD1_A)7C3%as+i+_B+>PB@4zU`SKn{$yoY3b<!TlueMFQ$tLyYkQcXQPX9eXPTe
z#BQ)zf3qx#AZuh)5iIEe7D7`P1<c7oIthAJm|QQM$1dDFqg>o63c6|uduo-1t+9+=
zO|sROOdl*aQPH&`<%ys!v%SKMhugr&$mkJXu6U4&sB_orQ0CUW!ouMai-NE#4$~!O
zBuZJ2IEt!&{u~<``awe?NHG66oK7Pt3{Ob$Kj<3^jwZS-!75{8C!pzfI6GbK&(t6!
z!s<`jzzf$0?i;VF))~6=&6{+v0?Gv~p<GbCrwRHk7GWXZywHQ->=vAaQ)B9AU;ldZ
zo=?W-#;s~!D)moX_ae%_;?V-x+0)zE04NeTqnEW!@A<o+pl-n-@&!p-{u}>&)A<f+
zrxPaoPQrGWLXq1m96-VUh#j+vFWkHMLJ!qFA<nv`%-@2$K811TJ`xgkh<PQ;^rVDK
zq{?$ZSp)jlj~;ICZ{QyuZ7)=O`Qk+yhmw3@<>5=bF_W4<XpmW8DzkNaG8sE{A?IGN
zR$B17OO5PCq1BmL%P$=r50%s1-ivVKO}x|@E5KiG*b^d~%l7=rOT7%JAz`nSS#vCb
zAV<l3vz+D6^6fK?+V|hxx^`@RwdM-a3%+NgYiOMI4~yZ}p~*zJNMJK2{i^wfOhn|T
zdi>}U*Q*QKk^E|XL>vXLz``yp5k5ZWo3>CcgA7Lf`}fxHzOr-uG?D#$>5{zuW@<Z5
zDETmj1zO9V!=dFlHD{{iy;?J5R(orzwkNhpVJQFlEf>t61$;1t5{SR33n=@U!HJMC
zW-wFzlS<xDl|5SH*+%jkbgu|bCJl?YrFR9tC!KOkZ<CFlMt<zhF#i74Y5$99M_}iL
z$D-z+wLgE|zX6ZuU!0;qGp>*3@y`bg%7UZ3>Jw>9QahZF{bogGqF;;5P}M3BEOSn5
z{^$rQTtk)DZN8ukz0LU#LXfqX?CKSsJDTDbxJ}L@f;F&6CaP@5yg#<SyxEHC_)<Ka
zlLf;#;TEy+VVaFpP&QVeAzcM2krB4?xhtlS%zyBhs@?ARi(l{=H9L<ACfybHXwt_-
z>!M=P{iAE(*{ztcUla7r8LvAjq|>`Up`13V{ra^QAHV!)#|)SIG?CNJUh8_d#inLd
z=Gp)ZUTqe<6Q{Dbwif7dCr-kPVC|b1H|cQnttaOKmf+inQvS`CJ@Xk++AA+HFIYxT
zn`izCPqi?hsN=Rbwa}>HMox70*RLFE3Q>LC$J*y%j%Tl5x9G~>p7WN_&WLUy6@^mG
zsP-<=$iZ*_B-Qbd@4)A}iMnO8Pb;x2hUg#h;+k|sp%g-6TBP(brwz15fkbZM4;Iv-
ztc@dXU*%d*>dd#3&X)S=aza1ITdx?8jXWXoxs9hFk_<oD$FEBn3O%Re>_!AZ&DWW9
zs=$cce0NzJZd2vb5?>Au+oL0~3R{cN<v@w}gAo3XkI2pXy(#OzUw#2PiTtw9>B|c@
zxP)K)oU^5#!7RV)DIPyVLZYX?LGkKu;@GzD`teLFUMD|)+o*VcJq|8biNqDnjO@Au
zl*;#4G?R;$jv_t9luT(3RgGT7cyp%Yk{pEn$X3W&(rRWg>MmTeKHTO5B0bPq>uS<^
z7GGV3o^%X)q?5{DbtyhR?lY9hevf3z9N52md<7_g=*Vh$;EV6^2}!fytPBjnInWIU
zqwd{t$E8EyT`wC7V5*cV<dZ*rR@amaifPHkpPwm!Q`UcW+D{7_07$kP1u<j34;PU2
z!p#d6!@;HMB$e{8<&cX-h~@Vo7P4QMl$br(B4uU5$Qd9y`F!EhDeP*c{GWl{S`6!7
z{J5uO))o{Ty92=o>;}8LR!MD{cMa0c?C3hjGsuZ+ZK#XzK9Fummj$c-yjuBq)5{!>
z@|gffsi}MAKIu5ObnJgqkh!>G^@N8&g7{MfNV!md>OH*N_+G76)#>CzlfNoV0hdUT
z5|<GL6euV632gsY=%h9zW8xlywKpk-;nr-3sqYNw=K>=k1b{~F%bJTUy#@E_q3n2p
zQCrnVJYa}rnzNf}O9Jt()}4%<25|`bvNbM2HUznKqhPXkE&c+*ADcq9<?8f{%m2m%
z3V3#&Pfo3>7o1GpAHM54S%&G-yMXI0h%J<sQ?4HLi$_O!JZDcvPB?4TxmwaG<G~j0
z@4=bSR13e@CK`H_un@c|EAnw}ri}8S%M>kZ##4g=$xU3VnnB?ny3hq-e6})>{VmMD
zpa~us0PVs4nwkNifBV*sjftM%iejp;6N3Fk5ViA-<Us60pbxTRlmdWe>dQ+;1n0ab
zh8Hj8EAVSr1(V${-uMn5?sOwgK}WPQT-HFsdj_2ZOuINI?>~_#3$^e9Fn#ic0_FqT
zpGRu~bjVGu_V7-u!qzgbAz#kvky5!`;LyL&LF1${{NV1{d@_A=Eruc)6I|7LjG}Kl
zW&CGUwky@EOFNhk#%7KZ`SPYa2wk&93^{OFJ<X`N6U{isRknk;{D=Wr5(>zD=nKCQ
z$M1As!|j(Fzt^Fw^T9)Tk(F9^(gNWjD29g^(I_G~up2NL7&Zxepx8HD11dqFWPt6l
zb$bM7MWUF=H0F~ufuVA{yA&yhOkI@4mXNB0@E{op%9;DeXwDVX$|!2_LY7{cs`bZP
z?I{rWyzt9&Iq((b-`*~u!_Mr4esz-6#02Ve+=H7&6p0D1&N)7mD$8UfWbx0^NDI|+
zgmznac1A0m^nxdNsRaQf$<NRC8SfHxrrZ@cd;I6JP{T4lM>$bl+xX38V$AM`N6&Nc
z>QJ!hY&g;)RhiOCI>E5r7l$z-!ev&ES8L+pOL5VZLem53{U1t{I4p}vW~QNgIjzgJ
z?7Bct&V;lhI4sk6fGPnSm?j(3PWF@c=w4nj5|O`maGLyNrTjsIx?4Wh&ics24Bl+(
z>&V7xLU;W!c@76#A_6~C$jECXW-!`{wA%5<?-5sMo&t?0mT$+Kh0A0tNvYVBmH-GP
ztD{c)TkTJ9{C>GX4x91H`5q+}&zfDJJC@ySbCCNHqn^acSh=#$b(J6hUE6(#$i6<;
zeS1BE+!cexaNmzI((wli(2fmcWe-O(M)x)yD-Y@#p^XEyR)yvayc2!kXhz3KbOE|X
zy44h&NvC0(jb;jMJ40PBAmE)&x{HP2uGqHz5cJ2npX+<}OHNS{%#EzHRE$iSY<I|^
zLBek;An;Xu7NMCqK)suQplOH?pbiB-=@*bWJ2jq${t*l7w{Og^ZU;~V(Qj|ALPC6i
z&sxUxy)gQlPDHU8f0q;LRy2bcQ1fRP&?WQrXOe1f)v6c!8lky!c5w?l0YW=cmHB>t
z?>{n{D%Y!U&1pVp>4^mIZtvT=`Fk2LI-`UmW`SnOv`75f`lmNVwcDZgtncQU+0kp1
zu03baF_NhBUCGP5U&H92q);AyY~^s~7rcIL=(Z7+g<9>}tfdwmFaBF8H(tzehwYK~
zSms-^o*Bx@l}D?%IDVJ_L~{AbWQ0{oppA|YaG#P~zkURqNpPM@F&e%`X`chN%1q!~
z8=hbtXe0n*RxIfm?#>nac-baLt2u^_DsBJJqD58}gODh|>|palMTLgz?Ul)uQPl=S
zfi=C=$|4Hftf=MI(EhkgxEv@P<dm<WExvGS4mxvTF4FBBmd*T<H3<|hCVhMUz{*pc
z42P{*b%Y3r>NJa%Ag4b?`lCbs^w8kYP=~AWsPAMfKzn0Fcbg<<I{Kl*uTW?lpDgJV
zFVXsAM-j9k-aO+KMl+mU=tdeEB4^^z{F21%6Job&OXOr@#W>#SCm7C4ZXbF|IJt5r
zox`L~M}AOCzoW*Rm+phpD8%fI`GC=V#a-cd!(FGr2?V#TdAc>!&ps({c_atHY-1X8
zNeHt^B4#S#C0OWBWN3#v(;eeTiEE2CTlU>f#;0VdoOHEp{=@5Jh@Kr%@a@v~2Itx0
zbKuQ;i(kBvRd!Q9C%O~0(>#yW8lcu_iW&`^G`hVT@m{ZY7mH=>n~hYIL--5DsFmZb
zEk-&K0vh8{Ril|l-tpR#sn&EN*Nt3(6`@v(pq-2)HtjtC+DXJsss>k%ndO{YBA@i<
zXDd8BEP|+8Rm=9*sN(z5mwaF(kmblqUwSwYD6(^MBxW7<X?@ElG==2om@VV^ur39J
z7iXx929o)e$7(QhovFQgB@9xU=<d<d@iw&PMRgsWRF<TwYPb6&w{M~R;B|ucj?7FO
zJb)c1ZmT-2#M#`}n%3`MwW9~@!4t7(*&Y3$CgcXLuT6o`@L!2d(KKo<b@>K~O*7MH
zxX{(tLhx8A1^A9)oPvQfPiqHud5k5Gv5!&``0hVDPV3ym2|Uaq914`*?i1*P-W}u;
z*iOj^-Uv`B({911i(?MfcRWq18>a2m!PgfC770BVgZkk%p1Bg}8*BspWleLfuT?q=
z6+py`&<Ug+B&6<th0ZxJ=Kt{FgO88T&!0aHz@eeS9@MUpG)PsOQ5t@pZ`ni_bmKJw
zJ(buTYk6>Bgp%_H?dr%v<?&wLsgc9#Vbfdn4q2+$(Q+DUbQ{N=f?$%Fkx?hg$C4I9
z%f(l5;l=#oZ!FeUNOb$#&9gnHysJVn>7C4yI5OMcLQJLxlP1fkO<(w=x{0xDJ`rOr
zP4jobP|Qp63x3$_;dI;?`5oA4lYt=&u0HX$JEqmwL{t?w;9U9;19yl-3@2>T0xs|A
z?)W!m@twb7S+My%&F3&>f}(j!8x%V#Zc>=S?W>2{9<efa8#eB#oihq?(adZs9?0u#
zwq~c*(BEX>p*r~VWk%Ma6a%qP+lNQ>6C$O(U2Hn@7H1IO8T<L*8w-$5i;Jo>sXN+d
zC^IpE0V{?>fa;tCfz0b+(?%wteBc-TlJV)8A8S@BXVa6Ai3f@ZTE1FJJIAur?6Q*3
zK$QKg8p@5}SGzx$no)QCo7BCw(IpU45+qtY%Za{o;llgXkz%vM?S=VyT{cdmp}fZN
zaVL;oyg@<=yp9)Y{-x`K5I+T8uK9G=1_gc>>>}k~^&~VA;iblz!(Y)N8KqqAu{cfG
zMy2*&t&GwMGX82KJUf~5ZpgV(S(?eG*6G@_a<7MT#V@iXRfaATclOO22>o)KB1#yx
zW=_dXN_-?Tol^RTO(6sSMF<s43*(T6A(8b~9C%|_d3qQN6pdL&A(MKNXLTh-{!cU@
z9|l}E#!8%#S^8Z#TL9$vX4xP(9vQ1(NhqXNqD-4#VrOQyoau@m12$}2CeT^O^9`Pu
z6*+SD^!4${Z*ELE-P1Q}%%6&;SqU9a1#E2Dfs!aX(`=3zauZ6W`RLBp_o>2NrTmBK
zjRKXWUHjc)XWgW)RQ2_1gq{O=e8w`5>?TEwkw;I%13(EQ3qn|PKd)MKbm(ZMY-Ghm
zGy6+wxyy`)Bmx;g6PrFR7oMTzS51N`6;Mvzi6#I4--@4~uVYawJqI_M3WuXtJUlG0
zA0YY&KtgK%>?y+bYT<c&Y=Eaco9V(n2D%>X#X^lAgKQhsKvw0id5=hDao7tC<AO7O
zuPt|GPR__{pI=PXcqlhm9=5l4=iU6Kp7SXcm#D!A(14Lwr-rNDaqp)FoLhpsvSNM|
zVx&^f8&?!!_>~u{mfN!C2nVkte)a5WIQxX*>$FYFG8vX%<fuuy=8|VS^PQWZ{}Q^c
zGbceQ4dX2rM?_4Ni{#{dGSdY%x0ho(%io#Lwmj2TW1z?hVZDD(z2Z2>J0PGJ_-;0s
zZ!*H^w=K42Zx>us>CebeaEQ(XpeOk$D3@hdsnZdw4D);>4~5S3npSir@5%JU7>)DF
z6LnkcF3&avoDKJbZAI}3rz?iM1BvK^GqGs~^lle4C*N=(>H$ge|G4d?|MRx5jpg^6
z_cw>3sBA1N!-Za=5)gns{-5i+=97q(5xF<|sCUq;Tc<T3x&~0SH3RO&<>M+q1>9{~
zTAbs58Z!4>H2uFengGC{=^=vQbfkZ?UFA5Ex=G*^(H?;QzapG&{XUr%_U!nBJ{c(+
zGpFPI$S-J3EPIjMUg|`XCr3djZ9^;uiAH0`mLZH8FkL&h(B`X2B^7u$s6^C^QEqQ9
zo1NNwKdul8>3gAEG@V5V!znTwp1=R?L~(31^89lJBy#}#&U<?gZWlviOUUVbsd*Iu
z(pvE(C;U<Y-Ofl7FQNl<ydh$0V=DRE=WXYXpdUDB*j*v^2-?+%C$qB}@3XvgrC7#J
zs1pr~>!BnuowB=40kexEdS%bUib4tFLZV(@n#=zjX4Q-Acn)MWFv}7GS`$p7@Os30
z4-XFy8@u>E(mR`uY(aifyhQW7F1k1T)OeMXPhd=5RSVRKOVwS!kw?!4j<ry=Na<+T
z_UwjF9kng1VyCcbIM#wn#Xl&z6{^Lf0QChJPEy*P3umV$cJUe0caFNHHr3kv-8ab{
zByeP&N{0n))2pxWa!v=wSasb>;w0-G<p2Kjp~MeYj6ta{Q2E`&?XffCmd$vi2~$2|
zeha54<Wmyk0c%H89RWK`Izeq(?Bne3pN&@DrHDmcu2u`WXuoV|l`R|CAO8edXKH79
zSU=QYhgtRq&(+v571^I`^TKrc1=%CWc;%&nT`T0$1D0?SjOO2nc-TAC>yMSKC;CSN
zTPAlbi}3zX-=oFO*!bB|<YPF@rB-JjDSJ|?uMM&}o63Et{u0T=cP7@;O#hFl-HQ9q
z(%fFI%>G~#HVGCw`hK@FDi+w5;bCD}-S|Hj`BquchrO;QqfX9x6S6)9Y$2tf+_8wj
zU!v^_TkG@kbYdkj4&m>$+lJ5%a5rL%srEEpcdN$OeRtnddf~LN<svqg@P|B>e1l@O
z{K5S1UVmQ9fHlglIW~7&Z_W!U!J;%QGbe|wUpyELLq+y}3Ys)aed%#N#;du#)j-%w
zWAp`yc7uQ8*w3F4^eBQt;@M1V8S|JpY+f)}R1-1(Yq>ohg1M<29oOmOUIEfY=ms}T
zE-N+l^*sZK0~jDThqDKU8l!23q9A!{#kHPK1%dwj60o0(NZ@+Sr7s=hOu6ZhoZJbb
zRT&u>408WF2z3MGG5+D@i}f%ugdh#2?ia7_Fr(~n0h+EAI1yA)QGPEm3@QAbT*${K
zaUR5V5QNTXB9LPg>Tn-AWfc~73+UkA!wc3-l)1N@?5%~s4-ok#(mS>vEWvAR>SKQq
zWd0S5gtVU}ARu53*D08N;&a+=|Ni-z9rmikVhQK}N_Ae~Y;3lDZa!sKKNMBZ{ak@Y
zJezdC(|)~Ck7D)AOrk|Yt<3T8cyiO*VTCWFRpyQSRcfcBl!=||-sm=NAr|k&plZAe
zZT_#kn0WQYfsx(C5hgT;p$5n3lnDaKrkFfJTUnF9lO1$8h8l~@vCNecNM}^aCFc~3
zuGW*Pss+uwf`Z+xt;sq_5Y1OdzAxjkS4gIOzAl?4M|XO#brxd<j;6<O#2bx9ORQ8}
z)id7&(ww2GUKdXdjiY0;Wj#xQo#RN`UmiRK?!M)ULPJ4vXL)GDsA%}mJFqoa<_L`S
zuk91P?VvYaCff8nIulp}-TmMiA(6cR==7<fEnf=Qzm{67l-o(&KkQ0L75Bgy9~_Vy
zufR(f@!u8EG#<#J-aeT4)d007xW$B_=#QbDU&sP7z{Lh10=`M3?aWfOUy)7E+3+Z#
z)smOFzJ7INem3xdE<$tUt!(m#O2Z)b>eVe&&DpjUMA3VAJqj~{$p7jJ_<$y~h_->y
zHrh`DXyx(BGCAqd`8^1vtWup2QBFSY)g60RvGmmj*|F@hI^<R7fA(K%xUKEA9IT<%
z=Ml=6bs6u|PR%dfh`R3=H0pjT8yZZioojthwW5T;Y*L{k!VHzA&W1Xwayx`l6H9rV
z*g}mreKoumfFhur`V+bz?mY<U0s_<zwjEinAuXw-x0CJMuDWp$|79~}S`w`{XaMCJ
zFSBVqKG^Dz9SWx{CN8y#q*4q_k!}VhXv;HvLs04fMZ0SSZf&5tMLh+T`;ZC9E}H|6
zhWh#vpz;K(0mKb1UNtmySU6sS5@E>70*ED;J2ek?DuDZ{ONB1~vWJ8R;r7fLcZj^{
zoF%2wb8d$yJn2*!(O5eXzowRv?NxCtM64Td*YzVomoRo?H0U!)v+glo{+y^oU}JPq
z^C3J8a&8ffiHNE<`PGYWC2*FS>!~Dn72=GFzaY6EuV}r0d6!KOY%d(n%9}HkQA1#_
zil%`O$n<`;*v9O7Dh(0fV!$ienkB9^2V1Sg?U6ja1itZmSvgSeKSSmCcfmhEtcYO6
zT>QyVZg@oisP$n!h`Z3CAAr1D4H9P1ji|3b8XdKgion|@deW=L`#)X@xXj0cpvWq-
zS*sxt_<Y@p5Ik;iJ>&!w3yyi~0F%5ih>V=rpDfwfnEcyn+<`$`I1}b6xwz6i7GtG<
zt&p#;4t`a++N~|u8lY}_edMbuQVN1NpcedKN)?Y2P#ZFZ1K#NvAenCJ^8wf+KS0f4
z90wbCdTeGl(`r?2F#%JS(c(=lmS)+snrLj1T`AL~p>53it@*M+Vpy_7GN@p4$s>Wh
z;sH}xK^e-!4%D4{cJf=$CxqBXs<6#affF{y*<~WaH?w3Ar`256SY$eLC7x~&N6+H!
zh!|HR^u~<ieHg7)8*;SVB{N{+rOTI=XYP@aSS!`zPV{>(hjEg9C^xZi-rhMGK3nH8
zA{kYTehuUeg~AMy2QJ^*(6@j2keu+@JG?Asn)H>_LLD}hb<n{_=pTC?Y`3qkt37py
z{~UxO$c<(d#T>nLFQ93EBu==o;95{T-oL}>vd}pUd$DPhZvA2rs_0{O)&r{0EK=4`
zo-rb&libN-bC@c_9Q(!*wok6ovb&+CE_YW*mB~cKk8c}Vu0eiLdA-GEp)gVBNm=-{
zmyIbFOSb0TZDFk66`^Dp9vXW6`k{OJtH8fe14P5){O=vvQx3Zi8b=>viDti)6lG>x
zOcb6S<E5;n4ITmVU0AJgU*#zS*?j%AYBy|I5;35DDbBTqN)|Uf(&XZOP1*K?X$$hv
zCg`v9)<!tz-zzkU1a+o{j*cBrF>@brS42=Y2YLDB@&wZSK`j3D-QE%ZgxI$?3p49X
z4$`wNZd!ccW>ar#?Ldaa^6Ov~?j4zyB6Wj(vY?#LE$KY2GF!xlj|JX>bL{3^dv~^m
zA1Lx|t+&A>*E2mG4KEIA`xXZT+3i`gGkwgT+v>a)L_BiU(X$Qd<M4)GA5>6(EpDSV
zNSzpwc9t~l3Mr$bA1&E7RKOOv5B|jk-x`H*8i03`l@)`-hW@Rn^W*uGW>A2G&BTVH
z5#X}a)LNG>Cp1L7y@qlASkO_x_-ER3vB+;;0Zo1NR0H0;6@A*rkKc$m8hGWcl#04K
zhJP?J(>#t%RA=^n1WlMbSK`wzJScAD-gmNo1*CkWzs@!C7oRlyDm2)7?e_+R*A-(9
zU84d8zy}19ceA-g%5%6lPJe39;R@V5|Dc!NIDc@!^A$k+|9>&g{*0C+NzDAN%Viy|
zp$vKFK5k)fg&+0NnzhZ`$KdO6m|rk1Tm$}l*<RqR|BXu=8aZUx!uJ9?4!M=8Lh(wi
zN2xl#HzuO32*V-tzg%D-i0;D0pG4!7A69#ta$&zwjf)r#InTGyaL4Bzt%w|0C&<Lj
z=7qxNtjYQ`Fb)Avl!ae#9Y%1ClCYPF9UO`6?%>%$1;u(3Ml9X?-;b{HGm~wn8Y!xr
z3ih}fN(vv1!s5O-{lT#_A#twz-J`2LTRvYff~a>8pL1aPHEg?caiQA*3`Rg_BN7R%
z0~weFfT=D_(HWTB8h~;u3?Hw2<n8h1Ry(RL<Bx`hTGM+lqJ#Jb=&zBG68;@vpZ>~y
z!$Q4(mDd8hbiqtki}VA}Dc{j4%jVw|Q`ONV(M<}N+3=08;#^G6B})9XhS6|-b5Q3%
zo)l&{oqz=52#9LH&hQVHOk5t!-L$(c1dcRdrV4I;xL2JJ+mZAB&qi8j4*Ubqy;xe>
zk8}O2N}zTD*~42OnWndsha70T1=#;8B_4Cq(xq81Yp++!5wx$9L9e3u_L}^4^o;eb
ztrBZ-%5TL8>Xbn?)Up~zM&%%mFlMzfHY+fchuoEtJyDc04FL6(gJCy#uSTE*P*lXt
zk<<sHhInr1(_WD;`g2q`$aVfFKZx^&zOkyxecP<|8Y<O7X_tHb&^iTF5_<Opk64Lj
zFD;0q{Bi?DdthXLD~Pob9#V}6O*@RD_vI@Bcar<dv$rX5hBCDlK^YxFKUiooE|3LY
z6A22-!0&GJMaj;Zgb0MP3)eRm#V#xHOjE!V_|%MeX2FC=OzJ;T$EzviAKB`~+L2pZ
zoNWYHsAVH3eDT-MyhWVRs$ys5_mU)mvJ&!@vpfYl+^mNZSTft}c^zto_i@|#Jg1bJ
z+ZUAD3$ae(+cg`fd(9i8c}+2=N}QbbW?LD8Xb7w(Yixnpyb%HEpz%mYZqNAV>vwTk
z+ScLt{jQ>qKY=!66Jq=X&O}=%iyN0;1jk^r#7x#C!fs}LlJ|jw<H6<&xnOjot$A@L
z8?QJ3F`;eRs5aAdGjE*VYpm^ozI|n!Y-S8PzS2)joDpc^K)#c;@gU%JYG|cDvjFkN
z))wL1gZz7v09GgGfi=t3BWOJVBxkWC<C}Y<#EvDb$$o8&8t&7#a^k7(201;z!ZwYi
zPqUsAeSRV*RqsdA%^(B=!r~tM32Xn!fVo&c<Qi^UTO-MuXw}mZh1GhiSKs6fRt`@S
zr|uuG^3?(nz1FabP>@&d18BnS{!<gqATOs$$Gb*pYrC6WSU5G+4O}|#a`5J2)P2jl
z9!5JcCmga|tP?LZ4lG#@Vqo$|4zmJz>?bS~A-cNJ5MwSNSsZWLBhtTwuZ~ytG$uc`
zdhE~Oj5BTm_c~zE;?DxeB)<o-#uGoGQkYKORzq0dENH|92tYZd)gF=mHd<`j!*8)C
zSyM~P0stIVL9!GqBb)toV=$cZ$s$|;LAeC@V}__!a8yy2;U$QkFqvszS2=~$9bu(5
zcKOQ74m-?0>$7Lt`VT4m#rj;$jO3`q&skf~sw|LQEU7C&sm#UnF6Ofyb%eWT?KQsW
zcPA=sWK1#gYPXqLbG3iBQfwQrcl4(PtZ@8b#-&5u_h|3|07nwp3?(;SZ0D>P=rPiR
z*nOzzLmimegOg%o#j~e1x)wB5HrCtJa<l~42$2w%9{{bbn>Z*Gw+Y5thlWa|l4G``
zfj|lwF@1*Oo+WiR!b-;IbXQT9d<<&I1QA?e-kIBVdx~iTb9n5`@+Cc?n}<hY)GEiQ
zrb|P;0Xnj(2*)*Kb0TYxRD*QD+Pj$NTCh9IkI;c!G0Rn_`0c?xdTi{c?r_;43BG<Q
z6-o(?gW|>^?kR%FO(=^23u?UN9I2>Ik-qsnuzBEo1VVIth6F5(h!c_q;9SA5CZ|8)
zPL4qCU(xpWFQSQq=1}$+FVC>jSbcP-(v)N4AC(UI;Y_x8xD019)`r#YvT%z=3+Tyh
z%(vcQ-b>!(<c)8LuzQ7ij(kV?ksyNz7rxSR&5_+iANmgniS?QbMtk_Mp@D%Pi%Hvc
zbi$%+z`>`Xq43C<F0U>c0E`t|sJ}R-p^<){9wtY)lmc?{of1;pr-pC6qff|@9iNgT
z6+?<3g(Dp}4fcDKeb0dbu4NhDlh*~h{=`fKvKto8=yXad6u%pEuDz*+dya|iGIAmV
zs(~wz7$I$H9_<5>_6RtGG~s@PL9vm4ZvU*dbVMin{IAOOCFo%bt!nYN)(7Qt3oCgn
z9IqRBq`ygWKkB?|X6%A5V7>dQ<r+OD85+f5O$(TWNPSSjVvTB;;i$wt7xHx^iF4|{
zP)L=z`m^nmVpCR(E5Au=>6;C`@z)J5XiL>pF4cA})o#`9pU1`oagWE(a7>%Qi>3kL
z4q)Z;ikjyL!+d`o{$&7#YgbavQ&8wXbq7>}h~ZO;9x<>Nw!vO4a(a1)MXhYHx4BV}
zEMOyR63{gqyi{2+b<Doo954hBbo-i-po}WJ3ob@`f2XBO$mh+h^GDTGx;LddK4>?s
zx>h@}b9h}dV}sdWS6R!hmfF>|tpvYpZ^v&=oq7GGcURWrzcq{e_lp;)R(ZLm$#k%K
zz_QfC*irl^wJQcpnB)tD{%fv0U&s&U^p|yjaGA02OmOn3)xsSwR0!(LK69ySTLO?7
zcz3q76@c0iNRQ4`4A?_7-SGP%j<Ohs{nRD}L*`O?X)QrHMM%IU2Z|*06&iue>JSb^
zD=Rx0sV-)GAeExhg^)E<c{ro<r)q4^@a?DMtb=wtUAbLPA#xo39a(oiGW{zzrN<nq
zsj<603H+Lz($1><LH!MOt+;e8_EQGk!(NZOP|>*!R$b>u;HzUYX$4ivGhjVU5fpQ2
z0UCu@OCQN-M%e0&6yaDgJQ!mjPTPlT2sD@KfJ0c$Eh;R*wOGB2wzAi7_Y4B=z~G<+
z$aD_|?tM>2rO3gYA1%$#LWNT+G1t~Qzf|*0J(R&{U_Ftq5Hl8`azUrq%*OydM++rb
zEFR77G%<z*VL(#$;P3S0Y~;VwlPcGS6DQG#umS{e4bf$Gx%c@^f%^*gLDNu{>>mC%
zo2u&~|3-_O@-Ym0Q(hoT0I2av8Bo}C#cz~gX6MHe;~%{qK?c<-5&!Y%s3N%W`TT<Z
zEIH+mB&$kDW*UAl0l)dSWWup2Tx=_$f^Q|UWHhPPr@Tb`jX%MQXi{lG90}~KnWw%`
z;>Cm09{<G#Ih~cW$2;!II~sQm-;M*Fk-_&2(wi_L-0@GY*;)4Ue;=#*mxhj5yFzZ_
zOx8~EA{oy&MYnve0fXas>0#B8GLqR#1ZeOE`jWRHm@rA;hGHu0Bh}8LcTMWtT0*|u
zuCQ-@?Ck!sVJoke+=t&)w>3YQ89X+5O;$d^X{7K4BLw2WETT7jdTLkHm0?v0J?^In
zZgFv~e-@#^NA+4R*^-+Q-9k`Zbw6}G@S>`Dt}RT%N)}Il56t&XWTDSUY5~TmBT0pL
z0&Q)AneW=bH>3>jAMcyzEZRS5VCSzLJ-wHh3J1H@s7m48j|b<edZpoqs3QWbpsU=K
zwu&vtTtZ+*Gh#>9@iUdoosxW9KCayYYwxMuv&@8PA{~E>N5_SHg@$V8+osxr!r#Ne
za0IHdLC{b-+pUf+@nhQAl}aWuHw;gtNW?Q19~{`++|5Iw@O3=S{>EqfOJdE@{Q;S9
z9gz0SP*Evn8+@b}5^|o}?e6QFU%4VIZc84Y5CAT3`2_{kk_o|Kul0wS^=4|n-k>W8
zLII^INIH6fDlT*gq;@cIc+YO&3c4(zIRw#{8yRCCEWy;+p-5Si|I;1pi|<Et2haZm
ztRlinZH*`DPVnjtDF<F-3ynw>$xD$ylZl19{Jk<fye&NZQve-F{iy#TIg$<@X5IUO
z`3HAAJhj8Z@zZWw{yp0l1zsA2yeLqDgDVE#)@sbRI8QvkNgFVA#K*|@N4WnCWlyaT
zdQ#5HR#un+_@*@`<%+Slyb;dj&;XWG1N|VL!65Z^wg2?_Oh&t>bR1fo3{$^ceYP#Y
z_e!hj0g*ejo51m8L_|wapy#z_OCS}(DOIK1t#7f<VS8(f&1$uB=4Sq)!ndKYruRFG
z%rkX@d955ak17vS-h$(o_fuVfVdm>M_aZ4tK4fRbc(v;eu`htdkd({K`;NerP3lZ%
zw3+@|*%g`312S*Oiu{8gzQNRI*<I^Q4^1s|K%6Sdi&Xpnd#WzCQ;!z?#xjTI=`4-X
zpYGDpcth?MGC^bo<?N*wFF_NhFv{)@1%MF;E*S!8Co=^{#l{$|?_lI{6Xgd)+pZxu
zgdEG3%dVgjAdZ%F$N~ZHX^7+|tL`sY8D`~<jSb43K}W@Gkp-6BX~H|GF2JB~5Z@i^
z?9=Z2?{{L6rIr@bvj`RN2^cy&BRbK#`j9pX&)u)H&stbiOE9nGF=2B?=T-GV^R$}N
z6BDAZ`U-l(1+1DI(Ciy|uGgFLO*4{diRD6zv-yatEHtd9w%Uyz*htDHj6t7&q~RgN
zj!wz?;2sG02!n&AC3Wp&4jj4#ia*uJ8b;`US0h<c5vrADA8PyN@uxny<w-!PG^dwU
z*t*V;i;Ry~`FQqH6;kqT3VOU!>@wQEdIozGs6cW)3&AjUCa~@WaaMNF`ZG~sl$4#N
zxo36&W~~nO=4-cZ!fY9X!JIb8M7Zs(J-XD+PUFGQi8LQtnRzd@w|7_9COW}}x9~~(
zLbt0obdv9AjlqqmDb+@Q`1@r|3~vPV3f=<zh808)i?3QJs#N47xaMfJrqYulJqmZc
z#e7F_E2S+A3jh>N;s8P3x0ee1LIzfPuv$_d$ZugZj+Q%nwa@c=)g&qAr1zxBdjR7{
zweoZ~z7e5DI~{`l-i7&eQ3Z3wU+VpG8iIs$yRT!vl^?G#U9%IBS}r$8yIX^~jDySk
zI=kbwc=lgWk4bNkyP?_j%iY1?{diJ=%rf@fEJ$lW3&V1Je2a^#xp=N1WH2P$COm}R
z5JR`W!hu59I_G*|6M%jKO+IceFW;;!bR*G)Fsi*W!7;P9*L_iCtDuzEp-_-kYB>0m
zcnZ?6!z-WCAv(NpLJXQa|Kqy4A*Q}sbl{9`ww^p7qEBp#sf*L&I2oYDu0fdDw1gCe
z#A(Ef4D|y}*SEzVOx?AFq&(Z}(I(&S@d9|=9%;p<FXaV%HCO>jVVDs8sRuFn4@vXN
z`9Bcf;WFva(p*}4nUIf)?QMKwkI;5Q|GwOCb`WL>2YThUlYV{~4${Iz?y%e4yTeeQ
zP<t#7Yy^db$OAmNkBjz%hm^i6UBHKCAXjd|tSu}s2a69eXH?=RqH`0){jcxA7OZYA
zIy&-<49Pm~5G%L((L0NkHDY$Qrt9v5HD}~#J6Xm?C#Zskq<pYkpdQM+0{~-Znav9L
z>cL>Ia>o;Wb2ois;|k-^NOgMu?2-=}<BfieYg%Qtz3h}NyuyFM!xfz`TnE9x-;kq&
zp!Lb@#LxRaezJ#st8@C|bKDekI>={rJh9qF`y}hYMcCWahvkTDmf7A@tsg4{mR5OJ
z{F~{vaKG@d*#<TF=uZJ29{J1p_IGL?+{scI34`z9`uOLIR-3R_pR3FL@)CQYa<OAb
zv`@d8jB~P?E{=T9cig#Ntd&_$BULQlw`V{*e;n!Qb@GdhUj^;2@3UruZUqHA`!~su
znxd)r|MPQCbNk-c-~EN-Xn%S0&rx{6=eNCj!u?SvM%!rJgrkR32ifsMQ*Vr?$%><o
zqzosAIX&HKI_#CpG<@=<OG~x5osUUHCX9LE_Xhp<!WbppzZV(t-08#EY%CRD$=oSH
z<>UPBwB6{)qcGT@(~7B^G*i>PNc&Ru)QWczqmgq0|NAp8<saJY$G<^U_RPmy^2ywA
zl8H&_`$*0y=A~lazBGS?l{uY{wEyU0-1KAO|32HN#LqSt;UIq=65FQikkThUlv>8*
zYMJm1RXz55XoH8u#gc^qMz7ii>@|Zn1#<q$+q12WOZ|IpAK=$~0hP2s>5t(;^sl^Z
zI`o{j(|g-`e?4@iS2{m&^XP_u${67v1MV!D8K&r~^jfkLm=Y8p#;wAuueFuuulx?Z
zE;em})F50XV{RVylB5>uN1tm@WU3jkPj70`(4FOiJ#TEj{z;a_(j$Dq%#C-?Tf^CX
z`R?7#R;DCmWp7XDI@&{b=am;98*47LGCA044_NHa>;ofaY=&zv5l>wBO(uQ&Pz$M6
z0d{t}zrjosnW$*4t`V2@Z;EHQ0^|0QVU|oUUxwBYhBJh`;we;+4}kNmNco9g=FekT
z&D^qjM3**EPx6@N&k2jGPEEDS%-lj*VAZhNV1_3$(OY_pdlVYFS3BxRnu+{E`)WZ9
zpCTR1HheHrYE>M3wtzuE07~%y6pS>O&t3O<feHUsA~d->1juFbz|t~KZm7)0h@8_x
zKUB^?-{1cM-TQa^mN(<AH>zRynnolpW74x{iLxO&M%w=L!`}yFQhfM49B-qIlFKx{
zCsTda#1Jx8$qhqq(&63VaI}9-=}iCj&l8;8RWF+Qs)okRb;$-o5904d^^zjG$@3M?
z!TPqNCDnMD$p~K~v18_~Ll@4>jB&sIOOGj{64R|uecD~VT3B8}T>y#VGfhXbJdE=4
zAQ}b6)5%(8bySzW{f$bUX6+}Xc<-yfi~&a8*=c7zZRX*P%Pg6=i}l8%PG%&pQ8YlE
z^xAb3Z68;32NvVJqbaY7F2>QmPeshRCFc*rX19C8>C7Sy;QmZiZZmM@1U^|pQM{I=
z)t<9@`u70S+_yH*`afT<a7MuZ-|~-gSG1!3ybZg}@>doAV9!%it>sR}MmslgX?0XX
zJS8YPQ*~2+8+T`<Z`j)$1eV=Kl1B?Ss{K8z(%Uy6H;^Bg(pPfn0hS*_?t>vWCVi=d
zh74u*TFhH1Nu*wegOtE7eTvz*UCh^D#EYY2U34s-#HT^gh572fe71Uy+|%AU1ypa#
z>~!<J)%cu!_;uW8O5fao)?zW!WSp&jO{iEti9<5Q8MR(KozpJx8}D1bn+1rL-HBQy
zjQU301Mo+CdyLD`(Qa-+l4o{}W}Fx97{|_K>w4}O*`kW)P9iGT|4RFATripNbtf=)
zNMRtKnzsKivDe`TD_Vln0t2t<(AlK@GY6AUyMxW5#JNfMx^!iBjrIsFt5sb`f?*Hb
zBW9x<v-c0DR?3y8wwN(ymC6^()jqFm&N%HKWxf%<CDttiqevfW$t1nwy=!+gv22{^
ziq36I9J=es^C~R4$sOzE;se}YgEqV4PGUY|4$%MZOjn$1iR3=4`Y0_Zc(<zrw!X(i
zGcGicnS1TV)=aa8nwm=P>|T#uzCOlSIjUcvejY|L6HZ-IfFveOM3&uN7mEqKDTnaT
z9K~W&z-Z4@zJXmWVFG~@rP%#wI(J^-q5e<ie2HRfa{2oD?|wTa_~c1_@6d#a#f9bz
zHNRZ@zn;){HiU<1i?{g@dFDxvS2_i!L~<^XYwHK)sp|VxkWt78-@YM7Lp{CS_LYp8
z`D?|Lzp(0y9}lGCI-5-C?MIU(3o&{LR<~liRLX}M+#<Np-kT}DP+X|<up|*Ryu0K(
z;O6Ot9&l~YJ45wMS3n~7?NN?Mt4vRYrn>rNxEjS1MKR<bHNE(A&8DC~{I84Xug3M&
zgXYqR)4N1i`1=+0{4(mN&pxiysj8H%*wko2eEohE&k%7KTO<w3K178_o;*5Z72XaZ
zY>}68Y@hu3Idy=^!PEK!Hyxe*NYOYYWs8mIV2*0DF_lCxgQ=z!0|P^ZWNIHeTw+oR
zMzuuzk8HT=Ay98R77J!sZ+v;gN@<f&e)67tw7B~t=Qp3u3}qhUJdh-XF(k$ZNDJy2
z<REsdm&`?^z!1~N$2c%>P@1eg#J_-Y$PL8*v@B;Pv{!bh?GzHYro`!0fdOqE+d?LJ
z_>EV1w6rkpiUJl48N2tUS1<i4bF4-^^KIO|01OYjVfTIvqo??TMV-`Q5lUr0!SuG-
zzUa%B^@(4lf`yAi`AjCgLN$kIw??+>2^`{6lhuALibY=g8q%bL2z-#QZQ!|j;U8=~
zLQZGTmr?X#G#Wx8kEilrA7LDl&vof6^z!-ws-MY&t<^5KymfgW!_;@puXp8sZ&NES
zbV(LzD&(iU;T0Fh&w1`I{^!=)?;QE>3;p|#z3j}jH8eH`$HC~u@_3mT{s=yPMURU8
zpsm~vQVVroxXk%nZx^WdN;`xkHlXn)2j|M!jlRf^Nh&J3521*bg+;aK{Yb5QDIw9Q
zlG3axiHia3)O=aKNa&%O8g&qj9ZU%JK0Q7?T7&Q$kP#;6cPNpiRBTdK7C2Ir-QH^S
z^5n30V8?-~U=rd7Tum@8;{h-5)m}yl%4XV9tObQ!IXRS<RCPEy1$s>wbU!7&oI*b7
z=Im^fDr3Q7n3Z2h5J45{EVTKM=kSG-CAcfGG3$l4Snq!)l5)zzSU}FrF`dpTd;ilf
z$gMyf-bY;lE-nf^jE;S$!(>8Y^R+Qwl6h8q;w_Awxya9HX+ozv{SULheoLsb?^drx
zS%G9TILd)43)^C`htY1=5MFf{l+A7Z9wU=tNZ|ib_m*K*u3gtKc2J^#N~)B!grHKQ
z5+WUoScH<&(hVvoun>{%5NTL+rzjmF-60Lq-F$PQ?zo@(eZF7skCz|&*vDqG)^(jZ
z=NMy-$;7TLs<#7xT3BO{L>QmLNsFTA`l7o!c!*@#>gke)UID~R&1z!^^rN)lbT#Dn
zI{?AVrzprJN|1gKaLJ|<X-2`kV}f#p^PoQfyB{`&2G_2>j^uqUt;3Q}t@nRQMh2lp
z$F#M^SifoSqB6>N{H#Tw)g&(N;JxS4bg1tKC}Q@EBv*8jW3O0n)E62KC;M!H;-{5L
z`WOD%o^!RX=Z}tFIB-Lw-MURFD0m6(+D-gW*;i$rT{3*QP(*T?lic~)Mh#tU3vHRy
z2gMVglOAWFZ5LXPZOqBdIH6=^O26;n1w0JZv<j7s=y^aFN5rV&DWnSPY;tlEZfP$s
zo=R6{B<*m(*Jf&(yWJU!d6~Bga+|(IQdl+cJ$5}qS8__lNQl;Zu}Q8iW5@OJeYGd4
z!Hk=@Je0xqSb!S~pqfIKGw2)N6~i)FIjI~jJN6^zoiuY6(b(9-RC)R*@xbX!*mQX2
z$IhAgy5pe}+yHKtCF!u^JwKHiURoBs8a{upSrIK6J#>BYxhnQ7K1b|4!?mYnN>5b7
znI15ya7LZk-87XVnDOFjiL$!Q!SM-qw<$ET?X)|-RQW3@J!F=4eQaAdm<H@SP$gLM
zB^V0BxiIJ45Xy1Jt6u!HnoXZ^HQeI8C;31UN9OG&9M0#!)objsze6M7TWB$*%Nu(%
z5i9YDj`e980{*W-MjUkdBM#wFIJol_Z=c~$a-c1Fakxrg1)GOk3$3v)Xwv(0`KO>s
z(7F#NnWJ;U*w{;ts)9ubfp1-HGh|H1w#m&jRMRrnXq6sMneXv2zbTi-(hir~v>Rqs
z!ji6*O-Pp8mHU?YOf9|=IyT6>*xMQooPq|R4`>F69*M0EqQpt&Z_w<g2!xyjw~oLB
zwhH6%x`noD4iRH+=gNAcn`&ZC$KP$^YR@IY<$I7<g`j@()<ma8U$xjWHkY8cged-=
zLs#I%@~s=uoJp&;gx?hPz@E84IY%Xh@Of8z0<Ng&*0gUNN%!lWukW@rTa_64P}yuP
z5V5}Iv(Fv%6*v$rPfpiqEY3cC+XQn41`gTOfeFG@R6CY-=y|=W8s)gU%j|N>46f-s
z^ZA-aMjseXDJq^>clXUTQIiU?-dV#_Xt1BMQJQ_q$e@w$I76?&p8G>4Q@xBbUhw9L
zqd@58K_(^s--AryH&k{w)iZOmWL<;=*Q&AgrN#;KW<+;^<Y8TMDg_0e#5)JZjMFb4
z`>7+%)JHC2mvl*R;awbjl&%|oS`H7q--JLGjfxDy*fbv=R8*hb$j^*+N!QlWYF2<d
zFmOEoI?Y}3dz>=*_Q%47PY8cRC&g*xJ-v8K#)mL&D83T9gCtSYDi@eAPeY|5ov4MZ
z;VP`^{VcR-*qtnVn(=!7pF8VivmM6Oq}&^JcFbnxVLGM)s(~nU(pStFOBI!{=4LY_
zi+wcgCWdIERCG*5I+2}<IbPFkeB_q!dKS7as6JQ!gf_0hKuVyfR>drSMiAMZOs%j`
zk|(`rD`2+>IErwJ7jpYiHVb6Z@gqM=5c|)lM`a~M&q5(yIK#xg2k#dKh618$nxM&S
zg>r4M;1a9^l~R52OLno}arEwT%+X~6N66<Xp~w$goZ|y;iX@LUiyWnI3pu~jx5&c1
z%7YO%MN`b$wS%?GP=w5?d^_Ha`4``{1+^ZCn!%TJukB8(WF$i{%e)_LN6PvM0jt1D
zQ$Be=xdIb~9XZE;4<<cZy^)dMA|gV-C6|*fk4vEOZ0BqAmCH7-`Ovwr0AXBW(YA9v
zHDR|a5}yv07J&y2({6-Je(aa+S!jIz+F{+`tIAOJL`5*U0h|o-x^eOH?~-o!qKsx_
zRJ&qo&?=ss8&61X#hj>i*gT+V7Wa-fD#Ib~6KWb~pDu1UVa%pm2Eh-VKyj$|Bh?h@
zK4}F%5g%O-bjZ<w!G)G2yAhks67%lj@2&1L_Lk@Um9C|+OCK&{0$nIX+m=a<jx4s-
zuk6w?uCX6CUW*P)O0mi`$Y|Fh9`1LV+xJpjQNhAGH<L#cSc=T5(;z1*NBTmYpDUyj
ztkTz5Bcq9#RhC+*1k|e>>Ah{{;u+n0Q8{`(AF6MY+&XV81e^Pm|I5dokGY(7umTf!
zm~Q89D+?zP8ws_wej;sZ_NRPP3;+f@lI_}4KALvaP_Y%B14TlRd(7-DiZ`px7ig&6
za%vUf7L7P_JN=Xu14o-IgK$TfQ8lfEK?=WfCyoEFkxD&yp}0KV%Gci1q14djwPAB`
z)pAh3fC#KjgyMA?otqD|pLBjRNeZbyIN=sOTydy(<DpSCXE1t&CP&{tQmpU|!GFD+
zqThwor78w3oXw6JQI1IlG$^@)*>USN&w|JhpVRe>6Ih~e*7{I!Ved~c&8ct?-H~1+
ze9Rp2R$71F$~^j^=fc2U=@fak&RSNZa8CMdv{6@=ch#Qd1V-;_zO$Yagc+#hUQ|>R
zWv`IfjsiCAG5?GHO`V;BfvBrgM}yU+&FJ?QU&?vn8Pw)g93JolRw1<Uzp7R^)3!7z
zA!U9za)?1gRvD)~gNNRRf{_jHasyBVd9+9~I7|ukJH-x6geLuUV$e`sLZm>?Z+5f|
z?djEu-PT@Zv17(5i-?kUN$2q6v)0&UrZ4$Jm=K&D*t1lz9|!winZ6iTm)PL1aE4KF
z&=U2b^jVM-PinrI+|=po$G_|qgG2Cpg*o#k9c6*Aw4O?9vJQBt&p4N^j;p;vilVEW
zba>w2hS@mmek{O`2BZ#)Fvb;q#j&5!eV?@nn)l|2Mu+pzR4A||?z09^A>?C+oefiW
zw)j7C=vjvWyrvWq&0qGgNiizNcKM`1ky6%!4E0m1Bau93pa~@UBF>dogf=&iNzYS8
z3AoNxZk-DW2+?kdB5w|Aj@1-mq%n35B1n<TBGS@wRSL&3VGN>|Lmdnhn4W6E!5@|+
zFnFY*Hnn^+A_K2&+MO*}-ab0CCND-(M_5Iy+C#-3ZM!yo8Wj>API)gkOlYX|?&Bw}
zWyhswZTuvo21XYvBpqAg<<m4~f~1P=JHv}(xL`m7br>QD(0D4WDL&*np*RH#9m)Nu
zHKJ6-MG*$zUyM`-&Jpv1U#ZY};wH*Vmu^Z#-8Q^ZZP>Z<O5}NJjCb_w+^ef2<MmuA
zgq(e-drUCsZ_5O^I4x5l-S+sCZu1EKNw;6(OzEse8opP*&X=%wke$~dHh}EA*HLqj
zuzFC);{(7B*36?bNZ)ZsU9E3~dRd=Ue?}uV^(Q$CYe>SstolbgiJ37Fr9SU~3{Ea#
zjmKpua{nsvq-^F>=X*kY_Li=k-h+M$+1jmxCBfw`E@F}9{?eizIcrgwoE8)U{9lH=
zx&Sjli3k@ntMh)8{&*Y=Mdau+iF$WiX1mZNq@>i%;yFh*5geW!l#Z_fx)N*W%-=2&
zPHII^1G6u-e#}HCtM+bJ%KBGGKsCzFTbqR<i!ILuS*%Vvt1Ct?-we&TsW;UNF|UaU
zcGZo9*-l1SgB7-Bmv>hOOEN1C#JIMZm~%vg?3Qvnx?a~@)u$(-GLXo>k&G-LCd|#e
zW!f=4Wj#+q%%XY?YBF-~-|T@77y7go-(3!h{5Wr3`Wf6c14(g6v-R%AtG+z{;dyRg
z_SodM-(gCiiJ=T*OiS~)e!OaNu3_ctEXDM>$-AdjY-aKEN9TH}_V&Bk;C3YA$-g{*
z?56t1*F?r2+V&7=Kin~>(_|}Ph1Bt9*WJ4oDq-Q_t8_8!t#1WGbBSX=ZJs=B63fce
z>`R=@K!lVj&`H&<2amMu`>#rYVs3r@>fzNJM{(Mk$ojFb<RUnRTg&I_u#Zl0fD}v1
zw?}Fc%IF;W?Oi%04QLkVdpD{~IWkOpR%dtkAhmr-F|Es(BDbKNmdCQKpCl_ot+q*T
zZ^!&>Dh~3do66ZYcbUq?miBk$AgR={;hFdr+1`*62Z+zkK%SwO<%F~iQ{Bu^*#to9
z3g?Zgu`lz6a`@6ou^2>D@Jc<dh<zM`F!Cc8Sa{@pxGbWfA6CO9(0x`ehv+dRN-1Km
z`cajY7=>)*>qi@Ny}HdLHBnN?*hd7;{?Wg3S$Uy&{r)iq)jPc|H>OYI)e~F6ovCAj
zFfbGxdskQ`%N8qHjd0xE7_ajk+?GYF<dHFt=NbA_&iAAHMdT1Bj2nx?QC;+TkL5Bm
zMV%#d0WVLc!c5!f*u&nkI(EnqzF6SoE_6^D2@#;$gP&L{#@?G?sR7gu5x<qkiL)_G
zZa$eiP}-{=RHWC!p6_vmb1ssHJhv2S24Sm}QodLaj+4{PY`83P>2GTN4(*nrasTsD
zT}rmKSd2y@ogVDA4DA}9Ne-M=$W?ezpx@nPTVCq;MEwlb2f=A0M)pXT@to_Lk!qhG
z>;&_Bo$DjIY@-PQ9W+bK$g}zc{>Sf0I>)xm=-9mJc^!8H==Y&XPFt){<g>5EARwAT
zBUdQen~H4Bx~n{$fZH(D(wbi=zeP_!+L3Gw7(_&*-jjA{oh(?{7%Y%2I@6M+<#5|r
zB}YTR(78Lz&p8<IV)S6S(|wgU_Hi+Do&mX>H*J?j81$D4hWjSJMao%!jfGikJPS4A
zcMZF4>Em_h=!wvWRt*b@pinDU_)AIACMpD%S!`w9#2||qhFUs<h>2+q3flQqqCC^#
z^9HruHfW`)@u{gT$YlHS43$884|nk(FjtVkJQ+@^jW=U{9zhVS#2_pRsP9eDess^5
zRK-e2C(EFR{jNU(B^Dpc8o;SnjjFFk5v9l_qLd=NNL8j<N_;2}9e#GLPlsn~)oP65
zz910^(M_&6EGD2TmdVLAnD$x(d~Gr*88>sGgC5(>7$uH}rxg*QOU{$OJXmszEfflZ
zt2wdy5D<xRm=4|aP7QxF|GhZD*j2Y`!5#w>--$bS$-e!I<KaQTw?;&x-!mWbbmi6E
zs;U>t%zp*<pE0x!{M^6%{|6glJ;hqfCHg286B6<nIy|HRgR{K+QIr0pr$JwCf>^t^
zA=r_`&*_SUR_%_*FnxskZ@2pLHXIHfLei&yrOW%6X7-q$m$E~AE_U7R0-EDrP7H5u
z)rmC?Q)dotHF_2B2{<XkB76GuDWmQ=wTf~;=q^I-&1J7^mx5t@cx?EK(Z(}vo(zF0
zaJ;|`8Cdi6i|WmCSoK*1EIlY?86dXwt=!%2cnL|@{Qlk_=@CEPQ@y>tw{>#-)X@_F
zNwlb?F}#V#%V9E8X;AS5{m6&c`+Yu%(=zLn-bb0)Dr&piSf3M*=W8Nb$7)5sMOhJz
zeeg_$bW2xPw=+fI`EdF2VnqQna>FoCOh-Rd%@M&slcvrmVI&CYlCn&JDP^I#PQibn
zFvh7%omWTh*Yye<@T<1hbe7^(oE(cveRjY7$7NkpNAo?Sw%wDMFQ3B7zj0DW-?*1O
z5ptD@1}C{v@OXT4UOrt__j`;atRk;au?{rStH#?ff@g}B7$npf@cQM!pJ}}oTE)HW
zv-jnjgvOYnX$*41elOcATxXvO_e^y3%+{T2H|P%{0hb!FIPr@X3OM@<Qih3ox%}CM
z9K-$Xh?YB?5|)tND{*-r`92%z64xqSK!&@eI}(OYH;p{-l~d&7B@4T<i2%CqL+Hq`
z>hcc#NsOFZb<gA6(F1*h2l{M#A>-Xc_^<blKF|H$^=19KB5aGu<6%CQE&CORUFFL2
zU!etWWbWu+84p${(E&4YMl|L*E>u<fg#5~$a3ExRcV@W(e7P>fxsI18J|#>73;j20
zg}G0EW^rlpt#J9JFS{x@L{j8z4Mlz4WL2+EJ%*KieD5cdy1*OYzpi<BQL;V55VPN}
z!qs#IzcA`Je3s8sMiLq}y-%#Hy%bwNPqyqy#35p(;!S>hy*ywhu(B|N4cF0q#0de{
z6UV#2!4<luBA6O-QJ&`j5|e}1(;f}G^^tr2`_Z}wCTp<FVX2FmlFdZ+Z^G;;?}+_*
z5Qg)=MnC7QQZFPZYumS-sxLWzJ6OeYx54^6Dd*zG#zRv|{=n{ISlT*E96haOry~gq
zp3At4s8`@+<&i(I-}<iDw7I182!l*&wkASYbEYwvb$*mxk*R??4EzF_V@F1sH3{l_
z?YIJmDqNJ98qCGSalm3vcdX_%0CRo@-3QOWj18Q!i8<O+X`axwf%D4lO9;<YvY0h!
z=@OOoT8dHir`x!P2@}axq`%W<iB5?p$R*|zLDsZ3L$2vN^Lx4cdw+#c{56=m`s(UM
zPR8@;A1K;wTzXaDa?dlMG|+Nsw{sbY6j`~4g{5^&z*Pvj9PP5#8=5W5F#_ketZ#V#
z@vP}f(-Vzj5I}$twwRe2T~(WSEQaK|u`?Mynw2G}slPgzm%Ik|g{DjwFn5V*Xwp_y
z0JinLKfq-eC-9r*n#psFX}Xp_VHgL2G-Y(4W*|=R3bTkEt(>gvBhag%2)DlkEGoPG
zBI~zWPW&T6xyAQ_?-aB`q+BkW-pA*4-rK78r(<Jd%gV|EYX<1U=jrLW63M#dSXyp&
zSR=f6siJ>@e%-4>EKY!4R4CvYWLUR^*Y>VD{wMdP!;A#q3p|LW)XV2+h;=B;EObCX
zteM=}gK|0KdqcZ2Ul6}FYYR>YLuHLqEtJd>7S>U~=p8OC&1+(-1Pq;#e^C6mAkROn
zC#V9FP;QesD!`ZG=PSFcMVCk4(3=3eZat5ag{V1Vj{JXauWHeV5$gA3+RMtiDH)vq
zy&!uQwTUp>35zcy@&1LAp@m!OYfWcj;pfvQ)1lJG0-jO4b{9!WNhv8=hqqr#JsB9R
z<u2HA+sGL<>{N#dW$9vw+g&p>v?(h!M`Didx#>NQJ6rjRot;jQRX$NL9K=F-)rTr8
z*CBAQE!eoZDS7gPfdH-oB5WQKY3+C*!k~eNKkb8lA0=u9Z<0WI=7&-5&g&GiThC`Q
zyI>eGTO*?j{VEV0Lvwk#w2)V_Cd3Ra0S4={`tpn%0&cy((3JZwf4xrR(d!5r)Zg9k
z#XouK)SEYNgoK5KMMQ?n95!JVVg6v|Zt<E@@|Bd0EhSg3ZUp~i%DZSoWMp01K0aMB
zsQyST7&c(Y#o~ROp$l2x%n?YyvrbK_9Of2FaU@o*u{tG)O73bzv=|XWRc)DrJ2=*S
z8G4v+J^!vl9eIVM*y>vZLBQDboiX5@HD7;;7^{t(n|GJ{wlTjtT+SCNldt)<=>~OG
z@370D*X8;ay!BO!+#FK-k<Se3eP|^1><+M5*(&mH2q`HUaAiqOWoQgDJ~=o!29~%|
zz_K)n&?_#G_O7bj?n41PVBGVxQA8;9zDmkLp$JKi>(?s{YwK!_mrMqF3IM>~VBk?f
zXV1>&>QbYaKO1(BV}JNrOWD}|2)Or~#B6*n&hJ!`q$^Qv&;7MhJu5QhcG&}hP`=^Z
zaC-8-ngm~+2%E((Rq4vmn!bK@FyENMm~?ZIGGUg4dxmrUTo)emlujdU77HN9ja<64
z6a7VgI`K~P9%2>_(upRFDFOpiBJlw2`4Z{O4aDpI@VtbC9+g7P;8}8wD?ALHv=5ST
zD^ZA?^~Zv%B_91c>ZKa&gxUWQr9QQvw#ID9vznt0G8y<=TU+0yVn2Miu%kdoPA(zv
zPE$*3f=A=&6~H&lYWGE}JWlZkmcZ=}NBMD=$QO3?8zCHum~1iug(u+ZGrXc1r8(w(
zVt#LKYOCd0YzyJDZ?P*5#5QwVjF4jOjR#D3rg}3?&G-8g222t%B19*j&^OKW-R=z?
z3t-%A2BcTPz8`h<Hn#Q0!#V<t3qUrRv#F-I_)|y~o`25Py>#)5@+7Q{xMc`^Wnav8
z9JGzlT}j+=Mcb~Y*hKLbB|UG8D{m`~MfVh%;XXF4CuESnpTAUeid{!cKz|Z6*GZNj
zH0Yqh@5<1SFt|n^>YId#5^1gIh}qWXcNu92S=G1N;?*?iJ%fC5<=*D38X;1guA+kQ
zeVW3#8@_yr;O@zMW)-SMc-bZv1FFBesZpL=7|9s$vHKewo0t}1kp$0l6l8U6;thEe
zv(s`j$Yu0R@D0%UH|mF+?*z8R+O9K%2;p#VzI?e3=DPk|yZf8NaJ5M{1#HAGg|Ga~
zIQ$gr;qlJS+^Fj>z%J+Cvjzt#yG~iD_13`wGj{|+Ekxk36wSB)B%1z#8Qay@;)0H>
z#rr2HC@6-8hRVy!uV23o&NtkqL+?C2eHR@CYnBhHQym<ROZg}}W*V?UUgBHOn$@Mn
za@WX?*jg|$fI8ze0Hl^%S5<WsR&u0BP09YnvGw%CKuQYof-E4u=%kKQ@UQVX+BQe=
zHEQcaLT)*<({E~QIy4}q5X2m=ZDMi&=WkpAAALQTcV3#<Ta&B)aA8WX<voSKLPxoi
zmbGk}4?5&k&eO{~;kQ!*Sv8`7Em$0wx$mkiL_y(|lqBMV$kq)+;zjF5Kze<{NvYKK
zHAA(?Ic$p`@i5g%tu3olKKvHCQ;os3tQs4!0`#vCxKbm0*3;js+SqsF9y{&tkwHOx
zB`v?j<WmlgoN_0Z!2;7apT^z+6-z%oJNx-311trBLo#i6;f#tJ4<Yf(tP8OdkD1#Y
zlbbgerRp!{4&x^ttpqR2`M%e*Pr{E$y!d(=ISCYrfLtGIV2W(oBNegSNOyPB#co!+
zb4ixjM7U+vr*Wq5`-%mY^I1N(5*Hr{WGqn*1Opr~(|CpQ$kpZN8i>B`_eq=uXRK86
zN9+BOJ%q<k9IBz;hC2X>sDJAc-NwgxRQX#C=g>X#+S9lxo}q2V;y<{nyR6T~g9QEo
z2`9mCqI)hg9j>951TkON3F|rt59hXS*G`D^<6E<S7qzcfr)7vIYlw5qA~?&ASk8F4
zdPY@Mbzoqiw5)8#T}DYs$<lJopH6C=M<a&vT*eS@52d4Z8wz5`;;`;*Q;`6OsdES}
zPa4@@BukbQ4NyD*V6bEN^@aZ1vjd+_%=IR=?Gnbv+J4+7zv<3iJ<A?>$Ja5k45EZA
zkDm}$1jr?b)6bAgLYIP}D8C3m4Vs&pz^cRS@Id4cU%b?du`FLxxcR~Uj|VOwhOfSy
z30;k@F@*8<3KJ`u+;t2yOQFfv)YP<%yr*z8M=UVAR1jPN>xW&)X~3mjoJ5-sWZKA`
z?3%@jL&?CE)3wdv^L8HwlfcmiYa{W?)tQ8t7>TCL>)^dh<upg9Xkfb7UXCNw=q?07
zPJvPAS62W|KR!J?n75;*u2K$M!K;{_=4(6M>*RK?2gQC>bAG%@AG9yd`mS0vYq7R~
zD%d^RwoXTsrgbD|kPpTUA{_U&&W68suf37?Y6^^$^=DR99zHB+8<L9G_ZlUb7!L3z
zotLLiM{_>EF)AW{gyC4eCGWz>O>P};bAT;P&nHkum-O?NVxzqyj~R1Y2inA@V8eA_
z*T;&I%l9C@h4AB+%iW;$B;rmYQnzbkmxfm&`7`ZSbuVAOjE|2`Nf{jz6O)vbRO>_8
zXj6V|pSq^Z$@UJX`7Fcmy?wQu&WR^O%p$H--fx9_(HQ0_Zp#KFepnyQ&+K0<Wf^Gw
zl5XXl=OpydH#J{Npy8u<R<XFvA_b>ZWxaloQbUzd1(4igu8=&(3DVr1!z1lgLs0Jz
zqeEnJq+JTXvzBbX^Bfd~0-NW`sznn^`ZdWxJ*e3L?)fazj=8zF*`i_jH<+!(wnn`i
z+phhTnZ3B2pxqJ=4y8P&^l!{bz2Rt625~`_#A}dP)pDEi7w0kF9uwPT7jH(4d->`Q
zmCB^}EItFys5ii%JN;vtpczlM#MKgOTFJSGE-FZ95S%2(MXG?J*<RDf^13<vtrHa-
zcyB%LQ#jB|5ab%2H(Gr5y@>Mejp2PnDnc+{T)RJH#S|6XeepchI4HnYTBf2sLa^_B
z#ruh2>aHA{DT_KD>Y=VC;MigRy&~M*&bZs2Z&0s!<4$2GM;p&=8Ttun+KC)g$MHNW
zE<C{+>If~;0H8-H&OC~Up0SPl@szu9$5FpTCu2&{bfjp;kYf7{O}S?<W&@py+tgbs
z{Y*n_jSe>=qb~MTZI1ZO>}4^Ir3C2tn+zGTmdU*J485e&5MVG+cv^9LC7!+q0G5fn
z^L@AD1QMkVH@WCpT1|ivPx=<4ob(2JU)Jhp&>o@=D80JTnQSut$~&Eu{V1T`0&;Sj
zoEIWU7a!yj!O~1u<`{%ygfvcgOstCvefxYHNx*3laOCm3qIg~}F7fyYZnl2mz!g=w
znG-T{9O<0jM4u#Ik#Tw96o<IFF6j%$CAFdSz_)gq6KL`vs`p%MY!O^n6dHJrD^siW
z7u76#G>S#;^tDO=HH|EA>>=FS^W&?Kx@#i~HD~nvPw%^Tum`%x{mtmzI`t#q3?}E!
z{924b8-(xML*QAH5$EBBO*UYjpjzIdHjHk0j$bh!>zO1JAeEP7vJ!t7v7UU}KyC>8
z<W;X1?<0Rumr2=PwB%}Vc6IT8ws4npiDnMetuN5dAa&)xbHQ(E#~adgtT_L*0~~~T
zf#z4-`V2*R^MV`nfSAGA@3<_)Z*8uUKEO>UW#W5809JbuGe3t*ofc~LChpGZN8sVD
zD1P#^Zfs9HW^{`rTCz7)k(9yQM&l-~ZXHv{mp9JIJwKP%ijXq<k86^NjjAEo3z-o1
zZhtO>Y;Ct-%gYe6%f;l523>pVfo3&<a6o0iEt6HNc+s%?fIF_^9i#Vef-8-kOM|Ar
z=z-JgJgWCWRr#_93oVw$QzW%iER0sOh9ca+ZH1ER>FU-Djcn0Rr5`L&)bcy^#Rnzt
zg+K7}V*lB>E7SFc{%j&IfHiCG|2l9?ss(V*KOgilzGyOk+IDO4g4)A3vBe$74N-k@
zLDdV_>dv}Z%;5+|hODh=cT{hO`{a{N_)dN5E~H2q+HKm>+1xx`=HtW+(E^tJhoR_7
zu_3h5TE_eH!|1y8QK9eII{spT48l{1U`SJB)#!dX&q!G@u%Q|(o;y-EsV17jZi^FN
zo)5yjImg83``ht$>+Zqc82q29&4SqA$Ab!as5?rC6*!n?^h#_rf66|62gp^?^BA5c
zCHuvXJE7?5`LcngrZmuFg6=|>fZ3<Fqq0!;&L<ohS=lNn0fo2)Kuf>4CSO$~(fh@$
zD(e_6qkgIld<(4mZs<OU)HmdL6!u9{*>CPWABY{9{L<%D$84)~;w7Etr)lT&M?YMT
zOkUevtk80CZYW9>7+B!7Hp)0!yIe+@@l6YZNR*H;Ys3l+@OMgUB}KT9Kc5v{glpJi
zeP_ehiO5A_h~hk#nMU3t%kx$j@*bjP!aLaWSgp?sDy!Y8?IQmp7e4NCb;>t`O~Wtl
zguvRnD|yok=`U?sG#U(#VckFd@oUS7%0J0Pbfmj1kc%g(QTpK3_X!%81Ts`Rj#kdJ
zpOFTyjbcsbV)Gt_^<fuNMz0J&(`cYm!|Pp)6y7=oG%G>?*rJ5Q@3lODZWF<%!RwE5
zK2#S?yqNmt!oL8qY|mh5Y+02~j9ChB(bOd86zU^+^oq=flc@7GVd=`(D=Hi~Fl*G1
zz+n*}qbVr`7_6<^RmG?%^D*eZ@QZp(H3H0>z70aO?9%`ZXI#u*<<yzZ`#N+I+)W%)
z%PsYT876AVp=U0il~}iRx*6|iwrpa#wWU8Xav8)2xyy3&^DmUf<-V!yKdYs2%1B|7
z+vc8V5jc~~Ie6Fj{1<wB81?;U?pD7NZ}RlS`@+fH1wL~J#kY;mrBC$R?U-D`eK0st
z;tgv$+3Akghvjo{_Z>;BCw@z;16cXm4$iAd;qL!@pK7`%&@ur@&1bCXrK8*%($bKe
zn`L^w`~`gxbM&(G6COl?9(<Y|5YPLlme1)tduF1mYYns@n}*#t;Ea+cz+Y9siR7~@
z07`QSe4&GyTK;=gt@i8A;yYW{H-IZjP)89nL(g{>Lk)&O-H*g9Yfp$sNdu_dC&0{w
zhB(V1d}~Zx-)QcYJ42=Uhx!X+@`;*^<xURS5K(b40Po8rmq55bGm+<}2T}ARUx>$_
zq#Dl2c$&q(5WeT3OMRM@D^0RYDx$|-1a#L4J6l;v;(u=dkic;&pEv2}@)0`NuC1_H
z)CftW;qZPQzPzbHS3c#}2pglIhM6;=-rxA<5ad$&(h%(YH92wy`J-qgzrfyyx!G2h
zHx=JIVl0M>+6778y|es;zM&`iWM)VzKOn$Gt}ov>Mr@)p=kM)t^4IqG{=@#fwj;`g
zBsU}Ww(;ro&U+50OB$U7_lf2tnHR;&^;$`!9=>@eey0}kV6Hk`QL*TZO=x!N3+(bL
zzs+;QR_94?O$9Z+0yDchV31$FYMs~1Tn+VZQr^>4-~G*I=4(~lpl{)izY~a3;4}b6
z1uBny$jsh(@qCoD+f;&lv8k!)%NNx+{kh2y=(~IG-Zu}=b8&V4bjQ@ypMW-3F6v<=
zYXy_|U63Gyv*R+f380h8$Lxc_Vg-fQXxoi6#*+8LC7Y}TriTvh($A;6Fhbc%45#7G
z@q(CS{sPP7aTK>$Hhr#<a`&)HWXbNAx45b8SR|aH8&BebzS5B<3L|AAM?V3foT%!y
z)q*hUPQSjd4EzZ2WRT3LWNSm~ol{Iqe(kZbytZoId<<;q9SyqF1_0c9lXic&&C&@=
z=C-*uCZRMPqTclaAYaGke4A{UvlFWnDO)V*sZ<2B&E|rjRfB{sQ@WY3swQ0HiJF19
z<b7|L#~BnFy3)3t-jf9Z0T{xjbxp{5JN_eQj^lP4;U2(+Z87rEPv<lHF>$;(L=XGh
zvkFVVekNn@9B<>6R8jn4oi3@vOA@SLU??IV*6#}G_#JyoDF8jiLCm#3Uyu*bT#D=v
zGZZqdAc=}_xNQsoSv%|Csr9JJTE&$CHZ}_l&2T_4tB+i_O8(U`Vo5vL)zdz+C;pxH
z0$Rb&KqEwEJQ$sStowWgNtK-TdF#ZD<jb>9_Lp6p-D8-TBeW808mD=>$;uwsf9p{z
z#nlj_UNlXU+K9BWSS>H?$H(mLkxQ|wEhC`t&Fi8Oz*S&C#r@<LV$Go0%MI{l4zGr{
zs}|=e`Pek&f5XA~Y1myT8d;r^Dqm>1dN+HwFE4EP?$juIaOkm=03KAfUP}!>63LAM
zQL?V?2vZeAV3Buo+6M+4t2|7y3o8!q@yo{o3+|4eK`>mhQC|}ph888^E2cB_?ni-&
z?-cgrRN41fYs-k%g2jxKfKC3DGr0zHG9S(25x1yhnqGvl$44tw$rrvjHbfZxAWQSj
z-X2-JKA@DJuC<J3EVtjGV#xx@kX%;7#Y<o3=iNCjsRd>m1NEJz%%Mh8iq9&6T)vbR
z3DVfy8@88mRPr4*S%MMrj6>f#li!JqWs4dALY6?3DpY>3^JFL1v!H;)WMOsEJ2tR-
z^_+@fwnN%&mUzwzda!gBB;YPM)uxg__4~qecDp@bR+agdGWumHc<w%&`bqzxbvpK|
zMt%SNN?HncwQ=>Q3@YQrX@``q_cj*W(zL)U)MeXAeAo=nKf*QND^ylycaG1i<I^3S
zvkkFd?&b${b5joV<Zf!4A{R6KD4m+}61Dp;RWz5DJ8z~M+8j+F$H%FbkyRf@u19G(
z*h->@ZF+3iB_i+T8845Xd-&EeKPw9~6g}}zN~*{bAovVoiM#`a8w~&n7K6sUM`?SE
zvaQK(>2r7GGn_!lunz89x3=wfCK}a2>WfFAO0!{mc<^I;Rm5htBiC$<L?XP4jITJc
zhSRF1`Af6$G2BUzI%VBx2T3C{;HUzNEM73);t@T1fJB4fc4vyx1?A>;M^5g?kN$Xl
zKrX<Rycam-cd2p<wVF0&e0D3tU#~0<+`R>m#H<Gbm)Qcv>*8$G5a7%ydB7{|&DS;?
za}6!1zf|SPOc*fuI$6?CI97>Ah2nz!LPS4`$o~xfLPy+ViM|J5(+_qDoYp?U;`o$1
zZEXq8wcfk)lg;}~Nq_eGyH~F<bx*{iK9rP?#rL`&#~w?PPXQkI@g-iq%fSo^X(ody
znri7%Io8iDbjse5^*XiF@_2j6plx}&??iP31=i$IF*MH$MrKd&I2B6y&Va=iTw}x>
z@eMsitjg@IfRsOYum#xM!49LH2DkIx;%HiDG80W+m+AR+WSY|TzN;v7sK<*2$a{{;
z_@44k+wq-hn6<as&qSv0@H88gWT@OAd1bD#)D-nBpUR7n^~+|gY&KFiqd)c_XpE-{
zrP_hLF2pBWG5Yk{O~&(6J!UqP!vmw2`dXY93&??7Qfx(34koA}$F^5in1NivsyjKN
z_o7Qyb-)vjWsN+8A~<2Z;x7b*^~iCmsZKVG0*F5|xO<t6^0hV)I;L>+8s9pS&PzPH
zGXYf~F#>xe+5ezBF?5XP==s@OAzkIjl4G%_Znk%gL<XiPPVTmJDCKp_q%jix{fG^m
zEm_0-_SO!yKjd7e=2?UH`sCBqPKA>%a^BrBEx0_DQ4e?5eOjQvav~`BR#Ii-=ep1q
zRX5Jwm>(*Ww?Bh)besnH<TTDiBP({J$#-7M=Xs%_y}neGe0fB#IT@Im;vae5XtOa0
zixFSNq)zv1zGP64{$20za^}@f`h>Kp#LYR*)G`hmCwv#<f-8R3Zgv6t<z&Nl2G=E!
zzB{oL$r`h2WEW5B+ztJ9ccUbcb)k^*9A)|EL|JYC2SY0!k7Qh8VeLKGTf<aGVAWN@
zup&ADZEJVTzM-8BtTk<<Pryx?I8aT(o%EDd1W<LKj71e?-3sTfg$3+t;%lNEprfY-
z@{T=Hjsi~ix2_s|T>m^cPISwOD_`e(+n!>x$fLq}s6ETAe{I;pfDRt<5zKl=$(=aM
z8Bn1e9Q+hLckZzKo={4GsZ_S?fhN&ecDHxCWV@hJ+_a|T;nQ8NOexzEe@tOVN^ZzE
z>Gw5A@7d*!$B&QD4x-O3PtUTm&krANf`kMdDP)SwLjfSpdoH6_^X?TO9)uj%&x!@V
z+r^CN=fqe4<v9_{E$>Svk}BFu^Ai`jTDScTrs!K92w^Yt(NVcn9-ntEh{{~@seh7a
zH8(tw%C3=9coFGqALpEGL*jbp)`Uul_359Sw6xMpWlp<Tj85weN=$EJ-uW#@YSERx
zE2&uA3O(0|zdt~?{dN-n5{A)zIZ4IZWMxlcE*bgZCMMrf#@)lgRIOg4VJ|-#&u9wk
zNCZZVLWKnbiBRlLk6B+pR3r|pUgCV-CtcpJO-QdkZn}88jjVe~jeN(7or7CWn^D+a
zuA+m-TaYZoyb|HY?)q+wjOWLCxceEYN0Q1D$dc$(A##5D%?R8*Qhe`h<Y7xz`{Tu-
zMqq&NBTfsr9@&(6z8gCls;M^`O8;X@5w$#c3F`}NhWXRmk0;D@rF=()woLqQad0Dx
zY|tT(RWhCG-`~P#V?pi259#BKeh$FSzY%aXz^Wzd(toPZJqwSjMLkBre<qd;czvu}
z#7i7kFh!UFH-AQ960kbnCBw#lMGYhND18QcHb=#eHMv84cqT-A0?A#w_m-V#KdF>O
zSLLq#`r^m-rCS${zB%t(mjCGRz6Ixv29teX;fI6foFlF_c}Zi)5{>Zy1$_KSaoc@i
zAn38)5&W5i29=}ynw@U1?|+;ZVQ|E~Sg~jA66f604x1`{xyW(#60sz4yXA#-Nv#-P
zkFRn!q235~On)C<vU*u8lmJ1igJJxuZOUm5V>RVq;u^@fDFIAmszU0>$Sqoae)%Aa
zpFuv}-nVCF+Fv?s;z9SpJP6ppo`M+Z`VJX-NX9ec^u>Rq4%>q36esDAsMPC}OOiQ#
z?#>Gq)}t$Dc3m&2*I;=3mszgSl^8`p+@sLLqa$R}T?6?)W>Id_$<LJ75<RG9xvNbw
zb;}dp;ipq%6({+lvi2*_sYjOx834hBlh&Y<L7G|wuMseBjG*I5;~c~{!3t}u7Qmoz
z#|JVg=i0BMz^wUG3v?Tm09}4fgNMg_8u-9Ufb4~4SG>7F#r2(f=qec!fCnbd*-?#e
zQ2et|*Y1JuXSq~6ED5xQsniIjinbFrXaHtE!xE5<ZL-7MF4qhz(<4(r75VfeX6k3d
z#>`b_Od{WUm_&<L_{=nJhPs7@h9cd9LlRt*Y)DRcKO&2I5Z{f^-iA_<5{J!eUXV<!
zfZR$S&0~XyL4(33-{R&onFIREnCd5Q20Uq-xCtZF(QJg9qD%*#+syY3F)CU=vA8BD
zO?$5vks2+cT3%X5vlMJbvF#Ua-ZUXs<N)lM4d31{pI2ZvC?(`h{n<P0t(X+{B@=eZ
z`;;U6{w18)$xpn9zl+)Y<WPa(HW(~p9@e|KU0z2wIZZnoS#zI?z&%kKq}a9ZW`tbw
zO^21lCrLnsHDNjZ{Sk?3!GhFzM25Ny$#}lzOdCz1)Va_Y{@uIQ;^Uo+jn=30qNkN(
z=qYjZUA9>g-!@g0tuFP~9%Z~(qRyu=suEZW(LXV3;U&T6^iRKra!JE|G|#-wgGfif
z9Z|eHaxS)?POdBncZ=VDYbAA5^Swzd>|V}`X13=8p<V$LktqRmG4>9L_Fmepv8U+u
z_IE<tMtXD72|2mBgUb_q`%z#RbFu%GxJdK_8PCQS@9DsWS{|t(g~B&$ye?2A`s~Ey
zfcf2}$%9LnI|qxBYS86Kx)PAUKXH`xQ@N^%C>&ueBNcenh7%tMo@@`ID%N%a7dbq6
zw^uyw7SFT~qqo-dKPzhN?_R7r++U=Fx>Zk4$}*PaZ;>vkxzA;4Yihz$fyrZHajKy&
zATk|XA#iYqXPP71oe1pj?pioM!|${ijE<k$aCm}@p5ysBIq76pK#9>UV~LW_loMi3
zpBMl&j!t1=oIleDiXT*W!*!~l6&uEl$nVjxVR)qMQ2O^o4{aFl-DAim(x|}uQ3;h5
z`-?6D%SE6>65cVXt`p@}kMnI$v{};bL0#|{Y{}A4tFUqU8U^w1fLu0u&CyvZS>xt!
zK?K%)#pgB>JjQ)i?RXK^W4RoOYWIfAU=v`y^nG=7B8i`LcIx~`ft@&h4=N#fmmjGg
zU(&U}QtZSop~@Kw4`+yPa^asR(&gYHBT?X_iJxSs_M*k?%=JO)kXASBqE`D}BFW<-
z$Ok}s;9Cvi@J13#E2}~?t>~n!E$N}NMnWF+UyZA~3n+#LN*A?<m4}9vo}jA+HS+Oh
z*!KJS)L1hHf<O#_^?~4*xGErK>S#hQx&4{Ym+0qzpPH}*%zMg1;2FQp3w!F{^RQ23
z`z~7bgC3(#HWGzAxw`F>2)DEhtTQN8&Ab&1)p0VCplDGZ2PrV@W;yL2U(7Vi#WRVn
zC*Wie4G-*2bs?fNk6CO4&fLVv6if&Pbi~%gHhZwSF?=?bHs=vzjzu$l6tI4-+TLtn
zKT>vJMlY^vN$pM8cl*sdg$kT|aedPjZ{Xo3QV|#0+ZboLd)etbsAt9sNE4p0vAyce
zR{s7$_Zt~g(6>k)*}#>cM_C?*8*>B!tH6rd#(^4*Fj;=4-_4El^l2o4W?L_aTbE|$
z$=#)JqY5e<FGB#fEtC_3=bz3reD#u@0;oc;US7A`+cJ}vmzS3Q;N#=t?(Xj8)d&Pw
zBs@CS5}T!C+$U;s#u<;twG#L2+t}otl`u*@YPcC2SR>;v|8Y;itOeTCG4eBX{iqyW
zuc&Bo4VO*aVPp2mdpsWcam(1WMQ(G1W3fpZaOhmaV^W*#$vWqq2wFja4#mdsDYk-c
z%DADr(jzNfL9`jSs7!4IMT_R(>{U+%f+rOf-NX^-4W|8Vw8ZAw;&Ak+%NK-ONSh9H
z^Ybhko4m~L_zDDJl**pl;V1J+UF>`tS3MdJ6A><@(GcP+dD^awKen{AR8qP!Uj{#e
z0|P)>MqsM5|Cg7<ZtP=?oN@hAR-bUjNXWmlGmr6kSxM(2y}dKLw?#;mP53)iJM-ot
zPK~fJOG`s^f>qM<PIZy2Q!*W_a4BCn6U3rcHmeqMUwxJvYGtAE<X~?7w|f1qwV4yp
zTH+Q4QlWDq)!bZQhN9~B96ji}M~hbH17lq6Cv9K8?2S|^v~fXA{ihg)iKuFT(UO`m
z+2l-H>C?)+4st11^jWreea5$x*zX5MuCf`lzM}Nwc3|--^?sj6VNw6A5mV?Y>*u(L
z189Z+rAwDU_}*MsR|oP84Gj%bQ&W6=pLxu5Z(X^^-zMYtKG3o%Zj6?kZ{`YvKpMsw
z<KosEo#nQxuxhifWD-gI6|%-2g{&L?4P#AFejs^{^7kEN-<85OTqD_bSj^(G3hQn}
zUZeD4%qDUwkogrHD%o2tL?F>B0*<`J+RppyE|5q1>Vk771Nfe_ML_9iTce?8PeOFG
zR%gmYTxbem@bZs`8c`sH)NC_iOjoPW8YRR3=}V!*BZ_{sIdI6+r#TKKT2c?cC11KY
z;h+uA8y(owqjWFa`~CZb_C9#cdll;-3d6j~=i2YfzVH1k)8eRT$+>5yAJ<B6KO=%)
zeE7_o^#yVATH^_1YXDK3mTh)Rt4;2}#wAYsg*)X_9q<1{-DaZqeh%C%08-f4*d1sG
zqyBumw*K?+kn{;S*}JEvy5_9TW!}0x^H4%at$Z#I6tDnaIXl0H^5;4+DDpHN=n)ZH
zWq$X;%xh6dt;@8J%k0}m{=<Caes+5rmrsdG7msv?OThkHm*XweWe%*v*l-BfaaL7V
zL!v*vFj&&s+6o$sXV0Dq3JQwAqyKL!IJFi|pSqRL2u>Yfg!K}Yjk^bMdG~BQCWl3Y
zM?weZt|sdHC7?x}WPD(?vf!P2ogJ~IZkf34f*5^oWMv~iH$CLES4l%E=^oYaVOSWx
z4M)P!(b33g4k-TT70`XFd3t&pm|_mhll(6$s8b6_P;I-XjA4bZ@8KlmEq0l_oIb1{
zC;rhH=fqKdDDKT^EHvu{nN4-&eQ898OFqcb$tQS>Oa;E!wHZyVlXC18U_2lm`iF#E
zp`@e)rW)jLmoBYBaUsyu!*H1WZ_}GW@%8ugR;|zOJlj-V2X`E6;8Ak1gnCUQ6yp&J
z*x1<RR1<{sGP$dt)BB~0J@X2ag2&6vI}?9B6XCFz$zbM8g$*Og$kC%<UK#VFOyG>$
z`y%+;p9+dwd`}r4TqZw=#r>QoeaYu5ODsW>4D$VANO^;GRa$FVZ68hu`<73<+~p#c
z)jK63O#!IBMD--rSsAj^Cv{}@^%$K$->>lg_2EbVtV11Xbzh>-Ci~xbpEo1b|I*=&
z2A}Jo5YH_w!a2!#Io6KL>o+M+oYYZ15^?<b+xyrUQ2+%zPuy0bAb((*e`NKn8qO%w
z=@Pld4*vBAPM#-T#-uSGi3tAu(eq<Knbw?u+jnMto@!_~_h2(hXxP|XLz;5iL~D~?
zcDKW;=QfC-{|{fKnqf-$Y?G;&$Y8YGz;l4S<8jA(WWz3DvW_k4gUnw=+DBif0`K&4
z84F3^$8ey3!J*|w{aE)aiUXcUiP9gFSn@uH#d0mr$<-<SsYv?ujLd(Aqdt((%<Pq`
zL;6mxLg9q|$dFC0`>=KE?T#A_i7N8JDlyhce;D0AWn@R65OWH{$>YN{?v2T*q}?lx
z`d{QF&G*Ix@22%qoGC!jj=GqPR-&O8JfMX^7Q5qp&z+N3{r?Xi!ffwsFD1J9!{n~t
zqN?`F&8~q|=N2_`ciT0}DSo3Hzw}g554YvLW>L5gfHyi4bpILezs5jJ4$uG%3svXR
z_6senB&)c>gn_bnI<n<GXHQ;D{qNuX(Gs|uubZ2uML%+9zW~f`JP%GT;shY>yrBI{
zPWtD2UJ_$+8Qvqapf-_TamnxBeLs$gNzOo^2-5Oj`r$u+_1Dv36u19}8NYCHhU&jB
zA;_nkj`Z(;J`U@zx%;K;#vIGPfBv47v#-~F6#)MERW7U$tg%-b7u+F6{*T{1I(jP)
z#TpERK>qJ9BRHDo(Lk^>x+Z$&-%o$?Xq8u7V=2Fd1EIH=-2a0k0z37WX8pJ0A!fY(
zuT66Ur{!}vbbppP1bYclpK)iCw;!wF&$`(-147IkU0g<ua?W`ikYj<6J>Re!BWh#g
zD8oqand3nNrAct|YV?0!#5z!Ki9b&UOeR>I5@hAtt@g>=&vtNS-87s5)6DhReNl`0
zaBiCtYux^PW9e*dnVlR#R|8FR`}Jn->f~gQWc{~K$5@B8h5i-4iP#%gU#2S<R?|;?
z#QMO-qm!c|1TDHY*Q>&Gn*?cgu-D4z3mg`|{dlb_fbHEG(ex6?d?P>TjrjEG4$c=)
z<M;L96&=a(1#9U3z2IM!n7=Kt)cx&K_HxEo9l5+9*6$yfLf<-A!7*YM7Og&jpoR``
zw2bg=S@8Irz7pYcRX36iI+DcoF^YdL5YQe8!2c}!m&98%Hec25ar`!?`n>kN8By9(
zP&-&*EZ1JmKM19>P!<kMgD7b6<CZ^M&^!Ou-86Utd~)tVc{Hd@+R~K2at;ZJ7-LHF
zGDLIp$T9GP@@o+D8|<}GRY0Nz)sH}QfMYZTYx6G+Gf1O8syzaG4=}=sw-Q3KUB5m6
za%d<=>;Vzwa^&k$k)64pCDwC2>aM4)`bv8bpv;fy$9O&SSk1n0CzN+>?`^XwuXE~A
z&jRbv@righ2e2AWf>}u>P5Y(K!75uD{jvdE2J-m%Vd?7Yy77I%A1%u@-Dr9AWi`UQ
zT)&1~W_?|ie(BOzK3-y6${}xa&_iQPi5i2;l6Js1r%L<m&fI^DRUxBZ;S;?-1w|ng
z#l5IL=7%(Q#m}AlG1q9jICNd#u_rT~FydZb1!tjVwKg`k1u8t8?(oUlY^QM72$&!N
zJEI*BoxfsSAg-7I4}q|+Lwhz$BPqbO<}?A#u`H|02+m?is9<Fvxs&-RH~l#y0<H4?
z_7@SM{f0fst})QgLzA{z^DE#75!(hHWn!+wE{BmF+6wGc|Mb_v$OPS3%j<0R3jLMD
zz!gP?J;}w)I;vSLkM-g5Ad2aMmrh3#h2Ms}z@GF56kW7ANAvNhR5-6h1_17Kb$@pv
z_>DgEcXwjuSy7JbH~s(P*dDp;hHEp^^cS5*mD+=XAauO$+2a+k;kyBqN|1KTbj9RZ
zQKj5588B@MwXm|PgVJVDz{oD5lvQsVI!i4>HX`HNLCC5Da@ih?(buTaV?N$i#9Uka
z_GI&hRMg4uQy}BTBlk14faXLjpqAw_ShE0EQDDk!x3jx<);U7;xSrlWGiw5r6eM%@
z4y-NV+y!EzL&<^7qJ-<<K#nU?dsUO5eZKz;908)tIYZT5;Grh`B;mm+#)hl{O3CQQ
zKuBfF&Ntq=jm!cs1Ptm|BuyZZ|Ki7SLRGNp${hwD_v|26wLT#i*udPd_;u;N0uG({
zA16-d8Jzzd6)=PPDEj6+LX%1rxGnlb^9gp?RJ=VodWM~~!sI!HVnIwtCmjJsFt4Nv
z3OaC}4iS2Ul);EW1EitqRR6=e5*T|-eJfhN=76IQ95~pO*kyv?n4w<nEr{U4fpmvc
zE;4(||4gY}PFaY5UkOnj>(>q=p|G?y!32yLGzMT;pRJwrcu}bF*XjQX`%ONR=ws7g
zRv$;_!t+;ZZxC>meLh>qkPlAW&HxNZzW`C=;?NsU3E!R*Ty)~o%(&2w@%`(LYd*KU
z40kuSHL+)XjH{t+pgo$Q{t`dfpMX1zLOidkJSbl6?VYv10c+v@8soEYT1QU$4prnj
zkn<pThW=kc*%#%F`?)@p^~#i>L;5f>N>w-(IgR1OOu?6WtwX}kyWNY9<l*+eJw1Kr
zA;fA8Y5%b|d)D=ibTu#2G#UMjjNLQGA=NX7hh}4YmE9G_`Pli)Gmz_|)5OfP=!`*c
z?Uv}75G*eXZW^1za`N<x5;%B6X_$iDbp~4~J>leqiwJC|Qf0G<bokhjG8+-Hp*~43
zgzaZRb#HX*(fTaWaOvH8FHmeIGd~1Y`vVzSO%i`TQLm%^;|3BaEYi{acRYYSH=6TH
zEJ&P9^cb1nl$Fg;pF+s2@?yB0sI5&U&pF1n8il|}C1!jCc2+pOi7y8?A;iT{&wDcO
zO(>?UL0?8XA*2};1^`mc&B2i>^U3^eKkBe$DDq{m{Gl0H1;^KG%C&yX{>;68PRvhk
zWFrE!eZ+(|+^+71N#_f07`Za_hF+;TxSSk!L*C_qX!h{b;q8iuLo;WaZ+skMU4^U8
ze9^TQQ=7Yk7K?XnlBb-bEHb`=0O0DqHDjx%0$VZRY+Lx<C<7OF{6(YQYk4;wH+=kE
zO^RidBo(FBfqF?<SYaSkzy8yKn3X~y_qns;oas8WEs@nqF&SiFzhk?kroos}t5vO2
zCCeyQzPpeEJ+|u=hFmHl;}H>j4w-w(G54cRoH;mXeH6|rC~+S>{laHK0fb=m+=>+k
z{xx+1s*EX=IUS^O210%T4}VveV)eWj{88fb%@MhEmFH<BmR~frEF*<LdCiqlM>~<_
z(Nn5s9ViBu{k$BdtbW6{cuxIS$Zn0`UQJdliYp%?^C1c*C_`8d(|?9u8z0jRJ5YfP
zd@L@)!tc2dL;WhPKPU!MlcKrOkOe5VSOcL|ycF93s&Hkes`+HZ++d0Ky8uSTrc&`J
z>J|Zwb|JK=pFz@Zb3QE6bRNge)=*Py0j)D>m+r5uE_R{(I+9%{sta`*E!U@@HGupu
z)ogJIqSVSTdIAM^g!!NvW7M52T7{H;Bt!`Bbh7SJFtSil7-IZwQeI228B{xNo7YFL
zPT_MS(vjRU!W6dG^0sFwOj{pghU?;o_C#)F;qkM<Ec+n?h~e^iZ^89bnPat^*-RUS
zB3wB;9{qA?+i7WSY3Uf8_ay7-_Ei=8)-xO}@=YOZkvI*f8gU8y2p{}4wuSr2_DsW0
zmXrNoT6&KCJo#adIt{Uxpu<sgK~cNQ4z2V_SXpuIoWYYI$6F?<EnnU|eE5JpiS;XI
zH>xqnJ6SHVE#j^#wE51_a8?$8dbR+1xj0b*%W3I2J41LX^J?e22DV#2&)~D%v$yO#
z*vAH`G>1V)Neu~RVtn#q$3MRks;s2%M7ql`mT!&D8*oTP&3Rq+>C1d(4$xM6g2X4(
z=lOm;lJ0d|FG&NTf*iiK_Kab}k00-@Q_^#;e1CXdBCI2X+jQEOs&S&lv|M>-rO|5q
z?fA&yW(Daxooo^I5LS(JwUWs?@I&qIEUe{Yk8PQyGLg!QjdMA~o4wY^S0Bh2ey<cP
z#{95b_!K+MAG%S$k^W=z%he%L&SD_+86O75@}hg*Xt`5#ibZPxfVy*oyU7RrD6l-c
z)pb+9Jt34sFSEST!^3$Jm!Uaaz>sN4$?U3UDk8w`jg>r-!=RedMKzR8%6bezVSiJ5
zdnL=XtW$hnKVoBQnV7r_Wpc(LE>SMAUqi32#D>&KjE0)pRmU~<X{Gz&YV`J`PNJkS
z_$n4;ectjF@^R396x}H@0BhfGrv2-aKn5~G!Vo?O(Z-;bNZumr(JKDzm5Jb=N{Ea9
zobFrv&o%}{^vap{-jQcYV%1AI8dhVMOh)hBY<jF6?`-9>z21#W>G++QDQzrPhzf9b
zdMZ$L_D(hv2pkl)mCj8?ch|o@c4Fv5Ah_-v&KETAB*?R<dPE7h6f*gXhpin9l|_eD
zJiJY-8)T%~HLVz6G`RCvzC+$g)qH)Hr6_jXM<D;I>r{(rVE6~pu)7v9_d*vlDy-j=
zc3X^m=H6V?i0QH|t!AxIz3E!9mp#O5J6>mg6+H5YCIt%$_}V_<jo=FmSYb8$ek#ze
zKeNAU^L()QRUEWv0Q-AToB5Q>S|i@)52W)7uZSiK{vIXjTAvJG!N%<bicgZy=7!4R
z`Gx8#C=7m^(0)FhcVk3g6v=pT1%GO?xy(mEU34gmib~{Xj@#bPzfVC}5eKd+zSPOE
zlb%+i%)l4`;S$BODFl5qC+2s2Ma=ityXQHS&pkHyFMq_lF0a3S5W#Kw{`>a`dfAgj
znl8C*TYOI*_^JGTpa?Tg{qv-wgmW-1+ps(0`okfE!D7KY108A@8a<fYNy;2*>f|>n
zzuiqU1<_}>@C}3>oP8|*_s7AReHeqFcKcA}_J8|-96Mq5;OuqJb9py@r64h%5GVKC
z59;q+cl&ViuW$b@17rB`P&?wn1JUDu9YWLa#D~uuucaS8y>i{{LdO3Xy$cU6Ui$ZJ
zB@vywPR;iJ;{Vvnui;Xr-JgGTr;r9NgcJn2snXSJE!iOoUtkVWsfYg`dv6^T_5QUD
zdyYp@F^&O<3aEf6L&zW~Z2^J;BHc=ev~&*GDBTUCARQyk5QB<zNq5MQLo*C9)U!uD
z#`!(({od<+pMRdUZvQxE!2;&{{lt#zy7t~E&Bj%t2Di3Xd*!T@>!xEL)>>yAFU1en
zP>phtqWrGE_-!|R-SU+|w`D>(9b)V6?w}biBn95u@KpMop=FKKcX(JGaA5J=O-9$1
zQ;s)Z`D|WCXR+|?7=CrwgiLatp0A`Hsq&9^BpSN!M>!AR<VXeqa-zGTp_Z>x90Eiz
zL*;Rce7ik`^}$$i=vCMl<KgrMb8U2vH))ZA=Vf$#yaG=M9s&J|M^#l5`N%Ja;BMK2
zk>5OIV3qoOszPewwC670W2{>>2B^m<*EO?jCmz?;k*lbsU=>15E7%=UvfD{E*|h2a
zRy}-0n?+xDVx#&{v9b-WIl!#v{#!Y;a>m-=(*w|eh1H_}1mW|><{E8njq8SX;JmP7
z*78&rOo3F%Hay@j20gdlSn%So4^I_7Xj;$8g<k70@*`g<mCSlml-&&&^gB8y23S_A
zF3DlE)1N+7fB;$peVXON&$E@}oAovNx$!W)U}GiA>frQ~kCS1{%*YIGAA}TE*@Zl@
zaOxC&L)0teffvth)6}wi+tb?#wT`T3ig@)Z9>I_cf&xF*)<kD>9lQO{KY@vR;If;r
zJb)P=C@q7rEW8*mj|leKJx8kadWqmi(Y%K3uU}vGr4rEgj|}WfQ_cJYp3D0~AX|sJ
z?6}wD*)Fzwl4rEBc4qdOx;ut%Xk)V!(5x)?em?Ti^r%@;L893g!>LEMf8KCCq>O0j
z784=8ce?V$7P;R{)mXPSf>%&6tocmsTm|wp9+|3Bt`}gM4zn>YVJF^P8_4qtJ*RNJ
zB9trFl{1B?&U0^dG%`MG1DgC7mTcq=1<Hj41Y3{o=Q$u7HW#xO%Du1YFkuwaRIldo
znzWxp)kGEe+__T~z{*sGI?hMXLV5T-`)RD+sBfbKn@e@*Ho{yCcgxnJEg}EFz@>+C
zqaWC<uuEwjO4;LcQRUCtJdR(Ko%sAl3XXORD$fe$G(i<_qRw)6ZXa}oLVbCjXwcPT
zQTo=xtuAcl-aQ6iCLQZ}-Nm^t(V#tFYLYDR?t&-YxpOCUzC7;b5AOHeB#eh)w@+5f
zHXP2<-`d<^+^&h>(h<$Go!n_v1erIP)Ujpp!K!HV3dWh`B1;eS$4lwSQx2-%`PW|%
z+31T#-ac)AEhC0qX%4O_$%I}l*SNShf8X&llM3wdH^t8MOmxihp`^<<&vr3cZ&Zaz
zPWh$`*91o&K2y9r<e3X~V=Mj6W^QC7Qj7?3m=JPkvBJ9q29-4gvK485zWA$Q>|7}d
zq}b8Re;SutDVV!08|6++dtYse63ndEU46MkrXjJshARBYvrivCehd+j5~{6uH9G`B
zd0j@gV!vC@pXq~^yh!tg|LF(wL-M11DZ3!))qHhmM;mIqIUXB9ULCXj<Bvb&gylPn
zU0V{)8Hb0<t0kwK^`B@;>*5{V0R@Mb>}RMq?CQt(1iRuuV{*SPj7uqHaAS?Gv(*FQ
z)X-GAa{+SbI~sY(ds(9e`GWaircG0#;_%<qPpBAgl(?*_qS~jY&N>Q@R-~;~T@p)S
zlgkJ$2}vFt46-`P<TCe%R7*mx{#zK{J{lYls-2R~Z$i)Z+i7N+CeOt24$!(*>{n%b
zG|Yy}9r~bP0=H2AX!CoQm{<X1jIG0AHD&}URpZcr`h07$_mwM;4+#5_2S11#4^MR^
zZLJ&PR@GsIbE<N>7h(x<Yb49dv<oR>OBlQr-W*wUR!NQKTmZM*W-oDc-^P4pu-Hb9
zx=eip-;D%l7;Mo$1+l!alT9$8?2OzDB9yg4>anqjK`pIJB!B(8d$TUY`eukQVVh-k
zO8QLc_WQ&OTW3kK6FhJ6>O0JZ8?sj@AyQu4p&eHksi6r>p2s^+C`jm6YUG>0Ml%}2
zurL`|=-UUv(=MRvlZS@CEtWRINhIZ>#f;KG19`D!WP~xLh{s%0&hfKWjBz=H1OfBQ
z0~UtAuT_$7&{t#i(jxt6roHrShiGJ=#>Dej|CE;Q+GA?TI(-2v?H)pQbs_#xZZPiY
zou<8!nRZTzkYT+Kp5`Q_nc_tWMT1~5H*=-y;V|zC5l-moDBB%sxncaeTfNZ62s+oB
z?X{a+O4*xdx*CORKHC^I<?nBacS^Vweswx}#6(d^&>n~4|3Yl+XiYS3J&RD-PK8UB
zD@RxrrMyvG6Vkmt2JO~V+dG+9eJgvz+DybTlC}^HXLNofO?90m?v(VMAuK2&8e&9L
zD<(VKnvt?MKK_UnI&Y)diXdVT`+Gp$a=e`fELw`3n~cR_@7AcMEA3U%8-$Qg;1Qkq
zrK6v;$KND+(#4TdZ)m%1>`?ohs$xPM4CCoDcz4bHOvTHTv=GkYaTZ_NR3@uiUmlDm
zom=~8+MRQrI0&0sHF%S|tzG5VNO+(K(y${#K-_cGzC6S%kZn1)4!1fwZNX#KofG0(
zo`~k+R)A3SbK+1WyckHAS)r^xpGhDz)n!!|3ga7!-*5i1rI?cT>k`_oSRaF@V8v`5
zQ)tB2rmoR*t7L>3MEzzbMWyT@Vsbr+%Z&}prm2-NnvTn+>B}^n+VR(4RStj_3fY^x
zE)1*J=C)pZeZL{<)P)O){(gRYk<cQ5PcK|smtMZK`l6GK3aSQoKHJpn)5``fi`>|r
z4~%LHU)=kMV~y!GH*U&w!m`ktejYrxp$?;JY>Wn~BEr_mlP_pF&BZQL@(*s!6*snH
zm^gjjRNn#-hPK2Qc24H)JB#mi-POz;N>RcatV0~3R<T=3^=I@+(9{2F<sq^bTs14N
zD?28zZdN|vHV~`r#pot82iZwgYXEDz9fY>8z;Y&Jgz=k2K;cS+VQpyX22C_Piz!6+
ztfL8^^$g;hp-w;im~cU$C=KT0E$;V2>PDrKAucQTmh;SxSA41q2!^;M`qKOs9-gJd
zfSQK=NC!sg-C!A#&u#M|ik)Y5IPjrue!V+FTeAATGLxmVU<%=;n)`wL7_DO}=||}W
z)GJbzQ6K+(*iQX(*yQiHT&;aQCkW1}LrDCUSFP#lt^;DXk|;R?nBN6m7-vwH><#c&
za58C<Z9*Y{8yBXWOE{c$^6c5qz0&QNt+#t2KxoD2`c&3P8;pO>Hz4%c>og?}DTPh!
zP}M{z4Rtf$R7^ihH>{&p44zoe7~(|ap+f;5tb$87yXj9v-ATZ0*d^mWTu-=PZ<RGt
zXq$SJd0tTZYu?`?9~>Ft4~?`{`H!lkUovW5LqZGF?X{Oq?WX=GEWcZ3>;8LW04{jV
zNNw&>VT#%XboSX$rNl6&yCu_=p%W^LVUX@?S-J=q!VEEe!g!MsIjF|_xN~g?C%ehc
zedMiVt1|b2jA*E^Ov7BPggwf-SEe7HqO&E1lBT)u?;ppBXUtEayK9+#VaU>#1HcU*
z2DE)&UsX*T1ZS2;I_yQ}eb?zZ6whLCxt}CAUgNDBmG~rvY=cbilMd!5#vP+=mzVIM
z<9;~VE~+;NP80^YKZN@NlP+2DOsLkL-#6>uK+#{292+?&Cf(;L^V=DJCNE7O?&&%L
zUh$I2mdyscWjsiqGCG;Yid-Ds9bIZeCXkTFniB`X*ym`LSmFs8MH<xrxQMI_Zbx21
zITd_`YY@SyD)t6dbA#6oJP$Krry=pWk{h|4dLy(SO(3GD{Pj1;QicuJlWS9y*C!I&
z)Uxy;VeEqlt{y?P*Wp^mX19q<-BW@K4!l4()nUIf_jI#)K-D~sRF4%FQF(XBXN5y%
zALBzfAeN>$rn^LFBR7ia^=6KtLICwKR)uD953q08&>S>>|NU^Pb1cO2>LJ=6`O%BX
z{r|>uf=nUGLLE;L7&+Z7ASNe2GF+V-j*JiO(Cf+)2PA0_ww99R4_BkI4Qe@_9z3{F
z=NZa*Tp?>X4tg;5XX-6MjshbujvPH2CTKec&vk)2Qpo<L7uAj(xYheDd?sgHHb?<&
zsbc%7Cp$~ssPw!mYie#lJ0=n6j?<%EVLe>6usX(6y|E6E0l!8I^?6i$nTT=oTZxAc
zYt(bui<h-~=(HUQVT>1q(u;Uztc{Vg|LIkIW^f&jOQu05`tt`|rIbSuDpL^rg_MUZ
zPA;oIcp$qWxyQT88^U<2#qkX1Wmk4zMa9-u!<gi=#~TCLpkmg7C!~DxEPaz9>7e}y
zNf?C3m?8A%pMMVP2<(cJD4A?-5QMCK-#LYZB!$EPN55ZF<$Ep;lfS0p=)XEV*ma`S
zMa*=rJG7o%RpFYXj?xFmuu2@`*AA0@_)vOd`QSyfhyX#`caCa#rr|1>P1OPDwW9}v
zKg_i!3fE4E`UVI4!-V3uGLZ>VfyYATiDUU8>`Fj{%o86o=8tA>%TBW?kTmI#b%5xW
z_x>$Ij@oFUwO;Hsj#@?6bxQ*PJa0wXC}n6abm&|hM{rKGPAqkVFU|Bxpzl<N^QJmx
zOF!RJUb^M_+)=IAC*U9oEM29gB5SI$w;LoX5G39VI@=j135ru(*!eFaYO6H}+xlAY
zC3JuP{m!gsZ*ALdsfRzUc!gm(Zf(3S|2aByd;9K_t5W*u4j8Kqa!jrX+g`@rWVk{Q
zcqhtEyMZ4<g%86?jg3uc2;&)y^L4_g^2lx-l4k~}q(8@~CdcSr;F*$An+YmN?syt&
z(2~9xg;uN$slG>>1Wum33w|KP5}OK-ioTTD_+$sO7xx)bK`u32tO0Z=lNr5&iYJN$
ztS{7(H#dYXn5o}HBPEwmUp^k3E$L9+KT2q08Ysr9=){dd6oIuEYe2n`OV%tYGyy9L
zSR|n*AC+&8@d5V?=oGGw0Uh@pLp!15JJFIDjaZ75_x3My4~>@!OwlTmAnRT|bmGUo
z`ic?-+(-}m%X+dMSK*y1ws^a09&b<b-*VE`y^mVzawlKn86&i5J>N4Dyu2EWs7&_1
z8JZV*R{ou0@<+ll-EOSP&lK$&n$&a#N|;<WS0k)P_qHeA2&kcAvWev9q`+*+V!kKT
z`oWJo2EtIC(s|E-BD?zJ+iwai2`s0U*;~Jl(R#EGut~Su2&a0BQnPj{sQ|FXtZhY3
zDT+{qov0Mbgt`FvkU>QR95n5c!keXBr(W&-=??ytpkGVBv3^q0hXc*enFc$Xu5r<?
znAlJY=<mY~G9!xh)UxouKlsqq8@fM(v)7QWQ01OJ^^E1r|K}eJcm^BP{$gL?$j3L=
zK(ZD`+VQFp^5iu_DufTELvR$x9H*pMe*XX#clG)8)%3QMVE^^GGHH|@G*v{>(C{gt
z7i^*D@9B#omby$R>E`sFRHXCD91=y)X)LrotdO{WbDiiryZ|MvA*aPZgAF7Z>~3fj
z!#K~Et7oa<rv(9!hIp<;rQ#w0HUV)?bAzXU&u8zs)ctNKuD5&q%T5Gb{fcu`yZw%H
zoYP^`D$KEJNmih8p4yLgEiA5^>Ee|`lkGv9dvhcv->BvNQF_s0>$`Uc$)v!=^4(Pv
zEs<BRS=Zno>w?_09iA*zA@NScg=8R7lDT~>C^%1-mCYg>Krz2M{(tRs;GnwY+PndH
zgdNX2cqAqCHFef~<Mk@Xz&sS#P5(u_dk8}#-j*WQTbSF3jJ#kXjzy2u($$9ZPEsI?
zozPqf@f2%iz<c1#C7AdU#DGys{Rm#n>jRv5i|z~M#dUbSX+9pFY<>%$f`_Nn0aW<~
zp;+&${u<fd%N<JFXi+$jMt4M;?T44X7A}>3?FC=RLHba&4fd^DH9_Z2b5BEzc>chd
z5p|xECr_R~e|zS=BoisG?o7QpC@{WQVJdv4@6qcN**)=ccQ4J*Va1(;fO>Mt?e5M=
zg;58WwB4&?KRKn_=*CJ{!er{Nyb^>9J-*yGX?o5nNA`=l;NO3Uq)M$CQRfv*xzD3L
z#<97%7V_?$Pg`mzrxrOAXk*ySk4Z_%a7&H~WO*8lJg05~cXbZoNrRaCNG)g4yRy~N
zf!lO?rOA3T#A~5BLq0A|GsLuqzbyK*x@CXyn|;TX5%RHj;l`rfaHC-47bm-WnS#yx
zw1bPFWBLL>N5G>YVBL@NCKT~Ra%puRIrl`+-ki(+G8dE35_YxFDcxb{Qv_sRHT#s3
zZm+*$+f!R|r__9Wo|XdM=PPC32UUVcwM>-I@^hi3oR7dxKoE5nfW2Do4hpCflIq;Y
z+_eMSXlybHd(CY>Gu4&t4ra3!X;7V}_H>w$K-K#)g~mW~@f=NLW%u-S*zs&~mG|-d
z1G3ZIG$W3kvEo|9W6TZcRF>5rNbft##2|n!X54ls(bURfH~JDGY`(Zh+&U)Qu}F=B
zsY$yuwi0G$a=^zeINd^vPAkX-H-tb5>X9prq8eQ^YkXm&!N55z0Ipu`&=k9hQ06#z
zA_@t6e>xT&(U)W7G2hG&LfWe6*Xr}>`4QE3;SK;%uAHKH5BvEm4AMQoL_@minq`@L
z$7Z6rH%uva2*NPpNRfyJjIkuzlGNqRWcJGgx&+u;9Dl*x54$#K#kSU&v13+O@-QLQ
zXmDKStx1Js1%M*sPMp9OYA=sNu!Pje(BvU<9&;qMIU$Sgdxu)EPPZl}b4&tZC>r0K
zC?}-m2Y4tn5u405@A<lBlcniN673kYA`ogVOPXrg_W^0zH`-&nsmWUXi#5kzQ~51?
zqolG9#@^%^1)`(JXq7|Am;BOwO3DP4{9!Ulq}-Fvk4_Kp6E2<pH#?!RWDJj<;7uiK
zd_{kAJX7EYKyp=>bx^sNz{&tYC17hDmsy9W)2o2L>S$$l`SN9O{Blt%&U6`CJ*dTT
zc4F>{ekLWg=PyP%lv3t^_Q~=cC9YF)5`NP#j{FDx5x_5Y0{^zQ%zb`SF;PG{P4(kZ
z%K>cp)#nSeXZ<9jO$zL16Cs}R`@pUw4LRw(nch=Yoq)^{fvQ8U%vZX(t)>KuMDTOo
zqRlbu`Rw8;0X^$DvPGQpniJ~)O><FImFzM=NsoMdJ{~JhOm&~?GDI+mPOa9d`1<Dd
z^zitmDsyOFx&Z9h)EZ!LBbJT8itXKhthHKobR8=lpz$+$A(UzVlY>f3MISn%ome-l
z?DXcr+nSuEED6dg>VJ50Fr(9YbaO>7(s3PP7LAk$fQJ42Yl3e^gxXH66xS+xVev^3
zkjBn*@@PmfI<j=6YpgAj*!R!+rldi3a<}UWO`LL24pc!Y->(VkzjRF&L&MpXYvO}g
z8WtzME-bHPbRMn?KdbjnxBO5>C*E|ky`??<c)=~s*MTBV%Y7=tjeuSAVtA1DGk=Gt
z0~IYwGY}<mJig&ioAQ{v&JyQZFsd5uV8r_ReH=A&b#L5wVNt4Oycco<^_{T4F+4;6
ze)GT|Z@#}z@XXm_S<(b%!YtN50&U~RmvyJKkTs>txGe=|;8GKW3rR^Z>v@4(*j$^g
zs})^;S2Q^jI3}ztGoMbwt@%<mlq-ENzs2Shc*PdXke!R07lx%Re-Kynm3YX|?9#Uk
zJj2)evO`_oPLdY#od)3~^Cl~<*C(XtPh8AMbe!u&&l5mlxJ~N%6~*a%9jkEHkDsd<
zb01i)sd^u6>ME|NS{TtY$TRJVB`bbJnzX-$rd$QOBIE~2*d^=AdDWs424aD6xttio
zeeHyXVwZ{d?uwVhF?K2QpCMIJqr*Sg*Z8n$`GP|CC1H(B<2E);d$+c?9@=fftNQ2g
z!6r?wKPXfneU%hkOvI~!zHY-D0_bWeKGfKa)TUcYxdA1gkd>N<!r4}<3?cgpy|0Wq
z(AdB<Cn=}jf~-jkh}RGe#oX8vO2pUk$~IY&^${Y>Za$2CZN&`C5W$9a0r=gPcqj_s
zrxC`TJ9gBB0P^faUOb~$1CG%LzpJy3z#MRpIW0H#U+>Yo`ZiqsV8K>-zOv0ik4LyW
zpVdl_2RMO1l_9{TR4Yg+30I#FWprZ3zu_YxwR&wfo9oJ?fPws3h1z{m+D^%Nt~B;j
za);VeRg|=N#63;|MLM_Xke249YAh~A9Br&2Pjy{ui1E&9^?)`GFv)B6(W6HI9ZmOK
zWQ2GFUN*y71p$!neujtwVI>oG;N%0k0QgClV?`pAy{PvV_i;p&y0!g$849KTuU9FU
znfn*rEH3qGcRE0~ijn==vqxBwT-hVc-IFS<3ZMX4kaii14&}r<DYX<>+J-LCL_5J5
zq#&S)j2Sv&Ql%c`eWl*VMbH|n^%rlp$x!|Em+63L%Tap=H(_OEiADAK`~iN$`iN?p
zwN%#-b<56o_QQ=}g<`}?mApG$b{qd`EY9Y9!AhS_tp#gsjgm&*`{<19$<Sg(vCqrX
zSVRj3dmRKDBjm$;_bbxX=0Wjl*q_YBm%=i8rs&nYIbOT>f`71xfp^Pi(xDZ8oncH{
zKgLmG&~`3?QB@9z?^a&@Dvbqc4%N9YAniEzl#c6qD(_gGk~i7E^tAW_%+Qk?@Hwc&
z2lFXvklMu#f6y}tca|C1IWFjjCLd;-YDibqc|^~+S;#Z=ZQsUoWA!1<A?#y^T!Bj=
zT@{k^1xPoTjw5Ex(#Q3EA>ZUO0h%OBl+_VziatO1Nzvey;!QF&mz<76s#rUt@1y!O
z(V-<pgrHkS!0>;88N5~wa>=qtF{b6+Yjpb?SyWYOrDp4qy(HIx8R7v5AE0mV;-jFd
zg~>wDN>hSU{Q?s3b4V}^-q}riRMbGikrDwzw7AH2Uad*;%I$j@$ax0E76VJj7&f^j
z$Uo2frlPmQ<grr6+vYImNo4e(tppyhl6sS<UM5JCDf*DN_sWdz`{Ort5VRaC@74t%
zh}Y{{ocMwaU{`vF-L?2t6vF0g10D~0jR4<K;7HtRi}2q=;{o8r=0dF#ie0-a&+LW4
z@WKcKv;hlP<EQ9P?rQqxR{poQITcXXF^-TZo3)<X_2=lC8ooGsNZfB^JaNQk&5*bk
zutp}KJom{Ng_hn-n!5l5&|5UWtyo_z1HM0u*KlqUQ+jt(wgJkhtDgYjActn;qIM-4
z<sPF*C<LtU2PcF3gy}6R2>^j2@4i1i(HtNAVF$HDn8kyxEFL%%vrTbrU?M?V{Faap
zBjllV5I=4iKsN)H4E6a?op!^zFj<Cuamp@uZ@Q62DkhiLpl)Gu>n(!Kup;^S^@!iS
zeq9V7DKF9=8>rqiZR*?aj7jGJq&Uk_AwaKEG_+Da;{kmK<RS`PS7-apAl&Op29ls^
zUpl1mGf#U1vkW|Il=jf=FR?Ky%H+tX?8YBF|BseNNVHKYAnj)&cwY22>9?!@#6&z8
zBby$R$9-DZI0#@k(hgY|moTNGldgibss<3qi?NRcdj!wiL$kK_BqX@037v%D<$HT8
zJl3#Lx#9_6pvmkP%Gb-B-4Ad>L*KB8lza*h_iXp<M1BCL#(iQIEMrY{4u=9_de)Z$
zL21IR0YE?ZN}Tfg#xf_NNHthGm{H8;>>U(u;y6e_)JOl(-q?^A6TIkKM2KFb;bQxK
zM}f0v9|A!bVkx3+QVvLHz5QjQ)+92f)cicR=Va!R!(U$Gptln8QEy^EgC`RG>4}b_
zhkj?Q{BvV{p+Xel_<U)iMHU@ELCXwkD`5VdL#0ob+a`S+cW3@=3y6MA`%k=Sq_E-P
zd#EQb*_ry%AS!^6;@=>!Q{p(J70Aw?E>DFU60M(__pDh%@E<3sq6HLiX~=LQTA7j+
zh-REt38F;s!e=kS%uK(hRCM&r^70BmGn9e;wH3{1F<-jXck*dSbZ~0b>k*B6N~TLU
zpaF%BqYW+RF(WS!HW@+A#j(#oGZU-D41hrB^nv3`4Uhh?fD-yecP3?miQ?jq{h#S%
zk_q|%K<R|WyHA@CfnEC<f&EL;f@V=gXcy*aMPE*EYdIrz+NdK#zQSt)vK(IfDWf2`
zpDFTjQ@JKZq~J}4nAA@)Ka^^*fGkv&YEy=*P#WDs{J8=f3ckx5Bn_xG=nGdqEQb=2
z+Jkkpo;_|+e95rkF18rNGXRo@xsg8WlvxKm{6s#Usvn$V+Hy))&D7nEXEjPvoR|lG
zo!}`I;6YYy6Wj8_I`XOo84Ihts{APh^O93Q{igWCba;Sa$7l+egL(-@4YmQ_^rcKl
zQqnD!n|WC0K%>$S&+jnB`XmJ%>FxM=Sib9u{(p&FL`J{3GX><o93PikOn&R9lv)AL
zB+JCMyEf<?YUE3XQtA`Yks=q!S6>}o8^;ghelh}I7oydJF)+xae3j^)c;g^s3P<$b
z-ifcgcFmfCM(DWcyan-u)t2{>vwn%%B`Kf+DFqXN>!e#%F)oMW2W<<4VcsT+{X^yn
zDJgKHr%#jn3NlpyQYfcultam}@|lE8cIN{ApG_i(?)!m1ef{uPX*8vRxlY}<mvc$-
z3mDCIy52;otlS~s$M3}NnQ5O^BHj%s$=@HyrKOJDf`&P1Aezzh6<GiYNK*bdT+K%G
zKnkXG44y`OIl4!y*da(X_+6Oq+Y==q$87Tlac9lfkbUcx%lx{cvwE89A6*Kh97<Bx
zt=0s&BIO3^)Jp!`l%q_&tG{v1A99D5@U=DKIn;YFdOluN1-KQQC%1>+r!k=KVH`|V
zD0fFNLZ}}91M%oSYScaz4uTUdE%IZWKg&_2gXuuFl8FEj0vx$#*Dk*gAD+&RRJ&M?
zFeTC8ovs5{di+qp7eFsJ*mu7ixv@E4nFm;a(pE`}1)0fnbKNGUz$dc1rBQV4v+xSu
z7ct;~7tbvP#)<D@vZdKr%+K`ujcAtje+95iNTnkWn6NNI{6$up!LR^`0%j7c0?<Eb
zh2ZWFkyRq!I+Wjek*tW(Zl`gMh{kQkjD34fN~D3O<ZGCKM-IXPJE%oDo{Bj2Mn<l<
zAMUUusv=Urj%sbNX=`(9=UdDDbPBi89au08Vt$Xlf=|i1LgmISJ?<7KE;$hI(qJ|5
zfgOt3<Lgo7@YZI1g&#oD38l|#qmeSybo=-1tA|OE!JHa1gfkTMsg|X53s)`-4Ye=R
zYvw$7TWPjAS5_0kiH6A;9bl=#=rjxd7BTG<Qc4wl;~J2D{nZnQ(e*Z2#p0AfI$Zhs
zO0;x{i(&|jf4R3jgB_i|u{6DwBZsz=6IGKoOR*XWXi0R}XxA*ofoq)s-k!G|1dccZ
z?_uz^l%`y_-xM3yQ;>P;Vb`5hiR*Y@vk*%?w-G?*x&3Pi)Tc~Z&!+B&{)4<x10I=t
z0@5W;xm?O=kJ5t5&K~d+T2j0!aI)NUfH6(G#Pn7jM{OHtIG>5%<~FsV%)KTp36J;I
z$RvrCh$aA#eUP?2lL8{2EM3t}x1Bsg$Y&LBb&+x3FS9V#$XN?f-$H_n!lF8lcH_nT
zY2KPi=7lO|ELe2z#tXIloKkcCL2QY8DOgfSxi)&YdC!Iwj)6#QLFy7y^2N;gb7Qa1
zysM)<7tlCq*E{bx`ibTT?)@TVSd$|DzHvES)lOQY?cA~Fu>x|9<0rob?u$p22J0g)
zUQo#}wfeBaSMd7vdys)uWKs0YFa|{15LZZUC|m9~Nwu(UPrCv_mk{dYJ3F8Zy*F$F
z;3tai;i5dw1@g3-BOoN%6b6jKfEqFk=b=|0t-d^_x^r{*D##9e8MO?s>F?jahrG(H
zx1i8ermq?XPDgZHu-Hu7d%r$n0y~x>O1xDLH?HQT<70}jIO{S$sZ}A~KmodNn9Bgn
zV9IgH#Ub2FF=eq}#ABwYF})Xux(_r`mjS(hpNh;YOO}#;kIY;^8qaE8QsjaXVJ$Nm
zpJqTj6&Qj|S<JdG5FRBJ@?_W$S`|Y`6w(C=n-y3ozEdO5MRsF?#8V$FROD5g1!X@<
zX{x6$U5Z~f(vGv58-%F_dy%B^xHk(Ak8rF!ynOl538jv{T;1Xri>1c1Ym(QSLHnoD
zyD!}T8ACM?jL8ya6<&Xg2Fu3mURoP*5h7ztWwl95mGwB~ps`oogY$TkseJr;xZY1?
z<O}k<2651VJ_dycm0Y^~0LoZYuIU7QBeFO%%|DpjMoM~e3Vb<C3Knp9=<fvxLmT8-
z^mSkcEwvSkjTv+6At?kav<B&w!7vbQ#)R*DM%VhPb?P}9th}Cg=8jdBSm_AJYXRpx
z`4of?=LgygEJf<=&vB&1rJd6v^XLszK(YV<>lc(Le<$bI`|1*>#iq}&dl1ef`{OG+
zo;}mwwO`h8=+l6^<-%}}VQa~f`e7oC(qeZ7UPV+8OQUCkwKn7i5K2XdGsJ(kRLB2}
z3_E=g^GQ62!YnIe@bQ9)Ael7B(cDx{KgM0DU-qJ!9CWZ`Z%>v%VXqwh1p-rKr6O0-
z&PBi*3PBot3?vP#3vUAe6kFY@jzek`uS`?TZ!GuFKLvin4>(Mft0v;^jc0v*U)F%Q
zQ7fk5Ob*K*k}$f|dTcbK)4bEg<4vI9lfVtDEQb8VvBWZ!5}_IVeI11Ba-SjLi$?bS
zC-rtwV%Af?z|2hTUkx5;Rd{q~gFroCa3;T*TAVpJF)#2d3d5*$zIeXEbMym67$N&2
z@}fo3F-vXY(H@HIuPwEx4nNb$of(w;=+U-~$y+4O;fClw7xw<O+5Er{P{2i)^q%VC
zZKQEVqIp0md_u((qqj)wG}^#$+QhiMcv9YBZ8}u{VO?11O`)~}&nfDIj1GRrn@8C4
zbxqSXvAUynP_`6c46VKV1?#!y#kviH?g8q#30%vy7sc@spjUGM_C2>^lt*ceb-7*>
zFO?v7Aaowe6zG}JsHHbv!}XEZVq`~yf!dpuevm#sM?W%uP=0l><({!2DS1VLAs;je
zpwqBlRUtiDxB%0O9y^BrZ`Tp>^fnq3NOJjmEH~>i5BvxduAx-NDDmHAkgLDZsQl}B
zN3!S!Uy00xJH)`Afv4;s{F-b+Pz8e$XV!!BMk~6(gi$Y&v2oIAB)AZ%lyK`HN_yZU
z@UV4H%iQflK2TI<n2Vr~r#6s*=+leB)1_MUxr~N;Q0?y(<+<6IifOklk3rf3B+5+q
zR0&{zDjy-n_e7U?X`$<0k&v^p=H;E;bUL?qb@D;EhP(tw!sr#HleVCXay<WsJdM8^
z3_UBd^WI$Ntx(k?hEcRqw_p-oCvvmLBC@T0Khx$~sAyZZc%G?R@>U)ICy`}_L6wr%
z4L}Jcn>WZp_D|E<s)i(5Jw(9q%%v`FwjN7oCszV9d&ocME(Rb%I~||&|2TE%ynjwz
zQ+1ceNMg>b*)9*K51&B}5;~Dcis}&N?+H>&wpvRQ>M9T&v885~aLAyEi%r0hl(Ri(
zZa#Z43aLrz<P4-XYouU8BE7ixF#`io)ey8D6#=O+_U_GC7XV>Vt!-b-OnT*^^6GSl
z-iS5X^arc;Rn8iS8ks6QD0c8r`FNsajf$hsvKJAYqJ;KKzVcLXLV+-qpKG$UdFGbD
z%EH+D#}?`#tO?3CD_#pLFO$+Ba!rVFh<yhjXcDu4i^EubB(u}9IddqlfwbFt0crAO
zwD94msnEdb0ud2A@=K2qrCFb~g02n^_x<82MVWe)rjgT^+(tXyf9Ry&h^BoDhbT&_
z0p&X3G<g>{4SDXP-8opT^GDf21Tc=KdFPT<GoRhE9UuHcx2MGX3Wf$Kl&++vX{Kk+
z!~UAUv_<mhy@#hQ%u$zLfbh$}7vfW8=O&7(EUi$5G$}?;+uj6bZ)YkWOkaOetH3(C
zWMlE|wBXx&w{E0A*fbLtVVn)7kn{$|08lL^@1<u9N)ASBZH|;u5^VIsrC(PAknXDq
zDJtBla^)9CnZaB3L;e~nhIUHH(d6g0UbyuzOGh>jzqHsn@yp3bvET^~?V;#cx_pR+
zKB%Ah*uQF)4iCVqtb9_YsOV%YF!mmY=tH{}4o;I0PPa67Tq|)>(n>%d@=6_*H;5#v
z&zIAgU}w1ege&m0i|UyaDCZ7@WC)c_bM8g%D|}<1ykrm(#n^pXN5v4dNmEA4%+DcP
z2<4+xx}ck9znzo<5wrT}9FuZzl8(j4L%C;n?cE!64&U)ds!Ay;PZzKU4n%Z^2boy^
zg|`OJ9E)^y;SLXAdjSVR)o1uiS#7IP)>Enh+p94@%}AvzlYC||q0f@(;+pz=a-wu?
znlR5d4+&)y--;66|A#i_wQ{ek%fHo6B5H9uO?tw#djWZ@58=%A!sv)qAC>3s0sXKM
zM<7t31Djn}$8v|>O3fDO%IRgbiibG#KG8<dB9t#nw5LZt@ahDmNUn*BO<!Mhk~3&2
zXFwM?KB;6k6*lb=H`+9t&Mr?$w6#Zvm4(eIYavdG428lpbNYb-OAoI^nMhDGXc=FR
zHc`z^Aa!NnxLaLJqs0bJh{g$vo@S@4W&-HQli*O0{T0n@AYiwfj?mjH_|sBMErNpT
zo25`dK%bmenl)k+Bq#rkH3_Qg72{Mg%?`VF<LRBl8ttH~+zhTwQHaWQD|8Jmh~4u7
zKw-_Iyq=?8FUQ%Q?$|TT<L0QBaBITgA&86#jhIsH0I0bFs#0@4nFdO0W0)mr!%-kV
zfxSLo0iA42qAZVgz!92nlDuZ1-<o94Y4YT$!m;IbfF<TCnR@Dal0m4OwmKfyUr~j2
zs{mzfy@B&ksOjx?{i?awtCy3<mz8rLQDP5nYbyi@XJoHKFKpA+rnuCG=(Ve8WNhd?
zC*ghsjlf6Xy>{=~b$+?XDk#P!D@ap(<}FXb{rbODOus;1-2t(6M^Li>uS-zVPc~%`
z{b!9Krww7NqlhXJ>!dpUgA%<3_d}**DtzEq>(ih^vShdjIAt#y^8VTnHho$>mAMRK
zjVIQA!Umf5E5GHE_i|%}mZHk<1onU@<4M%KE;KfFE(L-!Ffkw=VGu1QdeLu(m^TJ#
zu%|jf#?4-g9Xb_;219|_gPy#5Pj|{yKLLJE;c0`3_$yO>nFz(KlNT-+!cdEk9|dc6
zg4zm@HPbcD@mxxKD6P!ICnbOa!(T_JEi{4dITd-o$}gV+K&F9A$!kh$vV9*E<}o{W
zfan_;DdPMxULv69j*Qeu4J%YooI-#iw;Mvmt}A-p<S!K?wUrT=aj<M{0>+@SR-buc
zN^ob|6dh@(P9N8>W{Xvx0yea^W!Wbp?%Osn!w`kNaLG4<C9m5NfMrX~ZUMcU{g<mb
zj`7_G9jlJ<rS!*&_w{146J;4-I+1m#GJw=L0Y`~)(n|_YeDdVwnOBZa83PBIS2vas
z%?UEhcq@$86}HB|*w#k$g~)ni>q<-=mI@cufnjwtkb=NP73ac3>WN>#U?=hiD0Wch
z|IrSD972BNU!^G>Nl)%U?F>Acc`-j=Auz4vL)JoFcoI+wDLX)IT0%B10dZ1W2Sqs=
zG}S9m1pHM+{VPBuK)YjJx})T4q6s=^MU7p%c0K4VAVb&=3mqo`9g|O)EX{1>0I*_j
zK9&b;BQ&)-RI3$mLbxCaAlobkJp;H=P?Xc7dUB1jC7aRS<Pu7a+X*H;p;2@Y(Fs9r
z@0EglfI~-AIa)a7Evy`H85_N#0xt-3e*^<|3wy1#WhQR#5@TUb)tFSk=nrC9O0EjI
z56AJ=z%b@jsFG-#jws#HI?4NC`fh2IsifOfR4D;3Xl^W5Z#7z{o~io^hw4EKW81S1
zMot$nh*_Kd%;?XHx)6VZc~6^^f2!0JpvZ^8ZR6Ih-r(x09&h&q%)oW@RuGu*^~Dxr
zEH*4mZ9e7iMVGCOJzYM%j(WqBm{1CtvtDLub+{+5-p_z=L?W_Ey6cLXBLrb6JCJ!<
z6#%X@q2ScIzh<6NQfpANsXPOddv!sBH#$4r8W&>(7^$ilGUU_b>L`ic!0|e0(V+Ze
z|B00Z+yav)xQmVrs{#h*c~o1Ea3G!r;slq`Ur@pSC|G)HEItI?wDP3_&$Pi?ES|Gs
z8Ug*$0g)pM>qNeKG1jnKLxvcqA0FnbN-T+Hwh~G{qd*}kDmxQ5)y<a(1xFB7w<oTP
zx-O+8{-~_}hW*Wp)`N0p@ro4_t0S!k`+xidUI#;?r+XiYGA!Z3h>Gu;uU+X%jrkGX
zP>TP2-AX8xertli!;QBQ|L65t|M?f)=O0rF{eG4i{uhOQZ`_cwyH2tE@dInK0dzqu
zu;X2EzzB&0W9(>Fi_p{_tEe2=w#`|T?8f}fcMrN=hqvT~g}$+uX`}Re-Qz<sN?Je<
zi2}<D-_3#V&1?#o0Q%aT0+z&mKZA#lk9LWZt-k&+m=(i@D1q(U2EB?6YlISu-D--G
zibHFJQi?I^1ICo5en3$VKL%vjkn)38!&T5WZG^Q%x7<VAlNK_2d)jU9=^Yz`>}4Id
zg6!oTxr6N$9d&YXZQq*_Rd0u~rp5-enA=om=60(6pFVvu1%d_OL6EVb|J)YkzkJJa
zENEHIkuG@oj-zDoveKjm=eHO16Q&%7siAVu1*E9e@XO*DJzeNfSK>q>7;M{SI4q*j
zFEFy9&@VnxqS!A#f@&ixf1kO|a)7defbK4Ue~^t4c7(b(_;4t66%rJ5I{e>x<P2D%
z`Jr-N!-gu))y_;kNuLt}(8|?y+aunEm~*pH3!CR=V;8j9XOk9i#;DXC-yS)D3bcpl
zzG6p!G*d&lb#M;zL!gCij1sUWFHY!e+tyI!oKS3CvzA!wS>v2s99OfJLQ1Fo_RBXI
ze;8x<h69}8Z{LUizNh}@K2g4<{lk&M7jsYkIrZ?xBf5VMJLTt!L3>E~|JQ$mJN`)?
zDPMB`&qsY*mj7A6{|k=Ajb_?{nuAvZtkSsEzi*qXhx)<G0SWd;pZT%SOnQF5LXXg3
z{ruieFzh_VB2`X~{eCS66XCeC7)jWEvD<S0JHY0Lw`REr_a)#0l!*u2|K~<L8is1(
z%K;MUH*PflV8{G=;m+M?hAL~R2p;Xo(q2or&tM#)#N0N)KvAwbm?eOH)47elKjAVb
z+*zq(KyFF#R+w0CF@Wh61Pcn;`0y4ZSW|1TFR3aRb)Dw#zcHin^J%;~MiYc!M6vyB
zKWgy(V_+PkgdHK&;)RdO!@d1xnz!}le|@o5k7q3PM=|vV_JEwLZ_b`Nb4Fs5YN*Pe
zd132sI&STpfB(XAvGO|JomA=~x;E~$TL+j-rOwMB->-e?HR-wglx4YtnX8i|cnA*~
z1ixwL-_Yt59zw6uCtA#{pBw;<U@89|4t!nhzCiVP0@h6OjBk(XR<8I28p)qzX!#;B
zkAG&REXXoTdtle8Pbcutc_)3a)?-}iIS;`6!-Eys&w^R60u!C~uSHXbm}y`u+r>Jt
zgKnn^GB5l5O>c3UNKWIG?x8#_+R`R1$iARRcS|QQ<<70_iz9{Pox4x5S4<jIFi<uH
ziooF6!34*}#T{S}1RmRH@+Qoeqx^f1@}z8U$e{Xsv+v}^R+HuBw(YgtX^RU(e>^?i
z(V%8^S6tIy4QeM1N(yyt;`V1TpzzQB#^(x*?PuDs_-;@iv4Giyzv8Dp-;U#U-=`5)
zxG;?nz3nJpYk&HpYf9)#et(h`CpN?Mo@GSMfY*srJvse*PE`y2W1lZu0VaA<%F_bI
z<eDxPCTb+7ayVsZ4UeumnT(&e(&~EB-5O%pQxigpWM=95QQv;U{Og9#r_gK(<BZfk
zjG1E^6;bogc$^f%9#z@tn`G6u`SSTqPhOP1vGDKH8`a_A#yD^!e3D)b`|h*#P5!zT
z>W|M1%Y?fUOdZS1Y#-3>mj4li1RSRv--t5U+pY(;F+(2%8o9f0o!!)DM0@CJL)rv9
zU5>M#GXKXfom_?A^m{9iLSr$lP?}gU*F+YbIHHut9Wu@RawA$CD?W)j$rAoUIQ0ER
zWR1(WUvux*4or3$CS%*VJ}XFYpXkXOgE2g~+u4@shB_G?vDT^fl8a$98_BrlLtUF6
zI|tO(?|*u@VgC0o@`~>_83Te=rVj2~T8>vPua+OK7#APZiXYq@v3OPzJo1L4V(o=m
z&0r9XiBe378O~MQdRW<fKslnus)!tY>KC!@4RbHKR@AcN>+h{>wyi(uP`A8RVuvgm
z$J#mVc+e0vP0i>W`*PmrVCZf{;&?~yb@Q9%JcaU98x4O4xcp*ZDhz?k7ykUcTx6T;
z2OQ`w#A@mO3euUoJW^F}XGq^Lz@YZ}!4>@U#}|R>^5!OAwkr+WjkJ@BuHQiZ=pW(N
zdlVhNHbcDpz3O+{%8oU4OCpiMz}Pa?esQ5OieIGr_$<v*RIA4!tT?tWEVRFMHlW6B
zlh=(ny6Yw&Ehs{(1j_P|SLGV!5W~hRoG1^E`6LtslhgdKxu0&!f-0QxY;ES_p_8uA
z#0cfV!twL8>bZnKhO`~^z30#%ovCqo>R2A<-i(}+@74qM5f?`rtDcD5L>ktc7OR|{
z;5Bf_5PxbO=d?tACx_4D9&QMg^cG5^8KI^7D_AEeC99We!$&Gb88tL>e7zL1Txi(;
zwT>Y-K-P4|ZM2Slk@V`7r3OWLU5b;`IZ0_3&|fUjnsq>QJb`;I0-&;LTM%0%$@%{*
zq`zT4<05;Da<Q_KX-Xq6$X3uPxpsB0_C<G)i_MGW&#E!jEHrsYjq*`1bD6a!NL{}B
zs6~DLy+^rHL~Z((Z^_ytpICCwCEU4Z{a22B;oil5`t<3N8{;n@EuLX*zLFe!GWL!A
z!7C|8Cj9=oI$N@H*Xbv_ny(yrYk#N;H_MGh?&m!hxepOIwQL<z)>X1R6ZBk5WG$*o
zMARs4_5GA@Y8Fs&tE+9zLz5anowaVAxE8WkZX>HSG3<e_&IsQ3cti&q3we)qTgq%b
zH4D%>?d`%~T><NPH6q=z^<zIC6*Y+_+V+h-&fr|nIecDr+l@oI$ut*RO_}jmHmD+m
z#5k`|h1_=(^<0uTB`hq0(-EyMzJt{5A76ETT8D3vSVA}t$R|dBd!`7!0Y0yRQl^FJ
zd=Z7WbN*d66L*-zaCPgd2$lrAz4&6TZub2)cpg{R+#Eib;JRCCZHc5`3K1@k9M<|D
zzq!pm4kbHT*tlIwW5tN=ZqznEmQRWZ3E@5a>IRRiAu__vX4Z4o-?_e6;(Bug3cQNz
zURAjo%zE+$hcfeA<jU-@@}zUafBABXnq7(AJSO+5uGnVc@mx%-_<)~S%UdbiwI$iI
zKk20+`E5t*Cagzl%;S`Ee)e{OPj8<2_ow%ZV!5o=u^yuz<<O^iB_GTls!3#a4i6Ow
zeLse%=Be@zJ05z;1S{d4l7ts<IRE~9u5Nkf&VB4-HNjdGz|L-(z$kj+ZT)`6^;c+}
z^ufWV7m~J<?TQtNa<hg<nJ$d$(TiE?VtW~RM|rU#wkf5(A!aqxD%z{)sd()Yk4hiT
zCNcH~e8-`+rj+qzA-BzU6#Qz)pcbc)ZLAX~L7H1w$PwS{c;NTt3$*<VnD-SkUm>J&
zcg3X9Y;8KjTcal1(@z$Kn2k1U#75O-Xz}jTcqit#cho;D#+%nrxq8I}Gm<5~aW-K|
z=G_6tDS7JCr<ZE2xf18riQyxe3yOd(tamOmw%`<_gyK5$ld~-G!?c{nRn|$HS%5bU
z6xy0?{7Ka){zLvUXx>`cEzdMuNFZMBpmpuueUxn*%Wj@F4?1OWZH|I>4$Rg)iE_(d
z&_=MB2PO@}LIuJDyhn}>->CDx8I{{RS}&G_r{_;g<v&WBw_J80HFbV0rgpL7xMOp?
z=Q^hZH+SP~>1=vC4DmovT9Q3;HIek)nJP)cvEt#nUg14m9k`}n6QrGI+OdJVd-?rK
z#pF9l?q{=#N;lOpBIg_M`9gL%?A@-Vn}yMNl{=_kOfK_T^naEP_Net<?njt)`bVXC
zxj(Bzc6b=qo`zyFs~JL%0m>y{x=*O`-9e%SLU6%!YCud*ECaIN&^l3vcamn;V}?QB
zro|X<4#@Vogp$fE?hR=Tmxi+qW;FwfwIO_MLF?01Av#VIJ8UnW)-6@XuV5eiaFxCF
zVoX==ApU%p5N2F{IIuME!=u7!Z>51iqxRhRB`&yu!hbGNMZ&3jO=cMWu~H?@r>X-S
zYa<e523mHCZ3!<tfZkr|TGe#4dC(_QuGOESSdsvk$k>zMte72-)V+Rj`Y#fS(qPQs
zb0a3CFx4q8f1n}sw79-)j?1e3SR+O)Q#Z|2recjW`TECN8JAiV`&YKKKqYI0^HQCt
zt#Nt$&EurC2xt-JMZYofB0oQL^T_b7l44;UH<A2a{tgcSMq>oqw#Xzi!pw8(Nh@)b
zyfJZf*2HA7@@@u=o*O@-a3`}nyPG8P4$eg$n;zR;5F?_|8H>Xy3Eg$uT0$<AZi!&D
z8pc;}ibKv4KBmMLxyYW_3#O`SLajad_LN3$8o#fhH~DRoMEb7x5xOZfZpZncp`U3}
zdGFGMLVA-}Xv;Yx-nV=hOTovSMKxcqEuEw>mQK6sv<aoiYX*4Iib}R{uUiqV9q;aF
z9a$NTbYwog<nBIO>vt->R|~g3AgEwBHZlSY_q2Ngbxx~ew8iP0jK!v<3)FLK`ikgc
zIa9Suy!N&yD`=Nqp|1`n4q!GE>EVLszW)%%H)a3+k?f1|Zro`7aVO&FQqZ};+G!p=
z(U$w}`=?JcQ-<3~svsg-66H+P6bc@SmO0$Yjjexd$lN^ufwpgM%F%W=h4DDaHw$m8
z2Lo6K2y{X?Zfjk!xJ&tt(0#==3WpPC6kis4z2p$%`BR15m(<8&20l3LT!Q-i+@mYV
zqn$Gfl<Sww?oZ=+M#E<egu$}6*J7;pTCt2)l>4j8Lqp3qSLJQ(dkgyWk}yTZDCfj`
zP!)f;ZGMY9c^cdE`icQ|qngdTbqZ$CE-Wm-%+k;AA2apXbe!qOW+RlqwKd1%+_umS
zQZ(|I(wLrio?ryKW7e1CZP)L|-=w=keL_s#taL#&{Xwf_D$TU7n^l%-=AYfBo9o=p
zPEIjG`Q0<B=}E>nY;EI2!EE>lA8%^+AkafH66t#TPNJ+M{cKyUoERL9x>p-sL%pM6
zJX<aY9&+dy9>Z8S{fL|jj+5@id8;3M#8(dLY=_*TH5n7**+ZvoyIV*38Y;Q3s31~2
z_fK|U-p=G1DOA#GIkP~Cbe!NOkd3u{MlIy(>0(Fg6g5)c8>rZ(-W_hx5`69PV`eis
z*Xk6kx&n03!EqL<gNP^}6vnZQn;XQ|KP!FP8Huh+i@8J1@p`R#zKr`qVERyle@`$w
zjS509g=V(DuSCy%oh@yvz_O(6z=endbuN2H57H2`51OTSf-$9s0<5?%Pa2?@s58c;
z8=uQfGuCjn+pOkKjaHRf<LNAcc|khPf8we~MVTU_|8`n}P}{&MW)@#^^DOleCz9Km
z>%+dNEwgfJy7pu|l(6O=OV-GL(#xrq_1e)=wNpFS0XCbE$;ilPwcMG>+Pxhf+ja5m
z1?$m8tF<csa%BHoDLyR2kqgp2K2ODi`X1x$*B?yt%&Lg%AZqlo^{Y?XQ;ccvbT2lu
zHwHS;sT*ZbII7MBnP@P+ow2SKNU)>yyb0L?${)ie73&%$a&lvxcIw_KS~@&nLRi5a
zvXW>rS70z~Pov*gyZEZ(SL5itl=)^-^ni`om&E8tmVaIj_#65$-fJ_Z*HkU`$4<8-
zjwNY#7d=B7)hiN_V_9!)4h!rQIAo1KWXPGw#d9Q8#aD%yz_xq9am<!Dq>*ozRIZRn
zPW1=F$7T<G7Kv-i*P7o-#oNm6J1*fW2IEjl^o6wwTcHzUv9o=C9s`x<*`n>0Oqe)t
zqf&OVx_on{-gayxo172TfhGO=2xwW-+8ye0%(%QZ^x_zJSx$n=_I&f`1l&EoCCpxw
zN3O0XEuX18olT5j?nfwIxj0TIRDk&_Mn0!UvGUy3p}qg{!qYq*D8}*bk8(nP;QxBW
zatbc*Qnjr=zESByK8m~-z3dGkkPV@utGEvPmxzv(&lR6fy#=4NYek%nkQ;<xwj%D`
z1z{KTv2{Xf9z`_dL?l0@+TQxXqW6-TH-Na^v`RK0L02|koZ0X{w)MpwGh&{uJ`%#Y
zCTo7-!ELot%1b+IR$BOuHC5#3&|FI|K&{!39txa`oJl-AouHnn!Yu~1I>{pLODjPS
z|2e<Vu#^o6(`E%X`t>}Xu1OElix<h*M&(s@ypxD@i2ltm9XS4vVd5E*e{fquhyH*%
zZ;$4RQFz|Dg|VF^ZO)Yl$MD1c8#VoOhV0yuy5^d?m=W^wY|{Sw-8rt^gCU#>ZG-(K
z)_W(FGK0>@qzKvDCHtH8oG!|TGY6A-70iJpQ1C_zWJ}K^+zc&L%dSe@4fT8p1C&E7
zl7Y{!BtFpV#(2C@_Ila5wNUG?GUe#x)NRxEwoeg3Ce!*u^QsFi7BbT!IylW2C1JiF
zgkyDG`CE4c(I7<Uedj`T{%logf&oCE-tDkH(W~-jBV1GC$}X(6UYRuK|LZN4&TBKL
zQ$s8<J(yWvtPUS@>puP*=`i|`h?Md@h_3I-eJ{+2+POEVWH#yW>fuMDpA>617H(b!
zFPd8RS;sx`4oGgH!_7=I9K#1s*<?9X#4bXgWNNeXu=C_<5r~t(zs2G>6<Fc<jfKVc
zpyBY3=g;0fXyCiLLb6={{`Nu8EceX9?yN3th)y<=>5a>c+oY@ep6t+R+JAW|!>49l
z;mN4pdEcZk^gfDf4mhXaG(D-R1T5ZZycG_*@qB)FF#V2_<wKp_!f_As&n4@W25=J4
zpM1skf5sF$SUz21!1|zn-Th8R>wo7SzH-M9_&?$!k5ZSiwV+lEVKoAfwl$Ai+zB0Z
zoya29=ZBDduB-Y)+Sq#J!2K+Hft|$1T}&zl;k=2<B+l47?*<Vm7Kb4qTAuD1^`Agi
z4!CMW@tH`d%|Yn+V*fN!PhyKvB*LJ|Pgw#`sfV-LFI_Xq^x{n!T3Q<pp<FVpD^yG?
z$MR+!4vySNA7A-;@U7FKUFMJ`HtXij1Dn@Nn{OjzqY0RX#rliHnhcXR_Az{5n$5&j
z0<seNCqMy-rgPfr(K=@KQA7Ou$2*K8S*42w?p;NLW+!=mvLip42^+M*Z$|DPZxUgX
zUBBZq9Br>{(Z7z`;Ai-LfV$&cv*t-1)~TGe?M};^<AHL=pf$zEo}NiC&BosNvDhCF
z$is^SJ&EH0znXZ&E4w_jt^7C~PwPOdljE9!U1~XGbJu7|(_begIkb*V?Ms$;gllt}
z<HgcL!P4<kOlmK>PGD#{8nwoigikse{j-=mVf{);?Wt(D{)Lr!gHiXSD#f-GR+6uD
zOmCv~SjCIUVV0J}Wd-UG?k!m{F8j8Xy72A$4p<hyw0f(YBjl39Gp$mtiKsYoE&c37
zQ(SmT?{z}!xwYllql`F=B|gRYtyzy7wF;3ZjN%1e46n^P*Cr>|*9^q*yH2+IWN1Yu
z+?a0+3IJi^wNu~x0*_e>V;cw5O5#F0#59zl?*|m8A2aiQ`rAr$v$<ygN|O5=ZTDxz
z?rl<6IiO5M1rPlSI<q`8mz<GWJMBCA5xQe{(+kpUFLq(3`dn_XyKQ1OTa#(XM>F`m
zM8+D@wXs&c@Iv`!k&G=WxBE+(V)ITg;^ZhVTCiCprNpJ(dlDbYZNcvaK<5^z!^!MA
zLuuN@G%tQjMzdRMO7d&S<%H2Fu~G@;{(?*`F=!}N0~G+(e>~7|SUGP4S$QZIgEfgj
zYZm_fm|Poaj`#MYMKP}lQqo6OL(Va-#>=-qCvB&q4Z~dX?!ZNf#;N8dpH6(|L|UQe
zC1cchwPWmve->^3{rwFmet-X|+@V}_2-n<M+)1U0*D}QV5p>A=?KfNPqbjN)%v+)f
zEA*ODSuz)8x!U`)?*qUBH|>AFniv|^9+UjQu1Ckx>o?G%f2=*Nb-OL^T>0`9bM8=<
zpucm_M#O;^e=q+4ng-2t8k@BM`!b;xoBqq|@V0<wmrTlg*gAG3aFo1{a~ND{8r}2R
z?~j%j#cFA<LqkKC+TT<!Ty1wUJ61=%`@EPmdhpeN#0<i~s0*`tcb6sl2U|5Gv39-B
z7EM){H`gNj{?Z>OrCw$$2c4i7<*<^eShzAd8s>S~`u=p-)`-KF@0z_)e?7)_)(-8q
zR-W`+?}@9nv9{5T;iYUvKU6hiz5A7y8oyj6h^RQ~{neWoGu<Yg)Aj2=b{KPY(?7`A
zj+V9C$>oUO-sL%UbLoNb&a1t@peT^S-8I_Z=COok)a=3$Nb3Iex^JAgjA-q5a&dOw
z&f|9WM};4F^tb&l=`r9Psu542Pjf?;ckQMMXO@~vZbdA~+PmcL)hySUfOY@qcvGDv
z-G07P=12d5N8k6sD!jW;X(A4p+)5*#Cw(oI50jZGRkZZnCkvQ?RueLDWcRPpFZ^Z*
zEe2kQWR^s*r)B+vPo2sv!oqwHgO{+KTC|<9LY53}E$Hu`N;Z2yl;1Z)Rkp+#-7Wuv
zW!n`(LL@nFDV=#O9{PG8u`c}{hd=42hV6k{S`v9Dd;S-9?-|wf+I@@q>Q=U*peP7}
zU;z~oklw)ts3-_X3r(rgi_#&W*yw^3k)|M>5PENl^xk`s-g_v4kh4N?tNXn7f9@Ff
z!x`i9!GTHm<>}8_bImoEFRF^y%i-+z!hguQIRwZzaO@t6Ism5I1dVIRd`(*5PU3G!
z(dqoC@nhE*#o_?3tRBf>HN;%$D~+<YeY&J+r<cnQp8aLe?hL6ku)R8vh`dDESeFrB
zCANgWM3pRL<I6p!GDwZvSW~nc%1rV|It+?4?zM<_T{bY%DHOg-Z`6P0?5%&zDeLph
z$ZFR_A?bVDrjmWD9-QljwA_+<x?V~Cm@%)TH&%Xm;e;d_DTm9Mk)qksN%<+3?eR3j
z&Zh-e-r@Ib$eY5B4>@`KhSs5<@vcDvl&;(@j|Syj8K!@A03s^NT>lqdLs(t^JN2JX
z)E+(v0+%$`LOAQY+^>%QMd&COguaeS{Ti*~gdK1{k*!v2R^o5F*S|i!Gb~YxjNd>0
z|KK%;u}rNuWEk9*;p~7|gRpL;D~SWhoQwjV3d(^?G5&1oQ+`aOWVG#=cGT&yGQ_uU
ztB?fK0a#^KxJaTsA86Q&AEI)MR!AhjAic$TcDl_s1QI+;KeRip$f9JU?CAjcEYKVu
zT2GgxQ2!0v%(VRDfd0mXrUbZ#b^a<)<&DCd$Fm2hikGVKI?+Kv`XE9J0y_^9T2)0w
zt8^G0R+G-2O|K>Q1yx|sWtYZW2n1~L6i+o&gpGm9jp5<poae}8D($UC^uWvVaPrE|
z?s$8w?{K~~8=0sBBga4CA9KF$ipoFQaRUh8v}c#=o#*Foo6ZEAA#()0PiVtkSPy>a
zmBfef>p)x1Sd<FlZAWX~DVL9x-l$>!&uhsr{#0S$p>nFmH9}E~x;7cePIGFCH0#cY
zfBz2SO_z&EH*8x2L=hA+%9ch4phoZm2>`MV=bN*6)9t(S<=0~JYOl_PxWq585Hu1R
zoaY&q?9WPCB14NeevI+Uc`Bd~a_uKrvE{hUv#;YNeQpdmpfhSAh57ES??~Lkt~9e6
z0+tDR2_beNW8ZBG&r2q^xp!C2_6RA6Pt6bX7l;;Fj8NY`_fM`ITvUqne_SW#$%?|w
zX^R^c+Z>~}JtSmO6%QW?i|v1vWfEc<9so0Y&*=`p8`>FPPYdbANlvm9DpL$#tVz7p
zRJA)n7G}Qk(RjUA-881F(4ifmG40~GCSUCbzQ?zQJQM-_?#@C%Rh<DACEk#Z&M3p~
zPoHE#-_<`LN^-5h-m0c4>Z>KSQM;#&z3#2=+W;0%>7T*jdLl#%n^Qo{>!t9*P}va}
z(qMt7j{rf3lmsp1;oo+u7xqK<4g?mONU4oJd|D-nsa|WQhF!JhMQ^Sqw~PTnL?mf(
zIWgLc;P`n0tEJBTp!PktdHei*lF2AYtc1db@4mt+{?IYKyjXEWH<<2&-Cd9K6`&XB
z-JMyJXk*z{+#QMB1H~ya9*?#qs@@IqcD!IBtJ!kdS+6EA_kM_=Wt8P8MLnv(Lfhfh
zA@MdK(!K|WG}RhJ{IERu&4FdkBE33WtFLhr?WlO<bBEs+=hQyA9eXwniBgW2vruV_
zlcikt4+OKl>f_diX1m100EJ>C)AG=h<GaHig{C}tg_`X=v)p>9NPc&LMub`M?Bukn
z&eBNH7&EIko$J&IslY2xzu{AFp@YrZ%Y#mSOv`};*RWV_Gp!4pgex}e8oi*Mi7G5O
z7jpZi%EUV8=T%odTAO32Mvl&XdsPZ$O2eH+mr<%h89WJ!{-~<;4;&GYxg>r%A><!M
zyg6T1h1%~{&tKCW?q)^79aL>n!Lb>h)J^x>0hjJyxKzPz?=f$`IegxEF83Y?K6OAe
z=X-%(x#xC;54&ormN6Vq@0pfYmzMmGEguNG9oo<j&aUqBEBSy=A-AT{Jyo`_+>Opp
zcgXnpg0~CuoCsX?^L=7jA}UmZMNn0W!C2M`y?v??{Nk!XuxK-nDX{1@gkuQC?vXsZ
zU&oTRL+u|sAO(qvE8^r{o!^UtaGi<lKq?JdauP;+b-mTy{uSwXPmu_g!R^^O3sDF4
zJZ|6pM@~KD^&~`ls4%$blkBDs&W8z#BgYL3?J1A2T$GtJa!9-K%uyG%h3*JoxYI#i
zbY1EPgshD}dByE0Hog9%J<IE^Is_v^2Zu<#?YosWNQi00X2ea8r0F*#c%5JiZCKT@
ziEi*c?*V7{q_YP{(ex}CU2fJGL<%-Hvy}$M5TCB~JFMNPWeJlCt@u>btFUTH?en%1
z=$1bBOb7soKRW~N?o$=&fdDuxTlmo6K?Z$=#cfpc5Vd}yr~S*ZUsl(@J=G*l;4>(z
zP(4g|*ee_z4TyLeL8Q0)E%y3X%h7%g_CRA$>Y}njg|`sfB>~#ruuY)#mu-MnV5~8z
zHYEHSiWyhF_)(hwF_u&3HjBJekarWBj<+_aS&gdPMi<0E9i2R=LEn)zQ@7Q<>9-y7
zU)I=gIVNzwLGzb9fNJg9>8*Z*O+^>2M+Wfn8!Ic(-0}T3K3~ii%%GKga5%qzuEf{K
z2*ig7IDdD2b--|~2Q09P2hn%$s5EAq(Uz{4zWGduDzvtvT3T<nCHS&nOd{NK33CXv
zIUSwGPd-OjjsRxD`^&odHwLL(tXN>F`xHDs-8z8NYSaD7Jc@l)WMmqmBwaJVLfFa9
z!J#YCsCcHS?d77nnayBjCJzF23CQUPPJ-&dtmKj7e*8Yyr6s9a6BO#NZZ9{Gw!OEW
z?N;Pz&R>I|0bn1vv^V58r`r;r5EmGJ`?T(tXOqt8b6(K0|HF{^{b!$G)kgrrwzigU
zl(tT`umHjPLb^#$JI_53w7gahp$w>;ruD%+>w@RJy`*=q8jD785i5}S_95}Ov@y)$
z{m=^Y!IHfKGbflGrNa=P8Rh{G{y|N~K<4)}2-0lxC2!3H`NHv{21AQc2VqyY0Jv2Z
ziwCLcgb~FykkB9X+f8Kb^XC-^QBp|+w;wHsxZbcTi}hr)4jd1!x0a+_5X%dXp8!~=
zqmuV59%>6=d(1paOV>^dW$8c-IM7CYw<s6gp9i6-$2B(dbAc8Zvi3OH01%f{%SmCo
zVvH76Qy15dgT){k2r`l(P<IAoMk{J!j5#!&<Cof$ObDUT?SnU+v;+>!c1^d&e`cK`
zA?rw@!H-8wJL9aH^drPIzI}kB1#%Fkvsa-+N9!bzX12>tM!cs5=?z+ldgRJRl^<t{
z8)g}$)4ghE8G*zJR-O$L%p3w(<oJaZ8iBO@tk(#R?%#Ynr#VB=H+ys+y6(-Wk*SsO
znjD`kOG-YlR(2BQ=;%k&&L}ko!VO0NLpSM98|g26H`gb2&-dKY3jwY!s~hbVmLs4f
z-G+v1%rDDiy4tqdzl!|yA?|wyzRP}~q3)~`-b_)$@uZ<2*0_2;uR_O3!=<shT!*zQ
z%LiibPb)#-MJ1F~bqwO0;KS>EdnuY$bmzUHG&+=Xl*Q_7ltxR;yaDN-6PF?L;7?x{
zQbqYzYsJLs2Yf5<E|=DUQVJF_i6iT}(i4w(;McWhAt)<kWjHaeB()vNzbLhQ>M5wu
z@jI-3BHVLPjD2}LFqulXE0Y!$oW{z$(LSS<>}txfnlLYVrEI1H{qc(QLRsIhMvKSj
ze04isQzwsrsVe1y4R=U@6d<~N2c99)^&A1(Uv7`|%DbAX-#|6ST%iP*gwyuc<1`z$
zE!3;m_3{JZ36SA<PvDV?Hu96uZ#Nmi6<{sOJZF(842W{OD!STv?~4}_!TMpUcj*3M
z1rZ$}AgDDFur-KDx3KAe86%ab$WXcIJlD(KpMP?w_wLZMU)Rl!hZ(Mb$^k(HOu&cl
zf_9V9CtGQeK(K;?aC&m`Y&OKKVaU{Dl`dQj;ln@Lt{A@X%T%lzmh*;?4wFbCqG_PG
zaCLR>_gmXxAMlGgcYb|IloR*VA2AW(L?F71G1Lad9Mk$+i3K99L@L)Dh$Xm0!?S#k
zQaJqj`<+GtQ|~uFis%~ue|arq>cvs5x__3tDbT-MqJxDF-*_ASD`a($aP{fUUH$uP
z;4e4x0<=u|qoVo;=Wef~ONamEZ3E5lEzkek*Otvt{H7HDIIv`dCld&U?VhXM{<RIt
zNTlzDblPXZeMSof24bRp_@9-J9~~ns2`?BZqp<;L4h0pbvP&u-(y@M*PxG#wa(dR*
z{x-#YIB}OEcWnrm<s}5NW2#<8hu+9q1R37cw4&%KOLp*@W!?U&yHhOXE+e|_lm>Q8
zBPolSM~L%rCKYD-k-?7dEYs?a9e^Td`ip$;6`#=*U|mgX;BYcBr4xMYXaa?}2|u@u
z|LMU!&&;9sc-qB<_CBeQwVw0mJkch^5AAXL<-uB{C~_Bl(bmsqm=nV^1PGOy_3}#Z
zav^Qo|9O}vi(#2+MZIB&y85T8{;ZqQb;`);37TQS-6uBeC3w&TpEwuNG9tklsPxjV
z2sG~Ba<#j@ci0`VIG5`o<}7M@GdSxxbB$q7(3Sd!2Ad=zK8Hg#*0T2b%!ynTg(C2T
zpAzStr6975NVUgsLL7G`UI{&PF@pP}XyE|FSUJ(zH)<=A<kH9T$I1?RW}(A`oVgqB
z&JB>q%SC^=5(l9?JKjJ-WSkxYp4k{Ph5qVHaG0pmM{$oL-<~(*Bur9c5WK4{xN_D)
z92MvGx3jHP!w>C&`T<#VNAt;qX_yP0=ypnskdSlOA_uWmd(=D$3zR8EQTUlfTPsc;
zYeLWLTy3)ag8x0QiQ%kM`5E2n5h$GL_O{au*_wX;UPUMbewK&+lIT&IZqKYs_j^V9
zCUJj*SVWgFtrV2c7$24G$(G@h@$Gy%*E@AZg%cud8k-eei9r!QGHLJLsf?9LS43w<
zehq7J4iC=P!(Tk#QPk)7S^r?yWEDdo^~v37GUu3W(fcDl_H`0rG2S((C692xB*yrF
zl8Bwf71>OXiyJUJf08XpHDe+qO?N=iOcV}%9<iyea>v?a4@H(3nTWCe!lTPCz>`kc
z4^HR4y%Mz_nxH<<k+FFG;rW3gtun2itXu;om3X<u+Ta$=q5>7#gQPvGU|~Xhwzrs}
zZov2H2D_1X;hXGv_1=`V?Pw!FpNT(gF`_e>kT#KWVcf7Rm?S2edZ9?E*pTM6;{)3p
z9`0P-0Ux$x10P%I+$z^?-+K3fLSB4rLiPzbcCDKY2?_%t4C{xFw{Ya2OJj#v4oHYr
z(?bKP^}t&hoSnrCc{FqlX|h~k6n7s95@FMz+o1e37dTo|{QfBe=a=-yj^K>zI6}h3
z*c<*JeFc{Cj?Bh^bpb-*c=#ENUymhJLV0vwy478%;XtBvlMNySNqgXMH}`FEQ>C!3
z>pULbn(5S1;y@?ibKVZp%>p|YyZH7k?)vp8!Dn%rsamOdRxB&i9Y0nk1F-wwU%+72
z%$$e5TjB;k@(k;mgGwd#D{wWc2ML;|s}S-SU4=VvbQK)vtu4b1EY-$LdLTgX8u+6Q
zNfk*lp%w9wvuk5@v!$=CaD)2>K!VjMJ&oPW3{AKg>5V$r%#cZ*&f9iUJ?}Gzz#9WH
zMR)GgVaW8VQ~~`6^Z9;(u?oX+BYL+<8h$&=+$32Z{U`~Akt|TI*x$W(Lp4M=*9?aZ
z7)iC<17WMHfw=OFlL71D;xnr9D!G=S#tVgOcWX4=uYg`(;*V2}{658w8<BvnIOBAC
zx4~#=5D8+|uQ#?Vy*jE!A&y#Ks4s-Av)3=EOF65LT~m6?sE?k8gKhVE8Kg!9{2Av8
zjidCq@4YoAKVV>zaYHu3P_|BMk=dk{+><v|2?W<Lfhy$W<g=s~fx9I?+5AeUv8IL#
zLgxglt_OHcAj90z9VKXOe8zPj2{LKmp&Nx+^&==`jB%ZMbCBeSyIMTb$Q+8!c%4#c
z>c@VUVlOm@Xag=vOH7Ya(pz49)}||M9^fnS*;LhR=i)VmHuuk;mvwq8E_Ok_G;%R!
zWHx&lLS)vPtCLw5jmm%lQGMI}glL+P$|o}I(Q1n^+?2Cwldt}x;qodhv+h{!bHi11
zaXTSqL<lrvfuC4)L}0z7#CHr=UUZVOqTw6h!~<{9X2*CyY}Ziblj(Hv0p9vyJg{1p
z(6ZsyxWG(qQ?)iKtE*$o7yT|7LZqM`&D!huT+(9p$w~VlHO<Jjh6tbh6fMd1I-znB
z;`-h5wo5F+Y=<)i23N6~+H4ydf&H4f(!o4+epuyATL4d5^OpHjE%XE#{ow~@*TGj#
zlT^nm0l6ht6@_4)wM>OZ!V$W#vZ9u48hHxLY0o5P)m0M{pxNbWP{rLp4a_~SM7AkF
z=6V=TJ|rBcf>za^Z{~xNrfoxb*VLxCq~}D8SVE^y*W7|dLL6?a0dE;DEC9fa<<iI!
z_&EmYfEUmL4MsKae&~8MZ*+JluwmwU_&Qc~P@SJ|;&_b8#ehI&3QVKr<wPb@@cTZj
z84)N_2j==n0XutTc<ti-DVA)eY_s_c$*|0++1H0BuVm}$Ot%{V=mE;0(gO<uX@rqJ
zSC6V%^k-S~W}Uit+4Y44umS9@|LDul=QG>Bo{wnq9gYBU#ubpii`k~mI1H4;TI7bV
z(X#*XJ0~(DDUi$cuPB9(+r~54AqLhJwhgng2^B4qA7dnW&YKl}s2?3>Gz`1U{lPo`
zaztOkEXd!u2nVpDj-1rf&vDT+t-PQI`;oy^dWNzO%0afNHUg9~ItM3P%`8F9sJQ5U
zG30V3b839KjkH=@oehH(ZtLKno}Z=QbuV}+;L0VC_SxD1R%zQHaNW|@ApJ5SKjD)f
z6l7894upb2xrd?j*v(=gtJ<Y&ngiz$pjRBjYQDg)(29hj(H4`<61W_9MHWa_Or5Pt
z&HytwD^8<PjpY=<>{WTk+H;%~*kY&c4n*Qi#I4$2k&0O`MNI9*bUYC(I(bt|z=J;<
z#3V+@&vk2U2kF_&tcz`4S=!XwT=m-4>QzZUP-R^AasFd$=<Ra}lo<N{qP33hcbeFH
zoeyG6Tx1Mpue4K{nyMWluGqmlQ`+~4(OR&=bb6kkk!{s7Mn<N`GarUFNkf?(a2DJk
zzZC#Xds4Y0ihu%*u7WTe-xVQ{GelTJ)RRXp*YaR4?a`|@`cNv%eNYY7r1R*;{%{^c
ze+Abx`P}LG0gXO|{cWxB+gMie)7|0+X!(*87#>y_zY|*X=mvUH%eHOt*RN4WJQOkz
zi%?gaUKX6!$39r5Vz^+&>O$mAD^yrOzWs*EyR$bDxJN)kJKt~(*gAsK8iiXcu2UTh
zJ(-D#Ui?4DryXo{8c=NxI^5G*;X6zSX6Fhy+A1xV&idfRDOnUtghy{t7@*?TCi-2a
zLT-?6$aFm{8ivD?TYA@uv-SHo;RQ4$&MUD{h0LsF03wTY47Mlj&a?X1t1uwjh1Mil
z23;dZW1nIcg{3;ai0Zy}lu^wr@IRvO1s5Q3cYplY1i|R@4u?s5ScX{<t?zh>w<tc*
zYbAFvmcEhH(4;m&QMYjP3_lHBrCv=GPo!j;syNlgemy~Ix|J=GpwFw!XE786$gFYW
zCrh|SJGCy2)czU>keej%d!>Lyth?Y!?ikkT(HEco*4k*Q^CJ%zRUww&atn0G1M`8O
zdsR#=O{+{f*l8N2R3|UZc<?7`vS+Al^~0aErUBTZprpZ_vD$()DFgGVCMhUr+>5qn
zG#N|P@&rvu;3D2*RTq@#6S34u?RA1s#E7-|!joJPs1TQ{4%E2ZLX)1Al$1gMwj5?N
z)w-$ZuEfn)oK6=JtuXL;T#Nu>8X%y?vc=ynWruLbkNx-oQbCsa@jDb4aOC|it^r^a
zt5;`JydJ4g;eEuI?1bgmF^9v1HK4UP<g2e9bMLHJG2-=v13$^y(2B~fd>$*~(}JxX
z>|Ebr`debWXD!l=q#rb10-EH*kasyIsP*wFb!Rgi^SLX%{JTaRqt$;oKm7PAvKOY5
z>TD3SPh&6nS_HF-GGQ4axGt``LpG&5HXJI4$yu&>up?*!U%i^etgfbssIZR$<;s&z
zn7T2cjfB$yT;$DRy?XEs^SaS85$)afB&3&t$z<#^ZXuDc$%;iRE{)a^qAH8vltTey
zjpSY-LrBg-;+@QL3Be4YaJ9^oFJV4g(BH|}={D@~gmFc&C*H0O7T7D1eFy^ja%;PF
zr^f_aD`~PHcXQcaXXrb-ZaeU5?W*0N+c`0h<OQZbwT@;fPTN0g4V@<Orcv6xz3%w`
zYsr6gLs(P<KZ@9HQ%H|1){`|&l;$XNS+fa0!Yg*Q`@3AzY$r!)OG`^kA{x7Da^5CU
zfkjt2*JhrMW^Hvf&&ucxZ)d#xO&U7RFHeE+3wmt{2V_E(*<7RV7DlrPkwO#$Ws~wL
zt-`+c@}gk<leI+P?sYSCXaoG5J&AnK_<$vWom4$*Mrc-+jEXqpE(w%yiA<8bIpU$F
z0?-KVlK|OV*(7nH!v>3T9y?+&vJU#Gj3A8U*dfeBu;)01Ox4WbO0j4`G?|JuYS&Kf
zy`Rw%^p`#=FL5#GqO-E)_(MM-$Ydq_T&wuk9vHlZx)gj$P=&{1lBDCZ@MrNdn%NPV
zT$CUf(C3^<n!bL2*o4v$5tRx&%-NPP>Cin0F%vM*0I_5cJQ1gP#YjiD^mPEnwI<N%
zqANifO{^G~70VkAQ8Tb3!G<R=^pJ(F`vXMAwA(4r!=Bc~h{KsfFZTNm9Ac4+zWcd|
zy4^H^60VQ4Hu|*_Xc0q#9nA>N4wf}!&4@m=V&O31j;&ic?i$2qa_{|x08g2ab{R3#
zx4X-uyUc?YXsXPvKn!d`6Ane^g-0@gaE!!zgR>OwwAS|xxR$XpXl@ySV|*w|hJ5G6
zso-3r)r?a)ThR!tyG2=z)oRvhOY5(BBtd9ehTU_L(ehuL=C5(69$ugRb*kq9hM6}y
zbGQREFWi%XXS2OMtANOeTf|Q1wh8(47CDRED%Mc{`@?z3ECy#f^OYwHgouKdrw+h&
zwZRJ504N%8*Y}&G3FysGcIRN-M4Nz0h9hjA{C$~`aD33rA~UHC%kph(Vx>;z+Bo$<
z)o#_SBxW1ne?lGWc^8*sbsrUEf;n>q#{lhZ!d_iQ)}3Fa4*!ppHG9E3U9cS?n_**f
z{=T7OeJEkhG&I8Dh*c}J-$EC&Au^{NHiU54Y3s#4j~4x7v+ay6F_`6rg?Eby3R2Y;
zY?|9)#<}2+0Rg?e9S&H6D>pB@1dt?zN_aIRr=Il|D7NN1ZEd-^d04m47xHV1&l;#~
zAol(A+Ryl=|BEZjug;P{mzQHWwatv<_3;-Q&9b{5Dl6`L9gtP<Hj1J4*0O!o;MWMy
z%Y`H&U@3#v8!tKu{O;N!uz0aw%RJ7r+aHHAGOa#B8V>~ISh`P(5_VVF1D3mNYRaH#
zcxYBm9M0FR<p#{ga&gk^N}G~qcdB;zNzDv78wbpid`;~pk58wz?SW*?0Y%tmCMU5B
zDu>DF!?^T$P3{`>WSKhdp0fd9ap*#3Lr=`Y;+@qNnPrU8knr}?am85aur$-YL$AHo
zfZADFdXudA>KuS>QIE4V`)o!kQ-W15J1;HkYkQ^dZo6}_P8TNsfXEnA6z|#AhpJdX
zi=FDj)lD??Dl?5#_wAFE4qYFGP$oH@@*|B;mT<myeX?c^yG!5=pD$fg2EI1pz>$-Z
z1isS&ApORHwc$8k&xU)HVKKrV)rY3)QVP{f*ckjuU%Gr@JV&Q08$3mIfG2I&MQQBT
zuX3Mx^qpMH5oJ<Wpt<~3<hA~_b0O-fS~GA@QC*=%ZY=5H{AZlN-2m2ZjT^hhmY1=j
z*z~$asF25pteA7oMqti>Y-KjQ-o=RlD{_n{m7!Q9A!}t}K^bb7@LH}sF$W}AH9Og)
z|6|K9EO7@F0zSaGvu<q1j%`l2GUFlVMIpdpbG07GkIZWP5$Erx4}Vs4M0`u`OA~X{
zq1#OdP6DXZC0dq+V(1nDh5@(+6of}s!$s1i{B2vztMtCzM6GAMw5BV%q`nb`afk@b
zTbbLCD&NiQE#dqLG)YT370+R&dmtM^JN*8mILe4X)Vx(o_`NDPHOW@7+s!eJZx`N_
zM-%6*gbTz7cX2iNY-GMZUQmF^)?v2cMYDfPxN<J*`HL4wYLXUrZ`qRcYrlP7{p`7|
zAJO+elQ=jP=UqEKOB0x6U-;uIdpWJr?g4`*WE=<XB8n4+HVvAB0#=jt*us<1EbI--
z7Y4}6DR*1q3`wv%LqNbZxAkYp8E}P|i*6RXuJ5`T0r()~MJLhx3Z@Y#Oc}RiSpqL(
z6rsey+H8nXICehWsG}CD`&D_BzHudh%qNd7J-mT>qM~$zY(QW+$l?U?D{o&VG%gSv
zL_BWZ&hBJ)kyD=ClvsUt=5e_%3k3JQSJc|r4VVvruh-T5eaAMAlGVuS`Guvmw3r9!
zH#KF7^5)-K>_U|0R0IT1>Jii-7)prWj9uvwmfQC48QU+zL={izylDdBt?^>mxIkV`
zh@wH{3M4{5o;>bX@_+>)|J^l3-K*&E-RVT!e%2aUZOzTk&Zr~4%)^Gnrk)WcOz_8+
z%po|O%VIKCr<Cq9(D+&aI#zxtQww7ILuI5o5RL_kN%tURb#Sf&nlnjq(C+eQ#f-GK
zDGSBzvj;&)MWy~@_rSvkA1#Gw9WCtJ6H*fSyvT{)v4?JFZXwdIPyZoMt7KCHmk`aM
zmbmbeic&v=g|mr$xlxc%hu8>t`-avlLPej)mWQ>=9rdU+)Ab5G*QPtZZh=BFg<;wE
zq3-RdH(RkuPWid3N?DEhBQVny6(pyEc4srS86of|;s(|VAZ{bFVUhD0yg1&&)ENfv
z+@VH%RG}f&uvOg<Xt;{5mt;Tsss!PGkh?8|qzYQ9Cz(S4qR7WMDr6c~LB3R>O8OLR
z-PVFk;NV}lHz6M-(RJgM#xjN#IQFg)$d72vK_G54pxfDt|C%5frPeWDnFz;zHR{N!
z9*mO}8L@`iZ3Tse$r^o;nvZ<)+&Lt@jp5QqE<Eyi4E2#;A~>3I9p;7>7oWokNHHjn
z*dDTOoz+#_-5=jU1HdI(K$e9njBcYZwy351$*V|F1*E4jm4}RhHu6yhRJfE_B74uN
zy96@^!Dks$ZWC<yW3L3t4pfLTU<tGL??4W~VuM)6v{JZ0IxtFubT5N?ly3D2dmN_M
zvZu6EyYgLq_eaydkJW=6n%OO43jndiACb5<({Vt*p6-(Cc}Z(A@bh~K-tP8U#7917
zO+6(vy;=CV?~@N$E@+UO^@#{M_l?eq(Ox9Zy^FFz1Tz2Mlo{vT9E8(a{I;ODla6pr
zN~PJ&fPk?#w3gsEl9T&DPG*GATEh@H2eHzqt5@VRwIIyQsV^<&WM2%_<SHy6nw5~G
z&tOzTFM60&j<NVKfvF7QtF42pvn^0K@1iRpf30t^-EvNnwvcrsa2TVJ?Ti;TDX^Yh
z;$*Afg8apMnTD9>ywMFQkJWWomm5?+#{O;bOF$=oV;6J;ur>CjH0%ph<(I&*8?sWt
z@g_Q6N!((+@A~rft9qm$dNhST#x2?A4$*m#^e^jvgw{ZEb{1@Gc2`11XXR}$b0H9j
za$YASY;1Y)Eyd-p&As{}9oF2^vJ4ULctQc)n!Q%cBMU#&+XewHBv|_ZHRSdcZoc8f
zK%f&7(#8pz=D{e)+_G~&8haBpAv$yHSovAvFy};9MAH$D3HSfqVecn8>_>8e<pL*#
ziEPJ7(3VCl@1;~ANW(o8i%ULc+?$iY+f2ym0m_Z8?K&jFwQhD+y{~Dz4cd=U{Xr!0
z`B0ISP|LDDOsx7-uc9j{)#0H0sUG<do<!3Y9`Dyzz}eFSdT^<*_*=NTo*iF(;}bZV
zl$-uIBAv8dB+p@he>Zkw6DeBlja~0n_=6s6hMK5sb1%E-JTlnk?$?!00)h9ckb7x5
z{a&<6BF`>07D%+Y11#S`PR3xGL|GHyASrR+@PtnP4M>XvH?cl$4jiMAQ8%#dvLzKl
zz;S|FHdr{a2#{pJ+WebJTd=ov>r%C)Myv@~>niNaTGhZL$S%<%rL?d6*>E_`jhs6m
z7%~^vF<slsLq6Zjl}x;MTxc8rb-tV>0070P4+c+6NI+DQiTfGIvr1}+UV_bDI~(Ro
za7Fj)=yaw$NoKCyaf($}!}1)!mCfDkeHu(Ja!5gmiA{}Ptz6g0(g9>_2`d9i5W;!X
ziY2C_otAXkyHB#(7)V<mh--9i81Cqb@++Ny<?i(v!moHRR~w^oUBO+6^!<58YQ%wd
z`6A^c4VlA$oWmk!+Fy~q@~6uh?X~edbsW;Btfu^fY-nNYLBOU}MgTOtP17K4rZjMV
zfP4|SJ@M-KdWNoq`We234&xx_ih)Xbrv1HaP%#=?^Ju=GVLypaAT17S^}qvg#tSz2
z)+UCXY1QkCnw7?c5R3dv{?mrye9z{;jSf_>^{$(4z6xh*9Y9`N;_NX*+S`v+FVJRt
zB@z$2cOzRZgaUCX7cLr>h3UIGVU?8XBDX(^6P&9P`}%`;#z+MHAWV`qi4~?KF)D+E
zhU(iJOX5d*{7I^9mqtW^OwfKH-v<BS0C3Xup~Mk*<Aw{pxow=vUv6)Y)eQvEcJqN9
zDtLdcXidYQ6qF}ELfm}$#98S#h^DZ<&E+LHh(jEOuB>3QHHAft0xV7wH=1AI?nbkW
zRP?_$fOj>dY9UWnAVx{5A}m#{+_}i_afvZ@gB8vS=`F|+0#Hv|4>1LdD_Og{etpu?
z;+?U{NkS~&<mx#sXRlMfN*u@)Syo(WM{?L1*QpxWi}xm?yv7^wX+W?91Alq6Ci;k|
zBlSmsV8JgGvp<nA@b)eNP`?S5yFT&sz0q52i~0VgEQIA5VnShP%(vyI5y!}iU>X0z
zgyvUb>5fWPxx&q{MD)k33X<iChJ03os8Q~-$q!&eSkLt;_nS0FOF<<56poVw3MN4>
zbgu%J64DHNpr+?g*}y~KI!fq}f`8eHE^roOgr$@fH?M{R%)Hw++w^{0h{iyXjHAyq
zcoBYI38j%qn82T0Sy}>N{uhr!-~9!YA^XQlW~bf|NBGz5$3oGNn<tg-_lZRhjQK9b
z_VTj76@e3gz(woc^t1&eZ>8f@0>1`y2FbtyjyBc=_#^F&@(Ha;8_Bf<MNY9CfV41i
zgbSJh$`)w9K5UTqklCQ~He}Hh6bKVs1?r28&wrWPkiwVs2iEnj1QbO_8b6l+0}}Gq
zyR*$qfyKG}0-Tu$Ac<__j^YLZ_|k1OKN1P9Mn7B%bx_#@GqsrN$TtamDi|Dgvv%^=
zZ|2`$ceBI6&Ka${3KU6Ric^B@DxC8&VkV{<_ipcn$oTlJmttFD`F;FEAlBu(3*pvR
z`K);FmO)>hH8kGmwCcHRw0aMAsfJxK?g2NDWbByE9t5I8=u>P3WsPO)`o^+F2RS`o
zJ#jOYbQ3Ljt%4<p*a1uig=-kIp@xWhp?xrfygmjU^ILep@=f3@E7kySt9bH>rOt$p
zO@li3ZfwYfY1cl!XgS?Zwy|6vrtU-k>ZAUS1^BXsZC;qV+u)XY;AQ+4%hIKyRJAwn
z<zJL0_i?fjT@aUmopgX*`<n5=t@Tn;7V8<qX1=R!`BMXOa0CcVIU?E2hod$hm$wlY
zLCT)r%=@>oqd&qNV)c`I<)W8wped#p+9Fpd0d>$)BZgR9^a;tc1TTkR;t$2=<2wSh
zwW*R=rY_=>0n#!ICB_0u(g~DPVz57s@`qrycUa-}@_e~0@k@n`{$URMMq~Rwy+&oB
zx0;Y*l<gTse2V#h2u+VsIQjCZ5j>`$5n`Dm438hVbLNL2tt^H`hq;L#48KhH;6D_K
z@Xv{x-p29Wx)4Ujpe^j?x{Jv^BG<N<eu4tRM+i-+>wSFm#uZTL7k&zpB-}gyW|X~6
z4u9dKeLyFouxI1b{bP@R{Pe<Z6Nb^vvw)+j=Y7GQD%F63$5lOn1$G8y2VC^a#PPKM
z;jcEu8})?~e1zK?5*QDu@I?Dh6(2&1!#R_Q`adr6uz(mjL1m67cf$F+%le^w`{hm>
z()I$(XY2d3SPIk}-l{BzjM%9~pi`Xjh3%A7we$GdsiO0rPrqTmtN9p^qU{D#zFjE&
zO!&@YgV@vs9oH9DXM2=T2+9*DxPhI;;Jjr4?Ypnxwq)<G6kWhON_iPAZ<l#Wv!uj%
zuBniOk1Xt}H__lfvrT*qyXH1-ZD4J#j|FO=1+tR<{Wnxzs=v3V;bQ^CDCQFSuANCW
z%R`OWB}1MfmtC8h5di~A5e#|N5u#4m!LP1REeTPK#HH!hym;|q>_4{cBLSDtl6DH!
zM)De;mjnZp5*PRHQX$SX5%i!cdkgI3`$K?dXJhxiJJTqr0OEC-m#ItAFQ9MPiBu=b
zX@o2t3h0P0KzOk~D(U`~yyQca?>Zx~^WC5erBUR#u?2VwetYw)D+%-<-wA>?d%}6_
zn5w5`H3F8p{gvVhq(|Ef9sjeBYIR|?P<)cb7}bvXmS(d0_V3-*<kAE8{JTnF+l4_0
zjeu}gpiLa4=)*(j-;gti?io~huM}B8KdQitzHj%cditRTs{G{DM~?|$_f_4l{aIRm
zqq#<SUQ4o*?8K3sfNg(UhhD^fg)lOp%>_z-Sj;p*{tN19?*D%nStHVX>*)!;r%EI7
ziPdE#{<>=!r)+0qqspy_>%-J-N5Zc$wFj@3`?P1X@1*SsCEO6!57khwN_&jTRE@|<
z7?g&21(Cley`mP|*L*lUxD+3b4*40kAt!|<`(M@keBK-gHo}wNHbps*OG_UF7TKF_
zzNpul#ky+5<vVzQ_@Es1{_W*t3C%gvF|$x&Tg*W^k@y?o-yv{P|M}k;vj6gyu+uT}
zZ=N@aA95q;PJ*JIKX55*s+Q+Z(_ppNF{<SPJ8!#uC-&2}dexcJ@;T}Q<0aJmb9(K$
z@M4`^m+oCBkzpk>P=;~HdN`R>T?PUA8;F&Bi;0&OgiZnIJVaDR%&ErgtFY#o%x}#9
zGIcV$Z~)f~F>CRi&+Kvg&rVAQ5jOQ(82KQx7ji-JqeFR-$Z=QRE+7|86F+tZSTgY2
zI{QoYTnpQhR;C68h0!7R0;`5vb?x23dZe(^?GoqlCS1z!@IIvxRDOx#Ol2d3R}1ke
ziU8}tZ(AMUe2nkqdp(e2vOAh7gyZa=AB*4h7>|Nf<UjB1*?sHEEbQc6|HTDQa9;N8
zd87`9SIyH7GJ~f1_W5zor^LU)pWXTUlDzHyG_jJ{mA$H|ulkv8B36r?whAnW*USz#
z2|k{ZAry=6?XkXnEln;#t#_DjaP?p{@!J<PVUNH^D4thZrq&HQ*Od7j=oP@6*w!Z+
zcO}<%dVej_V!ZWLA&Mm4Qg*wy13A&R9OUUiY>66N$ne{39n**{ZJz-bXvX=PvJu@?
z8+t1|n&sz|$WZQd=iQ|~L2GN97BrQ8pz<S@tn9i+yW6!yo;Z$-T6|;?y<LN(NPXgr
z=K#lz_*L+)3;#bPJow*R&=>um-x_2~X5iPO+q?5Ab0Yb1kZK!2n^vM|tXd~ywryX{
zPrNdZo+J(_Yv{)!VOX1lA=O|4Sl^a#<LsIrAK(apXUz?L9q52{%t;*jk`uaQtMm*=
zT;R`Dy33kev)uf?q3%_zHYn@(9Mw5=F91oqfuHFkalF5VuUHH@6W8sJxUXPzLVQ+4
zDsxpapY^WCcANs`U89GYhVrd}kHue};?OF)WXO`5z?*vf&Kw?pM>>ptT&MSzX=uo%
zy=cFWsNejWL;Go@UGLg_fBq#-?t8_=O*^QvGj}drd4>4zfr5oWD%Dbsq}-xwArU;B
zaz8)BOzgCs`i4^jR_?UFrG>hiHGX}*6-^x2w_qQ@Z~T0Tn5`Rlp1J$}mW$t-k6?*Q
zY!C5FxTVwi{{8VF<4Xey$i@cZUGm2~LD5;_<KSNx+dtld>gfOTTP`mJgdEy@e{hvD
z2sg{@eAdMu08IGp+TL5jWU9f#g}Q-DiOWcH)8}}+3JObvInOY`eFPtRca_hYzW+hd
zG^doE+t!)lDPkDU<phy3d+nPFYMg2vUBCHUj&05qUsp=1v|_aLHP;Ri$(?6>zcC04
zayrJ?U=3@ojE)vN{vfuQnR=)3F5^oJ-vat(i)H(>Do+xP#CLMUm2!LUKOZL02cY|m
zksII2N@6r8^>+r!<vei<zVr8IS1WK{HNz24X>%Ro*zUAs&+e&5{LdNs|M9Ju^jf*_
zqc{FO`;uR4#krF>9beA0y2ofcI=K_yxCL*V6}9o%KR><g)LD0Q_e-xrZGaYzB9K%*
z`|{`wx^q~unWGUVN3hkiS?5&yxVV%M=g(t^=UxejZ{3%4QmHn?x$ZpkgIKG(oArF_
zD-=dl$+YmuXkPCj!30g>*WYtRG{K%Yxbs++R`-U<$Thuzy<VdSR-U19*5pNx6DRF`
zq#`%C#e~KmtvHl9v`p%}FtPA1Uc*#jL{H7PkUqj~XD7NGlx6uyMkpP3^u}9laopzY
zl6*(9dcMVQImi;v^%rg~{3vZ~Y<&CnZ(M}a)f}6tZ-IFq8*cSE+$-L@Gl~WLFd#Qk
zw+Y`gq%4a^3ax`$zN8EoK6AYS8xGiVFIu?bj~qGDhVOc#e9P&A;kHCgq}XvQ&9(Vb
z)4sOd4Z^-RGZK(Kik<ORY%Lz(6{Do4hN92FQzs`_QQ$4|nfBVQFMQr^5dF?J#U)FE
z-wcl17DwPC+J26Y-|2rnMNxEgexBV~X1+U9YWoX3CSyy%X^qV+S1QHfVuM-yCe#q-
z!4fTlg>w&xgAr3#$VJPBRzE6iHkHbu?QQGGf)9w$y;bf7vYs#bWuSF|!lT2(!_(7*
zky6jMJ}v6F4m!{_bG=RYF5)>j_y8vM4UmQ9nO54pxwtNxm^AkZJw1Y%H1MpgKBdAu
z?Ii?b=9d<=-SBlQmWmZIGCDdsJ<Z~*FyEKI26-9K-NygzY41l?84~xYI*m;#syHdy
zkHyU@#Cs{dmnqE0EN>gTY$+k3yglB`OI5e)ZWhnnyQ4R5-}S;4?_CbZ&H{%Ez6IJn
zKhHo-ZM!njWYm#7iJu`NQ0AA2Gg(R6fJ>*%;@w^uxEN)$zoB}zK+=0jrPzGq@j&Of
zbl@{p+w0!!a-FHjc?z?|%sw?>MjDaU!q86KR_sTKbFg&oxZU9Tx`oDM!Yz>_nh8T~
z@jeYPOyv|D-j(*yxB!t#q>fpd3{Do-&X=U0r<wjW)Dr+pUlzo@>_6Pw{3&tiuNCZq
zc7#iGd3$4dWmX!Au2PyzSNftktXVnOJ(@X{jVX=O*%+dmbmq?Pl4fTlXER=9X}&bo
z6_gpc*6LOsbM=@nuCiYzB2B-mc<~eA?<EL-f1W;FQ74gBxI#&cxXt{?h+Xj8vNM0Y
zoUnCd#BO|}{Y?!Y8!y#Mw}$dELIY+Z^nBq75CYcBDY>xEKmXBFukbbL@D7=s@pSpJ
z+Y!d6H_Q%TDGlh_m;(({9b>bLPC9~$c%TTohkb*Vw&;-nc#2LOW!>O6zX7FDcdXb!
zyIci<Ar2PK88;;Hg0K}O&du$#3ri*K2l^rf%f5NdG&5iBnq=J!imFT<d5e8|26o`!
zXGLzel%BO!Bo@aRbjVUOiM4kMn<ciwvNJg)Pd^b420yNf3NJ7Fa$VGD`eWZBQctGi
z!p?KN3oUwmh;{?Td7L%Fvx%OK8Vk)jay2crc&{1Fjc{>+$VG0LEPgnG?vF|gp2bI^
zqUMeT9lG8p@v1K`arcm-ctt#<?qv0f<$q;y3eaVvEQponrh1OmSQwmY5EgCl6?%hh
z@K!vP%^fhMppv2;Z*h~y@`OMjovgQ!Fb%9KZ^)ugcXOmb8n@ETKT{Z$RtZku-gveB
z^HTcJ8uWd3ZR(8^sTgMO%5gFegzq~YsYfkyOKQuoTD14a)qD%9aSvpR*>*i15^tn;
zD!Wa>n@Q4t_>|0RIO~RABbq|z!isXDt=UJDyAbosoBC{%yI0!F2bzbo2ND@pS+`nA
z8)f*f5TuPSX5*DlWBR1n6&4S^oo0RQ7wzD5s1O%}Mc=0zLQ#$?Tiy~#rt7o4OBM#<
zg{Nbl6P=5$K$QeZ&h-igsKhqoqa7+NGr}9nXZB@esLZNd<;LwL00nF7abwx%97J+$
ztZf!{uYH&Q-h}*ai9)BZ`A-?NH)5qa(4w;VcsJDosIupMsUjeXR)+aH2z(k{E4flt
z=pf{oUKP5qfP=DZjeVzl80Ot9Kp2p<I=E)<aI%(%n%=pry9vETh4%&QJwfxU(BgRh
z1#a%!xf~ry!8)N#FBzR-lG$eTDvQFk88i!{BZ#~EAQWCODpnGkQC*Ke`6<F&nIM~d
z^M={%!d+F}V53)~v?pmp#7qKbRl`~Jc`*^E#AA|z#bz3F@Z|eQaNHRx*?}8}#+1rU
z;weYpTB-@;g}N?&HwHCB8F?~n1%s3qwE7jPWKFP6m7m4h-2SC$h!_O2ou;KP5-VRU
zbU4YZkK8UOwopnPEqTu5)_FNT&7kGp=mf_{Zi7$Ihu3i8rvFUn=ii4Bm)$JHJ|6fc
zQ@98BvNTeWk&$Mp!&7raWlSMDtZ12Qq~)_no3s820n70ZGeYY5<xlbMG3p`tIeDEA
zS?E^-hO3)K={zs$IowkKY-#;@=$(A)BgQl`YS%yHpeTHS3I6pf^7H5G-Pbb}ja%dF
zgV?;Rx>6qJS%_IfZ2hd>Pt6PS1JyNtAWFCViO__!C>0yKzzt72-I=Y7MS&ba$vL{I
zVy<sxZMxMTY03lq7Nst*^-XKj@kw~INCrK<8vbFHLjk1>>^6b-qE6ji{HEP%MFrP$
z71n0l>>Z*{Wh(Y&o26PLjzD#@|Nf=l``tV{i_fXnLB=WWhW2=D-Hg|AtFz9D=*vMI
zY*J4~ax9+-kO&+fp6sHQZ*zxSe_yW24s@Z{a15a%j21tU%=&9~D$Nj^2J7i%Cq&as
z-`WQj%2g<@PcGrM7N^8G-M7UKbFxX@8kw*pv%FB=lFm_%SlqI69_12%0-F@{Mb6d!
zUjr@&JhN$#kG%Cc0(t5vjor2U4Op|n!uB9OaEt18b$~;@qz_g1{_EFCb(JC<oA255
z%Eu})OZtjbqCw)6U5vm!tpB2%`l7lu$HGaQw!>GOiy7>~J$G(he;5{P-H>f+LP*~Q
zk{Bvf?(>ZeTAqZt@wIu$vhpki^Aydsxw-+z^lNjyT~Yy;ue@n=LdKi+@S6rlIBzH1
z4_Wh9#XvGGbI27{-g-k-)RSRWz03{A)=<&HJfn{C{iI_7JeHeVt3BBkt?rBc=`W8u
z{H&77zi(9c4rykj9auA3^J=R;_UWJWU-6b_$po=iI7M%tkNQw(5pJP!?i@_)J1&m!
za4!zf_RA)Re6|8blqEjwS;mi2{AO+28*-bV%L>W|T4JnN5GxocLY<!*UG<UYy)|A#
zLpC76bJ`mq9W~uIe5SYB9B|mo4tjA}&?e|C&m51(1%59n$we3V-KS{)QbxW*cx|v|
zV1$UU{UuVZUc;7{VD{oIzr$ly@6(@6o`clczzD#rPS9`H_FOY5&;=H8d<exp5^F`W
zFI%T1e-41ZaWDUHbWn3uj#_-LiX~rF15^-_r<yhtSDjP2@mAyp>VuYWk@Y4%NfCEx
z=frp$Q{-vzuLGk~NMBFdFZP4dGCg5f$ee@{@s)p{Jb4nmkHxEo;uzsn2z6UrF}_Ea
zsTF;fsjs&gN?TV*`d~wava<|Y5S;7HQj_$ey{IHexcLCJ0ynFprKSUXC4E+BIyq$W
zooS`gLin=(BH0XJ*Hn`LZs0jFDPUVr_vEY!x4n3PtRxiRf}pj*#u7tY_B14APE{T=
z8`U3HJjtG11C=X#nTxllK6_S{<>in2^0dSpX$w#H%C2oo40-W_>M~Rb4~+|jWO!AS
zbt2`kD1*@oGjq0Q@9XNp_ZK&**tfUal<>G}8Fkc?8WE|#Qzhdl<qsIyeh1f(S83h?
zkCws`;T*6LZtU!%ix)h75-5c*99d3z+)r8_;3Oq<YW<pWE?D?R)d*AuQ_D1zf0res
z>sZ6oP2J7BEcC2Wo@TO#ZwmGD{>N7CIYqBoreL1c`3IgBy~;<e=V7b$b({9`-^_l)
zp9M1RnOof%2CTDbD(OYOUqMFpdyYv#_Pv4uRA-#5)#$QRTU=S}Z1#uQaW3;m4^!3S
z9&BHfSv6R*`|(XsH#%7{V>F!UW#{=;cjnT*;c>;{?gw*{^DAxA(#kqsZ+G3?l3ZqX
zDFm1@u5b!Fj89}oMQL!%^bd5dPReZ*CcxQnPN}H3oX5?BPQCtm{dZe?-V5FcS*Nvd
zKR_wfX$A^62NI08){%h|4OJ@`FU+i8R*+7+@>FSOxz+y1IwQ|#x}y5u0ibKpH)dhX
zR0XmeTY?U&=Cf%x-w5kAwzXllabe{q;K{<3?8R&RAvq}(N0p9q^ykwgJB>{>jYxIM
zj$~cCa`rnt#6CE_nGW={*nP1yGrcsxGcuuqBjOXGAC}U-fE6PQu2!mzv2*qi$t-O=
zzVhv18ZPP%MmB4B$Z8J>6MidQmPV;20hZcGO^_4~6b|srUL!wttih4yGtXI=jzH|y
zEQ>z71hWDtH!NcnQjywL=7Bd=0OizK2NKncxF}DE^<2&}X`?m^wlylF;d;IQui9pb
z4gZHmH%vKb8zkFVirG{+C9)ejf7@f<w$e?5%$}FaI<w{|2w-Q?zB1o1L=(^aZncrm
z?nU#xKNXixDYP~p1E-F1mRT;GI$9m`ik|sNaujqkvCok1kc59>E}t^syD~#LZ?cfg
zDDIWk(#Y4my5Y{Lg~#lp9i4G}9u}%R<*FC@5gZ1^svL960@lX4OVfE)@>ZLkD8-C!
z^9G6=Gsg_e{4Z|xm*OJ4RLA75&$VOb9iMHM-1#}AKG<(jI1OBi*^gKa7v#6cgqRAP
zj+&QbI2sO_c$!48?YnST4(}^ltBg<l<8-vEN66l}R+6MwXPBFphlt!vG3gnLlmE3c
z#zFq|)M$srFm{SJTbD(q!2<5&@|Uj<lx3k#4YO(|Ab^{KM@i$hkWI5(u;A{{{agX@
z$z~#hYZA+GVzhEfg2J|jI!`|A+T8WG{_8ylYnjuu%7<{zX`C;*`o}$YM~>xkSH4XX
z3tH#>elWZqkZ7}1IXYcrc92Rya9lB-uVF7{EY31f)y&RiRmClo29=jtm?f6m)^tWG
za`$WThWlWrYlBOlZF*)aKBO4_d32<_ed9yEJ+I&JkaBbz!`_T7uP@!Tg!zyBe%suV
zn9=k_1q#<VwzG4C?sV-z<xep6wuw5AhtpmXZHc#z-t&c0-w?8#h7ZkD7O>NHZO0fQ
z4ss3+4T0Ppz10F(iD?pDs&YV<fC8meXi!Tnw6zE`C0{gE$e5V^@nf;qv)m*A7A#a~
zJl$2~lx!W%ni;usb}UaN3XCY_%JroxCaq^Lc;_o-lt0^D9w+9<!lSm!B1H{KS~9gN
zBlK5@5C}iXuP*o<?rKVMc!=V+^iN%GVZzhyZw2FQppHRb?ZU>uI+|)0q4&E{WEYO$
zxN1J<N|K*p)SY1`L)DtBE`7Qy)2JvdpcsEbcVt2~;+%Ldm(Fdp=f%gUOXmp}oiEfP
zePTmPV>j5Fo0)22HSsPsMD-NSWLJ80vI-<jY>reF@q5R8x2=IS6n%gC!ubKGwcOu2
zIU2-Jg^riYP1yA30zn+ja!(rnfILJ~phMtMEuRN0g07V*7oCwJPHU2-nBzOw;P3O~
zcX-37oPFuaazb-`=f>pHXbzgt%So;;3_LcT)^!Ca(wdIsOY-s^wcK-GsllyKum5VR
zl{Ic>SjKD8U-N<ECK#c}?Tti(me;%{h#HDMb(E%<Lf=%?d#C-R5`}ea@-c@&$N?=o
ztPUAIs$-hYm<OwYFF_6vOfNPzHqJ|LCb}~hQyxb^Ii{3r&wCl1TCaMepkTmReO)(X
z!_cSe>X5+2p?5DLkae0+1sh%LI4l~;6Qe58TwrHHb0?_YWMMFQdCco!f7TNz)RRqC
zz0D1^V){=7kDJ=sGH<*ZVn8ahLfYO^qFPLv9MA$RiOYb9m=7NI4`KoZ-?8gZA%>H2
zrJW3&p%56Ikm5M3r9B(#)$p~=t{0CxDy0BEqHaQf3Eu9FH!kmClIq52Elq$$h+&zR
z$LNm9I_%aJJ`RNn@Y|%ASyOkYAdFHIkhOX1v`IByx9Of2qg6%$Y%icnCNCK^x4XAb
zkRNlJ%~Xn@XT1xAbTEj%7q-RR=K={T`TPK;JYA6O&@PbV?&oZuXt)kU^~kAY37<I>
zo%jZiH=@aKnKkee;RxIinlFg<RE;!ypQ^oCzS`%`3ufRu#-HVd%@0hG`m8!&N{e1a
z*#8H6@Qpb1bV*04M`P*M@?5W^<|a+^cs_fZv*D1Q6zURqrqxYevHqWg?K3X&cgj$l
zI`ze~lDzuu-0|z9O1f&BVa~wM1?7bJ*zuf=Wy#sT{M(zppYx)UVB!N$3y#ElR!aL9
zia#l$UW#z$t*)#K!Bcu!cve`4w@=831iXjTzL_-L;njIf3aYG*KosLenPjy>?6}>s
zglRW-i|wgY6IwVcy+pk}o!MY0^DV}U&en&`wtq04?bNDa4QyQYtqjYwU0h34#66pC
zSJb_wva#^PwC^tMJUFt=KjYfqa+R6?+vT#e-1KRyQM+tg^sw#XqxjS<hnT;GbM9_<
zw%C?IQC~nW2%g}gKLJ~KvJ+JUL!RrudEu<j@8{P%t(z|O@xn#0X^<$k8_G%ING|d&
zw!2$i5s0Mgu;nB`u7r|Agr5?cIQG{)^KImtRLH6Q6Bp@#@_M!^a8sYpHWr;$8~uWS
z3mt0wU^eck8R=LBIzsXIr8vuikLhI>QGqjyoTkwd-V|0zD+(hy<?jg?XU;D_$mvcm
z5{>N4UXW+MCiWu*jD<V(bPRlo;ilnTh8xDpI#>2;*S<I{RUAIm<e(D)>(@~@XR{>Y
z^}U6yuJK00;kza}_#N1z$@UbX)qs07<~?0#{kr}B9Q~Wgi#uH~H~$U$$y&>=;;PR#
zj~W#!^s;)?tP`6(qv?IF!teZ4!*jqjTmg;8ry`u4v)>C-Z+T=CQ9gSpMoM@N0U+PO
zg#83Q^X<cV@Om3kNo8k9rRTJ$uF_$aw3^B-uM8gq4BBGl0n3f))$QZc{iZBFBn_<r
z+gtYbBk#?3uX4KMzoBF4X3q~m0`CtA0LR+bUNpS-@(5UCuHGKKRDSdLjlb_eLB5yL
zI!`)3qmhgE6lCcsrw2AB>OZ&qyuQu=QvO+yapcv=*H?Ab4pfC{ZA;;TvIArnE~hb|
zC+6k-MOv7lG~gjXskNSIk3TNHQ5UtHXP#&|lW*7l_V&*<9ohvQBPr~;9spG3CKDy&
zxHs@r$PL=_J=OI7>Q$l}GxE@&uFs0MjL*@FiY{!B!;-8l)xNorOn~i(Ky-=4E(pxd
z=}Y46!!RCJbhnk3l=C5GuD3$Jg+kkiT2iObm<gV#BbLV36}x?jfFml#Q69@q3|T|j
zv0^<!Ta<(ZEZlhfvRQXPayp9L#(jH=pLtyp(-)v0sh@DDCNXP`UZ7eZym7a6&5#`A
z=Oo{NG>xtYt7kSj=0X9vtp@a92s1M0`pGoPzoKevN`(HeW!s%q!B0;dxbKX)xQZ!t
z6MMU8FZ=OGiU_5t<fLX(@pO98zM_?X5MiZ`9n5tX5C(_d_*s`(#gr0l_07@9aS0sV
z&O>9s&m&;3A1;5+whj#zFpylPuSsux7!h7xnM7z@e-6y)S!O7}l%n2=%8!k;otE5z
zOwIoyF4DIKPv>i2*BG7rt0BbRxc0+&`hjZaQGMWj4{O0+)*s)AlR@hJ;azkbUi_Z=
zQ~V?JKg5B87hm$jknTL%g=-hHgck|H3}Vd4`~dL_2`>&Q|Fb7u{)~_8^s0nrcS>QR
z-f9CjbZ4&qtNed>97O*fd%T0yUIno$!YYIh{A~e9^tmb%qedlqSy39J0}bj?5j!6m
z+z;65X^bv2p>;doc}vdDa=bs8SChpj@pK)@tG>fc#6@(b3ovN!Ma=F;kHV5`7A$Ub
zwj1kSYD9#^{s<UYn~2@%-E9r%$8Q0pI7;6U`q1LETzj85k`Gd^#IRe`i~PIM7MBsg
zT?D6U<jT>r&<1G81&GDYRG*@;bDVKRa|euaWX;WH*^q@d?>0o`UtO;nTz&q2TU@oK
zw6+FS?Z!Z*0+A@9<B$SXF#i|?yIaDCL|~UxyRv@LYj|@Ky&Lj-1hOQ*LO#$pOKgSn
zctY=d&G2mV(w^P5w0euUmI$r%238ScdLyk({XNZOh8;+|r2hZn0wC_7eb8UKADLPW
z;jADk=QvnGG3?I<P+svCXPjPL8X<8m{|p#X09DZmWz7>HRgbopuV%wU9Dwhu0NHWz
zy*75sMRI8)A)r?jEQ*^RS3!s7aunKUdYjzuNcOsTZ+$@1dE=B%NKPkm`WTD^V;R6i
zW6#DLCx^AiRblLj)*+*NcXiiqw^TbRnvzSe_DuG8f`S-LY=(e^R#}J{)w=*NIzjdl
z2s7OQEXBiPff5p+1)Zzkuy^=^-+9RbQp##{udcXzj`RBCOepR|#ja7=)}|n#v%J$X
z+4iL1A&vKfRtby4o0DW=Ii0q|Rx!b@xS(^yXMw$4f<91nY6bah<27<8O~mD;ya(m)
z7y8{NDC#u*s%U2VEJnsB@fJ_DjhV~YG}MA1)n7$1+w|4)IIeBcsDn4#SVgHEEN_s^
z(#S(WUe$XZqYJ^T3JD8EP9B-^XU{&b3Bs>eU91b&FJ#qEPFh@x0ITN&-AuM#-Iu!o
zcdOreczDbmb@N~yzXn_G-3jn&KePm3@|8vn&-l~^2uy3P_I!@mVc?y4-l|yt`(;dl
zVA1$Elp6blS=G`Y?G3S&QypkVBY+k+7l%di;sLvzFV+;-1H+GtbIHXz0g>6vsgaYi
z879=@waI<q^Zz35y`!4Uzjx93&e(Ot21-{Er6V8$(p01f0#ZZhQiV_qz2n%B5|9#*
zt{}ZhN$6msH$fl}n$iUV(mR~}g1;HRbJjg)-L>vo*FRk$dEZaj<$0dH_oTImJwa1l
zc6wkSP5liMlX$@7NjjZo@Uvh8p#k#ctQwRpVkulbwpy2KYCm88>5Z(CiFUt+e)uBo
zS(h<l#6|Z{;X|?H3-_{$ythw`TpfUz6stK$GN`Ec3Cq^s%)eG-Tq9=6X`OUh_C!g)
z<;TbjjKg{+MDeuHJd;?xNQUXFhW%y1*vholaQnOGPYavK74qoOd9PW_19Z?=R$Nt7
zO{e!|ZRO55AU>Hf!q|5JQYpvjvZv&FZMNUa2?!8-Yd3Oh1alSwUqI6|3*R+h%B(<D
zn*90mD+nwX$6G;IKI4c%tXu+wb;)LgxR|%K4OxC-w@48a50*cPZ0>TuR*9#C5Trp)
zH|vbE>HP*e!C4w(1MkgTE|<;4vTAlgjg0URLFkaEDZ7tqnu7&o-fiVi`G^-B$~&G3
zph)AERYLu>mmZ(IxY1IiAKhQB)4(snHxveI{H?#7Q8Btxm8npE+tPRI_gXyXr3uac
z5&}UUpQ_V#Vv{dxZU9=+d(Yh#SbYtJ(Y`vgCr&`An~13?1ohml@mfI59-&12zSpi{
zWo=OnFBIVCwMoXDMmFyjuuCroD4Ul$E4ptoB}vd)#%wwgcF+57^lbRQ5bUSXfU`48
z=LSuI#e5uAzG-`lbffbWr{-NomGn$Vis(+)ynK>fNPaLnK?iltR^7r#QbhUi)DgA`
z21Y%M5^R9^l#Rkk)v#07s^CB~i41aAN_Z4OvBYa64}}Jt2BoT-Z@W)k(yYxv<=CvP
zO$MnY`B|QKG<{9sgti6e9vgVA1~Z_%78e*I;M&57w}H|^DZRvYzdRw@?bWfI-+wn_
zPmxEi#~G0M`W*AxZjDo739FfC?v#pu()%;2Ija<&GW82x*04b^@;&jCtF=4~UTtM|
z(?k(UNgQ>$w~`Ctr6k1XQTlbG({ZwjO;M&e4D^^;g+uD)Rk<+L%@1fJn4$XTSRY@x
zvcmq(tjhY|(a@LBjI#3MTc2qeT%(EFYMg+{FaX7yo69p~JTw6yis{ghE9@G=yTivz
zQ0q*eohWp*UpH10+m9z{Hilj@fABWm$p>+2zR<hw!P&9XIR<fQ;bOX^BBA2qN#)I5
zacgeAnCY)*@@Nh<KIjN;Js&!R(B1dl3TWD6ouqh^q;pc0(-P0FcH#2nQC{CWw+71>
z;aprgtW8Kyq2He5HBeX>i_kAGxlQ}MgL6Uvg+OsSBKD(~8}gC0hsyt~fQ6X>mC`96
z=8CZQpj}T2WFriQuo^pvB5{IT00g$i#okLZe~y&avvdkLCY9Da`YG!8G-yEpPfZ68
z2a?f?huxNKtYcIY%anPP<6<V{BKf7cTAWa1fDRHABC5$VMt8>DGX6Br&W7fX&%n-v
zDcf`Fmwir@br0Y?8R61$WAy<_q{K#yf9^WDz=ogTI)BIXjb_$M6kWrIC)qG8CzR;g
z1Ry^YD`_j}CAa(C?jj;e3M5c_Al&)m`Nzk}Q=2XYUOV^pVHY|s?^k+rp5&LML)t;C
zE-R&d?=23_Ow%TWT}$wIZHS|rp*yVrrwpAikP$Jys7c?ftC#3e2(5>7zyq>Zdd*7f
z4Ap;P?YCz$s3_t(Bb1$k<xmI@;3v2(wvh405M=H=C70@_a`37pM;N-$dQe^oNA?0J
z4t_>xTL0S<g<hfx-wPB)+vd6`F28eJsGq&O{l&Sy_V<u(*UObS*pPDepAq8gd~#6F
zmhi2yLr^}8ZFYWLy1Ru;fGp%>uuIFg@@0;?NB2HTwBn$*jB@Bj!X4|LtFp9d29lOZ
zM2eab*I{b|VCyt!X~jzlZIXB(_Jyr|^mjb^*9iNsu8-e4%VmBv{0MDZLzICRtw{_%
zQ)@P{v81E~#$Kp0ih1`-I!>sEza;Zw?g-w4Luf5*?}*dplrM3z=3;?11E|XOAFd~6
zL~2KBA64Tp<JDA*bLut)J%xqrERXj)<Adi${4o(veP(Q169PxN^FA-(S!BH~vS_4l
zEc3L%4gbF`TL`rNWySEDd#!#xr`*?GY>$B&57zv6FS4%CVz+sgiI@fl32M_xid9-C
zFFJtZg_5V4-tIU_@AiY<KW+#Ptv$KeZ!hffATq`Y78#IK@+^!cn`r(vuEJdGM7#0L
zhnIzgs<zhmBxk>SPRJZOZBFXErhZwG((1k%Fw>Sn*^st?^9XtMx2D6;wf?`HGm4XG
zrd`JCIX8dwXYE|zGyq6yA8C;+4-<sOC5Yi`;5V&@lKKHKjbg5OGwo>_5SFn)={diC
z@ti31e{Q3!e*4(RpWSO<O)gtrpZUUL(0`1Eh`NgEmrltzc(OzyPyjU`WRXeDI@zg+
z*Fzh5ZzqM=R;;%7i3iPc9wGP+F|_M|)$I%)=M~ni^qP>|wh{wa2W22#{&aRE!r+>h
z$5SWUk3P;Q9!aRUhe+?d<Zw$oW?{U4?xPR0gxVu=g=)46LeJ6jC8WftK6pFu{&7RH
zBK_J&DuZ+k-~nKk_xwXfC;7gGa9nl}fc%hG+I%uY)tjVLao0TC+7~u9HWm&T7{Sz6
z>O2X&AN?|y>%#q(2m>$RL)+;`1BO4h<ii_5^P-ndxNOZZk2MQ>T2NV0f?4`Y*ahwM
z^2`8_1D}hHdF(a`CupXpuzYUorUo#dAO$z<{T3s_0(Ge8{h@<qf7%zH2%fC?tJbNR
zwxsME38?0%MckZ>Ox6-*0CgIOOE4Y>|4FqhQw)E#xd*eTr5=UrM@`*RFiC>Qif9`T
z?RYq=p|`41;mS;<cRZi5R*rraMAcl|u@ak@Av)u1y`HiM-^RB$a~@l<0<XNuTX}?>
zZ~h+WvH*W;1Lm4YXe@W5bab?dyF{wDvQiE0I?>M27e*HuvKK0w_>|IMzZ?qhfS1sH
z>LVKj$D9BG4M;7j%d5_e;C!LqC%;m61^<N$55BkM+Bx|4V%C>=RV2hU>az9bN1mAC
zuu||=Pv8<gKgBiGskeCyu|4n5kg6%&#7GaSLl?j8W>MR^Kl*FTA7QUzIT4xNTnr>Q
z@{oi70l>qu0~77m*I=)ml7z1wyBSPsBnUckW-ct^0)TR+bY}UAkzoYj3|Q|Ig&|0|
zaT{{=H|iuJ!;iYVQcOKtRpciO;u*Vvt1y&?BUzWFWxET?)unQYoH0G^s+yw2Dmm61
z>p4(S<*R=iaqkGQsQMOs42jzI5|!;tMEZUtHQkARg+o)INHf8rELEHDtYP?^qWdQ?
zsM<Ayx&dB|^tYw%Ot)tTpGvH}B7*^qGas>sF6G_T`>Ejl28ZGO>S<<wVDFM_@%vZf
z0+~F{av&=s42AGtTvZ4OKC)Dc)q9Lsf=&)S_JQ}o&OucVZH&&>nR&Z~{RuSIjCR8T
zyTQ}fJ?(k#e!c1X>RCmm4OT-sUk<cBb>2Bw)$rH1d&RLfdcNM0#}=n@GIqV@!!STs
z9pDdkw1hWLfR0!==(+4`cS)u!v9Hd~KMqv3>`y>E*u#@ZCjO7S@qA3vs`O+S)h#`p
zqK?>)-rsjqYj$Yp1(L#$JxPv}Zi1Nb&3R?sA@u|la=0(t0QY^e#CdLGErc?1kGad_
z;qI=!xVa-AOZX${-p6$KqmE>0|7$P_$ZWdzIO1?fJuG_<4Tslw8-CUOuP?Lrb2;U9
z|LZWKMB7Q~9-i`p_kld**%aE&!q12M;6ZK6UXTFsn>D_Y_}vk@$A|*HUR(P|bymn#
zV#HHo&Q4(Qi}%rf)b&eJsCg4prJyFZbc)+lfk$!avdy&B?2mDT@Tc^ICTpu%R%v8-
zsmg*KeCx3q)RB(YWD56OCkol%3v$c33Ore1yKkO2^)~|Z?~DmC%Dqc%CP7_xWoi&1
zvzj*0gvvJfQA^ULoH%Zrm3jec3WJ!q!(@|zS{ZtF`%F*6&7QxPb60QMeBFBF*GQ8S
zOEBuizvjlY_m&nK*M;yIc(f8BUWcWnbYv{{m-{<lE-Ep6{nk1Jp))|-rdZ%MV62t|
ztPL1K&cm8HTg6g7&+=R=y(qkT+BrQC20aXFc>+!e22EB#D$F9YAm(h7g~c)4v|F}$
z<>b*6b(_Bk3IAWYNpy}&Ie%}{I=b0`irro{Pb?Xo>K4qq2!Yt#eTy%n;-+K!sd&Cj
z%hF3$8U*ZbV<l><06<;{!V-QRf+ah}CB&dqn?}N`45~ffLzv{gy~zPN&TN&xN})^u
zC*iSOoPhaJOm|*(uaR8}GXU{DJL2Hke-Lp3KL3|+EAzBICk;oKflZ6U_uk&Vc@R3O
zcq!rQ9Vz5GvY`A80(K~1c_1gDe{TZx@d^&!F9AK?obJ;2JlQ}6=~Xg8n{sxA1)Gs$
zB6cRh@!))-#oddRj)C9ALz1%YOj$9HCxpB|Csjh*a_Ow0X7tsWO=m;@5dulS+!2$J
zXEr|?NoKEt$h%;@HQ9NlGtcm+=YW>cb)nEY!{5IFN3Rohd|j_Jet>tR;q>-$dP1G&
z=~D%ti&S+u^^5anW1ag$-cNN4jJ3ooc*(_H!vpP2&H_7i?1b&#xZPdR1HVR3Zo60u
z6h+a|(Or;~bj{0w=+|z(GZU>@D#M;CAHfqM>b%6NPz|!QCX%yix_UN$R}mH$p)bEY
z6toG&iDmA~k228$b<j<7fQ?>8hACCAG$sJ1^{v+9y$9sSDVvY21}7#;?tOGvJm#C)
z3Aw(g)UyTS>ID%m59zy~Ka{x|1iuIHgB`;pPCm&ng#zq`U)Z?%@+#VHdrOJpRS+rZ
z9j03vL2?-iiz>oYee@|0Q@Go2aG!+Xg^(OT7_GO43y}gCaC)51xFg6;PT%O0CuoMv
z2bXHdQ~(XNik5+48KFF}(Y>aYrxlP@(fKE&RMpo4g~ZTPl3xju0NV6J8jIPFe<Z(^
zvH4pI^v@4}4{qP0C2sG8VND=&?N{L9!VESyQ)+Y2`DW15ywu6ZxMm4In`i2u#sV*i
z*b{LFr1$$<wG=7>XXqI4`MqT@zI+c*;hLfb>+UleZa)kouDNWLd4sUW6uBTJc+0HR
z80b|bUEr>!ZPHhI32}EPoKva)DngJ<svUTe;l=LbezYPCzLts$A6IT~KgzKeKOL%q
zw4HA)6TMpp^|$!<P$|t(xir<S>a__u3|X*qobFCBa|f@{om+&Z$($D5uP^yLO@O&y
zBflTsi8!-$AK3|)>X%N_pJc61$+A2>smU>xc(p<v%)!~meWgMq3XCQ?a1INI+4GOx
zXin6q%S`=R->zEwVWLX?VMJy1^0j7}hwI0M?*_{g9VHqWZuRcRj5DbnHNsUnA^*N3
znwmk4SMFng2+au>0#}YpS(3Ls>Qo202&*#lyT@OIL4fEuBH+;&Fmw8)i{IC8LEysB
zBR}E+^?FlC5)8eBP2b)QjVdYM!SDhhuEln>db|)571QHnV&v<gqfPtiiH|0gAwgb^
ze-<@F$w!#`#jUjq;a3rhW+Eq)R4<>do$IkWI5!EZH3BBA_MD03;zT^&Aih%D{Tm@6
zWlT6y5nnHO;lk&rG7`^s2qywSLMlweQ*+#kRqjYnDsiyLY<O~T`^zuO<KN+CwV;d0
z14Qx&Ud$55cFF)4B7UB=D(Fj@d?cJcUp?&u=$q7J23L-?-)i@RxfR4Setfr~xELA{
zTP&|`bdUjggj|><AMqbvip`jaD;Uj&xheCQ3C*jP>Uv&_KgM78fUFz>M4%Cl<zz%J
zWxFL+h$%u*%nsYM(<0!(9(mV$;H863>u_=~yG~4s-e$Z_*2Z?dRURh6Y;X)oZfRQY
z!VnA?EpfK>;ZM-SjJ2$1G(cl_C_eV`x9-q}fF`JA55+Lyq-+)fi=j{`|KtyM;E9S#
z$6EE$Y(~0rRSJ;<>_ETc(q97$U^P2FGa1d{eZJ)sZy^W5Pwd75$thu{e?nC*;M`Wv
z5o<GXgh6`S;ZS;e0MsUG=SC#!<p3feG#F*(S*1|}X7+tzBI=^z1mLQK26CadK{&xi
zPg(TkIVm^)QTqM1@Tlc(v?J5RByE3?J0K|Coph>Iki<YQRm(sIw26GS0%O4>VNyaz
zL+Sdy5eBe1i8^Wh@}z8Quho$V6X-m4oNSHUyO7Utrmp5alig^wO_=lO?y%8X*_8cB
zlATm@JA@qd3!uVcCARy;iVEf3BB?-zyfjBQ@LCEE{}+ytZgA9K5$}dqX$^I&a%#s{
zSU^RkZsq0@OatdEwAmzpbufiFN{wWpvD**~Mg^Sa)O-L~RGtQ?AWbup6%!?T1gb5Y
z!nIXI)-rNN0ZyAsQ_ILUp!(cwIS*YXK?_GKdi7b(P4&cHe!BxyK}_<)+I}>i;%nzD
zg5#Mbw{kl2$@65jBs<WySYkTwg!FB#W%x{ep0g6q%x>?Ohb|st6B8UgOA{S#eI;qo
z3~hNi{yd7$!^N5M45E_*zJOR<f26xW9uCb-7Bk)OCltGH#Owx_hMMx5J7?-ir{B37
z3cQL-Z&~x&ii&wahLsEcdLj$y(hofXk$kE?XX5lC?O~3LCKxhTIwJw8QkL5(l?sp9
zp&HbEk{opW#0$-EPDH6D9fH|H<fWO@0lAuG_U7(zpxQmFXIcHr-3!C_LRK!Ql%`@S
z9eXE||BAIX2Gn=ei<+f+r8zTiga)`?WkcgTN=p2`@g>@!tOC1{PaCWDY4jY3)3(up
zTk_-+kV|J@PsfT?X1j>GcCM7^4k49aJAJSovZskZ`c)OhTA+Dn4mbuq!bA!Hx}fS<
z1WiZhc+T4V935n#KkUakIWT~>p9cAsJ7+(hliu|1=A-MZLbf)+?{x}^6M=T?OIK}Y
zn3I*a-QZv&!A(<ovAfXcFZMApjiXK5L<b?8Pj5e-X}NUa!rgt~R5N>0bi=^WgUC^j
zXcaT1D3o!LC_owo$u2sv3FOxS4Gy=-m;nN23sjRMK7bQDPA1o{0g6!R<`|0g;p><0
z9Cz0}Iy;%eWGBz5xxv;D(6e(T5liWNZ0l?5^iig{PqRv>#cx#^KVN+n%w#iI8|3)!
zVlEfRk>490kF8AXa*E0SVvvxe<o{pd@U0NW<c-%(UEqtUo$Rj__|E=7un^m84a;Og
z6Nvg@%U{Cum4|wL;$Ak^-!z4sH`8{-^A~u3GES47i<X^S>%fatr<o`Lmo#z*Py@@D
z5Cm~F1IuF(V^_2R$SH_x6(G1;b7_v3Bz=C(Opm&FWwclbmh8nT221I8*-Ktx+HnR@
z)`c)@yFBFu7DCnAU*k>Wy10kyMh)ImxcMlYPDlvGrS;mm@7vcbsKjay(ZgBu5T00_
zfWCWuCDbNPkaAYD*VGd*(S3dMwFH2?AAEkrBjw}O`|8FBSQ^bN?fN3&*L*GINM8Ep
zD{Qfo>7PNuD<jJF`CO@!g~x+F{wz1CyZNtV;5A_ocq4be@H|!^L(T{ZnUS(r|MQ>x
zn>T;&2xb!34&z!K1+X6HPoYcFJOwT&FhJ~8v?3p2@Zo=Ahi`(4b!E6t!tn>FJfnqL
z+IbXu%MHtr<v11sdF-B$_fJ_X*G*E-DHjY3P!@iCpx#A|-);S$bDbWHv~fKEwS_-+
zlAWoj09t_}_*YU=-+D=zDHC}Dqt&^p#Q47wacbnURQDYY2nq4!n4FJpk1WgByJlxK
zqPHiK%YPp4*tD#e|GL@PAiLx*FvUeds06cYRu;Z@%+2Q-H;jxyEA3itUEnTO(RtwL
z9I<k8UkeA8(ls)4A#K+tW|mrf5wLyxWtsxK)yYdoQ`J&D;Az&Eti3^q6N!7?C5h=2
zTAa}ESf>a<vw#O1D~BjVS^+a8Fy{(SY-oX@I~~n*m@5C%B*myJca;)B69r@FEm{+x
zbzCSRS}T6WBlD_m4&VG(PzZ~gD^5s>9c&&##)K5j>|KQ3vwaJodeca~tDCLRr|E7x
zA@kv5A`cNVl$i>h0?5zEf|lUCN58d7WurPBrhCUfpKF0BMh&AwHOm4#7vYY_z^%BR
zhfwCkXPd*{M<Ywxe6fdriU8eJbwvJ^EP%vz<*IF5TK|W1;HB6(TjKQQL9J*C?b!!X
z)zjX9X7BXr2#_=LO<P0m1o08x9O4O8r}LH1o>HvI1>t5j;jp%dD$ORN-EVnjhD+=6
z1l!^ys%^Ski<6_qZ3J%xi72-^TV-C0X+t$@$7+{ddG*3{pY~N+v7!vDd>vf6hDXq2
z8Z`91!Wi6){@v_aAk6G+5)3MrCWzHDn(8v3GuDUQYue(1!9Sa0@i_7j;KBUheEETa
zct$7KkEhqP$%drP$akw&lOhi`;!_>aH5V>nOopK(S6q*?KGeoM<J`Ap=AT7KQ&N;u
zzvj^m>V$-lGm>5cVjkP2Gc@?wVtZLO7TG`-^F|0ro-F`-)JCCX73y=s%gpsxY_3N@
zvnTC+8JgU95CB5ocK11x0Wjuv(3kSDTJpy7y%Ye<B|*>sv8qbioeOh^Feo(O;r8Pz
z{~~I{IuKZIb=k}oti)CQ96n%vTwE4jC|p)zKX~vUa?BE#tHR-hpvAlV5FLhV`O)Hc
z>f+Kd7_KJ=Qe7l*pDAlcjvS~j^UYhhNbtK$aQw<=Wh7`B1k(#k?$|sz!Fs695R9Qo
zeEnA#hyYzw@9(NG;vlqqvB9%$V-QzN6r1TR?_26mJN)xzF|z4BLkK#CBu(9l4Ov=f
zMH=Sx7OF+U%`<M8+QO@P4OP=PzEw>M2_Ikn-BQxD0P;+J;RlB1j<=v)6;e%NmJb|r
zMPjoS=fnv}Yfo&BN<*aCQd2#ts0;0<63Pz4{}HQTL{=YQk%bql-QTY*_{oQ{In4AQ
z9g4#(C-aAhyN?1oo%;CkKF8qqfsB%OWy87YQ+h9!^eM%Ob=};-vBUsJ`T7*8n=L8q
zsaLag4ZrqUX!@u2<F+C@KhVgd-`EI7(9p=_$7GIV=g}>=5wv0Kef<tI9T}*cgd<9D
zV?|f0PFr)gcvZb3?gT0QWjVEvMw>94EFgUIIqF*f2!@GR?my`X+ch(9vbCX-QxWy?
zMAn0Q&ejxj+=%{LiSqM9g>shW5cL9yRnPzfKRF+RMieC*rb)0LlPO_D*vem?TKZt+
z_I)^$vSMaGm1s_{)XyM6^n<XSF)b6goG*}_3on^@Y7aFbsn!{17^+sjW^M}gDMMMg
z?S4?P0W<&d0i!{#8EV>Efs0^tz8RL;v$?mNo=x@+zFxyA`jT=p=mj#=`1%ibYGtzp
zqKBTF^a^`sX@StcA)nbl{Rz|)+&sVs_SPjgGdOtd91;pVWK3;({;P=<k<Ze~H9DxU
z;PVI!tX9OqlUt{2`ZI|gE}Afk+hSnL6CKKlS^~8`FwamLC+=480E>l@rt>gqh8`py
z&yS09-v+6wOZn{+1_QUVvsIdqJCT00+J#rkxHv)B49C*>(z5ChwO>Om<g*T<Z+1jO
zzy<z9zuwJ-{p*RkGSS@r-=uEf_@<jIb#UgmH0W+Geikt8@NwJ!w0HOcI1y|B*VJ*W
z*~#=mAk_`UPpe(<1b8Zm)Qdit&#&^Xofs-N#Etk3z7!19GES$4N+uo_C}sXadGYtU
zAPe%F@E;9ozv>Q5$=a<w>-#DEBbdGZ)SPE%UEdXj!hR95s`IPWIpv|QE~9q{gf7JU
zmQ@f4H{@(>skP&8>+CE69uPL|xJ{RiGc$WJT&Pnunb=QsYFR6N&hZVk0E8T%8pt{N
z?8zRE8S?Hj6#PFe11mJJ?@z;R9Mdsb0u3{a8LX>a9`Jsx=LGMZ)I~2@5s$ruo!VWW
zB+W3ew`%1B9on-^LWgT}ATHI2fX-JpW!jP*ztH^UE5S^kBXqnw*Er5*7&suL7|R$D
z(@z)%EI$$q=kzn~6gEQE*}=jS21S^@)hWCP9<bci-amr00+NF<Nb2`NwUdb$4TKJZ
z|EK3JVD-(WmJOQbW&!XeO2GUUST_*3;IRM~_V%{bs?U!SV4gXr+TqiI)7|-|0~M5^
zuILUTT??IimdongGq{%=%ca_!UQ1}s)kUC{=p@S4!`L6g&tHf(Z(-8dgK#fvb*U}(
z5=8L8NY<eUatX^A)$^CoP=y0P-s+lCh-ZBqbSBif%C7op6T+W~ysqh|XL96l*xh#x
z1J`y<BRw_8MO`CPYj7;SGEZ#%D&lFLK!CP$I?P`!?fvz1;6H2gUAX@}sg8+wOB2Gv
zYAsQ?5wh(4r^q?Wp{A_zr&LpJ0bI2I=oAB7qpKvBTqp@Zq~u3aI{gZ5Z8J2p3f$;G
zh-ANz8Z>u1&gk7krTV-v5$23PNtioj1f$^d(_}`DsH<6vEt2$*SeKqQDmyP&4cA)`
za?Csc^T2GTg861}`|xC29F!4&v4)S&5Zkj5C_F~wZ+<wH_35woY9~$7Ei2*??wUcg
zJhOl74{wYX;y-KH38erIYLHkO6x$7cc$x^@*Q;n8))tj*753hJ+3Eg%s6jmc7?>Ij
z+2;6VNx+Sra98uR5WO{H*h#H|@lwg{1yxy)LzG)~DCgOakl=*`v9L4PDcPp)Uoy(e
zs)K01m=D*sAa!1ik%HBN@&U^?15j_Og)t1dGTs&mNAydH-9`KLD%R5T#rmEd-Ru%Z
zT0sa~12h_13IgBUnbA$?TJSS1*aJL8*$=2-?m{rgk)}X;q2|lYNCKq<?&DqK`S>U6
z)K(W;J~MLfdph9#W*2Je3fR#)`rhXEa9M^fMa*JFQ%e+Uz=8kxV~m4YK&Qe3yV_BN
zw6MS;BL*)zn{G~zpeJfW9iTVKa?4iM&+ma!Xej9Ry{($2dV6s-DP4CpRw1I39_D<5
zU=ztQHlR>?+#nMtri?Plad!No|1+xIXNmqVUa;No(*+0*bo0&HAbh10erpeqeN7;R
z{){lGC;)+sAT5$QP`P~hE!NvL-7PuWVIn1I*Q;Ou$)+Kn+7W~bAIVs(6%vRjR)2A6
zDz2G@1q9Kjch0fVPn9b2QAAnzE?0N%;1Ad0XJY0;VKZw00R8+*u761kg=1bwwyeNP
zD))5cTrK-sRC4y>e+wG-FsO7jz2J6qYY-rDT6g4EW_Rw^^dH&H`RZVJ7y02sbjU6_
z-BR=rc@(77_v@?7<H6nw(QL~7gr_>vVuw0*|1eH^M+{j~wz)(P^qx$>xJ66|%*vLE
z+##jHK8}3yrG}DQ73Q|{5X`|fyqtaKJ_pK6)+Pz+80b^r^c<Vp0Q<^7F5bI^$d!Y3
zF7=W2tq;HQZU3g5dN=A`@;&aY1i6vK14Cad5n814NB@2(A40JaXnLQW1Zthoi+^r_
zl<1nXO&GXGXf;oJ`qCAI<r3eI<cJ97IlTHm<Mm?x`fsV?|Hew$Y_Sm%*z`)C&r01;
zyOY&b>WnFV0ilX4U{m{HNGF`rJEfUWVv8sjjjDpG#Xkk>m5%P;(|G9M!7Kl_UmLWn
z8j9@!?)kV*ptI%BXF>vq1R)bBjsPQ_wUa6$;qhT~!MNy9*j0qWG6lXGNfC`m|5(ER
zO`pd%UH>^;Q2zY+C4?<PFciv)ZKWsYV~Au3kCo%5qJ^>7A?bpgST0?iUC?ulRPCu>
zQT7@L6x;H}sJ!Z~m_^9monVaPgn)Uc!^Fb9_m5m<12^u(HbKG8M0?sZsu`YTI}q^H
z1m%3T!DLcHk4S!p@fu{`TPy(z%w^;Q_8O9H$kRgbcH?jh8?5f%hXK&#3SrObGBq-K
zfy#y=LU-xv#(2qkmp?4k;LaAm07p%i5(Xkw-K7^Wj}+(>Cy@~w=&&EhPrq!P+Ds=4
zwX)o&b<)-E6^FYmazHD%T9@&|r#tI>%U8|*gZ=`UJ)CD9Vq<tyP0)<F?j6Kh-TQ~g
z`B!e1OE7X-@fum$Sf3dn48?nP%J1_z@;#Z+3PLQ}#z=ulnAqb!Q!WpKw8M_~9i?Jk
z3fY^Toh@it){}|Ox)Yfo(dsbORY4Z47us%$mz=<(^3VyTA3>j&kuRThhK^3X%;j8U
z78oMXXijA2YKE29eUnGZv@`C$F0vB=!cBk)Tjj^>e+nDHJU7<Dx*yN%N6qO1Sj<F6
z0~-ks813o}rR!<*_%1u?YPNXnHJ1k{NM>QGcf;@9l=0Sb!s%4AvE~6F;Mm64g~C*$
zKr?yQY^dT-+(1@pz{;8u2OQyzA5dp}p}uP0{&kC>Qt#~$gnSBP$W}?50QYEz#lq~Y
zuz>aqlu9YW^zYc&U0?ez#S7#rM~*Iq219%Pff9lSV|#fG-<2z=5S|094WVXzEu>~J
zA9-ptd=z>^Oz<ZS*5f(dDddqbAr{DHHO%qaDqdar<~M*8%bNqdF*Uzh8{78gFLLPe
zkMVPd`#lR&uNir|eS-QYNIHk1nwfTWl6L?An|eb)5llP)xa4PxSR!L`EQ9V3QPU2M
zE&IpRfle<#O&$TJ%kHVbOpm4J*h*TGmhtwn_9EMlP;<JP^J&1_F94$T)Ki6s7$%|)
zjU;gj3q5Qjxv!7dbn~xwpzMLuLQtuczeB+57JUDc+uZ$pQ(<9!BTlT_yf-KW^0QDu
z#|bfeZlHoS_gzxj$e~l`$Oe7nvuFEgofD7>t)S^JJT3nlNp~k4zY&l*!N7RxP!S&2
zA8&}@^#Uj9c-M7*oNh4j>=Y0rN4yp_%tui4Ic!+hABHGs!H{UX#l|S=^<dNOp^aiM
z!N{ucp4CpT?*iLTFsw4j^erG36Sc?%XMsd%2x15_qf-19;pt95?Mn9#Nq*?#ul5!8
zvCP{W87^rGbMiPCC8kV!@o$W4s7&4i4ff~JCAGvd&$p0HAv@?tiS;0B&q9d$^w3B|
z6;co?19i!u`3l<$t)qcRlkF{8L{SW3PPplViS~2k8%g|A1C@z$893B}*y`r8MZIi3
z6ug$bdi9jt4QynW4QxpjBC?9WG4`PL^$@di0uet#i^x6xD}_Tc=)t~z@4+9h*pWJ!
zodiYr<Ssqs0|HX0gIiLsc%cjxlQtj+DJj>;qFdamJR=A!kDeJ<c|j|(6Utv59C2%G
z?cMo4I@|H(>%RphSoR24Tv+Hob?Wfhgy%U%hq(_OkXJjk=al-M?;MZ(9*yA7`#pao
zN3C%8Slik5&zRJ|<i_^Ck>fpg{lp2?<@God6W!*ii}?yyr!H;}I2!2IiI}fVnZ(re
zIo{O_<C`g)x7%E!(#UdK2bjkQdskCEJQYukx4oxc?{~3qd|zk`gNUX2c7n7(g-ot)
zaT{?auCXL@{5~_CJC6GVI(1|%FM(LjB2$*t_#zLHp&8NF`(5u3j|(YzMfRVgGw89q
zE<Z(0phxcM+@Iwa2P;yTr@2?Y)4y_Z;pXMwlt0R>|2a!1`n)v%Aw#3jud<2d<cPfz
z+Z$@&nKk)6*A95T>^l*`l$3eDoXBt55FUbuM+5xDYqsiQn`)LeURmNh)3M7|D?bVg
z-V^QLmfjLDl@8SjV?kF+yt@1P5lwWEAz{=FovUBIE!R*RJi{UICKD08bUn*E|6(lG
zpiq1&d~}YV%KPiciqxfc8{|oAnYl<sGv9sO4|}ccOJ&q=5NPm&6tJ+1lhabf-AQ_;
zpV#6f+3Tpe&(RjS23h7!9qN4gQdS=E>O3PWt0z})M_<K-<qew0FTOC)A<U5~4`24D
zy5aab^S+(G9S4OhZe6$W5?#(3(cov@W7d9uz%3(@U#cF_Lq4}=<NST~Jw7qz^ma;U
zS=*Sp%V_Te+s_sJPlMpJ``WkuNAVT^vGgI86q{BR6nNMB`B3qGrXLxb8-aalRY9vL
z%#SXbLZ9;T#qhdNNqo5bbTJF7X$H28Y4<4;E{J(NBF3>Q&=husQ8RnIeYR2J@cn|P
zNpm>0qK%4D5-P_jugHlK*QryGXY}BQP`zBKPMCB~Zk1(D<_e{7M#2Axk~}#<C{Ch$
z<FEbcI&3>?BhpRu@!CtOLnle%+kcgHJw7ZbykPv2yhBpD#*WY}i*G)#eXl(58{s3S
zSW~l?G-A5?UgZtR1g)Z)t!vR8f9_l&0h)!xLRVw_qrINoqzLMk7&O!A!hWX@)i~w|
zzM&ebP95kip_Nn*6@&f#=7pb<YHZLdZAlIGYptXPzvVuZh8Lswnz-jnO%6`oqPyDU
ztL3fJCz`_G#e(@@IID!6$-O&`bjA_kZ{P9}lSF-wbcPFJ2W#9Ci6NjpQi$xGrZH{B
zSmlyAIpZWN<wcpHl|zAbPouc|O{nw$MF_QJNBTt^)O_ydd>15r;3#=(efi>iH0o9P
zaN?RLMo|GJi=3qE{iem$p30KFIzPS$U8nre&c;(WeKJAM;)LQNHqjLxkpOwTR*aT;
zdWhO%Dpy-O(Haf4>vz7lv4V_Mz@qKafBy4P-)j|3dpAuLiak)>&D`e)Nia4_4h2I?
zK>z{P2==4Uy62WzYEZ7uVB1h?rpvbv6X4PA%Np>)D8epjFTCUQmz2#*@eVm^V--5K
z+}=Ib)Jd}qyaO;E>4EjjKGrC9PVFY^U_RT*K9!4r#zyBVC_Fu63ZuaZkz%V~R_AMQ
zjG{mK-Dg5>Z)`9Xa0>;}3f!ghKh4V#&EhZNFdi?2C-<EfuhuvA@6bo9<Qcv%N|4@O
zoxY=(p}BSP;t`@rCmnt-65Or|gi-&sF*-i;?VR-Hh(_gTq_ZkdRazgiS}$b3<A4A4
zkcjALmX(=y`p!x<-jboaBy{nb8==yh(K?5QYkYleGK<$BaJ;ARF_@u2qO|~qR3SUC
z9p1>_(_fyC6X+#y7D2Pyy@yVHmJR1b0m-`d{g0{eq6J~FJ2!92U<BG5{0<(B)^|%w
z>ts`~>LJ$U8v9>TT)TyF-QFY>+;fV!pO<-GFju<TL<jl}jq`chM4gvDv^>?V<Wxa<
z8y1#jcWZ%fErRRsSHFQ)vHSY2H%P)QQG;`vq>q8n^#Iyuc1WP!4~<eqoc6{^u#gfC
z_lB~I@jCT~y<0sQ2ahtSl_Cm|v%GB$Cx5-*cErr_<f&d-n0LY3+M0pWBl`NH^SwOZ
zrE91y3jKb~FCdJzz80cTI(Pf4-kX93G!APEcIBos{oV9e@2E+bF6;{((s5X|dotDd
z@Zr6Xy@#vyN(!2VW&EeC(bIv9H@<&YsqWX6+un-hUXt*K=4c1%;$LST7*;-5)54QB
zA62$A7KU+iTBZ4EfEeoim}(G9B`klZF-jiKFX7eM8qKovVl?n#6?ivRtY_(sxw)XJ
zRXlm8JD=-OQ|TZnbg+y1+VafCbZKljS7ed5cULgWVX2!k+hdY~!_=gLw1FnKoC^p-
zWPv;YMsxC8+P&{}?3SX)$ru(1qZWtn8B}qdNRwSeMP^&~T;$`!1U%mPY1;Z-ZTnft
z&kcKiUBHA)IWZ0ki=Oi==6m)Wp%<C!gJ2ct>A|n>U90bby_NHVZ$*CLw-?NJH5Y`#
zb}7;_&amBr$m?F$(XB&wcgq!Lv+w@I9#{Xf`%XwM`l%Gm-p*GH@85k&_|GTDW)A(o
z{Nfjcg|K#9tVHQs*C6taAV~jdUP4VPvjTE&etw}7;~7x}p5y1L;>4H=bSXQ<k~25p
z5zoXc?|v-j0Q{~KTI~yQi768Mn(eOh%yWZ|9l!SD1Uz5h?CL4_wwniL{ork0Jl!-l
z+qc>oim4jqk@^y<w(9|ZxFDb0(yCt}h$Ejp_vsHQ^znzcQ$}+Rb9c+}oaT(5i1qlE
zw`<$uaPXY3ciif+K|R>McV!BqN1H2$M2d~LGFy3Uwg)VQkQH*d4Ce=|CGz{vouB5N
z|1IT0T%i8a3cX$HOSSCp-FTg!Ppba!m28$*C@QJwJ6mkC=d|U66==_}`;8a={f#KC
zEYbanpR<`nB{tqi#bxidG^djK*EW95W2xjhz|(FBr*(I)T_pbXRS)U0a7_z7T_Efz
ze8i~!zuI$km}*x2{JB8{Tm;jGg-@TFx`_w?^kmo$yg#x~4>um}Eb0AdFul-LNk+21
zDXOEXB(^9V`l{b?8WLz}7jTNabN$`h7cW|?okG@cD+iJDq<O|aZmkSubYys!xL~ue
zN6r<8mrkd1MMS`_;q-WdF6bZUEvK>WTdRTK07vPDAPD)n-)gBAN&?p7yow6Hrr16t
ze<RpH$mBAckSBSX>x}tS{m7?Jnd}<rPlAG4Aco4;7IbWTqg=5*{g{ia=YD}gRu^LG
z-m^JH&;U0+WavD$ufgx+C9kQ;$^3gCuNX)8-0JB8*V5X>YSEdQy<pR~=9Aknnddq`
zvpit1xMp8JSI^mmV~K5Qa!Yza?>l=<Eze{Ys)rn>d-=Jn0<dMGMq7=1l5O2Zw$07Y
zFu~Y2`Pk)FnA4iekPHkjeQDl5w|G3rt#^6hWBFc5&p+Ca<~Tk!t?D!X=p7h!&0+EW
zD$48X(b}tVYML=3_HQz84^;<6TRBry5;1Bb(O}T!{g)oBzTc0jebzO)Iu_5bG(Fub
zhsJ_v%)`_38I^ZK*N8~#5)qbxOsG8LKHr$QvAO=SfZLih{e8fjna^|WIgFM|)XcKn
z+Hwqdj2koQtcyh*Y8{+v#hw~+Om?EUAEH_4*s`gQWImZ+Ev(U8y%A~b1+Q~uEQZ`N
z`jJp8+|`}<b^QLQ;iJcu!P0kP*9?qNG;pVO_G#`9N^1gGg|P?4nML2UUJkTRS4in}
z$!Ndn6BhP&Q9^?(WW6B@DB(5}D7^F!VnDkrrrQtXkCW9$zog?~9$<{f06T@uLMpbe
zp}SPKS){8Owh7uQJee?aTd~h<YB6SfraK)yZ!;u>9gUP-?JKQhqi-W%=#%u6?0O6s
zV?)t3eL1HRstAcgY)&}>P}@My|E4e}C&)q2N~@-iSASmm>^w^>Zg#4vd(%on*Wb$9
zk-~N+C|Pvw!(rTrA@u)h>>6Q%OIM^p?ieO;uf^*fPjf=v@A`CGoDG_d)9om!-mlVn
zJE`_ZC%j+SYF<-fXvvj7$62?-*C+N`uwN@9EYMxTo@!y|Jj%Qko>_;<A@FxkN4jpz
z?&n%!iY9yZdgl+?p|QP1K_(w)1uCvMxvI;XdRb;W*?2Fs(#zY%xrS}mvMlTHXOFT3
z=n=6FN+*=%nwes`vIU?U$NBl76w|4$zpDEg0#=P)uLcXn#q{lL&sCvGwwJyPd;N!k
zG6<0E{MI}1uIPI42gE8}F#K!R<rT}hr@mbMQKR=u<i`_6EyQs6i=`jV`#YaQ)sN#D
zGWUbyqc_NE8C+4`EeW}qUAaR7IN)b6s0ZL&y*BlWH<xrw-hHGZ>6SQz@LPLqJcAzo
zkgb)n&P(-AS5{8IT_hisQ|L+dJZ9jqVA-=YQ?Y)X&U<54fI>QXDZDnPBV8kSRXtt(
zMl{Td4Pqo<)V@zzh>oeHgqJV(XAm$0YOk*UCsJOs!a}XGtLuR0!@jhw<w_Asj}WKc
zwIN>*9G!C@qv&OE@p`9+k)9{01=XtAm~X;N#amfI{xzH0ccwYH%{paUru)wEmVMSD
zHj_v-Ei>;U1!T$GoM!G<SOqctdYM|mPo5|eaY|Xmkx5#yBIomZOr?O{y=wTbav*@!
zz0~l=0H6Z~7bBR#Pj@L{Ji;oix`(Ix3;>0Taw6BBFwHV4o#Ihx&b8?yt7mEv@3(&7
z=R|9K$J^gI`YEe0Jfd!7L8st;8Kpq;q>f2I0N?cWo|Sb{t_d33vKG_m#!P3xt`zIY
zp9xU|473c>Tl;j9VBWOmwzYxfUw!wNUclpgB_4)Y;~JV}O3#hb_F6BOxjI>|b;{w9
z-$WeaqPtOOW=7*Yapuf!J#%fM6<ayb#ktmvv(_a4r+M=u3~Z?E0$taMPR|ERR)m)(
zg_+|YIIGU|<O}s|#!yb!4o?kgzhRwB{CbXbe$`z)&ji~;|11-6sqW}qcO_7|y`D(k
z=^j#CWrzFK7VENcN=S?-W+kVdK4m@cU}l;--Of~fkW#Is+0L}MZ@;&Fi@0+wm2<C3
zno(8WoK*1nr!eWzSTt+t#Tta{6CjnE%qjF54qi9#Tr5fPOH1o17;>B&R_$4;@D!CB
zs$s57+jLtPPe|9W<%RdS63&Iz^$Pcxt?CIRTa&&l1uu*?Rbn!<6K>^3=v#7N7KcNF
zYM+?5WPh$XlR|!bPdiPO)npQ8>MT{$w_vE)_WwDNPW3sZ-Yve?!({P|G}*SCP(~!a
zem!7Wj+UG*jOs^eH)aOWpgFtg+d5KPjq{}9+$K~MM%DEEUuV9gwDuMYXhjEECw9~c
zwm7kCng`Yn*TvV%85l5kcYsLni#tJf6{0#=?z_*#7e1HQ)djod%&Js0D(WBL*1qzB
z;P&llHQBip$Fv!T^@aPOf#)cMe#~8PHu+8E<s15(2QFTE$@QV8X6%~}24+Lvpfi2<
zTI%qEMU&NT7WAy!CL)B-c%P;FR-dzI_vVv#nJsmh%dcngMq8OstdQ<>&vnq3oTm^i
zlw**3_eQCCY-G{;IAD(D9;^IqJm!g92~s}h1*nXeNa6@hO0&JdI>%(9@g3sWW5LqN
zJBDA`tWPd9IS&w(W7h`qOcm;EB5-XS2%G40M)sP!;MJ2oBIf1sO<c1w%{<xC+IbR(
znC!Sgl@)tcC#g>b0)^VWK3+!-b7&dx2uAB~iiwLzQ+6tpmcKBqYavF|yuq)unWs}?
zy?x2kj~Kk<XHbae<8Ko#<_oL`1UEcOZ#@nG2zdoNyWx|{?L^&e_1SlS6^A#DJq8M|
zonB3qNN(;;^Jxu~m}*xkol8~G910ZWK=Tje8LltN<;@Xo7w;y^%XMAg-g|g0+kp8M
z;g)Pp1z0WcmRoC>3VsdZ`lpE%ss22#URy^ygGgOwO2#p6lK0eWD~pasp~GYebwT?p
zH9^c=#vli_?YZx0*3`sRmByk<v`Rb57?;aUk7;EZ(GeI(OB1hUx>gX>57t4_xH@8X
zmVUvYa((&_g;8G<QDtjiYK|}qa{J6DU)DCe(MCJU+kRK`r2R~(753)U(H16~Go?A{
zRmmp|?fe6}3%)NyI)wJPo-kF?nHAse<OPQA*;5=}VD2@EOZojiflMRj?wwUtS(Ox`
zU)##}l)go1J^l#OS=M7TqvA!Zdzxrmymcg40PX(GV|&xbEpc_e*V4@Z&G?U*ILfH~
z%KFjL(W`|v?!|UVFib5`&o4BDShhNPxQ#8td3I3S^i4j>7`l>{J1ytev6gr^p^Its
zm`i2fPw;`AkYcB7u9YVgh$5Lp@zBB`?sXDfLx-7ZqD0;4q1{0JfdC~kXeS^bW(qs@
z1cA2{lNkBa_=bw|<9Po5W;PaFC_MrR40vi78+DH30ODu}S*4*VmtH@g03gAIi)2^K
zBbpQ@8Bq@AYnCV`L8Zu$+4pf05)$sq&6+Z1d>t*4RKW&1g<fq=jq5X&7jaNvj!Ld~
ziq~S4yxI}B%8{<IzWn7tEE#o?B<pV92A(C!qdIn0>TVN56Aaz#w%ZiIa*vXF8&zYj
zoo|XJp(L2@`fsrrz@SqDh0#(ir<tRz+5tgx_*>FV1tt=NLhJT$HqoY~CK+Xk)#q3G
zy}dgQpWfPhPz%VpeB#zY_lt$Kgg0-jp!h)u4jO;Z_38;mk-WRKL*t08zvdPePeG@Y
zpUBWG*JD3J-*SyK7?_CINH)=Xqm99B`T!oSVQMy9Z3N46G6RDGF?A)GE|4S>59XVB
zT071Yz31vGpE6)Zx0ha*C-R&%e97O|osk=PrbWMWy?gkCo<wP;u75VO@iLp1_^9@U
zoWm9okN;<%M%w}(&!-oJA68n~WXxgs_5lg#&!Q}p-MJvA@yR!>%IU<-GLjSOc*SuY
zx5SmV$qLoAazn$_fJ;2{QGUy~v`E@an#H4{Cb@lmqchZtJ3>~wjT*uguQqp241c^Y
zJ0c}ZsZXqi$`ws7>(5{BnQC>a!5rnAUW}Jt%|lwf2u0I6bOzq#gr65MH*KlNU|Wfu
zJI}%Mq1rl(7GIc(oDH_AUOr97oE{|-6)Rd;a7H4qWuh@E8ttbhYXT8(fc;zjZ8k{}
zkvTAt^<PUIncL&g=Id<UHGyXpMs>`s=y5?r);y{tY<<{dg<YmWCF;%WV=8@;mte89
zPzV?n(CW?hnI$-UKT%)d=%8d)PKE2i%w>Mj_qAKV)6(s3jInMH@S~OnHihQOshvh!
zVu*XttdXrDnCNMWd3)iB2j|Dkb$|4gQ0jAE6x?sUPF`Q$UKX9#Ev1Y0#WGG!n};e~
zX>PKdp31Z1o=e9Bm+`#WY?Ylskr^SweApZ2GPe=pV}Qpr_sVngSoJ45AzAaop8G*=
zKX*i0U`8`jh|q(p)KPIY5wQ$gd#7~Xm_xmGMW08(>^;}z2Vwm7f8UT!HTSUY@^%0E
z%K~cMi@o;S6-ggAB(MuzS0-yVH7_mW>lQ6~SFjeee1q|}iS5SAuPuqPYVH?2Sxluf
ze3N=>kGC4HvkgS8^4z9y)`PY5%qZV+XJ$=nC7$bMNXS%hzj{Blc8qHn@A?;_iffpy
zoxhD3XmcVQ!@KMK*T6`-l_uJ^{SQ(pI!SlMMN1nb5b^v{JDzB9d}ZC7A(pq&qsA$K
zh9Z~|!4q?>g_0eF-LX-mkVQwC3>9>C>_%}hB?Q7MtvoK$$X8An0k&g{=*G+hoe^{7
z+Cg{@Ng`DQUBp|Ww0H5;lT+RkpJF<8)9)gmtvz+W;+p^<H+d8qJq_mVUvcI%TYsmd
z;IJ?OVJn_@TlsY=D9?!HO5y=d>Jkp^Hp{^dEpe2vduGWY9Y+tGN&d8CO*6Xen^=>K
zL<!f5bM9mZE$OKlcxQQ)#3uTrqnVou2d3F@AD=C1B->dwWp#6p$OJxT8d0gZ6@I_Y
z14_IN=JB$txw*%+JxAaOK#3j|Dsx3;J@s9TCs+lV5jn)z$RD4n=(%m{;GjhAOW<<D
zacjDp>j4pho}$iRh;@YgMpjm*Czxe`z?hii@I8Pu_2H@H{mN^OaXos>Llt?~B(7z%
zPEIzyxgD>?Z?Ko_V?H`cR2XJ8EZ#anA$N4$379l=mW<X-z}jfqn@8X=!6-fdf}lTb
z$?a2{XAooF5*0<$J<nM@w`aAzN75{L7e}!%{BN)r7LzsT&cuXhf%K4p+Zl}C35$sS
z5;gZTmkOfkxi~GM$-&TA{BoOwkZph2%%YPlRU(0Etg$;UVd;1*WD?m&8r(QGrM?BQ
z<iC{n@ADiS&$Z|bTF+9N<_w+uQjiv3-~qW1@ndEnbGjwg;R?XpFRJ?Y*NXsS!mzuv
zLx~#zPXMak5#svneyOx~*fumGsL#pM-Ncl~Y<_*8$vhI>n-Jp{^IP~NRrY_KNeBqd
za#3I7#a7i!s~SJ`$&MvOM3Kd>VX>2hPyr6h<j%o%R~u)~fc5%`mGPo*NWB1$ByXF)
z%DHZ1Q~CzL+cqAOy)29U4?GMB+%dg4`}`<T#QK&^XfJFoGs~~{*gC84-t=hGfm(~d
z_D=AW<Va26ZxN`Fl+rHhU%bOz&E5xGnYC{<wM|=>#Qo>;HPyHvoebbpx-TT6s@aYt
zsXw`sf&y#u(03^xnsJ<{^S%f+l}00%Gn7=1@l-u@3j`2znD>t=hz<PJ)9Mg>f1l`R
zs(v4s+-Bq)f1hgl@uT*ZrN%*QB~8i_m;~45KBcy{xAz!(?sZ~jM6XDw6L7Qlw^qlv
zEG*iF51PJF!(@Ld3ZoY}?*^_gD>A-vVrYm(jha1VmWggt#S5wvhDjq0DdQ~mODYw0
z-1TV=Gg}E<*$`tc(8!Lx>Eo_XAaxlLoI4d?Ue?m)KxH3euDoF@_P{Xvs%xitEZ?-m
zHRGD21zqc1AD<rf{u~|>lBa>ePKXtjN>qEAI(j(hD$tN30jdsEcztuP>3&OYunZ7b
zkJRJCmk1bd>=pj~2JF?2Z%gA9d0Jt(QgMDmJ)t%uTN<dbh$WDQYyRAZahKZqm5-M?
zG?Ddx@W+31R(7v5*;cLBd9_V*8zZclV%w7}uJZyc(`o6~hKc#4qRYbxz1dgV(@fWL
zeuntfcOvcjjGJ_9*e~Ir!s_YLB!DkSQoC+d5W~$0jb(~KXVEq|w*2+!;f%$55E>d8
zvoI*)!wQmQaH8Ci2K6ta)>`OqEzn+zlK02P%OM#Yj@c`<;>KmjV%-{N;6AX}zco2@
zbV~-~>#sAAqU=sV6Dd*}p|WaA4}4El1q8iO%!c%J$9gZTR4kIEoN!xgl>q2)T}^5l
z9+so19Wp&iHkY={1r9Q34q==2A8phlSX$DU+M%bb{4v%#N^!c{xkhNT=Jj`%%UfGT
zES&xG#s!I5lvqcAQ8ILkA6;2nCj}pFsK-l!hLK9-JeeM^U2xw}w74vrUdXEq#k)wk
z<<{%zU}V&Je}tzeXB8T#4kZTl+wzr7--#R3+&^jDyW>4yTD9!Ycs$wYds4x~op7y_
zO7cis5BN~VYhw1RbCsw2Z7XQc;;6(OY~9?#knjde91G~UY@YFW)5^}bx)|LQtEZVQ
z-EYsGXEyC!%o36o<|O+!4D~o*zgFb0Fx!YWx;1JwuBs;4VV;rv;i{KfX|#8I0u4}{
z_wE@VqUPu-bKTtDDja*s_eZ?f+Ckd8FetJ|wyqOn8xWf0F#aPT-azKhG=L!>$kRST
zmB@&vVkFR$>?b=Vp<09$2jRWz=3*ywp0N3n9L(kRC3ztKrDaXvE1<J@aRf_^b%+Kl
zRt715{ZR_3zw7FVdH&0KOWSy@9M6i>sYvGm$`!ATub%6p_bE=y%ba|bIgL3%jq-Gd
zPqCd9u<FdT0nW|jbX_kOkdBH>O@O4lv-3QD)4xtosQ6Sw&~ql)pt+&JP80&agl@5U
z*S_c{^SA*GjR0i!*-&PGHPd^$8Df+9M|nF(AZwIZd&WBFC{u4!SCVw|Ja9*amLt45
z!C*S_P=usf?eEM9_Z>aJ3;m?d-lH!W7oZZd6(Yt8sF*w;i6yc?&Y?rc?4B8JooH?M
zZM-phxqOO2<lb-spG~i9-bX^40(dUgi~1-GpKF{BV`fmF=g9c@nNZ5AVYySR>yP(z
z;0btw@tLY4nhMEtBMsxyH^irVoY2`ZIJ@KFD7O?P?%@OBY${y*cFzD<MGaZC(3aXe
z6+r5VT=Vbw{+QrGU4No2RakXqLx=p|5cPHM?Em8PVXw8F;{V(hv7GqakvL+o+AVyx
zr#)RG%d(>f@xrzi5UX0WGCNoTr>JHzMVg^5H(j27krMBfpp|=`e0+9s(E@<fp_<d2
z^FcuaXDQ^DCs_UdWawgLw`f4v^kN)c$AHst5tjLO;w&bffzYGZ0{E+Tp;w;a4FhXm
z&~jO~kLP~$+4c;23Q*RT=*A*R2g5v`65Pjs@59&36#nUxn9<WOJ%7BP1j@C2RKR;n
za*+(!XYhN42&Fv6%ugE?{FM?AcO#^{*UO2H^_FbC_W&W_0}8U*qr{?sF`TYgCth=$
z&i7Qc5-cCR7-8hN_<TILTraUYw%W;;;rGb9=htswZr|?aD3ud6H|c}a7SLW9r{K;6
z$=ijcx4M1W*dANcgN%zCXW%hQv^FN{m^6BC_o$7|FOo=%ZaoFI1DPgugKI~mA#*e>
z<g^vDLxPomjtR&Rs>WMqppStJO*z1ElZ2VkFq)owicw-JMGs!rFneE*)K#8lh+Ulg
zWBBH4&*qe(#m+gX#?Wha>fzJ;GFII2eyyty6&M)E*BwXIi6PPU0FX#jyr{IH#oj+z
z2gsJZglrJcM0bAdl9P<WXmo9%Rb+PKmuda_C42})#MrqRJvC+(aX%)yW1+i>Q0w$E
zG11W3f8h*hLp1m2@Me6+sDMDCRw8$Oxfa1I5O?r!<GT0Pp<h%WSrEwdFT6>SMKU;}
z^*-rpfDpp@Zr|1k(3`G>K@$Z8ekar543toGH;n+;X5M)bND6W}dy0$=>S!X-%mT9Z
zbs@fxugaghf!x;oQ`{mhxAK}s8jk0k6?x#+P;Ae+z14$P^`ybp&;Yb)-jSXblA0R1
z7V(YNo@LA=@Qv-jQM>O<S2J_kydY1G7R<mf*hcq?Tmy#DgdG-v->JKL*mYXnW~~+b
zg@{4LeMyM`(m|;+=aj%$K%Yr&e7?Ss%|+*CCuggiWqtqArgeSo>Y$c%qU8|?_mF=t
zn8!6le&x1Z-O<6rAECTw9k3I+0ry+a6Jx}R)z|4HNB)$7Lk0j%f_Egtx$bB7&wAwo
zNarosb%<eV%--n;Z-)G<r2>!#7}-zsh)|%~R_nqog$SOO@;Ui=18>F>v!<5g$19a$
zR%Q{ji$noAho(%$Z1p^q*j@39W;pD{CtZJz9pPgZASKk+(n4j8hD3MIoxe9~mw}Qi
zyMmC!GB+<|X|GO_EET_fc<Q$7Rkwokgl~`9zNL6GGe+Q3<jZ23;*G+9zaMR3jN@NK
z?14IW=;S>c!g}(L-=E!vj_2-xfDD}hC7*MzGj{^8h96_~%lO#WLdb`Z*HcQ!9LMeo
zOP;u(;IV#~jFGlzbw7ElG%d~gD5rZOpZa>_U##74%1(=oPm_Ymcu1+mc<oPCeJQ&M
zpT)l^MJ66W32amT<}g3Cc3$iEAAj!VG%pdV&_x<OyE0n^J+R8$9P@K0lP?H5MsM*V
z#HAb$Fqpr!m@6vwY*b$^R^3aT>HRk!`4XXvkw4BZ<!F!ydcM-pg<t<)bbWO|lv}s=
zcnnk|lu}Vpk?xiT0qO2my1QExkZzEcZjjCaq#GH!k#3}$`SuK+bI<#J_xjiIIP=W2
z*Iw~k{e(Fe-V;l-<V&rV3F6Bi=aC6eYmn2v;TWKiEHO~1RO>6QaE>_73y$m8%wn)L
z1k?2I3kmi{CW9gv&0_6wB`ve4Bm%u>h+a_4`Am?$ofAZtLPLfCRn%rKn&RRzug|Ij
z9@2*vjpOiN>R4$0rCuw@{NR#FzrQ&7;oJ?&h)CBP%D!s*flTw7BSK9xOG92?em)9X
z%q_22@*Fx5xK92*`v&d<z%%nVxXY~NwL3p?E5dM%Skdc$IKEY(r!l_-HDmyTecPL9
z0hJF5Wrn|+eeoWXB1m@EN(ga(?DT3!J<#%M^{Qy@k)`$V$JY<uOhG)DlJctJGUipY
z+Bv$J%yKtNh~zqq>08W&+EE@}ddBMS5daTgPl7RiCwohGb!tJG$u0niZ68Fzu+yZk
zRpVpZs_%kbl}0`sZSF)KfnptC*nfhw)dHfs;qJ?AL|S}??CPhV;Bo!y(L(Rx$;>w5
zY-HWZd&H$x{o@#b7#h=6M*B~kW}*D2DT40NxCJGKS6l(0cxZd1K%z6ewfwnSrg&!v
zkGtHHv>2QaLaix~x&ihiQp=*YU>;ocb@d6zHUNt>tnau3bpV!&2b5rO&n?9y7pNYB
z$txrilFW{ltVWwdIo@UqznW3gcMB@nGqZ#`*&`_wUa_&ssw6Ce&<luLE3>qWA@^H`
zFCen(V#J9JRdwc-T>Kug$nuEBBoje4AP3FfCG$FRGegGy&U^zb67E~%P`j)nI^fx$
zJ>{f29|YlV1O^i#gbtMGHETjA$aTs}=F5zlDHU?1f!QEU%GStJWHthZ*v~)Ch{O7H
zk6e{+cidnD;|a{A(X+2|T2aQ`Y^JVWQ{@@=1+|gWMnUkIJWvo0Gb$oaLEDq|`JMKG
zwAqL@kPUtKgpJ?baAN366Vw+5M+e$Ce=ZI{+{Np5MCRjIR7zAa9>MdCAOF1mc*%TW
zX+U{Dcez_~s#!X;siT779Vq-!Dsk8`9gkJWoiaYw@N@<>X&~bOLLMg_VcsJ>Z{MfA
z3lUiWX`F)(F|<Nc&L&Pq32%0Fpu6*}<rv(`{7-!`Jj6`KYYs6^50hNBf3}-WvJ8f+
zq(^$h&?cu=juyeCfmWl@P-V5><Xr<V>p>Y-ar(=b4>nn8fue(ll=@(V)Fb|MU=-pk
z0nPgWgxBRNFIPFrS{LMI=y0(Qhv4K3TY-oGdpHj~ftaHdq+`Gc5ay%xfiC|LE=9_h
zA0lSJ6j=+S&8g~)8GuOM8|7%66X@*$ku(-Vq+fffL=f2s)uSEwN`z{;3iMF1Egl^O
zV>^>M=}mD<dwZ4wrN?PCFj%<pP3hs^zRAGO4+f<k*CJHHTWijL%2q7Fngf*qoi}QV
z7sk_%XH%%-E?|So5<~k3MNp6-W0EX<4I+Dh8ljge0JjWgg$RpIXg|||Dk`cM&)2Xo
zWy|~>gaj@F5j7$bElz-sF9Q;WYZJvp!X|4I<v|x`zy~*O;NI)F1gS<gSI3V`+*c<z
zRnv|LT9Q2oUh#CxF0KH6kXz2z`{88;qhzGFN0zB9I{ss4=2T^ZL9v5nMZV$sw7*<$
zy_!skiPCRiv@*AbC(ZNT0N7qu7I=(3@s5)6oxp|hq#=lXXbqkWD_ur*5@(3Tgcb@0
zw3#%3-mdbCi4r~j)6<=XW+47_?|BVQPeBT7Z+F)(Sd*HE)%?N{xa<@CAl@0dJL}5W
z_{N~~;`E7LYdb-n-sUTWrs&-Lr^x3A4>OReq-GFMsoqg^9awarG!_w`x|nt#l+RNX
zoUANR<H>PT%^`@;YxP0fP<|GPBNo*~hKS<+bPw`Vk^BD5qF7r{cVMC2z}0pg6m4Z_
zoIe`^mj-fYzX8|<#Skp@h`6a6@Fv>W#Ps`~kwg2r)n@-C?MR;6yIEkW3)CbV@OMQC
z5~q3{3<KI44(LX(iD5L?GXB+0R<2Sa;lv6YFuJEH$t<R`WWJl0hmsnU`Ia!OfCdL6
zLN74V==;p-PO{7=^*YD-(*BVm>6Adljt8jtL_uJbc09up<LQUJMXB;15hQM}8jiLv
z!x;>y!Ah2o2gW-NNL6a(@c&(13ZfW6IqXA0Sy$?o3+|FZL8h{;qsbGUgrDMNJ3<#1
z`<fL&B;EcIq#hL10Dfr18VGk78Z`h&T0vOEuH7;T8v|9qP2Q+>YkLVJAQmqGVi2Gq
z7gp!wrlpn4Xb^3(1=11GKR{VUB%8_FKw7~;U+jM3zw`-`PKzkc3Vr{MM}n+7F(@Pu
z%%h6_cM-v5Zjho}q~^kFdz;^Lb<?%{2U-ykM1<~DnVT~JI~jBI=ps#;S*1c`+dZs1
z8$m1mMKwG1xv-O^n4K|60+0!R>gMLQI19>eoX;bqxKqnnjSs$Vod8#YTsGa(_2SOt
zJ8EX*DV0odky;I;31TAv<pO)(4;CZ8;PG%)8pk86yk5Wu@~r<2m8=W$4SQYt=dpO|
z*Eq_&%`P(S9oF6aCwzmsFD!dOxeLbAp~Dp4?I<nye)3b`shIi3Qc;SI<eydpmjO1D
zuQJ`wvol<2;R_-rfW7P6Kw(P-(coZO*;8FmJp!EAjV%yD9Y)^;j?{SY=*;~mm~=fA
zG9^|E7O*Q2-lNz;zAq9CIF0?d_tM%8m1f?9)6pAQ-tZ!MV4WFM`z19mm83@hcX16n
zh<a>IRWChvkcS-^kC$Z3IOpkrf?GZ1Pj@hY_k2E5;4#J`nRJoEbhL5o&)_&)kE}P4
zN&U(Ks%mzgux=A&WM(fxk2Ry%>aLtkCffiyg^_`=?0#l0AX9mHtW*HXQ%-+WKm`Nt
zluUq|DKWd|OfA5f9o>rztnUNW=e=ClpC@3Z9wGdW4yl9Ogn#GM&A;b=l>@T;>^XE|
z%$=xnS9Z27r~!vU{&$2_%?33h)E@DnEs!<{QDBJqb_yGDb#-o9a9rhYh3c#JZtN<^
z;=51_MAaaHtl~j5C@|bVJX9%N20CYTK(N&x=k#FEBQFq1%W6!-13sk<;@-i@ryZ^7
z*e1$1T0;U(PuFXty=n@IQhmLH!U$7S^+D;udE1TaYd{0Y<+No@5dW<hQ+T(AKs*NQ
zQN(rn&*}Mp)ui!WS$)_~`tIM~g<~PuoYYBQeEl1o|6QW@Ld)-RcHp){Wmtgb$xT|)
zXFPdG=-5$v?NlItdIksa*6}TJ0|D?skwTaK9Y-4borg%+#!DawP}4t^kr!%;2}k&d
zHx=m0sEU$0j24@P32DK3@)VF+=}<hGf0tLDU8=pOhsWA!U8aqa4%R2H2IHGRev=s~
zMG)17eBp3Z-$KZ9sL+3W2_B7O#!xz8Q#x@N&uBc~g+pn*-i92U51AwR4{zb%ymC#4
zw0D!mP%$yM^gioP{7>E7&u408gZ(~|$IK6L@F3L%1X()y?=#eqykGAhL~*Cz7*FDh
zN*Z?g<hoJdS~5CZO22+di2RZ#D*^}~phzJ})Ka@=p)#=C<~(k}M>z}E_wxvuYeHL5
zG~V@4%yWkS*-wpzAnL;YpB)uA#cGN}7Wr}uShVKn$<F(KK1BSV9|B3q?3p8EAt=NV
zT!bbs`ln|P*j`(|U;N#{7tWu-QwCVuGpl+Rf1{N06^2A?gym-7b>%3;G6L}BUr01i
z*BvygY_a;g_z1nD6~lgl&2j#eS!QI2$qp0Z_~~E~yBx8S+tUFM@HSGjJI3HQ6mzqf
zjQbpY;um8c;rU=^ADhKmf3Y@Tgj$qTn;m=yB83BWZ}+O5{M}muzRWuV5HxB6hl4p7
z-SP0@!(YFCrKF^Qr3zockZc6eIHRTtI=SMfsyi>^r&>Fq2~z_(tWG59S?Nh?<!0@^
zJfCN02ad#^#f)xMxO5Dm#vf;6K|FoO$JQ9DjlH9dUCr$xk-DdG5^=79fdLc@g22GQ
z$TS9ztBbk0IWU0b0#W=RMeJZ=-B03RZVe}Ku(GBlb+BERNQx+Y#&tQG{<EAK<ukU6
zY!Pi=9*mufSmF772tjjPT*caO|B^F~>=68)#8%N;a3D~2wYEBt#sOB1g9(=)bOt6c
z5<Y#(ju<(bB)UDam?W`1wRk15J-?_axxG3R&#9C_Oah!(t4Xz4s_dir+%`8Lr@xsL
zP2?LaZc@AR)gK05FlcQdwsOpIf$RP_Hm1z>2%II7A86lqY%G9sAHYBUmbb1XIX1Ok
zAvw0N#v?tpwie2oSzP)&RCNp77AGv}1CK#nZw>D>+>KEKsfgwf-1G7C=g+IFt5~Fx
z&o~_|!A#q*urP2Plz@rmau&@cw#OIyB(`T4X(YFo7K0_Boi{yQmy7&f@^K&jMePm>
zX8Eq4g<#i@>FMcXV`HnUhHN18Nx<d!doGE~r2^zm8|6Bu<EBbG!N|piPK|`A?#}0l
z&Ji)SM<KDNE1vWQF%}{K*`GsRR6avh$5pTT@U7LNJ6=n95O!VMizpYy6BZK_6BQK|
z7XA_x1hrk0wY5E{wpoz`Z~A{d9(UB8cwqsB+C7E%sbC%5@83h;KVz*7@j>R?4WdoM
zQNz@OM=CGLwkY6fhy?GP#5GKD(mFVMUdx?Wm)>WhY9-Sh?#sS&rVBf@n{?{O^qjK&
zFu2XO6yK>}sIb88Dny0&rr`BAPle|@_kBH*D(km|QivI6sMGcA$20Lc-0TmIf2Z%`
z4c~(_qS5TIaTbZ1R9`&<h1u8C%lY$l8E5ORah$NpS-3l>@;^A6_cEr<U4S%l0d9nD
zl#;^@%5$HC--B@C0KExZ|Aqh_*S)!uIp*Hk>8l@at`k_07g)%DMSKwa8UOaD6cq87
z7x>qB|BczD*r$<-RS(Oz!WX|HjIR|{N5J)qSV}sJ8Vm1cfh$(UogV#gj<V2KI2D(a
zkcy6AL<q#`_Vq7Fim`j_u37}J*q@n#lRCT6m+7V*Zryo)<)k^EV`zu4q<}n2e;%92
zOnrG#v&F%aRCU6WcyN}gyGB&Bb7m^q6V0`LJ)@(MLk3wfAIkVB7_7r(rb_Ka0oP~L
z+G<xYD~EE!(`cmZ0A8wkohxF!cl{o0R9xhzJtfp0NAPXOpVoj5;w50P<MaBZURnnK
z0K`jhLjDkC&Px0E`S8qHUCQMgLYLu#f8;GpLlS9jS*+et#q6)p9gVRn6Upk#kGKt>
z+%$_=T>;r|u}A~V8~9^he_KIISs7|JG&!4~QbN9E3<}#{G}M$W%z=^tKsHLSL`^+d
z>H15r{(PyVWpLm_B@;&3iP1gstDy<So9GfrZc96i>(Y=@si}`T`#Z)&c)lPKm1KLB
zip=o7sJ!+q=5FMVpvK$pTwS#5N!bo>1cd)a(VSs3Y^okcD&|L!(|1k9i~-vlp;i)A
z4LVJJHrHlcoe$Y+;Av3pyxbJ#c^jYIouSqi3tCUcBi7yNv@tXQ+4Id?p+WR+sH5S^
zyS=<B!nzJ?9beO=ksq`M^c4h8uo=E}EC^P$vI5#S`x9glAJ|1jrq!1*UZ62WbH+{>
zX}0I|uQ|-|Bc(?&8<W#f#umyDI^<MjJ*tJdzYfcAH(suO+`HH18joxX{Aq=73<5A0
zu+DAOi{;r}b!XY@R)I#dYu@Sj)K@f_<V-AMb~}_5D2B?TQ+DTO$#P_6#@{?Mnywy<
zK{NEC>I*#1V216t+xrVG(xK~Ci$;;__gZ8whI7=Ue&~OZ?EDdzhdN-}ZLR-mHc_MA
zJ477GgN@98J}J?OM+4{5+09hqNtUaR)zo@GJwP_^{n0nehdAL)mL!4`AdqL*WO@-&
z3L-H@v&BG8#R#1=ifBcnIfqWi^7YmYk)L}Hx&aXX0hC0}YBNv2+N`;>Vdp!*VF2Uh
z5+Oh1$@S-_g+L>Vfs(mI{o^cToihaDa!m*1#~>YduAkKrJnZ~_Gk?rYX!!bLduZ3Z
z78>-m0}77U>6J@sy1}t-d*TDy5`g`ddgSo?WO>y0w=6=Etug;Rr)`PL7sv~Dr7UVe
z71=%Vqs0l_OL*L4>m_0I3neViXO)|Ng?q9Z<JnTiuBq3CmH7Hy8}q+XyBs~ZG;)Hn
z-b5W577P4!>@Y=dIaRGN36qlrI&bQ=)j2%LqupljzJ_L{+Ft7$q|kZpUmwYHurR6C
z@t{%=U+dHs;D*C9ZNr?l_P=6s_-{<TRtio~RfZPSvBV5HQLkMHUVk;>&sR49CI&Iy
z>iq@30K!dd!`%SCsk~r_<^Jm=PC|E&_CN=m(e<y6?5fwi2|~XJ0wR^mB><Xcw=Lx~
zxE!oH`4fS$McpxS0MdBP{eyq#?O8{~Mq)pXr2#$w<P*!`cNJ1H8$lc$`K-ypq#(b|
z-6cP^Jb=%JxgqAEpz>v}Qxn`QQZQ_kkw5<auRpXl6Uw4~P<A5X6>tKU${bzMGcJIB
zE|eP`GDi25MmhI`>$aOHxLxRt8?IFVi0>jW-HXarLiXb0Zcm&mE`TwO4h6RYW>e4H
zT=dtL%knyb{<MDUEW1~;!V?-ZxmhAXyThJ-4bUH5|8SL2IBnbIWqWvU5yri|lYGF>
zKnvBZ%<wSjNdn~oo?srx%xuQrE;YhANz3JT#sz+M?$0@q8VKKE>uM)NjBq1$6puIy
z&rDkAuPXYHGTRxf2jHVsp4R~{$7rDFgxod00}Tr-Wyar%5K{Hz&$VThs1D;Is0T5B
zbWKL&Umzvd+6q#qY1<MU6?C?FepcD-f}V#A+(Q;`U4M4&(BAcg|68k6H^7soTU>h}
z`ds!oZ~YDOA?kwH8l_ItSiNa?4o9s9Em^HP1995*hRoAily;PMLhhVv>Gk}>NW4jp
zO6_Koe(}&2&2oL`)qu8CW$T}B?Ra?D3+g&s`?Di%00JSo*2bQ7<m6|tf!StOVE2HP
z0Co>JId;z=pY~1Q@`wnfr)$VHEf%eSz1rWXKp=>T=$k{_kUJ=CefP^wwjRHcM7k_{
ztbbDg&i<r=q{_0HH()k-$2|*)<WCXRKZpnV7rhtYb};^R7MgkmIIF;|{_1Z}X^;5N
z6Na_0_?M?=C`!)1V3jImw2|gc^Kx4P{s`5Ux}$ml3Q4`0xipa6xJUT+cQQwPZmC|B
z-NG}kI$Nte^57r>-B;^xUPy6N8mk%lz1yQ0yEwx%c^ZXyk41-TW`x+Q&)6BxDh(=f
z4|8O{cLVhL?mU@Y*}zt+D>pH$Yxma+TJ{EW7a+*idls&zawf)cNN!#vjl`+stV;tY
zf`|z4$s_5iB2ta*U^-ILtKs7_4O1_o^}+Tq*4Q`(<}uOPJ49HJzyb7Cjq4>v54wZy
zt2Oc*q>Lh5X{5&fs#C5xR_1cN!b9Vdny0BQE+#JPd&5amd~pVW)YuxfPcdK->K=JC
z3L@YTj?Ccf>M3xobugKdLxz?g;u*iS9*ZjU7w#rLo5U7mFI#L9<FkURqPZBrNIMh0
z5G|l2)^s%H;p{0$MXTuru2<=C@(I@4FKTI;KH#a=(@WF7%ZkPi7u9wE6fxGae<YQJ
z(a?}KH7sy+A&NwLb+^E67SeI=l77ald<T7S15zh3zqT6Ly=zQ4XQmBzI8dHrC}-vX
z$ts%cqf~n(EcF(i-9;xm#4+ap$o|XH`|8`Q@nr;vFyMhxgc_K-Y{Y-_I#l8wb^+Hx
zgA{rvrOo;@L`ms+?9$<k`tj8HUh~m$gAxjY+A|0#RYJJ1i<01hyh+8UK_7m2<FDf#
zojPzgl#eQbo;@*WcsBa&z0d%UZH(HC>V*BgxC4nGsk*XD-uEACQi$=1+goz^5swQI
z0+D%2MApq3T<wh)v?4)LoDXY^0e<hPg+{r1V*s%OJ-g_EsDbc}&+IqmmS{|;m}^bt
z*!oAy-Dv@I8mX!nh8T@A9%OB_BM_tJzuxd5uQ$h}FOdW9`E$25SO)MffX4zHjj}SP
z!&kQ<za8<?j&?5RV{p)%L1o-v(Gk*~-_QYeVcoD1HBqCQxlEUct(evJ<PGrOEO;8s
zYnl4UXQ`NzD%Zh}HFg6Yn!67gR70oy+{?$^!KNk`bOKJtgH@So2|tkS4hoVG6_urx
zg+O+~Tz~D&4mPtw&rTEedKbMKs*Whv?}A@Z#e66`q$RmVt>KGLxdgzU=;+nXl{C_|
z#`qV3&W81un1O!<ye!}&asm&@4~sN4Ee-3@qoDw7NF%BW2)d2#yeZX<n7H8>zrfcG
zTH-_Tzh*nUgM*1w_V8JFqGlPN^NNB|B0%Fv4MBiNq5iqggFJ~bu%qXfbv(j3td?VQ
z{QYezzoo4$7mplBT>N4O?fxfMM(zoRl{r7-<RD@@%?Nq`XL1l;g(nI?GL1NqIMZQO
z{N0k&XP3f_El?t%Z2|`MtEl7*!3hxC>LeW~Vqq-0hlZBO<8cK%Tvqd`Dw~zQG@%g9
z8e0*l@D0e`M^t==R**%l_=|P;2cg$rs6$a|F;J~L*>0m8xK-jl)cFH_Cl7NFKiQ7R
z;)0*Fp%9_pz_@&4-ir!-+r<Ps&ZUP@>gc8ivi5xr<$QLj@OzROL<jDoqk~mQ^;7u*
zV3szgBON=t>h&)w1f6#fesQWSpMaU2?1D{<R<0y0<|W`qb*Cz^vt54sz9{c+jEk=S
z{*L2`2bE<k62drAAQb`6D(eX3OQ-sUji!KaJ)bvYy^WxlbZge9jfQ6zZ~H@8Q9d6$
zCxdtO!(MH{gUP3OGsBI77+=4ZddG8mvoMy$YywQAeap|^+}unAMigz1g9%h@2=44a
zNu7DZ1utYd)AFBti>AoDcHUr-*?zT?&5mu^kobvIf2#0&gk!JUwY>jhvs|-oIJgiw
zWP(l#STRq^gLYOBuIgmj^^GYo8r)BITa{zY=F1BGp!Jz1mfK~;RVYmJ2@#QA9ZO0N
z-?B~u+e;@Zz+-33<~3S3AdWe}cJAP_nSuI$zS|oc9?ZD%E>>!@GFi>6>BJ;CSP-^8
z;~-~)GQ~-5L~pPi6&IVHX4DA7FAzEemI_D*5%9(k(m_MQWjxE8<`uxwGv?BYf5*Xz
z)wWe!=OKMShhwa0X0M~EOj$~g#BvUecPJ+!^a+WO)h+_wd<9T0HWp@u@YA~hRJJK`
zEBOA!)($QrW8-&VL_sz@=k`Nm2m2$BV_)&wriLt}$T)%?T?p`82E1Qud{LfGjjx#X
zO5Px-F^(=aHe_HZ=;4cx>XBPERe$!<i3nkkXsW(D^(Uq9P#496Qqh#=c4O91egHm~
zZbb}I0hhFtvNCs?B)yFkNWS>8rTer!(pCPA$bMCMm86zdTbnL5ohSE?87;+q7JsIb
zk6nWq8v+hQZWDcqk0&ZjfXD_n230w4YhR>b8B>O0!3s%=OfHkAGJ0qx51QIEj4O>?
ze6C(Is!SStUY`OHy+@oPN1d(0dOML?*WvcCtNGC$PvGshqoo%Zu~|JT%Tjt_i=9Y2
zMnDFt3lt*itpgs}i|qr=t5lm9_6!SOwL}K!+?WbN>2q);5YU*6RJd_cFz+wk$CaJg
z<ReZ-M?RS4G>!}7n6GTmdmQ_<@ww5W7NLmeF2(`Qy1LR4LE!G2RY?i2yEmZZ$E3hM
z1W!B2Z`scP(-2c_<{G<m1Na1<S%0)ZFSv4vfIw1ozGJSP=(yBqw3iGXD*jYr(b<JJ
zU(O(4p{Kfbd0#=~>F%TYL&XzdX7m~}o}&!Y^DdKaARNjB3e;TaV~>;ciLLOKh?P$P
zC*9R}aJ=MkMAur#yFcgXsh80**vz(;cpK9zZSoO)&+O;1h5JzHR{U0cg<Gax)=1Hz
z#{yJ_@CuiH@C}TG!2@KB^!(a}U$nRYT0lZMU=ea4lvG`_Hu*#F;;?}m5p^zUk0EUy
zN!JvSC*`e=jQ(17@<VcB?cr`yV*&-Ge@Bv5C+CtD(tZ5>`VSYxwh(IKs^@<I)P9N8
z{uuS6v4-V&T|NIyj&gOXyGp4-wq?p$KhuTVCDp=bXI=6VDwR|)_l4oJqY(nvTB{hl
z&I2!i$i<Zn1b8m{r7a)AhkIw(=<F4zek`ot>M)qcNS@kT#{1#@R5#(V_tTDkHd%FG
z6$L^qxYz~(Tu?&Za7YSIiT$h&`!Vjt0h%-iqzc4y82ucJmD);uR%-CYJVi4t?&cqM
z+&sJ88|H`V&LnAqucFunXT8*>UFgD`&p=dNR{7DG@qBk^DFW6AwCfMTUl&-g3P1O~
zXn)??8bs?sVKaGkb!?1?B+t<w_zrKoh_76ai9vyY$nIA&nkzQi@4VBE^Jx4^dWX3D
zo%tO<pO)_o7wM~XROFL&hZA>M>#emZ?7_fhF?P`M@|xTIQ!(pCdWP9xCKu?mE{<_T
z#>F`K_FAhN;L0Uy<u7e0I7<yyrHonk@)D?NG$-77w-@=vSVV*Uu8UdvzwzY%*U?)|
zOLwCxb>W}ub_<J7veGAgxemlsMoK_lQ`fIVU8Tk<DgiNDLLo0xbbfvW-^GSeMuxGx
z7Y-(s6bLGcs8xbeF#PsO5^|#emMyQ_3#OA&iK>~sFF}2d6-8{pNPM(@R?KxHJ!imh
zT(qTvnZQ-_r`Fc;f;%1JWEvpE(5SP9kvDz(weL@pI0S?(=r>-s=3~&n=zeBxZ!UQ}
zru3+|H^p9iLA`V+7Mp2X&Cm}WS^hLYi1zecWRi7qR_0Q&U|L*7CYr1}Dx;hIu~Ls~
zG)-bU^+7+6!4vS(Z6&G2tuoJ|aI(Zt#Z4M)jS{VLL3^nQl%|d+{7?3~D3qwR6?hZf
zi#A=XVnI^!*Bap)*PC(#i~)*QWu=ImN0(E=a7?7&^a*S~g8R%)T&~!<b$6e1GWgyE
z%Sx;H*8LM~It9fkHmzt%u^2nL!mp>&ie(^79*EEvjz!edK08m&<Uml)7-g>zpO&WZ
z_YV2sHhdf7T3#R%pX5-1I+O&hmv$qSTf`iswqtm0ami+HEBo^hvhp13w(EUyWxCck
zvU|Nf^rf%(gSOf_0K1f+x8X1nO3_fpVd%ATB2rusTDwD2@lYwQt)ejyJFBpL?oMT?
z0%kzjJ=;sgC#OjQcqcPXDZ>tUVMwDrW%{q57laK~^pelMNz1R&ttnnMh)<42S;eE5
zNW2sB)Rzrk#r%Dn5Gk`{!^fgK>G_5rAN~X(8^2{i+DOXRVr;}=2n0x0J^H-vk7$i&
z_tzJB)Yh$hXTP!cEG8g8Y`u;o;#tzuOeExIjX#<j0)sm|<;W=Y!%mvJ8SMKCB!X`9
z5Nll?1-U;Qbft3+wfc%01}?WF?y*w8ZlGRk0~~z^R6Q&<c@KjoS`zWc>J3-?3VAbE
z$?&1a9QN-)DRm&5opCJ7a!>41n^RxXWumPF$aEqr*1<AP!Fa#LFrjTimV7X7IzB2V
zP)~4@x%jyg$U!4In~O9BmybYit#~{OCrY<J=#xN{h*IVhY=Q2~?dfykg)&f(wmF<P
z4SMVps;#|25h|EZ+>rl?q0RmhtTF%{7rt@KJLaISz{<Qu6roK?TedmQ08A+|hAHLI
z8O3@i#TP(@l2kFnfMg^>oW7v8w(5L*0_Q6RSjt4T=K50P|9vTv-Uf9lblKb8ZN|yr
z$M4*-wOW{Xs4?i!ZC;kxs-UP~Ev&}|7UyTj93O2bPN#Qb!3%9O`+49ij7mGuW13UD
zgVp1}{d`d9vUVTsa>U*o%<*zwO>v=AD*SdiQ8+!=C6AC6!4lWg$obX)QLwqJ)nqsq
z)WH~?f^B35Wnrw!isHg!@>zXuFxhnB53x?5T@#l^T^Kh-yb4UUEU|rJ4<?vh@VKnp
zz-`^V+P!&;++KUrM<9s!YO`33$zFbwxXlaNYQE_Y#T47rZl-|-kfpxzmkoScOlhAc
zlb?M6hkFln*4%8Ld2Z0?%F}<mTkWzkO&&1S+Y>Wgpi&xMY()T;sMvi<PY<ENU%KRR
zcU6mJXdN@jRaC@pxuphzl8q|@usl`=4Gdq5uPbs*J|6Aflf4luAN$dRdRm7TvEh3f
zWc$JUFP)ws%svDHr!ZxdyA8hi?csNv;Z>i7+_GLTnr4AYsZ4I2^L-5ZrpCs`!@!uY
zncmrU>o*StHk01w6yxACW$SBebLzBxTQxjZt2}a89}4tZUe2_bNk}bo+J6U|1ZyAb
z@|z+^E9L5x>AOFFzUwU3j!rm3&3Qq%VDqa<OZjrN=v)*7TS9<-Z*|}os4<k)oofuv
z$M^FKb2*}-keR<sqqHl-QE|_a)tafr>v&}`o5XF^B;q_YU5j!br%Q^bg<5S><+EgP
zl!6Gm<>lELOnk<JT@1|soUO6z3&M9-DsmRHc|kLV2&r)^X%o>3_D?<<djC_S^1aiO
z6LA@HnwhCZLAH;~XC26ncL?M}=>vW|1>y@qo(0+OVq)0RL3=blQH>iz`I=EPPs^7J
z@4W!F2|v{=ZfU8OZE~=<dZ34D=T~zuCm7R@7m&=c5+1jm@#N`K*knfs7wkUDgYOx0
zk$?}>#KHUPqd2=1MYaiI$pnfgCFuVIi`~KeAX#TB*1O=SU~aC21&6&U1&K}2v++;X
z>~_W^Xyy}40ba}|is5&h;0<TFw~onEdXP5_fh0c>?P-ntERZa_MfU60Rm6302m-kh
z9Ba$GU-1gUOZ1*HSLUGZwypk@k0kaqckI&&;~sDd?Tmo`Iz^aPP&-&C#)r#eXG|J!
zaiTLpEepo0w%Tac-7Wu4$4Ez4W#20_5-OjWNn-o0bYIp;n(1Nd-C8osvje`8`=uM>
z{^;ln@@o#fhljlffBj4qM3w7X?k&yuVY8x6W@u<g<|a<G16C-q7ZV7RAg=^+Le&XV
zuPbrIz<F-YDex2-b%D&ydYhT%z6a2U>92~^r{oQ)#Tq;47yN<WJ1kx<8<Ijb3&`A3
zU#|UXeu2AEF@LnRzq*B|h3y}LVGxFfuP>dhQo7UXQ>b-(c%Z($$m9U#;ydj<&S9#=
zN#<nhngMfAl@*=r$Ni;}38*#BF8MJF3QVf2FQXGK1{NOe%(!_7cSj#?ZJJht$!C4@
zFqZ^>BCnylfS5qGge63e&T9s9W=hR>?h8Afz14hRO={fJnm%g56;Sr=WVXHE-4(fG
z6bRN+Q=R`2EaB5qoO7vX9Xu_M`@#sc<8Wacr8uQ!I9d(dv9!r-f}EVurNUbiQEOXC
zTmk7QHMO*Ps^y#<70UEtlzHKI?%bj1H3LPQTw{|rQ5Nywdis>?>=Y$93-e8mbR=!F
z6E(O2SPHqWL~a%Hr~8F<Wc(*a;y7m*Ie4as0GsFT;-b@4`Kq=u+_L${z<vd1Kn+!Y
z_mlL@^bY<PHVlk-X)C6g!e4sdoFYSK5XgntZ#1b(v%$5|-wQWG!4T$yd!~ZS&Y0gR
z&5E)#r3SVlj9?|?;8u$1Ed&0o8`iWb!_SVTYB2{#j!@jcW$68I*pb}-ywpu9`?IO3
z=f{VsG$CIV>Du^jpy|v-tbf*{{Gf5D$E<a_7O&*w6N;~{Z)l<Bp<>2tH52htVE$@H
zm;_jUrPJ@pL{E=?Z@g=s)%>LRzJ_{qTgyqnJf3;x{Y&2=)a(0ka$A@gR_JS24YFr6
z>uGr9COY;RBf(>o`pw!f{^<=kfd?TEK1_de(pPHn_6r*U8+w-cRF`_f1hjQ79v6iq
z<cL5>W5bQfG5H?=wHV$)9NKMPdZP2Rq<ZzJv&?qK`s!udV>W}b|2VWE<sB3b*_N?4
z{or&$fvb{5?IG~k7;YEbre^}~Y(x?E6|Z(Y(-y?nKIX(u`scf}bVf|-`Gy8RpL{DQ
z7=Vi#@b%RzdyiAShh1Pn3qio^*8<;BnLN(T>b}xOym=)Ygpdaa<W;A|4A*Zi0yf()
z3l+61jWy$`-@>I2W1ic$wqBgi2Ck4~OgA=f1SlRu`4{zgsTphr(s&u2ACB1ga3b3f
zA)X#LD~fZx3hqLF-W~Hdjtqacr1IKqcZZ-#jOikM!daITj;Z6SR*?ENGbdZaIPolW
zZ+9Qg6dqimE!y=2up)K>tA*|luhUgQ+cFMXE@xXtj>XmhX(NRm#i>dQKPIvY%6FoX
zCtfr5J2SG*FFFVJp;nZoILSObeMt*%T#ls2U#5e`KbZ_3Vi~IWI35q|CD%(ka)Oi*
za@p#=Q4tZ91p8um=u-swA&{Z{`KBPTfJziK44ckDPd6h?`!Qmvv&GG#pHUuuLJw3T
zv5ys#ZVbI*#uK4=cc`V+Kq`eG6mUNxnps#Bz5_S@=?yg*sH81HoIYh=BCWGKSkR&r
z?Ga3myRA%-8AkHvqK2bKB`_e>KF4nT(-{2{Y(VjKZyd8glzW!+S*1+cQ&{Tv@6R_w
zp)Po(!q(P9am;e#y@G4rOe&^Ifq{f@Mkq4_!-KoZ-LH0ce*qo1w^I2&mO(8HEaGPL
z$D{hXGcSl?l;G1W-W7xouRfw@vW-7r3rGh8oMrkz?RG!WN?-N&AHXz9EK`xZ7I;na
zZm&`s{*oDSNe~Fx>)qB3jy_+><K*-8E;Fa`tfi$4wS(y`g|frp*~ICdxSt!BI5llP
zLf!i%H@Ou&UkJ-}dL$xgfZg~v34V;eOhti&6<VlEkhYf(NTsfj4xVH*?Df<8#Cnfk
zm<438Nw(V$Ulw!Y6ztnzn_voV$!-jx6zg<l)D}2y#f5zQc!Sc~I*yWBR6OuvIbJsR
zpf>$zWArLU%Nf|PwyCKy`>if)Fjmj{#toBG8?;vY)(%j6{Xz3vO3DYQvjV7Kmd*c4
z4ArP}e9(<;*19q3Hm(<mi>puc&UUuK4BgJUEs$@s(Ri3bIN1lxJkGl~rFK8d>D_67
z*SKFENG8IlM2Lu*8yoFl?3Lz;{Co;$%mH$lV={?DAI+y#v1!yj;}(n%WSdWBLEJjT
zbE+w$b#kqiW6GQW>i*D;@%vf7k&VuR58jG}goI?6!G_OjBrj&V^qv+el3KUF2T9-n
zb?N!;x80Z38@%Z!V_1bw_-y#Y`*$aZCfsGKlMl&_qV&Iu(6i7N4yQ}*Xq_EAH&AL2
zY<9i9Ut0A_jouKWT&zHjuqBv0X1n55j@80bY+A6JXH%932DCC*A=}@G&yw$cl+Wll
zjS^MmKucF@-+Fg#UNB^RxIxdV2_OlusD;s`;?-cX2N(&W7Dd>!_VdTt?!tSc<y676
zQ}2*KSVn-8Qvv1%r|Vd;YWaPbxI#_$$*2||Cu#E)f2^O!L?cpiN)k^Rk~{gw`J_Mb
z9Zb8;Zaj904-a*;pQpfUKEvjmva~$nK9jK(eQ{To?6l~5d+}c<Nm*AFYX>GLyEhPs
z=<IV5zW@eA`~C)VcwdMboZfm;>gQMQg;Swe=g2Ytp;zFv0U9u20BnN&c1d>wj#h66
zbZq|?u~4~~t{p59P2%Pf-Sx$QTMea)3V*qaZa-COFyM`9&MAC~4fZC{hJ4xbe^|(K
zH74Zi;!+eC#MMUm8m#OPjqW^LNiLkM>@Te(WO3NO%dY6Gk|N*PDI;GU&<%Ueu`DF8
z89g&3KNLl&$<5us!Pd*=Iu<7Bl`k&=e<^b@cn4_?LZL0w&cd_bQB00&>AH72JNMx+
zaTNVO{T)KIH6Co##xjR-N$tv5rdzBX4W$Zw)UUMPjKN*|3zq~lJ?C2C^5UK7m;VPz
zZsi?Q9d2R}8hmo5Sq_>G*~IE?2nlQ~o!KPFQVGu}5H^zu7@{esvA^eKop${Y=lPFX
z*|n`07kMLtB}+NnN0rC7NLuP6vy7X1duQY)chRwyZo`i~?)7UXZgK}P3(>9?aPr%H
zr~CLqqSeD>vEe$acz-T__-rzBu;^Di$_rWuWECraCW@?VP?}w^a0|unDp|bHpf1kN
zw2$W}1Cf|o*hDIBjz%#fW~5jvkJ<H`j7y5THff<q!Rhs@J*sIgI7VBuuYR@h)6k3^
zU2H0x-njo}=EExmYn#%_y1AQx9LHoo1Fc=fDm}2Dk<*S~Qi%iYvOD|qe;DTfqmBbH
zu$Q6nDnx)l<{OG%aKB|cso`A~nKKg+5nXk*ou&#56n?7R;o71gXca6-FV`FSGJ(T!
zldoF-?|b{Eq^VKsVz*SEM(u9ZJNeZEeimtrNALKnl&7$xl<_4w82Yb*1=x6pptY;}
zbxSMfn<-1WVX0UH(n3)Y;Yb6rJE&N9Ve%K1%Rf*Ec-$`*J0n2JTmx93)*H{dy9+p>
zb5Dx}A@rWMC(-|XzYg9tWnlTCy-1k;wy%A_yZ1g5PTI49c1LN;!D}3S=0As0B9tW6
zmiKDU*$C<7C~}ikQ!26ri}5idUH+kTvQK(dC9uM;e5kZT-oECV@{mo6ymt%@mT?CH
zx%bz{p~c96{mPoBtmzkx>pTr#>dE`1?;ttv#G-c`LqJGKtJWTDmRDmcatB)zzzp<-
zg@vUCQ>3a|L&&({O~oD2C~K1REnapRa~uxG1Y4}F#?1i{)<19LMEHV?HQ;ZBz|Ga)
zuhmdy=(4AlafiQZn)7U=zRa<<?gf^1bK0@eY8;Cii;1;eRB4^^4dt)Ap_%gy%s&Y4
zqM-$S`SJ!-H<p`>0_=PYXbHwVba;#-Uj+6Mfh6t#Mx?wlGUU~pEQ5x}O&`otCE2FM
z<+vMrPdws)@Kvk+(a3L&t^Jh-Mh*%t_h8gcD$B21p+S#JzPL^MmOVK?`i14>qxv`3
z*KuQFV)E{<fB#MwrwT|Bq(2H)n?}M*kN`FPCc<MyQ-+$PS8@EP*PDD(YJ&UesKbp<
z1G~&uBTM*Dj#7INGjj5u3t>xW2uaQ;+61<;3l-aPmZJs0BqQ#2yn@y8x;Hi@ZXfp6
z+fq=@9opU$)K)p}-adCapoM1MZEe-P+Z6<8;leYwy}iA$fsc)ijf-o4b#bazY0l+w
zrGC|o9CsCpj<6jpy65YcrAkwY@9le2O~Ukn2y{&I6$l(wW%5Xc8T(}2bt}9!?2EX4
z5~_k);|E1`yiY6$x$hY<M!W6&4Qaw2j+fB+g>YH9HLt&qe^_`rs6QIp3FRI9DcNlC
zrZCmD_|e@i>UnsEgX{a_?P;)Sp}xMJsW$k_7ceh-B7!tdgB4Lc;R#1akbWYRI`0@B
zH=pcNvO<+<CSv<|(_J@t6`KP4xft{J+-%9IbL_Lg|Dn~hqsSIOt|&aiCIF|+^(7Jp
zi<|?|LZb0dSF7lpj(qzcP7ctt1vzpRdaKsLExxp4$Z?s)INGc6!C@x;(g`b7UzzT2
zu!RTXP=5ZFKzqeAzIGEpfLXBVsJ7OHmzNhfgrL-Np*`e3S^85jc+W!FK6Pv5b^YiH
zvtPyoV+HWX$IUK+qtZcS$-${QId^h>jnmkd3V44SyuLC*Fajv7@2sn{4X7`I`d3H-
z+a6=o5wIHnao9sLo(`Y2?u|#@+5K|OuXXiKWZ8$mkA3k+9P(ItT*hc-nO823xjMw<
zMcE=nPB$BWO7iCr6kFfz>TJ4&kKphc2$IoMi)K=W4yXgczmMOurO#a%sH&WtI^F(Q
zD}c32$VzXCw<Jxnq=S0%OzK`O0r(zo;T&v!>%i@~IjfZBHyrYNen2@{i#Y6{vp#!<
z7qR95WkHRIWL&|!SPp01!Z=KjDBzl)K2Rg1j{9OPaB7SFd?S$O@RM~4-46tJdD0*y
z{u4`{!>SI~c{6GLituP1e9E%(vKv=3$bD~<v&U`DvGQTWs+P0FL;w9}UF~Qw-{6to
zHxTl&c;D;kgVddkbIta}+w8x|-oPqtU2;d#cuUndj=BQ|2W&q)f-@bwA3T=A`fbQC
zZm}RZz${P39&P+y;n$B_(ln1q#=v7BKW`%(ce9_ihv<5l03NYEQ%YQA=t+~7b5|6U
zAxF?4APU?I)uuDz<7~<QSXvQ(7fRZ}pw9+HlJ?1MBsUMdX1X4o$nzx#e(|rx+Pst?
z6}2b-33Kr;TE#YgiM-*P6qB--+G&`PgP-pqm9^~+L`ValNfpX}|M345*0Yei*Ei6&
zvaD}$R>D2=A+_#Bd{wzl12FMJpMkLt@gm9)?7}0la`58vpOnrt8Q*r_p!sqqWh8YX
zyRU3J%Iv1W!>-f+WPvWF9n4#NHUB)^(bw-l&kbQIUz~plaI&oWFwrXpU`29b6$SCj
zuvQ!zafG~WU{6yV9Zx!Il-;qz9u{Hd$kHnPQk(LYP5tY8M42Hk9>O%2@%>tV?)5@g
z=))-De|G!=n$eEYWF9!|(`m|1Diz^z3D#Cuib@MUO!Rm2ul50Z!?P?ugj@S?Nevw4
z5uE+Tj?LE3on^aZ3m8hR!@!Kx`A@207tFl8>t%~;k0`(LeAeeyq;nwgeCT~>9WPId
zkI)Wqs8nqkkp>{#yYuuEy>G2w?m*)>%MgXZ$+V%^e(i(zM9o>5@=d>WgMO8|GF!hf
zw7Xp||C30fibx`%Uf%#Z>6E!<Tv!Fd%A7kMpQua~_!e2rc(@)sSUXDMO@3q~B@!u`
zAV>$Tcj_Rv&;gKPM$T1`DAc6uE1IjzOR@UXb&ldYB*2VVGnxo&`6qt-mheLSJA$RZ
zp}H#OH>iAeN8{m!INgBoChJx^`@Xo_h5Ltuo#`Z5jyPr#vqQAB)8R29p{HKQZo#t?
z+fp@EKgpf@miGroKxmZc`3~K#@Zhi44MiNMDt5Zel#y=&-rqOoN)Y9W6UU|I%_-?t
zd@Z9kq-~g$qHXYkjPwh9<h>U%Qb0Xds(sn}>VNR^>+WHWTYS<Lf0#sad1t|3&17P@
zDrLL=+fx}XdHmr{iY!HCo0Y7B1-6|lZW_tgNteGCOr`tBhb9nG2alk@Hxo4OZtaPi
z$QWs*;S0^QwmI+ZG};ERSv%|zG08jFuXGfQ87;nU50gL20r$5`@s<9=Gv<pE$RfzL
zx;2fyoKL;&^@0rFTLa<uzaX_Shf(CfV`7I+yasGowA5EyXf*3~Y!Wp3PR^DutJE-N
zx!g%Cq&!()_Pr7oVh_%I)qjL4xG$AyT81M6fIj|+N%|OZ?A6tIM;KAOuD{<d9wS_X
z3&c0hq9d`1qm8pbgjaE;*_Th7d~{=!lze5Zn0m8-+c{MemOK#8n$>bE6OZ<-ilp)w
zda=9-)Wu<9><z|c(f*$5%V>%L;2mwkw|e8<sha-pQ@z^8=Ec0VrZ9F0js&rO!TJnp
zdvM$CvlNa1D>3)c=Kw1rgXS}YB=;qY<3~T=nAycEG@fN%tVR3m=a*AvyV%&OjV255
zd7;V7JA`*DORdJjH-VXDJiJFL`Nr=Q4oprwKa@f?{hM-nd3Z!xPp?GIgwy`eX;B2}
zaaO{Oo2KJxZU+L;be^=(&;sqh2EkS#<=}EVYH%iR-yQAY8K?^{mBOptzz^3fqH#jU
zh>W(}vT7#;0$$Wqh-|YF0J_gsuCPE$!s>XvS#Xk8Ea+L)*Bus2!3Hwo<?I-tpbtZ5
zhe3I*!6L)84r;j#x}B-^_7#YzK@`Oyu}PV9$_0pE;$WOA9dy%j<%m(Mjo<}D2Kelc
zY7uIDJ-Ixdl_{UDt;CLqHJ>@?jvsxk#ckt$v)^>h@0~Uekq-z((SNjE3n#7341LUV
zWkAno0v3-au2U)Y$WqCY{m=W)$r1eriwjKc0x5&#T^kn2Lv97k>BzYXBC>5R)2!7~
zJ@RS5zA>si15Vjv^f?rYWvOQ%9@a+$Vk3w!-j=g74IV~khW4kD($c6qV9%iN57DUn
z7T3(}X*JoVscNE@R4I}pMr~dFClg~#%WSpw)R<UhBXd6zb0l-MsARM6pykS-$z`F>
zJ^Wh{gd2s_|C{?$^$*ecFe8Khka{R|yy-PDTUWt*M*s6dHd1GI6;TJ^9%YPh1u&&0
zePMit;7l|$w4AHncmuJ8tE)Vf+T@4=<qA`)rvvN5a_K*CC`n{~c687+8{iV~)b}<v
zezRTEwzB%5y_WUx{D}-J*!1;Q!)&r5?5oXOBRfT|MlHj6jz-NQ`Lba_95ba%VyQmb
z!+=OKdiwBbqmkj^k0|ti%=&k>kn2D_gBp|{^Oj!GAG$K@R?s=Q?PK27@GpCa#zPF7
zR(xHJW5)0H4f(=pLae1{@DrV6rh2Odaoi9fjv+P9!!9jfws9y`acIp|%8i{+e62)8
zo^Zs35TekkpNN&}&#I|Jy>`2_%dy{zyLG2<u&e@~^<s=m6$IyK-d&wh8m<rB05jXg
zBtTp7hgN@)PC||xFz<17w1^8|CII(v?Bn)!clPS<4??&hfm1{#AVB+|R&YJ|`Tp?1
zXOT;?zGR0Cez3=q%4Gg$3R-?e3@v}gE+YJY0tR+wx}Q9WqEw2T7LDvn$$w<LTD#K~
z8y5$5Wkx>&A+u04_^;+~Dy2R{AnI|6onK%w(67YVnGRy!chJ`5>s_CSg1x8{g&L?c
zP>$a1g7u~Hw>?Tc#w1TUIGR~4&URn?4N+KXrIE2)0sTCOyI$WmagZht^3A6QmjvT4
zdzqgF>+c7)<WfzGakxw#q$2V-PtXTT^sut6<>VrO8Z)Xx1a2xT3W*6y^n2x(8QqRG
zsx2BW{p~DZ>F(OgBLy~K#f`x|uuZ$Pgu+N$TfB&i^Q!tU*$;pPdQ%+3UfpgL7Va3)
zZlxOkm~ap4Oc*08Q}15O_B5*8V35>NG({wHjm^qm{-Zf^#305!R>;KIEt9|vjkpcc
z0iB;foI@cm+F%!-^{RME*ldy|^}Y1Zwjm6jG(^mh@}TLbwEKspiE^V|qrp3pNmE+H
z7ef`M#Rhn&xKv+5YLv<hKa6OfA4%xq&gCjZjFXXNSuYi>d3aM?=0s4zx2JEy7UgfJ
z>39A9M@hZM!nlrn=~f_ZsOGf|g&233ez0z~!nw^A*NZvLP27d6Hjvk9i%0_|{GvPD
zo{pv{Qmf2mGPK|kkJ@HVVk=dO1{D$wvNB6uTKkix=HuG^;aYVktIoAil!N9pxuOk5
zD@)xw5m=92NhVnO2XSQ@nQgv>MpJKeztVD3NCjFA?0UI-f8sILg2!S<rbRuupq0)7
zX9&Ub<<3g;EkdBG{FQR{&@#Z%REM}IT-u~%(XJ$wljYtV20ee73t)BDT~c+ihn{iZ
z!}55Jx73=vazl!u9^4xj4O{M=g@<VKq!Ej??V(a;#6*Mm{9Y@bx8dC)&BSl~@`M;*
z;3zpZJu7Pl4KTDNFQ6=Rbl*-gB}yHaeb5-mWWRaduKf}rz?1o_xwaTL0H<^@R$TO5
z@9U&u`9I1C-_$=9sqeq^AfeDW<uw%MMT?~tr=hhGF2$Lo28lQ%DN8Tk{voA8zM)_g
z{6H@L>ti?&m<sd6!EBicJAbg}7WJ+&r5Lx%$oSZskXV%&5IA+BV`KBz7{SG@_=H0A
z%6_F&N8kqmmui=JM~<LbIzm5!#bP%~gj3$09`9%o_1apgboG5ro)ywJUg_&4Gc+)u
zL}Ms79_Ed5w~;rp+@5-fy$M?qQYpzNy)X0-53kJ`hv4d}OQtJFb_uM+x(^CU^fd`M
ztC9$3(nTb0-uxt&WnWUcX<&Quec|#PMTOYqm}a>Xi{v1sBbxf?pvLmoUm%HGemj3P
zgy*O@?_Mj4F6=$|)k4T@X(dR>mZFO2kwy&FyJ7iHjxj~w!3mBNxfsvTzBZWC?;}zV
zV*gX2hmRw`F`3IXn1N)!EcF%vNlom7%@T3j^GGr^Q^BIb?re-9EGr*==iOIBKYvP3
z+z(?d>h!!(;jrDY<0xW0O4Iw{DMNYymAQU&%)C&D`EnSG+0)F!YQqoXH}96`Q6qG7
z+u-mal&6bG_EQi!`$Qs|fTBDw0{06wxdfx7;@%V&tuLVN5pceVq)o2&^V=;q;f9G9
zlXeOH*hbmdX^4YPLtS1%HNL;c-nU9jj43&}x-?le%aZIJQ#)d0prdm<qWV08OZJ{G
z<LIbancOaf9V{5mSX|6TM8g|Tmp=78TvXx`ZS4^TiIz>X{-gqi?)0u4!;$=#uy1=Z
z0S1Bhu#f?u)xYA8vJrj*)2mV>;yk*KMBET*etp!41k3W&O0&4~*zsYojoVy5iq%jW
z6ne66-uMgx?jDyouSsSbJVKp9M@GswL88<BYTQS`dN&oNyUu|&bXvz|qU@tKSKP=u
zc8{5;+ZHpfaL8NwCY*=G@i@=f%RZu<-o%zlnxg3@Wn=5r%W$2$d1oy5GYV7Y{Vijr
z`}Pis#sQk7#DajO4}olHLfHpWJ~6klnttWmjf`XjBk~v+80sv41U+wce+Q;I>RW7#
z6ad9=Clb0fR-CgAwpDB<*vIN$UEpr+Nzbqz-4%&#3q1An&lWp4+i3{-9`Mv*J94sr
zXC_f!P*aoAQ94b=;3(p6Kctc5@pb;b!xV`Ep#Mezq?~F4S%*w3J;?=CrsKC1&YFKe
zdh}}5Om~rBWTeUp+PVm0%VOt5%`Gi&xVhD%oi0vTiU}l4h=3CI^%C^QmdE;~t#sqj
z@ebkQ4^Pi>?9PaGG8!6j&c&Ws=qBc}08EXapI@xo>*7hMdWk*rQ^CtKcp75Q{pm-s
z=yYgBsaPo;9`)12vmZ}4Co7-x_+JJ(ADOn!fK*D-jAEYRN6k_p>b=P_gjSC-KkPh<
zP7&#$Vbwi$1EIG|c$qK8QtYo^waNq2wQzN4?m#x<xyav0bIu0iKakq%|AjSBZq$;k
zD%yQtJtCJm8uKqlktNI~oqymvgus~9=F_>HO-T%f`q9TTP+pb2z$c%wv%wg7ditx>
z^a`wQ(Eh|mktYx^A>42QiwIY%$S)#kVz$=BpvaZ)6n&Zil6fGG-LR+4y|y(uxG56a
z9V3-qDG@)CGMc9-fy=0eU=X!QLbB6Qt#bs6WJ@Cw+{;!aYTrv7Tm2PDNZMei=VSd}
zo`fQkgl?8zc}j2=3(W|8))`V(3(Xk+Hjr0^CbHW>pqG2yuVCDC#H2zhs-VTNDs~;*
z;F_J^Bdss78>3Q6Zmuq4@@PVd<5KtkNR8L}&9ivH)qhgjBL53QD6$|({U#R1k~*0s
zFs@DM>^dHI#>@54;7z(ePC@qaL!z2}ga@Q-LnL$*O3b+LHyb1uq)f7VV3b*rx;G(=
z_EbJ?F-Hz1+mDWzSTKr8CDMPn7oR)`G;arb0R&&-TG$oUpnoqZseA2q;uHJZS>gyr
zX$1gR1#2@Yuct};at>Q|4WUW3hq6QZIM1Jem6IJaCELZ^*|1*WB$X=58wwMB6X*D`
z==dX1Gq9@ka{Al1&C*{1)yxC8mAJIDHXh0*(=Xvh>R0BccKSTze}iSycahwu1EW-L
z8+-@}J?nrYE%m=ZPZ5z|Yucf}`FfK+KOe1VfIibfdbIyluPltPf^;wdFJ<$dQ#@;b
zblW(TT|zw2VtRr$2!1r_sBq>c0LC4EQI3}fsZix)gaL|XATI*y6*e^$8Lpu*%kxq;
z(9&$0-FF_bB2%H80AD1iYp>e*z%WO&A))xKcgaE1DC?)mHvcUO!rMk?2W0^ls^!Mg
zh3aeJ!~ykAHvX-w<_RLZM_cic)M^Rq9>3=ZF}_{~K6vmTi3{~Zm{<(wcy-1}j23Rn
zE!+n8>6ljXkAe)fs`Lo7`m9u=mV^qHBNtZy2KNx_#(G>7hoEPr0^ljU&?Q8jL{IY%
zrIyqFvE<3(U=3<%X(^YDev$HPIak*c;1?L~Dy9oh6zJc_{%#1MDahPuLD^rD*bu)K
z_<4V}EtCG-MJ-i6hc-_kkIwRaJ19<B4exiR5j`XAEJ3)EG1T$A0Sd($Tj>{@d_Nm#
z{zeMMxFjjhePyOx#v}*!yJg4UQwERm6(p~6%5Odfg8+K-mqEsiGzetOba(kav5PFk
z(7G_-%i>B&H24{ov{ctQ4t&xZ$(GqY-Cux-yIUwMl_&D-be%O@pmh;F=U{QWJbT^G
z>Coq`QCz7P0L_=Q4;ies5$c#%-=xV2T<&E&k;&8_!dgmuQJ~J|#}E_<+cR?NSSTz+
z=cK944Y>?VAH5Ar?Fat*MjO~A>y*G1N$=r~I%5cmd!m<j8dOzRiW)Mxyuu{q#RD6d
z-rl;EulI1h?o;y{`!xBcZWHgaJ4<P}{g3hfLG10<i2ZZi@Ojq5g7H<nWW{OiF!{1o
zZI4}1)YcliJo~jhoo1h5z-r{OCAtHHSq}cbp)~52lv?!<&P{XVJ9FL6Nmy9^A7Nh|
zSJm2eYZtZx(n?7qEiEWr!lqN{M!La51Vp-}yJf?sL#4YxTIuf2JGaU?ukUxid(ZFu
zjeD*2JadjY#+Y+@r_0l}_Lx}}((PnS5$EO0Mn6tBS5|Kb?~%OJN_b}C%rUTin){%r
z+?=I)DE%5XcLfco+|vrK7f_PU*Et1YEbr^tO2lpgI$w=AD}40);0<HmCrN0-AH-gp
zYuXxdWz%bUaX+~T(zyN%-yAN7Xn6hNmsC+#&5;yoZi<DeXcN&8x_qmdJ-stj*-#a*
z2O<)L`IM@@efz+n0g!^jlNb&Z6H}wu%1q~Z5yx+`;4+lkmHXg@?PG5BiL&H6lbmK!
z$En$QCB2+?T^}6$)9h|10Ns+)1TYs3eQV#mAyE2MjE(0g?r>obXJfuk6xX;v5AB89
zWuu%SI&HQ(&TQ1yUmVQ5=1ydYXd4`~+TV^&)$+pf&XP;NDd34kiw_7gIg)ego4CZT
z2Lff%&zul7-fYCblc9yIB}<|rw0`%Wki+vg<lt|f<$hfD5WJttj${ru4%?&WbjitT
z?$CbGZx%G5RqiTr=6qR8#CsK{)VWbPGc*zE-|Gf9-h8XEQCG?xoFXCR^-+No_uAF3
zZ#d`tvlFIh?%#c8;^brprzLuXYE$;|>C>l`ZuN_ZfPm%xn@c<K^i8;%h|~N<>;S=*
zcN+&iYS&G8!-AXFG7)1!Su$khKTEEpF_$z7EBDvyzE^xB+ZE>}?c7`HopMdHRv2W5
zL_>fXR9G+)=p_sIQ#lQ|*uf3va>sJ%VP4z~qN-5e>kNjn*KEA+PR(VDi5#UtHHXe}
zqiAA<Brp8g++D$$j_S>MCDOTz0U^DY5Qtk*JIl{~X<h|$WeAs^@)4UCNgI_;aIuTK
zm*a9^Ww1ZUj*X@9`B~un^-U&a<Tw#MD-#Q(Fh;NjDd9TpuIu+^HS=0gUAc8@45Gmf
zOT20XYjZ=yR`ePoT|SXXZ&QYM#yUqcSkv;7P~=Y>t$!en-rc{_m`8ZG<GbR5o<pk%
zTv01C@BJut98nL3o?`3Ma=XzlM33-;JmfXebz}$lE9wqEqC^71Z)YpEi`q2CG$k06
z`$t)-_z9^)?MWk}{K#`BT=efZzw0KVnC&M!-sciKy<g9)({!%9%$ID$X(LjxQfQVV
z`WI8l!0mMB_N}p_ZS&8Hfq}OL1QIxH$3s&6Mn}K#^XHq6@U(VX?i5+lAyu431%j4F
zDr$h#jD3uExGT0ePMNXL9$(oNa9`@<>V-W=A)AUeHZw^`YJ+8t&+WG9`qD%*YKNS|
zK>c5vnsDt23wQA*$76IIkEO`Dud4L%^%F7vo+p}`3CxmaN?ZWlY~W6an5~D0LD8Kc
zewZSVx;V`JW2wTSH|uO{>_AGi<|%~nJcDRFqN=quSMQ!|^16}_qYk?vi{9m9j2(?R
zXNDE4QR#E-kveD}_h%KB;zBd+QeCqhjpms;6J5A-+vPua_BZn2e<T_q5B3Msp$;46
z#>!6Qd8tn?G=)THxmh}xdFA+8?LR`4#g1%`cl6kiiR3_a)*EE)df^7Gzw$Wu(4_wn
zC+EPu$Hm5j57%ZoFJmR9&al#Ez7qO4&lg55FCHhi0zQW>Z!o_o>m?<8T3J>8N_g4;
zYVJ}6|Mc|J1j6YP+uO?kU9aKwu;f<wyt6<Z(?}^Ap<H{FwS6&Bxv8j;8ZV2fB`uwJ
za48fiF~>qm&k-w92E#2lcdgFpQ_%(U7YQ8e65APyuDKTua9x~Ete!gYl1IA20lV5*
zU?VuzA3ux6I|qm9Txy5e1__oqi>c}x3#cUQwW01zTgTf@Inq+eTti^4f10W@7T6T_
z*J&hwzas;~Cm(P8Y;|V}@aKVfrg4a5-TBkOJK1UL=N~!PXZq^Y)DRkVQ7nk3b(nQR
zNubaQs7US`t!<!Qx!sLjbO9-D<4A;oksA}^-SG*j<AvaQ@PeS^S>PSEtODkfyIgO7
z(cMrXHoA!bUoSh`u8o{N5()Cok8@4;03Ms#hP+^I-(JDy9MGb-#9{}DkJJ7CMNSA2
z@z6;jb*C27$`J5!2yDyMqt1En#XVOp8f0eoR!Iq{it7PPfk`{5mmFFw6Y}H07V8-r
z9<FUiO`0m7^{Fe*fIz4=O!G#FKhFcH9KJV(*mQ-7Nh3e>!K_?UV=w&tIcGxHzHTlg
z@T8;>V?FRd2?`oWCN$B=Mj06Gy`ef-A)V(DrlS*E8)u+WA6x}?j!?4FSRf4)>7&Cr
zG!RvYZ598`h`+=|s-iW{y5<bOTt4n4%5sY%skoUjw)ESGSk)^aq*UM-^a{xU|NT8|
z5LTB?wk><zrli2)D-!<SK6<^y23^3-#-}1z6@qKN9~~;F2Q7+u2&kgHzC_ucebNo|
z4xP-r8;@Hn_L1))`D7(Y%)Muql(ftS2kw>zx04+k@Hc{j?{43qhDL{|GOgPDr>7F@
z3AY%*4Cu*bAQK?;`ZcRe)!^Xz;lZ1ZrkypRR3280AU#6v@cd*%Vgp-;(IeO0)GKFg
z=R;dbn&fGekou4*^7yBjZvCP5&XHjRh>3+feJ%DXxP0#Lw)Yp~+ucjj31?9Pw4OuT
zm-9@An3an@5Tt)yJ>T%^IF82bzWhryiPPSo3p#$*J0&_PyN<75$D~q_i;sl&M}N`I
zeOU=(0ZOP~FI{QgzUQY*(U{Ao+awj(R^}+Cw7+YuA-8)VM#Rn0L`))-G-L^miAkh5
z9Dp>RX8wt=c%iMhx+)LnM1zV0)~MHDe4DzVOa04_d~ZGMk8IpBRddcKcT558=fha{
ziE|Ta2=mQ9O<4;XpNmSim(8>M_lBFP-@U<eB7@0GeDXC<*|9_nhOl>NJH{D-bX$)=
z#do3>g-GTaG&g+_b|qc+D*SG30lT&*{FG5t;6lnuD7LEaY-y3-r4f|)eOdSSbG^$B
z9@wz;rpYx{I6EpgbxA61z8V?~QVyv`$h4rrfxy?VA89%=lxo7_lu`_Ie||fg(2}00
z!*|IBS^$z6R2cAv<SF!i^AV3)?mM*TZaOb$WHq|=eWa%!@z<Na;)W5hog8~I$b_;v
zQ`6P?p_gp3*+#i6FN)v9gWzS%Cz9hUnRadZuK;{WVM$e#<}n$&suHdiw?kgSTP)gH
zIE)8-wlSY-yp5JGIL7?A#@mGzAR_e9SSC>;J=xkN?RC@|KGfLXziYw6Cl<hGxXFY<
z1Usjw6i|`TsBy^CP{~s8V(x73(>1FipF~lHyM^n@r)hV??F}QBT5RonMtvysJF?uJ
zg3E^;zq{|X_pG@be79vqd%{uSLlhdJRYMmyX$Rghsx{hdso3)6okL-DPp+9Lq=n5U
z%U31cqYyeKZ~nUs^;qrZ{P&K5y_E8v2G3e=wv;C%0_<T14MQMgxM16%B09M2A8g%N
zx!z9R^*ga#&BYW!D;C^)TiG`PP)~!M^}Ewfk~Mu|SHzMM^<-pic`R`6o{Ca}^<18K
z>Od`NxLX60i7_q$OuW)a@vy(2tr{bjfQZP$^G@EE+!vOIR|t){=ixwZ-*26$)xL#G
zD?Yk-2Ano(m-5!5MyYY%D%Y94yXF{0+<jT<Mg!*mda>GPx#hzCgwpw$&Um1q0&^WU
zZs!D!&lG(U1??qUb!GJHK*8zNaRwQkahF70?OTT7(P=SLT<!y&2>_2M(e_c-lvuh3
z<TYk|(a)#@XjOn3CNfX2m0uB^cy6bnsc2eC$~3rlzptF-)W;a%c)=r8f$-SBA5>sB
zq)b9YxO9o&W{=Ukh$5CfLR%KoJDN<3n^`Zxx<y2kMjifJ!Jne>=L#2x+E&^M7Dz07
zm%pVXCwqU<`O*Z|G4=A)`O#mgvfXMUtBO(9zcMJ1K`@-njCA5Q_<#WqDz#^-?7?(&
z!NkY!to$&&@3cpbLTrS77k^A0eRyO*!*QA0`#UR)IvpH?S!%Z!G!Qy{?zwuAsRPh?
z0ZdHC_VUjmZRhtNZIW{k%LOAf$qAog>n0kbGL>1LZHXpgD{F%Y`I7r<JG#=c{_6vi
z<YKamn46g`UAmBiGi5mF>l|AWrsBR4Za%_EN_I~=ID-Hlx+BnH(!WxMEmzPg&?^ij
zRO03`7yrwDGm<^$#O6hAK*DJB1eKW7YIcu8;llqyu6QJ++v?(|&-MnWYm-xTcgf>3
zP2Pu^iSb}3nYvL#)Dww1c+~;5vtqH;Jp6n>AwUjit8-6y(O;4-eO@^W0vj@Xq?BF2
zeDiAuSc2c2@8z|7L2>Wi>#KSS?e)g|5}-SM(qN<P_e?l_zDHUvttq=gJDkM`orhL#
zypu_tInC<`Jk8TY-X9Mhychy?8k^o>f7hs=?8DA#m<9-RnI@aC1aLbz_^epauD^O9
zCBhi)#d@6co{#v`i7;ltOOwq;j8N^(%7}kB>dS2bX6b05V1?^^{;2DdKT0%DSfA%7
zxFcr9%NOzqYbyG<G1z?W<o#IjOX&){ZJ$rBU;N-Fx{UxJ$<j5pj3ssFl&#NdXmW*|
z7&~b9!}l2#vkR`Cq}`7;-UmH?Dv5Pm8RvgZ|HVOEkWg4^l9wg+Hm<&`RJ=|k1bm7G
zL<Jzskob^aA->zKO$I75p^3M#+9PAbaGS56F0f>Zm4`=ha<l|a0uJl&y{AS2^!L`c
zvusK?u)V!3k|YW4VwwMXO(G)FTD6<Hz1S8FA@r8BU6MK9GF7HvZH9+G=p6IC*#~8g
zui)X6_oH15<E<w_6#4G<LB?UrwDHz|Uaf${%sP9^t#%!Ewev=s6B;W#WF{>iHE{3<
zX{F@eC1KnO1H;3u9?Jxy;XG>Wut8cC$8P-jjj`KO17uM{^4nHQ^PQTWW|4e^8hNAa
zfl@;4Iht<Q1J~UCcz|A+b<h5l6vDHHHQp|j6x67DP$0NeyH>^qKH~QU#=^9OyJF?8
zM?Zj~03`ifPfzT~^!tOyO*b~S&6hz(Bp084EaX??Jy+(i5eS3=Ik})`eFGe+{jYDf
zTxXgrz`aamG`cYtK(jV0X9jN!Q~Dd!u>j}7dFook#Xs<Re;amzjWQ&sPxk`p^B$!`
zVe@=6LFAx{cp{8m{q5pF!CU3~?NYQ<hV&(lR0!}s%s!ZSf1W=&;5R-WcM2Tv{1g&m
zrWU#|t&xRsl$G3jJGPKZjux&VqpZ`s2j0hYNh_R5=@iQBr?-P-uIk8?D_%S^fwgkf
z@dvVD{PGXoQ;}b4n@R&M0i5KCQo6QVI-03AVQsGR$7fXeyXU9x%hP}@b_4T%YV5+-
zDVzU1*E}S&+V!Ds)2%)o&z*371ZOO7adfmAdw#0DVm+MrHg>>03btbc_0+M&k)WXr
zx&h|qN<1~{?%+8ZL*w3h4lFrI94_b1R3krQ{>Ox~Gp$L@D1(q8{5Pj85dE7|`fmQR
zdmew=-~O)84(^36+p(;B_=mIUH|6EY0Q<)ER(q)k3NE&D+<IMj{O+s@FxkOa2QJ%h
z4$Uu^3Un<`fIsRU>lnH@3;brSHQ&y>W<F+_+^!|zqklg6K6UyQi4bc}?K~g5D6DZk
zT&XQ)F_g_iQi-G~qnt`?B$6cXQpA$zI2^2Ux1-ND{E-lR*XjjT`~q%oZ9<B;9$}tU
zbEQxFOY<N{M(>Bc;d}5)xE3^&LLWWN`se!oa?5Qi$S(m=w4Kd$B8=}ys_KaA>Edrq
z`sF7d9%BK?{eUSpR=YDQ*T!;BwSH?RIY(>fL`ua%Ht}D7t^7**Uxp|2gMbmhD<p}}
zSG-Vph3VE&Uf+NYbLXOD{HE2Rjz%xTVj21FMzo9F_CDg4!jslMaR;aM5Br@|w<rP#
z{1cxh--Q2TCCOqW$@n8hA4Q4=dRr43aPYh46Hmdx0DMD`(HA0h%}KO>pBg;X4c+Ky
z1pleM{Nww*cVU+qIxa*LoY<H+4&pBT`8#hpf?je2U9hG)X-y@a-<w*>Pf)aE-PDOp
z%-AUK;ji*IbA~T&+w2N_5cp63<garDZ5M@4UV(*6a77AFH8Vv$1#vM2;qlL}bYit0
zH59neAn@NmB6e@<8kCN=#;ync^Q}B2D?Uj}<;Q)~qvi)Y|FKi*w{cp-{XO9qR|N2d
z5v-ZHTD49&@0ratHK@ugs>Ns;tYIJXHhsl94Zy;^`R0Jy6zFXMAH;Pg7C9e6+8G+i
zVCjly4nqEztES?wsW4D3E-a{>gu|!mjfbp%8Bt`dn2iHRQ|9JP`|#h5CdU`HkUIIV
z@A#|TL^}mLd23k3DEkThw=EC%DW{26Gd`jxXD=xZ7Fj-`F@dhIAh-ZGyevYXBl7?n
zZJ2|B4&R*7>a1{e$7P}F7ytzPzCJw7xNlTePJfy;=fW=iA0uANeLNFr6s>||`n*iH
zFia(v{bjm&B^=@c+p}Ob4AQHVe|wkUk7F?JWr@XK1k*+I`+D@B6jPa<T?=+D=0&`S
z8qFC!E$Wsi?!a>$F?=XMt*bvEQxFn1CK|x04`<7E+%MEU7n`2`CZKar$mgn;K%1-5
zaZoBA@Jywo^znHja9R0>QX%`%=Cyo68?84&a3@xcFG3W&d*K*Weo<rpOW%6Z+0B`Y
zNx!jVZRYK)Tilhcmz9rs<?`k4we2mD7}|-^-kINH_*ig-b+;TQ(h$j)673ya###7%
zZGKCFzH9B(@?dJ_;dDuq62Uu6bp5P5(s;FGc+i<ts`-KhHu?24#{lm~)~CNq#hKa2
zKF?WNs71snDfQ+T-2K$cF9+2e?8{3(pwN$}Ia+>R8~eC~*+e<nWIzzoa}0A%3wTSQ
z8U)rLCJ&e(AYO^Z6mv9h%DGInoHVqm_s;=xUM*LbioQ8|gjkA@gp*Tc_aQQmhN5I#
z5?V#eIC5;4G!0X98h5)!>-@N(V^FV0)57958QM8;l^_F~o^WllnKJmt*qUQB53AKS
z2x3b^7=Z*)6Yrnw>}9tspRwr9QVToBXw-8(=l#s21aDd_7|Q~CfZ5p8;&AK<3rgd4
zFJ-R0a3xrh-g^RMI$ozcq^t*vLo?QMN!CllNb9+CFqOO%C|=2j1W}0>FHO8Sj`jM_
zsmn{9=DryV9a*St+j67b^Ao9tU@ktzcl{XAEH=#iclr)Om#U%u{&C;w55Z56xB?;@
z;sv0aju<FLFX7_iDk}wP+bApzo9JL3ZYVt6m>o&$Ab=Ixp6y;-_8$fZT>>UQ-#^;f
z%}SHcJZ0oOSU6l7*yov(Q;Y6I^enbDqvV#)!-O7+$2Wksos|P;#0<*M?<eT<RakFc
zv*w!&yhqjP4;Ax?HiQ8YC;TRGf3%vHJl+3>2QEw6c^%0}jz=__arY3fi;7ZxT9-5_
zDIb29?x#M-w%HZ^c%{#i#sb_bV9ybmML2KBUF7KQuz@!Z%g*qqKt4@EghP{Ws*q3c
zZG%2!IrFUs>*F&hZAx8Uv^R~c%zDGJx0-Di?a!)Ln~nC`CsRG{bh~(l?;mQ0JoCTL
zpxQ5fN~9=rd%FEO3CUwi%T5pgb^Ma0d?2gw%t*u83}?-Je4b93Ib0n<N~)cnnks@W
z*@rQ63)5tGl2nU2p!g`Z?_AnkIHBHPEa33-XU?Y$iQPiJc6ofBQk7>vinq64I7Eit
zsi(6{FkL<~tl1nM<cVD{SYo>Z#A$hXy8gr4d4T25p`3QAYJJ{FMfQuRCH_DI#8;Pu
zNMSkNPS-63h4VS@J;L`OqZ_{r1pRk4{oF`7H^Hs3R@F*xJiQL1o37X6cP&H1GSS{e
zCB;x$b*{+{vexBgwM0>85k4@panXYBWhgSJg=xdrTB|#)o>?2yxO$NO*lbQ?QvLq{
z;gDR8$=v~b`Cl%vw@{{#p(#!BiTu%21Sh2oSj}>7W`VjN2sAvIf$xqJ2%VERbj{K3
zH5>&-b7<`>bL<zeAQN@^%FWd-A4o}Ke4gw!wJzlqB-YFbOhZ`v0UD9eSErpOsp#SQ
zH_m(c@#q-<^O@gn7$kGrUImXE%fWiOewSFtN077vC$u+#Se<&nq~fRSchzRJs{A$}
zZf>9L?R`nV*JszbogHMAe}Y9#_A{ns#WDV2%*6~C9UdOWyspXA(p`9OkKdN5;OZR9
zSh=mRD1RJ{5+}1-=%ee$KJZrym(zcFM)*6sOMcN@0TwDCKgG}cqs+$~8VRfFSb(hy
zstVA8?T|Omx?f%RM$$C83J%>K-`$*FXAG<jfn3jC(t2qdP)Bi2@n1wsxaX9-keu=P
z#!4C+D=3Eq2yN0Y;1Pa3ZDv)K@a&^kr?6&t&&WX^s1EOijeJdA^rM<L2KyX}(WrC1
zdkrf;CU4mAeuvV6B)zTO9EKNYE@J<-s(<onk{AE~SL*+fCpO>y?)#0Mnf>R22!n!*
zgeKN%jN6~@aOQ78ibD2(Ki~)cQ(s5U-)rYJ#NG*mxEZpbE_qV4O5~q91cZBP*muus
zg!uiRpVvUdg-BAL#n;p(ABci_3SxOj3{+(gi3v8ApFf3&JHvZk&h3&;qLhuS8MUs>
z)oK|Ae&u4Tj9D#}6|@Ma4PGncrRUTxgvZzadHyI6WB-u=&;3UN)IwhTD+@it`}W)0
z0u30y`Go|(OkobY7tSy_pzj{AD$p_+5Zsd<Vk6cHXyAKaUqc@FT%v+wtE<U?C|c-e
ziFE>R5!l^)`#d2y=(Z9<hW3D<;C{8I>v_-GJQ5T0BZW$y$pF5MCN|BT>NnBf<+a&#
z)R5X48T{Wpquq~BUufpErfjsUIZ;O67DO*LTcUbIF5ch2x8&=8|K8NhI;;8b!Q>K#
zGOr;36S>Zhtw83YL^}w%o}^u-rK4+?FLm5HQ6e!75DcQYQLkiT0pRlld@O0pTe7sq
z0&XM?bZ8+hJU7Rni3EOMLJ}q8bABQvx6hco*N(H%0~NpVzi7w5e%k-a*i@NR0}W-j
z+?VSMa|lxy3o!d$&D+GUO&wVp4Ed88u*zjB2UR(xGUgQ)K2h<@GuH~w)X~>hEG<kF
z)ucx9Z0}}`hV>ayQ{hY77>w5ucBz6B)9!7bCs=2-!*D(dOQhZrX|9vcD<Bf|gBdAK
z&{j|Aw6)00sQ`Do<oNBH8ZSTObkQ-k%PW0!1oXkbk?Vi3hkx-ba{AQ%G&D`q*t`__
zB#wLYO7Fp(zG-k5g$dD?mh-daly2bIj|U%x2zjrzgtUHoty0k9M<x~o2P7yqGt}QA
z3C3sa)ZQ+@Yz(57FpK;&xhj6mXW}*kQzJDuS0z@^ch5^g32s@cEB*pEZ;_<S?g(z=
zAQ}m6D289KRNhFX#3V_@>GOmc4Pl{o5HA{TmlPI$?pmit81-hUW+;Y741g-B^!VxG
z&135Rug@YpFe54S-&9(Qu>hHjJ~i?_wtVVp^X^8cUJJfzX`v3tu^iT-xtA03<3f5p
z0Rq#hacp*_M!Fu(aJU{)fD;S+yx?$7KrIZH`J#C?;DR2$cs5k+MF?H$3k&WrmNRfl
zTi@JV2VNVfcPwmdIz)&;`T3EG(`5&vUi?Nq;?~yI)19?7O*Hh~F`^ab6cyuizg|OX
zgCMCPIP;)Dt#-d{0Ujjd!NMAd(Q$E`Fq(phySPX${alw7%;y1H%1?v!Td~i;n*@J)
za#jx7+IhZ>;(UBBM)UiHC5*Tp1x0GZu$@OihpuBl>vej;z0kSBS0r|<?))9i%_{%j
zJV<x?FeJ`;-jm=3LU-_Q8(05$CWKb41)X+uVEHRb(+%u%4S|&8&7|)x&wRUuKGKj=
zM8LJBjWSnRfe9-%ZbV}PW)&Rf-#m(&hb6-_YdaW?rQx8YJ$n)-=q*|jIn$MTx{5dn
zN|6RC(%Iglk&U_Xj=ZT>ACM3{?k~I3=sqN-%aQ$%pbLXR_74;a^rc%H(zH>Am@Wq>
zSL68{z?IUIt-J$ujIo1c#}*i;v=h+z@(1}Vf3bDmVDoDGxAD3B>J9FfQb~a4U=E1s
z;6tW|-~9x@oQ8XAj0g-7;aJ$%HtW;6z&64M+}Kbf8^#Kv2Hr5OA6e~E`3?unS4+d(
zcWDy~WOqtzafn>@Y`y?7Tm6s{5XM!~>RR`;yQqnUGJg)DJB4%%42&!XMLytvK?8ve
z?eC)+u4ko}yVGxV{OC-^x%>$gr~4$1G2Pwk-HXw;o!|_D1zKECPXcBEg|8~FYds=<
zcQ0GL!lf7#!rh|J&)$)Y-V}q*f0&$ciN^(>rsr<w`pg^In-N$IiN}V;yBuWK&rsg}
z1DsF&;u3z$U2i`P5=ji`y=X^zIl=zEyhkE5=pA3DcFI?Gg^#-ivHmT0Pn>afpw-|p
zZ^YVzY8hG3o3#UhIItYId@oCtpZ{&>wF%;5bIcbsZ-RM@*nj=QUuFp!qzwlP&+XCG
zMf4^-I*GAatSOLAtx#H}O=0_6ygKpp^sffyV?FAHg5+OU`78Qw6x%fG!EXRpJY*+-
zFm~2gYOy=&lLZbOyL(UmYTiCZy}#J4lV~SDkN5B3c!K2_6cpiqb5hU1?Aexl<M=K7
zYE(Zi-u{!TIDWY=0a+VR9ScprdSqXsowU({$G7eO&P?5%?mRZ6{Qa=U9og5<IOG05
z-XnZK=t+<w`E$_Gy-Q1HUdLSin*ysMaJ}&QZrLAG@AaREv+bPquarw{3_FvodoseP
zu$&!$a6}ucvYnk=uy4h*%Ki1i`2J^?PFVnc3i#~PWz%44R&|_IhU3;L2+CYAUcuo2
zsz#VJyD%{2VbG@ck5}+_>u?F$$UgCJOMn{2Er5YkLBG67(+Dc^nhNnS%}5RwG2!>m
z{D#X0!XqNkZBXLxczFN%1n&k>&|N^Wb?jAs^ARHe!{=1~r#|MXX*1}y#=3=+hE|SL
zSt<zJ0337H11MQH6?ay3aG6s!Hx~>DOD(D!zkGQHZ7!NT>pRDS+HYENx)9yFAVYB+
zLzL;o`OO?%3i5s0Ke5U<FFl+dC!l9wR~et3jgd*6?M{ccC~7_ZERwgPdSSrg8cIG>
z6yWSsFFk*B&hZ)k-FDl9K7V(;kKF})C2k&C<AMQ2tb&&Pw^j93jGQYbB_GeATW>q<
z7i>NaQ4#tl5^{5t8g`F^L$9x|Px8}u1t-~`5G-Y>x&cYbbP}1MEyxY{Y*|}D)Hrxy
z(A}VsquBwD^*|VT@xC#HJ26qOW!~B%9FMSE4A*J<!TZ;moh~lv6rq8)QI1>uvz6dD
z)VY`d_3G1hs9dUvK@dN_wEtaZ_y21DWIpbNIY$c~!vgNG<nLB<KiJ);Xdfb9dZ;7b
zvU`QA=T1+ch{4YnBnr5uZj-{WH;bkb%2uB00^=OC_F=ykzC84S-)$Am4KxFGSr294
zov7C$&Ga44QsWGo0#P;iH888egb%Is!&!u%Ug5G^iF5b!dk*v&CFng2hKuOv86TP?
zMfBvn=>V$`&1)W}<HKUd>*a=~7cbEMYN1d*zHo1_Fapwy_86u7@H}N0^m2xizK*^M
zo9W3s(ABjEAP>{Eb+J4?+Dv5^(a>U~$)*vx?(=|>N{N`~e_Q}VQ({h27Fy5o>Z<ee
zKN-mPrud#F_hxNM4biDqgYNLEs;l!g)HML_0%b>z7Q*EjxC~(6UjAd^4ayQ5lc@VX
z?cl=!k5*jV^U7jT$7%t!I2nlXnm0hcKdvhyUi_Y2#_xp=C%#z60VihW+jy(c`R`>?
ziM^Df0xRFVIDpOfbk|EE6YHSE$LGlNQmnFGOClO5Ndae;17{}ynlzqr!C(Cu2H!tB
zfV(O09g$0l#7Y>`$X+Dqy|D%0HXgeOE0Y;nSSS^;n5&ES?%c>3`10kYT9<IWtQ9n)
z8K6{8pSMZq2%^64A<(8rejM_QmH$<ips%_AIE24R!U&L%{s;%VtM9u8^X;Npj(+Li
zKQxT#JVXz0-JpfDV8)_ij;E4<ZWc#)DZJ66t320)NTH*~A3e|P+c%p!!#nKA^VNIn
zInT{VNVeJr08f7|0Az@RH-*ENWeXL@?Q2(tYDPi0e89p2YnQ&j#2^OfxPcK<lJ$nV
zn)!*4E`i2u`lp2bFJcm{F~Y@M_~&AFy4A;xQGb}sGsuS-KI9fGwzz`qfs}+%u`Q97
z3@j3k@^LxlQ9RDZS*rCviatOaVa!`U5=Y@TTZ?Cr@!Rp&;fN;-LkU-n3w|a!e|O5^
zBFmS<=)S5D2x~k}cd9y^oE4;(VJg|W1NbQsozaKF*>hc~#69AoBJ2q8W{YmGwdM_E
z@kbXN2N9<S6Tb>?K42{2O#I;=PjtbVcv9c(*`wmFZ-pYJB-J*8wyE5qi(m+Z7_D;=
ztcS_ON`nKAWM_?fGO9?>JVIRzU!=Bs03fYs(bf4%7_Qc-0={p+14g}0pq_^_rxI1)
z2We{s{9v7P@2;dzwVJJLn?ER1FJ@kl%mlB*bt6d$*E^&^u+jG+w4W(na@PHaV<j*9
zr(%O1%7n<{lnW(@^r~@noLI5`y0Jjg_&9~$RHBBfnrM*A$+&slWDrm(VXjdwGkU~V
z(D<pUE-MmWVsNwi$-$%y^Rxg@fW@oNU~m|P#gh873YUd7XrbHu`TA_U?2M1_`i7bS
zeagjPE*(#TGE@N(d3u-uG$6`y7%M8k0oXr206)v_pZ_(h5>!84vG(v0fRfO>kt19N
z#>^+@S8L<OFS)rbKm!>?O{}W`)VYN(zAk_>C*MAh`ZmGB;$pe@2R+JvQUs0oEXP&G
z@Xn-}p09Dq!pJ^$f6+M;TpGfZC$@|D515%{Q)TZ<nNEF;U^}4DG&J-Ny+bKs+M9K;
zx;Hzzg=Aw^F0l?Ezjim;C$zC*?VSLFDP>-al#@ZV0X(VpS8#o&bPQF2Du>FW*&Y?3
z@B-#zqCo^19;R=g_3YW*4Vu_i#pC4t-_n47jzg<D%5*3O+IKooyU7ZD$m*HO`^;8&
zKI_x%{tiJCYr^;hdL6Ies7(0*>h64%02NQwKDel)+uP$KAkoKzZXOXH4uyvxO~XB8
zj)8cxa52f+(frVPRk;bgFDqV!7CsFfa8g_!H(!2{E#7G%$J+EMRf0((Q?&@isBm?V
zM2B5k_UY3b=QZh66Mm@QeO>o%;OJF+@|fdEdM3A#tu?3p!9A`e_D>j}#vGR_*=z5>
zF$*>fXDcdN8r|QKSgIH)eeqo7prWFdD0_X(hnq%7mo;O5q1oco!yIK+M<}C$6F<C>
zg4qO*&LNj;s+OA4MoCnRA_d0Sy;c?HC`ILJ6zM{BDHN`B_j@wh_w3o<q@%l~)30lG
zghbAh_{awCM{$d-i-*uH2~UDgknt*~bN^VZd&9u@?-Z_63fbxsIQuZtHkcB@NYf-F
z#=$Ao=1*RUiD)ip7201YIILmOH~;Z67k*O#o?`HOCmeK~d}K3CBsMurLu`xZvWxK)
z<AenQYq$(=Y+1*rXb)d#d!P8IL96kkt@lkb&&H2Si#*lHK)vUE@_9`OIKd{>=?Z12
z$6=+31^6SW2x`irLh(GB2|j$zd?Ykpg9?yCGsJmMMPKyb^fI%fyIJXT`fi#}3J%%T
zLDVWhWYc6%RAWaIGN;Tz8=Zb1a`E)F+vyq=NfSSs-UU^Z^?9s}?O{>L)^%DY=}^A;
zfq+JT-&YxB3`%*fQ9VjDy!j>zVQM3)UCD=^qWV!%Wb|^40v#U`5?&r1ET!gXRRkOC
zyJ18DW8}KgjV+GVi%Y;&7(rUG9T(4Fzc?s}n4OT((z2ZsQF`O;?JXYWvX=?|2Ru?N
zI{cmOu^@2+H5?Rp?)xJy9Ec|0gvzMLUoMRc7MY5*?rk^uX&)U%1_cQNk)%l8!N+Gr
zBle{HG8&!S<;?3#^2jHCDPG@SVrw}YeQtm~N!6<Ej(^T!>nl_t+khvhE#2y-4fEl1
zi*R!y6lOrcR^LE{YSHRrHq-gf8N-~hC`^Gj=d!6>ADFfXnN*)V&C~5-`5~m$({ptI
zsgrN6xHP;ZpRH~(R>Mov>&vIOGY}CeEPBaTBbiE$u%#>eRy2$!d3kxiz)bx0n_h$5
zr)sbsS?J?Ff0$pxzJ#dd)KxZeh3vy2ZF4n*M}0s=uW5Wrz)V0u=NX+)cI%$|-H^%N
zx|?+d>}_!xh*2tdy!Yr+0|S2}6Zz1fOVC$D(q-AzCp=ewKkmAL;bJqfMZwSHiW8_4
zciD6nhDr{FzUtKGrLv55>S8!_NA;mb3pc|K;-9UR^~>imF2?7Nu1<_ih)G55m+8zz
zd3Gd<8M^k+s&Jb0KT8ZZ>-V&=q1@_MLTcyf)ZalFRZvvQXYDs5*Q0A|yj|<^!B$j@
z3{+oEg;4`_k9vkfr~M8ZQ&dZ*$!=MP4PPc2c3d3%8A5NCkDu$frD<j+q_x)i$ss?E
z^cs;33ZLjE(xoBr74n;Oe0ksuLUoX^k>TcjsbZC^dmIiSq-2464@K7(_HvrSyvI(T
z9%=}p9!hNFY!D`PJ&y)Kz6AYK-&3PyCVT$t-t0vx$<airgfeTiapo30$T6ngTpB4d
z>Scw~ar4$`d;<4;ed#Gw@8MSc{mc*8Yddf)83ox<VqW(iJBY%NJo<$hIDq4k`;JRx
zKYuJYq-U2eFP1dZEYaxq$#)feeMrOQH1PR(87_-Mrp*F&VzFxlLK1~}v~Ot)Xb;vn
z%U8Ha^nFVdt5u}KyYZ9LVjNo{y!3Fjv9+PGuT;r-VV6~-ytGK8LUMDHUMigVQFcS;
zH#d`PwE;s_QcB84Sbk4=aG?7tf%GU~fkv%3!B}skoT!mal+gWc1{<9bT>QzYbXRa1
z4y~fXS)g6WQK|gx=8&)1>;3ThYb%K%Q9IM|!9qS+vRD;!)W{D4UV@1`SGpb>Q775Y
zP|<$GSGs3pxBS(DF~gv<7e&<hkpLslux8|O<A}P^CMEZH$n)*x;Z+A6beO9%L;AGh
zD-GHS5n0aeWW!qbRGCE28D|b%9H&_rkizKe#zuaYHA}TmCP%ZcC(~@`@yhm!93#Wt
zk2h>ONImw@y4tVk8Asago9y|&@8h?UtzNxkRn3%@(kO?=?RU)R#Aj&wIXClEA2fe9
zrZ$w|k!lT-h$zn@!l`<EEvPrbjY;p2G)z8omfDEZTodK(-7H4W9iOrA)18{xRCTXU
zkEmBZQPrUinW-PfZrz|J)_}Jy=&cSDx2=AD%ZHrBqEmwI!y*!1eRbXweaX{%Fjjv+
z0GGiE%s%Ww$Z3a`=5bi3Vbdx<QBR5=dpdT<WKDabUwCDqfXIk!AzaeNX4cIgj!zzB
zKQqQj-lKhIk;CQ3wpxtW@;jYMGVfqcY^`@vc7s#&P6*1FTKQ;At->YTxQNSl!>DrH
zz^T-=#HL_TJKi2%{OaSb5Y!~5QcZ}4O`rfwGSF4(7_B9843#na!lc*opfRl~n6|()
zQ7ccsogy=QWvgwqpf}uE6k~yjk}`-AA>-0Ifk!=(RWO{USG=~R>eUjdBIZ(g&M3RR
zAsNO(-94>jrzPX71%ZjswbXxeJ3vbL3QkAo>eW+E%CG$i7uPOYnqm2sT;V-9n{xI<
z5oPYu@HMsJ7`44FyQnw@(xV^Sf$6ag!j09mBxU)d81%B4iaGQ9J0w{eBQBfs@ARVV
z#r@+2om0IpUK^2zUNAVq^s39uStdWe&@s+$jT~`X8cnygZZ6q&L>nf5?M_7u70No8
z+~FoMYbU^0_Y;riSu*Io>*=!<%`jFglPDUB?3L%THI0XzMPZC&6D)=}N|rB{ImTo>
zJWghpZSpETEyq)yTz=jQVJetr=jBR=ct5K`rgD*dCU$8VL43UJ%oI6nTT&H;fg~(h
z@+!IcC|eWi$!42yvjWVCS0TMLJDxSDuuent*KuAfx*zSlX}+LZ`SPVszq9FVZ?;k_
ze;-`iI-iZEuq!@XGSdE?$s@(vX+ha_j6InV98Pv-_7{W6Xo-oPG#qAd79x&%R5m^m
zN$t%KuhYGT@ARN-Wa`5f<;5NH($$7s|M~AZMHvV&It`w35I~di`aQ>Lw}MLNtweds
z{v^_-a)x{BeT9s)_b*BQ!ts5v&JPXZGB4akFzzi5F+9s(cpr??v(7Q5n3Z-lm4byi
zwAck7*84p%se`#~j1!~qnN!k9VHa_x9*2!F9aM<BvtiqIN1{PgSoG@5G)=YJWFK<$
zT5lp|>rHC3(H|h!p!2f*?sPnuSr%F89$L@dMQrwa!UUAyCWMq+{SO~6g^X>9nyz$(
z&d~XxJ+*+?le*<)&Do`^^WJ!zfh_BDy&|HI-CdH#GtGXz-YX^o9#Px_jdhT)ruDj%
z@-c(zeoXCE9C2gf?k>>_MsjpZq)w6JW;^twjPL?trF18#8^F_>YJ(L+xsiv?tlplh
zh#KuddGRI3(BY*uwJpl~$rt;#o+vHk8N87&Kw*Z^5on3dCH!1}{Tse9?$x}#d*M%}
zmm-(Q!#t@isykBVGsIJG^Q4h{jVE`We74=#h5p}H))?%~bhWd^Yj?R4%RzUjI5nwD
z3^9wN(5peJWv?Tth5zsejTR&t6LHup*UmKJwC2aP&@n-vW71bqp!o!5dUcSYn&llF
z9jumy<<IS}Bd%$!ZjGD|UF13`J)qmji4l&V_tGxTJ)7>fVNzY%C%G1ho<Umxqa;3G
zUTlj^4K6ZLVR#drZLt`$-$lx<)9^@ZbuOEi8OPLKAKr;1jWY9WyAYB1!M)HZ*YdQS
z1-)_=6^62<=MELEwnNEzS!pa4Q_2}iOiHWS6^H)*QuNzhFv&~%Zmya5h1b94MIj&W
ziFZ6vx$!7TdvmCSMUT3_busuL7t>qfhR4NQU0A}JnlF2N`f~L=g4-9ZrWY3URi6?+
zXfvsL&qKh$Y%*B5IS2Mu(c}f~K6nSpY+~|p8GXnh|GxaVDu1$gRLKD*rHrEbkDrxU
z4Ki2odOCUxQY9h;cONt=#MYiCDy4*a?Le|#WkjBNs@^7i$(TCaj4eyNpu)f)A2WA(
zjb+4?x&h|9%JzH8m&X|kYA0kn38)P4Bl{bIh>9(Aywn>CGed{B+K`4}49O@d7X9V4
znU=;l!{<AWS#CZ3*-C5nWYNc{Lw6+f`k6lo=1^MiZv=#X{w?{82U%*HOPO}PSnsP|
zo`iC?k)E?*%-46r?GmN~L;-Jw8FBH;({Rx7@FF}h8({~Q%l>vbiQqbeQoD@|qjGM;
zsxfb)P2<Mg0P1mHxpQOS*PF<Lq`cxMCr>si7nsJ-Di(gu>^SN)om0$KZ_ZL1pm>gN
zutT*z-JSl1GSfynso!&Qa6~d!Kt*~Kl8*mM5S83zj5X<gPo=}1@Ju6W<sDB8(w?kH
z;)*XxoY`^_wI%|Ndm&^@rh{w^muOvEQEe^POuMF8{_oE{lRp?CFm75Y<$BWa<RjAt
z$gi`mRyhRiNJy~3+yWQt#kz-ck|$mp2-@^}x?e34Mnd;<PELvYl{qq>TAzyeHCTkk
z=AWTaF^PUg@pIVqO)*zGQ`(Kly}X`>cN!LulAYC0UblB>kv%7-ztu5N%D%An(1%bB
z-o`DQXIffgQw2|3jYJx=v))dmw`q-5nI(1=EY*tg<eCW3T9|P*!wt?>-*B0ZT}|pL
zIYDJoO>^Yb+=If*bP{04RBp`IX)Jai_Zje9D(!sAh`xA8{>BkY+QaR!^YvTP?UMD$
z*#F{<Gtyt)pnbY^S36CL*u3h7-bEjt>N@puFwo6*$wf~d^PniGM~OKqm%;}XrMcpl
zsq^8_!{0<Fl6ra#9`LPDW6~;*uTC`A7&eEuigj0N6-VVD7ZS8#QUbk{3M$P^Ra6sp
z&WU3!1S_c9%lpR*r6->gtrHZTneY41GS)@+#Gv#?nhjG0wuV!`9dVM5V)-R*80>XF
z5%O~Kc!0kt3iC04&s@D1b{Um|OI@IginQ0@cS%cS6M>66JB9<0Zj=H*<eG@i?kmoZ
z3(BTQj+2Vs61P=XmouU+E<TL=AijpF^Ayz-+S#8B8ipuicN(`}=$)ARB*adrTvplv
z&x2iS|55-f|DFu2;n3?(PX5XA;sq0b)s;QNWvwG@LUT011f5AeAEY8^r^%qW%uFuS
zKjMPA&C56+R`}ph*e{TK!8Vh3GMVxV7wcO?SK_0>*v#H)L)I}gzOCdUK$dGUVV2a@
z=yLANzN0}W@8Nc=u-`XwFPlc+d)#E`$_=i8VUrPCoa0QQ-iLY!g7-=1S#<N5aPLdt
zKEsbkb&^Z&_dJxj2w_7=Q}YV|y==uCW0{VM1!7uI3n|6w^9`h0qeo=pYb;q=S(7*i
zJneHMC$0KDZ$ghL>rhewX72tPi%PG2-YTZfJ)3#O811-tTkZoZ%pGNDsg;sqHQ6oJ
zuK9SNjPq%dx*_IwIEmye$kDDpPuf@JH~=x=`Ewqq@T2V~bJFCf#gGDC91YkOFYKy&
z^4p+l{WniT!F%t6-zWWUqDrzSi+SQVx3qqz>*vL^Te>%j29`TDUMipPjX>@%4gswY
z&V<N%XLy;jmar!}IYoeVz!SO-(D0Je!FX`nU8b9EQYlT=<9VfnL^Mw!{IiK-AsLDc
ziPGcK4`nMXk|q>n8AU`+_M1#;n=9!-k!#dtmj&F$0*zo|CPhR-<iggVrBq8eOVz*t
zI9&PwkQUKUi$Kz>`3gfY9QId4M_fmAn#1d(qL@(m@_?vXBM0>H^G%0j7j$f<+pKn0
zSCB1aVuD*UYf&r3Nx|9Q?(punsimo_=LYWYEx~XiRzB#5tJRCP_Fd{;YgOo8JZWG|
zJ=tfI)GH5zRdUggM%F=vp^;Z3*V;rN*BVe#`93n9hSBZ?TcbY~(yx_guh7Z87vkDn
zAdAt~lG9JOG-+v<-Ougu6@l8Ix4_7XdzF&Wn{BHG<;2`H>A^Ub9D7}()$t}K2-B4m
z%NKS!tK&-&wo%ZnSQe4`A<)c=A<X=D!TFL$?(PNR+~2YP)#1r!f5rZprN=amCwi)W
zHWFHHv433N5jYI04L-ey+h<HInr9SZak>;fxJr~KHetC$iF|UB=@9O#SEl_zgw>EE
z3@d3W;&i|lMn9HD==6CI=38}?ObxD#rO(gH^!p0JN*`zwB?|OgB_nhxd~N>SvXvW3
zOii6oR+*C0v@Ey^z=pS<S2WFKK$k`^Q-W<oR_Y<AqfO<};Z|U|B+iSKxR8l5%r#@q
zP9tj3CV;IfvBUCBtF67p)++7B)lj#U<YQ{s#ip6N;qFKTo0Xd@iZ_{>aI)-5V0AhP
zI4H`~GEJ^;QSRi}EDjc{mxZq;x*lwlOi!zICSPMs93JR+I3HoggGABhxmE-q?aqDu
zT^a;O-h6#G<2Ofwu`WgMR}~=QN~GC$x-R0Ob3e&LJ2k6yI&RC&`E&JEfE2HKy<ZL*
z2hxb97q;MRu8S(q_oM7)Iv60MOydwmv%?G(LafPnZq&YKFb?fiLMx?w<H2CsTrEu*
zQJ_?OpNG&5wO{HO`*L#XEQSjqPbo}!9?4eY6ga2yv3+#;xdK~(26#)$Y?q>OMrxMo
z{4n7pD+Bvbni9dbRA?vdFp%NibH>^{EM<Ib>|g?uom1+<Wvfoc*jOGU)dX?YBv+s0
zj`M@zY3YkfPl@SFeHg;rqO;jiQZynH?!;aRJKvgd%8486o^d;zIh*MhU0rBCvcJDJ
z<$B1zIWA(`$e;|<a>QNypqkjoj+mtGs6=BBy+SF<m4hv{akeR_(Wb+oT!0Zh^1Io#
zS9s7PB5^*?2ZDuH=T|&XdIZQze)`wxdvfSS$lVWizTGO1?qIUl!c1{-`*{Hb8`RV9
z+|3+!XQ-gaB_vuhW9Rw9t5GsC_|Ci%zp0&e_tv>E*1B=NXyHe>>mde>)U2JlO0JtY
zu*vXnp6d}_{(N(57w#$s8UTNBK!e}2Ce^1fA!J0m9v%WtqZK=IkHJ_m8?M@5#Rw&r
zlM3Lz>?NlK##|d4`bLCF6EK;|kmX9xCj{}KryFZuGN~?6=5X*wgbD7_%(eckNFgy*
z;c)Rp_;D2Uds=g*>x^Tg`O23Y`qZcDF7<n!eZW|VPc8i=UNUla*R{5|*xKk5XMr@4
z<=UiV<6fxpE%;q09woKOH+}Djy%ijye>Wg~qI<-aN?C!BCh}*>RZ*1H*KZS2d7@z+
za;B-?3PN`)eqq>*WY^sg$K3aWCfhUgk7!TS0ldHXx{ZYRTknu_L!F-nY!{mtFyn<O
ziP`W>jn9=Z`e9=5U4%Zh?vK`2TEWTrH$(btl^Lz&MRPwtIc?o$(x|*48TO8Qb+Y5D
z7DAAxQ;^`*{%bUd_)KUba6*Ys#qaL>(u=?UN|tKT%{zCd=jP^M9qr^K4A|&!!@#Ed
z^7^b-1^%q;!wJtMF+3Zk2d;;4(KU(d*y;K5wTa5iFY*Gs%K|bh<6_6KKSqCIT>Z(`
z#aBnKP2|Tdu!-Ggq&?!tExbu$-3zNjgay#&q)ndm0<qa^^csP>z_zxwn3%h+uC8JC
zGt^3Ys;j|yl<0M-lx*lcJ0>!Oy*t`$qc~`0L#qMdE@^vJoTaiomA^A^wnU>bx7xKS
zxVBM@^{M;43SZ|Zo45Nkw6p!3g*NZ@`E;qlj)l9J|MMv|DhO}hv{;7bcTQUe&@JH~
zZEiME`kKEVaFQ~aFnm7PwQXrcdoLToxKP1*xm3+!n>2A<wM0kkNZkH#Dw@)3;Ctg~
zYl_vgeL~t&eg^`ZxP7+T*ZdEJhfr`YWZLD=_+p|zTwO#Ax}SrQjFC}h@*E!@AEU_k
zBFp3^EG{lCdCX^7OIu=L5`EuGHgFA_N|>jq><h}{KZyL?Y!<HP4AK8=(Q}G>Mm8;$
zRDo79?B%^9zyJLK%{B5cqwPj-us_`1Z7HCcaL!O+>mG9U<a+qxi+#-pBHHuU&-m%K
zp;uRg-6S9&z{Pb~94v~7iFtGW+V0-o-tMj`Whe}S>dZ20kZtJsI#xRpIO;jYDQwW0
zceW;>H`=s?3|H9YAV%YZeJ_=nNQY&P7lVh><INj=2yIutGQmxPzBk&uGPbn9{L22h
zmg3dGvSMK84*_Y+b@i&cLWW{Hke+$?g4f^b{P``|*w{EYu+EE$>8-D?FZ>`_hjwuG
z=@%ZKo{>7zh9Z5nk$SJL*~0_6L_9H;FOGW^sm`vMsXOMPQY+2$hZ0H32dn4(M~dtc
z{e=!;QuI6}vZ79%WDjOLAc;~-ut4#kg2Rm@jxedN4B?(!w8a0p=Cx1lLwkN)c#y=T
zy3Fy2Mm|Fykj6&SeBWd3N>w%29DMQXZ*Ts-#H3_o)z#GkLPA1<g5WUXW@cW8N*Vi7
zsO8t>GG!++CW>Ae?~ldyX%iUOl0+QgGPIplp@ZBnkfaLSyFFp?lp$Z4SB*P_MBPI&
z<W}p5{vWqOyC`$oRyQb8>)OB#TJL)}^(t3ebO$j^s;jDAhG@8K&LpR!^U-7kt8<xV
zH4-3Puond2%jnB{BFz5|=2+)CMi@_K#`pd3qZ_DCRK`>HaDFJ2ctsWE-)~D4R-59#
z8d5NSU^{41!f_>FB{{?n7_bv3Za+YOFoB+aPp{2ZYRH^Gz5Gj`m$BxGxtTAJlGvvz
z)A>ghV)uIjgCAn@!U{iayZ~VT&a2ZUigf(f-!edWJaIyi{!lp~S&c1>Gc$FNYE}5N
zayhMbj{Aqco%ZVs2BXcP8{NY}O|MQO7V+&GVRvKDtOuo}A$sQY*$=}(jb%PF|H0+Q
zqTh&IPFIxXm_4_UF(G@uV;<IO;mm$(UQ67@6fE?ak7PD@89CG_mo6WiqL2+M8F?wS
z*7G&3*0bQOWkAu4(^p#brs7DZ5mUV+-x?@hlwny+=JLT-gjqjx<-=#|)AV3JfWf|v
z-t}%6LZTK>#d+6*x<rQNDeP6jJsl_DHCUKa`S6ifa#R}H!QRK(c$4qC!>>d9S*EGF
z?Fzj!#jRxPR;%|M*6Or)_=FrP@9Hc15l5{x4V~UB9AvfCBkaq;m6ZgDnrpVQ=zVw;
z&(P__lLlH(qKDMxC}*z-XqD!~gvc%sI4Xl0=d{0~f*j*rf4WmJV!AvTVGYHUFk{1=
z%uLup5U8Nx%tshVA+5?!7)Yna_|PuWe7rrLn#eK3KTz8*-vke)pO)#j6R)mAzUZli
z#38^4P6igb?NKi&F<8RL2=t;uN4t3nX|e>K)BZM<{nG-|D`UjJIG!}XG^R?#7x=IJ
zI$S;QR4zkI1lm1$KNGKMh163Wz&$@9@`O*8?p@jh=fb}J`wy3uK3Pb2uB8{$YxRz9
zkerfA9W&)*s1~W2-`iC{2gaADCgr6*{*tDQRaV+2u7GUjJw=K8c=g&xGkRDYJ~1kK
z=6rTQSvi#Hy;&yR0Y85Z1U^?*kv<GsUJj)Ts}ml9dm!&$`EH}by}EX<Vwqn~#N}Ya
z{o+MO)VLoBHKFr5pGZqIFMp$*BWFWrI7@Ud_T@{;@kFm}7L+rlV4|K%%G21jDK_*1
zD$!`?9zJ@Uv0jae0K*EGNE)#-eAB-W!H+CrpEKF1gQ7{|Q8q)P*#c=g7*VK_x*wk-
z-8JdnWjQQM*yA&ID-meFa1dz_K-gO2CPAb*@$}0yk;l|<t<}F}5#xZo)#XqV&N!U~
zB{dp6Plv9E&c`)%KraWu8YYkV4If^0k)=~fILaz3Iki+!rAbR20>38WvMNH&ooh97
z$HZi1<*=rD3QC5Z<mjw8?jXZHWTLULaZB__f=*ufGw7%sAAz&p<qxk5#!ktA8f!lY
zEQAa$PicWU%7I3ORWc0*N9EAmI1_sw^5Kb>AJo=(kw{I;F!~+l17Zd$LE2;;fg)W-
zp2Y@~3GH6P>76a2T=es`S1$EDfJeJ+To7S_4ikd91D;w1Qb=G~>PuT`N<18xBcd$`
zWN{3N3U5M@1N3YV!BI2Y96r~yCi^1{IIV`=q*@lhEcx%F`NzplsgYpu)~JP`YG6is
zuF}`~j1-S)xnGr-m?^a{Xwfk4nnt-3Wi7*nB<m|QH=!*8HNbv%!0cecJXtbxJjY^6
zfE!$TG~N9ujl6%K>9Xod-;{iDj(D)sz*S*SiM^Kho`vZ@8C~GP_z;m3U(?Qyl+Fnt
zDs9elBt~6I{r$!Cqr)Q5_b{+2A2X9(rQOAbjk;AnP_e)?%_jayd)~|(5052Ht-gtX
z#>h_1_}hzyDllnALE>HK6>n+e_-UE`!j)?asWzQe9|<BF$38!Z20@_2)-2*v=@KxS
zG|G9xvVqa#1NkP#T3VL7dG1`n*~DW|v2ZrBh!vJd`OSjP_UzxQHp5<_TVk}b%ZTXT
zsDELp>8~s)^u6V=WNN{)u3+v8hX{^u-@IdT87+o#3A!NMp12gM!p#o1l#vWLC!@to
z#pkM=)JvHu)v1U@P{AqXGg54>-vP3m@k>K~+?z^je;l?&JRNfnq>h+KJz#{*^}!-<
zU>YVGLqx<cx3!3>mhIZEEvyl6b0v)w=EQ@y43M+Y*xtIm)GCRP%kv`Li+WQRWlTE8
zt^bXJ!ksgTc%LwO{R}$Fvt8=9Zzg&ARuf95>QOgT97cP~H5zza^YZ;lO<fv${Nii=
zdGTb1P1BliM<B@4I(pvp4@oQ2l4?B5^szC7ZENu$%LadWHC%^AsZSoH#vJY4t)+|%
zb`A%HSbn#J@udn`DUhQj7&&cd?3T*dL<1@4v`CAz>-9xkwubIEhWLb>2mPV@99naX
za@puU-w=)p<*@dZ)ft0o;m@7_BGYE2011*&h=W->Sh*yk^0A)LS~?^viBf~^vOCSN
z)M$cq{FO4$&X4%woNt@`5-X5x^6Q+rY16HlkdRhB3D{?B-1hP@rq!as&LdaOOChO!
z^|R6uFF-yY6IDVB`-UDXO~KkuG7UI7=H`y;<3GL*k?ug11q1E+@=dg8?PvT$KndEI
z?MBNQ-4#db=@YgK$~00DY_?B(GO8i&-|dDpr5t?Wb=w;>f_^z#7kZZR7AfA|Sj9nV
zPsWd-bquA!zWf#x_bWqMXL#fH#H!r|ey4g;2L-w<o}|YApbmlG{&ryLm1u+2_|X7i
zRFm9{weIgak<)`v1*^jZu|Z9um^#$44|H+avS@2x!Bp&D&!b~PCdLCCC|XwG#vxi7
z`TU#~XJ@0A2p4;6C5%L5A^+prq<7mIixCgKk#8wiTL4sP;9*eBH>OmIFeg*)O55OX
zj}w4(l==VM;uG<wPbVd?o+XfMR*Ub+xK89!nW(R(R5`3JuXZR~u-JDM*#*b{H(v1g
zA9x`%Q(ux>FQ+HNG@nEnx3VQiD5(XZiZYY|9te^=lU9un2G;)m*Yjo#d@&&Cih8xc
zrKtMmMuLG!B^&o-1tgguOvwmVNU_*D-@WL02yXl|!VmNPtWfeZF4H8IS|NWL4S4ix
zi6<mIS7rUd0nbWK_K`?KM@wrBl=VO^zU!jDa6#MuA?+;#s@l4+Q9MWFSRg8$3W&G~
z=?+CeL8TO=m2RYS1II$88>G8Ix<imI=`QJ(Zn$G@-t)faobP`3&)vUZ$69lYIpP`5
zm}|}ufBz##FJF6KsSXD{wZdeb#a-(|*)Y{w^$YSwB<p#Lx1`=Lw|zhF1zz0XV#+;@
z#32vHLV|oArva@Mp?Z9w%7)7IehZO0{3~CVpugQ=>mmzGJB@_G?V5Bmlq57n_V#Ae
z7Ep}pW%}Nf%fLORUh+qrKwAV>aFF@~sg;Kv*!uC~uZ(9YvC{+!5Sdi+^nI_<E1>M(
zPzPY@6KcO}SM$B1jXr${=30?!?me%Rryi!1al7k5#z<>H5L)M(JEik~G=7Zlu!4RZ
z{J-`o;A-+uMtub<{n=GRLu;G!kGXGkxr5oFP;eUEBVbaR4STBx?B9^b!4iZ8gfD^q
zgIt>tRDi9R+xuLnNVDEj2rwcnnRHbyXlot6h-%{K&{cqxn><}Q&|?t7Xy@?BO&QcA
za_>G;KO&&`;5Ianx2t}y1;WL*UNO_ye#-arYQ+#E14ESs?O&6Ct$P1K_so7&qm}+v
z4O8Z-a7<8!)>Fw*RTdq($Zdu`wh@4(*55}EjH2}G`*nH@P<itXP)d4qM#um$ur;v1
z@YFY84N9!+>4iqeEH2%<5`@7C*R``1tGUYum1gc6Md@2kekaK{&Zmi+Nl2f{F2r*Z
zenN@hKniniH#h!7MxJ3=sE)9rsbiqaiGqs##?`CaO_dzi&)<|kz1)jO*=uC##}C6U
z?v-=%%xEU_RrB?2pDnqbvZ&fHu^v>;FHCyV=%P~iyisUm$WPjfD}N!YzXts9%7f9f
zNQRg38M##PwY0gttpJye!U7%r4G{Ow`&nsk*#hj?b<z2@I_63Wkq*5pH@$0YDCO!$
zTIXRu{_)JGHK$qSDpEB;g?{gfJ%-M}y6OEM%(tVlPW_gcX#yD)B^UpVo01d(xCq3R
zBQvs+^l}eQLN#&vCz&hO^qAXPcGO4{4)^9{{cYm@R`|Ql>>pnnQbwme@l;T-o1EJf
zd(@G=5X~Q<QU2syDPa~BzMW)bo!Vv0HRbD-ZW!A}GcFqRJ^6<cub%bg#wf4qcK2$u
zt$%y|`OXDNrnia3wDt7KZ{=!LFR5*fhp{p0r{)HoAF{ul!1<!InPM{Cl4dTQu@vIT
zsbQc07fpZ_#O%1dmb04p#D6%-_?m!O1~2Qp7ryQW_(T2~kaB2i?MIiCz;R^p{m7L=
z{RRq}jB8Yc69EoE@&E7gia4}o4OC17dgnEE?$3_$=Nfkj>*gx3(ce-VDOs(mGN5F!
z>ZX4-I6{K{;vA!PjZ?m*v9awv`CmEbPZ0AT%!!D2%M5!nS4P%$CYR3OuO^AvK4ZlX
z4<h)eIC|`jHnPGm@Xq<8c2Z4#uL!X-n9Pjtx6^TQ09}g`df>UkayuwN?qW(1my_W@
z;FP5?gp7zo%cn=*HhN2h2gJj8><4U1m+~bjHrs{64AFObmd#uW_k9aDm4Z|n#Vbs3
z!oTG5&D>8esfy?o9J*IG_6J`YCcVFe5a>e?6t#Qp?7b;NOgwCOVc~TD2S;#Ept4~X
z{pzhKw|xo@+!wN$p;MEY9{@Uy{0V+y>cEuHk?bZA7$4vvH7~F%w=xr=P5@)YK7&lr
ztG!Rc_pUt1Jck%LmJzL3Jtalu!_t>2-wPDR)W=-zuY>VT&wsXP4Oo+?XWBIBasgEg
zOLBE4si#rd8%giT&MMf^i`UN46y`6X5+JgDNPyx~<|{H__9?p?5|?>x8t@-@(O7W!
zYJDC(hvgdXC$#}1a6P2GadY9<*8#Bpq`dPcOGkXi!~$b#l#abCu^z)P0e+P~b6FU;
zjyvnr&S*Tg${JKyWhuFyR++!22mln=!ZC<t+D}>5WO`xnu5TcHyM`mvI@*x1cLAc?
z@iiicqbgU1OgxSsL+`-bHOa4_w{!eGk3O?Kfhg^{_pwS|qMmuUGdego<85~B?GuOt
z+T`cqYQMez_tl&UELl0mH_kJQE%Jsg;o?P@Fh*FY(lt^n<B<A`ul3!OW?AdsT9a9>
z@L(_^UP;CUI4OcLv$i6OX~~x_qqDNI+}zy4!iHe!2@$hu5gZHjg<NIo51M)s-oXY|
z2`>SQLs`5>AWTsggzeJOL#O?A&$=nE?cXCF+a!@IlK30^&%o<l4&*aH*U?oF_o?;X
zefV$=8+-5Ipm{=Tc`%<DwqXorRy&Ku`^1aM;+^lL2f4{q2#o|K?{TslE!^V8#P{n-
zOqU(Rq9(ob;QyBd5TY#Vwif$D@88FT0~9Q0pR%xI!M1=U#l=j&yN2JYC*-YeFc<gY
zvS{(8@g{fa7QG6;gO_W#IB31?qlZU;sJM)b4>>>d5*Tps@$kH#WBGJV_1}~r=51@}
z5clG>nDU+Uc6f*&ZFu=~Ar3>*(a{kT6Eh3@U|hJsXZI_*va%BRSVF7@0}Eqc8V_>4
zDSeuHa^CfZH3>mlgxY{tg8`IJQyxV{MGXxNaDoEw>v!+ooyEq+K6h>f=l?cXkz;G?
zMIlavrI|uVS_^SGIXP8TRVyniSeT87E-IR(T5NIV|2i>y-FrPl;g4<j`7X&JE-$hY
zce=+6)@$LrVcZHQ{f*j09IawZ$S{k&5kLvAD)e}Zg*3f?#DTww-{iG!Qh3kj0A$B}
zI=l!WVlm3G9exUt5rM>5>zK3yf4DlT{VL0UdaHD+y<G3<R9z>$w`+!p0Pt5)5?wug
zk?=rWqqeQ?z^#1b^t~x$A~CO>yl4Yv`03>=C+(+C6^!6b5p_tHm=9mCN`CfIJ8DpY
zFKieUq;bN#)ObL)Vm>XhrJyMM(WpJEGxmf@`_W<kLyXp5xcw!O;GG*c4RzjggD!%(
z57P2mq{{G@<?==ol_OdosXj(ROek0d=3?WN*7^;MAii`LOZWYtaFq!rqapA)B(h_r
zL#yNTTk6+sIfpZz(a`&=^=H-?GD&S)QPCOk^Evze`->nAu2P=!Sn#!;`@JEpMwBMg
z+Bxn#R&p4%D`0RCT+`>|Jr21g+dwhIUL?(7_5LNi&k6RiKp*J)*WTHD<dgpjCUQJ$
z(ANs;d^LjmuTO-C9QVFh-oWX*df8v|CuR~~Qv9XsJ=I@Mw)FlZ+l7_#h+(+){58E(
zmS8LvYy%PD#rH9zQ25Jae4>!q3p8EQ)}n&AgqisCzm!HTTsl=;->6-fJwuO4stu>i
zBwTxMKm+Xpa#8FXBw|#<hN)cO6A@>dTD_<fJ*}D(zDy)@xVHSI4EP6YocXUo9o9qq
z^FArzSQF2~Tw;X;A!w1;vDUpVHHbGVq+7CxBvpdQ)yG$^n$-<oDoz%I@>$Vod)~aQ
zm0x>;kM2z(AC6aue+mz;V_=RSWKfdIA3Yfdn<hTXvfRkb7MV33+E^z9A$FElkc!yZ
zcq9TcF8I9rm>hP4C~J@EkpWKTX2*dG4$hOYF6$|PO=V;|zWvYAavggLuA)#}wrm3<
z%@fM8F$F1P>iaT7cJ?=};+%Wz+h=WDtywNeQn6|$Da`iS8HsEwyb|KA{*4)m5tJCk
z6$OL4xH{cDR@R=%_CX09+$YQsJ|2qtlV)aVo~v{9hzf4DwyRN}?_H@i;GZirEXmnf
zVtZBH+Cl%a0Mp?pS-SPQNA_x(24lNK3(xj8X<EAWtc0kChQ3ss&^}jDkiLGgZ*TpV
zI~jd~BkH~LLy476H})1FNlCMeP>+>2#NEga&Po|mg~3txeRmT}hhiWxMX~TG0h75L
z5x7)jMoUi%Yuutbc~py-Ur!B}qw7}ng<o5iw-2WkSTo4=<=E?z0F?Lr21q{Ms(TQf
zwR7U-r9r#cy>Gbx34L|#75;+wu-0Z;t~j|+XwKT`nL+Gl-cM9-W-V6j$jcA<Qym9b
zT$o8?NP4L}=B;}0fQ-d$1#HvLtfM3QqE1B4F&TXuK!8*-#1OP=j#qCrA6gEnjHMz0
zbDUBX=4^$x(R|HU;tfmsi1W{#>4VC!rJd22(xs;0gE|BIY;^z?dWBCaY$t_E`SDH`
zhaQ2J!@rcyq~|I&k=RMRiECGtt9*Qh5WQ{D-DtTU!CUE|0-m#{zI?Div^@22k22FC
z`TcZZA8{I$=?!80${iP;Uq{`QC$GzkMp<tDy1p!q4DQdz-D>WAw#-wnk3@Vhj<doF
z20UIFaGk;teex-nIn3KjWp2#U14d#*<v5h%o$wxVJeU)MXN|N3IVs!Xs<3K%vAxDf
z#fff1?bPmB>z)S6z042$6atGS(~unBzD-<R5m2qzSd5$>mrJjh_7->N3{<h_-g7cr
zHLrJ8a&YeH{a8cquQ}PXg@p2RjwPM}p@{WjK>zDiB-}ueb0`k+4AS@ViRt=w?@_Pd
z$Y>5{V5bnHs@~DYs+rN&G7$HI+s&Q1ZR)T1@oK{>Q!{Z-d_&x0*01pbu<bCvxU)@J
zm|x4izG1<j+`cZsa6@={d396x?n}vrYU{pj$|oM5Wffroz3UsKM*xDh&;meGL_&U5
zITEy|2rcC-zQ_0{oeURMo&*3Znd!{qDP>f0J);m%w2c+9)%ZaQy<SGyQvR%NgP65g
zk#s}*N@wB-M1zxkn@$L98+I{qmJ@tI!d5%<Ll3vc$A#NUOg{+_#%3Z0g8jj4=nR|i
z@J<iQsoT**GI1sMzfM6`GFkPh@hNC$c+*g?IZdYoVxCfI^9syE*w@{|1rr7)x?Cl-
zi|hE778X+-K9(r7mxt2Vjki%;y>kI|W@0Jg>bN62=&j~PB@~1<)2EN+`at8Zhqs|A
zLr>-ydbv)$BJtFju7Wc)@L9^OZynJ;ZBw5<8R+-q6gDrgmf;hJqF{J!C7MQyQ1wNr
z;Qo@1wf*&nzCi7Iy1BJ&1G-(FT)kb%4uJ7jYS(0z8GVG(3dz<Euk|YsaEb^*qVIgv
z<BL7_agpMO*GmNr$(kA?Xv?FIA4|qp9AE#~Y~2#JWa{|Qf5n19&Q?C7?M#&P?g3t(
zk>hXI%q)lmht-^RJ)6Uhyrq>3(z@<?pIARD@c>>a`zYeL{uU$d7JmqNR5UZ3i0pdM
z1ww?IP$&rQ>fWDvk{@*KCt&-1MFr!?aGzw1yy-xkVc8O)SDHd~!hWj=Dazijm+V6f
zYjuHR3CtJ@fk)YgOm}lofVcf-BSHAx0*bFCa#E8lVT-?CF5p-~&()I<aWBOiT*ktB
zUFpu_v<`D($mMpH<#q7+se;0a=SU(D;X>kQUai|0&ti@}xB&P?bb$@&7Vl<Pi#wUk
zE!D~x=5tfYbL_#L#s;NeSPA#Cs_-rEqw#(b&A|m^mh^>XZh6w{Wn#*u)9bm=)z)cj
z55gL4Du`=51O1Ck;RMrP42WVM7Ym*ziv8|FJF$Ox`L{9%$HZn+^9rdQP@6=CEPXF0
zhB)<0df|Yy(9d&<;z`S1njr{))o>1y@-OeQ0U=Jke6z6QI!C$^p&wPVo>^XADt0ET
zvepnMg6wGas|S}|&>KS^f`vFDYl|udOI^_X^ErKyQ#{O#Ah3*x+KWO_-46(Hf*3fp
zBV^CpMb$Pql$2bKT}Dx)rEKe?2jB+GX4|vkpNcfTt6$(R|E|?XUjs8_D)8Q1!tLG-
zcfqSSW4n<H_+%|Fb1K|=_b1IPCZwKT@O7r?*oorUSg+9bcID*|KTn%HDq;aMlcj{a
z)*P=-?$Xn{t?;~_O9~}3a*jQ5K=cZcAZaG^Q~A|QX1J{DVZE`sd~smQ?^#rT$VtIF
zBHJ)iGIv8-A;siF-pb?dS1wXCDP3*;6wI|eW8vH2qS>Z#<oF>B5E-z{9nKRGCKP31
zPR@oaU*0WpcXz-=8dx$RG27>EXp>=pkTx9kinXT-F$5BCaa`E$vr>qV&0!|iw|%I9
z5k1>(J2qMpC6&DoT?a-57m$5+xXd6KJY-7P?L&(n!x&K67)T*ffHd`mYt<`koI2Si
z6R7(HyC%l*T;Ac3%e(!CE&9`QZXA0>$joWlcrkkUI;x3lWXN$izg(gx1_oASW|DrK
z-LlDSzw)=MWrg_rwF4zkZY_LN?G2CtZ&y>Ze?`Rlwu}tW7J_RB7VU#-n~4W?q!Dit
zi@&>Bnm<E4Y^c@8eNe+2kXSMTO{j-pk{jruFLll<ymULe&`fP6TVHU@W-Ll&zGldP
zTF_TQbbBW%XCa1gP<>Ll>^M{UgC+VUa;ZLOy|QHu?R}Fz1#IUbBMt8W^D)rz%16q#
zMA=9i+>$CPk5P#6J_QanQ{&osU^0zO);uj^REQ+Da#n40i}ft-$MRi=q3m!)>1s4t
zt!ze-^&siR=Nb&HNP~`^_5-7G)(8*n^yc@Q)<>f!2$!|MgVp;<$Z{T-50JfYJB8D`
zfRD{k9gw><IsBMy5?p#nWyk#wfdoQ}Z%|&+-{J?#96p*t$f*_K^L=LIVMW?crWH=O
zgvHyv%daPT{qAG`h}E24FAE_=29Kw~`2ZEvt6q9u558A*VdgunHxXY`-W~mtw9_oi
zjmRtwQHpBUIaOu8PPs;_21SL<@_KgVlZa_ina(PNlX7dW*V+4yj-H<T2jP53Jwn3A
zYn0HE*ekq4sTcxzOhgFEf~un%2{AmczW_I)?5_pH1G8y=3hr+{T|hie^sPzg4FwD_
z^ATlEj%itKhDt3^!-eAM)^uAIBu4%0yLq|IFa^=D8=|+q+V|?*T-OULyMzVCL-_s>
zF)hKj>aDET558%g&rY<1J~CRGHo{zEnBnzz@=ziBo_S1j#r5DCSpH7tRMBqSBw^<5
zp-lzRwdGa)+rOQ}Bv-aCFL1OJ%QS_$o6?a{Q1bDw>3U#9O3`G|utWu}*Zam);9#nS
z*DesN$0N15qSQ;i9W`<(i<+x6S3vfDUXQiQ^5AUbV25*bfmvosC!cnQ!@#Sadms?@
z=%~=7PQ}#FiX+AihYJyDX5X#wAZrnN^ZH-Jb?IaYF8mRV)ek4fczd^JYwgUDl*BmW
z2ricx9Ha>RF=YLM0;WsGb%e)xu=q8_rv|MXm`GV<27dS&?^7jg1ZU|1%Z_Xap8*)N
zw8-K6<2G@m{S3+8Scc_no8iRhD=s(2Z6CGgHZP#7<9Og9{qdt*Jq+*q!;0mKU|zq+
zKBt&R7>b*5b^M&yBhViV*ck=3go2a}#lWXPappSh&OH^@=dfr&RJb)@gljtM%$-8M
z#S$^h=&C>@9}AWRIZsWN_bHe%!5NC7DwkE=U+<Yb_w^O!H%*6U>(;tJ*73#z_h{#h
zR_=CKvRb-Ykw%z)#h%s<z;a%Bf8nxge{)|qQhZ?7&6Ei0$XVGH#hsQpmSCTU^-p;-
zEl?vbMy<0PlEoTgw+u-{)D3<_|9R*#2u*<emvp&%Q|W=gOLp1JLJK|xDakLmTB6Ey
z`0{|SyBeo?I-yaBw8GaM8H^nlod@TiIIo^up(2d&!n*KvvrXaIIuVO{I6v%<fls5`
z9!WtMwDP<Fmd^5-|9n8g1xt;&xw&=nlcb}9tfAwkb}XC$C#klZC}yg%;z~Vy_-kV$
zObEUI@fmPAu(JLx?iJSAthPKymyr4Qj}jM-1;v4Qdr|!U=H0t8WDL5kU#6$02`DKu
zarbAVfENKe!<&>-@&hkFKP<ONqX7|)`SpSv0bkcPhN4cV>jV*?()`tkS0F(cf9R4z
zkeLl|PKG46e|44?#zsm@N|FlLz4pB+ws~>^Hrbk8Tuk%8JAdAOt4DE*^^0LoDoMQu
z+=V3C+`^)>9-isRdX^&B<O+}Q9Ke2nrLoTj3AysncA@iIJE$_5_}8z{PG3}RZ^Py-
z<Kw?p9n20^N>>AX)z#Id1=ik~x5Rl1l~^w-=nzA6ak+hCJ&~97QR|FXKWd`>7V{@Q
z`=^)+x>)2y23h$ap!rl%XtV1vAV4U+d$}vUcwL@ToT>U;@RL5uNmJ6K8=gkrUoIRg
z$j=W<dJZe4-QBxz!dhoYISuvqSheaHRf~SX=7+1WLe3(gi_@sr3aB%9h%B+2S*>r#
zW_2{f+c!(4!pVNGqzky~txM!QUmtwB%69B4LCNY2=a)_i8+TP0>?KXzdlXjv#Aq;~
z@O^cCy@X02!`9XGYxGaU+4a2AD-F65VQG7ud3<oNBDCmqUX<D_&%iTgT6LEk9UbkJ
zQ=g@bkH4IJ2ub9(p8=D1?6vX%3!Wws>_IoXTM(ev#g_tKBMIR^T~EagK-{4g7ffnA
zJmvytKP&AO>a|DW;}>R93cRX5yDa=bT3Q<Y^-v>|uF$0PAOe@YqVOlIv<kF|j*E*c
zu$b1qH%VB4Udi7}?9&b&8`3-6&DLTnynE-4q>&yxr>zhBAbjXa*4BnIFLkuXD$rZn
zPEKVu%(}oS9#a6hD)SOdUM18ByWLh1uo9LC^ADjhb|kIiRR8Xkk<zI=x|x~Ty$-3#
zki_*~or#!#E%tqHO2O3W*_O~adO<<K{P?J-s8_~=Y^EsX3l}bQDpXj_%W0_(RLff`
zK*xfG|M<63yu32=i%E||W9b~Xm-bfgbh3fYNZ=$p{ONO^$`xR1pFVx66M*|y1Yfc5
zN_c?=<rMu`JOzT-gA(?L?kt9|Z8ZwzJb|nVTSOCD-gw6JdyzbhiJ!kTKAzvS-*WAz
z*s}2VP<B01|M&7{CNDCS^VLdiNIoRp$Tg|;@wu{$YC2mTQaD^4Ak2_FY#21(%S7p^
z(hp64Ci`FG_XI-|p&8x$723(q8_h;ao~wug-zx`MyJ4)2aVNm`#i-}ODTuVyr}`d>
zV2tPYx>Nz$Pf@G_f}jWZp+j96#%FEVa|t-tr%JSw1+hBEz!VR<e5^~1*qu*`+B`v#
zaT?N|)Q5Ey?|$Vpsf9gaON)y=N!WE8d~U#l7Lf&m97CU*2*smHa}E=52X{4aaC<hS
zh4$hZwp4323nb~s=t$ssk@t1BsSs)kltW9Cn_=>%jQE9jAB}29ge=7q!vC(rG3YCL
zNJoB$ocONT=%OS!C6`LZ8SI*5*|^P<ubtXvW?77Wx|Ymuog7TW*5DB3U<P^d6WF%0
zhwt^cE89#|X+FW*H*ZGmXDP_Y$Vjw|j8x#WdP>K~DlwcUV&*GT8M$PR1Zg(F$1*8p
zs`54p>`nRGUV7rr#rFHk%CH=Og6q`4H9&WOf1rO%0R0Hzy0MByPZ$x;SAEH~3WNc0
zih!$bxc8<#$C{VQ;tf_8dRq|t2OeG&kNMAQ(gHD_49`;obo5x?7W|y3acd4@LcuZ@
zBS$+sTH5$<%kVWZ8TS5a%EZ)6I#Tt)5DVGfdMX!HHawx-XtsVot{hmQe`EgRr%$rM
zaPx*r=FA=cLgg^S6n_MFQ}5_UtzxFqUUy@3bW+aYbM1o0i&C|W-x_2bT8lT=NeT%#
z&!0cPZ|}c6RH&E=6k8a#8FK<0`cPL}JKyM&UO<4ut#7;7FupRBXCTjH-^c65l><Q)
zas6nK^;KT+nP)&|VHib`%nqR@jEB{<=$=r<O{-->^~UV5oAMmX)?eL{xx5TC>)A`=
zw2+b%;8gSBGTm5_xfWeic(^L~3xg-DA`fY|P?0V81%<6az1u7FzF{K-!P}Dr5UIMw
zO}Ex$jX*AJ4_;n-Xzyy@CotcQ$G|!Z&+Ri2$Ya;x)-T8N0wV80bGv*S0JFkFjM7^R
zG@m^Sc-6qfq*B0<px*YZvGQnp$j@c7L&D$R-*azw*KRrJGZlK%mvt3R??TtkcO{W+
zD40$Fwwb=2o&30lEkRN$N4wGQV0)xwLi0<eMrG!R`r34`hL?xOGsH%*8+(=ybnfIs
znRXf&pA61AVx0R2!0vUzJ^(gt@@I1x%V$&__P`C+PaHf+Ih{|Ac0}E98@u3%dM{$u
z`-}Kbzi`Zty_bIya`&E!Xr=R!>2MJoBb_vs@ndvUeLZLV>#LgM{lzTn#a{HUZ#d9h
zzXJ<Troeo4xWcx!Am7eRO+`>0)7F1J)=4!Adsbp)Fi_^|>RRK5S6W)S12e5sXj;d~
z7{%FF7r?e&JR7M}Vl}_FF-vC;%P9#^3a}Rn&15Dpl_FjjN6e{tg{C9B?9EPW{dFj<
zfrI&%bWKXZt<bj&H(q*6R0J%&!l{{;7sMV@CCDZ{jqvmHyCjwL@#Dv2g^Vxe{dJyX
z`JI_+rLb=26(a$QIvm|MPb2Q}BT@*~iya>y558P1yvut7L7u?KIzM01d0*Iflm+37
ztnX{mL9%RCxjf_(Yt>XZ36cZ{soqlOEEQFyI8=A64&F6{88Yn@3kO={E_{t(aN)yr
z97v9Gd5|z$1#E>Xl|J>VnYWi3&=cBqRj|0jW_e+5PG3jp=FM26J7#8Pg7%Yjm-k%C
zrK6zY-G-H>=<NYLew(Gal}OWOVMfL!z;p1pSFrZ$T;0|@OLERX|NIlq&~@0KPl6*E
zI||LlAXz@DtE+?je3X(DY1kS6Nr*>YB?J<{WG&uQ^u)R@i_(v8-|ki98H>PDv3gH3
z+udKU(AwQ88_Z(xi~*Mdmjygk&7_=XHxsI-{W?zEQ`-^xK-yZH-;f|<VjCQ#gF6W&
zM!wHMY`dD0Y{C2&36&$QB2A<{;)8?4Z&oOn(j806%koFNOu$WCtsWeqO`#<+^#h+r
z(@UAXzY87U!7HG;tN?jns{9waKH?&8(e*SJb{-rd?#4G$@4h2I90|A$Isi+juH@Pu
z42?l^k*jAR{5n~d!Wn8bxEaq7-$T`r3XP0}&wSRS0|j2>ub#Fkr}V<_*296`93H#^
ze_~&OB87LdpG9gKz14KV>`>7q^Wt~~G(0Wj9*2K9nvD__)oo<`4t2+Qd|AWg?Uc_~
ziF!>j6rug%;g@ALCM9U?gHWe+um&JQYMcj@7tNW}qofbd3_rKH|8u3S1`jWc!jWz`
zgq!{rbhG_y8Zy1zNH<Q1pFR&LD%eSu1EQlriY-*><nVxv>HL?OSY({8he*&~Vxy;b
z?3wqqkgClbmcy?ap{xCFV(_Cm-|ncqynckoT)bT(LSR-Q)tCG+lzIll$Ez?%0KKGA
za1DE8(Lu{20rfe3p#P9SCE_dreMcLLlVxdpjq*fEBjz(_t0Y0XF!g0dH(V%Gpf<r9
zF&Akzs`rP*#6QeBNUayjq$X67?(hxq0by{0Jk%gE>Q^X`M(O0=jPyaHtB|~>qM7xs
zG|)7By}|+dK<BXL-AhR`)kGd&1j-!gc-PY#r*}Mxq=W@2WV!;+&0FI#R#cI?HInb{
z%g-&3fJ-^;zr6Vq1UEjv>-459YZT}aWh~cHsM8IWubFIS#(Xc)<6l}8u5GLv&3{l6
zaxtb(o`4Q!KRpvnhB|BbQUyXhTi$T{Rq2K4&_%yQn!SrRy+7~}Wzyi=)4s?!<4Rx}
z&Xc=8L8#pKW6uVsBjJVMo~>=6EL=<e_|3%fYWFmxll9MI2f{q&680eDbz?9$?GZ0q
zoW_F%=rg2YV|`VI28d#SN$L)6e&o*#@i^#*XUv@pyg;Z=R{?WajRPnfh&CXOo@11c
zX>AjV9iiI>dcP&SI0CvFP#4?e!uAnlQ&RqqlA^NiutK|s4!OHz^4PcWy%mhL-+qYr
zPpm7;ExyntX!0cxVo`5EA}hY0Vl*JhQ3oV%Pb~}+d11PlIX8tEZ%%jLBy(Iz{ewCw
z+<g7<25oJ?*X&>yXhdW(Bjp*qsI!3f@*#k}3$(9>M)wt%fU^t_FPAjAo%lg&f^U5l
zp^y+J?!vi~NUd!vGJE!^SWI2Gj(CsK#Pp95X#LeS%EK?W$tfytXB22QZOLkZ%o1>u
z>sX(-wIC8&F;88w{F7`5-WspOJR~m$cB`$ms!(DM&IYl-n4d@AL6Vzwt2(K$x(?A$
zctAQX-1;_FTZwTHNym&sR0=W@YNQ1BF^~{%58laxj(<An!fk1plPf=F*GvzwtL}U7
zHSC%;JZHc8A8U`AF@>8C!U8npL0R13IEYlJ*jNoWW~Q{4C)sC*OlqIx^QFB-<aC8)
zDutb%C+(x?D(>e;XmV+l+m1BUAK%2jxyh!}d{y?rvj;NIf^rDHVaLAs&~!yssY&L6
z62%gm_Nv+$rJTYyOCxfAvwMLDv!rd0x&WkfZEiTDH7YtSpRPPSiML<bdBnyUy&hO|
zl57e06KRSCX?VD^)bX01(QqU;d2R%E^I|;|+9u0JMK0@BsF>@-?eq}9SLdtNLQzxs
zKdL1&dSJl?7Im#G>bHmCE`+AzCyCfTY^Lh&>T<c|vM5vIoj^X|b$xKtUDzL}UtA{T
zxfcOHz>*`+zlmkrvU48){zo%$^dPv*FPiNTvM!50|2~1>9SZqb_?GK+iHtw0D2^@&
z-FUbAtUCz`NLN}5o^Idnjh!;i^*4IoCbQD6!52jgqZQ7MdpToAUAgacXQ2z?vPh@#
z3WvU$`)HrnN!ru+50_02nlDCD9Mz@#?FaS~qZ7Mt;WzZ%(08vQV?Hbv=17)&QD;bG
zOC>ie7f!Q1v+1-ojon_W<_5|DQ8{H$zrA)-_Pz2mECy+~kA6*8C$j%@O`^}N`&0L8
zi;i==A@<%JiuB0%pWR2sZzu*reozKZgSK>%U9lm}eSUADKD;!(E#box3Y?}j<5fZB
zQ?;B&)RIha{ze7K#=!h{6Tk?3=>1JVAS~)-cCZw7Zf*{6XsWa!Tz>6q{qRS|jtA;$
zOBDE-Z3%wpxSP&dKh_U>%NH=YPBNL`Op$2D!#~zqL)xFJm=0xY)x(CVcoclJEE-Rv
zgwSh0YazXFJ%TBsrYx<Dyv@QiBfOtV6LiuJ7zeA0(@+d+MFw^Cz7zXQZkOMX0@POK
zlXZYDU~8$J{%kEEKq?%zQupHlON=*d$<HQEr=nPxj`z^zd=OHx#<~7+1&^Vb)-ZY&
zjowT(RMyMwl@Sz+CbN23vQP@dnWCJOBgOR+O~lF&tHOGEI{e$kc`g&5iYqC}g)L@X
z&kTv~H@Zw0cr+AMgk14sV~vWqHAaY!&k9ARm^&dn!e#@o!3~!JcIGa_j4PVA(%MX4
zCh+U{Lhv@ZEMiz#JTQ0TPfIcg;@V+<zx{)0mOQ-n=gm%6HXG8@eFJmU$NsqS-I4W#
z<Y|$~&+ngJy?T|a*B(T~N(N+3sqHF2;2wH}=4$O6q?i_~4O$sXMa&9o<pE51gw+dF
z<bhUisv_U}bBgTkf*dX*UsGFa)b)u*3smfq@TMy*RK&FpD>=XQOsQLFpx?f`V)p&8
zkNdbl!+B2!?uU<$59g~OWtSHPKbSxQMnS{#{do!NpEbpglgz>^<J&-ISVh+mi|Krx
zVYgRRJ?%Mkv>Na`%1yzMsm$!;BX;GJAuj%kQ;|lC;*9SV#F>R(@hbzRIhVFdWodzp
zQsqk2KNvmnD~s*tzH>hU;v!ZwMmr8E1k19e=kP8xs|v1Y=PKYC4RC6%X_r5+x~9ak
z<9E<RsLh|lIgnUFbpPS{dyIKU2=eLnDONJ3?gvdKs{Q?1$)M?U<?Y90lN>dq<pkMQ
zpGQfRJ%$wvUK&dlFsSs}O8oIC2wV$MA{G{dhcdn^zq1BPoi~RzXKKTIHYDlkZbOWN
z{M^0Mn;I(>WUU5V@!R~@Z;sWF-)QT0=uIu%r!wR)>7XsA-V|`Z)ySpOoP+)%cE1cC
zOcL{=eh*>mb-lMy?HqgBO(`y~#p}%#0wzz21~1+cG^*BVE*#D650Mt7qa6_a&&nID
z_`8Tf@0w)jdn+G59x8geHZfb?$v~=fjd>`zyrDwddx7=JeZMQnJ;q%!DNc44vgH?U
z!~MqD5p$l*%Kw>p@At_zlyt<$_t$!u??zraf0VggzpQRJls7816@^|d<{mZbLI04r
zrtqX!kx!z)%&9$gNmlsM{g3sSkaMgjwPQ9t-8%Xz2IJ@BWSA=l=l`7k{bEhdvnWy-
zUZ*LU@;{zAeq+kzdtc^XDdW5`P^VNk?(uw4@x*%T`jMBeHcJl6K-`j|F!BA5dZ*W|
zn+QQm4-@4@jeHf2K&Ha!t-Z;xWAJ2|%5Erq^i!;dxXwzbOo#09aM>4eg_{>-8qJIn
zgYN8n+!MGK<!dRvxMS_LB(;6}pa<{6m7hv5EG*Y3-g1YuvVu_gC2VWtn!iY9o|~_#
zd2N_Z=ta8nouTI4)yS}0@m7-m{f>02vY=*4X(6#>qOr&AwYj%5{vKrKdq1C!bUTyk
z>W#(_cD*1^sxd{2y>(J_ZxlpWEUd#8Dz!@AJ}wnu(!{68+zQo{-B~GbHXmg=Y`G>w
zk41}fl19*1F{t#EzU;YT`JsI0Ok82B9`VlAbOO2@iGi#oHR1RN)5FCCa8L@X#oEt1
z=s$f?ioK*pu-~0h)RVix%o$uO&PV$W=%5$gdk21Q&!V=(V`FcTo#YBQ*+mL1N}sCm
z`>VqCJHs;SL*XNNQWytt`e6V3UpiDkiASkX1f}eES2cAJKIse-o_##R!L+Jo4?_}d
z6DTGv@7R5tCA_j`k`+A2RX%$hTUQjQEDMSaEN^C=!_gIl4Ntke_4>b3?*B$JS@-^M
zHN;Z4OYhp_{glKqijAFogDzThFWDpEN`8zbN*}8gi>db`e$I!4joqu0gK?hVWKzxw
zsFefrkZ`FNTYcSa(o&`B6s<`_qR035+}e-7**}?^nP(|5xO#>7Ws1Tum&!KEF<9#d
zUW-GxQ7!Co*hNH~@;vQL_O0iJwPD=cR06~#6y^7#B+X(JHr0{o7l|c5v~N4^U?;aJ
z<(nXj9o<t_?>AoLmBZvar%&d~9pVr&>4eh=6f3*c+vsA=T*@~rpMDQg+PgT-9i{$2
z<Ym=IUf~54-CKIRh#c1YRDCr6)k0gorie(@XgPC5`r7!nhoNk}b_%Flbo5UdIc&<E
zkFxfS9WLg_?qF;r-CYRn>=5a&-ZT;Qo~)af>dMafWZQc5ZwtlAm6+UK6-?YmX#z+<
zbv;SB!`X6Uvn+qouok;=J|fDpj+xX<sF1ix0hPrfWvpG9W6OJv_v+Cv#=7K`&qOSK
zEE>$k_*XmcX>=8u(TAqW!~}RMv*wFt%#~vz)FM~@iKIGLx?MpSsNpG-yI+kvr0!EK
zc>JXWmsA24su#qz%-9R_@1y*(Ze8MvQn^IsG$N`ob5DEK;*tgJ{)Cc;ti0gi>+Giy
z>b_)nLUvgdi4Q)-lCYh<OtN0_1oW7`J70sR0=YWzMRv6xtX~Dnetv&ztBDYoDzdM{
zTB|XXy?N8OzrPiBIO5=1hx3Xnj<!Wh1)E-MkJwUinjPn@MZ-ZTT}92^DQ{btU{;Y`
zet4H)C+<L|gJ042R_CJv4b3&g1$g4l7BcWU+Ux~uRLJM*@@nO-`v{#J`uqCYI=N;9
zT4t-Gjt^ElVXyW;7LCq+t&x&IanA*UYq_!-^T+)^(+CbW=Wi#mR8phg8gO7RSgfV2
z%lmT*=PzbD&u7&vgq!sb+kY)f-OKH}eHuPk>+&VYAn64krYH!ovaGbei3to_G>P(C
zc`L*Q+R`HO><hNPGEhqXmi&{m9idk5=QM>QV{$kT#I}s#_0~dBp)!~83$4!hEMwc=
z&$<%<{I*_fI+Sn-U(}kG|1Iml^0}S>-W<zW*bndyN#PUNPN7oT20ih9uqj}7cT%A)
zo!kjF0oI9sJy8m@d?>5dx#E%Ndp-UA{G$~H<{E9Nj40VRLjet1D$ye9T6Z)mRBJyI
zv<0F{m)mweC<_p|=f^IwnvE6}MxDdabDHu!SS?*Oom9`6hG#|M)2&>L_gA0Z%w?0y
z(}$<eUHWz+#WCrJ(VT}+(TqNeq`;Zuam4y%udwY<>?mIvfl3{34A|Nw{>!P4pP^Q$
zj>^LyzVOF&7)qM*+))l~XDU$9ctuRe`A=I?LJcm<*18k<4y{%kq;9;yrBDz0#vp%g
zA^)cr1wNcrH1c(#Qf{M}WsJ4We5_)ijjSV$!7|>khwa-p65*pwrh&m2QA-V{Y_Chu
z#@buxvCdhVYOKvcYfXEQh~iOt1cVEgswR3-Mnu7RRQ7l4Juk8rFxavvq<>8(=S&T5
zE-xJmu8Cupd>v-dBwiCtFWqL)Rlz#eP^8!1vOHAdIn>);E17Xyg?)Q>y?Lvp&<)O8
zUG|k&3I4Xw)BNRmLZDWci>>g<aJ|i<%XyW;4-1acrI=W(Kz?izS@tr-+P0=&O0kD`
z?6pPXE#B&4JkI9`IL8{(QgzHj5I|#;VeN?MPa&n-={kz#%kog6eweXzZ}8=JtEkIu
z7@a1bdbnAWOPs3^FcjsyA2iG?L%r%r7UnTv)Ym)P=+6#2I9rHj5o|T&z^N)qT$VG1
zZIce1I$pquKJxmeY7q2MSBGHC76nVIAD=^1wJ{#TT5eJ}>OU)>kJfOwDgbVTxY$qz
zvwcS_)z&guwllMWp_rBtSdM~_sP)du{JneTvsWpP^I0{g`vb;Cs^1H1w}jjf{Sb|P
zQGCI@%L)^1-$3I!?0Hd4*-IXdSDAdX?6D=o`)9k`ouB=mB2yey_*^@0cJk-wHbcs`
z)#Z(1vFl|?KK~GTR@r>E&7cnd%UBu_Dc?h9<G##K!v%6ENj5#)Ae}Z1m$@IQ472zf
zNA}`gR3{_E+`{gh70PRwrRxpj{n=6cc(AF?owq;&2D4<b;$*Bg>kLQv9+-g1?XB0A
zQ+(BJwb&18eIZPQ%8y-(Ni26LPmu0OmQ_gn!kM=E)ycT6veaa#+Qa)H1$$y)1zUz2
z24?E3c;l}dzLM=JJZ_(mnRTjbU1Y6KWGc7t=|g&q4}bSC@<s{|<~{ig{iBi3?fG`2
zPNw(+7TR5Xc0p6<!r1ux@8#CD+zH!Bg}Dr$$vdm&FX*`qDI*5nmE^+i>@;?KRI1%@
zMccjdU6+yAtl5%39EW~WYZ#pYoBum$eRV#%lcB=RwE-sSu_oxKTQcD2big+Gjih*Z
z#+T-VzYRhjL+M@rWXnfi6*vkL$-m-HdV1gqT1C|iX7h%(S+#!AfG3o1b3=nCqoM^5
zlcI)8^LF%KB$CGb`Mk|^FaZPbe|`L0a>#Hg)J(%0{L;?!AtfwvzFFWQn{#38+9daw
z6Sc5zbI^2WLJz$(bDPhNWJn2hiYvwG1T;54z+>^%JSlLz8!*^B)YQ}~XRqCv*u<xC
z=$Xw?7%pIHA@*pea(Qf?yR*AJ{jeHjNL=$0Wp%QXp4Dl4)Ll&b0`*13a_>e$xkD|w
z&E)v7n4;IKb;2r9T0mC$IE+F5*Jyd}rjGL|>K$#GEoqi|?`h_eg27_H0{$j}bj!h$
zr?hz%mWZEC_)vnMP1IvgZt74z*k-P$mWZW_ti7H8^V7A9o>^mIcVkX|#85SP3ZeN(
z<sCBgZG7Oc2Y!2tY}UDB8d3i=h2csUFIHkwzB$PLf^8Zo@TNz+G{Hk0-j+Y2cfx~t
z>1AjAUS<^8t}<$UOII43&!uwumH2qX(d>p>zLq6V#C%hrFxjet)A*l`Qyg1?27;I*
z<ay0EZQ8mzZ+I*AL@?=e9{w)Hf0Hz%oqPV3tdMph4$9J4HmLs#3&c|h=(ZLWeSObe
zP7OjSvQblySN+LbS0o3=*%emL4JAG~sIz}dD8+;R{!x7k=1EJF3l<tYKUaBNQo1ps
zR`;{Q&rY1V(13C_EsN{5`b_wP2&p&uKYP*^-@IjSdIS50&E-D%(jAzhoPUQWog!?q
zjeVrp^2?gFhfcGQ)A6As+WZSH<VmcL-hwlA!#Em2edir3!csBPJpAo%sbbK~G%~W#
zD_rXPo3YL6c3xqoqaG(yR)J?Tuh2@Gr)aCecg{_Z)ggn&*-3-s{3Q>^_MiUJLEQC$
z%H{((*>%OLMPHlj--@5-hK(X-@0GvnlJJ<z{|O5`%%BZjlx4@U(S+L4`T8v7XLk1a
z@QPYA-I|B0X_xr{Pp)>O6}Z%FU>n3d!1{hA)~Loevyo{j9vY<uLei1pTuHXk%Di0D
zkNdJtI8_Q53sg>qd@e66c9~*go>OKNUt!t3zCG`Xg^%Sa|EGMC3YFbLnF>oo8mor^
z*U{tZ8}qflrr+J$XKOroEBvL%CRHd?;=jOlQyEy1=SsP{T)5C^Xm2%7P*5$kd6TWX
zK6R$9p*1Yb4R6(8)3>Q_Yo0D#Nb^C~bZi{AcGGpmCG_4je;W$6j^G>(>VtDV5<J~M
z4cJZA-P(|FKal*1xK%dN180*<XaeShg<TQipc`&0r>P1O05!Fz?kZimas@UOqR`0d
zFF#mhi-hB&H)tMbkcT-ZUL^G3@Y;S)WJurtHZcYRDt9#7RAt<dTt@5pmyZFE-Z|oV
z+(wtaZ{#qW6n_xy-2!+%$XIFrM4-yPb$7Z_P?me;_lFW~BpGJ+yq6Tg@1m(fw&wC<
z<3-(q-3d^K<8OEPD$S%*2+W52txk@_v}s|~Oe$Osvk^0NlGkC&2+Q{u610E8Q~e>Z
zC*TOB4r6Z`17gU{yrwQzdNVEG1RV=VU~8tmg4!tO1uds*+9`6ij+^>N8|~<Gm*xiZ
z=H>0zr-lp73hZtF(v2?!q;qG_HoP1yD;~@<I2_P3t6USWaa?8E++V!h%1PK>n@%vD
z45!2-*T3k^Uo@)wlxK2K4Qa;Z<fxvFjs_qwL)6Td@$6!OE<iA(CTYfF_C^MLh)W|c
zkqhjZf`ec)MN@kDnwtYXuR>F$FQ*D19KklG<aqC1`&^-o?VKK?My{s2?WkR@%HkdA
z=gpBQH&)XW1yznm|1}fU-p|Z&-Jks+J$)uRS&dJ9?&#DUlyY@aUbHq_>!L@X180Ia
zvAI$+h<r0{h}~&TjL1^b3r;Y?fg_MW8`I1)q>Be|C|_;i6B>McQCLi4s@3E}Cza^q
zgWG159`3G$s;g%dsytYsnRLAJ1hxnCDdk`7Xv(g&O+<iuo$zr{U`1;lF;d|nFY5Q9
zeYEAayltiLqwIfMIO{q!u9qLHy_^;?ZB?ye{oF{HNv(3pRH&v%FF_$du*q3xb^iw4
zoxaQrVY|DX#?8a97ba(p+<cIxCKt03n*$)^0y8{r9Gy^)2VzgSB*4xaqQ4)uJcgM*
z)c4S+bgtjo9$1zo<7yZStbl{&77q6U+vNQ!kH4@Q_1dzP+O5sOzTF3RrD;A52G{FN
z>4u3<UFU+1hfY&fiad_VsDP49JmcM;$EqG<!C^cs73Nx9CDxTqzRl-!a`!7*ig*il
z+n&LJw@zA3OKhhQ2NBfux~@9G&geAHDxvet`Q&R@es52DKF=P9aB@al==YN1OC`-s
zk5Pz?2Zh$@h2OgU4N7M^$AF`z(Jj%N@9Z#X>OTroto^6LTtHzx?#t62)uiPKJ1&yd
zvAW&%F_8$ran?v|Ab3f3JB{knjqkbt<DFXmO*K@eW2(5wg#B*UrU@Fi1%l{EXJPbK
z|23UAZ{D=flgl5Mt~%^3E8fb&>sr+j-@aOy#n_`$x&Q6TeSwQe$VOg1)h$Moqow4t
zBh~E!XRLn{vG~=jESqEWLxeZwN163a!l&KtBEfssTLID%AFSqwwpvXy#uf&SC(VRO
zuI{US?^W8DoNd_F!O%R;#P6<nW2%VG<hThbE^BgNTq?T}nzd>c!-8oTiMa_H*5;Z_
zmsL|aI}d(&U5@)WGW~q;a<jU&MvlZ5@gFxH{ecYbVO$XR+?}jfxE>Lw30}w>!`7*w
z_>Mmc<r=D|)S0(x7ALA35ca)m4$?WuAsPsF#(L)y{|-TK@nRh(kr!KKI2nr^S_a$~
zkQJ`u8;Dm<*5}7gHTlxzuA*;cDmm@$8Mxm{DSs)KqwlvSBsNg7BsRu*gZ2{!+#7UM
z_)e_<raQes1@jNStt^62?I)Q86op^JCI#JJ*)P8HCQmJRODR@x&1Ui7x=ypz=XZ7t
zNH7ptq9Am5Re#31+l?t@KwZ6xJTgxNQ;K)~2F|pyi_VxU+A>J4+hLTv8R^2WIe)#J
zA&<B?%lKP=fU$qO5Z!l2%qaA@moHpSzZ$vKIM+4X!y9F_HTP)JRf|RAw0)81iYR72
zM!~~f(6Dd(-h@(WbLa=1H2l$2qwhZ(9gOB~<*2XF?F2G4*k~K&Jh5hZ=QD*dfcfwm
zQ;ppRWcI9Iw<aeR!m|dCwjS_~=eG)DY8O|IH<&9YD3k>@;}B*#u&&U2qK&y1nAD?>
zKU(O5B=W0km0afE%yPsPnj9v*a<B)yD$IeXMfwn~Rx4E@B<qqdw*@^rfAF6`(?HH^
zZ`Wh`v~3^`w*8u3t>?3N+Yzgg$wu3&(4V8l`n0iC^6aUVTt^AG_$H-pw)-;2s6w3w
zb*-EjA$qu>&mfLu<cIB=ZR+8^CkFO(uQ{xI`DW9Ymw9jE2r$_SI$C*PO4WFLn1|s<
zZuzmkbGd0d-p9_?{<zTm;i5V#$c8e~PDt<LzW>LXdW*{kWWwS_!}u=w1fOY+bdZSn
z^@@Mr%U^5sM`9F)%ZjH!uEokSyx6zdCC$97VW+v0g;Vc6%=@xx+sAobqnL??EtBQe
zyZFbL(G>!=CLn!5$5^yqI|5xDDy}STcKiAD_Ug;0^4lQt|F6YEjkf4tz8IxXlXa$G
zi#Voj@9T!jb^~iW<Buxyu1pNvFu(!F_)p&kiN>8tzia6>Tyz}}i}EhFcoMPkN=2BG
z*^Qz{=j-W^5i=Z)QJ{UdtBV<v8)Wj3$gGMoEFRK=7ZDpK2QDF8S<iC2(h4z+1(7fR
z>?FBb>B}EvO=X?rB#p{qO1t<!5X(L7)nHV{t;fA`35=6a^{7+Btp{mdVKHFLru*}|
zD`S@sSDtSjv+QeO{P9wy-4`RfYrwznGgr4K1wBDU34}I`zmD7_glOgbjqlw5<HRo^
z@6IXyf_IZJg$#19`2UZ0;R;(UTr}@|o?(W8eBGxS2?3|gs{h4SOdsHX<Ng2lMGYH>
zd6`iHX<om<g$yt)$kSdMGH2t>gaXG7&?o9LDmd*CDkIF~-@11$)_YZJ6zICaIIZqa
zd6U)KN9%WV94hvqZ;6RwK0!z%{h#4fX=Ld4KRNzxwm0r*eRH|L*D^l58W!fC_DntF
zpalg0{Xd#?)!-w{=2$^H+b^gITR)AELXmq7>~IC;@{}8<@nOS&<IVqRG{1zigEQMI
zl6()*V<(eV*38ShwqnB<19@xJcZJ<VG30Y64>C3J4jIs^>*~!QlMs8-n-uUs!i<<J
zU1E8V0J=<c?dN$db<>pdTdMwCRV&F;)-b+xOLr1r6}Rz=IN-QE=>2bsT?k;<csW$S
z0t=Cn9x0iT7e}^5gw+-%J_)N6{ZLkEHfD^jjI7;{lX&<A6TnV;6y681O(qEQ8*F22
zcoG<18&xiTs@p-m0*iknw})HG@D#oAI-b)^i`f>#?9!;<(Knpcz`%R={)95K<dJ^~
zY<*2h9xf|>fvCdhXkTNi^dZ0#7TMV3HFCKe?QC&RL*Vt|tmdx*-@ta$RvO}7gEhcR
ztIAtIlYDzy%22w^NJu4kzf%)&x?k+Gg)5g^Wu99&H&cT4zDm?TZkLx<k5wJEmpRp*
z&<0<@4s*SI;V*V+NDw~cS5;8zFNF8{KVCr<e|`1Y*;Y{Db9S7>?3lG8rP6k{d>|fG
zq@Gt4Uw*tnSCX~>6e}*rB#FaDC&#=nkbr?49jehh1HX;#_ZQQk0-RYc)R1g)KuMUU
zhjN=eu-g3a7KdiGWv>G0HMXl)u0$_Y=f2=QcfV5~Ghh^Mee4~RX_f=3kq@cz22I)X
z%~OodEIWy(oIZAL;KtuUk*KCotrpGw-rze%boC$H=4|`45{Qj{M5m^wJe%)W?CV3x
zbDNnuZx1Z6sU)_%wQ&sCcm^xcwGSuU+~KTBxv|8^@0o=bQ@R=YUaA#kb;%D!@AJ(q
zUL!-*i##N~j0BKl?UOl@bv?9#@2n<^+Vk1YfF70|pKE)IVUJE*Q$#HaZU1N>MfQ9y
zRW5fhwtMI_(34}&*84e(Tbe8KET+#AxHQB)wCmHUlv}}$qnJf$Hr!m?Y3ctx)Aj|A
zg{5asE7ZCT<FLjoHOsaQkfImWSl>|?X$JXQeBN);LI%L`PTDMgIozGp(`#ew>f<r(
z$pdK3XKQ*3<%WCoYiVHG<%m-hSL@pwU&^e!p*Y<ZVne6P+7BPPiMq|)xmaC&u9-qQ
zQWXxDdR6`In1ZiNz@SsHiPR4l33jeyMa~Pun`P3CQCk3_x{Eoc>)tm{gc`j&_q^EV
zXWl6Zi#^F#jOna^q$?;<lu--q3lH@Eyh={A-P+ClfKXD-rlv38i(xcSB>DO}t}rB*
zy=SeUwJEQu_6;)%P+t2JXT|s14bjoQKK>-BVBMU@xR0aQw5Exf)s*3^XloC8xj2{n
zk$u>Hf&IfBRC}bFdbz_ejX~)aYsUH*&^+Zw+fo*BKv6|zz-egDfpqr>gfpCSM)toC
zin%*msavj=zt?sGCDf6LixrwOg%kN~k|06wux>vHJ!Q84S+6wZnnCNI=DAZ3f&{m`
zP7Unh<b@23XcZbLp{-{+N<Yf>x<DdWhA-MHu-<Sq^HElZ(_}xOqF?7~>FBG8hE~qD
z{GZT7(5AJV8K;q$SzL_RfCF`)|8KrI*S^WXuHf};?s}R6Q!d)E=nxh-l*q<8=(L2~
z%duHLI~zFT*19q(sOBtSZ?TpXRY7q5df$UPIx$;;o@9M~-&RI6f{&WKV`AR2Y5#HO
z+3m3eskBy3ao~#m*MQ8{hmEQ0V*IQqF@n`pHpeBNdxqOCx3T``<btYlZr)RRdvlA|
zhvcVy1)_qXvVYW02l+p>yaT_EEF{1<fp_xfwBMMKThTdsV)jXGwFo_hePN0TXzb9z
zeAI$bo%d>~+1OG;!z<v-TSHhyWn`i~=Eydw&kH%g#%uoAIZNFsbZwJSE~DyoM!k%B
zUX03{aUR;hneVQRMJU1%Rkb#HO8V&O933r_!Ugr&9oLHOL3TEtSNB~kzb6x1B&t{h
zmTUI%UlO?jty3n~I)%62b}XD?Y0&EFu6Q%2??StryeVcyk89=Ek(qxqLC3NPJiRYj
zpD0C-xtwG#_v#tnT2OC$wB#V6X(*-#+uo_>H*Ez!aPT=xRi3G);g6kFCZ|C%24(tk
z?`&|SKyg3u{4nndyP}43ab%7KOrf!D(EDD+ii4FjwsqJ`jF07De{qGaKcx!=wt#vX
zDIhXH{b&{e%T;*&TBb`&CtYuH%o;9RGhZ&T-`cN49m`;lg|NkeBo{;!MW;%I^cQRR
zN<R{$*wIZMYeL1<?^oF*nu1vjN^?ss+A`I;V2$q5p_&Iw!q?YRGhg~N%!sdce%s|h
zjs;RJEl}5(SGp>2Zn8#AXSJzlgc6QR`udnjiEWTLMZSJZvYhepQWF>yA9vQ?`n2CS
zB8_w{W_H6`ZDW;BE|?0Xa-zsU5ksr&(hiyYBTM}{QqES&-Om|MNxHKrudAHzpx)b^
zEZa-YS|RgQA>+cnW+Uv8Wn4I#HoNBF_MV2jk9aJ@ZhL7Rgz%#pL+?CCC+I!;MI31t
zo5x7ZF(-(=1I+_AczVUQ4TXdIOmRWym8N14qf)xf@@GjQDDaCtlzof-hLVg6?N=?r
zZ7&LMoQ3kO@!O73Eo`gT^k!)wSG}T4Jj#05VKSma3cdbF#q#xd)egq<Tu#(d$HcPE
zU;B?!f{%RiAlEh4gX7uuHSzq$Sp|-)o-6$V$^|u<ogK!m+d?gmQaIH1;LyKP*jc>H
z9vckP4Cz%=yka-jJx2}}Dw$&<1_H^b-w&AnBlEmn?fVP?7}o5&r;~7{y9uE}g^tKV
zFJHQJxR^yU11HC9fXn6-8&;BM8dm=m-jz_2!22-LU|*bJuk60d0D79Tf`?t|@&ndj
zyFgEzW$4e>J#3FO(VqH5FUim1?m2P@1pKKDLX-26c&g&bs#-iVz(`fhf-7Wn4`2PC
zo*f&nQQ4MrOEGf^I!1TofrKlcjeNs4l&N-2CsjU4QCr~l?bpD61TX}1zS8Vd;k77N
z5O8tU>4-JQIUKg++}ir|<W2ooo#tn}OD&;qq0MDQx!RwdVsVMz=0QVo^LU?zZQ)Ry
zwl*|wq=nUbcGI5~Pkd_vq(C+{&ZAW)Gh2=V_zwex)eFcg{_ejmEnQ)_C#QJ$BMVzt
zzjC%wUmrx6w5fLC8V^pGAu{evx@L=+7B2lCj-|HJmB5@t3bMm-F22GprX*Pk%WJTD
z;f_j$gLQ-lnKbqP!`NE~M43i?!|uB3Dk`gpN(d?<(gIRa>PkpTNQVLg($YDgqS7EO
ztsq^}4I<srF_d(74lumu9^7ZueZKE~`BP!$j_W$t`NcV>DNJB*XE8=HT=61kuM5V-
z9+HX3YH0EeTMX+k5Uhi-UMShztsy79kJgJ;pgMJxefi35>|O4#2B)V^(fSb=ARu8X
zgdmT#<jzz~e%?)Bt1Y|JrkhoEc2_s5rzabNlSO=gH;Z}N`clK8RnYjBzJ>5{eROPi
z%t@X4bN%sB!rUJry~#5Sxvejko?f<Koc7Bj82ys|&&et8m!RAld)FCf&|%!)vsOoA
z<m}8wXTYk{2!SChS)qGcB?$I<sr_a*lxf*lgiBgQ1gsl-J3ved@4f+CrdrW;)<|H}
zKtl|qWiwOHjMHu5zy^?T);#97gC{s-pZ<CocTd*stYCNQ&ZD7WDS>rbjna<{Oo}%(
zU`~|xC6$}{a?DEmeFiNy#b%A~2CK<PB66NCrxZN@c}q5m<^L2UL=01Ho>T;ARs5ZD
zUw+2A8wRDcfUU$d1P(xY4<AZkD=7tL`wNt2yS&EB1a_AaONCkzWyKtK<~@+3bb%U1
zO;>$-!q=6)zh3Pnfz_Oy9U$KZO(dc_oI6Xrw`#n>z%$T(qfsudu{MCA2SgBlRCN=}
z4WGtxXJ51PSFT*buFn=fF0Xy}&I{Y6T5Y2>;zF6*5ucI{`9Nm??P1j7+3i%|-+H&!
z<fx!z>FwblcI>4Gc6h-6S&s*B%)dw3_hWK@al!U-4W*y%u&e78Y>F=Z@r)lh$M2Zu
z9nigtbG<`hCfdCAR<-~YYTHeqG%HO_WwBTE9`CQ8OqVkPk<zoJ;u?P-6cS==N}B@d
zVO%8l?}rbMS%JO|wLT-u^&hoCUcm0#h+q+G<RQI=rsVF<E65e<HO<R-0}Dc*C`13|
zmBr0{y~E4C`w>(7qgST!cFvDiIGNN#&?cjd17$hFH3{Z=Ar;04alK4OJ#zi0R5_``
z9o~88P^ggW*}>Fz&B(^QLwXhf`);SY>iqn^ITz%6v%9%yHUhq)m_@FGq(K9LWDf$t
z4tnn_K1l0Tg;-+#KAimOh(g&XblL6TAR|D3wzSA69VAiA2qOCdrymD@EkS+uTY+Au
z4bs@=SQO~`O4ghKtGBZpT@F&p|NKeO(cP;~=~QC33Ty|`OCK#SZX1jjPXrnsn4cVx
zO~eDJdFw97s2W99RRa4b+vD5ta>)`pc$1Q#MaEqJ&bYq^XOg*Ie_uDhfA<xhGV*l1
zUU%^4iR$!N)Fr<!FcAC=?;AgM1IJcf>hAP(C+u`m=6gV6*p#p(%rZl@iFRjF)H*Hm
z_@F&O9c6t$zt#!-DLRx_jN@6Uu|qfT&)g@q9vul>Vqk|Sqsq7P-L8OlmtM=2FaG4X
zl5ysWyxEhAb9)PRyP2mSd>gCvZL*1Um`%N~uJqvP)Mc%^AMS0hDRF+w8&&cgs%;Dz
znvqp^*TBW$fsv_;Qy7g?qVAZ}ZS0z@C6gD=P2-^OzRbc1Jl6g^M55q_H};6a)-=3d
zi<Lp8j`b}41>XiKzYpaQ%ps}5%4I@j+2190QYos_3YH#cv*a5C>34DrX4j8+k#^oX
z50@%lZ$iVzyR!URnMDa<I-WCoaGO8Td2w_l82gpkcSf}@@1wl16CdIY{ak{HMK}fp
z-eh9y9J}?NrMFv|$td&Loaj8+j1j7pKUmRNPHe!?HNd@qa$ge+QR|YP=THpcvo$k)
zbMh|C82Ln9DlabDRzXFnkwENEjSxFqnWv1f+p{~{Y2;XYc!{otIUxGu3CBZDzoP1;
z6nP5`5@jVVovE*cfZoWtS%=1JK?sH7T4?MFWnCRJi)9z4tu=~mEOs^|w9B(v<e{Xt
zH=KJYO!nC6M&J31D3#R-sRpCEAVyiQUa??#sYu@80c(v^jWYNC67xwNGEPZ3j>rTm
zUu1+0#|>eb^g*Ib8<1ZEHcwYq8j|y2v*IM8{N`)x;SgW<LNbr*HJ_fg`T%ku=gvgc
z{<VhNF{uqH-O{{-l5f6;*EQywm02=;p7Wm_(i*|}S}WR+r_5D}XtsRW>+-y|xA`<f
z9?;v>t8XmkdgQD+K0X)#iJ0Q{Ed>po%0206yiAHDD&hHIMpzsC8c~W55|lWVKpt68
zJ&vyFD9APuE;C&@p*=u$<$(4({Vp~9C$KM5BHuClmzFl*2sl5D_z$~6pxOZp*}Qq`
z`1Ivbpc&wx<Pc3c&lt(B8_Ym5?_gc=>iC{lFN|rf_kk()4QQyqzmn(t^7qN+OKFs0
zfmGX@L$Nsq3b%C3CmOF4cw(9<DX}dA9u!WyS4bLznW4n^$hZ)^`)}Vgcua()f|;7M
zQIPNe0uf5hw_Vj%A|Vf7ZVW*+XF+vu08xN&kCiTX9L|W$nbho2nT(r$%Dh0;)$*mj
z%Wrn`DabtNN9pQaR<qB?hgT<C81vXrCn$I}%+aWq!m+z?#)JL+A0McZOn?1`LU-#O
ztS^R9wtLo&%UQR-U6|nC$_yV6AmBXU*l$1n$1$U8P$e2j(G<kk@ccJ5>-o^qClw~u
zx;CdN`kPd(R>nqPdIc2Y?{DkAV}T?kQvml)lPTZIXb+AjR6Xwv>)qv=ma$w!Z>lz|
z@s_y2fcFg=LzC@9%h~EoB>SBhNTqZepnw{)Bbd~54o}yMW~&oAHL08KphR{#2!y1t
zgnmdbwNo%|sC6e6KsA$x(@06i_R6pVVB+T3i;;-X>ToxU0m(VjgVJ%UBfKw{QCz4m
z&m<Gfk(h{_=yl=C8D*C^eTu7U%InoV6$L#0$P4l;s{x^>01ANvwVT*l<aQ>b_Dl3w
zd3O!Ahs+;89tPhHSGxF80(qZF5+om9UNzO#sZud`grhr<|IF6D_TrA0BJh1YB|2fn
zyWps$av3<FiKm~>bNuXlHB5!Rj=AfzPVC17wuU8040|(uxigIi(phDq?@Ob@nlrXe
zIU(mW>IlK$a;NioAMK5~MXz{TPWHB9TPp3l+bh%&$GlF9J6S7hg3}GAq5GcdN>OSK
zhY6QK)fLIz?xOv?zf<g5kuUSEoTofCYcD-A!Em-;nH5JtltSz^KUU|zipX}OhmV!g
zjIMkQp_2EmH=Q(@DO%+B!yr}y#0-lfJ%Jp*BDQ!Qo)Tl{38q>Q;?~OZN%asS)32q=
zeYASObn~~vh4sVWShy+N9Ih0^ZT{(`)oj-n3G_&2e_NKNK>|ZV1dq$=`zk6uuo8Ll
zu6;$<b40X*TCUU{BWy5vcT|NClV=j0E+yBfybO+s-}1<LFVYHBR~s{_ZZXB!N_>*H
zSpCyx31eEhTC3tfp0X(D7M3OQ%%E<|UL348xvL-+2QF8*O!gXcTN%CpyHo<XWErjP
zXV`^{1@Z3-UT2dbjKJF!rajB87WEjWh1(zT2j8@_DY^~sMvY1(ju5`)e6*^>Lo6|%
zbRReR{P`hFDswmtgg(z?e=c}D2pUJ9#{n4{!NX}k9*7O3<J0$u_ZD3e@sz4^7zJ|7
z%sb<{$sl6=<M0P_C<%-{>%(I2gN99A-Mx+mIk;v%uX265z4eS#>Qp(^dmk=UzU$sL
z6t*5d&g&&yytfI0Rm7@?v|i>!XIvUph^f5MaDfrqY8$%~W7f}K1N=}6%zmCjgX)Y8
zy>$V(C*<cpVC?VEG-7H{XOqD5RGoDn3Pc^ZW1})ZqY6-Y!f2fBj(EsRHr>;XxNRDN
z?T=7$lHS9c8bhbR#7G5HhNXI3rJ`(%5KML^qbFe<L!;5rBdYY?q@7|`YqeCH4fEaV
z_SX;GEvHlE*S5}l6(&!kAQI-q@2e4YUjF~N4=C%dG!pi{8|CL5oQQCIj@f2%-k8a)
zF9bQ`Wh>7alvtHD{3rgE5Pk(kB5-#4jyKeFrYK3ChmN5z!|~iCZSZ)P>lr?yyi$jS
zsn+dk*D%5s@g)&x(N0aZqA`gQjda32P$B|vZj>luTW*gJK5|Sq0L`d&`?^?=c#i&~
zo7I8Jt)s$sC{6S2#J_J85BudU232E55+@%prL^$MN}P89OpW5bt`oCM7va-YFAX-X
zWjF|P2JH41CYt=$QF`>q0ge3JIg#}X^|GG;%4DhV*R4a1xV=&S{dP}jW5N3;O(|~4
zH%IQ3aQg+^)*t?y@2gsnsZp5SXB%to$qs}}N4y`!q;jiikt-cgO-<7TNB(b@8in4-
zWq{gP{ratHFCvtxW7q_XA~&5&J2$vZ7?pYH^9at>7U{N#|Ffx)>wWv>S6(4Y*;Jun
z!i=i4*6>7!J9q>XIM&<5EVY}UO@H_?gU+PKMe7mf&CZ0p&wNfIJS=$#$2=KHogcOT
zDyxUE85{x-%xZ@*CS_yAZQSvajCGNG$tl~@@%&iBv*4VNjX%vA$pK};4&T1eX+2CN
z=5zdG?TkxuP34&uDwAc?Px%*oTE2{T`7Lk0dz`w}t-%J!0EmfCz!a|LxBkgtAU{N&
z0qcjSg$3TpvT?0u)d@-gTu~`kDn0>4?(4tUUn%t|^<WyYZsSGe+_?(YQi!!c(RY<O
z1;e~0fbyG*K09=G*{U&L7D{>c`wJ>I=R&p@%fwKh9wkqrz?;)w;j(#>fNZy#>=am+
zwB_!CVNfein0iL!n!sKM&E?B?s>yC8K%bak^9cuLl{AG#w^L+}Y~8i_<WC+xd_39Q
zG|@s?0PbSjRiRg}EVckVH;2iz6<HU-^%Ig$jfibEf&&hGUS<=XJi$nAaqORWUb*@%
z-(l=h7savf%d^SXp-g!6qV_0jS|#tv(PgMue+iQ>7t_mh7&Q3PPz^$?;7m`0Xh^-0
z5MW+xhBE3*LP0Oh8d0$2_Jcd-#{cJ%b*b!fzrZ2R&B0qKsvQebhuwG##HheKVnLqG
z;oLnA?w<y*9W`(pH!uRgjlfaV#9pnix3{+$Elg1`MD8&4VMjilVjsY}7bTc~A`+-r
zVAiq5SW{R-f83v^n-d&bN5LfQah`FiSSZ_|`+jeLIh5pIH-G`GF;XGY`hs-;dVyTI
zHIy{<RbSAD@;5ZB4y}<DUrxW_(Z{CD6j84mQb`^J4aG>)7hc<84@Nv#Ky{l%qDS1?
zU>=OZ>AHI9=}8+%LWC*NcaA12Fx#)s+(w6$QvMq-LliFm<N|ryqs-E4zBaWBbVa(x
z{vwgY`WYCAl&rmkP`J(tX(?*ChI3oXXt08D+iz@QYobXDOtoaS$36jlEfH~hYHb=-
z{aC!QI)trk4^o};3>Rq$$n#1gSQreKKv|=_eXCnhYfr?pcDeB#i$$etq?rhi#6=Fa
zUZp}CMcQ>!rla>9x4yMcx0m^<O&Nqkwg_ElcR0f@@$<IuPHdfpDvMn6v0A61)j1^K
zE(=^|qO_%2Ko0ojIffBTsPD&pigC`XWY#2;X$ocw{q9Rk=_snqbVil986MVAT!L!k
zDDdT85%uWxQ&>kNMMi#}pF<A72)T5qL99d}|0-g6A$RdR9r{B(AhK*erhyXv3YC&O
zQ{_X>Igb}X4+#k3KOm79=5<5ReE~IkFa<IN*Yb4}531?RDhGE<cEeU&wtS5LKG3Cc
z9tdLn7sxMhY+s1qXItAtl;F4SR)p9`xDze3IL*00gM)9`N2$xL{jUiAq2Qm(GB$Zg
zwi3{=<NaDUksGR9ksQ|CQ5T(DdaSw;>Lw4;7Yn!V-+T6+$V()JyKKotE@ogIAW%-G
zyeS*M+g#98G%l{&-}%{*O8!6-r2YlJyYI#5)(#DU72l29UOHlxM_TP@L!I$7F7-g_
zSAZw=qttKPEg2pel$^G^$A_2tc{ZlrP1{EK`SX<-MID$U@PG1PT{%NJrw06Z#Yiy^
zozh6jyuC?-ykDU`&9x)Q8F{B(W&MlGN{w}=2W27=ZtCgORqoy)`fR+{`?&>PI|mp)
z2xiyqV<0KE0K%=b$7~J;rCzh#loY|^bnsGj7`B^rmLLMwq>nr=Mxxnzap@+W-w>(!
zRlajeC1y^EaxlE_8mQWHQ?RUv!lYYk5L3FDYe=0~WPMNOGJauve3x}W_q>A;ZiV6^
z+usqZ!cc`vMk+_mAnUcZMC^wwG)o=&$sffDB;3>py-Hzz)FtYDim-Jttp>CHZZmhW
zgi+<e%tFN5b9na=tscC?6<uq+dGGznX9?!Gr%-TMyPc-jC3fK8;rvAfb=HN7I|xH$
z6lXQ8attL?r{+H{3?6^*0>8F2=UQ1BW-N~*vQVkkOn6l2&O=$-kY%VZK0t+~A-|wP
zK=T6%Z{)k)nJW3Hm6bYnB&Y*Bz@W164Rj!@nYDUKr+l19CopeNln@UxaFU#Die{BC
z>8*smR27eg;O_ih-1aIxkA+PEV4a<frY_E>+MqUOUS=@-1Uz2<N`X23y?eJik{*4K
zi4}&z?P4wASEW5z5+&8dsNk_LuOGq8=QP=P85l-C#-dbglWmp`%rfGFtgd*Jrdk)Q
zk;ZAg@C?<23}c@xwO&ktS|6?IwIG*l$N^1?TOSGq1irFi$G@si1WpSIF1sDmohpFF
zQm(de8~5RN<z+OR3ir=&<#DRb)>1J9ca5V^533AWAxw^Gn1>E32oNh+^rc#bv1_lE
z&q+h=iaRl7T^MI@KR>V;4j3QrL71vWO|re#o)?hHjn_55GqPF@?Q!VUrHU#~t()4-
z<i$V@AT>0;>w(x&tKrY#BUK)?!_ZyqVUB*t@UW*@4U3lD>?YmA%O>Dp5DU1WPY!X}
zd5xXm0`4*I!?>b_`qj-LkARBH-(6bjnalIcaBsO%LI-A=LS6O0Hhv5q&gq@*Knc^!
zJKPt7#v&W_fjQOh8z<`gWsib={+)F|Af#de<xu~`oo4{2ijQ0G#i0!tQqHY43bJ{D
zkQ9V|ux*O+Bvkf5^`Ic=J8OUxYg<9SECDdfs`ydl1t{)h4QDNd&MSo4TRZlHVo6Pf
z6s|yZ6(28fK;RBAWm2-=G|mHEVYOy+(BO(SxVt?|$Ni{1-~z;Qt#G@Dh9I!?nU57%
z-wTufyv5IC#_A>fjJgqtzXdYSb4TM{Nz;+P!cFB=E~7rq6_CHT)6~@_iw&WGFjr-<
zf=&3|-^WO#P6JEb%4tw-y93<_{V`JfN`rH|erL5Bfc`*(kJ)?)XfmKRFyYE~W_7jE
zu~d;Ysdnp`%?7tEY?O|I<$IcUDjc$%tO2{#=+*Zb;||+q^MiZ?<a4btIVVfEC(N-z
z5S@`@<vAyL=uHLn#|&wMlK72_`1klUl8J}xW(Bu1U}w~40>mPfIsz;di;%Y0?iSRk
ztr^{}>Br@pUNIX*ObS4TLt)&S&lPsf;wQ^7KFTBl$^ulg^q2YuF}djSICSQ0-jL%B
zXVzH5uZ>-)A2Kh4+Scq`9YiBVF$@zyhwWLnW|B{>dHppKi#HvaaFys_X0G#{mUx$p
z$Am~<fk;>#fD+zP?yS$Iq&EWSn(wm4kqGc_Yuj#TK#m1Q%Zr$ONaT=iUj8(bxV?RL
z^9SM%Ihx7xEe-j*-CM1&c{QfLZW!~DGO-)0HrUF7PP8`No&iKE&_OA3)6y!uInie7
z&PS!`{Q`a<%Nq$Aei9d!a+EX7#@kj#!L2h*kI+l9S-MUpyNci`UxC?i%(L_nT82Xj
z*q1MV4>Y+UE~?sP;>Te$GAN`6=;PnZ=u8ea8Ys;00~pEKRatEu<U$XXAyBJkQnu$e
zmmn484HYya$;hFI|B-q3-^H{AO4xV}1)nl~Lz;#L<+*b=WPz)=DWq<f=)K$X>B%V|
zFj(?HKBg(~<u+e}nZ)ZTib~Ypb-n)lpr+|n5&R}UZM0Y&^TFZIBtL{Z2nBmYq(E8Q
zMbp(Q2_5d&I{$wpvK-~s8~ZaIi60sKkFZ8U844uLo@Yiq4g;!~!xf#4$lG5iO0S;>
z(FE}tYlQUVrwq+)B!Hc%b}O8F-(L5_I$LIG+lTo9n_CpNV~*U1#us$zgV2gyjbWT$
z$U&YeCI2@~{8i*c4wj&%aUlm^C8!~X92;Qe$&)8l^A;4$y#^?tj;Wt#8x&2$(@^qp
z6$%+xd%*V&aV8=UoCHn+w@oy1+oP+pR<vIHZo9b<G461IP}8sgWU6L~LBuri3G_4;
z7Ba6h_|5jWeSdS52Ka=SNJx0|!&X@*dAEj3G9SYMG*JuURmK1vLxj`|W#284f3rEA
zqNZQ%H}WGe(Te2utpzV@@FbD*=EF=AtvIRuxVz3ttXH8fU3tVoBc%TA6_Ge7Z`_88
zP%p9zE0Dy)P?B$|4YU}Dep`)fo!TG4&r;*FzfjCR3G<N~t&&+g;u|ljH2YD@j@QRJ
z0m(o<19hSPj4DA;7sq{bGO(+q7Av}E>fuR#9*kT^!)_(=K)p!8j!7B16%1++@t!bD
zbxae7G)3~wPDbTXvP8!lazki@YOz3HIKemsNFEJkI)f^OcbXzA6B3wT?h(mR4Bwd<
z+PDVRiUP&28l(s%(qk=AnB7TcQuZX<xt`zm7GNUV4S>|E^+=5B=Wc4+NLN*YmJ1{#
z4s#i2C!15h=1q%;gP9~vW}L-*5gt`I*RmKo16EAFi~w^@s*hNpzgekCwI>Op)3eai
zs6YX%c@pGo)^n~<t7z>>DX{w~HjGggb~GVEpVck2MN$#emzwI#N8z)JL;afScYZpF
z5YLu&OKZ$3pq^q!bO|d3QI_dIp$3iQt{HCE7b=@O7N1rd`}F0Tj(mKeArXaZf-=qe
zl!keYl0wO&)EAi3+Bk23p)Ulcdl#uj!L0B3SEz<+(mbe3iQu*U44W`rO;)PX6Ye9k
zZ5(F87MS+|2y@z*C+MvWq&Emu(rN%itm9p))EK^<x=kF&l!ric61hQ^2d)bE9DW5H
zu^!1Kj7}<?+4Jf6!{#$1lIKFw3Q`zedw)KbGl`*Haj^t%n6YYp$`8NwgYi`edc6>|
zU_b6Y;X6~HjL)#2V_^CI-~@eZNbXH7W%af!X;x)JIv#oFpMU6+g6vPfhQV)7R%k4{
z22N=;tI16MufJ0j=u89t7(ao;8t7s^+2*2l*m2u>{JbU7u=zPc-TauQA3a^ub~|Eh
zak}t)NoV5PH^>g5L4mM#GO_)15<X481CQbdd+76znEi@d+gi7?hS^wjnG(#WD<I*h
zr~33kLI9sk|K}^B>0S2SYNb_h?<hPJlbT}*y?es4PH+YY53kLn9>5%hUmnH%hS@SI
zrw84)W@9BklGW&@1_(b^Pt?ILrsp<rg#BPYy-X{~G<d^F2++%A?2!44YGKC8HsRRa
zErZ(o_zSwji+sA4dOpoRe&9%Meywfj?bFd}G1}+W{(&Uv%@GBumMS`ULT?q3C)Aog
zOmxpx3g7O-<}s3b6S%QU*dKI18TqkY4-$j!M01n-65jH?aCV<TF<ugZn68wt6RaBv
zHnA7N&fF8B!`n1$<~rJ%R_HXF(O#FpEqV-o@3Q01FXVYmSI!h;`c<nnl7o}^86GqK
z>kVEKZ!8eQoAKle?8Yc9Pa|(t<(Ci9-8fC?AN*GXnFZcQf9M)8MR=+7yCHh15ddFz
z8Ht(0#EFAvbnoXk03Z5Kdy;>@8u_>XC;zg1xT`99uY()E<PPxyi2HE?{h`)pevNn5
zpKV1zA`9__Tvqz|jeh2<k=Q{TpeEyQy5M7w?_EMr5m?V3Buyd$tp9G(BY|02yQ@?#
zO(Cl#{XK>37H~jde;?t*OB5w)hiPgl>%o{_X8J7?|D+F5!2b+OCUv{}@MG^}XuhV-
z(yg%+v}=w~kp>Y$>0x4942ZpQ$s76o2JLYVu;)yPMmbl&PO?VJTm>b8P|b6a<Yf>8
z31c2at;PV_e5ZXTEb9m*{u{jrFq<x@B$j_bIC9a$v<Qg4mLcEoXf~Liz=94!Gwugs
zurL4chl;n+AsZ;eUstO05pdLDxB+$f{Il1)8t6vIM>$!cxEdP}thvkyEiOI+bB)L*
z=Gtph`TIt%T%1ywuOC#Qj%byg*|Fc|98VvckaRwHR8aJ&UyL`HP;|Q+csJT;Hmcl3
zN1A#gy@Yxs8kJdO<A%*A<);Xe6qpSdz{UX*>8n_=8YpfQjS{^HS+H9Ek{a-RF;d%T
zhb(zduL0FU3%8v`W;5svGPw+ui;$+zf;@*+6H&&8{N-K>Rw3MdA^xw|Hdfg2i}H})
zuoW$`Q;1vitB$KU*7q+KyytHj!)BUpOEb=TnP_}-k+(foe1nRWDGRGMBIZrr3vMa9
zt#6tuEe_yAsh=xFXC40ichNvPV=;%+cL8!KTds4y$}A|&Sb1_zrpodCd-5q;5AZ^&
z;|0GiBxXMso8(wL-Jr;L>r;IheIDK*c<Ak|UqJXVLj5XsVIA$lPTDTq^gO@E4mx9v
zfXb|Bp=I7vrxj~|-b*>dWJq$Qr5N09^>c7W2QLHm>jo9_A~Ab`LV8}LLuT=Ei6`Wj
zd%*S9qu~WLfp)Msz#~RkU}veek5fZ3tOb=aN3e0ygc?{agkLvU0ddkkMJ3O#KPW|=
zZ&3BwNaYtMwNO6LhpHXn@MA6AE9~{~y&oa?QpF$MhyLg1Y3v3;Y#fT<Tt?stbc2~>
zKTc6rrMwIZEjVBh$Kc#-pu$Yerlsd`ia_W@0mNjkk;dEFR#GanbU>2O)TJvAly6_K
z1J;kmNcr9ZxBsC-7Qo0rF)5uBWnS@q#K9hUp!17ged)b?%B{lGR@%_l(dLn)L+U#8
zKDH`lF%1`UMsR!Pzr)Yr!-SN$MFP_KjRb(O=V({<=LU}1$c|%bmMuOBpZQBWfq~?U
zh84+6!<6TSfBEtW-X~8;xI;kq_nkW=GI#HsQHh)5`=eKm<M*qzG8@LzjXQ&DJz6%B
zp^<MsuI>~pc+lG}Og3iIunYK)VM=z6HB@Ab$V%~D@u!!&(V6t9M8C6MPr+@v-K8h3
z_oBQWRYQ<Ol43@7e=Pu*fd02=F0|ci4&9xNUho;frj79g2bYT2m-9^I@s@-X;rm;o
zK6P=k9f=HK%^|CIf9JGYyEAHa$wV+pZ{<c~%6v~o6*$}OD66YSX66=JCiCtXvJ}`)
zw;e@$hwO0@(bwmmxX{epuDuB@SXE-G%>f&|Eix$^XysxnFOi`DvM3L_r3(p_?wY;j
zfT7rD3m|{8MU5-3PqkhxzZ55<bq2`4#}>nT>0@=KkES<TH>o<*?Wp55jjEc31$LTA
ziDEX8U~<im+IvUc+uUS0p7MF$q2Uv5Uc`iI%Bkp$#QB|bMq<^g-p17C+Ht0)T6!7L
z{Rz^e+}jeA>@$odIjDw{B-=|B#`c@Ir?y=3;kTxp2`+TaSnuua)W50^Z0JejE>(n?
z>(CrI)3d*{BvrNGEGw6xA|(bj@A#*_&DH|&A2xP&Oe!1?$e<01Wh5^@+$WdyLYXsr
z8S$#H?{J^?kZ6#D@==cq%noxsn&{oWoTf8p?AN$;HU!EQrR5b1EzX3nJ-*{oTU*jM
z+#2I?;#@7gGdM+u$e5bu0@uF@)6wZ`Wa;FLFNB$tMoVo?gk50;wZH&fnOp5;uTZ#H
zyc(Jz7&~(nklGzn%boJa=`-bn>}iYq(Hm_UY(wdO0vEfstrW<RXLYvaYz>;Zrhs#)
zo$!v)p=YlvtKDDh#MvL&dbAyv%<`~fcH6|ho;*ZPwO`RLh0Av3@wNoBLfWgrncl2e
zPjG8|y+}_ND`5lrz2UJ@4=^P+JK=Uo(M$ePcJ+_rB_#}lbI9nMBX$Z-ay(u7T0na9
zy>rzB+On(CP>}W*@;G!_D6UXZP*7M2kUygL--&vhl8`!CN3)6%a+YD!Jz8r62hiFX
zHhUC$%Xg+bJ)+-nd;CIl^u{#N(bID`oN+j`SA%F%7^i3<bE#rQPqd6BewonUW^fp1
zGa3t7{z}u{p^nY{AaBCW=+vy3#DQNUk^fyI!p3`T^q<oQ8waazNv9tj;@cvZ`+nm#
z<MnYTNs7mV(fhc|1!Sa!?KL#^fpjg(qbnT8GDcn;E@!=>kVc;Cyj<lj7UZDEW3)E)
zqVL@V^lf~8=)wKFa;!ZcDm-$Xt+cA3Oh#FADB2pkcA_LZ@1oT_Hj_w2y1rccT7GV~
zy1`YdzG?S#@dc-s8JdXM<6gRYYJjQjAB-8$Ph&HT9hN}ngm0U7ve`Im{pMZ$+3gXJ
zJa_^iUbZ&MC&(#O0uO%!cTzR;gZ$z<SCJfF?}6JZ@w+*nYU3R{N^a)hbE)O*ZW~7U
z%{fuSl&2E|?wxVg)*}P%GJWwHrTdNw1$(1DRO1^TA5bcex)F1l;5M2#H4>#q3jipe
zXV}W8j=a-+k-pDc#ET?G$fC<evkK}krWCGKH87VASIVbIUV1%{qqhTnh|N)ZxhS)J
zB2Qw2?z9_3{CnAD8G(!{=k-#R*aV9Vbkb8yYq%cYIVL65QfzCkR-7*xa#@&;2o`d8
zeoDv6xc^6$3{5>P57AD+6v%+iu3=P0$J1Y<O&mVp-y@fxQ)|z!3m95cvTP;<Njl_3
zvoEwWz?!7IRMOItt^?34O|@5>z0!SiaZ$fFGt%=Mqw>_Kk9~6}yF;ZbC&TsMxkp_)
z)$i+i(a3j{?jb#^mo^uZI|v0Ff_hT9(C4hW<K|VM*Kry8tCi$SWVI@mVD}jaoe1L8
z`T2Wea~!tIh6bJ<+}E?m!pzK41!pdD$%QOoXN^#*%|50|Fdl%VEma{s>7Pw{$Xn3m
zHM3*Ni`|@OtDhg>-_U2;Ag%>_?&gvgQI3c74?m~B#vva-Cy<k@@LXdcq{K5M8fL)e
zDL-Z&eQDLeAzy55;u55{w^X6a3VrPPj8xr-T~1C@TLYlB+{ZB)RhHMd6yB7FZY{ni
z9hb_TIc0C(@K-U#-k3|1z~l*eC1E6G>&I|37wL1KN-JD1-c;8`@!qnCkDqi_eYk&J
z5Vl_qceP$Szb_etcY+JvSrJR)!Oq&dur64b=wW~ar6}}r=BPd&nB<`dMZH{BIvXdp
zWuKteDfE#Jg3q%UO#3&@!tD<W>>cVjdPw2fRmk<M9#nsm$kuM%;PWt3X*kE`^OVlq
zlc0|gqu5HiS%U5h8$8d5<?NKztb(RhwF5Z@@iSr}C&xUg<n7NyurtYr3+xkM?lP{?
zsTV)f9#hAd#)=zPO~-sH;xHOwMb+DU`=X2q`M&;gOzxy8Wfil6Gs%LaC5TbXX3N;9
zvQb@$lE3;}#ZKLPV+fmZ|JIPp)I$Gu2{q1U1@6svVXl|TlacPxg$#h}&kX-=QeTPx
zGQAj-3>`8L9cs?3G#zR%T{yM7cK9LLA=Pp>MQQyF97%|#zhG2Lm_le@Y<UX*N_u}6
zYZdp7F6jlg^Z-TErcm0xbO$&Y>~6<ay2pwV`xa@{l*TZ}RvE%s;p#mYPe^(g)?sPN
zS$b$jqjnTr+*&*~i-X?4H!GdBtB9&QSc+Dg3md;5S*d?q@uu_M-_|pu($YI?)_;fg
z@Bg7y<%Cm;f{jK<NQe=?byc&4fEmOdN5N=*WO2UH3Sh4t02=J|tHySru~)T`J6qbp
zsZ(Opj}m3{_Eyajv*nOL^7(~|i&WjvaSw+XVV6M#WWvy)aFp9<Y4B)2+1B*2_Z)}v
zUz%q`v%?z<ES+8;9@bSUeZkjMCM8WzE$`{xr;wpJ4MD?kO_~t>(2e-mshO+RY}!kX
zd+WKBPW@S+K0wVy*GO`UfYWMvnY>=R=ZkRDN`2<&tZMX(PFG3@>UEaRDFI9U0uGp#
zo`_j(QFzC-jMnoa+cZv=UoW&mb7y>C$NHny)1dVFnR44xI(+RMDl_q+VAOuiW9^vU
z!jiS$_X@k74Avvn#6bG8t_fg6zO=W?Hv5pjP8pj`KW4DF=&;eNnP+SyHm6QobCHOs
zEn`%S^(xKSSY2%2`;97pv0%w;wStc2Q88X#UYP9=?J2AG-W6f44_`6y4lE-Y)5t*p
z?eH1Jk^IGRuFa#4*xwRP9ZDOvNJ;4YCYG%8>W`y_6!iP`Mx(F(5OX7*4?0W#=FNg(
zd)x~v)Y8(@)6S&9-mK(!$vs6f+sy&VzFS(Cb;&cTiCP7P7NFE2G520Wg+`{$)Yo08
zQMrQYEb`$C0?qd~w*mKd;V0Hc%JY5eXpr-B*q@39Gey&wD^ut1E2lgSHdKhpwV1v?
ze=0Z>R{6$U?+SLEv7RZUmwuE*=>FXDYBH@e^hzzXF^%x-FU(<d!tqv1sn55@2tve^
z4Bt{BiEq1u9IMZ_?z;?X1SG%Mjd(Wul@=eWhR;l;j}-oR!%MCinyg)vP7IiA+NH&^
z?pZ2fAEv%ibS|zn(MR2BFGrNabokCQadFqSLPs>58I1u8)9v)01fk5<<garvJXVbv
zWGi~(eS1TY#$sBya#VCS>P?Rv^YNX0`T6q)Z0$tTke!{K_r>KmrmTTS-I0h>Ik}cH
zz9ReuOUl=YG_rp#{CCQqpM5*X=w+rq9VJ{qtpCo(CL87(f;st@??-YNk@h$eQwIhe
z{IxDbD)?)7BoLkc`Rg;9f^?RFWllo{<^sWFMb`UYb7mVLS@Sec$d*R-$7OzN$#6a{
z8&M0z{66@zLrYI#MR46q5s58y_v|<D+QSLL;U$I~ULsM(lzeFP=9vSq@An6U6k%6l
zT6fV9{C~S>UcK5aH+61KZFD3vRi6;~xPBkSGta3i-OmZeHX`}l$G?vWgfq0D>7(?B
zESbgUk@fa`2j0xHSBk#T2?0uQQP0;V>bv&J)jOR_3{)|;iuhl;<98V_{ht|E1*K`T
zkVQK!IyP_L;E@|ZQ(EzNd@>*MZ6b8==j2!9Ki;52orkNttkyeV^on;jHMy^elsFZi
zTwhN73;%5_eBCKZ72wmP=iFG>YaJ>}H~n3ZPn2)HgJ@-~#0X<u9TbAUV#>)2CPDGV
zN0c=3&3BpcE9TGxSLC*)ugN3YiK<W#bCkAWEGCq7oQj#bWges3Fb}AEvewsV__KGl
zo@8*!!y>yD$RRW6Ew@)-W=t{a3z5_qi`AtLsyC0ObF+oVCZlLBsu(8;JAB07T;-lq
z8e<(sF>*yxQvLnGh3icxhW`W$d@j;clxFJ-i9G&1kpV%PLsBFNURtu}HHnm`{l@O8
zO<`s0D=XwIBd5^XxLxM4b4QMzW|y=|TT=v?M!7nzqtb2BfXI(uUR=;8fB-r7o(D_^
zUpHx39SFKGgcV4Bbnxuk+SIdh;IVybm{v61>7|AUS@Qd?p_q_%KNojh5`30ffnu>u
zG3&yDB1`FfTw|e=69mrJ^+Ajj#5pZi#eyD%+-BNEusu!B(1`jFmz0z+X$(FMe^_8f
zVsuYas|p@h6o1J*?=L-~pJckJ#`};*fBDF5b|YWjUdHD38*?L%zCU_N`=+jYurrt@
zHIXw(hqSeW{&UOZ>O^3imEO%{pWU6F+ViY_w)bVHNiRGIO_CW`@+kRQJCLF2fRPAc
z*K0d=-abmA(0b8_b+F9Ie)OuO9PkmvB_)8bX=ei%=>{rXF4WpoxyLfP`4Cga{(CvG
z1?DULUkokB>K6KUPaQ09zlyRDa#(6b;jYAaQEJgBcT3%k6FoOavLvGPsPksg-6~?|
ziPj^lpd2?(|4~Z~O_7U>FvK_~tlnBC%73OSmG$Yv3#f_3GG=2;?vv(l!ZzQt)REyg
zpFD*4(skl^2#v?n@&^TG)ML3Fq3p8RX)N-FL#4jrZzVL!N>QJmpFTps&qM?lUtl#a
zhl;UYG^XUuxA(nz1objLUU#}pP{_+pZ1MKsLZM|l*pQUs#HG1!8AYLbr>0y6sh&DY
zePmKs-E8JbhqP8z<%78K*Uy_9^G3Pm<l)q*fb?#IrSQWC9<SNpm<BMsW!}@OyN!y9
zm!i}(oQ|z>hek>P12F9)ylrpTIgJ$uSrr3ejl0`zt?Dz!CciFIq1a6a8w~}M?_Uyp
zX^>SoWy(oH4@`ccMwu0aY`;1Xi4)a|M#8zH=#ty$%1dBuFL>)rdOj(SR<mo<R}<6W
zqYEa5g=IF`GFZ1zEn=^e0@?1@h{VV@OUNe&KT8Q5%K7axF}#ChhxWf4&aK~R&7G;a
z?$P<XJ;{Y^l`xJY`XL(d(2Fb$a3db<tlCRVfB`*k>B|jRO>E3(!66hxD_fmwM25hb
z^A!$TPdH0dK8oC(u76zWP%xg`@#Xa>^5i>y_t{=8yP;nEssDy5mlHI08hexS4VZ&m
z40<|t615wm8|gOyrBHgXel+Y;-R9M~d(sRAIp!x7WP^-aqto*8g2l;rHZEb-!-o9T
zib}hc;Q_!*t`{jFY`FJk>6TdNInU#`xWr_R5jF?=Ld#A}no>GHTG@a{%dl5|A2*Nc
z1IwZpV@bB+a(_W*WF$;}pa4cGB@a*~F<n5qV#YlvrOM$Yrw<j-%6$?TVm`IyE4ox1
z((lgSJ|_K6DNKyQI=Mj6baR2yY;q%`veZ|Oqa#g?%7}J5M8OY|<yc;s?ldE&M@g=`
zHycA%6HVKz@v+c$@`91FN}~B#YLWh7!X0$uW?Am`(gcp^AV*GC`Z;lU+oQPrHMX-)
zH>$5xsx?=ecX3LdRal4gg2GI5ga)`a>C1+r9NJdPB*;TGGRNA3T(qjbevOdgTYr_8
z*PUM0+$NN!KA`$(codR$r`-(ksPjX@s?`_hq3L?EVebf7P5gabUHM>qR1R-=Pz2X<
z7B$D~LckLI7fA{fl$;ze5j>l#K+Mcq*Z4TKoZa!hh2g%wdEe^&vv0e7Be@z*H~iQ0
z%0sxtG@SSp<yQdXth4uYy*f@f$d8~pt%h8yg<Z$4ly3;3f?w}Q8G2Htq|<(>odJ>v
zyKZD8=VnB2v*~ye6Y;uq*-+53O)^TWusEGNp4Rlpr>OHj5CXyzfBaFLMyQ_uDOWM$
z*rF;ZZ)o&aBzbrIxG*$?)C4qC2pspuV~;-#EE+T8LmQ(0*iXS6oLc#z|AqU9HzhVt
zEG4f<C}_P;P-rrtERK-IKie>qH?=0#5CH<;8)Mgwjpk;Ic#_~)+p_hHFnWunm<LB|
zJV_FKdQN$zEY~3Udx0a`gCAjm#OBDd*3R&4o*=-)rnKjdVA5o+Tv^pthFm|_8J-)D
z0<1R3g;>*+=-G6q0bpeChLiPnNeOrb8AB59nOYe{L9cJW-pD33&B)C}Na!OQA4H}l
z7)u_`qLuP)m^-_ARV0Ml<X`$kbv<82qSC$34tfr!IH=DS+s0@YKm6c;B|CpW75E*|
zu#L^=UucUBF;#ZJqv*=lu`1(>F9NACxTww~{OS0=J)ocY5bV&pFE?v@e!h%y+t+jr
z9#sED`ciCClxOjtRZV-m!qoWUkit<OYvUxTEHYB1Q6FN3)KEi&2sx(l2f}_}MHG9|
z5Co$s5Mwz|s8_GQ?ru^fdWq{VhIX^@`X@Y3&7`u;A0eDyL@sKA!E$cPuWIQ<xE+*t
zJSYsL3*^W>t74a8vpUh$7(xkkoy`$L4Fj0Gyt)eMA}hgU34H@qRr+IK<fXrEb2@dI
zS4O8<B|0}cz&S?bnNgZuf9iEjK_kBEp&Bwy$JSE5<yzm@eXb!TnSH!6i)H)6$+uwO
zA?cZn8ZO3CWVap~xls0EW%Khg^JF3(?HND*8Ti1#E6BDepF+_yFjhniCH%}~160DN
zA69#1jI6c@Y;D~y3T59}lu)+%o62A}BiiT|HM@={>5NESIIk^*119{2LfZX@UoWD@
zySDPkE|o0CM+xN_VLoZs#pgV2IxAHiFdX?*_dU!RsK0L5(5TcF9rMwXICku$;t0Qr
z<wWD5f=d^<I`o<4EfzdUgi|(}Kd?s%*EiaVb;yVFoG3Cd?;JH|KSQriDTCdfG$B>#
z%e4DbAJ0tmB+3$PZ$b%Yk?H7#QSxK>Rk09xn{rMGeYfkvRpWkXJk;yI<D}R6zp*PV
z2|?G(RG`DkB*TWL=ay!b@jxgPAE?q|IM4LKzVJCuudG#;XuLGMP+-1K##C>7gJ{ke
zITw{BWfNtl-H3*UK0PVixZ>|~mU(?)pwB84-j)m!oST=v?Rk2L9XaCVYwUbf$BBYG
zz$oR0ZuQw6;y`GQG24~u2bp{rXP)w@jOcdVMlQ`9>+f$nZ2JHgPbAe0=wFrZaHJIW
zvTNw64_PhG1S?nU0DG1~SH9NT=3*FayR%{ER@g#5k}iIJao2y$=fwaY|06sp+F$Ws
zQdEXG-f9)X1y5Emi)?_O>9jn-97^@8VqaK~=eNpiy(q<z?Z4zkMGYH_pK7DW6s42x
zH?2;RbqVj>s*M$+>C1)NkFZwvzuRlR7dAuga8c)_eKgue59SLR#?!)bN3VCfoVTa6
zNbH2HQY_DDf1_Gn6R4e&ghQ#XGyQ1@H`dlVd;m5^@Iz{lTw?yzYton1d@v<0Z)8on
zM=dNF4kb6m42iI#R^4C&O7HVQi`4SsDGnoV7A_ml;NW=b1+}E>_(au$3F}xn!s`Y1
zJ!|iih|m8Qp8UMPUlL`EY-EYCo-&E1_Q+jS3cx7Gy@SLsL<?>lt|+%MP89N`?qgB_
z5yhwswW^e|-ZY4O`?9?_G=x(1QHO&iP_MjvW-_4gntVqRq_IIgoR51?_YD|_unMA{
z?O{#Ue1+YDv)P8{=PhSC%n-I_f&s?ONwLPOmn2mOb<C#c1uj5*L^eO16LL}fsi-Cd
z<~u2*?JASWX$r=-yaUEykz9Gy_G4o>XY%w<ivSYAw^f6}!)c1kfw}vzfN~DF<cm4`
z3ZEMq%v-OruluAUt3YJ3xl#R!)A5wm`7}JYnD6z=p&?o6E@QsY(&6_jxg!Xva)t`@
z&H<A-?+Sr>vi$4u1{$M&E_Cf%b;#V?2W2K8fr%oaC@s40M#Gq)F?pVNeKG8FcBYq%
zy4|#G$SQ6}E$|fgB_y@Oj#OD<2d1U~$_M&$4>_<^THP(ez%;)6s_V}^U3=JUo>_|-
zUZl!f*Ml?VbQa_*tW&cp3m_z5w+4zZCPRa9101$N+I)~2Wsu#i<A<g>{2w~*!U4Y;
zC-K6Yike!!KNIzaS{{5x>uA}ZpP_gp=XYwb>9vpj%Z!orSrrO<hWN&ez2945QOhOC
zDIXQUCb)cOlF0dsqxze|xnp*hrp(FDAw=19KURNWocTq2)_0=JSnHRS^$%xM_CK7F
zM5&Z?x)G)n2GhFW!kEDJA6Jr*2umiHjgb7$=3wSLPnb)&=1f@Vh}GM_>s$zS*l&Rf
zq_gJP%&5k<<vXc)>U-GP@)~c(uIdPH;$VhtnXV1UR^ObS--E0gv;#UK=&)=t+vU{z
zzyY(qxk&E}nIEG{*DPomh8ge}LHG(Ne{q<HLIAhu##%tr)$^AmkAm&Wmc>H<+I$`l
zhl#rIX`{*J#dU6-=C-ZnMI{Pv@9e%Z0g>vRHE99=F2%kJx1i>6pr;Kss+Q(G2XsT-
zH%w`(?DuVJz&rVM0aAMF!GDO#<XH-9MtKG}2_O;#gmRh$Z~*9VGcy}|;eSdZbnOLi
zrSfAXkjtJtAsqh-G>DDo;iDFBeSy21j*6eb6Hp>8#&bJrxRZ+EMNbeS0wG+7IesCK
zxh~P`TW+-_kz9H4TUbqfnHh$wTpZeaJ(=sVE`+>(&_1F&B}CI}2PZ%xt%F<dP6DL@
zT1X3)u?En}TC9wfV_&^{_m|RxHzx;`t$Q<_%<qT5?AG#AWO1`>$l*tY<ak9mgd{Hi
z?eOg>Di=cL1dXz!jn;^u9-n811BJK(^JJso%<8NG(6+#JJcz+GoZa~rm0mWu0fdwQ
zj!TBDm5tlqKDrZFwos1L)YQAs52rvfqTUI&{k7;Q5w93PsVK+7JJ4=+jd{O4Nv%jI
zGhlhjlilK}NpDGO%rR0GI{;$Eu*<wgb1kR7Iw(mYj98Im6w9b9d!+f(O<zDst2$=%
zl9Y%@G45BRMsY@|V8CyFrrmMRGAKoLhgHy*S!2ORV1ZVE?K?|WzrENR^ZKNGvi!oz
zxL37hAHt6un(mE^jH-+JZD%O#<3Y&q$IV3lN-`8CV%H65%GRMyh%GlIgYvTtXg{<V
z6YcC&ASVMC0_np%87JwkU$0y~pOaZMpputc_da{g7l<m{da(bQ6nTg&of|bhZ4Jvx
z%2_(@K+C^l*&lxijAVd0ys7=zhjot@xU@uj(I2zT90nVMdAvtjDXmv6_ps-cV7LRl
z7h`PWT%b7~36iDF-#%-%;CK6k%T<#>rMK&^AGgd{?{lReB!Wb6W5P0zQxNieo?tM5
z(@Z)o)pT@lePg2!*f@hZ?iSdgAwB}J3D@W~1)(XzUykb&Z7(Ix3v>-{w6^OLF7vQ_
zquC~VEH?Vv0j>!{2&!wnT2&z6TTU&FSPvaB>}A!$<SxdEZ%<9f6V#?V%yzAN`O|iH
zbtF<641I!L|NVplb8!yW=>(}w5azM%xlz-Q|750@rFvd<WddL2B6d)VM}2#2#9af=
z_Z{M-0)|T@v(g>lDt2eHa|W<vn^O}zV4pzx;O(u^NGy3hnjO;gJq>r!`o7|AmC>s5
zTqN`-4kYS%jJX*uYn|HqOAf)tiLY_@N`88gb!X|3Pj$-q?W2_0rJL&HhR8YkHfez0
zN(XYLF}Jz@AvI*^_QrXBLe_o|aFOp*3BKVjs!&w~->Ii4Zc`b0B4SL*(0cRC0UIK7
z6CSAdHL(;C>2raPk=vF@-&>Rni2oGWlI>PV7KeXDmyaNK`U97j*dbtGeZ*cqD(b_;
zI-l?Xy8mc+K<3?20_!3_+OBGEr^u7Bh?qD>YQH-tu!qmoh<dRr(c%$88Ft**t@nyO
z5?Z_3o#C7H{R3=}4|uSl*jn&z2Dte;nazdyo4NgR2)<Nx%{AI-?qThE$8vbGiHw@l
zY7zGVD2cRF7l?9bn9|1vZU?3z%<5ZGBlI?(?Mk2Arlo<nCq6bkKPM$M{*xLcg8vpe
zFm`5kv<OHc-!ieuc6oSRJcRYlt44n?Q)lr*@oaiY*EQHDT<ry{Wi$&3|9;ENE(_`f
zuQ{V*%H65$hVM`FFkhhgkMhj7Gg?&@!SYRi9zWT`D~}7rR3AScWX|%)-HR9%45WT3
z&h8UGG#Zm50UhSOX{I^KOsZe5uE>&3jTm;tWy|AyJ1s96a>heu`(Ju}|B~asd`bC#
zIlkWUKvu0P*z1gnOQsq_X7%<&JeK-?+~(B+`>MvOm2RwAGz-Z;+)Q|6!CYQmb#e@{
z6yMrS{X$$eSGhwP(s(O6QQ>)1%VZP1#C+RhdCG0h?ths((`c}3p=Y}|M)TR1GobN$
z3Lyd8`nngV@h%KX5*p19;WFw-$kT3)790&+rV>7HXJZ3LV}HIYQS96UFftf)bC5w|
ziaW^_IX%qVUsg7|yUkv0iYc_ST&?n$^&GWo*cGRfz{f%SWmc}qHUEeej?idU&Fcnh
zlMYsbs=m;u{u`N)L+&(N>R7Jl)4J&GO$Mk-FBS293Fk(F5A^OSu-}{j0;kh)6YY@c
z1d0)g)<0w9!{4haIZ46n20BKMT6kAGV8KyQZIbFz@Z{#p#$V55G>QYVV;`q5QthR&
zcD$Nv{_~4rKk6tZ$d@)aD&fcqq2f6Yur43BGA^dm9L`d{Ycln9(2PUK$7;<j5gR$z
zw_Xy?XXJu<Hq+tb<=+(bn?IY^<X!z5Z*Jz|hjkSde=8T5jlZoCQ(6Lq#%Un0qTE*x
z1$Y|^MG*l+vHRD;dGZR;J3=I^HVuuS$2Es>)?1MVI^u-|<k5&|_KD@6hplbJeTH5h
z7v~a0JM$visB<SR&m#HA1}oFkJWrOu^MTvgAhO%po5v_E5Hf6MO)r%JbzNSy3`fRz
z&7eR34G0l=Lko&9M5bT|5}Sap1^}ZW$Mfw1Hhg-ZXq_f%%@C9O&0lJw3|KIJ;ocS?
zhA%LM4?&{aoB5!xHj>XAb<g?eMvFE;EiLBCC=!)wJ!oaenY-4u0X0W=A+xRrmNGmo
zT981myN<ck24fYs&Gy(aZh09@FJ^J#B$W0Hlb>H)8t*^|&+D~%azTE?FvvtselX93
ztk*n*D$mOxlF$A=Zr2vNGeM0`FDuHu-Zgye?OWSiwnPgV2rGv^5?u%~9@x4!<kU4M
zhX-AL;TtkpuR#}3`;T46Q~$eNhnA%i3^8NI(E4SrbW$oEWKK9N!D6Q}As({g%MZQv
znV}8F+wwD1gI|xC4EBf8`1qXcN_upqv_&-s@>JG&D2VkfLfERPn@_%6CYc^8D*;J9
zy%hVfa1WcqmTNd$=@!Llbb{BizBTWrzP%rxeHWZWAhlW<%#l$KIh7@!gheF1|A)e=
z?&n=`^elFix`7|Jr3EpA%i?J%$JHXa?59_Nx&a=1N-R~4hyAu)lq2{(u4MXUqCCjD
z8GH<(tEN<x`V%j{G~g#2hTq>+Gt`xt#%mWMG#s1`vXRSD;#&`l@T<q{mrM?<04Mu7
z2VhgxbE<j0h*oDWMK4(i;jJp7;_Da_fw}=OQ}j9>O3XOxNerbehAe+5$Yi?a;t~>^
zWYYkA=T$n+Oe1;0Y^&H%3uI%^Kk+RL{K3>&-79mPXL$3MB>3ULrU3a{Mqp3d#(i5Y
zO%Ti($s_pDt{j@UlkcMR*m>3aGE-H$^VF6q2#e~5<D)hd<P(B7ZZw?6oYpr;Q!NmG
zIwgtz3fj;~D<E@BspUeMVHX@~bH>y(|6wbq@~%V@p+XU<>yBU6&szGGjEs@mR1Lc$
zTb*IOn0MD_9_<(L<JnKnptG`q_vdJVMfME1u{;LmjPn$wn0!~D3VVQt4Y>)_BWf4O
zhCYQu6kLC$c)_UCI}2Tjvc36dF>RY!5NCpVE;nt=TgyO4&l{tlzH6z<>u;|-XiEh{
z9NaLg<H<z%rqIryWtgM_K9z&}H3VJjjTwvtpMVr&X1z-#U71|xMY4iaMx`S`%>4V@
ziBn`0qA|b@-f%WE_M-pL=75~xZz<;NM+s~Thq_HX@gm_{@?XplBH+TA8E}8mT&5yD
z^Yz0v;-lNCVuq<g-5P}Qzw-jFm)?0<?Mrp+q6)V;zoON6eR@t2yFM?Cwf(w2DqK&c
z&#`oOg#gg?l3o<QzRD$@Qf-!Ew}<Jd28v2|NPk!WK3B8FJwhb$VhEdkYWUTg{A9Kd
zBxk+$KCBF6)->W5<$y{xdQDoC5pAYg={{Y6N5-pHO@>t7#TdU8&cO&v9f*Z>cb)dS
zevJ2sb!?(kB_p<dC^g{`aDB_8L-fkoZ#QO#5azVyTXv``ag<Z(OX|o3aTTl1q`JNV
zsF185h~!ft)$I$)jUu{!5(z&2Hj@$E0ml)TV+uTRH7a%jGK_(0FN2FJZj42`;z<VG
z!Kh-XsIDLHViuYdfg%~GoM#-$F<Bod(bs(oyWM&6GzF*=_mn=oR`eB3IJg^0@soa&
z*rrq10~beK<^MwW1jbn+?C>vik8$rQ|7>^nKA37E3=`&AuK=xLL|+cvf&!_EA^#b<
zbReemDd%jLh8>LVi;e1cF_@^j8BOmL7!PDaE>k}bMu&E*FOcOnJRT}F@@x?GqTG+P
z7;-F%fo12u=n46$L^aS>V*f5W==f^3>BZSc-_QptUn;5@IFU}_)8v2V{zWfy9LY=$
z>4kR|u7q%`s5(8VJD+m|_S5B%UtI|IQ}Xxb{KPB5;P9QdKR=!uM5{y5DmQTv6dtRJ
zYnZmuZBUJXs6Jlp4)vE;i6YUt?^sJ8mn)LA0Q$z2C*8fPrCr(HzWVjU{uef_-UZ!f
zOBcc51fkBP>{6T*mz{;LcmhoSgMg}DqWr*md1M*kuog%NP7NeR_zx60eHChq`fZgh
z^-ZdQ?jpiJnolaAOiRGHtZBO?M&w3J%Z6Z-JAE6QGnZEGmlcZ;7+4%6jc>(&*)-rF
z3JA?|iVI@EIt&)KbugXMS@(4^_cBaFxwo-1oz<Xy(pKj$Mo6jt-kR#_MgX&h%yoxN
zwdeCPaD&zhyUK8mhOmL75xoSfMY$5SBUAyAaDQjW*=LGDHf~D8DYdPpB}&75zE5W_
zEi<amo~Wdl7h0|`(=w>!+Q3ohrBQU_QFNt0IKSq9I63qSGGc>sX-<)DfnXs|xjPj@
z!Kw%l9_xxfNjslWfYPK#_z(;%3j>%ZJhENy2fkjPq9g-$lVg6*!))Wr7ptl~om5xi
zc5^%mc>m6|c7C3}uypfX-<^@YwlO2y=zWln@c8P^O2*Hjv%CQOQ#+AWN$vJFN49!{
zOdd<EF3NU@9`_FdQe+{BS;Gv3bxOycgVS(-N8>nVw~iEap@!fhNXSGb!ZzGEbQ^+5
z`Zg~^k54057H~M)gUOR2W2ghPp>8Xqvi;Kh$K^G#fxyP<H0hUNlQeSl$9ehq;L-Az
z?gfy-aqFqw9B$ekcgN_yJ!S|tr;!3vj#dr1M@hQYExZyp@m-1IqkWVl0&X83D~AWC
zQ;i4cSp8^xpz6uPP&ZWI@PsaDOGTn=Lyk$g0}yP`VF$<?Oroqm2)&4<jpIpwzBOZp
zeuoV-xUhql0fy&Cpwp80ZtrX!g9k~Up^0Teu<D65%;)8m{_G?RdxMiEpX{#z?!}Yd
zL49YsO}+;<VSC1Iyh0wYC760zLz$iG+RewSirWgtWHi?l!DP-X^Kp2vL_psfc+Uc@
znqcrXr|*qG%o&AU3aYZ8QWB_Z)pw-bh-0B^WPh$v1=R9BHSmwUE`hyMSC?J*?1>Th
zI?W~=-pad!BvP^>I=VX9Jw+6-*D+JFdAs2;^v=L12>*w-w+xGNkKToGyG;}<L_k0V
zL_k16L_)A=0cjXYNnr>9>9P={Q$%8vkQ_#0=-38bQbU7CNe<odu4l%b|8w4RKD^gE
zANI9{;feLDweI^~Yq?t+0|ku;hOIgk7C@)7FTUKh>E>a^Zf*5zAiy@1!zIVLeE#xf
z2w;iZFBgHw&Y!Xbhz2>lR7_(m;N*%iTM-5KT1&xeI|XWoL8UiNs6>)x5BSt?zv->a
z)$m|9*A`YcRt_KTD>SIkKm|ilmMz8%Ehc%o)1cR#J`<rp3gudKbn*nM6S_D3n-;7p
zq*i)*^lNiA0RkcOBQ>(F0VKm^O8G-d{DTL@nR;79ere{c`a3SD8p$tT92u(Q34x4u
zKp<};@pv_;>xK_rb(|Titl>!oTIMnpecdMACGl2Ggfgf5s3*(CXN#*BR7ki0i(wZ9
zhis=8m*2vbQ1%Z)L!PRx(upa>5BzKeg2SBuR8F4Jf)(?KwW88DHQ%Ixer9B(5LDfT
z?xXd!P)^8wzQ&V-MM8-Lf(P4bCKz5V`=${Wk$2U7Y$rn<A8<#w+$krfJ^;S~(k=MZ
z1dtUtGbwv0D|xi$lX~|bh(ek^R~|Sa!KR4>&*4KKJ>QA4adUUFZcfPK_a*lVKb}~R
zOCWXmeKITwVha!w`Nk`okk+yfm-ek^rD<}y{iox}@x0~Pf5-D2H^JwTqZEi3OZZ!x
zV+Ze#2#b_dYcC>Gc|He~f7Mm+!m>66w)wI-E%LA}r{On&a4MXL;3J_EQ-PjBigB+_
zj+vcs+0G^h-?=35&EJ|LRvg2I2L>~@b|%OioN_f1^AjwISn-8s^9U^182RYmtoyo6
zEV{5CKk6#*Mt9l{toP-c@JEzr=ez&TK}!+~IWulO{vdjIYnkALC)ExyLqwBOEp8c5
zt0!Fnqh~|xr!uUQUusiPtY$+4`s2@?WMFWs-xaq2F5KwX?8b-<0<laWI(4{jeWp(w
zytXHgnny^Wm4hd)o9Q^yds3%{8{J9Cw*OMcCa!5B%>rz9t*wn6sC*q=>-KeNG#Xbu
z!zhy1`N}w!YXv*tj=ri=Q@jLmZ5`F>T04jnO{bI<NWxCUcESIRU%g-!Q~zi6YXM+7
z2o9P?riF5)ibcjX*JYnhxdl&awJYTrts`Yi#nufboX+_?c)PI`a1cP_*xDH%gX}$|
z&zV>M6(K29`SvvNqzadMLo9E(ws$$)W@wl-g;Omqg0kXA1;pmzbX<DHc|wXz7-+06
zoHdmY{+E@C)L~m*SY8%(b9$O3Aw<%CBlo#+tW`zmUjS5$AI;blCd%y2aU6yCKcuPF
znIR3vtP4IL;Kck<0OkK&HdjM|&3*B5=8D4-RQg>S{6cAkjC~=idWnPO0-UJEg7FE*
zSFh9ops}^kG{U#ml5|+M?(SCvgN@2@Svs*$cfPAkNTc>GRHBE{wskWDj*IrsM}sbW
zilPdv`_$yGKF`9Ae$6Z{WL=r59LZ}PK9s$o77MbKmBmFwob!Kp7m`#c)NJ+n-K_r=
ztN_W?&>aE=*#0`NE5x}0tspQ1*5at;Es!&UydhIcq$j_LM>+96oZ(5(h}No*8~<qV
z8Wzo`zBv*Z1-bp-RtB@GY(Wd(0qO?^)7nw`s~Mxy(@BbrVO3)j?G5X{8-B&xPdY+1
zw=|u?dVp6Vi$Q%0SxYR@mpo`NHd^SGndm-x;oSU~7BVb7j@HAQ&+|8lCRtv0UC!9G
z3s?2^#f7j2=8&4G%AsuG&8TMcmPBfx44hqD%<W1_M3K`l3cBbz3oVzrdWyO{RsxP7
zHws$OZBL|ATPB;S;mx&#)~Fg;BT`6$FH4^i`<2SFfp#Ti7I1_vA4?%c)IeN;Kik14
zas6H{H@8;C$<DfhcUiFZwpYrJ%~SR#%3x)}#7>ECmjaLLIeSyXxEpi?aF$cj)C$@T
zKS@;)C)j=fd5?Ktf)s6yGGwcVegZjdt!1jdXKa#v!&hG@1`P;t=mdD-;T+6+elO93
z16ZrJBR^(-rUo=W)xn>%QJ|Gr17|2fvQ*&F{VJH_rEbm%Vp6XP0-5#Uz*iitr^~n6
za=f!Ff4*eZ;IOfve;q2!ZD5MzE2Kih4hC%(Gc*$j^19kTdoAQ!>6RN*v`}aEo%EaX
zpT4^wWdt}yiO_abb0num=2usueH?_V0Gm`X)p6JjXWBFXYx$a)l^HYD5Z%%ISpwA2
zLo#8<d9ZZ+n-Mm(g=8zPx=-mi-x}DNxkK8>&WtqcwUP9DTo9AKmrKVtiQ(Nb@s>4C
zaZ23Af%R8-GTS~qUl_^X04)3K%HV5d*dJ=6__e{Kfm8f_z@0l&%|DW^yN*t@#%v#H
zOV<#rTQ^n!>fim+MGK9kiJh>UJ^l-@i~#<M`1C;@?d?sxnkmcG<0E&HLp>wd+q(+J
zWAOk4sw~I*T_)A4z%GUZQ-oK?#jU$fI018ND93BrFn<Y&CboI%VaC<I16T~m_w7q>
z#Lpov_kzj1=_pjc$kwfa?bhVgVdDUFV>pK)q!QtDH&)y+yrqjJhsw4bq<W&15j)NG
zmuhnjg_Br=8}#=B0=2du+d1Fbacy@XX$jAa{KxNvklo;W*|^>=54Ey!^Ft?=(vEiC
z9<9DR^g|XBt%4MnA(x827zNtx%zCIWD$xTyEnI5em3!*De;wCU()JvwH4dK>K!13+
z0f3zp10Db9O=%F8NmgNOQ>ApkB}iA}V$X*rlJY$V+&A(<J}HV%6YpzHTeT3QTa&QP
zfU)E~hh+#UQ|MRj`4|8yeCnHWEA9G^Z9?@h$lZww7Re7nB6Ubm>+~>~2C;$BY`ex*
zxWGltOX|@X{wj^+fa;IJJq#mVZpNt&JEr(F5<Sil^dCMLfU5tUMg|@tm-=P{M!X4F
z!oGqzKN|(`_Kluxil7OPN<lqt;CxNcR#?4_umjRTjv;{7zm?fr50p7~OZ%O)AF)c1
zY!Bed;^y{QhYg8aTTIgqNd!88D{0ZJtO{@yEHhqmx;VblFs{6;!)sa9?=&<(th?fQ
zXVesRSX*$7KcNGdV3>Sa=IusN!CV?tJ+JddxwTC?sm#x2+Njk<Du&J-q><(LYkWTr
zuJzAbY*)2;k%J0fqkmJjh}uPksJ=;<DyB(-(_HEOEsp69q)ZLCogjEJ7P-0cO|JOu
zmDD6fJ7M(<$f}FFWZtG-`8r6^!Hip9Or|(}S_UI_!0l_&$vXlMzjN(?3{7tB<P8q)
zfpth?8q!t|stWZOh{*&!3DgjQ`gqw69h*m^0BN%58*Zw{qobi7rD;v5VvoW{1}@Gj
z8vTp{khRlAGD{f8*k&RQqRg4a&5<|N7wk{)*t$0<IdkeGoaj$?@`ROW(dV%LCnEqe
zHXaS2OFFRaKtE=iw`X_rx&k_9S<d(oXh*(luup;a6Cv#Ms7$P3Tr&%@T=@obnx@=X
zQ<p8h0Q+g4DVx2;R@hVOYBzMZr{!4+Y$Zq+B|$hm>5m^b5E%sGxOVm91NR@=>eN}t
z3-T1tMTcA5s?_%^#s2+<^-c8v#o&{GjO7_hR>XA{*c6R48&n|L^SMYp7d^V<7=&<p
zQVi)rIG&Y>qO`uxJbG%bkGx_Ty=zt0K2fui0S%6b|2a{UI6Yet$Pf<9%DYNw{q=e+
zSmYSE{|rvP0>}!eC2oL*bmBSmpb0;^)^TkhFD8&i-*x(v>%OI4IUMX+Xj+V6)k!o<
zcigG+X+@6fJ_sMkO`#%I!++^f3R@iY8MRv(i35Vkbyl0_)$*-q{2JKH-jX*TZ1h@G
z^L!(0;gc-;sD9UG;#S{;F*kPm_Kv6a+K3L~8TVQO5jKA(C++S=it7V&>Y$5LpCi`j
z%=fx>?7!|PL()=9r{-$tlQP$A$q7Us{z@P!wzBw3opQGnlxZV_j`L>B7srRfw&29B
zTyp_@J<JSYnduZSsmBPQ3+{pv_0i)+v7R|V)gtEDG4;4|jAGC6EC^DETo$tr#}ly8
zuR$yH?lGiUtiJ#;UY#^-*LEct0z%6T<Jk=5eUL5z3SYj=a;a~B&Q%ymIOf^xpj^Ks
zbF+bjR;|O^z9C;;bzmBd>GTWd(SJ@?D|;7$t@CSygw>YXR)wLw&8!%~UosS-NKQjI
zQU7mj3P=@+RI+Sab>m8#tV;2fH|<i}&~ne~HHU0Rflr?>V9=JCc7Rt;`$2BWCm=wk
z7cPNp3N&`--9<Ug2Ou${m6&I)ra1Z-)VkB_po^>6SaF12(9)w21-9=)&a4p`efOpJ
zVi!Q9G>FMvCQ`RlK}C>c;G`!UBhGM=<wS5U<quG`j;W^3TR_Z-(9}{>Jkb|7Ofq6c
z$}s}yRS1)TkvBtUs-`YNIG=m8D+#2yb@xG=yl6HWRK0mO9cJHVy=tZoD7><=P@>L*
zpSuaz$vPikx#1#}0E0|b`erjl#XzB(k-D24$w*}LT`WIvv+&F$<@`lE$TY+6)9|69
z)DO+iiWx+UP?6<K9B=-!41hNybgo=n-@Ckca5jgVPNr?+1R@jhC<Z^LBU3j4`01L%
zh1wwB0U#)^b$i=&%dY7<3l>UOmjk@oS0vyG#0;=gb;|28pzty4@I}0!7l;!SfX<57
z1vPiu=!+Ni2vlN}=(ZM`Z2`nKex=hMEIr@;+_Wi^@C*UW!1uvw=gWdrYGej<jFWc$
zH`@?U&<8|X+jLmy#uMd#H%_$EVZ<R)e%+lP@qoCgJ@rzuas@Qf)f;<y(rt$5v(pi_
z<7k&Rzo~k6BWd@i590cSi2^*%<Q0NU0Y)5o_PJxJiyD{uMQ#@84-LF`&nm$J5*&L!
z4t~<$r=t5&U$vv`K(gw2CC4x75oWxKmy3&o?zuh+5#JqIO{b@iEhYok*=D%6DA;E^
zNB(C{)9+PF5a;!~=c|Br8wxI6EFT4bZ*GN%q|07YK}54qlPZU=^~;w8kT^n7=Ulfn
z)*hi8)1Y91Y8P;wbL=O}h3<u&$AhZhARj>ABwp9;&9~cIJ?Jc*nO-pf)VdukCr2Bw
zP^NyU%ha#N$_Vfb<)jwt(xtR%?H@)}MkCPHYa<JT3Sis_JOuc!sG}9WHz2T|of4{Z
zZG(KNQz56=;utYH>-^nQtj9l)bod}TT?4`k*77u@f<^M`x3sqA+<012>VjY2ATCwb
zz)T&!TU-_Ky{R6gekWk1pg<}9R@C{CYMa<v7KhHY@|Yst^3%ij8?veSuDLmhyWes3
zOx*llL-#RO=DI9tdovnCe;HmgUfR(MprX`peRLq*-oA^<HneFwSHTjAn5Db^L!lxe
zC`a<-?BE{o`DY;c8B#`z-h!eH)`l;QKAm=WD-s<)@>XeOF7dN^5Lo0GxRbQ}{Tv9N
zx!Iky22BVl56MTLF<CPJd0CJ(0leHtlZF$JnIy3U@fjp<oL6ug=!|DdLe5YgN4uR@
zd!o?SooM??@aEK+b|#Ir70&dG3<BC@Mrw|XMZ77&o2i`1GBC#h)dh_JO)G6Cj*{jP
zDkPtXb^8z?nlm*mB0K%5J^st*gqfGABtlzR^xr7OcT`W0JF6lWn#&=ujQKqY6QRf=
z-{McW;|XPKT;bg~m6L02<r`Jbq<5n5K{CAl0j=m<m|rf{*Y<Ss7(7pgAU@vw_cxHR
zh(gBy-$_-ZABLVnz>2@qu}D8;z5MSdCH+v^0MSMKoh3#3VenVvdE?6;DS~o?guRfz
zOOJf_a@jNF$MJs?!v8NnJ|>k(X=@*hexbuL>~dD)aG}Fb-pSoJY;9TxE`zK~Nk=n#
zM6%k3ltgx8;!ei?Gd6JR#Jg7OB6}%<O*9kY+s_tgfwrV+ZR^>^GQs7oOp-+tZ^5G+
z^VU3iqjva1xgl@{m6@4e9PJPIP?h4Ye!uGJv0)cn;b=L+L-zm3m*&wgbA#3!mOXh`
zpnnHHdx5ev7Q)wy6w+3<+@V~dI+4Q@tQ{8$m204r){9*fE$J$)C--Q%(VC>&ZFJJ%
z_X%d9G_G&>#w?e6=p^JJR!M|#l;Rjf(dq1palNqob<V#AjW^T{fGWt1yPgc6?>JX@
zuEt&_Q^7VMlq*69*CuxglF^FFHsHL#!%LZtVZrT*_T%!1uq&HN9d+Bh2-giZfgCI8
zm}o)kI3egR_vyKa!<1&Z$5ys+-ANvuYt$5>(K>#^zN{T=g~BxgvYD#3rOLbyAYYDs
zbE3gmQGhyobsGV%_BnQ|;xIAG2*OCBrj@y28oaXGShg&@0@7{e%%gDSV84nq(6>_D
zunj|p=!6Uxv1+gvO4dZkW@=2Z9ij+s)HF26yW+xM{i7H>>&qcZ<_uPLEW-sc%MxNs
zEY<@mB%F<W>ErbDE=v>b(2xNm>O2om?g}}Yd6qqr|640Z-NxLdgy)SJ;GH^$@sCY(
zD7$*MaTA2hWWS*e=J<^tFTA}6%G@`=(zZ{pfnuR1j6DcyHZcEhEinw4ho9m|nS%&A
z`CZ}t7*9jfJr!B26jBJ3N|$x+$=6qbfm9GVA3j{_4k;wj&<(cK1=4u^D1v*3QLGxQ
zg*-LwGMP%YNuiSwE(dl~Br-TE#zNNU&ESfal`Ok<rrxPP-pSaGI>IxPH<S^W!pPJx
zgG9>JxAQodK%SNh@4KHzOZ1oJS0|UnY%-j!BI%Nzs0PCMj|}&RsflApjOKK;(sUu0
z(VW`K!L3(EXf1kTNrgOY;xKIRxzTMi5nXZf<bYS#WG~c0fU9aH#7ACl*J<3TpeZK@
zcd5(>j|RNibivj}l$vojX3H$L`^iSd3#rr0f{vhN`zsFo>#OpwUiqkcBY#B^1okHV
z5AvTIzx{e0(oa~Q{QvT+RGGHeZ%ge(82u70l2IvoU;Q$aizc=QRmKdaTF{X~tLAn~
zC}*QsGW(SGAx2Nsh2;pJC#pl$vvgplib96|>-KunXU%jqi|j$$7U&@+M;@nyUoV#W
zrNUVI`StXDu4+4`(>!=@*8KM-xHEplS28!r+Xp>zFu_N9kJXNcNr>VW{E}!`rr|1W
ztC7#>G@I8f8W2C@MfTLpNUC8lev)5_yET+{fu~@^xy3IBpUx}Wj1xWWy|tU1)SHVO
zFYpP@*24C@72lsl2>0X`UM%aD2rafBZUP9KGP?`}i62N<cd!F;@WMwq_sf?LXbiN<
z%cb0Apb4_l=op;$d2#4e@>S&5iDth{5I*@il$*2w()3Z~+S6x+Uc?n&5x?DVpGd#b
zxJgbX`s>>#CYH1K{cH)a5Sf?-HKxx-O?jF=6Fny)LPbs_Xc7K317%Ox^I90!<dNQs
zO379F{87P~i}iZ!z@{|pW+zYV+&?Gwt=KoStwo%=312?9?+vYKRy5rU>tT)|h5WF)
z|9sdwNXn%;8+FIqYbS<S0R|pvI7=2&2;U%EpW@hZRrnsbt9@A?*?@~rf6YeLsg=tE
zy!Gm1o1f*$L$?0sAKiUb;7|wEbVy*kH1q#=lR4M|hFqfWunMWgBLxTbuQeA%nxN%H
zz3D3o#oxunNPB_RpEHQbTP%(qCT~pfU~Je}8!313j2Cbw$k4Gq&siYsbylTZ&a^T6
z!bElqq@8~~v&=N`FqGMCRN1R>F(o%hAtZ$|>#tD>Jy`t6*zD7Juumy2NS(AHKMDVJ
zN(Vm%pQS@>`lQiZpDIrOu2FcmWbF~>g+{^$;%1IRB-tSj{58Qs8w05@ziYW^oUmrJ
znSR}U+t<eE>mlbic~_XAMglU$41bLptL<WI6x>llXtGbt1vP!P!l#HfkJZ}HIWg1X
z06Fib1@SxJb3^%Bxs%;T(<Lb3<B99dTn-LB&Aej>$Mlzl(qH2V{1o!l?+$|0F*+cq
z`E!p|4t+E0ljQZbmPKNn61f(*LdX{%6<cx-z)?3dA*^G0#!E=R{gtRPn)9(TY0qrA
zPQLS#9trP$aZwAGyG}2<Z^#-1`06QTsKK@W6uI6glKM5pm{upf)!>C9lDf4F4M@ZD
z<T2!}BR8Yi9N5vqrq?;_hXIJg>yX@B3i7B^9HD(}aUgq@$Fs;8u`Z%ory$>*;tYXg
z`0GN>Pf2!uf)H)UC(#jHTSlX~t+iK?Fg|3Z>Q_>_7Hl7-8zV{i&o7ph2d(LmHmn;6
zA%=WfihURyVISj~P)H$P@!GE|l74;c&#906>&&iSzoIS3W*cr3^drORH&8b-d=}4D
z|BzEUA)yqmKGDibA(}11-pJF~cQ5nOU)0%?E3m}Iz2<1teB(jwo1Y{m|Jxr4u%yru
zuOQg(BFwuZLRh5A07c?~ufEc}{<sunxTI<k_mbH$3Z|Rjyj6C)4|iwh*+%~SwqZ^h
znPBxJT<1!^=}Y5Lo(UIx<5L!qWdGg=rtF@DA1}Jjk9;i0k&m()^ta$apFu$Y_!=yP
zg5HoP)+1@zm!$fl_wC#xPxD+L2FCXw^#D#tz#M*rEg#LKnol`7rM5*>>uG12MQW2h
zR&DRDoRj%kdT{@<Cz>}@@1;Gta#Z5?-+z}#@;R|*kGRsuy@~rTFop*{Zuu!M{6gW}
z8HprX4&__kFIer$1ucZ)ro#B>_!47wtgqKabh$Qhv=*S_MEH?6Z-F|xoqM3$`HLe4
zn`ozrOi=ib0Sz6=qgw<>MF4}~=g*(dv9K(8-r05L>ezFKHRCiMUXFc|8<Td(-#^Lq
zK^=9tiIv`e_Qk0k`k4|mvA=X5)oCEbQ#PB*z?IU6obQVl@9s#QptzXHC@RFeBRB6d
zubqE({WNlcGXe4HFLaT<d;8B;mcL9V9z1vuYE*2@^c7Q|zV>K-xCX8<P+)T#xq!jJ
zawp@OA?s?tnwKwk#{7L-l0$y<3EK_2edBRQ%7s!KgW8S7@6=ge9J%H1d3dZ3|9D(^
z4dV{Z=<A&k$M1jaT4RQcC7tG-qkAa$lkMcOjq|ee=ru<;hTBX-=%+S~-t<0qbyfVv
zPI@@KHs6nwP;c2FlL=*GUX#nBQaQD;y>VS^pvH5=nl8j<(%{y98Qsg<0x|X)H*Wm#
z*^3gcUI@fYU$G<eb(ckGeY-9mPjRF*E2@q*(rs&WU~KU~;@<r214~WopHJgzBOMsO
zjs5dp#}q&FSczV-`dU=UxMkOVg^80;oskg|k=<W(6z;WlS?}A2egQx@#Kp_KC~0eV
zR(rr)Pj~NY#E9c|SPoL0R2s}*I-7W`Sd4*V=g98@Yj-io^`E@B$Mu;93Q}eq*s{F&
zje&X9#I4`y#p)<-NCTgwKSZ@nv|rhI=e?=1{rV`~j<tN{*a*s2cXIE6v#e}YPK?pE
z9lYh6e1?_&P*y%kE^_alJ=1-~D;Uphk}(r$9*ptsF-jMzO1FJjjUf*%QpOXR9Jx9o
zB?h_)R6AmqO1L(}c3yj8%68Qy@0-y(rD3E_sFu~jWnRz@p4Jpp*ngITALc<TasJ!R
zHu$V}i(LakJoj9^vMKIP@*#AfAUQI^J8YarJKt}5M5RlJvu3L=pto%PNYf%5yBt^T
zQuta&BkxR42)5?xQt6Rf(zTROjI&c~wSsGxka<n{Z?yTuR+7>G*h3!R_+t)dA5Paz
zw>|%ad$93DAP0+m?-w#zd$R3=QFONP<jnrFtP)6Z)v2i!Tve_3u1WpzOhuAe(J3?!
zXxn`6*lw*(R4A65+>)+V>G7<;hgSJ1X(W;@(DlJWE6=)*<LryX7$_V1#L~-K?{GcM
zmf;|6-c&RBDWKv%GR=@ntV!s<u6jZ=JiJ?@G56$)8Pk!wq$?=qNbi@aK`M9lbPw_C
z>Fsp1Po|NdppN_mR~0+G-c=}G@trwQCqUUdj9YoO5+}c%JtEYM(X#lO|Nhu5Ws4M=
zU4O(`>6cv<RMd6e5@*hp!;m)oNF~zbu#8O!w&yLU?c)&Jek&y`5dnX{^>c@MwT@WB
zv}AbZMevCuP>S(mvb#Hbjo(hUF!RK5#0tTu$ZsHGy7TU7^NL4Y_bx7zpSt%?uQfZa
zx?&uiwn|6s^>Hh;+PJb-Yy<mqv1s}$bww?wyUNyMCAt!pE`fo&kixwZrmw9Jh|s15
zowN5Xa51#%ryZ%-=`A|qj?|5%IQE=0p&s_Yg!;@YhZoX|*s3~&Kl#*!x4`bxJ~7<|
z+FI+9yf?<xZ{C}inzvqU%+qW3nUYv$a}D1@QNKKLD^w6l&+6D%>H6q@nDCPmI80rd
z)^yfhxb(3~wUqb-2^k5Nt}GsjbJecN@xs{rw*LE(<M?>X<86rvy+n`0J=$D1xLXAq
zICRVW=hBWvUiPch!l47F<d!dN;F%7ceZguCMrQpv-~VMoYSm-%>K(F$JENgz_E^9A
zyv3kt%oDL)U+-WaHoe%+yC0}ABBYhRC*u{7<z;AB&u-c4YbkS~$AX~UU039k(lVE8
zKGQL{tRY<XD-kx3lPA%vxMR_8S8OFE##<4yP`L8<v#<2_$i{JR`XB$s{^U&x&2&_Q
zwZ{d=BG2d`><H$y0|rvP;=b~JLMfdCTh#Vry~9&pyv&3Wh9yu={3c-!X9vz&9evf}
zjYX{d)51p&ur_)JMmw{T2;80A8aOM}{7S60Ha6!)0n)gAuE2d{ecrVHb)=74yU3mX
zgB{5vZ!yobL~*7tKSES{m5%+LBE@ATuI@_@Xa(1e)2>z(+kUT&B8)c02#Nf*AQs%=
zbY01Iw5EMFRuZ#4>)iA}zieA?!CUsE+E8YjZ?;qyZb~=slgs@~)Alr*$~phjU9Cko
zjDOt0cm@fXUY)c!SPw<B{TF2KLFrPg_DAhow@gyCpNB^Dk}SnG;qbM)NOySYf!X-U
zL0a5TvZY`X6icD8eDmB;s`mPf#x!^7LQdkB$k+hd<7}SqHxo{7Tj&ijh~~=_f6(jK
z<7xLTrmgibCfXh%?6$i;ipr9WNY0>CH7B?!U}d<W(7bM$WzSW<WUZW{i4*1>nJMzz
zI@dlId0mOAuKo_`9Nu1*{M5=^p^4C^?@6antakrg2(9-X>Z=7FQ~qLzLrC!l<Akp4
zKK!{BQF93flc7n*5hm)NtsUKKQO7^p-Q2#l29Gv4GA-cJtT`!L^Ihw<sWtV-Ky8+d
zh|;>tn$-16Z_pCFytv)_4A!zL;g)sbs4$ed1e%ITCq?1xneS4Q8Sb_dZ3pc|Ec%2S
zgypJBy-`PRWH@+UKELiMFp@&E-t%j_rf^Jk<YjF0m0p19^E##ad!aL0qWor_TM>SN
z-}G}WM<v%Q<(V~8Y~3*i(%{?-{OaPwBiZiDCVQeLk~ea5aHzGW=z}7L+GwJ147zU6
zsCcH(yh=tE_QZF^UGv%BBL~;`%dOf;`yRz5C8C~i3Qfo;%o6SnDx6PQ6=fU#qz7v6
zT}F$N&<mLDZ>>f30oDB@r-r37yvGbwv8$^?6;QhN@Y+zbl%G~dIH%eb_w~o(+pC^|
zo#s%0hv2p#?`?{4k9V5;915!b?Zwu}!NHyeG$;Vm%B&VYd*P2B{gfcJl7?C`)7orP
zNqTvB@+b{WyyZf5NCh<3i+IkVdI6l4AZq%yhRuLjDDAGIO-U7(q^p!|JE9qty{!|^
zg^ypmwzIvVQ7F&kIyDGoz$`8T#HAd>gl+#MR~zXW4<-P)4t<luG0_3w?ABKwhsvi~
zLiJyxWQB&@!$k%95q`8CHRByAN_yO{i;4ISJ<XD9>vgu?)H@l*&|hx)8}w<g54IaU
zWLqg}vOo~E*$K@>%HX~&r?r@s*D!`{Bcc2vfow>h@qv|ZslN=F{94je^IN{H9J(iY
zB<v=J4#!&iB0?pjuGa?^6nV@lQ)r$)JD+aYlg(D?-Fel@A2f;2_qLlhp8oz3x^rSd
z=O8}%=Ca{SK4V$2&DrPXEF*Q|HtUPBhEa3H05|O+Wa=tyS*|YkoEjM7^bWu7s!qqN
zv%0HG;pL(65hBnrl6N*Y-q)w31Vbs-+WS3u0reWHsh~=}dzgW6o53+j{Ys$SmzOnA
zJV(_Nyv<wD4Y49st%~BPlzU?KS!S)mHkRz47D{al<zOu85Q&hnl&zkv9CUx-Ct%qM
z^v7ad6M-BszX_#npz1~pmxe=CU(@@mRyuO>QP4k;VL`9H9Q*UtMr7g|9K4r`3k=IW
zAwy8$f&PFD**~E;S-Ii+pN+oH_F?b-!s4yB4%vC`sQz(6r4yS?@7jUe<-yJbW2-yM
zJXL3;46cjPLKjmdrL!>eL(0Y1f66aBQ;2<A^L?soHx~cn)$uyjv9=5?-60k$Fcyd>
zl=p&Y!t}&b$!S&mL@OkzK!cNI*Ok4euNNiCgmv@15kQYJ2<DyYfo{Fty?2hYucsW<
zQZI3Optanps83%Ew1b~N&@6yY22{T5F4hqQx)Ztz@CS(;*WwaeQcZ<6b-*iae0wk9
zxh0_AP<z>Nrq`_}Z%4Lwd#gBYDSJ*cKkWNjAmaw!{{)Bf_u-lm^I_m{piS^)>xQK*
zNaRxOV}W)GhYp=KaJzd?;XxCV=i1Ozms&QXeV_BfOD3Ug&3G#=G|8l$XW<yFx6&^v
zTK7`u5jjNmmnnP#T#}n_VtuXzp_;AMhN?a_;|(T*u$GwDk=j=;>B-y)>=nvD_xk;F
z9*z)kW#+t|v=@S*Fa@LeGCUJJ1!9KH2Ur?t)!^lSf>*C|^Keoq^s9~LiOs*ewz2b0
z(!ZMnOpq;Qn51Mg-93WtHv!73f#J0HHbYgcVl^ELyCRPwMlALa{d9ut$_&<M7Mel|
zP^Yn`sk^NX?hA<HjjL|>G0o`yVPTBg&tBv}oOQlc^S<5!8}7-<AsL+wD5ab_q+neN
zt9}x%`eWTv;vesRMd`s{WAz1c)bXS<#qq>n8)xajQdn_M`A{+;PqA)+S4|M!`;+%U
zt&RfPuHw_rPrq84)$uP>@6G4E$M}AoQS23tc&4!P{cV-C9u!v^Z_nm@-7=v;9jB-8
z0ctcS^U&kN2){v*Y@B)T>S+5urfL>i_PeWu5{nKVeY(Zv<uV7$u*)!=1dKjP2FzDh
z2QX;2B~Ky;d0CNcyg78GuhKL%lm}Ipap}7AEtX6S5%k`Sj%B;-2S0yxA8soefMx2o
z7Oyzq7Ogqt^7jA-kH(@-Jf5B%SigXrRIGcJ0^`90Gh@QX_x)H;rqQ=tdOIh3E_<Zf
zM0ZFpbh*_xbS#dGn^qg|BB5*1d8w#~@}RHPcrI%0>nr1l$GMX767Juov#OZXX|WLz
zwNPxZy&x^t-;$87kpwWiB(z0OuM8lvMEt&&3f7!a+~sS=vdnbO^EFcS#g{@;P)Z^S
z+}WvxcHY%9>&w&eVpr%iu%~v`WO;NnH@@B8+4dQt<Q1JH?%XySE+4pPF2A{P-D7h=
zn;2~^tcgQ^tw1#&U*XM?0Z;0TWwHBOcdw}Z7N4l+Qj;NhL+IuI*Be@M<*hAVABwmW
zmBaE44kFe;YpyiE+b`WXX>*M0Y?me~b4)do6fr=n$4{`Y=b~&@ti<hkvOGQ#>v$8&
z6$PLz<wU$6J}j%DU~{?0VyFm?BFdBXW0%}xGR@nQM}Eu>Vxk-$u*#TA6k2s<C$-Uc
zxz7FYDlI8F{d$HwbNVYPhfyed)r&SxZ7BY3RA{#~7aSc+Q3{vMRe7f;Mhi5#Tz+h`
zT}AqCBwD(<Ro3}!{_T{XXcO_JGM7knZu51hOHFDWnOVm6wsbF>jn5e>!duZ5yT#i_
zF@%60Q5~X5-Bj@q|07j}tF38NKDOKO=QpUtNbHYo4_D`6y7uu#Y~8axU$D_zi>;2v
zP_X<K@?x#;Z~L`L=nveK3cQ#nxe-zhf}y$}-b|dQjvg(s8#`SUJFtw@%X7HIxuVBK
zA3F&X57ekhd$IbGa5(-*?IL8*?W|AY+j-BM)W3PKwJuW`?zbUeRSK0Q%oqf#{yAcY
zDXB~8-=qhYRAUAT$Z^Y)#CQElkMD7vYe-Pf)y`zpJL(=pn}W97$UXFyX3IX-gn4<p
z`d=PIE=oxmr$<AVs$UM7W{OVE&WvIu(gA4v4_G!p$ev+gky_5R%7X)lPc3KE4tYxz
zr&S<=a%wA}UG>)@dGs<7lP;E<|9Bi~A4S(OW1-s$k4j+`>hhJxrRMX$?e>0Cg<aAU
z?UDIt0<rnab%`(FA!JDE4B%`gOV>=?CtnBrYv3M~doJaae8#zsvyfxlP#+hmzqZj=
zzK7zX^YeO#AY#_06t_E%jWPk>DCqiDfxVUi*$uo?v4wU!Pzl?I{smR$XxBk6(*PT+
zdU#u^ijt(BJN{)J@I(1<bhbWNPfVD^w=!6_h511g@8k1mJTVRAe3MX~3I!DePdj?<
z<s<YOB0Uy<7qDNm4R+RPcg-=Serzm4Sipa<9^lD-cjwi)34{3MbgNR(^2c7wsxLB*
z;5XgA{_-$`L9aT&aQW+&+!PWhN~eG3)uF0ZlG7XHwdhN4LSlp)$CQW{{`C4TG3XOd
z>2fWPqo+4>Pq-((nKOuA#0Xax-JSP*E*_ob9BAK5|5qSTh2qjHJQfZ~$o9d<&%2@h
zwb2z7ep0m{*XYPLzU<*a3{&iXJqO%ctXQdXK!KhJ91Q7VtRTR&!)ieZACHY?ss$gT
zA9tAXd*+72f*$6KBCqPapei7MCajpV^6@!ATaGl(c8|tOnbVq0f)^gnFHJ@_piy~l
zGA9vp>fW95;5U-y9a2jZwcp-E8H#dp4*zUsn;?GtXbI(XG(w@-cY9_!BP5gS8+e1~
zaRY@f9((BQtUvIsn2f2*NR=l1e5ZcrtrYg*m(!<3lxJ+p&8@XW#JMqt*6W=vD`gwi
zwK&eNj0&g_<Z-I(>y*+}7wJv=o(W{@BS*;6A38yJ_3+0NZ5iO^28p5SHxCG*u@|7a
zLcY-@5CRfQJDfhhu$J;)MfySTg^IZgFRa*|PjdiWVE(#$6~I!9Q(e#zz8@qmHVdP?
zFf|swfAShlmxEGuDPqYNUQ+MejTRVVLRa+UJBDA>`f4*~q@8coiAUFgLub<Pb`5dx
zXRf@3-gJS!2VZ%@?6B;bXA|1a?|0Fn+D^ulS+peP)z^;m>Tg?zMW$@YN(Rj&m7Tf@
z^#i861=iOmR|cGuZ$f>|evjg(S(5HvW^h759;F~``Ab<9nn7K#SIaB_<niRnI6?gV
zt}gS&ximMMDi1Oi5E}URB6)eBxS*L=1urztxi2%u47*i-ptJDZqq(29)faD99%>?_
zd`p`YAv#!Vk5r81jMcuc)J>z&Xhh=Rky9D_MqLcBG=}mS_;{n$*{1oCI%6?hwy|7|
zNdx+rwn$Ao#$&yCC(lU=8ap<|tgQ^$jOJPofJLIkdG&NmV+Cx3;4fFK%8#*a7as>i
zEGkxHOuB6)#5asRvZ|bMa*gWLY>1K{C-rsJNBt%5XQnkI6lMp#nXeE;W_quQiN*Tw
zvE@%wR~`o^kAH@=d|DjfkSZ>muWB~re?6WcZRg-2d`qwAIsM8nXi|obc-v*hlC9~a
zN9BQ^$8X$i^IfhV6%-E_=__xja+x-*soE01tf%;6Ocs0LuZX|5q;Lu19274NI#aiY
zmCJCt$7-M-n&ss}|3J{*ZZ?UJY0<v$vJ9J)%_Ry%_?d4Kuvh}R=7Z65l@E(rc=KK_
z${qKl<kvj9sOkX1hXynOB;9A)%W`=c1=ur(t{h`3b6=XUvHjq>yvp!ATTc?ga<+n4
zSW0|+tN8;a8|zeWh4IAYY5olT#fitx<&yF7w~U}!9(4@A>Agp@7YmE*Kjm4@<7_ed
zo?GLf#%?SK>Ke}iH@+PfQ=aY6*DkLL`UaQ^wlgSqDzj=VKka5t*%`;hq*%{!5-J^>
z=)Y2PeI+l{lu~@?_r(Ke&YMfPo?p!0V^_ktVS;7)Xp)ED^i%qMCI(kFbmb;A63^!C
zN|@4Ewz|%$Jpy%~kZgVi?h6;zqeTy#tpUK}4>8!t^iV}!q5~QoKTkRH-^EDMBPh15
zl(hvxg^aK!n*2}j<LXU$;o7a4j*q4Ioz@?;d^m@pqRMnxonsj^#`*}xv2=gx^{(Aw
zw!Ld8g~=0VS+xMc?!5DLDVmEDAI81`7)zP^c$!$im0^H>Hu*JHmNIRfo6i1P18@H)
zs6@iX#Q(y^)SnRC1kL_XiHK8(<cXb|H>lqEzPq8{(~zJpK8g3Q){9?>NP0Wf;c_WY
z7S1`O2jBEngRf%*ty|LBfZu+6o-*4rskbg2H|{4_<}q2n$DQ7+&YD@uQ`N?<4!3v!
z@eF4vhWc!qO0mOTpPR1ja{tZe6{@+hOZ?%x-lZ~U^uCNY54e9bY{(7BDW@N5O=_xw
zmDp3JQPt$_K9@k8eWFX5!PO8lU8iRRCYgND$$j%?7_>6KSL^_VG?)H-66u8)C8cO>
z4>rYxH7`97<RpSs*rzs=bgxV5ba|?h27!Y59f?oq7FIe7XPV-S`%aZUprO{--C^gW
zH;p&4X%SRSd@o?>yI^l=Dfv#lug*^Nl18kY$W9A6oGt*65CLSP*{5!OYiS9HkFJ<+
zxZZNnYCe*?ZrPYOn|E>-z{;}F<0&|AdXA2HtK1>G?OOh}AbD7xxI(vP1f=c=!s%&F
zjr?5cX7c2IG;+6;wj?qmCKdMAp2$*7M|nWIS=)SX&^tWxFBdI#Z`Igx{j~SjH4=XT
z-Hjp*@$2>R`u*M8hA$_k-)V<TulB87m+0b)J$IJX3&0%d^uQ*q!AV^N6JQCWC9eSr
z)}v%<N9jQEkwgzurDL<*8@tdZ+R?XYSvn%PQ{-!|uFa?bI1UYwg3tF|^Qh!C6mT}*
zx%}|0*gj-XZ?wE8nKE?e7)`e4?3ta5&BU@b<Mf$<(V-`5IT_doq9IGR+=VkSKQX*%
z=e5HuCtT0I2o9$;mpFqJ7Pa{_6PK{0gj|Ut^aTFg)H77b!$JoqiF;vz6H0^8nYQ<r
z)VJN&_g=(UaUb15ACFXw6v$R4q;u7tG!h{M9EV3c1b!{))BDSyS;#7eIq)-*V?E4|
zbJrfd7>#LcA<prj6Y=;CwM#XbmN5*-h(y=eV;NZCdH!k@SpZF@5IW+AOlL)acV$3l
zXRgZq8C2!%3i_xB<ks4Pz(R3|LugC-JYpa}b-|l-Z}k`y-*k2O<qb$i3Tkqk*I(0y
zy3s{%j@(j4n!%C2{~cO${vy+05tFZxPX^Wx0Kta%L#2(@-R=NBiycIMy>gU%gCn>0
zBgb4@?f52svv~eDkI&W-VtYv60OkTQ+^=t_POQez%ukel{D}_9|GY%%G*+Nb#{Yrx
zLgu53gx3JU`#wXXPc>Um`B_}QH+y{tX<C05`<rTmNyiCZ$xi{iu#`@5s^T9^REj!h
zc>Cm-&@=u%ZU3w9o9E&NjGVjIjh(hJcwp}=&Tw9IdypkLf9jf;s~367tkA;aes*Gs
zfM)@O;D-5J$E?tN%#ysu$cq6^cdF%gOuOsqN*BbFRY<7#lMUz==kUN?3i*R9%M_ZY
zs)MsH){t%5MMH?sI7Dopt51Q0oyXJl`674oIZ5)`m=OU(do3}l!Ck&WOPSx5%Z741
z;4TtzA4$~Y#{h(&FudQsK%68K6sHj*RWhU!nBSfQOIaL)Ns3>E)i$uGHquq(`CZkW
zD(|Srob3IXqWMeL@&hsLh_E5}9GNvEkKY-!YdHqdKpf1gZf&JwmV`QMV2+PG_?Wp}
zwNBPS9RKGONOS|n6i6|Srq+R?!_8y&*##9bD`eu2)^UnFEN7zrbqg=RsXXsz3eU6l
zZF}tO2*s{nnHtWYxjho{F-uGFS9}0V_U~DtoL%Qi)zF}!823JUV7;4;CQ0#&$!A`@
zu0FfPh%Kol(he;xM&8oEVz8-8*JLsa;ZyE}y_3WUvz#MOBnoAUe?9yoc-WwWlpSQ1
zh&0_lrx`Lgp)UTfRS5?DzgPn@@h$NZrO={gbGsO0UppP~;z;Ne3?AuHNOwtuM@zi`
zdF9qUc_Bi8#ZC{DPXfjd`H<$i#8-&kS5NcVv-8@?y?QeHN#`=@Zz+B)>^HulNSnG;
ztn>G$qG9YSd3tO$LoQlB*JWX|Uk2xa^zA<^D_xiV3Hqr(Z_hey)7aC~L$W;9(Uzq}
zeSB`Krhw~re>`iJCZNUz)au=BF;9=_5Ej4Nw@g6PycDJ=79U51eo*h1P%;c1b+<Y+
zpjmx3?8f9rvf@Vx{qsQN$in}qX%^F#i?m~7ms-=rS>>yy+>?xZX*WidrBHa(4*O6+
zvolYyKZRYTzrSBb?Lj5Y|M{vlr6?QEXhFrm`Bz*U+WC)5)%|_;>*biZ4V3A&1?>UY
zS@_ZYr+Jl4*0bRp?u~J}Y@RqBp*+_Wbw=SUP>zuZ&foi!zza+xfm8YlaX<iKSbJUo
z1)-tQiqTUYo2gD5ua0Iqw~z0^5M61j-cAFiffDDmLwol%@ln4Gl5*JUGPN|Sd%oAc
z*iEQf(+)6VEtU8?N1f?C7Mr8ZhxSqPT(Pc-;nx08^Ndl%1eNUnRgFtFQ-2_1Sq%bl
zOHQ+<z6+Eifs}_%pG!Wk%_O#&BNut~VRQflIPMU&s%}Xq_I5zE=H^TZ7;|LZ(n<6m
zqBQRvLTEwKm_AYc{BT6{pZ?y8dBrN%Z4JUH=k;-^cEk3b9__6VHo5cDERJdKpf-uY
zB;jyCRi4vA!#dx_QU@`5AI5F|sNHo3z;w>bo2PRa(juK@1+7z@X@M^=pCFcd3Iuu1
zeq!KTt)L}p1xZoOCj|AYb|^!40JdTkG<32zjZ^-hFpcgH6oT~R;60#P&rzUzm8>2P
znr!w!k+FwY+~P!5BDksuIDIu;IS!rGr&}9iD2=x;{h%;rTWSiSuJqzg!)tCoi&{5s
zn6s~8&epKatFIQh=#F&d7pSV3-boZY>?(4pmRKDw(U@|9{Qk<PhOqx~zc{+k6{8LM
zkVQ*u!~|{c?*oP}ZLjNiQrf6M+PgHZg+eG?2|)Z1xcl;NX0efxk%#iE2UvkhfyeH_
z*EtS;J_=co_FpZCZF|$z-CY0-E`+*HuOSrTg8(zMAv&49t~Z4MIRdN<Yr|prKqu5?
zE{xQ%JqG|q6@BY=2TqHBd#=h)WM*^t{U$f`zD;r#8Lf7P9(YhF0*6(R{DGr^)s(6d
z%$Rz#Db^Lz4w>C9?F662)Rwuq?~CA6Q{9Vk9?hz*zHgaSsBY1g^1;8F`-6*qVSKNn
z*TE6~B2BPSCSs#=MJgFPS)xm$v@RnPn5spy&K_(I?e6T3aPO)LOIPy#CjFqzb&7<C
z)#!1VA2|5-Vo=XM=6Y);)jet;diLDuYdUpNfBOI(bln?jNlFO#Bsh>kyyQM=-B<L=
z7D;S}@^{@OpRCKLFANEohYL!=`x|xCMFw5o3nls4o+C^ku0*^Xn*u$7QT7KtJf6og
ziLJ;+)Iu(F<*D9sPphKG&6t-uSwBoIla#nJbwzIS05`zL$@x`tfuPMR@?+}=``H)0
z7<i`@eO1lXb&Vn^N8dgAW!XC^VuyPux9<mwiavYm_JPFw->6OKH*`eMFF7+36**r3
zB#O85JsQ=gPcPRNLZW&#l(*5Xe?FltBfhn$Yd<#>G!W`%U82-fB56DO{TAKI{Je5`
z(9g%|C<d`j{)O)=1D;a_8>JbNGp1N40DpwNo;+cOmvEfcHfMw4-w|`xW#jL#SIi}*
zGnJI|dpSi~@+9}4T@h;Y{lonvjfd-(bj%%i;tBmO$2*vp)4JCmedhhLP&S^fEQAOR
zq-p*f1CIAdB75uR+7~xBVZ3Eeip>xz@S3^ALWh|!k>J~%|I)lKVx3LAE897Mm6MZI
z<%2&T-eu{Uzz<3M2gas%H~UW4ptzU-yo>$ZjXxf<veL^2Z47Tz_TbScI%>P|2|=K1
zkE!sZy&7L8lm{G3H(~$TVKLaD3o!8_6&+#`roAQmCiMI5q%nIT16$tO?QBr+G~?c%
zWRKxo>PjaG(+@3G2bM-7PE-hRSx(gpVZ-?N_5FSD1odcDBU(QE{ZEhV=lav}MmQQM
z!pNBe`!_Amot=9lTcVCK8_V)WCGyc7KTxTGW3SkKJJQr{)<J*H=D+QB++O5dicQc@
zh08l~k)FvacP{c+^@voZX9Hbj6(@`%!)CsTe-3s(%BDNlWBvlSTH4Q<zMbud2BP}U
zCM2<|EplojKRWcwt@VaVR1%G$>hT8x4rAn>lI-8pj>_)vC6;ZZ)z>n$S8O=Xgqk!=
z)H(rWIfUwZchkPG6Q}Rbi)90e2kf!mw;xH~v2xq8bIt_Mg4mL|d;Q9zs<)`vk(=`y
zk>cZI6Dj{?qI`9??KM*X4=L}lnV~D1#I0Fq83fYI;6aLMt*wa=#+iRjAwYt;$;DzD
z!#Wkk2-^a6Y=sKfTg6$uV~W@U*L(~oWwIhMS#oBqP>#v7q`<%F?UK6=*T&-74IZfY
zs!$9nwM0-c{kC%RadKyd>Eq-#D;3`cw%d}QiYV}QC5qL%Y|IOgJw#>BC8lD8s?eJ!
z__E2J43QcKW-cHEAO#u8Y?B5Hy_4vO5m{^jfYd;qL*gaSTb(5tc4MR2Q|%h)H~WmE
zzAVy}0cx6NZDfx;DvFB$WbIz5z$r7P$09cEzMnqjw4D`rc<(wV=bghYi@o@0_n}G-
zzBl})c|iG^a|LLRBeaJgBTNeOGM--#A2;gnuU!6GP*Ab&+Yw=juZ?sx_^H(VVVn7m
zk6mOIBJuvj^kb4D0FJROtadH4jf9DA2F-v|LY%0q-%0MD#GNm-5r(dd4`ZRXn3|Yn
z_o83cMFM?O1WIXs(3|_TqeqMN+WcimUj>$FHm50GyfP9h=)rOG7N?!8AVG&yO|`iH
zJ@_b#SY-NeU1Yk))=%8A06fYrNj;oD^iwFCpGD8rt@@}4XrRH@^md^^kP$dm(MR_$
zihDi0)9%acxk&(zg7voda`5hS-QsvSLHx_-W$|#5)lWk4Ay@-Y&3`?Rkslh@XF1JP
z11WIf`InbVA2Y8E$ifj3ezefjb!BFAgXjU|L4ToLqat*R{X&g-g99<)3It()xF2aT
zegytF;wrO0DGuDu*3|Q*rLjIu<DpFsA5PTUME+A#GpvXGDXWu81J$OW`rl)gq!XOs
z)}NjY>K5mz(gqCd$vvs65Q(nv@%e7mhf0zgvz)518S6NmZxLlu7SGCRq(0Lt<S#%i
zzIh*js18s4O9Z5Cty+-id~jBSlZR23T;$J#A2o0e1P+!o^|tC%HSGFgebnxAEYI;v
zaJX}*te?2}rb&}HJ#Be?Ueh{hZm9e+QQEA1f@Zqt#SvQ!C?R^8JA!6KZ^fLm_Ts%r
zkk<1JYS8>ZUgEVTC4JNXRL`*Gsh5;kF4riDW!_Oo;j9{x<QP1**SMH53XlmIyMAe)
zAzB+y-pyj7SZ|?SAS%asp-li?iDs^VLtJAo*!}?%jM~#fOriz%dg{P`h55_j8q&a{
zFLqwktvK(-$l`be!f4fPZtfi@!mCMcucON>W@iT_Mvb$Wn&yV;j2;pDDJ-Kw0~B*<
zP@AMi!!^(=i3mTwP#KsDG@lmX4U6D2hf@UB>B71xm==KOW$GMwD_WSJ0bP7Hm_6(9
zR+k9cGUr$T<_qVN9nPetiZgbz;R0C`5<Q>k+M4@v$eB@3ZzdLrcu307L<@*m{Js)=
zA-a(6MihLk#aPSr>dDzC{rq3DvmgJCt`G1`3%{c#kqqX)(3AhW(BxNmPIBG<L<t~J
zg1zQf$nekLslX9p?^q=zGAT-N^`Cco>UzRvdUWD#Y<@m*<<BUW;tV!{grs~J%zdbY
z14O=jXT~(v)|CzRgc@W+`>{NNPLK1{kGo09Z0@wM=<H69-1tduAcV&uCgv64>i)3P
z=mu8Bz^?5u-E9ldJroqq%3QhQOT)#=`x_u;SQRTA;2l@!0IswI#ZyMgH_13LKVQKz
zj~B_LAn=bsB*=P&rQx-XwYSX;;wmh$%v+j>lauADv>mQC5j`vbl}FdNH-Zx4Z)J4I
zb{BX=7nFq_xz%C>qqOoOmQr`SzGuEyODAnS;JE3M8Ob_RpPY6E?5w$*^Je)KZeS=3
zWG%2xwz*A&mJyvAn7V{?R~~SMlJAb&El+Vys%FFf0hBwxq(UqTnsO!rX+2Tch1KSo
z#D`wZjP%O<>n#rFH|l7jJ|v0SycTPIMkGTbol(uT&i@3yXWD%?dP<ya!xeS928u?u
za5O3?fbwOHj2?m5rmfX(yrr4Ib^d`4FQu+N#EoWrfJ_+lU0Z7kt$JIRW74H!-M7xJ
zirM>vEr{8jgxe_dCqyj#Q%~2MPBVl%q^o6U1hgms_Hd9v6GK9Cf-C-^5-~y}&3#F2
z<2d{43jBO+#Ji`viv_H7(7+@Sw5CyVul?75CI}iw+fS;S_vAH$<A6l8dPe{$2S+$s
z&=V<VkZlWez9l8$qMoSoG9J+!gohNEON_-{N7N%G=^DJIOhLW}5A0vff<wwSMLwDU
zwPqKZ6XbFyYw5f2cdUM2SdEup$?!G`_d3v@mqqZk>g9tFTNd^l*4m|nWY8b$#_^Sl
zbqH^MHg>1?>4<Qb+T;^0$ID~>UUUkQTx0**fn2dE2eCl1si&zDoO*p>mw}U^ugDex
z1V!<!6jW>JhUWl_Id>%#I#z+Im3ThWMhn<M->vs-N~D@LX1I+;RT*8<FVg|3Pq=tX
zvf>zV=ect^;qiFOE%oJz_C{f2);N?BA28Zc(C1Cq(*sK%l7NL?T!%i$jp>#+4Q{U4
z)eS`P86(@z0u9T#XYE>>Acq*8qZV_zy|;Yz$MuE#2G-gO*s*@@+xyR^UTO1vG6`Dq
z!jGCP&Se=H^ZnCu8cSwp&NAq2-C+{{#7sqCM`rGscD{a(f5|45rLmfM7O7Iq+*d78
z<+r_0T6SJ4bX#LL`UnhvKDaUJFc|Y8QcQ1!?EV=1;)jUJ8t5xDRaK=M-Zs@pLtES3
zzj^rkAA0?XK`<{vSLD-bZhVGP>Cls1%rygi*&bVo;A$Xb8;}g6&)fLy%?F^K&)VAI
zJO~xb)q6{O6tCZIAEPuT+E1v4`+?$m6Y9gZ(|hhPgV!=OJzZ*0(Nsy(mqMdkZrP9@
z=b8_S)5I3oLwJgSD*|C*FniquJtIqI|F`6)FJg2-p(g&caN<SmP_Z4dF(xujxVs|0
zMac<euChht_Q?)GhUd_&p&|HesXs63$}R1+Y8Gm!C^b=#XL!O8n#|r)d|Kdpy#^v8
z<4-wFVh@<0xN*oKbIj4lEOQ;cv^*JV-eZ#@)y^x@pw@SWPU8#NumEbDybc=s9~Cs0
z=&;rvA}stwhKA!33=LOIh>{$W<@u&?yuFxzfrkoa@39~Lz9?jCInpiuD2<FIrbf98
z^dnj#UavOaZrr*|o8Yszu6%e~V9*Ewn)#qTP$^vPG^EznpdaroEX)}1%E3B6g7wMQ
znPsRlxqgRj8#M>~(FC2a<IIsU5I1d1@9oYuta_bh4B8+K7OOVj%z?a0*`R)8o%{yt
zq~Pafr7lDCl79&ugjhV+_?$yZT6j47ug$9${P(FU2qbsfA9@8{_!N=Vm`0p+8)Ga@
z;g`bJL<?$wj3WR%E4jT4f|<s;n3S*jT*w)G9pYllaEU8xsjFjNW<B)l7@BcR5)MmI
zzdM_^^p}w+zMDZMM4k($w+<IonQo<#{R7VA{(N%02WXNjQQ-BQ!!$ix0Ux2OHlnT;
z>1hqNP(r6^@OI=`vOp(?RZqgwE7?taJV=b9<Rcq5=10yHYNjeLh8zNQV-cU@%xQA?
za#_Z_;&*H9zb!!#mzTftyK|H-^kmqHQTXLm3oVtElDukPEDe-R$zvH^c~psq`%4Cx
z*GjD6?2|$|^jvQeR#zWqEA+WSfFCW8&XohfvIecb$C|Tu(uwdF-qwgLYpo<S@xSk^
zB&ZlmU9D~hJjMcp<1a36J#}T86o)BWV4*$Z13K#ctCtajQ=RUV=NYYyfU+V1go;st
zCb5kd_7nZbA(*fkI$>>XUDd~|9`3fav|&3p5{c<hw;B+;UD=wfXd2_C#07e{HqDdt
zMP;zEslX@v_uDh!r%TJ`q5kflkZa5Dzg|7g75`(Kz&#RFa4rW<Qao`-C(pwF&}b88
z1C(psvS^u;lOPsJhjiz2EZ_nc*=N;4U9v`~sGAW5?7RIk({T;#h2-;NY${k(slg#g
zxDka2=@4BDv1`a$?;_gB*ze>L#Ox*h`r3yM>+XD}Y)Tt*g%gb-A1h@|2bjlG1T}3c
z%$<CKbEGNvZ_i{DP9@Kfx9|GnNi)O_r~a7jRT@oe(t=gz$4WRDwm0qizrGTK4B^mE
z;HPS86lrqFo|m7P9vNYKzBH*3dpV)p!VS(WIHtPuEQ_)vE1|)qF%b%s8gyk}1{oud
zu5fo%a%=v8L+;GyYQcfWP`73FkEdCiC*qH)ag~9xrR%LM0BdrQJn!S)%&%azcknKa
z#mt&+Ki@w?{MFw5lLYy20lssBUTe=^g=*+y&kh;ahHs81^NyeZ(FsEfm>t_H{Qzgz
zOkdti-=D`9MO@BuMdti(#S38%$T)i<%|xsxX&VCvF*3hFOsKXhqFQ#c9joL8%@FiO
z*B@RUvWbRnh!4KFd@X8Of&&J2bda@bU%3tC=R7vJE1v?onESB#*{DGLZSM~R-BUm|
zdu5Ebr^njY`lQha0Ahu1NnB1-8_Jku15rmqC|j7bdy=g23g~~hHzsjw(5U7TA)ISv
z_33WPA8VEsUX)S=jy**-b>Ojb9tMxqsd_vqdbr&l(ipzn#!ZmPY4uaq?_K}tz`!&L
z6P0{Vb285o3~gBDaouk82`J07G~%vhO#xls?Y(&{rqsiIp~U&NRM3oou`I@Z@;sCy
zta0g^ot;kC2#UVeJT`_Ye=FkXV^LdF83QH0YRjM_rfDpn?Nq0-mSN-E&;bjA^B9Bt
z)|O}Rm*9jx2p8<1BGUh|vggBjp<mQl#+s^Zr2$RWEp~XeIk;>Y-Kh;36Ut`b`~7kI
zT;@RU!gRrH@qNF1@0SQ|p{#&?7>f`pGm7x7L4W^s?8Z0rzO^M0l52Pj(3by)ueXki
zGF{`wab0y?R}2;@0Tl(65)lw73lI?ykWLAa?vBAVX#@djY3XKYq#L9Ln4zS*hmQAp
zX7C*MyubJN&-t8{nP=|j&g;6qaUZC|;D~~-8TbpndgWP6gI531E?j_Z7y(;}$OJcq
zIlcy|GhDmDqfz34Tbu46Jm~@=#qxj(%kIumso-`d4E+wn!OuR|dp>br;n_<DpZz1k
z>LpnV9|TVle;pBnJz686XGs0OBJb%lTX6`hNyHxBdu9@LyJ*$z-13md^2_WQQK=c?
z5B-z`5u3AS1>C?B9$bE+d&?FJeRmwCBMFK@k~AVVipbWWVNu_Gg(d`^YS67EC)wsZ
zZ-yMSK=oIE<T=j-=I!s}DXc!5_>+aA1Alc8H4}HWeg%Mf8WP{q>|}TP9@`m5m)eLt
z{Mi8?f5l&BM<Th(p{mvpBd}3fjue6k2?NPxx_<$1k5-~9D!MV7X01FUM5LZ%i0$9l
z*&Eu2{odc-yT)cD*M5*a!81vaz-S&u24#jX3HtbhF`SGf^So%bhw8#mQ~e9%ImF#Y
zSrj_>#=xW8z3+b`3POJv<ZmTrBEqcf>)yrg^D{h3MDYs^5tJwP7Ks@<saGfydlaN5
z-o@l;glD;){IwHE%y4s!-Q&=s>i4BK(upkhZ*;%*07<^_#Qw>k?$$0YJ|f1aN%QMO
zBI&b)p>v^1-i%MS(C<D(Ji&~J0wP4N2yJzB#PCeAu}ARTAtkbEzDfT26YZW4v?q|4
zpg+Ptvf3`O+(7lY$fT#>De+me2kJJ$vo0BL>^4SrGHkZDl&$h!NEGh(R@{1c!oGNy
z*D8=0I&ecb9%vIm^MHj<^lYX1@V^7tUjPCP!IO61G%8;-J}^NPj+Iixo(uhTo;~Wi
zls2Hat)*a3a!e=P{>A1wXX-`QjFq6@EV~0l`=_pit`Z>O4EkSyybql-<5Meux-$3-
z0B_>>$xR5j_!(BwLKHy;g?j<>#2vNgED=+T?J^qRw;pTA#F+bCU*1`11@g6Bt#>fy
z8d|~c6Iu5HSGPjaY(LHE(~B|I{N+%64k*l8sEdA2Q~$trii|alULaNKaKzu_F55ub
zBId}1XI}zL;^@gFr2Yw^tldn?C^lCD&KkcXkjiAX#DBG#{QfLld}pdHCKqm$2md|%
z=qgf_zY{RJiSLetydqzx{_4!%VmE5C+rt3fIDb0>2L#lV8G(;Ley<mLevkw|N$YDB
zEoBzNtuJVxnjzTe@5$6qNf-vyR3^rf#-^p2Y?t*@a+38QWp=^`>v`Sdf3nJTMdo?l
zA}g)BjR8ZH?|#D|=E!kIzyPK*u}NLb7^V8oMCY!5kc%|+WS;@WQUnS3fLMQ**1j$J
zNb?9%YDHc{YvvGorIy}u%)AROMVR^9{K~YF5_q2DKR7Rz?@WJWX^&f(A1LXX!|@R^
z?!A}h&bk&?;%J|Tl%bB1&Vt=367ypc?e3?3cs2nr`hHW_*uA1m{nk2_A6vHwJ6*ny
zr)|%_05G&+wM6ZN9QB}}+CotC$1_xDHg6`8)X%Icfl!=OrT}A4-P{Xf-R{b3vr7u1
zF5^v)XN;&NAz_XHvKvswUydLrLH3IsF#EzJUw#fXo$Cs0D*20tGX=xi4TcMw`#l`w
z0U2$gEO2(Ljh869WvnbJ5DTQfS42qka<>Ab!h9>kAU<|;8`xip>c6}Hea-hP#UbD%
zv!O`C$7a-o=`t_U?@l60UIK^W+iu)|q9p=pKmZd~Xel$kpf1t9J*K)#Bd{$yQz&~!
zexty+bU`EN3{{ZQjNI^J;H*MUsQ`hYeZFKUMk-Xm#VHt#wskuzd>-IrCNPNlm>mJ<
zqV=?(&f4s&to0w2LfMjWKQ7N1o1}(&I^pFU@n6^Qv^wDu75VCn1*Lvpdw%Sxl{$H<
zCfhEwU=s6@jvvLA`y-o)gTm&>d#VHZ$RpBeH7-J-md60;Zr#F;YnYH#mj$^&yh?|Z
z@Ln2EoWH?2wf&~(ByteXZk5b}GR7eL@KLABBZDruw&#iD;OM*s3J>sik5MhC1=iDI
z`7u+3EIzXakWD{ihqSjdE?l}~x3giYL(wXruoZ4gUH8Fy3C0EB=jU@+^2R{cuHsFP
zWO*;n_@k%h*>J(UmaceZfMop>owt9>T>>fLNDrXD_<AN&&?nnKj#M)X8Wj=G4OP+@
zkhCF^C6KUTH2!?j*;`-EW1>1Ul|Y}WUJ_<xT;sWi{Y_!*>hV*9g7y}sxhePG-puNl
z?^l7Ms#yG}i0?>!q!2pHI{Xg#m}z~Dmux4wR}7aaYyE;~0oB+U>!sm4#(e?VoNJdv
zudECA!xge}*Ktto$<3{+n^fygRv4>iqPL$(4MM^ywf+Fhk6vFxuK)~fzZ0ZU>VHqD
ztbF{QLd%^!Twh3{?6$IP?3D<tn74-ay%%F;<4c!?Y-67IRYOe%M0sgi)l7i@<k*_J
z=JhHXCfG$Zrq$-}lJURWh-}OhTpqEfqcR_1$w$e-bf$Cos#*TeW<^DwzN|TjdlMT$
zr0vtH9_2#>m35*ENq!El`$%-zb`B<X-Rpi^SdfdG$vI{p)SyGPVvIp`iR0nXAJ<VY
zPpSexl+Nx#>v*#)Er($>B$@=_PqtpGa)|@45+lmd-u@&oLGzsPfvfK1Lfwh7ZFcH^
z^v+IoaI9HxEMCHA)-gpo#ey<`6PV}(DGL|hizbSjcu2{Gh2MTozjBO)83Y6rbfs!I
z>wj{i?{Gu+7?ec=qK`F#Ya|iYT+%b?T+Nm+O8ScyyR(Hh#@9xms0a4Qvyi-BL@A=0
z+5-gWgut*V;c;Rj_^ru*eaZ-=+~sx1T66#aH{Yjwh3sz4IG*mqVlG06@aHJA+;te7
zp8Gp`2^b)KKQ_5i8-6TSnUP{_&lq^Vg<nS@0qQH@s<Bq%2UfYJHNI?ruZw>VCUe~o
zg+{TSK*UBXVGI%C=s)TuSS4Tr$nuGeibbtyoqs*iB5=d3Zp4Q|p<4#o>5&51<CT%?
zdlOkRVzV4o`>NdZ&v#lG$k$u`+3v0@S}4747|3dg4}F#RANJMANw)u`TrB7XB`yeZ
zp(NYRQ?&}+*up*4jl)l4KuNN96`)@GDpH!YK~bkX<4`sR1k(V#f;L{6<I*KX=P~VM
z`E=E?Ql*nek4UumGbQ|W^!J^Y1Emh)TL9xtGzJ+$4K|3)__n!LFM|*N<=4*JHXMQV
z++BKBI$qSh*|i$pa9JqJw3kbPRv=5TPC1~IO}K?YxVZ?_1Q`C8M)w3xj--=&P_XaJ
zW=ny&;a-gw>v(IAGbk8=Kuk%2fXc9{ow0>)e{Y=!!IrwZIwU3jN?bs)-G#hhT!L4v
zC#LVQ#aC~>^|za9dkDaz(v@H8E1P_b-&{yCY?6TixZsMo+>W=f0+*p$5(Kci^WL@F
zcJiRq)6H<eTYy_Z2uI9596(UjWJJ6E<xSTwuGWUPG>>r*TTBTz9~?)jlI^t#{+Pa(
zZe=!DP%ed6q?hfDt}Ye?U6qcNiGz!McUV;RMtlmuwcEEGSfqV`C8+4Ts8;W*+6cG_
zyvvVh#4tQrv>#nlGTW!7x}5?3lshZj<K=L!{p89e+Sb6H{b=Q^3bXeqx}dc6M)I1x
z%yaG{Nm5Q4U=sl89ftv;!gxrRNzN>&|0MBL&yi!T?FQA~zFoA))GT-6F)`vWH5jdn
z@aBuu;5e0pjs;2rnCn@3l}8BR8irur7<hg)1~{?BsUHM;yidB?_!e&YdKhDiU$A`e
z{EJOG`U4uhUjF(-v%)j;OnIm2L>WLna#{?euNcAtOI3NaIGbk_Jf6QoTDm6PxS`!2
z1H~0<5krh8I*sS7LUml%;fQ>Cq0Lcas?G6G((#!Z>X}~Nh50zEsk0NU>0Ah%0&6~z
z?KW;I0ETWKD?1hQUD!;Xu^*4f<($X$l~if)y?vLaknlxtW~$B7w0AiUDEO3!X=MYH
zix^&nlFty<g$J@O@TwT^?*S9iXCvNnaTlQUnkLy_pQL`qbE*cIXoT2+BwwP0a~x3{
z1obGJe|r}-<xr;TD09p(^kwY)sCSkK0xWq+Gb0MKsdoFu*YaFfpFhWe5u{q4(X~yL
zWODF`yhMS^GmbR|k_!3sa};b<+D}Wa2!Lc_JYZUu#k5pukkWpkq~_*wm%?0gBS>n0
z+;CnsZVp+p;D9xtkoJ2bux~`_>pa-yxiuO;c;rUoDfYCQK|Y;z8;VdE*2{J_LF~s8
zFGa~EE9BVjjJR3*B#AptCr<KRiKvn@*T=gu&5O$Il2Ug{;NrP3*_H$S9&2Lh2*qLO
z!<op?V~7TmY6rwgUBcb1)n3zA%Cl{1oI{I(HVhL$YMUtg8OS^xl@lg=HzM7)?&9<!
zch}F{GLB<z)ur(7(f%+~kYZf>-;ShUp`8D)iIQ{sFB>$}L9dBWkIc-CW{#9k;ZF;v
ziIo3@L{hc=J|WHFG`k=F?mDHPtA*5pt04gVUYHBZ8VE4w!a2^)gmz~si8g7CgPMyg
zf-3|{W=UM2Af4vfWPGwA?^X9nbrtWmwCyCKnnIpxnnKfC#PbCL5QvUJH+#R@UFy#8
z*YdOceD$kSyPfPuULf%PXirnN$naoHA#&l;%aUkbb2(LPo5Qe+5oj@}HkWGmvrRgJ
zzxVQv^mrtZ*LrPZ`M-9#r$siFD6nJx+d&|#OqP5O=yl7s<GdfYvASi|&i9PG_JD~j
z5A$ux;X!Za)|kuuCk%}&_SpcSINBKCsEQL-{V#jZlPB@l_%j~LGHE+`S_2EA`Aax=
zzj}Yi#@Bf|^^*(JP>{pIJWEC=<SJ)cjAdDv4}DV<{20h*OB$@4Z}x`JQy8sy2use}
zmMX$!#3IT~v~p!GYMnPXw>Oq_Ek=)=80Xwi`NF#{!z}XfciZXCrp88QKp2p6TbL1O
z)@akZG%?w-$4Nmio6OaDvHqiBe<-u#GqfK|M_$U6G<R`6WvM<Npcq;!y4Zf7!uD3@
zQYb*Fx^-+InPNtXZ=|%jUwkLG1G@UW?ba0BR>8ZlP#})Y_1OCwxoN47eM}MAm{v8X
z{Q<?7#_!{|$dZy-zYEI4*C{DVE4;=ONI*d{Y@xFpy?7#s$bxot`(*-+PH`Bw<6R0M
zq(}{qepsWMx4f~Qs^G~ruDrB7_63gE`VkvIu0bh`+}=ywZ6Ms`g`e$}$8~}YLs$1#
zlL7uNN>6;Vp&`c#2<T`7VLZp-jIhXoQv$Wav5qt4Ymjrm8|bOUTd?O21G9%kwktWP
z2(BcgcAF6ABje|@M3iij@-12&@fx1y3Tt1}J`b4&RKs!;opIYXhil_+wnL<59GVsu
z&gor}FT-5u!nUqnqS%V1S~s3oA5IS+J#-=4BKxby`buB8t<WVSmm~vbH7B;BvuK}-
zdvp2A{EsWLGin&u7oaFt*RVDhs+gdKRK}{NoxZ1meFw$gCa1~I5o-V>^D+ybyoet_
zfi$zp9YJ>O$fHS0w@@#n_vFL1AQK4S!Z6oRTc%#sZ;OuLH-SKiX&)(DQg<3u3pxw>
zdgK}^baIpbeM_l^Q?~)=YUi|XV0h9~t39{$(?H2CBK-DcXjgm2^VQH<0f!v8dcu{s
z*QXjjn~#I*pXbekl?$zMIEEcgz7XIuH0Zp_Zs@Q+Z{(SuC2GyA3#upZ55O2xOOpqc
z?VrNt+vLDj4+Z_p4C%!(urV>~O?YavgL_3<q&P@WyBYzW^V9_z1`BB8-y3#$;0ed+
zJQBg0Jh0xWVShT%Y8jM}z`vm5)E0ePsD66OlD9nH`L89@Up6D;Fj3-l+2O$?Dn3a4
z@M&cF6<IfFc&F&A(IHPy0&s%OhjKl!E}<DcKt)WUV&p$PAr1Z#QvKibsR0P`UDqW0
zdFvel@}mhrtn8_NU;|Pu$b$$nQ(GKDPq+rYM7QzQ2qJJ#S~P^ao$R+WOYMzWU$CiR
zeZc^l>O6mbk$oK3t5<Ds1-VPY_l>(!DFs2wOJK@S-w8wxea|N$ojCIe38$6NsZ5iL
znCv2F$M^Ql%<0ekxqvis0~8zDFDJM7?JXKKL4O9zIFyHyYICp}JR2H9KoE12-AvgV
zL$)4szU%O*QN&$h(=IG6{9qn3POFY)vcC49@Oef7MhxA05%#bLH2zS=YY7<Y^`Q$K
z-EwXGLRTS!XoSl96YDu_JLURh!8+iLPRE*qIUgPM`1_jX-uUx5d5fh278MgXiG8G)
zW<H&PiHn(|%!XC1%70>A>-~1O{ltt6)X@d44c=N`$3SxW7TCdceZ}l-_B&pS-;=k_
zn+?)Zjxn)&dOW`6R$MJgh)6F8dKdk=B{HrfXl^S@;5ILWq0Nc6N=s%UWuLVfRD*DE
zb6L1d*J#g}6-1kV(Ngce3V@y=rR#HsBNQ0IpjJ)t1pf16BuYLMO+SO%%{<2mFW>Z;
z<FzM`v9cbL*!E6!Y+KLwscwrjLs59T@>4~tX@>pd#*$9=X~V;ig>22CX`y_4MURQ+
zQ=x8+&wkAYW2+)sQ=kas{pVPffhdFp4VY84d!*czK%g;!e2vM*$3iywaV~(MAPF=A
z_Z7H|G~K9IX1w9v?r(8@eEy91z|bY|i81JNKvu(;-TC-d<-~kDo6Py@0Ohve&zANh
zUXwnf4FX7Tz-RUHx+oq@JjPhgn?GYu3$s>57jOY#)~srKtfZwVR~GU}FO5_H&tCv3
z6IAMa>np9em#L|cA%NZ=E>T2y%R1ReK^~a0Xf%3FEghp$A26}3?IXZ)BEm5($6i*s
zGZ1!w$r_F-p_zu2x`6DAciReMAk#!5oZnXB3ALbqD#<7|bnVpX-rw_be5hKMD0O&U
zp{L;cw?6B!L!0aWoFu0C7Z_{Re&vh%<8q@LBC^Gq-gz#RtR34--!WG6)yz@mz$h9D
z*8{{d?QHg-@*P)`K(ITWRbTIXwdYDp_m%+u*|imJkdE$eP8jFt!v15^w;3<LB5HuF
z97H?36(KXWIT4AR`>6f2>FD!!`BgF^!db39y^x;CwFJR?=!w6&*C&ftxZDt4qrAJ*
zro|kN;w4MIy=8LJ@ZT|)Kj2^b@3`ztM0SCRuiaD}3iVmGx;op#nw<^fE*aE128=Y2
z{ocUTMMVgfwBrXOVM`h*Y)&;Vv1tdHXDlEg2suS<VRf`XA#wRrrXY|gYit=*6he-X
z!M?7}3`LgK5;*s`%O^fURzc`kpp`xjYH^%s;l*NxL5%Jf#ChFdB7vdvwORK>%xHA!
zZ}|&(x!aO-zB4pd-30I*@!oj$Yqxd?VBFUuAZZRkePG6b1d-1|X9?&>IZH5`Rq~#M
zLXMK9t3A9GUj#&pdTS`07|<0v@jg15+uBRni)Kfpl^qG|{$6nRTW{evNLLu5c;>@x
zNu|~<wUthMf0R=D!ut;23eB!zx8!Fb)aNCCBiNeKvT@n9LKlW=^*gradN?@KBCm*>
z`CPZa&*Ag{pVgf2y9hoVifD%8$Ab~%1?W{Y=;tY-GppZrZ=3XWd-n*6hYa;r7Y2d-
zd&5vyGEMVq3v#MrkiFYOWKr-{7x0-Cs4w+70Kk$}uIR&*29cLds0vy4$54jW$N2AZ
zZpjqgemN7RAVe;(?Hnw!*=z~Hm#EH+OYD}9c#g=+xJ?u|EsrjP^cIt{8HQIDX?h!o
zt3BPC!raQBSFHE^<a+vLVoH~b5kiWxRKlu71wV47#(qo$Wnw?pd#vhT;8pF(s_iav
z2LVer>9ROMFXwyXf0!=7c70-9U~h>eJAnV4qE*%jzjE#J9FC_R3|gR`ik3VxT)e^=
zR$!sKFd$IM{<jz2(&F-4rdw9d^?t&TAyDoo)Tc(tKeQ+?-)UM-P^s58Ro@G0N!^!-
zJnHwF^ZIo6gmPo$@_M=pv93>&Nvv@*a)YLuxitl1dc}lC4PrVvi^u4TIh-AYKo{A<
z7s(4ZI(P49+cKGPckR>HE;RM5M}N8$C%nAke{1b(?B5L`m&Bv4KFo_2OFZ2m|H*H+
z<sFr$?rbIH>sefnmorNx<%^R2{fRrgWw`YwPsiFm4$Fm^O*<h6&xLiz)|>Og<^%nX
zKIiKvQKVnwo4k69?d3b-tw)BrsS|FJ=3bh2^El&pPH?rbZ|Q!7F^%o#^*0w2Ztoa=
z>0_l3!0=z$i@$RWNw^*XRjuzxZuA2&iT<@dOY$fB&fgg8Ur7rVd^#=A5x+@UM*Z}7
zu9is?e&)xuYx<~ps~YI6H9ij0x2SRli*yy-hJS3&ZENa$(X;F|E$qFD^TBP0lDi0%
z{ktHX{{b$3v<+R!&pQ%M1>N3Sa(LsbN+DF%wyY^+YZ7Pfp05reRP&nCZc%T{yS}kJ
z7ybsnuxQD{>n(xvgNDZFJA_K>BYHwJfm3@L>YKAxFSE+}dYwuP=+2wUPq;cxw+A|x
zMsV#ecNN$S<sZD+zrXUyg40|gMyiG7qym$x<6NETiJj%HUf!2}#2=_T{mT#hK@wtk
zOzLuN|5Kuxhzg`=|G`2C?IH2i?{qf<1rW3cbZo@b^(H9x=KmvqBmCRlc;Ni0O;X4p
zoW1{)4n&cEq)h*cAWSASKQrIk?(p>rJ7Gj!W{v~Ehwy}N((pqX7W;vY1%2IPbnNSn
z1?!F4cgvdoByr_4YcJa$T9z@nd_Ll)1}#B@N5Y1*0)%QLBuu;8r_xyWs(Qz|?u1AT
z9II)OCP?K-TxZ~gwxa=-|0cG-_xc1M+Mw|tnRNJ!c!U9Y(Zq*4L`YH<1af`dn=2FR
zv%O^J&Ye4Z_U!4?H^67S3}}~kNJ!=%s&9{yKUF_A*7a1KY%D-poxUsR$xz;5?TL-?
zL|tzCbVDr9HEzjpA__@p88agz<Mr#;Z{C!dpD!;jcX4rnvp(Vwyv)aLLHi@0y6@R@
zed>N_uluQ66n}+mqikQ?t*l_G|M?4lbZ<;eT9hnHV&e3l7be_<%-7!7zr91yCf2bS
z2<N9WE2N$0voQj<`5!-iL`6lx^A8<51WY0`re!Qsy6f_ttLg8SL$0QKE^mD;)v1_M
z6S8@s)J6Kj-}Y|X(YBTDuN`+K$uYy01%vb3d+gSP5%9f+41hwqdO(rgvuB_Bx+^Oy
z$0X^`p3Q>svAvY;y!_|Y^w-M<SJT~=8?L7NOp7!2;R?PtuZVN!xdab$8mG<k#Y-OM
z?MnQDw<tTwve)3nS$v#e&zf}<`d7ip$?3_HCstNg&z^O*g!3^lFjQ7l$R8pZk{r#I
zQa?0i{Z#$r7?-p<)fisdx&93ePRJoJT|pwd-f=f{*Dp<7A>mcn_026WVIQubB9qRC
zLe>QLL0=`L-N%m~ho*bExqal@f*We0;SyQkd(i$rTQ0MVr};5gdMmWpS-^09ZF6p)
z<(%~q-`8`LH}1`sFelj#JKjZBz=abqhn?eMV=rI6Tvc1EQR09Hbe@BQ1MKL9PX50}
z)8yLxQ!7okcdx3|1<7;N!w*~J^{BnyUB;~8lkDwhT!<|<qX2Xsek1mW>g0IxwohWr
zT~fWwl$4HUqve6MDN1X?kek^OKSjbeT(@wdnQ`IEO^HqJr^uqIvp5jND)^fHSl;pT
zg1`EgMokl#x<hHw#HFQr?_t7^7yj#5#*!`q;q<Qj7oxsz)PVwH!s*z#$gapfZ<a&c
zPwM_8KGe03m5bxrXm1{Tb-;B0DRD_D0lbR*v~N-WZL;jFwf7gvaq*0di3AdbD+_Vy
z=hF&aIm=e3RbYNcgqENr)Im(rz*WyHmhrO53>TJNBi!RhQ72*dgi8j9EuFtKUza$>
zUTn&3zde@j=p_GhefkO#zs>saSQ;tIo_p_TN&fxDMjYu^B0GQtHZJ66R8<YM+6PN&
zVS)R3r5<BaD@jX38cRZwPprFr3qV#vwMTd=y;DfKBr=DH2>mxf!b`h0-pMsngMov0
zj;<Xn%+ZZJ*djD}h)p;W$9Tnbf0k+PwG>aWzztaRYQ&9l=nvutx>SW+xN}4(W{yRU
zr#det*iRF|K-UrCFe;D<puF&}rRWV^^jGMJ6M^J{Eb)&NRyxX0hsO*Fx1)mA`^CW!
zTD%XPV0(+Er$!B@5chF2VwaHIoj<+T5(LeC7x=o9FuJZQKfm;<!-MCu#K0lpX$_&4
zBEnP~qWd}YR`uP(uN%2|LW@uB8Oaj|xA&ie!R;{Kw(^8tt|;=j!X+0@FeB9gHVD#{
zcfD=QJ4`fMLtN|)HG1tI9sHGo@Yf4Gyt!umZ}GS;>2KC?jEt<QeFHF=@zw0aNqK>W
z*tmiR%efnMr$nH6<zpdC)isG7t{&Kx=350gcKbr>hUSL{i`$FPF|Mi?7>#OSL~e!_
z@1DT$-5%IMo%1OC%}iKfoqnZJqkC3*qylSv@EeZA-{4g?kXiPAMdn;$02887!)|}N
zRD1f*Z*od3$<x+BjxIXrg|2IaSIUba%pZ$1SfxR7bDA&##}ji6C;t|=aED(}dyhK#
zi4XO?Qo=t?Rra8-fCLWTt#gBI`dCd<p36>5z2lNUE4v9cHH}0S+YCxKkFrba`;)F+
z2Mbc2*!LD;GqtU0CW{|?M_GH9+v-MVcsj{lle1&v;glcfEEf$&+C<XFK$wzuTP$YN
ztFfUu|InE@yr>sBn6N`XALeU#%zN9R3pO&I9O_SY9P$T;P`)U!=fZRsJ_v!BA(~)V
z508~S*fR(}GVe+pal(Imqy2dpBmbFym^j{qKato1pPu;t;D3imiO)9j3;7&NN}T_r
zXNk?Vxt)E>$^30#!nrhACgL|Nh)?=fFdWlrY9!EOv>ce?SdxC{WInnxc65VG@4!R6
z1!1(1klgmT!aMe@hxd>$4NMQv^ec&U3cEVu=2k-a??^VOrAZPVYe7j|aM!fB=T+s$
z)aE4IX;e;m`v|6|k@O7&&`P^(PH#A1iZfh_4mP&u#8$He+Hu%ecAGZSaWye6RFf-5
zC{e>cVKy@&6(lq$O~;5@r%P@jyp;vwstSj|j3SF@{E=q%UTFJTqlWFef~>3wW0E0B
zU)DsZK4yB?4eg&kc(6tC0;2)G<ja*d%bx=~BsL);&3LCi_pAT(pCst&`8z4jJ5!rn
zIO6Vi*ZU#it#!P}*=@K(i(fa~5_qm2)p97~xtOGqbcsK|dfwXk)Pwe1C$`71%BXMC
zHZoI8Aw8LlWY2hT9ThAw;L(77<UKMXg*5#__rXHfiA;9%*&0hXT>ENnq8oeA73GAk
zAR+0k^7Ersj`4uC9=E-IuzvK2tARwve>X-Co(n5<#k?Hpbl;hS8Io0*d$@M@grd;i
z>g@6#2WxfYVB^VpU^O)DdI`@UL>YB3R>T=_fx-NJbS3VTmyo%9ILS~x@Vk(uPvADW
z_7SJzBbAD`jW`FdwMG@3(X#jCE!BewZN^00qLC0lVDQNambI+j(YYBp&gIGllQ3^-
z3gSFG*y)E*EcMq!T~to5n#pF@t7Mfb?L$8#c_42AivWg5Gfs`?G6butjML(@vz7)w
z3Vro(24$7ssnyt0wpD&^>uJza%p+YOYQ1<_LDV_1GF<hq!Q3npo;fsnG*O;uS3ZgP
z;Gtklp{ZL;Ee_P9(dn=3){iuH>Md!MPqw?5o}hbqmaATf>za}p;XEW6T0@?@dnu)Q
znFm5<KgS2DpO5pjs{MIYM(B&#ZhvJwqlSk9k$yp92FZ)2Fk<Ik#dSaRGjGB_m_dF=
z>4QMn^(073+z~$A2g8HYnS?|VPGUuA#K7I$Ycl<1f+-(r55lje0EivcOQ`ATBYk~+
z{rsX!Pycoolcm^6IMnaX19j||Z{bXF*?LkCu0cdKN^b*E55!m!j~+eM_~X!pnb^KZ
zit4G_otIGu0c0bLzdRvTP-WO+#wOv2F7@DeNkvXhPD@KmMn*<YpHBG6&7yTh`*X_5
z1<nTdqYox!Gtwml%3<1>U2@}c<BJzBE}tq|Tr}H6t3gP*voa62^-Q0LVt(vaX0O@T
zm)*#nNJbJi)z|O{Igd7{ReN2Y63?Si2#s9Hb1&5&2Xm9^sVkg5l99#h@9Ax}of!55
zB6T0uczJ+_dNcHmrRj-3{`iBGl=S4ulc!D%LWu@m7yRO(ZwdoP^J%t4S`;@l$u<R8
zP^AomOGkA=V|((4ESkrn(6&{P2Ww^>)=bJ*^7@j;6>%ruCwOb%qKi;VTU)!|DTyv7
zG>D6d!|H?=6}lNf&(>D<+qV_>>?x?Ikj^0^i-BKrhX<Do?s1gqXwL<mR?eOYzCzO_
zOcKTz-C;Htr6(pPM?8B9Am!7H(|E(B9(kootYF9XsbZ*)^GX+H!KE}#eJQ!CC0&?j
zKh1epXis&IS*Y=YCpgEKVl9{pQq5ljBQP_OJYjIH8_EU|0(=)PT!7e?g~g~fLI8qV
z1&u!}%c{f`Y)^$!D@I4zY$dBto7+^sus%bgcPCdfm49pJM2Xeh&~f6TA394MG{0~+
zzAP={6_fqG8GgeJjLCw~4$f6K`#0O82^7R0Fy#5fT4&=)!}KQKepMky3C%mDVaF>9
z%bo9-6zNs$UA`r*la6YNMG|Vif2%i%C`)l(HbZ6?A<Q4Te(*yQV*Poht5?f@vrbt@
z-?!cwSfI_YNXvZKbRkRK<O(_fenZDFOTwD{&1oKQl`eN!RM>%q3D=5!rw^-z-CMAA
zCbIqJ%UYrAWHN`RajrlIBl(Z(3E~KfabNzS)f3WP_;USL8IRB(iUO@Y)L5#5RHJ*i
zPe!tNMt!sws{}>_bB6=M-|w90?2_b8vELV0SxaOl(FxK<u?C82K>)eb#<oG#NZ1%?
ziHkQZe1=J$HLa(~fv0FecfWqbQ{p+}C4wEkZey17h~)8$CY0-m<gAH_7Xz@yFS#Zg
zysui5-sN@|GUv|7$2)%UY5nscu}uRUD<fL|vSc%!EcslZv&6h+sZ<#i<(*o^(=P<0
zED?MBUcu%|7psOPbE6*>eEdRssP4tN#t;RE2FsRr@~=AyagS>wK!q@C-B$d}IE>7z
z$1#$b2Fc&N_6*qV)_W(}Rk&3KvwOm%9$a~oFPHkqP=rUn<>ic?#uMUYfu}8ni7PE1
zoP3b&=QeX94pWNh!d?^XXu1|29q6@}<=pE57VKZ?4qvPahYjgMD1_hR6<c$}`1Tt)
zal@z*>*X<s#izmTvtUr4tfqN~YGm88`&IwIJht!$&P&5|U*x@DxF8Lerbv(K$YWgH
zTJD0<CjshHuTKvP{s-+uc&@PhR8hf9tVq|S%@#e0^s?|5><N=oTRjv0GN%ICBQZu}
z%|U4Skvp6`O`HQyeGY8sslkSRn6Z8i949+CU_MF~QzjG7E|MYj4t6EJg=l}v6GFSc
zcOL(C2KkZWj>$!Ri8}*3-xLpB56*4dnOzB3Wy)E7qJFE(P6bz2s^gQTF;af|e&6K+
zH0VXG_v3BfZ;qw19xH>8;UFm>ndjQo%3Wc*!;4<*kh&XAavqG3viO7cNpCuK-k?Y#
z%eWJRrhGgue3XB)Pj)L?>FB&7a|7Ygy+upDs)CU3qIQ<7YrRcx8BO-biLYd8ZzseW
zaj_LK71)_KuTE87F*m32%6_Bs+(Iq&rI>_3uI5})ki*OOb3teuyCQaWQ@$^0g!rE1
zTS>e|ip_v9)5JNKt>a(GTp8eAia@5F@CXZ^<%Le1;@-8Xn?nzF6IrxvQ^>Cntl<0Y
z9tF1)STgT#jLZP}EYF~8ad&-iwmZENZc-#W%T1&3!uUMa)M6O}!1~p)%upT%9fOr|
zrNhT;3_9YMKrOSoF#;9Fzu+oK`@}??Cylu}(0-C>+m}Wz)+pW2x={ccoKhDCgMSu=
z|76WQOv=(`Ry#2=64RPILp*kUIVXeE!)@E@3*JV${5JhNl8E``isk2&v!iIU^}N1)
z=dBrU<sN5!wJu~<w)ZUlnvKR158thY{gH3?gq)Xbx-mY2((*KD@B|Scy2{raw!8&B
z3)+}_uYTLyb9R*{zs^s6o`1m3pGAyu4X&yFBbZe>dNN*ubIb><$isO|b?#S;pAvFX
z>91nlUT@_wsj`ofzuX(BD$QIY8acSMx$*7n$=nBOs!_U~zYii2zcsP-bz-YC$t^{b
zqkR=pLWit>Gy5IREbRG^oA>4=U97Rm;gJ{nOE(^&=sG?*eC@0n(lGAcFbUt64+^A<
zptI?6=X<SNmSxL(bmSH9r;QDX^ipMUz9gGDb+!D(1n2E>)83nU)16U3P`r0kKtO=$
z38hYPRJfQ}ufyu3)=1GQPV}HR?VxYs+MGr<?fF|@vk}RR>Bgdu?c6dhn+eM7^l%?H
zI9{K@DRY!C)K@%Z_A?SEO($m;o<C{29=CSH-A@i*7^$3r@e4^hm`Hb9V$?=&LEWTT
zn%OU<`5n5bvHzOp2D+xDmHQCx^<#l&k5P1F(0>1O5*%rtJR|r_)OB3V`zVQ)qIR03
zaiTu*7LV+g?KZc(W#Z40F#xC1x+C?S=~zQz4Q>FD(0`ZYy;QL^ejle}Qg)KYq0w$(
zU=IH=Ki>;z2tnob{_n5i3d|YqZ#z8`e<$kqmM|LU)tN<HZd7cc)J9WFpwt$Gp8pwQ
z`M%bt;FW+%l4Ym+<rDrPS=M{ICsT5Vvy_llm%W$lj;y*RXQ;r*W_gQf_j%rJX>qn`
zyg57P0X26@s5!<W`A71zspCqEow8#x=Le-7bk*b6x7)?LbTUi_ZSfyLc%#1zSi5PT
zcf_jqWy1%s)LD6p<vshI?P|Zd@kpvYJxG{*M}BP#nXS%S{QRos1MMFPquW$5cqR^s
zefncmLAsZak>@=-@}oC+eZcT~t!(V0D8ugdUGJI#OVoE#zN?d90tBlqoR4RJu@W5+
z0JcA$%-!;GBT;nU)B2OK#)D4T5!|}4&4+$=+ieM6Dd{V=n)16Tlh{s%g(W+kZ5R}p
zXVma1s>bVO{SaIklb_+xlVJjGF)SLTo}&Q@>fmO>4g=&BT4<#|XFKRDlRmJ5ZD5LI
z!KL(ydr<7JNasv-xr4*Q$60C8%KUrxZwA3I{8pC=^)^B%Jmiw&5e8O}`Mj`h-}2IG
zIcI+{^|GnSld9K?IXWq&6*BlBf#%nj_3!L7j(Z#cz0{QyWiBt}v=i^Nx!jNiVU+=c
ziwh?D+0lT2neP3>aLp%8)SKEK=T7d~wxCa*@405VJ%?LYvsPi0t$a67U#|irT~;9q
zR%ONX^-r<3m$62QJ(25!8hutXp4a6ZhQSmYbB=%CshU&ozA>7Cnciv9#TW=P!()v>
z*VKzY?97gIJW%m{k$N@z=A~oy)14M$-~On#f=ETDptCCWdx+X8Zys4TLVOY0!DbNx
zIKepVs^`WRJC`gpmJNF=d)BT^eNXV;yUfVX&%cw$dV{U;p$^<^VR5;pGMnlBDfV{K
zDew{CXu*z`?K>+6mTU}LV(I5n$Xmlz5>Y)<{~Q_drc+}nu+ldkUjv(J>Vg8atuECR
zHur5_Znj=(u7=s79Xq>}aVX4!?xV*310U-;>;1)ZB{Suc-({UJ-W@1;g%!=fB+7E}
zZbtfO3b^n;RIwj)uKw+CZG5~*N6jfZRqz2RTg%Rr2jM~bm`}Ak`9Nl+0`K+v^Nf&_
zW%aG?VNf_0`y@GwzLN*hn&hv8+AH)TCs*F744pYAyR6JNbIfJhJ@Bf5s(%6T5(&@u
zdQugYdN1Fv*3xUx=oxp!im@ummpW0+`Pg9G1FcHiZggzt#^U?kmCvzICX|?ew@R+0
z;mz_{J`=A`=N7BinuldOdzKsLy)Y=Gk$fG*RGlJ)wx;@pU4OoRCz+|HPZK8({yyEs
z_A8_HBe_PsIwM-p_+AZWWf@s1_5m}b6!)8}`0XOC>~uYevf^C(&xAwqUvII}{6_)%
zrtN~M(e|fKm)tZMv&TYPzUC6+mmGt%eHl3DA_R_~43DO5?<)|Z)H9B8{xEs?RA0jG
z5}RT5lZ9?Sm(-U9c$113&FbxWMuqq@@zT=wwv0kVFSQAFu6nQw-Z059=})@Zm1nHo
zn0m^SRjGYTzS;pF!IRdht-?ItH<iE@Ubf5Kl<((T^aOf_r=@C^c1h2yU_7hHT4Fn?
zgT$ij&1dF&x*-kPP7AgjM0Cn^yX}{mSF>l!T)Je!xhwYMZ#Lzgd`8QHMq6ePkroW;
zly`{&EQ_q!dZtDLRB@v+2lTp*BDgXg4_;mE@X^Py%OzEnI<Mp|-SQb7t&hWg>E&<8
zzc%OPnZ>oaS>=Y3C#AtO=gau0Gn@2n1g&}bJa}it#l|o??=O%$+&gv#lHuh>6%}0f
zFp~-$C7-C;?-$lj7%mm?*C>>9R>BEFEOYev*nI4OvIvhTY>_wCP-v}$JvG?&yzIrl
zm@6?_1P!Ks<uTT92?ozNBiX2mn5-0+U5Xr`0o~NkQ@hHuU&*iVn2I<pi}4v#fMUDr
zXa~PvINxqg`7NPXLO=IUGmcHr@;T)OkTH>Rr*+13yJKzd!qL~dM(Yo;QkXI`qiTLJ
zYBdGQLk2~QjVg}XGv#^;M)KW<%#OcLVDlAqK!SXxmLx*qn*<&E-xH6eY06g#7I$h}
z3oPzUr=|<g*POb&w??v_99&ev&(F8AG2&CVbj#>-+w0+-O*uL`x-6r`AvSEC8qD~n
z`ED(Z)UU$ZBy#4%RWjmtM9-3w#{%Vf*QoFQ{vNF^5Xaw-PQcC5`plwU)7q+uqUq#g
z3Q;90nfKp{wuT+&O1nJDHWI761Xa-=3r<r(Woda!0GteN_pgTPu_w)t<hvt<Lkb5m
zx&@{tW@0VMwW$4<nZh_<_vcLiRQWq(EB;!bjhs8J=|Wt;Zcv=NTh_iKOUujr_U+h`
zxL`0MQ{|goT%^K2a>&(!oyT~L*08#1u6y`V>TSK2b!;<_X&xp`pH9qahmrRLRT$jY
zZGM7PrBthMSG~Tfst!2H_4J@taWjvj!!5}774baXzEhJV7YV?2i8;qbTYr{xa;YXY
zI+@JWJPD2Tkmt?YkxE$~eIER-ssh#jWdqtVY5F$(18~$#8!IeH2I$jy2&*b$<Bh^m
z`;8X1e=2e}DsJ?S`*d-_TQzscMR5Gjx!xAzapLbfy~ky&9&So2L$B8x|0%TI-@GL)
zcJ~`46_6kD?KvxK;@0RM`b(tRtr>mg1{;CMywK)87gq01cL0IAZBk2AAZD^33!u<l
z^x~Pm##3g_FkHIrUf&6+cdS>Aeuv_oVut44UrA4KKz*k?!;x+F<DX?wUZdVG<^mUk
zB?G(NrTuqw4e$9BXW}N%8<Q)LHz?$2fBW5jh&}E5%}wQEV(H{xuZcCXD=NyBKfjln
zxgsl*cb|9H{>e(er*w_3pG(ZKCQ=@nTCa};k8RIm<4<e6wkIUuqB@($kFi>O*2|;q
z6dF#F@qbdV<)ikUocZ~k-r4y3`if!eA_NYRGY58GzXfmn**Ak1<znc((Qg~sx9h^H
z-{t=CV|MenbQS|nw>$lP*<wX@R+a<)G0X$eEW4%OJ5t@jS_0)<GOQO_!ZZS|6BwZi
zD_kCOE8oZR5U%~0$S;?<tZ_hfTjj!v>4SB5Z&p2)=8{UzOW&}t&EGzszM`bg%&1mi
zWANjS_@AayzxP!a$f-C97;cRxT61Xm9Q1_gF9Qy7wAL<aXLmY>$HwI`<d1hDj{ciP
zbrC0o%24BUo?}^1Flgu;6_)i<xgi2~dIf3Up!*y{b>oY_%`*_L=le+cOm)1M3cr(M
z*nJL;y+DLRKZTD9jE!ZL;(zX}9nE4l5zdI8DH|Fav)|vXPLNn>%hSdc>eF9Q{&Kgp
z{B==Xpz$Ef<Rqbs_V$Dt9)SdE&@p}L&GFYd$gKuog;<-zYSepk!dtYx$kvgnHI&C^
zc58jGj9SP=6K?;}y(~q?o^AhWZh%RGI>os^Cd?>^t@%CaZU(S|#u@}J7h%p(0>!D=
zo&h3!-KTk`MO<*UL1+DD#_Sf9c2r>b9sm2;-L+E(NAub*huVMgBn3jAge3&%4WITW
z4&S%7Ul~i4Pv0tvw3_TeTQ-a2di>3v<b{)Ce%JDI`UJZD{=29B^ff$d0Bm5*AthEr
z-+mj}VpSREU#@$-)d1saxj0mTpV{x+d#S=4AwZK<V*Zp<>tT9PZ+fP@YRMK)>bqxk
z7mWu^@=A=4iY~9T9?n^~*D05_GujX!>vinHu^k{-;nIKrSLP#i%9y)Zxy>Tkr?Un$
zcshNI7lVP6;96w<ynpc373#DUoY(qQ!ny6a>Jj<BS=I8JvJTmK>Ai4=<lM-MC1u-B
zP}dtj3*<%<u5;s|Ywy>A`3P5S=EAUpo#5CEAMj?zYPcLs`aXaGNfrwZq8^$8d(Pp>
zwrammC{(|;!8F|AFgB*Qu{>6$T97r6e{Fl+as0_wqy6FP{jR{Xz5Q!*<4V~gf6?z{
z8tGtfMfMl%dZBZ5>@JImsc;*I@WP&W@19UX?@O%7<(n33Fo>{-RM0IFPdqylAfz!Y
zJ2Wy84vO<<p?;w>Xt575nc4DB3LONNmbvg_r%Cn}_S5KvXb@bGfEJVFUit#Lj#5M;
z>R7OV!N$2Hnhb}C%$;q8Gx^R@Yg7rgR<+8~gq!yo2E5)s{KNcxUzGe`Y6Z`iXXQ-s
z>+FiA0B&>zJs_s17o4}M4e-&(4hnarnTu2mOtaZuhq@S?%8wyhwJQ*QuzQ?U015&`
z<Mbs>pnCYN8dTd0NiL&`&>Hpc_E{FcW)`gQOgCOU$k+vUwYcDk)W{Quy;A^wuAP;x
zL@nReKJv1O2j#R+zi=J+(p#LNX`Pj)a<(#>`~DCbNnNc|Puae%D7t3IPkH}C=)**E
zz5T826w=)ZfxUP^!Trn^p+~)ZgzP1qS&2n<lAEy_S@H63RAQi1)=(<VFy=DmxQ`T>
zXgt2%;<T(RW@p-7r5-5K9&DliYhG|M;i9$^inQm9j;cOQZz-WPbc^oj#VY6Mvgqc`
z*--l~T<A(?``+#Jrvhb+0)bLt5pw$##PW%2(LpgS+po~Le@1OAZEXKZHWbrp?%XiU
zYSYMLcl_vFPuB(aHRj7g{S!4TXDJzg$#y&$%BTGTvv=YYv3KU*5o>!b;uX~yzIvf5
zq16*Ad~r&BP>%~FxUtt9hDXT3BkXlGB0Ki7d;R0@Kq-~@bu%7f;oICGEmDzOb)L&G
zdjp#Bofm3)JjcUhN~ENrB^>i1r-x12G}>|&<gEtE7Kz^-G9lJjhi6rVG9Np(Mi1_?
zZ%ff7<h>4dH>zF0tY2#gocjCtMP>LH;TuEXlTN6zzq_pZS4Sz>nSY<HbnRO4l!yxd
zh-)~PgV>qR%HID##L?h8w}FR<Kp9!r5^-x@bYmJB-hI70e|F;+I{7rmRJ9F1-_t4S
zdu+lC7mwCqbV8@qVLl;V;cNNltYv5kOqC(YgHkY3bG|g2I*(Or=}s2W?6=*0kD|#i
z3e0@CqY;{K6o_2Vs$LXjbT3c4@Ak#2X22JRyh$b2)*BTj7Smr%6K4rR9)KdK*xJPM
z;JqJn4qIdBQcG#^Z?C=1b?OW4&(R%H6I$8dumnme3&YK{bg)<dSxAQwH)B$;dALcD
z;WAq;Ru(`+0|<PCU(tZU?^&XnZb$zY4M6h53%v6+etOtC*{VPvk%MTm@1T<`?!)Cd
z<_`5uF&#_`yFcFd3l4&nx*ptc3+c-rVw{kC-8|jaCK^E>C}+<z_Tm6Y`4&#Bgd*S;
z0wT9tT5VmjxA^0#%s%$j$Uzfr03U=V0$(d%1lkch1>pFhw=<3Ym6=rH2gHn7=&+w~
z5Ipk6<ARSFITnugFFqi!9AVmj1D^<F1^|ZDjS$3QSo_O@65jf{8~+y&%|L*$|G-y&
z+%>N#z8^uha{}YhZ>@On7^tcK`WO}S_c4b(N?2MU*ltoFq8?^IUHkPhdSVi4dllQu
zZ!$9HC=TAr8!6(idSt+>6TmRn+feUZrWlZN_c}nM%^(u|FG>e*MVQDJ43ScFO>!oD
z@lhJ^3W*CM>l}O-0a{$d$Ptvz<3H3kCgNiM*?s?74L|#W@Q+~t$swisH>ZcG|F=~A
zbASjRGy{Xr|6dsIXIsA^H)Z|A$q0BbeE;XVB0_|J<cE$LF3qUVSR!O2!YjI_fa}FC
zgE{{~JM`kRuf~#=-v9RpOvZ+!Rz{cT6n6shAG96xuM&{%G72Yhhehdg=lcpa^NcOM
zWFNyhCH48n*L$z0p?0D=zX_32np|>2-A8A*&O}o+g^7b>83GyuY>r9r%~LN=1&h+z
zXMmCjWUxy!=^6vg4s&&0U=(HSU<g$t!52@!<m(@=?Pk^4{kb#uKQw}0i5Wcyjm^eb
zs`1*_GeDpr279h#lc{09R?p2_4XZ&r+t_dSqaxB%Hm|n~wFjoA{sHRh5d#AODtS(E
zHgo&qjX??`4WH~UT+)hPV)TO}InpUBW$jU-V&+b$DaH_*Io2TM;NZ~kp>M|oV<>83
z1?7;N>i$eV-IHz30cv_|HhXK()3h)h^4&rw*pDGGR*&sppT7_j*rD@V<Sr9xRu(2d
z5+Ysi9J*c6rp&>uWwLsi-tlaaeZ<muO^>W+IDf(Ft7G&2x?a>>x1s7nFNAWDo56VL
z6hj&SY~yR_J5F|O&g<m<y^sLG?I+%I&y0)|HHUhj(!6bg!C8)CLm)IiemvBNPObQ5
z+lF#(Qr(C5@84&6G*w5yL35f1c9J1dmTQTI>QmQzR^{078J80dSW~y(4>a)p3Tt>{
z+}r$}E=8moNJTSkQJR`~3REk?^?f?cP@Aw_dGY3EfL|6K-#t@j6mVTCF5V<NJV{}}
zo(eS{ysVIx!ei1wDcTK<a!CE^Q&nx;d0mD+lCB2tUGqy*Y)FGyPOW@-A3AWGEasrI
zZaFYd6njXvu<opqK?zh;Cr!Sudn$a=O>jzgaC<H*L%y%jI?YBwqij!VBxUq_l;+%n
z$FKi!!5rf;`kdC^kk{UL!8;AzV?Me?ts4r#_=VSyhkBcr7$Xsu^VXv0VCTzLj+Y<F
z&fknRoM>qV2`{g1!*>uMQg$nvbmbg6r0uX~#LNszyq)&A++(CHzLgO0S;Q+q0Zb)B
zGi;5^S5Qy@eC4897FTFkdH8KjbfMr+#aTMn7Sk2RJIHJZF2>%lzEuaNgr5UN*LkJ0
zFk{}77;=;7wNw9&#89f^2GyR-4;(R*1=<{IV?p$F|J2f>s&2<6K;0)R9xMd6>W0eI
zbVl1m#hFc?KVkp*T5<9zPk%^Lo#%{?gx3Q77<1$3H&0oIS>AV`f-A;j8nGR3F=Zhp
z&WA>!BKRpFh%Gf$wstG@R{z##`At*Mzzgjx8gE9KkAwuPP|?t=H88UqAfk2CLcCjU
zRFteyH&`b5dIILB<XHK25~`%QBLEd6214EEY)3nHwyB}0v_GkIuoFnes}*r0HU6<3
z<xJ@q>Z~tnMG9WB4qNz{3x-fTy-(kkl!8g6p`u8j675!*y=~#_Wt{qw+sE(YZ%3Bl
zda};^0dDY8u!j^UL6X)WtX&(1C|oO5S<Yr*El8-Q)^rO>%gf`<498DJJ};8l&*%jq
zbt660JvX7}?Ch07AH}icpmbNp@wy<A8Svk2pm%l_9jhO~e}8Z#T@Cjoz0E+lH^g&)
zXT`NE8P!1wjN|hV#tv1;m@u-XW2EVZXa?xM9?U|gcwE>oDAI>84d%TGA*m1(yiCnC
z0l1qsfD75(3IcXb9W1R%#@0T<jkmi{2yW{DqvnwiNEGSs{9SCf^u|Zf01zQMD7sQ{
znA{*M7%?@S!|G?<4Gb45Yp~f#PA_b<D{*L@VSsMeiG3RNTY@AjT5WR<UGij~?Zli$
z!HedFcopmPImf#=G)m&AUeks=Jt&fH>eAhIu*#f+%ipV_;51-k0qV<WTM5um#4^nf
z#-&BCu-Tp>JWOR{is_3aiFe&*ZuHv6C@R#s$&IDM5@<o~jwqGhnl}77Q3GKWDCGZj
zLVR2N66Z(0y)}n*6ZR9>9Q_necoQg4ZpML|X{U(8T8_)OL9+bGfB@M9Qm)-1==CwU
zN{oR4<UToSYa>39^+UDv=r&QfYY`BmPbbgb|L_1=41xR=+ukeeiVF=b52pVn9CN+H
zYg{f+?MFlZ!fl#j=T@h?Ft_7G9V1oYY?x$#7Tww{D#~hxIwPO0iOIH_=fNTf0gPiB
z>h0UNx*Gx_i_IA-@^4xejBvc9pTF*?P$Mgg9&3%1ikD9fN%AV*vA{BW=|;scFBGMJ
zHeONA(lMuU0y_)5u5#+<x5mtX;X`nfpSR&Z(Me28vOK1^f8DY#O?0~(<G2Hl!0voQ
za%!qGF*qer1)U@q?Hr}KyTwjPAugZ3*K9RY;t;HEnmJO3=fc`Ds~6_vJqbQG>O<Ip
zbjK}fwHMdYSWW<zq8)Z!I{NFABT&REvKW129hb>sWu;r~K1OrvYnsl`H_5G=Kz?}?
z_+Ji>*8eq>!&Pptb?<$=^mZ5o5PGcW0lNge3=~<rj)8+P1H+L&M~lp!=PohUgnWk)
z=JQt7i0N|otM*`ei37WdXmfK$XpkKqY{xYxzn=<N8XZkV3NVS*Gkf1fLT+WI<-jeC
zl#Tbd6~Jm!K}5uJGA`xWePABd`~5fkc!K`dvB6sg_@KGOkBTF@%}~|w%=X({sclF}
zNSFWvw$<{H+6T*{OE=@XT$I|Aj?=0UyUHQ;Dj2&Jcz$A2li8Q4EUKsVxhE-l?v|;#
z2Gt;>+1qhyrNxpoRQ&lKo_3B3d1`@S#kl}j#G``VuBD$B+|i~=l$}5=T#|q&_>C_M
zoO6WfMG{tJ75ZyP@NordBRqqvpSVDr)eBD!zGGulALA1k*b8pc*JbHZePF3q%s<hz
zsUG||o6*XuL_pLeg*;tVNh2=>?~2%ao0r7EJTn?J39Mv$dSMW1gT}R>u*|ji%W>`Z
zx`M_bA0d~(kU|L&Q10$eC+Ft0J`SM2nF+?5aaf+)Y>GEpY!)6Pv9=P#c*JJjcKe^%
zW|=!&x{j+qH6{FlHkI5Ft}J!lGP?p%fWD!hKbjl*C6Jt19_~RD1bkWQF%~Wgs5nk`
z6ntCm*BEy1Er4#NA#h}br#^q}hJN>a*H|Np*V#c>ODncd)sZ4xhU`wE;A@8NK^}d;
z?!|*710{mnQTuU$&npW9*fnZ4$lvAF4^gfTs<%cMOQ1`K%%J?H*Yak*pXRovE1uO8
zT=lSM)6zLi=~hya%@(+~qeed-8+#8o^7&A<iMzn19jJgWYw4dXKb7xnt~l@FMJ*n|
z1t9~a{X3298ao>!dRx^0GryzN&hj8fh;EvE4ijmYyFNA7G|Ed^rakcDgF+-qQ}X9A
zjR02?I1Fx@C|Qh%R6+Gn;fpK&q@_sKOp#J#`9~<ub=r8zFh4G|HoP_h;O}4wP9wOT
zVd9D*xbA3$wfmQIOqP|vM0egQPA(~Xx<2Z!%VQj(-#0{$a#BlG7FJR%w5kUoHs>9O
zUiLDli!-q4vUV_|wv9ipiHN9xV?bf4E70rwuKYKCpQJ$li*g`pSl!dS0#Q>BnUa2S
z0SBOuaM6RQ{&<yJT*I(zLZDRe%^ZNK0D}wK-`koAs^O{$6Dl*nq?|!2=qh4cYtFV6
zZ|<Er!|CsrM@fMzgTWGVc6d7%0#VA<q7NRpuc`cYW>GieMB{bJ!Q>VW|C_guj`3Im
zkk5Mp0<A%(4oes_;4Rdo#!=0Axxtl(rREKL0hyW4SH`_Qm57g;8qZ(~un7qUaH3v3
z#$xD+5FodStXr6tgq-GlD!H4=l`Fb4sQv96{#K~(akRWJ0Z;7PpbsI=-JhAtWU!#K
z9n|=Dy*we@m;=O-zn*_@gMr87p$_s59Tf;32wx%83AzLl$raM~B)0jV_{AWmCx)%p
zVNG6xO)(+i{f=tvqjFf0FC51Db(%v4y=>_q#bpOm=ro(%o?wXu=YYRy5{Q%>-@|=u
zV*sTN%!{Q?!ii9J`0&)nZMUTsFteQkYE)f`%&;lj_JZT`MnBf_K-X}W^ovIRzvwOS
z?R+?DYtZp$qTkp8R}u*hd>!ASw`J&x#Uu19iJW;7UI^VZt)&Re#LJD)U86GFqRpQ~
zO*Auu(&vTZi2;N!C+v_v>5tHC6DyluMgS-v7?e7adXU4`ar`THyU^{%cV1w>^xbks
zKc`a&F{`<Iz}+mg1S@WrsdnX&+dwF-fu|RUTl9Iw1>hRBxo1-k?dxS8MDn9Z8Kz4h
zogC~y`o7%5s}=2d%JzoEOUyKUZ2G*EYW}#r3?&*Y0G9LS*Sp6W0`QSe?P(9)qOq2b
zBKXzWix+1<bL@ID(@L~#;x50*2cq<=zACNW?*_j7nh&n$ikF^CZy{unzLo!zas7Ci
zN=d`P<KX8b;MULIYG<k45a9S|zUKLJ6m>!tFVy)18Lr8vEV_}2du78(>e~y&Vafyx
z1ugAL5C#7eCJv`Qc+BO<CcKbK7GyxBz!7Vn8B@=T3Wf9quA1}p0E{z%U-_{3tzswv
z5$gpPCfZbZe?6^{1k1rssw!J<PHgod{YbOd(h7|L#Qv5O^3x0uyi;?ps+S2CC0|RG
z{~OFZxLOLIq;7O6^p8C>=t??EftIHC^j1Gdc^hM+G`@Gv6Zv&NV_5JO9-yKC9{H!R
z<Glx=qA$bLzthf-1<K|c3AV8OV}qO*(Aj13x8ec&u&9j?+Sg!J;EsLSRsr>KY^A|?
z)0u{p#!h$e<M~J?wverk?@KN_a-YB%c%}LSTTTXb?1l%{K<Fk)YDh+({omP9Q$B1a
zUJ>Rag6m6DQO@&|aD%|;1cZmad^SZk=?$%ZbGYWMVSv*TW#8wS^dp%$#3L=<w53zV
ztgyBLpUyGeSI&OHzPtEf0eC~$f4+Q)L{#8B3%K?E$w}QjG^=us8B7jj$NE34y?H#;
z`};TUob#zpr{uI)3yBg!2-&qDDG~-_D@(F(*<z@)+IPuT*_R<ScB7Jg%f3@~#*$$$
z!*E|?bk6B~?%(%u{~q`4kMlTXn)mztdcR)R^1Pnc^D2)zqpR=U5SL3C4&yU>@jxP^
z5qT8t9;h1^l)o6C53Dh+A+qE{p@$+MaAY(*lF`r&p=t_Tk!l`(<}Lmy^Lqr#9zX<;
z@9&;<7`a6*DDaM{J}99}B-9u0XZkYT7=2?j+iuAJrL_B%7_oqubLpa{SGpm17-JL=
zuQ1tr^>+>im@*Yr<S_Hemr=^jTI4ddPvZEV_Mf-HNPM?%!Ekk<Wv3=N5Z%s~oNs<<
zYkfHNdZA<mc&i3F3a@B=>+S&Z?o@cUQI1Jz2n?5kbQafzPM&*xCNO}u-7d4!7i=18
z?b}V^{*>z`{rpF*s({qOM+vb&)Z`jeamLLB1zTWx)t%189w%%y#IXnjhyzrePfiBD
zkJ*Jc7k52+<R#XOoL??{9j9*peT`Quz70mUl57H?fE|!!NY;b5)o0zZ492h_r_ZIL
zwY7ngI;Fs{TfT}ms5L2r=I<HKfTP{-4JaD<01emjL-KOUsNxN^pCj03`e#@4{FoNs
zP|-mLa0}?1SHfm#8)sUvzn&F!)}z#tV6cZAu%Ar_OXU7IQVVpQD(ik88><#Mqs2GR
zt~ST5SB^K}9{JROCK^Qng0PRC_pFQc*3zW5P2V{U+tWTkKe$$bM)1|sJ$z__*%LL_
zP0M0c1sPAdb??~Y$4z*rn{5npHi3@8q(`L^Y*H=VFCj~g;Dpm?6Wey8)MGaH8Rl?!
zgn3KG0!!mpyN{0R6sFBvC|g4WwpkmZP!sfQs_=Ra!gH}|5~`4Em2~B+b1@a}OId&#
z-PjFM37LW_%DovV$;^%T@!v6(OmbeYWAk2shc<?xi$5GrpMvvt#vPbJk4Yk;y*N0+
zOy40fz6CzWu+{YiBObl5El``j%uczE>ANc-7s2-uK2q3lA20Yw;y58fwP>#<ohp9D
zE|Bc%R*h6wc3a!8d!yu@a{tF`>_KspF~zZv#`c%yO*2T~)DuZuCvDWbl8A-3icyL{
z7|e+9wrFOtQt0)Yt6NzZR^JU%ov)*~fRx1y+@abkKPzkT^LMVv!EJJU#{L~%zvr8w
z(4mS4Zt{68t6Q~K=*c&r7v{n~0>P43Peb;_dpLb5-WB4i`03Pz+FQT}AOJmYaiBN?
zqOz!61|{dZ6@e!@-}8-c-_`KbmQpXLM{}1vMdF}p=|}_MoY>&aM8$E4O8Nz^EN#C6
zpw*ZUq{v!j(WhQt?~a2h$oCt*f&>?&bS*wM!<(XJK9tmt(oir<8TzsP6MMNd(iS>w
zV;cA&$9(Y`(&I8uqVWCq6FCZgyP2(<980TXB%RadZdF4$7ffH?hssJ5h*2W%Syr{D
zYHvUsB;!$F)1H#M!uI(baAc0bs(M68IGuVAwapa0`1={LbK+7du%yb9{=zRs1Ful>
zD3U8$r($!TFw6t2so$LrarMey6aG}+8eG|qDaRv`xr(&7XD(f6Jq!RVSF8P}qds<>
zS?P3RxP(3p>KFI(fHo!!qjYXqRso~T2-PVAJrZ!ft-5BDAprH-a5$>b)#>XJZx=b%
zB3Dr$8}afQr{Z$kp7ssBcS%l)%#AEcXQ1-k_bd<eE|q$ZQ(oleKVD?!)Q=Y_X0;N!
zpR~4o*7l=VHClHzbCL27LGQj(_SABiS|1N)BuUw4Jc!}~t=@<1m;I0E;Tn@k;vFsU
zTakmJkc_b_!>bByW;Q!(bu2eYi?2T0EXk<iz<({kzmvvXj4@Ca`pr0%kbY^FoxCiC
zw~mf(uS4W}ONF{{o-SlVd;1a`|5w&9K#Wt($EOCzmtTN*zvP+E3-2dlu$*{D2F2A>
zu}ekLJp5yp!{<=McHE`7xs<>SdH1vr&~5HkP%!D|GJgljFKwOv$tD)o=9~AZh}#G@
zG+nWUD_O0C2a%)!@`QBObR$R(D`v~(LtUF`&<IWMH}oPZkiVsL`@&)3^^TQA6=8+X
z+GqL0FrVR-iD+4{F5-tJAgB=z4S%0}Gnw1e2xiGw&|SFx^Gd-uveQP`GU4-gZ%pF4
zE6q#+je(fQdb+JktWY@&Ssw^kF14Es_VxJ}7>=T<pCA-{^j$S!1HJ>Sq&NQ38}{j7
z^kHhi_fJnc`_^WAhur}xc6Wz<W0&c+I#8u}`uG}tae5Jg3z42zRalmmP*wD4iF>Du
z0P5+hyq-fZ<!pJ%`wVcYAe$#|D7r%UbL-<q-mZ2u-GR<wM_2J0lNKV2h_y~3I0B}M
zq#J5=p;h3WBmo&m>rJxBl(<2JY=pu@&X!pBwnYi%v_~bc76wl+PYX3u_hcwgJYSPT
zp8y!VQ3y-pwXrBde50Em70wEXx)8*t%^|OX(++H#%ix&lsGR>XpQ-MfhNuy+nT~~T
z1x5>nw>}nuE5&KNqD1WPMEwRu4e!GlpY7S~!!9Ei!I{sodc8_b@UpIaI!(bRHevD2
zZF&cf1yuzuiKb`^;%cIIoF%{|;k3RKs=(BZcXN5mn+$EzoHEtAqt8#qA=QCA@))?|
z;etjK?Xlhar+`M%2lU?BdVqs6vLJymfoS#E366>S&{X8ymO}xxK~_FH*@)lupZgCo
zn|x_Fax(YtEjGm*EbxI6JcD5TcgRj(HYFMxclD^AJf)b86m^C=JrGu5Twt!_l9cV-
zZ0`+bO5ij16>PTYcR+|qwLnjY@f^7ZiQFg6GS5VEaanim8Nb3HuwemY*@npLk-tTT
zK+fsqmFT@i=0i!jI!TiZh0hzAwDkwFNj#xFngSJ*yMV#0uPy+nHw=`iYO~0De?L2y
znAo-5EeS?u1CK%lv1=bpHQHg6>269y`Ut3{faC`&jr_47fX}CPD9g_SVNPdo2^kW+
z92)$N2uiVG=EVwr)kn?ua$E*@B>1rP{6>KEexC-hQioHDJ8^XPPVw_VT~96<*eepw
zmc=VIX=$$+_*rT-2Ao>7u3Ym!m(Bh7&yz6wOQz7f<C^>a-AA&$&DJka!R-eF{?rPW
z1Q+N=cgDAaMxl0=&h5EL^LQR_3LgY&l|m4?6cwuS>rdizH4gn%z>yb7Ep+@hPlMxy
z?;o$kno_~IQG(Cq`9WDY^()CRnU(@aKlFgcm^5fF9RH<g;aSB_snSvIr|MaewrzYl
zlYVxwH0i|97ILS^c=D$V?So8+qlgf+YP(ONv-<f(In=40h9Ca@v4cZiY0~oyGMfnK
zRoa1Bv!PY`A7#C~;rMUuV;2}<tay)%(#}2ULqQY@mQxeOE;g0(gPYF|>`DLx_&hWS
z7N3R_DCQ@1Y%V4hL=KunIF3@unl$><Uca;?i}n(bjNAeY++QPflPpy~3vimhMzH{(
z#dhr}4iKA@!jyaSl3~=&Z=+Y0+JQAn<e%#sH;)DB|4B+3>}7sYjE!_sp4uq*VSI|Q
z?Y~a>^J1v^%qq`LxL3zaZX5wBG#dhZph~_JjP`umXxl4Xb3URJ&O!#*qS|83jOEX-
zFT}w$eYy=Z4S>B?;+)CCDD}#5oGq09*%PwGkE>H-1l6}czu?D-7~^HGgy-g&ePK}G
zp<MGW=53nx0ufyBc4|a{En=^XR*M1<GUWr^E86H+mZe$H5ulYJy-nR^5WeEJ<`0Oz
zUjVI$DwwmSzss`!N()a=U^Uf+%WBKYg6l(eQJGc>baZrTYHIHG*JID?L_0?#Tl-7#
z=+ugX)ja*0fJa9*CCGK1hoQC-{D0#e<q`k(WOwwL`|=f4uGV)o$Hk}!7#W&NZFU<C
z*S<~|zH3H?icsO**4JRLU=nLzhE`>7euapwh?v-HjNN_g2Hr1%Pp-GbIWdB7i?AXE
z(VbFwfRe(lIH^KB6f!c^6Y)h33AlX7o}0sJGSw1X$3LEwW0xxUyi!n&Tm)Egw1zI6
zwKI#DFqx2ZS_xxX_j!564JvfAnYS;&*pm7@Kb5F1q%HZ7*Sd`ktYv~n_Qmy;9MB6g
zDkieF)KY@->r0GjN}2TIP)9<p%+rSRhXa-vS&pyw>oaP9O52X<_4j^8%5vb6=)IqJ
z{Z+^PZ%@o2MYJqcYyrI=!S51X6ulptKz?%$P0on77o(RX)Gwx8sUzM9KXB18@R-w;
z@Q6Q!`eUQo9cvqPpR1}o{=G7`y4q!HE5Tz}zakUoVOJ_X&pKZoAGBI&vhG!}>TJ|q
zZdEFiy*i4ulVAqDQl1(<D}ZaUcEfK2j#h-n1hH=wU}3tu|6f7Yb$>)NiZO0LZ;g4+
ztvH&SoF-OPN5x$-+t(H<x?h1Z5?O(H<ExLr#79|FU;VA2vf@mwOr7Mb?!>pKb@MYv
zfzciT!%jlY=y?Z>601#$9mkjP_&<JUGB!+<B?_LtTZZHr@+vJC%Cv-ez?}7w&W&Og
zH!D5$$`P7+e26T2GD$6x&o!v;)~&DS$!rztwy$Q3JvsWd8^-#JisD-2hUHP2aH_sH
zM$=Z?7)YFuDfg)05(lN-eA#5-yEn9TgGI~(1uKqav|NR$pcX@XX7d9<9oG1uH=Dh_
zmXN5m92Lv5?2DhvF8w1;n)wcPc-Tu1<PaUA>l20x4a>R59!5OFMVnjp9vaT;EQ7Id
zXa0)7Vwj>ZgHY2df0E!p)3x`wXx>#cD3-IpY|RZKDu`7NtvE8`!X|snvbXQBn)DfQ
zh{(TLj(vFe)syInLM_Eh63TP0Y3X};oy^qasknVf{#v6LA>#r)M4ybeZyVLhyehoo
zir_oI+=f~hk{{J02-mQPvWY0piZ3jF+_S)^J<mo!Rt}ajjx|PK+6|J0nnm^xiAzeL
z1%{hy?L2w)NXSRvS*|u|8%Up!dGjU#_~RM}E+pJ6w&y6j_+-7)XRA>J1A90fTOGd~
z^ZL{l(<v>!NWlf|q$|HjL{3dXzFD@l*(SW!s#G3ehCdDyW+a$Br<1Gmu8S7gf9rX)
zYpIt4yz_uLq#7jKw*sj!)jXuhECT7!UtnjNbS?Vk-n|~nb7^M`H(q3=Yh{MIzcX(U
z6Vp&Puh4anA>A!ji7J>nDrBjkTxg3nHG6ZB7@*xTjd^=g%B3;?B-X7}I&FUO+p~tt
z3O46<TXncKMy~Z;UMh`und!K=8~l43)_L)HTV%euc!u^beTR$+dUA%Xq6C$6y10z^
zP7x@N#K3d&YqwDplh1Fv?}dIm!1{`r^WnqM4in?v+4mN|*-%Ox;eQ!9arN#t_^a9p
z%Io}g(GBZ~74E^3MIx&dfj+^rPj=&7rn^0U%uD#RM)mW>$RrZO>=v3nF;P5<SL+%>
zq3z&}fF#Hd`wOoyPzGbd?YH9lK2`^0Hhk?!CpY=nVSAhJkZLb622CMg8kLgku)(>-
zXSY12IOLq>%+=Bn*JgySWgzt5-ST(u?a4)%y)!61RsGyj3q*-*d%reD`~24(Yq$Qm
z<I~aNcHtz=Pq7kCz^aAKcB_FhuiALSPzUBPw&<ip8BV-}nhkzjql4kmqw4;!G<rI=
z{mimu+Azfk*X^BW+4)BSm!(33Oa{_nq7iiHRnSu-2M3J>4EINQEH5rbHbtIs@1AbQ
z1*DHzRVA@qLLt~g{EwQW>2V$D*6R!XZ!>N{BCG#b&1m3r(fI|epXxmShW~HxRB6&f
zo>(e)j3@#95}`E6rF0<S#o=Mm7AW_n@h|dUg7E$J3-{!9--hQfm=%CD|13dB=zH^z
zLLNNp4F#04vN9N|@CB`x3H_J{*oPWi)-4raH499ueA9=90`EA~2G3XDlI-?{kUBg>
z$YdzbIv4<q5vUS9>=)peC&dqq=EOhG+rhh=dTbqs6}VR!ysCfE;eOCjiv+Pl!3xMB
zGajD#j>r2xe`(^Md7(k?>5K!?fw|QR8kWQcoV7XhMp9{zmQ`?pP&+t&M_9{s1Gtt>
zrNQ(d1L?Q@^jf`8=WAzDo<!!lFO>-6VcfNz*cGVvIZ(nqn>&Se9)KXJKG9k*j@t%+
zkH_Q=j{US$kY9RkRA5FzIER^ixYeFUoN<rhpGK-Hl;58C{;k~qAmNQqkn~M4j@v=l
zq34uEGvvF<AaE>m1=#MtifN#A(%UZK=YZkD%x7n}{U)=QX9$nxD(rGHEUUhL-5VL9
z8gx2Z7xj5Qi!$>$$Y1*VhjMY-S+U)M`oC-E^d$kiiVKFTd|m0=`go7{1Q}a#VHtY`
zw=IK2)9XKXY89wBcHhj8J#hZ@O2GS0--@y>1ojHAFwPi#x-MZ@TXpoy7q!kp@2&Ec
z#Ts^S0D0s>gn!_WCz&L$M4RBA5=og7mf#+cL9Pz+?k{UQlu93UFctGQ$*h4?Ef}ZH
zCkwZPpYvz-@i)uALmL$W6B(oZ<WpCtu2P;TnM1FjvB3ZHXKOya0+7~vymx`ghxRBU
zA_OXj?Rh=Z2TzJ*2KB^s`ql*HEE1add_a3s+HtHDY{u?g0U+An1~%C2opKlp2?YVq
zL3mg($>pj;M4LbAb(az_{b*_*im6;d%)mb_ej9?X<Pf7(6{C^$nbbv@)g#adm_1lp
zh+S%yV!L0P0|&QYtIHP(f}x@d6~hihJP)o5l|55PaS-fACPM&{rh-!pPX{iCfc|-x
z%BK(9mlO#zgp0%2xd2gBJ^@Z;Kr&Rb_;k)Dkdj3#6$p3Gc`cwOyEdEu5W<Gw7)G9v
z)4%@q>r<u$|CwbrgLL}2Y}SzYp>m_pnEl6kbQ5ld#DT~!oBLz!te3p~;r!ZY<OSQC
z*s|gAhJ)34>WTLoZh_4;Z(<Q>06n${7T5ci6_=^oA>4DR=`=fgjgmA=hPL;;`tVho
zEfh1<o~FPF+D09IqsKthj2cd<%-2RzS%kHb{wiJb&~Q8SspUKk?mxjS=`eY9R>#e=
z@2vI-K0*vm!o`|UNf#y5Jeiu1?SMCZ36A*NHzP(qM32rXHqY-^n|^Go_-Q_N)caU>
zv*uU{((1z9Gxl)qlrvzm9ij6q=0YMu+Iw>k!7%G;)2kqMX{NVBbsEdK)mO*~Sb!}0
zIe}v#@kgwx@Z;phqnh#F*oV?<6K0@juf3km#GW^`{M>&kpY&Yj1ycQlTo<?lFcZr2
z_eVavniv<LR(j?2M$Gk)2%uR|M!efNc&+AeU<qT|(;wc^{Mhyp4sioNMMfCRTPY}X
zIFU)wehdLpZf7qCfX9;dJik0pd_6K^&w>9udwgwUB1XN`1r@VVL%X@LG?J{s4fEJw
zKB^rI(X@<*SPWym(TABMp}D-tnEH(iL6NnzCv$V98hsoYmnMTYr&Eucn2uHpM)AjZ
zuFNVD(Cr?edwQ0+?4E_6`wiQX<qvapY$5Tc1tvgucfavv4NMb@&<Me<g1q+SO$3Q0
zLdJukF<!>F@+r-zR~%c&K``FA++KIz?gwd9!{J9KVVA0JcG0qQXeB_N1N_zxXrNP!
z<sE9NU1$wd<@|9HOrR!q=?*x5<x}8m(-@_mK0&={fhD6H9)_y8(xQwF6}-y(>1px9
z*~9Ntx9P0GAi4kR0cZi%FoSU{iHd}wQt|H_M0VSO9#*zZ%>5W$?=4?E8XHfIK?_fC
zh}ohB<MBt|Pb_L@8<iPTQ^?~Uz(YL-oZ^(L0W3kx-UItZtz^9*@<Iu5Jbnok#H6@E
zEN1Q*9+y87KcT%PYZAAM5}q9I7s=Kx1x}vFKDkkvti$q_&~JS$Vjtrt?d(`d$FZY8
zxba+{TQR9wp{3hG8YzOL2zZQh>!_=*H|Ea>eEI%K?O7Jp6o8!0jctCf8}NG{o-1`2
zw{-JcRYeb*QR^l&F90mxvt87Thb5s#M@1CAp!~MdjL6^d2Am~$7~r~6zG??xhtAIj
zzisn=TmBM;902Ny{p)S6EA!t$D8%Xqsud^#I-mdg&IkRV+-UzLr<x)SsVn&-(<&;b
z+!NXI425i){G%{U{qR|VPc!T{Au)SwN+CaO-|vU(KRv^7X76iskvdc{%Li6J|BgqA
zF<WoUK;}zkACcWVpIWq~VWiyMwq}hqY^4VpTUosf;hB*emK%~@@jL9jA^<P`@mTlF
z3)%NCqPZ&=*N3(`s5M&}%1pWQl&IqOMM`qQ!00VomUP90nB3Fqp0x8lNg#vxkHvjy
zK*S}`CntmrKmQ&{o?YDAWwHHG!7M*5?XBlBPMf9A48x6{5eWCIjQsMcTlIk^KsWz*
zE#uY6FP+s~!iS$=BBb;y+^Tkz>uv`9boZApS`Sn!mX9-Xyw}HBrMBo%HHPG0Q5V9Z
z0m6#CbXz1ypJp_Gpe#(OEz5A+R*CrqulKHOEMNP8Q^EFGv8QNv9*E9BfZVTfO`!Wx
zvHw^PN{UO~&&PhauG~qs9ooPo7%7i3zJt)Bx&z{aIz_IE&5|(^!GL7b&apbAcX5SR
zdcz8JRSldBpSEgejq+12kyyFUOQG~FnW%M!rk6rj*wp~7{1AQJ11!1G&9v4h2?unk
zru+l{*{i?&<l3*@<l9`<xB)}T94DL2VtXVU*Q5!WnCH(WNF)6(JBAjLRrGur_@~Cl
z3C&VD6f-kcEB^Gr9LFf!SCZ`@Z?)p%9J?VXY)<LfyXxoAGYTBz+f(XAzJ}rrOM--i
zym1x6IhBOaGJJi$FrVB76mLTnYEliXd_y9HvxOv0N$#cDy^|4GVT{A7+S2!LH;DNg
zkev|H$6!A{H}U)QwqQ1&TD*IpXQFTF^v}Sqs0z9GAzjO8ZZ8wo;n4=45pJJ;-3Bqy
zX`+#X+X=X0yARB6bZS=uwPj+#NL{h4yqx>`OzQAh0T=D+(Ie*!?^tzt4oJJr_RN&d
z^Ky+s_iMZ)W-FX$!F9F=xQQn~i@&Y#>wFP}|9u1-pl}a)<oL)&xQ7ZR<Q((c@L!qL
zecd8U&=ie!Hp&gLb-)ovM~J}(>ZCnBxhD&%+O&O3m2jH4RqO|G8A((4?^FJ-2=$5+
zn#ti_y0^S`!nf;`NoU=R++mQzQ^Io*_qFeai;JaA8ttjxplbi}kNw9|hrd(-_v~I>
zs4KrN{)L&e&8n2Gz7exGaXe+>BPCY&2m#0`u34eob^|@-u6D28b#Hn&dW_bOd-WFj
z(l<o#>&;Lcll8=l4DZY1_2UF_yXBXp8uVmK7ureO`u8Gx4*i6ylT#j{1)L=Wd&B6c
z<hj(>TjvHtp3-Jg@~_$60Fvg-zn>`0&sWS+!PLnjlYVkOF2dYY1RiCdzpc7iwN=2K
zRkx9)z$Z1*f}Fwv`K0Tyr)0fciyc>MEe76P5<ww^Z^?5<^WRMR05J?Hi_aZjr)0V>
z(r>~7I}8UQcv0I3)g`_5`7m9>S9raIxtF8&)NDQU)9EWnmM^pR{?7DP%`9WAVG=h!
z4w7A}z5VKmS$5B+ga~RWlHP41%+8l%wI@tF)ILURe6KvyTL=K*jE3^xS*~$u-A~S+
z7GwOmHM#h(R23<|gm%koER8l%a}4*?$W^=PtzV9=KJ>ToFS07pu^;F(KglTYc-TRS
zO;^OE`nbticrw5oxh7k-ZW&6OH(z1i{|8GBmQ0+i!rQ=9z3~Z%WVOVBpI#tyebr;8
zW7Tn~KBA%FD|s~vp$GJ7|7)FTi!b-DKv0imjWAugJPrXz<x@h|&EzsL5OscnVuqzI
zPqC~XBY^?TONcnhh|c;NHjmdf{i#iZsfK*<(#&1SDk^m^4&yqW5AcF7gb7bVcD+?f
zTH|0$K<s{LH7Cs_5rMu6=;0gphrR<Q3qyi3YhO{80Ymm>tA=}e-Au>um!2W8D}7F8
z4UrIXIGczW$qpZr@T8o7rEn?NY$GpSV=UTm3xs2DeR-V?XtvM_FtolY4<<^7LSmkw
zlN*~AUMlP58PHf=J-;@UI20s1!({#CHRP{O{Nieh&zBqH)<ZUFUOD+qssV%}lo<pu
zf0z$ibDBdU5)$l%0STiDT%wY8L!b;~40$OQ?XM_yb6_obz;k1*kWf`uQ^sA#9y0i(
zhKTSAjMe6?+d3j#=dP7<Egi-hHi!`d&Qm6JZ2t^=b_rV-kSs3zE^^?5<S$8zES6On
zBBg1nt*4JPxm&u>MWY$MT(5Y;Mi4`(NiV*WHA@0hoHs$7Jjw(ttyu*3*06VuXbud2
zffi*Sx{@?I&Jz=B#E8Z?si^%7d<Y$_UpY7q&smfVb1GrOVi<YDjdm}TEgisMf@B@b
zI+QmtCnLilN-8Kz$ha!(aRP|hCzDkeqtZPV_*?VL$N&au<RspQh$V8awtjuSR4>KT
zvy6hkRcwYqQi#CHIL~;P1SC^@$i?!zb!%z00B>2g%d)l2;}bL50M!t7>o#}-RH5c}
zweHipcmd{IYx}Lu<GRP`RLbwGy|?T<?(J10r54EA-(99SH#bnsURP<XGV9i;gq}(0
z>0yPQWsP-fFE;{7so<2WHYA&luK2aIN*KrY&MQbI(i1X`1W$(+nX1kf1-3fCdSI4|
z0&7%`ogwj}i+txr-t1!`Y|eQg9|EaLan%wxvF1ijbZ4zEy@r;OR}HJXrjNiLD~n#&
z1;f{>ZpBhWXSd~6N9bP!l22#|y!06Dl0!@JT;7+nrJD=!PGe;^l{Zs^m76nR=vw_6
z2qp24{tqV?gBejvMP#nZidInOr3p$FL_l8~sfk}bDijFPZ`7E9BpZ{(qmdFW6q@mC
z<FwvJ@|@S4a@k%G%j@sl=X1F;gZ{*ci7CB&?p$sM2PrMO#fg|X{~-5uIKcqzXzm7?
zYi~hc-+;kIXmsyAWW;CTh3W)2!;G`KaH4^XmzP=9XC)S>B@|RY62vl{;e-TIOi@$c
zTNBJhM98Nn`(mXE>zLk`RjaS8ym__(UI|jU3`GzoF-W@dP`}ubO=_j$@TEDM#SsM%
z%gH!U?|CL;Geocel)X@Y!hoEu$V3-&LJI|bl9IF5QHw#aWqO=3C~=G69j80?dt`{*
zrcQ{soh@?~oI!smsa^9J!6|9^SPdllDJ5~ATh{0ed-qOonI}R|!h4oS=BaY096rai
zGo!_HY^2Iw>m4m?U!~3|kCW!F_!q}*9c|M-f-}-IPchs|VnV6KvW55sIlb}@bZO4q
zs-9N+7;n*>37AjBqU(@*m2kY~-(l~}%^2u`>eaWjs(LUef_f^B!uti@e{(mfE6Ttu
zAgja9_Jw7~khffMQ1dH*46*=T=w@;#r^)AbXa%QcrS=vP4xPdnjZ_B99P1bCy>1hY
zyBk<iJ%qiXMS8?4rZH;vBn3iP%ro24wrq|Txv2<nQY<$8^}(faFTw+$NOu=`3QqSI
zmhT6+wB7MiH+v_m)I>T;?EVdznIaZZQj0qQ-mrB__w_!zc^k+;s;cL|h#Pmvt$Z%j
z36H>H-M2QJl37}D>?)@9k!y#9mR^@AL1HuE8mJ|je=MZ9R$VYmSoIKN&}kdxC8CMi
zG{AkEJO(92#9dA>dAxIF_^@7_9qgTDaJdt-UYo>cV&()j-`3U7(+7*!&ZiP5?@pGH
z7Fbf{c6p>o<N&>da}=<EcmCY;f2A5P9O9aO@=>tUYht*G`|bK}AzaI^pKF`4s#$+s
zf0aBDnHDunSV(Xzj}jaP>6><!ij^cQg$Rt5dD^G8NVh>x2tOxuQ$6r~RxNe60Hr+>
zBk6R<r>_~(%5|QIoHBftC*RTBtoNUb2IO3<jbNQK8fBj4vXVs_VHcbE0J}N(Bc%Je
z-rm7xQoO8^=K$FK4<&lzoG~+miB#f|>E+jF=(Q(E+^6p7Q5^k9YJ5hD;>|4Yl{r1G
zeSa`CnzL!H7Fo1wPf(H6<!Sbpd$cf1LmsRhg#v7?XfE2xAerQvv*{%B={DsFvl(lP
z?(7#rZ<`O3VWLI*qNR5Erm_$z{=CcyM)t{bTgT>NwRLC8kXTROrY991|46-N{`j#6
z6|@b}IyQIA89^;%C^5&Xdy>Gz3HA0U(bYlMLYSEJ%N@0mx9)xO-SIbp#Ne6m!C{m%
zQ8&6)ln34<#wdC0o*Fc{pYfRyVc}P2uPnIJbdO*&*B7WQ>kR0%kwsuh(H86_IMIF#
z{B9$kB^w^O%)P381cw9TpE{#XOH0;7*}uBm^KPa(zzA88veK14(S&1ZSa$q$%!zEG
z=9zj~;<PT5F)z(2cgW?XfDyqj5tjIL^TrGcxMtV^#U<6?E!-nXHC3D?RY@xwV5BbB
zHO_DzD%R-t#<4q>B`WH+G$zd?97!C`Y3FoYbm)Sr!yILY)!&@#1f2l0GRJXz<YE$K
zWWw=@DY@=MLEW7sFov0N{wF}}rXF7jzSkEbw}laNzLlv~Wb-#*#ms0ZA~BZ7tzL;{
zn)oMW&^X=SKCP~A5SkF!xB$vyy@kRlq<Y*eCnXA>ztgBkQvBmckwyw4dt>!*w<bNW
zM|RFRC4+$lIG3a^MGqcuMD8lTUw(Yl@p$B-rc6et+?IZCv6J6GF{{E8CQz7gN6gtQ
zO*lWJ#aV!ML!!T#YUb~punJyI=CGN#r7Y6Dp?eZQm_T;jXyN4Dv@?<(E58#eOAH7>
zeoFWBMo4flN1lg9cPh;`&m<%@|9>yhTZK{6vI{;L+e`F&kSk$9<c*mgI(^x4HhQUx
zD#HF%^<T&#EYwxDgw|Gbw{{2_r>W!6kn-Z>r}sNfny|CmsYIA@!CBbcz~)VasSSzj
z4&(ixd3)k2`eng7rc|HrDrNYcif7CXlh4!f@2z!*SB9G}DY(d&KdN8jq5zWCPA<KJ
zhek)Rq%2{H>fqoP6T4=b4Az$|tcq`EuxW9os-lMT&5t@?T3SDuQGR{X=FXh5=0U|}
z(j=I4=P(BT8Qqx#kl3gzY>|ce9E}C0Ls`PK+pAMLGV;&WVb{v6Sgclwq&=kt_MS|^
zmHdM8v7)6`a!OK@T9J}DvgCUY{2SPr8{8lRcx+zkGBe;xSAN>uO$XB~E>NXI&5|ET
z_5KXRU%5m{b1bqCwq)FC-FT%yL^}JrD~g4Ql4uE^tLDlk<3}7>R_ATX>$C8SHFov0
zajrwqB6SLa>doO_XItd7S$y!$-#!J>Z8#zM0O}Q|O9AJdo=)Gn?}Q$#pa1#6!-QTF
zfRAj8iL1jc;SNT_Wq`MJJkQwcG}#=XNuObiEs`_-jKe#}OBZ+LYz-f6vxV0Brrz;&
z*mjZUEN))v+7Et$N!`O^i=3QeG@P6xKJwo8?Ava+P~e+stn<jR#-wjT_iL<Ysmt7c
zlkqvUw?3shz}N!qs!HLFS+d5ih^=d}YuWy_#-sbgW2Ko_YB|kpnw$UkXHqLc*2c`U
zIW~m4;piA#S3b@73N}oa7dSpES}NPiyB)qxH~m-ms$kV)QAR`K*`<8>f@WQ8xzV_)
zHN)RISFrcERVPpLpp;65@=e`b;|%Q+<T=TxGej=P2^>S!5;h;2W!!kPA<TA6`T}Zw
zsl^Wj-Xb`k1zqR+&=Em?bIC)eAh=-N8ObMLAX(@6Lf>(IAO*(v=oWmvr?yGtZtND%
znSEMZ2<;ZSg|_s1BT8H>K7bw$pj_3NVd$u(kWjz>BGi|U<|O7>F|KMo3z4f>h?m*d
zam91Pwzu%tUGw1{Lbk~xBZ<80p3`j%OO%4u&8}-PVqcg*!6@_oe?q;PBingDJ#Qx|
zQM^^Jt?*33Gd6sf9rrc28l4ngTB3SA$59{Eh1Lj)MQn3gnXRsTc8Q<-UZT)(vnTBQ
zThlv)gQfYTNvJ5#c;0P&J2XGI?*Q9=;&S^h&`#mL_Dxv0C#i1BaQ+ljnVleWYb?)W
z`>#FUC6U9Wl@T8G3~6h|tj62n`&|>vCK}y#p?R*8zOPDAVFwv{u>S8ouSfADO~w&|
zlI#2JECV6OXEaK^+nl6KhCs#og`ifnkja<OlL?*>7VslGG|Y>LCLjFo&GzV1WQD#!
zCZ`(>MQ`qSHyv6e)C=MhTn9qTm#1X&&4bS0oAMT{QmG_MqUm84-0|sw;wJ+z`z$?-
zd)4FXLl3j)3U7raGjh_3DeSMIp&{WRD5eU_+Vsg2NN<$bcs#ycEFuO%DILm;w$b<{
zKIj3jxm|g`{@XChwH2Uy7zidX&&@S!F}%sl46O<FreltxX@SO2`IrdkH}KMo5{L_z
ztFVKG8@mw33TMee_XY@HHY9uZKJz3Vv*XgsL?rWQ3`K!>7`8t{>$l$5xz!f*x4F_u
zlYk*WQCoR~hn%w+qNIk6K+SjJo?P%LL1ZikAIsx49{*(vm!oAF-R^NOc{8`v<?{Xe
zt6s{s!uGe!QCG(qTG&&SOfM&Fn{@U%aBWLt#MOL}2=fFqx!3$Rn-_7x?&CgmL)<=&
z1uysTw=RgMb2^T1J4E7St$T!4b0*|ZyxwmO+?|U6)pbic8kO@@YvBa<iYpz~el8*Z
z2goSk-=O<b8N?!+Uh6<ClF%9d;M-B|+6p`d`=QEni`)pg{84kv&0OPRs0K{?om5vp
z3Z=xP$nn~5?QbsS12|1#S;Qdt3@flIcLHpXvKP-_R&nnUS=tMG8yEnI>n!)MQsH^o
z7=Ok{R-yd#)w(cl?e6RrDHLnl%G|If8u?L&r#@;`gmkeq-)|jKlo&BIj}Oo?Bpr<7
z{A&a01r0BIPiir;cLJ3_GtIujg7KJhZHt^>f%SEKyV?baEN={=Z>HVYq?FTiUN4{}
zApQ>ph|1DOk$m`YKKgo$qUDYGT&+ytk7vgVnFO=AuMTQ=3PXX;m~7(u?fG(&&ep&P
zarCds3mnh&g$5|?Kp6`&9-9C~>)Fcp7J;OiHn()-B1}im9T+%9_6n0cQMzy2mo&&J
zHS;ayC3*d!8dUpS7V3F+#Il*TWV3923A5bsi8?^X<GE!g`bhW7$FdA{Cx|acQ_<83
zCdbQ}y1)Dsr`STXMY+ViyW?%iVRu^Ca)DkCInW!yccxpLui3p`($izq6Y|D#DiAh3
ze}cg1+sBV(NY<7M+AUA^ebXzbH3~f#8o`&UsASjGoyL{V?bt1hF{zPW@`#lT=&J?1
zA`TIhZQA<Q0pESe`!}7^hM<fA%(1-Lr;Cr!NhkQseDd%R{i0S@6lI=5RhOAlZmaD4
z3FE-=!Q*y9h2-b94a6{6N)po4>v2bR!#)~Nv>BYnHDRTD{SduATdE&yZONn{ek&_%
z5_npa1Av8(pD8~N=<g^Bif!Y&D(5<WHdSET6EN4^9slX+g|*OE+C)H=45o{%ZjvvM
zj&P_tfvp~?VzoPL>8_5{A83|ZC^Px+K$Ud;cZizZok`22LnnPfRIPU7m&k0&T629P
z1vIsk^Gz;6aY&y;PTQHCkt7IQ!G}m8Df6Cp@ldqts@a>%jeRhSE;KaEzeBRC;Fs|{
zf9|~7C+HFl<Bn4d*x=8x2#Z)9(9kch65yz-iCD6PgafjIAiw_fVQJzGzE37SqlZrz
zGM(mLYJ00@bbc-M$F-!W*NT~>px(zhLV+&Fq;~Ep0?jgIS6=E#3}2e`{!%FaoK3qq
z^V|_%iXmoN-=i8O;;#HgangIEX{W#-{K$d7;h*V}4}~vq4q#N*`B*uRmFJW~npoB(
zgpwyXqi_wsD{BqhH-zp=6aDo`Ylvc?YVn>*CwQ<QN<053R&2k5f0a_U|BmMWUpeSf
zWE%ZKdEw*O87P<HG^P`J^OgRyM=e;;Wsc+mOHKL}iapGKwZQIt`OA!J;I@N;TrYn<
zMkMv*b`tT#mAQUHN^y&e{G$d$BTgwo!J&}0x9rsR`1Pq>?D4JoZqlRvPyqcwZ8AA1
zXtg%Pj*0Wag;BGbUw?f%1^WJvlbrs}+@X$f>6KO0^F$T$ZzUv(=kl*D!mcrdF<Vwy
zbr(eO>tz7K59qQDn_X|77qDues@-k}_sm7<6{oJq_H95>9byo^)!I9<l`#xVgKz8o
zyIGp%Ikp%`MalkS%)Qs{5Ml<d3SUB>ceVtt0gNZTYS%duqS^zDeFfZC@G^9^<pujy
zu;o%I*blBX{_6;|-QZI^W{@HIGhn-W8?eRY=u(O<Uq3VhEnwVqWo1RcXvnVdWg+x*
zQW`<71A`~qw61ilALJ$M=lYmQyFnp@Ou`99@@QP`S|d%MHB#{am7N4Yoq-}BLBPpb
z@bGY}dTQ?;My+ZseFb1J;v)o1wcT{GZbrbHgUWL>V_L23u=^w{qu^5<r8v~a4>Tm+
z6+!|-c<D;r!ilWI+pBauUl=LzQ(@*@hp(DftAewy;+wmwm7nkAZYL6|OTg|LJLd&{
z9XK_u;7q{RR6u1VQZxerAT!`R$>V-)$$p^Fdjne=C)EwbDWRN!ToXg+HaERmz<Ct9
zcdB8-)EDMmPt*l@k5d1#rDnc~qZ#}SBf!6_{z{=wy<m?kg2diaJ!k0fL=4k(Ya*sk
z2IUJ<KP7;e>wX$qO{v#q3D4|WJb84de0)5gR2Y_sxGWachg?k6$n5k;cm+XDpg$vP
z|5X@z517Qp=DM)NGe3Gh&+&SM$#*#4k!Bf)GsyS1p8T=8FjOv2A=e>*%di{7>a5TB
zz35FrP`E%$(1e9CYmhW7K5tgPZpj5k)pPxOrJ27dl;9hlM@2<#tXI-)dF<)lO`9=M
z`weP8yE_Fb=(&(t^H?3(bfrnWfBLWG-|(7Ue=&1p%Mjc9!&C@q)dA}*q$#-ovA;*A
z9WprXim5b4Uqwr=X*Y?)ZIFs|>l2tu{qhon1ktzkpCAMUFfmN%{Jpz$dLs>g2885b
zSx#|6OOK?iS0Qm?AA^6$B1FpRjAw?5a!aoqtl?t`I!09GX97ZwXFt?Dh}z}j>0`^&
z1X<ak02T>0Xb$e{+w4cY0-BFbGzx-eFyfDc?*YGAxL5{t>bzvt07mVxZ7#JE`=D{|
z4v!Kf@cjP;1AWJ_<tZX&#0$q}I_HwF(ucJd0R@agQxUwOju`>wQ1qUfz&Spjxjs=L
zMMJORbpNtVl3!#@g4~wR{gWdfeK;l}D1`x1!F_^~nYb6x?8SbV*jdB^9JF_yQYg|M
zyz}}>OKtbzQ)SSfR1e6mS;5r^{NFb$Sc+Q3jgF1&Z`N2J<CVR+O(uMhHTl;qzvat8
zWU+net<vVZ`l+%4k;8fffaiTs*ve7Iyv;gC7f9isLEOZ}2~r}hg|B6Ax1K&V*-XBI
zwdu{ndZK`5Qdn5X%Q+tCIQAXrkNQ~Kwxp;24O!$nw91r%d^Au!YLjMH3}j?o?)kdo
zHu7Ccof)>zo9V7C7npZaJFx?9C{%BQ8yP_FI0h-ew@+J<esPkRcW3N#5n1Y^Ld?t}
z6Z{QLCy7f^mQ~x#CrGsy=H}uA6YQ*K0|C1b#@r{|V_xV&M|hUsn@)0?6oaneeAT#m
zOCWj*)~!81n1j=c{Lk*dFkOO6I;Bhuj;r?Z?B2anrGbw3d|f+a=nE=$D$seqcN+EV
z?8k7;_}04rh7{^1>m$&>8M?86DDfm7Sqk^V7(*AR>DXLhKd3fACWYw*VhEFuRwg1i
zgn%;#K?HGcFQtmpK7I@me|&<yMnOukFQtnUkQ>vfzgagA8EQcUxoTG6x)8O@16F(*
z`bSO0RvtfQjZ>_bU>?z1SbjSABOG=fI0GH!A?3+$5dP;&&aFN-*UG=^)%4aAEm<Ya
z8B@nXews}odpRQLAeWYg=F0Q#j&d>i;+zx&tQv%LT!AZQVh^m5g3r4b1Eug3B@Gs7
z50^x6ZA82mBtlDgyyX4mVMhJUwb6^Z(5S7|5DBy3?_anBW#&w^gV66@2t#5ua%;G)
z7tS`e@(k%NG^WV>xW!~9bnL&XJqmRL<@uWVI=Alm@roE)ohy9?CF4w0b#OoDn_3ey
z)nawbJ&&?iltSa9Bf@*J>eiAlkip<}(o;$~P3&LX#_PLywdxzb?qR<tH0%lb0KzY!
z-bi%a+-R*Xs;Ds8W2(RMxeN=lr2#euQ5{=0&GZ}JHl^lk4+EKyLcs~Og-NL?j?$(+
zi5iXCa=e}iJA4OIQANJVpSXer$kzC^S5@5DsacV-bcxMh3^WLmRghMUH%2D{xebuZ
zgmdXel~1+C!v!=_Iv|vtFoPM%q2mpywY#0hzE6L7(+focFsS<312TD8iUBp*hGaEP
zCV0lXt&fCH;#v~6J~FXGMTFE8Iv3OJjj!`4*kXv}g}$tMw;(n&|0u<8QO=U}fxr!3
zUgHX9sxXb|g`Gpxrq7pg>^x>BQ|6aSaa9WBfVzN}us>dOyD|gBQV`tv@J4}(8pOK3
zidG8f07H^sRA*3%6{Vv9;lgWxm!9z}w2n3acQaFYL?PGs$sXDnmc#i?dDq%XS5@+M
zjk4a*f|5+_YY?-Fm~iO*gjyXmfXWo5C_XBP?dbs=0^724qtw8|{%~T%e^CVrxHxXN
ze5-sD3e@!F-uINcYTidE)wQR##fn;`czAfk7*!R)fg-ZTirKuTQ0K2m{?#jKO9=x_
zpCX0!nE|s5R<}3TB;FI|cUZx8uIW#Jexp-=b7ZO9o@+LD8kv%0Z#zsj6QLxUSH{f?
zM%^ET6R5YjLjk&W>CmASrY)eu)N%b?QU8f+^W(9$<73M3Ds#93^)I(?>~Av7_Fw)h
zK21v9x97mzjA$2I0?_`qf8wA2ljw4}M52`ZHT08OUEK=qG4Th=`7`M$DM$n7`eZ;?
zt@%Aan#BFNT6YKM<Nk?T6LMhFaOIMHe4pbh8*iKQ3lFxXR^?YN!1^&U-iCPYPYMZY
z0LUbn4C84WlRZIpD7-h=XX<oGHvxFa3l-aw!Az$iTVOqrx{Dv5Ex_IL@Quh$#POk>
zLOml<CylAVODY^}VQ+GbH8AY-ih2KG$G7MG0$(K|u|Do9?{#==^@11QnCm64Oa3bF
zX=qI8ZAt8Gc`@Y+s(arP1@Y-#Ze4%u&;e`NAP}CU1jF$kuWwaeTDcvh*3;{(`MOE&
zv^IK_<7n1SBH9nSkg>pCqjB3UPNt*lt(otx+10mk$rDGWIGh99OKl3X*d92gswK#}
zeZS@Aww9rldGX>!&`*~$Z;tJSI}ycioNO`1>z``5i!VFXVv9d!j_Ug@l%aepD8ej0
z$hXIC=cV;R9Q;*ZQ&ZE_bPR^Vjz`^w{^Sc6E-b+)s(m!_2+kHG{FzfNW_bToEmrv1
zQ!Nf%sWQiP_jcRqJlnn%`4x!G&oi>JqQ+`N$m^?igC(Lc%nH5*ribl=0gaYpM3wle
zvEpm-tz+)j;|Iqinn~~XP`6AHWmC_ORQcie{Rv=D#a@71BaB{vli}Y*b38L-QqY|t
zY*N@=F>F%Q-6d@DJg%LM`Y(eajrmag^5x64w6xKhASFe``QZw0>O@}LFaHNu6%Z3!
zfeWjvtK+Tg;nr(wYkl_6&Ho==c5Q8~r>6%l?#C#osHCK%pb#gEB7vHzZh*9RUH(hy
zs5+5X(m8ecG14`<2`kh)eh?1FkNUsx-z&fTII-}D2S=#C>eakBK!`I?iW??pQbi$Y
z<f)mDsZzI~{?LsI?bl6PrF;4y+1=SMG+PSP@r6=CHEKE8YmTp*yxr69w61UMFe+*8
zZf9T*X2*e=hzR!*_%cyZa<TNKN$QVpXx_Pa?KEvEBja7ByGuq!Io*UQl^w_TfNSRi
zRjs?Md>lLfcu%ymS-*YJI(FxH9k<x#56TyO$E~?PH0=D<X47Lh?jPsxxbF4`9z4qj
z+;3Wh18$+Vl(Z1Wh@>8O8hz??OSil=D+fI!-S6*-dnVISXQn)GJHuNkTtZkVwUz#)
zT@S^!PCj9Y>n-cvIg?+7w`-ao!g@y!yAW7B7Na=3wnwqjJm}b&!nnQe!N2~feNz6&
z^Z)Eu$M;ELyrN`eKki6C+n0hRfh*{CemrQj>%Lb1(!^yPRqOV{9Pkw3SEe$H-6I7U
z_Cv7PV;bbu^oKtdyC16C@PS(6>^MnAM4}ZK2reUXSmuczugjLYR;DKboUo~qY5L7(
zlaGuvJa1pS6YhOwqrQ$v2Wxem@2t-7f#L2MueoLSAFH`D^jr7g;AZ<*!C%WWz`(e=
zutxmpI#>eNhMx~{)Lqj!Up=1rjei|Jz&M_^xZWZE<2%-=&lueoQOS+a_LP8kn)F>G
z^^?m^sfMO)*Y*w%PDd{-9D~OsT<LFk7N|$14$`zi8Uoh|PB&Pa{?b*zK2&tXWXB|3
zQTjngrQFHQe-1u9zU%+uSMt@l{b)|gchb;AAEI7fDEpY~K}2~&>l55g?o1QCGd}c}
z%~uuo9X5BvcI%`!D&Xe&@nFKt+uP{4!C=vm{JGBC55>HdKkxf3N69EJoBHjwp48P_
zc5+$&_$3bw2ZF=3OG?`6$&VA05B?24+vX#~@olm-AJ+CDEYbRBt0*ry%bn4e!7r#w
zY|H4hu?(0ce2ZUM<^oP!^c#s5M^zht&`8}b_Bo?|;%9g|PQz;ej_5yLLmqY0e=xAs
zFD}VnuYtR*o0wRj)EBg=cWVmTzwmz#O7%C!uYi;N=#IPW#b8bC*`=wyNj-Yvk|nq1
zp8WPKE0OxIbpK*OQU2|Y0i*uve{0+RhhJHQ*psWbdgr>-sUM=FnzSTjM<gnf@BO;S
zt@Ish_~8<DNz(0QNNw5iCe*Fltu<%5Go<wU4eGOG2JX(*LySbr$9Uh!M(%mqeC>Ha
z{?6Ok`HXyh_Av=!Wxm~>zKxSO+;Y(x?%>X<(geXNJzkl{m;d<BpdbRsgj&vuk9fzO
zmHS*6AKRkxhbU>O!K{m(db_=#`Tk&kqAMMI*q`#@o6U0@?$?vGJL}5O<X{TN_s2@p
z!QBb_56S#_QChgm$m_UYkps^}O`)vrn1%uLz~rGfb@Q7_s9xf@6a;R;xBcrs+HL{T
z2=mM?BMM==IsUq5JgeCIgZZMi$qsr=L-FDd_QOD{=jIT&=nf{=n&5B*-=VE%I}3MQ
z4>nvd=t}Kfoc+rU#e?^ie+p{#pYu&N0uzd+m#5poAGWr(G71{{zj*N?ARr(psBn`?
zi-yC>1FK(q7TDTuF8;%d<>IW;ZfAvs@wFkGcsYM?#NZCAtMTqTqt)cQ;OHK&ggA1f
zSIDcTd-w<&8y0G&5F~)RW|Q-h=H=x*b*h@Q;{<5rQ=o<Z?|%?A1mrSaB6~F`h>XiI
zhlGUSxBTG}$StZ<03#U=d(#w@BUA)fk**`9b_ZJGH<w-t?Rgpy4rv4EbOYZ%TCRFw
z?NJQGM~Ez)gA5D>&bThP1$GHXE=kEgxVU{qSZ3k2{oFZIraO-r+T)~mpeeQ_-7M(q
zuLS=+mxCJXS#)`Dgn&OoB}`&JIN7}d#o!w^zWCDfjcqYYxz78;kFReYtk?k0eWS7J
zR8p-)ajv@EP7p{F3OoCFrRfrKaU-aq(#R8~p8cwN^j+HB%GWG5K1dh3dA!Sa9C^%$
zh*UJ)@V0X74A-l(A<!NQ?KO@q%(r_bV%`kmewW}`&`5eVHm~nrKenf;>A{N39|S7_
z?H7#h+EGr9%HL8cL2G>Qt(|$d50bVYs<!}9wlP_9oxfzuV{NFDq0>{s?Xwbx)dc@g
z#fkLVtZl{i!5am~`&-3TuS~pHl#*RIB~I4<?aEMqijW*?&E0-T(ot;pcm`&*Jl$bZ
zP<LnS?{Vl?qY=L5l0|=bWkc9Y|3*AA@VAOY#1|{OC!Q7Zf(OH1WJSTVurk&xb%dhp
z#L%l3uS`JDE*wi%+<4Q%D9G1!InGzFALRyB32Nt<JPY-n(FlK;qu5*vbLZL%EzY#P
z?{3)98u$+&3SNtygmxvItJ0OHu<e;~pM9G$>noB}KP_0f%9WB|J8w62fDiGZZ1g$=
z%nVJ$U1|__J!bc2_s4eb>Fc*y{+<9zR^40I1Nnbq>@XSklvLg^y*l`tO`zb=tsR5>
zpabIa;M;j>Xt(hxlG*CH2u_3LuTFlI*v@^Q-gD3D^`=<s7O3T45eDJC5DqXI+Tku6
zxAl?B)3s`hC-p0C|M;SF+ebT38O`J&CjH)XpHiw$deg}BTULT@xEH@i^6!x}%<p;R
zdg){|1=cyOH1T+z{XCiUq+utnp&6i9b>>rg9lm=##6;&trjD>%&PS@MpFE*cAh>#B
z_2lZ^!95p+LFIsIqaIMS1>x2&q1PIUasy4ybR0Jw^t57pdHIyUtF~nCRfK`z-Hwb!
z5kYYej9raub-A3l=R<7Uv0f}GR-sr4CH{L|@V^Yl;u>-hpMZOW@A_jogFzY<YWN?d
z$H(#pBlfP;yD#2WCy3_97CUy`)yKu~?;{*#3GoP75A_IN?{s|{yi9enaC2XkxBJ1m
zCU^S59$ae~wW|6)=~3IdOQu^ZhlW3z@!*>MxRSrzUFB%3V~Ura(-?M)4XAi=|Ey2A
z9U3*ptY;H`ka3T<FU@Wrv)>@R8B*snz2qn;6n<ua`DXT~->QxBO`!v~9#tn(Pp&V=
zm0sRX%L}z3{)W7EhrC1+Z0PUTIbZtEd&{?~LeC8aU)ndn7HPPt+eReYRzn#uS%>c`
z<(|fe2nJWRniIBeL;sY@=9<Y9tgwj_1wOL_p`&hdyOXNyztrVa2)qawe3Qcs%|i~Q
zT%W5IRQDm(NyXzQ69Ot2%y)d5e92h>MCk%DVW%01Mp%X}o8F|wW^cU#-<Q(9k#}~4
ziI&(827dd7wR+YxQpN-|zZPrjm5IOEdQj(sbasDpuh*lah!692AaNjPpmf#;Ymz;=
zzF@xTnz}hYsSV_dpk)FxrQ<7&bsfs$q**jqx{^FJizfnGsUb?O)lQ-D4dOG}uYzTL
zee6lYf)^rA#fr_!n+N|A1`==ov^{YM=s<Oo26iL>f~Vc>(Q7q~3H1)UI`8-P5iO==
z)1nq#ukj$?PQ9m3i0MAlS3X8;MwgeB>u1of<^-=tctoMTxHb})l93IO1Smytr0Xs@
z0L4j^>Cdy5E0mv(6?FIlHUn%|Oxf;MxBt8n&&g!_MHvuEHut0~7DnI;mU^M0`1Bg$
zDYskXFg}wrI>}ElDGFAZ_tre7PvI!xCj2CEj<%)!yidL&9aJ*e9Q8RkW!t3WoGz{i
z2qNF6!5zD~d!P#N`%uZI8;_Ltxjvm5y*~!8*o=Ld)k#J%y#Q(&LPh2+k3cA{_7-$b
zKsBe;E`r_(XnM{`pkivmCeHQ{fGNxXrKcZ>;Z5%qA9AaUK%2FIow0#_HT=>POlg!w
zHz&NajH7_@+p`L3Xyi*Y80Da2o2D%xwaa(!VrkTo?1eP??#6bwLG1n*n~j4Syq#HZ
z1yyXQcVw!zJm@5(3VqvO-pF*U0aJfj&#a0|>p!P7_^xIf4jNKubI{CyabN1@vE}!G
zma24T2%<iIGZNt02$yui=5&%NeXM@eWeUE~QKbfRBOWYIrej9N<+>#TGj%x2zvqvQ
z7LNwV8P|Ip-aXaO_Ghtc@1EYns8#)IH!&kXxlCI$sX^dCIRE^6rJyc4X?r_R>H~qf
zy8}g7<#NWUVy76zpm~i{RWrGY&``(md5fVk+q+ZVLq(ktXfmOjm#_lk1Z_K%0LS<a
z-Oy2j3*4^i$ybSLvhIQcwyDGkjg+$Cg1PpY=fFu1EV&J`4<1)BZ^yoV{L{{^ru0*R
zMf>S0bb9UPe&#lVmCLNo0A`vuGMV<CR0ELgCInL!-x>Y(ozt9b1RGCj$1~XOrlNVU
zKUu)54+4rLIW;uBT9#v(j=egj;C{b(oz&=%_~vsSqo++>QOO*R3wd;T+@$&9mr0gY
z+nq5$<*cz1d=efr0JXV-&xKde`o%!Mk{H8*u;D<_Z3AYuO=mzMJ6C{G^L0`?PyV6Q
zI1WfLDK1tdb3PVMM?nf*l+<@z@2oeAF`NPZeV0L2uJb^eU04SFNhl8T?8A>QX?a96
zcFn#}GAMdC%5Um4UQYxTSO6+4QOaHT+Hlbxi09Jrm)fz81=f}WlZ_MQJE$9t>95sh
zYO4k~r=2Ej`4q}qeG{!Q{`wJewWD8F#c-~_b&d0mil<c5YZ(=SnZ<L8y_kK0^$@7G
zK(7IlORKXRm_Ct&nm{xtDkmKKq-{j2!KoDJIXS6)lcD9MP;D6=*bwP1Xdr<3F?t(&
zDvmBx2uj%>KabH<NkM3K8pwYLh8B?ec-Ms?WPsYs?|}|W8mZV}Ks{NEO768$fK-6S
zdkr$_0f|ZJ+F0pt8!J4eloVJ3{E_N?d}cYO+-C2f%j7<B<`;;EGcLmr;n{-Uek2a2
zEHfjikPyj}mO7A&-7iL2F(X!X(>4hwulLJZZ5%vI{9~fM8$|eiyg{Z!O}+B_B)G8L
z##vk?UFk&20v{)(R}@N$4J2{sUGZInZjG0FpnbaMkWqj++iYv4`hvT=`;#ZA+r3v<
z3L>webpU5>ZH;O210iwVQOcWiKbx+0>0UBoW5n;H<@L*-W5)_p0&81xlEzW`-el(&
zK|!N&nm#_<Q~fP7Kj2v!=@%ty7L*8MQyPPiKJOTQOw&GSb-AD=^p#q-*yi&W&<#9g
z)yDAGk@Hv2h#qg4lyb8#%+xN#;TB3VgU_tt8{SNOgx<Zn*M)_v(EVfy7`0l+i9p7=
z&U6jk;VYJfchm|flSCsTo0?yV>R)G-T&_q@@|D-NtOCM7nkXy<9}%4{j$%ERmWd7N
z!|>I0s0fO7rRIUVqIRFssJ;EiSuya&80W7vfmQe<o{)n*Wm6mg#W*D9;*K^8|Dw~M
z(951EC=2b&$bljU0to9eS+u8wuxyc6%`C@T6SuM{wPS2thiy~5HTteUQ*XiCQBe#u
z{+XOjKk)^mLO@Q#vPn&jypG6KExdC~9nL+9bLNRZRL2u!BRc;g2)G?`j%%l+Z)A5%
z^c0*f7tb8OMWt(d2QWHDkxvI!S`g3>{SKy-)E5S@5Nm4m<aXWY+L%0hPHwa423j-c
z{E_w)+Kz>D7`=QczJr8=oO|e=rll`nWA5yi<o|UpyVG}u)&Riz7cY7v8@v2DLB+KM
z8v+!w`f%wok|qKoo67^e`zTGtRNW^Ud4{BHr+-+MSKNCrX-K{Dx%{Nz&%ac&3yu4U
z8cqMxnEHdR1r+x*I7h1qm@~5X?k2wi-PQrvr}zEoj+{fx996FDnr*&%8TGj~+h8~&
zonP+`a2EaKOZQ=nFMf&#ZMeEe(EOv~Wfc<A(D@a#JeKDuZCKI&tGM@!iYn{6h3z)b
zCQxZGkW`XbD1rhaNkv3JKtzfRN|Y=hp@_D$fh<UntRR`9B<Elt=PX5Ridf`S#DcpH
zV5{BF^S*bCZ;bo-6QSyyefC*<tvTmfGjFly$mT_A^V$B@7nyJGNFSD6M{0lm4VZbg
zJ7Fvg`tEj&)+-p7R=cEF(JQ6iM518M?#N><U;O!>7bkE@iw(drxOM2jpiT^^0C@aR
zN_C(QdvmlLgtsu>K-cKgpSJTd0va7D8q`j0X>6s~j_`n&D=&RP7{)U>I0zD|#$%6F
zci}bSX`o*{nYQK)_nBpEDRgX6$m|gXMQ~9#G#ysmgFd4X1r^~I_YVJV=hKg?W8-?)
z7I#f2X2mS*IG%BSD}G-^NB^)VsrzlYIJ&NSqjYP93a2j`v^{qbCDu>(=}?VU-=)jd
zf|uyUu8D3b4WDLYT;4&zs{=p6H~^&0UK4ks9EOfs5pM3YO+*jXhOUAtW+fTpg;Hyl
zh9$p+)8wi^I%8^GH`b_Q+svWS79+H*I<qvx3r)430+)hcLbfMoVT_EJ_^4k?RL-(m
zAd-;&u@)G~!KuJ_$f$IDs4O7KH*&YjV&8t^Fr%eGA&~N$Dk+AoBRGxCdgkw)e5Ru*
z@dd$e<)zPjUA>>fWO4hFV610^psW@f#&&IWE_)C0$K(VO0m)kxH+XwMzdg59<mAz^
ze-@a|k4?MF;Nd{3G&2FJSxe|@MI|Y@w5%n51o;}o@}TF~1Tu^-$uf=f_U<uBh5~<J
zqa&Yc<V+RWivUIR)YGRAuim?H<A%L&!>(V%xT3C($RzHIfB0+Dwf8~4{i%7~?f20`
zuX@h!bN~7(@$IEi*2;|y>6>K_di=XtLp7dH4GXawEIRcDhaaEpcBmIIuz~UwMYw1{
zd1-RG4J*99?#u(6Mt<4M7o$>?Qr3$XR24y7*|+s7{bu?;J|m5rwkBF+Ezz;IC+AKL
z(>N^HtCd~UtC}unqVpuQ{g&AuO;~Xgr7GgLF>K3Oeb0)Dq`Y#)Xfj+{sb<@*e)>YQ
z2u~&ymbaW}Q)pa*d1UKQQEO^O!v<2gznDg*bV44(G$lTrcng`OK!KP<f8PW*R9vFN
z9cCN~cfR~B;~TPMGTOgj0WD*Cmd7%~!f|E(4y3ATYZ}j;R`=AuIeg{u!^N9kiO}V^
z9HfOlrX>5Op}x9W8m(U+5o0~}cAeZ=I46sZi?Cmt$Tk+p%Vseur58vOA}MD@2#3NA
zkF?{g+meHIKgfo=b8}O8Qcycg8Q*G-U3jgRrkvk+r}$S~(aQDv_xDyB<7lXUt00Vx
zMSH<OxQoP6NfUFw$?jginM;O_of!$MgF%tdmnT8uU{3q|Z2ya-)zqu;G)%i)%r|Tt
zJ{Ng7RvT@!(V;R#Gap--JodzFZ#+h4yhJn-0ut&!W%gtDcQS*6z&uCc<Ih5wq>K8M
z9|tkN&JxY_LM}NQx+`%uu65h0&L23hfK@N!v~YS;Tc>LASqK9PSb;qYCF62OGW(b3
z<mH5X6=Gq-*$>q?iT0jRqdB*d?0h=psAk2+aO9BMOd#j+h52T=V?i;}!%Rn-8XF5)
z<xyt6j44hF@nz-Z`C>2jwBx3D7$i;B_=Ad8i2GNnAm$q3QhbgH!_wI=oCV{~FLuqk
zX%5Xi`ZW{+mb%>IHR$)Zu3=7Dv%}Vi8e|Afy}QcpJ&h{P7q2MYDN&2sdeQEmTA>I{
zSxv6bd=}~a>(JgEjBwvkx(4azEsZ?XtohrWrShmIV~PV<Ya>+UHRUyxG&O`-URV;!
zCL!6CH0$k2s#_=9`tz;Ui*~kjL`yISaWPRdirgoZB|y{eB5z#mmoM~RK`8ii_h*>A
zQ{=L-woB_wM`3qfri9=Ta{gTz@n{pq!`#|~RjHCL)$#Pu89yuf=gu~4=zAyYMCaY}
zEQK%LFUA7B<&<wz8^Le>GR&VoG!Gka9s3ZI&84Zb{J7ySx!9hyxdO}<L%1U_+C_OH
zuYN@xF`~I2v7>J$Sp%iH);s%5Gv;Uv?t|{!ubFH4xZi}90!R#Tl~P$~|8_qm|MmbS
zC92WGZuT3eEtFud>`hG_+Aj2z{nsC4j){y}nIfiIm|vfir`ur9bf9srVH!8Wvy3(j
zq`v%7QDvP(G=JzO`R(%*sfHT&W=0MFO)h^pLjG*j?$kDn|0E~+%iOLVJ_ZmviRNQR
z<50y7N%Q?~(XIRL)Rv5jX`WSVDKD3BF=!ri>`#3@aiYGL;hkBGgeL1`W>Y{=`+xdq
zX5)W;w7jM6(glH!;vFb16;Y*gzf#wXPwW?oIM!r+b&*!swUac~Fzi7kaqdL=K<6M)
zN=J8N_Ux?ctUK|6(B0+b;lV%tU}b@d<eq_~(R0<AQ`W1WM30gfxP7)z+CE<i>~AHe
zjL*PdY^bD-A73GG-g&(?Mvyki`hJyexpqf!fqOw<LDcfG-z*ehL9ZC_Pj+{V6G{zH
z$p_-;=%{rf_H1s$l4!_WpL7Zx$<!X-FbnU^T6y+1M}H>Z=6OR}Th2h?>h(dzfy|bj
zC%<UCLpv&WU7lN{a@9|+(UMzTR2@*zH^xTr*K1tDZJmbSKJ7G=MtC<FR7B$Oc21Fv
zp{9d#HHCeyx}Sw6M8uJ6TWR_;2L?Pao+p_BOm(ieWwfv&&XdHIIXn7xib6KunHYxQ
z*m_R@&Mom`42L@{QfZk~@vP9q%zSAavS~=Da6aAdA}3F}9d}Cz@L|TWs(SX~F~Pr*
z%6l8u|2Vyd8h<$37&&IMp=FZ%?b9A15KuM-YN)SE=3=eR2J&eGwKmdxTz5jR3o>_B
zF=l8~iY!km^asB~&tFACmO_l|ifC=f(NG2k;f=Q5pl>042f{REV_J+#bH31D=Fwj2
ze>^yt%*=C7xhrwi&ugx=?Sfl{eTP(5fN+Jgu6df=T+*R_7?3i5bvTN$qPW8EKmaL=
z;jwf3gSl;F`PF5Jer9uL+T3SyS2|Zr7p^=UE~<!|Z`xOTlxoSO5-(unwgeWJHr|_n
zY3Ci%$yIq<*_W`(8>vgn)<ql^x|8^82;1vs33+o)EwdWRD0iuNP%zZSZQ3W_O1|1p
zz4df;ab~h}IjgDtxyiMnwSaP-(}a~1DqL!nSwzacGZ}wlZfFpTz&@K%m9K_~>=J&(
z#=+HFI(-lE=nbzeSh_X*5VBTVMB|QRc;TJ^(FcP;+ZPOqBAhrK`>DiUFj5{r<1&~E
z%G<m*hw7;^wG#!3S68Kb*G(9|fu+AAtBJ4z_;={Xnbo};Ht`$&0n1~R;ypbdaF{Jg
z#g1F@fKGHh2NAUK3)M#P6o!qtidVtL9(?V%>DhuzDyK`81>2$Mr(fmP>lSkOYk1}`
zU3F$N*LWIz>!S5B%k#vNjnc9ZrLE1ogJbhm0Omk@;tneIrQn9TAZ?MQ^n&ftW&g&M
zVR&FRh18b%t)w@CwzWyyHAxWMdmkUL6Uu@u?i||iKH&8{r*R*!ldJ5s$v#CE)dkxk
z;zz>B<3;F_Ofl@6)6S8(XA`A@befgAavzrpebXkK{^6Il|4<o`<779YD6S)a`R#|m
z|Ln+?&xaqfieVpG5^8$ckDBvr2Z$XJoA(mmz4O!;zjx@CwK>9+=mE;!JF#Bsuf==x
z%)*vC3$|j(j_Lczn%>0Gw?yhP|EYYk#XY1r+htXwcdwRc=bhq{9?ivBh0c*E37^oQ
z?LT3J;lIdZhLsYk%G9pGcDf|@q-J;b;TT=SiYa{sw0fKE`$h+QZ}jHq^=$3O9n*Gy
zKfB?^WSaV^b!Um!K7qQ)?<3c%))pv9jC1X6@I1b}`Sw7lsQzAzxrc4;E{=s_f@9XD
zYL24!@q=Q;A=?Dk4l4Gaey@?=d_zd2A5yZ~EoJhK5;5=Z7aRf$xB2hB;@=lk&XcKa
z^0=nAv)HT1xmjrY*$Tm6zF%^Hay->m_gNFADT*Owa~0zomp;d+Bvz<|smyp`w)gM!
zneY36N(Xz)X^sSuhiP0`e__AOJR!)D>_~WhnC{!Qc_Oj-OgHyC=A}`oi}M;ej*HeL
zq0z}A&wb?qSLN?Hu;yBEH#JwuRC8OgdPhk#5Dwqg{rAlN;DAoF5Y2n0L|v!KJ~1Y_
z^|4UbRNLt9UvdoDBNh(WuL%m#eSL3tQVb<2#CGLn8UQW^Crp|_{b}>d(3N#YEo<b%
z17RpbQqH$ot&)1Uiq|sG*nOB;q1Zx&!P?NIhm8i1+6iK2%c;^d1uc2OZa~sRW~}WR
z%z;=R45A^9T{*gnW5npr0T()K%Mi%CcGkAG``mT!dJU^FoX5~MZMmZ#TvUEK&aE7<
zZ#We8U>28%Nn9-)Ixv90BfVaP73JhuARTbF>Fu=u%Rx=joHR2tTuzq5qKP$iC0HSW
zS}m^d8qL|?@5ITL0?PS2$K8g`PPLo5a}+8#hTO9-druOk>Mb1Sj*1(N3HJzB@)4@S
zoPoeU^2US0J49mpA)lG|3DH<oi8S6XO5RmNy+bG>8lcDSIXRi%QrUwRIq&c*>Bw>0
z%npQ<Ggh-zCn}<x)|QN%)<AXVbwcs=3?P0CSAKthC$?)T=~oA;=zGvOIQJG|$`Y!B
zvd?L(VDfDim~_EjECs7lX#WYT<^Yb8nU;fJ)AT&55Z(7EYnX>{`BlalAtVNF{S*Ax
zDrKOBcu(mr?k^p$Oqe-E95Nc`C^Kp~gEE#1betKg?T$?t86le&$ZP6*&^qz44Lz|)
z)Gk%hU0WXBd0u1XW_R2PiEl2QApaIix+Qk~O5zxU*XB3BcgET+Pvb;=e7-iuYw6at
zb1|${3LV_KmcC!W{paULmVy>)O6-8^a2vc;9m@e@g?dG`99}FBg&rp+4?z9#Q0p!z
zdXG6hS|vR)Md`!@-JsWCGA{QWGrql=d~a0o_;?#OIIri8M!r7O9=BFvZ#sBi^9bvE
z!IZU^lG3QR=%YUexjxe8Zu^(A_6+GjPw1#}OQsiIA@4t$MK64U<3*~?#Em$mvM=;6
zJ?XLJ1G=|vm4nj;J_GDs|1`0K_DQvDQccK$O1byJ;aWOvRk1KxVvBna6?tVYN4%4c
zq!AdMx9;wz#de;L>)SiLBf}>RfxquYT4icC1-uhBo@Y_>bXv1eQ+XxoqG>H9_iSIO
zuFRuHuSA+~TE@p=zE4-I+A(U6=rNrM#Og8u?Kl+7uJ@=VzK3Y914g%}!LYN1LzqPW
zIRMo;)|!-DC~ZtmI=4=7l9^c|6s?)_A;xhz2W9B75rSS06}0uXnIKlX5?iY;XV1<K
znnJ5)3p!SM*xX~I3=h-ekF^Uev=DfT;NB;m%QvPQSP_1mJ!zqVwHwXXaz2s&$icO!
zI!);!+6^^Zm<#oWd2^r^dBGn;x4o~ZZmu3`MR2MGj5Aglt7@pykTE(&^oO~Oy}rE9
z_8)DK$T$m=sEvsIy9gsI%7~YsPBJnO>pZhz^9mSv-qbL!IjU8_bWB;B*s@OaXM_hg
z_B%A(+AmFOW9-Q*DUz>6q+XXPrCAMg5~Rr0`Yvl0!9v0gHUuz>T$ph)J}sm7j*N1B
zdbaXDPSd=4tg2bu<N4~!iqN{9Hx%Dv#u;E$&qmNGbNqm@dSesMBHr(=Iy3%UxH?U-
z5GUn$_MvTc100*`<cSOn@79ey@z=>`7Z(|me)at|1}8_Z!g~$0z0wH^_TXvAVGQw3
z8(*~^+5?->VX6Y4Y{o;cB;=r|wU)74dIFPxQjJ=3WW!IyND{^fgmcV9%J5rhO6Jvp
zn?9a`*_D@J)FFdz0lZoBzVJLMZmrB4%0+4#s4sUIXqYY{E`^?u+|p_-o|yW@X$%{}
zbJ@7fVC5wmHB>qGHB~3cQ;>z@h*FEYlCubhpgI&#ljxn^waS=@H#(u)X~?6HiHP5q
zlew;?AlA4S<lx|p&_Wq$9S@ne{R0Z?a@q}sP)buhPuO(~2{c~rN4YXg)jo+H8NK0G
zXy2V*%)0*se~Q_O4G7CwOH*91^wE4xG16VODSRf%tr?c^+_F{?w?~_?w%a#h6xcJ1
zjtbvG-49m7Wyq!0MT)j$i20qi5XYWLA+Nu{Y^NMg#=2KO1Ow2WI0x>pH{3p@y)|xU
zgDo&2k}HH^Y?gp4(akT;=NYQ-)%*DIT3N65<Ht_P3=%0g%<6>dsZ$J@=2kErtIvxr
zzcrwawL_<&s7q0^`w}CyRY`BJTr3#(CVJgV37eM6L`*WXOoF{?jlJnrbU$boR;}=0
z(YHTl1su~+!rHCO$C$gUpX21=V=G%@+>YcWufI-8E~Se=GLS-8&eVR*)~a_c(<r8u
zLl~=C$YFf;-kDgRhoWa-^lTDQyK<=ZLDrJPLYU@OV9Mx47d(0(9U<gX*=*Jwl7I@A
zPAk8Yc<->v1xGt7>$Apfw|O!lrV*+he6B&YrZqGMJlnT>*Pg%&F>;Y;#Kkj+tx<KR
zdOC*5M}5YomnKH-T%EF{niT}rp~dYb+!67`1}cyzEknzh{Yx`s-D_Y_gVXGOS65cn
zi@18ioRynQ^nA%LJm1TVEw*cgw#u|1uAZqj^tnYhlW16z&|b}?xrKH@YpE<thmIY2
zAua8#%Z5!Xv;;23NfJ;BYT2^wH;r0esu`NBX2c`!nsIC5NoLnQ*1XtD&r};@mT~AX
zVTZ}LjdM>|Yf!z~AE|lgEzTwFYw2xWqlU%X{8#e1V-ixDS9qafm})9=7DW1K`j9pd
zlXW}N>h;<>J6A^<Z#hjb&9oL3iDdnW$9?_N=(<FEIUX@&E`$lmW(+LMxmLpsE-lm7
z{KmN}Mk~N>Oe%K9yjbJCMux}HY$Im!N@k!h^cNiq>MqPL2BrPhzN9?XpmMV+Xk+Sp
z(=IXWNYh$7L+m*ht$-0N=SB}N^rhANokuVFFkR7hHr|eFeZD4(P_*1Kg*QbCrsbVB
zPSdSin#lIJtpH<m7hcN^1$K}o=-$L$u{Gl)K(Er=&_Qk)R%P(V?1^AjGA@-4Dyj_P
zntTGiI`JvCmns=Qe{|hH_yO=Qm~I_lQJ@faGgfD5eU;U6lIOCeF7C~nojkJypK48)
z!eo+0!fc6K0J~gDqw_~@K<8#!WuS;L^i=GB+SNK7WG*lqzNk+{&+9T-;7=~zE@gJy
z{bPa=Ry(0KS9JzX(b<!!70KX}usCV{>;=_@!G?FgnbvmauOfjmttR;50j3^^ph4Za
z=~Ljs3val2U6_hqfqHHb^k*32=N88Db=4hgjqvje)?;kp0_p3diNds8o1@_gU~lSl
zL?We^KLMI5c#YYrQcT=>T@nVtf{0?*fV|76hBqwU*NW{SsY@;0DESMYNxiY8^O;JN
zlicT;qjv0~{%x0m3LZj_2sy*mW(7d5%256wA;3r%-(J%gycT|CaoYs+nu|+uLxZg4
zE#T{}*gg8|y(E(teTTFb@)Sol7$OCit5==XxMMbO+bQjndvBfij1m56B`k?%!c8nw
z`{{G44V-+wl|e6L12c2dI;yYPyg<kxlLA95CczK1Y*MqZM>dpi^0`1j!Mtm-Tz^HJ
z?1Z_x4v?1Mb?|ED@#q>Alcq_?rXT3af-zQhRI>lre3I?r<T|5pi1Ff4A`Dx}Hf}eu
ze$gEFf|g737A>G$(a@e3CyNcgG|H^9(Wb^5u6dl6<YvPhEk8G8KC&N%XP+P!6IA0y
z@;1Ize<x{1BGd9F(?!~8omck0Vc%gV1g4<X4zyt>n6%||WAbuC%!`6kF;>b?1uV3^
z3};|IdF<`c-WciEeSIgFk$jqXf_J#i6f{<Mrh29-(0%~N`p~t*rFPg(jw>LZpl-~f
zR{Dh&wSZ^F2IbgWzsQ<}9l#?q>dT=rJ%&R;e3PVi9j&4l%#x}*&GMd5@`pxSO1RxB
zNz>YV@6CMf8S<i9q5=t5;E3r2FmRxibrzT9vf((<sgOC|B_K_y+!jygNAb5h<~|~;
z>MCng^%c77=H0U~TU}q-x$4In-J&v#_Pa;<Elu6}J*dV<_EIr@&@NRb17CVHE5lGh
zsizaP{0@XNvtjg+Y^Ykc-qR1DpWk6dNKv(z8@e!o;&vMz7>$c;=&4E9t$YI;)7+d3
z6UMER2e0bo!r5P_X%=Fjx1k><+HQw<RIXALf}&ebCelCxOEhP=sy!gePIR%`w4UDj
zmgE~7OD)!s3%Oa-&2l9|zmyPilhAN1-!0_zI;4=JHuLd&6}?%8StvoPon-hwP!EtT
zrrLb}=I`|#EY9Y?CjsymkLZlV_s2=TCPF<$$>4q`E=*IBG4CHA#i@X@SLH@0p?3=~
z>OjBt%4EKbLCtUEF<dRtUTGj9jxoq~$h1>GUO^VeLIuRsx7*$PQtvkRAlrIT-cw&9
z)O*sec6V9NWN33L#2#32h?dNIye{^_#>Y+Ityw@?>PE=dVn3nB@MnK7MSRCkOCg|&
ziU>KBw)#w)G|;ki$l9u%^|ba4$bJx`0tGWSG|G9Q_2^1P@Wrv9^JFB`$>6VnmnKOq
z#$=oee9C{iJMek=8Nx<lS(1KS*$b9H=5wL3&e#z{d1LW&jg6}iN8<|(QZ$9Hbzj)6
z<D&9#Lu$6+@6nYXj)2=rw}I35oTskUT~g^eDY@~Y{roEA4$#$RH8(W5mwJWQ@GjYl
zzY6lo&e!biELpRWE?EcZ+M><6OJ)eG3F)!eqIG-6Y_nS3NX4YUeUy|ZL<-6w=kVGO
zpgHJ#Hh?GDy(jQhK(BLtMFs^g9I3C{@gE+zUx{H)1)Oo6X8+OiC)1&{yy#v2g<d&L
z_g<W=*T5Yh+K-&Tk1qBW^O>TI2Vz()4|@_&O5Tc8l3e>=7iR5kbC*>=-v7rBt8YH2
z{!?k$X)KOyfRR(`33tWk`Kf)OT}#+uC?2Jhd`vB4Bpn|TA-u85D4%%@gi*DyqcQ@Z
zI=5RHWzQ%t<B}rJ)gOe)JnR4@Sgcw_U9%<a?FKXbzGdx-&6&p3DjiUiK#_6;XoR&T
zXGD0ju-Ge)e@Sn;JX@;UP+l&0@}wM`8iT3D#l1mV&PH9+lig&zN|;Dt-Q}KKE1lyo
zR+O*ongk9zLlm&pdr1L;ovn=o`1xzipFr;6Q<>Vnr*}s>krF!6DWJ=|3L@Q173!Jp
zhx;ELA$DEFa;oQ)T&x!oFz<N<^GPsJHa910dX|2nk4H+tN<UTt#FVJ$#p*sdyrQCt
zTBgwcysA@|b#L)wIGG`jkqd3(f;#@_c@u8N_Z;c^PPFv&zaQql9^Ul&F?Olj_AtIP
z*2d*sfqlSP)<MJCkiqpeE7vT2Sd!7^xCIhPv)DPU=pA)t6uG_4ZXqn6=gZFTuf7}U
za4I6(AkMu~omptF*38dRU=nh6v<|sc#8YHBsN7s-5P^Yyc^S6}39d49^0A~sE>`ro
zBpMfSazB#m(jTCt^t;w9{8W}@6jXo9XC|h>K#S2~>Q<UwHMFntm+8U4(^oS`Soe)F
z%eJ_awA9GN-1(|kKZa1e#Fs7BOUy{T8Mh*tVZMu(q>HbrsAwe0wvaQ-d#^@_EOs>$
zrG&$;@cQur-A6|u;p42e2W)xXrr4g5YzNa)r|3e{^J*l_cp)>AYscz=r9fLCwEv>%
zETYgE8+am0!(Q*!*&jmj1hY0GwQ3m#F9#3WOg*8?m(O$r?5#8E{cE{Sa44$on5hg5
z2LAQe*^x@HnmqudIHX3%*A=g&U3cj0%CokIuiJZY;(f~P(6)M;sr<V-3i0UMBz)d~
zyGQWp;WH&x*#U4=nR5G4*5lFBvtR;z6K)P4vX91nHw8s7kI_AI>q0TfJhXbo!<?Fx
zB|EV3lZgmCOJmFO`NiTLCH>kE$=E<Hrf6XqUsdi7<FO``*j?!D{1%lTG93o5mtWqC
z_<;9EJI*A3!{IWuT5zAqoja_Uvo5Ux_C1bsyeia3n&iXnr&%;mP!=ibqtK4x4j`)#
z2)(;c3IfI0*qDwG?)L;5c(czJ@~{N_r=9avmHXsLA5Sh7p0mi(!DL3U2z_9Us{$s7
z+Jun)()|evR1v_nPIP`QEG#r#bXJxJS7t#B@<q*6g$~12IXIk;Gp#*h(PQM)QR<-v
zz?MOJ{{Og)KV^(jqpPCr$-!q_1&}O3C)+Sa)sOYE13(}EO;z3k_^Gv2wJyBVpIgUX
z<)V{){FT)w2$`(#dd?4~_VqSU_%M3GycXHlWsB2)m6nx4+da4)bzhDT4_Y?{>ARWJ
zL}oue^wHDIDC+jM7^Ua$5o%#;wNZ^C2eUSLZHU*TFYi<vfi(pR8N#Bl{Uu9$#w%c%
zEAHDZ?XZpshqwf^H5V7x@nrev@vdA~y<tN6Vv=fRON6l1JTK4W#KbvV59CIW3an3m
zZfZ?p|MSnsYxB*NMCp;`f!Cy8e!)CHDBTx#XyGA<fAo2E%~e&ilIK3{U(U3Z#yHLm
zxnMQN3+ZSh9eEaOf_Dy{HtFDzX{&gtzK`JL<_DUhDmxe<!6vhEE6aXuh92+)dy8J<
zko(w?u1xF6szX%J(Xe%2_gV2TYPQ}>DC%Y-cEgbdF7F9uDK}9WY_e<99R`t2y|>rM
z<f5g1@-8Jj)EzLe$6we%-6M8xPI|6*quchruW$6+V6~|_Gd|n=ZPA|*DH@>_A<ksg
zBnA5n)kYSpp#uv<#hx6C#5_$N&>xI8Ez`9JomGU!K)qN!QS!VZOyHR3Ep->(n5(aT
zy<}QSgDSgXYZ{*Ob0Awc#Qu!WWuR}*j68!51_z+@FY8HdVCJ5O3FpgeU;xGh_BhyV
zR@#Py&kTnPWWPOf6j)=xIFxXccd`qe9HwGr6yjv|2Ma9|^r}UIG!l$G1zbd=G{-(Y
zI|on^p<Jo@gpO?3E&c4&ncjzab~CpG4hY~~DUK%Y&j5v27Qi{xnSP(!ZmzEj{vn3X
zwL;%(37Rb#H69xYIK}w4<z~qyy6!dH;!gbi)WAP;vTZ8pTOPB`D{WFU+a$ymH`S$y
zx_QI%H!7xAeN^j*uQLjLj{}?8S$4bopNE2eILD9-ben|vMx}hm;=do=|Md(1Z_~m;
z%afa&&~{YXy?Hg64)8;szc2BB_+g>t9Tz{ZL)w4*BbEHW{d%x?NM`uEnEy^>{5yF^
zsI<RN`Ttj|V^k_}O3=1$GwYJQD>PVDNPp;+0l?-&|7KJs3?TDkmA;uksQkx+Bal>6
zftP^H$kVVfiUjl2-=*BHg=vQx-q2M4n|0M_yun$+mU#GFVP~>+OrA(gnpyYz3_~)c
zgaua?o>-JB+P}&f+ebIoqTo}#al)*VPb}QhJ|+;H(yJhws`6ha-fQ~DHW0dxwObk|
z8d7|^9(}V)3zK~Q7GE%r-YZ)lF#OrIYoIa!mA~%Xl%~gEZIM{oSXCbJ(BSOw8H2N!
zez&ldN;tt5$2-<QMnObVy<u`uXTx>oS--ln(6@CpgZo0YH+WNBVj@7CYv<sA(-Kt)
zmpc9TE(sW6a`?H%j597}U_UMWEOTKm*3c87RWG|eRBRx&QfI^g3}M)j=1mGr)33c@
z?L^cau2Tu+f1v?qXt)#~jIZKUo$tsruBE_*C(PWe5ws;ueC1BR=6V*tTr?+p&Vi)k
zqODEoe_n${E}|S^gz7}>7zfVgp7z#!p!8)utzkXD9?986A3|`VU!jQkUTdsoY%0eV
z1e8#9S1t=rl;B0)@unZ3JS&o**E&tf%0@AK4D3sE)%9Ctj(8-XJ-w!6BcN_RKHiSY
z%<Gv`h`RAWU<qOlzgJRBP=t@DSyG|LdDTlo9ptZ(yZ1k@WGwSsz8apUOJDdY<s}(`
zw!BpGZK6zQPT(cOr8vK@*h41kP3fZuyAiTdWP)I6$>_v&eoFcb%qv=qx^O{s8z<hS
zK1vlO1v+uXJr45^%~TziXS4p;nSU=uJ?)n7Q($*Gk<k3PGkdY_&Ed1@dQ}DYqHg?k
zg0~7>f7ghu43rbYg^Q}YC@9ElbC%XHavBSD%HVG>T|5;eS5w7WQMl#5Uc{ua8Pp|P
zP6L?lU+xEqKxPMv6b{%L5L7*_sp{2TWX{D{Edo>mQrT4H)Zv{wr5{grExBx{y`4ld
zB*52@4A`sF>U=C%sGE(qj+u7+HPSehlwKxtcVHzcn0M?V2K(~mVZdTnaUU2RQr?>+
zk*O;NdA#ex1nvm46mmjR#-@y7bI^llE3~W&77$jz1D0P3Q2u_Df2*w_Q)P`Sb6Pa)
zo40`(*EM4o2_dCT4<=d;QhTbRZc0qGJJXoMi&7R)OwNJ<)&)H4{T}uH=hRy2xx9jc
zl$5`+m+`_BEzD@lQ@r5aBF9{5|1*F%(qa&EpckZQv<SYUDF){BI6ld8k-=v;)A8MI
zY%{@MYP}qT+>0rnTa)x@inrJeg3m$8sbRnvftq;b>v_CcDgMs*v!k=sIs(s5iRB%)
z1<#AK$GH>}U#_T<!aOYWZhZM|!rcw3s4@H2B>%hZS~36}nN)U{7;VtB-5f9Qvz?l3
z=M!?W54R`)xSMC`uNS7CuHKqzgx2)ADzKvK9I8;-rSPq19v$UE9QjGl1b)I);Tq9S
ziwQF#;ySuQ!yj_Y#R39=kZV!3=qowT<9E>jO{jffJGJhR-Qjus9lip{O1)0V#YO`H
zlEDN1RWb&0kFqQTCC@gW%5)J;-K!{qzqP)G0lqWMnLJ?JZUe(&(n?B>@VwzSPYLC>
z9YayC&NjW5#xXf7Cl>mqsPS{Skt=453ALfcr^??Rtg=9;$2~!u$766|eCKZ5#AhTJ
z+rLwms1sK^4jjk%aX`BfC0ozx!#pVtJ92BXD(`ug_t6Q#7fauvOf~`@Z&nE>a1r53
z`d>dVrX>TYUG|X$^dDOXn6ewmB4)E(vdTao=oD>b&(L?{z_whMmwRS7q3e}=k6$TT
z@f!GCA{w-%X+{X?oO0><wHel9PNEGtk4J}jG>aU$3HO1K(|h#kPiH*B`xsA&LvTvq
z(%o>@4yck~G6eV%Lei)!?DNf{!exKJeTHM9>Z8^({pg9lqvzKa%Qud6`Pi%hwwwc+
zQVT~wrL&guyXJiX77X;26EQSbk1budYD5>!-~9-T5_=XC`D{$zg6(-qjR&i^_nY+~
zy4aqi6`X5DQGFkp8a-Vle~^kz5Tv#$qlehb1EGx&#87hPxGXpO#JZ7_#t5o+0=thV
zQM1r9q1YEeyJAJwbFdcE9$Y=y$IUACQ&Ogt+TM>fW$2bmzPrqFIZ8bL@PsSXdcHO1
z$14~3a+{D$3O_1w(_2<s)U>nh^)&&7<{=0Y?R*;(*#Y<p!KoI%IH+|lU_Gq|)H4FK
zT!b~d-SQ%TFIcbp@o^DR6U98$K|a18{aCdwQL_E*=u{$=;e*<uGNUu2gl$oQ5qNxV
zK8;$o_gD<0i%>aq#N4jdbin4Uqjiq_ey=ho7Qjzp(&dau<(OH?M>nLC(B@S+YpoJT
zl6UI7Mil}pA8d21Gy4U5YNS+vX23^?lkpC>B1N#bv2a{D;DJV*eT?v)Qmgf>sZa~W
z{=MM3?k(<>nrf@KnnXo{?gxl)GF-kt#GOV_fyX~VKLB`<*0Quo?-s&VO-q5u{T*bR
zLQZqF?YFC|{4tfZ8#KPaFU5}324}_Ult2IBx;@a(PE4^&f1vb~Ntp*w^;J!*B*9^U
z=*>b>$a{SFI6WWd9}b6LTe2vi(4MUkHX{vJBb-SpO4c#tVZX0cy9^YjR|Jo~Nclik
z;t@A0)x}}SN(i8kmUcHr=^xiEl9I7m`oQ)2MNz9Q|JimRtVed@cUCZmiTR9Apkq6x
z10L{??mHup0*^)ii!!~1F{LaHt;2@yS!|=dVd(~<sZxWl`(6ej)CdEcGDR7il6~ca
z&i>*Ze52%+6b<=3tE7W`rp|LiW}x>ChHN^Jk4O8490ngPVbxp(Z}@*(ZO=6&F?5!x
znq0UPsN=TN(13?bN<W>9ds>=8#0kP4v&v(?H&Z5`Ge)9(0@@!6FMnSE(p{DwB#6Y5
zE7YNIg0mxDkUK>(Qe*<KXks#X)lKni<Sq%8wATd~tIDOSfQ_CGS_d4ZdV$@0!$?Vg
zP0JO0{>bx#3VuEHPkss4`(Qcf7b{%xM<vXd>IKXv!xyU-S6xA8?$5uu(~qbJe>K^s
z=`!5kK$Ep0byH$P4Yj_$+P;z|y8iVQd%X_dDp+);z$1xO!e#5}!AV2B_w;+Vc4IZC
zX_MU+kcV=Ne(A0;?f3L!R*BI#yg%8s8A(1=Q9VV4ivddeI{ICNCqX}f?~9S{)vb>Z
z-y`8Uk}!Fr8Y=O0y=qS56TFEwi<8cTdynUf<t93iH+lpiuK2P<_8+AT`iR^)_n0ek
zx_^WtDVP*|f0UJi&uXXyj;rdH{3$+OS=O9LsG3%nV`fOCo=oE`kuxs<QtT?U#i~(^
zx?1jLbl_A2o^#%+U1uXVzWrLak4Wg#_TJpfkDpCI!&*%+fmC4BdU;|L=mSmXWdSIm
z)j(qj)%ZF}A+|;u2rY;nN^wVis9&=jeuf@F(qOVC>`}^A?nIZ!9rFo~cZrOm%>?hl
zMU6irwN4zL>Rx4VdIU;${C(FwieTQ5g|Ye?Cg6I-+DLaTq8`$+#f1f5UR=T5hc$1g
zVrBL(16T+a3YX9lq;UysbH-sHe_(7Q*c#l)Iw7>w4M!dZW>FQzJqBN$G#&u*fNZHs
zgOxBQ;DgZ#ckgc07Qns-+#=u_xD$&wsRpkUe<5A8f81qi$|C~1{CJQO4m^-ND-K5h
z`<_D~VB1Nyy=s)Yq24m~YTiUj!-ZEPpD(qv-5OFK2^_q%X%++`PXw3NBxH}BMNY2p
z5FpRE3SfbWTZ=nX*n$?O6S+LV3TDET0nQ7PXJItcw~A6bzx-#gTmxk!;ApduvGc(@
zdFDZ!5c()f=q_k?G>9w>FoHSMV{I}`6xpVsGfmRF7Z&M#fvAFz=t)<V0<hV!b|~aa
zmz)xj<#EjL1(-B|W6rNg5s2;KItG)j^no(3?$)HB#`Y0CKbu%Ka9}qD>B~E@!?EEk
zsZ5m_hNo23Vv`i&`V$n4WgITsnkhg%k5G<=UF%lzII*;J4oh<DS1nWsi^VgYi6TEp
z{xN?&TU$Ai``%?O_0(uD`tc+lvc5c9m+JEJRcL02EoA-Sl$fWY`bqoLv$M^e3aRkH
zc3f(MK~Nadr63Ep(IW0jU<188>4gpI-hyaH3$W5|gWENK0D=X>dJ#&vc*EH(?_>u#
zOepuJrs~GNwy&$wZ-MK*<g(r%6B^r-Gt>L40ww($CP)u}{c)<t2NRb8&?cgdTF4J`
zog8rVB!Gkf$$Il;@quhOUW-x?v^*9K$ep?hr&BqTTf;<|SaC2opVnH+$4cpI9g3rR
z;OsfoOX{N0#T&AHuWTm6Xn->!eH}Fp{Tcu>z>&Z^RoH&Lo5k(>Q~noe0r1vmzg<)3
z9L_XlnHDCiTqMsoE3H&~b~x{2d0w+i_3hQ3vx-tDT;4WDeE*b9Wo$gnM9pWlQgMl?
zsjl1^cv<FsUo5IK4vu$RjDtEAK~&=W{#9}})(MR(c7Y;jp`2<pS12Uc#?;{PytB1X
z$G<=R_Khzur>B2GwBT`!dCH^ex6;1HyZ_H1#eYNzqK3gj#{v+%019A89yY!AY1vKX
z5MfWWSk`j?#!~&WGM{_d;?7mHbo=U6M&aH2hmth%`=LV70;!os*!`*i2Nk}qZ1adK
z0jE_y+<$|^)dR*fI0J$hK+r^1laumlM&G172~1R!UYI1;rD&wLE^JqLlK;Hle^=wv
zuXL;Yuk}Q`gYxadhcElN2B0ytkd&erf2RbZdi+>xPR0m8a1n6oI80?WNW{ucaB*b=
zaAlop)tGV>XpF&q509RL7`l>g3uLc4vc1ph>1^<3xUfosy7$}ZITAVczgFU{O^^#A
zQbm)F;aCeS((Cz@G!Jb?&{nrFJL~uHn(KHT$D<$0a{H1lkUv1l2?3xGW0h@DAQj*T
zEIWd_b$@YtsMME)E4o0rPU@_x3#T(S?*l(SPlWM%^E9=X^PiXaZ?RsO^&@-yADK?q
zjrEVy-*dcMo%k1nW_Z`x)dqVIe)A-m`CZ|VkNQw>loiC{3F^7;540sJUh9@K(#K~U
z67c-+LGCsI*qERhh|me4mwh1uo{N?!#udJ(_Ki>HIJPM!^3(khAh$@_suiNpT^6UC
zM2i$4Gdlm6P;xDl!qB%|Q9q+SMEu31ijal23~*}^Kq5VPBE)MP*jXUJd6rlWV%5XU
z_95s9f%GEK7}X0eW+ZcJ6@7&Ov5){Y(Am(3TH`7)Qj!?Xjv`_8P?-;CaG|`l2c>jA
zLD*@kkT$In2E}hIw1Yul8^@iKQ;>Zul&&OOPz7<B(_P7MD0Rm@6jf9P&P^t?$ZVys
zjKy2U!(?zcXb7PDSPMxg#^CfvoS?0%-l(LDyw>q}dF&nN2*Ajxf}_F&vLR1bsLJ>5
z9aS!{J2f#5f{Y@wZkFcfKy_wHJ3+BRSON&TRjjG{lR{jZ&1lp6SL2sY%0aP_WyZVM
z0AyjMrljBf@8x%+n!wKl+YPL;r4b!gp=H0gPU17$R~=h5c+EO_4#`Z+PXZhcOh#sq
z=2`HzRD|N{cmmWU7K66E;?UT|XKp?PsXA7x7#g4~ggXEd%jjSb)URTMcTV?$Qp&h0
zb(U`B8B@NGs@xYo{CObDL`A|OQBehWHnz~}ogIqx5w#1YMvc}36=`vi&e!)Kirk>{
zryWr0IZqHpUvv@Ms7@dv$7F_TFWKi<bF7SpTEE8IO`sbpSp?|zOQ9J|Hl2|TQ;znk
z=n!7kH9PK0jZ@?QVA2ug>})uYFcb2n%*8b+>n})dJPCN)B<H0EbcDAyh;Gx5-~2r0
z6`yIBXyCc^Ux^!c%L2-h!p8$x+<st=Cv+6Qm1}k*<0mHa<-8U-PB0S$UbF`BrrquC
z@(1q@(Ycz}vy+V=ga)0Iv8%kimdMNv*-kRFnyEQNxQLW=cEYAe#aFmd8(R)k^uta7
zgEGyEb*^jOdDeO3GJ6)TODCm)uK~;jsAQH1tgM*mbXZu3jgs~r&K-^jJS^aBni@Da
z96gU67Z~DDSgDppQ2(iqZxAnQ6OcM4DU@wh-2}*pK@|#28eseZB)%g3+Am+1sJZT)
zxf%hQym3GZ@gYd1PtLD-b2!m_<OcSPV1i=OC&&y^XM&QP$yGdW5ST$Dg4ilclJfiV
zW0~%o{GZG8Wv)&bB$QxgRt5XgbVj(jHZ<Rh@S5GlB)=FPCTRP?^B&f|*8&j*f?tBO
z787(+6#yFm@C5~xvl3l`e6-2!nqN%4(0cGzAptG6c0r|Zq{+Lhy4rZECzq&wjzn+e
z!&p0Lc<YvgwG~*Hie<Xqi=&rm%7iZR-mm@VlrM0SdVGhggF2OyrDEl%0%m^QJxfHm
zQ64?|0y_)i=LbejW^B1b&_t!q2$bZJt$}S2eu0pYNc%>}SXA&wLo`E2^k|w=FWd`1
zyeJ&M`Jl6VQ&`OzCh)ENUUK0lY^fqs(I$;iS?AV=a)I_3g}3#LD`)|sl{gQ5X_iDX
z>&$|DTyTL`H6Y-tunRm)K}(E)bquIlRXTlEP=2bwGrk^A`WpP+xD=jkM)hgj89BAA
zWF6^|-a%Y3pK-M}BY83VB22E6DSmS%0gcV@T%07!YNIA{{a8}JpXX6dEL$=s0FWkf
z)l%nM+H88T%I~gsnV+FN(b9S;rOh2*wX1M>$ap0UY|c6!JbH8oxVv)C<-V_}im|+I
z0h++gmNPpjC=pYK--PleosyIAB4W+XtK?cH*A&f4owBZK1UA!ogM4J71pK<r$swF3
zqYEi`xmP@@TP4TFw97W8EcOoeOi-i#lCQLNjIfd)3+;E7U|vq*r*sgc@KM6W*f&lO
zg#}&IQf~(b4PbRf8YW{cGSQrBS@GwJ#P;nSeOQGgK6<d7%X-oGUMr6V^d;K}F<fC;
z3w>F}E6D_IG+w&3AWCYfW%Zyv7}QY}Af2e-%{HnkziOiZMFSmwe~}kos>@MH=*NW4
z{3;h0!UZV4+pq*9XbK)<&1(AZdqIA7_B|RPnw@dk3WDNpp4BF!A8d%vjfm|yPICs3
zv~hbSWoi@3TJ_!oq(zkVl+09>7i1(HPJ~rN_IX>us+oed6b~5B22XrVeRpN>A;c^c
zpu+kv@3$qQYA0r;$Kl-VYS5nz0z;{=!X?FqMj2TrglB3`;Au=3H%fG$DhZDMm+k7N
zYEkZXtN5494E;vC`Y55cE2SAbjjK;si}6D9L}0cz(v%Bt(@Gzci^&-XtrP1_X0ro6
zdIP}*5d~HTk$FtQs@P+Pxj$Ws=+BI@5rTH**ekWi9K12@DIKvFd55}fL#xJ-!-hlR
z^$qN0^PWR$Yd$iQpzNYMjz~%UQHyDYgJoU{dO{%MTq#z9QZ}>SycpXOR7n8e)34)6
zG<sCvR1`F`FviaQ-&Y%)>3Qb*E^RF7b65Ah?SHL`J~(v}8oSy!0Pol6X8E|b&^`p5
zYjwWFojWn))nS<B?}vEL)rAuf)b_sD3B84Y_LPYl&<~!=RclLB;$k*NRE35@rN*U6
zO144}l#jz(G!N*&ydG2^#h8ne4mWfr1cv}IPh*2t0KiNY4S<#&7!JCb;&(-_2CxW_
z8|FQF-~j@jkE-(Cj{v}&J(9I*P78G8!Q(vdVFowYlKF|8kyyeTm+I+(Hpo-3aeenu
zF2)35GC=f@cr7d}q_W;c0U%Ujm-gU6WX1iDPnQSozWEQ4=)aZLaTz4wV{RvW$g=5)
zi#LG2TF}gonlnd1DL~COpI&O~RTj{hRojr4Iy>kArnlEXcLk?IJ5DQCF^PYH7jNqh
zR(UqleYScZamDKn`!(F#-Tk0?f*t@aS2*rLZccNgDODyk4?3Hz;PJ1VfNcP<bK3po
zS?*XRA^S^B)zxF+wno8at&b=0H%JYenjjyWV*pSfa+Q{Nd4y9~U$;=wT=%B$sLpU6
zs`&#-SxeSlm*N<D5~z|h1h0Vt>e2EnA3;js=<)gpVUMt)wb!7EUxgl>hpv#jK$2iT
znHvW_cBk?uI?{8KgDOhzDV@M&Ara*Viq~W@=O=Y!9Hfpf>Qf?YPI6u{dJmn4#9tl2
z%tvcsv^f!0X{tcMxGwA(sE6o8MN-iB=%U45oQ5_RkTS&-Pv}+$Vk%ylt^C>n95a3;
zd7arKC7y;g-?sj|%B(nf@W#9Azkp#)R}Nc;PLU%<4c>qjb9&R}*c8AwaxceP@RHiy
zZ$fI0&N69)j(9{Kqrs(8<XAITPcbqEVqfFVtO$F#fnFC0s2y&rL6bXkyH;I1Fa=pR
zjKp(KE)Yw}v9W9?Pu7R<Qp>E~o;G54V3qt4f!cWTv-D6H#063FBaK~w4Yt8XxsM)H
zw_%(4%_$LC@fDPSvtwqB^Xfzt=!uCY?h+2U;erMU0ihA^eK3tte_0m6MjT;=WX0aW
zfr|dCxJFnNxb4zdesv(#a67jrg-jKByrKqci8Izx^_8!UA@&<j%s?DzSodntlVpdO
z)bjld+ALXxK5XjTVQoyRYK_`ti=DB}F>@P}`M+Tt!E2|SslM^U14Tmp!6W_Z-;-0Q
zIs5p`a5TV^^%SnE8Mn*AR-1)`$>XSxBk(-4&UZ775?XTG8?25TX#%smkF)pdBLv{A
z#UL`&gQvXz&E(Exw!4o_oyuETK(Ws}i=u@|(5nMn&rVBz{C>$%F0Uqk;$INHUt+2^
z-_{J?op)mSFaCTScF~{#vVEnX!`H)p$QPh$>nfXo=Dja4-v58q5&U2B>Y*>9&|nEy
zKFFZonRT3akH{|MSkhn0JovH5Y3@3-RPFz5CjR^7Z-WF3RbSkgfCirW%B{c{DU{0w
z;!Tjpz!mok{NvjGUESXDwY!Bq2CxQr-M}F_?+Zkq<$c%~@g93;zK_S-l0$^0(Ab8(
z<fLh9W6y}?hU$*kPvHr3yZOy0&qEpH!6jmafSGpPd4B+deHj!(d3#Sq9QvLDz$4G`
zvdTnoQZhvw#Is<%M|Wl<&m}##eO27?yd}UFIlPkdDqX)&8<nQ&tX6Q>gbRMXRAk;O
zbbJb*>GqG$n@89E45`VZCNIMjF!w*2JD-`+Uw$}u^4x6BtS3n|{o#hN2OuWMBnm(g
zFjN4Rp1*hIK9X<nf<Ef6Pl3>vF<3eGM#yP-a2Od=Fgg9jjW=A7A39cW$(658X+T+r
zG<`vu>U0f+^q}&*5P(=!2ZEV=FE?d`NTDo@c*$@Ta)#gq+rAhfkp7?*7y_6OG&X$J
z?uUL<EB{lIiZG+G8I4!O3-4Ttm2ym1zLFfC_uwgp;59otIWwLv2l}<lhw`g{D;JV&
z&NZKaA(AhT&D30!t8!(JtO<vl9n&{8Ws8XEt3ddP;LWkRqG_MOFB+r=*CMJ!7W8L8
zmR}9iUd-wETS%N9<}m1i%A2XTo_3?zt=H-3DJmeWTXWnZC>c&Xd=V#mxS#ZWzs;Jn
z!(@Py3!w64ypn%&by9)g<X%=`SNC86Y>Myk^ACb@+%MZ3yoeD9j|oXH41=LNsU~=#
z^k^g?W<{P|MTObAl}GhHXcf1uq>Z)P8luF+1V>%t<Z!4vCnxJlxphPuZrY5$;gHj^
zJ5^jX1fnsX{=q?3muxfg6rDQM;G<(>bI`kz>6{AMz7>CNEytOn8l<oYKmBFm`-Z=f
zG++X6>D@?Zd-%GZ07;zmZNnH^cl#=*<F<m)$n}b^KKKM7$pVz*)@UCzt;mLB$+P`x
z^B?6zC+>R`ACzYbM(EB6%uprd2W7Rx^-O08;MdS(rd;4)>*7ssVS5Q-5b#ewy7mUd
zfgeX;F<vP`3iNOT1cFAUQC9$X!o_B-c1r00<jt1eniznN`_01Pd+7T{iv!CeR&;!V
zS~Y!ko@5jnA6Ml`2~xSl&`_i$0igl%B`W>6Qh*NAcq^VnqlAmNPmi?n9N;rXi!ou4
zZm=d0*)|V>q^@=H1~>_^mIXlll`MQtVTe`06Dcb1=UQ?ZyDG$yg5s#zozM7$^1FyJ
z`XI-&!8stT0y;J&g@5M2SfX#3R2K?7On!NPMZ#FzVG_+r-G;Brr(s3Xj7f&y0iRdT
zd6bg}twVY-7LS%5Ss^tCc)<uQX;@R?xj2cX1Ia3pmCbq9I|q@2W12*2tGb0brKJ@K
z{i~G(P&-uR)Rgrkol2mo{QSeozCJO4e60xbwb0U0-e7ODo)r~Xyx|R*w>4=T+-DGu
zZnsUFyIwVIfG@=AP`)7DI(j8kiYl+HgFR>g0HL@Y%mYFMcFu9?V9-QHd1f0cX)yvb
zS_J7_q*jPKjaFluEhI8!6bD9<CsooO{q-ogwdj1nA-NwyJ)UCpTWKgiTlM~aWJ3sq
zmxL|%+Q-U*)}P;7P2lTb&%AX~8=W20@l=4zLgpm-Lc2vM3A~(aOtUE{YuYJ5ydi%R
z8qrpULUDR^^zB?#eNo~TyZ-_nCtSelt<X}x$6{tFG9im~ej!m65v1tn+n7fE{2p53
z{E?m(Vpu#9j^~-~NE_37Epk@rU=?l)e#lCe=g(lb9@|qDDhZV`;ca+kKlD_ZOOI6F
zQo^2KCqQ<U2XCgx5_B7y%pBB)v@ev;NrMg=v8q5{dFR~|piMM2HQ8m?96k?jtY=@P
zRZ3BBf<1yrggZbglc4a^9{E=XFThwekh1@aAB(C<3}tyk&E6I!kgn-+f}yY&k?894
z=t;Q{cm$10p}hmLFqJ)Cq78PiqOcn)k)~a4Gnlc=d3+waw80L6A=xJg)Ve!(&P!;k
zYXN!=Oi*`0Zs+CrK?pJkeTbm4|H~DofIO(!V5XG=3zhx}g|o?6u|<xXK$*WT%f9KA
z7U|gJJU_CSbdQ5$ie-6jxX=+3Y7vY`Od%0Y6NBwbd(Oy*p)(Gm7~s*b^<WbgS`dnE
zUbtfKf^<$vwP_XPC^Aj;7Kf9bv#s){Y^=>Knk*g-RHbB8KSO}wo)^5R`%it3Rs+4V
zFh$@h(JBw!V)+j_*p(MlTq$>BbfFsq@9+|wVt_%DjaXYul30M^%kt{g2&dJd;}q<2
z>&kobt&R0n0a&q%k-`~?#-6bptXglBFa?WVJyo_*I6=p+ZS1*sPSB>t{~8Q!O}XS<
z%?K(fH|^30AMYM>dh@Ovdw@w=blAR#{eb)QROSAdX%|o=(<rdOBq!)LXU&DCp(|tR
z=heTS7F;7Q;#xW4(xHdg+}xa?;fd%6vWt+;iT{vK2*K2smxv-878DMw3PN*SyIyUG
z8%~s!5$Rsr{I{j#JeV039Sprw6Gv$mC&N3l%|DC^%Kv+qNIXsWEjXXaT&Mp10WfIc
zUu4PVsE_~W`o#aB-dx%sjVrgx^B(v-Le?s+e5C7s@__Q!Kkq$#CUYoxz3lY+L;F(?
z-5u|DY~={M{%gl^iMCJs8~VwIB1DH4NqsYRl*<*HG5gVuwA0h&YdwrYjP<9OR5ovo
z@+x|l4U4yISj6S47SH>Sl}fsQo_Be*W8J2Aeyi8a@k#P;<1dqcD<{cpbr6<NRJfOT
zSGYei`RP|GE*#KkS5#CC)QcEa2@IEwb9oZ|QoKAxr#p2<*?wFYT`aPh3zwX)gg^Hr
zyt!)>!e(|y{`cWIf$B7-68SGtI_;^GU+p-BNsLKaOq<l`{UBZO`x3E+#ML6x&b$<^
zAZhvEF%cWPyie0I<a=9}m+6eAE-I5(4sC9Sd=}KNf;{zBUE%(B>EGt15RL@sE$_eV
zuKalXN*e>6PfU4_&cc}3=I@UC!EIHfaS|@~OfCA~?aY#CzNcut`+xZ0Sx1p!3}ZQW
zid^p^M@-6?+5dFOMMXss^}}hLb3$^>m%IrV4p8--(QZr~Q?@k`3S@NfX~j`(3fVtM
zr)>+rKV17(EAVYSF0iH8v-Oa6?D%@}8&yoFyS?}CyC!cdq)c9Ii{hUg{QvdCykCF2
zjw!Z(U+(AL5E`Za7(y#yXaB{1o&MMB+tUwvhJRB@9m`8htV*ky6RJ*Y9-XJ!dcCJb
z;+i?C(}e1)(~=Vt$MPN=YwMo0W~z1Ph>0~!X*b^7J4M6W6KtkMVB6IXN1cKHX}-h}
zV?p1(_1jLp*`{jk3xk$!T$OWc?B6~c6LD1BB3GT52UzUXs$t0XXZw^h$2`vO?x%x~
zQ3)*G`t2u+9M!Y-g>BYO`Q3M=e9CnqhOM(5x+T*4FMBVp3irV7j5SP5-1aiqF{PlW
z*nA0o=0CZ(df6K;KfilSB!p%d<GtuC#OTypZtz&ccDwDqCvGgy|8DOhd@6l8CL*$a
zIIpvCGFpYZ$4({CZox35pYHhsyRGZkF?I34=gZ#Bmulw<IIHKD*H%_kZS&imE`3{X
f7v{gW%rw)O;|2WE*i<s|x02$rH&U+OfBJs_H=89Z

literal 0
HcmV?d00001

diff --git a/special-case/pom.xml b/special-case/pom.xml
new file mode 100644
index 000000000..c62b9e759
--- /dev/null
+++ b/special-case/pom.xml
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>java-design-patterns</artifactId>
+        <groupId>com.iluwatar</groupId>
+        <version>1.24.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>special-case</artifactId>
+    <dependencies>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-engine</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+
+</project>
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/App.java b/special-case/src/main/java/com/iluwatar/specialcase/App.java
new file mode 100644
index 000000000..276b1dd85
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/App.java
@@ -0,0 +1,47 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * <p>The Special Case Pattern is a software design pattern that encapsulates particular cases
+ * into subclasses that provide special behaviors.</p>
+ *
+ * <p>In this example ({@link ReceiptViewModel}) encapsulates all particular cases.</p>
+ */
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  /**
+   * Program entry point.
+   */
+  public static void main(String[] args) {
+    // DB seeding
+    LOGGER.info("Db seeding: " + "1 user: {\"ignite1771\", amount = 1000.0}, "
+        + "2 products: {\"computer\": price = 800.0, \"car\": price = 20000.0}");
+    Db.getInstance().seedUser("ignite1771", 1000.0);
+    Db.getInstance().seedItem("computer", 800.0);
+    Db.getInstance().seedItem("car", 20000.0);
+
+    final var applicationServices = new ApplicationServicesImpl();
+    ReceiptViewModel receipt;
+
+    LOGGER.info("[REQUEST] User: " + "abc123" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("abc123", "tv");
+    receipt.show();
+    MaintenanceLock.getInstance().setLock(false);
+    LOGGER.info("[REQUEST] User: " + "abc123" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("abc123", "tv");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "tv");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "tv");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "car");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "car");
+    receipt.show();
+    LOGGER.info("[REQUEST] User: " + "ignite1771" + " buy product: " + "computer");
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "computer");
+    receipt.show();
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
new file mode 100644
index 000000000..f756ccc43
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
@@ -0,0 +1,6 @@
+package com.iluwatar.specialcase;
+
+public interface ApplicationServices {
+
+  ReceiptViewModel loggedInUserPurchase(String userName, String itemName);
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
new file mode 100644
index 000000000..ebb9109bc
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
@@ -0,0 +1,18 @@
+package com.iluwatar.specialcase;
+
+public class ApplicationServicesImpl implements ApplicationServices {
+
+  private DomainServicesImpl domain = new DomainServicesImpl();
+
+  @Override
+  public ReceiptViewModel loggedInUserPurchase(String userName, String itemName) {
+    if (isDownForMaintenance()) {
+      return new DownForMaintenance();
+    }
+    return this.domain.purchase(userName, itemName);
+  }
+
+  private boolean isDownForMaintenance() {
+    return MaintenanceLock.getInstance().isLock();
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/Db.java b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
new file mode 100644
index 000000000..847330ece
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
@@ -0,0 +1,150 @@
+package com.iluwatar.specialcase;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class Db {
+
+  private static Db instance;
+  private Map<String, User> userName2User;
+  private Map<User, Account> user2Account;
+  private Map<String, Product> itemName2Product;
+
+  /**
+   * Get the instance of Db.
+   *
+   * @return singleton instance of Db class
+   */
+  public static Db getInstance() {
+    if (instance == null) {
+      synchronized (Db.class) {
+        if (instance == null) {
+          instance = new Db();
+          instance.userName2User = new HashMap<>();
+          instance.user2Account = new HashMap<>();
+          instance.itemName2Product = new HashMap<>();
+        }
+      }
+    }
+    return instance;
+  }
+
+  /**
+   * Seed a user into Db.
+   *
+   * @param userName of the user
+   * @param amount of the user's account
+   */
+  public void seedUser(String userName, Double amount) {
+    User user = new User(userName);
+    instance.userName2User.put(userName, user);
+    Account account = new Account(amount);
+    instance.user2Account.put(user, account);
+  }
+
+  /**
+   * Seed an item into Db.
+   *
+   * @param itemName of the item
+   * @param price of the item
+   */
+  public void seedItem(String itemName, Double price) {
+    Product item = new Product(price);
+    itemName2Product.put(itemName, item);
+  }
+
+  /**
+   * Find a user with the userName.
+   *
+   * @param userName of the user
+   * @return instance of User
+   */
+  public User findUserByUserName(String userName) {
+    if (!userName2User.containsKey(userName)) {
+      return null;
+    }
+    return userName2User.get(userName);
+  }
+
+  /**
+   * Find an account of the user.
+   *
+   * @param user in Db
+   * @return instance of Account of the user
+   */
+  public Account findAccountByUser(User user) {
+    if (!user2Account.containsKey(user)) {
+      return null;
+    }
+    return user2Account.get(user);
+  }
+
+  /**
+   * Find a product with the itemName.
+   *
+   * @param itemName of the item
+   * @return instance of Product
+   */
+  public Product findProductByItemName(String itemName) {
+    if (!itemName2Product.containsKey(itemName)) {
+      return null;
+    }
+    return itemName2Product.get(itemName);
+  }
+
+  public class User {
+
+    private String userName;
+
+    public User(String userName) {
+      this.userName = userName;
+    }
+
+    public String getUserName() {
+      return userName;
+    }
+
+    public ReceiptDto purchase(Product item) {
+      return new ReceiptDto(item.getPrice());
+    }
+  }
+
+  public class Account {
+
+    private Double amount;
+
+    public Account(Double amount) {
+      this.amount = amount;
+    }
+
+    /**
+     * Withdraw the price of the item from the account.
+     *
+     * @param price of the item
+     * @return instance of MoneyTransaction
+     */
+    public MoneyTransaction withdraw(Double price) {
+      if (price > amount) {
+        return null;
+      }
+      return new MoneyTransaction(amount, price);
+    }
+
+    public Double getAmount() {
+      return amount;
+    }
+  }
+
+  public class Product {
+
+    private Double price;
+
+    public Product(Double price) {
+      this.price = price;
+    }
+
+    public Double getPrice() {
+      return price;
+    }
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
new file mode 100644
index 000000000..a052eb20b
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
@@ -0,0 +1,4 @@
+package com.iluwatar.specialcase;
+
+public interface DomainServices {
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
new file mode 100644
index 000000000..400689ed9
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
@@ -0,0 +1,46 @@
+package com.iluwatar.specialcase;
+
+public class DomainServicesImpl implements DomainServices {
+
+  /**
+   * Domain purchase with userName and itemName, with validation for userName.
+   *
+   * @param userName of the user
+   * @param itemName of the item
+   * @return instance of ReceiptViewModel
+   */
+  public ReceiptViewModel purchase(String userName, String itemName) {
+    Db.User user = Db.getInstance().findUserByUserName(userName);
+    if (user == null) {
+      return new InvalidUser(userName);
+    }
+
+    Db.Account account = Db.getInstance().findAccountByUser(user);
+    return purchase(user, account, itemName);
+  }
+
+  /**
+   * Domain purchase with user, account and itemName,
+   * with validation for whether product is out of stock
+   * and whether user has insufficient funds in the account.
+   *
+   * @param user in Db
+   * @param account in Db
+   * @param itemName of the item
+   * @return instance of ReceiptViewModel
+   */
+  private ReceiptViewModel purchase(Db.User user, Db.Account account, String itemName) {
+    Db.Product item = Db.getInstance().findProductByItemName(itemName);
+    if (item == null) {
+      return new OutOfStock(user.getUserName(), itemName);
+    }
+
+    ReceiptDto receipt = user.purchase(item);
+    MoneyTransaction transaction = account.withdraw(receipt.getPrice());
+    if (transaction == null) {
+      return new InsufficientFunds(user.getUserName(), account.getAmount(), itemName);
+    }
+
+    return receipt;
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
new file mode 100644
index 000000000..98a2cf89c
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
@@ -0,0 +1,14 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class DownForMaintenance implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DownForMaintenance.class);
+
+  @Override
+  public void show() {
+    LOGGER.info("Down for maintenance");
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
new file mode 100644
index 000000000..8fe714f80
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
@@ -0,0 +1,32 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class InsufficientFunds implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(InsufficientFunds.class);
+
+  private String userName;
+  private Double amount;
+  private String itemName;
+
+  /**
+   * Constructor of InsufficientFunds.
+   *
+   * @param userName of the user
+   * @param amount of the user's account
+   * @param itemName of the item
+   */
+  public InsufficientFunds(String userName, Double amount, String itemName) {
+    this.userName = userName;
+    this.amount = amount;
+    this.itemName = itemName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Insufficient funds: " + amount + " of user: " + userName
+        + " for buying item: " + itemName);
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
new file mode 100644
index 000000000..443fdc7bf
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
@@ -0,0 +1,20 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class InvalidUser implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(InvalidUser.class);
+
+  private final String userName;
+
+  public InvalidUser(String userName) {
+    this.userName = userName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Invalid user: " + userName);
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
new file mode 100644
index 000000000..29a5b4f81
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
@@ -0,0 +1,37 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class MaintenanceLock {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(MaintenanceLock.class);
+
+  private static MaintenanceLock instance;
+  private boolean lock = true;
+
+  /**
+   * Get the instance of MaintenanceLock.
+   *
+   * @return singleton instance of MaintenanceLock
+   */
+  public static MaintenanceLock getInstance() {
+    if (instance == null) {
+      synchronized (MaintenanceLock.class) {
+        if (instance == null) {
+          instance = new MaintenanceLock();
+        }
+      }
+    }
+    return instance;
+  }
+
+  public boolean isLock() {
+    return lock;
+  }
+
+  public void setLock(boolean lock) {
+    this.lock = lock;
+    LOGGER.info("Maintenance lock is set to: " + lock);
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
new file mode 100644
index 000000000..e3904964f
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
@@ -0,0 +1,12 @@
+package com.iluwatar.specialcase;
+
+public class MoneyTransaction {
+
+  private Double amount;
+  private Double price;
+
+  public MoneyTransaction(Double amount, Double price) {
+    this.amount = amount;
+    this.price = price;
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
new file mode 100644
index 000000000..5359bed31
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
@@ -0,0 +1,22 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class OutOfStock implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(OutOfStock.class);
+
+  private String userName;
+  private String itemName;
+
+  public OutOfStock(String userName, String itemName) {
+    this.userName = userName;
+    this.itemName = itemName;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Out of stock: " + itemName + " for user = " + userName + " to buy");
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
new file mode 100644
index 000000000..81fc46bbe
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
@@ -0,0 +1,24 @@
+package com.iluwatar.specialcase;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class ReceiptDto implements ReceiptViewModel {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(ReceiptDto.class);
+
+  private Double price;
+
+  public ReceiptDto(Double price) {
+    this.price = price;
+  }
+
+  public Double getPrice() {
+    return price;
+  }
+
+  @Override
+  public void show() {
+    LOGGER.info("Receipt: " + price + " paid");
+  }
+}
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
new file mode 100644
index 000000000..482eef21f
--- /dev/null
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
@@ -0,0 +1,6 @@
+package com.iluwatar.specialcase;
+
+public interface ReceiptViewModel {
+
+  void show();
+}
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
new file mode 100644
index 000000000..25799368b
--- /dev/null
+++ b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
@@ -0,0 +1,16 @@
+package com.iluwatar.specialcase;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+import org.junit.jupiter.api.Test;
+
+/**
+ * Application test.
+ */
+public class AppTest {
+
+  @Test
+  void shouldExecuteWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
+}
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
new file mode 100644
index 000000000..5e83aa8d6
--- /dev/null
+++ b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
@@ -0,0 +1,120 @@
+package com.iluwatar.specialcase;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.BeforeAll;
+import org.slf4j.LoggerFactory;
+import ch.qos.logback.classic.Level;
+import ch.qos.logback.classic.Logger;
+import ch.qos.logback.classic.spi.ILoggingEvent;
+import ch.qos.logback.core.read.ListAppender;
+import java.util.List;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.BeforeEach;
+
+/**
+ * Special cases unit tests. (including the successful scenario {@link ReceiptDto})
+ */
+public class SpecialCasesTest {
+  private static ApplicationServices applicationServices;
+  private static ReceiptViewModel receipt;
+
+  @BeforeAll
+  static void beforeAll() {
+    Db.getInstance().seedUser("ignite1771", 1000.0);
+    Db.getInstance().seedItem("computer", 800.0);
+    Db.getInstance().seedItem("car", 20000.0);
+
+    applicationServices = new ApplicationServicesImpl();
+  }
+
+  @BeforeEach
+  public void beforeEach() {
+    MaintenanceLock.getInstance().setLock(false);
+  }
+
+  @Test
+  public void testDownForMaintenance() {
+    final Logger LOGGER = (Logger) LoggerFactory.getLogger(DownForMaintenance.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+    LOGGER.addAppender(listAppender);
+
+    MaintenanceLock.getInstance().setLock(true);
+    receipt = applicationServices.loggedInUserPurchase(null, null);
+    receipt.show();
+
+    List<ILoggingEvent> loggingEventList = listAppender.list;
+    assertEquals("Down for maintenance", loggingEventList.get(0).getMessage());
+    assertEquals(Level.INFO, loggingEventList.get(0).getLevel());
+  }
+
+  @Test
+  public void testInvalidUser() {
+    final Logger LOGGER = (Logger) LoggerFactory.getLogger(InvalidUser.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+    LOGGER.addAppender(listAppender);
+
+    receipt = applicationServices.loggedInUserPurchase("a", null);
+    receipt.show();
+
+    List<ILoggingEvent> loggingEventList = listAppender.list;
+    assertEquals("Invalid user: a", loggingEventList.get(0).getMessage());
+    assertEquals(Level.INFO, loggingEventList.get(0).getLevel());
+  }
+
+  @Test
+  public void testOutOfStock() {
+    final Logger LOGGER = (Logger) LoggerFactory.getLogger(OutOfStock.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+    LOGGER.addAppender(listAppender);
+
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "tv");
+    receipt.show();
+
+    List<ILoggingEvent> loggingEventList = listAppender.list;
+    assertEquals("Out of stock: tv for user = ignite1771 to buy"
+        , loggingEventList.get(0).getMessage());
+    assertEquals(Level.INFO, loggingEventList.get(0).getLevel());
+  }
+
+  @Test
+  public void testInsufficientFunds() {
+    final Logger LOGGER = (Logger) LoggerFactory.getLogger(InsufficientFunds.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+    LOGGER.addAppender(listAppender);
+
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "car");
+    receipt.show();
+
+    List<ILoggingEvent> loggingEventList = listAppender.list;
+    assertEquals("Insufficient funds: 1000.0 of user: ignite1771 for buying item: car"
+        , loggingEventList.get(0).getMessage());
+    assertEquals(Level.INFO, loggingEventList.get(0).getLevel());
+  }
+
+  @Test
+  public void testReceiptDto() {
+    final Logger LOGGER = (Logger) LoggerFactory.getLogger(ReceiptDto.class);
+
+    ListAppender<ILoggingEvent> listAppender = new ListAppender<>();
+    listAppender.start();
+    LOGGER.addAppender(listAppender);
+
+    receipt = applicationServices.loggedInUserPurchase("ignite1771", "computer");
+    receipt.show();
+
+    List<ILoggingEvent> loggingEventList = listAppender.list;
+    assertEquals("Receipt: 800.0 paid"
+        , loggingEventList.get(0).getMessage());
+    assertEquals(Level.INFO, loggingEventList.get(0).getLevel());
+  }
+}

From 6918a4bac2f006a99b56028ff6b7d9ba7d4b017c Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Wed, 13 Jan 2021 13:31:11 +0530
Subject: [PATCH 197/254] docs: add ignite1771 as a contributor (#1626)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 9310e5e1e..828a72409 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1359,6 +1359,15 @@
       "contributions": [
         "translation"
       ]
+    },
+    {
+      "login": "ignite1771",
+      "name": "ignite1771",
+      "avatar_url": "https://avatars2.githubusercontent.com/u/59446563?v=4",
+      "profile": "https://github.com/ignite1771",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index cc1e1bc3f..3510b692e 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-149-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-150-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -299,6 +299,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="http://libkhadir.fr"><img src="https://avatars1.githubusercontent.com/u/45130488?v=4?s=100" width="100px;" alt=""/><br /><sub><b>KHADIR Tayeb</b></sub></a><br /><a href="#translation-tkhadir" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/ignite1771"><img src="https://avatars2.githubusercontent.com/u/59446563?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ignite1771</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ignite1771" title="Code">💻</a></td>
   </tr>
 </table>
 

From 7e56491e92e42be5efc90ef070d156a6a97a7ff0 Mon Sep 17 00:00:00 2001
From: Halil Demir <m.halildemir94@gmail.com>
Date: Sat, 16 Jan 2021 19:49:35 +0100
Subject: [PATCH 198/254] #1625 Turkish translation - initialization part
 (#1629)

* #1625 init Turkish translation and add the flag

* #1625 update the Main README.md for Turkish translation

* #1625 add Turkish translation for README.md

Co-authored-by: Halil Demir <halil.demir@zalando.de>
---
 README.md           |   2 +-
 assets/flags/TR.png | Bin 0 -> 288194 bytes
 tr/README.md        |  42 ++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 assets/flags/TR.png
 create mode 100644 tr/README.md

diff --git a/README.md b/README.md
index 3510b692e..a19e70c53 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@
 
 <br/>
 
-Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),
+Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),[![TR](/assets/flags/TR.png)**TR**](/tr/README.md),
 
 <br/>
 
diff --git a/assets/flags/TR.png b/assets/flags/TR.png
new file mode 100644
index 0000000000000000000000000000000000000000..bcea266c17c50649afe32e8fdc43552a6be0ca73
GIT binary patch
literal 288194
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
BSX2N2

literal 0
HcmV?d00001

diff --git a/tr/README.md b/tr/README.md
new file mode 100644
index 000000000..fe64ea3d6
--- /dev/null
+++ b/tr/README.md
@@ -0,0 +1,42 @@
+<!-- Biçimlendirme nedeniyle bu satır boş bırakılmalıdır böylelikle hoş bir görüntüye sahip olabiliriz. örneğin web sitesi -->
+
+![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
+[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
+[![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+# Giriş
+
+Tasarım desenleri, bir yazılım mühendisi bir uygulamayı veya sistemi tasarlarken yaygın sorunları çözmek için kullanabileceği en iyi çözüm prensipleridir.
+
+Tasarım desenleri, test edilip kanıtlanmış prensipler olduğu için yazılım geliştirme sürecini hızlandırabilir.
+
+Tasarım desenlerini yeniden kullanmak, büyük sorunlara neden olan ince sorunları önlemeye yardımcı olur ve aynı zamanda tasarım desenlerine alışkın olan yazılım mühendisileri ve yazılım mimarları için kod okunabilirliğini artırır.
+
+# Başlangıç
+
+Bu site Java Tasarım Desenlerini sergiliyor. Çözümler, açık kaynak topluluğundan deneyimli yazılım mühendisileri ve yazılım mimarları tarafından geliştirilmiştir. Bu yazılım desenleri, detaylı açıklamalarıyla veya kaynak kodlarına bakılarak göz atılabilir. Kaynak kod örneklerinde iyi derecede açıklayıcı yorum satırlarına sahip olup ve belirli bir tasarım deseninin nasıl uygulanacağına dair programlama dersi olarak düşünülebilir. Savaşta en çok kanıtlanmış açık kaynak Java teknolojilerini kullanıyoruz.
+
+Bu projeye başlamadan önce çeşitli [Yazılım Tasarım İlkelerine](https://java-design-patterns.com/principles/) aşina olmalısınız.
+
+Tüm tasarımlar olabildiğince basit olmalıdır. [KISS](https://en.wikipedia.org/wiki/KISS_principle), [YAGNI](https://en.wikipedia.org/wiki/You_aren%27t_gonna_need_it) ve [Do The Simplest Thing That Could Possibly Work](https://learning.oreilly.com/library/view/extreme-programming-pocket/9781449399849/ch17.html) ilkeleri ile başlamalısınız.
+
+Bu kavramlara aşina olduktan sonra, aşağıdaki yaklaşımlardan herhangi birini kullanarak [mevcut tasarım desenlerini](https://java-design-patterns.com/patterns/) derinlemesine incelemeye başlayabilirsiniz.
+
+- İsme göre belirli bir tasarım deseni arayın. Bulamadınız mı? Lütfen yeni bir tasarım deseni için [bizim ile](https://github.com/iluwatar/java-design-patterns/issues) iletişime geçin.
+- Performance, Gang of Four ya da Data access gibi etiketleri kullanın.
+- Creational(Yaratıcı Tasarım Desenleri), Behavioral(Davranışsal Tasarım Desenleri), ve Structural(Yapısal Tasarım Desenleri) gibi tasarım kategorilerini kullanın.
+
+Umarım bu sitede sunulan nesne yönelimli çözümleri yazılım mimarileriniz için yararlı bulursunuz ve onları geliştirirken bizim kadar eğlenirsiniz.
+
+# Nasıl Katkı Sağlayabilirim
+
+Projeye katkıda bulunmaya istekliysen, ilgili bilgileri [geliştirici wiki'mizde](https://github.com/iluwatar/java-design-patterns/wiki) bulabilirsin. [Gitter](https://gitter.im/iluwatar/java-design-patterns) ile size yardımcı olacağız ve sorularınızı cevaplayacağız.
+
+# Lisans
+
+Bu proje, MIT lisansı koşulları altında lisanslanmıştır.

From aa46e119d64657b3f71d921b96dd24659a6df0de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 16 Jan 2021 20:55:20 +0200
Subject: [PATCH 199/254] Fix flag image size

---
 assets/flags/TR.png | Bin 288194 -> 802 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/assets/flags/TR.png b/assets/flags/TR.png
index bcea266c17c50649afe32e8fdc43552a6be0ca73..70e2bee6c41a252870103b5196a1a2c019347abc 100644
GIT binary patch
delta 776
zcmV+j1NZ#G%MqdmA&F2<M-2)Z3IG5A4M|8uQUCw|5C8xG5C{eU001BJ|6!48DSrS5
zbV*G`2ju|}5;il=O4-8z00OT`L_t(I%RQ4%YaLY>hoAR7=giEVo7`(mYT6PC1}a??
zF$8fXQgkDt5$!^XOQ9%;NDu`VZUt8^{0O4BXmzPY#hnU%0!6HDnwTcd{Wo`J&N;7(
zfWQ6o@N9n4ZeKA`CB~kk$tk5eoPT!+0s@vZ7!0b4JRA@JZ^E>X+?!7D0AWxOWWaeJ
zIDBwS+bl5=a1H@1Cz{x?;T)8K&Wur2Vts{7wzf@Gs7E8jAf4Ml_FjZ$NxJ<t`Q8B%
zJSWpB4j7Ne;2kkW)H!r@W1XU`Xpip02m81mze8`nfowlY_~c{!?ha}&tbZ!JDt+5Q
zHoQ8VD4uMDBH&)xgX^!td`{lGPWt^1L=_p0aCME&XPCicF{7JLsfRV*ITSO<hQ9m~
zR2BB&N9dn_;X{F_VzU|2wbZZQAO**G;~W>())`kd1&SiTh4Zkr1wgv<JtiPdK?KX0
zyja3xms$Vq7kKU(wp?O4qkjgTm|$fER)zrNrlD<HLJ=s6@=Wr~)7Z1ukj+i1l@WbP
zSWKjx@$?a5gth~qxO54<`!~~O4hX>q?1!Jo@4iQS<uWmMxO#w(kv>Kg@8RGO4*vy!
z7oNw5z}my>%$tTj_Q;^Z-TjC9tJ{PxZ_&(WbSV=pp`--!1$=u4`hOnYeiI(Q3aYGK
zyhzivw6Vt)a{vabtE`P4q6h^7C;$R{{ssK}D^wMH_9;BM3uVdpi5<A{8q0&jv%<ay
zgcy6Af!Nhuqw64eXqNESP1t{j|99&f*nc0Y60$*xWObZOP8oQI*v?ai3bZ{~hGh$z
zkHD~o*&L4ULlFS5WnGJikX1N-aLlkA;7JLRfCxAbxj6$*PC*3*6?w5BwJq6<qAbZt
zzyzm?C!O7u;2<XO9#kPGZ~^)rLGi;OA_}U+=>)HWneiV8F)MZ;enXr90000<MNUMn
GLSTZsyId3i

literal 288194
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
BSX2N2


From 25ed2540f4b5d6fc2709c1e178082461a1da222d Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 16 Jan 2021 21:00:23 +0200
Subject: [PATCH 200/254] docs: add demirhalil as a contributor (#1630)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 828a72409..ae63d60ec 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1368,6 +1368,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "demirhalil",
+      "name": "Halil Demir",
+      "avatar_url": "https://avatars1.githubusercontent.com/u/22895118?v=4",
+      "profile": "https://github.com/demirhalil",
+      "contributions": [
+        "translation"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index a19e70c53..28635009f 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-150-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-151-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -300,6 +300,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="http://libkhadir.fr"><img src="https://avatars1.githubusercontent.com/u/45130488?v=4?s=100" width="100px;" alt=""/><br /><sub><b>KHADIR Tayeb</b></sub></a><br /><a href="#translation-tkhadir" title="Translation">🌍</a></td>
     <td align="center"><a href="https://github.com/ignite1771"><img src="https://avatars2.githubusercontent.com/u/59446563?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ignite1771</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ignite1771" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/demirhalil"><img src="https://avatars1.githubusercontent.com/u/22895118?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Halil Demir</b></sub></a><br /><a href="#translation-demirhalil" title="Translation">🌍</a></td>
   </tr>
 </table>
 

From 18a1a725ee763dbf8f9c10025e23226f038cbb1c Mon Sep 17 00:00:00 2001
From: ignite1771 <59446563+ignite1771@users.noreply.github.com>
Date: Tue, 19 Jan 2021 14:36:26 +0800
Subject: [PATCH 201/254] #1469 Add lambda expressions implementation for
 Strategy Pattern (#1631)

* #1469 Add Strategy Pattern lambda implementation

After Java 8.
Also take advantage of enum

* #1469 Update class diagrams

* #1469 Update README.md

Add lambda programmatic example

* #1469 Remove unused imports

Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 strategy/README.md                            |  45 ++++++++++++++++++
 strategy/etc/strategy.urm.puml                |  16 +++++++
 strategy/etc/strategy_urm.png                 | Bin 29282 -> 143387 bytes
 .../main/java/com/iluwatar/strategy/App.java  |  15 +++++-
 .../com/iluwatar/strategy/LambdaStrategy.java |  29 +++++++++++
 5 files changed, 103 insertions(+), 2 deletions(-)
 create mode 100644 strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java

diff --git a/strategy/README.md b/strategy/README.md
index b2330ceb8..2d2cbf9c4 100644
--- a/strategy/README.md
+++ b/strategy/README.md
@@ -122,6 +122,51 @@ Program output:
     You cast the spell of disintegration and the dragon vaporizes in a pile of dust!    
 ```
 
+What's more, the new feature Lambda Expressions in Java 8 provides another approach for the implementation:
+
+```java
+public class LambdaStrategy {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(LambdaStrategy.class);
+
+  public enum Strategy implements DragonSlayingStrategy {
+    MeleeStrategy(() -> LOGGER.info(
+        "With your Excalibur you severe the dragon's head!")),
+    ProjectileStrategy(() -> LOGGER.info(
+        "You shoot the dragon with the magical crossbow and it falls dead on the ground!")),
+    SpellStrategy(() -> LOGGER.info(
+        "You cast the spell of disintegration and the dragon vaporizes in a pile of dust!"));
+
+    private final DragonSlayingStrategy dragonSlayingStrategy;
+
+    Strategy(DragonSlayingStrategy dragonSlayingStrategy) {
+      this.dragonSlayingStrategy = dragonSlayingStrategy;
+    }
+
+    @Override
+    public void execute() {
+      dragonSlayingStrategy.execute();
+    }
+  }
+}
+```
+
+And here's the dragonslayer in action.
+
+```java
+    LOGGER.info("Green dragon spotted ahead!");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.MeleeStrategy);
+    dragonSlayer.goToBattle();
+    LOGGER.info("Red dragon emerges.");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.ProjectileStrategy);
+    dragonSlayer.goToBattle();
+    LOGGER.info("Black dragon lands before you.");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.SpellStrategy);
+    dragonSlayer.goToBattle();
+```
+
+Program output is the same as above one.
+
 ## Class diagram
 
 ![alt text](./etc/strategy_urm.png "Strategy")
diff --git a/strategy/etc/strategy.urm.puml b/strategy/etc/strategy.urm.puml
index 8b9daabb9..d9b9aa526 100644
--- a/strategy/etc/strategy.urm.puml
+++ b/strategy/etc/strategy.urm.puml
@@ -14,6 +14,19 @@ package com.iluwatar.strategy {
   interface DragonSlayingStrategy {
     + execute() {abstract}
   }
+  class LambdaStrategy {
+    - LOGGER : Logger {static}
+    + LambdaStrategy()
+  }
+  enum Strategy {
+    + MeleeStrategy {static}
+    + ProjectileStrategy {static}
+    + SpellStrategy {static}
+    - dragonSlayingStrategy : DragonSlayingStrategy
+    + execute()
+    + valueOf(name : String) : Strategy {static}
+    + values() : Strategy[] {static}
+  }
   class MeleeStrategy {
     - LOGGER : Logger {static}
     + MeleeStrategy()
@@ -30,7 +43,10 @@ package com.iluwatar.strategy {
     + execute()
   }
 }
+Strategy ..+ LambdaStrategy
+Strategy -->  "-dragonSlayingStrategy" DragonSlayingStrategy
 DragonSlayer -->  "-strategy" DragonSlayingStrategy
+Strategy ..|> DragonSlayingStrategy 
 MeleeStrategy ..|> DragonSlayingStrategy 
 ProjectileStrategy ..|> DragonSlayingStrategy 
 SpellStrategy ..|> DragonSlayingStrategy 
diff --git a/strategy/etc/strategy_urm.png b/strategy/etc/strategy_urm.png
index 8e15c3c36e402057e7a20f07956fce737fd4bd94..67d19acae62d2f4b36ca6dbe9e28aaf91f659ae8 100644
GIT binary patch
literal 143387
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
Zl30hkOwC^G@j~P!%l+2-XkY(u;otDb3PAt>

literal 29282
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
Oj}PywD;D3gc=dl2RxgAA

diff --git a/strategy/src/main/java/com/iluwatar/strategy/App.java b/strategy/src/main/java/com/iluwatar/strategy/App.java
index c526c7917..6313087b0 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/App.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/App.java
@@ -45,7 +45,7 @@ public class App {
   
   /**
    * Program entry point.
-   * 
+   *
    * @param args command line args
    */
   public static void main(String[] args) {
@@ -60,7 +60,7 @@ public class App {
     dragonSlayer.changeStrategy(new SpellStrategy());
     dragonSlayer.goToBattle();
 
-    // Java 8 Strategy pattern
+    // Java 8 functional implementation Strategy pattern
     LOGGER.info("Green dragon spotted ahead!");
     dragonSlayer = new DragonSlayer(
         () -> LOGGER.info("With your Excalibur you severe the dragon's head!"));
@@ -73,5 +73,16 @@ public class App {
     dragonSlayer.changeStrategy(() -> LOGGER.info(
         "You cast the spell of disintegration and the dragon vaporizes in a pile of dust!"));
     dragonSlayer.goToBattle();
+
+    // Java 8 lambda implementation with enum Strategy pattern
+    LOGGER.info("Green dragon spotted ahead!");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.MeleeStrategy);
+    dragonSlayer.goToBattle();
+    LOGGER.info("Red dragon emerges.");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.ProjectileStrategy);
+    dragonSlayer.goToBattle();
+    LOGGER.info("Black dragon lands before you.");
+    dragonSlayer.changeStrategy(LambdaStrategy.Strategy.SpellStrategy);
+    dragonSlayer.goToBattle();
   }
 }
diff --git a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
new file mode 100644
index 000000000..d74806017
--- /dev/null
+++ b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
@@ -0,0 +1,29 @@
+package com.iluwatar.strategy;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+public class LambdaStrategy {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(LambdaStrategy.class);
+
+  public enum Strategy implements DragonSlayingStrategy {
+    MeleeStrategy(() -> LOGGER.info(
+        "With your Excalibur you severe the dragon's head!")),
+    ProjectileStrategy(() -> LOGGER.info(
+        "You shoot the dragon with the magical crossbow and it falls dead on the ground!")),
+    SpellStrategy(() -> LOGGER.info(
+        "You cast the spell of disintegration and the dragon vaporizes in a pile of dust!"));
+
+    private final DragonSlayingStrategy dragonSlayingStrategy;
+
+    Strategy(DragonSlayingStrategy dragonSlayingStrategy) {
+      this.dragonSlayingStrategy = dragonSlayingStrategy;
+    }
+
+    @Override
+    public void execute() {
+      dragonSlayingStrategy.execute();
+    }
+  }
+}

From 3adc3cda051aace936dacabd45b5926265de8923 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 24 Jan 2021 14:47:05 +0530
Subject: [PATCH 202/254] update gitignore (#1632)

.checkstyle files are being tracked which should not be
---
 .gitignore | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/.gitignore b/.gitignore
index ada1e7d10..cbf902674 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,7 +4,8 @@ target
 .classpath
 .project
 *.class
-# Package Files #
+
+### Package Files ###
 *.jar
 *.war
 *.ear
@@ -13,7 +14,8 @@ target
 *.swp
 datanucleus.log
 /bin/
-/bin/
-/bin/
 *.log
 event-sourcing/Journal.json
+
+### Checkstyle ###
+.checkstyle

From 0010fb55c52629ce6fb55fa9389f360883359426 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Mon, 25 Jan 2021 05:35:04 +0200
Subject: [PATCH 203/254] Merge data transfer object examples (#1635)

* #1617 merge dto pattern examples

* #1617 update license headers

Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 data-transfer-object-enum-impl/README.md      |  54 --------
 .../data-transfer-object-enum-impl.urm.puml   | 129 ------------------
 .../etc/dto-enum-uml.png                      | Bin 123167 -> 0 bytes
 data-transfer-object-enum-impl/pom.xml        |  61 ---------
 .../com/iluwatar/datatransferenum/App.java    |  59 --------
 .../iluwatar/datatransferenum/AppTest.java    |  44 ------
 .../java/com/iluwatar/datatransfer/App.java   |  69 +++++++++-
 .../{ => customer}/CustomerDto.java           |   2 +-
 .../{ => customer}/CustomerResource.java      |   2 +-
 .../datatransfer/product}/Product.java        |  25 +++-
 .../datatransfer/product}/ProductDto.java     |  25 +++-
 .../product}/ProductResource.java             |  25 +++-
 .../{ => customer}/CustomerResourceTest.java  |   5 +-
 pom.xml                                       |   1 -
 registry/pom.xml                              |  24 ++++
 .../main/java/com/iluwatar/registry/App.java  |  23 ++++
 .../java/com/iluwatar/registry/Customer.java  |  23 ++++
 .../iluwatar/registry/CustomerRegistry.java   |  23 ++++
 .../registry/CustomerRegistryTest.java        |  23 ++++
 special-case/pom.xml                          |  24 ++++
 .../java/com/iluwatar/specialcase/App.java    |  23 ++++
 .../specialcase/ApplicationServices.java      |  23 ++++
 .../specialcase/ApplicationServicesImpl.java  |  23 ++++
 .../java/com/iluwatar/specialcase/Db.java     |  23 ++++
 .../iluwatar/specialcase/DomainServices.java  |  23 ++++
 .../specialcase/DomainServicesImpl.java       |  23 ++++
 .../specialcase/DownForMaintenance.java       |  23 ++++
 .../specialcase/InsufficientFunds.java        |  23 ++++
 .../com/iluwatar/specialcase/InvalidUser.java |  23 ++++
 .../iluwatar/specialcase/MaintenanceLock.java |  23 ++++
 .../specialcase/MoneyTransaction.java         |  23 ++++
 .../com/iluwatar/specialcase/OutOfStock.java  |  23 ++++
 .../com/iluwatar/specialcase/ReceiptDto.java  |  23 ++++
 .../specialcase/ReceiptViewModel.java         |  23 ++++
 .../com/iluwatar/specialcase/AppTest.java     |  23 ++++
 .../specialcase/SpecialCasesTest.java         |  23 ++++
 .../com/iluwatar/strategy/LambdaStrategy.java |  23 ++++
 37 files changed, 674 insertions(+), 358 deletions(-)
 delete mode 100644 data-transfer-object-enum-impl/README.md
 delete mode 100644 data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
 delete mode 100644 data-transfer-object-enum-impl/etc/dto-enum-uml.png
 delete mode 100644 data-transfer-object-enum-impl/pom.xml
 delete mode 100644 data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
 delete mode 100644 data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java
 rename data-transfer-object/src/main/java/com/iluwatar/datatransfer/{ => customer}/CustomerDto.java (97%)
 rename data-transfer-object/src/main/java/com/iluwatar/datatransfer/{ => customer}/CustomerResource.java (98%)
 rename {data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum => data-transfer-object/src/main/java/com/iluwatar/datatransfer/product}/Product.java (58%)
 rename {data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum => data-transfer-object/src/main/java/com/iluwatar/datatransfer/product}/ProductDto.java (82%)
 rename {data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum => data-transfer-object/src/main/java/com/iluwatar/datatransfer/product}/ProductResource.java (62%)
 rename data-transfer-object/src/test/java/com/iluwatar/datatransfer/{ => customer}/CustomerResourceTest.java (94%)

diff --git a/data-transfer-object-enum-impl/README.md b/data-transfer-object-enum-impl/README.md
deleted file mode 100644
index 7e6dbc365..000000000
--- a/data-transfer-object-enum-impl/README.md
+++ /dev/null
@@ -1,54 +0,0 @@
----
-layout: pattern
-title: Data Transfer Object
-folder: data-transfer-object
-permalink: /patterns/data-transfer-object/
-categories: Architectural
-tags:
- - Performance
----
-
-## Intent
-
-Pass data with multiple attributes in one shot from client to server, to avoid multiple calls to 
-remote server. 
-
-## Explanation
-
-Real world example
-
-> We need to fetch information about customers from remote database. Instead of querying the 
-> attributes one at a time, we use DTOs to transfer all the relevant attributes in a single shot.     
-
-In plain words
-
-> Using DTO relevant information can be fetched with a single backend query. 
-
-Wikipedia says
-
-> In the field of programming a data transfer object (DTO) is an object that carries data between 
-> processes. The motivation for its use is that communication between processes is usually done 
-> resorting to remote interfaces (e.g. web services), where each call is an expensive operation. 
-> Because the majority of the cost of each call is related to the round-trip time between the client 
-> and the server, one way of reducing the number of calls is to use an object (the DTO) that 
-> aggregates the data that would have been transferred by the several calls, but that is served by 
-> one call only.
-
-## Class diagram
-
-![alt text](./etc/dto-enum-uml.png "data-transfer-object")
-
-## Applicability
-
-Use the Data Transfer Object pattern when:
-
-* The client is asking for multiple information. And the information is related.
-* When you want to boost the performance to get resources.
-* You want reduced number of remote calls.
-
-## Credits
-
-* [Design Pattern - Transfer Object Pattern](https://www.tutorialspoint.com/design_pattern/transfer_object_pattern.htm)
-* [Data Transfer Object](https://msdn.microsoft.com/en-us/library/ff649585.aspx)
-* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94)
-* [Patterns of Enterprise Application Architecture](https://www.amazon.com/gp/product/0321127420/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321127420&linkCode=as2&tag=javadesignpat-20&linkId=014237a67c9d46f384b35e10151956bd)
diff --git a/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml b/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
deleted file mode 100644
index e6426c392..000000000
--- a/data-transfer-object-enum-impl/etc/data-transfer-object-enum-impl.urm.puml
+++ /dev/null
@@ -1,129 +0,0 @@
-@startuml
-package com.iluwatar.datatransferenum {
-  class App {
-    - LOGGER : Logger {static}
-    + App()
-    + main(args : String[]) {static}
-  }
-  class Product {
-    - cost : Double
-    - id : Long
-    - name : String
-    - price : Double
-    - supplier : String
-    + Product()
-    + getCost() : Double
-    + getId() : Long
-    + getName() : String
-    + getPrice() : Double
-    + getSupplier() : String
-    + setCost(cost : Double) : Product
-    + setId(id : Long) : Product
-    + setName(name : String) : Product
-    + setPrice(price : Double) : Product
-    + setSupplier(supplier : String) : Product
-    + toString() : String
-  }
-  enum ProductDTO {
-    + valueOf(name : String) : ProductDTO {static}
-    + values() : ProductDTO[] {static}
-  }
-  -interface Cost {
-    + getCost() : Double {abstract}
-  }
-  -interface Id {
-    + getId() : Long {abstract}
-  }
-  -interface Name {
-    + getName() : String {abstract}
-  }
-  -interface Price {
-    + getPrice() : Double {abstract}
-  }
-  enum Request {
-    + valueOf(name : String) : Request {static}
-    + values() : Request[] {static}
-  }
-  class Create {
-    - cost : Double
-    - name : String
-    - price : Double
-    - supplier : String
-    + Create()
-    + getCost() : Double
-    + getName() : String
-    + getPrice() : Double
-    + getSupplier() : String
-    + setCost(cost : Double) : Create
-    + setName(name : String) : Create
-    + setPrice(price : Double) : Create
-    + setSupplier(supplier : String) : Create
-  }
-  enum Response {
-    + valueOf(name : String) : Response {static}
-    + values() : Response[] {static}
-  }
-  class Private {
-    - cost : Double
-    - id : Long
-    - name : String
-    - price : Double
-    + Private()
-    + getCost() : Double
-    + getId() : Long
-    + getName() : String
-    + getPrice() : Double
-    + setCost(cost : Double) : Private
-    + setId(id : Long) : Private
-    + setName(name : String) : Private
-    + setPrice(price : Double) : Private
-    + toString() : String
-  }
-  class Public {
-    - id : Long
-    - name : String
-    - price : Double
-    + Public()
-    + getId() : Long
-    + getName() : String
-    + getPrice() : Double
-    + setId(id : Long) : Public
-    + setName(name : String) : Public
-    + setPrice(price : Double) : Public
-    + toString() : String
-  }
-  -interface Supplier {
-    + getSupplier() : String {abstract}
-  }
-  class ProductResource {
-    - products : List<Product>
-    + ProductResource(products : List<Product>)
-    + getAllProductsForAdmin() : List<Private>
-    + getAllProductsForCustomer() : List<Public>
-    + getProducts() : List<Product>
-    + save(createProductDTO : Create)
-  }
-}
-Create ..+ Request
-Request ..+ ProductDTO
-Private ..+ Response
-Supplier ..+ ProductDTO
-Name ..+ ProductDTO
-ProductResource -->  "-products" Product
-Public ..+ Response
-Id ..+ ProductDTO
-Price ..+ ProductDTO
-Response ..+ ProductDTO
-Cost ..+ ProductDTO
-Create ..|> Name 
-Create ..|> Price 
-Create ..|> Cost 
-Create ..|> Supplier 
-Private ..|> Id 
-Private ..|> Name 
-Private ..|> Price 
-Private ..|> Cost 
-Public ..|> Id 
-Public ..|> Name 
-Public ..|> Price 
-@enduml
diff --git a/data-transfer-object-enum-impl/etc/dto-enum-uml.png b/data-transfer-object-enum-impl/etc/dto-enum-uml.png
deleted file mode 100644
index 57e9a1ab520db212a7ff5635c5b1b2125af7ffe6..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 123167
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

diff --git a/data-transfer-object-enum-impl/pom.xml b/data-transfer-object-enum-impl/pom.xml
deleted file mode 100644
index 74c8a3a6c..000000000
--- a/data-transfer-object-enum-impl/pom.xml
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!--
-
-    The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in
-    all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-    THE SOFTWARE.
-
--->
-<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0">
-    <modelVersion>4.0.0</modelVersion>
-    <parent>
-        <groupId>com.iluwatar</groupId>
-        <artifactId>java-design-patterns</artifactId>
-        <version>1.24.0-SNAPSHOT</version>
-    </parent>
-    <artifactId>data-transfer-object-enum-impl</artifactId>
-    <dependencies>
-        <dependency>
-            <groupId>org.junit.jupiter</groupId>
-            <artifactId>junit-jupiter-engine</artifactId>
-            <scope>test</scope>
-        </dependency>
-    </dependencies>
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-assembly-plugin</artifactId>
-                <executions>
-                    <execution>
-                        <configuration>
-                            <archive>
-                                <manifest>
-                                    <mainClass>com.iluwatar.datatransferenum.App</mainClass>
-                                </manifest>
-                            </archive>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-        </plugins>
-    </build>
-</project>
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java b/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
deleted file mode 100644
index 9c80d07cc..000000000
--- a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/App.java
+++ /dev/null
@@ -1,59 +0,0 @@
-package com.iluwatar.datatransferenum;
-
-import java.util.ArrayList;
-import java.util.Arrays;
-import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * The Data Transfer Object pattern is a design pattern in which an data transfer object is used to
- * serve related information together to avoid multiple call for each piece of information.
- *
- * <p>In this example, ({@link App}) as as product details consumer i.e. client to
- * request for product details to server.
- *
- * <p>productResource ({@link ProductResource}) act as server to serve product information. And
- * The productDto ({@link ProductDto} is data transfer object to share product information.
- */
-public class App {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
-  /**
-   * Method as act client and request to server for details.
-   *
-   * @param args program argument.
-   */
-  public static void main(String[] args) {
-    Product tv =
-        new Product().setId(1L).setName("TV").setSupplier("Sony").setPrice(1000D).setCost(1090D);
-    Product microwave =
-        new Product().setId(2L).setName("microwave").setSupplier("Delonghi").setPrice(1000D)
-            .setCost(1090D);
-    Product refrigerator =
-        new Product().setId(3L).setName("refrigerator").setSupplier("Botsch").setPrice(1000D)
-            .setCost(1090D);
-    Product airConditioner =
-        new Product().setId(4L).setName("airConditioner").setSupplier("LG").setPrice(1000D)
-            .setCost(1090D);
-    List<Product> products =
-        new ArrayList<>(Arrays.asList(tv, microwave, refrigerator, airConditioner));
-    ProductResource productResource = new ProductResource(products);
-
-    LOGGER.info("####### List of products including sensitive data just for admins: \n {}",
-        Arrays.toString(productResource.getAllProductsForAdmin().toArray()));
-    LOGGER.info("####### List of products for customers: \n {}",
-        Arrays.toString(productResource.getAllProductsForCustomer().toArray()));
-
-    LOGGER.info("####### Going to save Sony PS5 ...");
-    ProductDto.Request.Create createProductRequestDto = new ProductDto.Request.Create()
-        .setName("PS5")
-        .setCost(1000D)
-        .setPrice(1220D)
-        .setSupplier("Sony");
-    productResource.save(createProductRequestDto);
-    LOGGER.info("####### List of products after adding PS5: {}",
-        Arrays.toString(productResource.getProducts().toArray()));
-  }
-}
diff --git a/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java b/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java
deleted file mode 100644
index bba131e64..000000000
--- a/data-transfer-object-enum-impl/src/test/java/com/iluwatar/datatransferenum/AppTest.java
+++ /dev/null
@@ -1,44 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.datatransferenum;
-
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-
-
-import org.junit.jupiter.api.Test;
-
-class AppTest {
-
-  /**
-   * Issue: Add at least one assertion to this test case.
-   * <p>
-   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
-   * throws an exception.
-   */
-
-  @Test
-  void shouldExecuteApplicationWithoutException() {
-    assertDoesNotThrow(() -> App.main(new String[] {}));
-  }
-}
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
index b8630d4ea..5bee4e27f 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
@@ -23,7 +23,13 @@
 
 package com.iluwatar.datatransfer;
 
+import com.iluwatar.datatransfer.customer.CustomerDto;
+import com.iluwatar.datatransfer.customer.CustomerResource;
+import com.iluwatar.datatransfer.product.Product;
+import com.iluwatar.datatransfer.product.ProductDto;
+import com.iluwatar.datatransfer.product.ProductResource;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.List;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -32,11 +38,17 @@ import org.slf4j.LoggerFactory;
  * The Data Transfer Object pattern is a design pattern in which an data transfer object is used to
  * serve related information together to avoid multiple call for each piece of information.
  *
- * <p>In this example, ({@link App}) as as customer details consumer i.e. client to
- * request for customer details to server.
+ * <p>In the first example, {@link App} is a customer details consumer i.e. client to
+ * request for customer details to server. {@link CustomerResource} act as server to serve customer
+ * information. {@link CustomerDto} is data transfer object to share customer information.
+ *
+ * <p>In the second example, {@link App} is a product details consumer i.e. client to
+ * request for product details to server. {@link ProductResource} acts as server to serve
+ * product information. {@link ProductDto} is data transfer object to share product information.
+ *
+ * <p>The pattern implementation is a bit different in each of the examples. The first can be
+ * thought as a traditional example and the second is an enum based implementation.
  *
- * <p>CustomerResource ({@link CustomerResource}) act as server to serve customer information. And
- * The CustomerDto ({@link CustomerDto} is data transfer object to share customer information.
  */
 public class App {
 
@@ -48,6 +60,8 @@ public class App {
    * @param args program argument.
    */
   public static void main(String[] args) {
+
+    // Example 1: Customer DTO
     var customerOne = new CustomerDto("1", "Kelly", "Brown");
     var customerTwo = new CustomerDto("2", "Alfonso", "Bass");
     var customers = new ArrayList<>(List.of(customerOne, customerTwo));
@@ -72,6 +86,53 @@ public class App {
     customerResource.save(customerThree);
     allCustomers = customerResource.getAllCustomers();
     printCustomerDetails(allCustomers);
+
+    // Example 2: Product DTO
+    Product tv =
+        new Product().setId(1L).setName("TV").setSupplier("Sony").setPrice(1000D).setCost(1090D);
+    Product microwave =
+        new Product()
+            .setId(2L)
+            .setName("microwave")
+            .setSupplier("Delonghi")
+            .setPrice(1000D)
+            .setCost(1090D);
+    Product refrigerator =
+        new Product()
+            .setId(3L)
+            .setName("refrigerator")
+            .setSupplier("Botsch")
+            .setPrice(1000D)
+            .setCost(1090D);
+    Product airConditioner =
+        new Product()
+            .setId(4L)
+            .setName("airConditioner")
+            .setSupplier("LG")
+            .setPrice(1000D)
+            .setCost(1090D);
+    List<Product> products =
+        new ArrayList<>(Arrays.asList(tv, microwave, refrigerator, airConditioner));
+    ProductResource productResource = new ProductResource(products);
+
+    LOGGER.info(
+        "####### List of products including sensitive data just for admins: \n {}",
+        Arrays.toString(productResource.getAllProductsForAdmin().toArray()));
+    LOGGER.info(
+        "####### List of products for customers: \n {}",
+        Arrays.toString(productResource.getAllProductsForCustomer().toArray()));
+
+    LOGGER.info("####### Going to save Sony PS5 ...");
+    ProductDto.Request.Create createProductRequestDto =
+        new ProductDto.Request.Create()
+            .setName("PS5")
+            .setCost(1000D)
+            .setPrice(1220D)
+            .setSupplier("Sony");
+    productResource.save(createProductRequestDto);
+    LOGGER.info(
+        "####### List of products after adding PS5: {}",
+        Arrays.toString(productResource.getProducts().toArray()));
   }
 
   private static void printCustomerDetails(List<CustomerDto> allCustomers) {
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerDto.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
similarity index 97%
rename from data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerDto.java
rename to data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
index a77eb8702..50d3a0857 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerDto.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
@@ -21,7 +21,7 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.datatransfer;
+package com.iluwatar.datatransfer.customer;
 
 /**
  * {@link CustomerDto} is a data transfer object POJO. Instead of sending individual information to
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerResource.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
similarity index 98%
rename from data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerResource.java
rename to data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
index d0a153f6f..edd3fcb6d 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/CustomerResource.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
@@ -21,7 +21,7 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.datatransfer;
+package com.iluwatar.datatransfer.customer;
 
 import java.util.List;
 
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
similarity index 58%
rename from data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java
rename to data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
index 96758baf4..698052efe 100644
--- a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/Product.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
@@ -1,4 +1,27 @@
-package com.iluwatar.datatransferenum;
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.datatransfer.product;
 
 /**
  * {@link Product} is a entity class for product entity. This class act as entity in the demo.
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
similarity index 82%
rename from data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java
rename to data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
index 49d08d896..97c2acd05 100644
--- a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductDto.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
@@ -1,4 +1,27 @@
-package com.iluwatar.datatransferenum;
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.datatransfer.product;
 
 /**
  * {@link ProductDto} is a data transfer object POJO.
diff --git a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
similarity index 62%
rename from data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java
rename to data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
index 5940982b1..abb869254 100644
--- a/data-transfer-object-enum-impl/src/main/java/com/iluwatar/datatransferenum/ProductResource.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
@@ -1,4 +1,27 @@
-package com.iluwatar.datatransferenum;
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.datatransfer.product;
 
 import java.util.List;
 import java.util.stream.Collectors;
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/CustomerResourceTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
similarity index 94%
rename from data-transfer-object/src/test/java/com/iluwatar/datatransfer/CustomerResourceTest.java
rename to data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
index 7765fd5bf..8b2d0d92a 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/CustomerResourceTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
@@ -21,13 +21,16 @@
  * THE SOFTWARE.
  */
 
-package com.iluwatar.datatransfer;
+package com.iluwatar.datatransfer.customer;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import java.util.ArrayList;
 import java.util.List;
+
+import com.iluwatar.datatransfer.customer.CustomerDto;
+import com.iluwatar.datatransfer.customer.CustomerResource;
 import org.junit.jupiter.api.Test;
 
 /**
diff --git a/pom.xml b/pom.xml
index 38e702761..eee0cb154 100644
--- a/pom.xml
+++ b/pom.xml
@@ -199,7 +199,6 @@
         <module>filterer</module>
         <module>factory</module>
         <module>separated-interface</module>
-        <module>data-transfer-object-enum-impl</module>
         <module>special-case</module>
     </modules>
 
diff --git a/registry/pom.xml b/registry/pom.xml
index 852bcacfd..bb02f1184 100644
--- a/registry/pom.xml
+++ b/registry/pom.xml
@@ -1,4 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/registry/src/main/java/com/iluwatar/registry/App.java b/registry/src/main/java/com/iluwatar/registry/App.java
index a593ce5cc..5dbcf0c05 100644
--- a/registry/src/main/java/com/iluwatar/registry/App.java
+++ b/registry/src/main/java/com/iluwatar/registry/App.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.registry;
 
 import org.slf4j.Logger;
diff --git a/registry/src/main/java/com/iluwatar/registry/Customer.java b/registry/src/main/java/com/iluwatar/registry/Customer.java
index 354999fdf..d70407887 100644
--- a/registry/src/main/java/com/iluwatar/registry/Customer.java
+++ b/registry/src/main/java/com/iluwatar/registry/Customer.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.registry;
 
 public class Customer {
diff --git a/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
index 406d616c6..62453d425 100644
--- a/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
+++ b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.registry;
 
 import java.util.Map;
diff --git a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
index 2919390b9..3a23eec2f 100644
--- a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
+++ b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.registry;
 
 import org.junit.jupiter.api.BeforeAll;
diff --git a/special-case/pom.xml b/special-case/pom.xml
index c62b9e759..a0ce1b46b 100644
--- a/special-case/pom.xml
+++ b/special-case/pom.xml
@@ -1,4 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/App.java b/special-case/src/main/java/com/iluwatar/specialcase/App.java
index 276b1dd85..f7245da37 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/App.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/App.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
index f756ccc43..9ad2de619 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public interface ApplicationServices {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
index ebb9109bc..43b123673 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public class ApplicationServicesImpl implements ApplicationServices {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/Db.java b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
index 847330ece..7696e9865 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/Db.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import java.util.HashMap;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
index a052eb20b..fadd40278 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public interface DomainServices {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
index 400689ed9..a9e40ba7a 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public class DomainServicesImpl implements DomainServices {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
index 98a2cf89c..9076202b5 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
index 8fe714f80..4bf5af883 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
index 443fdc7bf..4accfaa42 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
index 29a5b4f81..ffe0c2628 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
index e3904964f..8ed509f62 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public class MoneyTransaction {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
index 5359bed31..a06eb4360 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
index 81fc46bbe..5323f7190 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import org.slf4j.Logger;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
index 482eef21f..fd9b42cad 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 public interface ReceiptViewModel {
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
index 25799368b..1c33e0513 100644
--- a/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
+++ b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
index 5e83aa8d6..573afe0a2 100644
--- a/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
+++ b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.specialcase;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
diff --git a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
index d74806017..042f6e7cc 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.strategy;
 
 import org.slf4j.Logger;

From b9da15dda36bb3a14e8f0eadbb4a5154814bbf15 Mon Sep 17 00:00:00 2001
From: Rohit Singh <rohitsingh18997@gmail.com>
Date: Wed, 27 Jan 2021 01:49:36 +0530
Subject: [PATCH 204/254] issue 1628 handled, removed mutex and semaphore from
 catalog. (#1634)

* issue 1628 handled, removed mutex and semaphore from catalog.

* issue1634, modules still exiting in pom.xml

Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 mutex/README.md                               |  31 -----
 mutex/etc/mutex.png                           | Bin 12737 -> 0 bytes
 mutex/etc/mutex.urm.puml                      |  27 ----
 mutex/pom.xml                                 |  61 ---------
 .../src/main/java/com/iluwatar/mutex/App.java |  49 -------
 .../src/main/java/com/iluwatar/mutex/Jar.java |  67 ----------
 .../main/java/com/iluwatar/mutex/Lock.java    |  35 -----
 .../main/java/com/iluwatar/mutex/Mutex.java   |  67 ----------
 .../main/java/com/iluwatar/mutex/Thief.java   |  67 ----------
 .../test/java/com/iluwatar/mutex/AppTest.java |  39 ------
 .../test/java/com/iluwatar/mutex/JarTest.java |  45 -------
 .../java/com/iluwatar/mutex/MutexTest.java    |  51 --------
 pom.xml                                       |   2 -
 semaphore/README.md                           |  33 -----
 semaphore/etc/semaphore.png                   | Bin 30089 -> 0 bytes
 semaphore/etc/semaphore.urm.puml              |  56 --------
 semaphore/pom.xml                             |  61 ---------
 .../main/java/com/iluwatar/semaphore/App.java |  50 --------
 .../java/com/iluwatar/semaphore/Customer.java |  82 ------------
 .../java/com/iluwatar/semaphore/Fruit.java    |  64 ----------
 .../com/iluwatar/semaphore/FruitBowl.java     |  92 --------------
 .../com/iluwatar/semaphore/FruitShop.java     | 120 ------------------
 .../java/com/iluwatar/semaphore/Lock.java     |  35 -----
 .../com/iluwatar/semaphore/Semaphore.java     |  77 -----------
 .../java/com/iluwatar/semaphore/AppTest.java  |  39 ------
 .../com/iluwatar/semaphore/FruitBowlTest.java |  55 --------
 .../com/iluwatar/semaphore/SemaphoreTest.java |  59 ---------
 27 files changed, 1364 deletions(-)
 delete mode 100644 mutex/README.md
 delete mode 100644 mutex/etc/mutex.png
 delete mode 100644 mutex/etc/mutex.urm.puml
 delete mode 100644 mutex/pom.xml
 delete mode 100644 mutex/src/main/java/com/iluwatar/mutex/App.java
 delete mode 100644 mutex/src/main/java/com/iluwatar/mutex/Jar.java
 delete mode 100644 mutex/src/main/java/com/iluwatar/mutex/Lock.java
 delete mode 100644 mutex/src/main/java/com/iluwatar/mutex/Mutex.java
 delete mode 100644 mutex/src/main/java/com/iluwatar/mutex/Thief.java
 delete mode 100644 mutex/src/test/java/com/iluwatar/mutex/AppTest.java
 delete mode 100644 mutex/src/test/java/com/iluwatar/mutex/JarTest.java
 delete mode 100644 mutex/src/test/java/com/iluwatar/mutex/MutexTest.java
 delete mode 100644 semaphore/README.md
 delete mode 100644 semaphore/etc/semaphore.png
 delete mode 100644 semaphore/etc/semaphore.urm.puml
 delete mode 100644 semaphore/pom.xml
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/App.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/Customer.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/Fruit.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/FruitBowl.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/FruitShop.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/Lock.java
 delete mode 100644 semaphore/src/main/java/com/iluwatar/semaphore/Semaphore.java
 delete mode 100644 semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
 delete mode 100644 semaphore/src/test/java/com/iluwatar/semaphore/FruitBowlTest.java
 delete mode 100644 semaphore/src/test/java/com/iluwatar/semaphore/SemaphoreTest.java

diff --git a/mutex/README.md b/mutex/README.md
deleted file mode 100644
index 997c37a35..000000000
--- a/mutex/README.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-layout: pattern
-title: Mutex
-folder: mutex
-permalink: /patterns/mutex/
-categories: Concurrency
-tags: 
- - Decoupling
----
-
-## Also known as
-
-* Mutual Exclusion Lock
-* Binary Semaphore
-
-## Intent
-Create a lock which only allows a single thread to access a resource at any one instant.
-
-## Class diagram
-![alt text](./etc/mutex.png "Mutex")
-
-## Applicability
-Use a Mutex when
-
-* You need to prevent two threads accessing a critical section at the same time
-* Concurrent access to a resource could lead to a race condition 
-
-## Credits
-
-* [Lock (computer science)](http://en.wikipedia.org/wiki/Lock_(computer_science))
-* [Semaphores](http://tutorials.jenkov.com/java-concurrency/semaphores.html)
diff --git a/mutex/etc/mutex.png b/mutex/etc/mutex.png
deleted file mode 100644
index 3b7c966f87dffab72c65a77c2578c801086f7d9e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 12737
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
RF7OUbSwT&{Qq~OqKL9K>lx6?`

diff --git a/mutex/etc/mutex.urm.puml b/mutex/etc/mutex.urm.puml
deleted file mode 100644
index 08cf43b90..000000000
--- a/mutex/etc/mutex.urm.puml
+++ /dev/null
@@ -1,27 +0,0 @@
-@startuml
-package com.iluwatar.mutex {
-  class App {
-    + App()
-    + main(args : String[]) {static}
-  }
-  class Jar {
-    - beans : int
-    - lock : Lock
-    + Jar(beans : int, lock : Lock)
-    + takeBean() : boolean
-  }
-  interface Lock {
-    + acquire() {abstract}
-    + release() {abstract}
-  }
-  class Mutex {
-    - owner : Object
-    + Mutex()
-    + acquire()
-    + getOwner() : Object
-    + release()
-  }
-}
-Jar -->  "-lock" Lock
-Mutex ..|> Lock 
-@enduml
\ No newline at end of file
diff --git a/mutex/pom.xml b/mutex/pom.xml
deleted file mode 100644
index 84455abb1..000000000
--- a/mutex/pom.xml
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in
-    all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-    THE SOFTWARE.
-
--->
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <modelVersion>4.0.0</modelVersion>
-  <parent>
-    <groupId>com.iluwatar</groupId>
-    <artifactId>java-design-patterns</artifactId>
-    <version>1.24.0-SNAPSHOT</version>
-  </parent>
-  <artifactId>mutex</artifactId>
-  <dependencies>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-engine</artifactId>
-      <scope>test</scope>
-    </dependency>
-  </dependencies>
-  <build>
-    <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-assembly-plugin</artifactId>
-        <executions>
-          <execution>
-            <configuration>
-              <archive>
-                <manifest>
-                  <mainClass>com.iluwatar.mutex.App</mainClass>
-                </manifest>
-              </archive>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-    </plugins>
-  </build>
-</project>
diff --git a/mutex/src/main/java/com/iluwatar/mutex/App.java b/mutex/src/main/java/com/iluwatar/mutex/App.java
deleted file mode 100644
index c50acc65a..000000000
--- a/mutex/src/main/java/com/iluwatar/mutex/App.java
+++ /dev/null
@@ -1,49 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-/**
- * A Mutex prevents multiple threads from accessing a resource simultaneously.
- *
- * <p>In this example we have two thieves who are taking beans from a jar. Only one thief can take
- * a bean at a time. This is ensured by a Mutex lock which must be acquired in order to access the
- * jar. Each thief attempts to acquire the lock, take a bean and then release the lock. If the lock
- * has already been acquired, the thief will be prevented from continuing (blocked) until the lock
- * has been released. The thieves stop taking beans once there are no beans left to take.
- */
-public class App {
-
-  /**
-   * main method.
-   */
-  public static void main(String[] args) {
-    var mutex = new Mutex();
-    var jar = new Jar(1000, mutex);
-    var peter = new Thief("Peter", jar);
-    var john = new Thief("John", jar);
-    peter.start();
-    john.start();
-  }
-
-}
diff --git a/mutex/src/main/java/com/iluwatar/mutex/Jar.java b/mutex/src/main/java/com/iluwatar/mutex/Jar.java
deleted file mode 100644
index 4a0861e1a..000000000
--- a/mutex/src/main/java/com/iluwatar/mutex/Jar.java
+++ /dev/null
@@ -1,67 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-/**
- * A Jar has a resource of beans which can only be accessed by a single Thief (thread) at any one
- * time. A Mutex lock is used to prevent more than one Thief taking a bean simultaneously.
- */
-public class Jar {
-
-  /**
-   * The lock which must be acquired to access the beans resource.
-   */
-  private final Lock lock;
-
-  /**
-   * The resource within the jar.
-   */
-  private int beans;
-
-  public Jar(int beans, Lock lock) {
-    this.beans = beans;
-    this.lock = lock;
-  }
-
-  /**
-   * Method for a thief to take a bean.
-   */
-  public boolean takeBean() {
-    var success = false;
-    try {
-      lock.acquire();
-      success = beans > 0;
-      if (success) {
-        beans = beans - 1;
-      }
-    } catch (Exception e) {
-      e.printStackTrace();
-    } finally {
-      lock.release();
-    }
-
-    return success;
-  }
-
-}
diff --git a/mutex/src/main/java/com/iluwatar/mutex/Lock.java b/mutex/src/main/java/com/iluwatar/mutex/Lock.java
deleted file mode 100644
index bd28c3c08..000000000
--- a/mutex/src/main/java/com/iluwatar/mutex/Lock.java
+++ /dev/null
@@ -1,35 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-/**
- * Lock is an interface for a lock which can be acquired and released.
- */
-public interface Lock {
-
-  void acquire() throws InterruptedException;
-
-  void release();
-
-}
diff --git a/mutex/src/main/java/com/iluwatar/mutex/Mutex.java b/mutex/src/main/java/com/iluwatar/mutex/Mutex.java
deleted file mode 100644
index 6c62cc8ea..000000000
--- a/mutex/src/main/java/com/iluwatar/mutex/Mutex.java
+++ /dev/null
@@ -1,67 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-/**
- * Mutex is an implementation of a mutual exclusion lock.
- */
-public class Mutex implements Lock {
-
-  /**
-   * The current owner of the lock.
-   */
-  private Object owner;
-
-  /**
-   * Returns the current owner of the Mutex, or null if available.
-   */
-  public Object getOwner() {
-    return owner;
-  }
-
-  /**
-   * Method called by a thread to acquire the lock. If the lock has already been acquired this will
-   * wait until the lock has been released to re-attempt the acquire.
-   */
-  @Override
-  public synchronized void acquire() throws InterruptedException {
-    while (owner != null) {
-      wait();
-    }
-
-    owner = Thread.currentThread();
-  }
-
-  /**
-   * Method called by a thread to release the lock.
-   */
-  @Override
-  public synchronized void release() {
-    if (Thread.currentThread() == owner) {
-      owner = null;
-      notify();
-    }
-  }
-
-}
diff --git a/mutex/src/main/java/com/iluwatar/mutex/Thief.java b/mutex/src/main/java/com/iluwatar/mutex/Thief.java
deleted file mode 100644
index a9a715970..000000000
--- a/mutex/src/main/java/com/iluwatar/mutex/Thief.java
+++ /dev/null
@@ -1,67 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * Thief is a class which continually tries to acquire a jar and take a bean from it. When the jar
- * is empty the thief stops.
- */
-public class Thief extends Thread {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(Thief.class);
-
-  /**
-   * The name of the thief.
-   */
-  private final String name;
-
-  /**
-   * The jar.
-   */
-  private final Jar jar;
-
-  public Thief(String name, Jar jar) {
-    this.name = name;
-    this.jar = jar;
-  }
-
-  /**
-   * In the run method the thief repeatedly tries to take a bean until none are left.
-   */
-  @Override
-  public void run() {
-    var beans = 0;
-
-    while (jar.takeBean()) {
-      beans = beans + 1;
-      LOGGER.info("{} took a bean.", name);
-    }
-
-    LOGGER.info("{} took {} beans.", name, beans);
-  }
-
-}
diff --git a/mutex/src/test/java/com/iluwatar/mutex/AppTest.java b/mutex/src/test/java/com/iluwatar/mutex/AppTest.java
deleted file mode 100644
index 7866b22a8..000000000
--- a/mutex/src/test/java/com/iluwatar/mutex/AppTest.java
+++ /dev/null
@@ -1,39 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-import org.junit.jupiter.api.Test;
-
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-
-/**
- * Application Test Entrypoint
- */
-class AppTest {
-
-  @Test
-  void shouldExecuteApplicationWithoutException() {
-    assertDoesNotThrow(() -> App.main(new String[]{}));
-  }
-}
diff --git a/mutex/src/test/java/com/iluwatar/mutex/JarTest.java b/mutex/src/test/java/com/iluwatar/mutex/JarTest.java
deleted file mode 100644
index 786f96e44..000000000
--- a/mutex/src/test/java/com/iluwatar/mutex/JarTest.java
+++ /dev/null
@@ -1,45 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-import static org.junit.jupiter.api.Assertions.assertFalse;
-
-import java.util.stream.IntStream;
-import org.junit.jupiter.api.Assertions;
-import org.junit.jupiter.api.Test;
-
-/**
- * Test case for taking beans from a Jar
- */
-public class JarTest {
-
-  @Test
-  public void testTakeBeans() {
-    var mutex = new Mutex();
-    var jar = new Jar(10, mutex);
-    IntStream.range(0, 10).mapToObj(i -> jar.takeBean()).forEach(Assertions::assertTrue);
-    assertFalse(jar.takeBean());
-  }
-
-}
diff --git a/mutex/src/test/java/com/iluwatar/mutex/MutexTest.java b/mutex/src/test/java/com/iluwatar/mutex/MutexTest.java
deleted file mode 100644
index d6d0cc1d7..000000000
--- a/mutex/src/test/java/com/iluwatar/mutex/MutexTest.java
+++ /dev/null
@@ -1,51 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.mutex;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNull;
-import static org.junit.jupiter.api.Assertions.fail;
-
-import org.junit.jupiter.api.Test;
-
-/**
- * Test case for acquiring and releasing a Mutex
- */
-public class MutexTest {
-
-  @Test
-  public void acquireReleaseTest() {
-    var mutex = new Mutex();
-    assertNull(mutex.getOwner());
-    try {
-      mutex.acquire();
-      assertEquals(mutex.getOwner(), Thread.currentThread());
-    } catch (InterruptedException e) {
-      fail(e.toString());
-    }
-    mutex.release();
-    assertNull(mutex.getOwner());
-  }
-
-}
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index eee0cb154..a3fb757a3 100644
--- a/pom.xml
+++ b/pom.xml
@@ -141,8 +141,6 @@
         <module>module</module>
         <module>monad</module>
         <module>mute-idiom</module>
-        <module>mutex</module>
-        <module>semaphore</module>
         <module>hexagonal</module>
         <module>abstract-document</module>
         <module>aggregator-microservices</module>
diff --git a/semaphore/README.md b/semaphore/README.md
deleted file mode 100644
index be882e04a..000000000
--- a/semaphore/README.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: pattern
-title: Semaphore
-folder: semaphore
-permalink: /patterns/semaphore/
-categories: Concurrency
-tags: 
- - Performance
----
-
-## Also known as
-Counting Semaphore
-
-## Intent
-Create a lock which mediates access to a pool of resources. 
-Only a limited number of threads, specified at the creation 
-of the semaphore, can access the resources at any given time.
-A semaphore which only allows one concurrent access to a resource
-is called a binary semaphore.
-
-## Class diagram
-![alt text](./etc/semaphore.png "Semaphore")
-
-## Applicability
-Use a Semaphore when 
-
-* You have a pool of resources to allocate to different threads
-* Concurrent access to a resource could lead to a race condition 
-
-## Credits
-
-* [Semaphore(programming)] (http://en.wikipedia.org/wiki/Semaphore_(programming))
-* [Semaphores] (http://tutorials.jenkov.com/java-concurrency/semaphores.html)
diff --git a/semaphore/etc/semaphore.png b/semaphore/etc/semaphore.png
deleted file mode 100644
index a2ff6d0c4f5bb931d724a4dd3872e7dde4730102..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 30089
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

diff --git a/semaphore/etc/semaphore.urm.puml b/semaphore/etc/semaphore.urm.puml
deleted file mode 100644
index 168fd17e7..000000000
--- a/semaphore/etc/semaphore.urm.puml
+++ /dev/null
@@ -1,56 +0,0 @@
-@startuml
-package com.iluwatar.semaphore {
-  class App {
-    + App()
-    + main(args : String[]) {static}
-  }
-  class Fruit {
-    - type : FruitType
-    + Fruit(type : FruitType)
-    + getType() : FruitType
-    + toString() : String
-  }
-  enum FruitType {
-    + APPLE {static}
-    + LEMON {static}
-    + ORANGE {static}
-    + valueOf(name : String) : FruitType {static}
-    + values() : FruitType[] {static}
-  }
-  class FruitBowl {
-    - fruit : List<Fruit>
-    + FruitBowl()
-    + countFruit() : int
-    + put(f : Fruit)
-    + take() : Fruit
-    + toString() : String
-  }
-  class FruitShop {
-    - available : boolean[]
-    - bowls : FruitBowl[]
-    - semaphore : Semaphore
-    + FruitShop()
-    + countFruit() : int
-    + returnBowl(bowl : FruitBowl)
-    + takeBowl() : FruitBowl
-  }
-  interface Lock {
-    + acquire() {abstract}
-    + release() {abstract}
-  }
-  class Semaphore {
-    - counter : int
-    - licenses : int
-    + Semaphore(licenses : int)
-    + acquire()
-    + getAvailableLicenses() : int
-    + getNumLicenses() : int
-    + release()
-  }
-}
-FruitType ..+ Fruit
-Fruit -->  "-type" FruitType
-FruitShop -->  "-semaphore" Semaphore
-FruitBowl -->  "-fruit" Fruit
-Semaphore ..|> Lock 
-@enduml
\ No newline at end of file
diff --git a/semaphore/pom.xml b/semaphore/pom.xml
deleted file mode 100644
index 64fd44db6..000000000
--- a/semaphore/pom.xml
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0"?>
-<!--
-
-    The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in
-    all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-    THE SOFTWARE.
-
--->
-<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <modelVersion>4.0.0</modelVersion>
-  <parent>
-    <groupId>com.iluwatar</groupId>
-    <artifactId>java-design-patterns</artifactId>
-    <version>1.24.0-SNAPSHOT</version>
-  </parent>
-  <artifactId>semaphore</artifactId>
-  <dependencies>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-engine</artifactId>
-      <scope>test</scope>
-    </dependency>
-  </dependencies>
-  <build>
-    <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-assembly-plugin</artifactId>
-        <executions>
-          <execution>
-            <configuration>
-              <archive>
-                <manifest>
-                  <mainClass>com.iluwatar.semaphore.App</mainClass>
-                </manifest>
-              </archive>
-            </configuration>
-          </execution>
-        </executions>
-      </plugin>
-    </plugins>
-  </build>
-</project>
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/App.java b/semaphore/src/main/java/com/iluwatar/semaphore/App.java
deleted file mode 100644
index ebb35037f..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/App.java
+++ /dev/null
@@ -1,50 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-/**
- * A Semaphore mediates access by a group of threads to a pool of resources.
- *
- * <p>In this example a group of customers are taking fruit from a fruit shop. There is a bowl each
- * of apples, oranges and lemons. Only one customer can access a bowl simultaneously. A Semaphore is
- * used to indicate how many resources are currently available and must be acquired in order for a
- * bowl to be given to a customer. Customers continually try to take fruit until there is no fruit
- * left in the shop.
- */
-public class App {
-
-  /**
-   * main method.
-   */
-  public static void main(String[] args) {
-    var shop = new FruitShop();
-    new Customer("Peter", shop).start();
-    new Customer("Paul", shop).start();
-    new Customer("Mary", shop).start();
-    new Customer("John", shop).start();
-    new Customer("Ringo", shop).start();
-    new Customer("George", shop).start();
-  }
-
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/Customer.java b/semaphore/src/main/java/com/iluwatar/semaphore/Customer.java
deleted file mode 100644
index 47f503a06..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/Customer.java
+++ /dev/null
@@ -1,82 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * A Customer attempts to repeatedly take Fruit from the FruitShop by taking Fruit from FruitBowl
- * instances.
- */
-public class Customer extends Thread {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(Customer.class);
-
-  /**
-   * Name of the Customer.
-   */
-  private final String name;
-
-  /**
-   * The FruitShop he is using.
-   */
-  private final FruitShop fruitShop;
-
-  /**
-   * Their bowl of Fruit.
-   */
-  private final FruitBowl fruitBowl;
-
-  /**
-   * Customer constructor.
-   */
-  public Customer(String name, FruitShop fruitShop) {
-    this.name = name;
-    this.fruitShop = fruitShop;
-    this.fruitBowl = new FruitBowl();
-  }
-
-  /**
-   * The Customer repeatedly takes Fruit from the FruitShop until no Fruit remains.
-   */
-  public void run() {
-
-    while (fruitShop.countFruit() > 0) {
-      var bowl = fruitShop.takeBowl();
-      if (bowl != null) {
-        var fruit = bowl.take();
-        if (fruit != null) {
-          LOGGER.info("{} took an {}", name, fruit);
-          fruitBowl.put(fruit);
-          fruitShop.returnBowl(bowl);
-        }
-      }
-    }
-
-    LOGGER.info("{} took {}", name, fruitBowl);
-
-  }
-
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/Fruit.java b/semaphore/src/main/java/com/iluwatar/semaphore/Fruit.java
deleted file mode 100644
index 1f4026b92..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/Fruit.java
+++ /dev/null
@@ -1,64 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-/**
- * Fruit is a resource stored in a FruitBowl.
- */
-public class Fruit {
-
-  /**
-   * Enumeration of Fruit Types.
-   */
-  public enum FruitType {
-    ORANGE, APPLE, LEMON
-  }
-
-  private final FruitType type;
-
-  public Fruit(FruitType type) {
-    this.type = type;
-  }
-
-  public FruitType getType() {
-    return type;
-  }
-
-  /**
-   * toString method.
-   */
-  public String toString() {
-    switch (type) {
-      case ORANGE:
-        return "Orange";
-      case APPLE:
-        return "Apple";
-      case LEMON:
-        return "Lemon";
-      default:
-        return "";
-    }
-  }
-
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/FruitBowl.java b/semaphore/src/main/java/com/iluwatar/semaphore/FruitBowl.java
deleted file mode 100644
index 5c2901efe..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/FruitBowl.java
+++ /dev/null
@@ -1,92 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * A FruitBowl contains Fruit.
- */
-public class FruitBowl {
-
-  private final List<Fruit> fruit = new ArrayList<>();
-
-  /**
-   * Returns the amount of fruits left in bowl.
-   *
-   * @return The amount of Fruit left in the bowl.
-   */
-  public int countFruit() {
-    return fruit.size();
-  }
-
-  /**
-   * Put an item of Fruit into the bowl.
-   *
-   * @param f fruit
-   */
-  public void put(Fruit f) {
-    fruit.add(f);
-  }
-
-  /**
-   * Take an item of Fruit out of the bowl.
-   *
-   * @return The Fruit taken out of the bowl, or null if empty.
-   */
-  public Fruit take() {
-    if (fruit.isEmpty()) {
-      return null;
-    } else {
-      return fruit.remove(0);
-    }
-  }
-
-  /**
-   * toString method.
-   */
-  public String toString() {
-    var apples = 0;
-    var oranges = 0;
-    var lemons = 0;
-
-    for (var f : fruit) {
-      switch (f.getType()) {
-        case APPLE:
-          apples++;
-          break;
-        case ORANGE:
-          oranges++;
-          break;
-        case LEMON:
-          lemons++;
-          break;
-        default:
-      }
-    }
-
-    return apples + " Apples, " + oranges + " Oranges, and " + lemons + " Lemons";
-  }
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/FruitShop.java b/semaphore/src/main/java/com/iluwatar/semaphore/FruitShop.java
deleted file mode 100644
index c74145610..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/FruitShop.java
+++ /dev/null
@@ -1,120 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-/**
- * A FruitShop contains three FruitBowl instances and controls access to them.
- */
-public class FruitShop {
-
-  /**
-   * The FruitBowl instances stored in the class.
-   */
-  private final FruitBowl[] bowls = {
-      new FruitBowl(),
-      new FruitBowl(),
-      new FruitBowl()
-  };
-
-  /**
-   * Access flags for each of the FruitBowl instances.
-   */
-  private final boolean[] available = {
-      true,
-      true,
-      true
-  };
-
-  /**
-   * The Semaphore that controls access to the class resources.
-   */
-  private final Semaphore semaphore;
-
-  /**
-   * FruitShop constructor.
-   */
-  public FruitShop() {
-    for (var i = 0; i < 100; i++) {
-      bowls[0].put(new Fruit(Fruit.FruitType.APPLE));
-      bowls[1].put(new Fruit(Fruit.FruitType.ORANGE));
-      bowls[2].put(new Fruit(Fruit.FruitType.LEMON));
-    }
-
-    semaphore = new Semaphore(3);
-  }
-
-  /**
-   * Returns the amount of fruits left in shop.
-   *
-   * @return The amount of Fruit left in the shop.
-   */
-  public synchronized int countFruit() {
-    return bowls[0].countFruit() + bowls[1].countFruit() + bowls[2].countFruit();
-  }
-
-  /**
-   * Method called by Customer to get a FruitBowl from the shop. This method will try to acquire the
-   * Semaphore before returning the first available FruitBowl.
-   */
-  public synchronized FruitBowl takeBowl() {
-
-    FruitBowl bowl = null;
-
-    try {
-      semaphore.acquire();
-
-      if (available[0]) {
-        bowl = bowls[0];
-        available[0] = false;
-      } else if (available[1]) {
-        bowl = bowls[1];
-        available[1] = false;
-      } else if (available[2]) {
-        bowl = bowls[2];
-        available[2] = false;
-      }
-
-    } catch (InterruptedException e) {
-      e.printStackTrace();
-    } finally {
-      semaphore.release();
-    }
-    return bowl;
-  }
-
-  /**
-   * Method called by a Customer instance to return a FruitBowl to the shop. This method releases
-   * the Semaphore, making the FruitBowl available to another Customer.
-   */
-  public synchronized void returnBowl(FruitBowl bowl) {
-    if (bowl == bowls[0]) {
-      available[0] = true;
-    } else if (bowl == bowls[1]) {
-      available[1] = true;
-    } else if (bowl == bowls[2]) {
-      available[2] = true;
-    }
-  }
-
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/Lock.java b/semaphore/src/main/java/com/iluwatar/semaphore/Lock.java
deleted file mode 100644
index 5679e2a05..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/Lock.java
+++ /dev/null
@@ -1,35 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-/**
- * Lock is an interface for a lock which can be acquired and released.
- */
-public interface Lock {
-
-  void acquire() throws InterruptedException;
-
-  void release();
-
-}
diff --git a/semaphore/src/main/java/com/iluwatar/semaphore/Semaphore.java b/semaphore/src/main/java/com/iluwatar/semaphore/Semaphore.java
deleted file mode 100644
index 48b008fdd..000000000
--- a/semaphore/src/main/java/com/iluwatar/semaphore/Semaphore.java
+++ /dev/null
@@ -1,77 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-/**
- * Semaphore is an implementation of a semaphore lock.
- */
-public class Semaphore implements Lock {
-
-  private final int licenses;
-  /**
-   * The number of concurrent resource accesses which are allowed.
-   */
-  private int counter;
-
-  public Semaphore(int licenses) {
-    this.licenses = licenses;
-    this.counter = licenses;
-  }
-
-  /**
-   * Returns the number of licenses managed by the Semaphore.
-   */
-  public int getNumLicenses() {
-    return licenses;
-  }
-
-  /**
-   * Returns the number of available licenses.
-   */
-  public int getAvailableLicenses() {
-    return counter;
-  }
-
-  /**
-   * Method called by a thread to acquire the lock. If there are no resources available this will
-   * wait until the lock has been released to re-attempt the acquire.
-   */
-  public synchronized void acquire() throws InterruptedException {
-    while (counter == 0) {
-      wait();
-    }
-    counter = counter - 1;
-  }
-
-  /**
-   * Method called by a thread to release the lock.
-   */
-  public synchronized void release() {
-    if (counter < licenses) {
-      counter = counter + 1;
-      notify();
-    }
-  }
-
-}
diff --git a/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java b/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
deleted file mode 100644
index 302796238..000000000
--- a/semaphore/src/test/java/com/iluwatar/semaphore/AppTest.java
+++ /dev/null
@@ -1,39 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-import org.junit.jupiter.api.Test;
-
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-
-/**
- * Application Test Entrypoint
- */
-class AppTest {
-
-  @Test
-  void shouldExecuteWithoutException() {
-    assertDoesNotThrow(() -> App.main(new String[]{}));
-  }
-}
diff --git a/semaphore/src/test/java/com/iluwatar/semaphore/FruitBowlTest.java b/semaphore/src/test/java/com/iluwatar/semaphore/FruitBowlTest.java
deleted file mode 100644
index bc21f9196..000000000
--- a/semaphore/src/test/java/com/iluwatar/semaphore/FruitBowlTest.java
+++ /dev/null
@@ -1,55 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertNull;
-
-import org.junit.jupiter.api.Test;
-
-/**
- * Test taking from and putting Fruit into a FruitBowl
- */
-public class FruitBowlTest {
-
-  @Test
-  public void fruitBowlTest() {
-    var fbowl = new FruitBowl();
-
-    assertEquals(0, fbowl.countFruit());
-
-    for (var i = 1; i <= 10; i++) {
-      fbowl.put(new Fruit(Fruit.FruitType.LEMON));
-      assertEquals(i, fbowl.countFruit());
-    }
-
-    for (var i = 9; i >= 0; i--) {
-      assertNotNull(fbowl.take());
-      assertEquals(i, fbowl.countFruit());
-    }
-
-    assertNull(fbowl.take());
-  }
-}
diff --git a/semaphore/src/test/java/com/iluwatar/semaphore/SemaphoreTest.java b/semaphore/src/test/java/com/iluwatar/semaphore/SemaphoreTest.java
deleted file mode 100644
index 6d64066fb..000000000
--- a/semaphore/src/test/java/com/iluwatar/semaphore/SemaphoreTest.java
+++ /dev/null
@@ -1,59 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.semaphore;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.fail;
-
-import org.junit.jupiter.api.Test;
-
-/**
- * Test case for acquiring and releasing a Semaphore
- */
-public class SemaphoreTest {
-
-  @Test
-  public void acquireReleaseTest() {
-    var sphore = new Semaphore(3);
-
-    assertEquals(3, sphore.getAvailableLicenses());
-
-    for (var i = 2; i >= 0; i--) {
-      try {
-        sphore.acquire();
-        assertEquals(i, sphore.getAvailableLicenses());
-      } catch (InterruptedException e) {
-        fail(e.toString());
-      }
-    }
-
-    for (var i = 1; i <= 3; i++) {
-      sphore.release();
-      assertEquals(i, sphore.getAvailableLicenses());
-    }
-
-    sphore.release();
-    assertEquals(3, sphore.getAvailableLicenses());
-  }
-}

From 9abfd5777c570cf44ff1e3845a00c3209d548078 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 26 Jan 2021 22:22:48 +0200
Subject: [PATCH 205/254] docs: add rohit10000 as a contributor (#1637)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index ae63d60ec..9502a2767 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1377,6 +1377,15 @@
       "contributions": [
         "translation"
       ]
+    },
+    {
+      "login": "rohit10000",
+      "name": "Rohit Singh",
+      "avatar_url": "https://avatars.githubusercontent.com/u/20845565?v=4",
+      "profile": "https://github.com/rohit10000",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 28635009f..82fa8c3cf 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-151-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-152-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -301,6 +301,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="http://libkhadir.fr"><img src="https://avatars1.githubusercontent.com/u/45130488?v=4?s=100" width="100px;" alt=""/><br /><sub><b>KHADIR Tayeb</b></sub></a><br /><a href="#translation-tkhadir" title="Translation">🌍</a></td>
     <td align="center"><a href="https://github.com/ignite1771"><img src="https://avatars2.githubusercontent.com/u/59446563?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ignite1771</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=ignite1771" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/demirhalil"><img src="https://avatars1.githubusercontent.com/u/22895118?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Halil Demir</b></sub></a><br /><a href="#translation-demirhalil" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/rohit10000"><img src="https://avatars.githubusercontent.com/u/20845565?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rohit Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=rohit10000" title="Code">💻</a></td>
   </tr>
 </table>
 

From 462b581b3441b1523db4efc42336bb51f52ef620 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Wed, 27 Jan 2021 19:54:06 +0530
Subject: [PATCH 206/254] clearing Sonar Blockers (#1633)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* update gitignore

.checkstyle files are being tracked which should not be

* NOSONAR for statement

excluded from SONAR analysis as it is already dealt using functional approach

https://sonarcloud.io/project/issues?id=iluwatar_java-design-patterns&issues=AW8FwRBhm8eoEVQR-x0f&open=AW8FwRBhm8eoEVQR-x0f

* achieved thread safety with lazy initialization

https://sonarcloud.io/project/issues?fileUuids=AXb6t0PKusn4P8Tm-LmM&id=iluwatar_java-design-patterns&open=AXb6t19yusn4P8Tm-Lmo&resolved=false

* remove double checked locking and initialize before using

https://sonarcloud.io/project/issues?fileUuids=AXb6t0PKusn4P8Tm-LmK&id=iluwatar_java-design-patterns&open=AXb6t19qusn4P8Tm-Lmk&resolved=false

* NOSONAR for the line

https://sonarcloud.io/project/issues?id=iluwatar_java-design-patterns&issues=AXPd3iSe46HRSze7cz3D&open=AXPd3iSe46HRSze7cz3D

Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 .../main/java/com/iluwatar/dao/DbCustomerDao.java |  2 +-
 .../main/java/com/iluwatar/specialcase/Db.java    | 15 ++++++---------
 .../com/iluwatar/specialcase/MaintenanceLock.java | 10 +++-------
 .../iluwatar/transactionscript/HotelDaoImpl.java  |  2 +-
 4 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
index 15f20eb43..23958cab9 100644
--- a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
@@ -67,7 +67,7 @@ public class DbCustomerDao implements CustomerDao {
   public Stream<Customer> getAll() throws Exception {
     try {
       var connection = getConnection();
-      var statement = connection.prepareStatement("SELECT * FROM CUSTOMERS");
+      var statement = connection.prepareStatement("SELECT * FROM CUSTOMERS"); // NOSONAR
       var resultSet = statement.executeQuery(); // NOSONAR
       return StreamSupport.stream(new Spliterators.AbstractSpliterator<Customer>(Long.MAX_VALUE,
           Spliterator.ORDERED) {
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/Db.java b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
index 7696e9865..4c6665fef 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/Db.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
@@ -38,16 +38,13 @@ public class Db {
    *
    * @return singleton instance of Db class
    */
-  public static Db getInstance() {
+  public static synchronized Db getInstance() {
     if (instance == null) {
-      synchronized (Db.class) {
-        if (instance == null) {
-          instance = new Db();
-          instance.userName2User = new HashMap<>();
-          instance.user2Account = new HashMap<>();
-          instance.itemName2Product = new HashMap<>();
-        }
-      }
+      Db newInstance = new Db();
+      newInstance.userName2User = new HashMap<>();
+      newInstance.user2Account = new HashMap<>();
+      newInstance.itemName2Product = new HashMap<>();
+      instance = newInstance;
     }
     return instance;
   }
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
index ffe0c2628..214e04d6b 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
@@ -38,13 +38,9 @@ public class MaintenanceLock {
    *
    * @return singleton instance of MaintenanceLock
    */
-  public static MaintenanceLock getInstance() {
+  public static synchronized MaintenanceLock getInstance() {
     if (instance == null) {
-      synchronized (MaintenanceLock.class) {
-        if (instance == null) {
-          instance = new MaintenanceLock();
-        }
-      }
+      instance = new MaintenanceLock();
     }
     return instance;
   }
@@ -55,6 +51,6 @@ public class MaintenanceLock {
 
   public void setLock(boolean lock) {
     this.lock = lock;
-    LOGGER.info("Maintenance lock is set to: " + lock);
+    LOGGER.info("Maintenance lock is set to: ", lock);
   }
 }
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
index 240f96892..07c88b698 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
@@ -49,7 +49,7 @@ public class HotelDaoImpl implements HotelDao {
   public Stream<Room> getAll() throws Exception {
     try {
       var connection = getConnection();
-      var statement = connection.prepareStatement("SELECT * FROM ROOMS");
+      var statement = connection.prepareStatement("SELECT * FROM ROOMS"); // NOSONAR
       var resultSet = statement.executeQuery(); // NOSONAR
       return StreamSupport.stream(new Spliterators.AbstractSpliterator<Room>(Long.MAX_VALUE,
           Spliterator.ORDERED) {

From 8a9e26e77a1b6164b97e10724827b58943615731 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 30 Jan 2021 12:46:40 +0200
Subject: [PATCH 207/254] docs: add byoungju94 as a contributor (#1642)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 5 ++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 9502a2767..9d21621a2 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1386,6 +1386,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "byoungju94",
+      "name": "byoungju94",
+      "avatar_url": "https://avatars.githubusercontent.com/u/42516378?v=4",
+      "profile": "https://github.com/byoungju94",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 82fa8c3cf..054094108 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-152-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-153-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -303,6 +303,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/demirhalil"><img src="https://avatars1.githubusercontent.com/u/22895118?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Halil Demir</b></sub></a><br /><a href="#translation-demirhalil" title="Translation">🌍</a></td>
     <td align="center"><a href="https://github.com/rohit10000"><img src="https://avatars.githubusercontent.com/u/20845565?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rohit Singh</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=rohit10000" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/byoungju94"><img src="https://avatars.githubusercontent.com/u/42516378?v=4?s=100" width="100px;" alt=""/><br /><sub><b>byoungju94</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=byoungju94" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-restore -->

From 663dbd298e8e9921870a8381665a3350db15ec44 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 30 Jan 2021 16:23:28 +0530
Subject: [PATCH 208/254] Update License year to 2021 (#1639)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 LICENSE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/LICENSE.md b/LICENSE.md
index 909c618ce..ff341fcb6 100644
--- a/LICENSE.md
+++ b/LICENSE.md
@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014-2020 Ilkka Seppälä
+Copyright (c) 2014-2021 Ilkka Seppälä
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

From 3f09fb70bb36a96142c3cad4e25e20e02cb6a7b0 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 30 Jan 2021 17:07:52 +0530
Subject: [PATCH 209/254] Clear Sonar Blockers (#1643)

* remove debt from CachingTest

https://sonarcloud.io/project/issues?fileUuids=AW3G0SevwB6UiZzQNqXR&id=iluwatar_java-design-patterns&open=AXK0Ozo--CiGJS70dLl0&resolved=false

Signed-off-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>

* fixed few debts for Spatial Partition module

Mainly convertig Hashtable to HashMaps

Signed-off-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>

* fixed some logger norms

Signed-off-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>

* fixed few errors as it got mixed with the stash

Signed-off-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 .../com/iluwatar/caching/CachingTest.java     | 16 +++++++++----
 .../com/iluwatar/spatialpartition/App.java    | 24 +++++++++----------
 .../com/iluwatar/spatialpartition/Bubble.java | 10 ++++----
 .../com/iluwatar/spatialpartition/Point.java  |  4 ++--
 .../SpatialPartitionBubbles.java              |  8 +++----
 .../iluwatar/spatialpartition/BubbleTest.java |  8 +++----
 .../SpatialPartitionBubblesTest.java          |  4 ++--
 7 files changed, 40 insertions(+), 34 deletions(-)

diff --git a/caching/src/test/java/com/iluwatar/caching/CachingTest.java b/caching/src/test/java/com/iluwatar/caching/CachingTest.java
index 4db4085d4..22130951a 100644
--- a/caching/src/test/java/com/iluwatar/caching/CachingTest.java
+++ b/caching/src/test/java/com/iluwatar/caching/CachingTest.java
@@ -23,13 +23,15 @@
 
 package com.iluwatar.caching;
 
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
 /**
  * Application test
  */
-public class CachingTest {
+class CachingTest {
   private App app;
 
   /**
@@ -47,22 +49,26 @@ public class CachingTest {
   }
 
   @Test
-  public void testReadAndWriteThroughStrategy() {
+  void testReadAndWriteThroughStrategy() {
+	assertNotNull(app);
     app.useReadAndWriteThroughStrategy();
   }
 
   @Test
-  public void testReadThroughAndWriteAroundStrategy() {
+  void testReadThroughAndWriteAroundStrategy() {
+	assertNotNull(app);
     app.useReadThroughAndWriteAroundStrategy();
   }
 
   @Test
-  public void testReadThroughAndWriteBehindStrategy() {
+  void testReadThroughAndWriteBehindStrategy() {
+	assertNotNull(app);
     app.useReadThroughAndWriteBehindStrategy();
   }
 
   @Test
-  public void testCacheAsideStrategy() {
+  void testCacheAsideStrategy() {
+	assertNotNull(app);
     app.useCacheAsideStategy();
   }
 }
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
index 083d6a019..69a2852d7 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.spatialpartition;
 
-import java.util.Hashtable;
+import java.util.HashMap;
 import java.util.Random;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -44,11 +44,11 @@ import org.slf4j.LoggerFactory;
  * <b>{@link Rect}</b> class to define the boundary of the quadtree. We use an abstract class
  * <b>{@link Point}</b>
  * with x and y coordinate fields and also an id field so that it can easily be put and looked up in
- * the hashtable. This class has abstract methods to define how the object moves (move()), when to
+ * the hashmap. This class has abstract methods to define how the object moves (move()), when to
  * check for collision with any object (touches(obj)) and how to handle collision
  * (handleCollision(obj)), and will be extended by any object whose position has to be kept track of
  * in the quadtree. The <b>{@link SpatialPartitionGeneric}</b> abstract class has 2 fields - a
- * hashtable containing all objects (we use hashtable for faster lookups, insertion and deletion)
+ * hashmap containing all objects (we use hashmap for faster lookups, insertion and deletion)
  * and a quadtree, and contains an abstract method which defines how to handle interactions between
  * objects using the quadtree.</p>
  * <p>Using the quadtree data structure will reduce the time complexity of finding the objects
@@ -61,7 +61,7 @@ public class App {
   private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
   private static final String BUBBLE = "Bubble ";
 
-  static void noSpatialPartition(int numOfMovements, Hashtable<Integer, Bubble> bubbles) {
+  static void noSpatialPartition(int numOfMovements, HashMap<Integer, Bubble> bubbles) {
     //all bubbles have to be checked for collision for all bubbles
     var bubblesToCheck = bubbles.values();
 
@@ -81,9 +81,9 @@ public class App {
   }
 
   static void withSpatialPartition(
-      int height, int width, int numOfMovements, Hashtable<Integer, Bubble> bubbles) {
+      int height, int width, int numOfMovements, HashMap<Integer, Bubble> bubbles) {
     //creating quadtree
-    var rect = new Rect(width / 2, height / 2, width, height);
+    var rect = new Rect(width / 2D, height / 2D, width, height);
     var quadTree = new QuadTree(rect, 4);
 
     //will run numOfMovement times or till all bubbles have popped
@@ -110,15 +110,15 @@ public class App {
    */
 
   public static void main(String[] args) {
-    var bubbles1 = new Hashtable<Integer, Bubble>();
-    var bubbles2 = new Hashtable<Integer, Bubble>();
+    var bubbles1 = new HashMap<Integer, Bubble>();
+    var bubbles2 = new HashMap<Integer, Bubble>();
     var rand = new Random();
     for (int i = 0; i < 10000; i++) {
       var b = new Bubble(rand.nextInt(300), rand.nextInt(300), i, rand.nextInt(2) + 1);
       bubbles1.put(i, b);
       bubbles2.put(i, b);
-      LOGGER.info(BUBBLE + i + " with radius " + b.radius
-          + " added at (" + b.coordinateX + "," + b.coordinateY + ")");
+      LOGGER.info(BUBBLE, i, " with radius ", b.radius,
+          " added at (", b.coordinateX, ",", b.coordinateY + ")");
     }
 
     var start1 = System.currentTimeMillis();
@@ -127,8 +127,8 @@ public class App {
     var start2 = System.currentTimeMillis();
     App.withSpatialPartition(300, 300, 20, bubbles2);
     var end2 = System.currentTimeMillis();
-    LOGGER.info("Without spatial partition takes " + (end1 - start1) + "ms");
-    LOGGER.info("With spatial partition takes " + (end2 - start2) + "ms");
+    LOGGER.info("Without spatial partition takes ", (end1 - start1), "ms");
+    LOGGER.info("With spatial partition takes ", (end2 - start2), "ms");
   }
 }
 
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
index 9c39c29c8..4ff166420 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
@@ -24,7 +24,7 @@
 package com.iluwatar.spatialpartition;
 
 import java.util.Collection;
-import java.util.Hashtable;
+import java.util.HashMap;
 import java.util.Random;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -58,13 +58,13 @@ public class Bubble extends Point<Bubble> {
         <= (this.radius + b.radius) * (this.radius + b.radius);
   }
 
-  void pop(Hashtable<Integer, Bubble> allBubbles) {
-    LOGGER.info("Bubble " + this.id
-        + " popped at (" + this.coordinateX + "," + this.coordinateY + ")!");
+  void pop(HashMap<Integer, Bubble> allBubbles) {
+    LOGGER.info("Bubble ", this.id,
+        " popped at (", this.coordinateX, ",", this.coordinateY, ")!");
     allBubbles.remove(this.id);
   }
 
-  void handleCollision(Collection<? extends Point> toCheck, Hashtable<Integer, Bubble> allBubbles) {
+  void handleCollision(Collection<? extends Point> toCheck, HashMap<Integer, Bubble> allBubbles) {
     var toBePopped = false; //if any other bubble collides with it, made true
     for (var point : toCheck) {
       var otherId = point.id;
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
index 410beae34..a2547b7a1 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
@@ -24,7 +24,7 @@
 package com.iluwatar.spatialpartition;
 
 import java.util.Collection;
-import java.util.Hashtable;
+import java.util.HashMap;
 
 /**
  * The abstract Point class which will be extended by any object in the field whose location has to
@@ -64,5 +64,5 @@ public abstract class Point<T> {
    * @param toCheck contains the objects which need to be checked
    * @param all     contains hashtable of all points on field at this time
    */
-  abstract void handleCollision(Collection<? extends Point> toCheck, Hashtable<Integer, T> all);
+  abstract void handleCollision(Collection<? extends Point> toCheck, HashMap<Integer, T> all);
 }
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
index c543da12c..1a9a0d91e 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
@@ -24,7 +24,7 @@
 package com.iluwatar.spatialpartition;
 
 import java.util.ArrayList;
-import java.util.Hashtable;
+import java.util.HashMap;
 
 /**
  * This class extends the generic SpatialPartition abstract class and is used in our example to keep
@@ -33,10 +33,10 @@ import java.util.Hashtable;
 
 public class SpatialPartitionBubbles extends SpatialPartitionGeneric<Bubble> {
 
-  private final Hashtable<Integer, Bubble> bubbles;
+  private final HashMap<Integer, Bubble> bubbles;
   private final QuadTree quadTree;
 
-  SpatialPartitionBubbles(Hashtable<Integer, Bubble> bubbles, QuadTree quadTree) {
+  SpatialPartitionBubbles(HashMap<Integer, Bubble> bubbles, QuadTree quadTree) {
     this.bubbles = bubbles;
     this.quadTree = quadTree;
   }
@@ -44,7 +44,7 @@ public class SpatialPartitionBubbles extends SpatialPartitionGeneric<Bubble> {
   void handleCollisionsUsingQt(Bubble b) {
     // finding points within area of a square drawn with centre same as
     // centre of bubble and length = radius of bubble
-    var rect = new Rect(b.coordinateX, b.coordinateY, 2 * b.radius, 2 * b.radius);
+    var rect = new Rect(b.coordinateX, b.coordinateY, 2D * b.radius, 2D * b.radius);
     var quadTreeQueryResult = new ArrayList<Point>();
     this.quadTree.query(rect, quadTreeQueryResult);
     //handling these collisions
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
index 957a36ce3..f02b5e961 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
@@ -29,7 +29,7 @@ import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import java.util.ArrayList;
-import java.util.Hashtable;
+import java.util.HashMap;
 import org.junit.jupiter.api.Test;
 
 /**
@@ -63,11 +63,11 @@ class BubbleTest {
   void popTest() {
     var b1 = new Bubble(10, 10, 1, 2);
     var b2 = new Bubble(0, 0, 2, 2);
-    var bubbles = new Hashtable<Integer, Bubble>();
+    var bubbles = new HashMap<Integer, Bubble>();
     bubbles.put(1, b1);
     bubbles.put(2, b2);
     b1.pop(bubbles);
-    //after popping, bubble no longer in hashtable containing all bubbles
+    //after popping, bubble no longer in hashMap containing all bubbles
     assertNull(bubbles.get(1));
     assertNotNull(bubbles.get(2));
   }
@@ -77,7 +77,7 @@ class BubbleTest {
     var b1 = new Bubble(0, 0, 1, 2);
     var b2 = new Bubble(1, 1, 2, 1);
     var b3 = new Bubble(10, 10, 3, 1);
-    var bubbles = new Hashtable<Integer, Bubble>();
+    var bubbles = new HashMap<Integer, Bubble>();
     bubbles.put(1, b1);
     bubbles.put(2, b2);
     bubbles.put(3, b3);
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
index 3470b27cc..f36995938 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
@@ -26,7 +26,7 @@ package com.iluwatar.spatialpartition;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertNull;
 
-import java.util.Hashtable;
+import java.util.HashMap;
 import org.junit.jupiter.api.Test;
 
 /**
@@ -41,7 +41,7 @@ class SpatialPartitionBubblesTest {
     var b2 = new Bubble(5, 5, 2, 1);
     var b3 = new Bubble(9, 9, 3, 1);
     var b4 = new Bubble(8, 8, 4, 2);
-    var bubbles = new Hashtable<Integer, Bubble>();
+    var bubbles = new HashMap<Integer, Bubble>();
     bubbles.put(1, b1);
     bubbles.put(2, b2);
     bubbles.put(3, b3);

From a94737075e1a5c8e7bbeb58ee89648159faede49 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 30 Jan 2021 14:16:35 +0200
Subject: [PATCH 210/254] Minor fixes to readmes

---
 abstract-factory/README.md        |  4 ++--
 async-method-invocation/README.md | 12 +++++++-----
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/abstract-factory/README.md b/abstract-factory/README.md
index 22edb81e0..4cdbd850a 100644
--- a/abstract-factory/README.md
+++ b/abstract-factory/README.md
@@ -213,8 +213,8 @@ Example use cases
 
 ## Related patterns
 
-[Factory Method](https://java-design-patterns.com/patterns/factory-method/)
-[Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
+* [Factory Method](https://java-design-patterns.com/patterns/factory-method/)
+* [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/)
 
 ## Credits
 
diff --git a/async-method-invocation/README.md b/async-method-invocation/README.md
index d1bda1a52..23910a631 100644
--- a/async-method-invocation/README.md
+++ b/async-method-invocation/README.md
@@ -20,12 +20,14 @@ callbacks or waiting until everything is done.
 ## Applicability
 Use async method invocation pattern when
 
-* you have multiple independent tasks that can run in parallel
-* you need to improve the performance of a group of sequential tasks
-* you have limited amount of processing capacity or long running tasks and the
+* You have multiple independent tasks that can run in parallel
+* You need to improve the performance of a group of sequential tasks
+* You have limited amount of processing capacity or long running tasks and the
   caller should not wait the tasks to be ready
 
 ## Real world examples
 
-* [FutureTask](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/FutureTask.html), [CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html) and [ExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html) (Java)
-* [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx) (.NET)
+* [FutureTask](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/FutureTask.html)
+* [CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html)
+* [ExecutorService](http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ExecutorService.html)
+* [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx)

From 7408620a71cb4bc0d8ba81b7f403a4bcfe17fb8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 30 Jan 2021 14:44:41 +0200
Subject: [PATCH 211/254] Update image filenames

---
 circuit-breaker/README.md                           |   4 ++--
 .../etc/{ServiceDiagram.PNG => ServiceDiagram.png}  | Bin
 .../etc/{StateDiagram.PNG => StateDiagram.png}      | Bin
 3 files changed, 2 insertions(+), 2 deletions(-)
 rename circuit-breaker/etc/{ServiceDiagram.PNG => ServiceDiagram.png} (100%)
 rename circuit-breaker/etc/{StateDiagram.PNG => StateDiagram.png} (100%)

diff --git a/circuit-breaker/README.md b/circuit-breaker/README.md
index f1792cb24..b3a360b33 100644
--- a/circuit-breaker/README.md
+++ b/circuit-breaker/README.md
@@ -49,7 +49,7 @@ remote calls.
 
 The service architecture is as follows:
 
-![alt text](./etc/ServiceDiagram.PNG "Service Diagram")
+![alt text](./etc/ServiceDiagram.png "Service Diagram")
 
 In terms of code, the end user application is:
 
@@ -292,7 +292,7 @@ public class DefaultCircuitBreaker implements CircuitBreaker {
 How does the above pattern prevent failures? Let's understand via this finite state machine 
 implemented by it.
 
-![alt text](./etc/StateDiagram.PNG "State Diagram")
+![alt text](./etc/StateDiagram.png "State Diagram")
 
 - We initialize the Circuit Breaker object with certain parameters: `timeout`, `failureThreshold` and `retryTimePeriod` which help determine how resilient the API is.
 - Initially, we are in the `closed` state and nos remote calls to the API have occurred.
diff --git a/circuit-breaker/etc/ServiceDiagram.PNG b/circuit-breaker/etc/ServiceDiagram.png
similarity index 100%
rename from circuit-breaker/etc/ServiceDiagram.PNG
rename to circuit-breaker/etc/ServiceDiagram.png
diff --git a/circuit-breaker/etc/StateDiagram.PNG b/circuit-breaker/etc/StateDiagram.png
similarity index 100%
rename from circuit-breaker/etc/StateDiagram.PNG
rename to circuit-breaker/etc/StateDiagram.png

From a86bdfd14d4c484cb343783d6a5a6d274ed2270a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sat, 30 Jan 2021 14:54:14 +0200
Subject: [PATCH 212/254] Update link title

---
 converter/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/converter/README.md b/converter/README.md
index 02b172149..4414ec00c 100644
--- a/converter/README.md
+++ b/converter/README.md
@@ -105,4 +105,4 @@ domain equivalence.
 
 ## Credits
 
-* [Converter](http://www.xsolve.pl/blog/converter-pattern-in-java-8/)
+* [Converter Pattern in Java 8](http://www.xsolve.pl/blog/converter-pattern-in-java-8/)

From d620dbbc05e91aba7c9e46bde36f9b41ed98c455 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 7 Feb 2021 20:25:52 +0530
Subject: [PATCH 213/254] bump version to 3.8.0.2131 (#1647)

earlier version 3.7.0.1746
org.sonarsource.scanner.maven.sonar-maven-plugin
---
 pom.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index a3fb757a3..e0f437921 100644
--- a/pom.xml
+++ b/pom.xml
@@ -25,6 +25,7 @@
     <inceptionYear>2014-2019</inceptionYear>
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <sonar-maven-plugin.version>3.8.0.2131</sonar-maven-plugin.version>
         <hibernate.version>5.2.18.Final</hibernate.version>
         <spring.version>5.0.13.RELEASE</spring.version>
         <spring-boot.version>2.0.9.RELEASE</spring-boot.version>
@@ -425,7 +426,7 @@
                 <plugin>
                     <groupId>org.sonarsource.scanner.maven</groupId>
                     <artifactId>sonar-maven-plugin</artifactId>
-                    <version>3.7.0.1746</version>
+                    <version>${sonar-maven-plugin.version}</version>
                 </plugin>
             </plugins>
         </pluginManagement>

From cdc2a154df7646cbcd1008d824f477ba2d3a46a3 Mon Sep 17 00:00:00 2001
From: Moustafa Farhat <farhat.forall@gmail.com>
Date: Sun, 7 Feb 2021 16:00:48 +0100
Subject: [PATCH 214/254] Arabic Translation - Initialization part (#1648)

---
 README.md           |   2 +-
 ar/README.md        |  42 ++++++++++++++++++++++++++++++++++++++++++
 assets/flags/AR.png | Bin 0 -> 252 bytes
 3 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 ar/README.md
 create mode 100644 assets/flags/AR.png

diff --git a/README.md b/README.md
index 054094108..cfc1cabe9 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@
 
 <br/>
 
-Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),[![TR](/assets/flags/TR.png)**TR**](/tr/README.md),
+Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),[![TR](/assets/flags/TR.png)**TR**](/tr/README.md),[![AR](/assets/flags/AR.png)**AR**](/ar/README.md),
 
 <br/>
 
diff --git a/ar/README.md b/ar/README.md
new file mode 100644
index 000000000..b49d7927f
--- /dev/null
+++ b/ar/README.md
@@ -0,0 +1,42 @@
+# أنماط التصميم بلغة برمجة الجافا 
+
+![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
+[![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
+[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
+[![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+[![All Contributors](https://img.shields.io/badge/all_contributors-148-orange.svg?style=flat-square)](#contributors-)
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+
+# مقدمة 
+
+أنماط التصميم هي أفضل التدريبات التي يمكن للمبرمج استخدامها لحل المشكلات الشائعة عند تصميم تطبيق أو نظام.
+يمكن لأنماط التصميم تسريع عملية التطوير من خلال توفير نماذج تطوير مجربة ومثبتة ومفيدة.
+تساعد إعادة استخدام أنماط التصميم في منع المشكلات الدقيقة التي تسبب مشكلات كبيرة ، كما تعمل على تحسين قابلية قراءة الكود للمهندسين البرمجيات الذين هم على دراية بالأنماط.
+
+# البدء في التعلم
+
+يعرض هذا الموقع أنماط تصميم جافا. تم تطوير الحلول من قبل المبرمجين والمهندسين ذوي الخبرة من مجتمع المصادر المفتوحة. يمكن تصفح الأنماط من خلال أوصافها عالية المستوى أو بالنظر إلى كود المصدر الخاص بها. تم كتابة الشرح على أمثلة الكود المصدري جيدًا ويمكن اعتبارها برامج تعليمية حول كيفية تنفيذ نمط معين. نحن نستخدم تقنيات Java مفتوحة المصدر الأكثر شيوعًا والتي أثبتت جدارتها في مشاريع الجافا. 
+قبل الغوص في المادة ، يجب أن تكون على دراية [بمبادئ تصميم البرامج المختلفة](https://java-design-patterns.com/principles/).
+
+يجب أن تكون جميع التصميمات بسيطة قدر الإمكان. يجب أن تبدأ بـ KISS و YAGNI وافعل أبسط شيء يمكن أن يعمل بهذه المبادىء. يجب إستخدام الأنماط فقط عند الحاجة إليها من أجل تمديد البرنامج بشكل عملي.
+
+بمجرد أن تصبح معتادًا على هذه المفاهيم ، يمكنك البدء في التعمق في  [أنماط التصميم المتاحة](https://java-design-patterns.com/patterns/) من خلال أي من الأساليب التالية
+
+ابحث عن نمط محدد بالاسم. لا يمكنك العثور على واحد؟ الرجاء الإبلاغ عن نمط جديد [هنا](https://github.com/iluwatar/java-design-patterns/issues).
+استخدام علامات مثل Performance أو Gang of Four أو الوصول إلى البيانات.
+استخدام فئات الأنماط و Creational, Behavioral وغيرها.
+
+نأمل أن تجد الحلول الموجهة للكائنات المعروضة على هذا الموقع مفيدة في مشاريعك البرمجية وأن تستمتع بتعلمها بقدر ما قمنا بتطويرها.
+
+
+# كيف تساهم؟ 
+
+إذا كنت على استعداد للمساهمة في المشروع ، فستجد المعلومات ذات الصلة في [ويكي المطور الخاص بنا](https://github.com/iluwatar/java-design-patterns/wiki). سنساعدك ونجيب على أسئلتك في  [غرفة الدردشة Gitter](https://gitter.im/iluwatar/java-design-patterns).
+
+
+# الترخيص
+
+هذا المشروع مرخص بموجب شروط ترخيص MIT.
\ No newline at end of file
diff --git a/assets/flags/AR.png b/assets/flags/AR.png
new file mode 100644
index 0000000000000000000000000000000000000000..f216ab108976dce9e01aaa5020617b860249ba7a
GIT binary patch
literal 252
zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|SkfJR9T^xl
z_H+M9WCij$3p^r=85sBugD~Uq{1quc!HJ$Ojv*HQ$u{aMzRhoBI>55@B-`Nw49C8|
z-X18@!SjD(gK+;kr$~+lUmli#Js;#b(&yeg60j>->hQwf;tLk>B$#>dsIUh$^91lD
zusAvL#kGAtpJy!LwbId5@<7gn84Bw95xhnRI9wPPERy_plxP3{zl~i64L6PdcuTM}
sv@K>n7P>kNXp_SC9<|gi24-f4!uJ`Bg)x`-fsSMFboFyt=akR{07<n}9{>OV

literal 0
HcmV?d00001


From 934578d6d2c48ebb885fc5391d778f327efef455 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 7 Feb 2021 17:04:21 +0200
Subject: [PATCH 215/254] docs: add moustafafarhat as a contributor (#1649)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 9d21621a2..cd996bd37 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1395,6 +1395,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "moustafafarhat",
+      "name": "Moustafa Farhat",
+      "avatar_url": "https://avatars.githubusercontent.com/u/38836727?v=4",
+      "profile": "https://github.com/moustafafarhat",
+      "contributions": [
+        "translation"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index cfc1cabe9..be21765cc 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-153-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-154-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -305,6 +305,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/byoungju94"><img src="https://avatars.githubusercontent.com/u/42516378?v=4?s=100" width="100px;" alt=""/><br /><sub><b>byoungju94</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=byoungju94" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/moustafafarhat"><img src="https://avatars.githubusercontent.com/u/38836727?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Moustafa Farhat</b></sub></a><br /><a href="#translation-moustafafarhat" title="Translation">🌍</a></td>
   </tr>
 </table>
 

From 2207ea4ce9a76deaa91b0181950e11237c246ffc Mon Sep 17 00:00:00 2001
From: Mike Liu <657829312@qq.com>
Date: Mon, 8 Feb 2021 23:37:48 +0800
Subject: [PATCH 216/254] Translation zh (#1646)

* add state and callback pattern

* add command and template-method pattern

* add iterator pattern

* add bridege and DI pattern

* fix issue #1600

* add converter,proxy,visitor pattern

* add caching,composite,delegation,dirty-flag,interpreter patterns

* add dao and producer-consumer

* add dto and provate class data pattern

* fix #1646 png path problems

* fix #1646 composite png path case problem

Co-authored-by: Mike <admin@xiaod.info>
Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 zh/caching/README.md              |  27 ++++
 zh/composite/README.md            | 174 +++++++++++++++++++++++
 zh/converter/README.md            | 101 ++++++++++++++
 zh/dao/README.md                  | 162 +++++++++++++++++++++
 zh/data-transfer-object/README.md | 111 +++++++++++++++
 zh/delegation/README.md           |  29 ++++
 zh/dirty-flag/README.md           |  29 ++++
 zh/interpreter/README.md          |  35 +++++
 zh/private-class-data/README.md   | 128 +++++++++++++++++
 zh/producer-consumer/README.md    |  21 +++
 zh/proxy/README.md                | 161 +++++++++++++++++++++
 zh/state/README.md                |   2 +-
 zh/template-method/README.md      |   2 +-
 zh/visitor/README.md              | 224 ++++++++++++++++++++++++++++++
 14 files changed, 1204 insertions(+), 2 deletions(-)
 create mode 100644 zh/caching/README.md
 create mode 100644 zh/composite/README.md
 create mode 100644 zh/converter/README.md
 create mode 100644 zh/dao/README.md
 create mode 100644 zh/data-transfer-object/README.md
 create mode 100644 zh/delegation/README.md
 create mode 100644 zh/dirty-flag/README.md
 create mode 100644 zh/interpreter/README.md
 create mode 100644 zh/private-class-data/README.md
 create mode 100644 zh/producer-consumer/README.md
 create mode 100644 zh/proxy/README.md
 create mode 100644 zh/visitor/README.md

diff --git a/zh/caching/README.md b/zh/caching/README.md
new file mode 100644
index 000000000..54cb982b2
--- /dev/null
+++ b/zh/caching/README.md
@@ -0,0 +1,27 @@
+---
+layout: pattern
+title: Caching
+folder: caching
+permalink: /patterns/caching/
+categories: Behavioral
+tags:
+  - Performance
+  - Cloud distributed
+---
+
+## 目的
+为了避免昂贵的资源重新获取，方法是在资源使用后不立即释放资源。资源保留其身份，保留在某些快速访问的存储中，并被重新使用，以避免再次获取它们。
+
+## 类图
+![alt text](../../caching/etc/caching.png "Caching")
+
+## 适用性
+在以下情况下使用缓存模式
+
+* 重复获取，初始化和释放同一资源会导致不必要的性能开销。
+
+## 鸣谢
+
+* [Write-through, write-around, write-back: Cache explained](http://www.computerweekly.com/feature/Write-through-write-around-write-back-Cache-explained)
+* [Read-Through, Write-Through, Write-Behind, and Refresh-Ahead Caching](https://docs.oracle.com/cd/E15357_01/coh.360/e15723/cache_rtwtwbra.htm#COHDG5177)
+* [Cache-Aside pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/cache-aside)
diff --git a/zh/composite/README.md b/zh/composite/README.md
new file mode 100644
index 000000000..1f0f7b3b4
--- /dev/null
+++ b/zh/composite/README.md
@@ -0,0 +1,174 @@
+---
+layout: pattern
+title: Composite
+folder: composite
+permalink: /patterns/composite/
+categories: Structural
+tags:
+ - Gang of Four
+---
+
+## 目的
+
+将对象组合成树结构以表示部分整体层次结构。 组合可以使客户统一对待单个对象和组合对象。
+
+## 解释
+
+真实世界例子
+
+> 每个句子由单词组成，单词又由字符组成。这些对象中的每一个都是可打印的，它们可以在它们之前或之后打印一些内容，例如句子始终以句号结尾，单词始终在其前面有空格。
+
+通俗的说
+
+> 组合模式使客户能够以统一的方式对待各个对象。
+
+维基百科说
+
+> 在软件工程中，组合模式是一种分区设计模式。组合模式中，一组对象将像一个对象的单独实例一样被对待。组合的目的是将对象“组成”树状结构，以表示部分整体层次结构。实现组合模式可使客户统一对待单个对象和组合对象。
+
+**程序示例**
+
+使用上面的句子例子。 这里我们有基类`LetterComposite`和不同的可打印类型`Letter`，`Word`和`Sentence`。
+
+```java
+public abstract class LetterComposite {
+
+  private final List<LetterComposite> children = new ArrayList<>();
+
+  public void add(LetterComposite letter) {
+    children.add(letter);
+  }
+
+  public int count() {
+    return children.size();
+  }
+
+  protected void printThisBefore() {
+  }
+
+  protected void printThisAfter() {
+  }
+
+  public void print() {
+    printThisBefore();
+    children.forEach(LetterComposite::print);
+    printThisAfter();
+  }
+}
+
+public class Letter extends LetterComposite {
+
+  private final char character;
+
+  public Letter(char c) {
+    this.character = c;
+  }
+
+  @Override
+  protected void printThisBefore() {
+    System.out.print(character);
+  }
+}
+
+public class Word extends LetterComposite {
+
+  public Word(List<Letter> letters) {
+    letters.forEach(this::add);
+  }
+
+  public Word(char... letters) {
+    for (char letter : letters) {
+      this.add(new Letter(letter));
+    }
+  }
+
+  @Override
+  protected void printThisBefore() {
+    System.out.print(" ");
+  }
+}
+
+public class Sentence extends LetterComposite {
+
+  public Sentence(List<Word> words) {
+    words.forEach(this::add);
+  }
+
+  @Override
+  protected void printThisAfter() {
+    System.out.print(".");
+  }
+}
+```
+
+然后我们有一个消息携带者来携带消息。
+
+```java
+public class Messenger {
+
+  LetterComposite messageFromOrcs() {
+
+    var words = List.of(
+        new Word('W', 'h', 'e', 'r', 'e'),
+        new Word('t', 'h', 'e', 'r', 'e'),
+        new Word('i', 's'),
+        new Word('a'),
+        new Word('w', 'h', 'i', 'p'),
+        new Word('t', 'h', 'e', 'r', 'e'),
+        new Word('i', 's'),
+        new Word('a'),
+        new Word('w', 'a', 'y')
+    );
+
+    return new Sentence(words);
+
+  }
+
+  LetterComposite messageFromElves() {
+
+    var words = List.of(
+        new Word('M', 'u', 'c', 'h'),
+        new Word('w', 'i', 'n', 'd'),
+        new Word('p', 'o', 'u', 'r', 's'),
+        new Word('f', 'r', 'o', 'm'),
+        new Word('y', 'o', 'u', 'r'),
+        new Word('m', 'o', 'u', 't', 'h')
+    );
+
+    return new Sentence(words);
+
+  }
+
+}
+```
+
+然后它可以这样使用:
+
+```java
+var orcMessage = new Messenger().messageFromOrcs();
+orcMessage.print(); // Where there is a whip there is a way.
+var elfMessage = new Messenger().messageFromElves();
+elfMessage.print(); // Much wind pours from your mouth.
+```
+
+## 类图
+
+![alt text](../../composite/etc/composite.urm.png "Composite class diagram")
+
+## 适用性
+
+使用组合模式当
+
+* 你想要表示对象的整体层次结构
+* 你希望客户能够忽略组合对象和单个对象之间的差异。 客户将统一对待组合结构中的所有对象。
+
+## 真实世界例子
+
+* [java.awt.Container](http://docs.oracle.com/javase/8/docs/api/java/awt/Container.html) and [java.awt.Component](http://docs.oracle.com/javase/8/docs/api/java/awt/Component.html)
+* [Apache Wicket](https://github.com/apache/wicket) component tree, see [Component](https://github.com/apache/wicket/blob/91e154702ab1ff3481ef6cbb04c6044814b7e130/wicket-core/src/main/java/org/apache/wicket/Component.java) and [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/zh/converter/README.md b/zh/converter/README.md
new file mode 100644
index 000000000..0b1f7a074
--- /dev/null
+++ b/zh/converter/README.md
@@ -0,0 +1,101 @@
+---
+layout: pattern
+title: Converter
+folder: converter
+permalink: /patterns/converter/
+categories: Creational
+tags:
+ - Decoupling
+---
+
+## 目的
+
+转换器模式的目的是提供相应类型之间双向转换的通用方法，允许进行干净的实现，而类型之间无需相互了解。此外，Converter模式引入了双向集合映射，从而将样板代码减少到最少。
+
+## 解释
+
+真实世界例子
+
+> 在真实的应用中经常有这种情况，数据库层包含需要被转换成业务逻辑层DTO来使用的实体。对于潜在的大量类进行类似的映射，我们需要一种通用的方法来实现这一点。
+
+通俗的说
+
+> 转换器模式让一个类的实例映射成另一个类的实例变得简单
+
+**程序示例**
+
+我们需要一个通用的方案来解决映射问题。让我们来介绍一个通用的转换器。
+
+```java
+public class Converter<T, U> {
+
+  private final Function<T, U> fromDto;
+  private final Function<U, T> fromEntity;
+
+  public Converter(final Function<T, U> fromDto, final Function<U, T> fromEntity) {
+    this.fromDto = fromDto;
+    this.fromEntity = fromEntity;
+  }
+
+  public final U convertFromDto(final T dto) {
+    return fromDto.apply(dto);
+  }
+
+  public final T convertFromEntity(final U entity) {
+    return fromEntity.apply(entity);
+  }
+
+  public final List<U> createFromDtos(final Collection<T> dtos) {
+    return dtos.stream().map(this::convertFromDto).collect(Collectors.toList());
+  }
+
+  public final List<T> createFromEntities(final Collection<U> entities) {
+    return entities.stream().map(this::convertFromEntity).collect(Collectors.toList());
+  }
+}
+```
+
+专属的转换器像下面一样从基类继承。
+
+```java
+public class UserConverter extends Converter<UserDto, User> {
+
+  public UserConverter() {
+    super(UserConverter::convertToEntity, UserConverter::convertToDto);
+  }
+
+  private static UserDto convertToDto(User user) {
+    return new UserDto(user.getFirstName(), user.getLastName(), user.isActive(), user.getUserId());
+  }
+
+  private static User convertToEntity(UserDto dto) {
+    return new User(dto.getFirstName(), dto.getLastName(), dto.isActive(), dto.getEmail());
+  }
+
+}
+```
+
+现在，在User和UserDto之间的映射变得轻而易举。
+
+```java
+var userConverter = new UserConverter();
+var dtoUser = new UserDto("John", "Doe", true, "whatever[at]wherever.com");
+var user = userConverter.convertFromDto(dtoUser);
+```
+
+## 类图
+
+![alt text](../../converter/etc/converter.png "Converter Pattern")
+
+## 适用性
+
+在下面这些情况下使用转换器模式：
+
+* 如果你的类型在逻辑上相互对应，并需要在它们之间转换实体
+* 当你想根据上下文提供不同的类型转换方式时
+* 每当你引入DTO（数据传输对象）时你可能都需要将其转换为
+  DO
+
+## 鸣谢
+
+* [Converter](http://www.xsolve.pl/blog/converter-pattern-in-java-8/)
diff --git a/zh/dao/README.md b/zh/dao/README.md
new file mode 100644
index 000000000..a16d4c7d6
--- /dev/null
+++ b/zh/dao/README.md
@@ -0,0 +1,162 @@
+---
+layout: pattern
+title: Data Access Object
+folder: dao
+permalink: /patterns/dao/
+categories: Architectural
+tags:
+ - Data access
+---
+
+## 目的
+
+对象为某种类型的数据库或其他持久性机制提供了抽象接口。
+
+## 解释
+
+真实世界例子
+
+> 有一组客户数据需要持久化到数据库中。 我们需要整个额外的增删改查操作以便操作客户数据。
+
+通俗的说
+
+> DAO是我们通过基本持久性机制提供的接口。
+
+维基百科说
+
+> 在计算机软件中，数据访问对象（DAO）是一种模式，可为某种类型的数据库或其他持久性机制提供抽象接口。
+
+**程序示例**
+
+通过我们的客户示例，下面是基本的`客户`实体。
+
+```java
+public class Customer {
+
+  private int id;
+  private String firstName;
+  private String lastName;
+
+  public Customer(int id, String firstName, String lastName) {
+    this.id = id;
+    this.firstName = firstName;
+    this.lastName = lastName;
+  }
+  // getters and setters ->
+  ...
+}
+```
+
+这是`CustomerDao`接口及其两个不同的实现。
+
+Here's the `CustomerDao` interface and two different implementations for it. `InMemoryCustomerDao` 
+将简单的客户数据映射保存在内存中 而`DBCustomerDao`是真正的RDBMS实现。
+
+```java
+public interface CustomerDao {
+
+  Stream<Customer> getAll() throws Exception;
+
+  Optional<Customer> getById(int id) throws Exception;
+
+  boolean add(Customer customer) throws Exception;
+
+  boolean update(Customer customer) throws Exception;
+
+  boolean delete(Customer customer) throws Exception;
+}
+
+public class InMemoryCustomerDao implements CustomerDao {
+
+  private final Map<Integer, Customer> idToCustomer = new HashMap<>();
+
+  // implement the interface using the map
+  ...
+}
+
+public class DbCustomerDao implements CustomerDao {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(DbCustomerDao.class);
+
+  private final DataSource dataSource;
+
+  public DbCustomerDao(DataSource dataSource) {
+    this.dataSource = dataSource;
+  }
+
+  // implement the interface using the data source
+  ...
+```
+
+最后，这是我们使用DAO管理客户数据的方式。
+
+```java
+    final var dataSource = createDataSource();
+    createSchema(dataSource);
+    final var customerDao = new DbCustomerDao(dataSource);
+    
+    addCustomers(customerDao);
+    log.info(ALL_CUSTOMERS);
+    try (var customerStream = customerDao.getAll()) {
+      customerStream.forEach((customer) -> log.info(customer.toString()));
+    }
+    log.info("customerDao.getCustomerById(2): " + customerDao.getById(2));
+    final var customer = new Customer(4, "Dan", "Danson");
+    customerDao.add(customer);
+    log.info(ALL_CUSTOMERS + customerDao.getAll());
+    customer.setFirstName("Daniel");
+    customer.setLastName("Danielson");
+    customerDao.update(customer);
+    log.info(ALL_CUSTOMERS);
+    try (var customerStream = customerDao.getAll()) {
+      customerStream.forEach((cust) -> log.info(cust.toString()));
+    }
+    customerDao.delete(customer);
+    log.info(ALL_CUSTOMERS + customerDao.getAll());
+    
+    deleteSchema(dataSource);
+```
+
+程序输出:
+
+```java
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+customerDao.getCustomerById(2): Optional[Customer{id=2, firstName='Bob', lastName='Bobson'}]
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@7cef4e59
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+Customer{id=4, firstName='Daniel', lastName='Danielson'}
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@2db0f6b2
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+customerDao.getCustomerById(2): Optional[Customer{id=2, firstName='Bob', lastName='Bobson'}]
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@12c8a2c0
+customerDao.getAllCustomers(): 
+Customer{id=1, firstName='Adam', lastName='Adamson'}
+Customer{id=2, firstName='Bob', lastName='Bobson'}
+Customer{id=3, firstName='Carl', lastName='Carlson'}
+Customer{id=4, firstName='Daniel', lastName='Danielson'}
+customerDao.getAllCustomers(): java.util.stream.ReferencePipeline$Head@6ec8211c
+```
+
+## 类图
+
+![alt text](../../dao/etc/dao.png "Data Access Object")
+
+## 适用性
+
+在以下情况下，请使用数据访问对象：:
+
+* 当您要巩固如何访问数据层时。
+* 当您要避免编写多个数据检索/持久层时。
+
+## 鸣谢
+
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
diff --git a/zh/data-transfer-object/README.md b/zh/data-transfer-object/README.md
new file mode 100644
index 000000000..e7895f683
--- /dev/null
+++ b/zh/data-transfer-object/README.md
@@ -0,0 +1,111 @@
+---
+layout: pattern
+title: Data Transfer Object
+folder: data-transfer-object
+permalink: /patterns/data-transfer-object/
+categories: Architectural
+tags:
+ - Performance
+---
+
+## 目的
+
+次将具有多个属性的数据从客户端传递到服务器，以避免多次调用远程服务器。
+
+## 解释
+
+真实世界例子
+
+> 我们需要从远程数据库中获取有关客户的信息。 我们不使用一次查询一个属性，而是使用DTO一次传送所有相关属性。
+
+通俗的说
+
+> 使用DTO，可以通过单个后端查询获取相关信息。
+
+维基百科说
+
+> 在编程领域，数据传输对象（DTO）是在进程之间承载数据的对象。 使用它的动机是，通常依靠远程接口（例如Web服务）来完成进程之间的通信，在这种情况下，每个调用都是昂贵的操作。
+> 
+> 因为每个（方法）调用的大部分成本与客户端和服务器之间的往返时间有关，所以减少调用数量的一种方法是使用一个对象（DTO）来聚合将要在多次调用间传输的数据，但仅由一个调用提供。
+
+**程序示例**
+
+让我们来介绍我们简单的`CustomerDTO` 类
+
+```java
+public class CustomerDto {
+  private final String id;
+  private final String firstName;
+  private final String lastName;
+
+  public CustomerDto(String id, String firstName, String lastName) {
+    this.id = id;
+    this.firstName = firstName;
+    this.lastName = lastName;
+  }
+
+  public String getId() {
+    return id;
+  }
+
+  public String getFirstName() {
+    return firstName;
+  }
+
+  public String getLastName() {
+    return lastName;
+  }
+}
+```
+
+`CustomerResource` 类充当客户信息的服务器。
+
+```java
+public class CustomerResource {
+  private final List<CustomerDto> customers;
+
+  public CustomerResource(List<CustomerDto> customers) {
+    this.customers = customers;
+  }
+
+  public List<CustomerDto> getAllCustomers() {
+    return customers;
+  }
+
+  public void save(CustomerDto customer) {
+    customers.add(customer);
+  }
+
+  public void delete(String customerId) {
+    customers.removeIf(customer -> customer.getId().equals(customerId));
+  }
+}
+```
+
+现在拉取客户信息变得简单自从我们有了DTOs。
+
+```java
+    var allCustomers = customerResource.getAllCustomers();
+    allCustomers.forEach(customer -> LOGGER.info(customer.getFirstName()));
+    // Kelly
+    // Alfonso
+```
+
+## 类图
+
+![alt text](../../data-transfer-object/etc/data-transfer-object.urm.png "data-transfer-object")
+
+## 适用性
+
+使用数据传输对象模式当
+
+* 客户端请求多种信息。信息都是相关的
+* 当你想提高获取资源的性能
+* 你想降低远程方法调用的次数
+
+## 鸣谢
+
+* [Design Pattern - Transfer Object Pattern](https://www.tutorialspoint.com/design_pattern/transfer_object_pattern.htm)
+* [Data Transfer Object](https://msdn.microsoft.com/en-us/library/ff649585.aspx)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94)
+* [Patterns of Enterprise Application Architecture](https://www.amazon.com/gp/product/0321127420/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321127420&linkCode=as2&tag=javadesignpat-20&linkId=014237a67c9d46f384b35e10151956bd)
diff --git a/zh/delegation/README.md b/zh/delegation/README.md
new file mode 100644
index 000000000..83ac8f331
--- /dev/null
+++ b/zh/delegation/README.md
@@ -0,0 +1,29 @@
+---
+layout: pattern
+title: Delegation
+folder: delegation
+permalink: /patterns/delegation/
+categories: Structural
+tags:
+ - Decoupling
+---
+
+## 或称
+代理模式
+
+## 目的
+它是一种让对象将某种行为向外部表达，但实际上将实现该行为的责任委托给关联对象的技术。
+
+## 类图
+![alt text](../../delegation/etc/delegation.png "Delegate")
+
+## 适用性
+使用委托模式以实现以下目的
+
+* 降低类的耦合性
+* 组件的行为相同，但是意识到这种情况将来可能会改变。
+
+## 鸣谢
+
+* [Delegate Pattern: Wikipedia ](https://en.wikipedia.org/wiki/Delegation_pattern)
+* [Proxy Pattern: Wikipedia ](https://en.wikipedia.org/wiki/Proxy_pattern)
diff --git a/zh/dirty-flag/README.md b/zh/dirty-flag/README.md
new file mode 100644
index 000000000..f055b0174
--- /dev/null
+++ b/zh/dirty-flag/README.md
@@ -0,0 +1,29 @@
+---
+layout: pattern
+title: Dirty Flag
+folder: dirty-flag
+permalink: /patterns/dirty-flag/
+categories: Behavioral
+tags:
+ - Game programming
+ - Performance
+---
+
+## 或称
+* 是否脏 模式
+
+## 目的
+避免昂贵资源的重新获取。资源保留其身份，保留在某些快速访问的存储中，并被重新使用以避免再次获取它们。
+
+## 类图
+![alt text](../../dirty-flag/etc/dirty-flag.png "Dirty Flag")
+
+## 适用性
+在以下情况下使用脏标志模式
+
+* 重复获取，初始化，释放相同资源所导致不必要的性能开销
+
+## 鸣谢
+
+* [Design Patterns: Dirty Flag](https://www.takeupcode.com/podcast/89-design-patterns-dirty-flag/)
+* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
diff --git a/zh/interpreter/README.md b/zh/interpreter/README.md
new file mode 100644
index 000000000..7d7910121
--- /dev/null
+++ b/zh/interpreter/README.md
@@ -0,0 +1,35 @@
+---
+layout: pattern
+title: Interpreter
+folder: interpreter
+permalink: /patterns/interpreter/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 目的
+给定一种语言，请定义其语法的表示形式，以及使用该表示形式来解释该语言中的句子的解释器。
+
+## 类图
+![alt text](../../interpreter/etc/interpreter_1.png "Interpreter")
+
+## 适用性
+有一种要解释的语言时，请使用解释器模式，并且可以将语言中的语句表示为抽象语法树。解释器模式在以下情况下效果最佳
+
+* 语法很简单。 对于复杂的语法，语法的类层次结构变得庞大且难以管理。 在这种情况下，解析器生成器之类的工具是更好的选择。 他们可以在不构建抽象语法树的情况下解释表达式，这可以节省空间并可能节省时间
+* 效率不是关键问题。 通常，最有效的解释器不是通过直接解释解析树来实现的，而是先将其转换为另一种形式。 例如，正则表达式通常会转换为状态机。 但是即使这样，翻译器也可以通过解释器模式实现，因此该模式仍然适用。
+
+## 真实世界例子
+
+* [java.util.Pattern](http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html)
+* [java.text.Normalizer](http://docs.oracle.com/javase/8/docs/api/java/text/Normalizer.html)
+* All subclasses of [java.text.Format](http://docs.oracle.com/javase/8/docs/api/java/text/Format.html)
+* [javax.el.ELResolver](http://docs.oracle.com/javaee/7/api/javax/el/ELResolver.html)
+
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
diff --git a/zh/private-class-data/README.md b/zh/private-class-data/README.md
new file mode 100644
index 000000000..735ca93f6
--- /dev/null
+++ b/zh/private-class-data/README.md
@@ -0,0 +1,128 @@
+---
+layout: pattern
+title: Private Class Data
+folder: private-class-data
+permalink: /patterns/private-class-data/
+categories: Idiom
+tags:
+ - Data access
+---
+
+## 目的
+
+私有类数据设计模式试图通过限制属性的可见性来减少属性的暴露。 通过将它们封装在单个Data对象中，可以减少类属性的数量。
+
+## 解释
+
+真实世界例子
+
+> 想象一下你在为家人做晚餐炖汤。你想阻止家庭成员在你烹饪时偷偷品尝菜品，否则后面可能东西不够吃了。
+
+通俗的说
+
+> 私有类数据模式通过将数据与使用它的方法分离到维护数据状态的类中，从而防止了对不可变数据的操纵。
+
+维基百科说
+
+> 私有类数据是计算机编程中的一种设计模式，用于封装类属性及其操作。
+
+**程序示例**
+
+使用上面炖汤的例子。 首先我们有 `炖汤`类 ，它的属性没有被私有类数据保护，从而使炖菜的成分对类方法易变。
+
+```java
+public class Stew {
+  private static final Logger LOGGER = LoggerFactory.getLogger(Stew.class);
+  private int numPotatoes;
+  private int numCarrots;
+  private int numMeat;
+  private int numPeppers;
+  public Stew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    this.numPotatoes = numPotatoes;
+    this.numCarrots = numCarrots;
+    this.numMeat = numMeat;
+    this.numPeppers = numPeppers;
+  }
+  public void mix() {
+    LOGGER.info("Mixing the stew we find: {} potatoes, {} carrots, {} meat and {} peppers",
+        numPotatoes, numCarrots, numMeat, numPeppers);
+  }
+  public void taste() {
+    LOGGER.info("Tasting the stew");
+    if (numPotatoes > 0) {
+      numPotatoes--;
+    }
+    if (numCarrots > 0) {
+      numCarrots--;
+    }
+    if (numMeat > 0) {
+      numMeat--;
+    }
+    if (numPeppers > 0) {
+      numPeppers--;
+    }
+  }
+}
+```
+
+现在，我们有了` ImmutableStew`类，其中的数据受`StewData`类保护。 现在，其中的方法无法处理`ImmutableStew`类的数据。
+
+```java
+public class StewData {
+  private final int numPotatoes;
+  private final int numCarrots;
+  private final int numMeat;
+  private final int numPeppers;
+  public StewData(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    this.numPotatoes = numPotatoes;
+    this.numCarrots = numCarrots;
+    this.numMeat = numMeat;
+    this.numPeppers = numPeppers;
+  }
+  public int getNumPotatoes() {
+    return numPotatoes;
+  }
+  public int getNumCarrots() {
+    return numCarrots;
+  }
+  public int getNumMeat() {
+    return numMeat;
+  }
+  public int getNumPeppers() {
+    return numPeppers;
+  }
+}
+public class ImmutableStew {
+  private static final Logger LOGGER = LoggerFactory.getLogger(ImmutableStew.class);
+  private final StewData data;
+  public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    data = new StewData(numPotatoes, numCarrots, numMeat, numPeppers);
+  }
+  public void mix() {
+    LOGGER
+        .info("Mixing the immutable stew we find: {} potatoes, {} carrots, {} meat and {} peppers",
+            data.getNumPotatoes(), data.getNumCarrots(), data.getNumMeat(), data.getNumPeppers());
+  }
+}
+```
+
+让我们尝试创建每个类的实例并调用其方法：
+
+```java
+var stew = new Stew(1, 2, 3, 4);
+stew.mix();   // Mixing the stew we find: 1 potatoes, 2 carrots, 3 meat and 4 peppers
+stew.taste(); // Tasting the stew
+stew.mix();   // Mixing the stew we find: 0 potatoes, 1 carrots, 2 meat and 3 peppers
+var immutableStew = new ImmutableStew(2, 4, 3, 6);
+immutableStew.mix();  // Mixing the immutable stew we find: 2 potatoes, 4 carrots, 3 meat and 6 peppers
+```
+
+## 类图
+
+![alt text](../../private-class-data/etc/private-class-data.png "Private Class Data")
+
+## 适用性
+
+在以下情况下使用私有类数据模式
+
+* 您要阻止对类数据成员的写访问。
diff --git a/zh/producer-consumer/README.md b/zh/producer-consumer/README.md
new file mode 100644
index 000000000..80ffeb9b9
--- /dev/null
+++ b/zh/producer-consumer/README.md
@@ -0,0 +1,21 @@
+---
+layout: pattern
+title: Producer Consumer
+folder: producer-consumer
+permalink: /patterns/producer-consumer/
+categories: Concurrency
+tags:
+ - Reactive
+---
+
+## 目的
+生产者消费者设计模式是一种经典的并发模式，通过将工作与执行工作任务分开来减少生产者与消费者之间的耦合。
+
+## 类图
+![alt text](../../producer-consumer/etc/producer-consumer.png "Producer Consumer")
+
+## 适用性
+在以下情况下使用生产者消费者
+
+* 通过将工作分成生产和消费两个工作进程来解耦系统
+* 解决生产工作和消费工作需要不同时间的问题
diff --git a/zh/proxy/README.md b/zh/proxy/README.md
new file mode 100644
index 000000000..50f7575be
--- /dev/null
+++ b/zh/proxy/README.md
@@ -0,0 +1,161 @@
+---
+layout: pattern
+title: Proxy
+folder: proxy
+permalink: /patterns/proxy/
+categories: Structural
+tags:
+ - Gang Of Four
+ - Decoupling
+---
+
+## 又被称为
+
+替代（代孕）模式
+
+## 目的
+
+为另一个对象提供代理或占位符以控制对其的访问。
+
+## 解释
+
+真实世界例子
+
+> 想象有一个塔，当地的巫师去那里学习他们的法术。象牙塔只能够通过代理来进入以此来保证只有首先3个巫师才能进入。这里的代理就代表的塔的功能并添加访问控制。
+
+通俗的说
+
+> 使用代理模式，一个类代表另一个类的功能。
+
+维基百科说
+
+> 在最一般的形式上，代理是一个类，它充当与其他对象的接口。代理是客户端调用的包装器或代理对象，以访问后台的实际服务对象。代理本身可以简单地转发到真实对象，也可以提供其他逻辑。在代理中，可以提供额外的功能，例如在对实对象的操作占用大量资源时进行缓存，或者在对实对象的操作被调用之前检查前提条件。
+
+**程序示例**
+
+使用上面的巫师塔为例。首先我们有**巫师塔**接口和**象牙塔**类 。
+
+```java
+public interface WizardTower {
+
+  void enter(Wizard wizard);
+}
+
+public class IvoryTower implements WizardTower {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class);
+
+  public void enter(Wizard wizard) {
+    LOGGER.info("{} enters the tower.", wizard);
+  }
+
+}
+```
+
+然后有个简单的巫师类。
+
+```java
+public class Wizard {
+
+  private final String name;
+
+  public Wizard(String name) {
+    this.name = name;
+  }
+
+  @Override
+  public String toString() {
+    return name;
+  }
+}
+```
+
+然后我们有巫师塔代理类为巫师塔添加访问控制。
+
+```java
+public class WizardTowerProxy implements WizardTower {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(WizardTowerProxy.class);
+
+  private static final int NUM_WIZARDS_ALLOWED = 3;
+
+  private int numWizards;
+
+  private final WizardTower tower;
+
+  public WizardTowerProxy(WizardTower tower) {
+    this.tower = tower;
+  }
+
+  @Override
+  public void enter(Wizard wizard) {
+    if (numWizards < NUM_WIZARDS_ALLOWED) {
+      tower.enter(wizard);
+      numWizards++;
+    } else {
+      LOGGER.info("{} is not allowed to enter!", wizard);
+    }
+  }
+}
+```
+
+然后这是进入塔的场景。
+
+```java
+var proxy = new WizardTowerProxy(new IvoryTower());
+proxy.enter(new Wizard("Red wizard"));
+proxy.enter(new Wizard("White wizard"));
+proxy.enter(new Wizard("Black wizard"));
+proxy.enter(new Wizard("Green wizard"));
+proxy.enter(new Wizard("Brown wizard"));
+```
+
+程序输出：
+
+```
+Red wizard enters the tower.
+White wizard enters the tower.
+Black wizard enters the tower.
+Green wizard is not allowed to enter!
+Brown wizard is not allowed to enter!
+```
+
+## 类图
+
+![alt text](../../proxy/etc/proxy.urm.png "Proxy pattern class diagram")
+
+## 适用性
+
+代理适用于需要比简单指针更广泛或更复杂的对象引用的情况。这是代理模式适用的几种常见情况。
+
+* 远程代理为不同地址空间中的对象提供了本地代表。
+* 虚拟代理根据需要创建昂贵的对象。
+* 保护代理控制对原始对象的访问。当对象有不同的接入权限时保护代理很有用。
+
+## 典型用例
+
+* 对象的访问控制
+* 懒加载
+* 实现日志记录
+* 简化网络连接
+* 对象的访问计数
+
+## 教程
+
+* [Controlling Access With Proxy Pattern](http://java-design-patterns.com/blog/controlling-access-with-proxy-pattern/)
+
+## 已知使用
+
+* [java.lang.reflect.Proxy](http://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Proxy.html)
+* [Apache Commons Proxy](https://commons.apache.org/proper/commons-proxy/)
+* Mocking frameworks [Mockito](https://site.mockito.org/), 
+[Powermock](https://powermock.github.io/), [EasyMock](https://easymock.org/)
+
+## 相关设计模式
+
+* [Ambassador](https://java-design-patterns.com/patterns/ambassador/)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
diff --git a/zh/state/README.md b/zh/state/README.md
index 6b46510e0..e222ac4d1 100644
--- a/zh/state/README.md
+++ b/zh/state/README.md
@@ -134,7 +134,7 @@ public class Mammoth {
 ```
 
 ## 类图
-![alt text](../../state/etc/state_1.png "State")
+![alt text](../../state/etc/state_urm.png "State")
 
 ## 适用性
 
diff --git a/zh/template-method/README.md b/zh/template-method/README.md
index f848552c3..54d6fd1a1 100644
--- a/zh/template-method/README.md
+++ b/zh/template-method/README.md
@@ -118,7 +118,7 @@ public class HalflingThief {
 ```
 
 ## 类图
-![alt text](../../template-method/etc/template-method_1.png "Template Method")
+![alt text](../../template-method/etc/template_method_urm.png "Template Method")
 
 ## 适用性
 
diff --git a/zh/visitor/README.md b/zh/visitor/README.md
new file mode 100644
index 000000000..74afe1a14
--- /dev/null
+++ b/zh/visitor/README.md
@@ -0,0 +1,224 @@
+---
+layout: pattern
+title: Visitor
+folder: visitor
+permalink: /patterns/visitor/
+categories: Behavioral
+tags:
+ - Gang of Four
+---
+
+## 目的
+
+表示要在对象结构的元素上执行的操作。访问者可让你定义新操作，而无需更改其所操作元素的类。
+
+## 解释
+
+真实世界例子
+
+> 考虑有一个带有军队单位的树形结构。指挥官下有两名中士，每名中士下有三名士兵。基于这个层级结构实现访问者模式，我们可以轻松创建与指挥官，中士，士兵或所有人员互动的新对象
+
+通俗的说
+
+> 访问者模式定义可以在数据结构的节点上执行的操作。
+
+维基百科说
+
+> 在面向对象的程序设计和软件工程中，访问者设计模式是一种将算法与操作对象的结构分离的方法。这种分离的实际结果是能够在不修改结构的情况下向现有对象结构添加新操作。
+
+**程序示例**
+
+使用上面的军队单元的例子，我们首先由单位和单位访问器类型。
+
+```java
+public abstract class Unit {
+
+  private final Unit[] children;
+
+  public Unit(Unit... children) {
+    this.children = children;
+  }
+
+  public void accept(UnitVisitor visitor) {
+    Arrays.stream(children).forEach(child -> child.accept(visitor));
+  }
+}
+
+public interface UnitVisitor {
+
+  void visitSoldier(Soldier soldier);
+
+  void visitSergeant(Sergeant sergeant);
+
+  void visitCommander(Commander commander);
+}
+```
+
+然后我们有具体的单元。
+
+```java
+public class Commander extends Unit {
+
+  public Commander(Unit... children) {
+    super(children);
+  }
+
+  @Override
+  public void accept(UnitVisitor visitor) {
+    visitor.visitCommander(this);
+    super.accept(visitor);
+  }
+
+  @Override
+  public String toString() {
+    return "commander";
+  }
+}
+
+public class Sergeant extends Unit {
+
+  public Sergeant(Unit... children) {
+    super(children);
+  }
+
+  @Override
+  public void accept(UnitVisitor visitor) {
+    visitor.visitSergeant(this);
+    super.accept(visitor);
+  }
+
+  @Override
+  public String toString() {
+    return "sergeant";
+  }
+}
+
+public class Soldier extends Unit {
+
+  public Soldier(Unit... children) {
+    super(children);
+  }
+
+  @Override
+  public void accept(UnitVisitor visitor) {
+    visitor.visitSoldier(this);
+    super.accept(visitor);
+  }
+
+  @Override
+  public String toString() {
+    return "soldier";
+  }
+}
+```
+
+然后有一些具体的访问者。
+
+```java
+public class CommanderVisitor implements UnitVisitor {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(CommanderVisitor.class);
+
+  @Override
+  public void visitSoldier(Soldier soldier) {
+    // Do nothing
+  }
+
+  @Override
+  public void visitSergeant(Sergeant sergeant) {
+    // Do nothing
+  }
+
+  @Override
+  public void visitCommander(Commander commander) {
+    LOGGER.info("Good to see you {}", commander);
+  }
+}
+
+public class SergeantVisitor implements UnitVisitor {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(SergeantVisitor.class);
+
+  @Override
+  public void visitSoldier(Soldier soldier) {
+    // Do nothing
+  }
+
+  @Override
+  public void visitSergeant(Sergeant sergeant) {
+    LOGGER.info("Hello {}", sergeant);
+  }
+
+  @Override
+  public void visitCommander(Commander commander) {
+    // Do nothing
+  }
+}
+
+public class SoldierVisitor implements UnitVisitor {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(SoldierVisitor.class);
+
+  @Override
+  public void visitSoldier(Soldier soldier) {
+    LOGGER.info("Greetings {}", soldier);
+  }
+
+  @Override
+  public void visitSergeant(Sergeant sergeant) {
+    // Do nothing
+  }
+
+  @Override
+  public void visitCommander(Commander commander) {
+    // Do nothing
+  }
+}
+```
+
+最后，来看看实践中访问者模式的力量。
+
+```java
+commander.accept(new SoldierVisitor());
+commander.accept(new SergeantVisitor());
+commander.accept(new CommanderVisitor());
+```
+
+程序输出:
+
+```
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Greetings soldier
+Hello sergeant
+Hello sergeant
+Good to see you commander
+```
+
+## Class diagram
+
+![alt text](../../visitor/etc/visitor_1.png "Visitor")
+
+## 适用性
+
+使用访问者模式当
+
+* 对象结构包含许多具有不同接口的对象类，并且你希望根据这些对象的具体类对这些对象执行操作。
+* 需要对对象结构中的对象执行许多不同且不相关的操作，并且你想避免使用这些操作“污染”它们的类。 访问者可以通过在一个类中定义相关操作来将它们保持在一起。当许多应用程序共享对象结构时，请使用访问者模式将操作仅放在需要它们的那些应用程序中
+* 定义对象结构的类很少变化，但是你经常想在结构上定义新的操作。更改对象结构类需要重新定义所有访问者的接口，这可能会导致成本高昂。如果对象结构类经常更改，则最好在这些类中定义操作。
+
+## 真实例子
+
+* [Apache Wicket](https://github.com/apache/wicket) component tree, see [MarkupContainer](https://github.com/apache/wicket/blob/b60ec64d0b50a611a9549809c9ab216f0ffa3ae3/wicket-core/src/main/java/org/apache/wicket/MarkupContainer.java)
+* [javax.lang.model.element.AnnotationValue](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/AnnotationValue.html) and [AnnotationValueVisitor](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/AnnotationValueVisitor.html)
+* [javax.lang.model.element.Element](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/Element.html) and [Element Visitor](http://docs.oracle.com/javase/8/docs/api/javax/lang/model/element/ElementVisitor.html)
+* [java.nio.file.FileVisitor](http://docs.oracle.com/javase/8/docs/api/java/nio/file/FileVisitor.html)
+
+## 鸣谢
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)

From b3fc60fe928ba1d96cad9a0988c215f4866f046d Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 14 Feb 2021 14:33:13 +0530
Subject: [PATCH 217/254] update .gitignore (#1651)

* updated factorypath

* updated gitignore
---
 .gitignore | 41 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index cbf902674..027769b63 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,21 +1,54 @@
+################## Eclipse ######################
 target
 .metadata
 .settings
 .classpath
 .project
 *.class
+tmp/
+*.tmp
+*.bak
+*~.nib
+local.properties
+.loadpath
+.recommenders
 
-### Package Files ###
+#######  Java annotation processor (APT) ########
+.factorypath
+
+################ Package Files ##################
 *.jar
 *.war
 *.ear
-.idea
-*.iml
 *.swp
 datanucleus.log
 /bin/
 *.log
 event-sourcing/Journal.json
 
-### Checkstyle ###
+################## Checkstyle ###################
 .checkstyle
+
+##################### STS #######################
+.apt_generated
+.springBeans
+.sts4-cache
+
+################# IntelliJ IDEA #################
+.idea
+*.iws
+*.iml
+*.ipr
+
+################### NetBeans ####################
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+#################### VS Code ####################
+.vscode/

From 7891c2b117e9c9f94c6d3d092657a306b3a6ac5e Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 14 Feb 2021 15:27:57 +0530
Subject: [PATCH 218/254] update inception year to 2021 (#1653)

---
 .github/workflows/maven-ci.yml                |  2 +-
 .github/workflows/maven-pr-builder.yml        |  2 +-
 abstract-document/pom.xml                     | 39 ++++++++++-------
 .../abstractdocument/AbstractDocument.java    |  2 +-
 .../com/iluwatar/abstractdocument/App.java    |  2 +-
 .../iluwatar/abstractdocument/Document.java   |  2 +-
 .../iluwatar/abstractdocument/domain/Car.java |  2 +-
 .../abstractdocument/domain/HasModel.java     |  2 +-
 .../abstractdocument/domain/HasParts.java     |  2 +-
 .../abstractdocument/domain/HasPrice.java     |  2 +-
 .../abstractdocument/domain/HasType.java      |  2 +-
 .../abstractdocument/domain/Part.java         |  2 +-
 .../domain/enums/Property.java                |  2 +-
 .../AbstractDocumentTest.java                 |  2 +-
 .../iluwatar/abstractdocument/AppTest.java    |  2 +-
 .../iluwatar/abstractdocument/DomainTest.java |  2 +-
 abstract-factory/pom.xml                      | 39 ++++++++++-------
 .../com/iluwatar/abstractfactory/App.java     |  2 +-
 .../com/iluwatar/abstractfactory/Army.java    |  2 +-
 .../com/iluwatar/abstractfactory/Castle.java  |  2 +-
 .../com/iluwatar/abstractfactory/ElfArmy.java |  2 +-
 .../iluwatar/abstractfactory/ElfCastle.java   |  2 +-
 .../com/iluwatar/abstractfactory/ElfKing.java |  2 +-
 .../abstractfactory/ElfKingdomFactory.java    |  2 +-
 .../com/iluwatar/abstractfactory/King.java    |  2 +-
 .../com/iluwatar/abstractfactory/Kingdom.java |  2 +-
 .../abstractfactory/KingdomFactory.java       |  2 +-
 .../com/iluwatar/abstractfactory/OrcArmy.java |  2 +-
 .../iluwatar/abstractfactory/OrcCastle.java   |  2 +-
 .../com/iluwatar/abstractfactory/OrcKing.java |  2 +-
 .../abstractfactory/OrcKingdomFactory.java    |  2 +-
 .../abstractfactory/AbstractFactoryTest.java  |  2 +-
 .../com/iluwatar/abstractfactory/AppTest.java |  2 +-
 acyclic-visitor/pom.xml                       | 39 ++++++++++-------
 .../acyclicvisitor/AllModemVisitor.java       |  2 +-
 .../java/com/iluwatar/acyclicvisitor/App.java |  2 +-
 .../ConfigureForDosVisitor.java               |  2 +-
 .../ConfigureForUnixVisitor.java              |  2 +-
 .../com/iluwatar/acyclicvisitor/Hayes.java    |  2 +-
 .../iluwatar/acyclicvisitor/HayesVisitor.java |  2 +-
 .../com/iluwatar/acyclicvisitor/Modem.java    |  2 +-
 .../iluwatar/acyclicvisitor/ModemVisitor.java |  2 +-
 .../com/iluwatar/acyclicvisitor/Zoom.java     |  2 +-
 .../iluwatar/acyclicvisitor/ZoomVisitor.java  |  2 +-
 .../com/iluwatar/acyclicvisitor/AppTest.java  |  2 +-
 .../ConfigureForDosVisitorTest.java           |  2 +-
 .../ConfigureForUnixVisitorTest.java          |  2 +-
 .../iluwatar/acyclicvisitor/HayesTest.java    |  2 +-
 .../com/iluwatar/acyclicvisitor/ZoomTest.java |  2 +-
 adapter/pom.xml                               | 39 ++++++++++-------
 .../main/java/com/iluwatar/adapter/App.java   |  2 +-
 .../java/com/iluwatar/adapter/Captain.java    |  2 +-
 .../com/iluwatar/adapter/FishingBoat.java     |  2 +-
 .../iluwatar/adapter/FishingBoatAdapter.java  |  2 +-
 .../java/com/iluwatar/adapter/RowingBoat.java |  2 +-
 .../com/iluwatar/adapter/package-info.java    |  2 +-
 .../iluwatar/adapter/AdapterPatternTest.java  |  2 +-
 .../java/com/iluwatar/adapter/AppTest.java    |  2 +-
 .../aggregator-service/pom.xml                | 39 ++++++++++-------
 .../aggregator/microservices/Aggregator.java  |  2 +-
 .../aggregator/microservices/App.java         |  2 +-
 .../aggregator/microservices/Product.java     |  2 +-
 .../ProductInformationClient.java             |  2 +-
 .../ProductInformationClientImpl.java         |  2 +-
 .../microservices/ProductInventoryClient.java |  2 +-
 .../ProductInventoryClientImpl.java           |  2 +-
 .../src/main/resources/application.properties |  3 +-
 .../microservices/AggregatorTest.java         |  2 +-
 .../information-microservice/pom.xml          | 39 ++++++++++-------
 .../microservice/InformationApplication.java  |  2 +-
 .../microservice/InformationController.java   |  2 +-
 .../src/main/resources/application.properties |  3 +-
 .../InformationControllerTest.java            |  2 +-
 .../inventory-microservice/pom.xml            | 39 ++++++++++-------
 .../microservice/InventoryApplication.java    |  2 +-
 .../microservice/InventoryController.java     |  2 +-
 .../src/main/resources/application.properties |  3 +-
 .../microservice/InventoryControllerTest.java |  2 +-
 aggregator-microservices/pom.xml              |  2 +-
 ambassador/pom.xml                            | 39 ++++++++++-------
 .../java/com/iluwatar/ambassador/App.java     |  2 +-
 .../java/com/iluwatar/ambassador/Client.java  |  2 +-
 .../iluwatar/ambassador/RemoteService.java    |  2 +-
 .../ambassador/RemoteServiceInterface.java    |  2 +-
 .../ambassador/RemoteServiceStatus.java       |  2 +-
 .../ambassador/ServiceAmbassador.java         |  2 +-
 .../ambassador/util/RandomProvider.java       |  2 +-
 .../java/com/iluwatar/ambassador/AppTest.java |  2 +-
 .../com/iluwatar/ambassador/ClientTest.java   |  2 +-
 .../ambassador/RemoteServiceTest.java         |  2 +-
 .../ambassador/ServiceAmbassadorTest.java     |  2 +-
 api-gateway/api-gateway-service/pom.xml       |  2 +-
 .../com/iluwatar/api/gateway/ApiGateway.java  |  2 +-
 .../java/com/iluwatar/api/gateway/App.java    |  2 +-
 .../iluwatar/api/gateway/DesktopProduct.java  |  2 +-
 .../com/iluwatar/api/gateway/ImageClient.java |  2 +-
 .../iluwatar/api/gateway/ImageClientImpl.java |  2 +-
 .../iluwatar/api/gateway/MobileProduct.java   |  2 +-
 .../com/iluwatar/api/gateway/PriceClient.java |  2 +-
 .../iluwatar/api/gateway/PriceClientImpl.java |  2 +-
 .../src/main/resources/application.properties |  3 +-
 .../iluwatar/api/gateway/ApiGatewayTest.java  |  2 +-
 api-gateway/image-microservice/pom.xml        |  2 +-
 .../image/microservice/ImageApplication.java  |  2 +-
 .../image/microservice/ImageController.java   |  2 +-
 .../src/main/resources/application.properties |  2 +-
 .../microservice/ImageControllerTest.java     |  2 +-
 api-gateway/pom.xml                           |  2 +-
 api-gateway/price-microservice/pom.xml        |  2 +-
 .../price/microservice/PriceApplication.java  |  2 +-
 .../price/microservice/PriceController.java   |  2 +-
 .../src/main/resources/application.properties |  2 +-
 .../microservice/PriceControllerTest.java     |  2 +-
 arrange-act-assert/pom.xml                    |  2 +-
 .../com/iluwatar/arrangeactassert/Cash.java   |  2 +-
 .../arrangeactassert/CashAAATest.java         |  2 +-
 .../arrangeactassert/CashAntiAAATest.java     |  2 +-
 async-method-invocation/pom.xml               | 39 ++++++++++-------
 .../iluwatar/async/method/invocation/App.java |  2 +-
 .../method/invocation/AsyncCallback.java      |  2 +-
 .../method/invocation/AsyncExecutor.java      |  2 +-
 .../async/method/invocation/AsyncResult.java  |  2 +-
 .../invocation/ThreadAsyncExecutor.java       |  2 +-
 .../async/method/invocation/AppTest.java      |  2 +-
 .../invocation/ThreadAsyncExecutorTest.java   |  2 +-
 balking/pom.xml                               | 39 ++++++++++-------
 .../main/java/com/iluwatar/balking/App.java   |  2 +-
 .../com/iluwatar/balking/DelayProvider.java   |  2 +-
 .../com/iluwatar/balking/WashingMachine.java  |  2 +-
 .../iluwatar/balking/WashingMachineState.java |  2 +-
 .../java/com/iluwatar/balking/AppTest.java    |  2 +-
 .../iluwatar/balking/WashingMachineTest.java  |  2 +-
 bridge/pom.xml                                | 39 ++++++++++-------
 .../main/java/com/iluwatar/bridge/App.java    |  2 +-
 .../java/com/iluwatar/bridge/Enchantment.java |  2 +-
 .../iluwatar/bridge/FlyingEnchantment.java    |  2 +-
 .../main/java/com/iluwatar/bridge/Hammer.java |  2 +-
 .../bridge/SoulEatingEnchantment.java         |  2 +-
 .../main/java/com/iluwatar/bridge/Sword.java  |  2 +-
 .../main/java/com/iluwatar/bridge/Weapon.java |  2 +-
 .../java/com/iluwatar/bridge/AppTest.java     |  2 +-
 .../java/com/iluwatar/bridge/HammerTest.java  |  2 +-
 .../java/com/iluwatar/bridge/SwordTest.java   |  2 +-
 .../java/com/iluwatar/bridge/WeaponTest.java  |  2 +-
 builder/pom.xml                               | 39 ++++++++++-------
 .../main/java/com/iluwatar/builder/App.java   |  2 +-
 .../main/java/com/iluwatar/builder/Armor.java |  2 +-
 .../java/com/iluwatar/builder/HairColor.java  |  2 +-
 .../java/com/iluwatar/builder/HairType.java   |  2 +-
 .../main/java/com/iluwatar/builder/Hero.java  |  2 +-
 .../java/com/iluwatar/builder/Profession.java |  2 +-
 .../java/com/iluwatar/builder/Weapon.java     |  2 +-
 .../java/com/iluwatar/builder/AppTest.java    |  2 +-
 .../java/com/iluwatar/builder/HeroTest.java   |  2 +-
 business-delegate/pom.xml                     | 39 ++++++++++-------
 .../com/iluwatar/business/delegate/App.java   |  2 +-
 .../business/delegate/BusinessDelegate.java   |  2 +-
 .../business/delegate/BusinessLookup.java     |  2 +-
 .../business/delegate/BusinessService.java    |  2 +-
 .../iluwatar/business/delegate/Client.java    |  2 +-
 .../business/delegate/EjbService.java         |  2 +-
 .../business/delegate/JmsService.java         |  2 +-
 .../business/delegate/ServiceType.java        |  2 +-
 .../iluwatar/business/delegate/AppTest.java   |  2 +-
 .../delegate/BusinessDelegateTest.java        |  2 +-
 bytecode/pom.xml                              | 39 ++++++++++-------
 .../main/java/com/iluwatar/bytecode/App.java  |  2 +-
 .../com/iluwatar/bytecode/Instruction.java    |  2 +-
 .../com/iluwatar/bytecode/VirtualMachine.java |  2 +-
 .../java/com/iluwatar/bytecode/Wizard.java    |  2 +-
 .../util/InstructionConverterUtil.java        |  2 +-
 .../java/com/iluwatar/bytecode/AppTest.java   |  2 +-
 .../iluwatar/bytecode/VirtualMachineTest.java |  2 +-
 .../util/InstructionConverterUtilTest.java    |  2 +-
 caching/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/caching/App.java   |  2 +-
 .../java/com/iluwatar/caching/AppManager.java |  2 +-
 .../java/com/iluwatar/caching/CacheStore.java |  2 +-
 .../com/iluwatar/caching/CachingPolicy.java   |  2 +-
 .../java/com/iluwatar/caching/DbManager.java  |  2 +-
 .../java/com/iluwatar/caching/LruCache.java   |  2 +-
 .../com/iluwatar/caching/UserAccount.java     |  2 +-
 .../caching/constants/CachingConstants.java   |  2 +-
 .../java/com/iluwatar/caching/AppTest.java    |  2 +-
 .../com/iluwatar/caching/CachingTest.java     |  2 +-
 callback/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/callback/App.java  |  2 +-
 .../java/com/iluwatar/callback/Callback.java  |  2 +-
 .../com/iluwatar/callback/SimpleTask.java     |  2 +-
 .../main/java/com/iluwatar/callback/Task.java |  2 +-
 .../com/iluwatar/callback/package-info.java   |  2 +-
 .../java/com/iluwatar/callback/AppTest.java   |  2 +-
 .../com/iluwatar/callback/CallbackTest.java   |  2 +-
 chain/pom.xml                                 |  2 +-
 .../src/main/java/com/iluwatar/chain/App.java |  2 +-
 .../java/com/iluwatar/chain/OrcCommander.java |  2 +-
 .../main/java/com/iluwatar/chain/OrcKing.java |  2 +-
 .../java/com/iluwatar/chain/OrcOfficer.java   |  2 +-
 .../java/com/iluwatar/chain/OrcSoldier.java   |  2 +-
 .../main/java/com/iluwatar/chain/Request.java |  2 +-
 .../com/iluwatar/chain/RequestHandler.java    |  2 +-
 .../java/com/iluwatar/chain/RequestType.java  |  2 +-
 .../test/java/com/iluwatar/chain/AppTest.java |  2 +-
 .../java/com/iluwatar/chain/OrcKingTest.java  |  2 +-
 checkstyle-suppressions.xml                   |  2 +-
 circuit-breaker/pom.xml                       |  2 +-
 .../java/com/iluwatar/circuitbreaker/App.java |  2 +-
 .../circuitbreaker/CircuitBreaker.java        |  2 +-
 .../circuitbreaker/DefaultCircuitBreaker.java |  2 +-
 .../circuitbreaker/DelayedRemoteService.java  |  2 +-
 .../circuitbreaker/MonitoringService.java     |  2 +-
 .../circuitbreaker/QuickRemoteService.java    |  2 +-
 .../circuitbreaker/RemoteService.java         |  2 +-
 .../RemoteServiceException.java               |  2 +-
 .../com/iluwatar/circuitbreaker/State.java    |  2 +-
 .../com/iluwatar/circuitbreaker/AppTest.java  |  2 +-
 .../DefaultCircuitBreakerTest.java            |  2 +-
 .../DelayedRemoteServiceTest.java             |  2 +-
 .../circuitbreaker/MonitoringServiceTest.java |  2 +-
 collection-pipeline/pom.xml                   |  2 +-
 .../com/iluwatar/collectionpipeline/App.java  |  2 +-
 .../com/iluwatar/collectionpipeline/Car.java  |  2 +-
 .../collectionpipeline/CarFactory.java        |  2 +-
 .../iluwatar/collectionpipeline/Category.java |  2 +-
 .../FunctionalProgramming.java                |  2 +-
 .../ImperativeProgramming.java                |  2 +-
 .../iluwatar/collectionpipeline/Person.java   |  2 +-
 .../iluwatar/collectionpipeline/AppTest.java  |  2 +-
 combinator/pom.xml                            |  2 +-
 .../iluwatar/combinator/CombinatorApp.java    |  2 +-
 .../java/com/iluwatar/combinator/Finder.java  |  2 +-
 .../java/com/iluwatar/combinator/Finders.java |  2 +-
 .../combinator/CombinatorAppTest.java         |  2 +-
 .../com/iluwatar/combinator/FinderTest.java   |  2 +-
 .../com/iluwatar/combinator/FindersTest.java  |  2 +-
 command/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/command/App.java   |  2 +-
 .../java/com/iluwatar/command/Goblin.java     |  2 +-
 .../main/java/com/iluwatar/command/Size.java  |  2 +-
 .../java/com/iluwatar/command/Target.java     |  2 +-
 .../java/com/iluwatar/command/Visibility.java |  2 +-
 .../java/com/iluwatar/command/Wizard.java     |  2 +-
 .../java/com/iluwatar/command/AppTest.java    |  2 +-
 .../com/iluwatar/command/CommandTest.java     |  2 +-
 commander/pom.xml                             |  2 +-
 .../commander/AppEmployeeDbFailCases.java     |  2 +-
 .../commander/AppMessagingFailCases.java      |  2 +-
 .../commander/AppPaymentFailCases.java        |  2 +-
 .../iluwatar/commander/AppQueueFailCases.java |  2 +-
 .../commander/AppShippingFailCases.java       |  2 +-
 .../com/iluwatar/commander/Commander.java     |  2 +-
 .../java/com/iluwatar/commander/Database.java |  2 +-
 .../java/com/iluwatar/commander/Order.java    |  2 +-
 .../java/com/iluwatar/commander/Retry.java    |  2 +-
 .../java/com/iluwatar/commander/Service.java  |  2 +-
 .../java/com/iluwatar/commander/User.java     |  2 +-
 .../employeehandle/EmployeeDatabase.java      |  2 +-
 .../employeehandle/EmployeeHandle.java        |  2 +-
 .../DatabaseUnavailableException.java         |  2 +-
 .../exceptions/IsEmptyException.java          |  2 +-
 .../exceptions/ItemUnavailableException.java  |  2 +-
 .../PaymentDetailsErrorException.java         |  2 +-
 .../ShippingNotPossibleException.java         |  2 +-
 .../messagingservice/MessagingDatabase.java   |  2 +-
 .../messagingservice/MessagingService.java    |  2 +-
 .../paymentservice/PaymentDatabase.java       |  2 +-
 .../paymentservice/PaymentService.java        |  2 +-
 .../com/iluwatar/commander/queue/Queue.java   |  2 +-
 .../commander/queue/QueueDatabase.java        |  2 +-
 .../iluwatar/commander/queue/QueueTask.java   |  2 +-
 .../shippingservice/ShippingDatabase.java     |  2 +-
 .../shippingservice/ShippingService.java      |  2 +-
 .../com/iluwatar/commander/RetryTest.java     |  2 +-
 composite/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/composite/App.java |  2 +-
 .../java/com/iluwatar/composite/Letter.java   |  2 +-
 .../iluwatar/composite/LetterComposite.java   |  2 +-
 .../com/iluwatar/composite/Messenger.java     |  2 +-
 .../java/com/iluwatar/composite/Sentence.java |  2 +-
 .../java/com/iluwatar/composite/Word.java     |  2 +-
 .../java/com/iluwatar/composite/AppTest.java  |  2 +-
 .../com/iluwatar/composite/MessengerTest.java |  2 +-
 converter/pom.xml                             | 39 ++++++++++-------
 .../main/java/com/iluwatar/converter/App.java |  2 +-
 .../com/iluwatar/converter/Converter.java     |  2 +-
 .../java/com/iluwatar/converter/User.java     |  2 +-
 .../com/iluwatar/converter/UserConverter.java |  2 +-
 .../java/com/iluwatar/converter/UserDto.java  |  2 +-
 .../java/com/iluwatar/converter/AppTest.java  |  2 +-
 .../com/iluwatar/converter/ConverterTest.java |  2 +-
 cqrs/pom.xml                                  |  2 +-
 .../main/java/com/iluwatar/cqrs/app/App.java  |  2 +-
 .../cqrs/commandes/CommandServiceImpl.java    |  2 +-
 .../cqrs/commandes/ICommandService.java       |  2 +-
 .../iluwatar/cqrs/constants/AppConstants.java |  2 +-
 .../iluwatar/cqrs/domain/model/Author.java    |  2 +-
 .../com/iluwatar/cqrs/domain/model/Book.java  |  2 +-
 .../java/com/iluwatar/cqrs/dto/Author.java    |  2 +-
 .../main/java/com/iluwatar/cqrs/dto/Book.java |  2 +-
 .../iluwatar/cqrs/queries/IQueryService.java  |  2 +-
 .../cqrs/queries/QueryServiceImpl.java        |  2 +-
 .../com/iluwatar/cqrs/util/HibernateUtil.java |  2 +-
 cqrs/src/main/resources/hibernate.cfg.xml     |  2 +-
 cqrs/src/main/resources/logback.xml           |  2 +-
 .../com/iluwatar/cqrs/IntegrationTest.java    |  2 +-
 cqrs/src/test/resources/hibernate.cfg.xml     |  2 +-
 cqrs/src/test/resources/logback.xml           |  2 +-
 dao/pom.xml                                   |  2 +-
 dao/src/main/java/com/iluwatar/dao/App.java   |  2 +-
 .../com/iluwatar/dao/CustomException.java     |  2 +-
 .../main/java/com/iluwatar/dao/Customer.java  |  2 +-
 .../java/com/iluwatar/dao/CustomerDao.java    |  2 +-
 .../com/iluwatar/dao/CustomerSchemaSql.java   |  2 +-
 .../java/com/iluwatar/dao/DbCustomerDao.java  |  2 +-
 .../com/iluwatar/dao/InMemoryCustomerDao.java |  2 +-
 .../test/java/com/iluwatar/dao/AppTest.java   |  2 +-
 .../java/com/iluwatar/dao/CustomerTest.java   |  2 +-
 .../com/iluwatar/dao/DbCustomerDaoTest.java   |  2 +-
 .../iluwatar/dao/InMemoryCustomerDaoTest.java |  2 +-
 data-bus/pom.xml                              |  2 +-
 .../iluwatar/databus/AbstractDataType.java    |  2 +-
 .../main/java/com/iluwatar/databus/App.java   |  2 +-
 .../java/com/iluwatar/databus/DataBus.java    |  2 +-
 .../java/com/iluwatar/databus/DataType.java   |  2 +-
 .../java/com/iluwatar/databus/Member.java     |  2 +-
 .../iluwatar/databus/data/MessageData.java    |  2 +-
 .../iluwatar/databus/data/StartingData.java   |  2 +-
 .../iluwatar/databus/data/StoppingData.java   |  2 +-
 .../members/MessageCollectorMember.java       |  2 +-
 .../databus/members/StatusMember.java         |  2 +-
 .../com/iluwatar/databus/DataBusTest.java     |  2 +-
 .../members/MessageCollectorMemberTest.java   |  2 +-
 .../databus/members/StatusMemberTest.java     |  2 +-
 data-locality/pom.xml                         |  2 +-
 .../iluwatar/data/locality/Application.java   |  2 +-
 .../data/locality/game/GameEntity.java        |  2 +-
 .../locality/game/component/AiComponent.java  |  2 +-
 .../locality/game/component/Component.java    |  2 +-
 .../game/component/PhysicsComponent.java      |  2 +-
 .../game/component/RenderComponent.java       |  2 +-
 .../component/manager/AiComponentManager.java |  2 +-
 .../manager/PhysicsComponentManager.java      |  2 +-
 .../manager/RenderComponentManager.java       |  2 +-
 .../data/locality/ApplicationTest.java        |  2 +-
 data-mapper/pom.xml                           |  2 +-
 .../java/com/iluwatar/datamapper/App.java     |  2 +-
 .../datamapper/DataMapperException.java       |  2 +-
 .../java/com/iluwatar/datamapper/Student.java |  2 +-
 .../datamapper/StudentDataMapper.java         |  2 +-
 .../datamapper/StudentDataMapperImpl.java     |  2 +-
 .../java/com/iluwatar/datamapper/AppTest.java |  2 +-
 .../iluwatar/datamapper/DataMapperTest.java   |  2 +-
 .../com/iluwatar/datamapper/StudentTest.java  |  2 +-
 data-transfer-object/pom.xml                  |  2 +-
 .../java/com/iluwatar/datatransfer/App.java   |  2 +-
 .../datatransfer/customer/CustomerDto.java    |  2 +-
 .../customer/CustomerResource.java            |  2 +-
 .../datatransfer/product/Product.java         |  2 +-
 .../datatransfer/product/ProductDto.java      |  2 +-
 .../datatransfer/product/ProductResource.java |  2 +-
 .../com/iluwatar/datatransfer/AppTest.java    |  2 +-
 .../customer/CustomerResourceTest.java        |  2 +-
 decorator/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/decorator/App.java |  2 +-
 .../com/iluwatar/decorator/ClubbedTroll.java  |  2 +-
 .../com/iluwatar/decorator/SimpleTroll.java   |  2 +-
 .../java/com/iluwatar/decorator/Troll.java    |  2 +-
 .../java/com/iluwatar/decorator/AppTest.java  |  2 +-
 .../iluwatar/decorator/ClubbedTrollTest.java  |  2 +-
 .../iluwatar/decorator/SimpleTrollTest.java   |  2 +-
 delegation/pom.xml                            |  2 +-
 .../com/iluwatar/delegation/simple/App.java   |  2 +-
 .../iluwatar/delegation/simple/Printer.java   |  2 +-
 .../delegation/simple/PrinterController.java  |  2 +-
 .../simple/printers/CanonPrinter.java         |  2 +-
 .../simple/printers/EpsonPrinter.java         |  2 +-
 .../delegation/simple/printers/HpPrinter.java |  2 +-
 .../iluwatar/delegation/simple/AppTest.java   |  2 +-
 .../delegation/simple/DelegateTest.java       |  2 +-
 dependency-injection/pom.xml                  |  2 +-
 .../injection/AdvancedSorceress.java          |  2 +-
 .../dependency/injection/AdvancedWizard.java  |  2 +-
 .../iluwatar/dependency/injection/App.java    |  2 +-
 .../dependency/injection/GuiceWizard.java     |  2 +-
 .../dependency/injection/OldTobyTobacco.java  |  2 +-
 .../injection/RivendellTobacco.java           |  2 +-
 .../injection/SecondBreakfastTobacco.java     |  2 +-
 .../dependency/injection/SimpleWizard.java    |  2 +-
 .../dependency/injection/Tobacco.java         |  2 +-
 .../dependency/injection/TobaccoModule.java   |  2 +-
 .../iluwatar/dependency/injection/Wizard.java |  2 +-
 .../injection/AdvancedSorceressTest.java      |  2 +-
 .../injection/AdvancedWizardTest.java         |  2 +-
 .../dependency/injection/AppTest.java         |  2 +-
 .../dependency/injection/GuiceWizardTest.java |  2 +-
 .../injection/SimpleWizardTest.java           |  2 +-
 .../injection/utils/InMemoryAppender.java     |  2 +-
 dirty-flag/pom.xml                            |  2 +-
 .../main/java/com/iluwatar/dirtyflag/App.java |  2 +-
 .../com/iluwatar/dirtyflag/DataFetcher.java   |  2 +-
 .../java/com/iluwatar/dirtyflag/World.java    |  2 +-
 dirty-flag/src/main/resources/world.txt       |  2 +-
 .../src/test/java/org/dirty/flag/AppTest.java |  2 +-
 .../java/org/dirty/flag/DirtyFlagTest.java    |  2 +-
 double-buffer/pom.xml                         |  2 +-
 .../java/com/iluwatar/doublebuffer/App.java   |  2 +-
 .../com/iluwatar/doublebuffer/Buffer.java     |  2 +-
 .../iluwatar/doublebuffer/FrameBuffer.java    |  2 +-
 .../java/com/iluwatar/doublebuffer/Pixel.java |  2 +-
 .../java/com/iluwatar/doublebuffer/Scene.java |  2 +-
 .../com/iluwatar/doublebuffer/AppTest.java    |  2 +-
 .../doublebuffer/FrameBufferTest.java         |  2 +-
 .../com/iluwatar/doublebuffer/SceneTest.java  |  2 +-
 double-checked-locking/pom.xml                |  2 +-
 .../iluwatar/doublechecked/locking/App.java   |  2 +-
 .../doublechecked/locking/Inventory.java      |  2 +-
 .../iluwatar/doublechecked/locking/Item.java  |  2 +-
 .../src/main/resources/logback.xml            |  2 +-
 .../doublechecked/locking/AppTest.java        |  2 +-
 .../doublechecked/locking/InventoryTest.java  |  2 +-
 double-dispatch/pom.xml                       |  2 +-
 .../java/com/iluwatar/doubledispatch/App.java |  2 +-
 .../doubledispatch/FlamingAsteroid.java       |  2 +-
 .../iluwatar/doubledispatch/GameObject.java   |  2 +-
 .../iluwatar/doubledispatch/Meteoroid.java    |  2 +-
 .../iluwatar/doubledispatch/Rectangle.java    |  2 +-
 .../doubledispatch/SpaceStationIss.java       |  2 +-
 .../doubledispatch/SpaceStationMir.java       |  2 +-
 .../constants/AppConstants.java               |  2 +-
 .../com/iluwatar/doubledispatch/AppTest.java  |  2 +-
 .../doubledispatch/CollisionTest.java         |  2 +-
 .../doubledispatch/FlamingAsteroidTest.java   |  2 +-
 .../doubledispatch/MeteoroidTest.java         |  2 +-
 .../doubledispatch/RectangleTest.java         |  2 +-
 .../doubledispatch/SpaceStationIssTest.java   |  2 +-
 .../doubledispatch/SpaceStationMirTest.java   |  2 +-
 eip-aggregator/pom.xml                        |  2 +-
 .../java/com/iluwatar/eip/aggregator/App.java |  2 +-
 .../aggregator/routes/AggregatorRoute.java    |  2 +-
 .../routes/MessageAggregationStrategy.java    |  2 +-
 .../src/main/resources/application.properties |  2 +-
 .../com/iluwatar/eip/aggregator/AppTest.java  |  2 +-
 .../routes/AggregatorRouteTest.java           |  2 +-
 .../MessageAggregationStrategyTest.java       |  2 +-
 .../resources/application-test.properties     |  2 +-
 eip-message-channel/pom.xml                   |  2 +-
 .../com/iluwatar/eip/message/channel/App.java |  2 +-
 .../iluwatar/eip/message/channel/AppTest.java |  2 +-
 eip-publish-subscribe/pom.xml                 |  2 +-
 .../iluwatar/eip/publish/subscribe/App.java   |  2 +-
 .../src/main/resources/logback.xml            |  2 +-
 .../eip/publish/subscribe/AppTest.java        |  2 +-
 eip-splitter/pom.xml                          |  2 +-
 .../java/com/iluwatar/eip/splitter/App.java   |  2 +-
 .../eip/splitter/routes/SplitterRoute.java    |  2 +-
 .../src/main/resources/application.properties |  2 +-
 .../com/iluwatar/eip/splitter/AppTest.java    |  2 +-
 .../splitter/routes/SplitterRouteTest.java    |  2 +-
 .../resources/application-test.properties     |  2 +-
 eip-wire-tap/pom.xml                          |  2 +-
 .../java/com/iluwatar/eip/wiretap/App.java    |  2 +-
 .../eip/wiretap/routes/WireTapRoute.java      |  2 +-
 .../src/main/resources/application.properties |  2 +-
 .../com/iluwatar/eip/wiretap/AppTest.java     |  2 +-
 .../eip/wiretap/routes/WireTapRouteTest.java  |  2 +-
 .../resources/application-test.properties     |  2 +-
 event-aggregator/pom.xml                      |  2 +-
 .../com/iluwatar/event/aggregator/App.java    |  2 +-
 .../com/iluwatar/event/aggregator/Event.java  |  2 +-
 .../event/aggregator/EventEmitter.java        |  2 +-
 .../event/aggregator/EventObserver.java       |  2 +-
 .../event/aggregator/KingJoffrey.java         |  2 +-
 .../iluwatar/event/aggregator/KingsHand.java  |  2 +-
 .../event/aggregator/LordBaelish.java         |  2 +-
 .../iluwatar/event/aggregator/LordVarys.java  |  2 +-
 .../com/iluwatar/event/aggregator/Scout.java  |  2 +-
 .../iluwatar/event/aggregator/Weekday.java    |  2 +-
 .../iluwatar/event/aggregator/AppTest.java    |  2 +-
 .../event/aggregator/EventEmitterTest.java    |  2 +-
 .../iluwatar/event/aggregator/EventTest.java  |  2 +-
 .../event/aggregator/KingJoffreyTest.java     |  2 +-
 .../event/aggregator/KingsHandTest.java       |  2 +-
 .../event/aggregator/LordBaelishTest.java     |  2 +-
 .../event/aggregator/LordVarysTest.java       |  2 +-
 .../iluwatar/event/aggregator/ScoutTest.java  |  2 +-
 .../event/aggregator/WeekdayTest.java         |  2 +-
 event-asynchronous/pom.xml                    |  2 +-
 .../com/iluwatar/event/asynchronous/App.java  |  2 +-
 .../iluwatar/event/asynchronous/Event.java    |  2 +-
 .../EventDoesNotExistException.java           |  2 +-
 .../event/asynchronous/EventManager.java      |  2 +-
 .../iluwatar/event/asynchronous/IEvent.java   |  2 +-
 .../InvalidOperationException.java            |  2 +-
 .../LongRunningEventException.java            |  2 +-
 .../MaxNumOfEventsAllowedException.java       |  2 +-
 .../asynchronous/ThreadCompleteListener.java  |  2 +-
 .../src/main/resources/config.properties      |  2 +-
 .../iluwatar/event/asynchronous/AppTest.java  |  2 +-
 .../asynchronous/EventAsynchronousTest.java   |  2 +-
 event-driven-architecture/pom.xml             |  2 +-
 .../src/main/java/com/iluwatar/eda/App.java   |  2 +-
 .../com/iluwatar/eda/event/AbstractEvent.java |  2 +-
 .../iluwatar/eda/event/UserCreatedEvent.java  |  2 +-
 .../iluwatar/eda/event/UserUpdatedEvent.java  |  2 +-
 .../com/iluwatar/eda/framework/Event.java     |  2 +-
 .../eda/framework/EventDispatcher.java        |  2 +-
 .../com/iluwatar/eda/framework/Handler.java   |  2 +-
 .../eda/handler/UserCreatedEventHandler.java  |  2 +-
 .../eda/handler/UserUpdatedEventHandler.java  |  2 +-
 .../java/com/iluwatar/eda/model/User.java     |  2 +-
 .../test/java/com/iluwatar/eda/AppTest.java   |  2 +-
 .../eda/event/UserCreatedEventTest.java       |  2 +-
 .../eda/framework/EventDispatcherTest.java    |  2 +-
 event-queue/pom.xml                           |  2 +-
 .../java/com/iluwatar/event/queue/App.java    |  2 +-
 .../java/com/iluwatar/event/queue/Audio.java  |  2 +-
 .../com/iluwatar/event/queue/PlayMessage.java |  2 +-
 .../com/iluwatar/event/queue/AudioTest.java   |  2 +-
 event-sourcing/pom.xml                        |  2 +-
 .../com/iluwatar/event/sourcing/app/App.java  |  2 +-
 .../event/sourcing/domain/Account.java        |  2 +-
 .../sourcing/event/AccountCreateEvent.java    |  2 +-
 .../event/sourcing/event/DomainEvent.java     |  2 +-
 .../sourcing/event/MoneyDepositEvent.java     |  2 +-
 .../sourcing/event/MoneyTransferEvent.java    |  2 +-
 .../processor/DomainEventProcessor.java       |  2 +-
 .../sourcing/processor/JsonFileJournal.java   |  2 +-
 .../sourcing/state/AccountAggregate.java      |  2 +-
 .../src/test/java/IntegrationTest.java        |  2 +-
 execute-around/pom.xml                        |  2 +-
 .../java/com/iluwatar/execute/around/App.java |  2 +-
 .../execute/around/FileWriterAction.java      |  2 +-
 .../execute/around/SimpleFileWriter.java      |  2 +-
 .../com/iluwatar/execute/around/AppTest.java  |  2 +-
 .../execute/around/SimpleFileWriterTest.java  |  2 +-
 extension-objects/pom.xml                     |  2 +-
 extension-objects/src/main/java/App.java      |  2 +-
 .../CommanderExtension.java                   |  2 +-
 .../abstractextensions/SergeantExtension.java |  2 +-
 .../abstractextensions/SoldierExtension.java  |  2 +-
 .../abstractextensions/UnitExtension.java     |  2 +-
 .../java/concreteextensions/Commander.java    |  2 +-
 .../java/concreteextensions/Sergeant.java     |  2 +-
 .../main/java/concreteextensions/Soldier.java |  2 +-
 .../src/main/java/units/CommanderUnit.java    |  2 +-
 .../src/main/java/units/SergeantUnit.java     |  2 +-
 .../src/main/java/units/SoldierUnit.java      |  2 +-
 .../src/main/java/units/Unit.java             |  2 +-
 extension-objects/src/test/java/AppTest.java  |  2 +-
 .../concreteextensions/CommanderTest.java     |  2 +-
 .../java/concreteextensions/SergeantTest.java |  2 +-
 .../java/concreteextensions/SoldierTest.java  |  2 +-
 .../test/java/units/CommanderUnitTest.java    |  2 +-
 .../src/test/java/units/SergeantUnitTest.java |  2 +-
 .../src/test/java/units/SoldierUnitTest.java  |  2 +-
 .../src/test/java/units/UnitTest.java         |  2 +-
 facade/pom.xml                                |  2 +-
 .../main/java/com/iluwatar/facade/App.java    |  2 +-
 .../iluwatar/facade/DwarvenCartOperator.java  |  2 +-
 .../iluwatar/facade/DwarvenGoldDigger.java    |  2 +-
 .../facade/DwarvenGoldmineFacade.java         |  2 +-
 .../iluwatar/facade/DwarvenMineWorker.java    |  2 +-
 .../iluwatar/facade/DwarvenTunnelDigger.java  |  2 +-
 .../java/com/iluwatar/facade/AppTest.java     |  2 +-
 .../facade/DwarvenGoldmineFacadeTest.java     |  2 +-
 factory-kit/pom.xml                           |  2 +-
 .../java/com/iluwatar/factorykit/App.java     |  2 +-
 .../java/com/iluwatar/factorykit/Axe.java     |  2 +-
 .../java/com/iluwatar/factorykit/Bow.java     |  2 +-
 .../java/com/iluwatar/factorykit/Builder.java |  2 +-
 .../java/com/iluwatar/factorykit/Spear.java   |  2 +-
 .../java/com/iluwatar/factorykit/Sword.java   |  2 +-
 .../java/com/iluwatar/factorykit/Weapon.java  |  2 +-
 .../iluwatar/factorykit/WeaponFactory.java    |  2 +-
 .../com/iluwatar/factorykit/WeaponType.java   |  2 +-
 .../com/iluwatar/factorykit/app/AppTest.java  |  2 +-
 .../factorykit/factorykit/FactoryKitTest.java |  2 +-
 factory-method/pom.xml                        |  2 +-
 .../java/com/iluwatar/factory/method/App.java |  2 +-
 .../iluwatar/factory/method/Blacksmith.java   |  2 +-
 .../factory/method/ElfBlacksmith.java         |  2 +-
 .../iluwatar/factory/method/ElfWeapon.java    |  2 +-
 .../factory/method/OrcBlacksmith.java         |  2 +-
 .../iluwatar/factory/method/OrcWeapon.java    |  2 +-
 .../com/iluwatar/factory/method/Weapon.java   |  2 +-
 .../iluwatar/factory/method/WeaponType.java   |  2 +-
 .../com/iluwatar/factory/method/AppTest.java  |  2 +-
 .../factory/method/FactoryMethodTest.java     |  2 +-
 factory/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/factory/App.java   |  2 +-
 .../main/java/com/iluwatar/factory/Car.java   |  2 +-
 .../java/com/iluwatar/factory/CarType.java    |  2 +-
 .../com/iluwatar/factory/CarsFactory.java     |  2 +-
 .../java/com/iluwatar/factory/Ferrari.java    |  2 +-
 .../main/java/com/iluwatar/factory/Ford.java  |  2 +-
 .../java/com/iluwatar/factory/AppTest.java    |  2 +-
 .../com/iluwatar/factory/CarsFactoryTest.java |  2 +-
 feature-toggle/pom.xml                        |  2 +-
 .../java/com/iluwatar/featuretoggle/App.java  |  2 +-
 .../featuretoggle/pattern/Service.java        |  2 +-
 .../PropertiesFeatureToggleVersion.java       |  2 +-
 .../TieredFeatureToggleVersion.java           |  2 +-
 .../com/iluwatar/featuretoggle/user/User.java |  2 +-
 .../featuretoggle/user/UserGroup.java         |  2 +-
 .../PropertiesFeatureToggleVersionTest.java   |  2 +-
 .../TieredFeatureToggleVersionTest.java       |  2 +-
 .../featuretoggle/user/UserGroupTest.java     |  2 +-
 filterer/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/filterer/App.java  |  2 +-
 .../iluwatar/filterer/domain/Filterer.java    |  2 +-
 .../ProbabilisticThreatAwareSystem.java       |  2 +-
 .../filterer/threat/ProbableThreat.java       |  2 +-
 .../SimpleProbabilisticThreatAwareSystem.java |  2 +-
 .../filterer/threat/SimpleProbableThreat.java |  2 +-
 .../filterer/threat/SimpleThreat.java         |  2 +-
 .../threat/SimpleThreatAwareSystem.java       |  2 +-
 .../com/iluwatar/filterer/threat/Threat.java  |  2 +-
 .../filterer/threat/ThreatAwareSystem.java    |  2 +-
 .../iluwatar/filterer/threat/ThreatType.java  |  2 +-
 .../java/com/iluwatar/filterer/AppTest.java   |  2 +-
 ...pleProbabilisticThreatAwareSystemTest.java |  2 +-
 .../threat/SimpleThreatAwareSystemTest.java   |  2 +-
 fluentinterface/pom.xml                       |  2 +-
 .../com/iluwatar/fluentinterface/app/App.java |  2 +-
 .../fluentiterable/FluentIterable.java        |  2 +-
 .../lazy/DecoratingIterator.java              |  2 +-
 .../lazy/LazyFluentIterable.java              |  2 +-
 .../simple/SimpleFluentIterable.java          |  2 +-
 .../iluwatar/fluentinterface/app/AppTest.java |  2 +-
 .../fluentiterable/FluentIterableTest.java    |  2 +-
 .../lazy/LazyFluentIterableTest.java          |  2 +-
 .../simple/SimpleFluentIterableTest.java      |  2 +-
 flux/pom.xml                                  |  2 +-
 .../java/com/iluwatar/flux/action/Action.java |  2 +-
 .../com/iluwatar/flux/action/ActionType.java  |  2 +-
 .../com/iluwatar/flux/action/Content.java     |  2 +-
 .../iluwatar/flux/action/ContentAction.java   |  2 +-
 .../com/iluwatar/flux/action/MenuAction.java  |  2 +-
 .../com/iluwatar/flux/action/MenuItem.java    |  2 +-
 .../main/java/com/iluwatar/flux/app/App.java  |  2 +-
 .../iluwatar/flux/dispatcher/Dispatcher.java  |  2 +-
 .../com/iluwatar/flux/store/ContentStore.java |  2 +-
 .../com/iluwatar/flux/store/MenuStore.java    |  2 +-
 .../java/com/iluwatar/flux/store/Store.java   |  2 +-
 .../com/iluwatar/flux/view/ContentView.java   |  2 +-
 .../java/com/iluwatar/flux/view/MenuView.java |  2 +-
 .../java/com/iluwatar/flux/view/View.java     |  2 +-
 .../com/iluwatar/flux/action/ContentTest.java |  2 +-
 .../iluwatar/flux/action/MenuItemTest.java    |  2 +-
 .../java/com/iluwatar/flux/app/AppTest.java   |  2 +-
 .../flux/dispatcher/DispatcherTest.java       |  2 +-
 .../iluwatar/flux/store/ContentStoreTest.java |  2 +-
 .../iluwatar/flux/store/MenuStoreTest.java    |  2 +-
 .../iluwatar/flux/view/ContentViewTest.java   |  2 +-
 .../com/iluwatar/flux/view/MenuViewTest.java  |  2 +-
 flyweight/pom.xml                             |  2 +-
 .../com/iluwatar/flyweight/AlchemistShop.java |  2 +-
 .../main/java/com/iluwatar/flyweight/App.java |  2 +-
 .../com/iluwatar/flyweight/HealingPotion.java |  2 +-
 .../iluwatar/flyweight/HolyWaterPotion.java   |  2 +-
 .../flyweight/InvisibilityPotion.java         |  2 +-
 .../com/iluwatar/flyweight/PoisonPotion.java  |  2 +-
 .../java/com/iluwatar/flyweight/Potion.java   |  2 +-
 .../com/iluwatar/flyweight/PotionFactory.java |  2 +-
 .../com/iluwatar/flyweight/PotionType.java    |  2 +-
 .../iluwatar/flyweight/StrengthPotion.java    |  2 +-
 .../iluwatar/flyweight/AlchemistShopTest.java |  2 +-
 .../java/com/iluwatar/flyweight/AppTest.java  |  2 +-
 front-controller/pom.xml                      |  2 +-
 .../com/iluwatar/front/controller/App.java    |  2 +-
 .../controller/ApplicationException.java      |  2 +-
 .../front/controller/ArcherCommand.java       |  2 +-
 .../iluwatar/front/controller/ArcherView.java |  2 +-
 .../front/controller/CatapultCommand.java     |  2 +-
 .../front/controller/CatapultView.java        |  2 +-
 .../iluwatar/front/controller/Command.java    |  2 +-
 .../iluwatar/front/controller/ErrorView.java  |  2 +-
 .../front/controller/FrontController.java     |  2 +-
 .../front/controller/UnknownCommand.java      |  2 +-
 .../com/iluwatar/front/controller/View.java   |  2 +-
 .../iluwatar/front/controller/AppTest.java    |  2 +-
 .../controller/ApplicationExceptionTest.java  |  2 +-
 .../front/controller/CommandTest.java         |  2 +-
 .../front/controller/FrontControllerTest.java |  2 +-
 .../iluwatar/front/controller/ViewTest.java   |  2 +-
 .../controller/utils/InMemoryAppender.java    |  2 +-
 game-loop/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/gameloop/App.java  |  2 +-
 .../java/com/iluwatar/gameloop/Bullet.java    |  2 +-
 .../iluwatar/gameloop/FixedStepGameLoop.java  |  2 +-
 .../iluwatar/gameloop/FrameBasedGameLoop.java |  2 +-
 .../com/iluwatar/gameloop/GameController.java |  2 +-
 .../java/com/iluwatar/gameloop/GameLoop.java  |  2 +-
 .../com/iluwatar/gameloop/GameStatus.java     |  2 +-
 .../gameloop/VariableStepGameLoop.java        |  2 +-
 .../java/com/iluwatar/gameloop/AppTest.java   |  2 +-
 .../gameloop/FixedStepGameLoopTest.java       |  2 +-
 .../gameloop/FrameBasedGameLoopTest.java      |  2 +-
 .../iluwatar/gameloop/GameControllerTest.java |  2 +-
 .../com/iluwatar/gameloop/GameLoopTest.java   |  2 +-
 .../gameloop/VariableStepGameLoopTest.java    |  2 +-
 guarded-suspension/pom.xml                    |  2 +-
 .../com/iluwatar/guarded/suspension/App.java  |  2 +-
 .../guarded/suspension/GuardedQueue.java      |  2 +-
 .../guarded/suspension/GuardedQueueTest.java  |  2 +-
 half-sync-half-async/pom.xml                  |  2 +-
 .../com/iluwatar/halfsynchalfasync/App.java   |  2 +-
 .../iluwatar/halfsynchalfasync/AsyncTask.java |  2 +-
 .../AsynchronousService.java                  |  2 +-
 .../iluwatar/halfsynchalfasync/AppTest.java   |  2 +-
 .../AsynchronousServiceTest.java              |  2 +-
 hexagonal/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/hexagonal/App.java |  2 +-
 .../administration/ConsoleAdministration.java |  2 +-
 .../ConsoleAdministrationSrv.java             |  2 +-
 .../ConsoleAdministrationSrvImpl.java         |  2 +-
 .../hexagonal/banking/InMemoryBank.java       |  2 +-
 .../iluwatar/hexagonal/banking/MongoBank.java |  2 +-
 .../hexagonal/banking/WireTransfers.java      |  2 +-
 .../database/InMemoryTicketRepository.java    |  2 +-
 .../database/LotteryTicketRepository.java     |  2 +-
 .../database/MongoTicketRepository.java       |  2 +-
 .../domain/LotteryAdministration.java         |  2 +-
 .../hexagonal/domain/LotteryConstants.java    |  2 +-
 .../hexagonal/domain/LotteryNumbers.java      |  2 +-
 .../hexagonal/domain/LotteryService.java      |  2 +-
 .../hexagonal/domain/LotteryTicket.java       |  2 +-
 .../domain/LotteryTicketCheckResult.java      |  2 +-
 .../hexagonal/domain/LotteryTicketId.java     |  2 +-
 .../hexagonal/domain/LotteryUtils.java        |  2 +-
 .../hexagonal/domain/PlayerDetails.java       |  2 +-
 .../hexagonal/eventlog/LotteryEventLog.java   |  2 +-
 .../hexagonal/eventlog/MongoEventLog.java     |  2 +-
 .../hexagonal/eventlog/StdOutEventLog.java    |  2 +-
 .../hexagonal/module/LotteryModule.java       |  2 +-
 .../module/LotteryTestingModule.java          |  2 +-
 .../MongoConnectionPropertiesLoader.java      |  2 +-
 .../hexagonal/sampledata/SampleData.java      |  2 +-
 .../hexagonal/service/ConsoleLottery.java     |  2 +-
 .../service/LotteryConsoleService.java        |  2 +-
 .../service/LotteryConsoleServiceImpl.java    |  2 +-
 .../java/com/iluwatar/hexagonal/AppTest.java  |  2 +-
 .../hexagonal/banking/InMemoryBankTest.java   |  2 +-
 .../hexagonal/banking/MongoBankTest.java      |  2 +-
 .../InMemoryTicketRepositoryTest.java         |  2 +-
 .../database/MongoTicketRepositoryTest.java   |  2 +-
 .../hexagonal/domain/LotteryNumbersTest.java  |  2 +-
 .../hexagonal/domain/LotteryTest.java         |  2 +-
 .../domain/LotteryTicketCheckResultTest.java  |  2 +-
 .../hexagonal/domain/LotteryTicketIdTest.java |  2 +-
 .../hexagonal/domain/LotteryTicketTest.java   |  2 +-
 .../hexagonal/domain/PlayerDetailsTest.java   |  2 +-
 .../hexagonal/eventlog/MongoEventLogTest.java |  2 +-
 .../hexagonal/test/LotteryTestUtils.java      |  2 +-
 intercepting-filter/pom.xml                   |  2 +-
 .../intercepting/filter/AbstractFilter.java   |  2 +-
 .../intercepting/filter/AddressFilter.java    |  2 +-
 .../com/iluwatar/intercepting/filter/App.java |  2 +-
 .../iluwatar/intercepting/filter/Client.java  |  2 +-
 .../intercepting/filter/ContactFilter.java    |  2 +-
 .../intercepting/filter/DepositFilter.java    |  2 +-
 .../iluwatar/intercepting/filter/Filter.java  |  2 +-
 .../intercepting/filter/FilterChain.java      |  2 +-
 .../intercepting/filter/FilterManager.java    |  2 +-
 .../intercepting/filter/NameFilter.java       |  2 +-
 .../iluwatar/intercepting/filter/Order.java   |  2 +-
 .../intercepting/filter/OrderFilter.java      |  2 +-
 .../iluwatar/intercepting/filter/Target.java  |  2 +-
 .../iluwatar/intercepting/filter/AppTest.java |  2 +-
 .../filter/FilterManagerTest.java             |  2 +-
 .../intercepting/filter/FilterTest.java       |  2 +-
 .../intercepting/filter/OrderTest.java        |  2 +-
 interpreter/pom.xml                           |  2 +-
 .../java/com/iluwatar/interpreter/App.java    |  2 +-
 .../com/iluwatar/interpreter/Expression.java  |  2 +-
 .../iluwatar/interpreter/MinusExpression.java |  2 +-
 .../interpreter/MultiplyExpression.java       |  2 +-
 .../interpreter/NumberExpression.java         |  2 +-
 .../iluwatar/interpreter/PlusExpression.java  |  2 +-
 .../com/iluwatar/interpreter/AppTest.java     |  2 +-
 .../iluwatar/interpreter/ExpressionTest.java  |  2 +-
 .../interpreter/MinusExpressionTest.java      |  2 +-
 .../interpreter/MultiplyExpressionTest.java   |  2 +-
 .../interpreter/NumberExpressionTest.java     |  2 +-
 .../interpreter/PlusExpressionTest.java       |  2 +-
 iterator/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/iterator/App.java  |  2 +-
 .../java/com/iluwatar/iterator/Iterator.java  |  2 +-
 .../iluwatar/iterator/bst/BstIterator.java    |  2 +-
 .../com/iluwatar/iterator/bst/TreeNode.java   |  2 +-
 .../java/com/iluwatar/iterator/list/Item.java |  2 +-
 .../com/iluwatar/iterator/list/ItemType.java  |  2 +-
 .../iluwatar/iterator/list/TreasureChest.java |  2 +-
 .../list/TreasureChestItemIterator.java       |  2 +-
 .../java/com/iluwatar/iterator/AppTest.java   |  2 +-
 .../iterator/bst/BstIteratorTest.java         |  2 +-
 .../iterator/list/TreasureChestTest.java      |  2 +-
 layers/pom.xml                                |  2 +-
 .../java/com/iluwatar/layers/app/App.java     |  2 +-
 .../java/com/iluwatar/layers/dao/CakeDao.java |  2 +-
 .../com/iluwatar/layers/dao/CakeLayerDao.java |  2 +-
 .../iluwatar/layers/dao/CakeToppingDao.java   |  2 +-
 .../com/iluwatar/layers/dto/CakeInfo.java     |  2 +-
 .../iluwatar/layers/dto/CakeLayerInfo.java    |  2 +-
 .../iluwatar/layers/dto/CakeToppingInfo.java  |  2 +-
 .../java/com/iluwatar/layers/entity/Cake.java |  2 +-
 .../com/iluwatar/layers/entity/CakeLayer.java |  2 +-
 .../iluwatar/layers/entity/CakeTopping.java   |  2 +-
 .../layers/exception/CakeBakingException.java |  2 +-
 .../layers/service/CakeBakingService.java     |  2 +-
 .../layers/service/CakeBakingServiceImpl.java |  2 +-
 .../iluwatar/layers/view/CakeViewImpl.java    |  2 +-
 .../java/com/iluwatar/layers/view/View.java   |  2 +-
 .../main/resources/META-INF/persistence.xml   |  2 +-
 .../src/main/resources/applicationContext.xml |  2 +-
 layers/src/main/resources/logback.xml         |  2 +-
 .../java/com/iluwatar/layers/app/AppTest.java |  2 +-
 .../com/iluwatar/layers/entity/CakeTest.java  |  2 +-
 .../exception/CakeBakingExceptionTest.java    |  2 +-
 .../service/CakeBakingServiceImplTest.java    |  2 +-
 .../layers/view/CakeViewImplTest.java         |  2 +-
 lazy-loading/pom.xml                          |  2 +-
 .../java/com/iluwatar/lazy/loading/App.java   |  2 +-
 .../java/com/iluwatar/lazy/loading/Heavy.java |  2 +-
 .../iluwatar/lazy/loading/HolderNaive.java    |  2 +-
 .../lazy/loading/HolderThreadSafe.java        |  2 +-
 .../iluwatar/lazy/loading/Java8Holder.java    |  2 +-
 .../lazy/loading/AbstractHolderTest.java      |  2 +-
 .../com/iluwatar/lazy/loading/AppTest.java    |  2 +-
 .../lazy/loading/HolderNaiveTest.java         |  2 +-
 .../lazy/loading/HolderThreadSafeTest.java    |  2 +-
 .../lazy/loading/Java8HolderTest.java         |  2 +-
 leader-election/pom.xml                       |  2 +-
 .../leaderelection/AbstractInstance.java      |  2 +-
 .../AbstractMessageManager.java               |  2 +-
 .../com/iluwatar/leaderelection/Instance.java |  2 +-
 .../com/iluwatar/leaderelection/Message.java  |  2 +-
 .../leaderelection/MessageManager.java        |  2 +-
 .../iluwatar/leaderelection/MessageType.java  |  2 +-
 .../leaderelection/bully/BullyApp.java        |  2 +-
 .../leaderelection/bully/BullyInstance.java   |  2 +-
 .../bully/BullyMessageManager.java            |  2 +-
 .../iluwatar/leaderelection/ring/RingApp.java |  2 +-
 .../leaderelection/ring/RingInstance.java     |  2 +-
 .../ring/RingMessageManager.java              |  2 +-
 .../iluwatar/leaderelection/MessageTest.java  |  2 +-
 .../leaderelection/bully/BullyAppTest.java    |  2 +-
 .../bully/BullyMessageManagerTest.java        |  2 +-
 .../bully/BullyinstanceTest.java              |  2 +-
 .../leaderelection/ring/RingAppTest.java      |  2 +-
 .../leaderelection/ring/RingInstanceTest.java |  2 +-
 .../ring/RingMessageManagerTest.java          |  2 +-
 leader-followers/pom.xml                      |  2 +-
 .../com/iluwatar/leaderfollowers/App.java     |  2 +-
 .../com/iluwatar/leaderfollowers/Task.java    |  2 +-
 .../iluwatar/leaderfollowers/TaskHandler.java |  2 +-
 .../com/iluwatar/leaderfollowers/TaskSet.java |  2 +-
 .../iluwatar/leaderfollowers/WorkCenter.java  |  2 +-
 .../com/iluwatar/leaderfollowers/Worker.java  |  2 +-
 .../src/test/java/com/AppTest.java            |  2 +-
 .../src/test/java/com/TaskHandlerTest.java    |  2 +-
 .../src/test/java/com/TaskSetTest.java        |  2 +-
 .../src/test/java/com/WorkCenterTest.java     |  2 +-
 license-plugin-header-style.xml               |  2 +-
 marker/pom.xml                                |  2 +-
 marker/src/main/java/App.java                 |  2 +-
 marker/src/main/java/Guard.java               |  2 +-
 marker/src/main/java/Permission.java          |  2 +-
 marker/src/main/java/Thief.java               |  2 +-
 marker/src/test/java/AppTest.java             |  2 +-
 marker/src/test/java/GuardTest.java           |  2 +-
 marker/src/test/java/ThiefTest.java           |  2 +-
 master-worker-pattern/pom.xml                 |  2 +-
 .../java/com/iluwatar/masterworker/App.java   |  2 +-
 .../com/iluwatar/masterworker/ArrayInput.java |  2 +-
 .../iluwatar/masterworker/ArrayResult.java    |  2 +-
 .../masterworker/ArrayUtilityMethods.java     |  2 +-
 .../java/com/iluwatar/masterworker/Input.java |  2 +-
 .../com/iluwatar/masterworker/Result.java     |  2 +-
 .../system/ArrayTransposeMasterWorker.java    |  2 +-
 .../masterworker/system/MasterWorker.java     |  2 +-
 .../systemmaster/ArrayTransposeMaster.java    |  2 +-
 .../system/systemmaster/Master.java           |  2 +-
 .../systemworkers/ArrayTransposeWorker.java   |  2 +-
 .../system/systemworkers/Worker.java          |  2 +-
 .../iluwatar/masterworker/ArrayInputTest.java |  2 +-
 .../masterworker/ArrayUtilityMethodsTest.java |  2 +-
 .../ArrayTransposeMasterWorkerTest.java       |  2 +-
 .../ArrayTransposeWorkerTest.java             |  2 +-
 mediator/pom.xml                              |  2 +-
 .../java/com/iluwatar/mediator/Action.java    |  2 +-
 .../main/java/com/iluwatar/mediator/App.java  |  2 +-
 .../java/com/iluwatar/mediator/Hobbit.java    |  2 +-
 .../java/com/iluwatar/mediator/Hunter.java    |  2 +-
 .../java/com/iluwatar/mediator/Party.java     |  2 +-
 .../java/com/iluwatar/mediator/PartyImpl.java |  2 +-
 .../com/iluwatar/mediator/PartyMember.java    |  2 +-
 .../iluwatar/mediator/PartyMemberBase.java    |  2 +-
 .../java/com/iluwatar/mediator/Rogue.java     |  2 +-
 .../java/com/iluwatar/mediator/Wizard.java    |  2 +-
 .../java/com/iluwatar/mediator/AppTest.java   |  2 +-
 .../com/iluwatar/mediator/PartyImplTest.java  |  2 +-
 .../iluwatar/mediator/PartyMemberTest.java    |  2 +-
 memento/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/memento/App.java   |  2 +-
 .../main/java/com/iluwatar/memento/Star.java  |  2 +-
 .../com/iluwatar/memento/StarMemento.java     |  2 +-
 .../java/com/iluwatar/memento/StarType.java   |  2 +-
 .../java/com/iluwatar/memento/AppTest.java    |  2 +-
 .../java/com/iluwatar/memento/StarTest.java   |  2 +-
 model-view-controller/pom.xml                 |  2 +-
 .../iluwatar/model/view/controller/App.java   |  2 +-
 .../model/view/controller/Fatigue.java        |  2 +-
 .../view/controller/GiantController.java      |  2 +-
 .../model/view/controller/GiantModel.java     |  2 +-
 .../model/view/controller/GiantView.java      |  2 +-
 .../model/view/controller/Health.java         |  2 +-
 .../model/view/controller/Nourishment.java    |  2 +-
 .../model/view/controller/AppTest.java        |  2 +-
 .../view/controller/GiantControllerTest.java  |  2 +-
 .../model/view/controller/GiantModelTest.java |  2 +-
 .../model/view/controller/GiantViewTest.java  |  2 +-
 model-view-presenter/etc/data/test.txt        |  2 +-
 model-view-presenter/pom.xml                  |  2 +-
 .../iluwatar/model/view/presenter/App.java    |  2 +-
 .../model/view/presenter/FileLoader.java      |  2 +-
 .../view/presenter/FileSelectorJFrame.java    |  2 +-
 .../view/presenter/FileSelectorPresenter.java |  2 +-
 .../view/presenter/FileSelectorStub.java      |  2 +-
 .../view/presenter/FileSelectorView.java      |  2 +-
 .../model/view/presenter/AppTest.java         |  2 +-
 .../model/view/presenter/FileLoaderTest.java  |  2 +-
 .../presenter/FileSelectorPresenterTest.java  |  2 +-
 module/pom.xml                                |  2 +-
 .../main/java/com/iluwatar/module/App.java    |  2 +-
 .../iluwatar/module/ConsoleLoggerModule.java  |  2 +-
 .../com/iluwatar/module/FileLoggerModule.java |  2 +-
 .../java/com/iluwatar/module/AppTest.java     |  2 +-
 .../iluwatar/module/FileLoggerModuleTest.java |  2 +-
 monad/pom.xml                                 |  2 +-
 .../src/main/java/com/iluwatar/monad/App.java |  2 +-
 .../src/main/java/com/iluwatar/monad/Sex.java |  2 +-
 .../main/java/com/iluwatar/monad/User.java    |  2 +-
 .../java/com/iluwatar/monad/Validator.java    |  2 +-
 .../test/java/com/iluwatar/monad/AppTest.java |  2 +-
 .../java/com/iluwatar/monad/MonadTest.java    |  2 +-
 monostate/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/monostate/App.java |  2 +-
 .../com/iluwatar/monostate/LoadBalancer.java  |  2 +-
 .../java/com/iluwatar/monostate/Request.java  |  2 +-
 .../java/com/iluwatar/monostate/Server.java   |  2 +-
 .../java/com/iluwatar/monostate/AppTest.java  |  2 +-
 .../iluwatar/monostate/LoadBalancerTest.java  |  2 +-
 multiton/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/multiton/App.java  |  2 +-
 .../java/com/iluwatar/multiton/Nazgul.java    |  2 +-
 .../com/iluwatar/multiton/NazgulEnum.java     |  2 +-
 .../com/iluwatar/multiton/NazgulName.java     |  2 +-
 .../java/com/iluwatar/multiton/AppTest.java   |  2 +-
 .../com/iluwatar/multiton/NazgulEnumTest.java |  2 +-
 .../com/iluwatar/multiton/NazgulTest.java     |  2 +-
 mute-idiom/pom.xml                            |  2 +-
 .../src/main/java/com/iluwatar/mute/App.java  |  2 +-
 .../com/iluwatar/mute/CheckedRunnable.java    |  2 +-
 .../src/main/java/com/iluwatar/mute/Mute.java |  2 +-
 .../main/java/com/iluwatar/mute/Resource.java |  2 +-
 .../test/java/com/iluwatar/mute/AppTest.java  |  2 +-
 .../test/java/com/iluwatar/mute/MuteTest.java |  2 +-
 naked-objects/dom/pom.xml                     |  2 +-
 .../src/main/java/META-INF/persistence.xml    |  2 +-
 .../dom/app/homepage/HomePageService.java     |  2 +-
 .../dom/app/homepage/HomePageViewModel.java   |  2 +-
 .../dom/modules/simple/SimpleObject.java      |  2 +-
 .../dom/modules/simple/SimpleObjects.java     |  2 +-
 .../dom/modules/simple/SimpleObjectTest.java  |  2 +-
 .../dom/modules/simple/SimpleObjectsTest.java |  2 +-
 naked-objects/fixture/pom.xml                 |  2 +-
 .../fixture/DomainAppFixturesProvider.java    |  2 +-
 .../modules/simple/SimpleObjectCreate.java    |  2 +-
 .../modules/simple/SimpleObjectsTearDown.java |  2 +-
 .../scenarios/RecreateSimpleObjects.java      |  2 +-
 naked-objects/integtests/pom.xml              |  2 +-
 .../bootstrap/SimpleAppSystemInitializer.java |  2 +-
 .../specglue/BootstrappingGlue.java           |  2 +-
 .../specglue/CatalogOfFixturesGlue.java       |  2 +-
 .../modules/simple/SimpleObjectGlue.java      |  2 +-
 .../domainapp/integtests/specs/RunSpecs.java  |  2 +-
 .../integtests/tests/SimpleAppIntegTest.java  |  2 +-
 .../modules/simple/SimpleObjectIntegTest.java |  2 +-
 .../simple/SimpleObjectsIntegTest.java        |  2 +-
 naked-objects/pom.xml                         |  2 +-
 .../webapp/ide/intellij/launch/README.txt     |  2 +-
 .../intellij/launch/SimpleApp_PROTOTYPE.xml   |  2 +-
 .../launch/SimpleApp__enhance_only_.xml       |  2 +-
 naked-objects/webapp/pom.xml                  |  2 +-
 .../domainapp/webapp/SimpleApplication.java   |  2 +-
 .../resources/domainapp/webapp/welcome.html   |  2 +-
 .../src/main/webapp/WEB-INF/isis.properties   |  2 +-
 .../main/webapp/WEB-INF/persistor.properties  |  2 +-
 .../WEB-INF/persistor_datanucleus.properties  |  2 +-
 .../WEB-INF/viewer_restfulobjects.properties  |  2 +-
 .../webapp/WEB-INF/viewer_wicket.properties   |  2 +-
 .../webapp/src/main/webapp/WEB-INF/web.xml    |  2 +-
 .../webapp/src/main/webapp/about/index.html   |  2 +-
 .../src/main/webapp/css/application.css       |  2 +-
 .../src/main/webapp/scripts/application.js    |  2 +-
 null-object/pom.xml                           |  2 +-
 .../java/com/iluwatar/nullobject/App.java     |  2 +-
 .../java/com/iluwatar/nullobject/Node.java    |  2 +-
 .../com/iluwatar/nullobject/NodeImpl.java     |  2 +-
 .../com/iluwatar/nullobject/NullNode.java     |  2 +-
 .../java/com/iluwatar/nullobject/AppTest.java |  2 +-
 .../com/iluwatar/nullobject/NullNodeTest.java |  2 +-
 .../com/iluwatar/nullobject/TreeTest.java     |  2 +-
 object-mother/pom.xml                         |  2 +-
 .../java/com/iluwatar/objectmother/King.java  |  2 +-
 .../java/com/iluwatar/objectmother/Queen.java |  2 +-
 .../com/iluwatar/objectmother/Royalty.java    |  2 +-
 .../objectmother/RoyaltyObjectMother.java     |  2 +-
 .../test/RoyaltyObjectMotherTest.java         |  2 +-
 object-pool/pom.xml                           |  2 +-
 .../java/com/iluwatar/object/pool/App.java    |  2 +-
 .../com/iluwatar/object/pool/ObjectPool.java  |  2 +-
 .../com/iluwatar/object/pool/Oliphaunt.java   |  2 +-
 .../iluwatar/object/pool/OliphauntPool.java   |  2 +-
 .../com/iluwatar/object/pool/AppTest.java     |  2 +-
 .../object/pool/OliphauntPoolTest.java        |  2 +-
 observer/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/observer/App.java  |  2 +-
 .../java/com/iluwatar/observer/Hobbits.java   |  2 +-
 .../main/java/com/iluwatar/observer/Orcs.java |  2 +-
 .../java/com/iluwatar/observer/Weather.java   |  2 +-
 .../iluwatar/observer/WeatherObserver.java    |  2 +-
 .../com/iluwatar/observer/WeatherType.java    |  2 +-
 .../iluwatar/observer/generic/GHobbits.java   |  2 +-
 .../com/iluwatar/observer/generic/GOrcs.java  |  2 +-
 .../iluwatar/observer/generic/GWeather.java   |  2 +-
 .../iluwatar/observer/generic/Observable.java |  2 +-
 .../iluwatar/observer/generic/Observer.java   |  2 +-
 .../com/iluwatar/observer/generic/Race.java   |  2 +-
 .../java/com/iluwatar/observer/AppTest.java   |  2 +-
 .../com/iluwatar/observer/HobbitsTest.java    |  2 +-
 .../java/com/iluwatar/observer/OrcsTest.java  |  2 +-
 .../observer/WeatherObserverTest.java         |  2 +-
 .../com/iluwatar/observer/WeatherTest.java    |  2 +-
 .../observer/generic/GHobbitsTest.java        |  2 +-
 .../observer/generic/GWeatherTest.java        |  2 +-
 .../observer/generic/ObserverTest.java        |  2 +-
 .../iluwatar/observer/generic/OrcsTest.java   |  2 +-
 .../observer/utils/InMemoryAppender.java      |  2 +-
 page-object/pom.xml                           |  2 +-
 page-object/sample-application/pom.xml        |  2 +-
 .../java/com/iluwatar/pageobject/App.java     |  2 +-
 .../main/resources/sample-ui/album-list.html  |  2 +-
 .../main/resources/sample-ui/album-page.html  |  2 +-
 .../resources/sample-ui/css/album-list.css    |  2 +-
 .../main/resources/sample-ui/css/style.css    |  2 +-
 .../src/main/resources/sample-ui/login.html   |  2 +-
 .../java/com/iluwatar/pageobject/App.java     |  2 +-
 .../main/resources/sample-ui/album-list.html  |  2 +-
 .../main/resources/sample-ui/album-page.html  |  2 +-
 .../resources/sample-ui/css/album-list.css    |  2 +-
 .../main/resources/sample-ui/css/style.css    |  2 +-
 .../src/main/resources/sample-ui/login.html   |  2 +-
 .../pageobject/AlbumListPageTest.java         |  2 +-
 .../iluwatar/pageobject/AlbumPageTest.java    |  2 +-
 .../iluwatar/pageobject/LoginPageTest.java    |  2 +-
 .../pageobject/pages/AlbumListPage.java       |  2 +-
 .../iluwatar/pageobject/pages/AlbumPage.java  |  2 +-
 .../iluwatar/pageobject/pages/LoginPage.java  |  2 +-
 .../com/iluwatar/pageobject/pages/Page.java   |  2 +-
 page-object/test-automation/pom.xml           |  2 +-
 .../iluwatar/pageobject/AlbumListPage.java    |  2 +-
 .../com/iluwatar/pageobject/AlbumPage.java    |  2 +-
 .../com/iluwatar/pageobject/LoginPage.java    |  2 +-
 .../java/com/iluwatar/pageobject/Page.java    |  2 +-
 .../pageobject/AlbumListPageTest.java         |  2 +-
 .../iluwatar/pageobject/AlbumPageTest.java    |  2 +-
 .../iluwatar/pageobject/LoginPageTest.java    |  2 +-
 partial-response/pom.xml                      |  2 +-
 .../com/iluwatar/partialresponse/App.java     |  2 +-
 .../partialresponse/FieldJsonMapper.java      |  2 +-
 .../com/iluwatar/partialresponse/Video.java   |  2 +-
 .../partialresponse/VideoResource.java        |  2 +-
 .../com/iluwatar/partialresponse/AppTest.java |  2 +-
 .../partialresponse/FieldJsonMapperTest.java  |  2 +-
 .../partialresponse/VideoResourceTest.java    |  2 +-
 pipeline/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/pipeline/App.java  |  2 +-
 .../pipeline/ConvertToCharArrayHandler.java   |  2 +-
 .../java/com/iluwatar/pipeline/Handler.java   |  2 +-
 .../java/com/iluwatar/pipeline/Pipeline.java  |  2 +-
 .../pipeline/RemoveAlphabetsHandler.java      |  2 +-
 .../pipeline/RemoveDigitsHandler.java         |  2 +-
 .../java/com/iluwatar/pipeline/AppTest.java   |  2 +-
 .../com/iluwatar/pipeline/PipelineTest.java   |  2 +-
 poison-pill/pom.xml                           |  2 +-
 .../java/com/iluwatar/poison/pill/App.java    |  2 +-
 .../com/iluwatar/poison/pill/Consumer.java    |  2 +-
 .../com/iluwatar/poison/pill/Message.java     |  2 +-
 .../iluwatar/poison/pill/MessageQueue.java    |  2 +-
 .../iluwatar/poison/pill/MqPublishPoint.java  |  2 +-
 .../poison/pill/MqSubscribePoint.java         |  2 +-
 .../com/iluwatar/poison/pill/Producer.java    |  2 +-
 .../iluwatar/poison/pill/SimpleMessage.java   |  2 +-
 .../poison/pill/SimpleMessageQueue.java       |  2 +-
 .../com/iluwatar/poison/pill/AppTest.java     |  2 +-
 .../iluwatar/poison/pill/ConsumerTest.java    |  2 +-
 .../poison/pill/PoisonMessageTest.java        |  2 +-
 .../iluwatar/poison/pill/ProducerTest.java    |  2 +-
 .../poison/pill/SimpleMessageTest.java        |  2 +-
 pom.xml                                       | 41 +++++++++++-------
 priority-queue/pom.xml                        |  2 +-
 .../iluwatar/priority/queue/Application.java  |  2 +-
 .../com/iluwatar/priority/queue/Message.java  |  2 +-
 .../priority/queue/PriorityMessageQueue.java  |  2 +-
 .../iluwatar/priority/queue/QueueManager.java |  2 +-
 .../com/iluwatar/priority/queue/Worker.java   |  2 +-
 .../queue/PriorityMessageQueueTest.java       |  2 +-
 .../priority/queue/QueueManagerTest.java      |  2 +-
 private-class-data/pom.xml                    |  2 +-
 .../com/iluwatar/privateclassdata/App.java    |  2 +-
 .../privateclassdata/ImmutableStew.java       |  2 +-
 .../com/iluwatar/privateclassdata/Stew.java   |  2 +-
 .../iluwatar/privateclassdata/StewData.java   |  2 +-
 .../iluwatar/privateclassdata/AppTest.java    |  2 +-
 .../privateclassdata/ImmutableStewTest.java   |  2 +-
 .../iluwatar/privateclassdata/StewTest.java   |  2 +-
 .../utils/InMemoryAppender.java               |  2 +-
 producer-consumer/pom.xml                     |  2 +-
 .../com/iluwatar/producer/consumer/App.java   |  2 +-
 .../iluwatar/producer/consumer/Consumer.java  |  2 +-
 .../com/iluwatar/producer/consumer/Item.java  |  2 +-
 .../iluwatar/producer/consumer/ItemQueue.java |  2 +-
 .../iluwatar/producer/consumer/Producer.java  |  2 +-
 .../iluwatar/producer/consumer/AppTest.java   |  2 +-
 .../producer/consumer/ConsumerTest.java       |  2 +-
 .../producer/consumer/ProducerTest.java       |  2 +-
 promise/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/promise/App.java   |  2 +-
 .../java/com/iluwatar/promise/Promise.java    |  2 +-
 .../com/iluwatar/promise/PromiseSupport.java  |  2 +-
 .../java/com/iluwatar/promise/Utility.java    |  2 +-
 .../java/com/iluwatar/promise/AppTest.java    |  2 +-
 .../com/iluwatar/promise/PromiseTest.java     |  2 +-
 property/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/property/App.java  |  2 +-
 .../java/com/iluwatar/property/Character.java |  2 +-
 .../java/com/iluwatar/property/Prototype.java |  2 +-
 .../java/com/iluwatar/property/Stats.java     |  2 +-
 .../java/com/iluwatar/property/AppTest.java   |  2 +-
 .../com/iluwatar/property/CharacterTest.java  |  2 +-
 prototype/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/prototype/App.java |  2 +-
 .../java/com/iluwatar/prototype/Beast.java    |  2 +-
 .../java/com/iluwatar/prototype/ElfBeast.java |  2 +-
 .../java/com/iluwatar/prototype/ElfMage.java  |  2 +-
 .../com/iluwatar/prototype/ElfWarlord.java    |  2 +-
 .../com/iluwatar/prototype/HeroFactory.java   |  2 +-
 .../iluwatar/prototype/HeroFactoryImpl.java   |  2 +-
 .../java/com/iluwatar/prototype/Mage.java     |  2 +-
 .../java/com/iluwatar/prototype/OrcBeast.java |  2 +-
 .../java/com/iluwatar/prototype/OrcMage.java  |  2 +-
 .../com/iluwatar/prototype/OrcWarlord.java    |  2 +-
 .../com/iluwatar/prototype/Prototype.java     |  2 +-
 .../java/com/iluwatar/prototype/Warlord.java  |  2 +-
 .../java/com/iluwatar/prototype/AppTest.java  |  2 +-
 .../com/iluwatar/prototype/PrototypeTest.java |  2 +-
 proxy/pom.xml                                 |  2 +-
 .../src/main/java/com/iluwatar/proxy/App.java |  2 +-
 .../java/com/iluwatar/proxy/IvoryTower.java   |  2 +-
 .../main/java/com/iluwatar/proxy/Wizard.java  |  2 +-
 .../java/com/iluwatar/proxy/WizardTower.java  |  2 +-
 .../com/iluwatar/proxy/WizardTowerProxy.java  |  2 +-
 .../test/java/com/iluwatar/proxy/AppTest.java |  2 +-
 .../com/iluwatar/proxy/IvoryTowerTest.java    |  2 +-
 .../java/com/iluwatar/proxy/WizardTest.java   |  2 +-
 .../iluwatar/proxy/WizardTowerProxyTest.java  |  2 +-
 .../proxy/utils/InMemoryAppender.java         |  2 +-
 queue-load-leveling/pom.xml                   |  2 +-
 .../com/iluwatar/queue/load/leveling/App.java |  2 +-
 .../iluwatar/queue/load/leveling/Message.java |  2 +-
 .../queue/load/leveling/MessageQueue.java     |  2 +-
 .../queue/load/leveling/ServiceExecutor.java  |  2 +-
 .../iluwatar/queue/load/leveling/Task.java    |  2 +-
 .../queue/load/leveling/TaskGenerator.java    |  2 +-
 .../iluwatar/queue/load/leveling/AppTest.java |  2 +-
 .../queue/load/leveling/MessageQueueTest.java |  2 +-
 .../queue/load/leveling/MessageTest.java      |  2 +-
 .../load/leveling/TaskGenSrvExeTest.java      |  2 +-
 reactor/pom.xml                               |  2 +-
 .../java/com/iluwatar/reactor/app/App.java    |  2 +-
 .../com/iluwatar/reactor/app/AppClient.java   |  2 +-
 .../iluwatar/reactor/app/LoggingHandler.java  |  2 +-
 .../reactor/framework/AbstractNioChannel.java |  2 +-
 .../reactor/framework/ChannelHandler.java     |  2 +-
 .../reactor/framework/Dispatcher.java         |  2 +-
 .../reactor/framework/NioDatagramChannel.java |  2 +-
 .../reactor/framework/NioReactor.java         |  2 +-
 .../framework/NioServerSocketChannel.java     |  2 +-
 .../framework/SameThreadDispatcher.java       |  2 +-
 .../framework/ThreadPoolDispatcher.java       |  2 +-
 .../com/iluwatar/reactor/app/ReactorTest.java |  2 +-
 reader-writer-lock/pom.xml                    |  2 +-
 .../com/iluwatar/reader/writer/lock/App.java  |  2 +-
 .../iluwatar/reader/writer/lock/Reader.java   |  2 +-
 .../reader/writer/lock/ReaderWriterLock.java  |  2 +-
 .../iluwatar/reader/writer/lock/Writer.java   |  2 +-
 .../iluwatar/reader/writer/lock/AppTest.java  |  2 +-
 .../writer/lock/ReaderAndWriterTest.java      |  2 +-
 .../reader/writer/lock/ReaderTest.java        |  2 +-
 .../reader/writer/lock/WriterTest.java        |  2 +-
 .../writer/lock/utils/InMemoryAppender.java   |  2 +-
 registry/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/registry/App.java  |  2 +-
 .../java/com/iluwatar/registry/Customer.java  |  2 +-
 .../iluwatar/registry/CustomerRegistry.java   |  2 +-
 .../registry/CustomerRegistryTest.java        |  2 +-
 repository/pom.xml                            |  2 +-
 .../java/com/iluwatar/repository/App.java     |  2 +-
 .../com/iluwatar/repository/AppConfig.java    |  2 +-
 .../java/com/iluwatar/repository/Person.java  |  2 +-
 .../iluwatar/repository/PersonRepository.java |  2 +-
 .../repository/PersonSpecifications.java      |  2 +-
 .../main/resources/META-INF/persistence.xml   |  2 +-
 .../src/main/resources/applicationContext.xml |  2 +-
 repository/src/main/resources/logback.xml     |  2 +-
 .../AnnotationBasedRepositoryTest.java        |  2 +-
 .../iluwatar/repository/AppConfigTest.java    |  2 +-
 .../java/com/iluwatar/repository/AppTest.java |  2 +-
 .../iluwatar/repository/RepositoryTest.java   |  2 +-
 .../pom.xml                                   |  2 +-
 .../acquisition/is/initialization/App.java    |  2 +-
 .../is/initialization/SlidingDoor.java        |  2 +-
 .../is/initialization/TreasureChest.java      |  2 +-
 .../is/initialization/AppTest.java            |  2 +-
 .../is/initialization/ClosableTest.java       |  2 +-
 retry/pom.xml                                 |  2 +-
 .../src/main/java/com/iluwatar/retry/App.java |  2 +-
 .../com/iluwatar/retry/BusinessException.java |  2 +-
 .../com/iluwatar/retry/BusinessOperation.java |  2 +-
 .../retry/CustomerNotFoundException.java      |  2 +-
 .../retry/DatabaseNotAvailableException.java  |  2 +-
 .../java/com/iluwatar/retry/FindCustomer.java |  2 +-
 .../main/java/com/iluwatar/retry/Retry.java   |  2 +-
 .../retry/RetryExponentialBackoff.java        |  2 +-
 .../com/iluwatar/retry/FindCustomerTest.java  |  2 +-
 .../retry/RetryExponentialBackoffTest.java    |  2 +-
 .../java/com/iluwatar/retry/RetryTest.java    |  2 +-
 role-object/pom.xml                           |  2 +-
 .../roleobject/ApplicationRoleObject.java     |  2 +-
 .../com/iluwatar/roleobject/BorrowerRole.java |  2 +-
 .../com/iluwatar/roleobject/Customer.java     |  2 +-
 .../com/iluwatar/roleobject/CustomerCore.java |  2 +-
 .../com/iluwatar/roleobject/CustomerRole.java |  2 +-
 .../com/iluwatar/roleobject/InvestorRole.java |  2 +-
 .../java/com/iluwatar/roleobject/Role.java    |  2 +-
 .../roleobject/ApplicationRoleObjectTest.java |  3 +-
 .../iluwatar/roleobject/BorrowerRoleTest.java |  3 +-
 .../iluwatar/roleobject/CustomerCoreTest.java |  3 +-
 .../iluwatar/roleobject/InvestorRoleTest.java |  3 +-
 .../com/iluwatar/roleobject/RoleTest.java     |  3 +-
 saga/pom.xml                                  |  2 +-
 .../choreography/ChoreographyChapter.java     |  2 +-
 .../saga/choreography/FlyBookingService.java  |  2 +-
 .../choreography/HotelBookingService.java     |  2 +-
 .../saga/choreography/OrderService.java       |  2 +-
 .../com/iluwatar/saga/choreography/Saga.java  |  2 +-
 .../saga/choreography/SagaApplication.java    |  2 +-
 .../iluwatar/saga/choreography/Service.java   |  2 +-
 .../choreography/ServiceDiscoveryService.java |  2 +-
 .../choreography/WithdrawMoneyService.java    |  2 +-
 .../saga/orchestration/ChapterResult.java     |  2 +-
 .../saga/orchestration/FlyBookingService.java |  2 +-
 .../orchestration/HotelBookingService.java    |  2 +-
 .../orchestration/OrchestrationChapter.java   |  2 +-
 .../saga/orchestration/OrderService.java      |  2 +-
 .../com/iluwatar/saga/orchestration/Saga.java |  2 +-
 .../saga/orchestration/SagaApplication.java   |  2 +-
 .../saga/orchestration/SagaOrchestrator.java  |  2 +-
 .../iluwatar/saga/orchestration/Service.java  |  2 +-
 .../ServiceDiscoveryService.java              |  2 +-
 .../orchestration/WithdrawMoneyService.java   |  2 +-
 .../choreography/SagaApplicationTest.java     |  3 +-
 .../choreography/SagaChoreographyTest.java    |  3 +-
 .../orchestration/SagaApplicationTest.java    |  3 +-
 .../SagaOrchestratorInternallyTest.java       |  3 +-
 .../orchestration/SagaOrchestratorTest.java   |  3 +-
 separated-interface/pom.xml                   |  2 +-
 .../com/iluwatar/separatedinterface/App.java  |  2 +-
 .../invoice/InvoiceGenerator.java             |  2 +-
 .../invoice/TaxCalculator.java                |  2 +-
 .../taxes/DomesticTaxCalculator.java          |  2 +-
 .../taxes/ForeignTaxCalculator.java           |  2 +-
 .../iluwatar/separatedinterface/AppTest.java  |  2 +-
 .../invoice/InvoiceGeneratorTest.java         |  2 +-
 .../taxes/DomesticTaxCalculatorTest.java      |  2 +-
 .../taxes/ForeignTaxCalculatorTest.java       |  2 +-
 servant/pom.xml                               |  2 +-
 servant/src/etc/servant.xml                   |  2 +-
 .../main/java/com/iluwatar/servant/App.java   |  2 +-
 .../main/java/com/iluwatar/servant/King.java  |  2 +-
 .../main/java/com/iluwatar/servant/Queen.java |  2 +-
 .../java/com/iluwatar/servant/Royalty.java    |  2 +-
 .../java/com/iluwatar/servant/Servant.java    |  2 +-
 .../java/com/iluwatar/servant/AppTest.java    |  2 +-
 .../java/com/iluwatar/servant/KingTest.java   |  2 +-
 .../java/com/iluwatar/servant/QueenTest.java  |  2 +-
 .../com/iluwatar/servant/ServantTest.java     |  2 +-
 serverless/pom.xml                            |  2 +-
 serverless/serverless.yml                     |  2 +-
 .../baas/api/AbstractDynamoDbHandler.java     |  2 +-
 .../baas/api/FindPersonApiHandler.java        |  2 +-
 .../baas/api/SavePersonApiHandler.java        |  2 +-
 .../serverless/baas/model/Address.java        |  2 +-
 .../serverless/baas/model/Person.java         |  2 +-
 .../serverless/faas/ApiGatewayResponse.java   |  2 +-
 .../iluwatar/serverless/faas/LambdaInfo.java  |  2 +-
 .../faas/api/LambdaInfoApiHandler.java        |  2 +-
 .../baas/api/FindPersonApiHandlerTest.java    |  2 +-
 .../baas/api/SavePersonApiHandlerTest.java    |  2 +-
 .../faas/api/LambdaInfoApiHandlerTest.java    |  2 +-
 service-layer/pom.xml                         |  2 +-
 .../com/iluwatar/servicelayer/app/App.java    |  2 +-
 .../servicelayer/common/BaseEntity.java       |  2 +-
 .../com/iluwatar/servicelayer/common/Dao.java |  2 +-
 .../servicelayer/common/DaoBaseImpl.java      |  2 +-
 .../servicelayer/hibernate/HibernateUtil.java |  2 +-
 .../servicelayer/magic/MagicService.java      |  2 +-
 .../servicelayer/magic/MagicServiceImpl.java  |  2 +-
 .../iluwatar/servicelayer/spell/Spell.java    |  2 +-
 .../iluwatar/servicelayer/spell/SpellDao.java |  2 +-
 .../servicelayer/spell/SpellDaoImpl.java      |  2 +-
 .../servicelayer/spellbook/Spellbook.java     |  2 +-
 .../servicelayer/spellbook/SpellbookDao.java  |  2 +-
 .../spellbook/SpellbookDaoImpl.java           |  2 +-
 .../iluwatar/servicelayer/wizard/Wizard.java  |  2 +-
 .../servicelayer/wizard/WizardDao.java        |  2 +-
 .../servicelayer/wizard/WizardDaoImpl.java    |  2 +-
 service-layer/src/main/resources/logback.xml  |  2 +-
 .../iluwatar/servicelayer/app/AppTest.java    |  2 +-
 .../servicelayer/common/BaseDaoTest.java      |  2 +-
 .../magic/MagicServiceImplTest.java           |  2 +-
 .../servicelayer/spell/SpellDaoImplTest.java  |  2 +-
 .../spellbook/SpellbookDaoImplTest.java       |  2 +-
 .../wizard/WizardDaoImplTest.java             |  2 +-
 service-locator/pom.xml                       |  2 +-
 .../java/com/iluwatar/servicelocator/App.java |  2 +-
 .../iluwatar/servicelocator/InitContext.java  |  2 +-
 .../com/iluwatar/servicelocator/Service.java  |  2 +-
 .../iluwatar/servicelocator/ServiceCache.java |  2 +-
 .../iluwatar/servicelocator/ServiceImpl.java  |  2 +-
 .../servicelocator/ServiceLocator.java        |  2 +-
 .../com/iluwatar/servicelocator/AppTest.java  |  2 +-
 .../servicelocator/ServiceLocatorTest.java    |  2 +-
 sharding/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/sharding/App.java  |  2 +-
 .../main/java/com/iluwatar/sharding/Data.java |  2 +-
 .../iluwatar/sharding/HashShardManager.java   |  2 +-
 .../iluwatar/sharding/LookupShardManager.java |  2 +-
 .../iluwatar/sharding/RangeShardManager.java  |  2 +-
 .../java/com/iluwatar/sharding/Shard.java     |  2 +-
 .../com/iluwatar/sharding/ShardManager.java   |  2 +-
 .../java/com/iluwatar/sharding/AppTest.java   |  2 +-
 .../sharding/HashShardManagerTest.java        |  2 +-
 .../sharding/LookupShardManagerTest.java      |  2 +-
 .../sharding/RangeShardManagerTest.java       |  2 +-
 .../iluwatar/sharding/ShardManagerTest.java   |  2 +-
 .../java/com/iluwatar/sharding/ShardTest.java |  2 +-
 singleton/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/singleton/App.java |  2 +-
 .../iluwatar/singleton/EnumIvoryTower.java    |  2 +-
 .../InitializingOnDemandHolderIdiom.java      |  2 +-
 .../com/iluwatar/singleton/IvoryTower.java    |  2 +-
 .../ThreadSafeDoubleCheckLocking.java         |  2 +-
 .../ThreadSafeLazyLoadedIvoryTower.java       |  2 +-
 .../java/com/iluwatar/singleton/AppTest.java  |  2 +-
 .../singleton/EnumIvoryTowerTest.java         |  2 +-
 .../InitializingOnDemandHolderIdiomTest.java  |  2 +-
 .../iluwatar/singleton/IvoryTowerTest.java    |  2 +-
 .../com/iluwatar/singleton/SingletonTest.java |  2 +-
 .../ThreadSafeDoubleCheckLockingTest.java     |  2 +-
 .../ThreadSafeLazyLoadedIvoryTowerTest.java   |  2 +-
 spatial-partition/pom.xml                     |  2 +-
 .../com/iluwatar/spatialpartition/App.java    |  2 +-
 .../com/iluwatar/spatialpartition/Bubble.java |  2 +-
 .../com/iluwatar/spatialpartition/Point.java  |  2 +-
 .../iluwatar/spatialpartition/QuadTree.java   |  2 +-
 .../com/iluwatar/spatialpartition/Rect.java   |  2 +-
 .../SpatialPartitionBubbles.java              |  2 +-
 .../SpatialPartitionGeneric.java              |  2 +-
 .../iluwatar/spatialpartition/BubbleTest.java |  2 +-
 .../spatialpartition/QuadTreeTest.java        |  2 +-
 .../iluwatar/spatialpartition/RectTest.java   |  2 +-
 .../SpatialPartitionBubblesTest.java          |  2 +-
 special-case/pom.xml                          |  2 +-
 .../java/com/iluwatar/specialcase/App.java    |  2 +-
 .../specialcase/ApplicationServices.java      |  2 +-
 .../specialcase/ApplicationServicesImpl.java  |  2 +-
 .../java/com/iluwatar/specialcase/Db.java     |  2 +-
 .../iluwatar/specialcase/DomainServices.java  |  2 +-
 .../specialcase/DomainServicesImpl.java       |  2 +-
 .../specialcase/DownForMaintenance.java       |  2 +-
 .../specialcase/InsufficientFunds.java        |  2 +-
 .../com/iluwatar/specialcase/InvalidUser.java |  2 +-
 .../iluwatar/specialcase/MaintenanceLock.java |  2 +-
 .../specialcase/MoneyTransaction.java         |  2 +-
 .../com/iluwatar/specialcase/OutOfStock.java  |  2 +-
 .../com/iluwatar/specialcase/ReceiptDto.java  |  2 +-
 .../specialcase/ReceiptViewModel.java         |  2 +-
 .../com/iluwatar/specialcase/AppTest.java     |  2 +-
 .../specialcase/SpecialCasesTest.java         |  2 +-
 specification/pom.xml                         |  2 +-
 .../com/iluwatar/specification/app/App.java   |  2 +-
 .../creature/AbstractCreature.java            |  2 +-
 .../specification/creature/Creature.java      |  2 +-
 .../specification/creature/Dragon.java        |  2 +-
 .../specification/creature/Goblin.java        |  2 +-
 .../specification/creature/KillerBee.java     |  2 +-
 .../specification/creature/Octopus.java       |  2 +-
 .../specification/creature/Shark.java         |  2 +-
 .../specification/creature/Troll.java         |  2 +-
 .../specification/property/Color.java         |  2 +-
 .../iluwatar/specification/property/Mass.java |  2 +-
 .../specification/property/Movement.java      |  2 +-
 .../iluwatar/specification/property/Size.java |  2 +-
 .../selector/AbstractSelector.java            |  2 +-
 .../specification/selector/ColorSelector.java |  2 +-
 .../selector/ConjunctionSelector.java         |  2 +-
 .../selector/DisjunctionSelector.java         |  2 +-
 .../selector/MassEqualSelector.java           |  2 +-
 .../selector/MassGreaterThanSelector.java     |  2 +-
 .../selector/MassSmallerThanOrEqSelector.java |  2 +-
 .../selector/MovementSelector.java            |  2 +-
 .../selector/NegationSelector.java            |  2 +-
 .../specification/selector/SizeSelector.java  |  2 +-
 .../iluwatar/specification/app/AppTest.java   |  2 +-
 .../specification/creature/CreatureTest.java  |  2 +-
 .../selector/ColorSelectorTest.java           |  2 +-
 .../selector/CompositeSelectorsTest.java      |  2 +-
 .../selector/MassSelectorTest.java            |  2 +-
 .../selector/MovementSelectorTest.java        |  2 +-
 .../selector/SizeSelectorTest.java            |  2 +-
 state/pom.xml                                 |  2 +-
 .../java/com/iluwatar/state/AngryState.java   |  2 +-
 .../src/main/java/com/iluwatar/state/App.java |  2 +-
 .../main/java/com/iluwatar/state/Mammoth.java |  2 +-
 .../com/iluwatar/state/PeacefulState.java     |  2 +-
 .../main/java/com/iluwatar/state/State.java   |  2 +-
 .../test/java/com/iluwatar/state/AppTest.java |  2 +-
 .../java/com/iluwatar/state/MammothTest.java  |  2 +-
 step-builder/pom.xml                          |  2 +-
 .../java/com/iluwatar/stepbuilder/App.java    |  2 +-
 .../com/iluwatar/stepbuilder/Character.java   |  2 +-
 .../stepbuilder/CharacterStepBuilder.java     |  2 +-
 .../com/iluwatar/stepbuilder/AppTest.java     |  2 +-
 .../stepbuilder/CharacterStepBuilderTest.java |  2 +-
 strangler/pom.xml                             |  2 +-
 .../main/java/com/iluwatar/strangler/App.java |  2 +-
 .../iluwatar/strangler/HalfArithmetic.java    |  2 +-
 .../com/iluwatar/strangler/HalfSource.java    |  2 +-
 .../com/iluwatar/strangler/NewArithmetic.java |  2 +-
 .../com/iluwatar/strangler/NewSource.java     |  2 +-
 .../com/iluwatar/strangler/OldArithmetic.java |  2 +-
 .../com/iluwatar/strangler/OldSource.java     |  2 +-
 .../java/com/iluwatar/strangler/AppTest.java  |  2 +-
 .../strangler/HalfArithmeticTest.java         |  2 +-
 .../iluwatar/strangler/HalfSourceTest.java    |  2 +-
 .../iluwatar/strangler/NewArithmeticTest.java |  2 +-
 .../com/iluwatar/strangler/NewSourceTest.java |  2 +-
 .../iluwatar/strangler/OldArithmeticTest.java |  2 +-
 .../com/iluwatar/strangler/OldSourceTest.java |  2 +-
 strategy/pom.xml                              |  2 +-
 .../main/java/com/iluwatar/strategy/App.java  |  2 +-
 .../com/iluwatar/strategy/DragonSlayer.java   |  2 +-
 .../strategy/DragonSlayingStrategy.java       |  2 +-
 .../com/iluwatar/strategy/LambdaStrategy.java |  2 +-
 .../com/iluwatar/strategy/MeleeStrategy.java  |  2 +-
 .../iluwatar/strategy/ProjectileStrategy.java |  2 +-
 .../com/iluwatar/strategy/SpellStrategy.java  |  2 +-
 .../java/com/iluwatar/strategy/AppTest.java   |  2 +-
 .../iluwatar/strategy/DragonSlayerTest.java   |  2 +-
 .../strategy/DragonSlayingStrategyTest.java   |  2 +-
 subclass-sandbox/pom.xml                      |  2 +-
 .../com/iluwatar/subclasssandbox/App.java     |  2 +-
 .../iluwatar/subclasssandbox/GroundDive.java  |  2 +-
 .../iluwatar/subclasssandbox/SkyLaunch.java   |  2 +-
 .../iluwatar/subclasssandbox/Superpower.java  |  2 +-
 .../com/iluwatar/subclasssandbox/AppTest.java |  2 +-
 .../subclasssandbox/GroundDiveTest.java       |  2 +-
 .../subclasssandbox/SkyLaunchTest.java        |  2 +-
 template-method/pom.xml                       |  2 +-
 .../java/com/iluwatar/templatemethod/App.java |  2 +-
 .../templatemethod/HalflingThief.java         |  2 +-
 .../templatemethod/HitAndRunMethod.java       |  2 +-
 .../templatemethod/StealingMethod.java        |  2 +-
 .../iluwatar/templatemethod/SubtleMethod.java |  2 +-
 .../com/iluwatar/templatemethod/AppTest.java  |  2 +-
 .../templatemethod/HalflingThiefTest.java     |  2 +-
 .../templatemethod/HitAndRunMethodTest.java   |  2 +-
 .../templatemethod/StealingMethodTest.java    |  2 +-
 .../templatemethod/SubtleMethodTest.java      |  2 +-
 thread-pool/pom.xml                           |  2 +-
 .../java/com/iluwatar/threadpool/App.java     |  2 +-
 .../iluwatar/threadpool/CoffeeMakingTask.java |  2 +-
 .../threadpool/PotatoPeelingTask.java         |  2 +-
 .../java/com/iluwatar/threadpool/Task.java    |  2 +-
 .../java/com/iluwatar/threadpool/Worker.java  |  2 +-
 .../java/com/iluwatar/threadpool/AppTest.java |  2 +-
 .../threadpool/CoffeeMakingTaskTest.java      |  2 +-
 .../threadpool/PotatoPeelingTaskTest.java     |  2 +-
 .../com/iluwatar/threadpool/TaskTest.java     |  2 +-
 .../com/iluwatar/threadpool/WorkerTest.java   |  2 +-
 throttling/pom.xml                            |  2 +-
 .../java/com/iluwatar/throttling/App.java     |  2 +-
 .../com/iluwatar/throttling/B2BService.java   |  2 +-
 .../com/iluwatar/throttling/CallsCount.java   |  2 +-
 .../java/com/iluwatar/throttling/Tenant.java  |  2 +-
 .../throttling/timer/ThrottleTimerImpl.java   |  2 +-
 .../iluwatar/throttling/timer/Throttler.java  |  2 +-
 .../java/com/iluwatar/throttling/AppTest.java |  2 +-
 .../iluwatar/throttling/B2BServiceTest.java   |  2 +-
 .../com/iluwatar/throttling/TenantTest.java   |  2 +-
 tls/pom.xml                                   |  2 +-
 tls/src/main/java/com/iluwatar/tls/App.java   |  2 +-
 .../com/iluwatar/tls/DateFormatCallable.java  |  2 +-
 .../main/java/com/iluwatar/tls/Result.java    |  2 +-
 .../test/java/com/iluwatar/tls/AppTest.java   |  2 +-
 .../iluwatar/tls/DateFormatCallableTest.java  |  2 +-
 ...FormatCallableTestIncorrectDateFormat.java |  2 +-
 .../DateFormatCallableTestMultiThread.java    |  2 +-
 tolerant-reader/pom.xml                       |  2 +-
 .../java/com/iluwatar/tolerantreader/App.java |  2 +-
 .../iluwatar/tolerantreader/RainbowFish.java  |  2 +-
 .../tolerantreader/RainbowFishSerializer.java |  2 +-
 .../tolerantreader/RainbowFishV2.java         |  2 +-
 .../com/iluwatar/tolerantreader/AppTest.java  |  2 +-
 .../RainbowFishSerializerTest.java            |  2 +-
 .../tolerantreader/RainbowFishTest.java       |  2 +-
 .../tolerantreader/RainbowFishV2Test.java     |  2 +-
 trampoline/pom.xml                            |  2 +-
 .../com/iluwatar/trampoline/Trampoline.java   |  2 +-
 .../iluwatar/trampoline/TrampolineApp.java    |  2 +-
 .../trampoline/TrampolineAppTest.java         |  2 +-
 transaction-script/pom.xml                    |  2 +-
 .../com/iluwatar/transactionscript/App.java   |  2 +-
 .../com/iluwatar/transactionscript/Hotel.java |  2 +-
 .../iluwatar/transactionscript/HotelDao.java  |  2 +-
 .../transactionscript/HotelDaoImpl.java       |  2 +-
 .../com/iluwatar/transactionscript/Room.java  |  2 +-
 .../transactionscript/RoomSchemaSql.java      |  2 +-
 .../iluwatar/transactionscript/AppTest.java   |  2 +-
 .../transactionscript/HotelDaoImplTest.java   |  2 +-
 .../iluwatar/transactionscript/HotelTest.java |  2 +-
 .../iluwatar/transactionscript/RoomTest.java  |  2 +-
 twin/pom.xml                                  |  2 +-
 twin/src/main/java/com/iluwatar/twin/App.java |  2 +-
 .../main/java/com/iluwatar/twin/BallItem.java |  2 +-
 .../java/com/iluwatar/twin/BallThread.java    |  2 +-
 .../main/java/com/iluwatar/twin/GameItem.java |  2 +-
 .../test/java/com/iluwatar/twin/AppTest.java  |  2 +-
 .../java/com/iluwatar/twin/BallItemTest.java  |  2 +-
 .../com/iluwatar/twin/BallThreadTest.java     |  2 +-
 typeobjectpattern/pom.xml                     |  2 +-
 .../java/com/iluwatar/typeobject/App.java     |  2 +-
 .../java/com/iluwatar/typeobject/Candy.java   |  2 +-
 .../com/iluwatar/typeobject/CandyGame.java    |  2 +-
 .../java/com/iluwatar/typeobject/Cell.java    |  2 +-
 .../com/iluwatar/typeobject/CellPool.java     |  2 +-
 .../com/iluwatar/typeobject/JsonParser.java   |  2 +-
 .../iluwatar/typeobject/CandyGameTest.java    |  2 +-
 .../com/iluwatar/typeobject/CellPoolTest.java |  2 +-
 .../com/iluwatar/typeobject/CellTest.java     |  2 +-
 unit-of-work/pom.xml                          |  2 +-
 .../java/com/iluwatar/unitofwork/App.java     |  2 +-
 .../com/iluwatar/unitofwork/IUnitOfWork.java  |  2 +-
 .../java/com/iluwatar/unitofwork/Student.java |  2 +-
 .../iluwatar/unitofwork/StudentDatabase.java  |  2 +-
 .../unitofwork/StudentRepository.java         |  2 +-
 .../com/iluwatar/unitofwork/UnitActions.java  |  2 +-
 .../java/com/iluwatar/unitofwork/AppTest.java |  2 +-
 .../unitofwork/StudentRepositoryTest.java     |  2 +-
 update-method/pom.xml                         | 43 ++++++++++---------
 .../java/com/iluwatar/updatemethod/App.java   |  2 +-
 .../com/iluwatar/updatemethod/Entity.java     |  2 +-
 .../com/iluwatar/updatemethod/Skeleton.java   |  2 +-
 .../com/iluwatar/updatemethod/Statue.java     |  2 +-
 .../java/com/iluwatar/updatemethod/World.java |  2 +-
 .../com/iluwatar/updatemethod/AppTest.java    |  2 +-
 .../iluwatar/updatemethod/SkeletonTest.java   |  2 +-
 .../com/iluwatar/updatemethod/StatueTest.java |  2 +-
 .../com/iluwatar/updatemethod/WorldTest.java  |  2 +-
 value-object/pom.xml                          |  2 +-
 .../java/com/iluwatar/value/object/App.java   |  2 +-
 .../com/iluwatar/value/object/HeroStat.java   |  2 +-
 .../com/iluwatar/value/object/AppTest.java    |  2 +-
 .../iluwatar/value/object/HeroStatTest.java   |  2 +-
 version-number/pom.xml                        |  2 +-
 .../java/com/iluwatar/versionnumber/App.java  |  2 +-
 .../java/com/iluwatar/versionnumber/Book.java |  2 +-
 .../versionnumber/BookDuplicateException.java |  2 +-
 .../versionnumber/BookNotFoundException.java  |  2 +-
 .../versionnumber/BookRepository.java         |  2 +-
 .../VersionMismatchException.java             |  2 +-
 .../com/iluwatar/versionnumber/AppTest.java   |  2 +-
 .../versionnumber/BookRepositoryTest.java     |  2 +-
 visitor/pom.xml                               |  2 +-
 .../main/java/com/iluwatar/visitor/App.java   |  2 +-
 .../java/com/iluwatar/visitor/Commander.java  |  2 +-
 .../iluwatar/visitor/CommanderVisitor.java    |  2 +-
 .../java/com/iluwatar/visitor/Sergeant.java   |  2 +-
 .../com/iluwatar/visitor/SergeantVisitor.java |  2 +-
 .../java/com/iluwatar/visitor/Soldier.java    |  2 +-
 .../com/iluwatar/visitor/SoldierVisitor.java  |  2 +-
 .../main/java/com/iluwatar/visitor/Unit.java  |  2 +-
 .../com/iluwatar/visitor/UnitVisitor.java     |  2 +-
 .../java/com/iluwatar/visitor/AppTest.java    |  2 +-
 .../com/iluwatar/visitor/CommanderTest.java   |  2 +-
 .../visitor/CommanderVisitorTest.java         |  2 +-
 .../com/iluwatar/visitor/SergeantTest.java    |  2 +-
 .../iluwatar/visitor/SergeantVisitorTest.java |  2 +-
 .../com/iluwatar/visitor/SoldierTest.java     |  2 +-
 .../iluwatar/visitor/SoldierVisitorTest.java  |  2 +-
 .../java/com/iluwatar/visitor/UnitTest.java   |  2 +-
 .../com/iluwatar/visitor/VisitorTest.java     |  2 +-
 1625 files changed, 2029 insertions(+), 1870 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index 048a1bc80..b05d78281 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index a451f4c86..05e5332c1 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/pom.xml b/abstract-document/pom.xml
index 15e7cc54d..42ede08da 100644
--- a/abstract-document/pom.xml
+++ b/abstract-document/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/AbstractDocument.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/AbstractDocument.java
index 485af25b3..21be23326 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/AbstractDocument.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/AbstractDocument.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
index d13021e72..a14d8f292 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/Document.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/Document.java
index d0eb85f34..07b1354a3 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/Document.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/Document.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Car.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Car.java
index bf68d40e5..124890cc5 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Car.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Car.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasModel.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasModel.java
index 76d7d7431..f1d3f3465 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasModel.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasModel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasParts.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasParts.java
index 54f308ccf..c007072fc 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasParts.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasParts.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasPrice.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasPrice.java
index a50c725c3..2f9318939 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasPrice.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasPrice.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasType.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasType.java
index 2722564d5..c1bdc6cf0 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasType.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/HasType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Part.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Part.java
index 996598a92..8689c812a 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Part.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/Part.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/enums/Property.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/enums/Property.java
index 640f0ed83..bcd4443cd 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/enums/Property.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/domain/enums/Property.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
index 13db318e4..9fad18d1a 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
index dca4f040f..97d730826 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
index 5b1311ff6..bafdb7247 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index 2328c60a8..3b82189b9 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index baf2d7569..db464a231 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
index 51f69a822..0ed5dd8bd 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
index c75eb32ef..2977cc978 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
index 6d2da97cc..ad54943aa 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
index 5f2b6ed2a..9c2ca1d4b 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
index f7c4c6146..aa64a489f 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
index 4493d2d08..a727a1778 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
index 97e5f676f..704c14679 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
index cffcabf68..9326c5096 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
index a72dbf78c..520e36de0 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
index ae0bd5c3e..fa7bf3889 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
index 458a61bf9..fea7c1866 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
index f73ada9b0..9a47a9d0b 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
index ae7c744be..eb038ca61 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index 17c09be88..582862b30 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 238ff76d0..02e4e93f4 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/pom.xml b/acyclic-visitor/pom.xml
index 8c53b8750..234cbfefc 100644
--- a/acyclic-visitor/pom.xml
+++ b/acyclic-visitor/pom.xml
@@ -1,18 +1,27 @@
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
index 354c4db74..28345c505 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/AllModemVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
index 866abc3b7..b151019c2 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
index f9df38529..5313fd6bc 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
index 3d14eff8f..3f570d212 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
index b49a6234c..db10bfd2c 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/HayesVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/HayesVisitor.java
index 59527d57b..06ee5300d 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/HayesVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/HayesVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Modem.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Modem.java
index 201712dd1..04018d543 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Modem.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Modem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
index b4058f237..b2181fe7c 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ModemVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
index 3fbaa38df..6486c7a5c 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ZoomVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ZoomVisitor.java
index fd54d8b21..e86a64fa6 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ZoomVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ZoomVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
index 842779fff..12f0ba6ce 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
index 79097a454..99424eb32 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
index 32067ad38..5473e95ef 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
index 308dd5879..a2ded206f 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
index 2dcfcfbbb..923632228 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/pom.xml b/adapter/pom.xml
index a4d8d7b12..f50a7ae3d 100644
--- a/adapter/pom.xml
+++ b/adapter/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/adapter/src/main/java/com/iluwatar/adapter/App.java b/adapter/src/main/java/com/iluwatar/adapter/App.java
index 4e3755fb2..1375d85c7 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/App.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/main/java/com/iluwatar/adapter/Captain.java b/adapter/src/main/java/com/iluwatar/adapter/Captain.java
index b83b13429..9e6c9f816 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/Captain.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/Captain.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java b/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
index 123006c46..a6af76040 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java b/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
index 39a9adab4..84035d62e 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/main/java/com/iluwatar/adapter/RowingBoat.java b/adapter/src/main/java/com/iluwatar/adapter/RowingBoat.java
index 908036a3f..69d39c193 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/RowingBoat.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/RowingBoat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/main/java/com/iluwatar/adapter/package-info.java b/adapter/src/main/java/com/iluwatar/adapter/package-info.java
index d036d86dd..873df29c5 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/package-info.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/package-info.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java b/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
index f87073b23..c8291400d 100644
--- a/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
+++ b/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
index 3748c64f6..8b224e451 100644
--- a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
+++ b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/pom.xml b/aggregator-microservices/aggregator-service/pom.xml
index b7c2bac66..46337c0ec 100644
--- a/aggregator-microservices/aggregator-service/pom.xml
+++ b/aggregator-microservices/aggregator-service/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
index f28377a1d..c467a25d0 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
index 3c09c54be..791df87ba 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
index 3c214a58a..ca9af3de1 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
index 47d786ec6..75d87967d 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClient.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
index d19dcd829..4164a5e6d 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
index 22369350a..1ddba57ba 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClient.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
index e493c8040..6ed566ac4 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/aggregator-service/src/main/resources/application.properties b/aggregator-microservices/aggregator-service/src/main/resources/application.properties
index f9e29f5a7..79c2622b2 100644
--- a/aggregator-microservices/aggregator-service/src/main/resources/application.properties
+++ b/aggregator-microservices/aggregator-service/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 #
+
 server.port=50004
\ No newline at end of file
diff --git a/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
index cb958ecf9..f8ff2173e 100644
--- a/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
+++ b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/information-microservice/pom.xml b/aggregator-microservices/information-microservice/pom.xml
index 71935757f..43d5ba072 100644
--- a/aggregator-microservices/information-microservice/pom.xml
+++ b/aggregator-microservices/information-microservice/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
index 3815fffc4..0db963733 100644
--- a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
+++ b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
index 2accc013d..a8b60ffb8 100644
--- a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
+++ b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/information-microservice/src/main/resources/application.properties b/aggregator-microservices/information-microservice/src/main/resources/application.properties
index b953a61da..8f2a5f174 100644
--- a/aggregator-microservices/information-microservice/src/main/resources/application.properties
+++ b/aggregator-microservices/information-microservice/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 #
+
 server.port=51515
\ No newline at end of file
diff --git a/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
index 90388af1a..d3e07c552 100644
--- a/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
+++ b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/inventory-microservice/pom.xml b/aggregator-microservices/inventory-microservice/pom.xml
index 6c2726a35..9f74cf7c9 100644
--- a/aggregator-microservices/inventory-microservice/pom.xml
+++ b/aggregator-microservices/inventory-microservice/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
index 9a49518b5..a97b609ac 100644
--- a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
+++ b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
index e3c3838f8..e40835860 100644
--- a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
+++ b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/inventory-microservice/src/main/resources/application.properties b/aggregator-microservices/inventory-microservice/src/main/resources/application.properties
index 9d2021f44..380791d88 100644
--- a/aggregator-microservices/inventory-microservice/src/main/resources/application.properties
+++ b/aggregator-microservices/inventory-microservice/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 #
+
 server.port=51516
\ No newline at end of file
diff --git a/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
index e9961796b..5d278dd76 100644
--- a/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
+++ b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/aggregator-microservices/pom.xml b/aggregator-microservices/pom.xml
index 9e66e9be0..f5d18c2b4 100644
--- a/aggregator-microservices/pom.xml
+++ b/aggregator-microservices/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/pom.xml b/ambassador/pom.xml
index 0e5e208d5..487dab008 100644
--- a/ambassador/pom.xml
+++ b/ambassador/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/App.java b/ambassador/src/main/java/com/iluwatar/ambassador/App.java
index 087fc39c0..6da5a2588 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/App.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/Client.java b/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
index 70d52e799..dde44bd3f 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
index e2877b683..c2524ad47 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
index eadb981a2..3012eea29 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceInterface.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
index 5d830e0fc..64cb6eaac 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
index 57e444d88..771da8602 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/util/RandomProvider.java b/ambassador/src/main/java/com/iluwatar/ambassador/util/RandomProvider.java
index 5948472c0..9af9da500 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/util/RandomProvider.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/util/RandomProvider.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
index 186f13715..57658be39 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
index bab319bee..93ac792ae 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/ClientTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
index 374a909f3..c8c7d66ca 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/RemoteServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java b/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
index 48d128115..a17e36d74 100644
--- a/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
+++ b/ambassador/src/test/java/com/iluwatar/ambassador/ServiceAmbassadorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/pom.xml b/api-gateway/api-gateway-service/pom.xml
index c5ca117b6..26c567d95 100644
--- a/api-gateway/api-gateway-service/pom.xml
+++ b/api-gateway/api-gateway-service/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
index fbb8bdfd1..6d0cde3d3 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/App.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/App.java
index 1d72aaaec..fbffbf9f6 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/App.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
index 2f790bef5..e4660c31a 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClient.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClient.java
index 33e212b07..066986271 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClient.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClient.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
index 6fea815fc..2ec726693 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
index 45fa4e486..e59af3693 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClient.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClient.java
index ebe5150ba..b8f3787e8 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClient.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClient.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
index f773d0d54..801b9a3b6 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/api-gateway-service/src/main/resources/application.properties b/api-gateway/api-gateway-service/src/main/resources/application.properties
index f9e29f5a7..79c2622b2 100644
--- a/api-gateway/api-gateway-service/src/main/resources/application.properties
+++ b/api-gateway/api-gateway-service/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -20,4 +20,5 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 #
+
 server.port=50004
\ No newline at end of file
diff --git a/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java b/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
index d8b4234d6..5de617fc6 100644
--- a/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
+++ b/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/image-microservice/pom.xml b/api-gateway/image-microservice/pom.xml
index 821857449..ac270a987 100644
--- a/api-gateway/image-microservice/pom.xml
+++ b/api-gateway/image-microservice/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageApplication.java b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageApplication.java
index 12c001976..c93a21fb6 100644
--- a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageApplication.java
+++ b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
index a96ef4f41..232c7004c 100644
--- a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
+++ b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/image-microservice/src/main/resources/application.properties b/api-gateway/image-microservice/src/main/resources/application.properties
index da11b3c3d..057678c69 100644
--- a/api-gateway/image-microservice/src/main/resources/application.properties
+++ b/api-gateway/image-microservice/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java b/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
index 0d2414c5f..d1a6caf91 100644
--- a/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
+++ b/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/pom.xml b/api-gateway/pom.xml
index 8ed569412..45aa6e75b 100644
--- a/api-gateway/pom.xml
+++ b/api-gateway/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/price-microservice/pom.xml b/api-gateway/price-microservice/pom.xml
index dc3591bf3..9ee235a9e 100644
--- a/api-gateway/price-microservice/pom.xml
+++ b/api-gateway/price-microservice/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceApplication.java b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceApplication.java
index 5fc6a0f96..9b79c3d53 100644
--- a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceApplication.java
+++ b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
index dbcd59952..7502e0c24 100644
--- a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
+++ b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/price-microservice/src/main/resources/application.properties b/api-gateway/price-microservice/src/main/resources/application.properties
index 139fa2223..ea5b5871a 100644
--- a/api-gateway/price-microservice/src/main/resources/application.properties
+++ b/api-gateway/price-microservice/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java b/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
index 4d5dd92d9..4fcc69ebc 100644
--- a/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
+++ b/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/arrange-act-assert/pom.xml b/arrange-act-assert/pom.xml
index 4b0d57ebf..c0c60f575 100644
--- a/arrange-act-assert/pom.xml
+++ b/arrange-act-assert/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java b/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
index 71269359e..317848ae0 100644
--- a/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
+++ b/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
index 115dd3a11..3e2d90f6f 100644
--- a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
+++ b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
index 564b923e7..5cad10f9c 100644
--- a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
+++ b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index b4f7dd670..a5f34729d 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
index 40c186704..13959f1e3 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
index 22b36134f..e51b0f190 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
index 819ffd237..84cb7bec8 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
index 6aaf233b4..d27011a18 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
index e430e9ce4..b514a4000 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
index 5dfe901e8..db49fae85 100644
--- a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
+++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutorTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutorTest.java
index 1e54747fa..b644e0e23 100644
--- a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutorTest.java
+++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/pom.xml b/balking/pom.xml
index 0a86bc430..1b200663b 100644
--- a/balking/pom.xml
+++ b/balking/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/balking/src/main/java/com/iluwatar/balking/App.java b/balking/src/main/java/com/iluwatar/balking/App.java
index 3e72acc59..7d66724b5 100644
--- a/balking/src/main/java/com/iluwatar/balking/App.java
+++ b/balking/src/main/java/com/iluwatar/balking/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/src/main/java/com/iluwatar/balking/DelayProvider.java b/balking/src/main/java/com/iluwatar/balking/DelayProvider.java
index ed05cd292..9b21e9574 100644
--- a/balking/src/main/java/com/iluwatar/balking/DelayProvider.java
+++ b/balking/src/main/java/com/iluwatar/balking/DelayProvider.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/src/main/java/com/iluwatar/balking/WashingMachine.java b/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
index b35bd99df..401aa5feb 100644
--- a/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
+++ b/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java b/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
index 664a4c0c9..90ad0d9b4 100644
--- a/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
+++ b/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/src/test/java/com/iluwatar/balking/AppTest.java b/balking/src/test/java/com/iluwatar/balking/AppTest.java
index b12b6e1ec..9c3fa683a 100644
--- a/balking/src/test/java/com/iluwatar/balking/AppTest.java
+++ b/balking/src/test/java/com/iluwatar/balking/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java b/balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java
index 9e218e3f0..8f41bf36e 100644
--- a/balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java
+++ b/balking/src/test/java/com/iluwatar/balking/WashingMachineTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/pom.xml b/bridge/pom.xml
index 41271814c..7fbed70e9 100644
--- a/bridge/pom.xml
+++ b/bridge/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/bridge/src/main/java/com/iluwatar/bridge/App.java b/bridge/src/main/java/com/iluwatar/bridge/App.java
index 3e89ef6f6..218d65b54 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/App.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Enchantment.java b/bridge/src/main/java/com/iluwatar/bridge/Enchantment.java
index 8388fe91e..3ddc34f9f 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Enchantment.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Enchantment.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
index 772456b88..c2300c03d 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Hammer.java b/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
index ffab542cb..b535c403c 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
index ede98d2cb..286272aab 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Sword.java b/bridge/src/main/java/com/iluwatar/bridge/Sword.java
index 71f87a55d..f669c5516 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Sword.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Sword.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Weapon.java b/bridge/src/main/java/com/iluwatar/bridge/Weapon.java
index 76272332e..c5e1b5074 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Weapon.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Weapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
index 026f0954c..da2019815 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/test/java/com/iluwatar/bridge/HammerTest.java b/bridge/src/test/java/com/iluwatar/bridge/HammerTest.java
index b91f9f402..678913c2a 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/HammerTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/HammerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/test/java/com/iluwatar/bridge/SwordTest.java b/bridge/src/test/java/com/iluwatar/bridge/SwordTest.java
index 95a6bc3d3..7bba8599c 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/SwordTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/SwordTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bridge/src/test/java/com/iluwatar/bridge/WeaponTest.java b/bridge/src/test/java/com/iluwatar/bridge/WeaponTest.java
index 620e0104b..e8c4ef277 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/WeaponTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/WeaponTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/pom.xml b/builder/pom.xml
index 6aa467f9e..439ce282a 100644
--- a/builder/pom.xml
+++ b/builder/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/builder/src/main/java/com/iluwatar/builder/App.java b/builder/src/main/java/com/iluwatar/builder/App.java
index 76e514749..950e018cc 100644
--- a/builder/src/main/java/com/iluwatar/builder/App.java
+++ b/builder/src/main/java/com/iluwatar/builder/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/Armor.java b/builder/src/main/java/com/iluwatar/builder/Armor.java
index 5a20a0824..7f1dc5164 100644
--- a/builder/src/main/java/com/iluwatar/builder/Armor.java
+++ b/builder/src/main/java/com/iluwatar/builder/Armor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/HairColor.java b/builder/src/main/java/com/iluwatar/builder/HairColor.java
index 1beccff5e..9437a4cd5 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairColor.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairColor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/HairType.java b/builder/src/main/java/com/iluwatar/builder/HairType.java
index 950f02a1b..882bdd7c5 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairType.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/Hero.java b/builder/src/main/java/com/iluwatar/builder/Hero.java
index 86dc11034..7d45bd3df 100644
--- a/builder/src/main/java/com/iluwatar/builder/Hero.java
+++ b/builder/src/main/java/com/iluwatar/builder/Hero.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/Profession.java b/builder/src/main/java/com/iluwatar/builder/Profession.java
index 23b1ac220..f4c25fe89 100644
--- a/builder/src/main/java/com/iluwatar/builder/Profession.java
+++ b/builder/src/main/java/com/iluwatar/builder/Profession.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/main/java/com/iluwatar/builder/Weapon.java b/builder/src/main/java/com/iluwatar/builder/Weapon.java
index 4ca78b95f..c80349287 100644
--- a/builder/src/main/java/com/iluwatar/builder/Weapon.java
+++ b/builder/src/main/java/com/iluwatar/builder/Weapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/test/java/com/iluwatar/builder/AppTest.java b/builder/src/test/java/com/iluwatar/builder/AppTest.java
index 29b6ecb15..2f32066e1 100644
--- a/builder/src/test/java/com/iluwatar/builder/AppTest.java
+++ b/builder/src/test/java/com/iluwatar/builder/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/builder/src/test/java/com/iluwatar/builder/HeroTest.java b/builder/src/test/java/com/iluwatar/builder/HeroTest.java
index 97c984a70..f456c5ed9 100644
--- a/builder/src/test/java/com/iluwatar/builder/HeroTest.java
+++ b/builder/src/test/java/com/iluwatar/builder/HeroTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml
index a46e856a9..aa70c99ec 100644
--- a/business-delegate/pom.xml
+++ b/business-delegate/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
 	xmlns="http://maven.apache.org/POM/4.0.0"
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
index 115234df7..8bd4d12c6 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
index c39a2ad39..f2dfc49f6 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
index 489caa23c..dabe9664c 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
index 3094d3f6e..20845841f 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
index 2c13bc149..4d5c151e3 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
index 6f39abb1a..4c90c1377 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
index 2317d783a..1f218a402 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
index c0f02b5e3..68e1bbf72 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
index 6c57e145e..f70b67814 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
index 10815ad3a..b474ff4a6 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/pom.xml b/bytecode/pom.xml
index d21064be4..3655ebbb4 100644
--- a/bytecode/pom.xml
+++ b/bytecode/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/App.java b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
index b85d8ef05..d3754cf2c 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/App.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
index eeaf16846..ceec9b464 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
index c45301c29..c05b159db 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
index 5153969d9..fb258cc13 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java b/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
index b0baf326e..196d2b55d 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
index 31060b683..a035c797e 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
index 4518ca310..5ddf57a6b 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
index e7438fce1..2b4f0bada 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/pom.xml b/caching/pom.xml
index 627f76e98..f15334c88 100644
--- a/caching/pom.xml
+++ b/caching/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/App.java b/caching/src/main/java/com/iluwatar/caching/App.java
index d8bd1338d..b8b226550 100644
--- a/caching/src/main/java/com/iluwatar/caching/App.java
+++ b/caching/src/main/java/com/iluwatar/caching/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/AppManager.java b/caching/src/main/java/com/iluwatar/caching/AppManager.java
index aad98abae..6aca3f980 100644
--- a/caching/src/main/java/com/iluwatar/caching/AppManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/AppManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/CacheStore.java b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
index 90a060e55..c6767ed2e 100644
--- a/caching/src/main/java/com/iluwatar/caching/CacheStore.java
+++ b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
index 84b8307f3..3bd948070 100644
--- a/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
+++ b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/DbManager.java b/caching/src/main/java/com/iluwatar/caching/DbManager.java
index 3b2b706e7..2e770632b 100644
--- a/caching/src/main/java/com/iluwatar/caching/DbManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/DbManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/LruCache.java b/caching/src/main/java/com/iluwatar/caching/LruCache.java
index c443b6b1f..88aeb2318 100644
--- a/caching/src/main/java/com/iluwatar/caching/LruCache.java
+++ b/caching/src/main/java/com/iluwatar/caching/LruCache.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/UserAccount.java b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
index 4c58cfb08..7fbccbca3 100644
--- a/caching/src/main/java/com/iluwatar/caching/UserAccount.java
+++ b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/main/java/com/iluwatar/caching/constants/CachingConstants.java b/caching/src/main/java/com/iluwatar/caching/constants/CachingConstants.java
index 86d2bd2a7..797a561fd 100644
--- a/caching/src/main/java/com/iluwatar/caching/constants/CachingConstants.java
+++ b/caching/src/main/java/com/iluwatar/caching/constants/CachingConstants.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/test/java/com/iluwatar/caching/AppTest.java b/caching/src/test/java/com/iluwatar/caching/AppTest.java
index 20a03282d..12b72d56a 100644
--- a/caching/src/test/java/com/iluwatar/caching/AppTest.java
+++ b/caching/src/test/java/com/iluwatar/caching/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/caching/src/test/java/com/iluwatar/caching/CachingTest.java b/caching/src/test/java/com/iluwatar/caching/CachingTest.java
index 22130951a..8869a66ac 100644
--- a/caching/src/test/java/com/iluwatar/caching/CachingTest.java
+++ b/caching/src/test/java/com/iluwatar/caching/CachingTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/pom.xml b/callback/pom.xml
index a74b653e1..73491cb32 100644
--- a/callback/pom.xml
+++ b/callback/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/main/java/com/iluwatar/callback/App.java b/callback/src/main/java/com/iluwatar/callback/App.java
index 64cb3c796..8f504bb03 100644
--- a/callback/src/main/java/com/iluwatar/callback/App.java
+++ b/callback/src/main/java/com/iluwatar/callback/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/main/java/com/iluwatar/callback/Callback.java b/callback/src/main/java/com/iluwatar/callback/Callback.java
index ad98e27de..fde731c18 100644
--- a/callback/src/main/java/com/iluwatar/callback/Callback.java
+++ b/callback/src/main/java/com/iluwatar/callback/Callback.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
index f12448d96..0c380cd22 100644
--- a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
+++ b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/main/java/com/iluwatar/callback/Task.java b/callback/src/main/java/com/iluwatar/callback/Task.java
index f3e8e478a..8d8ab9149 100644
--- a/callback/src/main/java/com/iluwatar/callback/Task.java
+++ b/callback/src/main/java/com/iluwatar/callback/Task.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/main/java/com/iluwatar/callback/package-info.java b/callback/src/main/java/com/iluwatar/callback/package-info.java
index 0b86125fd..7bf62f90f 100644
--- a/callback/src/main/java/com/iluwatar/callback/package-info.java
+++ b/callback/src/main/java/com/iluwatar/callback/package-info.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/test/java/com/iluwatar/callback/AppTest.java b/callback/src/test/java/com/iluwatar/callback/AppTest.java
index 3a70df7e0..9b7315dc1 100644
--- a/callback/src/test/java/com/iluwatar/callback/AppTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/callback/src/test/java/com/iluwatar/callback/CallbackTest.java b/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
index 08a3df0e1..300acba24 100644
--- a/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/pom.xml b/chain/pom.xml
index 9a7097e6d..201405f47 100644
--- a/chain/pom.xml
+++ b/chain/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/App.java b/chain/src/main/java/com/iluwatar/chain/App.java
index d644ad680..16641dfb4 100644
--- a/chain/src/main/java/com/iluwatar/chain/App.java
+++ b/chain/src/main/java/com/iluwatar/chain/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
index a0dab903a..a24525dbe 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcKing.java b/chain/src/main/java/com/iluwatar/chain/OrcKing.java
index 1d43ac63f..d7fae9ab0 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcKing.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcKing.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
index abf1afe8b..9c9e1afca 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
index f1291a0a7..aa36c8428 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/Request.java b/chain/src/main/java/com/iluwatar/chain/Request.java
index 621303d93..107d3009e 100644
--- a/chain/src/main/java/com/iluwatar/chain/Request.java
+++ b/chain/src/main/java/com/iluwatar/chain/Request.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
index 4778ecf91..c174e22f2 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestType.java b/chain/src/main/java/com/iluwatar/chain/RequestType.java
index b63cf9402..3742f3b02 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestType.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/test/java/com/iluwatar/chain/AppTest.java b/chain/src/test/java/com/iluwatar/chain/AppTest.java
index 6cd696517..a126919c9 100644
--- a/chain/src/test/java/com/iluwatar/chain/AppTest.java
+++ b/chain/src/test/java/com/iluwatar/chain/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java b/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
index 7cbc1ad68..8da944340 100644
--- a/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
+++ b/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/checkstyle-suppressions.xml b/checkstyle-suppressions.xml
index f0c4b5eb1..e9eb2244a 100644
--- a/checkstyle-suppressions.xml
+++ b/checkstyle-suppressions.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/pom.xml b/circuit-breaker/pom.xml
index 083c527fa..160537144 100644
--- a/circuit-breaker/pom.xml
+++ b/circuit-breaker/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
index 302930585..898ac2c26 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
index 92884258b..8d98e52d9 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/CircuitBreaker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
index 7e45f5709..2194d75cb 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DefaultCircuitBreaker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
index f4add64fc..6f2b27924 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/DelayedRemoteService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
index 3fb8d8396..214b1435c 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/MonitoringService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
index 1b73bc0e3..b292dad03 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/QuickRemoteService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
index 3c2fd9c78..1a90a40b5 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
index b34f0b3fe..b4bfba938 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/RemoteServiceException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/State.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/State.java
index 95fdb08d6..6b3c1f5f4 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/State.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/State.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
index d28d316c8..77d42f317 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
index 4d300b36f..b8b031dc8 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
index 21fd80d03..fb7a512cf 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
index f6b802b96..57408a236 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/pom.xml b/collection-pipeline/pom.xml
index 08c41880b..70c64936c 100644
--- a/collection-pipeline/pom.xml
+++ b/collection-pipeline/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
index 121aaaeab..218248900 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
index cffdc7c82..52a3aabd9 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/CarFactory.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/CarFactory.java
index ea29ceda6..3902edcfd 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/CarFactory.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/CarFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
index 2214ebd4c..72a06a0a9 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/FunctionalProgramming.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/FunctionalProgramming.java
index bb216d2bc..5965ce019 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/FunctionalProgramming.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/FunctionalProgramming.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/ImperativeProgramming.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/ImperativeProgramming.java
index bdf2d5e80..14d33f46c 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/ImperativeProgramming.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/ImperativeProgramming.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
index 3e25f6993..fd438f8ec 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java b/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
index cedc492b9..bc05ea98f 100644
--- a/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
+++ b/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/pom.xml b/combinator/pom.xml
index 4886873cd..3592c5949 100644
--- a/combinator/pom.xml
+++ b/combinator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java b/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
index 578c87bfe..d13550bf1 100644
--- a/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
+++ b/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/main/java/com/iluwatar/combinator/Finder.java b/combinator/src/main/java/com/iluwatar/combinator/Finder.java
index 37cecbd0c..1da87a411 100644
--- a/combinator/src/main/java/com/iluwatar/combinator/Finder.java
+++ b/combinator/src/main/java/com/iluwatar/combinator/Finder.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/main/java/com/iluwatar/combinator/Finders.java b/combinator/src/main/java/com/iluwatar/combinator/Finders.java
index f91c07f4c..a137c6938 100644
--- a/combinator/src/main/java/com/iluwatar/combinator/Finders.java
+++ b/combinator/src/main/java/com/iluwatar/combinator/Finders.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
index 6e7b4f63f..3aefbf5da 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
index 67314903d..3cef476b4 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
index 5753ec92a..2827c718b 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/pom.xml b/command/pom.xml
index 3869d4b44..c0bc15810 100644
--- a/command/pom.xml
+++ b/command/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java
index 77396d37a..92e1a1e70 100644
--- a/command/src/main/java/com/iluwatar/command/App.java
+++ b/command/src/main/java/com/iluwatar/command/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/Goblin.java b/command/src/main/java/com/iluwatar/command/Goblin.java
index e430b65b5..e79ba99a6 100644
--- a/command/src/main/java/com/iluwatar/command/Goblin.java
+++ b/command/src/main/java/com/iluwatar/command/Goblin.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/Size.java b/command/src/main/java/com/iluwatar/command/Size.java
index c9aeb7017..446a80ab3 100644
--- a/command/src/main/java/com/iluwatar/command/Size.java
+++ b/command/src/main/java/com/iluwatar/command/Size.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/Target.java b/command/src/main/java/com/iluwatar/command/Target.java
index 419ad6f54..50d3c0122 100644
--- a/command/src/main/java/com/iluwatar/command/Target.java
+++ b/command/src/main/java/com/iluwatar/command/Target.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/Visibility.java b/command/src/main/java/com/iluwatar/command/Visibility.java
index 8fe0ce7bb..0a49ee6b2 100644
--- a/command/src/main/java/com/iluwatar/command/Visibility.java
+++ b/command/src/main/java/com/iluwatar/command/Visibility.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/main/java/com/iluwatar/command/Wizard.java b/command/src/main/java/com/iluwatar/command/Wizard.java
index f63831c07..5ff3a6d9f 100644
--- a/command/src/main/java/com/iluwatar/command/Wizard.java
+++ b/command/src/main/java/com/iluwatar/command/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/test/java/com/iluwatar/command/AppTest.java b/command/src/test/java/com/iluwatar/command/AppTest.java
index 73d098fa3..0f437852f 100644
--- a/command/src/test/java/com/iluwatar/command/AppTest.java
+++ b/command/src/test/java/com/iluwatar/command/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/command/src/test/java/com/iluwatar/command/CommandTest.java b/command/src/test/java/com/iluwatar/command/CommandTest.java
index 76b8c9e58..e9f362142 100644
--- a/command/src/test/java/com/iluwatar/command/CommandTest.java
+++ b/command/src/test/java/com/iluwatar/command/CommandTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/pom.xml b/commander/pom.xml
index baabc04fc..8cb801499 100644
--- a/commander/pom.xml
+++ b/commander/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/AppEmployeeDbFailCases.java b/commander/src/main/java/com/iluwatar/commander/AppEmployeeDbFailCases.java
index 7c48dee4c..0b1860dcd 100644
--- a/commander/src/main/java/com/iluwatar/commander/AppEmployeeDbFailCases.java
+++ b/commander/src/main/java/com/iluwatar/commander/AppEmployeeDbFailCases.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/AppMessagingFailCases.java b/commander/src/main/java/com/iluwatar/commander/AppMessagingFailCases.java
index cbb6e6c78..bea45a8c9 100644
--- a/commander/src/main/java/com/iluwatar/commander/AppMessagingFailCases.java
+++ b/commander/src/main/java/com/iluwatar/commander/AppMessagingFailCases.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/AppPaymentFailCases.java b/commander/src/main/java/com/iluwatar/commander/AppPaymentFailCases.java
index 8dbe7327b..e6c9f065e 100644
--- a/commander/src/main/java/com/iluwatar/commander/AppPaymentFailCases.java
+++ b/commander/src/main/java/com/iluwatar/commander/AppPaymentFailCases.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/AppQueueFailCases.java b/commander/src/main/java/com/iluwatar/commander/AppQueueFailCases.java
index b108701a2..20e32e5d8 100644
--- a/commander/src/main/java/com/iluwatar/commander/AppQueueFailCases.java
+++ b/commander/src/main/java/com/iluwatar/commander/AppQueueFailCases.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/AppShippingFailCases.java b/commander/src/main/java/com/iluwatar/commander/AppShippingFailCases.java
index 36bb06042..c748b06a8 100644
--- a/commander/src/main/java/com/iluwatar/commander/AppShippingFailCases.java
+++ b/commander/src/main/java/com/iluwatar/commander/AppShippingFailCases.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/Commander.java b/commander/src/main/java/com/iluwatar/commander/Commander.java
index 2909f9304..097b92bae 100644
--- a/commander/src/main/java/com/iluwatar/commander/Commander.java
+++ b/commander/src/main/java/com/iluwatar/commander/Commander.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/Database.java b/commander/src/main/java/com/iluwatar/commander/Database.java
index ebd333e02..0bfad5366 100644
--- a/commander/src/main/java/com/iluwatar/commander/Database.java
+++ b/commander/src/main/java/com/iluwatar/commander/Database.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/Order.java b/commander/src/main/java/com/iluwatar/commander/Order.java
index f736aa47c..ffc93cb59 100644
--- a/commander/src/main/java/com/iluwatar/commander/Order.java
+++ b/commander/src/main/java/com/iluwatar/commander/Order.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/Retry.java b/commander/src/main/java/com/iluwatar/commander/Retry.java
index be93a821c..e22990412 100644
--- a/commander/src/main/java/com/iluwatar/commander/Retry.java
+++ b/commander/src/main/java/com/iluwatar/commander/Retry.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/Service.java b/commander/src/main/java/com/iluwatar/commander/Service.java
index ddcc2d5bf..16f3da1dc 100644
--- a/commander/src/main/java/com/iluwatar/commander/Service.java
+++ b/commander/src/main/java/com/iluwatar/commander/Service.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/User.java b/commander/src/main/java/com/iluwatar/commander/User.java
index b1389ab4c..f43821913 100644
--- a/commander/src/main/java/com/iluwatar/commander/User.java
+++ b/commander/src/main/java/com/iluwatar/commander/User.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
index 69ebc1fd9..92baa6da3 100644
--- a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeHandle.java b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeHandle.java
index 3c9c3cb97..a13349bc4 100644
--- a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeHandle.java
+++ b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeHandle.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/exceptions/DatabaseUnavailableException.java b/commander/src/main/java/com/iluwatar/commander/exceptions/DatabaseUnavailableException.java
index 8997b1a10..a17d551b7 100644
--- a/commander/src/main/java/com/iluwatar/commander/exceptions/DatabaseUnavailableException.java
+++ b/commander/src/main/java/com/iluwatar/commander/exceptions/DatabaseUnavailableException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/exceptions/IsEmptyException.java b/commander/src/main/java/com/iluwatar/commander/exceptions/IsEmptyException.java
index 98c3cfd90..8699bd603 100644
--- a/commander/src/main/java/com/iluwatar/commander/exceptions/IsEmptyException.java
+++ b/commander/src/main/java/com/iluwatar/commander/exceptions/IsEmptyException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/exceptions/ItemUnavailableException.java b/commander/src/main/java/com/iluwatar/commander/exceptions/ItemUnavailableException.java
index 7ba5b2a13..e373adfda 100644
--- a/commander/src/main/java/com/iluwatar/commander/exceptions/ItemUnavailableException.java
+++ b/commander/src/main/java/com/iluwatar/commander/exceptions/ItemUnavailableException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/exceptions/PaymentDetailsErrorException.java b/commander/src/main/java/com/iluwatar/commander/exceptions/PaymentDetailsErrorException.java
index eb7c0fb3f..c6b1effb4 100644
--- a/commander/src/main/java/com/iluwatar/commander/exceptions/PaymentDetailsErrorException.java
+++ b/commander/src/main/java/com/iluwatar/commander/exceptions/PaymentDetailsErrorException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/exceptions/ShippingNotPossibleException.java b/commander/src/main/java/com/iluwatar/commander/exceptions/ShippingNotPossibleException.java
index b374f2a7d..425ffa731 100644
--- a/commander/src/main/java/com/iluwatar/commander/exceptions/ShippingNotPossibleException.java
+++ b/commander/src/main/java/com/iluwatar/commander/exceptions/ShippingNotPossibleException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
index 22ad733cb..42c208d2b 100644
--- a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
index e353a4c7c..ac5154d1b 100644
--- a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
+++ b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
index bf9e846bb..655c301e5 100644
--- a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
index f18b55eaa..4b74c5f17 100644
--- a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
+++ b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/Queue.java b/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
index 7a2c5d7ae..69c7a0490 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/QueueDatabase.java b/commander/src/main/java/com/iluwatar/commander/queue/QueueDatabase.java
index 003a7da46..2f1e0d610 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/QueueDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/QueueDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
index 341eb628c..7056e7197 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
index abaf27c9d..77807456c 100644
--- a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
index 250cfa807..c8c70c2d8 100644
--- a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
+++ b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/commander/src/test/java/com/iluwatar/commander/RetryTest.java b/commander/src/test/java/com/iluwatar/commander/RetryTest.java
index e14bbbc6a..55ff28684 100644
--- a/commander/src/test/java/com/iluwatar/commander/RetryTest.java
+++ b/commander/src/test/java/com/iluwatar/commander/RetryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/pom.xml b/composite/pom.xml
index 6f7147482..ba4e54570 100644
--- a/composite/pom.xml
+++ b/composite/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/App.java b/composite/src/main/java/com/iluwatar/composite/App.java
index 48c9fe03e..56f2c747e 100644
--- a/composite/src/main/java/com/iluwatar/composite/App.java
+++ b/composite/src/main/java/com/iluwatar/composite/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/Letter.java b/composite/src/main/java/com/iluwatar/composite/Letter.java
index 00b1a9639..322faf1eb 100644
--- a/composite/src/main/java/com/iluwatar/composite/Letter.java
+++ b/composite/src/main/java/com/iluwatar/composite/Letter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/LetterComposite.java b/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
index 0daf88222..981db28d1 100644
--- a/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
+++ b/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/Messenger.java b/composite/src/main/java/com/iluwatar/composite/Messenger.java
index d57f32692..9f8ceadf3 100644
--- a/composite/src/main/java/com/iluwatar/composite/Messenger.java
+++ b/composite/src/main/java/com/iluwatar/composite/Messenger.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/Sentence.java b/composite/src/main/java/com/iluwatar/composite/Sentence.java
index b0c2adbcd..239c64d19 100644
--- a/composite/src/main/java/com/iluwatar/composite/Sentence.java
+++ b/composite/src/main/java/com/iluwatar/composite/Sentence.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/main/java/com/iluwatar/composite/Word.java b/composite/src/main/java/com/iluwatar/composite/Word.java
index 235d1c31f..39503f9e6 100644
--- a/composite/src/main/java/com/iluwatar/composite/Word.java
+++ b/composite/src/main/java/com/iluwatar/composite/Word.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/test/java/com/iluwatar/composite/AppTest.java b/composite/src/test/java/com/iluwatar/composite/AppTest.java
index c82056a51..3a9da579f 100644
--- a/composite/src/test/java/com/iluwatar/composite/AppTest.java
+++ b/composite/src/test/java/com/iluwatar/composite/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/composite/src/test/java/com/iluwatar/composite/MessengerTest.java b/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
index 169e18508..65dc29958 100644
--- a/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
+++ b/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/pom.xml b/converter/pom.xml
index 1bed5e973..0ec4c0847 100644
--- a/converter/pom.xml
+++ b/converter/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby 
-	granted, free of charge, to any person obtaining a copy of this software 
-	and associated documentation files (the "Software"), to deal in the Software 
-	without restriction, including without limitation the rights to use, copy, 
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the 
-	Software, and to permit persons to whom the Software is furnished to do so, 
-	subject to the following conditions: The above copyright notice and this 
-	permission notice shall be included in all copies or substantial portions 
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY 
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/converter/src/main/java/com/iluwatar/converter/App.java b/converter/src/main/java/com/iluwatar/converter/App.java
index 2d4ec0429..c68b3b5e2 100644
--- a/converter/src/main/java/com/iluwatar/converter/App.java
+++ b/converter/src/main/java/com/iluwatar/converter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/main/java/com/iluwatar/converter/Converter.java b/converter/src/main/java/com/iluwatar/converter/Converter.java
index 10425e1ca..d8c1108d5 100644
--- a/converter/src/main/java/com/iluwatar/converter/Converter.java
+++ b/converter/src/main/java/com/iluwatar/converter/Converter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/main/java/com/iluwatar/converter/User.java b/converter/src/main/java/com/iluwatar/converter/User.java
index 2c1ba9ff0..1ead0c55c 100644
--- a/converter/src/main/java/com/iluwatar/converter/User.java
+++ b/converter/src/main/java/com/iluwatar/converter/User.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/main/java/com/iluwatar/converter/UserConverter.java b/converter/src/main/java/com/iluwatar/converter/UserConverter.java
index c2341695e..7f5cabd82 100644
--- a/converter/src/main/java/com/iluwatar/converter/UserConverter.java
+++ b/converter/src/main/java/com/iluwatar/converter/UserConverter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/main/java/com/iluwatar/converter/UserDto.java b/converter/src/main/java/com/iluwatar/converter/UserDto.java
index 67a886087..bf1af5036 100644
--- a/converter/src/main/java/com/iluwatar/converter/UserDto.java
+++ b/converter/src/main/java/com/iluwatar/converter/UserDto.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/test/java/com/iluwatar/converter/AppTest.java b/converter/src/test/java/com/iluwatar/converter/AppTest.java
index 7a99fe6ae..55b9a2258 100644
--- a/converter/src/test/java/com/iluwatar/converter/AppTest.java
+++ b/converter/src/test/java/com/iluwatar/converter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/converter/src/test/java/com/iluwatar/converter/ConverterTest.java b/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
index 46aca82a7..79c874032 100644
--- a/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
+++ b/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/pom.xml b/cqrs/pom.xml
index 1838ed599..7d2d5aca9 100644
--- a/cqrs/pom.xml
+++ b/cqrs/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java b/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
index 436c2d130..5be436e6a 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/commandes/CommandServiceImpl.java b/cqrs/src/main/java/com/iluwatar/cqrs/commandes/CommandServiceImpl.java
index e402adad8..a25d015c7 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/commandes/CommandServiceImpl.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/commandes/CommandServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/commandes/ICommandService.java b/cqrs/src/main/java/com/iluwatar/cqrs/commandes/ICommandService.java
index b81d24c7c..566bc19f8 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/commandes/ICommandService.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/commandes/ICommandService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/constants/AppConstants.java b/cqrs/src/main/java/com/iluwatar/cqrs/constants/AppConstants.java
index 0a8971729..0b4aae4d8 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/constants/AppConstants.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/constants/AppConstants.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
index 9f2b73e48..a904cb608 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
index 8b87bdbf4..d3ac74e22 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
index f3fa3f03b..91ddfce5a 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
index afddd5f28..fb1f6200c 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/queries/IQueryService.java b/cqrs/src/main/java/com/iluwatar/cqrs/queries/IQueryService.java
index e67371bc7..6a358f8e7 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/queries/IQueryService.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/queries/IQueryService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/queries/QueryServiceImpl.java b/cqrs/src/main/java/com/iluwatar/cqrs/queries/QueryServiceImpl.java
index d30c0f386..7f14af84b 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/queries/QueryServiceImpl.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/queries/QueryServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java b/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
index 31610e5c1..3c3e2ce14 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/resources/hibernate.cfg.xml b/cqrs/src/main/resources/hibernate.cfg.xml
index 019cd3917..a5d1e2eaf 100644
--- a/cqrs/src/main/resources/hibernate.cfg.xml
+++ b/cqrs/src/main/resources/hibernate.cfg.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/main/resources/logback.xml b/cqrs/src/main/resources/logback.xml
index 7a74fedb2..5734b6850 100644
--- a/cqrs/src/main/resources/logback.xml
+++ b/cqrs/src/main/resources/logback.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java b/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
index e0bb07fd1..64d4a38e8 100644
--- a/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
+++ b/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/test/resources/hibernate.cfg.xml b/cqrs/src/test/resources/hibernate.cfg.xml
index 019cd3917..a5d1e2eaf 100644
--- a/cqrs/src/test/resources/hibernate.cfg.xml
+++ b/cqrs/src/test/resources/hibernate.cfg.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/cqrs/src/test/resources/logback.xml b/cqrs/src/test/resources/logback.xml
index 7a74fedb2..5734b6850 100644
--- a/cqrs/src/test/resources/logback.xml
+++ b/cqrs/src/test/resources/logback.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/pom.xml b/dao/pom.xml
index 32e9ef1ff..6f0628b00 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java
index 6d578bc79..4de690ed3 100644
--- a/dao/src/main/java/com/iluwatar/dao/App.java
+++ b/dao/src/main/java/com/iluwatar/dao/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomException.java b/dao/src/main/java/com/iluwatar/dao/CustomException.java
index 3da6ab20e..eff7c44cc 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomException.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/Customer.java b/dao/src/main/java/com/iluwatar/dao/Customer.java
index 2630c9252..3cf6bd4a9 100644
--- a/dao/src/main/java/com/iluwatar/dao/Customer.java
+++ b/dao/src/main/java/com/iluwatar/dao/Customer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
index f5dc573ba..3bd4da85f 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerSchemaSql.java b/dao/src/main/java/com/iluwatar/dao/CustomerSchemaSql.java
index 633a65860..c0f1e2c7b 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerSchemaSql.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerSchemaSql.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
index 23958cab9..811ef5a55 100644
--- a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/main/java/com/iluwatar/dao/InMemoryCustomerDao.java b/dao/src/main/java/com/iluwatar/dao/InMemoryCustomerDao.java
index 0a3bd40e3..c896a4bf9 100644
--- a/dao/src/main/java/com/iluwatar/dao/InMemoryCustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/InMemoryCustomerDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/test/java/com/iluwatar/dao/AppTest.java b/dao/src/test/java/com/iluwatar/dao/AppTest.java
index e6d41fc8a..ccd123374 100644
--- a/dao/src/test/java/com/iluwatar/dao/AppTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
index 479b619a3..ccfcba142 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java b/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
index 8155cda79..7375ebd64 100644
--- a/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java b/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
index 64ce433df..d4cc79303 100644
--- a/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/pom.xml b/data-bus/pom.xml
index 4db738307..b9d57e091 100644
--- a/data-bus/pom.xml
+++ b/data-bus/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java b/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
index be26f0e8e..90d996291 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/App.java b/data-bus/src/main/java/com/iluwatar/databus/App.java
index 8f3b8cfbe..ba4ab4463 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/App.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/DataBus.java b/data-bus/src/main/java/com/iluwatar/databus/DataBus.java
index 53000ece6..ed6c78a31 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/DataBus.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/DataBus.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/DataType.java b/data-bus/src/main/java/com/iluwatar/databus/DataType.java
index 6976f4541..e604e7b6b 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/DataType.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/DataType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/Member.java b/data-bus/src/main/java/com/iluwatar/databus/Member.java
index 4c5cde3a4..ff5a3213d 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/Member.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/Member.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java b/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
index 86f87dabe..26173f417 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java b/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
index bd1f4c20f..0b2b2d9b6 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java b/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
index 41bb67482..1d415135e 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java b/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
index d77d56b9f..26ed6b24f 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java b/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
index fffcde9c6..65ba87745 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java b/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
index a6491d5a7..3f8aa88b0 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java b/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
index ebbdaea1e..c6f5b3b40 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java b/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
index c7b411c56..b7be285ee 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/pom.xml b/data-locality/pom.xml
index 88fd96c64..f8539d0b1 100644
--- a/data-locality/pom.xml
+++ b/data-locality/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/Application.java b/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
index 463a02b78..0930cae56 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
index 337532175..340b021f9 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
index 40acb2f71..58d4c5784 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/Component.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/Component.java
index f159df4f6..0cfd100f8 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/Component.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/Component.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
index 89c6f1503..4636336c2 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
index 0b49da056..5415c4281 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
index c85bd1e68..034dd2db1 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
index 155793c88..dc70ba0cc 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
index be1d3c2e9..ffc1b4303 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
index b7d1f8961..7be4e9d44 100644
--- a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
+++ b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/pom.xml b/data-mapper/pom.xml
index cf17de69b..a980f40ee 100644
--- a/data-mapper/pom.xml
+++ b/data-mapper/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/App.java b/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
index 09c027401..e1aa6ecb6 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/DataMapperException.java b/data-mapper/src/main/java/com/iluwatar/datamapper/DataMapperException.java
index 4f354c7eb..e9176047a 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/DataMapperException.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/DataMapperException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java b/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
index 25075b1e0..ec9de8090 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapper.java b/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapper.java
index 3dfe4787f..6804433c5 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapper.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapper.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapperImpl.java b/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapperImpl.java
index 7abe04e3f..1f40c8161 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapperImpl.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/StudentDataMapperImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
index ab74edd6c..1f1b05532 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
index 717e4fe90..25ab47eb1 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
index 2ea7a3daa..7153ae790 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/pom.xml b/data-transfer-object/pom.xml
index 2529b3756..0ab0dd60c 100644
--- a/data-transfer-object/pom.xml
+++ b/data-transfer-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
index 5bee4e27f..ae9aadf32 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
index 50d3a0857..6f653de53 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
index edd3fcb6d..2c5b88663 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
index 698052efe..f8e537aca 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/Product.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
index 97c2acd05..9452db970 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductDto.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
index abb869254..79a93ac8b 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/product/ProductResource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
index 68a8b9444..5cd12868f 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
index 8b2d0d92a..1a9e7eb84 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/pom.xml b/decorator/pom.xml
index b075704c8..61e1a64b0 100644
--- a/decorator/pom.xml
+++ b/decorator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java
index 25d03e4c8..c74b52c83 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/App.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java b/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
index 74a1434e1..ab7fcbe53 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java b/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
index 08eed94fc..a9bf2bdad 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/main/java/com/iluwatar/decorator/Troll.java b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
index 43f9ac916..1a990a5bc 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/Troll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
index 792d61233..590f4fc2e 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java b/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
index 28970db1b..1bb677a4e 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java b/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
index a398135e6..2d98a120d 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/pom.xml b/delegation/pom.xml
index d7ad81362..d6295b45b 100644
--- a/delegation/pom.xml
+++ b/delegation/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/App.java b/delegation/src/main/java/com/iluwatar/delegation/simple/App.java
index 9b9f1284e..748843105 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/App.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/Printer.java b/delegation/src/main/java/com/iluwatar/delegation/simple/Printer.java
index f3f434adb..b796d8d7d 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/Printer.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/Printer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/PrinterController.java b/delegation/src/main/java/com/iluwatar/delegation/simple/PrinterController.java
index add1d71e6..2c3934171 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/PrinterController.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/PrinterController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
index 5d7c59c86..025dbe92b 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
index 67bd00ac8..ef0026cb8 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
index 082e0054a..0e9af1284 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java b/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
index 8e20c9032..f759c99f1 100644
--- a/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
+++ b/delegation/src/test/java/com/iluwatar/delegation/simple/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java b/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
index 8aefc4b56..093549428 100644
--- a/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
+++ b/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml
index f3aaba520..f1ede7a59 100644
--- a/dependency-injection/pom.xml
+++ b/dependency-injection/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
index 31f4e78bf..edbe039b9 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
index f0ff2da94..46758a718 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
index 6762cbbc7..9c114981c 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
index d769ffd46..6979883c8 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java
index 3f242ea60..a31a839d2 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java
index 50ef5e2c5..75f711ea6 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java
index 622958615..365840358 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
index 0136ff69f..6579238d7 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
index aaef6ba2a..191655e79 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
index 43cadc071..5345cc5b2 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
index 0575118a5..199f88718 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
index 701cc1754..d985d5975 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
index b076e87c0..bd5046389 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
index 52508814a..d1791ec58 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
index 1e31a5316..658ab2876 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
index 7b11469c3..b67005ad8 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/utils/InMemoryAppender.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/utils/InMemoryAppender.java
index d91099af9..ea7f355b4 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/utils/InMemoryAppender.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/pom.xml b/dirty-flag/pom.xml
index b796ab37a..eaa1e5cf2 100644
--- a/dirty-flag/pom.xml
+++ b/dirty-flag/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
index 9408904cf..49c96d3a1 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
index a4efaa6a8..5d5c981fe 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
index 1d4fbfa75..1c5f7e81f 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/main/resources/world.txt b/dirty-flag/src/main/resources/world.txt
index 1d077006d..0c25bc5c5 100644
--- a/dirty-flag/src/main/resources/world.txt
+++ b/dirty-flag/src/main/resources/world.txt
@@ -1,6 +1,6 @@
 ====
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/test/java/org/dirty/flag/AppTest.java b/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
index 82c7fea9b..0b1ed0709 100644
--- a/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
+++ b/dirty-flag/src/test/java/org/dirty/flag/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
index 9af9664d6..852d5a006 100644
--- a/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
+++ b/dirty-flag/src/test/java/org/dirty/flag/DirtyFlagTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/pom.xml b/double-buffer/pom.xml
index cc4032074..06ceff2e7 100644
--- a/double-buffer/pom.xml
+++ b/double-buffer/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
index 00aa3b114..7b510eddd 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Buffer.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Buffer.java
index 78877c3d9..019db5abe 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Buffer.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Buffer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/FrameBuffer.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/FrameBuffer.java
index 4b974a2e8..1d879f18a 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/FrameBuffer.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/FrameBuffer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
index 54f130b1d..3e4ba93a4 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
index 8ee72ded4..7f6d7fffe 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
index 6612d2b00..ceedab0ee 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
index 2ade416cd..f0cd6f148 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
index cd17d2191..892443e9f 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index 04aba2260..24c852e91 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
index fd4f71063..a61e41550 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
index ae2e70d6f..735195645 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
index ecedc535f..7ce150c74 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/main/resources/logback.xml b/double-checked-locking/src/main/resources/logback.xml
index b562cace5..bba68ecb5 100644
--- a/double-checked-locking/src/main/resources/logback.xml
+++ b/double-checked-locking/src/main/resources/logback.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
index e24e51094..0405936ed 100644
--- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
+++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
index fe0cbf5e9..5ecd8ddca 100644
--- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
+++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml
index 275b505a5..26d345f65 100644
--- a/double-dispatch/pom.xml
+++ b/double-dispatch/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
index baeda1a46..0774516c7 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
index c603abcac..edd87bc08 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
index 3dcfd5015..6ab1bc49b 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
index de9c59f21..58c28c43a 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
index ea18ca3dc..1fbae4635 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
index fecdd6b51..144470271 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
index 5b6535752..13d0a6d75 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/constants/AppConstants.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/constants/AppConstants.java
index 77f6dde4d..906803167 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/constants/AppConstants.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/constants/AppConstants.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
index e5df7a2be..db92a6233 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/CollisionTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/CollisionTest.java
index 59f25b999..3aac76fe6 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/CollisionTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/CollisionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
index 8b4ff56b5..173f3fcba 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
index 71f160f07..d49026261 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
index ceae9b260..628838dc5 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
index 681c63b8f..7138160d5 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
index b4e79b475..d72f71172 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/pom.xml b/eip-aggregator/pom.xml
index efee153a3..06733a51e 100644
--- a/eip-aggregator/pom.xml
+++ b/eip-aggregator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/App.java b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/App.java
index 34fa6e307..d2ac10912 100644
--- a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/App.java
+++ b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/AggregatorRoute.java b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/AggregatorRoute.java
index 2465fd960..ae0880c90 100644
--- a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/AggregatorRoute.java
+++ b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/AggregatorRoute.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategy.java b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategy.java
index 9fd4c933a..365a0b45a 100644
--- a/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategy.java
+++ b/eip-aggregator/src/main/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/main/resources/application.properties b/eip-aggregator/src/main/resources/application.properties
index 34febce1a..ca07b459e 100644
--- a/eip-aggregator/src/main/resources/application.properties
+++ b/eip-aggregator/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
index 3da3b3e66..08e03441c 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
index e1c6f5b2b..17f9ea61d 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
index 8325e7255..9279f11eb 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-aggregator/src/test/resources/application-test.properties b/eip-aggregator/src/test/resources/application-test.properties
index 0cab1156b..843005704 100644
--- a/eip-aggregator/src/test/resources/application-test.properties
+++ b/eip-aggregator/src/test/resources/application-test.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-message-channel/pom.xml b/eip-message-channel/pom.xml
index 12fe153e3..33ee56c05 100644
--- a/eip-message-channel/pom.xml
+++ b/eip-message-channel/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java b/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
index fefac5e0d..9d8a4644d 100644
--- a/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
+++ b/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java b/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
index 14cdc5c65..ff51f314c 100644
--- a/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
+++ b/eip-message-channel/src/test/java/com/iluwatar/eip/message/channel/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-publish-subscribe/pom.xml b/eip-publish-subscribe/pom.xml
index f354b1ee3..244bf1d0f 100644
--- a/eip-publish-subscribe/pom.xml
+++ b/eip-publish-subscribe/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java b/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
index a72643248..3d04c631c 100644
--- a/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
+++ b/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-publish-subscribe/src/main/resources/logback.xml b/eip-publish-subscribe/src/main/resources/logback.xml
index 60a1101b5..7681632ad 100644
--- a/eip-publish-subscribe/src/main/resources/logback.xml
+++ b/eip-publish-subscribe/src/main/resources/logback.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java b/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
index f910d0abe..7f683000c 100644
--- a/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
+++ b/eip-publish-subscribe/src/test/java/com/iluwatar/eip/publish/subscribe/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/pom.xml b/eip-splitter/pom.xml
index 5b4758a9e..57c28125a 100644
--- a/eip-splitter/pom.xml
+++ b/eip-splitter/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/main/java/com/iluwatar/eip/splitter/App.java b/eip-splitter/src/main/java/com/iluwatar/eip/splitter/App.java
index 2792e0be4..263d9fab5 100644
--- a/eip-splitter/src/main/java/com/iluwatar/eip/splitter/App.java
+++ b/eip-splitter/src/main/java/com/iluwatar/eip/splitter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/main/java/com/iluwatar/eip/splitter/routes/SplitterRoute.java b/eip-splitter/src/main/java/com/iluwatar/eip/splitter/routes/SplitterRoute.java
index 4d2cb3efb..4fc467960 100644
--- a/eip-splitter/src/main/java/com/iluwatar/eip/splitter/routes/SplitterRoute.java
+++ b/eip-splitter/src/main/java/com/iluwatar/eip/splitter/routes/SplitterRoute.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/main/resources/application.properties b/eip-splitter/src/main/resources/application.properties
index 34febce1a..ca07b459e 100644
--- a/eip-splitter/src/main/resources/application.properties
+++ b/eip-splitter/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
index d5936282e..c9ba7d17b 100644
--- a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
+++ b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
index 037954609..cdd930985 100644
--- a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
+++ b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-splitter/src/test/resources/application-test.properties b/eip-splitter/src/test/resources/application-test.properties
index 0cab1156b..843005704 100644
--- a/eip-splitter/src/test/resources/application-test.properties
+++ b/eip-splitter/src/test/resources/application-test.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/pom.xml b/eip-wire-tap/pom.xml
index 332861547..365f793dd 100644
--- a/eip-wire-tap/pom.xml
+++ b/eip-wire-tap/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/App.java b/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/App.java
index f3b5c11c1..7940d3e5e 100644
--- a/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/App.java
+++ b/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/routes/WireTapRoute.java b/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/routes/WireTapRoute.java
index 8eea7adbd..39d89e738 100644
--- a/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/routes/WireTapRoute.java
+++ b/eip-wire-tap/src/main/java/com/iluwatar/eip/wiretap/routes/WireTapRoute.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/main/resources/application.properties b/eip-wire-tap/src/main/resources/application.properties
index 13e13b959..cb77786ed 100644
--- a/eip-wire-tap/src/main/resources/application.properties
+++ b/eip-wire-tap/src/main/resources/application.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
index 8be8bcbe7..20fc2a8bc 100644
--- a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
+++ b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
index 0d13374dc..2323d8bf9 100644
--- a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
+++ b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/eip-wire-tap/src/test/resources/application-test.properties b/eip-wire-tap/src/test/resources/application-test.properties
index a64f4b316..801b7c928 100644
--- a/eip-wire-tap/src/test/resources/application-test.properties
+++ b/eip-wire-tap/src/test/resources/application-test.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml
index 813521c48..e9b712f37 100644
--- a/event-aggregator/pom.xml
+++ b/event-aggregator/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
index 4ddcb9d2b..fb7193b2e 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
index 91bb020ee..be74d14e6 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
index 7d3f32a68..79093885d 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
index db436b50c..a1e8c3e29 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
index 23940c0a2..014ca89c0 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
index e6e05cb8d..192e9681a 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
index 4b0f4c898..b00a05330 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
index 0e92580ea..b56635eab 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
index 00b4a7a49..88061e40e 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
index 1e0ce9491..fcd367e25 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
index e56bc9d7f..f92358b2b 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
index f0de726f3..dcf1c71e3 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
index 59034366a..891bbd10c 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
index f8aa5cb37..deb468e40 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
index 08af63f9a..8a8d4eaef 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
index f28f52b63..5fe55f136 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
index 47208900a..c00c9002e 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
index 985d6ccbd..90bb8e45c 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
index 411bb9bc3..47d1d015e 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/pom.xml b/event-asynchronous/pom.xml
index 06921a100..b9b505557 100644
--- a/event-asynchronous/pom.xml
+++ b/event-asynchronous/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
index 341a47c8e..79159314f 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
index 68c4c9781..323689e5d 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventDoesNotExistException.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventDoesNotExistException.java
index fdd075d7b..1fc40dd9a 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventDoesNotExistException.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventDoesNotExistException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
index 55671fd82..400920705 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/IEvent.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/IEvent.java
index 37cce70b4..28cdb34f0 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/IEvent.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/IEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/InvalidOperationException.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/InvalidOperationException.java
index 6c0167850..349d31b80 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/InvalidOperationException.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/InvalidOperationException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/LongRunningEventException.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/LongRunningEventException.java
index aac69e312..3ef450359 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/LongRunningEventException.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/LongRunningEventException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/MaxNumOfEventsAllowedException.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/MaxNumOfEventsAllowedException.java
index 204f07dd6..49ccf452f 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/MaxNumOfEventsAllowedException.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/MaxNumOfEventsAllowedException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/ThreadCompleteListener.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/ThreadCompleteListener.java
index 290e93434..a2f7a5733 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/ThreadCompleteListener.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/ThreadCompleteListener.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/main/resources/config.properties b/event-asynchronous/src/main/resources/config.properties
index 10f048ad3..9b05b1c77 100644
--- a/event-asynchronous/src/main/resources/config.properties
+++ b/event-asynchronous/src/main/resources/config.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
index 638e77f87..a1145c5ef 100644
--- a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
+++ b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
index 26253f6cc..a590d2be8 100644
--- a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
+++ b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/pom.xml b/event-driven-architecture/pom.xml
index c40a8821b..01f750bb8 100644
--- a/event-driven-architecture/pom.xml
+++ b/event-driven-architecture/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/App.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/App.java
index 33374a58d..01b4791ed 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/App.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/AbstractEvent.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/AbstractEvent.java
index 011cfc3f1..1fbad77fd 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/AbstractEvent.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/AbstractEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
index dd5e65a9a..9b11125dd 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
index 05370c6a6..6df09f97d 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Event.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Event.java
index d6c1e6725..9f2dca00d 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Event.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Event.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/EventDispatcher.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/EventDispatcher.java
index 74a7ee145..0c0be197c 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/EventDispatcher.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/EventDispatcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Handler.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Handler.java
index 3d385007e..649ed203e 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Handler.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/framework/Handler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
index fde830bdf..e8805d90f 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
index 5dc2fb8ab..ee2b64ac0 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
index 0c9f12501..43bd8da49 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
index eb944a22c..11f16e085 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
index bbd74fcdb..97c368513 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
index f45eca703..7d0fb2346 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-queue/pom.xml b/event-queue/pom.xml
index 232b9abaa..55cfabbd3 100644
--- a/event-queue/pom.xml
+++ b/event-queue/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/App.java b/event-queue/src/main/java/com/iluwatar/event/queue/App.java
index 368eb1ccb..2987d0e06 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/App.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java b/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
index a0ff5d987..1b97095c7 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java b/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
index ae1de3fdf..da462c74c 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java b/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
index 2ae4ef0af..bfe16c839 100644
--- a/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
+++ b/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/pom.xml b/event-sourcing/pom.xml
index 44af5fc5e..ee05ed8a9 100644
--- a/event-sourcing/pom.xml
+++ b/event-sourcing/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
index 8cebeea38..dd67366ee 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
index 34ca628f2..bb4ba7e12 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
index 0077b214b..1d7b042dd 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
index 69febd48d..059970f6d 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
index 86b3f0c0e..9acf0d506 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
index c72dd9b59..b76f8e22f 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/DomainEventProcessor.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/DomainEventProcessor.java
index bc37a8872..c4dd47612 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/DomainEventProcessor.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/DomainEventProcessor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/JsonFileJournal.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/JsonFileJournal.java
index 4fb10821f..925f7ca94 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/JsonFileJournal.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/processor/JsonFileJournal.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/state/AccountAggregate.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/state/AccountAggregate.java
index d040acc04..4bdbb0da3 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/state/AccountAggregate.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/state/AccountAggregate.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/event-sourcing/src/test/java/IntegrationTest.java b/event-sourcing/src/test/java/IntegrationTest.java
index e3bac5c8f..dfa405809 100644
--- a/event-sourcing/src/test/java/IntegrationTest.java
+++ b/event-sourcing/src/test/java/IntegrationTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/pom.xml b/execute-around/pom.xml
index 2d0640fe0..4e04cb624 100644
--- a/execute-around/pom.xml
+++ b/execute-around/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/App.java b/execute-around/src/main/java/com/iluwatar/execute/around/App.java
index b86034625..f3de8d450 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/App.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
index 5f850862d..7cd4c3687 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
index 4c019035b..f84b7427d 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
index 6516ede4a..55ec49587 100644
--- a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
+++ b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
index 9bbd89963..621dccee6 100644
--- a/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
+++ b/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/pom.xml b/extension-objects/pom.xml
index 7247a9676..28c5d0ab7 100644
--- a/extension-objects/pom.xml
+++ b/extension-objects/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/App.java b/extension-objects/src/main/java/App.java
index 89b17b85b..e4d822099 100644
--- a/extension-objects/src/main/java/App.java
+++ b/extension-objects/src/main/java/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/abstractextensions/CommanderExtension.java b/extension-objects/src/main/java/abstractextensions/CommanderExtension.java
index 2337bf8c6..edce64089 100644
--- a/extension-objects/src/main/java/abstractextensions/CommanderExtension.java
+++ b/extension-objects/src/main/java/abstractextensions/CommanderExtension.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/abstractextensions/SergeantExtension.java b/extension-objects/src/main/java/abstractextensions/SergeantExtension.java
index 0993b7431..a01417a3e 100644
--- a/extension-objects/src/main/java/abstractextensions/SergeantExtension.java
+++ b/extension-objects/src/main/java/abstractextensions/SergeantExtension.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/abstractextensions/SoldierExtension.java b/extension-objects/src/main/java/abstractextensions/SoldierExtension.java
index 8865ae60f..043ea6dfd 100644
--- a/extension-objects/src/main/java/abstractextensions/SoldierExtension.java
+++ b/extension-objects/src/main/java/abstractextensions/SoldierExtension.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/abstractextensions/UnitExtension.java b/extension-objects/src/main/java/abstractextensions/UnitExtension.java
index d0f237f7b..785d45c45 100644
--- a/extension-objects/src/main/java/abstractextensions/UnitExtension.java
+++ b/extension-objects/src/main/java/abstractextensions/UnitExtension.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/concreteextensions/Commander.java b/extension-objects/src/main/java/concreteextensions/Commander.java
index ffd46dd25..6981d303c 100644
--- a/extension-objects/src/main/java/concreteextensions/Commander.java
+++ b/extension-objects/src/main/java/concreteextensions/Commander.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/concreteextensions/Sergeant.java b/extension-objects/src/main/java/concreteextensions/Sergeant.java
index aea2ddaca..97dc80443 100644
--- a/extension-objects/src/main/java/concreteextensions/Sergeant.java
+++ b/extension-objects/src/main/java/concreteextensions/Sergeant.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/concreteextensions/Soldier.java b/extension-objects/src/main/java/concreteextensions/Soldier.java
index 3ceaa7880..65f50f254 100644
--- a/extension-objects/src/main/java/concreteextensions/Soldier.java
+++ b/extension-objects/src/main/java/concreteextensions/Soldier.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/units/CommanderUnit.java b/extension-objects/src/main/java/units/CommanderUnit.java
index 3d8a5bc2f..00ed50c76 100644
--- a/extension-objects/src/main/java/units/CommanderUnit.java
+++ b/extension-objects/src/main/java/units/CommanderUnit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/units/SergeantUnit.java b/extension-objects/src/main/java/units/SergeantUnit.java
index b1e7397c8..a2c4c3adb 100644
--- a/extension-objects/src/main/java/units/SergeantUnit.java
+++ b/extension-objects/src/main/java/units/SergeantUnit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/units/SoldierUnit.java b/extension-objects/src/main/java/units/SoldierUnit.java
index 721c51eff..642741c93 100644
--- a/extension-objects/src/main/java/units/SoldierUnit.java
+++ b/extension-objects/src/main/java/units/SoldierUnit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/main/java/units/Unit.java b/extension-objects/src/main/java/units/Unit.java
index dc339e228..799a473a4 100644
--- a/extension-objects/src/main/java/units/Unit.java
+++ b/extension-objects/src/main/java/units/Unit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/AppTest.java b/extension-objects/src/test/java/AppTest.java
index 321bf758f..9cfb5db22 100644
--- a/extension-objects/src/test/java/AppTest.java
+++ b/extension-objects/src/test/java/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/concreteextensions/CommanderTest.java b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
index 0c9d00baf..4378131e6 100644
--- a/extension-objects/src/test/java/concreteextensions/CommanderTest.java
+++ b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/concreteextensions/SergeantTest.java b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
index 3970a5c80..0d24d0fe3 100644
--- a/extension-objects/src/test/java/concreteextensions/SergeantTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/concreteextensions/SoldierTest.java b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
index 98224e848..48af362c1 100644
--- a/extension-objects/src/test/java/concreteextensions/SoldierTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/units/CommanderUnitTest.java b/extension-objects/src/test/java/units/CommanderUnitTest.java
index 0b35fbe9a..11fc84240 100644
--- a/extension-objects/src/test/java/units/CommanderUnitTest.java
+++ b/extension-objects/src/test/java/units/CommanderUnitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/units/SergeantUnitTest.java b/extension-objects/src/test/java/units/SergeantUnitTest.java
index 52edadf99..3afa2cc81 100644
--- a/extension-objects/src/test/java/units/SergeantUnitTest.java
+++ b/extension-objects/src/test/java/units/SergeantUnitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/units/SoldierUnitTest.java b/extension-objects/src/test/java/units/SoldierUnitTest.java
index a38401124..51c8c63ca 100644
--- a/extension-objects/src/test/java/units/SoldierUnitTest.java
+++ b/extension-objects/src/test/java/units/SoldierUnitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/extension-objects/src/test/java/units/UnitTest.java b/extension-objects/src/test/java/units/UnitTest.java
index f65ed3f0f..cbb90ff24 100644
--- a/extension-objects/src/test/java/units/UnitTest.java
+++ b/extension-objects/src/test/java/units/UnitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/pom.xml b/facade/pom.xml
index cf73e6a43..d98c074e3 100644
--- a/facade/pom.xml
+++ b/facade/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/App.java b/facade/src/main/java/com/iluwatar/facade/App.java
index d77695b28..648b0b058 100644
--- a/facade/src/main/java/com/iluwatar/facade/App.java
+++ b/facade/src/main/java/com/iluwatar/facade/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
index 8c40fffab..db383e47b 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
index 4d41a4633..6a1a8f057 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
index 0cc91f29d..77218f828 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
index d52291ad4..a6b832cd1 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
index 08cd3a15c..2fea7955a 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/test/java/com/iluwatar/facade/AppTest.java b/facade/src/test/java/com/iluwatar/facade/AppTest.java
index 7e2d389dc..fe06980e1 100644
--- a/facade/src/test/java/com/iluwatar/facade/AppTest.java
+++ b/facade/src/test/java/com/iluwatar/facade/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java b/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
index 10d6e1ecd..d93ba2a5e 100644
--- a/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
+++ b/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/pom.xml b/factory-kit/pom.xml
index 987bbdb24..0e83283a0 100644
--- a/factory-kit/pom.xml
+++ b/factory-kit/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/App.java b/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
index a47ee3822..580e60006 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java
index 288026061..a2fc46643 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Axe.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java
index 24795eafa..d5a4a813b 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Bow.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java
index da43e644e..cd58e11d5 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Builder.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java
index 52d26613a..b2cb98271 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Spear.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java
index ea41e4ce5..fecbe7cdf 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Sword.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java b/factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java
index fd8f590a8..229e2bf06 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/Weapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java
index cf520dc05..70c56272d 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
index 9d59050c3..cc4a1df1f 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java b/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
index 99477aaf0..cdbf74d68 100644
--- a/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
+++ b/factory-kit/src/test/java/com/iluwatar/factorykit/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java b/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
index fd8241efe..f05dd4f8a 100644
--- a/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
+++ b/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/pom.xml b/factory-method/pom.xml
index c49fae691..325a00c7f 100644
--- a/factory-method/pom.xml
+++ b/factory-method/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
index 1bfd82457..ee92abe24 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/App.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
index 7f3eafd60..fdfe72cb9 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
index 99ebcef65..4c49ebaa3 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
index 208dfa277..e3b436554 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
index ea99200de..d97bfc92a 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
index af1ee5bcf..c3a9c8688 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java
index 8094c6f73..cb88518d9 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
index 6c7c86712..b600f5a25 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
index 8756ba0aa..2e6b76579 100644
--- a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
+++ b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
index 68960204a..f7bbf6f97 100644
--- a/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
+++ b/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/pom.xml b/factory/pom.xml
index 17c6863af..8167403cd 100644
--- a/factory/pom.xml
+++ b/factory/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/App.java b/factory/src/main/java/com/iluwatar/factory/App.java
index 22c50d86d..554baeeb1 100644
--- a/factory/src/main/java/com/iluwatar/factory/App.java
+++ b/factory/src/main/java/com/iluwatar/factory/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/Car.java b/factory/src/main/java/com/iluwatar/factory/Car.java
index 22b615342..e1f82d41e 100644
--- a/factory/src/main/java/com/iluwatar/factory/Car.java
+++ b/factory/src/main/java/com/iluwatar/factory/Car.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/CarType.java b/factory/src/main/java/com/iluwatar/factory/CarType.java
index 4855cb89b..33d5a521a 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarType.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
index 0274ecc2e..a802da039 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/Ferrari.java b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
index 03a91ec28..294a04fcc 100644
--- a/factory/src/main/java/com/iluwatar/factory/Ferrari.java
+++ b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/main/java/com/iluwatar/factory/Ford.java b/factory/src/main/java/com/iluwatar/factory/Ford.java
index 9a94bb04f..d1091a00b 100644
--- a/factory/src/main/java/com/iluwatar/factory/Ford.java
+++ b/factory/src/main/java/com/iluwatar/factory/Ford.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/test/java/com/iluwatar/factory/AppTest.java b/factory/src/test/java/com/iluwatar/factory/AppTest.java
index 1bc16a734..69a581e88 100644
--- a/factory/src/test/java/com/iluwatar/factory/AppTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
index f69bd1632..b93ca91f5 100644
--- a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/pom.xml b/feature-toggle/pom.xml
index 1818d882d..b20d05afa 100644
--- a/feature-toggle/pom.xml
+++ b/feature-toggle/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
index ceb926b63..e00fb45a4 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/Service.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/Service.java
index bd276f592..e6f618ae8 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/Service.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/Service.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
index ed6e69518..631f90687 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersion.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersion.java
index 448218070..ee401c309 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersion.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
index 7924f86e8..7c7dc5d6b 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
index 7b644afd7..ec4e21a91 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
index 69641a7ad..9fa8d9052 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
index bb7195b7d..de45d9254 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
index 9bc29fabf..db1569cf4 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/pom.xml b/filterer/pom.xml
index 46042c1b0..19500b859 100644
--- a/filterer/pom.xml
+++ b/filterer/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/App.java b/filterer/src/main/java/com/iluwatar/filterer/App.java
index 43de5a646..2555dd7f8 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/App.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java b/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
index 17970c115..a9d3f9dc6 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/domain/Filterer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
index 3a2959828..9d6a9ce5e 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbabilisticThreatAwareSystem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
index 11e61dbf6..dec119f84 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ProbableThreat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
index 3991d975e..ea431042a 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
index 54da07873..5c1183fb2 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
index 08a8b0e17..ab1977bc8 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
index f1dec40ae..428521ad9 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
index 515b59332..7eeaa6be2 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/Threat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
index b889d537d..4e34c99dd 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatAwareSystem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
index 5f9a152a8..4c9a23b21 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/test/java/com/iluwatar/filterer/AppTest.java b/filterer/src/test/java/com/iluwatar/filterer/AppTest.java
index 551ebcc18..9ba98dd23 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/AppTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
index 2f14ca057..082496175 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
index ea918c9ec..9f93fa50f 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index 138dbfa12..8f5e8e175 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index 0222fc54a..c51c488c7 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
index 2ffa4d3dd..2b7963db5 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
index c0b52cec7..114697a93 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index 517e6b778..d6acd1771 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index b6a068653..0c6a3b4af 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
index 1b6671917..dbaaf7a70 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
index 2ae69eaf8..7eb2b59c1 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
index 902f68d84..9a88e5bba 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
index 1a956855e..85e358cf1 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/pom.xml b/flux/pom.xml
index 14f4f5557..2766081e8 100644
--- a/flux/pom.xml
+++ b/flux/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Action.java b/flux/src/main/java/com/iluwatar/flux/action/Action.java
index c8e2e012b..5dff8444b 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Action.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Action.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
index e84954efd..bb852279f 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Content.java b/flux/src/main/java/com/iluwatar/flux/action/Content.java
index 6fb2e3e0e..5832a0f45 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Content.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Content.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java b/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
index c70561a65..48b04addd 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java b/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
index f833a6187..f3e78a92a 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java b/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
index 90fac3e2e..ef1d2c530 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/app/App.java b/flux/src/main/java/com/iluwatar/flux/app/App.java
index 1344d9eaa..761da8823 100644
--- a/flux/src/main/java/com/iluwatar/flux/app/App.java
+++ b/flux/src/main/java/com/iluwatar/flux/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
index c43d87680..32381fafc 100644
--- a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
+++ b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java b/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
index 60d3faea0..62b4fa6b2 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java b/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
index 819500c8a..dff81ab96 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/store/Store.java b/flux/src/main/java/com/iluwatar/flux/store/Store.java
index 34188fff2..7f78781b3 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/Store.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/Store.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
index b71a2c53b..e194d46f9 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
index f4cdf7a4d..090cab5c7 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/main/java/com/iluwatar/flux/view/View.java b/flux/src/main/java/com/iluwatar/flux/view/View.java
index 94a3bfd09..ad509ed33 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/View.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/View.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java b/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
index f0f41f8ce..d99e17a13 100644
--- a/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java b/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
index 374f27daa..b8772b69c 100644
--- a/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
index 649708d8f..51831bbf9 100644
--- a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java b/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
index 5212a57d8..b8491b514 100644
--- a/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java b/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
index cca59a5ab..264502e3e 100644
--- a/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java b/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
index 24a05f486..1a3be2fa4 100644
--- a/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java b/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
index 15ffc48d0..11b69857f 100644
--- a/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java b/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
index 2efe0ba02..6813c61b7 100644
--- a/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/pom.xml b/flyweight/pom.xml
index b9ffd42ae..128397cf6 100644
--- a/flyweight/pom.xml
+++ b/flyweight/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
index e7af8ee00..140bad760 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/App.java b/flyweight/src/main/java/com/iluwatar/flyweight/App.java
index 8f5ff8742..1982d376e 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/App.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
index 8a02b7007..368c25326 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
index ebe0c88d4..30c980769 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
index 3a3b2d638..8ae18279e 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
index 4641e7986..816c8634b 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java b/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
index ac89dd1bb..98a552891 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java b/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
index a731c0359..a9a7edacc 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java b/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
index 84cf5fbc0..1a7f3bcc5 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
index c8011b4f7..bceccfe01 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
index 50053dddf..83516e8a3 100644
--- a/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
+++ b/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
index 5f957c794..402e2cc07 100644
--- a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
+++ b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/pom.xml b/front-controller/pom.xml
index a90029a82..55009eeb7 100644
--- a/front-controller/pom.xml
+++ b/front-controller/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/App.java b/front-controller/src/main/java/com/iluwatar/front/controller/App.java
index d1a77887f..5b1b8e8d7 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/App.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java
index 46949f879..ebc00267b 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java
index 46509476d..f5548b557 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
index d767dd80f..7f567c8c4 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java
index 29f66502a..0c0347b88 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
index 58cbf282c..9f23fb608 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/Command.java b/front-controller/src/main/java/com/iluwatar/front/controller/Command.java
index 04d42f4f2..7b8a22b76 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/Command.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/Command.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
index c7c012a31..22757514a 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java b/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java
index acdb7b1c8..ad0bcd38f 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java
index b03a3dd1f..cbf68961a 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/View.java b/front-controller/src/main/java/com/iluwatar/front/controller/View.java
index 8b46637d3..49f085c05 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/View.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/View.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
index cf33bfb48..bffda6eb6 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
index 165d13f44..15ccd5caa 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/CommandTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/CommandTest.java
index 46a3ae94b..472e88f8d 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/CommandTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/CommandTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/FrontControllerTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/FrontControllerTest.java
index eac3ae3bc..963b017af 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/FrontControllerTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/FrontControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/ViewTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/ViewTest.java
index 6839d4ad0..e88c6fc0a 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/ViewTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/ViewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/utils/InMemoryAppender.java b/front-controller/src/test/java/com/iluwatar/front/controller/utils/InMemoryAppender.java
index 8cbf7c631..e129038ea 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/utils/InMemoryAppender.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/pom.xml b/game-loop/pom.xml
index 6935c1fd1..5dba93496 100644
--- a/game-loop/pom.xml
+++ b/game-loop/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/App.java b/game-loop/src/main/java/com/iluwatar/gameloop/App.java
index 4d9e4c11d..cccba9098 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/App.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/Bullet.java b/game-loop/src/main/java/com/iluwatar/gameloop/Bullet.java
index 69b93bc74..bd8fb44ff 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/Bullet.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/Bullet.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/FixedStepGameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/FixedStepGameLoop.java
index 07ad21584..cd69e4550 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/FixedStepGameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/FixedStepGameLoop.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/FrameBasedGameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/FrameBasedGameLoop.java
index 45c59168f..eeffe744c 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/FrameBasedGameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/FrameBasedGameLoop.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/GameController.java b/game-loop/src/main/java/com/iluwatar/gameloop/GameController.java
index 00c65332b..fa2eeb6b5 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/GameController.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/GameController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
index 5f47ef1dd..1ed1e9771 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/GameStatus.java b/game-loop/src/main/java/com/iluwatar/gameloop/GameStatus.java
index 46d90669e..f13c351d7 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/GameStatus.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/GameStatus.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/VariableStepGameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/VariableStepGameLoop.java
index 544590c5b..371aa618b 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/VariableStepGameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/VariableStepGameLoop.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
index b163fe47c..e01bf0c1e 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
index 6999f44ae..6c282f7d5 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
index 0f2d58237..e6e7a75e7 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
index 19c4df1c6..d15bc4054 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
index 963c8d0b2..7edb65204 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
index 39ea03aca..ca2c0262b 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/guarded-suspension/pom.xml b/guarded-suspension/pom.xml
index f1bd31c66..4ddf29253 100644
--- a/guarded-suspension/pom.xml
+++ b/guarded-suspension/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/App.java b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/App.java
index 7e300575d..be2f22cb1 100644
--- a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/App.java
+++ b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
index 0102c5253..abc124be1 100644
--- a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
+++ b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java b/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
index 38d451ced..683f3c1e1 100644
--- a/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
+++ b/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index 635b76172..7a383b4f7 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
index d013924cb..de4591a22 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
index c310d8015..df2f5f5a9 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
index 32f5e9d4a..6361e5d41 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
index 395599927..a0b799db2 100644
--- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
+++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
index 91f9f9e2d..05c2272b6 100644
--- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
+++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/pom.xml b/hexagonal/pom.xml
index f51825d5f..bbd6e27b6 100644
--- a/hexagonal/pom.xml
+++ b/hexagonal/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/App.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/App.java
index 1733ea2ea..28482965e 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/App.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
index 4a62d2d90..f14e6925f 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrv.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrv.java
index ec6f815c3..4fa878458 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrv.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrv.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrvImpl.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrvImpl.java
index 7de34ca15..854b55b36 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrvImpl.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministrationSrvImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/InMemoryBank.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/InMemoryBank.java
index 746b93508..95d1ffae4 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/InMemoryBank.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/InMemoryBank.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/MongoBank.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/MongoBank.java
index b34da3e17..2af25f315 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/MongoBank.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/MongoBank.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/WireTransfers.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/WireTransfers.java
index fad455b9b..55b9595b9 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/WireTransfers.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/banking/WireTransfers.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/InMemoryTicketRepository.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/InMemoryTicketRepository.java
index 5c0461843..f46416e5f 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/InMemoryTicketRepository.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/InMemoryTicketRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/LotteryTicketRepository.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/LotteryTicketRepository.java
index e307004ed..4d436425a 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/LotteryTicketRepository.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/LotteryTicketRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
index 6d6c33239..728c2e057 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryAdministration.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryAdministration.java
index b174a4372..45183234f 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryAdministration.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryAdministration.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryConstants.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryConstants.java
index 06bf294ee..ff1a31362 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryConstants.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryConstants.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
index acdd2b8c5..3e46b8113 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryService.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryService.java
index cfd04c45f..b241ee3f2 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryService.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
index 86a5a5487..9017e4480 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
index 640300b62..5cc7bf6b2 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
index 114e78c9c..4ab167fce 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
index ce7cc8aef..562ca140d 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
index 70a2aa452..d40024a6a 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/LotteryEventLog.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/LotteryEventLog.java
index 993f2a344..393441e35 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/LotteryEventLog.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/LotteryEventLog.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
index 62fcf32b4..e12eefd65 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/MongoEventLog.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
index 474ab980e..4bee37103 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryModule.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryModule.java
index 73cf16805..6704e4f7a 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryModule.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryModule.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryTestingModule.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryTestingModule.java
index f416ffcc2..9058a1492 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryTestingModule.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/module/LotteryTestingModule.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/MongoConnectionPropertiesLoader.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/MongoConnectionPropertiesLoader.java
index c5888cd8f..e09331baa 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/MongoConnectionPropertiesLoader.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/mongo/MongoConnectionPropertiesLoader.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
index 42e49713d..130f3b92e 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
index d77204b92..bc17c3662 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleService.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleService.java
index b5bd01a66..e47bbd691 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleService.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleServiceImpl.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleServiceImpl.java
index c32ede62e..6bfe477c1 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleServiceImpl.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/LotteryConsoleServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
index d2ad89c9b..7a8e2f13b 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/InMemoryBankTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/InMemoryBankTest.java
index 5c8ca44e4..e24345a09 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/InMemoryBankTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/InMemoryBankTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/MongoBankTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/MongoBankTest.java
index b6a7e2a37..990c8cd4a 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/MongoBankTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/banking/MongoBankTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/InMemoryTicketRepositoryTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/InMemoryTicketRepositoryTest.java
index d016b0966..261c24ec6 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/InMemoryTicketRepositoryTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/InMemoryTicketRepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
index e926e1afb..eb9369ef6 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryNumbersTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryNumbersTest.java
index 696fd0f98..c49574665 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryNumbersTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryNumbersTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTest.java
index 541b2b98b..b7f16f8bb 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResultTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResultTest.java
index 4ad872f69..a55ba39a5 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResultTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResultTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketIdTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketIdTest.java
index e6815ea08..bae49f993 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketIdTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketIdTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketTest.java
index 445bdd27c..79fdabf8c 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/LotteryTicketTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/PlayerDetailsTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/PlayerDetailsTest.java
index ba6b5f557..e7c4ca789 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/PlayerDetailsTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/domain/PlayerDetailsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/MongoEventLogTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/MongoEventLogTest.java
index b0c4e1383..ecd083ad9 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/MongoEventLogTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/eventlog/MongoEventLogTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/test/LotteryTestUtils.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/test/LotteryTestUtils.java
index 4686478d3..8eb7d42cd 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/test/LotteryTestUtils.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/test/LotteryTestUtils.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml
index d8ee9985f..f2a2aba26 100644
--- a/intercepting-filter/pom.xml
+++ b/intercepting-filter/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
index aa20365f6..8ad3e094a 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
index 5f13aa7d7..9d0271009 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
index db1c4830f..5adb771b7 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
index 52aa890c1..f93558108 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
index 0e76ac1c0..50b97b5b8 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
index da802616d..a80db7e39 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
index 76afdedbd..94d1f44e4 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
index 07429ca5f..befd61a72 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
index 91e438882..6314b568d 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
index 358c9fd85..fc2c2c4d4 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
index a75911578..85a81bdfa 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
index c555322f7..39429d974 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
index db552356d..569aa3b31 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
index d8f22a478..df6c936da 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
index 605db4de2..1a94a8b80 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterTest.java
index 7a0ce9150..2035c471b 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
index 21643986e..ab08d2dfe 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/pom.xml b/interpreter/pom.xml
index d32c80839..56d1d5146 100644
--- a/interpreter/pom.xml
+++ b/interpreter/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/App.java b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
index 909c33345..c0c4dce63 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/App.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
index dee43b57f..b718ba7da 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
index 46b5c96cb..3c8b35e6f 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
index 926d6c119..a039603f0 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
index 908eec8d1..8529eb28b 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
index 38a8bb4af..65de6dd75 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
index f4fb45637..4b0681c9b 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/ExpressionTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/ExpressionTest.java
index 85f836dab..eda39f329 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/ExpressionTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/ExpressionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/MinusExpressionTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/MinusExpressionTest.java
index 19f74171b..24ad73c01 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/MinusExpressionTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/MinusExpressionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/MultiplyExpressionTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/MultiplyExpressionTest.java
index 678048e1c..2fdb22034 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/MultiplyExpressionTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/MultiplyExpressionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/NumberExpressionTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/NumberExpressionTest.java
index 16fc0a429..4bcbd4c44 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/NumberExpressionTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/NumberExpressionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/PlusExpressionTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/PlusExpressionTest.java
index 1f53f3606..ddc8759bd 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/PlusExpressionTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/PlusExpressionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/pom.xml b/iterator/pom.xml
index bca091f11..4e5a8b475 100644
--- a/iterator/pom.xml
+++ b/iterator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java
index 053b5c4fb..6141f7fcc 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/App.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/Iterator.java b/iterator/src/main/java/com/iluwatar/iterator/Iterator.java
index 5f399c5b8..950af106c 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/Iterator.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/Iterator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/bst/BstIterator.java b/iterator/src/main/java/com/iluwatar/iterator/bst/BstIterator.java
index 9f584cddc..547767028 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/bst/BstIterator.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/bst/BstIterator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/bst/TreeNode.java b/iterator/src/main/java/com/iluwatar/iterator/bst/TreeNode.java
index b0ec5f486..8000a47fd 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/bst/TreeNode.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/bst/TreeNode.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/list/Item.java b/iterator/src/main/java/com/iluwatar/iterator/list/Item.java
index 00d5625a8..c272bd43c 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/list/Item.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/list/Item.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/list/ItemType.java b/iterator/src/main/java/com/iluwatar/iterator/list/ItemType.java
index fc38046f7..1a755ada8 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/list/ItemType.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/list/ItemType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChest.java b/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChest.java
index 8eb4a8e18..125ff0903 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChest.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChestItemIterator.java b/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChestItemIterator.java
index a309b4ece..1bafb175a 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChestItemIterator.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/list/TreasureChestItemIterator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
index 2e0d28b67..c15d3a067 100644
--- a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
+++ b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/test/java/com/iluwatar/iterator/bst/BstIteratorTest.java b/iterator/src/test/java/com/iluwatar/iterator/bst/BstIteratorTest.java
index fba9ae8e3..d7970db32 100644
--- a/iterator/src/test/java/com/iluwatar/iterator/bst/BstIteratorTest.java
+++ b/iterator/src/test/java/com/iluwatar/iterator/bst/BstIteratorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/iterator/src/test/java/com/iluwatar/iterator/list/TreasureChestTest.java b/iterator/src/test/java/com/iluwatar/iterator/list/TreasureChestTest.java
index 5e4f85e6b..fd7583806 100644
--- a/iterator/src/test/java/com/iluwatar/iterator/list/TreasureChestTest.java
+++ b/iterator/src/test/java/com/iluwatar/iterator/list/TreasureChestTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/pom.xml b/layers/pom.xml
index 9c299d2ba..05392f78e 100644
--- a/layers/pom.xml
+++ b/layers/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/app/App.java b/layers/src/main/java/com/iluwatar/layers/app/App.java
index 8574b8d02..40e662551 100644
--- a/layers/src/main/java/com/iluwatar/layers/app/App.java
+++ b/layers/src/main/java/com/iluwatar/layers/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dao/CakeDao.java b/layers/src/main/java/com/iluwatar/layers/dao/CakeDao.java
index 7013bd5dc..34bf9d407 100644
--- a/layers/src/main/java/com/iluwatar/layers/dao/CakeDao.java
+++ b/layers/src/main/java/com/iluwatar/layers/dao/CakeDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dao/CakeLayerDao.java b/layers/src/main/java/com/iluwatar/layers/dao/CakeLayerDao.java
index 5907ff7a7..bdfd04848 100644
--- a/layers/src/main/java/com/iluwatar/layers/dao/CakeLayerDao.java
+++ b/layers/src/main/java/com/iluwatar/layers/dao/CakeLayerDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dao/CakeToppingDao.java b/layers/src/main/java/com/iluwatar/layers/dao/CakeToppingDao.java
index cddac432e..49fbc0141 100644
--- a/layers/src/main/java/com/iluwatar/layers/dao/CakeToppingDao.java
+++ b/layers/src/main/java/com/iluwatar/layers/dao/CakeToppingDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dto/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/dto/CakeInfo.java
index 7db5fee71..4730cc8d5 100644
--- a/layers/src/main/java/com/iluwatar/layers/dto/CakeInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/dto/CakeInfo.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dto/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/dto/CakeLayerInfo.java
index 67774a408..30cd620b9 100644
--- a/layers/src/main/java/com/iluwatar/layers/dto/CakeLayerInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/dto/CakeLayerInfo.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/dto/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/dto/CakeToppingInfo.java
index 62dc5ccd2..5f0276146 100644
--- a/layers/src/main/java/com/iluwatar/layers/dto/CakeToppingInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/dto/CakeToppingInfo.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/entity/Cake.java b/layers/src/main/java/com/iluwatar/layers/entity/Cake.java
index 83511d158..a7aef2d8d 100644
--- a/layers/src/main/java/com/iluwatar/layers/entity/Cake.java
+++ b/layers/src/main/java/com/iluwatar/layers/entity/Cake.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/entity/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/entity/CakeLayer.java
index 3e3ab8a0e..c84d21a26 100644
--- a/layers/src/main/java/com/iluwatar/layers/entity/CakeLayer.java
+++ b/layers/src/main/java/com/iluwatar/layers/entity/CakeLayer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/entity/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/entity/CakeTopping.java
index ae5277499..8ac3f2ebd 100644
--- a/layers/src/main/java/com/iluwatar/layers/entity/CakeTopping.java
+++ b/layers/src/main/java/com/iluwatar/layers/entity/CakeTopping.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/exception/CakeBakingException.java b/layers/src/main/java/com/iluwatar/layers/exception/CakeBakingException.java
index a027fee98..a150d7c19 100644
--- a/layers/src/main/java/com/iluwatar/layers/exception/CakeBakingException.java
+++ b/layers/src/main/java/com/iluwatar/layers/exception/CakeBakingException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingService.java
index 1ccfa5cf8..326d18363 100644
--- a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingService.java
+++ b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
index 4694082fa..2af1541ea 100644
--- a/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/service/CakeBakingServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java b/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
index a5246e7db..76674c025 100644
--- a/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/java/com/iluwatar/layers/view/View.java b/layers/src/main/java/com/iluwatar/layers/view/View.java
index 0002b23f6..76e1b40ca 100644
--- a/layers/src/main/java/com/iluwatar/layers/view/View.java
+++ b/layers/src/main/java/com/iluwatar/layers/view/View.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/resources/META-INF/persistence.xml b/layers/src/main/resources/META-INF/persistence.xml
index 043a19e62..f796fe971 100644
--- a/layers/src/main/resources/META-INF/persistence.xml
+++ b/layers/src/main/resources/META-INF/persistence.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml
index f7c6f3530..dc83b92c8 100644
--- a/layers/src/main/resources/applicationContext.xml
+++ b/layers/src/main/resources/applicationContext.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/main/resources/logback.xml b/layers/src/main/resources/logback.xml
index 3093a63c9..941b75a9c 100644
--- a/layers/src/main/resources/logback.xml
+++ b/layers/src/main/resources/logback.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
index 105487683..22be5a810 100644
--- a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java b/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
index 586b0f503..106ef1e0f 100644
--- a/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java b/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
index 47fdc97cc..253a8634f 100644
--- a/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java b/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
index bd06e42ce..465d8f034 100644
--- a/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java b/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
index 3c13966de..ed0ff3803 100644
--- a/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml
index 49421edc2..f49ba2970 100644
--- a/lazy-loading/pom.xml
+++ b/lazy-loading/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
index fea535acc..a4b268403 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
index dea2d6341..f0cbc6e93 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
index c18ced6d4..d42f09ecb 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
index ef6d5e663..7a3196172 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
index 395dfb81c..ba0c2de40 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
index c47377cf4..5e46ab678 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
index 74c324b24..6a3f6ccac 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderNaiveTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderNaiveTest.java
index 05dfcaf2a..161028da3 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderNaiveTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderNaiveTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
index 2589927a6..d45f7ccf6 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/Java8HolderTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/Java8HolderTest.java
index e4e294268..d098880e0 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/Java8HolderTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/Java8HolderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/pom.xml b/leader-election/pom.xml
index 78ad13e4d..5b16c097d 100644
--- a/leader-election/pom.xml
+++ b/leader-election/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
index 94db89ef7..0a26808e9 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractMessageManager.java b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractMessageManager.java
index 4842d32b2..f7c348ded 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractMessageManager.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractMessageManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/Instance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/Instance.java
index 3ea57c04b..c5bf77783 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/Instance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/Instance.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java b/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
index 99b8d424e..b6fa0f9a8 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/MessageManager.java b/leader-election/src/main/java/com/iluwatar/leaderelection/MessageManager.java
index 9f10de22e..e246af077 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/MessageManager.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/MessageManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/MessageType.java b/leader-election/src/main/java/com/iluwatar/leaderelection/MessageType.java
index a82bfa38f..eec60949b 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/MessageType.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/MessageType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyApp.java b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyApp.java
index 33df1e941..72cc9037e 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyApp.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyApp.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
index 3181791d4..acf50faa9 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyMessageManager.java b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyMessageManager.java
index 2a306c09c..3d13418a1 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyMessageManager.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyMessageManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingApp.java b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingApp.java
index 646fafccf..67cea3b23 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingApp.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingApp.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
index 2d2d0ae1a..a7c4a4551 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingMessageManager.java b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingMessageManager.java
index ef147fe63..f8d230ed4 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingMessageManager.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingMessageManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
index a1c8ce86d..ce36ccc2f 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
index 19497a32c..713ecb0c6 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyAppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
index eb5adda58..de1cdc480 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
index 40e18b8c0..b6836983b 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
index ce5c59aa7..f07d95c95 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingAppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
index 05e9afa3a..69bc636de 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
index 1ac8b4b87..fe4590a02 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/pom.xml b/leader-followers/pom.xml
index 42e552ac8..56db4e5f2 100644
--- a/leader-followers/pom.xml
+++ b/leader-followers/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
index 2a4d716ef..924483e0b 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java
index 7d91e40cc..7d6c1447e 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Task.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
index 5dfd67d69..81f2ed044 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java
index 3461bc8c0..3719c0814 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskSet.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java
index 935462037..39ef95648 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/WorkCenter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
index 6912af89b..773eb1c6a 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/test/java/com/AppTest.java b/leader-followers/src/test/java/com/AppTest.java
index 3d0588fef..f586db96d 100644
--- a/leader-followers/src/test/java/com/AppTest.java
+++ b/leader-followers/src/test/java/com/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/test/java/com/TaskHandlerTest.java b/leader-followers/src/test/java/com/TaskHandlerTest.java
index 7dc44c04f..0b82e39a6 100644
--- a/leader-followers/src/test/java/com/TaskHandlerTest.java
+++ b/leader-followers/src/test/java/com/TaskHandlerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/test/java/com/TaskSetTest.java b/leader-followers/src/test/java/com/TaskSetTest.java
index e3691d220..bfc2c35a9 100644
--- a/leader-followers/src/test/java/com/TaskSetTest.java
+++ b/leader-followers/src/test/java/com/TaskSetTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/leader-followers/src/test/java/com/WorkCenterTest.java b/leader-followers/src/test/java/com/WorkCenterTest.java
index 41e9ff43f..d35a26296 100644
--- a/leader-followers/src/test/java/com/WorkCenterTest.java
+++ b/leader-followers/src/test/java/com/WorkCenterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/license-plugin-header-style.xml b/license-plugin-header-style.xml
index db5e35461..085992740 100644
--- a/license-plugin-header-style.xml
+++ b/license-plugin-header-style.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/pom.xml b/marker/pom.xml
index 64b7243f3..73c89daa1 100644
--- a/marker/pom.xml
+++ b/marker/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/main/java/App.java b/marker/src/main/java/App.java
index 0908503e5..a9183459a 100644
--- a/marker/src/main/java/App.java
+++ b/marker/src/main/java/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/main/java/Guard.java b/marker/src/main/java/Guard.java
index 9e7b731b6..edf585263 100644
--- a/marker/src/main/java/Guard.java
+++ b/marker/src/main/java/Guard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/main/java/Permission.java b/marker/src/main/java/Permission.java
index 5395ccadf..586cd3459 100644
--- a/marker/src/main/java/Permission.java
+++ b/marker/src/main/java/Permission.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/main/java/Thief.java b/marker/src/main/java/Thief.java
index 0e4cf92e3..9f068d46f 100644
--- a/marker/src/main/java/Thief.java
+++ b/marker/src/main/java/Thief.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/test/java/AppTest.java b/marker/src/test/java/AppTest.java
index 17a13c167..3298e82ec 100644
--- a/marker/src/test/java/AppTest.java
+++ b/marker/src/test/java/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/test/java/GuardTest.java b/marker/src/test/java/GuardTest.java
index ae92c27dc..5ea0eb907 100644
--- a/marker/src/test/java/GuardTest.java
+++ b/marker/src/test/java/GuardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/marker/src/test/java/ThiefTest.java b/marker/src/test/java/ThiefTest.java
index dc081acf8..e1eaf1e40 100644
--- a/marker/src/test/java/ThiefTest.java
+++ b/marker/src/test/java/ThiefTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/pom.xml b/master-worker-pattern/pom.xml
index c6bc2facf..8a2174e54 100644
--- a/master-worker-pattern/pom.xml
+++ b/master-worker-pattern/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
index 592ba8c59..8f2c6296b 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayInput.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayInput.java
index c8e68f958..4014e64fc 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayInput.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayInput.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayResult.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayResult.java
index a26472e80..d3af6c119 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayResult.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayResult.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
index 5e695e5da..1be04a7aa 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Input.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Input.java
index 8d832f6c7..ecf95eae2 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Input.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Input.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Result.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Result.java
index 79bc14604..215b2756d 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Result.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/Result.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorker.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorker.java
index 86c1a5700..44b49a9e4 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorker.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/MasterWorker.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/MasterWorker.java
index 817fd65d3..2a80ac09a 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/MasterWorker.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/MasterWorker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/ArrayTransposeMaster.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/ArrayTransposeMaster.java
index 9bfbf200e..be47ad4b6 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/ArrayTransposeMaster.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/ArrayTransposeMaster.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/Master.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/Master.java
index 06ea3a8fe..ba530cd6c 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/Master.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemmaster/Master.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorker.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorker.java
index 3f2da0a0a..da43323fe 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorker.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/Worker.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/Worker.java
index 526299645..cd2452c4e 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/Worker.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/system/systemworkers/Worker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayInputTest.java b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayInputTest.java
index 1d3c7f0bc..e4aed40e8 100644
--- a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayInputTest.java
+++ b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayInputTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayUtilityMethodsTest.java b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayUtilityMethodsTest.java
index d25276572..4092bc902 100644
--- a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayUtilityMethodsTest.java
+++ b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/ArrayUtilityMethodsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorkerTest.java b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorkerTest.java
index 79838ed35..f021d31f8 100644
--- a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorkerTest.java
+++ b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/ArrayTransposeMasterWorkerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorkerTest.java b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorkerTest.java
index c4b210643..d1c25aa45 100644
--- a/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorkerTest.java
+++ b/master-worker-pattern/src/test/java/com/iluwatar/masterworker/system/systemworkers/ArrayTransposeWorkerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/pom.xml b/mediator/pom.xml
index ae802a349..f04de3ba4 100644
--- a/mediator/pom.xml
+++ b/mediator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Action.java b/mediator/src/main/java/com/iluwatar/mediator/Action.java
index 60ce3949a..7c2a388e2 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Action.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Action.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/App.java b/mediator/src/main/java/com/iluwatar/mediator/App.java
index 0e9021c0d..cde969b54 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/App.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java b/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
index 1e1d53fc3..b360b8e9d 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Hunter.java b/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
index 0711acf70..dcd1db961 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Party.java b/mediator/src/main/java/com/iluwatar/mediator/Party.java
index 52d91e21d..5c1f1e854 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Party.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Party.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java b/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
index f842a0f39..2e06abcfa 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
index c233a051a..ee1602ddc 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
index 2d025db0c..6ec619752 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Rogue.java b/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
index 568510236..a0eb6ac88 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Wizard.java b/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
index c138f0265..b96c7da6d 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
index 558ec4907..d3114f8b6 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java b/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
index d25562f84..293708890 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mediator/src/test/java/com/iluwatar/mediator/PartyMemberTest.java b/mediator/src/test/java/com/iluwatar/mediator/PartyMemberTest.java
index a0e722cfd..de6782164 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/PartyMemberTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/PartyMemberTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/pom.xml b/memento/pom.xml
index 596883819..db9492b5d 100644
--- a/memento/pom.xml
+++ b/memento/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/main/java/com/iluwatar/memento/App.java b/memento/src/main/java/com/iluwatar/memento/App.java
index 77cc0f214..217bb741a 100644
--- a/memento/src/main/java/com/iluwatar/memento/App.java
+++ b/memento/src/main/java/com/iluwatar/memento/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/main/java/com/iluwatar/memento/Star.java b/memento/src/main/java/com/iluwatar/memento/Star.java
index af1c98b04..c67885d81 100644
--- a/memento/src/main/java/com/iluwatar/memento/Star.java
+++ b/memento/src/main/java/com/iluwatar/memento/Star.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/main/java/com/iluwatar/memento/StarMemento.java b/memento/src/main/java/com/iluwatar/memento/StarMemento.java
index 7b7ccd3ec..5d1b78fdf 100644
--- a/memento/src/main/java/com/iluwatar/memento/StarMemento.java
+++ b/memento/src/main/java/com/iluwatar/memento/StarMemento.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/main/java/com/iluwatar/memento/StarType.java b/memento/src/main/java/com/iluwatar/memento/StarType.java
index 58fd935f2..6e5888342 100644
--- a/memento/src/main/java/com/iluwatar/memento/StarType.java
+++ b/memento/src/main/java/com/iluwatar/memento/StarType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/test/java/com/iluwatar/memento/AppTest.java b/memento/src/test/java/com/iluwatar/memento/AppTest.java
index 2d8a518e2..d82cdec1c 100644
--- a/memento/src/test/java/com/iluwatar/memento/AppTest.java
+++ b/memento/src/test/java/com/iluwatar/memento/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/memento/src/test/java/com/iluwatar/memento/StarTest.java b/memento/src/test/java/com/iluwatar/memento/StarTest.java
index aab59e9c3..b90a67768 100644
--- a/memento/src/test/java/com/iluwatar/memento/StarTest.java
+++ b/memento/src/test/java/com/iluwatar/memento/StarTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml
index 98c9dddfe..b106ab8e6 100644
--- a/model-view-controller/pom.xml
+++ b/model-view-controller/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
index cabc4d96f..be76f2082 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
index 64bae6e51..a146a59f5 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
index f96113574..18cb41ca8 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
index c80d0dba0..d61c2abf6 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
index da14b7c08..c19f1e188 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
index f15585cdd..fa5f6f46a 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
index ba00c38c5..22f5b61e8 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
index a0fdbf3ba..b01ffd219 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
index d106d0944..65cde953f 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
index 677ab436e..c820e5f1b 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
index c6314c1dd..59537f5b2 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/etc/data/test.txt b/model-view-presenter/etc/data/test.txt
index eb032e720..af31a07e0 100644
--- a/model-view-presenter/etc/data/test.txt
+++ b/model-view-presenter/etc/data/test.txt
@@ -1,6 +1,6 @@
 ====
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml
index ee309f292..d943c82d8 100644
--- a/model-view-presenter/pom.xml
+++ b/model-view-presenter/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
index ac3b83927..be1136c1f 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
index 7dd5dd215..f4978a51f 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
index f59bcdf6f..38473d718 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
index 5cd6580d9..909e4cd7d 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
index 1d3aa07fb..45c850216 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
index e381784c5..1473da2a1 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
index 6529cd18d..a2229d640 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
index 3787cd20b..e7a5abdc3 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
index 238d3a135..954c13817 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/module/pom.xml b/module/pom.xml
index 2dc3fe340..ec71b8fad 100644
--- a/module/pom.xml
+++ b/module/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/module/src/main/java/com/iluwatar/module/App.java b/module/src/main/java/com/iluwatar/module/App.java
index 0f89d8f89..1e406be70 100644
--- a/module/src/main/java/com/iluwatar/module/App.java
+++ b/module/src/main/java/com/iluwatar/module/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java b/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
index 7ca0d873d..32ae77db1 100644
--- a/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
+++ b/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/module/src/main/java/com/iluwatar/module/FileLoggerModule.java b/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
index 185bd0ae2..590988cbd 100644
--- a/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
+++ b/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/module/src/test/java/com/iluwatar/module/AppTest.java b/module/src/test/java/com/iluwatar/module/AppTest.java
index 4bf72fcb0..3ed46e7e6 100644
--- a/module/src/test/java/com/iluwatar/module/AppTest.java
+++ b/module/src/test/java/com/iluwatar/module/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java b/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
index 9899d4c5c..2386f16ad 100644
--- a/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
+++ b/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/pom.xml b/monad/pom.xml
index 2c21a28b3..779f788ac 100644
--- a/monad/pom.xml
+++ b/monad/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/main/java/com/iluwatar/monad/App.java b/monad/src/main/java/com/iluwatar/monad/App.java
index bb3315064..040161ef2 100644
--- a/monad/src/main/java/com/iluwatar/monad/App.java
+++ b/monad/src/main/java/com/iluwatar/monad/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/main/java/com/iluwatar/monad/Sex.java b/monad/src/main/java/com/iluwatar/monad/Sex.java
index cc772c340..5d9ac3d28 100644
--- a/monad/src/main/java/com/iluwatar/monad/Sex.java
+++ b/monad/src/main/java/com/iluwatar/monad/Sex.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/main/java/com/iluwatar/monad/User.java b/monad/src/main/java/com/iluwatar/monad/User.java
index 8644c4c0a..defd32a8d 100644
--- a/monad/src/main/java/com/iluwatar/monad/User.java
+++ b/monad/src/main/java/com/iluwatar/monad/User.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/main/java/com/iluwatar/monad/Validator.java b/monad/src/main/java/com/iluwatar/monad/Validator.java
index 47acc8a42..6dbc5365f 100644
--- a/monad/src/main/java/com/iluwatar/monad/Validator.java
+++ b/monad/src/main/java/com/iluwatar/monad/Validator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/test/java/com/iluwatar/monad/AppTest.java b/monad/src/test/java/com/iluwatar/monad/AppTest.java
index d56270173..41e60e980 100644
--- a/monad/src/test/java/com/iluwatar/monad/AppTest.java
+++ b/monad/src/test/java/com/iluwatar/monad/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monad/src/test/java/com/iluwatar/monad/MonadTest.java b/monad/src/test/java/com/iluwatar/monad/MonadTest.java
index afd5b50f8..da90f0dd0 100644
--- a/monad/src/test/java/com/iluwatar/monad/MonadTest.java
+++ b/monad/src/test/java/com/iluwatar/monad/MonadTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/pom.xml b/monostate/pom.xml
index 02e271931..701774e11 100644
--- a/monostate/pom.xml
+++ b/monostate/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/main/java/com/iluwatar/monostate/App.java b/monostate/src/main/java/com/iluwatar/monostate/App.java
index 9f5b2c173..feff63d20 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/App.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
index 7a784f514..6ccb209a7 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
index d7e4fcf8f..395823903 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Request.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
index cd08b2b29..e86a5f374 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Server.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
index d17a56bb9..427a6e920 100644
--- a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
+++ b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java b/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
index d62c029e2..e649ebb60 100644
--- a/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
+++ b/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/pom.xml b/multiton/pom.xml
index d1e4d50d5..52f0a8441 100644
--- a/multiton/pom.xml
+++ b/multiton/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/main/java/com/iluwatar/multiton/App.java b/multiton/src/main/java/com/iluwatar/multiton/App.java
index eb3e0313f..994424e34 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/App.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
index e08107eeb..c9b6c88b1 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/main/java/com/iluwatar/multiton/NazgulEnum.java b/multiton/src/main/java/com/iluwatar/multiton/NazgulEnum.java
index bb1454b9f..9c46a0016 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/NazgulEnum.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/NazgulEnum.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
index cce19c6ff..66c4ba47b 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
index 0496ebdaf..dd3f8af5d 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java b/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
index 4d107a181..18bdcf99a 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java b/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
index f900659a8..4563d7bcc 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/pom.xml b/mute-idiom/pom.xml
index 2bf95f070..1d5072929 100644
--- a/mute-idiom/pom.xml
+++ b/mute-idiom/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/main/java/com/iluwatar/mute/App.java b/mute-idiom/src/main/java/com/iluwatar/mute/App.java
index eca345014..773ea690b 100644
--- a/mute-idiom/src/main/java/com/iluwatar/mute/App.java
+++ b/mute-idiom/src/main/java/com/iluwatar/mute/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java b/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java
index f15153d00..6c48500f6 100644
--- a/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java
+++ b/mute-idiom/src/main/java/com/iluwatar/mute/CheckedRunnable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java b/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java
index 30e1698d5..971cd4254 100644
--- a/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java
+++ b/mute-idiom/src/main/java/com/iluwatar/mute/Mute.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java b/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java
index e56025ce4..8ab85f55b 100644
--- a/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java
+++ b/mute-idiom/src/main/java/com/iluwatar/mute/Resource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java b/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
index c5ce35582..bf632232f 100644
--- a/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
+++ b/mute-idiom/src/test/java/com/iluwatar/mute/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java b/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
index e92b26f9b..4cce97ff0 100644
--- a/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
+++ b/mute-idiom/src/test/java/com/iluwatar/mute/MuteTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml
index 1b1eb2266..08966fdfa 100644
--- a/naked-objects/dom/pom.xml
+++ b/naked-objects/dom/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/main/java/META-INF/persistence.xml b/naked-objects/dom/src/main/java/META-INF/persistence.xml
index fd916b045..e3e9382ad 100644
--- a/naked-objects/dom/src/main/java/META-INF/persistence.xml
+++ b/naked-objects/dom/src/main/java/META-INF/persistence.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
index f7a197326..d70857458 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
index d37879352..9d3cfc54f 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
index 43d96f280..089243228 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
index 88a4666e0..cf50ad8b2 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
index 5435325cf..126bae2e5 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
index 5fbcfde2b..0c090dd2e 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml
index a918e20de..66bf2b681 100644
--- a/naked-objects/fixture/pom.xml
+++ b/naked-objects/fixture/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
index d7da56858..34a72383c 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
index 0df939678..1bf8fb422 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
index b3cea73c4..1ded07107 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
index 5dc9a4785..ac559c807 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml
index b9482b292..012a44abd 100644
--- a/naked-objects/integtests/pom.xml
+++ b/naked-objects/integtests/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
index ad186d706..15a6ad4cc 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
index b3bd973bd..81d82b92b 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
index 142b0e9fb..1fb3d68e7 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
index 51253b667..1947aa9b4 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
index d92cfa881..d077528a1 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java
index 24d8d207c..939034311 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
index 819220344..3cf4efd18 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
index 2699c5aad..be4e5ccfd 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index e8b9b79c5..e5e8e9d2c 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/ide/intellij/launch/README.txt b/naked-objects/webapp/ide/intellij/launch/README.txt
index 2977f3068..eb87ef25d 100644
--- a/naked-objects/webapp/ide/intellij/launch/README.txt
+++ b/naked-objects/webapp/ide/intellij/launch/README.txt
@@ -1,6 +1,6 @@
 ====
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml b/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml
index c27b5fbdd..e2989e8cb 100644
--- a/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml
+++ b/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml b/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml
index 31995a187..f711783ad 100644
--- a/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml
+++ b/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml
index 3a817f9e2..6b760d72e 100644
--- a/naked-objects/webapp/pom.xml
+++ b/naked-objects/webapp/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
index 780e4027e..95cd3ea01 100644
--- a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
+++ b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html b/naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html
index e81389640..c74b3ec8a 100644
--- a/naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html
+++ b/naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties
index 2ebd42968..5736e399e 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties
index 594b97ede..e41b6b976 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties
index 572b2e194..cadad18ed 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties
index 34f639a54..706d5c7d9 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties
index b52c7fa6e..1be134dc8 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml b/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml
index 6a3ecd65d..d5dec5623 100644
--- a/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml
+++ b/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/about/index.html b/naked-objects/webapp/src/main/webapp/about/index.html
index 4579f3d0b..ce011a881 100644
--- a/naked-objects/webapp/src/main/webapp/about/index.html
+++ b/naked-objects/webapp/src/main/webapp/about/index.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/css/application.css b/naked-objects/webapp/src/main/webapp/css/application.css
index b41165a5c..ffbe7dfd6 100644
--- a/naked-objects/webapp/src/main/webapp/css/application.css
+++ b/naked-objects/webapp/src/main/webapp/css/application.css
@@ -1,6 +1,6 @@
 /**
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/naked-objects/webapp/src/main/webapp/scripts/application.js b/naked-objects/webapp/src/main/webapp/scripts/application.js
index 5ea0e2de6..eafb35275 100644
--- a/naked-objects/webapp/src/main/webapp/scripts/application.js
+++ b/naked-objects/webapp/src/main/webapp/scripts/application.js
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/pom.xml b/null-object/pom.xml
index 4317ee36a..1a2c93057 100644
--- a/null-object/pom.xml
+++ b/null-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/App.java b/null-object/src/main/java/com/iluwatar/nullobject/App.java
index cd35a3042..744cd2d5d 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/App.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/Node.java b/null-object/src/main/java/com/iluwatar/nullobject/Node.java
index 2abd4c304..5c447b0c7 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/Node.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/Node.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
index 41a3fe60b..5cbeda88f 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
index 472a1a2fd..c272de68e 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
index 27724a724..a7065269a 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java b/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
index 5862d1e1a..f3fb28ccd 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/NullNodeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java b/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
index 9a2b485d0..f51171946 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/pom.xml b/object-mother/pom.xml
index f9ca156ad..4afd67b0f 100644
--- a/object-mother/pom.xml
+++ b/object-mother/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/src/main/java/com/iluwatar/objectmother/King.java b/object-mother/src/main/java/com/iluwatar/objectmother/King.java
index 2bd6a39cd..58e4f885c 100644
--- a/object-mother/src/main/java/com/iluwatar/objectmother/King.java
+++ b/object-mother/src/main/java/com/iluwatar/objectmother/King.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/src/main/java/com/iluwatar/objectmother/Queen.java b/object-mother/src/main/java/com/iluwatar/objectmother/Queen.java
index 308760ba9..d171a7c3f 100644
--- a/object-mother/src/main/java/com/iluwatar/objectmother/Queen.java
+++ b/object-mother/src/main/java/com/iluwatar/objectmother/Queen.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/src/main/java/com/iluwatar/objectmother/Royalty.java b/object-mother/src/main/java/com/iluwatar/objectmother/Royalty.java
index 892a6301c..2fd15ac11 100644
--- a/object-mother/src/main/java/com/iluwatar/objectmother/Royalty.java
+++ b/object-mother/src/main/java/com/iluwatar/objectmother/Royalty.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/src/main/java/com/iluwatar/objectmother/RoyaltyObjectMother.java b/object-mother/src/main/java/com/iluwatar/objectmother/RoyaltyObjectMother.java
index ff4c8bf39..6dce4c4f2 100644
--- a/object-mother/src/main/java/com/iluwatar/objectmother/RoyaltyObjectMother.java
+++ b/object-mother/src/main/java/com/iluwatar/objectmother/RoyaltyObjectMother.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java b/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
index 525b8e24e..b167a06a0 100644
--- a/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
+++ b/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/pom.xml b/object-pool/pom.xml
index 0587c3968..4200200f9 100644
--- a/object-pool/pom.xml
+++ b/object-pool/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
index 48957ce24..4c544d8e0 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
index 43ac5d873..26423569a 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
index 09dedbab0..cce541008 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
index 8c038ce26..88355fa2a 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
index f36563a8c..fd90b48c9 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
index 880009f86..e78a895e2 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/pom.xml b/observer/pom.xml
index c558992ac..c5a2a5a3e 100644
--- a/observer/pom.xml
+++ b/observer/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/App.java b/observer/src/main/java/com/iluwatar/observer/App.java
index b8fd01f32..df8ac8dfc 100644
--- a/observer/src/main/java/com/iluwatar/observer/App.java
+++ b/observer/src/main/java/com/iluwatar/observer/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/Hobbits.java b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
index 5894c93a6..09ac75ceb 100644
--- a/observer/src/main/java/com/iluwatar/observer/Hobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/Orcs.java b/observer/src/main/java/com/iluwatar/observer/Orcs.java
index 1a955aafd..396ae78d8 100644
--- a/observer/src/main/java/com/iluwatar/observer/Orcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/Orcs.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/Weather.java b/observer/src/main/java/com/iluwatar/observer/Weather.java
index a0d80d6bc..70ad63345 100644
--- a/observer/src/main/java/com/iluwatar/observer/Weather.java
+++ b/observer/src/main/java/com/iluwatar/observer/Weather.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java b/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
index 53f331174..f33f1ff03 100644
--- a/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
+++ b/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/WeatherType.java b/observer/src/main/java/com/iluwatar/observer/WeatherType.java
index e11317c21..d96698d7c 100644
--- a/observer/src/main/java/com/iluwatar/observer/WeatherType.java
+++ b/observer/src/main/java/com/iluwatar/observer/WeatherType.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
index 90fd4e300..1e6f99aee 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
index bc49c4e30..59e4dfd54 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
index c8f7bc701..46d44bd83 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
index d90219c92..8561228e3 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
index 043e4dbb0..685f7cfbd 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Race.java b/observer/src/main/java/com/iluwatar/observer/generic/Race.java
index a6fc0a2a4..992cd831d 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Race.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Race.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/AppTest.java b/observer/src/test/java/com/iluwatar/observer/AppTest.java
index 6b1f426d6..e16a59872 100644
--- a/observer/src/test/java/com/iluwatar/observer/AppTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java b/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
index 345b8e331..67d3f2068 100644
--- a/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/OrcsTest.java b/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
index 65beeaf0e..40af6638a 100644
--- a/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/WeatherObserverTest.java b/observer/src/test/java/com/iluwatar/observer/WeatherObserverTest.java
index 7f9b3a790..1f077cc79 100644
--- a/observer/src/test/java/com/iluwatar/observer/WeatherObserverTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/WeatherObserverTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/WeatherTest.java b/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
index 90e090c8d..c2ca327e4 100644
--- a/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java b/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
index 756d72239..5fef1a3cd 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java b/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
index e45dd5c28..6f062e048 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/ObserverTest.java b/observer/src/test/java/com/iluwatar/observer/generic/ObserverTest.java
index f358c88e1..c5166e735 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/ObserverTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/ObserverTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java b/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
index 523678288..5f0cef1d6 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/observer/src/test/java/com/iluwatar/observer/utils/InMemoryAppender.java b/observer/src/test/java/com/iluwatar/observer/utils/InMemoryAppender.java
index 132216d19..efde073f9 100644
--- a/observer/src/test/java/com/iluwatar/observer/utils/InMemoryAppender.java
+++ b/observer/src/test/java/com/iluwatar/observer/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/pom.xml b/page-object/pom.xml
index a91843121..d2f07d91d 100644
--- a/page-object/pom.xml
+++ b/page-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/pom.xml b/page-object/sample-application/pom.xml
index 6748a4063..a8a631345 100644
--- a/page-object/sample-application/pom.xml
+++ b/page-object/sample-application/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java b/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
index edf7e1258..f3f152518 100644
--- a/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
+++ b/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/resources/sample-ui/album-list.html b/page-object/sample-application/src/main/resources/sample-ui/album-list.html
index 95018bf6f..468f600b6 100644
--- a/page-object/sample-application/src/main/resources/sample-ui/album-list.html
+++ b/page-object/sample-application/src/main/resources/sample-ui/album-list.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/resources/sample-ui/album-page.html b/page-object/sample-application/src/main/resources/sample-ui/album-page.html
index 0f293de16..a4cc475ab 100644
--- a/page-object/sample-application/src/main/resources/sample-ui/album-page.html
+++ b/page-object/sample-application/src/main/resources/sample-ui/album-page.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/resources/sample-ui/css/album-list.css b/page-object/sample-application/src/main/resources/sample-ui/css/album-list.css
index 943a32494..5abe16c33 100644
--- a/page-object/sample-application/src/main/resources/sample-ui/css/album-list.css
+++ b/page-object/sample-application/src/main/resources/sample-ui/css/album-list.css
@@ -1,6 +1,6 @@
 /**
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/resources/sample-ui/css/style.css b/page-object/sample-application/src/main/resources/sample-ui/css/style.css
index 7ad0f635a..e4761f28a 100644
--- a/page-object/sample-application/src/main/resources/sample-ui/css/style.css
+++ b/page-object/sample-application/src/main/resources/sample-ui/css/style.css
@@ -1,6 +1,6 @@
 /**
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/sample-application/src/main/resources/sample-ui/login.html b/page-object/sample-application/src/main/resources/sample-ui/login.html
index 774e213eb..142a93278 100644
--- a/page-object/sample-application/src/main/resources/sample-ui/login.html
+++ b/page-object/sample-application/src/main/resources/sample-ui/login.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/java/com/iluwatar/pageobject/App.java b/page-object/src/main/java/com/iluwatar/pageobject/App.java
index 1acc63419..98d8d19a3 100644
--- a/page-object/src/main/java/com/iluwatar/pageobject/App.java
+++ b/page-object/src/main/java/com/iluwatar/pageobject/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/resources/sample-ui/album-list.html b/page-object/src/main/resources/sample-ui/album-list.html
index 95018bf6f..468f600b6 100644
--- a/page-object/src/main/resources/sample-ui/album-list.html
+++ b/page-object/src/main/resources/sample-ui/album-list.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/resources/sample-ui/album-page.html b/page-object/src/main/resources/sample-ui/album-page.html
index 0f293de16..a4cc475ab 100644
--- a/page-object/src/main/resources/sample-ui/album-page.html
+++ b/page-object/src/main/resources/sample-ui/album-page.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/resources/sample-ui/css/album-list.css b/page-object/src/main/resources/sample-ui/css/album-list.css
index 943a32494..5abe16c33 100644
--- a/page-object/src/main/resources/sample-ui/css/album-list.css
+++ b/page-object/src/main/resources/sample-ui/css/album-list.css
@@ -1,6 +1,6 @@
 /**
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/resources/sample-ui/css/style.css b/page-object/src/main/resources/sample-ui/css/style.css
index 7ad0f635a..e4761f28a 100644
--- a/page-object/src/main/resources/sample-ui/css/style.css
+++ b/page-object/src/main/resources/sample-ui/css/style.css
@@ -1,6 +1,6 @@
 /**
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/main/resources/sample-ui/login.html b/page-object/src/main/resources/sample-ui/login.html
index 774e213eb..142a93278 100644
--- a/page-object/src/main/resources/sample-ui/login.html
+++ b/page-object/src/main/resources/sample-ui/login.html
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
index 22bc8a5fb..ff35635cf 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
index 68c836bd3..a68bf51ad 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
index 460bdcf96..a3ee088e5 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumListPage.java b/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumListPage.java
index 6d68960b4..6886b96ad 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumListPage.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumListPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumPage.java b/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumPage.java
index e9e2605ab..75a7e91a2 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumPage.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/pages/AlbumPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/pages/LoginPage.java b/page-object/src/test/java/com/iluwatar/pageobject/pages/LoginPage.java
index e245f4b23..488068041 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/pages/LoginPage.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/pages/LoginPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/pages/Page.java b/page-object/src/test/java/com/iluwatar/pageobject/pages/Page.java
index 81d148dd3..3034a932e 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/pages/Page.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/pages/Page.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/pom.xml b/page-object/test-automation/pom.xml
index 5f64807de..f2c2075e0 100644
--- a/page-object/test-automation/pom.xml
+++ b/page-object/test-automation/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
index 807582cb7..f943ee178 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
index 837cb6307..ca238222f 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
index b9ec57ff9..e5a0d5053 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/Page.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/Page.java
index ddf7ec63e..1a5948d57 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/Page.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/Page.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
index 1acdd5ba5..c5d8fc701 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
index ecde999c3..27af5713d 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
index 429b7fcc5..80b0ba8d4 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index fbece028e..64457665b 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/main/java/com/iluwatar/partialresponse/App.java b/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
index 18c346142..58d50d4c2 100644
--- a/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
+++ b/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/main/java/com/iluwatar/partialresponse/FieldJsonMapper.java b/partial-response/src/main/java/com/iluwatar/partialresponse/FieldJsonMapper.java
index 92180b9d0..5647d1da3 100644
--- a/partial-response/src/main/java/com/iluwatar/partialresponse/FieldJsonMapper.java
+++ b/partial-response/src/main/java/com/iluwatar/partialresponse/FieldJsonMapper.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/main/java/com/iluwatar/partialresponse/Video.java b/partial-response/src/main/java/com/iluwatar/partialresponse/Video.java
index 9e3ad5ea3..37abf92ce 100644
--- a/partial-response/src/main/java/com/iluwatar/partialresponse/Video.java
+++ b/partial-response/src/main/java/com/iluwatar/partialresponse/Video.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/main/java/com/iluwatar/partialresponse/VideoResource.java b/partial-response/src/main/java/com/iluwatar/partialresponse/VideoResource.java
index 11a4f23ca..29155335a 100644
--- a/partial-response/src/main/java/com/iluwatar/partialresponse/VideoResource.java
+++ b/partial-response/src/main/java/com/iluwatar/partialresponse/VideoResource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
index c423355f5..2024cfd80 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
index 6bf5bf190..a4dfd8299 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/FieldJsonMapperTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
index dbd8e78dd..9d8be1b09 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/pom.xml b/pipeline/pom.xml
index fca6180bc..df897c5ab 100644
--- a/pipeline/pom.xml
+++ b/pipeline/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/App.java b/pipeline/src/main/java/com/iluwatar/pipeline/App.java
index cfbcbafc2..feaae9b41 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/App.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/ConvertToCharArrayHandler.java b/pipeline/src/main/java/com/iluwatar/pipeline/ConvertToCharArrayHandler.java
index f57a81511..ef82327dc 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/ConvertToCharArrayHandler.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/ConvertToCharArrayHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/Handler.java b/pipeline/src/main/java/com/iluwatar/pipeline/Handler.java
index 5591632e0..4c5ead2f9 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/Handler.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/Handler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/Pipeline.java b/pipeline/src/main/java/com/iluwatar/pipeline/Pipeline.java
index 81b63e6cf..6758608bd 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/Pipeline.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/Pipeline.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/RemoveAlphabetsHandler.java b/pipeline/src/main/java/com/iluwatar/pipeline/RemoveAlphabetsHandler.java
index 50c158fc4..10e4adcbc 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/RemoveAlphabetsHandler.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/RemoveAlphabetsHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/main/java/com/iluwatar/pipeline/RemoveDigitsHandler.java b/pipeline/src/main/java/com/iluwatar/pipeline/RemoveDigitsHandler.java
index dba50bbb3..d8383e29e 100644
--- a/pipeline/src/main/java/com/iluwatar/pipeline/RemoveDigitsHandler.java
+++ b/pipeline/src/main/java/com/iluwatar/pipeline/RemoveDigitsHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java b/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
index 1316491ad..6b722dd9e 100644
--- a/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
+++ b/pipeline/src/test/java/com/iluwatar/pipeline/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java b/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
index 062d796b1..e54085be8 100644
--- a/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
+++ b/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml
index c4780fe1b..e9ebc5e29 100644
--- a/poison-pill/pom.xml
+++ b/poison-pill/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
index 841745b75..4e423ab47 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
index ac0e57829..b0264c298 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
index b0298e407..814985fe5 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java
index 2928e172d..7b8699405 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/MqPublishPoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MqPublishPoint.java
index f61a57987..3fdfdbe8f 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/MqPublishPoint.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MqPublishPoint.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/MqSubscribePoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MqSubscribePoint.java
index b7133de8c..2095000ef 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/MqSubscribePoint.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MqSubscribePoint.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
index 8cc446697..5df72daf2 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
index 70d116c9f..4417b11ef 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
index f6a50d4ff..0067af09e 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
index 50d7a90c9..ba93fa9e3 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
index 8365fca17..2b6105133 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
index 159b9658e..30e57708b 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
index e1781f9e4..3b6545c0f 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
index d5486ddd2..1295d8234 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/pom.xml b/pom.xml
index e0f437921..d750e9ba2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,19 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- The MIT License Copyright © 2014-2019 Ilkka Seppälä Permission is hereby
-	granted, free of charge, to any person obtaining a copy of this software
-	and associated documentation files (the "Software"), to deal in the Software
-	without restriction, including without limitation the rights to use, copy,
-	modify, merge, publish, distribute, sublicense, and/or sell copies of the
-	Software, and to permit persons to whom the Software is furnished to do so,
-	subject to the following conditions: The above copyright notice and this
-	permission notice shall be included in all copies or substantial portions
-	of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
-	KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-	MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
-	NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
-	DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
-	ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-	DEALINGS IN THE SOFTWARE. -->
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
@@ -22,7 +31,7 @@
     <artifactId>java-design-patterns</artifactId>
     <version>1.24.0-SNAPSHOT</version>
     <packaging>pom</packaging>
-    <inceptionYear>2014-2019</inceptionYear>
+    <inceptionYear>2014-2021</inceptionYear>
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <sonar-maven-plugin.version>3.8.0.2131</sonar-maven-plugin.version>
diff --git a/priority-queue/pom.xml b/priority-queue/pom.xml
index ff04a5359..0969623d9 100644
--- a/priority-queue/pom.xml
+++ b/priority-queue/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
index cdef90ab8..785f712ed 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/Application.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/Message.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/Message.java
index a9a3dcfa6..8f506dbbb 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/Message.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/Message.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
index a161a9700..6994c9d23 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
index 3a0761f4a..8aace72e5 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/QueueManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
index 95417c500..979984e62 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java b/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
index 541310dd0..1921dec5b 100644
--- a/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
+++ b/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java b/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
index 3f5dc0676..73463fb52 100644
--- a/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
+++ b/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml
index 01d0149ea..27488067f 100644
--- a/private-class-data/pom.xml
+++ b/private-class-data/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
index 52e18b125..15b0aa7aa 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
index d312cd34a..49aef81e1 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
index 65ba6c08e..e4b80457a 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
index 1b0fd269b..f406dfb55 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
index d551614cf..6be9859d1 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
index f78940828..e8cfcbc5d 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
index 722e8354a..07b512b75 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/InMemoryAppender.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/InMemoryAppender.java
index bbcbc8021..cb478b9dd 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/InMemoryAppender.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/pom.xml b/producer-consumer/pom.xml
index 4884ef728..4e6eababa 100644
--- a/producer-consumer/pom.xml
+++ b/producer-consumer/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
index 0096cc7ca..18f1cc1ff 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
index 347b4a052..0b4149558 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
index 89f692282..39acde941 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
index 118e3265d..bd5c54278 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
index 28f6c053d..010c5f93c 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
index 0a436bd02..5051aa813 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
index 24425c3d6..8e7ad61f8 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
index 6d772ec6a..2b386d305 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/pom.xml b/promise/pom.xml
index 6ef67edec..7e7602743 100644
--- a/promise/pom.xml
+++ b/promise/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/main/java/com/iluwatar/promise/App.java b/promise/src/main/java/com/iluwatar/promise/App.java
index 6c0921936..440478f38 100644
--- a/promise/src/main/java/com/iluwatar/promise/App.java
+++ b/promise/src/main/java/com/iluwatar/promise/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/main/java/com/iluwatar/promise/Promise.java b/promise/src/main/java/com/iluwatar/promise/Promise.java
index 5b79ebcd6..ab5c671be 100644
--- a/promise/src/main/java/com/iluwatar/promise/Promise.java
+++ b/promise/src/main/java/com/iluwatar/promise/Promise.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java b/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
index 01e9926a0..6f8974527 100644
--- a/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
+++ b/promise/src/main/java/com/iluwatar/promise/PromiseSupport.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/main/java/com/iluwatar/promise/Utility.java b/promise/src/main/java/com/iluwatar/promise/Utility.java
index 47755975a..b55c48a93 100644
--- a/promise/src/main/java/com/iluwatar/promise/Utility.java
+++ b/promise/src/main/java/com/iluwatar/promise/Utility.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/test/java/com/iluwatar/promise/AppTest.java b/promise/src/test/java/com/iluwatar/promise/AppTest.java
index bf2f264c0..ab20b374d 100644
--- a/promise/src/test/java/com/iluwatar/promise/AppTest.java
+++ b/promise/src/test/java/com/iluwatar/promise/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
index 3b6d43be2..f3450ee00 100644
--- a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
+++ b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/pom.xml b/property/pom.xml
index 8746a60ac..789127ca9 100644
--- a/property/pom.xml
+++ b/property/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/main/java/com/iluwatar/property/App.java b/property/src/main/java/com/iluwatar/property/App.java
index 912388e55..d646c6787 100644
--- a/property/src/main/java/com/iluwatar/property/App.java
+++ b/property/src/main/java/com/iluwatar/property/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/main/java/com/iluwatar/property/Character.java b/property/src/main/java/com/iluwatar/property/Character.java
index 3d3813e5f..5ce977ed9 100644
--- a/property/src/main/java/com/iluwatar/property/Character.java
+++ b/property/src/main/java/com/iluwatar/property/Character.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/main/java/com/iluwatar/property/Prototype.java b/property/src/main/java/com/iluwatar/property/Prototype.java
index 423863522..593eb96ed 100644
--- a/property/src/main/java/com/iluwatar/property/Prototype.java
+++ b/property/src/main/java/com/iluwatar/property/Prototype.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/main/java/com/iluwatar/property/Stats.java b/property/src/main/java/com/iluwatar/property/Stats.java
index 2941299d5..95b42baf3 100644
--- a/property/src/main/java/com/iluwatar/property/Stats.java
+++ b/property/src/main/java/com/iluwatar/property/Stats.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/test/java/com/iluwatar/property/AppTest.java b/property/src/test/java/com/iluwatar/property/AppTest.java
index 38c5cb4d5..4cbdb6602 100644
--- a/property/src/test/java/com/iluwatar/property/AppTest.java
+++ b/property/src/test/java/com/iluwatar/property/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/property/src/test/java/com/iluwatar/property/CharacterTest.java b/property/src/test/java/com/iluwatar/property/CharacterTest.java
index d7a67e52c..59113f28a 100644
--- a/property/src/test/java/com/iluwatar/property/CharacterTest.java
+++ b/property/src/test/java/com/iluwatar/property/CharacterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/pom.xml b/prototype/pom.xml
index 220ed4521..687f936cc 100644
--- a/prototype/pom.xml
+++ b/prototype/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/App.java b/prototype/src/main/java/com/iluwatar/prototype/App.java
index 526a13848..eb81c792d 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/App.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Beast.java b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
index a5fc0158e..359c1f280 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Beast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
index 8e2ed9474..cfa1e1f3f 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
index 42a54ca97..6345749b3 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
index fb426a444..c435976a0 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java b/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
index 264416797..312b3d588 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
index 14516f3b4..f3c67f542 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Mage.java b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
index ca2cc6db4..fb4344c6d 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Mage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
index 91339887c..032d1c2ab 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
index 439e7f368..24b62739c 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
index a2ae31b4d..85446fb5a 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
index d4c518ec2..2581b5215 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
index 3df514be4..d4135bc7e 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
index d82568ddf..595f4af6f 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java b/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
index c3a8d8999..653f25547 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/pom.xml b/proxy/pom.xml
index 0e7707bf8..65561102e 100644
--- a/proxy/pom.xml
+++ b/proxy/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java
index 18a4f1348..e51a1c423 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/App.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
index 2523af8b8..e359908a9 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
index fc77d80df..bdeed212e 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
index c08b49e7d..36ec71b9d 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
index e295850de..9d8fa5944 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
index dde0bbe57..7b4d480b1 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java b/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
index 8c29df9b6..c1b929458 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java b/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
index 82df04b0d..cfcb21b04 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java b/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
index ff023b818..3314ffe0c 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java b/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
index 173825288..8fa13c20f 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/pom.xml b/queue-load-leveling/pom.xml
index 817e6e3cc..f2001a81f 100644
--- a/queue-load-leveling/pom.xml
+++ b/queue-load-leveling/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
index c73caf242..430317246 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
index 686737389..aaf0c69a4 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
index 339ea2867..c4177ef72 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
index 2a33286a0..0c9f96143 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Task.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Task.java
index 88e9d21f8..7d59bec2d 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Task.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Task.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
index 492b58623..3b4755b25 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
index 2adc15011..1f303bf97 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
index b712853f6..ff43b3298 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
index 15b90078c..dd14b5144 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
index 3d12e6abf..30ce34e30 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/TaskGenSrvExeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/pom.xml b/reactor/pom.xml
index c25ed45ae..2d6d2aab6 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index f656eacf6..7eaa7c747 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index ec6022621..1ddd2c34c 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
index 8babaa3a0..a3501971c 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index 7adf18166..7a5418290 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
index 5bd145a38..d4af75d2c 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
index 0a2db2ca8..b0fefaeb4 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index aba99d65c..fbddc12c6 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index 77e39a88d..65a69b646 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index 04673f01d..351ee4b19 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
index 0faff6793..e6f38ea30 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
index b75f0f64d..d8af72c96 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
index 1d7faab7e..fd3eab523 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/pom.xml b/reader-writer-lock/pom.xml
index 37f70b435..c78acbaa7 100644
--- a/reader-writer-lock/pom.xml
+++ b/reader-writer-lock/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
index c482ab7e7..d703cc691 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
index c54e62e58..4abdd5220 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
index 932428b4f..621084b59 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
index fbc8321f2..b215c457b 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
index 63f4c764d..5908809b0 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
index ffd1dd4a4..ddd19087d 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
index 284a1bc3b..5621a8d6a 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
index 00edf8b54..8be8c93e5 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/InMemoryAppender.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/InMemoryAppender.java
index 01a63d6c8..a7a4ebcbf 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/InMemoryAppender.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/utils/InMemoryAppender.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/registry/pom.xml b/registry/pom.xml
index bb02f1184..c6312713b 100644
--- a/registry/pom.xml
+++ b/registry/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/registry/src/main/java/com/iluwatar/registry/App.java b/registry/src/main/java/com/iluwatar/registry/App.java
index 5dbcf0c05..de6fa8464 100644
--- a/registry/src/main/java/com/iluwatar/registry/App.java
+++ b/registry/src/main/java/com/iluwatar/registry/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/registry/src/main/java/com/iluwatar/registry/Customer.java b/registry/src/main/java/com/iluwatar/registry/Customer.java
index d70407887..97e77af98 100644
--- a/registry/src/main/java/com/iluwatar/registry/Customer.java
+++ b/registry/src/main/java/com/iluwatar/registry/Customer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
index 62453d425..b4279e1be 100644
--- a/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
+++ b/registry/src/main/java/com/iluwatar/registry/CustomerRegistry.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
index 3a23eec2f..54c800cd8 100644
--- a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
+++ b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/pom.xml b/repository/pom.xml
index 694629efa..197528ad7 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/java/com/iluwatar/repository/App.java b/repository/src/main/java/com/iluwatar/repository/App.java
index 0308db473..e46bc75a5 100644
--- a/repository/src/main/java/com/iluwatar/repository/App.java
+++ b/repository/src/main/java/com/iluwatar/repository/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/java/com/iluwatar/repository/AppConfig.java b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
index 81d158d23..15684dc15 100644
--- a/repository/src/main/java/com/iluwatar/repository/AppConfig.java
+++ b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/java/com/iluwatar/repository/Person.java b/repository/src/main/java/com/iluwatar/repository/Person.java
index ee1602ace..ba02cd6c4 100644
--- a/repository/src/main/java/com/iluwatar/repository/Person.java
+++ b/repository/src/main/java/com/iluwatar/repository/Person.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/java/com/iluwatar/repository/PersonRepository.java b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
index 2bdd0feb7..b5df96ff4 100644
--- a/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
+++ b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java b/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
index 823fa2d3d..a5f58dbe6 100644
--- a/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
+++ b/repository/src/main/java/com/iluwatar/repository/PersonSpecifications.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/resources/META-INF/persistence.xml b/repository/src/main/resources/META-INF/persistence.xml
index 4a4566b47..3795d6f18 100644
--- a/repository/src/main/resources/META-INF/persistence.xml
+++ b/repository/src/main/resources/META-INF/persistence.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/resources/applicationContext.xml b/repository/src/main/resources/applicationContext.xml
index 9efe2bee5..fbfc2d080 100644
--- a/repository/src/main/resources/applicationContext.xml
+++ b/repository/src/main/resources/applicationContext.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/main/resources/logback.xml b/repository/src/main/resources/logback.xml
index 3a4a84c83..4973ac308 100644
--- a/repository/src/main/resources/logback.xml
+++ b/repository/src/main/resources/logback.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java b/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
index 9e2e1f4e1..d2e8f3b83 100644
--- a/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java b/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
index 403f793af..5fec985e1 100644
--- a/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/test/java/com/iluwatar/repository/AppTest.java b/repository/src/test/java/com/iluwatar/repository/AppTest.java
index d44af23db..acb239bdb 100644
--- a/repository/src/test/java/com/iluwatar/repository/AppTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java b/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
index 77e2b3e35..86604e1bf 100644
--- a/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml
index 34428033b..c2d973e0f 100644
--- a/resource-acquisition-is-initialization/pom.xml
+++ b/resource-acquisition-is-initialization/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
index 08b62ee8b..a1f12bcc8 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
index c311f939a..829f2997c 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
index 2e8595b14..cfcd4893a 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
index 057a85500..4922132a1 100644
--- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
+++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
index 53caabea7..cc901eed5 100644
--- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
+++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/pom.xml b/retry/pom.xml
index 2f0b15bd2..d84fe9dda 100644
--- a/retry/pom.xml
+++ b/retry/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/App.java b/retry/src/main/java/com/iluwatar/retry/App.java
index 7d6e6faec..fb0cefcf9 100644
--- a/retry/src/main/java/com/iluwatar/retry/App.java
+++ b/retry/src/main/java/com/iluwatar/retry/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/BusinessException.java b/retry/src/main/java/com/iluwatar/retry/BusinessException.java
index 397a4623b..e89140fd0 100644
--- a/retry/src/main/java/com/iluwatar/retry/BusinessException.java
+++ b/retry/src/main/java/com/iluwatar/retry/BusinessException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/BusinessOperation.java b/retry/src/main/java/com/iluwatar/retry/BusinessOperation.java
index a67240d3c..9ca570541 100644
--- a/retry/src/main/java/com/iluwatar/retry/BusinessOperation.java
+++ b/retry/src/main/java/com/iluwatar/retry/BusinessOperation.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/CustomerNotFoundException.java b/retry/src/main/java/com/iluwatar/retry/CustomerNotFoundException.java
index 3826fe0e1..d5efbb8cf 100644
--- a/retry/src/main/java/com/iluwatar/retry/CustomerNotFoundException.java
+++ b/retry/src/main/java/com/iluwatar/retry/CustomerNotFoundException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/DatabaseNotAvailableException.java b/retry/src/main/java/com/iluwatar/retry/DatabaseNotAvailableException.java
index 37fcecf32..0cbf3486d 100644
--- a/retry/src/main/java/com/iluwatar/retry/DatabaseNotAvailableException.java
+++ b/retry/src/main/java/com/iluwatar/retry/DatabaseNotAvailableException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/FindCustomer.java b/retry/src/main/java/com/iluwatar/retry/FindCustomer.java
index af3e5469a..791a5efbd 100644
--- a/retry/src/main/java/com/iluwatar/retry/FindCustomer.java
+++ b/retry/src/main/java/com/iluwatar/retry/FindCustomer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/Retry.java b/retry/src/main/java/com/iluwatar/retry/Retry.java
index f54c51301..988cbc2da 100644
--- a/retry/src/main/java/com/iluwatar/retry/Retry.java
+++ b/retry/src/main/java/com/iluwatar/retry/Retry.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/main/java/com/iluwatar/retry/RetryExponentialBackoff.java b/retry/src/main/java/com/iluwatar/retry/RetryExponentialBackoff.java
index 54faf4306..aea2afe82 100644
--- a/retry/src/main/java/com/iluwatar/retry/RetryExponentialBackoff.java
+++ b/retry/src/main/java/com/iluwatar/retry/RetryExponentialBackoff.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java b/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
index 295d8d763..045be73dc 100644
--- a/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java b/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
index 3ca739fbf..91bcc1419 100644
--- a/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/retry/src/test/java/com/iluwatar/retry/RetryTest.java b/retry/src/test/java/com/iluwatar/retry/RetryTest.java
index b36b6a561..c137209e9 100644
--- a/retry/src/test/java/com/iluwatar/retry/RetryTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/RetryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/pom.xml b/role-object/pom.xml
index 07becfc9b..e53ca1747 100644
--- a/role-object/pom.xml
+++ b/role-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java b/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
index 0fc028893..30572ddad 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/BorrowerRole.java b/role-object/src/main/java/com/iluwatar/roleobject/BorrowerRole.java
index 19db1c823..0e357f83e 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/BorrowerRole.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/BorrowerRole.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/Customer.java b/role-object/src/main/java/com/iluwatar/roleobject/Customer.java
index bca450a38..7b6e6f585 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/Customer.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/Customer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/CustomerCore.java b/role-object/src/main/java/com/iluwatar/roleobject/CustomerCore.java
index 1c4cf0383..c886b3702 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/CustomerCore.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/CustomerCore.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/CustomerRole.java b/role-object/src/main/java/com/iluwatar/roleobject/CustomerRole.java
index b961c210e..c260320f4 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/CustomerRole.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/CustomerRole.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/InvestorRole.java b/role-object/src/main/java/com/iluwatar/roleobject/InvestorRole.java
index d95289a07..86887f633 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/InvestorRole.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/InvestorRole.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/Role.java b/role-object/src/main/java/com/iluwatar/roleobject/Role.java
index a776178fb..4049c7644 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/Role.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/Role.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
index 01535f477..1b02b90f1 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.roleobject;
 
 import org.junit.Test;
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
index e04f91acc..ee7881f19 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.roleobject;
 
 import org.junit.Assert;
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
index 50c96986a..acbbfaf02 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.roleobject;
 
 import static org.junit.Assert.assertEquals;
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
index 7f8410cca..ad8bd49f9 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.roleobject;
 
 import org.junit.Assert;
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
index 29161de3f..b8426a3d1 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.roleobject;
 
 import org.junit.Assert;
diff --git a/saga/pom.xml b/saga/pom.xml
index a3ae60ed8..07d327885 100644
--- a/saga/pom.xml
+++ b/saga/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/ChoreographyChapter.java b/saga/src/main/java/com/iluwatar/saga/choreography/ChoreographyChapter.java
index cfb22441d..7bbc3e4c9 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/ChoreographyChapter.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/ChoreographyChapter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/FlyBookingService.java b/saga/src/main/java/com/iluwatar/saga/choreography/FlyBookingService.java
index 4a9b1e804..371e026f6 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/FlyBookingService.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/FlyBookingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/HotelBookingService.java b/saga/src/main/java/com/iluwatar/saga/choreography/HotelBookingService.java
index ee623482e..aa9da3085 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/HotelBookingService.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/HotelBookingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/OrderService.java b/saga/src/main/java/com/iluwatar/saga/choreography/OrderService.java
index 19586a5a3..bfb7ac32c 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/OrderService.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/OrderService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/Saga.java b/saga/src/main/java/com/iluwatar/saga/choreography/Saga.java
index 506587c76..4013a50dc 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/Saga.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/Saga.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java b/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
index 858aa76d7..03da8e8a4 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/Service.java b/saga/src/main/java/com/iluwatar/saga/choreography/Service.java
index da447c528..8780cd775 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/Service.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/Service.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/ServiceDiscoveryService.java b/saga/src/main/java/com/iluwatar/saga/choreography/ServiceDiscoveryService.java
index c6bc7bc80..5531b69c0 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/ServiceDiscoveryService.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/ServiceDiscoveryService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/WithdrawMoneyService.java b/saga/src/main/java/com/iluwatar/saga/choreography/WithdrawMoneyService.java
index d0fd02390..4cad28116 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/WithdrawMoneyService.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/WithdrawMoneyService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/ChapterResult.java b/saga/src/main/java/com/iluwatar/saga/orchestration/ChapterResult.java
index b04d22849..f0a98a4ad 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/ChapterResult.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/ChapterResult.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/FlyBookingService.java b/saga/src/main/java/com/iluwatar/saga/orchestration/FlyBookingService.java
index 23b612957..767bf19fd 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/FlyBookingService.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/FlyBookingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/HotelBookingService.java b/saga/src/main/java/com/iluwatar/saga/orchestration/HotelBookingService.java
index 2d6ba1389..741038bdb 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/HotelBookingService.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/HotelBookingService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/OrchestrationChapter.java b/saga/src/main/java/com/iluwatar/saga/orchestration/OrchestrationChapter.java
index 667dea904..342e717cc 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/OrchestrationChapter.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/OrchestrationChapter.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/OrderService.java b/saga/src/main/java/com/iluwatar/saga/orchestration/OrderService.java
index c42a9d7a1..ea02a40b6 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/OrderService.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/OrderService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/Saga.java b/saga/src/main/java/com/iluwatar/saga/orchestration/Saga.java
index 1b68d6cf7..ce196ed8f 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/Saga.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/Saga.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
index 201a526f9..43dc1464a 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
index d4df6fa07..9972192c7 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/Service.java b/saga/src/main/java/com/iluwatar/saga/orchestration/Service.java
index eb2fc0482..53728ab79 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/Service.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/Service.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/ServiceDiscoveryService.java b/saga/src/main/java/com/iluwatar/saga/orchestration/ServiceDiscoveryService.java
index f88efae52..e5d02a5be 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/ServiceDiscoveryService.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/ServiceDiscoveryService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/WithdrawMoneyService.java b/saga/src/main/java/com/iluwatar/saga/orchestration/WithdrawMoneyService.java
index 7eb5634ef..a9b7a7220 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/WithdrawMoneyService.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/WithdrawMoneyService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
index 5d73a9fa3..52b407b57 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.saga.choreography;
 
 import com.iluwatar.saga.orchestration.SagaApplication;
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
index 5ae9df19d..b1ddcf13f 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.saga.choreography;
 
 import org.junit.Assert;
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
index aa4f4ff7d..1ebb9de44 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.saga.orchestration;
 
 import org.junit.Test;
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
index f80a46fdc..6a1a257df 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.saga.orchestration;
 
 import static com.iluwatar.saga.orchestration.Saga.Result;
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
index d3522418c..7dd4c3180 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -20,6 +20,7 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  * THE SOFTWARE.
  */
+
 package com.iluwatar.saga.orchestration;
 
 import org.junit.Assert;
diff --git a/separated-interface/pom.xml b/separated-interface/pom.xml
index da7584a93..c4d5f17f1 100644
--- a/separated-interface/pom.xml
+++ b/separated-interface/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
index 1951e738b..046970644 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
index c17ed5ac5..fea32e2bf 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/InvoiceGenerator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
index aa4b81a84..95deedf40 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/invoice/TaxCalculator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
index 788afb90a..2018f281f 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
index c2b12e2f5..fcb45eb00 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
index 4114f9bb7..1a09b49c8 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
index ac75d3b70..e1fb2302b 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
index dac3ec2d6..895d66edb 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
index 22526b6df..e756297f2 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/pom.xml b/servant/pom.xml
index c7b282c09..cb8fd2089 100644
--- a/servant/pom.xml
+++ b/servant/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/etc/servant.xml b/servant/src/etc/servant.xml
index c628bf019..75b66474c 100644
--- a/servant/src/etc/servant.xml
+++ b/servant/src/etc/servant.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/main/java/com/iluwatar/servant/App.java b/servant/src/main/java/com/iluwatar/servant/App.java
index 9c4591b05..b10861f6b 100644
--- a/servant/src/main/java/com/iluwatar/servant/App.java
+++ b/servant/src/main/java/com/iluwatar/servant/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/main/java/com/iluwatar/servant/King.java b/servant/src/main/java/com/iluwatar/servant/King.java
index 1017ef378..d9942fa16 100644
--- a/servant/src/main/java/com/iluwatar/servant/King.java
+++ b/servant/src/main/java/com/iluwatar/servant/King.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/main/java/com/iluwatar/servant/Queen.java b/servant/src/main/java/com/iluwatar/servant/Queen.java
index 416efaade..45059dd67 100644
--- a/servant/src/main/java/com/iluwatar/servant/Queen.java
+++ b/servant/src/main/java/com/iluwatar/servant/Queen.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/main/java/com/iluwatar/servant/Royalty.java b/servant/src/main/java/com/iluwatar/servant/Royalty.java
index 959d108f0..2d67a17e4 100644
--- a/servant/src/main/java/com/iluwatar/servant/Royalty.java
+++ b/servant/src/main/java/com/iluwatar/servant/Royalty.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/main/java/com/iluwatar/servant/Servant.java b/servant/src/main/java/com/iluwatar/servant/Servant.java
index 57b6bc541..be3100fd3 100644
--- a/servant/src/main/java/com/iluwatar/servant/Servant.java
+++ b/servant/src/main/java/com/iluwatar/servant/Servant.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/test/java/com/iluwatar/servant/AppTest.java b/servant/src/test/java/com/iluwatar/servant/AppTest.java
index d05c22eeb..1f77affb5 100644
--- a/servant/src/test/java/com/iluwatar/servant/AppTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/test/java/com/iluwatar/servant/KingTest.java b/servant/src/test/java/com/iluwatar/servant/KingTest.java
index 6c4c76ccd..f769389c3 100644
--- a/servant/src/test/java/com/iluwatar/servant/KingTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/KingTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/test/java/com/iluwatar/servant/QueenTest.java b/servant/src/test/java/com/iluwatar/servant/QueenTest.java
index 7af351855..1a86d0afb 100644
--- a/servant/src/test/java/com/iluwatar/servant/QueenTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/QueenTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/servant/src/test/java/com/iluwatar/servant/ServantTest.java b/servant/src/test/java/com/iluwatar/servant/ServantTest.java
index 5d8d5d997..db6cdf341 100644
--- a/servant/src/test/java/com/iluwatar/servant/ServantTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/ServantTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/pom.xml b/serverless/pom.xml
index 2880764ec..e81b38cd1 100644
--- a/serverless/pom.xml
+++ b/serverless/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/serverless.yml b/serverless/serverless.yml
index bbf9a71c4..1d8ff6eaa 100644
--- a/serverless/serverless.yml
+++ b/serverless/serverless.yml
@@ -1,6 +1,6 @@
 #
 # The MIT License
-# Copyright © 2014-2019 Ilkka Seppälä
+# Copyright © 2014-2021 Ilkka Seppälä
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/api/AbstractDynamoDbHandler.java b/serverless/src/main/java/com/iluwatar/serverless/baas/api/AbstractDynamoDbHandler.java
index abe7c388d..bb87923a0 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/api/AbstractDynamoDbHandler.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/api/AbstractDynamoDbHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/api/FindPersonApiHandler.java b/serverless/src/main/java/com/iluwatar/serverless/baas/api/FindPersonApiHandler.java
index 7190b04fe..b755f28d9 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/api/FindPersonApiHandler.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/api/FindPersonApiHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/api/SavePersonApiHandler.java b/serverless/src/main/java/com/iluwatar/serverless/baas/api/SavePersonApiHandler.java
index 51c2df791..7703930be 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/api/SavePersonApiHandler.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/api/SavePersonApiHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
index 512f436fb..4df66ecd5 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
index 0fd9f1588..4c13080b4 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/faas/ApiGatewayResponse.java b/serverless/src/main/java/com/iluwatar/serverless/faas/ApiGatewayResponse.java
index 6f57d2e27..33ba188fb 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/faas/ApiGatewayResponse.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/faas/ApiGatewayResponse.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java b/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
index aa2a86667..0302983e2 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/main/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandler.java b/serverless/src/main/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandler.java
index 7fdb8ad38..9a5087c36 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandler.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/test/java/com/iluwatar/serverless/baas/api/FindPersonApiHandlerTest.java b/serverless/src/test/java/com/iluwatar/serverless/baas/api/FindPersonApiHandlerTest.java
index 19d0cab23..8eb209e06 100644
--- a/serverless/src/test/java/com/iluwatar/serverless/baas/api/FindPersonApiHandlerTest.java
+++ b/serverless/src/test/java/com/iluwatar/serverless/baas/api/FindPersonApiHandlerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/test/java/com/iluwatar/serverless/baas/api/SavePersonApiHandlerTest.java b/serverless/src/test/java/com/iluwatar/serverless/baas/api/SavePersonApiHandlerTest.java
index a8c729163..bf4a59273 100644
--- a/serverless/src/test/java/com/iluwatar/serverless/baas/api/SavePersonApiHandlerTest.java
+++ b/serverless/src/test/java/com/iluwatar/serverless/baas/api/SavePersonApiHandlerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java b/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
index 2231d59e5..1f4b59a45 100644
--- a/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
+++ b/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/pom.xml b/service-layer/pom.xml
index 071cf0f49..da73a3f45 100644
--- a/service-layer/pom.xml
+++ b/service-layer/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
index e360e5c94..78f2fffb6 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
index ca76e5218..e93d45d48 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
index aefcacafb..0520de87b 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
index cf77e4f6e..3cd572fba 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
index bc2e51f13..fdc269aea 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
index ce4f01700..27f66645b 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
index cdcf926d0..d5d03fef1 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
index 9528c6ff9..ce09bb178 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
index 616379717..2b1609527 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
index aff1a37c5..4269e20c9 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
index b781499b9..2d95448d9 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
index 6ff95b183..ce96a2d39 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
index bc05ebe77..4d9ff08d6 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
index c973d433a..52345cfdf 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
index 6f966e8ea..4b5f176f9 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
index eb27b70f7..d22082f87 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/main/resources/logback.xml b/service-layer/src/main/resources/logback.xml
index e6678aff2..31c0ad1d4 100644
--- a/service-layer/src/main/resources/logback.xml
+++ b/service-layer/src/main/resources/logback.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
index 5cc1ccfff..399238694 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
index 6b85065ba..bc47481fa 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
index f559d2d75..6e03c660d 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
index 1768df10e..98ca75481 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
index f9e4e59f1..273cc9f31 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
index e25e434f1..32ca3f3af 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/pom.xml b/service-locator/pom.xml
index 2b0037eb8..7b8ebed0f 100644
--- a/service-locator/pom.xml
+++ b/service-locator/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
index 85419b603..525467376 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
index 93c6e3c7d..bee10f5d9 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
index 2635afe4f..28c1166ac 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
index 775de114b..670b5abe9 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
index 62e77af00..8247dd631 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
index fad1dafe7..dcdefce84 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
index 75d6f8b05..45b227d5a 100644
--- a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
+++ b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
index f4369a768..28bcb6122 100644
--- a/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
+++ b/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/pom.xml b/sharding/pom.xml
index 5f6c40ee5..05d064f75 100644
--- a/sharding/pom.xml
+++ b/sharding/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/App.java b/sharding/src/main/java/com/iluwatar/sharding/App.java
index 109f88cf8..1f5ded0da 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/App.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/Data.java b/sharding/src/main/java/com/iluwatar/sharding/Data.java
index abe49f15d..9261f2e34 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/Data.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/Data.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
index 11ada60d7..8577d2e11 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
index ce239c156..ba530f15a 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
index d06cd51da..12dc6ce22 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/Shard.java b/sharding/src/main/java/com/iluwatar/sharding/Shard.java
index 56037bc3a..f261f6d4d 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/Shard.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/Shard.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
index f244509d5..f128db462 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
index f23b71d1e..5c9929531 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
index e19de75d2..fb11e210f 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
index c6ce5851d..84614f86e 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
index 9ea4a2d86..75f0e85ad 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
index 992ad8d52..fab640ff3 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
index a12ab3a97..30a492b01 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/pom.xml b/singleton/pom.xml
index 80a34ea86..076756f2e 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index 2cea2edd3..dff78c77d 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
index 753201dba..6c8519dc3 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
index 42779ff71..8cdc50bf9 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
index 0bc3af28b..b6ba1cc02 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
index f5d47380f..ff373f415 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
index c3d96445f..2e68c2ece 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
index 5d3f247de..781704423 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/EnumIvoryTowerTest.java b/singleton/src/test/java/com/iluwatar/singleton/EnumIvoryTowerTest.java
index 6a19ca752..c1d147925 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/EnumIvoryTowerTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/EnumIvoryTowerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiomTest.java b/singleton/src/test/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiomTest.java
index cb9336667..10c2c4ec9 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiomTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiomTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/IvoryTowerTest.java b/singleton/src/test/java/com/iluwatar/singleton/IvoryTowerTest.java
index de4dc3a18..73cabedf2 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/IvoryTowerTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/IvoryTowerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java b/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
index 63d13add4..cbb1f944b 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
index b6ba2e5af..3b13fd878 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTowerTest.java b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTowerTest.java
index cfc3bd030..94167090f 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTowerTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTowerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/pom.xml b/spatial-partition/pom.xml
index fe749b22b..04a51455e 100644
--- a/spatial-partition/pom.xml
+++ b/spatial-partition/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
index 69a2852d7..5534fde5d 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
index 4ff166420..a9a9d4562 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
index a2547b7a1..5f4416a59 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Point.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/QuadTree.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/QuadTree.java
index 5eda3df2e..7d2fb473c 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/QuadTree.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/QuadTree.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Rect.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Rect.java
index 02acfb640..e7662657b 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Rect.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Rect.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
index 1a9a0d91e..5faef509d 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionBubbles.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionGeneric.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionGeneric.java
index 5ed73a7a1..05f2b0b11 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionGeneric.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/SpatialPartitionGeneric.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
index f02b5e961..e93a0c0bf 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/BubbleTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/QuadTreeTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/QuadTreeTest.java
index 66306fa36..1c2c3cd2e 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/QuadTreeTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/QuadTreeTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/RectTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/RectTest.java
index 8ec4b992e..c514e09c1 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/RectTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/RectTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
index f36995938..969bf99fe 100644
--- a/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
+++ b/spatial-partition/src/test/java/com/iluwatar/spatialpartition/SpatialPartitionBubblesTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/pom.xml b/special-case/pom.xml
index a0ce1b46b..5f6554068 100644
--- a/special-case/pom.xml
+++ b/special-case/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/App.java b/special-case/src/main/java/com/iluwatar/specialcase/App.java
index f7245da37..02ae7b466 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/App.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
index 9ad2de619..e2b7acdde 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServices.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
index 43b123673..eebd6dbc0 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ApplicationServicesImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/Db.java b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
index 4c6665fef..a456dd2c4 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/Db.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/Db.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
index fadd40278..cd09af916 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServices.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
index a9e40ba7a..22beab8b9 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DomainServicesImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
index 9076202b5..a0348663d 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/DownForMaintenance.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
index 4bf5af883..37e61b83f 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
index 4accfaa42..ac1abfd67 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InvalidUser.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
index 214e04d6b..e22a96096 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MaintenanceLock.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
index 8ed509f62..260a765d2 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/MoneyTransaction.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
index a06eb4360..2b3cbbab7 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/OutOfStock.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
index 5323f7190..304241f73 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptDto.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
index fd9b42cad..d50408dae 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/ReceiptViewModel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
index 1c33e0513..4c85849cb 100644
--- a/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
+++ b/special-case/src/test/java/com/iluwatar/specialcase/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
index 573afe0a2..4504057c4 100644
--- a/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
+++ b/special-case/src/test/java/com/iluwatar/specialcase/SpecialCasesTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/pom.xml b/specification/pom.xml
index 1494ca305..4f0250bea 100644
--- a/specification/pom.xml
+++ b/specification/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/app/App.java b/specification/src/main/java/com/iluwatar/specification/app/App.java
index 2ccb3047f..6b27e2ebe 100644
--- a/specification/src/main/java/com/iluwatar/specification/app/App.java
+++ b/specification/src/main/java/com/iluwatar/specification/app/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java b/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
index 214ae4562..c52e4e80b 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Creature.java b/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
index 2eb41a6dc..6339d535f 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java b/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
index 937bd5497..3275b82bc 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java b/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
index 7b173d580..b5439d6ee 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java b/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
index 2b35714fc..6fbf729bb 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java b/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
index f516a6dc5..832ad480a 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Shark.java b/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
index 8788e85d7..2816b33e4 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Troll.java b/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
index addcb94b6..38fe2c3c6 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Color.java b/specification/src/main/java/com/iluwatar/specification/property/Color.java
index b3128054e..4090e05c0 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Color.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Color.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Mass.java b/specification/src/main/java/com/iluwatar/specification/property/Mass.java
index e0e90aa06..c400bb8ff 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Mass.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Mass.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Movement.java b/specification/src/main/java/com/iluwatar/specification/property/Movement.java
index fcdcfae70..78b0ad5a6 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Movement.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Movement.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Size.java b/specification/src/main/java/com/iluwatar/specification/property/Size.java
index c5ad5525c..ab69aceb2 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Size.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Size.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/AbstractSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/AbstractSelector.java
index 2dea52271..94a214dde 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/AbstractSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/AbstractSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
index cefa5f92e..745f349f1 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/ConjunctionSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/ConjunctionSelector.java
index 661c8bceb..fe3df0157 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/ConjunctionSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/ConjunctionSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/DisjunctionSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/DisjunctionSelector.java
index 32dcf7e73..5e1da5370 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/DisjunctionSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/DisjunctionSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/MassEqualSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/MassEqualSelector.java
index e2c0c1e7c..d86724fca 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/MassEqualSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/MassEqualSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/MassGreaterThanSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/MassGreaterThanSelector.java
index 56160c12a..811971b34 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/MassGreaterThanSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/MassGreaterThanSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/MassSmallerThanOrEqSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/MassSmallerThanOrEqSelector.java
index 94ab3cc9a..a0c39fdd2 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/MassSmallerThanOrEqSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/MassSmallerThanOrEqSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
index e2a0bdb15..abb67d768 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/NegationSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/NegationSelector.java
index 30302baa2..b859fb4ab 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/NegationSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/NegationSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
index 6d5aa85d0..3b70e8297 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
index 4b29e11e8..8b760947b 100644
--- a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java b/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
index c0a10c19e..446add357 100644
--- a/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
index 61224819f..844236bea 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java b/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
index 62febf78d..68cb972bf 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
index 346cf5231..131d269b8 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
index 7a8b052aa..5de71e3e7 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
index 4fe9b72eb..ee3995c07 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/pom.xml b/state/pom.xml
index a434dabe4..5a1713a40 100644
--- a/state/pom.xml
+++ b/state/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/main/java/com/iluwatar/state/AngryState.java b/state/src/main/java/com/iluwatar/state/AngryState.java
index e105262b8..0598782a9 100644
--- a/state/src/main/java/com/iluwatar/state/AngryState.java
+++ b/state/src/main/java/com/iluwatar/state/AngryState.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/main/java/com/iluwatar/state/App.java b/state/src/main/java/com/iluwatar/state/App.java
index 75c42c4aa..a7cd79b77 100644
--- a/state/src/main/java/com/iluwatar/state/App.java
+++ b/state/src/main/java/com/iluwatar/state/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/main/java/com/iluwatar/state/Mammoth.java b/state/src/main/java/com/iluwatar/state/Mammoth.java
index 1aa541849..c8796640a 100644
--- a/state/src/main/java/com/iluwatar/state/Mammoth.java
+++ b/state/src/main/java/com/iluwatar/state/Mammoth.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/main/java/com/iluwatar/state/PeacefulState.java b/state/src/main/java/com/iluwatar/state/PeacefulState.java
index adf8be209..c535509d5 100644
--- a/state/src/main/java/com/iluwatar/state/PeacefulState.java
+++ b/state/src/main/java/com/iluwatar/state/PeacefulState.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/main/java/com/iluwatar/state/State.java b/state/src/main/java/com/iluwatar/state/State.java
index 4e3e8f6dc..2fd86df66 100644
--- a/state/src/main/java/com/iluwatar/state/State.java
+++ b/state/src/main/java/com/iluwatar/state/State.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/test/java/com/iluwatar/state/AppTest.java b/state/src/test/java/com/iluwatar/state/AppTest.java
index 90beddb33..cf607754f 100644
--- a/state/src/test/java/com/iluwatar/state/AppTest.java
+++ b/state/src/test/java/com/iluwatar/state/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/state/src/test/java/com/iluwatar/state/MammothTest.java b/state/src/test/java/com/iluwatar/state/MammothTest.java
index 4cc6e0adb..799be46c6 100644
--- a/state/src/test/java/com/iluwatar/state/MammothTest.java
+++ b/state/src/test/java/com/iluwatar/state/MammothTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/pom.xml b/step-builder/pom.xml
index de5763695..77684f906 100644
--- a/step-builder/pom.xml
+++ b/step-builder/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
index 5216b4106..4406df229 100644
--- a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
+++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java
index 43bb874f8..6f02bf57c 100644
--- a/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java
+++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java
index 5be38e471..132ecba53 100644
--- a/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java
+++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
index 20119b41b..6e347db31 100644
--- a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
+++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
index f46541f97..89b56beb3 100644
--- a/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
+++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/pom.xml b/strangler/pom.xml
index 7cb2ff263..fdf712028 100644
--- a/strangler/pom.xml
+++ b/strangler/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/App.java b/strangler/src/main/java/com/iluwatar/strangler/App.java
index bba0f7f74..d02e4e698 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/App.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
index be9c15ec5..61b3e5d07 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java b/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
index b83293335..90b1fed6c 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
index 8e482c8b3..c2ddfe290 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
index 8cc1822fe..5861ba11f 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
index e9d57987a..3295a6fd5 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/main/java/com/iluwatar/strangler/OldSource.java b/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
index 0ac0b5a07..dbccfc0c4 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/AppTest.java b/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
index 7e45d63ec..908fbb9af 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
index 004631966..410199e97 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
index a8f9fc6ac..31577842b 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
index edb20241b..3fa38f4a7 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
index 577cc0daf..89a078e84 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
index 7f653d311..8090d7a56 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
index 12d6a6c14..f072033d4 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/pom.xml b/strategy/pom.xml
index 0f3b0e830..9e2e0c75f 100644
--- a/strategy/pom.xml
+++ b/strategy/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/App.java b/strategy/src/main/java/com/iluwatar/strategy/App.java
index 6313087b0..9abab0b01 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/App.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java b/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java
index f6b91d967..a8df0ca76 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/DragonSlayer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java
index 537b521f4..9fabc3ec9 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/DragonSlayingStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
index 042f6e7cc..3c017a26c 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
index 12f467b07..658427279 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
index 769b0d7d9..a88179259 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
index dfa47f72b..6199d303a 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
index 174334f51..5349e88a3 100644
--- a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
+++ b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
index 625aa5eab..c675ffcc2 100644
--- a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
+++ b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayingStrategyTest.java b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayingStrategyTest.java
index 0b5a2d615..446467cd5 100644
--- a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayingStrategyTest.java
+++ b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayingStrategyTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index 780547e95..c2b58a274 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
index 9d3881b52..0d0305967 100644
--- a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
+++ b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/GroundDive.java b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/GroundDive.java
index 57779e823..269e2df05 100644
--- a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/GroundDive.java
+++ b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/GroundDive.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/SkyLaunch.java b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/SkyLaunch.java
index 803fd419a..b82567ee9 100644
--- a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/SkyLaunch.java
+++ b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/SkyLaunch.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/Superpower.java b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/Superpower.java
index aa10f9bee..68dfe2f92 100644
--- a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/Superpower.java
+++ b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/Superpower.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
index 8d4865f6b..e8d048ead 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
index 3b379946c..88a6afe47 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
index d285e6c7d..c0e9e9087 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/pom.xml b/template-method/pom.xml
index cbf2ac156..283b95a5a 100644
--- a/template-method/pom.xml
+++ b/template-method/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/App.java b/template-method/src/main/java/com/iluwatar/templatemethod/App.java
index f98e9f760..ee40b0482 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/App.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java b/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java
index 631a58600..01f05e70b 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
index 4ede6f023..bc550989a 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
index bf206f3a5..cdf2c11e3 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
index eaf897667..4ac7e30c6 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
index 32f09242e..4aac0be60 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
index 952705756..02beef759 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/HitAndRunMethodTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/HitAndRunMethodTest.java
index 2ef08aa8e..a129118a6 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/HitAndRunMethodTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/HitAndRunMethodTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
index 95326eeec..58f4bef31 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/SubtleMethodTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/SubtleMethodTest.java
index b0d023f7d..9d17c2c52 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/SubtleMethodTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/SubtleMethodTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml
index 3727bd240..7cafb4708 100644
--- a/thread-pool/pom.xml
+++ b/thread-pool/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
index cc3c4cb18..6562b68fb 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/CoffeeMakingTask.java b/thread-pool/src/main/java/com/iluwatar/threadpool/CoffeeMakingTask.java
index 46f5ea254..99d99c20e 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/CoffeeMakingTask.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/CoffeeMakingTask.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/PotatoPeelingTask.java b/thread-pool/src/main/java/com/iluwatar/threadpool/PotatoPeelingTask.java
index f0e6fd633..cf5fc3ce8 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/PotatoPeelingTask.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/PotatoPeelingTask.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/Task.java b/thread-pool/src/main/java/com/iluwatar/threadpool/Task.java
index 7822f1638..cab1d5f79 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/Task.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/Task.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
index def9e0b22..797d9f693 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
index 4c1cf90d6..9a0590721 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/CoffeeMakingTaskTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/CoffeeMakingTaskTest.java
index a523b3a77..9b983a568 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/CoffeeMakingTaskTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/CoffeeMakingTaskTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/PotatoPeelingTaskTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/PotatoPeelingTaskTest.java
index b7444614d..e5d627828 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/PotatoPeelingTaskTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/PotatoPeelingTaskTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
index 67b8cf059..66052659c 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
index 63d2355b2..854642ae1 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/pom.xml b/throttling/pom.xml
index ba2ca9c47..d832d3d77 100644
--- a/throttling/pom.xml
+++ b/throttling/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/App.java b/throttling/src/main/java/com/iluwatar/throttling/App.java
index 44a2f150e..cc3eb11c6 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/App.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/B2BService.java b/throttling/src/main/java/com/iluwatar/throttling/B2BService.java
index a0e3a571a..70657afd8 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/B2BService.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/B2BService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
index 115d6781e..d5ba4e132 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/Tenant.java b/throttling/src/main/java/com/iluwatar/throttling/Tenant.java
index 5fe2c72db..60a08704f 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/Tenant.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/Tenant.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/timer/ThrottleTimerImpl.java b/throttling/src/main/java/com/iluwatar/throttling/timer/ThrottleTimerImpl.java
index 70d3c5074..9d69481e3 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/timer/ThrottleTimerImpl.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/timer/ThrottleTimerImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/main/java/com/iluwatar/throttling/timer/Throttler.java b/throttling/src/main/java/com/iluwatar/throttling/timer/Throttler.java
index 2f4fca30e..878a6789b 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/timer/Throttler.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/timer/Throttler.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/test/java/com/iluwatar/throttling/AppTest.java b/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
index dcabb02b3..ffc611b9d 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java b/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
index 786325237..78dcd3ea8 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java b/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
index 32e1b0f48..d9aabc9a9 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/pom.xml b/tls/pom.xml
index 54e911e40..a2a7ad905 100644
--- a/tls/pom.xml
+++ b/tls/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/main/java/com/iluwatar/tls/App.java b/tls/src/main/java/com/iluwatar/tls/App.java
index 9dd611512..26adafc69 100644
--- a/tls/src/main/java/com/iluwatar/tls/App.java
+++ b/tls/src/main/java/com/iluwatar/tls/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java b/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
index 4e5c14e0b..9f1743ae2 100644
--- a/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
+++ b/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/main/java/com/iluwatar/tls/Result.java b/tls/src/main/java/com/iluwatar/tls/Result.java
index 38dc197cf..1cbc78355 100644
--- a/tls/src/main/java/com/iluwatar/tls/Result.java
+++ b/tls/src/main/java/com/iluwatar/tls/Result.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/test/java/com/iluwatar/tls/AppTest.java b/tls/src/test/java/com/iluwatar/tls/AppTest.java
index ba3774b3e..d2231b5d7 100644
--- a/tls/src/test/java/com/iluwatar/tls/AppTest.java
+++ b/tls/src/test/java/com/iluwatar/tls/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
index 5338829d0..9713c9b39 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
index 7b3d6b4ad..7b7e33ffd 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
index b3328d4c5..a0a8a7430 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index 6cc0ac283..c869c98f4 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
index c547388a2..abe200753 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
index 7529435fe..579c5ee2a 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
index 98ad31fe5..6981c332e 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
index 3e019097e..cffdb87af 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
index 4b9432408..77d4276ff 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
index 72e559fb5..a6676bab0 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
index a8155bcb9..f743140d7 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
index 6def17cd1..c23a74381 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/trampoline/pom.xml b/trampoline/pom.xml
index d78236473..48b501be6 100644
--- a/trampoline/pom.xml
+++ b/trampoline/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
index 40117a67a..b28a14803 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java b/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
index d59950b29..754a55d2c 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
index 664a95634..6eff6d99e 100644
--- a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
+++ b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/pom.xml b/transaction-script/pom.xml
index 7a6f40219..88bf09578 100644
--- a/transaction-script/pom.xml
+++ b/transaction-script/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
index 59ea5363d..db599cc2e 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
index c24ea4f68..c00d0ae65 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDao.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDao.java
index b06211905..36eddf83a 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDao.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDao.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
index 07c88b698..f289712a3 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
index fedf4ed21..868f860ca 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/RoomSchemaSql.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/RoomSchemaSql.java
index 4d919137a..58ebd298b 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/RoomSchemaSql.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/RoomSchemaSql.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
index eb819cabe..8f3d6e0da 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
index 6dbbc8ff4..67eb52def 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
index ab0265244..b0b7f8bd4 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
index 6755c2e5a..022c2e023 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/pom.xml b/twin/pom.xml
index b879ac593..687705935 100644
--- a/twin/pom.xml
+++ b/twin/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/main/java/com/iluwatar/twin/App.java b/twin/src/main/java/com/iluwatar/twin/App.java
index ccd91f6e0..f7f6c44ff 100644
--- a/twin/src/main/java/com/iluwatar/twin/App.java
+++ b/twin/src/main/java/com/iluwatar/twin/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/main/java/com/iluwatar/twin/BallItem.java b/twin/src/main/java/com/iluwatar/twin/BallItem.java
index 44884bb50..4498a5c43 100644
--- a/twin/src/main/java/com/iluwatar/twin/BallItem.java
+++ b/twin/src/main/java/com/iluwatar/twin/BallItem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/main/java/com/iluwatar/twin/BallThread.java b/twin/src/main/java/com/iluwatar/twin/BallThread.java
index f302016c8..e9465f73c 100644
--- a/twin/src/main/java/com/iluwatar/twin/BallThread.java
+++ b/twin/src/main/java/com/iluwatar/twin/BallThread.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/main/java/com/iluwatar/twin/GameItem.java b/twin/src/main/java/com/iluwatar/twin/GameItem.java
index cc9fb0808..ef986997b 100644
--- a/twin/src/main/java/com/iluwatar/twin/GameItem.java
+++ b/twin/src/main/java/com/iluwatar/twin/GameItem.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/test/java/com/iluwatar/twin/AppTest.java b/twin/src/test/java/com/iluwatar/twin/AppTest.java
index 38a3208ad..1cd51a294 100644
--- a/twin/src/test/java/com/iluwatar/twin/AppTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/test/java/com/iluwatar/twin/BallItemTest.java b/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
index 18aba2bed..5c927b35c 100644
--- a/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java b/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
index 568e2ccd6..f42c29f5e 100644
--- a/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/pom.xml b/typeobjectpattern/pom.xml
index 03af8e78d..703e9acba 100644
--- a/typeobjectpattern/pom.xml
+++ b/typeobjectpattern/pom.xml
@@ -1,7 +1,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
index 80054a5fb..e9b42d659 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
index 7183c99df..a7b038664 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
index ab175e660..d80b6a775 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
index 76629b9dd..54de9bc95 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
index 923a5c403..3ca79cab6 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
index 150c648d3..38a129191 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/JsonParser.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
index 69bcc67c5..8d49136f3 100644
--- a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
+++ b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CandyGameTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellPoolTest.java b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellPoolTest.java
index 777dae2dd..a94522a32 100644
--- a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellPoolTest.java
+++ b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellPoolTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
index 6d910e47c..9bd0326c2 100644
--- a/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
+++ b/typeobjectpattern/src/test/java/com/iluwatar/typeobject/CellTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index 1d57e138f..1770a9742 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
index 6caf1de49..50d1598e6 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
index e5e24817f..f72d83a12 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/IUnitOfWork.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
index 92733feba..74d0581e7 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentDatabase.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentDatabase.java
index 1f5cb3173..c64c47e30 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentDatabase.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentDatabase.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
index 70433ed98..d11f07aa2 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
index 36e738626..ede021742 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
index 630bb1392..79ece6058 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
index 6cf1e6e16..e00340d84 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/pom.xml b/update-method/pom.xml
index 3a60d433b..b49ab3c07 100644
--- a/update-method/pom.xml
+++ b/update-method/pom.xml
@@ -1,27 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-  ~ The MIT License
-  ~ Copyright © 2014-2019 Ilkka Seppälä
-  ~
-  ~ Permission is hereby granted, free of charge, to any person obtaining a copy
-  ~ of this software and associated documentation files (the "Software"), to deal
-  ~ in the Software without restriction, including without limitation the rights
-  ~ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-  ~ copies of the Software, and to permit persons to whom the Software is
-  ~ furnished to do so, subject to the following conditions:
-  ~
-  ~ The above copyright notice and this permission notice shall be included in
-  ~ all copies or substantial portions of the Software.
-  ~
-  ~ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-  ~ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-  ~ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-  ~ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-  ~ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-  ~ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-  ~ THE SOFTWARE.
-  -->
 
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
 <project xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/App.java b/update-method/src/main/java/com/iluwatar/updatemethod/App.java
index 45069a3de..e964eb478 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/App.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java b/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
index 0f10d7775..b8fbac3df 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java b/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
index e365d6aec..b28b35790 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java b/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
index f1f3e2a87..11b6f2438 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/World.java b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
index 37211abb1..89f8d726f 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/World.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
index 4849c4e62..6158e7491 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
index 73ab9eb1d..2562180b8 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
index 2d523237c..eea6bbeb1 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
index 2a9dad316..b8d95f140 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/value-object/pom.xml b/value-object/pom.xml
index dbbbccd01..41c84af84 100644
--- a/value-object/pom.xml
+++ b/value-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/value-object/src/main/java/com/iluwatar/value/object/App.java b/value-object/src/main/java/com/iluwatar/value/object/App.java
index 5f0d69ecc..3c91c54f3 100644
--- a/value-object/src/main/java/com/iluwatar/value/object/App.java
+++ b/value-object/src/main/java/com/iluwatar/value/object/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java b/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
index 453718875..118658646 100644
--- a/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
+++ b/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/value-object/src/test/java/com/iluwatar/value/object/AppTest.java b/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
index 39eaef28c..91f58c514 100644
--- a/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
+++ b/value-object/src/test/java/com/iluwatar/value/object/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java b/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
index 122205a57..27645673d 100644
--- a/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
+++ b/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/pom.xml b/version-number/pom.xml
index b5748c93b..0265e2d85 100644
--- a/version-number/pom.xml
+++ b/version-number/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/App.java b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
index cffba50d4..1e23589df 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/App.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/Book.java b/version-number/src/main/java/com/iluwatar/versionnumber/Book.java
index 93b35880b..02595c572 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/Book.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/Book.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
index cd993b147..b48568b69 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookDuplicateException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
index f832f350f..93f43abbf 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookNotFoundException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
index ef41e79ac..4764035dc 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/BookRepository.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java b/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
index 94ea0fd9e..0e00d5023 100644
--- a/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
+++ b/version-number/src/main/java/com/iluwatar/versionnumber/VersionMismatchException.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
index 7b4984901..2656a0672 100644
--- a/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
index 6b7b2b39a..22aa5ba3b 100644
--- a/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
+++ b/version-number/src/test/java/com/iluwatar/versionnumber/BookRepositoryTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/pom.xml b/visitor/pom.xml
index a08f6ee8c..c34c57433 100644
--- a/visitor/pom.xml
+++ b/visitor/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/App.java b/visitor/src/main/java/com/iluwatar/visitor/App.java
index fc4caa1f1..6f4be74f5 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/App.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/Commander.java b/visitor/src/main/java/com/iluwatar/visitor/Commander.java
index 782d0116c..a7c0a0252 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/Commander.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/Commander.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
index c34c8ed9e..92d242106 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/Sergeant.java b/visitor/src/main/java/com/iluwatar/visitor/Sergeant.java
index bdc96892a..d92cfce3f 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/Sergeant.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/Sergeant.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
index 59fb405e5..089c467a8 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/Soldier.java b/visitor/src/main/java/com/iluwatar/visitor/Soldier.java
index a2a812416..ae27bd9c5 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/Soldier.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/Soldier.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
index 1f19a6458..0a0de0f7a 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/Unit.java b/visitor/src/main/java/com/iluwatar/visitor/Unit.java
index 3597c4d60..e112423c5 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/Unit.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/Unit.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/main/java/com/iluwatar/visitor/UnitVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/UnitVisitor.java
index 8300fd1fe..29aefc1ad 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/UnitVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/UnitVisitor.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
index 45f7006a7..1f286a2c8 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/CommanderTest.java b/visitor/src/test/java/com/iluwatar/visitor/CommanderTest.java
index 256a0cdbd..1e6895550 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/CommanderTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/CommanderTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/CommanderVisitorTest.java b/visitor/src/test/java/com/iluwatar/visitor/CommanderVisitorTest.java
index 935baa58d..58c6c6f14 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/CommanderVisitorTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/CommanderVisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/SergeantTest.java b/visitor/src/test/java/com/iluwatar/visitor/SergeantTest.java
index fd977f2bc..77fcbafe6 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/SergeantTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/SergeantTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/SergeantVisitorTest.java b/visitor/src/test/java/com/iluwatar/visitor/SergeantVisitorTest.java
index 05eae49f2..cef0dd0df 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/SergeantVisitorTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/SergeantVisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/SoldierTest.java b/visitor/src/test/java/com/iluwatar/visitor/SoldierTest.java
index 3d2c7698f..a59eca6b4 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/SoldierTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/SoldierTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/SoldierVisitorTest.java b/visitor/src/test/java/com/iluwatar/visitor/SoldierVisitorTest.java
index 653d814c5..0bc78794c 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/SoldierVisitorTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/SoldierVisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java b/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
index 0356782d7..f41cce068 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java b/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
index fd2f1cb76..4e9f8d958 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

From cbffcb28c87647f3b0a4463f06c4a3ddeb8a2c92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Sun, 14 Feb 2021 22:12:21 +0200
Subject: [PATCH 219/254] #455 Static content hosting cloud pattern (#1654)

* #455 work on readme.md

* #455 work on readme.md

* #455 S3 web site complete

* #455 add cloudfront and diagram

* Apply suggestions from code review

added syntax highlighting

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 cloud-static-content-hosting/README.md        | 170 ++++++++++++++++++
 .../etc/static-content-hosting.drawio         |   1 +
 .../etc/static-content-hosting.png            | Bin 0 -> 88049 bytes
 3 files changed, 171 insertions(+)
 create mode 100644 cloud-static-content-hosting/README.md
 create mode 100644 cloud-static-content-hosting/etc/static-content-hosting.drawio
 create mode 100644 cloud-static-content-hosting/etc/static-content-hosting.png

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
new file mode 100644
index 000000000..0f1fb3207
--- /dev/null
+++ b/cloud-static-content-hosting/README.md
@@ -0,0 +1,170 @@
+---
+layout: pattern
+title: Static Content Hosting
+folder: cloud-static-content-hosting
+permalink: /patterns/cloud-static-content-hosting/
+categories: Cloud
+tags:
+- Cloud distributed
+---
+
+## Intent
+
+Deploy static content to a cloud-based storage service that can deliver them directly to the client. 
+This can reduce the need for potentially expensive compute instances.
+
+## Explanation
+
+Real world example
+
+> A global marketing web site with static content needs to be quickly deployed to start attracting
+> potential customers. To keep the hosting expenses and maintenance minimum, a cloud hosted storage 
+> service along with content delivery network is used.
+
+In plain words
+
+> Static Content Hosting pattern utilizes cloud native storage service to store the content and
+> global content delivery network to cache it in multiple data centers around the world.
+> 
+> On a static website, individual webpages include static content. They might also contain 
+> client-side scripts such as Javascript. By contrast, a dynamic website relies on server-side 
+> processing, including server-side scripts such as PHP, JSP, or ASP.NET.
+
+Wikipedia says
+
+> A static web page (sometimes called a flat page or a stationary page) is a web page that is 
+> delivered to the user's web browser exactly as stored, in contrast to dynamic web pages which are 
+> generated by a web application.
+> 
+> Static web pages are suitable for content that never or rarely needs to be updated, though modern 
+> web template systems are changing this. Maintaining large numbers of static pages as files can be 
+> impractical without automated tools, such as static site generators.
+
+**Example**
+
+![alt text](./etc/static-content-hosting.png "Static Content Hosting")
+
+In this example we create a static web site using AWS S3 and utilize AWS Cloudfront to distribute
+the content globally.
+
+1. First you will need an AWS account. You can create a free one here: [AWS Free Tier](https://aws.amazon.com/free/free-tier/)
+
+2. Login to the [AWS Console](https://console.aws.amazon.com/console/home?nc2=h_ct&src=header-signin)
+
+3. Go to Identity and Access Management (IAM) service.
+
+4. Create IAM user that has only the necessary rights for this application.
+
+* Click `Users`
+* Click `Add user`. Choose `User name` as you wish and `Access type` should be `Programmatic access`. Click `Next: Permissions`.
+* Choose `Attach existing policies directly`. Select `AmazonS3FullAccess` and `CloudFrontFullAccess`. Click `Next: Tags`.
+* No tags are necessarily needed, so just click `Next: Review`.
+* Review the presented information and if all seems good click `Create user`.
+* You are presented with `Access key ID` and `Secret access key` which you will need to complete this example, so store them safely.
+* Click `Close`.
+
+5. [Install AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html) to gain programmic access to AWS cloud.
+
+6. Configure AWS CLI with command `aws configure` as desribed in the [instructions](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)
+
+7. Create AWS S3 bucket for the web site content. Note that the S3 bucket names must be globally unique.
+
+* The syntax is `aws s3 mb <bucket name>` as described in the [instructions](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-buckets-creating)
+* For example `aws s3 mb s3://my-static-website-jh34jsjmg`
+* Verify that the bucket was successfully created with command `aws s3 ls` which list the existing buckets
+
+8. Configure the bucket as a web site with command `aws s3 website` as described in the [instructions](https://docs.aws.amazon.com/cli/latest/reference/s3/website.html).
+
+* E.g. `aws s3 website s3://my-static-website-jh34jsjmg --index-document index.html --error-document error.html`
+
+9. Upload content to the bucket.
+
+* First create the content, at least `index.html` and `error.html` documents.
+  
+index.html
+```html
+<!doctype html>
+<head>
+    <title>My Static Web Site</title>
+</head>
+<body>
+    <h1>I'm the index.html</h1>
+</body>
+```
+
+error.html
+```html
+<!doctype html>
+<head>
+    <title>My Static Web Site</title>
+</head>
+<body>
+    <h1>I'm the index.html</h1>
+</body>
+```
+
+* Upload the content to your bucket as described [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy)
+* E.g. `aws s3 cp index.html s3://my-static-website-jh34jsjmg` and `aws s3 cp error.html s3://my-static-website-jh34jsjmg`
+
+10. Next we need to set the bucket policy to allow read access.
+
+* Create `policy.json` with the following contents (note that you need to replace the bucket name with your own).
+
+```json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Sid": "PublicReadGetObject",
+            "Effect": "Allow",
+            "Principal": "*",
+            "Action": "s3:GetObject",
+            "Resource": "arn:aws:s3:::my-static-website-jh34jsjmg/*"
+        }
+    ]
+}
+```
+
+* Set the bucket policy according to these [instructions](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-policy.html)
+* E.g. `aws s3api put-bucket-policy --bucket my-static-website-jh34jsjmg --policy file://policy.json`
+
+11. Test the web site in your browser.
+
+* The web site URL format is `http://<bucket-name>.s3-website-<region-name>.amazonaws.com`
+* E.g. this web site was created in `eu-west-1` region with name `my-static-website-jh34jsjmg` so it can be accessed via url `http://my-static-website-jh34jsjmg.s3-website-eu-west-1.amazonaws.com`
+
+12. Create CloudFormation distribution for the web site.
+
+* The syntax is described in [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-distribution.html)
+* E.g. the easiest way is to call `aws cloudfront create-distribution --origin-domain-name my-static-website-jh34jsjmg.s3.amazonaws.com --default-root-object index.html`
+* There's also JSON syntax e.g. `--distribution-config file://dist-config.json` to pass distribution configuration arguments in file
+* The output of the call will show you the exact distribution settings including the generated CloudFront domain name you can use for testing e.g. `d2k3xwnaqa8nqx.cloudfront.net` 
+* CloudFormation distribution deployment takes some time, but once it's completed your web site is served from data centers all around the globe!
+
+13. That's it! You have implemented a static web site with content distribution network serving it lightning fast all around the world.
+
+* To update the web site you need to update the objects in S3 bucket and invalidate the objects in the CloudFront distribution
+* To do it from AWS CLI see [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-invalidation.html)
+* Some further development you might want to do is serve the content over https and add a domain name for your site
+
+## Applicability
+
+Use the Static Content Hosting pattern when you want to:
+
+* Minimize the hosting cost for websites and applications that contain some static resources.
+* Build a globally available web site with static content
+* Monitor the web site traffic, bandwidth usage, costs etc.
+
+## Typical Use Case
+
+* Web sites with global reach
+* Content produced by static web site generators
+* Web sites with no dynamic content requirements
+
+## Real world examples
+
+* [Java Design Patterns web site](https://java-design-patterns.com)
+
+## Credits
+
+* [Static Content Hosting pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/static-content-hosting)
diff --git a/cloud-static-content-hosting/etc/static-content-hosting.drawio b/cloud-static-content-hosting/etc/static-content-hosting.drawio
new file mode 100644
index 000000000..50281e5e6
--- /dev/null
+++ b/cloud-static-content-hosting/etc/static-content-hosting.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-02-14T18:28:17.242Z" agent="Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/12.1.0 Chrome/76.0.3809.139 Electron/6.0.7 Safari/537.36" etag="QnfBZG6C0m1UGNnIYq8H" version="12.1.0" type="device" pages="1"><diagram id="yBzANdZOEQQZAcADu5ny" name="Page-1">7Vpbc9o6EP41PMZjW77AY0Kh56HttMOcIX3qCCxsNbLlyjKX/PqzMvING9rMQGE4mWQS72olrfbbXe8KBmgcbz8KnEafeUDYwDaD7QB9GNi2hRwL/inObs8ZIc0IBQ20UM2Y0Veimabm5jQgWUtQcs4kTdvMJU8SspQtHhaCb9piK87au6Y4JB3GbIlZlzungYz23KFr1vx/CA2jcmfL1CMxLoU1I4twwDcNFpoM0FhwLvdP8XZMmDJeaZf9vOmR0UoxQRL5JxOePj8vvN38XzEXc/KNzvDj65cH29PKyV15YhKAATTJhYx4yBPMJjX3aZmLNVGrWkDUIp84TzXzJ5Fyp8HEueTAimTM9CgoLHbPQJiGW5Lfm2MflPuYFbUrqS2Vz6UcPH+vlwCqnqSIcs7+eOpMR82mWRnPxZKcspWr/Q+LkMgTgsMKXQgLwmMCh4B5gjAs6bqtCNb+GVZyNYTwoFF8C6L+NRDVyJg3jox/VWS0lmvMcr1VFyrGILMpSDYRlWSW4uLgG0iubYvrpYiQZHvaft3j6gn2SCukU7M30plqUyc6G2le1Exy/uhCJhreloWc0iLaQrZvGe61beTflo089/ZMNLqhl5r5m5faGdNgWR/ddBYsC7vrgGO9Q3NCSes9bm62rrN60vzfBGfYRsewQKHflOuK+koEBQMQ8X+FrfO2DsiaMJ6CRQ7x5LlkNCHjqpVVBlvxRI4546KQQfAzVds/hQIHlNRjCU8U4ivKWJ94JgV/IQfCAc6iwj3URqoKoND4fsILwr7yjErKExhbcCl53BB4ZDRUA1I50RPW1BJ0USg33Ufprn2r8JaC1udVW+Is3R90RbdKj6eUU7XKZA2LZXoR6JtTNSHehuqKwcCbzDHyrNjrDPUL8ts1ntctgv1ht3gpeefvEjoO8zifAWOG4M8iX76Ar/+R41wa3B5ckLFX8MeGyugHX/wEbbKuU05M13bQcR8+A6qW20YVoS6sXk9N6lXV69mBRUeAHTOeB1MBoXHDuC6VkqtCyQ6cU3foIu+icLqeZ7T7DGQ5PX2GX4k1QR2hSyX3LqaWoS4jBcGSHI9XMIQ8MHpfem7aWbM6wB3iG9MgYMc6P8HzJKh85xxhZrfDzOrJnpbVE2flvPND4nQgsRUkOAhgvTwN9sCUuelukaku0Mu+3OxBpq8rvxwy3esv1AqWgIKt6SIvUtjdAuOWSaMMGf/qwHRvlJwqZEyaAJ9C2AAqdxwvnnMQL9bVYRl1YClfJ+aGLOBVr4KGJEFRNA9sjykkFtBWeOEeEwmWelRKqF8Px8pwe6FinYcEx6QaKOYYGXrQaz+0pwgSggP0TcExfoWmcpMZS6g47tZBDvKp0/OmQ30V5cX8o1y44R+NKg3SKY8xhURqasxOuUdgv6DtJsG/8DD5tW1Ue0ai/G16v7A69s3h2r0yUN1uN/e+Xxe86bogO9d9gdVyGN8x+xqRv3llYL3pY7PSQEWQHwmzM3+M1g4xt6cU9Z2eEKua+DdYDMj6KxXFWOOLKWjyHw==</diagram></mxfile>
\ No newline at end of file
diff --git a/cloud-static-content-hosting/etc/static-content-hosting.png b/cloud-static-content-hosting/etc/static-content-hosting.png
new file mode 100644
index 0000000000000000000000000000000000000000..6e0baa95e0f99d3a8a32063531060a8fe80a9323
GIT binary patch
literal 88049
zcmeFYhdZ2I*EWub7GjhXA<?5G>L`OKV+O+*y^C&)GJ3B;5WOY3M2YAUB_Tx(NhCTU
zNP>{)B5HKs9`5IO-{<~*f5Gqgj$;xtSJ~IzYp-&ybFC{zOGAZ*>IxMR5fP0l3aLXx
zbOs0hB~p-qBN0T7LPSIq!d^;7Ue11Y4tOjPHxzODjayXM-qq8K8;ax>6;;AxZM-~O
zUBFjx+}YLE!Oj6|dwNb(SX4wnSX4knOiu*H4TXym{)0jVMTJF7POrDZVO{<i2;&;y
zfX7>Liz<r?3WK3|jYLGap^D&}x`T_iANcDBldzBw;{)H|Zf<z2A=Vo0;6=C|Dk%t+
zAl!mR>0#8lMG@dT-oXhA{-|JWoLmXF*m_v`3Ocxg%SA*5MNXc8u=j9v1{WzyN(c%I
zLSe#Ef+A2UaP9xBNttj)5**UCva|AV_+JkrtQPBKg*#oTqok86Oh6qih0+r<P_t4|
z$LiReuFwbT;pqUxb0Vz&JeqK`m%khK^r$V?$H4~7gK*RhNW}A>iwQ@dN<i$k4pul1
zD`#-p;UCHRD+a(dY)v$kw6#s(HgKf3xQqYk04`QwNhc4}0z(OioDL#s;AU+j<tm}1
zB_^VUF>y4Ml!O}#qwU2dP+ndbO&e7ss5=7T=c!?>j`w#&8-aytxd&i;R5etjJTTfS
zN@C82+PadWu6PeSYilDc46W#lv#}0<p<R@$?6CSsV_&2dQc_z{N=3s#)LzFI?1Hj`
zi>9?F%tX~jSXEJ5R9GJ)YAkGkb#S(_b{2Qk#u@5+Y1?>;IqBK@VAS+sx}I*@UMPDj
zgte5L0~#i2<t<?>rlts0u~x;K-~+r}aK-_mP_(j#h!0Q(WdvN*(Z<<MT?B#gQ+L%D
zQ5Ey@^+nofD7(30gq7`m)qQNWU`8ewXQUd|%EV5}N7GqHSl`u8TSr}7%}*1n<p}ff
z(SX8?0+fuvRw<)30(_8;65=)}Q7J97zk!Iju{|0N*V9w8H}(_rSJc9&IT}H&Oq|s<
z3{*S}osjyfZZI*u0HXjkab<ru7)r?-s|R;**2734aIWeoYb|Xx2NgqcbvtKKj2&Lf
z+gRCJ-@{#3)F41Y-$o0?Evo2)_eHq7xa+Fgcmfqu#A>=>bYP;+hB_`<ekN!ePd7sk
zFfna#O5F*A)5CdU&_>!gbzf%;!d^^K9Onr4l(2U9LTFfnOH>R@{56dAd|j25VF(Ez
zenkx(q=CO04(jMike7j>t}x!&2V>(QVxa8rp`xmeannT_>);J_4aL0GaVo+N-qyxG
z9&W}C+9oI;D?2Z!qXf=HR2Sjxq%Vnq3cKOm_5E!mR7CMu5hXvMZOY#E2sL{TEZ)`7
zM%Y2!O54N4M+GY(VvW_a!@CN@fF&uLU^LX-?eXFs;?ClBRw}j{I71z9*w$9j*b^b?
z<AGDrl+uQ3Aat>wQr6BAq8=U^62d+Kc8V%?#yXx@Uu`tX4zKBr2Fr1BRZ`T(Xv2VR
zDk^)}X^J8}9jq{F5(ph_Nk4IQypsk3<>>BaV4#Ti@zYTi6Bm;}YirxV0}O0E!6WUp
zRZ(~i9Y=&dOkd2w2W_Y(C8mZm0B2OS?GSJq2?t+CsJ@Q7E80~9DQ4%Xs_yF{>F=oI
zfmZUfx3)px#i5FdVkSr(eYl9KxUi0vp@^cIu)Z!13e~rB^KcRMfT>v_M7(Vc48a6d
zJ)t^M!aCNrXh#XGzP_Xp+5|4DZerxBBcbM{r=g3&+IzdBeQgld0Z5d;hlZmEQcGVQ
z=H)5k;$`E7^AWN4g5un;SUVpjM^{Z)fP)>}P*X(=19LEvlz<b|0z5=VOvKj;swi&b
zq^@iP!(dhXy>Tdl>G~>JTcf@8g~c%<P-|@)9T>P6F5zw{Dr{`vsw?4X<Rqmbfj2Uc
zkaAYk(Z|A3dYV{85sad%5en&zkT7rpO69LDVWSVVb5->QH#^v<yJJlx^(2uh+TvP9
zqAEsWP9oYmqV~G}Mo@KkD??XZF-Juk6<w67lo3W%8-_u-*<qa}tqiR(626L12Nfv{
z&KP4Op#?()sG;p);(mViCLVUk08I}y7dLAIB~d%Pj}{QTi#E<vN8d>kZjbZP^VN{@
zMCf~C@!n2WPTs;8!c?G|eu{4HFb^L;Uw<gp(?<mEZirJwdr9c3`sjN(+QPjx4Rx(B
z7!^Ap2zOtUjt^eV*WE<P-wLiKg%E|q-EIAReOz2H+Uio)20;Hsj1hP{H83*p+M0?6
z9%5(}H6>*o4Y-u2qra1rvX`PER#OS9<m+sR#p|Hmm0?<bFgIVU1n_UhHcEaH+E!>y
zV`CK~4{fUeFpRL9FHRSS(-PJLC+%Dfoo(DOCb|+hF-b2IMWhef4For3O=oSWuz|RZ
z5zJM@UrY?xgrWu-2h~Lz!~E=l7Fv1wX?pA1;(R2KUTU5y;0_oPDeh$`qK_4}B7`9o
z5eXkjxP+7^)Lzs>*k4~m#9IR#22n)O$PWvXuy)01O4&-`Yz_QXG+@91DEhhU_(1V^
zV|A#Tv80x+wvwSX%GWsn0|n<WA~-QWFR<ZKCZbp+v^R*tibz{yB*sw!?PsKHsHv%r
zHgxny`4S=v;R7P9@_(YzNr(c!{{aV3rA$BKdLkk=B2^?@&(D1M;n@fJ!<XJm3efP2
zTM{8+irCn`f9Lytl>_B_Pi*k}cbY+VZuV3TGaahCq0t9ld=Dn)a;&De-mI;>m{80N
z>>Zo)ed;;s`&Vus8L%<i!(5O;M49~GpPe)Xu2^Wx`rH(k0?B`U@+q`(*Ob|a>Hqt4
z6_O7dYUAiX`>*5l`LG$;e+{8PBF(1YUVK+6|J;8KO}NbcePAdl>c2l;3Zc{L<Z%j@
z{&gG`IvxM_zvm5>F&|3wF6;coFu{K<DVgXU)9SycP2W#U91FdAlf>-5mjhN23!OOg
z@9E{AAz{Qx8<D>LzgEPEYb5{o^c2WRd3(L8DZIk|y&~RTKiYp!FZ4W+?1ClTJjuT|
z0|@-u|24h;C-DC#@PDh&{|_|0nmUX}^X|`YkrtnWXjx^-j@0Rr^-{^X(q6h-ckwI?
z8AYAtQ9JQS`SQRP_e>cAkS9N<;3V=avg|TGs~IbAw!5mn`f@Hy875ZhG`fY9=@dNZ
zh-2n?yW~&&k8%0M0xwa5s%1U(S7vlZFI?i{b40(g!!M@KK<rmcB_1#mfAkWUlt!G4
zZ>a$uH+$Q#H<n<`H_=2XwNHcZMe==;JH8obz2PctBPtcN9I?0G^VRp)_QSvekGrU)
zEsTuv;LSio_i2JBnPLV*H2>(<K6Mn0>O}h=$r5teqBF-#6>7Os_m9hB-^Kl;{Suec
zu-du(5Eb@~M<p?j%E$TJOLyD#d3dS}PC}?J;`{v*r)QJ~mY{F=XyZD;t1-}p3Ret0
zzgsm*UVM>91Mi?$@>;Ci^!t<OOB`-9CEX$DBAV4nOu4~LXO4hesuMAUniE_OmV2K3
z^e38Bk-<*?Q^o^xv+*}vpA@BuQ$}iSG%2Y9?Dn<$dY#keAO907LU|~)a{W`U?{l1Z
z)IWS-{SjG`9Hy5`eC}_198F`t9yE$1YW{E+K9%oxIuIVdr}nd-{#2oSzBsCz)_IRT
z!TnQaoB3CU;_c@NmxU@uTwlCuu-r3xmN3VA#$4r8^4AEGH%9kHoJd~Day$H&=+4&|
zxdhwD`1}G?=OYYSHdW4{?A?s5>Ph5K<OXqs`R<9=ZFM8n(ys~XDPG@nNM3J(uQ(3A
zLCfTIpRviP80e@c@5!*)w+&}G85`B=3Ox2f)T1+}5`L+ck6vZ3-+a62pxYINt-HPQ
z>50!*-{1EQEdJKM_}=6|Nn7p{!^M0mlu-r{>kdyNgC#FX^z94$x?Qt%E!)8b3ei3n
zuaqMaFORlsu`Jv?mG%)q_^z0Fx|5#@Fw*y!M*<ARz1oIBN5&V8#XK7={0cfkzS~)h
zy+3lFRQ@fy(WU05MUbE{EeKB=mE1T*f`ro9w5ruHue|r4W-t95xLf3xauAZ^`|3)9
z^RF#qlS$XE)-ZxxTE)QP)axGPQV<@PnWxbC;Jt;$@3p0(mB)VXsD7pK+1%S1W<9TQ
zDs?=N`g?Qv0L_y}a9CQ%S<qU~FYlst3Ji2#knvXBv7S^$SCR9ePp+Rb2G>9O^>N}K
z<wjXfMN^9U4p50JzPU*A1W}=E&eBu!^i18w=VqP3xI~c|{nO}LKoHwQ_~}D0lWbq0
zKWv&*ziZdB+HH}>NmCc<_26V9*=~aeG{R4Zr$)4z=PoEwEDZ3p-{if@eWHaF$^Z~Z
zlAcP}ieg^-zfb=U60uY#31CzV*!-ATfqr(XGMA<P15+$7|8r9KoSMr2byA(gEPyse
zf2o0gF3`v2M#7@O-+kmV?YoI4hnOM?)U0pb{3#*{6`>UNu<Q1I{DrVgOI4EXdvcPc
zW|#n9hdIOZnvcj-w-2z+ay$E4_?EX*|G+F4APY}scA3*?|K~y&YvQBi*FDWT?cB5|
z{y+(Vt>ONH#Jb=)IfpH8p{=?;`7Vw)yTrd0@+`Th+CB>QIKC-l^U;Z|sIWOTi_$Z0
zs`mtbPi0zH-4hG3>0ht7R%`Q@SiISM@a7@e-T&x1CUm;nIb!(~dbMVdF8_VF3w<GC
ztH${^XLnt2%IIVr|K$bM(XDbX=<aW3@YYTqzki@SG~tqanIQh12f#IHx_ka({hE+!
zAq$HqL8?q5)%SQ_d%sKq4i2@Ojrp}O#5QaPJey7<D&*eR4aHOUKu?iC2xaF^f3?$5
zFv*$<2Uq^=&FaBzlmaKmBIl!%@S!xTuiBIC#2#dUJq!tn@Sq54G|Oda5zp!J4OZ*6
zXOzcCUZaU4HNJC+TV!t0!{B5U7@$fcw|#rF2~wigBswegY1sZ|!|FF(&yUH1S{HjS
z^Q=w3UmO2s@bvplv;FgRTa!<f5DWd~DPP{(d>{;=Kr+Ii;BHs7HH$y7Ej`lSM=e}0
za(t@OM(!yvPqgG1a@c!be3}gB<Qd)BwRx6Pb}{Kb`-z_V#evniQk||2!9c;(qZrFc
z<>lu{dxgUbf~^>Fu5nk(lXxNRHlCv`jS!-G$a8X^TMUpYdUQ1UWUCc4N!j|z5_2u%
z^4l7wBR5q0T*uX7Lv01$P{Ac!KH-5s5RA;~VjN38)eLR0=ET%#@6*}8<_hf`Ni^HX
zZomEI@%yci>#orgMLs@rSPQ*VV&;eiO1t=llKlKLqaQ)>xl$w#zMNtWm^#oBE4{|k
zF~Jn7C-J?77up7C+Bawy5+MfBMNcSD{2$Mxjti>TF3+yK@z@!qG>tiko-N<{(u_qk
z6nfGnwCDX3!R~<td5>g6PwZD0(#nJb{*O`@`7VaR)MKubKRWcPRLG|)smIUgBRBYd
zL?sz8iQ1M#_i7itip)+pHBMy2bbP}}ST}mm>e_O6{qOJZ_uu%ge!9=2`Sb7Oos0}2
zi>N*Swdu%%wGXV}5`B+k@6Yw+RU{p5Ju`1gZ8<(N4K{BH5jZ~BNNV)oP^P-T&-KP<
z#Up1OMDil1Jgb7(+E827BJGEZI*pwzDIz_3Ud}%}c7Ke16pqxlPyAuIP<}xTy~eS7
z_le-!dn+=3yFPj6{5p8o)t1eXO2*1Ic*`pC+@<vIZ+t7Bawx@erEsd$2Nxn^IJ6%t
zUs&n0A1EwqQAxV?eLIGZGs->>=01%&*jf8^_;=DU&#1<_EYIPK)A3bFm)okD!UbGv
z4^YAVLJ6mP>I<wr=tDLqApnJbp;W*}9w-Ej9p`NS?TBGOr*f%sISdx13Ybdx@BArP
z={guH(fqYG^I?6e?ac6Y??V|iw_lwph!|+lSkfh-M^jz5nm2h+$qK;}!GF!Zl5;5R
zr>_3)_@J4^NdOQP%n#~ZjY?i4o@}sxuI5=;j<f(c4c)e<IQ))!VG#9{#aQ1WQO^oV
zN-Gx`-|JtSE02UCMUFbM?ep^U*|sL{9PO5v&<6dP%(kz;)CU=XSbTYErW;&v6=}FU
zTElJEow?pCvs#)rGnvYbzHa#Rw)PjRl{HUinzfR{Y{z4lW7n5L_NVIml;9{IUNuc6
zEWD3`jl}!+H>s_*3>*d@$!HESWtWFoY#$dNUhSPh?<@?J{Q6v`yXd+8Q*{exX_;^P
zF_n9ihmEZjw=ql>p8vL>kNsS*!h;vC!>CJvO>Bc&j+1h!QM@Mi(i4iT9y-e5W;;V6
z=8~=x)LWi2?`gJHA$W)r#0oN%&8G61M!RwU?`j3@-ry0l_E0j3U}ei=*G)9%iOKFH
z5gZvA!PNWdh>=okt-X(AnV0*{T@pk^Q8RIQ&UUAAC{g8%Qt>siWKlKy30XAXHmEdW
zzf4QVh>6DbWa}R`TpJwIx^}0(fq~#Izdm<sHhShd?!Qb8Rq>Mw=vhA7r9XC<pO34*
zJ{m`M=W0xclyu^=r-+|oMWF~U7m(n4EDUn*F4y&O1#U0b)Be8tO>^5?pvbT8ScaqF
z<(Hu%)r}Dz=ke!@%|$1AGz@TwvGY4A3ovUlh(ZUy7+usRJi1y_ZkKB`4+zt@Yjx?%
zv#+E~&2EOz%+1R6E3R7vtwow122{9b$RQ@n-;Vy{EgPaXQ7zG%ZNB@wR|Z)w^<KuI
z!Y*EX&~mhgPGprAlt0>eymFVK^7_bfBy%C&imBsDgn4J*ySPjG<9MUDG}^LPPM}H(
za1%_1X`TRV_R|nA)4a_XO->PBrlZ0{JW<aYv}v|z3ecw%4N4{}qpbb*$}<p8t?3&<
z6^Ekh_|ccmZX#i=;CpX7&3~NLaDQnqFuKyDWq5?eA@N*ElK5wq+=nt$t@hSE<}b0I
z9`G4G5YT*d>%4cur3+S+lF09G>0NkJ6;F2aF(5Obi=PHu34)<l;2(V?8;ECR91ESI
zVxrs_ITDDjmhznCg-6w}cmDa91uYTuACoz2Wl-X9&vL&j_QIzdoMhX=wx1~-vPOkU
zvM!LC*h?~P3p-lV?2pyEP740&%E<8e^{I@u93kyA&vWy~_K$n4;}Ogp{;0Fc?93;!
zxEuy#L1z#n2Q+^^ooKLj`Q2q5vU3-2+VAI66$(*v|K8tPDv9;~*_UTQDO!}y^zqXd
zJiU6R_$l<j74bFxx)B@se0g-Jp0=l)q~{tnzv@$q7IO*wXue!Do0B4qwuCRuSx>Pa
zQI{AmF9AOi9xYPnv%`@0^W*(DGK^mdt~>Mt0sgb_$#4NI3MDQw8H*EPl&`*I^JvFo
zfm$B(pz8K3otQd<Dif)p+mc_-vxvZF1x>6raDK-wIxnmpzVFN>a*p0JcmpIu;@nsK
zBr2Zlbvt`yJvr^Q=ak~h?;^AiwpDs%I@g%be^5C1(@yI#-_O3qBL|b|HLrwMM>fd!
z+Voa)66}fs1Q8}z+JC+dmH>flCxiJkZvDN-9$a(h_{iEzo6LuO=s4gXz(#KHEP+WU
zKdS~6%`;WtMpNhz?ZbYk9as88Q}6m#5&I`+p%J#x<fBrhkv}Coe?tQXeYceWhBF5d
zbk@wYHy&VVB@$*ymj}W7+aGJOU8Hjo1Oc%BDS<y=SF8`%a$NY@@XU%6dj%1lF5S~y
zo7VMV7dvWWr`&$~#%D*z9Fw)TySD3@ZFafkDzg#x8R>h`@+nb9Eg``U-(J>8d-gE<
z{OqJNwWYD9Q6V3V6Gx64@eMNn9OD6^CxG0)Cmd09CkSss==7V~tkEJtlt?<7rbelj
z;Qe}P7MNCyXmnk=fN8e%_vOD?1^hFGSu>c2zb}cZ!TdMb_{_Ol_(lf5-dE73%dL?J
z+Hot>c@q2F<+};czhA>vYobW>-Oqy@bOQG*Z|IdKGu|*zp9ox)eYV%y3!-kN5<mea
zOFd&i2}kKhTkf>nG<&T_Daz7#yTU+VYi-2T-|$D$HCdC9D$|l6XdLgEIQRRwu81;E
z#&j6S;|rN))Xf~tP4Da<dh<eRLl&r2>5{vLzqY5Y%=YB)+`o=V1&&2EN5WZ8tjEv?
zxNYuHH@$c9Oi)rB#Gq6Q&Tml3yD<1<BaNBm9@vZ`LSpl}I`<-Fvcf!R;#C>DxMX&I
zgE~75cfiD*<KXY?fqR=}dxQ5prXDLN3_iT`8|JmKeU(qIIKAo|^f&Ze9Bm?X>Gz_h
zm3+ry$=4w~KW@KRZQj?oD0sURd8N>yOt-|R3318f8q7_h>6Y;upDM>H$`=4EyzXbt
z0l>)UAu!6}RifTJ(whoXC3zvWN}X=SsTbLYJo#3X;x3l)GBt0q2Y<pxZFHXpq(<@9
zF3wm_`f=LLpGS3Phd!wN&TW?RX^YRbXbvhPJTNRQOsxpcwL30&`=up=<6Q4U-2t(n
zsdMFsK|=n+#sM^uj&8aS>;<(d(Hx6IU?%_+)^W+ZdsVM*{9(KH16oLICzgAt-!Nua
zU$!#wyd%{i_&=G;`O=A(Aq(nI!G^xM=iW;O+=JCBn7HD1NvxA|A-4iHQA$I9+RzvE
zaz7V3#?W)GzmjJGc(3&`A+@N{*h~fA;UuGR;iBJQ@y2n<!RsG+&ew0RVtLiVg<R|G
zdUUJ@EA3dtq3!UYr%xFMna@3VY9({rt&V&1>Ql%46_@X?v2n%Xt`oNdwidb9rr&M+
zglKF<PNGfrI12-_wKl%EvuH^5#eu~I0cG#Tl}bT?-b+$iYL0ZKa6SRidwuJRMFk0~
za_zI`J+<CksmINY?_w`>p`Ob8stEo}t)#H+Vs5v%7*E$$BNUr@L&d-tW^)^f+3~zY
zanrof=n19o@~F1H%vQsXAaP7-L1|3-QKr274d1;$XP6x2P7c`47Q@gP;Obtg6FDFt
zww%iGS{ARHcW0SZQ@LWg4tF23Z<jt0G&7O*n$MTBlib&nyP?wa-1|I}?92po^@ug}
z?$<RA@(Wry5{IkZQmctqLRMQ2*5d>Y>Go}wMye`$g~Zf4Ci9kI5|o+$6W;DKgyx6w
zwr5#DY|UPKrGV8kyNvh+%K0oCF-hPvU3zslt|KW@mUp|xqpBCp>yqPF&`UYH5Es`8
z)85Sl{?h2Dk3VrBO@KA$I{Y4Xx^sN!Yg}y^rvB)bv3_zS3K1XykYlSf*vZPekz78?
z%a4ef)!Eg^+{v^@ic}fedmV;~F{1YUY*K!I@~!5kDrdIIg-vS|ZHyY1Z%9smt7F)g
zkd90L@<xGZn2~*ufSYaJ$EN_xeBB@SH+%W}8^f6A0;cu6DN%jotU*&v#A8sfcY*|}
z!<uOx<mL)~q$8EakC9A;HqoiOkCF8}h7{O!?HKnNWv5`u22F?OgRkrozsc}Yd+hhh
zdM}(18g##9JtA^=o{lvKzfp_pO}mj1TeSPQ*2Zr`L5zljCa*gST46&1qW4TpSsfu1
zTm_+e=tp5cH$7X}9ZK~)IkT8rP5DE;nA%(Z>zA+5^ja%E@2<qIx0~kUce_3fmB1J2
zi^a%zuojmi$`X!tCt37$=v3P$G?y_$kAFm-Poz{>V-v_OmJ}&daoLO^jYk5-L{%tR
zsJ3#D7OQ7*0Cb<RI9zc<JF0fbPPj;9qAAeux<;;j)B;SLeE)M3$RPC6l*jLoE>{?>
zcSDaSn9h(<YXzF%`W^`km+NmlgIdLh9PW9WiqU9`QHUD^eEy{~z(?<v4ODTcbCf{e
zn38TUk8ui^Jl7ijG+ys~gOZ->&xn@XYJ+ZxMmh4RHSA2VT>Uk&+$PIc)JNME+MhbL
z=5NqvzQ|u8m;e3Meu0zhAh?h0?Afy5Dqc@{oA=ar-Z1>$fn6u!ODZ+5P#TIiVpIK+
zyud=a14<=Xv{s(HKzRL>w*t4--B35rCp?t)E-yl7^y-yry(E1{mMn_ZuX~3257g7w
zj*wa%$BcKS%#?iYGuE+SZTJATML%|?-uWw6@ZRR08$Y#B$k8qiEb#-WLMZ{;evuoJ
z0uN~bXkzUth~<B75aU}{hf0#vb0jd1U!JZQS~QCIrSa<*-G1dU_|o0R)yp+gj_($S
zIX~5CG}G=(EQrD=;G^`|6Ma_3ciYdFeCSx!MGn>4ek=_6%gC$Mx*&HVJb9q<2kj3Z
zr-uHb%vTpH#A3VB_3ypS9*8=Bl^+Z+*kjdjWQ(_;j^GO{coq??4Y}68()UJuv*v4q
zs}RUVQnr@9EcLw-z9sFmoXPe?S|b-${xWqU@tiO<N?MIX4wSBD5u+@C9acc1tw3xj
zj!n-Jh}1T<(F;Oni<R-?6&Y$KHMhDx$|C8hi1!QGZjo!`HFQSNFc&!vm-F}3ShgK+
zQ!EaBJ#KvaDwg-@1KB_y?!iBAVw6d^@->0O-@AP&K#8Q7EA*~;;NRcQ<BZDA1J#<p
z`U?=Rg}A0Fa+W_1v3-2hQt1qft?U1&o4dQ1=;fMAz}iowX1g*puX4F^<;dS@rgwPZ
zIIP0~6v<xMBd<9%l$!wft+S+5>Hi233q;a!=hb}Z?v4`Uz<0<8Y?fw~EPVdPE6vjG
zeHt?_DplINJO~+{YP*YF8GpeaYxn$9t<8r-eGZ!a;J~fLU%u&HKwqZ_{Cp!bh*you
zQvlkAt3{4#xy~{w)38mHen?<86m|vXz}w5x!kl@u0J|Z3J0?Roy0GAz+~Cy&yH4B7
zk}kQ_ta7)T^a?>*vXcjN^7u>Wwd7Df%H@eBQ@6|;9mYT<)ulcp-&ZViZd8?Al9M*P
z<i6h<Jh-@YXR_B*NPmZsulIIS*TL8GX)N-4^PCIgFDmX_b+_6q(ahs-0SR3t(j?)E
z`0e>f44CIF0<6*H8lwdsD}kt-kz*JK64dm9a3Qhb3PVFy6E~7=eG0x_-rnxLW0eM%
z?_4@XsPM@<%FindpYf;o?5<<E2V*Y^ICePn<LHHN0Zyu2h@D4)WRF9uImrLx1HSvz
zOrl7OME?P1#<L3iGr(k<V6pCR>M!ALg=SB8zx4I!ctp!Aq0Z(3d<y;AJL#tBowXUY
zBBdC5r5LemwpBxsg{H-T-L@Nl@~Z>Y+CVC3-pK2}{xjv3=Uh1=qskh#VZXPzQ0wwt
zx<Y+y!Cxm=Dly(6A+c_7DGj&@ed99#E)G=0o!^aICXap&rqc-!{;%)8lisCQg+PAg
z1`^h+z=Ki1j42>zyR#na_-n~csL}p$`tr1_F7Z!s?nMdWK=*VIQ$MD0GP_5@Ee{@y
z)#v@`B%YbLj?NHFGp@7y2ykD5Ow4g$v)`IElepu9=T2WVu87%N?(Dh&W%dP%5n#c-
zr$Qpl)8FXt>A$s@*8S*kGDGd*n`M!|YUwxmcBZYl;fqwa0^MiT0xRkZV9@PPoa+&e
z(f4RsCAN`AtHJG2G`~LH=c#oZ=GX1Mcb|>8iQw{=KJ^RH_e&A$?I>Qcxp)3*5txni
z-;s^q-ix1AQ+YH6E$$q?n3It-PP*~MB^?xSvhW5I4}mS${Q7x>nYbF!6!@?e5Hv*q
zq=Y|rg^mKB{>0>kV>y3S+TfR-YM<P@?!a1@a8>hsl=D$UI^J4o5C;(c>^>)0G<*C6
zGy{Lr9LSWKuMGZ~nX0U7|Ipbr5Lszb^MJq(&;M%F_&_RX_L|FoV>WFvWFPavT>AI8
z{P6+jg&PJBid65HAJ&V3_|*p%vvE^%TbZPor@z6~BCWU%+jViMPrR~2oICnIy#SPU
zy}8B&kXo+uA6)o%buuF~lxP>QN8CQkqjY92(RnjdE7xQLN_nr;@)GEiN9@2=F(ocX
zlHP>p`>jo<%HIhAS$z`sEb};5%i*@^E8o>e@hnn<wbU?oFqb*X129@D8=Qo|B6UR5
zweOzy8YL-Y(0)#GmWm>gE+5$EOHE)q!BNX$U{E&T?aOmLYOLSg6q)S5PN|*FjlTFQ
z@b6PBliM_yz;8NKhTy|ox!`dz5*jhLYgZDr;fw;9Y_Z?O)=u=*Fkm-vlSH|4lrTj$
zz)OU0H2!(=_EXeiJTIwEA(HZj&D1x54ZpGdS$ft&RSOZcXkJzp+H(p36wn1F#Mwze
zY%TS{L0ymxtkf<!vM`5hN{9qt>RSH|yRH@*Gk}Ps>+FvXc8^S`5<&UGlAgp)uJI_x
zwK;_~WCyM^;MX0k>SCnPUIP46P;AcKl+YTABDFL%LY5Aa0g3b(^FI>6_}4-AgwSTU
zAec@i%5uKHAe>Vb&^p$y7gi@*ER+VSRT==vSDeGjgCv<CL<r35<s4FK^{JU8`E;{4
zKB@q+(A+xL_cF0|7vu?Pds|C^#fa^bst(5@_4C0eXf(mceSGXb^L~APfD@>50^i&R
z)s#?4poac;`S-bq?=tMnKTfh;ooEV|uX2&`S=P$=P6t2ba!M#|yV5as0AzqWx4gc*
zo~K<%s4{txnj`6|_Omm^`v=2AHey-8rVVW@_Dj<LITJ=Jx1(^L1;z#>QNXJFWit7R
zT3RYlSJml`n60_o$Xn8ZN2$+OzNz@Q7%dMN2Ub`lNq_8B*JK0nWc^^*Gv<nTIp18s
zT<=xY6pqOJ%TyM7SspP`e6$3WW>fc3B2nf^zUA-X-70piP%K6D{`HT2^2awPga2N2
z-^mJXKt5>LqlsAp;g+6TjZt3r=br#>x3y^{K8xnY+b`YV&jbTHgo?U^Zokw5;$KQR
z8m0W-5c(1Y7dl;?z%CIJ6AM0<z}@FkP3;8OucI_8FWq;&`)sZK*p(Po`9}`~&5Z!R
zZyT2zEE(KfIaaN&Rr)LLcAjcdue0rD#KQU)i)Tfe4d*}2d}ujl-$m<ZAif%YysMJ*
zWG*zt<G778=IV{&&4qDzE$&cn`P~@7ifwp$QZZkB%eJ$i#Tmr1&4hFpJ$vg(5oTkr
zc6EyG)!(mYc56+}I^2F1_1fjj1VYr~K#bu3f-*T2qPCa#V;GuvpmRcL=Q2X{Z5Vs=
zRHR=x&GMwOj8KpQHswh~*Qc}_2~$tI<OmUc{Dl*bxYLN&D_RLIVkp=|=*FUl3)d7I
zada~9_Ns$Ls#oz=M_nM86lQ`PVC>-j@DJ)cyIa|MuKgzURgZ*LTQanyw^+D%H1qVQ
z@%v8?MIGOY8O!;mcEn!LeIhg4n}w;h-9wK1F7O0O3h6>kYV7XgzrNBePGIG~;3%Fp
zK72#1s{Gfl&8&^VS{vH2CWo>EkKJ+sGmrN4RqS}~yIR|A(wN;|nRV|Zc&eBx$HJaI
z`eXL9c(I+@STFpLUdWqct=RNu0;Yz23`LLAN^fhX_da5CIHUV9-XHyI=VKnB?k(!N
zrj`YBep;C+uM{J3g%XLhoN5hI`$>CQn5_^^bGQLKv}z)Yl;5@N0>hNvKu}-FYUr%B
zpckefUVb9&IZOQ*!9H>>rGtS-L#ujkLC*YnP}TC-9i!sJ{f6$HiMuLAlgT1#x!x->
z>N>#(1<&pEOb@A3DwsCXJKr+R=oR6|UlydYo8^nSPMUpsaPwv!u8)KJ#+M9Ta>=h$
z^m^srZ@<3t-DLWGj57lc61p%%rdCJx0&kPZBB?(j^suahX|FF+E@98OC(8K=Ae7e+
z-l4~;{qJ>Wi|HKh*U9IhK`rpta>`1r+pfvji@E&nM+a4TydFlJ^r3ELw_nvRaH3(f
zG>Tq;CRe_FeNUaloD(<`@#o8#q??-g>RF<q_)+1Hxl(mU54Q^L0hT}Gu}adX=MF<b
zF#dbBJi-p|gI)!!M8#hoMI1s4%`Ci^o^==x`IzZ5(r80R<)0mE54;eME9uHlVc>!v
z`0@V|wuo`8_3iR_<+1fzuj-4MQkz)d(Lp5j{O*gOO}Ix6%xSc|?!gUXWVt@S4RhV_
z7ujE}^=WFk&PEctI;32>@=k;G6^uf;pw20Kf9*aF{WfCFIe2Cgvi7ynrXd%$RTs}R
zo)d>A(V%M`xC+JfGA<8@)+I1YYUq<m1oD?;eM$D*AONU7C^m`9l7eJwari#)2NXv|
zXL&-yd3oc*N%+K$Ax1Cp3FDLE*yWa#x`%<ZpYrJ#9>A6+TqBBT)cHVh_D+{n5hH<q
zG?949=_KiL|Dz3A*TcZSPrQc7JUotz8=f{ydPa2`zi!nVJUFI%CA)tod4K`eInE7z
z05cVKjt|;Xl^#~v+N*lvaMuLv+qtpY;D#Q}ed1XGV{RVJ<C~A~Y31(D35xzMg>`@!
z_q*10Qf@}$ExfPh%lQv!Q@(;A;Z^`8Dqmtsqhz9T+D9_J8id5KZS0;rwy{diYd*O<
zQ{*oG05t`gUWzn^&evjxZ~3o&Cv_BJI-;4zfB1by)P0e~SlA}FBjzePz0#;;J4C<A
z$Yi3?pYyDmeum~?Nt(x#Sk&&|yU#cIM;yyL7>|zT*H%R>cl?;X%`w07IV=|NsCQoy
z%o249yP329up|1KSwa?A*I<n|19xw^0k1&Qo9FkJBwf*2jx^Z0y?69d9$Z_KU9;+`
zN%Cq196`K#;e}j`xRAy$bzv{SUvTRdt1re2*L?+8NsoUHY@FZ4?6FHZ8*w0aG>(Y&
zBc{xZBjOjWw;xa>@NrLL{Ou)RlQeUUKN=;o?@-2PiRq?4{g%HSS&;c*IkL<7om}$v
zOUJ{DyZggVs=L}$Od~BhT&f4n9)7LW?zLW9WKy+G56inL-gvA;ZC=@_`u1u+2N}y^
zoc+0?V2`@OWF|+laJzi#_qc}jyZEvW<DB9x+u^+`dPYVrfh%89UW?zTXnx_CAY|T{
zJX&L;I_YwiOQpV>5qH!StS%A&>TPM3F`xv-H_I@=<uch^6|!pn$|G_PpB?f-s_hSm
zwQEOg#Bp@d*JNK45@Mw*_HC3Py;UKk<aM~d>sRP0l!>PCUFEM*#n$fZk3>h4HexJi
z-Y1k>FM|}XQTBn$-Us&KxQhbQ#`dp`>7=Kf019rt-n)isO(LaY<Yl`{PMdzPyRkoT
z?(qCWQLNh73#W_)$sbF;XE&FaI>u(xJh`*XwCN55(0$#=e30!fhAs-V91N-tQTYnO
z&Q$@2&p(`^Okx0BgWZb@b3p>=e1OMOd9^v<yVm1hNeR^I<elTD?uRlNeyAw{LVCt`
zphUFK`xq1>VO-zU49fNRn4~<4#(h;diEn_Gow`9s&!_3!)qv5?0-0kz|3v{W5&(eG
zSH3o&%k|2@DnZ`lrDXZzZ6pC)5xAzO2kZ6FQr`GWpqJ^=-)*hsJW?+NXyBAY!&OkN
zGNix1z2eLZ-p;bD69<Dqs^ky;+>O615*|%pHWe~R-2}0q{95F-F!*}2&s5`y>V0L(
zq1ILfSDLmERRu$U$h=;#ctw%k(j>~Ma5p$#4jEMB(W*2O@h*m(4|#G@!n#IzE9Afk
z^5f3te9E=&8|9k3mRtWo6T=Tyb6ol4gcQW+?4AONIfoYDtX~wow(H3@ztXnz9dKG^
z7f`Q!R<hT4+L-{mo0%P|-&fk`y_Ej*QySW3qS0Y->(@^d5txY|YjUV6W&Bkc1Ik1Z
zoA;SsQIE0=T0#y9iQyoC?R{RI=7eRn#*sGfOrIm9LLfKz5chcg+0x<u-wJAS+wgu=
zYd09GyYY2y4wjNd$^&^Flg$Ndh`T69d`-GX26QI1qDUbtu9MA8mBw}NQ7(ZUhK$Iu
z*WMNUZc3cQbpTgEmp*xzr(aJNu~9Z|4tf;?7}@k$$iPqShjdS}8=Svh9C&gdMJT1s
zM=1aXyvVXGe6ZRI@qOp#4HdHUEWCt5IPn>>9Y<6mf<zAFm$SOxSh{sdFAA7&0iGav
ztPY0;q`|G>s;)ye#b3*y?K_;*W44=#0P(tJ9BESCMmK}{E&I%eq>Qc%p{|$iGjCUX
zKO|mFl?x6?ieKF(J@`y~-n+`ErqI&$+DY{~UU3RwnexzqXDvsLj2W_vIKcaJxlS|^
zc%G!~u3nS^Es)D*HPvPt9|?$O=}m!usnj}V4j43J>b^X)sJJWlP@DylebZQ!kX-0u
zn%H}*jlst6tWUp-qX-V;g&&0ww5@R@{!;$>m%!B~9zqG4spNwc(2~qtg{FY5BETl=
zG`N`E?-Scxfad~p){SN4v;Mg2IXFwmvnO7NuXJlXy2WQ)YpZ=vryf5x$nH)?JY1s5
z>K)31G$Q1f!1726{tju%e~e+^DZ-D{iu(Pr+=9!=#3H9M<e$a>pTQy<pa(z-H!to0
zl(-2w_Y=1tZ_BSt0|=*2#olY(mT?5^^F|G5-DA1%@h#c!WHR@W3PYhR3FmCmvu9O7
z3E&q<cMRs7*{OVw4*Z8Zj#jOD5OKMOAUBJpIZAw0NM&We0Z)N2wxS;0dZo5h0V+BU
zs~OeT?S{*7>8AD?nWXA!Qy`;QeB}+`^!;ApX$Ju9)tZlw0#&m_u^pE-s0e^57JBz4
z<M*H(qTXT;z1)*RUNT5k_|_gsdD<D*SVz*|?zFf^^j63}x)P+7oo#o?)2bEq&XZ8*
zJabQmBFzr>wy=QJA8fgEhdck;Ex&x7GcWA*fn?L7okl9N7F%?lsD(2!Qrrr>3#%}1
zdQFcbFyreBZzInwR?k;=7#nSb9?SUtegL8=-`ei5p+#9k*^iz%AYgrmWP^lUD_KC_
z2pS2U7DQ8sbnBEjR1zy61^N}JaS}s8Cpxs9-^A;DZ!{GDC~9Y6wB~W)*3XX&F;`{k
z2~0RBb+Vb(<F$_y54M1tQ3WK=@T8>6H(rpCS7AQGE!nr|_|jnCc7bM6UGLRWI!7nA
znM6)@6W5ztPK%#7&)2KvO@(V{g_t3JQY#AGbiX)q>$-YozJv<GKKN*NE`0qDUC)P4
z)6@fo)yR$qfWT8AQRa37`DvNSi}GCAz>!j2x38{`^cN%)ee$8e7fG8!UeCaYaUD!L
z@{qIbmplRyj?)E*d$z!_F6MQm-6$!vkIruUBOwUt4<5^-B0wEu*e;ycFHDw;7TVbv
zlJkgKVoP3*3nE0PnAYUL8Hm(fSpT5N6lWnG>@JmVZlpNvCQS+@oT4DAXYh1>Dg9y&
zgDBu`Sz3Phai2JdWFk>v$C1hft=N|H-~UFVLC=78*&gVp*+$)2jvzfy1$lnnrc}Kt
zX)YZOf(89J$$-x&6#<6J2Qq$oz2Jz;?MF9_Kpo+1;aP{UZJ(tP0ZMA>2dsAvw72eV
zgFkDg)6~a_+o1C%Fv9aL48dQRZgB6D?kM@+HgeX|2goAWTdm($IY{^(6!e@KxW&lD
z2TG9AZdYz6Ys7S#8*RW_3@+jzlPF@P&3|NjJv4X-Fgz&$`7--oaoJB?AuBbB4;~St
z7ZwEy&H3!nyI@*OE*xJFO<riW9R+P6qq)MhzrCV6Pz^jTFWd(p0Ly9o_t)P1vXH=`
z>Gug0+jrpyQvu7ecXwhzMqBO?t*3;1mpmR_eg~}J-d=4|lREG3uqGnFxESt#?oYay
zFmw<OyE_W{Ngjzsb1%yx255^6CSJND+-MT1TTS87b^WtpVrrWSH8uC}1g=1Icc;>#
zMeg%1o3kj;$Hj4A7{-elCiVC%%hd^BsRH7z8tK6OH<D_7rW|J0&j0ku01zPh@0iZE
z+jCj!0mV@^lRCFgv$nC(CttCtxO}Y0&su(i;{_+^`zh~NX%5;Ar`wy$yQ7Ci-X>o=
z(-vVdg>rhHlv^;6%#N@H&awO$WC@=@T;XD4QveiQK63EQYI8*d)3!H!{wk<<{!viS
za|W9!0YB@0cCtE&IufmTrGu4phCuEYRhc%p48Hbu@@DF|8gZe}6NN>VbMSjc=8|9Q
z1XP`YqL$1YwHzSoRAfu(+|N15K?*?p(UCLaYoZOmj5i7yd)tD9dD9Cs5&wRC=nG#<
zWi;kYw0)Mjd~wQ4ols;!#(gX^N+K$>fJMsy_c4;wcn&%{W+$j%!vMG`1f*1}AiSLZ
zHsDtgJ4*sQDe&-&^wRgB{f3he7pKbyaP*KAKHcI@09*8G=(24{A^J+voP!7lV3f05
zq12SN68T09=C^;KrEA#^u)HjhlQN^1X3N<{quy$wf>mb82EVZ@F4LSXbBjN>&B9qF
z3+S!3SY3xN;|(f{w`v8K<BXJkK0XW*wgbe<1B(Drmfi%}Z=H?>DWL-duF(12ybxt{
z>1XvKFOHs+Sr~DV*fi?Q@+(3wb!HL~^4#EfjqBxo_Zs=jfpP9yH8N3?FUHq+d$;eF
zH~vA$)V>?remP;Dd$>E7SAJQ)(Qj>Hu^gm){FtjktHO4jo;OprkJf*oO#=-(vJQi$
z$aN?H$_q9u{`Epa-F5SdiO(|OtrfY@Zgy1b5Gi1XISJHG`FoUSt^(k6hC|*VW9X$O
zq76Yc|8i6-pt|+-RBw1iY}Q{9ckF!O^yTftGa*7#fBCklN<h3=k$Eq|15toT5o)4m
z3$$J}0CLFV?{72xXa`_Li}7lsp!%WrL}A(R{VERmhb=_ZuA4WBRo(z+!ciEx0Uh9p
zRkgagETjDHdva7brZc`(4!2yUOcmJK$y8`bV5x-`tLLulmkpes%j4F3bXz%*h0iiP
zHW8vf+MX+HrD*z-=EzE3BG%w6C}th@j`AcljTSs?h$+oI3<6l&E-tr?{8rBMZqnQ}
zDThI>cMzLt6GodoP%|FRDwGY_{IeMRZd3W$G<MFMz{x4ST+SwKgcH%W5?b-Bxx_x4
zps*(G_Zi|K#DwlrvIT_OXuIL5dP}Lhl4Ftqo4GLA(o*h2!5(F!0a;MwHm9IGFfBr*
zd>-IIUG10<q_~iaiE(@bk$@l|{*c?HwQ);yZHm(35hQzeOWWOVma@cCHSvCmDAcJi
zsG^#^)^P#JdW77vViXCtti6PT$e_MN{6U75fp#K_LdW)dv>Cn={wkE}$X+ciM?ig)
z%Lbjx8lm_>?jF?)lIO}q_gBIDKACgQ<9#3Gs_1ZG;S956voLzHh15UfDdNImevz$_
ztdPo=y*ckUm0bt1lM|qObylEuIfJwjNknUqI}j;Z2o^pSs#6p`-9t!PTfdQNC0uH`
z;U4l6fRwaOsxCGcw%+GdccO#Xw`fyDqGM^8C3sUjLD4dee;0&T(^$?z#AWh@LCril
zeGbYfXai&c)G1Ac-J|BOgw%ud!22rlYM~m)!L(ZP#DE~g|6HvH{Rf1av#>kaK&0B+
z=m&612TxE&ZlE`{Ki8t2cG<IkkRK5X-ApLGMjZ}Gfkv12bKs)YqPTn6*xKj@Bztgr
z?8+VIS={Y-VvX7$G|1O{h4&}KDlhb&kJKtj3DqW;Aoj^T59L7~(Y5z}rIG1m2$U5=
ztFbrgxJ{dyz_xENC@@kwgh7y_b&)6o`zVUbvCa|cdlcI4pz8<_lnHEVq%}4cx6a_q
ztf^U?!a2Ag(!$6{5DdhW14SNRZMSYwIro;BPPB;IF^W?Q)MQEvt%P@?Idv6_#T9oH
za^X8uzAQ+lTK?pK=*Jdf?om=V0e!i3K_|C>7Q@B9LO0L~ELuvS7xF~W9kRSK9Hh)e
zzmT6P#Ni8Q>qQ*<@$a5DbPkU*?{t#zPq5q%z8@+Bu<^Ho5A|GAHY6zKwy#=^{!gSd
zh*Fdr2b9$42>S=3M%(s}_Ivf7)G1^Dsd;fjmft1G5=V;`T~_2Om?z&3x3XX?zd9aA
zu^G0cD1$iHa-Y34dGKEFZO~7q^_IT~*4~1stTL{<{!J-#>TdrKXevC%mu;o*gnUlx
zkOe?ky7$sZnO9ql&4=<sclN#wYQEm&w=rIr%Nz-%9?|v;gY+rW6nA$JCVoh;bFT?N
zK_dFVN}k#L`kroX+ofeVV6+}9C=8+$RtZ?YS#dLobeV!Jl8n~5k)5y}@)#Qn@`-#x
zd7~Rm6kZH=qt<uT+|(-Rso9%ySv`~t5>B<uUMIOMb+=SO`kKz}`vm5ah_i!4h*&D*
zg!|P(BSL^a3xiaJL)u3{-=d*5w1|lVOE<vLsMUT{4btvUpli7J{o7Se<P3xk@dLtm
zu|_hw8^F;DSv;?;9%v)Fa9DQ<$7>lbYYq~4oxpAg`)v@U)vS=8&(GxVppetlDNjNE
zSK8zW$-8_;9fa-@sv-rvb<1TAcL;8KBka$h+JX%pxh5>Rb0)8*#iccrIOGye-BoP$
zc*8E2>9oC3l$*FQWo4|cWN#4enWzBT0*09oC|N@JGc$*1dqy#N>YUWzJX?Kr2Gv`V
z=`+735m(BY6qngzqd1sNUc679rY?(u@IwTmYpw1WbfpWVX|@081ASOJ4oMI`6m0|q
z*+CijI@u+9KF6Sn&LLy;aa5BH?=kCOwfsfgbI|`|kr0Nu%rE4aA{4Dip+upvY=|hA
zdHSIl_FRb$5-nHcsmR6QNM4teYjps>OICKtFq*<T$q4X4!`}1E)*GOzVW5BQ$J`Ti
zh8|hC1S@h|%-znSif;O;LKsPGFxcxu!Cqn3V#)0N<3MOn;&iuq#m85f*+d?HnE~{;
zwj(x2F(n|VlWyG+{o^*m976!kWZa>gq>#4ud)q?9#ggk9!XyMlS4kiI{1$Oh4x@mH
z-pbv4DHWo7ebWLG+adiY`8Gc(qyTZ{)*y?+F};H0jl^3Dp!<R(0AzH<U(yOJxGYtO
z97H;gUBA`~yn?9`<+Kv2!!NQPoj`R1j?nczloE0wV7!GiUC^vN_JL&!NLn|+3#aNy
z6^ePN)<mLmH+CHBg%0~(hSnpxM)>>Lz>{>uD28aeqhOuGTxZ~jvvrPSmF$0tE07dm
zjTMU)rQ1rLi9{2ZZ8&8l)`m{z>qx4#MHiT+y^ylaO04&?11+<%ELqD=EK7KAYRIww
z5<Nwv0_f)^P3zFo$eLv#W|5AC_G<k~J)JODDD;~4Q+d!$Y>*q0>1nqa-*DF)G*v8k
zW9Kgc?9mVab5*$!rq0_-*D58$`#7l_OYnR2)f{01k5#$=inIM(s{Q|YFU9#=?_P-m
z0)U715=B0QqW4~VSml3i2JM=q?fLE(nFV0P%6)z+^MqEWYle|>DWTB>CPV+eNsaYc
z|Cb6=gl6+^6V1V2BS-Kj<*iwEEs%D5cls14Ms`E_XuBf@ptK6Mm#*=Ez~o-EoJ@KP
zkq^*iDhT+5vOP}vxsecvmO2gvHw>RXAMKVhBdmZzg9s-(9si6S5e30eki<V)OYdg}
z3er?XamXHa%rJGPy~(uTA0BLXHplhbQgjt4*P&XcNRwm2HbiMz<?w&9{3e2x`)>6;
zkbSKJFsEz?9z$Zz?gj{s-SsXZ{WRrlr~l2-y%`}k1xA@18bi?m8X1y*Uj<n^L(eCu
zZktplZ}WxAm*=z2kDa4@2?vAG_~F$^COCvGTZ#M+_g-wSPEML4GMgvo2Of6;=8y}N
z&5HAGoW8k2M^_5ie(8-$kO|P4IljuP6RrJ~e)|hUF>GjSy<e(=zB60A0uXqHZgMm|
z{v?D3YB8q~Lb>aAkWD?12Y3;XJ`?6%NT`&7l+^O=*eiK%<-TvY&TF>-3)c;00rT>U
zZ%w;lSOnnCI^YxnDm5#-H$e-)N6<t-YN7m3i+y1T&-AwsV21Q6yrh?9XPgTz5lAy*
z$~`#AF;D1S#TuchudXfJ43{WBR~Tv%s`k9Bn19;dGZfZ;e*6WNNDqN1a1}r-fksAN
z1EF}q>cadP&@|eaBl!%}m~{xWn1_1`5o@(zxD6CcUzefOqNSNp$o%#nlDKUNf?65Q
z6Pli{8HC9tw;oe|d*iFQ0(}$sS1{`(Y6@6Xs-T&)|DUO_IN55ZlXmg@MBAdP<1f&l
zeZi)eGQiRx=+zu?^zvH*<LUCl#)kgS%`nh9P_e!X7^ijohl`8OfT$%&WR}2J_g6~k
z6Z9%NvlUnc7ij$P03GzvLiO_(;vX4%{qPoZ2JedtkeRWEfpSDC;(m&cqGy5vAkeq~
z|20^L)BGZBd4n*5ut?bE!cZ51;E5szOeb${c<>}hM7TKU|40E1&EuR41vnxMyc(gJ
zelzP<@ZN*yZ)^l2b77+CO}U@ysVFHl@-aCQsesvY`2JdaAOfBbh(JPR6qM|lCorl1
z=>?!=N(t=)Ccn!fMa~7<wz_j9H3`&?cXO8fGFa_kEf!7S45x^2w_XBfWktmBed5&{
zfYL|--3yJwxNuU+&wYTmEC`9}{1HvZ$punUjU-l}*=-X|fHSYC|B>J{DYb1Wh9B);
zSW|Rz1AVz=236Syz(iaRFT2|G<;k=1ldF*ZEy_!b|KLOj*-Dn6a3gx>D9HGQW7@0h
zvu$Iy8~wCDWe7d%jeMLE`iwB)Y}g0RFkuS4ay?a$aBzV}h|P140l)nbFr-*O8?6H^
zQw6Ci7IggT<SP&-?aY+I0(aM+kdl#o0%c-uFlmj1Ly!TZ0UKuvNXL4g#OONE-BVin
zq=c#_f~WWBU_*0vf3=0%ywOjihvrh?xMs;!%QIk`+8J8oUJ^>)M>{jL?S1cZ7&<}Y
z{&-6+r^<QP^X<*5|M27}@G?JOc35LB3S>8i9FBw5A=3s8QC#m$Kxovg6LZukMpA)#
z>wULi#SYg$Q*G;u!#8$8<N7eO@vR+;Mn85?BS}9)e!jE?wEUT|sY9d?UQeCB*7G|T
zX*`q`4cN5Tr#PDeMbegNJmd$l`#u5jKQ(XS2Z%>s&i>AaVxKCmO@Oor?=%^bYfLr=
zn+hj^4$*tkg1vtohRf3kl=oJo1mRsHK&)2CUd{_zkHJqg8b6Z1BiNH8X=qK8@)ErL
zb1&dIagg$Jy26WxVP_`l6?65$OB`#afHwxc9f)E~PVxKNq}(4Xc%zw0(8j-#gLr*o
zJj@g%x8b{#Yt#lW@3c}Z>poHY)esm>czN*hU7|>pj-`l8fq+Q64`2{7NaPtC@&DBO
zpVBK};nDO>w@Clki6f$@`AH(>+iSrqPh|)UT}?PI@I#TYKA0>~r6%{=&+SwAzaA`)
zL4nRD(Ze7N5O+dLF}c!=G==yrQuf~0-b=+2R*#=mcQ7FtI<6tF>9Da^YN5_f{{pP4
zT4f~5rRmwaJ~`bKaf&yf0)ak0I@FJ4|Mc4iPoZ{sFY1JYl&-#@-2=i%sh4ICTeRHa
zrf%Ba?yn3BezMF-(5j}-Ef%yJ#)c4MEGvh&Ky0?BZ&tcbX@b60@VXSI+NgC<?wv2s
z9dvW@US0<cDzT>E{cL>)e6+=HPWP>2#d=QSB}l7rw%=OBr04T~$|>KQkM8*GDsvKB
z5PBfEofDNvtRV9ss5Snb2n1m9QVUe^GeugtmJ3r(A*U##a2PBU{)bJ#<7>UM8gD@o
zsGybS6`;tkc|4TyHQ>7s(GsTM&@*gwpNXQshGK^!c>($LBeo8x;Mkr*Hd_Qkp@Cn%
zb&FxAJA1FN<n4RW-@%PPA1BGBf_A_gnJ|PjH-|l>G`h8o?KxXH6?l83otTb{ICAOv
zCYnMk8oik#WFeO(5mA#|9wWtJ#>hbx4q@(Tzd}BsxJ({49|89&V67fOa?Jww&W5;m
zUSC`KoBRnVaEl=7dMBf(`uSW3P-{wlz9CdAp=J}Lls%IS-f>Q@Cu1jV`=NQ)GQ2fR
z9`wLQ_g_FJfxed#4kO{Ba~%9p(ahKE0O?SFVXQUB1pidIob%`^2@=Y<+S+IRF7`<T
zB!c#4BVY<t+4n=;!cg$?e1mTY=1bFf@KV=0h+_YTu&<8FYW=nrd{IKBK}xzy3F&T-
z?k*7trKF@01i^rpMx+D@k?s-%6p)r~5l{gEX(asC=A7TX_Z#DW;~V4rbI#HI?x)tX
z)?9PWT|jaRTQrAuLG!4SVu*?UTGay6=J{AD`2)H?0%Fi@CCZF6b1<lOHcnu`33*bf
zb(CTK{3?DZ-omAyG1ku>vC-h>gmGOV=KB!AM&CZM_iJh-IdZsc$0MwUo0ksbGqG^M
zpGxGygW=ivl6}S4^v>epc`gW%%-CZ_#OW1b3%R#^0-eUOU8Ggkr2wE8=73D(N?nNZ
z1cJH2xebkqMhdK0`pAk@L8n5!j|hu>H$0M}opx4sVXmr^Vo#5L>v1Oq3O_8}V35#E
z>o-A%D8biIqqb(g9KmcY90uJ;6MDYz4ElP#TvgHpi>vNtIoGoXI$ubg=IiJ~k$K`t
z-$8Lo^D`<n$T|cH=1rOCQhJ?8kI|T@NH(fJ!9l4T1cu7r!-OB@Uv{F7<der2x;J^7
zxM@D@$IE~}xyw}TEXxtRX5${v2n2%eCU#~mL7?RV78SQM=J>_u5^X*j(6{>Ug}sU@
zHN=s<5K9z9**q<`LnlizR2sx-{UMCwS^un-)_EI8=n8N+KHd?Hj6^6_38hMo*Y<{F
zTBKuSN;8Ajbla%9Am=G~Ad`d1fcy9^O}5u~8&+F-Aw)m+LF}(%nKI{PZV((iQ6^-t
zj=b~L{%$lc<@kHD$yx%ZA5;sRj>GvJy+pQ*92b6vMN%Dy(Y4PCM5-KM3_cBTj8wIL
z@%YYx`+2wUY???EY_W<FIu^nka<pt0Fv}uI802e9KkoVUeW1J;I8U7o1!3VM8^Wx%
zs&U%v!zVUO!uQV|{h_<nO01w)8Uzhis7VM3TQ+zbQ6DxaO~z51)Y2@dKz!Kf<j6*s
zNwGyXdZ`j#EUUcUvBNlPcz}@!33jverA%d<YpOmmj2yRJ2zZnq$y*c1KcJI_dTh7@
zA?SUeBDkvT$)%GMxk4K&n6oFtB{QGdiG`vn6qOD8`Uk?>TWh+T1Nf6k?7E8jp7J4A
zo<?KSetdjY<^irg^Zwez>t^RLL7sM+V&DB4?*wJp9b6a18#jlp6Y9%V;%ZBiFv$qu
zi#MPCaY}f6b*R$uS!5)AVK|8@37bgZaV-&gyd?8b$Yc4I{xIY1s*j}~Tc=y8j(S?K
z2IU)DM~>y+*Iv-4`F(+Uume($w*k&)=RGp=oPv^k*y)K#;8=DHsfFy&|2++K!9c|(
zT1g5D#d{TOP<RT_t{PAA8D(xeZTpM#-Wj?4U2&m5FsWA5n93?j%jY<{hCZ+oNCo=u
zmiHxWvv(z;(vW^6*9{9z%xf&c4+Q1KwG3V@Ukw?!;;T5}w{|GYq|yIa!aH)5{#V@D
z;+!%BD-)zk+?mUZx`ac$5&FQ#@Ul|;?e6$4ubp#&L5%9=Q?&Qyc=>oY`H!-74n&3)
z%I1U@-#4tpjcQQgZ_6d(>8t``aXM)k-9z>+IkD#0)4SQ=uBO|aaQ$U!PqpBe&&*9z
z2ihrA$DnvH%e}HP0zK4xd5UI|th+d8y-nz<>syy;?u}Un?Iz(_(30D$A+jY>dv~QY
z`k8C?4h&e=mZOB*v^h53{|zjCcRu}G=93D9{^@IT$*`TGnu1Qk;@cv3ki-r9ihUWk
zJA0(d#}Cxcjo=WfwDJa~`k^+ZWkmwh_m{3IRfGLU=@krlrS+MHJY4#e!O}5`qj2qz
zaYDDpA5@jM<+04xJRt>WE^Ll={OI#h8au0-m(Sewl!?KfEh=1AZ~VwKPlKjPi1H}5
zEh<gI|3K@P3XfrN+N8_#2gf+XEcre7k&J0oDL^EsqGnSJKj|6of7aALUh?dNp|ICQ
z+t;=FcVqbvqMPOj;x^}IE!U<#df}4%mc7AFvL{={MScF!X_*UP#Jz=uWn@3)+&D=t
zpC^x$UTam$kZgL2P=0U#ma}?Vm^gm%nZ%m%*H50C<o8<m^b7UwH1>*1vPSX0V6=;1
znis}6wrQJEds8dY$5qLx9djO^hy?dv^D1G*bKrisgJaK=+Uv^H1?48zQLOd=2Lnuk
zK|a${+-?Fww$U&fUF9e8gB;jQIlXe%L#WDW=_KhEv<C37GF@rHC^_~3RwS5_U9u&i
zl<Bb1qj@a+D2BtlzLLXhBww4cikcuaU-BtON511z8{N&HkZ~H4M#O%+nkxK=Hh(c%
z_4Bx4{vn=B#5<DY^SJh3g{dQXB1>bw-*t3&MqoHjj;|f@?XFhcRjlGGw30<(G((E9
zA8{})&_5;5p%L@a8%b=%P+FohC$b^?nN=AH7m7kpq#@|K0TZFR!lTIUmAZ=B+n6i4
zrssqAZ*}1MR2n9h8M63LiH19T@_8{U#S+BSg!ai&h2Lavwa}Sqsrw>X1WJa@I%pQk
z_>t`kyyx8(al_tu@vtx`M?T2%QTBnmZ(o=X>v1PB2fkdV^p14pJBub0ef-B-ZP)m6
zsAX?Ee5#WcW)KZ`{FwCwmRgxwp6J##`NG=a_IDyc7D<1~4PQB#7fyksjN#FylGq!C
zmyF9#?~cRuso#G2X5g_8Gadci^O%_NnH_{;J$K#K|MEoffA{(ANVLfo0!_&L9gN0j
z*>xJ{@TnU++Lpb}z?7I^=+>0UjF|ct+>E2&3e%I2kDwEU(M1x_<Dzb0%1zQ{+aQEj
zrQ~^L4xg_gkG92P6<-X?9E<h+9KOV!eP9ejBjiu3!;u?SITDk%TNy6UkH;SoDC4DZ
zNF)dy-}XXC!y;`ykpo|A69(E-mP-t#&wpxcVHM{jEI3+k*wBk&7$PW(pbA0|=N1BE
zIi{h&=a8d=s=hkkL)~qZ?NY43uMJj>G_8e83zxs685R<Oy~96q$KoYkN6Oehxh)ZP
z#<{@X-;%EDu-{!LY?)G9T(SN84+%oK<pw77Rt+5PDF^Y#SqEL+vu!2t4Bc#z<dJW3
z?X$c4SeXJvn0=2xoPb*S6ZFfCE8eJHeoD%jNTdNWW$i&eagWUnlSM8zHf4obhN!e~
z=DvCIzV3FBOl8|Jd}Vg|oHa;jIm#bLk`HkbcHya|Ih<zGUQLhPBy@U~)Ee1s&3O*R
z@CQdTO{U0(mZI-mIK2cRCdnnb@ef4yl(v!5aK&Uza6Wpt@|Qk}Uo-Z$6w^Et#_<Qa
zVyRj2!D+_e;eng?Ci5Q^BJDKz=Q*Kt4hv}4R2!2=WEK19<cV2s<?jVdP-RQ{@Vrjt
zu}Ej2!MDL%IDhn^Y#*;flHggW7Kc%3=A`Z807o_^%+_#*s|5Oy&UHj0kEF&wJ>I|~
zKu3DDg2w!fJY72-g8|!YNc<=3w#VU=B43Ub!tj5_-Ng%{A0^NZV|(PIP|xVE*v+Iv
z6&o12O5a>5VSkl2_7iAR*sUXe(Bp<dV?oF$=hB!16k5BAPp@X}HD&$4KHxH~?n$I{
z81?Jb-Od)?CQ;dw!_**>Huh}Pro3(y9LMeJtBe^b&EOfDkm=(BG@6)T4^*iT_EA_&
zfR!R1dtWInp3Qk}RzJBFy1hX9mslTg*?mE^q*D+*J{3-)qGzD^#5a-}+f;tEbPhL2
zDeMX%H}*}EeQEjbS%I=g*akijKSKmVI@|V9S3h<fjB`G=q1(hOcu61u<+E-<?A~|i
zT|1mI2omdamc74pnys@4+H*Y=;fG5FY04R4{mK#YdY85NDhCS%i;c=;%`aj^oW^8F
zet#E0`MOE?ktN)Y3y+m)*ST{ZWfL)R+W-<m$iG0!G*61@gH5N8vGl;9m^iql!&FjS
z;9vX)ph9x@HG5f68u;U#19!)YUlkT9Gh(;^zhe7>{+<fv6#``tLyF=tyDhX|G3!<P
zzz{6-I8u_qF7)gkW}2tQ$mymR#Q%PGkbxyQlCn_LCW!JGwAuiNqS6B~v%K^<2QoH~
zXgMl}bwcSsSR9(*bT!!Y98sTu$CmOrcE|C#_U)TArv4<CegZH)=>deN|9$~N0_i|0
z9m=xS#N}%ki)G(jZ~3<(Vgy(rVI`~HRKdcPYklR}B8umh*2+FTRm7YH-@)a}g==vr
z2D;z~y1pwiyR2}TYGsq-t2i6H`OjZHXD{#dV?aiqIS2mgMKk1<cTE;}h7w0Sa=yq<
z(BcS7pZm#(xL4%vz^mV#ZLC}DNzsLDe%V3^utPWqWK6Em8SBcBdjF7RkeV@=Xa`Df
zLsC))rg;aL{dAV@Q{@&6%yFL+AU!ApXhBn(niQsVZiL4actXOf@V3Z_f;lv3^n6ZU
zyli3rJ*6!C8>E=j_8pumEw(7v%*7<jKz9AN2D?TX2EW(<u;Bx`M$HwHDh~X<m&hEZ
zF$cFr@S4}>^fhNI+?t1)dIgK~iu0S;;5@ird{fzu7%?tl(_O~DsK4A9+ZOWHSH%bA
z!-TPMrl$un&=ot2`UeHKdy-*UxQ0bRJ><CI1Hc-$fRo0^f9Jc{m?R|Wb<C%yM=nn&
z_}|cRNBsNxlo-^~GgVH8>;^^2PBccP`XK6#Prf%(Uxj7g&+Zooz@E_0au<NNTYxt<
zqPRfLYZ3F}C8{)}2}o-0yDR!ael{Kmo>s~e0%al|$^=+jMR=`UDZIwz@}tG(oYCaG
zUggZZtRb5)q~BNQF=&aUEu^9h0cjfi#Q4&s77A1qh}erDSX+KcZGYw$C&@4Xb+<}9
zTde<fuaG3=;6dATy{8(;-<bh85;(mreBK<v-bdUAC^!iK{)!N#wFAP4L2|L-_gb3{
z+$v3*!>uI?nuu2bfy4x-;LIB(ff%t9Fwb6b^%wozU?x%SG{$py@a=`ftdLkG4`6<)
z#S-@Gte603paBZ%1PaB;Vu<f!8mYiWU@#a%>&iY|#f{}`;cYQ*4SHM_{vu=k?W4h0
zAoqWxk;Rl`87Q%odP2gE-uX2(hKx?w*-8oLZqDLa-y;}h##n0Ke{J{HWRqVF%y;Do
z&^s1EL&oR1q8CjxU)l6uhc8Sn6SOIXkqV%s>grO*9B;HJzpYYWT2uT|qU?+;Xq0qr
zPa52FED#mCIW|wvF?egNGy=%kUq6tlu1xm;HgY4sa?2+asNOgv{PyC(-{!#Q_V(qA
zkAbY02raaiF79b(24@G6=kWEtXaw*#y}-9c=giX5oIn|xs|ZAedH%fT*B7y`5MdB-
zVl0N<s5>n>40t08zbO_1^ZyypKxS}83Eb~czEXK_%0Pi8wnK&yLzBR2v4@ys;v$Z)
z4Bf+>A6oz&As`*`J0FL;C?N81daqB%f~gJxh{%zZqC#zcaD|o?TGZ1~=wX?~7syfY
zEb6PB#`+${eSg{{3um0uXo4LlOk*BWYQ#N<nGNo3E6V5p=;DG=YdDC#2BI8=Ex>q{
z6&qoILO+s4_<67*W;zmNaH7^8p{SW$cYbJlcCvEXh+uQ2eeTPU;sxNH%(?U5P*baP
z4l9vEzc2^aY=D}z6jXbj0)2oO)3~&As?bp*(<`Ce5`iimbN&#9Q||DEh4#5)Ult@S
z?7+T=ffOX!BQ%W^8Q4LLG;AvbupR<r3jWw}R^XqXtiXDCjwr1T;=W#b0Be7X{IfJ`
zk*pOo7t3A0${N?X=jy*%tMY}`te!!M1-Gy`^vTZl-!+W26xmp2lG;pY!}@iCjD|r*
zM&`NDLIM-P71+zO*O=zzFbVENrgIyWwnV&6^<cYp>d@!8R0MJ7SneGAJ^=-wPJ1uT
zU${m(O(3HNBD)ZKnXz4%;9I<$GE!VJRzOAx4X`I56WGT_ngIy`ijItD1(b4&1g0=Q
zA6(HxK!V&CEw@^Qy@$|B^-S2Fp{9|NkVmGP6$9p;R>}e-U`2sXzCb#{O8@|*-o=M!
zZ8Z>yF<u8Qrtj%--6cwaP6%P+^$2sir~+Y5hgN)#m-w%c9wujXu=#cC;I}PE?XQZ|
zsRSP}PNO=Pk;$-9vV#8DN^%l(iWAM!m|Bv;H88&|eFZr0+hsVFOo&DgRK!t$_<usC
zA|FDP8jv8dmNNcLjMfSN)0WXEc?0dr+#P%xQ6~O7J+8&{B`hIY2*n&4IJ87RhH|43
zm#0^riXJb{^?h>~&X3hAGWxG;QCS)%8W<sXdx~Gu7)v3-Pzbwb&PS3{;?%0a)-?}x
z*2L5xu;NH3E@h~#1eR&2@@?p`iI1`SotZU86G@YPh2BOtkj=SOTXr2R8@$v30%QZr
z4bLXxY9{EK!LZ&*Bf|nufG+6N2;83@KO5HCL<OFX3Rs@p>BITQOAYn_r$G@x8f~5b
zp*w85^eo_Fa+O%VPgIU&NU_&RdtwPgJH!&ZSjB;1@L+4Y8$z+knUGE=cgrkq?aA3)
zuWAKh2nkZg?*p3@aB78q0p*+2x4i=7&+CwJctl*ALI=m8I1G!qE>j8+tR-dFDa`}-
z)$rxm95|Egi-L3zf(0GM1jOph?CTZ}2h&)!fGt;*K^<OrmuVi^v)(_-xN(G4GQnA9
zsLWOgNWD4#BzJ?^3cB`N^3Ny}Tw(XZKhsR5L4O00PR!a=O@D8C(L^IC#yNVML8do~
zYBBbE3OCm$t#U@_6hU(v3w1GI8Tua!(Y^}FD7tQf8%Izbs+^5Yx#c|KNy382?tsSp
zFjHvNv(@9)yPD<M)EoZ_m7u!|HWqf!G($t<Vax4N3m6KFP^nTU1EUogmup5#3cvm0
zXWsYm8G(PgPWrgU&*K)%S2$1b;q|5K?lHmWG>2|mG7(^eAVvrJZQaQ?7>(;>&iVDa
zHcvpEHUlDOr12Sy62L?Vw}^WMoO*dS9s*&2e^edhQP55PpL4Bcya_#%q<D5+(Ft_Y
z6tS@TV&r^}@c(=#Xe$6iOWYk?vG&C(tnh(sfQD+W6E-Nfu%E_69HcAaDscg^(kK*S
z>IG#|48R=d1S*u4x-$q6%kNFy6nbc_`_I}vYXS6)30eg1e@_Esp)JVpqVqYT%Q)-p
zMZyu`p~K)M3XaT&z7ulr69zP6=t9h32Lm|I2&x3b!=G&L)u6qOuLfCD31W>JGJriU
z^}5jD9fwcI!Ol<J6ftj}3~ioiKFEd)vGg%9G0pDwvM_=69fBGT)4Uz#M&tH#j{R%=
zcW(I}ACxiOO4dpU4g!&0qyOR1=hrVQju4G=$oY%6ArV?mqq7HdAUG`yE%x!>rSsHZ
z8r-};oj*hcnH~o`(y*(H21i)gYP{4Mkpvt<$JLoTTj>Q4AfmeV-2-W?*YEUPt>U%W
z`7zihbmw2wLn;i(*W%v%x4|Sqfu`bi*Fqgk<`SGF<NIAA)<Fc)!)wsosLry5p3U0E
z>1J1_t?amB6p6|ci+@XJKh(if_ZJzXqQJ~`l-eP;^#2M?>1bvIsCJ(aaj+yV4dU<0
zPdVB-+WGm~{SRc1KLhPSzzaKsOCz|St$+F){6rGmYpOu(75_r-SBC5|H6Ah6U-+1l
zFI5zKr}O3t^*Ix6%DOE}s_mT>fMBW?f3z<H%<>#aFIK2EATFswT+(-UR)V6c<)w<e
z|DXMh{-!$`<#@in|Kra3PohVMK`_tXeR7lu2s;q&jSI{hs*hfkUHlBuwqk9_V<DZv
zbz@dSKY%a;B$r?I@=k)j*|TXjf=H$HrC?e}XiYr4Z~2MC-?_<tB36wxb|Li<O$aXt
z<$lEn^Pl;V9*6nanwe=Ok7%~Nw;cPg0%Hml2%af*fhYBUGDS1@=JtX<eVhXtf(TQ!
z>tkrVdxt&|Rv!*0@u2nJ3|Rw_ujKKj+|<RtWLq1;V!e(ZYvK${-TIQiqelSKU-9Q^
z^TEp75+=w6hqB}@28bxSTtZ9+v_31?Hz}NRA=69~rbn9if293iNd;Mei4Rfn^-wL@
z5ownRkm$;ihV6y^h8`!<|3$PGx1o0!0O6PA&hz?_B4b@wD@SNBG=`_20C_Ve_&)X~
zMefU7?6FwDla-+>Rp;4y^>eN%FMHpE27w1XrYJgR0m3&peAv|3l<L!nPDFKWKB;K-
z@=r9Rz3~}Ary}Ex*$UBjh#e;z34Hk<=@;lIfCiow(w3WT4}>ow=d_d%)~8me4f5%c
z(Z@gpqVOi#nMMd)$IYk*EmLRF4z`naY#Br`xcA*c6_NpoN}O?itfv;Kbreab!&+vD
zchL@VA63btHGVmb2LHpYp=<>_b^spfPx8JXw{9l<&dU2D($`Y2kyiD;-NnrdtQbkK
ziR+#|zr3qDUo#h|YvT<0+)6)0b#{7a1{3NBo<JjL<n5}({wfdz+*gL#C+a-%Y&@Wx
z=y(H)kClFyXy2KOnwPZdA2=j@!T;x$wqk-c3vV(}3{r%iyE-Bw20E(X5Vwk@CpZz^
zvd5G4He(EqOlJ8A8Znw%u13aB737KWW&P-*^)%FrNV$xzXD<gHiCj4Vi;4!|CJnnt
zx>}vZ@Az{W+RxFrfv*PBwZZ)_9wO)GP%J#Nm)A{!ECZ44=5?+RnB{IL>`^X-a1+=@
zpVHaASf<3tk#@BCwfVJe2)q&yD*XDMS1W58d7eGS&q>@;$o_(ju{SL_{8azL1)x|u
zOc*}mcZ3R<&wJg>)A`CXlo^sTafnoJ<Ap#y)CCmX;fn?Lgu|}-<s)n>@}M5^A5cl%
zhFRtd`11g9+8Hjfv<z@PsCdr}A%xF;QMvWTg)`8901u**e+|(?e?{nEt0QnepD$do
z|AxC){n(lAr0rK{6|FVnS%_Tk^7jg%LPJBHv!M|AR4uq^xcdnt-)7B6>tcvap36B`
z5@e3BAHf`*z8BotdMfHVAN=6gr2Z>yxc>~1)mDA}t5J0x;PUDxA<(&HyD<PQA<z}<
ztkkZF+h9W3SouyJ;JuN_%%T8D))?=vWpQd*10^bD<>36;nLkK{=Qp#gANZX5E7Jce
zhu%`54&VQn8eEL{AX-WPT7<epQ}mSgblPx{bokm&l9$tjBOt5*2ijMrO*d`<T|?>5
zm6AB%Y<7XvXbF@lyMK(R|GixO6)9FNHh1}PKM*K20S~9uDD%g=VhG(o9Yu;(q2{xX
zXKTC0>fh=Dkcy}E)d$PKKGAhDYV>iddMw;IWts?@Da2$9G21bfE4BRR%(d`4!WFVo
zbW8H}Q(xPI1q!U+&jTiqVwHvI;X6F273z&HtcsR_{&Y9|TExwT5JMnXt$w)P)dNmO
zsSHbmPEiXq={Iv~Y}y1rp1~x+HQ0z_(}`qTGdPCStAN!&qaexAE+K}d)N8HlZ$Yud
z2heQ+Q0yP_0C8IRR~({3;{uOL)p)kAuP5BD{;Rg3biIO5D_!V8N|@c;lEiH~8eEb2
z`72=y<u^5Tgc(hl#A(=P+ad`(yO7eqK#Y(WWfeP1NS~c!*giNR<u(!6J$egM8fMFf
zneMOHwB0A>IOhrCSS*DKB9>chkX|K0j@kt{fx6=JFTZcXW#mG9=Wi=^5kOv0O1#GP
zo9AXy%X<0ug3Jhqf0vAP5{TNA0f?JUfAHUYq<JsPe_W0QFo9>G+s~GxAs7Gkl6q<#
zj?V%`cv3I4YZIVP{`mqY)RRL{ZzE}79frHtf4FJa1uy}yi34M!!i8(Vf{q6t6@vH<
z?BnC@exQVa5PdWAR`PWjEw@2^r0mI*qJAfRmdAPHWMY%1YeN#L-_N#g@0pbUd$Qr^
zsqFA2`x1x8+lIgX-WO-s8Mj1YDd4%^Bm@5FNo;EMx&TqXUbtnP;fJS~dL%!IKQz0e
zi5!3q;x%cQ^OTM#3G6xYrpnKJaPOkh#eK8WweyQ3>`D4H7Ms4V@OMi-{FqO%!RQV9
zuuks9y*B3S4}NI1Uc?uVZwHpNL<qD7IAcc}yj>C`7oT<js|``k0kG%xhN9%mo|h^F
zIClB*PU5d!4WLMy4p4L$<X7zV;jKe>Wi$_+sW?IaiYgF_RleNX_CgU87Js%4*eHc;
zCXfxtHVrpZl3ii^w7d!zo?IfA@drnv#wJKM(ilqJmsEFc@*!V9lyiBLTQ;kNu8S18
z+A=$r{K&vv6|#lV27U3Hw$KX7x~&9axHtrL=1}k<{u$jCsWL;2a%H*H%te3M3phAv
z_<uDlcPuZjf;MgI^k}1kGEpQkqk;}2gP?`K5ID<QU}jj5B;&7mh-zTJ;I>E+{v=z}
z7HH^pNJToV2ssM^1CTm8Z<B?9#JL;dRxT`>POYmo5d%gNw*TLgeWY5c5-NimqV<oJ
zAXidMIRG8Ok$3y^!FN#=O0Lc@lo<oTEPr?Im5E4{ESQmeoB|SB<b(NR4*!&EH*CU8
z1IljT+(n6cuX7<;fb)2%3~(Im&bPtTC?Qir57`udrO&(9s1FYnMJCh7V!=NRbf-b!
zOLr8ID&$h!EKLqBS4)B8F(}!ya*+90JMcX?>#YzOv@J9N*K(c>qBS*h$Eq1U!6bio
zLg4sglq^!YN_-^>0X9uHoLoe($5Um`NaPwX4G9H`umUj@VkvsO#3lkZ{G-h99-d>f
zWBmAsPq%gtsQdllEqZF+SiBm9JXlZQJeCy1-ftsi<03E~L}?5it$3h3bpwQAd^x)2
z0yw|rL&ml6>?=OzUVlDR^G9u1&m9;bZn2o$a?!K{SwlI90TMoTwgok*zdVUx+62QB
zcGK#jvr5IXxd$di0VX9B(t;?VFe#k7{cMdb>i`Q&nSUL>0KCyVn^-#uM~GhupIvu8
ze=b}}nwWt8C&0_(C!x;nu5&OMKD0l=;VJ+w<F`N1T%E4kPWcXkDQ$<R%xZ}{6Uo$(
zs1J<6JBsm>QbDKUG5`x3rNN&kdynxzI6(6CgIcx=?oSqaq@$Od3}Z#fu3lwJ;yHQI
zw0-VH;g3HDDjQ)8>IG!dqM=x^Z?bLV6k0KF$}d%gELHh)Y_7azurahykmh3JxTz<t
z-TK%H3x$$TjS3!S%3+<`rfPJnSYz>yn^|jWuuo^zET5?3w?DOCPdn@v;jj33Jeq?o
zjDs9A6%g$q=x;1YbcIy}5)=rvP>$y?s<Z{ql^bZ=p@tRpDeCisw7QIky)ov_mDa4K
zIu+j_wp5P_)+L;8*CM-usEk?DeX?~s^y)}36zDp!^Pl1JWtx~N6KGM95*aZzYcbms
zmMpYT9SrMgc7a6fHk7C#Qbn3<nAXynmhS`kT<4|h{;a%h(`qm%z-Ge~d=fmFpDJ&<
zihBXm@pWj3%}#vQBG<zQ_ul4G8(J6{-Q7!e&_PXywIJ+5Zf^B!4}Z`LJ$YBoff*%z
z4*B(ST)iu7@aiI}G|$NtyHZ|{=vI7?=>)`v8Q5_4y#_^9?3gmLR&XZ_!41EgiG`!d
ztw`uf1V5LSb2%ZG1D;Zd>o~ao6kYM-OI<&irO(&!p(a1?y7l^15<-QR5p40TPR6Y^
zd@1atP)8jUNl2%(^gX@XKeSEhvu~>U$=G4DiM+j(#ddJo%~=x9_(ELgF+S}ztal?U
zisv!GJ|rGcfG)W2X)gDU+~mL{d<H{~G;q<osc}yad_cTjC!|e0=HTO>_4)P;0pjSN
zTgEXEsGOlxa9^+h)zFGbP;Dw3Tb>l&I$L!{d&H<pTRV3>nDXr+7hNp_=QiZ7+&DNm
z?qlZO3I=VJf>AAV*iXStbzxy4thrbPR(d)-c#_Tgr&{i1YFP3RTe8cVY$DMYxR35K
z&W1r1i~wcXBpCO+D(PGS-d2MIW9iMy`%#H3PGY1OV~m+MyLUN;FO17e--}nz%w~Iu
zu3*!t9?@HmL;%5SNwnehFGg8B{u(Fom@gK-Esiq4uAGSqc7mO;M5$kpDI*J$78Cq5
z#wI>ZA(G+OO<RbYTY$!_nrnGseDNoIbnb}bg~;+%3UMFT_DU5h7%n9YmqGpY<h2G^
zr1EIJ#qYZAWQU?WPV}Fm!Sk#qhF?8OT7Y2ya2a3V;^jh?IymlsuYzIzF0v&|Bsk12
z(`DW)yddo*L#o<mmYHMqBsn$JaW5q|CkORbnOlj_l@!z1*w}qQ=3*CQ(PqpwxNouL
z&m+?;^Lg@P6uf=z$$1pKvWk@O?{?y)y(yO@Vhv$>Rg<D#J(NG=bx4*yaDJqTc#tqC
zNE5nZ!(XM&#wKN4Lw08a?gyS=bVcb~x*g0P+V8SH89BL<V?LCxY1qjfQoIR&_Cv{B
zlj+#!ZlP<j7ewBxehX}4ZvN)LQ0DfPoJ*A%PE~Hy--Zd*J_fVD^_aw8aYvW+DKN|n
zO86f9$z&i9fMH@??&cu99b0}mS}GomCi*$aq)z#URr%Jh^UPmst%>Hc-YY*vS8{}y
z_C~-7Czd9cDqigA=ze=^XKl^d<2~_>o>Vx?RzaxoAPC?ZDjFIFKJXth9}{X(>9+;@
z>D9c5m*Aix>le)FQ6&?pko+|4!0|*PLdC2h4!&{M#_AeBT6B{`l(b}#D|ELw?^M3j
zy~;sGMp`oh5BI4_B!d<+5?XMo9VK?~+1qpt8ZC`y7mJ?ejND^+B2f}kTYVCrqpx;8
zL;{|2y^(>r23?^%m}4mR@hJr()Kr2>-<{ypVf@7wKU%9m;(Z;Yd88~b+xhhH<Pm~_
zAj7zZdvQhn->i+_V{1;F=JcRH(u#00I$W%bZ%=PyUf=vCqFa22iZHjT;8~Pp2d7B1
z^s5rc06|zU4(<oOsA`RuIoK%L5OAUU3}Gt=!euM3nVKG)c6TH|)LpSoil1P%w_|#D
zN{=3Qs%@`Yf6esn!f?Ua?$UzYMV<51>dDY+C435K%~1QTm9=u{eAY%WP=@qN9^Haq
z!UI+pGV(RLRC(CK7;px&#$+>dxU}5wEWNnrlgzYJud{GvmGqCIg4<=-erkuX=(pw|
zRY*VzAMj%$vgZD>%!ZkzFuxGZn+VRIUEt#=XBwMWj4giywvy~yf4S~El3c6ri-r9M
zGe{D`1^@W*RBOKsVEQ$1E$f~YNmB7mj)(EEP9Gl7(9-fA9v%{r=PAu8COcM%&?^S-
zv+(olZf$MJn#GZoV9WC&&wPEff-Wz7*w<)E>}S;gPnx%t{W8GDqkm6tht0Cf81?fZ
zz)3>|x~xc8XUx~1BvHs*Ch!56zz!M)TkXV}!)CcA5YU*B1Mw`|<K|z63Kt1(ws3DJ
zG|S~7;zDyW)HA;!0W5Nulh%$e1-a}Z9)))><5v+R5o+<z-g5!u^Kq%>5XHm^twO$a
zkXw>GKZJXY4YO4SqKd2Qj(&H#r`lrM;G<9-8T~fOCe9a9TmC9*LL6*-4)jZ~lSvOH
zWV?*Ret^R6c?_U<An!0|$WfTQq(CQ*jr8-}dj-cjp)zY@3?41SmZw7opQp!cpVc<{
zg!%0=_iTeu&Ny_%`~pSd&>PK+`{H+irhu(>Vp70B;DG&<Qc$(tdxPiE1uT0((V@-3
zJvPh`2t6DGm6-hyq+NTaPs1kJYMe@K4inN8f&-_(hYP#{>Y*)l6Vv3ix)$ogixyzI
z^%gvXhAGbb>l`5r^X{;{!wo`I`(&d_h}8_KmgL`|G+CJKTif`!n4A8d9`U&?$op<I
z?SIgDZvZdNfti=)9#typ3$w4}NL*zeCEbafV$aCvQ!~cj&#t_!43=0;?2dTd|5hO5
z)umQZ0;bb^Jf`36u?YsoX-V7)4b`eTuOD&tzNP4fh|l5f7l!6fTCE0oCLb6I{{)fc
zXHz1P1@e0*x=}UvK&|4oOQq`nND)IS4?pZe2#`sQ)`6auBIIImmt#POG=vSgE3H&{
z*n8qUJ@PsWMR-+{>aozqB_ZvC8ys%E4Ju~Q_lb1#x&pE4yF3ii-Wyhz9OzV^?&La~
z?!H<({zdLEMyF!(K+J;Zp*eHeGn0!Kj7Yv4P?6Sk8@eys%(z>%dXAa1g2v9>jdPmu
zp^8Q|NwFp8F;8h=iK!E1OpSQ$SC_H^2lV)smadooqktUl=0L`6Z=D8>b&TF6G$ac8
zNLoXEClk3PG3DTT3usiubzd68XXz?@VS%15nptkW#y!N$FVbvAf1`?$0{v0bIr=pd
zOH;aVN}9~gni3<nsl*_5)1XrWuhVM9sOYHfssg#!Bn~EGUB|rZG3!UlCg0kAJtFTA
z8BtVtvz3rmXH@b%-LKfpwG|7=h{$U`q-4vrY$fsDVB*@yV-6K6%Ez58)vDq-b>TI&
z`7Fn@n}1DpTo$zhwvmhPYG%=fmH~qDf_KZJq!$_Bf^(lC8m+lADsQ~qb*Zbri(|jV
zjhipWz}+l7ynWb-UgW3x?bGRb=X=-&M&H(-CYC?+%UUz~8%L6)_f+oF$ATdy{xUNb
zo-&Oe0afTq)%uvp{O-9MLd#n2%Zl%wbizL60OUEY%4y&CzJNY$NT}y~<-TM5%M_2|
z>$sU~R++kfiK%qQeoFM6nI65s+C2rR(;*bLxd3`=kZ9WJps0~NFKR@m(z~X}ci+L7
z|F0+e_{(qn6}<f^B~OhHJGKt%x7v#fUojZ%r@fnsW#z0{o*-)b;<0=p?Hqj{J?<CQ
zer<Txz<4lO<(}T6gLzkqn&-pa5yO{ay~Xt_97)wJA~xUs|75MD-ssg%FI&leWdCk&
zUXAJ9hRO&x$4W-fN<rT3rS62S#W+nx2{PPZ1}h}qkTUM}ZT9ITXP8>Eh^6!6cJ}cm
z_J_*%g)WJhzUQ|za4x6~F!&bW+t(PPBL0)*$;KPQmj^4?9bd0KS6%PQTkMgj=ZF*F
z<Wxg$5`bx*<K=ok@AT=emJ*pwu;6Q8lO0-_6E%=<@WR-R+sKL2KqDFr9UYxQW3(j1
zZAl0-9Am$!$PEKG!yopYw%*A4PKqAz@L6h6bhuKb9h>XJY|k_N9Xdn2Kmd<{-fX?r
zL;J{{YvsK{=FH52A5_xl?Ob!_U1L8Irw_)_y~SYlPIt>W1>Sg}c9bLpg^OoDQGu=q
zx?aduG}xWHShOISd$VxMyH8ytKCMp0H0blgj}-RFt{)*uoe3WjlUtP7=#77+%PK0D
zOc}%AF`z}foL}IG-FUJ$#dmK~z(Y9l?DoA16PU11z-+JD$Fae@=K(p|iv%in4iS$>
ziQ>1pxVYjgD+Sou*j!T<`-r@E`Cq6FMQn(w<rApt`map5Z<adA8p$n^(@;@yc64+Q
z5fc+1J{uw9z|==_Oo{pUG<K1SG2ONAI#hPFoO$2%+?O9*_U+31^yY$+^_+yLMs@T4
zo62tGq=WI!bmx-sSIn0+q?GEPHwp^RD>$$}<noE<uy{#B0OMb4&0W0JmC}@MBb7AC
zc4Q<Xk%#8bbLv!UhI0R<U+;y>L%Pw0uj}pNSi6PdGGZ4Gj6|3u)G2e<8qV>fhpHPf
zjb9~j`zkOGISgQ__7xUP1E2Xb+)upF6m}O>8~Q{V(y4&F^$drIuKS&myz&0ro86KI
z8vO-}JwGY8(7g2YGVUH8%#xC`c4#rR>7r+=OTRwz#C(_zP&!$Va7sgS?Zy%3YS@HU
zgk6?SZCoIlNPEc|w75*6qo}H^5?k@6nSr9$1f_+(v#UtQ%c}{sv+b-D)MgCxRIm<v
z4<DoXneF!;MxB_!cx{(<(!k}um>&NS`7lq4xNo`0kg4u2;epe{i>==@LMnZGzm{+x
z<&UV}irESCDR`AkNAdgj^UDD}JRIm(hvDUKGqt=(NK~~|9O|m2d;Um?YG3&=Q1>U;
z0mpsPA+Jkt%#1NF{b6Bt7Tm%XNP0fUe70b7rfc8zkOgB!7VP#fpDwSTxk;*^VOT<|
z?F=`q6yDoU!egpXa?$PS=eIyJ^QzCh$nhP;u>PzZDP&P~kbG5cn#jhMsp*1vvQL|P
zbTsqdjk$?%1+=LdgK@Y*pmlJ3mBcqLhoGMcXuXE#i$#aVLsy)1&BwD(eaV!-+Lo<f
zV&81oHtQT4=Iq&vvHrha>_=7v($WUMFcu#4WJ<QXiR~-%sodGB8f9mbdO{-2$rbO}
z81-l}1La}=s(g(hsjL{Bptu@o)8>lI(lx@)WYWaDHEHpc0uIx=$_}%uC<osaisdqN
znzP5?Uf<+y&WQfl6u0X3p$yWiUT&^{Zi(>?B%7_$)?Yub+83XuU$?EdnK_xSm1(kV
z$0738x96?iH{h4#BA649!S#Ro2IPxlri~i;wML+m(|M};uCh4<XmEI|@cRv&{&7fI
zGis8($$Kc{b$?o`TB?`bXw+fy)=H(g(F)C|2_@}Fli3f39In+9A-n#f6rGq?+zk&i
zaxR9VRNO!_Lw3pP&Ye3ks>3!U82iYTf1L)|!DL1+$}&vhDlAG%)$K~r75v6L2KfJN
z=nriTD$&--+t^2|u-VS4#dXu1#y-@;|H@im{>fdw*AXX-+v%I)#P*S5*Tiwd?UOp=
z@|t6Izlw6^qZf0bvsU8P6zZv|?yJ|_^O<t(mD{RmnCgCqNbbjwLQVlUU_w*$djTnf
zh2f7o(IxRWA4Q<dKi=hv8CU?-F|fY_vda!9?<lme!l}kwy^72r)~M|oWCTczScWa9
z*Xz?I2oUr{^}Uzk2lJ13V#g=Iy1$t!Fst&G<}UkP|C7h)>E<}5YGFMh(`yVWzeFeQ
z6MT)uYS<s|+ej(X_?(D#ACQzaFy=7YkEXZ9S`CVA%t%xotmc-aHBM?Wtk*~_&J#4a
zkl(xE()e4^VY0FS(!cIy;#76QNPnavdt-~lM9kG2dme9*n5gRkF|qJY<6`~h2fU@H
z{CzQaJhd&%L}Hdbb>DZBZZiK}+b+Dd&`uVSeBuxzxP7$Ij}!E_c<oU7J*z;O>xs#>
zQEPpbPPx!j%=J^t&HcZ>;txHXL(`7`IExtzzPOCC@c*swtu^p#IJxuUC|8v910?ml
zE)kKC))5&WAFpcdRzQ*%uWDiaWRWyMRYRui&~hf;r{E<e@9xmv$?`Ua0}h&m*0v#b
z)oZb<`<-v~miOIw26ZPx|FOHW{hUl$-(5|Y6#Q7KwAVK<ppedP17M;X`Vvck%6mU)
z?<4m(y~mill$sIBbJrcqqWa*%W%U3B(*VD^&BqCAy*P!pR<Ahm23+$I$hTAUutvm+
z(LD9app>WVy?%F!^sLIlEs`6?7UASh_@EP;y+G8(%aJhsfoQ_ih(QF4S!d1jR}{_9
zFGRNcvDL$<f{PAEM|m2mY3&_}toK#>*61ix#UW*X<fNWhxLCw8SZres_094o2G7-D
z5^+?bdOBN&%lnlTwLDI_N5ph-5tqhJ?j&H4&hMLH_WMzglmAm<M2aH|Sgb3ySY-eC
zQkQa}|I-jx?#X0kzpW@c`}<||R>r;^M>BpDwefoy`Elj_UoJQ}rNz?SxN)OA(7yQ{
zrsz$L1eTO1q|5sKDco$I`3j!lUgFJLGH_oOcy<u;9a{M}k4$SVRdhEAtX#%5h5mlt
zXs(zaA!$ZGcyD~SR0^;rJ3#J-fNnFOmzm3f$%6nV^WEigeb1d@>8sG3toG?u-w38m
zwYVm*d^)3;S%1-Wxp<;)-}|du?(G~`L}SYAH0ISc+oZPTvG(iPa}{Ou&eK~eCFX{F
zE5mV5>n}4mS)6B|Jj^@(-Ru11Mf8pRAeQ!yweK<&kDj9W#n`YCl^|vJ5#g?ZJJO*&
zLL8|<AsTfBoo>^TE3fhpeovcKx}q87oiu=<+#pb+)puYeb58TFff)9*+b0?z;!)Kd
zEJXjhJtiI{Esq2h*WHJ4{L1>;Dg`77@ygn61-}ECKX%||g>~VSp;HMsyMC9U(WM*T
zGv3=WaSuv`MBke<Mn_0~(`^Y2#q64_S1GS{jw#}P$>cP(fqpNfG_)#+Ho5##S@F>u
z^k7ca?c28x`~$z_eX$!HE(@fxG^yWsiyqS1)-~f`Nh{Bh&xwrrY%^)fq2g9{v{#ec
zuJ$WlxFC*_*Jpv~+bK?hUca$bz^(s#%<zel8}yjebMM$|vHjiK^xZpMj;_pL8!W_s
zTCCpF^v;=WBvtFNrft=DOIZ^Wm+sFq-k})a>pkO{#Kg?p^~!seV%Lc6Tok0eEk`Xw
z4zKO@_uk(gTYpt<zkk20yBmGn*o01c$$9AO%i=5=({4=@Q$0!Xb13r^W2jV{(ZR=x
z*kO46s*1=~qjXgHEARahsqTK-Td@*THQnnpL0x?`Q+8v0G-y*Jjzb0J>d$3-Z{Fmp
z>gbf`<h)VQQ7s&Pr)zq}*~pSo$dO6CA%mx^S5T*wCm&J+hNT{VNDT^-+;yG-fex(0
z*oCHDAK~SACPl7^MF)64&iQn)-!D<*z@|Wg?fQ%E;xUVu8U9eeKbBtFvGHjlMxvLf
zzVhVON>4`61{xvUhm`Bqp?Ep^gruMwgw+-}SpGH1Qs?KTY(XZ~z~s_@rK^9IyKbU^
znb+?H6BCQtyFbsEUt8-IjATB!ea)w|oi#69G5MV8%+c7LiAO^Br#8y%r)bet0nzR4
z?W*n%ALrzZB@T=3GSf4w>o|@iEcVo+)3gnVzVMyTm#Hv#40GH~;J&vHqk2cnIFp-X
z!C}VX)5V-rD{bQa<lqx|Mpw!HERXsZolurq-Oh<OX=V=mr|cQz1{dFzX`2iHTj`7?
z1+ah;JLaUb!aOYm0S6Z?R2l-B+W%zKa)4_l%INA=hUX|SVeFE+f-%m2(DGX}6j?oZ
zon!mTM8+u}p4@%RAhOhSDC3kwwu6u9(zKiCn$!ax@dc%9nA$JkJ@Yp(af90sO!Rs<
zitRbN;v5E^(jK(zI)Sg6>%B4iHD7XJ_4uGW%l*e*uZ&Y3Jam#JqVxBQ!&&TWl^+!y
zWPr<6FzwMV0X2Sx{Qu{5fyZhL>TH%*qF7#?@>k_O?Glj0dFXq8!eZ@sX6FXV{bOK7
zWAjNaZ{&K^f4Bgvou-e5Sh#b<F%hHHOYm_C#1$Z1kudTh%!@(*xz;&qm~^%XcJRW2
ziNQ7!F0TRCUNSBtI^ZbaEA0|mvL5x_ob`?n&``OeYWhmLZ`{Re^VR<6kWag~sxK>J
zwy=S+JG*v%DGCoD+)5-yO!@^^&pANC=ANpE8K=}`Y~>Tq><wQFv4hkJol=lT5w40+
zp($=MdFM~_XXXJ>cxvMMG^4$Lxv<ut;Cpox)be&3S~Eb~=w%gn$v{vC4~sIJar`_D
z)hC<xN-x@^D+O=o6RyPXwp7`OmbK`<#A;t-nSvIa#kHh|&z8dMEibA1RT9i$|L`l2
zkRu$A2yVukBqqW5PM^7vyZyk%kb&9WD;C#Q(mdgk#DV3EU!K76{jBy+AN3l_UE?Ys
zYwue3C|?(PTg`Gpp7|C{k1~w*qJdP!ERT;=_yb@uOZTxjMLa@I1=6K<R896<xh77B
zeF`$tjDB^0Q183>eOaYKZ2im0osrR;znJic!sZ<ZixE&_RqqX^k}y1K`kfV&gaaAr
zVWbb4mo_HZGhTTYRu(20oISx{tq*;=O{U*KV-g&M+F|1QMHAH`1rsqen~5!q2YF}T
zkW%Iln+P6B+4aRSvD=OpcJ?o(GyKZUpG*jUmBwtZ{5NT?&`YfH++XY;G<=g{Bq2cv
z3f?3`=t>4ZpO*VVI#=7BjLpWnGicP<zRNDjoCQSL*mA!Hb(fB(6ji_Ie=cm=;A)m(
zeBv^2oo+s=`hINoyPyj@PfL2%gr;VH8Hw!m`MotyB%7xV5t{SYwFo@4OA+yS^C1UY
zUIKn1yBUw|+!bWdZ6wfigiH#>MLogWw4>ueIm(=5M)Z8;^_#v7`$i^TUUjtS6P)6E
z+fbqvc=vJ-Z4L9AO<fSembB|8L5x@se&l@uLpwc`EE0=jKD-U*#Kb`Mn^h<EZZMi(
zsi3XqI-}Ba0dI~O*S5<%F{4ckckY?-&Ru@5W%4GkzMAmu{-Scpm{d&8r03bAPa)^|
z46G6!003Pd)pERMAkcwx5sp1OEumu)!<c(0!f*(Iwbn3)&M@b?p(>s`GYh>jQ&n|)
z&S-3MWj#^cgs^-l%4luYTqm_cPIYgc<m<+?1jCIRL~+Sn=ok)kGRF;-0{9mebUe!q
z6$b_!b_|2;2~Nla;v0@4(EQ{-T%e%^6*D8SL%l*O*U8-0eNS@LRkEC@%0vZq|1{-i
zd1V>Qn|seNtEi~Be}CouxSoUClF(Hg<`>g&keC0I)8UC58hw@3;Ypc}i5{Dd8J&(1
zUG8`$dZ7iEImj(5UN&?gPX5xNO47Jugo^+7iu0VG@2t<fKV>t0pUVCu7Yl6_7{!z&
zV7WkyW~ML0Wu^TDT?eyJ?5$7CPuf4K+;T38|M*euxK&BbdHeoN<}c2$cV{jF;vgM_
zWEAjO75(+P@7ExsxKAk6xQFY|<lFR1k*Q`?FHy+lkZ7tuoWT|{2IrrX=KC+hG0jT&
zfJ*J<Fjf8T5{+o(1;;NOBpCK**~Lkto7<{8er{f_s)=La?VLOnN5{gPH*ZvCc9@=!
zDjN<;E_7_51A<K7t3@9+x0IYKQx{X)8n8bOw5<2ei@)O%H?;QasL{-4ar0yDNL=#H
zLqH^-%-IVCikg#Y(yZ<ug@yU3XxxgI-;OKY@Rki_VqsF1wF#wng`OKaHr`7470I%S
zgY|6l9G0Jgs#<rq#t+|crXA{Q!UNiW0QdFgv_K*c1W5+sp#yLgY=E07y4HD1o;~nr
z1b6>c$D3TW<;*Pf?EdYqE}RLAx79}dT)NZu=SWVA9T%htbuur8mCkXUEO6%b&eQ9^
zGs&oUA`PDtT1>G|j|IBrq`zzhJ7#P&l5Tjes`vRPxSB;@DoCIvxB7a6!3~FqID?HS
zgRbndiP{J4@6q(uzQ#JK4Qi^}*l|6HLyZ!9-5Sa_=_7A+Q4qzU>CtKIHwse91HL&P
z9=82NCuQ(Lnxdl>JjN^iA|vvFa~g*_ALm{rz%zLqoJsJLo9-s}ne8>cMB@8i-Q?rr
zW0I1Z!y2kLZGWG5!X`Cy%=`YRk51$ACrKu<kgX9D<&nfep^LYQi^^B#>Rp)Kr)pb1
z7)`i%^(-1Py*9@4=4{0p`qa^(Vr`w({_$hIv<ay;AvQO%b3X|sFFLzeKPl>sO6chk
zMJF07>3kVt7UWj9`L=MLyr@v~xCx&}%D#r=&PL*HkaNPW*soq=sIo~P{OyNST=I>e
zaW=XlRlb4JlTfy!Yz9&oA3@bYrC)T{zwb!8`=DK3j~-;%GnFmTCy?ou-hb!Zd|0Tu
z?Q5@me@=z+`HXjGJG{Hftmd8^a}e4`<lb^x@aphIOgXEGay$1y1@bNc@z48dd2nJ9
zK1Eg|-YFt&_iijtN>>7LQPHu@p}+ZPAZ88=tBRsxJ#1Aq(XVKSpDYjfM3~icIPlau
zuvpe&&#MS0=L{dua^_<BGU%8TpL&XI-Ci;{we(#XU{gpP)hN9F`e7f(r@`*5GnA<p
zP^N;^-{|PBd564LEaVnGS!zsPCCM4nt_jpzQ<Eo@(pPPpoLtIgN`GlSPg>LbKG~=F
z@$ugjx>3oSd!_g4j##GpOT>zrc6{fxrw#>eM+l$`PQHkIa|Wyy_1~QfP$i6%MoObM
z!>M%kr%X{#2rFv1B?Q$SN4l?DRPR&@sA#Ci<t)Yr(7zzV;1r{Acae^Whij%t3dLVD
znQxU%kzO937JhL**eL*T7x=~uHxR`Rf-^>7^5z?qKB;WwRWM65A4lb~x|QoL%yw9I
zRl9jlbvbV3TpN)qicwspZ$P=&%VaU(QxqTdI=?pGeG0~~Xkd=ueTqO@gdqWN&*2ua
zhQ+1nGdYa0I1F8H`r{qI@xQ)=T`nlkHj+SOj&)olNpKZ2$p3fB@xzT@Ljv!Pn>c&z
zFFcm;>kp*0{_Fbu5leIBoW;!syQ0stoaU_RP&tMa)T`D33z`w(iXdO^1DHmcFjD?(
ziu9T7|IX)HKMUD?)$RWFS>Yx6??EMtJ%^%vMC;>aa#zIGt|MegSfZNbe=?do@lNtz
z$me3mhXtlCb56WueEIlFX~O%_pXYP?>=^x*XGA=+*L+JB8a@X;SC5Ia%((ZKr&mt`
z#mCQY2OK2C6Lf_%M-w((*x9Bl0JziGO5$VSeSikb+#NOGbdEg5ubZrNu-&VtelQ>d
zfY+<+K>sBzkq1Z1?jJ5vj^6d|zxwI-H^FW3#JLKa=S!c?8xH<H{<pm8du7$2yaL3v
z&Vsyj4&c*y#}0E8GHCI`l$XD#IKv+OqEFJ!u*XFNdn}^io#1I$<0Dq}1OTvJ+0i?y
zySZZL(1TfIJ>&I|oF|>~@_cmeUS>2W%5ltzw{x9>_n@aOu%fo2FX>8~zu)Y10fxQm
z3FNvs-lFiSr>+#tLcJ*ItB^(6(fT6@%i2EK5wuh$K6Q7AB&3NLi&>O6fj!Rh!W1+f
z>i+%3XZths&venB1v7t#!MP59_IhWmB%xPGKQLZ$KUXmDM^IqXo%Don65F0P1dn<r
zrFJT*2eK-}TD@Y2K|m%%{vpG?o1F)3qM(m*ynsNhZU*je7JC9+$})7%5VABt$l|KL
z$yK+v%Xf8k#fF8gWV~4{e>0X}d)VOB&H6pPe6E>a79Yo@C^D0@$kOR~O9|VhLC0H7
zPJg+7256R#RIh1D#sAWjthJm?I8<=&_S?Rfkd;#ST>Ad~V#GLRZ+*seS9V85fey(b
z?KE2v+-qW$eb1u+!I!=u_)`7j#zissBK;D4wmT7E?S@<K`%jJr2SSD%H`Y&35t(*r
zfzMqdBfewMD@;`<`}LO3`h6k0@r}=kr|JrmTbUranctf#^((R8Xz_~Dq*sO;j|hB#
zRdMF0HKfMN&V*pi7m*35|KG7@-a`w&UxG*`2gymB9lAktx@5gcmol(MYr)p`7#F`a
zw21WH%mV-7_2GAYfHR}{FRlhwXr1R~0BIu$&!oinG!Mtjo9|=^T@ie5?WcNI3Yy<f
zq9c&!Y#TpBw((d@lD~q20ve5G2oDeEiJJ~sC_b`EbPjTC9M;r$P_(%w<m5Sa-hJM!
ziJH?k2b&DCq}<%x*dgkB5ex)Ga6l&>>Hn|K#Xr1o=_(ym8*%*o;$Omt8kBDDy=oH6
z%%Ij5s*v3<t~Jrq)8VkZKSfU-^jof0J~H*;od32u@o3~2G`KUd^^kzy?H7q0hJ<~h
zBN6ziPu-VcYu3rAS@3B9KOFIm@&!{cbGD`i`E<9BI694fc_LSHG_pOeSWhGx(s6p(
ztIV{SeEz9x=}Df?6Ytd-L;r!@C`|B-c@zb!ukVYm4g0TX%fdz~0%>N{(L*ys=x&$V
zM<8@m{IvrXCQtmVIfKXC1bWQkhAiu+Pu(HxT`WB}BqW;^sX~*u-sUUQ*-dS2GneGI
z4+kxlz6I#%^4)CUXD#DKFD`Bwat=$6n1nOTi^6Q_7xVqE9UlMAgOZ>VHTaq>9i!rp
zj<zg4`mATPW}Z*hrYqgvJFYM>C#x0eE-d8i%~@1g`Ha=-QSyDXrmgGfK${zJ0g`_-
zHdmRF_NPZcrO=!;o<KfeLR0*A7_cuCuYp~9{wG-sEz}y)-L%P>tt+n}Sza<o{#i>#
zp~ERstkYSs9lccHX`HZJ5tn5eC*Tlcal#h6E4FRdkr*{)-}R-;tx%w=$j8Oo=Djvi
z(Bh$2DuJgjRIlmXupD}MKwwO24mj!tGNaifruUO3$i<9*?@^&E0vhhM(z|$}e@7kC
zS)Qi9`%;-g9oR?b!0!|JYC%v_knk=5zFgqNn=0U-(~I75Q=oeY1(JSQarEALqTq%k
zx6|@_9xOi(|2yl04CZ`soG*qtyP>W4NWQQBrb^sn89Mv_z^tPF5sK_Xm0sxn#xm}D
z6`Ku0B0nuZQ#%D)fLdeoJfYAV{h2BAXt8m-k6$X)@j?iaP`xDQjqjE6XB87F!iy}@
z*Z)unAEnUPP8_OLGjxD&W84;S(jLj)sXIsLvy@<XOZXc|4A1-PRB&P<B~bT~w3|hB
zQHr3pLH|o0thy!M+L~`7(FIet-1$<wj_Wq`EmEFQw{E5V>bpz-wuZdx`Lnk<wfPHQ
za-j{naOD?0jzol-^S8Ep$}~;JFrjbO&-&TOhY)a_j=?U|Y#P@)T4Vg%UPfY9`katz
z-|`%@l$e@V(MfKRw&_?2dDs5?hsiN$2G3MM-p_Njy5!s5Cf^?AjLP)xL>^!FegP7*
zPWUQfuE+O2>qPmthN$TXsNau7Is4`~-v?e-G3fU*cCYYyc@bX7#!(PmOE%N<pN{;R
zagClNHBFkrq!qmFi+X7yO=@=LaNqKP4%vz7W3`Dt+co9eHG(>3dXl&1zIc#%cb1_C
zR#lnpZZ<rhWP2%H$Mq5@59~drX0lY^H^&Xm?QXtmdj1M6#{Y+{?*ON||NA!%ju8jp
z*p9uoB4qECWR>i_GRjD@j+J9ml!#P9nH7cXJz9#A>`}53A^N|+-S_Xhp5OEQudA-R
zx{q_d=QH2qHPDDaA`q^HxFfeR>rfV6M~PW*kV#6rX}G^1$``L#XyHHqm091tnVjK6
zQ$^<!#W$GRypI&$t*8D)r;t?inyuc+tm7MD*-j1@(qGzUa_E0w)RN;@(UN`p<pJ+^
zHhzN?f1wpVH$Xbv<9vN8>0?>%Xe|Q52mxKgcK26+25g;|FyCMz_P_<aF%asLcs9XX
z5PJ_nFO(ytu=43{3!SLP*MI3g5|!Y|E39*jS2$Z(*N+#ftn>U}W#D}=z|Hn&gcNLT
z9se7rf|!Y)&%e{1N&EEd!;w1rJEnfIq?lhDJ>2uP1CrU?S6@-LaNeP1YMV!5t4AcC
z=ai@=7+zaEhv$0#B&!bnY7H<6t{XF5vLM}s_DnsdL624=frL6|Hci=dSaoM&o%$|=
zFo~odl(9XT%I3uDf1Rkg_{7}wo#DFc=^$nm@s6`^GWEDb5U3<j3gRtkAKB3dD3c(*
zn@D4Yqo@k`a<Osn<))^VDvtjDKsis}yzAmTw)A8Mt);G2&1+ozkwXt@f?V{5Z+OD@
zwoUCvVIgmU23Zj$YRN(;iSK}I&4hwc-^;_FRn`5)xnd;#I#ckqZ$MM5-z8mj;k{tl
z#I<M_IB}WSM(2DFb=<#PK6{Fa?tKhTK~rA9MD?BC()i!VLoF>GL9kjQkZEV-<_aVy
zC)2-|^-JT$oJGOKEe2ey8wCXgudGV%iIJEicf>1Uwa`z3wn{&oZ2$bU6A=-493(KR
zYFK1+7w0}<eIH8BFxHZVrjl^~Wk0bX8@CUeCPP#K+#r6l3_Hthjw)e^K^iEg%HQQ1
zp{aD21?AVsi*bfYjc1<vnpIz(CATUhSGw|QR`XM<u;lswz_q?U2QA4UfTG`eyC5$D
zDB5}SV3C>wLY9KUqSt)BLLzdLA%&vR*pc@g38l>&)s+rM^MoW|AU{n>8!Rc<&7A%D
zRN#htIfBnDPq=li=ycG6)sQ964j|RUJ&Gcqf(WE6$vNxr>@?MFo3?`y@{4bv3Mvvh
z5ttaAl6&~0=ua;qbb4?B2#ipqdD#oU#nleBvL`OS1^2){1`$cg>i|>kjokUX_(O9B
z%w+Q49w0=JzJY=46PLdBKKWoThLo)zuEHDBZ=XFC1;VUzpo@_MAcn}73GW`C|MbqN
z@az4$;S&QKq-w6cm`^%ToHT<GWX##~v;LYvNaPI33$R@+PUQNENj?Keups)R5O&M#
zn@4g=0qZC8lkPf#9(-)#K%e}uPf*A0Jc7&n4s(6x%g#h_y1e&0eFW-TEV1>u5+rj5
zQjbpx!)yk9d-Tk3XZ5oi{61Y}uR31s6o-V|3vF=YP=(_h0OWq`&$rQv8+KQB=Yx>;
zIK=NXN~ACI^048vsmBNJb%HKL4%|)GD}E!O;*t_x1k)v;pfHN5WHeJTFN``2SK6J+
zMi4gL*#`RUh*J@ZT|mrlC@y3b6xcm3fO;fQS$e-e`y$!H5o~<sC+p)oh$zMHFMkdk
z&OABCUV+9l#&|w4pKj;KdOGuyves!Mk!jVSf>6-K@#-`~ggq`WvFJ`|WkL>s9225L
zPAU8Ya!f(wC-cGC`yvP-jp-;qZ93=Qr~|V7K1m}m`R=P%`83`D4Ic;m(VDr11w%;n
zQbRM>*|xFMULCVt29c0P$dCL1D6Ly(sw~371>g7T&aSRpA2qiCO~KLu!;A(}TE$k(
z3uu6Ue&-{A=IF$*sxZ#20L&%_KEtZEu5KQ#nq%78$|gL7>x&~l<m{Duaes`=%#J^x
z+5YyyOhwfLh+Hy-O`w$6pJCM$HfN@<pYiSS3)9Cfd)}<z6g{PcZvwua{jky^N6%Nq
zyx7S7@6YZ#OnrWbAPW^z)a3!1t`qj><F@~KDX}kMXO4*rPSm)9mQJs&@n`paecMl0
zd1Y#*{dM2Ht2!p?edhe*VptnCYZ(|7T}-;CKAwAKV{bZ<oB!lVds?;M0k+MTp9Gv3
z1FW`RlYLm7qVzl*dor%q6juR&ke{L5j<K$^ak>*b@f$KzggmDN3bO;5@)yM6!ZFwK
zUq5mC;u`}&`B&DW!onGdK?$sN@EsKl&!_`P>_~=OyBJ7Y3BzK_0&Yl$lv13XIjyX?
zebZRj*JBqZ#lh93h0<qk#`<svKH-)RGx}wxPtW};O*(dG4`DitfM<^=Pi{iarIWiz
zurN`&O<z)uoW9=7F`jki3Mu|wPrmbcrT_kJu%B2Oo?VxB!USN(0|G4vB8L6#chsMl
zI}v>*wuF2nnn6>91bCaY8R`0F2=x`m2~$z-^%W|(ydH(&_h~p3Pa#^)THQdtac#1|
z;7-DZ`Gmo3m&zDCTYV-903vu@cUUu=1g>b75sk1b$a-g;>55?pt43g77WZ{pe{r=Z
zdUyk8FF`(B$n~aj=wpt^t=9`;+r!gJE_655Mp!40Z@;S{G5H9MfeoV5EL`#`i5T-k
z!Rg%y2#@-|w!Tej3L7d(EujBs_ySUT#^tJnr)Km4;v}zK?-rDyE@Zi9*1<J?GopV+
zd5a}kgj-^!Geo<@7{KY~726+6=LWe<9}jm;vxMa;rb=eLg@6qeoA80qc~ZK`eywHy
z@$Ri=XE3Y1J+7SafU=7Imap3G9OJa@HplLXvbfRnXbhgZ>XuI76(@tdUPPY9+Ac7D
z{AG8`aWNce;R)L1=ye64Q`*sI$f<Z+HSqO3*Q$lEd+J63<Td%K{*$;Ym1mA^Bq9<L
z3Y$|3d>Wl)J?+A3Y7XRdT)yi`f<Xz7+h|E1A=B8NqFz5%wq9Zv_#IC6!)p1l7p81G
z?2;RtW{k;}r<o;hLy?SSbGXbJSe9FuAQ80RY&3QIDy;LJYZ<!R$+j#3S_$hXKt^QH
zPLja#9e5rJxHSCX^k}Sh4R`8#EBqgQUEPF@#~NY4*><2Uw=h-eTCs>LwN1`={cQ5`
zz{)w7sQg^6uqoo;F?69~({&DVX924Y;kZ{?BPg#}VXnYV`h_n*9h5%d1CciFB3>~|
zm@a%gj$GuHj7tK?rFZ5F%9{bT{P>jSg!(^GfA)*UUC42>@|v{AH=fYRoCOioLnu<n
z78fGG_EuK3_Vd&r@_x~HcBJn{E)j2~3lT)u2lIPcDm(&VX1o&gEr}0$sl4hx>Up{V
znRR~eTh;LgBDD{wYPIrka6H>*fu<q$bT=_Ca~p0YBc(~H4fEzFnCq}RlZQJ;UC&+D
zpNX7pO^0XsvQXa*z4H81{UA8T`lj0}wW@jhCN2W-#tIKK8QdvZHw8VyexkKXX<CHl
z7}l(ThJ3^e->R|VDK<ywP*rRxiVU{nY!%5|F|XS$(D=%ei#etF3!RNW70WWmG{V(M
zPe7;6oiW(d^N#J*@}&Ip_p}<;<jL~OsmrkPDu5VY_<{F*_xaO7R&`;CPmU$E0Zu$s
zPv{Lp&&%Mj#AnB^bx5u@@7Paw@--Q*a7I8ij-Yo9|KLciZm$rRg4pzJHaT|!PCY|z
z+nb(5ui;MU3|?>BU!!5HBH;#Y)}>E=&+<JQ)lyz6^%s$z6{eV3xSf~B^9@`I<B4y2
zD3WD$_N8JBo1F2=CxJ1su%)k0-gChCJTE_A1n|KP8)=sd-=iOPu=iX&mc%b~Jc~O>
z7c1nNK`Mimh%MtKEo{^`#)sCXXE3TNK!6fmhe>i}pBFE+WP1R~VE@CL4{aNB3P!~z
zovKnXifLz_(YBypsEbDPp3*|AD=Pgat-6n(69WVxI4O9@k}JA}L{qBW{tq?!^3TaL
zX)7tkXT%AOrIZ@bCy}Eno8wzluD^bD)$cCvlpw@U0EiUzk%pzhM01qy0gZr1=G}ql
zvzouy_D9egZ=ppcOM-t<J3@$9LE@)qWn@v&sy@saMFQNPGK6{tV2j+;CH17+uT=Dn
zZMM95G)7-L`o%J!J_i*j|E|gN@JK;7TF!iIMZ!x(_t)$AtUAwEL1cb&JSpHubdyvF
z-aHde^nn#v;hzfBA0nIg-!`Vny~hZJC)efZBfxL!R4k}|97>M1yQt#aiPq7gPeP+A
z--;_WpGHa&4G1=H^?i}yOEnmddh0WIXnB3-CMRB9o^f_wZF^ISZeWc8sv=?%4Uz*Q
z{{9L5kKy{`f+u{liV=bTTsvx#@R$=o=!uWM87?@_zz$#HlK<dkO7;}f02gX0)KJ^|
ztdTFqQ;P|xOFgkY=Hdq4;+s%DX1mt}777c)Myqe?8A44=LBDh2k1pg@h@MCj=)iBn
z9hR?rqOqdBp<!$yA{@?11F*xqBDxnxcT#%CI!jGK!SeFXsstoHcQ`ID73-!!^ZP>%
zCt=Q(YriZ*?AWoVcCYLGfZN?xW(vh%k5vgjV0519uXv~l?2w~xRv+v2<-hpJa&b9%
zZKS{djmvgiS|u~q8`VI#Wz>>9`vJM`Gn1p){oZZP515>xN@V<e`P(Ce16Id<eZw0H
zLI^*I)$Ql^Pu9KE`Q8%^fS&^S{y7L;Zx~56BQ}k0y{s<hjg1LS8{O=G0RoUG-h*sr
z{^%hPNBiPg?1j@+Hj@efKXCfY8Gbso-_<HmtV{T9enGfz9AJSW2x>9@HYOIJNY?k#
zPB^v_H3HstKF=lX;hP`RVfub&6i<bE+%_DZc=#;CaEMb5p%2*RBQr=$EU3V8{$l3k
z!HGNKx#sj`f+YTR=9qo}X&D9u)n3^i_lTv)KpD7H9mm~jY;0WUPY1d4bC<VQypos-
zpCa)zC`b*pomcq-!uh$`R_=8F!2-}9@3#R1d5$aVZTp!VPeq{h_AWzdL_U1eRq0^s
z?U3aOW~EOMRc6NRn{9-cgNX1KKd!sOkn<QpaejM$(8;Kt%sFf_e6bHw`cxs>k$knF
zZJ>Rz*Fp(AVi*2|aN!kx95G!0#IXF&I}T0Gj;}%f&9)(+*!N?-0j<&;MoYhu1f9-X
zdL7diJgoHKrmE;xdIhqnGta~UTj-5D=F=wRZqzK>vah;(dMIjKB@F4&TqJ-16VzS=
zzDN#0EKpUB638~<NR2+{dvp?~VvphWU55BfvckIRdTA-YR`mMi>7f$Uutv#-DH6oJ
z*7&Bp0g`nDtIb|x5+g{iM{9UCuzZ6|OiJ&KN^ZRMV@M$r&d@J>7Yk3o*+>2yT{z3B
z{~DNNb7gnaWNQ)U4k@Ki5O`q9`ws1s__Wsn0QNYi0J%RiPV3Kr9)`)j@};l*P)JN=
z9RQPC+aI4nOoJx;H@uLBHUknf<$h3M_ik6jg@!E@tSVWs&o4Q3*0cjlrqa7z3hP8i
zbDidXr8Dp(3-CnKYL(@+(Nj+&DNNhV-ON#t!m|4w-EToM$Z){R9~r!17nEEOzL1X)
z4|ah`M8n!4hJQw>+2ygFAoI9JNJ2<Rk1JwD=7)Hpz<>`ryiM{42Y<JmMi`G<*zEch
zOWom{$NWSQYzw$L54j51NlQtMVC16;>p)lIocl<j1fqo#?ha*0gj17~DW@sy15}{L
z-kX?i^zOj$@G(3!ukL5OQ&!oH^${esBbx#3kzOEk4~B;I4lB;mF!nE#2i-r`|A^1%
z7eMEjuW~BdlUVJc`4qp`zvYmspu%#ZrEycvUdMX>Hhz|LTl<b(BbDayv_eruyj;KB
z3_7gt+*n);5_aJ@!s2=Kk!%l9FIiZp=~imTG&6RlXz3t9<m@Hoy`{SYwdzZ6-o7>I
z<)g05&6H~jThZdH%+fC7*`Kt(ye#l?j_@{MgJ|X_-}G**%~_{ZxVN(*D#)qWizcO&
z{#gKT-A$^`E1&fTIBSo@FPuGl^WmSTpZv2S{<$Y^$I0Lw8FB(9kLk0^=}YIT<|?0~
zb^Cr`DQK>7J>eFh3Js966?W{(&pn4gy6>Q)qZ$2<PI7CqjSF4R%kw-+hU<81rfmo`
zjMV=GT`Qy=b)8;y_(SOOUs^!T69_c3=Urs3oq{;Z*69K>|BxJK_*|yD1|o<se>h?<
zq0eov=rh7vSO-i6wshuXEu##^ATsmVfIxKv4UHI_4`Nff5i(6#*X^X@fInyTbdhk3
zM=md8y}<l9>U!r%<*)or4DDZaVQvh2O26{n`TI3q|KLa+@aB$_7ITEV?xwaQjE#G(
zh9X9+9Jv(K>DRSey^dY$kOhFyDdsnxeTJTVxN%7BnpGf$bzeJ*@`5B#keW*@iN2IT
zs;v(R3<H{lOVCtwuD%;;3KJN)Cf}7$o5m||dAT2afaG^~K}_?A2e=0#aaAJ0W{zOg
zGS05o%OBBKme}kd-m58zlrxkd07<p$P5VIo#`Cu1ILLq0MG+!>W3uG*+3c$UPVhc#
zx1k`PRMYd>g9kLbs%oLjZ@R)h^IR}BfZ(Boa%Z4;Zt&nl<!ffl;xLtfm=?_&<Qu9-
zW7xJent*`iw$JNbV*f}Bxt-&qvwe>yT27hN_GZTOPu_==`~!wTpCzKF`r-S&YZ&HU
zHX-cU2ZEd8cxp4OQ*?%$sh6t*8%6vt!-585Ru0|R9%|kWRSycTFvrG-VIEfwD(Bnp
zdo$Oriz6}Q!@EeX-$BvFhtJGr$V`nhg67}Q54>9t+Cb-l!sUqJj9ZLYFP1{3uQAv+
zPp|c|?mW|QY@?@hX~_Oq7U08E`_(##*><n8=6%2-Rp9r^05~x;lflSJ$@Jzr%RkF*
z4ES_8oH_Dl{{}!$Xv~28>J?QcOHvsUs7CFShF9}Ejfzbss^|>!Qko~c;{4|aQL#|h
zQh)WPDF#6Rp6Zl;c^-anTnDi4+R==6^VAvFOdH|^b$GC73{~gnlb9$UzDVi*QCTEv
zc#cF{=l32zd|#egE>e28j!VGf^~0Sz&u;FYYT5fL*0|X(Hbj;QLtoC*y6mvxv;++P
z#w(UcgaaHv_10SR0`J~w=D#n1hJk3=vK&0eoH+6v4yXo;cq8FP^(@A+u~(G_^wn`h
zw|d9l4Q&h;&~&>8{QLZj#J)#`7=z9zKOiYjr4oFedHy<5;;edm7Fa%BY{^97ivE8-
z`cx?hoe7l95!AWEi}G*Tbq^jnk}cqH<B{m)zuOkYNGyqVmq{|p?nz~587z5Hi3T#u
z8I<Vgv<Vc+0>~O|n;_bvX0e~qc>&SS=ZT}aswgz3r5CmQ^3TDA@tPrAnQjX3P9bv<
zA`#~bdZ%*i8g)8E!i7jgc8HOLVU4HW6@GYQXe{hC0?czEir8AB7m)bizNZyEpo4SM
z<BqJ~xGo?dAY$|Pq3~oeAg#&9{sanZE_Z>Z$i=Kwe|izhqy0+HldKH>29Z7upAkI?
znP}tQ#;E(iq*f4*v10K@<^BE}r<7^+p9opO`e)W(g$;cQMMFX`8Y@FeypoM`3|=5h
z!^`M~1dFoq$_<TBD5@;bKl&Z0YO=*?(7Vn2<p0716egIGhu$3v=aB|`pSmg+&>;t-
zPps0n%DSW6f8UlPnP}gk#vCyaKX;*dw1A^Rq!tO0$M-I|d;{o^xeq<h4^R}GkD=g_
ze(=MIh=K--A%65mFpQUoJ~1cove1c>^EnnrdH%keT}&%*bS`vP&CEE<UA+yL-s6mO
z@$~@2gtnR2@J$`{KHH(0M^D0W)gWx?LS+5utQ!pvF8$_2YAb+338s|Pnh)@`Nb3!z
zBNZJGB{Vw@(pDz*6n|fYpbEc9v6aHUI&wBdgB{K#4;P}1GMQp-ux+O<wW3$0&jW1i
z>uFYx0;h{(Abduq4}*6!CP|%$U8lYWXycG@oVg1C!SV*-qv!f;kBWZoGnuS)OUa*t
zcUye()bAXErJlz#ng-PNno9t+?#CQNlhTD|+wSW9Uq4iFkLG#KGQlnif`OWs{9OJ|
zW)TUh1aAwc^ihUJM)ME>$us@|sVKHAT}1=X)8!DkAW!)OG->a$Tt%PPJ`VbMnR#%}
z#A<vhhb@Ivsf8Cs9sF{FFWt==*HZ7xS1pjY#?nLNqeerY2M*(axyH)2nt?)LyRhX&
z%VwVsk7YHxKVP~|%XZwK<Gi}34?Ghb{Rn#f*9-i|vh{E30uYiJ4#y_myMBiBFX`5e
zzZlekWUu@R06tZE>AicS>fc{m>V$+m4d`5l5Y?yMSVHqXROFXPG|yGQgI$X@ffQ{V
zC5j#gEDEu<M0+ND&)`x3uqmUVNv52jg2ZgkFD~;66<w)SdfW^`Y$049R8C?Xo!b(2
zfZ<NX5@a9P#T4{=qvw{^$-g-q93x|py#d>0WdXQLEFwdT?y$`oZ6ib@SV<hNY{cV^
zVp5<VF`6NtQmNqiN<DKE4v|k1vfXQ1bgK0<FCcyq_W!%tgh@0I%Im258FovBi7k;(
zzB_Y+pZ6@5BYCO;D-wjCZ6&3X$Hz(cg5iLXe6|A3XQ-#n!?+&9B7VK|Nxq<|RBwjl
zmhfD73?y)eZI<jz?P(8mUXT+Dcsw@Gr8;Ygy83%VPfHs)0DxB>)7jHAK(EK)bQPUA
z7YYh_<!75*iatT%+3N@78je?gSe!oXyuI|=AMFE0J`S;$RQHkLRF{WSz|ilE{8q5v
z-ALrb?lBD3MUxa%x@9t@G|bJ-<<KkivV~SEc)ih{m@+_WXh=}5cyg@ne1Y$>f%@(_
zGiySIY30!0Weps-Go9sD?Dx@Qny_dj^5iW_`KqC$7{n#mWNKGw2a+C5-oNF+0%_&K
z$OypaaB+!yV5DxdO-lLW(D-2DIC=io78-c?$6bTG+Ws9<1!w@4-Rw9E!CreR2r2~l
zsDBHUC*c?cMubCW(wgGgLkK>z-@SWh7&Z2%yL<@{IbsJfL_xB-I<yD$om*QM^<2u@
z|1+itileyA(#R6ko{YR(N!2Ai6iKCLkW3wCdv0EyFt`NgW+|pDJ=_uFeV%ko^Y5Om
zMtXg|uY9_$sY6XB$Vy;r3#Y>qfVwW_AgRZBDM$Qlz5d5%7r4WS_wau&CU|%ZFA9D4
z<y@ALEA$;0`U4Iy$yHsT0TKrvn`D0PSm!c2;KCTNc?Ej7A}X%{+`^Q_dfoy#Z`A3N
zcv0XcaFSIyq;dipA)8TucB0JR1^JcpPKm=*DH(B#n&5d`A7+5OHN!SVwH|@*K&eUV
zpIZ?=d<q0Kv$F-D5Qu)c_zWqEpy^=$wa2}9&*p}<v6rhD|Eii&OM7R?^6vrHhMrQ`
zABj42(YHN)I%@)W)n8SEt6R?0_v*qy>H5w3+#(T5rP=+uBK&)_^BL6NL-r_fT=cv`
z-PEbI{1E7&T!H;a&Aoj#IETkEeCW-aH~f;4rq@zZ;*F|CBbWs^)o&rXFV~{u=-0Py
z+B%o-47O2OyyoSCg-u`O?B}RR-|7=GDAS{lAiqJu7-^3{UBY7S`Z@nhNEZ4)A^Osq
zts+zDC8VFti<w8Och1bt4qaUW%8X$g`H{gxPtyx?U;jolr|J-K7TcyLPl+&!aLvp?
zWjhx{sZi@VYn8}-C-Mynt~KYa%*`_)O4gEmzQp@!B+O&(YCb~Ll>~O@4<_9VOQ?=m
zQ*k{3T!;mn|JGi+*dc_<2M_>Wh)<hv;R?68phmyD{Ge#Aaj~%C^eCO`R)&|B+el(X
zq@{PxNu<U=pR9hVNBP1jm4OHZT=)Fj<7|39-Cj~U70l7!D`~eTzk@ncVNI&p$=y<f
z8s4qzw2$N-e6v1P&4Lj6Q`_jin2l^D`$l?A{U{H_H&i(*?*$WX6-@tp4z&U|5Zlp+
zlNJ!@@_laq#M|;7e^=dUD>*vFDI(}eW<o_`03MoEK7WPz%;!F;8y8)+ATgVN)(^8(
z{bWRv_NEyubYAY5uW6x7nRTGjWC(;in%xa!d=ujymnW6$L}l6euzvJQx`bzg!(rT>
z$_g)eF%mGuDa<A>s&8l1K_$NzbefK^DlM00yFwXeA<yBM6iEBpvnhDHo?X}tNAyo~
zMA~Kdw!iy;=Z@$=a00Qjz&g~CbCL2XqP@k=kf3n_n0p9zTd?UaOnNN{lPE!w7C)*Z
zHr>}zjU3=0Y01pj0r*YNexzTLYV8ANe<uf2SE@S(Ic4WQfttCvZEfefT~O0xtHM^K
zj;Q<~02wYX2o7|eAI<Yh9eK0KJ^&{kEL1%Q+}wHSw8;ZS3knIxBgUKF!bC?d+`THv
zsS1UTd0=4QKm-_}`-VfVmbv+P)^zUBS_Qw4@9+-J0c~=8d|InbKTPl5f_0^ZB$liY
z1U%e^hTQSc`Di)6JE}{sg9V;|M5%ih_WS`9neP`WuQq56gPdj1_q+E01fqB<;-n)k
zvW2|8ua6v`;5q*JVs=<o9wH$$YV9BazASQ27a&rsDhTXm-GukPwNaQvl(py)H7hi$
z<l^A&exG&cm&vX;d11&$uOKKYVZ*U{26|lKr7G|>+|4UQXWeyX8$w?o@+t^W6ppRl
zvG~J-{Q;zTw=xBuQAl4ZQ^Dswc7F%vg>`qGB$i?}5^fd3kn_Y-xyguc?;Q3;%NJ{U
zxEOg|6y36VX}@;!C0`j+{U{F-aTZKLyxb`TLInY_D!<n|+)ox8&<C)=$y0EjKKB6)
zaql=RMYqG>yMkPYNSTEHnzUBb9L?#sjlmwaO<^^xr6O_bZAjisD3A%5ZHrmb@J9M)
zTE=j^Uf7P;(47R>71AiBq2JgpsPQ1EWGHTew(lfXhCnpu`T6-Jqy@VtzJuJVey#dE
ze3u+T#@+5mf)C=$dhb!gW4>dKy>w2Z8O2ct-yGcL2q9WC(hdA*#_z14<%r0E+;4uj
z<`?jLz9TH=10-@D(y{!S!=BvTVTfuG?DCtW#t=yRCvoRhC(@SmYLjSEEZfyM$7cdV
z-&FTHL<MIGp_miL*gg5yW|j>9Dy9P{1O8}XMxu}3#!p6a{ypK*0wm%XnFP7vnz2z3
zF_L?%RiC#am*B*%c($<mCA5@p1qQ%5C}=#%tyJOpdy7Ej)a1r-@1#%hDzv)gkBLA-
z82?jFFpd5Au(lcMg#TW4hr<h-QrF+zlInw=V)!GxJ%4a@D+V1Q7?N<Lh-sX`InHwu
zHrgNG)Sdbfxm_Rb?O_L1yi2Vm(SF=#U+`75wd*v+sioY=@L*Q3CHf89hoI_KbG_>m
zRHRPkd^Q@eLX|@qxlXk0KHVsa1S^du)=unf1z-UeBl{ZIK=#Gh$Y8SbRu~1H!-tV1
z$t4VDhvBt4un(VSnvLh3_H+43>$3j-+=X3!j|^@rMH%wSS}3HAR(3<@PEXeJ6%P{g
zx`ANg$$>8604zG;LpfvBCupyG(tLr)-&6l%_~LDAf2o`EN<a8LFxD!bjtuPVK64(q
zObqY997mSPGAI4OKf}5yj9=wyC0Yvur}ULsg?bg|3`46liJ)%R`%pPpXoN}~o47E=
z1WyEi0Dn$)hZ#@D`$9Q_beQePhezkE5xG$pyWE1&PT*t1twn^cRwT#Obt`pSXzufv
zWXN@^CQ<!K49loCdiFWw7GiTM^>?E9J;vm^jeO`aQgqaIW1<YlQlGC^TDnba2_;sA
z$V@VtY(QV0ZKgfUEH<w;ij9sdxl3`oMCPi8n_GV1ExZJTfaS^j8}@`B3X{)#$7}6`
zwmzKP+^wMajnq&UygHd{0+J-$r|H;}&$lBct>0>QQS@@XNu1E3P&@*cDS+|&EfR>x
zeZe=pJ1ooQGyj!ou&dlQ8s;&;z5`Hqu2$A!n)0fm);mRf+!cOu4;6bXnV3w5)&kO$
zEt(@-sbtU;L_hfriW!8Or<zA?om?&7ST|+}Ct)knt`n~JP;12!ClomK!l%3Uw@L5v
zdSFkP#^MKUDCt<l?p0EqeOPh@&psmqZS^n4A=Py!-yX9ve$=7Y`sJfo;v$W)?LB@C
ztJhEmI&eeh2^|_=Y+XRm3VOpfBHb@^Nuo|#JkFBiL_(80_c4wu&Q0|z1j{O>_lmw_
z(sif0VsmrD5-`3h-iIn4OsPeaa|DZs8Xx|qlkYtG;v(-zc6<61(766H<mSh<DQ;<$
zDW9XzACqO4thvFzLhf`&+jX52m8HE!TAb=jx-RI^(j8I3$^7{6V`B49Yq~j_@ML)$
zeGp}h&Q)HQGScx~0?pWI23%!^PvPkQ8s$n*8BG|>7}M+i%32&}{EJd#I)J8KdR@3?
zhmx<2G6nkI8u>Mjj_#vtpok<N(frFK2~AE%8YgsQX6p9uc!eyw4$9=1YUu_S<Bbq{
zW`i;O%b@YNOHe??N{zo*Yw;<^C)M;2SLNm=eew9h{D-edDk!1GJt*3`yyT4eNi$hp
z*1{t2*7nt31iw*}4Xn!7S``nx=ZpeB{a*VH)}tLS{(Hl&M9k{;c*MdoQ2g&py+HB{
zcH-`!_JQ#zW9KIRiL^2*vk}&m5Gy<w=WS2O7BYtPmgFj2pMBy~fSf;q9)$QY8iv9;
zTFw(WeOh?3OEp*<rl18g+JWGOaY<&BZ5}_(XIdqfKdiWT?bzySU3MOWHbIXuqo|)_
z0v;>$J@#j}#U~C-zgeS1kpy9zu7@|8cs55<#e!dR8~Q?iR!ZZybdt!lspDD~+*Hge
z69O|RP{|l_eMVG!@CfVvLt)aH4lV^6+#kL(q<qoVM@aNN`PrX|3{ZL0w6+J#7MJ)E
zNOy7ZJ={@E<7%xMxR(C-1`O#)xp?6N=nmaFaPC}nnH%?MJt@^IcnNbtvo}R&7|o44
zN*_nHTzplZJ_3i<z|~_e+<J1tv+tV}x7b}+U%mQC!u*6i9&fzS**OA}%VxkG3cq;q
zI5l!id;c|oVhvwkq3tijhKOh7z>|@h+ZJRH#6y}Ny|E1a9|ct026b$#Nz5JfVRVnX
zu}ffvK1sJ9ZMI{ROFCPKJ3#mo3aS^WMi}QROE&6wgSzv~wou0?m5CZ-Rf77f)Pk&D
zH!PdcI(%=x>cp7LR--k{lPjJyd{bdSe6U8n&sq4-Gr7r6KMUwLm#es5%n@`<rTGc;
z%GYkYUI<Zqd@nhPMUS2SG*UV`YA?}r0$sh6oEJjwMthrQjzqK5UWNu6@d{l$^-jn1
ze5_54SKgY9SLXnE_>Ys1==0aRYgnk)@-Cg_v*#lBLzCe$@Y>ay*V>-8A69NV5+1Vi
zlF5|#(~8IFGgO#uT1tl7K6LxS)=fx#hmoh9am-fGrY6z*C19^XBP{cyaHoL&ek=uM
zEk^;T&L!rWWzp5d=#*p3(e%S|PKi%D>mWG8;^VbxUAjubX{l@`G=FERDm{mtCW(dS
zsddjy4&99Eqc6HY)<ru0#ibmLIfWx)ZL_Zy?r~xf52%qE`{0#|_p3|1o<#X=RjS*!
zml8LLS9Vrg7q*nYYNb7#(R1PveRvYrw6-Sm?C(rD{j`^Xb-YTIZ`mG&)I6h6Zo}Dy
z^s+vsRvzN=X@8B&txr8Tzw-I9_~~{@rCDuQ$BshZ@d|IE)?4U<%v`Ccn>bdxPF{f6
z?JeYl!0|6rp-&|uFUYkd+`Pp&N8?P%`d6q7Nyo0Dl3I8+@kvZbq=z|)%m!V=BPA+&
z#kmZvK`uEJ1Ao&DxhDU@#LR|9RZ(Pn3X{A}BbxqIaMa-4U(FpfH<G|5HoxbHM`H{%
z8u<1<O%(i7srcvR`+VwSC-$?I?2M2!5Kjj;!E}ecPnsrbY-~u?kwXUxppdB}>16;F
z2}gO?NuM><_okU<^QTZHWbo?OC0>3H_%KuNq)adIKL#aA<ROr!KZ;V6E(b*HLbdq6
z&(C|aAkgka4?g&1eCP}pZ4=8%{<OZGbEQ(T)T_>96OO3ihp~SS)}n?EgrOI>d5*9s
zViNOy{&o>xq!-`jCzDaHiq9w7Gt=KPG^!Ea7QYfXF<t-A@qv2BZl&_8*5<OZ-W7#e
z&)?7iBR^L!dSg+<C71d&#ow}08H)J9n5&s`6O^!~@t;70H7{a7F?nN9ZbV*hVZW}b
zV5K*?z947}LdxKBN!&Mog91<A+hw0XUo*HwvUuC>QM*@1fuNm*$f;Xr^X&@f17oFc
zL<E<w1F>5)qW;ZV&9wMq`-`u2au=Rtw^@f51{*57c^39+^LY2MN{QZ(<_aE^0j-8~
z{i|17lxS5lI^{UX21FTm9A(M^=N|2JDnnOnf~AX7WLnU}($9yd0d<ols5O$$Qb3&J
z_+aLDj@f}bl)KZtmuZA{I#F_D-ul=pjScyH8BxEcDT2+g4-_;PDzY2$a%A(2ZIb!^
zD8;J1niFxkGjc*C>e7B@_Q#T1=vpVK>wwsWU+n|Vg*08}fJT))&?%J<y%Z=-{vrJr
zuZK8MZN@;PtzB@tN-T9rBi)-L$p^05{ycIi@e{B6e&c6<G}bW$RYUN_=3{v0*b~_{
zm4R8)Qy=5g9(7uhy?2|*&7D6`J;o6kymnSPD>QsExZm+zv0DRUOp=fXjb=ewPct7)
z*+g4sq>-Kbpv=_7Z0A%?Muy{Rk+bwd6wN8)?L3>{J|{>c=MbPyI9C;Wa@#K;Ez0b8
z2kJ2wHXu^i=WUuI_d|lsA>GTKF9;r%2@P~Q+S~K_eAu^!TX@Uky_DLqxne%;-*@w0
zR5e&%qvpcJOooOAUZ9W-Ui<*b&|0nX(*~bw#8_6V$97&c>7!P?1P|x=jDdm;#Xy|U
zt+>Xz`28+V>ITO=?8G{)ebm9vg}_z0X$G_H)6=+_t5`I{gI#kL?bwLt(jj)O#xHhh
zR*`y4V;%Kuug=X0sgBRChYZh2gI$S)tfU(k@hRGwBZgtpN?)5HF`K{UoQt_j_0XNn
zcj;BJZqJ;a+Elt-n1%@Zo1yr-R}#~(zZw}6b9FDaaUP$@Cm#kpfm~>;Mi%;rhF)*0
z&KOPmmX7mY<6I84>7$5ODwnj+{TA44hL#5)s!>|HwnyfMWme0JudI$~_(#>sZ8U6u
z^chkOoN$W^%}g=H)$}H<s;rG^&`KWOr~6QDIk1#()VQ324P33Aeyp^1##}8{KaPdv
ziUrFWlOoQ-WSdXr5ja6fhYoENZlwLNx2@fQF1203(9Xo8o)U5w^ybN*?=0^3P0_t?
zidb6mFkAl*79j3W^Uq9)#p(#IM!G{g{Yw+|`vaZHG01bq-T4loE;DrgV!_uw8`AM@
zOFCVS@IIpwi7isebb*@9k@@l_4<wg;Sag_T9WB!?SIjs!Gjo1Vaz|yuSSOM=d;=TJ
z7g<n~y<gN2kscTqnqu(<YO{rCM~4ol?3w}bu|RE=HCC77Dfb8wkYXtu+>lA?#L@*$
z7aFG&gn#^icuFYipP@~zDfnYf5gHiC&A*+w&pqx!Xl{?Q7=Ll?VEuT@9=lIi6>B1E
zPcqgits^Y%{QB{384$_Z&hNb7%P|r-!b&|@Pa50Z&N-`U{ZiVa?W(k34Z6P}sd+Y{
z-_=-1=7Ce8%jXEM<)T0mWjfkHgN6$<`zr?bt7oCKtKcHK&AE~%6+`_rUkTgyqwbmA
zn0L2k?=cp$S$fyW=oXySnCkXBr;hc!ph%))(KQ7j`*jY3mP;?jP}}piKh!HCnNp`)
zd{tfQLXq=^Q>la<*=EKG;o<q%nlFhr*cm#$7*lN&$V^FBPb=}|OoN!E^hicJF-1F3
zjbni0X!4C5?W^Q0g3l{UrN^Yh7w&n;?f|ay79|5e`HY71tM<3u-n8A(Mj@=y*cG_^
z1PzSw%u@Egf>AkbbKJ9ztaO4NG^H5TUOHXkSRLj3LAkKH6AR;3YmY~GOjI#q{R_^n
zy{sd$wsD>6o2@aMtWAxr^i>#q2Dd(SwlcXM8k0b!nLv-Sp5uT#T85)OZk<vvmA|(G
z#DxdruV)kjFYN}aaZ92$=0q(0T&*V!rgZErS{?SKmN1X_WFdb_m{xx)iBeg%!EqE@
zkYVga$1tpVTVAsC<<1QC052g|@(bV}Q$g^T=C6<GleCex5fTu{rRNs>gcaJ9&fj^!
zccIyFPK4d1H@-B-@4Ky*8iLfma`5v*_ta~L$Uf6vA#&yeji;1eZP*yKgDzf=C5~C0
zFEQ1$tg@X=?2h=t<!>rI5jv4r(arGt*Y@adJlUL--i`Tn_Mm9br<@xn#wfohau5@G
zosyVQ(kMiby=f79aZmOD)f{B5=t6wiEijRiLNS{9dyOC+GuM<J_skzACnN5=QFR%e
z<&p>2bZF<ctmz_?LbGLv8BAgeHcl!))>xl-sQKCWW8Ot|O;$b?#%wWt_7rA7>fHC=
z6J2Y3*%I9}=T;eA|At%S#s+Orzv6PL&c$12{Z!GfF0{k;5NLWJuD^NmM~ma1a5YuN
z*<Y<Oq^YU4V8dv(|24m;CLC;&+-Y22lg~IwC<aZ-tns=$xE;#$X~E}8eDp3mX*DIm
zq3FtHGOl3IBkY6Mt(P+XBZaDOo?r5*^SsvVp(0eDy{^XWRk^_#gbHul?^HHn=c&z*
z`glzhCB%G`wWsa64Dn27!`$+1=M~qQgh1vOy$!L0gSW(kx>XWY2u}t%t82!@dLfQY
z;OLDX>UkVP5yIJ6eQwfTK1uu%A6+nCuW;$@K#pda2W?z?w<u&JV;_Ms<VzWjs@rPk
z*3K6$7M#{2Ea~#hz~##!_LE=mOC_P&(28EkrG%CqrxAvAv<-CGT*_aMuGSnBJ?<LI
zk})bpei}{r$H>S?Y=;J48nLsA6osy55|JATnjH4BYSTNrJu=qN=iv-%$70G7Zxn!}
zOOGf!>9IJeWDWKzRGbRq>6E0)p^<|3GfvXbQqH36X)aE+dNWtd@{@;>d#{tRX#UK*
zQ?uD|jVVr*l2><$f;|08{U}?#Oh%<A{ny3(yau@>=Q5RK7T_OX_=q&xJ;MYA52vUP
zjTIkJR(No^y00fT6|42~#>v<l^pjhFPGr$NKC9-8>^`wL)jh{~g6mJf=b%U#x<pHv
zOqUyrs5xUOCdmZr4=>J{2;<Nhrh?xlcdos@kjHbbn`Gij->`Q6Rf-LP*X{(-Y)Z2r
za<4A+HxKmdnc|3F>x^Vji1F6}CN04=JVHq9s~)zipnyZmMt=$W23=hF@Tzw6mcXP>
zb@$si8b`tkCeX^l0DED8blAhnX(K0&SnQiPL&htCNa`6s0hK<2sxi6O1)Z@?t{<zm
z`<ALbqESDqGoqgzHLIJ?T#Rb^mSMWbMQv=nmk}4(Z|$st&#=ApBTd#{qyG0#GM_e*
zH|ft(0~2#Yd&RO<q-(pyigLfI-DM!&Gg0)FovmY{qFpD%Z=E*_>eggR$uj;G{-9FT
zV{&`+G)KzQF|x^Xd(Yj{*Hz3}QrHQ%#*CHMyme+PUdj;Nij%0FJm2lj9L|F|>{guX
z85psPPeRYtl^9^xs^#A4@m|BrOnxMB9!kkGTIbj%y`{ZH?dMw9`eKb$S6^umhc&8P
z%r}}k@UW{#AAOo2!x*7k`*n&{|Ay2EYbRFotC=K>YD<pERedaqP?M&kP+=C$JzM%R
z{FK|=;0J74>W0TRuPUMO9|ab=^F+m|l3K84^A}@y3O81n;J`gWgR*iiX;=Rqew-=W
zPVkSF?=h(pg|&ci&x;|n(OtmCC3=*xxiOv_!6$WIQ*e_j-q0HsPBGvsR2u0FuFTrl
zWbD>H$v{pzk|dOm571CStJU|il1hm=^IHwB2gTgDM3B66wutpkUq>lZ5LuuLui?SF
z4(*Jmv-F*L8~L66>=lj}dvYDKpf>*78Z6Bjc@0{4n{j8ygi}*~Ka8=;y{!B(F@#YC
zv!Lieb#j8Fm_OEJ<X9}DSSXh7WA`0sBk;(CFR-?s*wD5`#r6pmqCa*zrqfv6Hcopj
zQkoLO-Z8v`Z#*T)Ke}mXJ4eG{uzPqB74vjk%CVX!D1&9a!$;Slj$w{)N^y^_uV`iI
zCgqF8X_>I7%3Mt&T`TV0PhX2Lw(BKkcRc2Fi}=6ExxV#REBPb+uvp6ZX!wZDGXI%+
z!F_sr@rzyjF(*4-bY9p~!Jb`HJK+p5!!_-sBhyh^MlD)u{3=P6Q)i1MjWhD@yn4B`
zUwW<j=VXdYWP<O01;vQWq;$W>y_;RQ^?T_h)>bRFXWHxf`FZ5z-fkJ7Z+Vo^Srpw1
z{`R7Oj!X#6L3v)bc=k5&Iq6zK+j-HqbmpniFRz+vYY6+vQp<!j)tK||sc<o-6gZ98
zV5SeMX|pyx98{TlHARjQ$jmp-tr4djB?P~3@LW9q^LWe5#*gFVQ(ev*!<Xsu%`km!
z_%C0uJ$W%h?c}i(#dvX3S;4x`q_><iIS<_jJu-7HH!bSCa~r>yL>Ww9Lfga`g8HoW
zrYT$JPTtF@?>hyH(mR^=1KDew?~_a_^d&C@B|LKF>bbB|@IYmY(w8&j{TG!o*`NiV
z7Ru{~zN(qD%t}8BEp&gX7pJlac${o!qa=$RlzvtFoYc$tCx=-~F7{Pk-iEUbv9qHy
zgP(xCJ~=}#X=!2%TRM3h@BFz*6>=Rx1>-{2q&yX^1)Hu1_U&<H6m*=~jy}A-c=~*s
zX_wJ!UyQr4c6nHtBz5NIY!4g0x!$w54pPTQ9DBSTy|glpPf|NkoN+EU3S=<OR~~76
zv5*w(efz-d`1Fl1X`ax@N%^&qbs8K4*772e?GF_V$~6jmR+XqiKa`7WVyR{)TCMA@
z-k2ccSxxiGWRlL0H*h$P4&KzI+a5A2h0lcu34IdJxA{H7&g2W%%`BPe8E-9z@>{u3
z_B}DZ#9KH?^`}G2gVpS!>86mf6T9(@L^{Tv)+!sAq&!SZH#@1MJ1K)!FKntuJ^7UW
ziqenIj!Y}9$r!VeRp+?H*IvFv+H@Slwx=wM(i{%^uq=j;k|idJnxsf6m>%z991wk;
z%k$^3`sZ=4doTAY5|hae2%%uETj<7Rp^wcr74$EpJinQy&Y`N6#^W~SxXht~e(Rih
zhc`U8V3~#&2%MlT>yvG3*O7LX`keTROv{hL>LW3sWT#uh`~`ZiOYKwHwr)FrFu>1h
z9EM%MTGTiY632XeX=bBuhmL;vMOCwLoP7OIOHh1-^=VQg_0!j1u!%!=jeQ^I+LXDh
z62Imz@4QtYW7hV`^Pp&Z`cj>WM`232_>AU76~^y9hkWcVbU)YwJZc8s2J3dFD2&AX
zl0BUM>?|37Mf-k61_h_IZg_uJQ&J;A;Kp&KI%XD$k$eF<x0#qu+M0DXW4P;wiyrOp
zM-&G4tA7z2;toe^ODOS)Q_|5$;Yiuz7z2lBdTAyqPdMr4UEGMWdZ)TmAk&vXRK3^D
zqi0j35D*r^NRDgqa7#5%ouiTM`NH3Hq0-8nWm=DhfJJ>3Fpf^<FJ#vwA15U<aE>)p
zfj+C8)vyR@ZETI>>8?LE0?s_{mQ*B55U#GSEQ`!4kBnex3G6?4*(U|je6nL3VUE>d
z*S|QD8#p?~H_7tU#p0bdE-A_V($MBf4;%e87)@~>f9ln-Cg$Hm8nlklG7pStVnf^6
z+eC3cV^}+>YTHGHepV;vy|lG;y`!f~kgCY0**12U3Fy_@#U3HIvTAvCPbVvHT{B5M
zD1jwC_oU{T@Zq8~QFizBa_ET+zDbu>g#9O^oTpX7v*H*RNNTjE>fzWMq49;-g`oDG
zh%PFdVj$bS@4UGh$pwPQm|UNe46zj7nvKa%zCErr$!wAKjrEIhLMcpGKM<>yUW{y|
zrpiws$jD6nA#fU>!WyaU%v$0fy)+Qxa*g^Kef)Vb?WX#it*7H=hq9S7NgpbD)bHX@
zgPvMfN~^~t%bsKk6UL;Qty^u6k&z<`lCazY%kBGLcP7ziw1+jlvTI&6iEVkH8C`g&
zwV~HR!mEP)rjosAzE`-NtHa4GvVpOsIENt_(G<lEUgzwVOHU-<w;F%Zue@^Mih%3q
zFWA-@x>>5%ycnS*w(l`vd+f7e5Y%BPHE)XxJKaTJ5UQl-?ab4yW&VR6cYi_j5@$a~
zTcVW5NUv+s%bSu$uqG^y5hdliz1ZM)UaS5yW-hk%7HYshomeudZ?#|b?iLKV&#|C8
zcClTd23Mb}(%WSh-H4u5EKcs7Z(bZ^bO5kx2xf%+dH1%<Kz{HppT}5$FH^7#^V*|r
zjl+YVe#}V+<CjM^Z5rwqa!v#R?#XC4&sVn5?KBC_(d?)cJ(nao%b}onB1?uw0h7YW
zTQ)E!(O|s@J-R-pSS#BSI|3$7BI10dNu@CZt1Ig|4_iT5!VSCua~$25nsSH>=Z5y{
zb-#A8_c-wxcUQiRv5AazluoK?PfP6cu3)0_@Hjoxn&jkS$<@(W&QwSu-I{X7)`l-m
zmQj<OM=;WuCzIu_jjgjn*0CDvm>}tpu=70Z9Gb28qg6z4vSJsFPq)3^+zh`#mmkOP
zWGoVQ3PWJ%9{MQOZ73l2Fl>ou$XC&w?5Oy%+!p1gg%FNAjE~0;qxF$|8SZa+Sfm>+
zmT9k~(6MTqmI;ZAJClWSEwDUGV+>Fz#{6CObhd+6P))^33(8<m)A&jEvL2AF;9mIh
zdb~mTW38`#&{msKb)1ePV``eV!b*4I$(WVrXy~NYWVI6wh}OvcoWvbB<7zzI#tq-a
zuReOq)?D+`V~jFp+nSDjXL;7x1}()a6Bz3%Ys<Hh_J(_%N|u<vlU{R0>3U6G$5?wr
zjGg#RX<A?lEg9Jhc*Hb4yvc$R<@G48?;GP1oF-f{{#x^G%Yj#($3}ekvS52=xWgmT
zXHDP5j>XlmRM7?#ckB1Z%U6$e*sT9qxlNXHRBvZnsx9sX<HYSQTnc&O6f;jl1cM3*
z%7mwZA~e(%y-M45DKJzB_a*%6!R5n_+JWH}n*oc(cgy3SSIZ-!6qMhZK~wP8YP4sY
z2kBwD*1p4$<sVF68gY^2QxUX94}RI{IP*+AnBpSdp}<9UYj|opPASv;`S9yxYcu)D
zZyS*biJ2ciy6&&Bpee5$n_^2+o=}_Kr!Bto>q;9v*=x+N!cJ1-?=RSk8ZnQ5vA5ja
zxXotwRQJk=&wkbPN%T|4D*@c33BL-v);4aZfB1Encph`Nn)<uTHr+{HHr~>FxiQL!
zfIl%I)mLd<u4Sy5soHghD!PxYpD!NDX?Op%^Kd6b|I5$q@6(f7FCNT2AfwDXTM+LS
z7HC11>Be1xy&e*Fgc79(_?&p*oshO0EL8r+>+`Yf3=?*!p{GlJFUGhL({Q|Y^q0Q0
zm&bWBcqDm-+fPf2CH;JhcA<OJ5D``TYH#+7L8~DceZ>-<MheH}PNKI)l~K}lF&VG!
zM3{u%4aHYXCku%do}KX$(WJHoYc75DD%7vrE5CXhM29hr(KOv>ZMGg<zONX3#V$;c
zQW5;A2{VJ^J2WGqF+{aGGkyH+XPVAqWMiah#bb39B{g;H>wir?jXwa#t&C_s_+*aa
zt(U=eOdey4N6t+<p11dmpAnbW{H;uhzfII-J2t*y$PjRo=>5K<1kro`YWPOTuV{NT
zPceN~0xpx18veEhmUp{psuAF>EzYL9pv~{*g!}8M%tPFaQNKu*MT{#Z|6eaG^+}M{
z(mlnDSTDjaFuZiVs`J#qwZIL2be$8N2fx&Kj4<;@UmUi%kT5RyKVG;ZlHli7{gdK<
zy`%5tYpNS;@}7<wYs<3#J|?AORHwt$U7e@C<0aONUM!S0vEV8#kdSZsHJ&IdCI{S6
z{W$u;!tJlK?q%FMv{xyQJ^RuWUT1Gy!pZMw0PbnmIYLf+7b5|pLN0j60r}YEiW|xP
zU&}u5K2Ap?2)_gxR$gLa;!-UV#IyaV$4UIi<41Z#5d}=br_=$b<gdE8Ec4Gp`BVB%
zG?*houn5!L->=k(-;oS{#0u-SSH?~<hGJt^dj_bB<HufO{v90~u<S<c+X3gNhee!_
zK}mE$>(|Q1%P3$X2?5eQ7syLzN5U@~|NSa=&XEAXG#AVZ`)?}vT=d~P!bdCy9^ZBC
z!f*9HW0uBh?v|Pr*#j%~4*M-n^xx+qqO3go#8A+zP#nxZ`Dx&jxj{|x2kuIUpDIZ&
zK9}EsLBkpIKc*q64jc^;ht(}-hVMMYMu>UvT=iQo2l^%8>VwUV7BHrk#Tdt={(b)|
z+KynVD0^X21z;;O%dn7sWx#CEP1pH+qsK}+Mgv$^7g(?t{^wYMBe3<O<F~*o;{S}4
zzQvVq?<IDj34YOq@yNd`E(Wn0fWbfzgm{hrnhnR_zczwqIw=u0`_F<0J^xJla{+0v
zg;4_MZNyOW*|9g$4AmsC{KN>dk?)QWpUi(Zbn4Z=6QN830+QE%ERGBS`=&P@rQeze
zTj&b9=={0#R;cKbr993*GH}_&EFJLyS06!P{G%3!Il=BeuW+c;kKge!%=3M2=M!Z@
zBolhNW_LBtA$uAz3?KVC4@kM#PD^oktQJ0)Uu94*iA5nqbU^84!RoVp74iJv`L!lN
z<R9>K-1Z2rwfUz03;k9GcocD&!HcJ*P$6rR5?`YJG_QPoVk9N_n)csil!15_gIO?A
z-6{R=v6)(WeHZX&jJfnF@U{Lv)0XBPSVUR8I#hrZOZh+B0pj#rC@uB_Ip)8&L%q)j
z(^~f-Q82C*;Qa4pgcuC->RjuEZ~ACaMHTT5hpjIW1Npo@SiB?D$mdTo6EdTj;6$-?
z%2~eakDhoL<p7qS;y`wPn`$DD|M%$tAcvSfX9E3`0jv+B>A=Ev7jyE(Q?8gBQVxc(
zD9SnT)_xyc$d&!~%v!px4k(dQaMC^fBE;|WNBs`{Rw@{=O6mSBVCw)RPA#|m7buuL
zuSrh$_n1?E;yqd#INOZ?#~A<XLj+@B0rbOS;0K%5_bBzMe|+CB>fO<dr$UUVMI2h1
zR(<bk@H+}1Tbs>qubi3$-YORyfXfeDZS>XCQHKXR4zESsBg_$lW=a;x2@1X6X~?4D
zKpEbUlu(V>&N+S0FuwzLS%ZWe%!S=w#oQh57RXQu4;p`Vp@`q;`e1|UtDtnou$|T0
zDp!BoAf}{WVRep<*gQ*8NGaQ{dQvpol_In_Qgq|lg)jZ!cYRXv;~z=u$9A;<Ke~mk
zV{t(@k9vcdw<|b)iXLUr96BtEU(_sRlC-m-<x&v_z~yh(R3@?OUm4|k^HdMt(YM_B
zj+JrN2PG2ABYS%Q^V|7lQ%#C&ncr1(Z1Vcom?gZ)LYMg{m#)L!_D@Vm$j?;=6qp;p
z%(5iUpQwAT|8fPb?ut_ulD(902B%o9(J0s%@EgPy_(N94NMzz}3YxG9)br>9ukU{O
zfzNl3!NC%3@LlKCOZ(mS`Y;run@3s4;vAOxMd_S;Ci(u<+5^$wmk;)yfIqqDJ3c)7
z)7xR&EBOo$$}}AA-Ui2!)1Z)48b)R<WAx~N>k7}_Oiy}M8YUarXeDo!(!uv{b8*Cs
z<A0v3H&H<ggCYRo%L1oj8^&mZrUat4mP_CToC65?_%P!f;Y<~9j!llq@Xq2l$a(b!
zk4?h}iWf7s`f|Brz~Z>fojI<;X7=F$*KEjqKa)TXw@TO@MITKQcJ8F7^<Hnw^Hm8B
zpj<yn&lGzj9yO>>RJSbWK8U%ZSA!gkX)t(eV|5-W48k_mcaXDR^`7f%DdItUGIH{d
zqV56pMH_6#cMcB^y|*c5M8R9LjjQqLsh2J^13U!^#rKDNHS2L(o8UPR1P4%K<o?qW
zC7RXaDGGylz6l1W{%xkZVsU=3;~t9(1}V-g5eq@Se3NqqtruZW7#}aasK16Xye=++
zIQ23J7%qK2^Y&BXrL#6gO!bAzp{A;;EfG79uWWR&l!MjUX50sitN439qSyXX@7Lut
zMK4S=Y-o_NCMhI^nAC$?sA2WO(KVr_gfbT#L<FtAf$HkfRK@Q9b<+!+s&Upqm@zzl
zGAW^G9+~cBMxiqYz(^UT|5gD@1DCgpJ}c+id*>Ln2QH?Xq4lF8`WU|1yZuPXDxAIE
z<jlpnHl$_AQQy(8ub;T&eJPFu2DCb4<ePr07m2aeyu7TvItdq;#4gZR`sScC1y5C2
zNdN#b?Omm9cAknl(YKeh9Ex|Iibem5#dLhE2I5S`O^I{IK4sQ9aAAp#ElU$uX4lc(
z9@S=l-{tqE<-CAcn{Ps7yl2PA;PzK(_rfKf7(69oKM14mI`(VWtEB!vs;&c^>h=wD
zI^~>D2ifc3Ad<*P_I9jDB_n%p8QD2xRko5Hk|N41l#+}F60#!F&_I;XkpJ_lzWRTc
z>$|?|yEx}J-uHR$=YH<zez1yY7X1Oo5pjHsY9UPDH7PY<cN?zaV{ar=d7L1&rM7Z2
zUrQtM+uRP1RtlRZu|+3lOIl&OA4RBBee_Xuth$CPYI|(P8{g|nN`H_g`I6@B2d;?S
zN8&ziJDD&~JS}xSj#p3K))!*TCSKJXA4LqPx-&sitPf3ri7vNNcHR#ET9dP1wcYwC
zj_Cy9^XJb8n6FiL#KVf)M^)5BaKB`9KC{;4@o{6xm(II}!AyuB(8M9WGh!qHBekQr
zmh%BpGeUEJA(>z=7}^A841iYPG^6jB7wP>9NF6<+>GtFg_v>BBWAM)td|bDMnp9KG
z>bauQsvMf-rD3)!h9h~@L%FxAC+y{c0{eSGjw1Artm8>!IHHx|^5+~LWRhF>FwlBs
z%86Tk|MXGO=gI&^+3nVVeMU<-bv)VfU`$#rn?@Et06*1X98p1pamv<;0Y29Al~tpk
z6LU{o^Hqu36anu+^9nVp^UYa%?}h3h#4>@9%+5$~Wx#;<HX(-e1!}m_&m(7c*9@v9
z?6kgR28clj=3Qk#OZydp1M;7Ds$&X-DaNuh?~c9g<&(L0?A3jSz&1Kg&75Z2m!Yzc
zQ{s1pQhYmwKETZEWv%6z3<%q>XW1vVkS3il_u{u6E~}3Oh_`FG;{06I+wi;58*89x
zsxjzeL7nG_2?U&7urK;j(&}QcV*9AF_wn`3Y~;M2)zZcB(`J8lkCfl5`*Fgt-S?|k
zsgo~f8Mg5p+huc`u9`n;6OZ@{JIh`Wgj;^OxlP36GT}g%0iPp5=lf7XaWFs};jhd)
zObq}6R9;_GO(O6`&(<$VG2SC`F+7tRKAcE@yyJwpBaK$1+#Xl0`@!FrX3^xqX!?O_
z8s20JnIBaB)Ql1Y06-h)Sqx=pklVqP#W|R7DiyD>B{YgN9}ejUU}APguKgGWdW}r?
z1ffXUL8Jt%0j@X;N9dJPbY*1a;*&C5)loNhZFZ(wsG{M=e)!<4+5U0XMnmp}6q(6B
zYo|I{I0lz|IeWL0NwJ6=--T6i>s!H}ey)ZI?mJ<M<DU&$ir(C+$8=aueOs(4u}NC(
z5?+z3zI=5S+T}45Gdr;S$F(^pDeN_qSmAK>4$EQsw9P_t?lMLNiYVya?Q)wLu73LD
zr_A+Zs%DPxWK=GXxhmB?c|D;!=>SVE{BSDe99}gK1fyCoqj2tZK}5e5L?(j*MRQs2
zvF)IwKMNi_dYf6q-f}t&?*NqX49}%<d`xJNI84O()>@a48AL4VF3V57nHY)ok|Y+V
zo@M^d%Krr4#+q!QG*+1LM+;ED#y+)KDr}f$OEk{IbUz>ejE%-YH-0*u%?Z6an~JyC
zGh>VtM(=3T4%>1U58t+@=fvjTxpT+XBLVc~kp~&}om{3puoADlMe!a70xgm~izYf)
z!owTTqsTnyG8nzftBat1<|2T4i#k`n;qY99BYt2d4xFH$gsA|63PE!RJ7I`=IB`(o
zJLUy*9c-)dC543DV|4;!>{2$vB=#v<oyyU*#O&=X5eyXLA!kW2(J6~L)_aP5FHX73
z(f(H23SOs@pTxwjmG(NzgXfFP?Ya&rxEjTKXDicH6R@V&tapMd-NEWr=N)GHvd}QU
zH)t*|hx^2K{j;KHN5)E2V4dt^Y-y4StB%V(`km8vwth7!1kTUAnb=F5*;LNc#KGB(
z^2fCYjc2@0rdq`Ksh7M6+t`T$v8K?l>Bg-XhRg@*7;Q9(dXb@IHBO)^<g+uov}-El
zU=Mt+$2-nLJU_Gj9_#k&xEAeaXkntC$$gkCs}p1meip83*)1MK29uMkKctH`RmTPT
z5mwDqa4$OGQ{iNAK9g3QU&;q0G|#)i%G`&yoff0#w|UZ2WC93I^c>O>P5O1`*AZw-
zA(qfgT~t~bd2e~=^^*<33&k+K*&HuJs)!1HlqL{ADjpq+UDT#b8TbgOhZz`Aao)M^
z)~{XpK*A4o?-}IFAFAAO<zQKQnpM&4uj>>NqEzHSKsHsMg(f%mT`Hs+wE-G+f%;P;
zvNIpz>l4LDlRIGH-sXRNe5XFu!eZ=ZW=6#qQub>68K#vM4?wTK3*x72F>PJ;Z<vf_
zSF5g1GOh0L0v!z;<l7$P?zvV@@EqpHm<yYeTR7qU-BQbrNTqO7i-l?*QM7-ZWSV+Z
z5}-BmBiSr#i}LaH9KDvI<z7E@x|W5m%-humZm1y$JYnX!I<@}r3W#v5;>$fVU<x}W
z(S+cZ?5SE#la=sn7mOGG0gZYlwa$i0S(==`atm^c2e!(a{(;VXM1sKWduhHU!3$I6
z_C_i!jJ`AwdxDG|IZ2Zw>X|40AajyvuXi}`7&OBVz)ATj!}t4>3C*!HJC3KEPm5!-
z;Rj=o6g`c^3#%TUTTauN;XdN7+N<!#?B*ZXkbA4<H<qV7#ZQI>Ktl)`iF=4|l-MVF
z@N!`?F5VHa1f<5av@+Hjn0<s68o5@!s*|Fcgr#LSur3LB+pAWrom752{@cum6!ZIp
z&5}-$ZJYAUZqYGps*e3YEcb1jaw=i&@XU*V0Wme-*u(A;NgFup!0OJLd)B7&G%LiT
z5dIecQLd}!1<s9);8Q|Gf2YJ|r>S_3tC!fR+<};l(xO9ccy~C5HcniGca4K5p|gE~
zi*aQQJO3gK0XaB7W`oy$MyR!a^lekO7ZZ;oYD56`g)pHr)sb|?9f0}ME@oNFScy~Y
zQl;ftXIm$XFKC@!y324!<0ip@VD@KEsA9eeQod7b<`shV#DU78tEQDX2d`OMnUs)=
zZ0@;bKSl{vIL?*AgCqXfYQ7Dkfyn*Am{UVphON=IxZMZ4Liw_3cJJY<AiO)4b{Bsr
zEa{Ghr&?-}x*0;SzkbZlQK=Kp?X(nv_JOmI`H=yRyh0X)V*a*#)L|$Hs{kdVj)lXm
zqHoB-|6xmuDzjf9cXcOzNm*@$$g)yA6^LvcP1SMY2fG6Pesrp;8J<hwn1ORoo(KRK
z(_H&KUZV%!4_0yxz6s8M010Har)uTQ7Ioa?d<B;)D_=q6p%=hcClUC5Ky-Dd`iAN)
zw0xUJ8Cw5KcwuSY(j^j!s=ou-82|<4IgqpX<h0xlKs(uGgSx-EFlGK8NU9#dE`G}J
z1rW9<lO51Mp3nhQ;l4=>+PB9PcL!7`p7^~5$t^nARJ#zE1y`O4d=vCZ2?K0bu8AA}
zmJTR?*Sp$}MvSU`bOx&q8_15LZ5~`{asn{bHhr(ZbD(DT84;$9Y!gPmBbh2DPMA`W
zqO$g*R*z@!hL6qJg|v2gbR<X(HZ5=C_k_uTqST!r9D1s3d*3}q#s-)T<D(;TQ!am~
z8`#VeQq(1{c_r;*Mo+oGf{9KbvV3MLl#^Ox`_QLRl0R`X=o)w}=^UKd0Ku6Ng^ZQ2
zUqvJ#Nd9*jrb1QFQC7dlz5Nuk6Syv$YTMx_L=XXSJBaan1f0AYv&+<KOOtmuoK<J>
zXiY8IaQ1u9*W-Dv)W6q8Dn%KOnh2pELI{Y4LzdsFvNGU-?Cm_nYONOYVgoiiA+_}<
zSnM2PPpE2P_GmNv9X!_Q2`*tu{4-|JgQ>s(=mCo1zLV<05eI*77pJ!tXD{GVa>A<4
zHBCNq`+jvuN<|S_0KoXe1hoZV&R^$(DrOV0_fBNw-ApxrY<np6(ofi7P4@IoHQr@3
z14kWryE=o{Y<2;4kggc=i42&H6uS79r2Y33NR!m-gMYxH-w;TNS5bo_CD#xkdg|8Q
z@9p2J;XpdYvi1X-N%YQ&9-^CL?iT(XP$8_oB)C2;KkN9oAfGR}gT2Oh=S4YMW(K1w
zVM;ecCv=>}(z0eE&Jo}jKH<-Lg4>5B<vv(Zwxo4WjN|kI>{RwhI;FY0;LPI)&Q9*!
z=0)nU1O4otRNeo)GSZ|a2G&&?0&p<8Il==M7DNjn=7z1bj{xG6Y?(A2&1RlnVeKE!
z4Z8e}{l6EbhKJ#6z(DB&twQ&nx_c1rZ=snWMy(iy#&@3)x3WMylnMXeJ7eq>iGrTP
za;08mNs(_suH^y><IQ#v+I(Pv6wVd|0x7^KVnU(~*?0ICdxG9>OE4BFTp~onGvB^^
z;Cvix@q-#J@iw0)7PDc4AZ)Rk@UMO{4*xDiQeh+pOyrmyz1w(d#X5xG7@t}2&;0^p
zn9oA`ejoBNK|n>`9_Q#0?fvH`IFo9(s}Ep5e$9l*k>uf~PI!(XT-84n8bUsoZrf#j
z1X|87MLM|g{r#I%N>U5B5WE6J(s#{9#Y7Ta91~sf6>&r*&!^<e9koB4JN4zi^#%W7
zO)`c_=3w8X@EIGN)+l_lSne~)YD1k8=v6~Ly*e52@%cE_V4vo%Q})-tlc;11y`i~`
zXen@dFA8N2T=!-+)_k*F+dU`B>l||{_3vW1wXYBa$tbfF>@n-ofP_=gfnCU`s&Nra
zm=LF8*Hpmze>Z-Ps_)HK9z`=Cf#$}OM{<AP_-%#x&!00O>(+aIE98sU_DX@juk$pM
zDkG56<+>nrdkyK{bvb(fCZnUyJx2qFuONm!UD!yxJ4eQUg`?n~?M0fj!XTF%WK-Ue
z!n+HY#LwQ-Gu<8tcEnkn=WYhd*YKoN(rx9=c+>wb(k!<nO+d$SW&Q=D%JFb^2vqfU
zW-Vc-q-g2<T*c8)2(UP-?5p~7xUav`m4X(?J)A&PT;tX+RF4&er26)rQ!K%G5EMEY
zI4_)lv!!hRg*Yz7;9j;({d#{NxCCDmz^;ejw|9A|P;0vb5UvJq1+6xpL>V2YEGBGe
zhGFJhRP$re!&eP<|KH2yr_j6xJN`3}ER-#-K%Dqw@_0tu2<~rDnnS+o_3X17dWFrA
zYu3=jDGVm015t;hqyE0UF5O8mCQAou-~k+BCD85KSL3AbFRyoviyyWNLFhw%jHhar
z+G!r8CcU8?0i7)$)Czwy*XTMR_<*%qIxKNSdcT5Xtq(dQ%Pi{4X+rHYw1G!<u4DLI
z(+sTOIney-LL2E*@x|e!f<G+p`lbuPkmsrc-kD@8M>K7=@<bu&L3;bwxZqef*b~{u
zT*p5QLpP8UFvQS#Xu-T8DgPZUv*@em`-VCGZjP+P79gE>O1bo$0S-YIYA%S-6%9{|
z#YV%0bS%dnz!s=Pilft-cQ>%KrZ)!!9yyemT+DNi7yd=lqTNX`$LA@AfV<|A?X)n&
z8P<*-q|X<@Au=7dS8bEQoiR;V<%Yz{;VyW*PQYI=5(q>Hex`OQ7VR_)zz_V{<YsBA
zF*t^UCiMt>0MB_w^<IT}g;{k)!U<&sHTV>~nWBs%2JH6^@EcwM8ZC{S#$VQ}QyE9g
znvDA=E-hl`#%~JaTn0p)`{w1ruh;!1e?lD`C|7cnBSQN>7oJFl6VyMC`EfvW3y?65
zz*k2%_t%|r<X@O-uZ>`P{UAeU`*0rR;er1?mCkSyf}9`t0*~B@yaS<1^C=h^56^+8
zsCb3*Fl<k6R~5JLVR#3z`P|n6(gDKIU=MwlkPly}(tBc4q`vVax59OlcRUSv*SB|M
zx6wamivwfu*H0H`pW{F%cJ+t|tN0P)?3(?w+qM@bi<p#1l%A*?6@kNU-;1dSb3(o|
z!;*Xb-z2JD&R34GcnT$;%XKxup)uLAF=QBtXUhHc?yETl+pz!Eey9K?qF3T(T$9g)
za$uVhL3FUH$ZxAfb5c&&Op%=bR-Nlp+8Bh)^W+2dlw_jKZU($dKXNO0KR1IoKJCrN
zkJr@sGlY$<Dqr>;u+}-v(w#I|CGvMi&MQ%mZ9p6w#IGVz9%qdbyD)*Sir3w_L(AHI
zm~-$*8WU6LgEOdNI5kHBI6q~meg+520iD@EC_O!m-_~OY9Ic+^X@}k+#Jg|bUmV;Y
zzNGc{;P&R5Uwn5!urJls@kz1P`y$!vvZ7W^b@I;lQ}6Cvtz!6yNF#Bdr8gTfDZDDC
zQl6J#J|IJz&r8=e4v(?a%h*~UTz-tPhE|;Jk1e%6aI!8$*Uv=%-P=cm=U+Ww8i86O
zst|I6$-5Xt%8Lif59)$J!gMH&=iMDB4n}9^zdcE%e2XA^vhF%6tDq$7l3`Yeemd!7
zTMDmDte*Wx*?-|1KeZ-1Sjp&(KSrg*lhTeo9ckYy-vw!k^eigK)^*Wii7m-IN}^=N
zX!d&K&<@-GP%DEc?&PYL$)$ajr9aaGV*ZH$UD}fnI`v9s$8R1+aq8=**BRi_s0#u8
z&?~~}<8T7Ka}jerc^bPfPp-)1i@*g2*+@;%QJ{hJt{!P5x%A|{KY`;^5`vOMdqMEt
zzx$635&+)neO|B!Ol}1q73>4}>vAOCz;SPT_DP7rS8a_5J1rSxeSq96$XSi1(%4Pl
zO0$<$kHML?s@wdxRmd$O7=k-^{9Ll|Sc8h69+)9Ljo5bD2O+IEg)sUJ)MDQBIGk}d
z2XcjeHhlpi7@SEw_48-{xlwXU2nH;4&Y~hAobFF^P`eaz!N~JTINX4uieUJy;S8)d
zP#>DZ5KU3YGbz@@L*!0;C>JB4_0MY{QZF;LFs7l{4H&irKDQ4z(dD34mJ<MVI`+g}
z#SvFm0V*8gFq?U{A1o%AX_A89K34v2aQJ#3+uy}5Ar%$BmG>cV$FIO%BMn()AhSv5
zpuiWL?b+gSQQEfM!;n8Z0l5Fvy=Q_9ZIg%ixBlOyOfah67ieR59!Qldf#`c%=6+lA
zfxPTs-!F5ckS$y&?E>$oLUm>+UsTHKJN`-P(M9y~M!_ge<a0D2s|A_O>)lLS=@{Cx
zX$or|^y29ND6~s#<yAh?eWo42!Q$y)D24rruc?&BcrN(>a@-c~a>klKfHKodSr4dA
zNl7J@QitCy;6QFx=-`Rp!cAu@X-N7DDHw6ds!)7+1#wlBS><#XyvfFR0n4KlRp{>&
zREx$U0z$9O^$Ax)^rgRFNQHl!-2#6D!g0_+ei$*hH>`csIjd;*^&*rFz_Kkf|4%Kj
zPF#E@$U(eBgE><tliFn<=3QNQ`E&~bm8rLh9wft|KGQOy_<zg96-(@bRu3`Q)si{y
znrhBX863W6r|f`?+94BWXd~7Bdr4X6RBs-eZJU^|aUZ(sWi6~U!`_}9Pi@)w6<qI(
zHgDTb1m+<FYK9i<8zcUS(fv$v$7Zq?VO|mBoL-?eO0S9S*_ZCuSnUmbf5yTgF6rXB
z=wm(Mfs?w+hzRNVr>S<@lWda3U-Q3E;<vf*P#y}c=}ZEmH@WU<-st-RllJeWnNd{H
zHug&eLs82X%jKKoqi>FvdOk^3g<RYbs9$ub`u)2eBqZ0@L!;koN7!XTOMSIh_veLV
zUVClXSsDZ8L#g1)Z&9$3`tP?;vhhTRmjFVXpncx?SpS9F@CVy=aneKqEv1WA>k`lZ
ztyX`=?dCNlC@iAdr@#E$jn^O$Qe|5u)On9vfXmr-tEK?HKXvQ%x0u1uqOo#O|D4{f
z;01#>*+Jt)C_3ven_k+-eb(X*WRRI}RHy$57-Cqk&)o^up=aP=BZDbU_f+QN9}v^o
zLp_cuf{_~gUcVBe(8%M*k8=obW&W<|EQ%_0;2kub1H(!(B(jE+X&<fN?^fB&dN4nj
zUY=)v4M@>eNas=WhPM)b{*ID{H-M2v;JL92Za4!P2iQlL$4B-ZExpNCovenC47-%`
z_M>s0$zxmZ$vYSs{dcX2T3~ESBl@Wfg8wJ5gk2}{APO{A=SfiNp|rzBs?ANfwCgm>
z&h+^g_pV%$7;eb<zva4&g(JRfY3IG1-8d=77ZCfKKGI8-ZQSM}#BC<fR3G}q{ccVj
zw7Tm90K5ox1}Lu=Xj0Gp?;6N0Rajr6>(C&IoLq@Y$Klmq^n3j<?n@^*?m!;9Tb-Ew
z2e8<1dOuJWO<w_wuArdanN%>T(;c|Hf2TUdJN<7=SjOe4L|TJdMVM38GnI9hH93(@
zvIKq?Ca>-6Ne}U1J7~1c#d=fET%G`;5wbx$bm}Pb)E9)!1x0UW-Be<fKmCH|-ylh(
z)|y;dcv*fGQi<!{<Dy!pS<aT|W|UtP1itL0P@i)6`CkfvW64wnZ*09d?9V?sBO-vR
z3%o=)(EP9R6&U_K{aN@Z2_@@n=IXb=`uzdmfmQ<fO}d~yi-`3tIVqP9Z<|$*mR`79
zD3Z)H4CVIF(c0syp^d=vN`s>rq_(9~#S2mQ{>iUR`F%e=S3)T22l(_NrO6=y%>-gp
zRFvo^T)pkxXm=}>TCw-b`D#Z?C#s8_wlD^-%oh=V06a<h1i~ZWS$xircNiB^a!Mi1
zx_M&fg7n|}@7)yz3@Cmu-t7x$e*6$#i}+UeFm!f$S{NX-$+Gh0VBhZUqAv;scg-Op
zRxA|PZvi^<DV%f28{~a3Dns|pN5x*!B6uCCeM3bq`0wH;4`JX4U>@sqWez(HNsQk3
zqe6bVg(nwu(gEEb0!S|gi{?-#G^T|<H9htQu_OgA9-0PfPJ#%iCg`K}A!v)-g*(|6
zS`RNtA1FmZpgrBod2{Xl36vBC{G{@$rP*hg7Z(p{ekEcTV2xbgoEG@$m9B0Ye{7{X
z<;72It=;ADhMAtUCoY!TT)uI!TD-QyB-~Mk7>*z^w+cjz5wI(QCarrcn<>6j2@Ph|
z_94R@vPOSiZ{gu}=!q)y#2VxCDv?*6ukolHuSm8?g1E_eBx|-$G}C(WIA%!DAgk9D
z%ESN<HTQpSbY~u6tkzC!9|c@iq4aa{c`}tUInC76QZo!tI&)`|RxOToyGcnxj+aI&
z!_GVk)fXKqo8ljS{Sytn{OD!j^d|4D{md|W3e~^EGatS$e|-8_4g#hrc&xc7Ov#A;
zT>A7{|4Ufcz7gIhDlyvzz1*0m!CdG75-BV#N6+^q2m6M7eq(rdd2`R*=QfucSX-W7
zF?+-;ypPK=_I|692E;#4=At-)7cj)z5ksuIp!f(*e`=Od{y|RrSwu9)HpsXS7#sBi
z*z>wV@B!JCLsm)rgk;vLX6e4~r>gI=?pT3&s1`t%ez4mythgS;C{pWcBb2{EE`{u{
zNk<xd@0up?bjk8Ph&AQQoacDNP_>1&SQt*B_m>ZKk;fa3YOE?lt&*3EubenXtf<>8
z8H-~-!n@N#y8cDYu{Mu`UB1=O=LCm)$Z6^Cl7iHVZYShgc=#>aS=FJ|2I`&(7OCWc
z`e6Bl)QyVf_ZTpk>X*TrJ3sMJmu%>;7F&s~zXmI5zeqG+E8w}SENagVdzpTQfQkBj
z&2M<;GrC<)c<S=&0Gn5)j`;>0w0)y0^w1wfwTqQ3l*BWWCiyV96TLM%?WiT%I9mlI
znBoOm`5=&#w@TE>1>kUs?e{X|adI&lL`8mB4DUsF3+CLIRX#KmZ()s;8Tc{P?!585
zi!ucU>Ic;lqv+dMu@w>R{O`bQt-RMnQHj1%wM(s}Xv)nUjRgt+`l-mO<Ib<7wt-AF
z5w^p$0u3R#jAJrPeIb<(;hX3PyC^&;m6C$Lb$oR+vl)-sWaBz~gp)nDs)wF`Q#3sv
z7lG5FJ6q~f9*BWX%+to$t4^vBVE6%Zb^$T9iiMW>1*e=kmXFSub_ez5A3UwQUGr3&
zS77&DuwR+o5krc(be%l<GvTvuK2#Go)7Gcl+xpFd>GI0dl4kf%AWjE5UW1%59W2d}
zf!sx)8kKn>j;-&bH++=(QK+{ZX5KHD#JMLEgoNc@o`{0wLh3X&;Q}p;wIBr);Y%}R
zOYXE~s){e%O0N5wTei`u#S9T5EVS~JHMuoeMV&wR#`v~Qxq7L|errwKHoAplI>lVE
zE}rf9_fuMZE9_osmq&QN$lat-Mu#L&p5@(-WQyQG+j}ipQemBhk|MM$NfR8h1n&iP
zLZqy82Y$0_k|%;leGRhi&+>l9$QaPx9N#{Cf}Sr`tU!PwW|d?7tlr}sm<$=;{_#nl
z`5W#Dlnzn;I?qR~8H}(;>}!qG2+*+TCBlf{Lr$_tkm8#JY>~&0U>SUHB9;2KG`0<V
zNn#)c@a+OmyN4inJIJ2~jD%=f-23V2>5vV>8_?c)n@UwIM(n6N6?hjQN+z5RoB6j8
zWFNy9{-bWF#Fif{L&F=-K*_nW-b(fjTNJ$5?P+nRzW5Q`0E=b7x+!xMT(8mCYGcT+
z>cW=2nN3sbn-WARZ2h8x3MiTeBX!X9Fwh>pCtF}7_ysH=Z2BYa@vJxZQQ0XH+=dIo
zfx;8D!?*ILy~XO3eEzjP1Q=D>l-k%d*^(hFor5@`4}sxO`!p92CX{8gMN?$L_^B`9
z5LS+r0oR&=vJb&E(|Dr7YY5s;H<ioX4*jBcQhETurvG^CbUZ}~E+;09YUz|_pNL_i
z-R#abwwetu6C(B^+#0R}2~`l3&G6yrRI)X3s?QpZ3h2JeqgtwjVr&E)eik?5=5;FV
zyE$Bj0+bV^Q?Lf)NkBNoPvIe59s>CtfYYhrHZyPzG<dt$il6!=B;`_b!%zG&m|7~>
z(@ktAq*xpnS`0Y6W9m+I*Yk~nio)9A!qIiK>3f#y`rf;VSwbz+YMGD=J`rUMBfee*
zCd+Czc?kAqFw&pWyr^+wgkP0)>^Qg6XUa<O-S-dG=kuCv!@e(7&Ok<tc$h1wjB>5o
z20bb&JXVk@3Y}SkZ8IrZ%{pW#DV2HI(-n8!M%sahO_21Qv;}AtU;ss<&J!B_9Os=V
zf3yJPLfB?~z=4+;7h&wOQmL?<>4~mi;Mja02qFb7CU;=X4)LV{T0EE=f!=r4d8)yv
zd_YuHx0!2ga|nn^Idxf;#pe43fufUOXPJ&9c>o!@x2E!>Q=)(zVGo{nZTgBwnMKtE
z`|X3~6&h4!-(`y8lJ2MVK_#=+U4<_}x)Qh!wdQ@<yDtV#_8wrAz(=7|3tt7J1V=zt
zqu8Je11PqEnuJlvz?I2<<@{EUGRqrRN4FrN(#|V-2pHSoD0qgf#9CTL+>R&!W%&27
zu<ngwuSqdP0pTjxS9gkY@2!p|%>?PO`!62Isprm<tQ2x^)K+}d8VtenlTo9>3~*a!
z`r&|S1Uu%}=%_c{y~tfZgmViD5&<-n_)DSpajtZP2No(P;(i!}a`~x)m|D7n0R26s
zm!k!xJ=FuMc^<X<{h&x4FeF-gbRH}-i69LV$BdZ-^)#zs>)Vki?BWSxKdz0OmY5AJ
zA*W&2B1hMVZLH2sd>vePExHTlcdg^t<zjS%$f+&)-8DPmNZ*5aJt<>Z9n752JXEr2
z3vPpo^y#=^t<q^iZ^7s@TG=s!sSbuPZUlJ-+!+oAWPq6wO8mUX8u*5;*&OanwRR}w
zs67(gYqzVlZfNBu&qL6G4xGpWW#)&wT%#x`;n86bmP+Zt+aBlz9@T0yvuKIGzFPqU
z-gcbUTUFyq1GSdiww_Kyp20gs?$_!CqzpM0tZcb+7YaWB#^W=+6<KZb0tnHwZ(C2$
za%qHeL%Cn0MWeWA6FtY}`U(_OzCm%M^y5NNAc+X_+(Yl4g2Rgj2We6YleJgXkFjK?
zqkE^f_5S*y(FGucWM9N}->9DEtTF0<D)yn-`eTWld#*kXx9{u_qAattnfiVKBgFU1
z!#2iYkEfJ46pnd*QROQ+<)uI0%cq-8>WE`%`-Z|Mq@GStCoKJRx+j&w4(~7f=)rdx
zWjI@-9Dv{tpm=Tgnl)cin7V{&D28+J<z$E1&HWwSHA@x>Q(R$BGNoMhF^57;2%6uM
zIL16?gFu%mElj2j-pIEG6kEuTm1_CXJ6q<0f^8<Lql7vrWTsWMl$@1L`5gxh6JxjX
zKF2t!96Jh#(cNl{H}Z#_?%F$PJR8va*=gFRuUn+Iz<peVOQ``iQ~#UMrEWtikFXi7
zXTUHV(pH$&wz{d?`Q&H)Qc!}F=k3!oLBq!|c5W7{1CO(+?<L8%!Ws|ESF?$P$suoe
zC`Q3F3o#=iq`W8Yz2_O;oEj0SaElJ^OXh3tm`F>-u+uJBFpbEK-Wk+vT>U8Fyu_dQ
z!IwMI<JjDodFAO317#U6Sr-go;hhIr!e{)kV|timCeUeB>ZSaA)6LnrYbu*$%Yex$
zJ5dOAi4mGs;$=D9H!1I*d~ekmd2(=3lv-9VvlG}f-2S(&?G^NGq!{Z4-xmY>ublt3
z7x=sAY^?-RrFvJ~k`z|RGaR(T_n7U%C+&9KCf=Hf(7CA=slB8&d>L;Srp7hq@ng$*
z7mND)&jzNwP0LKQppI5lvxe#}Z*$@4-R_JZOr!9pLaEyPx@WfI!!su}A@JWKQ(-!-
zt0wL6<x;IQn60&%ghR;*I}F3y0qEk5blUTTe%6tglTYd7#dqajUYa`1cfmURLP*1o
z3d;f@0-=`LeNU-61Rla+wA=MkhcYOvI5gY2+_X{@ihW<yeSTA|Ee2S^`_nPovl<bp
z)w>4}aYV{is9kB<LRnfgz;%A|F6mFAvxTXJqX&-fhvPScxNpY^L(cl2)RxgVs|6sD
zBhbe+km<!=dvWqN+f8vaA!AXJ(+U7zf(pK2105q!Suq!g?Q$kCN9tGROSyo3^Z5L=
zr9Jm@)(NOp2ps)uY){k~jj^eQvygqepE&r32Jww)fx%}7W&45Bm-mx@4A(v{37^cn
zmFlK2wGRHwj>G$qFE=>m1THcb=&U0b+oKr7XCRPp@Z0)+1|?MKnq+Y-sSpQ+e2uD)
z`=Rcj`$r_t#c$jc;Pwve|Dinju;_CLBg9W1c%ol3Rl<a+<MF=ZlzW$h`Pbop%bIYi
ztd|8Ihf9@q>r2JMuTldhV7E<m<;PQ6AgY!Cx#st6(G3F^yUxkP<81xGXL<E7g#78=
zuZkz3fO`W{r|?JTn=>c}u*I4u`5`8z!L2I<avS~9`&aRxb75h5`5aUk%+`BW{!_OP
zl8j*j<k@Yc$e%y{%Idj<;6&PoCS`+L`GXf8=z{;bjY~M&{XtOEIq3Iad&<hTC`pHo
z`;ePD!DGP!>u*bd__~RGdyX!KSmiw~|3wf8JBvSe5@o~)KB)Dtdh#vd9<@y1#cx7#
zu+*sHY!Vd))G24Mc*gq>v~ho)t+H+*q@B@*mw}bh`~N>EWca6$ivL5@sFNtolJH4l
z(3T@42oLZC>~E?2s!t3UdvO7?qlb|4hVjIo9xGK}#6pW8DjteL1OnW06nY)5Rj#7&
zIzXuE1ZiW9=g98=Zo>B8&Y}%?IGouMV3S5|I$fGhg;NY&B=?mX?f@zmw7u)^j}e#I
zlE5JF3J3+{D$fY@`~Re$g49W>5MG=BNT!1bTK)Gshkhq%pXW#5a3TS%D1aI~HZZ__
z^x8f-2>0=C^T)Q|U$T;*3iUfDh`uI;s?>e(LH~Y93v>_-<kWusJk7LueH~Ka!!?P(
zv-&}E&q*F7`FF6r{@w>go64qvd@;rI2wMN>$JU4_Az}Pubrq1n4lFca*-D^S%_)(i
zkKu>{&EtJYT}UvPIOb0jkp0sgRsIo&_M-#3fx+M>7K~L4llDHh*&&3%Pqcsp*z<+}
zLV*v7p}_y40})V{?FMasT~z@I|2GDxwln%U@y{EU#-KzA=qp`FK5_7WTWn!7(8=0L
zpMwq`Gks$yBs7M9-Cgu2U?f3L9qbQt(70)cqBV!=wN=y?8qrOGV5P=mNE~>Pjd%b2
z0Y3rGbR-(kOy<f)k@oKuwG^m=#P1?x7N|r(p!@wS??V^N(`DG7tYi=*wNTIn$+=2r
z!v*0i_xes!U`w4e{&mA-RnrPHK49N7fauFW4KLIXE7*N|U3cSMu{{M!I}TkjJq!E*
z;m@184;9JR@C~0p5|IA?e=y8Mh5{UP8>s_$Buo5ySuDcFcaBGt9ciqASpIm5^i~<q
zhBQBtok^w{lq6LsY9VNe#DXTj7F?BF6bLRJLd+)VBy+I{t1aucWWh}&?)9$A!Fpnm
zFEh@EODR;k?AJpw%Top2z-tKbpGI8Ho9AK2g{d7-*6^m`i95Vtx#K??h#oIt6Ow<u
zx0Y6H)z60Cp^f%H;RlkfCoG^29u*5Cu>6Oj@xi#OKzybD>XV~r;bC5{38ElDGjwA+
zb(0~c0|`=pNS4r$h-elEX5(fu(5Je;6ksjISR`?RR4e1E)lG{tRO3R_FX3pA`pMR}
zfiV@8=U~vR6YM6`lZ6)aevH<sZD~;N)&<qzPCbfu2IaTL=N&a3Z0z{8Ov0XNCbFfW
z6#zeCWXc0oF}b$^BY(O#?w4az_ucv3>~w{{aAN&)%`r4vxKcqZ@&Mq@&PSBw3<^7h
zlx(|g?>68Q?nC<>st4>2nmh98S9qvmqxQVy_wz>x^5$+=ymXUfD-Mt54Tn*vgB=EZ
z$}=H7yANcMm_gK4#C1?)@Q581HLchVBJCSORH23#Arwf{qe?g-kir(t0HTWwC42m@
zK-!{?ML`LAC)1(thc?9Uux?8@yx*=prHl7lu|oUuw!?c*11jDu3uCojI`Lp=02!oX
zcg~@?=gl5FJKycZLl)JZji)&)ZhnsHb`}T>#GzJOEshP{hn^^l0Od;u6q{K*)sY_R
zpV!OF(DG9j__~`=2TBO|{WMhzfeU2>2J0OZh&JB3c$#GEjqaMqCe%d@GfdgWCk{}t
zzHm8UU1eLLQwWI$Cd#zNQTM}MX#Hz(gzGnuEewdqrs}b?-vn?DU7NOe3~<|N@UY55
zXGdiM;Sj$#c00n-X;-_)tm~S^cPr?Cb3_$B$T9SRQ&*AOv}y(AN1)lar|)*svor*T
z6!!fHW5v4?WxVYm-PYIh#}UOPAq&94A%(Y6ILa1}bZFpuT*#783s@VsPDL-xnB(c_
z>hO|=iAoSXHWXoBoPiD*=s7!b*<PQ?MosGo*?tc3mO%JKI%>dSs$9c&sQh5Mq=WWP
z-kcZommPQkI`WY(ME+Pg%5ACJ56|kipbN0cCjQ<_M!bOsPD!w`FiJ2+0T+BF@dDH|
zO%H|9r)BIoEUud+@j|E8bS3{9ZTbQ>zxkfQrtlWeW1x&B!JB%2xj8Nv;M-w5k>Nf7
zB4mYsRkr;DN}*LDg{C>7%0zA%#{wfkf)J5@f@W*eO}Fbh7;nKUAV}_hKg490wGk%@
zmKOZliEjswH;)WIyWyik$jNyN6241@mq9piPB;A4-t9u~uRwVej#>sc7?*nTR`Cv!
ztrfi8LGG|nZ$FF~4J;lW-2%nN2TB*iwD~FKC9semA*zgl^O8gV5yMoqDzl3aZw7=$
z38HwR$tc5DM-9%2=N~feHDbjP!y`aUfT{?r7B4Qs+6#r%UwSUBkef8=jNw)|b_OPS
z>q9YgY;1R~0CgvxXdd6pcACHkFqss-GM~K1`IFQdtbna%d~N;K6%Ys>yu!XMsKtW!
z_IeBfp^|)<$Ya<Ey&~}1^S97-^TUHfldMq`eu&r&uTy}R4`5TXY=PC&a|IG(c|%l`
zCbw8JLjwp!Xzc03*wiZyT{c$pLL3!rzUbKl(DFb=&BcHBD}jsJF;&BTAxqMMk$?|A
z(~_?c<OmZ9%K4=k?CJ@OAY<j39nwqk8E-mtQs#$|K$sI^T@9gjb5^4FumT2h$aAol
z(1gnMZdnrA7`sygVBoL7JgVZKWE4aVmRL>b%aU;E;S#(L^>}9{+Tn*$?X_45g|d@&
zB&H}bY?=ZW1*Z>90u-g4!0KIcK7jb8E+pXLdP&|zCYoVD8o2+36Br8$@-g~yQg=<d
zwiZGWPLC}d=J<JgoTuNbLsjd>wv`my>)bEr@QzF4LIJ(qZIFsVQ9F6RRpB_?yBdVU
zg`H{`Az{KUYsLD<CZO6ioD&)UOj@td1J~;alGSv8$+<XN^{qxGL07#<+n#7j)u`BO
zUj(eq2s!XH$J9t1k>YtCXrTSij1i#Aiih|V(ve<}s#=AGI+&oOeOoHL(R2b{&JdMu
zcL&egA_KY~KR!Q3?WR}0IEsA}qR>}^OiCPSGhsrzB`8n%3_6NGO8O7V|FBUG`J@S%
z{i~UaiqMjv+6m7#Kv7OQ2|K2S0Fj_mgWu~@3ONp(Q0k)ZI{G>O(&vV12tkcnihIuI
z0_|(!@NRngQU_yhXf4}$RZwVvM)kN|ANR|xf=a}wt>{tEt6^A(l!_3j#_rF3R+HLt
z2}hLK<Nd1Ihtd0$$G~MZTOmG*j2oL}jGTif)C8RvA6HCwd>Fd+RK6CfRp#sHUI?9z
zpQua2-~fQ(<{7a6%6g?)p#G0~rjd9!TIN*4(Ou>>B(>}_RE%WR5+&$nO$vk~(eQm)
z$hi9b_n<Txa8W=!Wg|MVJQUy2<73D~yVe*#;Nj*@wk_YM!KS|3YUcygz!{JSNWJP-
z|Cj=CS|n`=MhWPFx}n4%dpFCc=fhX+Z&jT~Q}>c)ah0%-RsbZkPi#X;HEMT6RZ^(`
zicLw5|JX+D`1wO`(TOHWUeLLg=$$>)BBnP9%^B~7R3I#ia=JiWd8b~hoVP$D+?wS|
zq(>g#g^Q#~3D}zP`xi7JHb=qZ&<DO6q3n)hF@rY^3PFS+%7vu*(T1MpWGXCF$pwM9
zIXuE0PtU2nU0%=^A~q870rb(n#L_1QAoVcZccXgBP&x$$&uDXn@xu1KYn$1BB#5B8
z!teYjHS{Lbz~@}ky|PkUU{;?{mRqNo1+=glye+D>;(%JW?VImVx0bjrP*(uO2QvtI
z;SQ;kSR8^grTg+lp+ZrWIusBHVrqA7tkk8fou{{nFczh@2;+&I#OG4OCe-|uu1|_d
zrA!zAi01&P;cMm*7m$?#%lm7`8J;xwU6O7(oKk!FVOt4_&=Okc*cnwOHz@#D!7`sE
z-jvY-(Cb&3(^fmFeHjaDKzMC+`TR%vqK&Wx|2AkY>Q6#fFiUvj+G4-aH<|RzMgyt`
z7|}!JB&22puzz!mhqFqSy6bu*jG%y)bB?btVz!e0Ui@>P;VLyG)wo}S%pGj^q2rtD
zaHtlBkFf!IVNsq3u|Z2uNRSf4o5gJfqvpe5ewfggbnlSd7NnNKuy+;H0|EYQyjFz)
zHNc~0SETPj&`1JB-i$3`<NQ%Z463EO#1^laT->adozMa}d%)8imO}RYJ<XTpdk&{Q
zI0`~%y&nP>6;3bXkW|mf0yO;@%koZ0({GJL(TB!n60wVFC|K`4He<$I+-AQ8bAK`}
z(5b<$Crk3e-n?SgCPCl#10r9DR8o8IQ$3st!9ZDg>f^^<(969L?lJ?C(iRtp0O4^3
z+!>G?1GlLT*_!}pGL|d(X2u0E_sipDoM7uYxqF=h2}#wu3q&6D@}}Z5%~kKI_bzw<
z*t*<$R@fkGaz#rKbu{|IC(`Y4l+MDAY1o3a;}h^t?<Vft3FC0wVJ%z*j0khVDf3#`
z4`I!bP=X;+NX%x_3C21qDk|y=geW8!hT=973@;gP^~{7YwG}>cQDSpl6gFIS5^AFE
z*I&bKReqaq)ud+&6L~}v8EVgqkqT)rkog|quY}hWD$yArtC_@c2<!_;P@0p>_Xz+o
z{Nx&nP~!magedj=p#33ux<9n%!k|&fNPYmbRlT?_xRnX6^F~T=?p{g}{P86-0}}sq
zkam5Jd~Vq?vh}YC1>?L-6!fo=p_cLr*!bJBv8xK?LL@tdcz^eJAY7HsdW3*|Rwkjt
zvP^J=aX6!zw?P>{=ayOt8{xmE_cRK$Fk|r^>`)nanZIR3KMRkfMi2rn$!>r;lM)jg
zs&S}V0JLA3ixj<sB}gO&o}Yn|`<}#Z=`*lHJ>gNcb|f86qqyOYGzI8Fs1X1yg>;gU
zvp;x03!`>=^LqEQ+r-RzJ?EbAW-zL5w@%`a!G8a^|6oi+Dmpp{H-{%sehR&SfT>kF
z7E`h6f|SHalwg3aGcHuzXkI)D%0WBq;yB0PuETElFKJ`M85{hklS9|+Q&8s9G@K)|
zE51c*CFINdr<Hh$bq1v!p1rwe%R6!Kz@ge>45EiK0JxY^lX14DpV3rg2xlMei{_|f
zdYHDGR%Gcp!}hU}i>!{l7X0P?**4&lt#60B*=-KU$5x;wX^WSJKDtCr%&>thr0UUh
z$zr#KeL=AxvcEXy$nEfv<&ItqqwfZ4@9>X`ZQ#N3phzPg%V~_bH?tEEePlYat<zO6
z{|l4WZ%&LlW;e75nOCuL)8eyEszO3Kupu52uG|MZQ@%#CcOr2bKsKd88cyJ+dRbv-
zM<mfy@=>2>d<(=`+bL#!ICozhP^cLD3Xy!{o+_M+Js-6cV**GCLL+q&2zL|b8oPyi
z3U1O1a`Hn>15&#I-zR2_^I`}H(|YG2qld@G+6Fa96wX2L5FkT>s(TV^0Ip9yirCf@
zxXe^M9h-z|1Pe?+KA(j$IwVC@KY@}V222A3GI&`0F!VUBKO~tGKN-iIy9{}6e^O<Q
z2vY9>&@Pv`3X1;T^GD^Yw>xwsx_?gu&f;wwe-5(wpoj4Hys%3d@e$C=CJL&%bPznS
zb@{!_IsN50N(w<q!!d-n*asbO4WVDkZ4H_GW@^L9wrf9EMfdiDejy<a7Lh$HA~D&?
zfOA+bJ_#U<8jrq=L(`;^^LqS`kc=xWWSE=I09nLpIrW-kD~198d*+yr&|f`l78f>b
zfs^XWtM{3B{+rruh9}kkETNZ&u@_H0Q|S+RrZ?Az7YmbyS@G1hA>&LdAOIYg83BeW
zz~{;hI!9A|pEPF`QlSdm&o@pc3r$QDkrEMz4jU#RgWgyrXK8z&tK1DAfG)fHEl&hL
zP@D)jK^(eR{`3)OPoLg)Uh#z1GsY?&c+nq{_JRpXJRXpN38ck>!-|>h&CoPE34xV-
z4&{nOX#4T2@7VldSLG4d$^sy(AmB_9Y4icEzV>-mzXRfpp`hjj?8|PCK{3P|Co@bY
zU3SO|&J4tX-sV2+3_&=JL}Qf^fRO=C#oT}FoeW;ipb%85XtJ~jm^|DYnr|~=vc<7Z
z@R10L)K}ua@#if-Xx;62pKx0XEebtY6vZ2iZs@k`$3WJUhKLc^XWY#((-F}vfLmSz
zD;Q0}A!dx1Nj0t&avyz&c4F}~mTpL;392vqy%X<1v(~a6JoABVAc#f*0)K$Sd!ThI
zDtN@CE<}mw0%S>oraeI+usAXzTsFCQ3PDq(sD0#{1EK48)3i7H`FGpl;}H5>xe7<4
zZ-OeEmKQ<EW>S7oB)(@_mzRkQBc8EXEE%e}3GooPnXr%&3qxTDIS*LGF)hhx#C5=W
zHS2JZ*Mo!|S_ObhP-Vj-0gsbcI3PSW%c><ONc&7@B>YkD4?#W(P@Oe&w31+Ewbff;
z&L4DLrH`RqD^twe-q*-g8J_eNtepQFQ8jBL3=6-6*QoReOkPL5s4SmG0}q2A2QgUm
zIP_8uaXQeFZ22&NOH4TrcAjE>G+;gb=$sL1SUG<Dc<E9`4^XKw`zTXl0otgo4?6wT
zlYlT1goZADRvJ8No8*x7+z#Z4|NQ0xmNPB=E{~o1GxHg%oZ^q%39;OFzPWJUgFMOn
z@{Oy0`tKOE1f3J#TA#QyQnx(G;FQvA_#i_lbGP8Bka3}Fdp}-G20t9qWm;D8MU#~0
zAJMoIQ3V0@0+jNQ!Qks7V&5;}ZiOxHLmnwhFYWO8EkH3j0-!{Lp?Zzpu=6rdsB)BD
zsts~$$&hFK)K!0wE|j^iGMD^C^tIwXzjqJ6?DlJwZan(A-`v2VEkWFnV<6p!b6~OD
zcTtXN*RgpRpN3cG0tMa6cI)OL=D~#}R7&<jeqU6ufESct=}byT0d4yT+KjMajMd>e
zs$d_1HRnj<&u!m}8S;6aE^GB|*tvwOxyj&U@$M2Eqm%@`g!Va=E$Nh<3fwX}`SByo
z3j&+SpGpkU=C;W(G(zM-)#lheIh8ZdZWw_qg#?xYGPxd$uxyBl=sd(FpG$*YUSEON
zy%W^rjXdH<<j@#Fb(L(Fa8;_-3cvg}yj_{EALkx$KPa+m<EPg(C-V-t^gOzKLg#7M
zXt!mMr<W>SclPeSN(_B#h1%zRyb0|kx{PJn)tKXrB>mFG^2p)aA6xdD*ZAens04I5
zGdVvo-I=8x#S*t13hay^h@JW%2bVZfIiY|1=Qj`N898|n<Rf>q`*y>7xrVw1M7@t`
zW8Ux+_|&mb%TEHIrsqeJ8}H`A`Eez;kk(q}j}}1us=!emXJdwKz+bWtUb}Qg#C#?r
zDTzzPP}}Io9i?KzbGbSjqiK5Fi&MPExk%7{q8D#Ep?68vP<iBMI`fB;wW=qdete}3
zED+Yb@QiC9L<9FdS0U&sX<we%bf&!Xa{xUTfd=#g?AR$jX%2xQ6FRk>Pui7ckS5tN
zI4{jjoq*-TN;hn{F$$eWYMZXZ;$s`8oyhXuRYUB0vya^^_w43w{)D1A75eM>vSFWi
zO(bmQdc|qKd<@&lmF8m+a6Ny|t8+Xi7u>%ZU%Q9T8ox4eE5opGFaLWk_hEZszT6j(
z2{=L`T{?dYwDRuU-02(F+juF!rYC;f2oLQXP8w#KdKn~f(r2zQfQdylu)r1o_cTf1
z7f_KM87qI?x8wOl{W+nD0l)IIKQ(k7B{rUZDw73Cl5P2cA)27wo_*<&(pPN`eEZpZ
zw@mg@w>9a`Pg!lN6Z0Kj9;^*AulhtB=)(N~WW55-A)`{$a*baohShlx`j|-2IPzKZ
zGc>Q0TUua|(J2N?=VKSuiNKZlK_+&#Jx%N28<{E)jI$n<(``BahSmd~4EJkCT7E*X
zP3ASP+%k*3k*DrS`P>bR%f2QWn0rOVPRQqbQ>-1M>6hHVx=J;F=QrJMR6@54ZSEZZ
z1flC87!%pM?otSNOEj->OoK^~Y@=H_KzRkKL~uiKdB~#M;)fMK(m+J17GxxrJ<F3^
z$$&Y)=18wfC<V4yrNVN$p=D6n=_3phDvR9P^$&X)&&D_{bw79iF7fF7*+&n1f7&sP
zFV(tSJk6ShkE9FOvgL6m2om%W3R*k2{}E94sA3TP*l@iriGvd+@gpAI$PL0Uh^L@6
z(dyV-fOva@rTox-0hohfT%-rA_fXoQ4#|st`Oeop6Rvgzk34Q^<iD)iWBoRXSD84_
zM&f&N-R1_%pt;)1#FA;T+23|^65k!$5b=iW(6)&m8BTc9?+jnH6)CtRY(c$g%3p<=
z(7@{rjiS`^j-2#>6AS7_0;LbOPtQgfoO?7e_&WB&v(~X@h1k>xx#BB$?XlN3S$DH0
z)dj8%<-qW0)DoUL_N%$&SJ&A_I0-EASvxP}NclQ<=Ug<Iew??rKl@SeRqm)GT04dZ
zPh}hC+3h@1V9$K^hS|+y0n--A5p4K@Yc@8}86XCbm)3#y`JEYf59vfTOvu7i<TKG<
zRXU&zHlQSq&-Q8eIm9{x>z@J7GbFZ_UE%1E*xA)@;)f3mJ#&c+aN^EWaQWONx74!|
zu=sX=eG1XJEXf2l@wSncWWg5+&e>F)@0-Mr^zckl2&ybKaJ=gQOQF<v`#HxrD3DQ&
zuxcq;a0WXw6x7IHK6cg&TQGdh#$PZk{wCw;nEb1aSH+N96t{vYWNKH!I#J&jG;}b}
z(EpOYorj*nj%6BnAe}gLXn9px0A@@1Qgkj3&Cy}5Sp?zohjx<2D8u~F7PtQTlo}=T
zzBc!ink>n@XZ`QLbz7R;Qn$)oiw~+e+C(1~y!0YrWp%LrvtURcY2N~UQ)KRrlUjN2
zhuega7Z{=}H_*IS`GAmxAaGJ3d~%v%DDr@3Hirx&ww&^W;}lT8=>vmI$YzisVu@jH
z=EqH}c-xek+#7S3O<QYT_@8)_?>KSy!u!y}QZnvWhabOXo_{3hUz!;3Q2%@HeH6Z%
z`^=6AP@0*+_DB@Ek&agKZM8|NNCyqo8Bnf;H3%bdu<a(;TFz`*-&8U3!j!rpc(_bB
zHmS^)ohet?)gA2|j^<NVXV@+Lo%4sb!YOre$IuRe)BuMst!4Wj`)!<7>m6x$f9T<Z
z-s4K#euK(ljI6$cU3{Kf^3TY4n3_Yg`Dm|s%4;ZzA$1pO>Er3XU<mgr50Iwxo?4ME
z2{e6Bmp%gpU8IONm@YWPR2b|>oOLPhHOgkxaw6X;;ENMhR}5S`TIJQzWxjtpVV9Z~
zi*s+>;s=J}l@o?{wr~niTmJO<s1nruYOnn@=AL)YZd?Pt#r)giSDWn>&-H+xMIDjI
z(W^OII}9*G0PJdmOB*z5$t|8(>*i2Fp!%3fGGr|uAe)j2`VkKEF%7EdQp0o4d8Jtd
zv;#!mp3~pF@;bANeQgiz>G^g*Gm%8fd|2M;?41enLCnK3*^L13B6~^S?&nE1t5y`{
zDTk>oaVzqNZRJ^gd*tx4uK&4R&Tcd#9Jw+cLXe&e=Id))FkMmzmQKKmfhex4^@P!o
zZp$+)u{YJ6-j0mZ*{!iR^5?CC6=wSZ8@g-?3ZL7c&O!4-R@-~*)+~!9aVj)&$a?de
zN8E3gQZZ{o6CK;1yiShR6ppy<vCB!1#b3ui(?<XZ*BUT{(ao2y_cnv9(Of=gu4^W-
ziJgH%9n*p8P<hqG7fH68QSFKaNQ$$^fB-IyTXq8y^3&TV0$^BN^&(>7;)c7ig6>O>
z4^vHJrRG$&eaca;*!3t~GM~6(D%+n`#ZRz;o%6(18Cv)LvRYQpTxXijU6If8_(r!`
zn3e46yho0RTpkZXJr>ACM!ZYb{|rT(svpNFu@@0XTP4N?sGA{MHvz2)n%W#H^Mvmv
z41yQ??K2=3pltLli^>@$X-p^|A=qEhJz)Xo>)vNM;<#NE-&+~%P7pkC!UhG>)j6?!
zCUY9bJI$-DOS{cWVwjwJa>5VnFk5t`m9n=W+xrT;eb0z>WODv~b>dcK>y9Tpt>PNB
zx*up>oFfya9(ENxoj5>llJp*v%Z4%a;>M`oFjbe)Zfw20J}Cy*>vD1-932S^S#n2<
z8C~u>ZYpwa!`xgbQG_l%ZRv?=SsKF{>JzETcMjwViO(9w9V4D8?Y1r%?b|$<q&ED5
z?Z{h_`j+ariqO}7>4FDBp9K<J3Bf&cjV#+FJk>3w-iZI4H0p6IS^Qe~u8XRxqZ7PL
zR(ZcQP4dyp=E7>2v8%hi6txQV#TDc!=<~HUh_OmB3fvd<pqu42>Ypyw8b5dIE+?d`
z-+juUSODi+E9ZFj)s(_kI;jIp+CSc>nUhL}c=y`n9Pk(+4iIw`C9lMev<_N@MiLlx
zqga-1H1O2$+dr1k#6mGoa3*;kwTC}~qp9|XC54Kt%8Lb<D+CDtfX9<W6X2FAWeW;q
zJTmti3?}7Y>d8B|X{Y=%b@uA3o^u2H#UC4N3?!@uthvn#XM_}foE$83^WuAT^hbit
zxHqTsllOZ*xPIW|OZFF9TezE;@4d-jI&P8=-?kr25+m$I_T((B%f3n>Za6=*yLf<P
zYk)E9jf74Wa~NLF$3<y|YO>Us!hsED3F!|5b4Hx26$QK0EgqR(&<kO1VjD|j8%){g
zIl{+zW9EmgDQ&H*8K*Pv`?p&%)i!d}=wG#vc*<>PS)K$O%0o!1u=vnhR^cNzZbUdm
zLbxgbzWz-}$2zBo$3Pl#hWGf2TBU}5mP8TL;n1}KC~s|+y}J{bnPr7Nz9|;b^bHi_
zj;FMj;u_NY&BkNytEV$mx;{|kvf9HkHY#D%?a3FVdvUbe)4odMijRt!Fstb%(<X6n
zT7kNn5Cp@;@@If>4!`>}-JLuA^!NxkPf$W2%g7G$1Q!anOjTRkLW}sg84qCjdMkO!
z>Xg+)`_AM_OU^IOX1xQ8SxJ7&$8FR!gffJ5O9pFVod$Qj9hK-Rv~zy+w2i3NDR?<+
ztm)Y8XB)3Pe@;7BHx1?Q=s*`xO8L9gp7*5Pnhp>dS!69*oSy+^@gK5`PQMUJO7A<S
zL3Mr>vg;2IQ&4X-yHtV{ODFzEZ&0C_RlS-OMX9B#r)#|ZjykvHeNxQG``E}PQYmri
z{hp7Gxg)I{b$btJH$C&L|7q~-QDx}sn%#AgyKXGoz1ei2gv<xbcpC6|VPl3f9$<r{
zm8}?3)A`+=242M=9N5m43#B(mwsII$2M5OV5r`7cl0Ppm55;bUa_u=d<L-mtJiso6
z0ou2TF&Wp-kIX!XY*1q2H<@1h_KYodLs6ptr9`^^M04YUEVb{YS}xD7DcRkO;Kdb<
zT|XA3U)+cLhz}Yy0}nkAp`V2Y<p=rQ#|K!PKi4`v5;F7nWwtQ~+R-=O#hxkffCR9R
zXI|8_0Bi=A0{@Uzl4a%nUXeqfs=YWf(*HzXEV3ZtEvS)gwIAgRUS9b=@TTAH-Ho;0
zC)ZaWD4uP&U@}{JeI}^@_m%GSgm$Adu*;%tz|Al5NQOX~g_?y?J#5bTlhTv~CzvhI
z;~^BCw{^J$kHt=qvT=>zhO>$$KZ3<*mh1Pf39^ODNj@;mc+Nz@v}stm<jHs|o@;j5
zP($wJQXuX4Db}fvk3Q9Vy-3<IZFKZeMP75-l2jy}SAh4*rY&6CcUj*uK2JL*j&o@9
z{0bQYs=Cj47tA703JUZDuussz7smmECzw!oq|vV|w;BRP$kP<~UDWP$h>iKQ12$E8
zZE=M5y`xdg#_Mxq`m$c*7e|+4Ry1xdVQP=A=JYMcZ%N+!angLLD5=0AW4cfzPQeQ@
zBUHm;S2$K->4ogFU@hpN!rtJq5jK=<V?jor_>mUkkp@#1BzKH%&|_e_#|Sv=<x?ud
zGc38zLuCg#cdTX?Wdt<-^l6?1h&(oDGH1{1^<hNu>};>HbpHYP#y78y&C9zH&ToWT
zX&O+r4eiCS`}II%;shx76Qul&7Y${BT~Wmp0lP(;L|6m;ge?wppwwW$oesGyY2$a~
z%mPA@(5@wD4%9s-ZiO{^YOXG9dtROQq<r$+5zcQ~`|_ev?<uy6j$WOQS?T9kt_!a5
zS({ImG1xpc`P~*m-0sjtSM!^L^~)^jKWtgH*gYbILe(yy7gMnAt8*2iu75tCC9p}o
z4Af$yo!#sOC~X=S8XyjiHJX+{D_wL6apUG~y=lweWZL^*gcf*D6jWSl&yLWGFp7zM
zzic&?<3zqNQE9mcb&B=Vqk3YjM)6eSO^`ji%l>k|xMc`H<XPJY7`0P|a6lP$qAx(Q
zYv%!DDW`|8(zzRsgKQazAkK|eKWr~xF@i5To;S0+|Fh-_3GC5-?tqfT1@$Dbnwj<8
za36Epe79mRGBGU&`Sa10&|h9C|Lh#q8(8E;4qpHs;}<kJyx&yq+j(@VEnUJ+J>IMH
zD>Uk5Xr5%;8=iF5sE*ah?8?*Wuw_!8s->iZCace>+DYdgf@ztc!qLDy8amF|Cv75E
zM=uS1fZp@U^u@8Jz#W=QY26H*oxDn+2akWB-2(!;rX0a5Hg|4Yj~83Pi)BF)vubLP
z@~C3g1Sp)+3DS;18f@FVXFyDIrHw_j?c9=l!}&Wf)Eeo`MuU<B12AfPj&51q+}YFH
z`g3L|&u+uCfWn~MpekF>=6x_s@Qy^5TcbW03RVuDM7@Knkv5=Qy&$k81SWU&P&3y?
z&<5699ha~?7+4qjApVwz*8)VXV3vuC)r>Xkx29SC44LI?kZf*q*^->Hr|opJ>nF_y
zz9aRI2VKv<f6n=HZ^CHJCAB<wBl@uEOR=acL|Gmw^=rc4%E3#NgrWqyL!PT3{C5vd
zqT<O{YWBUyb7mBR+rHAO9NpL|Q0u67t!MtVvJ0Hp|7-8czp4JZKi8G9TuLhQRHiaT
zhHx_vnJE$}!_5>WnL{NXQ6%#`T=O;5jm+dzNf{z!D6?cJGDL*$K0eR-KF|981>YZ@
z*2=oey58?|_St8jJ-qhou-)UYA;$_Ep9O#EeVTr9&2g>fBl>%TQL-=b4mcXZ_a7U;
z_VY=h*nh_-#pl}=I9UcYJ0~sD62+XZ3{>7a^NmgZ`X1F|j~OQi$kVe$am)Gr_p<i4
zFPbqi<N2b24XU7Ab2qS-5CP+r^N8a+lo%F;Df7D5gtu{uo#xN)oDSMn-3ojwu0+)A
zUAiWHKsqSrn8Eq)g8DJqm1S1nDk}$~=dc%bau@s-Tz7e6J|l)7C5{1r;6W9}W509Y
zzV+t=5tGOzo`^nV-+M<m=5*m)VHa~{e<oOZ(&07kk0a}~F8iIgd^IB=9w4FOf^LpJ
zVpsUAi9iw}dxK!%KKC7EzrhruTaoe(oLqA|?FtpbJMFk@DkQ<H0GJrpuy5w3`g@S0
zY#A3)?Kxe<Nb>yJ_Vb^*UNH8wAv|?Casc|Fg6Zf`8~69Zo+5M6{eA@31c~?NjlRdM
zeE6}0>&#TmC+{A-`9=(^fJkZ=>r;Yj%|-=RijJL2B&1+xKWSgsH3L}ykDajEMTs@z
zGoh5=Y?uqB!mu%Cn{g)$&fI)f_J!A7TuZ}<cQiz0@;x$+@AEn>#Xf!&dlo9Cn%JHu
z6{Caa;QO}q<o4F;d8l2*L6N0tGmWeTrj*5FKP<_q5PNCZ2z`7K&OJge?^oiS#5VXT
zuJ>-WoPpf!G|d~{2)ieHDu_43`CfJq&-5I(uCR$GU3A~?aDfVUi_<EIJ@2sG7PC}_
z2F}697KMGw@>)?SSC3XnN=;u2$ymo0YMD}YZx|6qUNObN>I6%0RkE`8Qx=B{?=}r(
z!lSkB38}WFDf_?78fI9ZirH7v5O?SI4Mhk8miC1}rMp;S0@%ZR^VNRsT4yd4JX039
z#_akkK#cVom<ND}<H~Kq-qEquloykqF54+53x7P@8OvM3VtdN{%k_SC;`=a<k1-M0
zdK{mdb|Y7+j%Q*4!4PVY)hO8tTk0#YU@4#z=ihx%Jd~dM|AM9u#M}~U@^t-CQvuya
z6$|z}%R8h84!Q?6ZOf!x%{U>?J+I``6EE><_y$RIvq;_8%Q`9MwQCUlx=UEiwV9&5
z-139doBNh_25XlWQ-9P&O<cN|-PdArvWqtA{<w&$)u4%KQIAQ5{gqbJ(}%)y`&eRF
z1YgNI+$nNCd}YMBcuKOQqW6u#@e-5GXk*=+3qzh;23pDLS}d)B8Oxh#Yk}6)XIla@
zM%Fer(p8qOcWfzg4!x*k3XT($lr%<Z94MTsQ&D1ZA1(xY<gKm?aZzID4-|l1RM*th
zg%+xLvA-)^ii;h_0&{-Uaz1q+-(Pa{$-h~4wXicoezViQQP*%!UM)k;MqAsu;L@6}
zo=J6a@zsTT_9s84trf+XPBmQqdruN1ph%a3f_#20c5}cRaBt61Hd|KSxFLbXc{~9Z
zhw9a*Pv_x^gN3|G&aUE`7#R->*P?|uC99mGf?^91d*6-Rh9OyxZ{N&boGw}@dw7^@
zEN)flOUAVpZfVCz6wzL>v-1*7^JB(SgqUIONgL2&arjYQ>hXz*lAyv2z~-uPg+wVu
z2G_`3|4=>>M0frL->-dh0%@vuxxac?ZnP2C9Cbf$l4GK>D(5pcU#ep+#G6U)j6t(6
zqEyjP;z(!1(DG!GDaOuD&loFWX!}JnxqR4JSomm|xSm(+J9Ru=HnC7&F|VH8&gGDa
z%)>)$34b_cG0AJ4Z;xdJm>>i(c<GDV<D|bRFtqkL6k}rSlJW;Iv{i;pEiGCxF);}7
z_rqoQJ?DaUKYy0>ra)QIE!)(!u@R1+O5$EAcC{z!>8{!+AM3d>`|=}LdvdzsTL!dr
z*06M&*g|eftSc+feBE7{?bS=az2RgvClPqPV(;xQZ+KfrBt1<eY6%&#nS~3P?P-#&
z%wt`X%W7^JDo_AIEd;G@-Rv+J^<a;$F=sv=#nAd_+JXz#Cp!#|{%RYBqnG9CNbZY(
zYR|IO#$NBXN|N>D+Ye7<Gb;j09!CZeBurN_@c?K;WFJ7nJonOE4xrRLqnwn@N#3cJ
z)Rb68R-;aNm;UlB$VIk&*!SJt#qrOT@WU$d)zRxrM|DdGcjm?CRm`G)`Cnhy^0F@?
z<jGfh=rf1{#f<B4oh1f?Ir%;K8Cu~HYFa|-URs`D{6T7Hd~yEXZvhO1VqD=-`K;Rh
zigsbQN~XSt)N?Qa2k>96pPzpzBFB!{J^TG6^ii2*3u@^<j!2B*|BQvQ41X{MW{nQl
zAt#K3XN%D@0;dZc`l4N3U6!X=xD7?4Zxs7gNaxg~8HXj%$B8#=Oi%7r_4Aq&s{dPY
z#;E3;jHZT$4is2R!d@<`Qcz;g;&@V%BsBc+6qHufK%LG5#mEG}{0&_QbBf5Xcg`F7
z9wO}CGC7+>=;#3Z)e6;2)MK1(8JxohgRwctlj?gobqa@XIvWDP)q4cgmyr0-w#V(8
zh(nccrKY*dP{0?P+1Y{WWj4~Y7RIRPbM2RUOQ>7={DFiP1uIb2eEU?!<Pa=Dv?Xjd
z$Jah8@OhC2!_3UQn{7UM6{kEPkXhNG;{PM#0!>Qn3x~ddn&gTK<+6F^zrw?xreBwZ
zqRzZLkJcHO6bBDp&a(+8L`jKVVOyUqE+Yo*Y$MXxt(5C{8bU`}f{M&FJM-+yj*;5$
z`)SPLezTbT%2KYMc|yHZmEr!C>D93x`wPsA;}OGe(fP7R`(QY>krZQXiN@Wuu%C`M
zl|CFe6%za6WW%3)Hv7R>#sl6S;@pMS)2F72tv5;L)fJNdivzim{v7i37+N_)(A2sl
zBW4WkRS^lmW?R<YDtXn?;xZWG`Ocu4wf;xQ(W#P$$5UitpYq?Aqq*==7x+^75e_{%
z8mF(A>542w6w;)_NRwpg5mg}z3(Kp{PI30A*#<Qkh8eN2sO?|2?)fS=73yc^|Jjxn
z?slKvtUT}D*@P4_q}047AuyR~O!DS|rAr1qI>~-$iZ3{rOnp>8S>TvKYBbb&6l#sa
z&abIg)U>j44b={e_2yklciJM3Je?lyA`=W<=KesO=5vktQ6w0LegV83nJ(Rd8Q*j<
z1n4#20u~--*7EtNQvW~}|HwNRw;Bu4Z*_;Yb+er-*pI11`%T?BY%-(6RlO*Y{{eux
zxezbM#Kx{ja8FCa<bo$)nvb}dsbN^xFviBlF+dp~9vRtFa#O1(Wl0uqo#7sTP--fV
zr)DJ2X<7$0y;Q?R2I^W`Lza77&<5e!4>}ncPsJY`Y(-saQ!fG_S42bvR~707?(cZ^
zim(y}xeD>{@bDP%OUgN$M0v37Ww5;U<a|#oZZQ*YVUdWXrq%&|h0|3JlEMtCYqP@7
zcl>J~CCQ&=x+UZA?tnb-S-{ylaJSgwDy&eG4cL$RZPFtO%zb(U%TiTSoBC*|BJ*6W
zvm#C^HHpREWVr9Du3@?&)%N;ZXn~7^;*A~vXzS`v&het%ghu`_ITW7dhJjK|G|-8>
zQ(UN<sO%&6l!cGEjt=G64-~D&GmMEX=eI=js-Zv%fTyEvL5YTFQIDWSJ#sJ?q<0&G
z`q*JVTaBEVh?5M79TT(5_%LUEkKER-r<9z1du!tcG%L3SMtdWv9ifN6<TxS-Qd7o2
zl{3M6B=9^$#`%U_vge)s<RUmem@0(s86uH7m!R<V%<J`8>XUGZRB-SN9AY1joehFL
zQj3R#d@clN-QYG3xpZYwtfrF78y?^I@rRo8UAx)C+YN#atJzURqnDVZjZ~|VI$+ed
zYzU}^qDNB+cI6=j<^;%~+I94K1O;Z8tqQI_Ky7rlp|r6e-tmC;s+duM5wE=eFVbqD
z^zPf)v9yG1iBd{1<L?+is*%$>PXYpO$R&#cdlUEVQ(4BUbvvM6W{pnBAd5A?hnIVQ
zP;=iM&|adrQA2<)AnG1s_w32raU2c_j-c*YZtHPt0(|$4r<f9u20JL^wNwQq_;?%x
z$%%M?leGeifU9MO2J;7vOh7V8f$NE|o+kuNk0C2|9CMHCdU=uuZPqtfbRiS?zHwDm
zRgr<g-n^qyA&ZM1qOqZ&q17bMK@G52>aew`kt`FadpaJrr<_WFYNC&?L%dqk0Ose<
zpV?e0l7Ouyu<3fCZ-v2}x$aDr!{?^ESU7F$LG0OFChc&>zVdr}6T#nV7aHy&Z^@$s
z6uTlP|2h^|Zi;tfvVq1N2;?Hu9Li-ekC=VtpSGZu1rum}Xz5YsMUQ_0Gaf!jP(oH`
z1cNAxK$9N$eK;YG{VbMw%Mlog>){H7?smo%&~@6yH0cg_5x&VFL^*H+HHPHEv2`o{
z<sfbUQ3;^<KxKhQZk6H6BNm6yh#pX!??{!Rn}tK?6FruOM$gRbz|eig6-I<un`}$^
znAJOD-3OgEBpR~ks>K4_oC0o02Dl-cV)88LX!w9}#Vvif*~<NyyyJ3s{nypsjjTWW
zb`q8vJ5v?Ksra;X#v4zxejoA{Aex)fEpRy3yT7CHoSf*L6ND7pQb79=DSJHA&(<`n
zBIOb7W`(eKE0)U+oA(8!yu0Wv%k6Uu%Fq4j%9c_-s;jH=BVo1K+7ByBaeZdgiJcP5
zC4`ro!0sM2d`2WH?ZICZ6iiqh^)qG`lD~lfDHi~?`wF$oq__@rWNR75j=z4O8`W6H
z`>AwGfVs;~K-MpMzQ6kX(O3EjuY)o~Ah3u_r@D`v3ZhzVpUK4QJeEIxc87aTT|9BA
zT133D&!CcIB}Tn8{Ulek?_DPpo~~*$)JJoed<XL}RhXY10|{O^BHufZCpMKA&b~Js
z1sD)?ITpIo_@OespPQRoT}pT{(<86+k=w{)Tk4X05p(SZeQ+=>elJMn=33?7>T}L;
z`>pEOX2au2I2)5cC;NnH{EA?Kt^+{C*nCUR==sjIH@+?2yDgwWzjOX*@x=EvZ0V)O
z6EKJbB2mByJQ7N5H!V0Pg6Ja+-RC-AQ*=v4<Mu}J-J<TCSej5Wz^1LTT&9k(PjxdT
zlt}z)+*u~fbh|{)e+hb9<D6&XeQo5iRs`$gsOccvP_iI-<cSnzlvU8$>SK3@!LXmt
z+*%AoM_)4r>iyCCJsUESDbl;Pc5S4=?Th9+<X_@>Dk#PxrP1U8(gpA&5+?`rYtEOy
zOSSIUzN<yNG)X&9b*0q&TctRQz0W*xav}3e@%H8u0x|H@@X|K1OUiq!#bi7DS-0@X
z^@guza#jk{N_0Y7R&up#HNJE4uk=#{wHkgK<n6dUCmVB|vj$YSy3#}$nBjfJkvGu9
z2_S-0Ntz-g4imb9FjJMa&z`8~)?P};V{E*UcxKsXpz?C~0TBy)wq|64xc85WX3K>$
zf9FoQJS6^LkU<#!xKD#OAOGYJdmH*nPwMxUC5wt(%&N6i#h4Z(Ds#=3&zFc2)|!)Q
zMDk_#B+2;|Otwz&zdu)!U?>|PB0c`bzFcAW>)f0u<fWNc%bk#+q`(A;f!?;EVR48c
zBr@IJy>ZZsEcaY>I!?x~+3a^q{CDtw%IeJW<J;03&u%|;PA@2SR<k?$c8a@9w}V4|
zay4&nuD8#z;*dh=uWz53&rSBV51Gi0UJvKw;uX|8oh*`C$azF-$E%1mRAqT%s!dSv
z0b5*R7L{Q6#lzEZQB*ddXRU^&5}=hiq}Ld2<xvheG(8>92qIe+h=FV*OGW!OBoV5{
zn|^1d1=ocB3_q4$&Lw4C<#GA@Y`!frG(&LWxJQt=kge6BtSC;~p!SA}Xm%-nQ58=U
z0`^l65bz~I7Cw`YwQdR}9RW|AatN$iWmGT*)+i*B4)_eTptL9k{XA{`G(Kz?S-ODr
zu`sx%jAP)r(-VExaxr*%W<CT_oz=!N5N?=df)mxZc1!aS$BYT(;H{b_U@$_lsbgE>
z*osLZ6H>ZVFt*qEvv`o{e2I~il)N$8L<toiN;6tHT^>0(3+J8!UT|w46-8V@%3=+c
zyyol!1r#bAz&KCWLPl6mRTXoBR!)^iNJyKHpFbBIg+~QpeCX?(Fb4&LhskI@%mdY)
z`4zp}K)sL)pqxY=+lVIczU?7Kl?vJpD1^%Zj?0t_!7OYaz^Gz%x@lk*CZlkscatoo
zh0m9!BIhM;&q=ooJQPwil%m|Bxi1Eo8aC-KJ0LmZU~PEs68FNyUNk`#kTk>rEg{EY
zU)?&j=ZpVEge~oU?qq755_B&t%s)WsAdCz98BSQw_r#g~l-NkNb-<RETuL1Anb><+
z&Li{ZR(GZnx`MA#Hph4e2PjQ<LuS$gI7JSL;N_%mmOl@r!2Do61owd;w0@s>CtQ$m
zLmZn%C`Q{EFs?^UUR<+=W=6A0u9UmTX`=me6!iKmdNbpJ{u-}hFIKlcl4W<c1_PBM
zQP7=U%(})5_2D}&M?o{faEc!JAW}RLm|XE2eKLHM4S6x_r>DI0$J2$3tLT*%$4c>+
zL*p)LyRTaxj{r8q#I}IgHRM0gp1wyhHqZNE9RdNK%qPM0gjqIM){gP<aRFefR){k!
zk){0u-41>7o{OVrMEgG#nZLg;V!?v61CFq^K<Rut_*mGa#T_Vsh+n{+czXFSz0Q!x
z=bY^9qM$S9grH$XO;fqqAFVm|nNF}rynZyt9(cqD4ZPc-Y_3D3(rg*%;ZAr~`0;NH
zl#pJO#ut83?tK(lxBDk`;&{2`26<65;7W#6<-oz32l2770-(Wh(78Y4l1<@{1&Tpu
zrDBrDSaV;m6jajv=`WkZs#8$ja+&1VT}ZL=>l2!&sQkI!|9lT?1tBA_ubrcGcI&-(
z;{h)QJIGfN!LwQF))TKT3Q9(vOsY^*ob)k+&}8%=aRxD~%C^CW;=l#K!pzKDR=4yZ
zLDW{>osMMnqJ!Q6m?+B~w>IX={9T;-(1D86)(ZA`BaD1Ao@lW})cxC7b*av$YvZ+&
zfB=?L4coKE*z4Ns7U5hud%63c$)*Z|zV)3hK=J`j2B@!<T$=O-()2Ap?t=%v{#7Hy
zw~U!p40Vo&;H1*g65{VR?t8oLGOdpWgl4Rc2hqz{4#@c~5mzI&pg1C+pfFfNT?#-T
zKiP@wB47_bf!M#G+Ipc@yvPX1j~DnTFQ5sp9N<Zvkv~<W37_jkJXUAT5e0Vz8IfX>
zF0J=MbGUEa1)7L00_7^_Gsulwsi4dJAPuSq;RO*Nf+^qC;;XQ0KH3|_hQr+DG;D!v
zw3Qcctz*ht0@z*y;Z83vl1=?!atnB#F>1>U;&r16G)K@&|09IQy6#?iz{=QDIloq#
z2d&=idCs57^YF4KRL|(Iyi=Bw>sO+<`G58st&b^ch-$r@1(AJUNfb07!~m<cKbbM-
zlSwDhbZ9g~$^Tr#@2@G75*Gpem9v=#5fi>iAI$J6{S+Hyjl^jKwpKqOYH?9*Am(bN
zciPJ?`+S>`k#R+p+EFYElPGl&t^r#mfXa)ht(roiQaYK)fb{L(SuhI9C^~4URWxs^
zf@r;{{LOv7#*f8&l}zqSa&u>xoddshr9V|p0<<F-sP1S99f?%t=x8g&K^L=n5k)rF
zy^BCPMn_K{14wZz6`*{Q7#;@zLUzNcyxXXoX7(}lEaj+hnN+;6=^G!KBkCYQoc3|B
zAdyJrapn3vyu4?iqr-_h*8j4GlE7~pqgu8>0AsmWJ+!o52f4KJ&f7#mD(!5q9Y|_2
ziICnpYZ8ERg?PLt7?rP7!~i6olOa$G&8;aSV)TI~ufUo|FII>bJZXb%W2SSzmY2zC
zqfoIzxX!t0Xl?1sfPnNI_iUqi|5;xzBWk06PHkEuD^Kcm12juoIh#>H(%k^?+1#&2
zf8K94xEhF`ipukvt-$Lp8RB0Cgxim(8j&@))iI)`Ic_-Wj>7Ff>wz+{VwOt{M|#}C
zA+c9}+h<qfc%qph+oBok!?Y_;JL;Z1ey6evf`WqK^lmeu$5+?jK9uL_ALAeMOoJ~W
z(w1BA2ZSFdS~iSOt_H=4_oM?IHF9^oi+}yFEe9JnI@WyzeFJS{^y3>p=r-Y;8PdD|
z{p}tGTn8i9iIRWD^3Qkw`^bOG2hQ#P%JM(N@n0qSf4+MbcVx{L-$Z*fno+<%9SsBZ
JQdQeK{{x#R@mc@?

literal 0
HcmV?d00001


From fce8d2573664c78e3b4da19aa9c7c3ca409ce449 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Feb 2021 22:49:42 +0200
Subject: [PATCH 220/254] format readme.md

---
 cloud-static-content-hosting/README.md | 122 ++++++++++++-------------
 1 file changed, 61 insertions(+), 61 deletions(-)

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
index 0f1fb3207..87c75148a 100644
--- a/cloud-static-content-hosting/README.md
+++ b/cloud-static-content-hosting/README.md
@@ -55,13 +55,13 @@ the content globally.
 
 4. Create IAM user that has only the necessary rights for this application.
 
-* Click `Users`
-* Click `Add user`. Choose `User name` as you wish and `Access type` should be `Programmatic access`. Click `Next: Permissions`.
-* Choose `Attach existing policies directly`. Select `AmazonS3FullAccess` and `CloudFrontFullAccess`. Click `Next: Tags`.
-* No tags are necessarily needed, so just click `Next: Review`.
-* Review the presented information and if all seems good click `Create user`.
-* You are presented with `Access key ID` and `Secret access key` which you will need to complete this example, so store them safely.
-* Click `Close`.
+   * Click `Users`
+   * Click `Add user`. Choose `User name` as you wish and `Access type` should be `Programmatic access`. Click `Next: Permissions`.
+   * Choose `Attach existing policies directly`. Select `AmazonS3FullAccess` and `CloudFrontFullAccess`. Click `Next: Tags`.
+   * No tags are necessarily needed, so just click `Next: Review`.
+   * Review the presented information and if all seems good click `Create user`.
+   * You are presented with `Access key ID` and `Secret access key` which you will need to complete this example, so store them safely.
+   * Click `Close`.
 
 5. [Install AWS Command Line Interface (AWS CLI)](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html) to gain programmic access to AWS cloud.
 
@@ -69,83 +69,83 @@ the content globally.
 
 7. Create AWS S3 bucket for the web site content. Note that the S3 bucket names must be globally unique.
 
-* The syntax is `aws s3 mb <bucket name>` as described in the [instructions](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-buckets-creating)
-* For example `aws s3 mb s3://my-static-website-jh34jsjmg`
-* Verify that the bucket was successfully created with command `aws s3 ls` which list the existing buckets
+   * The syntax is `aws s3 mb <bucket name>` as described in the [instructions](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-buckets-creating)
+   * For example `aws s3 mb s3://my-static-website-jh34jsjmg`
+   * Verify that the bucket was successfully created with command `aws s3 ls` which list the existing buckets
 
 8. Configure the bucket as a web site with command `aws s3 website` as described in the [instructions](https://docs.aws.amazon.com/cli/latest/reference/s3/website.html).
 
-* E.g. `aws s3 website s3://my-static-website-jh34jsjmg --index-document index.html --error-document error.html`
+   * E.g. `aws s3 website s3://my-static-website-jh34jsjmg --index-document index.html --error-document error.html`
 
 9. Upload content to the bucket.
 
-* First create the content, at least `index.html` and `error.html` documents.
+   * First create the content, at least `index.html` and `error.html` documents.
   
-index.html
-```html
-<!doctype html>
-<head>
-    <title>My Static Web Site</title>
-</head>
-<body>
-    <h1>I'm the index.html</h1>
-</body>
-```
+    index.html
+    ```html
+    <!doctype html>
+    <head>
+        <title>My Static Web Site</title>
+    </head>
+    <body>
+        <h1>I'm the index.html</h1>
+    </body>
+    ```
 
-error.html
-```html
-<!doctype html>
-<head>
-    <title>My Static Web Site</title>
-</head>
-<body>
-    <h1>I'm the index.html</h1>
-</body>
-```
+    error.html
+    ```html
+    <!doctype html>
+    <head>
+        <title>My Static Web Site</title>
+    </head>
+    <body>
+        <h1>I'm the index.html</h1>
+    </body>
+    ```
 
-* Upload the content to your bucket as described [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy)
-* E.g. `aws s3 cp index.html s3://my-static-website-jh34jsjmg` and `aws s3 cp error.html s3://my-static-website-jh34jsjmg`
+    * Upload the content to your bucket as described [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy)
+    * E.g. `aws s3 cp index.html s3://my-static-website-jh34jsjmg` and `aws s3 cp error.html s3://my-static-website-jh34jsjmg`
 
 10. Next we need to set the bucket policy to allow read access.
 
-* Create `policy.json` with the following contents (note that you need to replace the bucket name with your own).
+    * Create `policy.json` with the following contents (note that you need to replace the bucket name with your own).
 
-```json
-{
-    "Version": "2012-10-17",
-    "Statement": [
-        {
-            "Sid": "PublicReadGetObject",
-            "Effect": "Allow",
-            "Principal": "*",
-            "Action": "s3:GetObject",
-            "Resource": "arn:aws:s3:::my-static-website-jh34jsjmg/*"
-        }
-    ]
-}
-```
+    ```json
+    {
+        "Version": "2012-10-17",
+        "Statement": [
+            {
+                "Sid": "PublicReadGetObject",
+                "Effect": "Allow",
+                "Principal": "*",
+                "Action": "s3:GetObject",
+                "Resource": "arn:aws:s3:::my-static-website-jh34jsjmg/*"
+            }
+        ]
+    }
+    ```
 
-* Set the bucket policy according to these [instructions](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-policy.html)
-* E.g. `aws s3api put-bucket-policy --bucket my-static-website-jh34jsjmg --policy file://policy.json`
+    * Set the bucket policy according to these [instructions](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-policy.html)
+    * E.g. `aws s3api put-bucket-policy --bucket my-static-website-jh34jsjmg --policy file://policy.json`
 
 11. Test the web site in your browser.
 
-* The web site URL format is `http://<bucket-name>.s3-website-<region-name>.amazonaws.com`
-* E.g. this web site was created in `eu-west-1` region with name `my-static-website-jh34jsjmg` so it can be accessed via url `http://my-static-website-jh34jsjmg.s3-website-eu-west-1.amazonaws.com`
+    * The web site URL format is `http://<bucket-name>.s3-website-<region-name>.amazonaws.com`
+    * E.g. this web site was created in `eu-west-1` region with name `my-static-website-jh34jsjmg` so it can be accessed via url `http://my-static-website-jh34jsjmg.s3-website-eu-west-1.amazonaws.com`
 
 12. Create CloudFormation distribution for the web site.
 
-* The syntax is described in [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-distribution.html)
-* E.g. the easiest way is to call `aws cloudfront create-distribution --origin-domain-name my-static-website-jh34jsjmg.s3.amazonaws.com --default-root-object index.html`
-* There's also JSON syntax e.g. `--distribution-config file://dist-config.json` to pass distribution configuration arguments in file
-* The output of the call will show you the exact distribution settings including the generated CloudFront domain name you can use for testing e.g. `d2k3xwnaqa8nqx.cloudfront.net` 
-* CloudFormation distribution deployment takes some time, but once it's completed your web site is served from data centers all around the globe!
+    * The syntax is described in [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-distribution.html)
+    * E.g. the easiest way is to call `aws cloudfront create-distribution --origin-domain-name my-static-website-jh34jsjmg.s3.amazonaws.com --default-root-object index.html`
+    * There's also JSON syntax e.g. `--distribution-config file://dist-config.json` to pass distribution configuration arguments in file
+    * The output of the call will show you the exact distribution settings including the generated CloudFront domain name you can use for testing e.g. `d2k3xwnaqa8nqx.cloudfront.net` 
+    * CloudFormation distribution deployment takes some time, but once it's completed your web site is served from data centers all around the globe!
 
 13. That's it! You have implemented a static web site with content distribution network serving it lightning fast all around the world.
 
-* To update the web site you need to update the objects in S3 bucket and invalidate the objects in the CloudFront distribution
-* To do it from AWS CLI see [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-invalidation.html)
-* Some further development you might want to do is serve the content over https and add a domain name for your site
+    * To update the web site you need to update the objects in S3 bucket and invalidate the objects in the CloudFront distribution
+    * To do it from AWS CLI see [this reference](https://docs.aws.amazon.com/cli/latest/reference/cloudfront/create-invalidation.html)
+    * Some further development you might want to do is serve the content over https and add a domain name for your site
 
 ## Applicability
 

From fc837e289f21551db3920d05b460f94f642868c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Feb 2021 23:01:05 +0200
Subject: [PATCH 221/254] format readme.md

---
 cloud-static-content-hosting/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
index 87c75148a..2851c6bed 100644
--- a/cloud-static-content-hosting/README.md
+++ b/cloud-static-content-hosting/README.md
@@ -82,6 +82,7 @@ the content globally.
    * First create the content, at least `index.html` and `error.html` documents.
   
     index.html
+
     ```html
     <!doctype html>
     <head>
@@ -93,6 +94,7 @@ the content globally.
     ```
 
     error.html
+    
     ```html
     <!doctype html>
     <head>

From d2f926e3e87a7efa8920f22f51d88ccbf192e2a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Feb 2021 23:21:49 +0200
Subject: [PATCH 222/254] format readme.md

---
 cloud-static-content-hosting/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
index 2851c6bed..a74f3ee80 100644
--- a/cloud-static-content-hosting/README.md
+++ b/cloud-static-content-hosting/README.md
@@ -83,7 +83,7 @@ the content globally.
   
     index.html
 
-    ```html
+    ```
     <!doctype html>
     <head>
         <title>My Static Web Site</title>
@@ -94,8 +94,8 @@ the content globally.
     ```
 
     error.html
-    
-    ```html
+
+    ```
     <!doctype html>
     <head>
         <title>My Static Web Site</title>

From edbea7d50b2374f7fa05b37e9ecf1a7ae43ffc92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Feb 2021 23:33:40 +0200
Subject: [PATCH 223/254] format readme.md

---
 cloud-static-content-hosting/README.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
index a74f3ee80..19c5f2352 100644
--- a/cloud-static-content-hosting/README.md
+++ b/cloud-static-content-hosting/README.md
@@ -80,10 +80,9 @@ the content globally.
 9. Upload content to the bucket.
 
    * First create the content, at least `index.html` and `error.html` documents.
-  
-    index.html
+   * index.html
 
-    ```
+    ```html
     <!doctype html>
     <head>
         <title>My Static Web Site</title>
@@ -93,9 +92,9 @@ the content globally.
     </body>
     ```
 
-    error.html
-
-    ```
+   * error.html
+    
+    ```html
     <!doctype html>
     <head>
         <title>My Static Web Site</title>

From 7c01bc7464d136ced2f22a0495e81996204a4cdd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Feb 2021 23:43:33 +0200
Subject: [PATCH 224/254] format readme.md

---
 cloud-static-content-hosting/README.md | 28 ++------------------------
 1 file changed, 2 insertions(+), 26 deletions(-)

diff --git a/cloud-static-content-hosting/README.md b/cloud-static-content-hosting/README.md
index 19c5f2352..8c6e70f41 100644
--- a/cloud-static-content-hosting/README.md
+++ b/cloud-static-content-hosting/README.md
@@ -80,32 +80,8 @@ the content globally.
 9. Upload content to the bucket.
 
    * First create the content, at least `index.html` and `error.html` documents.
-   * index.html
-
-    ```html
-    <!doctype html>
-    <head>
-        <title>My Static Web Site</title>
-    </head>
-    <body>
-        <h1>I'm the index.html</h1>
-    </body>
-    ```
-
-   * error.html
-    
-    ```html
-    <!doctype html>
-    <head>
-        <title>My Static Web Site</title>
-    </head>
-    <body>
-        <h1>I'm the index.html</h1>
-    </body>
-    ```
-
-    * Upload the content to your bucket as described [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy)
-    * E.g. `aws s3 cp index.html s3://my-static-website-jh34jsjmg` and `aws s3 cp error.html s3://my-static-website-jh34jsjmg`
+   * Upload the content to your bucket as described [here](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy)
+   * E.g. `aws s3 cp index.html s3://my-static-website-jh34jsjmg` and `aws s3 cp error.html s3://my-static-website-jh34jsjmg`
 
 10. Next we need to set the bucket policy to allow read access.
 

From a79bed9a46cc8acff183823140cd42e77dd5b324 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Mon, 15 Feb 2021 20:43:06 +0530
Subject: [PATCH 225/254] #1655: added maven wrapper (#1656)

Addresses Point 1 and 2
---
 .github/workflows/maven-ci.yml           |   2 +-
 .github/workflows/maven-pr-builder.yml   |   2 +-
 .mvn/wrapper/MavenWrapperDownloader.java | 117 +++++++++
 .mvn/wrapper/maven-wrapper.properties    |   2 +
 mvnw                                     | 310 +++++++++++++++++++++++
 mvnw.cmd                                 | 182 +++++++++++++
 6 files changed, 613 insertions(+), 2 deletions(-)
 create mode 100644 .mvn/wrapper/MavenWrapperDownloader.java
 create mode 100644 .mvn/wrapper/maven-wrapper.properties
 create mode 100755 mvnw
 create mode 100644 mvnw.cmd

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index b05d78281..c42cd4378 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -73,7 +73,7 @@ jobs:
     # SonarQube scan does not work for forked repositories try changing it to xvfb-run mvn clean verify
     # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven and run SonarQube analysis
-      run: xvfb-run mvn clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
+      run: xvfb-run ./mvnw clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
       env:
         # These two env variables are needed for sonar analysis
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 05e5332c1..98bbc79e6 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -61,4 +61,4 @@ jobs:
     # SonarQube scan does not work for forked repositories.
     # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven
-      run: xvfb-run mvn clean verify
+      run: xvfb-run ./mvnw clean verify
diff --git a/.mvn/wrapper/MavenWrapperDownloader.java b/.mvn/wrapper/MavenWrapperDownloader.java
new file mode 100644
index 000000000..b901097f2
--- /dev/null
+++ b/.mvn/wrapper/MavenWrapperDownloader.java
@@ -0,0 +1,117 @@
+/*
+ * Copyright 2007-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import java.net.*;
+import java.io.*;
+import java.nio.channels.*;
+import java.util.Properties;
+
+public class MavenWrapperDownloader {
+
+    private static final String WRAPPER_VERSION = "0.5.6";
+    /**
+     * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
+     */
+    private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
+        + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
+
+    /**
+     * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
+     * use instead of the default one.
+     */
+    private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
+            ".mvn/wrapper/maven-wrapper.properties";
+
+    /**
+     * Path where the maven-wrapper.jar will be saved to.
+     */
+    private static final String MAVEN_WRAPPER_JAR_PATH =
+            ".mvn/wrapper/maven-wrapper.jar";
+
+    /**
+     * Name of the property which should be used to override the default download url for the wrapper.
+     */
+    private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
+
+    public static void main(String args[]) {
+        System.out.println("- Downloader started");
+        File baseDirectory = new File(args[0]);
+        System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
+
+        // If the maven-wrapper.properties exists, read it and check if it contains a custom
+        // wrapperUrl parameter.
+        File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
+        String url = DEFAULT_DOWNLOAD_URL;
+        if(mavenWrapperPropertyFile.exists()) {
+            FileInputStream mavenWrapperPropertyFileInputStream = null;
+            try {
+                mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
+                Properties mavenWrapperProperties = new Properties();
+                mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
+                url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
+            } catch (IOException e) {
+                System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
+            } finally {
+                try {
+                    if(mavenWrapperPropertyFileInputStream != null) {
+                        mavenWrapperPropertyFileInputStream.close();
+                    }
+                } catch (IOException e) {
+                    // Ignore ...
+                }
+            }
+        }
+        System.out.println("- Downloading from: " + url);
+
+        File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
+        if(!outputFile.getParentFile().exists()) {
+            if(!outputFile.getParentFile().mkdirs()) {
+                System.out.println(
+                        "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
+            }
+        }
+        System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
+        try {
+            downloadFileFromURL(url, outputFile);
+            System.out.println("Done");
+            System.exit(0);
+        } catch (Throwable e) {
+            System.out.println("- Error downloading");
+            e.printStackTrace();
+            System.exit(1);
+        }
+    }
+
+    private static void downloadFileFromURL(String urlString, File destination) throws Exception {
+        if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
+            String username = System.getenv("MVNW_USERNAME");
+            char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
+            Authenticator.setDefault(new Authenticator() {
+                @Override
+                protected PasswordAuthentication getPasswordAuthentication() {
+                    return new PasswordAuthentication(username, password);
+                }
+            });
+        }
+        URL website = new URL(urlString);
+        ReadableByteChannel rbc;
+        rbc = Channels.newChannel(website.openStream());
+        FileOutputStream fos = new FileOutputStream(destination);
+        fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
+        fos.close();
+        rbc.close();
+    }
+
+}
diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties
new file mode 100644
index 000000000..642d572ce
--- /dev/null
+++ b/.mvn/wrapper/maven-wrapper.properties
@@ -0,0 +1,2 @@
+distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
+wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar
diff --git a/mvnw b/mvnw
new file mode 100755
index 000000000..41c0f0c23
--- /dev/null
+++ b/mvnw
@@ -0,0 +1,310 @@
+#!/bin/sh
+# ----------------------------------------------------------------------------
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# ----------------------------------------------------------------------------
+
+# ----------------------------------------------------------------------------
+# Maven Start Up Batch script
+#
+# Required ENV vars:
+# ------------------
+#   JAVA_HOME - location of a JDK home dir
+#
+# Optional ENV vars
+# -----------------
+#   M2_HOME - location of maven2's installed home dir
+#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
+#     e.g. to debug Maven itself, use
+#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+# ----------------------------------------------------------------------------
+
+if [ -z "$MAVEN_SKIP_RC" ] ; then
+
+  if [ -f /etc/mavenrc ] ; then
+    . /etc/mavenrc
+  fi
+
+  if [ -f "$HOME/.mavenrc" ] ; then
+    . "$HOME/.mavenrc"
+  fi
+
+fi
+
+# OS specific support.  $var _must_ be set to either true or false.
+cygwin=false;
+darwin=false;
+mingw=false
+case "`uname`" in
+  CYGWIN*) cygwin=true ;;
+  MINGW*) mingw=true;;
+  Darwin*) darwin=true
+    # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
+    # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
+    if [ -z "$JAVA_HOME" ]; then
+      if [ -x "/usr/libexec/java_home" ]; then
+        export JAVA_HOME="`/usr/libexec/java_home`"
+      else
+        export JAVA_HOME="/Library/Java/Home"
+      fi
+    fi
+    ;;
+esac
+
+if [ -z "$JAVA_HOME" ] ; then
+  if [ -r /etc/gentoo-release ] ; then
+    JAVA_HOME=`java-config --jre-home`
+  fi
+fi
+
+if [ -z "$M2_HOME" ] ; then
+  ## resolve links - $0 may be a link to maven's home
+  PRG="$0"
+
+  # need this for relative symlinks
+  while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+      PRG="$link"
+    else
+      PRG="`dirname "$PRG"`/$link"
+    fi
+  done
+
+  saveddir=`pwd`
+
+  M2_HOME=`dirname "$PRG"`/..
+
+  # make it fully qualified
+  M2_HOME=`cd "$M2_HOME" && pwd`
+
+  cd "$saveddir"
+  # echo Using m2 at $M2_HOME
+fi
+
+# For Cygwin, ensure paths are in UNIX format before anything is touched
+if $cygwin ; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME=`cygpath --unix "$M2_HOME"`
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=`cygpath --path --unix "$CLASSPATH"`
+fi
+
+# For Mingw, ensure paths are in UNIX format before anything is touched
+if $mingw ; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME="`(cd "$M2_HOME"; pwd)`"
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`"
+fi
+
+if [ -z "$JAVA_HOME" ]; then
+  javaExecutable="`which javac`"
+  if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then
+    # readlink(1) is not available as standard on Solaris 10.
+    readLink=`which readlink`
+    if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then
+      if $darwin ; then
+        javaHome="`dirname \"$javaExecutable\"`"
+        javaExecutable="`cd \"$javaHome\" && pwd -P`/javac"
+      else
+        javaExecutable="`readlink -f \"$javaExecutable\"`"
+      fi
+      javaHome="`dirname \"$javaExecutable\"`"
+      javaHome=`expr "$javaHome" : '\(.*\)/bin'`
+      JAVA_HOME="$javaHome"
+      export JAVA_HOME
+    fi
+  fi
+fi
+
+if [ -z "$JAVACMD" ] ; then
+  if [ -n "$JAVA_HOME"  ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+      # IBM's JDK on AIX uses strange locations for the executables
+      JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+      JAVACMD="$JAVA_HOME/bin/java"
+    fi
+  else
+    JAVACMD="`which java`"
+  fi
+fi
+
+if [ ! -x "$JAVACMD" ] ; then
+  echo "Error: JAVA_HOME is not defined correctly." >&2
+  echo "  We cannot execute $JAVACMD" >&2
+  exit 1
+fi
+
+if [ -z "$JAVA_HOME" ] ; then
+  echo "Warning: JAVA_HOME environment variable is not set."
+fi
+
+CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
+
+# traverses directory structure from process work directory to filesystem root
+# first directory with .mvn subdirectory is considered project base directory
+find_maven_basedir() {
+
+  if [ -z "$1" ]
+  then
+    echo "Path not specified to find_maven_basedir"
+    return 1
+  fi
+
+  basedir="$1"
+  wdir="$1"
+  while [ "$wdir" != '/' ] ; do
+    if [ -d "$wdir"/.mvn ] ; then
+      basedir=$wdir
+      break
+    fi
+    # workaround for JBEAP-8937 (on Solaris 10/Sparc)
+    if [ -d "${wdir}" ]; then
+      wdir=`cd "$wdir/.."; pwd`
+    fi
+    # end of workaround
+  done
+  echo "${basedir}"
+}
+
+# concatenates all lines of a file
+concat_lines() {
+  if [ -f "$1" ]; then
+    echo "$(tr -s '\n' ' ' < "$1")"
+  fi
+}
+
+BASE_DIR=`find_maven_basedir "$(pwd)"`
+if [ -z "$BASE_DIR" ]; then
+  exit 1;
+fi
+
+##########################################################################################
+# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+# This allows using the maven wrapper in projects that prohibit checking in binary data.
+##########################################################################################
+if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Found .mvn/wrapper/maven-wrapper.jar"
+    fi
+else
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..."
+    fi
+    if [ -n "$MVNW_REPOURL" ]; then
+      jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    else
+      jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    fi
+    while IFS="=" read key value; do
+      case "$key" in (wrapperUrl) jarUrl="$value"; break ;;
+      esac
+    done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties"
+    if [ "$MVNW_VERBOSE" = true ]; then
+      echo "Downloading from: $jarUrl"
+    fi
+    wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar"
+    if $cygwin; then
+      wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"`
+    fi
+
+    if command -v wget > /dev/null; then
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Found wget ... using wget"
+        fi
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            wget "$jarUrl" -O "$wrapperJarPath"
+        else
+            wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath"
+        fi
+    elif command -v curl > /dev/null; then
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Found curl ... using curl"
+        fi
+        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
+            curl -o "$wrapperJarPath" "$jarUrl" -f
+        else
+            curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f
+        fi
+
+    else
+        if [ "$MVNW_VERBOSE" = true ]; then
+          echo "Falling back to using Java to download"
+        fi
+        javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java"
+        # For Cygwin, switch paths to Windows format before running javac
+        if $cygwin; then
+          javaClass=`cygpath --path --windows "$javaClass"`
+        fi
+        if [ -e "$javaClass" ]; then
+            if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+                if [ "$MVNW_VERBOSE" = true ]; then
+                  echo " - Compiling MavenWrapperDownloader.java ..."
+                fi
+                # Compiling the Java class
+                ("$JAVA_HOME/bin/javac" "$javaClass")
+            fi
+            if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
+                # Running the downloader
+                if [ "$MVNW_VERBOSE" = true ]; then
+                  echo " - Running MavenWrapperDownloader.java ..."
+                fi
+                ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR")
+            fi
+        fi
+    fi
+fi
+##########################################################################################
+# End of extension
+##########################################################################################
+
+export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
+if [ "$MVNW_VERBOSE" = true ]; then
+  echo $MAVEN_PROJECTBASEDIR
+fi
+MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin; then
+  [ -n "$M2_HOME" ] &&
+    M2_HOME=`cygpath --path --windows "$M2_HOME"`
+  [ -n "$JAVA_HOME" ] &&
+    JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"`
+  [ -n "$CLASSPATH" ] &&
+    CLASSPATH=`cygpath --path --windows "$CLASSPATH"`
+  [ -n "$MAVEN_PROJECTBASEDIR" ] &&
+    MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"`
+fi
+
+# Provide a "standardized" way to retrieve the CLI args that will
+# work with both Windows and non-Windows executions.
+MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@"
+export MAVEN_CMD_LINE_ARGS
+
+WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+exec "$JAVACMD" \
+  $MAVEN_OPTS \
+  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
+  "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
+  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"
diff --git a/mvnw.cmd b/mvnw.cmd
new file mode 100644
index 000000000..86115719e
--- /dev/null
+++ b/mvnw.cmd
@@ -0,0 +1,182 @@
+@REM ----------------------------------------------------------------------------
+@REM Licensed to the Apache Software Foundation (ASF) under one
+@REM or more contributor license agreements.  See the NOTICE file
+@REM distributed with this work for additional information
+@REM regarding copyright ownership.  The ASF licenses this file
+@REM to you under the Apache License, Version 2.0 (the
+@REM "License"); you may not use this file except in compliance
+@REM with the License.  You may obtain a copy of the License at
+@REM
+@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM
+@REM Unless required by applicable law or agreed to in writing,
+@REM software distributed under the License is distributed on an
+@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+@REM KIND, either express or implied.  See the License for the
+@REM specific language governing permissions and limitations
+@REM under the License.
+@REM ----------------------------------------------------------------------------
+
+@REM ----------------------------------------------------------------------------
+@REM Maven Start Up Batch script
+@REM
+@REM Required ENV vars:
+@REM JAVA_HOME - location of a JDK home dir
+@REM
+@REM Optional ENV vars
+@REM M2_HOME - location of maven2's installed home dir
+@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
+@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending
+@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
+@REM     e.g. to debug Maven itself, use
+@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
+@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
+@REM ----------------------------------------------------------------------------
+
+@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
+@echo off
+@REM set title of command window
+title %0
+@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
+@if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
+
+@REM set %HOME% to equivalent of $HOME
+if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
+
+@REM Execute a user defined script before this one
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
+@REM check for pre script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat"
+if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd"
+:skipRcPre
+
+@setlocal
+
+set ERROR_CODE=0
+
+@REM To isolate internal variables from possible post scripts, we use another setlocal
+@setlocal
+
+@REM ==== START VALIDATION ====
+if not "%JAVA_HOME%" == "" goto OkJHome
+
+echo.
+echo Error: JAVA_HOME not found in your environment. >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+:OkJHome
+if exist "%JAVA_HOME%\bin\java.exe" goto init
+
+echo.
+echo Error: JAVA_HOME is set to an invalid directory. >&2
+echo JAVA_HOME = "%JAVA_HOME%" >&2
+echo Please set the JAVA_HOME variable in your environment to match the >&2
+echo location of your Java installation. >&2
+echo.
+goto error
+
+@REM ==== END VALIDATION ====
+
+:init
+
+@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
+@REM Fallback to current working directory if not found.
+
+set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
+IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
+
+set EXEC_DIR=%CD%
+set WDIR=%EXEC_DIR%
+:findBaseDir
+IF EXIST "%WDIR%"\.mvn goto baseDirFound
+cd ..
+IF "%WDIR%"=="%CD%" goto baseDirNotFound
+set WDIR=%CD%
+goto findBaseDir
+
+:baseDirFound
+set MAVEN_PROJECTBASEDIR=%WDIR%
+cd "%EXEC_DIR%"
+goto endDetectBaseDir
+
+:baseDirNotFound
+set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
+cd "%EXEC_DIR%"
+
+:endDetectBaseDir
+
+IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
+
+@setlocal EnableExtensions EnableDelayedExpansion
+for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
+@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
+
+:endReadAdditionalConfig
+
+SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
+set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
+set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
+
+set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+
+FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
+    IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B
+)
+
+@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
+@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
+if exist %WRAPPER_JAR% (
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Found %WRAPPER_JAR%
+    )
+) else (
+    if not "%MVNW_REPOURL%" == "" (
+        SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
+    )
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Couldn't find %WRAPPER_JAR%, downloading it ...
+        echo Downloading from: %DOWNLOAD_URL%
+    )
+
+    powershell -Command "&{"^
+		"$webclient = new-object System.Net.WebClient;"^
+		"if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^
+		"$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^
+		"}"^
+		"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^
+		"}"
+    if "%MVNW_VERBOSE%" == "true" (
+        echo Finished downloading %WRAPPER_JAR%
+    )
+)
+@REM End of extension
+
+@REM Provide a "standardized" way to retrieve the CLI args that will
+@REM work with both Windows and non-Windows executions.
+set MAVEN_CMD_LINE_ARGS=%*
+
+%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
+if ERRORLEVEL 1 goto error
+goto end
+
+:error
+set ERROR_CODE=1
+
+:end
+@endlocal & set ERROR_CODE=%ERROR_CODE%
+
+if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost
+@REM check for post script, once with legacy .bat ending and once with .cmd ending
+if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat"
+if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd"
+:skipRcPost
+
+@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
+if "%MAVEN_BATCH_PAUSE%" == "on" pause
+
+if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE%
+
+exit /B %ERROR_CODE%

From cda2675221555b04415e0e122039d5da61b48b45 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Tue, 16 Feb 2021 08:57:11 +0200
Subject: [PATCH 226/254] Upgrade jacoco (#1657)

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 .mvn/wrapper/maven-wrapper.properties | 23 +++++++++++++++++++++++
 pom.xml                               |  2 +-
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/.mvn/wrapper/maven-wrapper.properties b/.mvn/wrapper/maven-wrapper.properties
index 642d572ce..7af88697b 100644
--- a/.mvn/wrapper/maven-wrapper.properties
+++ b/.mvn/wrapper/maven-wrapper.properties
@@ -1,2 +1,25 @@
+#
+# The MIT License
+# Copyright © 2014-2021 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
 distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
 wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar
diff --git a/pom.xml b/pom.xml
index d750e9ba2..c7d61a12b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -45,7 +45,7 @@
         <junit-vintage.version>${junit.version}.2</junit-vintage.version>
         <sping-test-junit5.version>1.0.2</sping-test-junit5.version>
         <compiler.version>3.8.1</compiler.version>
-        <jacoco.version>0.8.4</jacoco.version>
+        <jacoco.version>0.8.6</jacoco.version>
         <commons-dbcp.version>1.4</commons-dbcp.version>
         <camel.version>2.24.0</camel.version>
         <guava.version>19.0</guava.version>

From 03bc4a6b9a6d43f20b14fa90758b848c6f4a08c5 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 21 Feb 2021 18:51:11 +0530
Subject: [PATCH 227/254] update CI badge (#1658)

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index be21765cc..ea2866a9b 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 # Design patterns implemented in Java
 
-![Java CI with Maven](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI%20with%20Maven/badge.svg)
+![Java CI](https://github.com/iluwatar/java-design-patterns/workflows/Java%20CI/badge.svg)
 [![License MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/LICENSE.md)
 [![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=ncloc)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns) 
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
@@ -15,7 +15,7 @@
 
 <br/>
 
-Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md),[![KR](/assets/flags/KR.png)**KR**](/ko/README.md),[![FR](/assets/flags/FR.png)**FR**](/fr/README.md),[![TR](/assets/flags/TR.png)**TR**](/tr/README.md),[![AR](/assets/flags/AR.png)**AR**](/ar/README.md),
+Read in different language : [![CN](/assets/flags/CN.png)**CN**](/zh/README.md), [![KR](/assets/flags/KR.png)**KR**](/ko/README.md), [![FR](/assets/flags/FR.png)**FR**](/fr/README.md), [![TR](/assets/flags/TR.png)**TR**](/tr/README.md), [![AR](/assets/flags/AR.png)**AR**](/ar/README.md)
 
 <br/>
 

From 846d05672a66e4464ebca61c56d061eb964df4c6 Mon Sep 17 00:00:00 2001
From: Martel Richard <martelmr36@gmail.com>
Date: Sun, 28 Feb 2021 15:12:48 +0530
Subject: [PATCH 228/254] #1638 Add Parameter Object pattern (#1650)

* #1638 Add Parameter Object pattern

* #1638 Fix comments and formatting for Parameter Object pattern

* #1638 Fix formatting, commenting, remove string concatenation in Parameter Object pattern

* #1638 Fix readme formatting and log parameter object
---
 parameter-object/README.md                    | 138 ++++++++++++++++++
 parameter-object/etc/parameter-object.png     | Bin 0 -> 182925 bytes
 .../etc/parameter-object.urm.puml             |  52 +++++++
 parameter-object/pom.xml                      |  61 ++++++++
 .../com/iluwatar/parameter/object/App.java    |  62 ++++++++
 .../parameter/object/ParameterObject.java     | 113 ++++++++++++++
 .../parameter/object/SearchService.java       |  60 ++++++++
 .../iluwatar/parameter/object/SortOrder.java  |  39 +++++
 .../iluwatar/parameter/object/AppTest.java    |  41 ++++++
 .../parameter/object/ParameterObjectTest.java |  63 ++++++++
 .../parameter/object/SearchServiceTest.java   |  63 ++++++++
 pom.xml                                       |   1 +
 12 files changed, 693 insertions(+)
 create mode 100644 parameter-object/README.md
 create mode 100644 parameter-object/etc/parameter-object.png
 create mode 100644 parameter-object/etc/parameter-object.urm.puml
 create mode 100644 parameter-object/pom.xml
 create mode 100644 parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
 create mode 100644 parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
 create mode 100644 parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
 create mode 100644 parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
 create mode 100644 parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
 create mode 100644 parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
 create mode 100644 parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java

diff --git a/parameter-object/README.md b/parameter-object/README.md
new file mode 100644
index 000000000..9783879f1
--- /dev/null
+++ b/parameter-object/README.md
@@ -0,0 +1,138 @@
+---
+layout: pattern
+title: Parameter Object
+folder: parameter-object
+permalink: /patterns/parameter-object/
+categories: Behavioral
+tags:
+ - Extensibility
+---
+
+## Intent
+
+The syntax of Java language doesn’t allow you to declare a method with a predefined value
+for a parameter. Probably the best option to achieve default method parameters in Java is
+by using the method overloading. Method overloading allows you to declare several methods
+with the same name but with a different number of parameters. But the main problem with
+method overloading as a solution for default parameter values reveals itself when a method
+accepts multiple parameters. Creating an overloaded method for each possible combination of
+parameters might be cumbersome. To deal with this issue, the Parameter Object pattern is used.
+
+## Explanation
+
+The Parameter Object is simply a wrapper object for all parameters of a method.
+It is nothing more than just a regular POJO. The advantage of the Parameter Object over a
+regular method parameter list is the fact that class fields can have default values.
+Once the wrapper class is created for the method parameter list, a corresponding builder class
+is also created. Usually it's an inner static class. The final step is to use the builder
+to construct a new parameter object. For those parameters that are skipped,
+their default values are going to be used.
+
+
+**Programmatic Example**
+
+Here's the simple `SearchService` class where Method Overloading is used to default values here. To use method overloading, either the number of arguments or argument type has to be different.
+
+```java
+public class SearchService {
+  //Method Overloading example. SortOrder is defaulted in this method
+  public String search(String type, String sortBy) {
+    return getQuerySummary(type, sortBy, SortOrder.DESC);
+  }
+
+  /* Method Overloading example. SortBy is defaulted in this method. Note that the type has to be 
+  different here to overload the method */
+  public String search(String type, SortOrder sortOrder) {
+    return getQuerySummary(type, "price", sortOrder);
+  }
+
+  private String getQuerySummary(String type, String sortBy, SortOrder sortOrder) {
+    return "Requesting shoes of type \"" + type + "\" sorted by \"" + sortBy + "\" in \""
+        + sortOrder.getValue() + "ending\" order...";
+  }
+}
+
+```
+
+Next we present the `SearchService` with `ParameterObject` created with Builder pattern.
+
+```java
+public class SearchService {
+
+  /* Parameter Object example. Default values are abstracted into the Parameter Object 
+  at the time of Object creation */
+  public String search(ParameterObject parameterObject) {
+    return getQuerySummary(parameterObject.getType(), parameterObject.getSortBy(),
+        parameterObject.getSortOrder());
+  }
+  
+  private String getQuerySummary(String type, String sortBy, SortOrder sortOrder) {
+    return "Requesting shoes of type \"" + type + "\" sorted by \"" + sortBy + "\" in \""
+        + sortOrder.getValue() + "ending\" order...";
+  }
+}
+
+public class ParameterObject {
+  public static final String DEFAULT_SORT_BY = "price";
+  public static final SortOrder DEFAULT_SORT_ORDER = SortOrder.ASC;
+
+  private String type;
+  private String sortBy = DEFAULT_SORT_BY;
+  private SortOrder sortOrder = DEFAULT_SORT_ORDER;
+
+  private ParameterObject(Builder builder) {
+    type = builder.type;
+    sortBy = builder.sortBy != null && !builder.sortBy.isBlank() ? builder.sortBy : sortBy;
+    sortOrder = builder.sortOrder != null ? builder.sortOrder : sortOrder;
+  }
+
+  public static Builder newBuilder() {
+    return new Builder();
+  }
+
+  //Getters and Setters...
+
+  public static final class Builder {
+
+    private String type;
+    private String sortBy;
+    private SortOrder sortOrder;
+
+    private Builder() {
+    }
+
+    public Builder withType(String type) {
+      this.type = type;
+      return this;
+    }
+
+    public Builder sortBy(String sortBy) {
+      this.sortBy = sortBy;
+      return this;
+    }
+
+    public Builder sortOrder(SortOrder sortOrder) {
+      this.sortOrder = sortOrder;
+      return this;
+    }
+
+    public ParameterObject build() {
+      return new ParameterObject(this);
+    }
+  }
+}
+
+
+```
+
+## Class diagram
+
+![alt text](./etc/parameter-object.png "Parameter Object")
+
+## Applicability
+
+This pattern shows us the way to have default parameters for a method in Java as the language doesn't default parameters feature out of the box. 
+
+## Credits
+
+- [Does Java have default parameters?](http://dolszewski.com/java/java-default-parameters)
diff --git a/parameter-object/etc/parameter-object.png b/parameter-object/etc/parameter-object.png
new file mode 100644
index 0000000000000000000000000000000000000000..661c3488ac49c90e191cf77a20c72350e8dafed1
GIT binary patch
literal 182925
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
B?yUd-

literal 0
HcmV?d00001

diff --git a/parameter-object/etc/parameter-object.urm.puml b/parameter-object/etc/parameter-object.urm.puml
new file mode 100644
index 000000000..6cdab2141
--- /dev/null
+++ b/parameter-object/etc/parameter-object.urm.puml
@@ -0,0 +1,52 @@
+@startuml
+package com.iluwatar.parameter.object {
+  class App {
+    - LOGGER : Logger {static}
+    + App()
+    + main(args : String[]) {static}
+  }
+  class ParameterObject {
+    + DEFAULT_SORT_BY : String {static}
+    + DEFAULT_SORT_ORDER : SortOrder {static}
+    - sortBy : String
+    - sortOrder : SortOrder
+    - type : String
+    - ParameterObject(builder : Builder)
+    + getSortBy() : String
+    + getSortOrder() : SortOrder
+    + getType() : String
+    + newBuilder() : Builder {static}
+    + setSortBy(sortBy : String)
+    + setSortOrder(sortOrder : SortOrder)
+    + setType(type : String)
+  }
+  class Builder {
+    - sortBy : String
+    - sortOrder : SortOrder
+    - type : String
+    - Builder()
+    + build() : ParameterObject
+    + sortBy(sortBy : String) : Builder
+    + sortOrder(sortOrder : SortOrder) : Builder
+    + withType(type : String) : Builder
+  }
+  class SearchService {
+    + SearchService()
+    - getQuerySummary(type : String, sortBy : String, sortOrder : SortOrder) : String
+    + search(parameterObject : ParameterObject) : String
+    + search(type : String, sortBy : String) : String
+    + search(type : String, sortOrder : SortOrder) : String
+  }
+  enum SortOrder {
+    + ASC {static}
+    + DESC {static}
+    - value : String
+    + getValue() : String
+    + valueOf(name : String) : SortOrder {static}
+    + values() : SortOrder[] {static}
+  }
+}
+Builder -->  "-sortOrder" SortOrder
+Builder ..+ ParameterObject
+ParameterObject -->  "-DEFAULT_SORT_ORDER" SortOrder
+@enduml
diff --git a/parameter-object/pom.xml b/parameter-object/pom.xml
new file mode 100644
index 000000000..be64d62df
--- /dev/null
+++ b/parameter-object/pom.xml
@@ -0,0 +1,61 @@
+<?xml version="1.0"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2019 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+  <parent>
+    <groupId>com.iluwatar</groupId>
+    <artifactId>java-design-patterns</artifactId>
+    <version>1.24.0-SNAPSHOT</version>
+  </parent>
+  <artifactId>parameter-object</artifactId>
+  <dependencies>
+    <dependency>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <executions>
+          <execution>
+            <configuration>
+              <archive>
+                <manifest>
+                  <mainClass>com.iluwatar.parameter.object.App</mainClass>
+                </manifest>
+              </archive>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
new file mode 100644
index 000000000..7d4f600e2
--- /dev/null
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
@@ -0,0 +1,62 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The syntax of Java language doesn’t allow you to declare a method with a predefined value
+ * for a parameter. Probably the best option to achieve default method parameters in Java is
+ * by using the method overloading. Method overloading allows you to declare several methods
+ * with the same name but with a different number of parameters. But the main problem with
+ * method overloading as a solution for default parameter values reveals itself when a method
+ * accepts multiple parameters. Creating an overloaded method for each possible combination of
+ * parameters might be cumbersome. To deal with this issue, the Parameter Object pattern is used.
+ * The Parameter Object is simply a wrapper object for all parameters of a method.
+ * It is nothing more than just a regular POJO. The advantage of the Parameter Object over a
+ * regular method parameter list is the fact that class fields can have default values.
+ * Once the wrapper class is created for the method parameter list, a corresponding builder class
+ * is also created. Usually it's an inner static class. The final step is to use the builder
+ * to construct a new parameter object. For those parameters that are skipped,
+ * their default values are going to be used.
+ */
+public class App {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    ParameterObject params = ParameterObject.newBuilder()
+        .withType("sneakers")
+        .sortBy("brand")
+        .build();
+    LOGGER.info(params.toString());
+    LOGGER.info(new SearchService().search(params));
+  }
+}
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
new file mode 100644
index 000000000..65f636191
--- /dev/null
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
@@ -0,0 +1,113 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+public class ParameterObject {
+
+  /**
+   * Default values are defined here.
+   */
+  public static final String DEFAULT_SORT_BY = "price";
+  public static final SortOrder DEFAULT_SORT_ORDER = SortOrder.ASC;
+
+  private String type;
+
+  /**
+   * Default values are assigned here.
+   */
+  private String sortBy = DEFAULT_SORT_BY;
+  private SortOrder sortOrder = DEFAULT_SORT_ORDER;
+
+  /**
+   * Overriding default values on object creation only when builder object has a valid value.
+   */
+  private ParameterObject(Builder builder) {
+    setType(builder.type);
+    setSortBy(builder.sortBy != null && !builder.sortBy.isBlank() ? builder.sortBy : sortBy);
+    setSortOrder(builder.sortOrder != null ? builder.sortOrder : sortOrder);
+  }
+
+  public static Builder newBuilder() {
+    return new Builder();
+  }
+
+  public String getType() {
+    return type;
+  }
+
+  public void setType(String type) {
+    this.type = type;
+  }
+
+  public String getSortBy() {
+    return sortBy;
+  }
+
+  public void setSortBy(String sortBy) {
+    this.sortBy = sortBy;
+  }
+
+  public SortOrder getSortOrder() {
+    return sortOrder;
+  }
+
+  public void setSortOrder(SortOrder sortOrder) {
+    this.sortOrder = sortOrder;
+  }
+
+  @Override
+  public String toString() {
+    return String.format("ParameterObject[type='%s', sortBy='%s', sortOrder='%s']",
+        type, sortBy, sortOrder);
+  }
+
+  public static final class Builder {
+
+    private String type;
+    private String sortBy;
+    private SortOrder sortOrder;
+
+    private Builder() {
+    }
+
+    public Builder withType(String type) {
+      this.type = type;
+      return this;
+    }
+
+    public Builder sortBy(String sortBy) {
+      this.sortBy = sortBy;
+      return this;
+    }
+
+    public Builder sortOrder(SortOrder sortOrder) {
+      this.sortOrder = sortOrder;
+      return this;
+    }
+
+    public ParameterObject build() {
+      return new ParameterObject(this);
+    }
+  }
+}
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
new file mode 100644
index 000000000..62acc840d
--- /dev/null
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
@@ -0,0 +1,60 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+public class SearchService {
+
+  /**
+   * Below two methods of name `search` is overloaded so that we can send a default value for
+   * one of the criteria and call the final api. A default SortOrder is sent in the first method
+   * and a default SortBy is sent in the second method. So two separate method definitions are
+   * needed for having default values for one argument in each case. Hence multiple overloaded
+   * methods are needed as the number of argument increases.
+   */
+  public String search(String type, String sortBy) {
+    return getQuerySummary(type, sortBy, SortOrder.ASC);
+  }
+
+  public String search(String type, SortOrder sortOrder) {
+    return getQuerySummary(type, "price", sortOrder);
+  }
+
+
+  /**
+   * The need for multiple method definitions can be avoided by the Parameter Object pattern.
+   * Below is the example where only one method is required and all the logic for having default
+   * values are abstracted into the Parameter Object at the time of object creation.
+   */
+  public String search(ParameterObject parameterObject) {
+    return getQuerySummary(parameterObject.getType(), parameterObject.getSortBy(),
+        parameterObject.getSortOrder());
+  }
+
+  private String getQuerySummary(String type, String sortBy, SortOrder sortOrder) {
+    return String.format("Requesting shoes of type \"%s\" sorted by \"%s\" in \"%sending\" order..",
+        type,
+        sortBy,
+        sortOrder.getValue());
+  }
+}
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
new file mode 100644
index 000000000..6420ca9e1
--- /dev/null
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
@@ -0,0 +1,39 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+public enum SortOrder {
+  ASC("asc"),
+  DESC("desc");
+
+  private String value;
+
+  SortOrder(String value) {
+    this.value = value;
+  }
+
+  public String getValue() {
+    return value;
+  }
+}
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
new file mode 100644
index 000000000..809e41f36
--- /dev/null
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
@@ -0,0 +1,41 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+import org.junit.jupiter.api.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * Application test
+ */
+class AppTest {
+  private static final Logger LOGGER = LoggerFactory.getLogger(AppTest.class);
+
+  @Test
+  void shouldExecuteApplicationWithoutException() {
+    App.main(new String[]{});
+    LOGGER.info("Executed successfully without exception.");
+  }
+}
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
new file mode 100644
index 000000000..05907b9c6
--- /dev/null
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
@@ -0,0 +1,63 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+import org.junit.jupiter.api.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class ParameterObjectTest {
+
+  private static final Logger LOGGER = LoggerFactory.getLogger(ParameterObjectTest.class);
+
+  @Test
+  public void testForDefaultSortBy() {
+    //Creating parameter object with default value for SortBy set
+    ParameterObject params = ParameterObject.newBuilder()
+        .withType("sneakers")
+        .sortOrder(SortOrder.DESC)
+        .build();
+
+    assertEquals(ParameterObject.DEFAULT_SORT_BY, params.getSortBy(),
+        "Default SortBy is not set.");
+    LOGGER.info("{} Default parameter value is set during object creation as no value is passed."
+        , "SortBy");
+  }
+
+  @Test
+  public void testForDefaultSortOrder() {
+    //Creating parameter object with default value for SortOrder set
+    ParameterObject params = ParameterObject.newBuilder()
+        .withType("sneakers")
+        .sortBy("brand")
+        .build();
+
+    assertEquals(ParameterObject.DEFAULT_SORT_ORDER, params.getSortOrder(),
+        "Default SortOrder is not set.");
+    LOGGER.info("{} Default parameter value is set during object creation as no value is passed."
+        , "SortOrder");
+  }
+}
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java
new file mode 100644
index 000000000..d7633f0e3
--- /dev/null
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java
@@ -0,0 +1,63 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2019 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.parameter.object;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+class SearchServiceTest {
+  private static final Logger LOGGER = LoggerFactory.getLogger(SearchServiceTest.class);
+  private ParameterObject parameterObject;
+  private SearchService searchService;
+
+  @BeforeEach
+  public void setUp() {
+    //Creating parameter object with default values set
+    parameterObject = ParameterObject.newBuilder()
+        .withType("sneakers")
+        .build();
+
+    searchService = new SearchService();
+  }
+
+  /**
+   *  Testing parameter object against the overloaded method to verify if the behaviour is same.
+   */
+  @Test
+  public void testDefaultParametersMatch() {
+    assertEquals(searchService.search(parameterObject), searchService.search("sneakers",
+        SortOrder.ASC), "Default Parameter values do not not match.");
+    LOGGER.info("SortBy Default parameter value matches.");
+
+    assertEquals(searchService.search(parameterObject), searchService.search("sneakers",
+        "price"), "Default Parameter values do not not match.");
+    LOGGER.info("SortOrder Default parameter value matches.");
+
+    LOGGER.info("testDefaultParametersMatch executed successfully without errors.");
+  }
+}
diff --git a/pom.xml b/pom.xml
index c7d61a12b..48fa6fdcf 100644
--- a/pom.xml
+++ b/pom.xml
@@ -208,6 +208,7 @@
         <module>factory</module>
         <module>separated-interface</module>
         <module>special-case</module>
+        <module>parameter-object</module>
     </modules>
 
     <repositories>

From 0220f3df129e9b1c22f34bc48fc33ac57a009e37 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 28 Feb 2021 11:51:47 +0200
Subject: [PATCH 229/254] docs: add richardmr36 as a contributor (#1662)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index cd996bd37..27bacb604 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1404,6 +1404,15 @@
       "contributions": [
         "translation"
       ]
+    },
+    {
+      "login": "richardmr36",
+      "name": "Martel Richard",
+      "avatar_url": "https://avatars.githubusercontent.com/u/19147333?v=4",
+      "profile": "https://github.com/richardmr36",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index ea2866a9b..da4c65bda 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-154-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-155-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -306,6 +306,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/byoungju94"><img src="https://avatars.githubusercontent.com/u/42516378?v=4?s=100" width="100px;" alt=""/><br /><sub><b>byoungju94</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=byoungju94" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/moustafafarhat"><img src="https://avatars.githubusercontent.com/u/38836727?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Moustafa Farhat</b></sub></a><br /><a href="#translation-moustafafarhat" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/richardmr36"><img src="https://avatars.githubusercontent.com/u/19147333?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Martel Richard</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=richardmr36" title="Code">💻</a></td>
   </tr>
 </table>
 

From 268e4148b4ac796b4bdb6649373c0a62aeba8e97 Mon Sep 17 00:00:00 2001
From: Halil Demir <m.halildemir94@gmail.com>
Date: Mon, 1 Mar 2021 14:50:06 +0100
Subject: [PATCH 230/254] #1625 add Turkish translation for singleton design
 pattern (#1665)

Co-authored-by: Halil Demir <halil.demir@zalando.de>
Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 tr/singleton/README.md | 87 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)
 create mode 100644 tr/singleton/README.md

diff --git a/tr/singleton/README.md b/tr/singleton/README.md
new file mode 100644
index 000000000..2f6d494e8
--- /dev/null
+++ b/tr/singleton/README.md
@@ -0,0 +1,87 @@
+---
+layout: pattern
+title: Singleton
+folder: singleton
+permalink: /patterns/singleton/
+categories: Creational
+tags:
+- Gang of Four
+---
+
+## Amaç
+
+Bir sınıfın yalnızca bir örneğine sahip olduğundan emin olun ve ona global bir erişim noktası sağlayın.
+
+
+## Açıklama
+
+Örnek
+
+> Büyücülerin büyülerini çalıstıkları tek bir fildişi kule olabilir. Aynı büyülü fildişi kule,
+> büyücüler tarafından her zaman kullanılır. Buradaki fildişi kulesi singleton tasarım desenine örnektir.
+Özetle
+
+> Belirli bir sınıftan yalnızca bir nesnenin oluşturulmasını sağlar.
+Wikipedia açıklaması
+
+
+
+> Yazılım mühendisliğinde, tekil desen, bir sınıfın somutlaştırılmasını tek bir nesneyle sınırlayan
+> bir yazılım tasarım modelidir.Bu,sistemdeki eylemleri koordine etmek için
+> tam olarak bir nesne gerektiğinde kullanışlıdır.
+**Örnek**
+
+Joshua Bloch, Effective Java 2nd Edition p.18
+
+> Enum singleton tasarım desenini uygulamak için en iyi yoldur.
+```java
+public enum EnumIvoryTower {
+  INSTANCE
+}
+```
+
+Tanımladıktan sonra kullanmak için:
+
+```java
+var enumIvoryTower1 = EnumIvoryTower.INSTANCE;
+var enumIvoryTower2 = EnumIvoryTower.INSTANCE;
+assertEquals(enumIvoryTower1, enumIvoryTower2); // true
+```
+
+## Sınıf diagramı
+
+![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/singleton/etc/singleton.urm.png)
+
+## Uygulanabilirlik
+
+Singleton tasarım deseni şu durumlarda kullanılmalıdır
+
+* Bir sınıfın tam olarak bir örneği olmalı ve iyi bilinen bir erişim noktasından istemciler tarafından erişilebilir olmalıdır.
+* Tek örnek alt sınıflandırma yoluyla genişletilebilir olduğunda ve istemciler, kodlarını değiştirmeden genişletilmiş bir örnek kullanabilmelidir
+
+## Use Case
+
+* Logging sınıflarında
+* Database bağlantılarını yönetmek için
+* File manager
+
+## Gerçek dünya örnekleri
+
+* [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29)
+* [java.awt.Desktop#getDesktop()](http://docs.oracle.com/javase/8/docs/api/java/awt/Desktop.html#getDesktop--)
+* [java.lang.System#getSecurityManager()](http://docs.oracle.com/javase/8/docs/api/java/lang/System.html#getSecurityManager--)
+
+
+## Sonuçlar
+
+* Kendi yaratımını ve yaşam döngüsünü kontrol ederek Tek Sorumluluk İlkesini (SRP) ihlal ediyor.
+* Bu nesne tarafından kullanılan bir nesnenin ve kaynakların serbest bırakılmasını önleyen global bir paylaşılan örnek kullanmayı teşvik eder.
+* Birbirine sıkı bağlı kod oluşturur. Singleton tasarım deseni kullanan istemci sınıflarını test etmek zorlaşır.
+* Bir Singleton tasarım deseninden alt sınıflar oluşturmak neredeyse imkansız hale gelir.
+
+## Credits
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
+* [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb)
+* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
+* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
\ No newline at end of file

From c3c90e2bd451cdd60947704d1250c8b245881199 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Mon, 1 Mar 2021 20:20:34 +0530
Subject: [PATCH 231/254] created CircleCI config for sonar analysis (#1664)

* created sonar config

#1663

* updated license headers

* xvfb to run tests

* updated circle image to enable css and JS analysis
---
 .circleci/config.yml                          | 52 +++++++++++++++++++
 .mvn/wrapper/MavenWrapperDownloader.java      | 28 ++++++----
 mvnw.cmd                                      | 36 +++++++------
 parameter-object/pom.xml                      |  2 +-
 .../com/iluwatar/parameter/object/App.java    |  2 +-
 .../parameter/object/ParameterObject.java     |  2 +-
 .../parameter/object/SearchService.java       |  2 +-
 .../iluwatar/parameter/object/SortOrder.java  |  2 +-
 .../iluwatar/parameter/object/AppTest.java    |  2 +-
 .../parameter/object/ParameterObjectTest.java |  2 +-
 .../parameter/object/SearchServiceTest.java   |  2 +-
 11 files changed, 98 insertions(+), 34 deletions(-)
 create mode 100644 .circleci/config.yml

diff --git a/.circleci/config.yml b/.circleci/config.yml
new file mode 100644
index 000000000..3e35aee71
--- /dev/null
+++ b/.circleci/config.yml
@@ -0,0 +1,52 @@
+#
+# The MIT License
+# Copyright © 2014-2021 Ilkka Seppälä
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#
+
+version: 2
+
+jobs:
+  sonar-pr:
+    docker:
+      - image: circleci/openjdk:11-node
+    steps:
+    - checkout
+    - restore_cache:
+        key: jdp-sonar-pr-{{ checksum "pom.xml" }}
+    - run: |
+        if [ -n "${CIRCLE_PR_NUMBER}" ]; then
+          MAVEN_OPTS="-Xmx3000m" xvfb-run ./mvnw -B clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar \
+             -Dsonar.pullrequest.key=${CIRCLE_PR_NUMBER} \
+             -Dsonar.pullrequest.branch=${CIRCLE_BRANCH} \
+             -Dsonar.pullrequest.base=master
+        else
+          echo "No Sonar PR analysis as this is not a pull request"
+        fi
+    - save_cache:
+        key: jdp-sonar-pr-{{ checksum "pom.xml" }}
+        paths:
+        - ~/.m2
+
+workflows:
+  version: 2
+  all:
+    jobs:
+    - sonar-pr
diff --git a/.mvn/wrapper/MavenWrapperDownloader.java b/.mvn/wrapper/MavenWrapperDownloader.java
index b901097f2..cfc696f01 100644
--- a/.mvn/wrapper/MavenWrapperDownloader.java
+++ b/.mvn/wrapper/MavenWrapperDownloader.java
@@ -1,18 +1,26 @@
 /*
- * Copyright 2007-present the original author or authors.
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
  *
- *      http://www.apache.org/licenses/LICENSE-2.0
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
  *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
  */
+
 import java.net.*;
 import java.io.*;
 import java.nio.channels.*;
diff --git a/mvnw.cmd b/mvnw.cmd
index 86115719e..ed1dd59b0 100644
--- a/mvnw.cmd
+++ b/mvnw.cmd
@@ -1,21 +1,25 @@
-@REM ----------------------------------------------------------------------------
-@REM Licensed to the Apache Software Foundation (ASF) under one
-@REM or more contributor license agreements.  See the NOTICE file
-@REM distributed with this work for additional information
-@REM regarding copyright ownership.  The ASF licenses this file
-@REM to you under the Apache License, Version 2.0 (the
-@REM "License"); you may not use this file except in compliance
-@REM with the License.  You may obtain a copy of the License at
 @REM
-@REM    http://www.apache.org/licenses/LICENSE-2.0
+@REM The MIT License
+@REM Copyright © 2014-2021 Ilkka Seppälä
+@REM
+@REM Permission is hereby granted, free of charge, to any person obtaining a copy
+@REM of this software and associated documentation files (the "Software"), to deal
+@REM in the Software without restriction, including without limitation the rights
+@REM to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+@REM copies of the Software, and to permit persons to whom the Software is
+@REM furnished to do so, subject to the following conditions:
+@REM
+@REM The above copyright notice and this permission notice shall be included in
+@REM all copies or substantial portions of the Software.
+@REM
+@REM THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+@REM IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+@REM FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+@REM AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+@REM LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+@REM OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+@REM THE SOFTWARE.
 @REM
-@REM Unless required by applicable law or agreed to in writing,
-@REM software distributed under the License is distributed on an
-@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-@REM KIND, either express or implied.  See the License for the
-@REM specific language governing permissions and limitations
-@REM under the License.
-@REM ----------------------------------------------------------------------------
 
 @REM ----------------------------------------------------------------------------
 @REM Maven Start Up Batch script
diff --git a/parameter-object/pom.xml b/parameter-object/pom.xml
index be64d62df..5fbf06066 100644
--- a/parameter-object/pom.xml
+++ b/parameter-object/pom.xml
@@ -2,7 +2,7 @@
 <!--
 
     The MIT License
-    Copyright © 2014-2019 Ilkka Seppälä
+    Copyright © 2014-2021 Ilkka Seppälä
 
     Permission is hereby granted, free of charge, to any person obtaining a copy
     of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
index 7d4f600e2..e0f2008d9 100644
--- a/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/App.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
index 65f636191..d90344930 100644
--- a/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/ParameterObject.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
index 62acc840d..7f038bbce 100644
--- a/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/SearchService.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java b/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
index 6420ca9e1..3f7240f6a 100644
--- a/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
+++ b/parameter-object/src/main/java/com/iluwatar/parameter/object/SortOrder.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
index 809e41f36..16baef96f 100644
--- a/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/AppTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
index 05907b9c6..999cd19e0 100644
--- a/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/ParameterObjectTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
diff --git a/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java b/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java
index d7633f0e3..76f561213 100644
--- a/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java
+++ b/parameter-object/src/test/java/com/iluwatar/parameter/object/SearchServiceTest.java
@@ -1,6 +1,6 @@
 /*
  * The MIT License
- * Copyright © 2014-2019 Ilkka Seppälä
+ * Copyright © 2014-2021 Ilkka Seppälä
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal

From 903453229cb7d5996f4f52a5f5d88f34e6eb1d5a Mon Sep 17 00:00:00 2001
From: CF <6307904+charlesfinley@users.noreply.github.com>
Date: Thu, 4 Mar 2021 00:19:31 -0500
Subject: [PATCH 232/254] Updated update-method module to JUnit 5 (#1542)

* Updated saga to JUnit 5

* Update fix for CI job in trampoline module

* Updated update-method module to JUnit 5

* Upgraded to latest JUnit Jupiter
JUnit 4 is not needed when using JUnit-Vintage

* Reverted change to access modifier on Trampoline

* Cleanup to resolve code smells

* Formatting

* Formatting

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 pom.xml                                       | 10 +----
 saga/pom.xml                                  |  5 ---
 .../choreography/SagaApplicationTest.java     | 13 +++---
 .../choreography/SagaChoreographyTest.java    | 13 +++---
 .../orchestration/SagaApplicationTest.java    |  8 ++--
 .../SagaOrchestratorInternallyTest.java       | 18 ++++----
 .../orchestration/SagaOrchestratorTest.java   | 13 +++---
 .../com/iluwatar/trampoline/Trampoline.java   |  2 +-
 update-method/pom.xml                         |  4 --
 .../com/iluwatar/updatemethod/AppTest.java    |  6 +--
 .../iluwatar/updatemethod/SkeletonTest.java   | 44 ++++++++++---------
 .../com/iluwatar/updatemethod/StatueTest.java | 29 ++++++------
 .../com/iluwatar/updatemethod/WorldTest.java  | 35 ++++++++-------
 13 files changed, 99 insertions(+), 101 deletions(-)

diff --git a/pom.xml b/pom.xml
index 48fa6fdcf..8b00646c5 100644
--- a/pom.xml
+++ b/pom.xml
@@ -41,8 +41,8 @@
         <spring-data.version>2.0.14.RELEASE</spring-data.version>
         <h2.version>1.4.190</h2.version>
         <junit.version>4.12</junit.version>
-        <junit-jupiter.version>5.5.2</junit-jupiter.version>
-        <junit-vintage.version>${junit.version}.2</junit-vintage.version>
+        <junit-jupiter.version>5.7.1</junit-jupiter.version>
+        <junit-vintage.version>${junit-jupiter.version}</junit-vintage.version>
         <sping-test-junit5.version>1.0.2</sping-test-junit5.version>
         <compiler.version>3.8.1</compiler.version>
         <jacoco.version>0.8.6</jacoco.version>
@@ -274,12 +274,6 @@
                 <artifactId>camel-stream</artifactId>
                 <version>${camel.version}</version>
             </dependency>
-            <dependency>
-                <groupId>junit</groupId>
-                <artifactId>junit</artifactId>
-                <version>${junit.version}</version>
-                <scope>test</scope>
-            </dependency>
             <dependency>
                 <groupId>org.junit.jupiter</groupId>
                 <artifactId>junit-jupiter-api</artifactId>
diff --git a/saga/pom.xml b/saga/pom.xml
index 07d327885..80eb70f75 100644
--- a/saga/pom.xml
+++ b/saga/pom.xml
@@ -35,11 +35,6 @@
 
     <artifactId>saga</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
index 52b407b57..67ac0f2fa 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
@@ -23,18 +23,19 @@
 
 package com.iluwatar.saga.choreography;
 
-import com.iluwatar.saga.orchestration.SagaApplication;
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import com.iluwatar.saga.orchestration.SagaApplication;
+import org.junit.jupiter.api.Test;
+
 
 /***
  * empty test
  */
-public class SagaApplicationTest {
+class SagaApplicationTest {
+
   @Test
-  public void shouldExecuteWithoutException() {
+  void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> SagaApplication.main(new String[]{}));
   }
-}
\ No newline at end of file
+}
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
index b1ddcf13f..749a66ac5 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
@@ -23,24 +23,25 @@
 
 package com.iluwatar.saga.choreography;
 
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
 /**
  * test to check choreography saga
  */
-public class SagaChoreographyTest {
+class SagaChoreographyTest {
 
 
   @Test
-  public void executeTest() {
+  void executeTest() {
     var sd = serviceDiscovery();
     var service = sd.findAny();
     var badOrderSaga = service.execute(newSaga("bad_order"));
     var goodOrderSaga = service.execute(newSaga("good_order"));
 
-    Assert.assertEquals(badOrderSaga.getResult(), Saga.SagaResult.ROLLBACKED);
-    Assert.assertEquals(goodOrderSaga.getResult(), Saga.SagaResult.FINISHED);
+    assertEquals(Saga.SagaResult.ROLLBACKED, badOrderSaga.getResult());
+    assertEquals(Saga.SagaResult.FINISHED, goodOrderSaga.getResult());
   }
 
   private static Saga newSaga(Object value) {
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
index 1ebb9de44..29a2f7eb6 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaApplicationTest.java
@@ -23,15 +23,15 @@
 
 package com.iluwatar.saga.orchestration;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * empty test
  */
-public class SagaApplicationTest {
+class SagaApplicationTest {
 
   @Test
-  public void mainTest() {
+  void mainTest() {
     SagaApplication.main(new String[]{});
   }
-}
\ No newline at end of file
+}
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
index 6a1a257df..23635d1e6 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorInternallyTest.java
@@ -23,28 +23,30 @@
 
 package com.iluwatar.saga.orchestration;
 
+import org.junit.jupiter.api.Test;
+
 import static com.iluwatar.saga.orchestration.Saga.Result;
+import static org.junit.jupiter.api.Assertions.assertArrayEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import java.util.ArrayList;
 import java.util.List;
-import org.junit.Assert;
-import org.junit.Test;
 
 /**
  * test to test orchestration logic
  */
-public class SagaOrchestratorInternallyTest {
+class SagaOrchestratorInternallyTest {
 
   private final List<String> records = new ArrayList<>();
 
   @Test
-  public void executeTest() {
+  void executeTest() {
     var sagaOrchestrator = new SagaOrchestrator(newSaga(), serviceDiscovery());
     var result = sagaOrchestrator.execute(1);
-    Assert.assertEquals(result, Result.ROLLBACK);
-    Assert.assertArrayEquals(
-        records.toArray(new String[]{}),
-        new String[]{"+1", "+2", "+3", "+4", "-4", "-3", "-2", "-1"});
+    assertEquals(Result.ROLLBACK, result);
+    assertArrayEquals(
+            new String[]{"+1", "+2", "+3", "+4", "-4", "-3", "-2", "-1"},
+            records.toArray(new String[]{}));
   }
 
   private static Saga newSaga() {
diff --git a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
index 7dd4c3180..2a1da9981 100644
--- a/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/orchestration/SagaOrchestratorTest.java
@@ -23,22 +23,23 @@
 
 package com.iluwatar.saga.orchestration;
 
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
 /**
  * test to check general logic
  */
-public class SagaOrchestratorTest {
+class SagaOrchestratorTest {
 
   @Test
-  public void execute() {
+  void execute() {
     SagaOrchestrator sagaOrchestrator = new SagaOrchestrator(newSaga(), serviceDiscovery());
     Saga.Result badOrder = sagaOrchestrator.execute("bad_order");
     Saga.Result crashedOrder = sagaOrchestrator.execute("crashed_order");
 
-    Assert.assertEquals(badOrder, Saga.Result.ROLLBACK);
-    Assert.assertEquals(crashedOrder, Saga.Result.CRASHED);
+    assertEquals(Saga.Result.ROLLBACK, badOrder);
+    assertEquals(Saga.Result.CRASHED, crashedOrder);
   }
 
   private static Saga newSaga() {
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
index b28a14803..1d2ea91d3 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/Trampoline.java
@@ -98,7 +98,7 @@ public interface Trampoline<T> {
         return trampoline(this);
       }
 
-      private T trampoline(final Trampoline<T> trampoline) {
+      T trampoline(final Trampoline<T> trampoline) {
         return Stream.iterate(trampoline, Trampoline::jump)
             .filter(Trampoline::complete)
             .findFirst()
diff --git a/update-method/pom.xml b/update-method/pom.xml
index b49ab3c07..b70520a99 100644
--- a/update-method/pom.xml
+++ b/update-method/pom.xml
@@ -35,10 +35,6 @@
 
     <artifactId>update-method</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
index 6158e7491..9c5c2a1e2 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
@@ -23,14 +23,14 @@
 
 package com.iluwatar.updatemethod;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
-public class AppTest {
+class AppTest {
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
+  void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
index 2562180b8..a30dd26cb 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
@@ -23,56 +23,60 @@
 
 package com.iluwatar.updatemethod;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
 
-public class SkeletonTest {
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-  private Skeleton skeleton;
 
-  @Before
-  public void setup() {
+class SkeletonTest {
+
+  private static Skeleton skeleton;
+
+  @BeforeAll
+  public static void setup() {
     skeleton = new Skeleton(1);
   }
 
-  @After
-  public void tearDown() {
+  @AfterAll
+  public static void tearDown() {
     skeleton = null;
   }
 
   @Test
-  public void testUpdateForPatrollingLeft() {
+  void testUpdateForPatrollingLeft() {
     skeleton.patrollingLeft = true;
     skeleton.setPosition(50);
     skeleton.update();
-    Assert.assertEquals(49, skeleton.getPosition());
+    assertEquals(49, skeleton.getPosition());
   }
 
   @Test
-  public void testUpdateForPatrollingRight() {
+  void testUpdateForPatrollingRight() {
     skeleton.patrollingLeft = false;
     skeleton.setPosition(50);
     skeleton.update();
-    Assert.assertEquals(51, skeleton.getPosition());
+    assertEquals(51, skeleton.getPosition());
   }
 
   @Test
-  public void testUpdateForReverseDirectionFromLeftToRight() {
+  void testUpdateForReverseDirectionFromLeftToRight() {
     skeleton.patrollingLeft = true;
     skeleton.setPosition(1);
     skeleton.update();
-    Assert.assertEquals(0, skeleton.getPosition());
-    Assert.assertEquals(false, skeleton.patrollingLeft);
+    assertEquals(0, skeleton.getPosition());
+    assertFalse(skeleton.patrollingLeft);
   }
 
   @Test
-  public void testUpdateForReverseDirectionFromRightToLeft() {
+  void testUpdateForReverseDirectionFromRightToLeft() {
     skeleton.patrollingLeft = false;
     skeleton.setPosition(99);
     skeleton.update();
-    Assert.assertEquals(100, skeleton.getPosition());
-    Assert.assertEquals(true, skeleton.patrollingLeft);
+    assertEquals(100, skeleton.getPosition());
+    assertTrue(skeleton.patrollingLeft);
   }
 }
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
index eea6bbeb1..3b28ffd5d 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/StatueTest.java
@@ -23,36 +23,37 @@
 
 package com.iluwatar.updatemethod;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
 
-public class StatueTest {
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-  private Statue statue;
+class StatueTest {
 
-  @Before
-  public void setup() {
+  private static Statue statue;
+
+  @BeforeAll
+  public static void setup() {
     statue = new Statue(1, 20);
   }
 
-  @After
-  public void tearDown() {
+  @AfterAll
+  public static void tearDown() {
     statue = null;
   }
 
   @Test
-  public void testUpdateForPendingShoot() {
+  void testUpdateForPendingShoot() {
     statue.frames = 10;
     statue.update();
-    Assert.assertEquals(11, statue.frames);
+    assertEquals(11, statue.frames);
   }
 
   @Test
-  public void testUpdateForShooting() {
+  void testUpdateForShooting() {
     statue.frames = 19;
     statue.update();
-    Assert.assertEquals(0, statue.frames);
+    assertEquals(0, statue.frames);
   }
 }
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
index b8d95f140..843c4a654 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/WorldTest.java
@@ -23,41 +23,44 @@
 
 package com.iluwatar.updatemethod;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.AfterAll;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
 
-public class WorldTest {
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-  private World world;
+class WorldTest {
 
-  @Before
-  public void setup() {
+  private static World world;
+
+  @BeforeAll
+  public static void setup() {
     world = new World();
   }
 
-  @After
-  public void tearDown() {
+  @AfterAll
+  public static void tearDown() {
     world = null;
   }
 
   @Test
-  public void testRun() {
+  void testRun() {
     world.run();
-    Assert.assertEquals(true, world.isRunning);
+    assertTrue(world.isRunning);
   }
 
   @Test
-  public void testStop() {
+  void testStop() {
     world.stop();
-    Assert.assertEquals(false, world.isRunning);
+    assertFalse(world.isRunning);
   }
 
   @Test
-  public void testAddEntity() {
+  void testAddEntity() {
     var entity = new Skeleton(1);
     world.addEntity(entity);
-    Assert.assertEquals(entity, world.entities.get(0));
+    assertEquals(entity, world.entities.get(0));
   }
 }

From e9d0b3e98c9d22d8c071c8eca9821929e7bf8e80 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Fri, 5 Mar 2021 23:21:09 +0530
Subject: [PATCH 233/254] remove labeling trigger for PR and actions set to
 master (#1666)

---
 .github/workflows/maven-ci.yml         | 11 ++++-------
 .github/workflows/maven-pr-builder.yml | 11 ++++-------
 2 files changed, 8 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/maven-ci.yml b/.github/workflows/maven-ci.yml
index c42cd4378..f264831bd 100644
--- a/.github/workflows/maven-ci.yml
+++ b/.github/workflows/maven-ci.yml
@@ -40,25 +40,25 @@ jobs:
     steps:
 
     - name: Checkout Code
-      uses: actions/checkout@v2
+      uses: actions/checkout@master
       with:
         # Disabling shallow clone for improving relevancy of SonarQube reporting
         fetch-depth: 0
 
     - name: Set up JDK 11
-      uses: actions/setup-java@v1
+      uses: actions/setup-java@master
       with:
         java-version: 11
 
     - name: Cache SonarCloud packages
-      uses: actions/cache@v2
+      uses: actions/cache@master
       with:
         path: ~/.sonar/cache
         key: ${{ runner.os }}-sonar
         restore-keys: ${{ runner.os }}-sonar
 
     - name: Cache Maven dependencies
-      uses: actions/cache@v2
+      uses: actions/cache@master
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
@@ -69,9 +69,6 @@ jobs:
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
 
-    # The SonarQube analysis is only for the master branch of the main repository.
-    # SonarQube scan does not work for forked repositories try changing it to xvfb-run mvn clean verify
-    # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven and run SonarQube analysis
       run: xvfb-run ./mvnw clean verify org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
       env:
diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 98bbc79e6..f529920ca 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -29,7 +29,7 @@ name: Java PR Builder
 on:
   pull_request:
     branches: [ master ]
-    types: [ opened, reopened, synchronize, labeled, unlabeled ]
+    types: [ opened, reopened, synchronize ]
 
 jobs:
   build:
@@ -38,15 +38,15 @@ jobs:
 
     steps:
     - name: Checkout Code
-      uses: actions/checkout@v2
+      uses: actions/checkout@master
     
     - name: Set up JDK 11
-      uses: actions/setup-java@v1
+      uses: actions/setup-java@master
       with:
         java-version: 11
     
     - name: Cache Maven Dependecies
-      uses: actions/cache@v2
+      uses: actions/cache@master
       with:
         path: ~/.m2/repository
         key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
@@ -57,8 +57,5 @@ jobs:
     - name: Install xvfb
       run: sudo apt-get install -y xvfb
     
-    # This worflow is only for building Pull Requests, the master branch runs Sonar analysis on the main repository.
-    # SonarQube scan does not work for forked repositories.
-    # See https://jira.sonarsource.com/browse/MMF-1371
     - name: Build with Maven
       run: xvfb-run ./mvnw clean verify

From c150871a940d8b8b3afbc4549569b9391b51ba3f Mon Sep 17 00:00:00 2001
From: CF <6307904+charlesfinley@users.noreply.github.com>
Date: Sat, 6 Mar 2021 04:12:46 -0500
Subject: [PATCH 234/254] Update to JUnit5 across all modules (#1668)

* Updated saga to JUnit 5

* Update fix for CI job in trampoline module

* Updated update-method module to JUnit 5

* Upgraded to latest JUnit Jupiter
JUnit 4 is not needed when using JUnit-Vintage

* Reverted change to access modifier on Trampoline

* Cleanup to resolve code smells

* Formatting

* Formatting

* Migrating to JUnit5 and updating some Mockito patterns

* Migrating to JUnit5

* Migrating to JUnit5

* Migrating to JUnit 5

* Formatting cleanup

* Added missing scope for junit

* Fixed tests that were not running previously.

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 arrange-act-assert/pom.xml                    |  4 +-
 .../arrangeactassert/CashAAATest.java         | 19 +++----
 .../arrangeactassert/CashAntiAAATest.java     | 15 +++---
 async-method-invocation/pom.xml               |  5 --
 combinator/pom.xml                            |  6 ---
 .../combinator/CombinatorAppTest.java         | 10 ++--
 .../com/iluwatar/combinator/FinderTest.java   | 17 +++----
 .../com/iluwatar/combinator/FindersTest.java  | 44 ++++++++---------
 double-buffer/pom.xml                         |  4 --
 .../com/iluwatar/doublebuffer/AppTest.java    |  8 +--
 .../doublebuffer/FrameBufferTest.java         | 30 ++++++------
 .../com/iluwatar/doublebuffer/SceneTest.java  | 22 +++++----
 factory/pom.xml                               |  4 --
 game-loop/pom.xml                             |  5 --
 half-sync-half-async/pom.xml                  |  5 --
 leader-followers/pom.xml                      |  5 --
 .../src/test/java/com/AppTest.java            | 10 ++--
 .../src/test/java/com/TaskHandlerTest.java    | 11 +++--
 .../src/test/java/com/TaskSetTest.java        | 17 ++++---
 .../src/test/java/com/WorkCenterTest.java     | 24 ++++-----
 marker/src/test/java/GuardTest.java           |  8 +--
 partial-response/pom.xml                      |  6 ---
 .../partialresponse/VideoResourceTest.java    | 15 +++---
 registry/pom.xml                              |  4 --
 role-object/pom.xml                           |  5 --
 .../roleobject/ApplicationRoleObjectTest.java |  8 +--
 .../iluwatar/roleobject/BorrowerRoleTest.java | 11 +++--
 .../iluwatar/roleobject/CustomerCoreTest.java | 26 +++++-----
 .../iluwatar/roleobject/InvestorRoleTest.java | 11 +++--
 .../com/iluwatar/roleobject/RoleTest.java     | 14 +++---
 .../faas/api/LambdaInfoApiHandlerTest.java    |  7 +--
 sharding/pom.xml                              |  4 --
 .../java/com/iluwatar/sharding/AppTest.java   |  8 +--
 .../sharding/HashShardManagerTest.java        | 21 +++-----
 .../sharding/LookupShardManagerTest.java      | 18 ++++---
 .../sharding/RangeShardManagerTest.java       | 15 +++---
 .../iluwatar/sharding/ShardManagerTest.java   | 41 +++++++---------
 .../java/com/iluwatar/sharding/ShardTest.java | 31 ++++++------
 singleton/pom.xml                             |  4 --
 .../ThreadSafeDoubleCheckLockingTest.java     | 12 +++--
 subclass-sandbox/pom.xml                      |  4 --
 .../com/iluwatar/subclasssandbox/AppTest.java |  8 +--
 .../subclasssandbox/GroundDiveTest.java       | 32 ++++++------
 .../subclasssandbox/SkyLaunchTest.java        | 32 ++++++------
 tolerant-reader/pom.xml                       |  5 --
 .../tolerantreader/RainbowFishSerializer.java |  4 +-
 .../com/iluwatar/tolerantreader/AppTest.java  |  5 +-
 .../RainbowFishSerializerTest.java            | 40 ++++++++-------
 .../tolerantreader/RainbowFishTest.java       |  8 +--
 .../tolerantreader/RainbowFishV2Test.java     |  6 +--
 unit-of-work/pom.xml                          | 10 ----
 .../java/com/iluwatar/unitofwork/AppTest.java |  8 +--
 .../unitofwork/StudentRepositoryTest.java     | 49 +++++++------------
 53 files changed, 333 insertions(+), 412 deletions(-)

diff --git a/arrange-act-assert/pom.xml b/arrange-act-assert/pom.xml
index c0c60f575..e23237197 100644
--- a/arrange-act-assert/pom.xml
+++ b/arrange-act-assert/pom.xml
@@ -36,8 +36,8 @@
   <artifactId>arrange-act-assert</artifactId>
   <dependencies>
     <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
+      <groupId>org.junit.jupiter</groupId>
+      <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
   </dependencies>
diff --git a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
index 3e2d90f6f..96c12b478 100644
--- a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
+++ b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAAATest.java
@@ -23,11 +23,11 @@
 
 package com.iluwatar.arrangeactassert;
 
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertFalse;
-import static org.junit.Assert.assertTrue;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Arrange/Act/Assert (AAA) is a pattern for organizing unit tests. It is a way to structure your
@@ -51,10 +51,11 @@ import org.junit.Test;
  * change and one reason to fail. In a large and complicated code base, tests that honor the single
  * responsibility principle are much easier to troubleshoot.
  */
-public class CashAAATest {
+
+class CashAAATest {
 
   @Test
-  public void testPlus() {
+  void testPlus() {
     //Arrange
     var cash = new Cash(3);
     //Act
@@ -64,7 +65,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testMinus() {
+  void testMinus() {
     //Arrange
     var cash = new Cash(8);
     //Act
@@ -75,7 +76,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testInsufficientMinus() {
+  void testInsufficientMinus() {
     //Arrange
     var cash = new Cash(1);
     //Act
@@ -86,7 +87,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testUpdate() {
+  void testUpdate() {
     //Arrange
     var cash = new Cash(5);
     //Act
diff --git a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
index 5cad10f9c..9fe52ce4c 100644
--- a/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
+++ b/arrange-act-assert/src/test/java/com/iluwatar/arrangeactassert/CashAntiAAATest.java
@@ -23,23 +23,24 @@
 
 package com.iluwatar.arrangeactassert;
 
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertFalse;
-import static org.junit.Assert.assertTrue;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * ({@link CashAAATest}) is an anti-example of AAA pattern. This test is functionally correct, but
- * with the addition of new feature, it needs refactoring. There are an awful lot of steps in that
+ * with the addition of a new feature, it needs refactoring. There are an awful lot of steps in that
  * test method, but it verifies the class' important behavior in just eleven lines. It violates the
  * single responsibility principle. If this test method failed after a small code change, it might
  * take some digging to discover why.
  */
-public class CashAntiAAATest {
+
+class CashAntiAAATest {
 
   @Test
-  public void testCash() {
+  void testCash() {
     //initialize
     var cash = new Cash(3);
     //test plus
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index a5f34729d..910e350a8 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -45,11 +45,6 @@
 			<artifactId>mockito-core</artifactId>
 			<scope>test</scope>
 		</dependency>
-		<dependency>
-			<groupId>junit</groupId>
-			<artifactId>junit</artifactId>
-			<scope>test</scope>
-		</dependency>
 	</dependencies>
 	<build>
 		<plugins>
diff --git a/combinator/pom.xml b/combinator/pom.xml
index 3592c5949..8b8750432 100644
--- a/combinator/pom.xml
+++ b/combinator/pom.xml
@@ -34,12 +34,6 @@
 
   <artifactId>combinator</artifactId>
   <dependencies>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <scope>test</scope>
-    </dependency>
-
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
diff --git a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
index 3aefbf5da..2400496dd 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
@@ -23,11 +23,11 @@
 
 package com.iluwatar.combinator;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
-public class CombinatorAppTest {
+import org.junit.jupiter.api.Test;
+
+class CombinatorAppTest {
 
   /**
    * Issue: Add at least one assertion to this test case.
@@ -37,7 +37,7 @@ public class CombinatorAppTest {
    */
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
+  void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> CombinatorApp.main(new String[]{}));
   }
-}
\ No newline at end of file
+}
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
index 3cef476b4..bbd6e7f1e 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
@@ -23,22 +23,19 @@
 
 package com.iluwatar.combinator;
 
-import org.junit.Assert;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-import java.util.List;
+import org.junit.jupiter.api.Test;
 
-import static org.junit.Assert.*;
-
-public class FinderTest {
+class FinderTest {
 
   @Test
-  public void contains() {
+  void contains() {
     var example = "the first one \nthe second one \n";
 
     var result = Finder.contains("second").find(example);
-    Assert.assertEquals(result.size(),1);
-    Assert.assertEquals(result.get(0),"the second one ");
+    assertEquals(1, result.size());
+    assertEquals("the second one ", result.get(0));
   }
 
-}
\ No newline at end of file
+}
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
index 2827c718b..688ebdf47 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
@@ -23,44 +23,44 @@
 
 package com.iluwatar.combinator;
 
-import org.junit.Assert;
-import org.junit.Test;
+import static com.iluwatar.combinator.Finders.advancedFinder;
+import static com.iluwatar.combinator.Finders.expandedFinder;
+import static com.iluwatar.combinator.Finders.filteredFinder;
+import static com.iluwatar.combinator.Finders.specializedFinder;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-import java.util.List;
+import org.junit.jupiter.api.Test;
 
-import static com.iluwatar.combinator.Finders.*;
-import static org.junit.Assert.*;
-
-public class FindersTest {
+class FindersTest {
 
   @Test
-  public void advancedFinderTest() {
+  void advancedFinderTest() {
     var res = advancedFinder("it was","kingdom","sea").find(text());
-    Assert.assertEquals(res.size(),1);
-    Assert.assertEquals(res.get(0),"It was many and many a year ago,");
+    assertEquals(1, res.size());
+    assertEquals("It was many and many a year ago,", res.get(0));
   }
 
   @Test
-  public void filteredFinderTest() {
+  void filteredFinderTest() {
     var res = filteredFinder(" was ", "many", "child").find(text());
-    Assert.assertEquals(res.size(),1);
-    Assert.assertEquals(res.get(0),"But we loved with a love that was more than love-");
+    assertEquals(1, res.size());
+    assertEquals("But we loved with a love that was more than love-", res.get(0));
   }
 
   @Test
-  public void specializedFinderTest() {
+  void specializedFinderTest() {
     var res = specializedFinder("love","heaven").find(text());
-    Assert.assertEquals(res.size(),1);
-    Assert.assertEquals(res.get(0),"With a love that the winged seraphs of heaven");
+    assertEquals(1, res.size());
+    assertEquals("With a love that the winged seraphs of heaven", res.get(0));
   }
 
   @Test
-  public void expandedFinderTest() {
+  void expandedFinderTest() {
     var res = expandedFinder("It was","kingdom").find(text());
-    Assert.assertEquals(res.size(),3);
-    Assert.assertEquals(res.get(0),"It was many and many a year ago,");
-    Assert.assertEquals(res.get(1),"In a kingdom by the sea,");
-    Assert.assertEquals(res.get(2),"In this kingdom by the sea;");
+    assertEquals(3, res.size());
+    assertEquals("It was many and many a year ago,", res.get(0));
+    assertEquals("In a kingdom by the sea,", res.get(1));
+    assertEquals("In this kingdom by the sea;", res.get(2));
   }
 
 
@@ -80,4 +80,4 @@ public class FindersTest {
             + "Coveted her and me.";
   }
 
-}
\ No newline at end of file
+}
diff --git a/double-buffer/pom.xml b/double-buffer/pom.xml
index 06ceff2e7..191076215 100644
--- a/double-buffer/pom.xml
+++ b/double-buffer/pom.xml
@@ -36,10 +36,6 @@
     <artifactId>double-buffer</artifactId>
 
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
index ceedab0ee..f6e25566f 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
@@ -23,14 +23,14 @@
 
 package com.iluwatar.doublebuffer;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * App unit test.
  */
-public class AppTest {
+class AppTest {
 
   /**
    * Issue: Add at least one assertion to this test case.
@@ -40,7 +40,7 @@ public class AppTest {
    */
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
+  void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
index f0cd6f148..6a0467bec 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/FrameBufferTest.java
@@ -23,17 +23,19 @@
 
 package com.iluwatar.doublebuffer;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.util.Arrays;
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * FrameBuffer unit test.
  */
-public class FrameBufferTest {
+class FrameBufferTest {
 
   @Test
-  public void testClearAll() {
+  void testClearAll() {
     try {
       var field = FrameBuffer.class.getDeclaredField("pixels");
       var pixels = new Pixel[FrameBuffer.HEIGHT * FrameBuffer.WIDTH];
@@ -43,14 +45,14 @@ public class FrameBufferTest {
       field.setAccessible(true);
       field.set(frameBuffer, pixels);
       frameBuffer.clearAll();
-      Assert.assertEquals(Pixel.WHITE, frameBuffer.getPixels()[0]);
+      assertEquals(Pixel.WHITE, frameBuffer.getPixels()[0]);
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 
   @Test
-  public void testClear() {
+  void testClear() {
     try {
       var field = FrameBuffer.class.getDeclaredField("pixels");
       var pixels = new Pixel[FrameBuffer.HEIGHT * FrameBuffer.WIDTH];
@@ -60,21 +62,21 @@ public class FrameBufferTest {
       field.setAccessible(true);
       field.set(frameBuffer, pixels);
       frameBuffer.clear(0, 0);
-      Assert.assertEquals(Pixel.WHITE, frameBuffer.getPixels()[0]);
+      assertEquals(Pixel.WHITE, frameBuffer.getPixels()[0]);
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 
   @Test
-  public void testDraw() {
+  void testDraw() {
     var frameBuffer = new FrameBuffer();
     frameBuffer.draw(0, 0);
-    Assert.assertEquals(Pixel.BLACK, frameBuffer.getPixels()[0]);
+    assertEquals(Pixel.BLACK, frameBuffer.getPixels()[0]);
   }
 
   @Test
-  public void testGetPixels() {
+  void testGetPixels() {
     try {
       var field = FrameBuffer.class.getDeclaredField("pixels");
       var pixels = new Pixel[FrameBuffer.HEIGHT * FrameBuffer.WIDTH];
@@ -83,9 +85,9 @@ public class FrameBufferTest {
       var frameBuffer = new FrameBuffer();
       field.setAccessible(true);
       field.set(frameBuffer, pixels);
-      Assert.assertEquals(pixels, frameBuffer.getPixels());
+      assertEquals(pixels, frameBuffer.getPixels());
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
index 892443e9f..5f4296700 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/SceneTest.java
@@ -23,17 +23,19 @@
 
 package com.iluwatar.doublebuffer;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.util.ArrayList;
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Scene unit tests.
  */
-public class SceneTest {
+class SceneTest {
 
   @Test
-  public void testGetBuffer() {
+  void testGetBuffer() {
     try {
       var scene = new Scene();
       var field1 = Scene.class.getDeclaredField("current");
@@ -46,14 +48,14 @@ public class SceneTest {
       var field2 = Scene.class.getDeclaredField("frameBuffers");
       field2.setAccessible(true);
       field2.set(scene, frameBuffers);
-      Assert.assertEquals(frameBuffer, scene.getBuffer());
+      assertEquals(frameBuffer, scene.getBuffer());
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to access private field.");
+      fail("Fail to access private field.");
     }
   }
 
   @Test
-  public void testDraw() {
+  void testDraw() {
     try {
       var scene = new Scene();
       var field1 = Scene.class.getDeclaredField("current");
@@ -63,10 +65,10 @@ public class SceneTest {
       field2.setAccessible(true);
       field2.set(scene, 1);
       scene.draw(new ArrayList<>());
-      Assert.assertEquals(1, field1.get(scene));
-      Assert.assertEquals(0, field2.get(scene));
+      assertEquals(1, field1.get(scene));
+      assertEquals(0, field2.get(scene));
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to access private field");
+      fail("Fail to access private field");
     }
   }
 }
diff --git a/factory/pom.xml b/factory/pom.xml
index 8167403cd..f6362cf6e 100644
--- a/factory/pom.xml
+++ b/factory/pom.xml
@@ -38,10 +38,6 @@
   <artifactId>junit-jupiter-engine</artifactId>
   <scope>test</scope>
  </dependency>
- <dependency>
- <groupId>junit</groupId>
-  <artifactId>junit</artifactId>
- </dependency>
  </dependencies>
  <build>
  <plugins>
diff --git a/game-loop/pom.xml b/game-loop/pom.xml
index 5dba93496..ad6c4986c 100644
--- a/game-loop/pom.xml
+++ b/game-loop/pom.xml
@@ -35,11 +35,6 @@
 
     <artifactId>game-loop</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
-
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index 7a383b4f7..a6e71b786 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -43,11 +43,6 @@
       <artifactId>mockito-core</artifactId>
       <scope>test</scope>
     </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <scope>test</scope>
-    </dependency>
   </dependencies>
   <build>
     <plugins>
diff --git a/leader-followers/pom.xml b/leader-followers/pom.xml
index 56db4e5f2..49c1bb33e 100644
--- a/leader-followers/pom.xml
+++ b/leader-followers/pom.xml
@@ -32,11 +32,6 @@
     </parent>
     <artifactId>leader-followers</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/leader-followers/src/test/java/com/AppTest.java b/leader-followers/src/test/java/com/AppTest.java
index f586db96d..e764304d6 100644
--- a/leader-followers/src/test/java/com/AppTest.java
+++ b/leader-followers/src/test/java/com/AppTest.java
@@ -23,20 +23,20 @@
 
 package com;
 
-import com.iluwatar.leaderfollowers.App;
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import com.iluwatar.leaderfollowers.App;
+import org.junit.jupiter.api.Test;
+
 /**
  *
  * Application test
  *
  */
-public class AppTest {
+class AppTest {
 
     @Test
-    public void shouldExecuteApplicationWithoutException() {
+    void shouldExecuteApplicationWithoutException() {
         assertDoesNotThrow(() -> App.main(new String[]{}));
     }
 
diff --git a/leader-followers/src/test/java/com/TaskHandlerTest.java b/leader-followers/src/test/java/com/TaskHandlerTest.java
index 0b82e39a6..b3e2f7577 100644
--- a/leader-followers/src/test/java/com/TaskHandlerTest.java
+++ b/leader-followers/src/test/java/com/TaskHandlerTest.java
@@ -23,22 +23,23 @@
 
 package com;
 
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
 import com.iluwatar.leaderfollowers.Task;
 import com.iluwatar.leaderfollowers.TaskHandler;
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Tests for TaskHandler
  */
-public class TaskHandlerTest {
+class TaskHandlerTest {
 
     @Test
-    public void testHandleTask() throws InterruptedException {
+    void testHandleTask() throws InterruptedException {
         var taskHandler = new TaskHandler();
         var handle = new Task(100);
         taskHandler.handleTask(handle);
-        Assert.assertTrue(handle.isFinished());
+        assertTrue(handle.isFinished());
     }
 
 }
diff --git a/leader-followers/src/test/java/com/TaskSetTest.java b/leader-followers/src/test/java/com/TaskSetTest.java
index bfc2c35a9..af5f6b8a0 100644
--- a/leader-followers/src/test/java/com/TaskSetTest.java
+++ b/leader-followers/src/test/java/com/TaskSetTest.java
@@ -23,30 +23,31 @@
 
 package com;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 import com.iluwatar.leaderfollowers.Task;
 import com.iluwatar.leaderfollowers.TaskSet;
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Tests for TaskSet
  */
-public class TaskSetTest {
+class TaskSetTest {
 
     @Test
-    public void testAddTask() throws InterruptedException {
+    void testAddTask() throws InterruptedException {
         var taskSet = new TaskSet();
         taskSet.addTask(new Task(10));
-        Assert.assertTrue(taskSet.getSize() == 1);
+        assertEquals(1, taskSet.getSize());
     }
 
     @Test
-    public void testGetTask() throws InterruptedException {
+    void testGetTask() throws InterruptedException {
         var taskSet = new TaskSet();
         taskSet.addTask(new Task(100));
         Task task = taskSet.getTask();
-        Assert.assertTrue(task.getTime() == 100);
-        Assert.assertTrue(taskSet.getSize() == 0);
+        assertEquals(100, task.getTime());
+        assertEquals(0, taskSet.getSize());
     }
 
 }
diff --git a/leader-followers/src/test/java/com/WorkCenterTest.java b/leader-followers/src/test/java/com/WorkCenterTest.java
index d35a26296..ddbe19cd8 100644
--- a/leader-followers/src/test/java/com/WorkCenterTest.java
+++ b/leader-followers/src/test/java/com/WorkCenterTest.java
@@ -23,43 +23,45 @@
 
 package com;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
 import com.iluwatar.leaderfollowers.TaskHandler;
 import com.iluwatar.leaderfollowers.TaskSet;
 import com.iluwatar.leaderfollowers.WorkCenter;
-import org.junit.Assert;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Tests for WorkCenter
  */
-public class WorkCenterTest {
+class WorkCenterTest {
 
   @Test
-  public void testCreateWorkers() {
+  void testCreateWorkers() {
     var taskSet = new TaskSet();
     var taskHandler = new TaskHandler();
     var workCenter = new WorkCenter();
     workCenter.createWorkers(5, taskSet, taskHandler);
-    Assert.assertEquals(workCenter.getWorkers().size(), 5);
-    Assert.assertEquals(workCenter.getWorkers().get(0), workCenter.getLeader());
+    assertEquals(5, workCenter.getWorkers().size());
+    assertEquals(workCenter.getWorkers().get(0), workCenter.getLeader());
   }
 
   @Test
-  public void testNullLeader() {
+  void testNullLeader() {
     var workCenter = new WorkCenter();
     workCenter.promoteLeader();
-    Assert.assertNull(workCenter.getLeader());
+    assertNull(workCenter.getLeader());
   }
 
   @Test
-  public void testPromoteLeader() {
+  void testPromoteLeader() {
     var taskSet = new TaskSet();
     var taskHandler = new TaskHandler();
     var workCenter = new WorkCenter();
     workCenter.createWorkers(5, taskSet, taskHandler);
     workCenter.removeWorker(workCenter.getLeader());
     workCenter.promoteLeader();
-    Assert.assertEquals(workCenter.getWorkers().size(), 4);
-    Assert.assertEquals(workCenter.getWorkers().get(0), workCenter.getLeader());
+    assertEquals(4, workCenter.getWorkers().size());
+    assertEquals(workCenter.getWorkers().get(0), workCenter.getLeader());
   }
 }
diff --git a/marker/src/test/java/GuardTest.java b/marker/src/test/java/GuardTest.java
index 5ea0eb907..d34fe3bac 100644
--- a/marker/src/test/java/GuardTest.java
+++ b/marker/src/test/java/GuardTest.java
@@ -21,18 +21,18 @@
  * THE SOFTWARE.
  */
 
-import org.junit.jupiter.api.Test;
-
 import static org.hamcrest.CoreMatchers.instanceOf;
 import static org.hamcrest.MatcherAssert.assertThat;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Guard test
  */
-public class GuardTest {
+class GuardTest {
 
   @Test
-  public void testGuard() {
+  void testGuard() {
     var guard = new Guard();
     assertThat(guard, instanceOf(Permission.class));
   }
diff --git a/partial-response/pom.xml b/partial-response/pom.xml
index 64457665b..20e4958d0 100644
--- a/partial-response/pom.xml
+++ b/partial-response/pom.xml
@@ -35,12 +35,6 @@
 
     <artifactId>partial-response</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>org.junit.vintage</groupId>
-            <artifactId>junit-vintage-engine</artifactId>
-            <version>5.4.0</version>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-junit-jupiter</artifactId>
diff --git a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
index 9d8be1b09..a02be215b 100644
--- a/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
+++ b/partial-response/src/test/java/com/iluwatar/partialresponse/VideoResourceTest.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.partialresponse;
 
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+
+import java.util.Map;
 import org.junit.jupiter.api.Assertions;
-import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.extension.ExtendWith;
-import org.mockito.Matchers;
 import org.mockito.Mock;
 import org.mockito.Mockito;
 import org.mockito.junit.jupiter.MockitoExtension;
 
-import java.util.Map;
-
 /**
  * tests {@link VideoResource}.
  */
@@ -44,8 +45,8 @@ class VideoResourceTest {
 
   private static VideoResource resource;
 
-  @BeforeAll
-  static void setUp() {
+  @BeforeEach
+  void setUp() {
     var videos = Map.of(
         1, new Video(1, "Avatar", 178, "epic science fiction film",
             "James Cameron", "English"),
@@ -70,7 +71,7 @@ class VideoResourceTest {
     var fields = new String[]{"id", "title", "length"};
 
     var expectedDetails = "{\"id\": 1,\"title\": \"Avatar\",\"length\": 178}";
-    Mockito.when(fieldJsonMapper.toJson(Matchers.any(Video.class), Matchers.eq(fields))).thenReturn(expectedDetails);
+    Mockito.when(fieldJsonMapper.toJson(any(Video.class), eq(fields))).thenReturn(expectedDetails);
 
     var actualFieldsDetails = resource.getDetails(2, fields);
 
diff --git a/registry/pom.xml b/registry/pom.xml
index c6312713b..2b82d45bf 100644
--- a/registry/pom.xml
+++ b/registry/pom.xml
@@ -41,10 +41,6 @@
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-    </dependency>
   </dependencies>
 
   <build>
diff --git a/role-object/pom.xml b/role-object/pom.xml
index e53ca1747..0c5547f57 100644
--- a/role-object/pom.xml
+++ b/role-object/pom.xml
@@ -34,11 +34,6 @@
 
   <artifactId>role-object</artifactId>
   <dependencies>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-      <scope>test</scope>
-    </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
index 1b02b90f1..c1583fed7 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/ApplicationRoleObjectTest.java
@@ -23,14 +23,14 @@
 
 package com.iluwatar.roleobject;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
-public class ApplicationRoleObjectTest {
+import org.junit.jupiter.api.Test;
+
+class ApplicationRoleObjectTest {
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
+  void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> ApplicationRoleObject.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
index ee7881f19..037296aff 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/BorrowerRoleTest.java
@@ -23,15 +23,16 @@
 
 package com.iluwatar.roleobject;
 
-import org.junit.Assert;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-public class BorrowerRoleTest {
+import org.junit.jupiter.api.Test;
+
+class BorrowerRoleTest {
 
   @Test
-  public void borrowTest() {
+  void borrowTest() {
     var borrowerRole = new BorrowerRole();
     borrowerRole.setName("test");
-    Assert.assertEquals(borrowerRole.borrow(), "Borrower test wants to get some money.");
+    assertEquals("Borrower test wants to get some money.", borrowerRole.borrow());
   }
 }
\ No newline at end of file
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
index acbbfaf02..a17b3034f 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
@@ -23,22 +23,22 @@
 
 package com.iluwatar.roleobject;
 
-import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertFalse;
-import static org.junit.Assert.assertTrue;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
-public class CustomerCoreTest {
+class CustomerCoreTest {
 
   @Test
-  public void addRole() {
+  void addRole() {
     var core = new CustomerCore();
     assertTrue(core.addRole(Role.Borrower));
   }
 
   @Test
-  public void hasRole() {
+  void hasRole() {
     var core = new CustomerCore();
     core.addRole(Role.Borrower);
     assertTrue(core.hasRole(Role.Borrower));
@@ -46,7 +46,7 @@ public class CustomerCoreTest {
   }
 
   @Test
-  public void remRole() {
+  void remRole() {
     var core = new CustomerCore();
     core.addRole(Role.Borrower);
 
@@ -60,7 +60,7 @@ public class CustomerCoreTest {
   }
 
   @Test
-  public void getRole() {
+  void getRole() {
     var core = new CustomerCore();
     core.addRole(Role.Borrower);
 
@@ -76,17 +76,17 @@ public class CustomerCoreTest {
 
 
   @Test
-  public void toStringTest() {
+  void toStringTest() {
     var core = new CustomerCore();
     core.addRole(Role.Borrower);
-    assertEquals(core.toString(), "Customer{roles=[Borrower]}");
+    assertEquals("Customer{roles=[Borrower]}", core.toString());
 
     core = new CustomerCore();
     core.addRole(Role.Investor);
-    assertEquals(core.toString(), "Customer{roles=[Investor]}");
+    assertEquals("Customer{roles=[Investor]}", core.toString());
 
     core = new CustomerCore();
-    assertEquals(core.toString(), "Customer{roles=[]}");
+    assertEquals("Customer{roles=[]}", core.toString());
 
 
   }
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
index ad8bd49f9..dfb4d4c18 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/InvestorRoleTest.java
@@ -23,16 +23,17 @@
 
 package com.iluwatar.roleobject;
 
-import org.junit.Assert;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-public class InvestorRoleTest {
+import org.junit.jupiter.api.Test;
+
+class InvestorRoleTest {
 
   @Test
-  public void investTest() {
+  void investTest() {
     var investorRole = new InvestorRole();
     investorRole.setName("test");
     investorRole.setAmountToInvest(10);
-    Assert.assertEquals(investorRole.invest(), "Investor test has invested 10 dollars");
+    assertEquals("Investor test has invested 10 dollars", investorRole.invest());
   }
 }
\ No newline at end of file
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java b/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
index b8426a3d1..fcce53984 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/RoleTest.java
@@ -23,15 +23,17 @@
 
 package com.iluwatar.roleobject;
 
-import org.junit.Assert;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-public class RoleTest {
+import org.junit.jupiter.api.Test;
+
+class RoleTest {
 
   @Test
-  public void instanceTest() {
+  void instanceTest() {
     var instance = Role.Borrower.instance();
-    Assert.assertTrue(instance.isPresent());
-    Assert.assertEquals(instance.get().getClass(), BorrowerRole.class);
+    assertTrue(instance.isPresent());
+    assertEquals(instance.get().getClass(), BorrowerRole.class);
   }
 }
\ No newline at end of file
diff --git a/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java b/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
index 1f4b59a45..064e15cd8 100644
--- a/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
+++ b/serverless/src/test/java/com/iluwatar/serverless/faas/api/LambdaInfoApiHandlerTest.java
@@ -30,17 +30,14 @@ import static org.mockito.Mockito.when;
 
 import com.amazonaws.services.lambda.runtime.Context;
 import org.junit.jupiter.api.Test;
-import org.junit.runner.RunWith;
-import org.mockito.runners.MockitoJUnitRunner;
 
 /**
  * Unit tests for LambdaInfoApiHandler
  */
-@RunWith(MockitoJUnitRunner.class)
-public class LambdaInfoApiHandlerTest {
+class LambdaInfoApiHandlerTest {
 
   @Test
-  public void handleRequestWithMockContext() {
+  void handleRequestWithMockContext() {
     var lambdaInfoApiHandler = new LambdaInfoApiHandler();
     var context = mock(Context.class);
     when(context.getAwsRequestId()).thenReturn("mock aws request id");
diff --git a/sharding/pom.xml b/sharding/pom.xml
index 05d064f75..36d156b17 100644
--- a/sharding/pom.xml
+++ b/sharding/pom.xml
@@ -36,10 +36,6 @@
     <artifactId>sharding</artifactId>
 
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
index 5c9929531..10eabae78 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/AppTest.java
@@ -23,17 +23,17 @@
 
 package com.iluwatar.sharding;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Unit tests for App class.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void shouldExecuteWithoutException() {
+  void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
diff --git a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
index fb11e210f..0d498a66a 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/HashShardManagerTest.java
@@ -23,22 +23,22 @@
 
 package com.iluwatar.sharding;
 
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * Unit tests for HashShardManager class.
  */
-public class HashShardManagerTest {
+class HashShardManagerTest {
 
   private HashShardManager hashShardManager;
 
   /**
    * Initialize hashShardManager instance.
    */
-  @Before
+  @BeforeEach
   public void setup() {
     hashShardManager = new HashShardManager();
     var shard1 = new Shard(1);
@@ -49,16 +49,11 @@ public class HashShardManagerTest {
     hashShardManager.addNewShard(shard3);
   }
 
-  @After
-  public void tearDown() {
-
-  }
-
   @Test
-  public void testStoreData() {
+  void testStoreData() {
     var data = new Data(1, "test", Data.DataType.TYPE_1);
     hashShardManager.storeData(data);
-    Assert.assertEquals(data, hashShardManager.getShardById(1).getDataById(1));
+    assertEquals(data, hashShardManager.getShardById(1).getDataById(1));
   }
 
 }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
index 84614f86e..f02fd1522 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/LookupShardManagerTest.java
@@ -23,22 +23,24 @@
 
 package com.iluwatar.sharding;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.util.Map;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * Unit tests for LookupShardManager class.
  */
-public class LookupShardManagerTest {
+class LookupShardManagerTest {
 
   private LookupShardManager lookupShardManager;
 
   /**
    * Initialize lookupShardManager instance.
    */
-  @Before
+  @BeforeEach
   public void setup() {
     lookupShardManager = new LookupShardManager();
     var shard1 = new Shard(1);
@@ -50,7 +52,7 @@ public class LookupShardManagerTest {
   }
 
   @Test
-  public void testStoreData() {
+  void testStoreData() {
     try {
       var data = new Data(1, "test", Data.DataType.TYPE_1);
       lookupShardManager.storeData(data);
@@ -59,9 +61,9 @@ public class LookupShardManagerTest {
       var lookupMap = (Map<Integer, Integer>) field.get(lookupShardManager);
       var shardId = lookupMap.get(1);
       var shard = lookupShardManager.getShardById(shardId);
-      Assert.assertEquals(data, shard.getDataById(1));
+      assertEquals(data, shard.getDataById(1));
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
index 75f0e85ad..eab44ab5a 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/RangeShardManagerTest.java
@@ -23,21 +23,22 @@
 
 package com.iluwatar.sharding;
 
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * Unit tests for RangeShardManager class.
  */
-public class RangeShardManagerTest {
+class RangeShardManagerTest {
 
   private RangeShardManager rangeShardManager;
 
   /**
    * Initialize rangeShardManager instance.
    */
-  @Before
+  @BeforeEach
   public void setup() {
     rangeShardManager = new RangeShardManager();
     var shard1 = new Shard(1);
@@ -49,10 +50,10 @@ public class RangeShardManagerTest {
   }
 
   @Test
-  public void testStoreData() {
+  void testStoreData() {
     var data = new Data(1, "test", Data.DataType.TYPE_1);
     rangeShardManager.storeData(data);
-    Assert.assertEquals(data, rangeShardManager.getShardById(1).getDataById(1));
+    assertEquals(data, rangeShardManager.getShardById(1).getDataById(1));
   }
 
 }
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
index fab640ff3..14d0cf244 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
@@ -23,49 +23,46 @@
 
 package com.iluwatar.sharding;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.util.Map;
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * Unit tests for ShardManager class.
  */
-public class ShardManagerTest {
+class ShardManagerTest {
 
   private ShardManager shardManager;
 
   /**
    * Initialize shardManager instance.
    */
-  @Before
-  public void setup() {
+  @BeforeEach
+  void setup() {
     shardManager = new TestShardManager();
   }
 
-  @After
-  public void tearDown() {
-
-  }
-
   @Test
-  public void testAddNewShard() {
+  void testAddNewShard() {
     try {
       var shard = new Shard(1);
       shardManager.addNewShard(shard);
       var field = ShardManager.class.getDeclaredField("shardMap");
       field.setAccessible(true);
       var map = (Map<Integer, Shard>) field.get(shardManager);
-      Assert.assertEquals(1, map.size());
-      Assert.assertEquals(shard, map.get(1));
+      assertEquals(1, map.size());
+      assertEquals(shard, map.get(1));
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 
   @Test
-  public void testRemoveShardById() {
+  void testRemoveShardById() {
     try {
       var shard = new Shard(1);
       shardManager.addNewShard(shard);
@@ -73,19 +70,19 @@ public class ShardManagerTest {
       var field = ShardManager.class.getDeclaredField("shardMap");
       field.setAccessible(true);
       var map = (Map<Integer, Shard>) field.get(shardManager);
-      Assert.assertEquals(true, flag);
-      Assert.assertEquals(0, map.size());
+      assertTrue(flag);
+      assertEquals(0, map.size());
     } catch (IllegalAccessException | NoSuchFieldException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 
   @Test
-  public void testGetShardById() {
+  void testGetShardById() {
     var shard = new Shard(1);
     shardManager.addNewShard(shard);
     var tmpShard = shardManager.getShardById(1);
-    Assert.assertEquals(shard, tmpShard);
+    assertEquals(shard, tmpShard);
   }
 
   class TestShardManager extends ShardManager {
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
index 30a492b01..0b4e73f0d 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardTest.java
@@ -23,50 +23,47 @@
 
 package com.iluwatar.sharding;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import java.util.HashMap;
 import java.util.Map;
-import org.junit.After;
-import org.junit.Assert;
-import org.junit.Before;
-import org.junit.Test;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 
 /**
  * Unit tests for Shard class.
  */
-public class ShardTest {
+class ShardTest {
 
   private Data data;
 
   private Shard shard;
 
-  @Before
+  @BeforeEach
   public void setup() {
     data = new Data(1, "test", Data.DataType.TYPE_1);
     shard = new Shard(1);
   }
 
-  @After
-  public void tearDown() {
-  }
-
   @Test
-  public void testStoreData() {
+  void testStoreData() {
     try {
       shard.storeData(data);
       var field = Shard.class.getDeclaredField("dataStore");
       field.setAccessible(true);
       var dataMap = (Map<Integer, Data>) field.get(shard);
-      Assert.assertEquals(1, dataMap.size());
-      Assert.assertEquals(data, dataMap.get(1));
+      assertEquals(1, dataMap.size());
+      assertEquals(data, dataMap.get(1));
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
 
   }
 
   @Test
-  public void testClearData() {
+  void testClearData() {
     try {
       var dataMap = new HashMap<Integer, Data>();
       dataMap.put(1, data);
@@ -75,9 +72,9 @@ public class ShardTest {
       field.set(shard, dataMap);
       shard.clearData();
       dataMap = (HashMap<Integer, Data>) field.get(shard);
-      Assert.assertEquals(0, dataMap.size());
+      assertEquals(0, dataMap.size());
     } catch (NoSuchFieldException | IllegalAccessException e) {
-      Assert.fail("Fail to modify field access.");
+      fail("Fail to modify field access.");
     }
   }
 }
diff --git a/singleton/pom.xml b/singleton/pom.xml
index 076756f2e..d7e0b354d 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -38,10 +38,6 @@
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
-    <dependency>
-      <groupId>junit</groupId>
-      <artifactId>junit</artifactId>
-    </dependency>
   </dependencies>
   <build>
     <plugins>
diff --git a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
index 3b13fd878..6ad57d62a 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLockingTest.java
@@ -23,15 +23,17 @@
 
 package com.iluwatar.singleton;
 
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
 import java.lang.reflect.InvocationTargetException;
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/29/15 - 19:26 PM.
  *
  * @author Jeroen Meulemeester
  */
-public class ThreadSafeDoubleCheckLockingTest extends SingletonTest<ThreadSafeDoubleCheckLocking> {
+class ThreadSafeDoubleCheckLockingTest extends SingletonTest<ThreadSafeDoubleCheckLocking> {
 
   /**
    * Create a new singleton test instance using the given 'getInstance' method.
@@ -43,12 +45,12 @@ public class ThreadSafeDoubleCheckLockingTest extends SingletonTest<ThreadSafeDo
   /**
    * Test creating new instance by refection.
    */
-  @Test(expected = InvocationTargetException.class)
-  public void testCreatingNewInstanceByRefection() throws Exception {
+  @Test
+  void testCreatingNewInstanceByRefection() throws Exception {
     ThreadSafeDoubleCheckLocking.getInstance();
     var constructor = ThreadSafeDoubleCheckLocking.class.getDeclaredConstructor();
     constructor.setAccessible(true);
-    constructor.newInstance((Object[]) null);
+    assertThrows(InvocationTargetException.class, () -> constructor.newInstance((Object[]) null));
   }
 
 }
diff --git a/subclass-sandbox/pom.xml b/subclass-sandbox/pom.xml
index c2b58a274..6d344049f 100644
--- a/subclass-sandbox/pom.xml
+++ b/subclass-sandbox/pom.xml
@@ -36,10 +36,6 @@
     <artifactId>subclass-sandbox</artifactId>
 
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
         <dependency>
             <groupId>com.github.stefanbirkner</groupId>
             <artifactId>system-lambda</artifactId>
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
index e8d048ead..2902b39e6 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/AppTest.java
@@ -23,17 +23,17 @@
 
 package com.iluwatar.subclasssandbox;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * App unit tests.
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void shouldExecuteWithoutException() {
+  void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
index 88a6afe47..8452e2df7 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
@@ -23,45 +23,45 @@
 
 package com.iluwatar.subclasssandbox;
 
-import com.github.stefanbirkner.systemlambda.Statement;
-import org.junit.Assert;
-import org.junit.Test;
-
 import static com.github.stefanbirkner.systemlambda.SystemLambda.tapSystemOutNormalized;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import com.github.stefanbirkner.systemlambda.Statement;
+import org.junit.jupiter.api.Test;
 
 /**
  * GroundDive unit tests.
  */
-public class GroundDiveTest {
+class GroundDiveTest {
 
   @Test
-  public void testMove() throws Exception {
+  void testMove() throws Exception {
     var groundDive = new GroundDive();
     groundDive.move(1.0, 1.0, 1.0);
     var outputLog = getLogContent(() -> groundDive.move(1.0, 1.0, 1.0));
     var expectedLog = "Move to ( 1.0, 1.0, 1.0 )";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testPlaySound() throws Exception {
+  void testPlaySound() throws Exception {
     var groundDive = new GroundDive();
     var outputLog = getLogContent(() -> groundDive.playSound("SOUND_NAME", 1));
     var expectedLog = "Play SOUND_NAME with volumn 1";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testSpawnParticles() throws Exception {
+  void testSpawnParticles() throws Exception {
     var groundDive = new GroundDive();
     final var outputLog = getLogContent(
             () -> groundDive.spawnParticles("PARTICLE_TYPE", 100));
     final var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testActivate() throws Exception {
+  void testActivate() throws Exception {
     var groundDive = new GroundDive();
     var logs = tapSystemOutNormalized(groundDive::activate)
             .split("\n");
@@ -72,10 +72,10 @@ public class GroundDiveTest {
     final var expectedLog2 = "Play GROUNDDIVE_SOUND with volumn 5";
     final var log3 = getLogContent(logs[2]);
     final var expectedLog3 = "Spawn 20 particle with type GROUNDDIVE_PARTICLE";
-    Assert.assertEquals(logs.length, expectedSize);
-    Assert.assertEquals(log1, expectedLog1);
-    Assert.assertEquals(log2, expectedLog2);
-    Assert.assertEquals(log3, expectedLog3);
+    assertEquals(logs.length, expectedSize);
+    assertEquals(log1, expectedLog1);
+    assertEquals(log2, expectedLog2);
+    assertEquals(log3, expectedLog3);
   }
 
   private String getLogContent(Statement statement) throws Exception {
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
index c0e9e9087..eb9b58406 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
@@ -23,44 +23,44 @@
 
 package com.iluwatar.subclasssandbox;
 
-import com.github.stefanbirkner.systemlambda.Statement;
-import org.junit.Assert;
-import org.junit.Test;
-
 import static com.github.stefanbirkner.systemlambda.SystemLambda.tapSystemOutNormalized;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import com.github.stefanbirkner.systemlambda.Statement;
+import org.junit.jupiter.api.Test;
 
 /**
  * SkyLaunch unit tests.
  */
-public class SkyLaunchTest {
+class SkyLaunchTest {
 
   @Test
-  public void testMove() throws Exception {
+  void testMove() throws Exception {
     var skyLaunch = new SkyLaunch();
     var outputLog = getLogContent(() -> skyLaunch.move(1.0, 1.0, 1.0));
     var expectedLog = "Move to ( 1.0, 1.0, 1.0 )";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testPlaySound() throws Exception {
+  void testPlaySound() throws Exception {
     var skyLaunch = new SkyLaunch();
     var outputLog = getLogContent(() -> skyLaunch.playSound("SOUND_NAME", 1));
     var expectedLog = "Play SOUND_NAME with volumn 1";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testSpawnParticles() throws Exception {
+  void testSpawnParticles() throws Exception {
     var skyLaunch = new SkyLaunch();
     var outputLog = getLogContent(
             () -> skyLaunch.spawnParticles("PARTICLE_TYPE", 100));
     var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
-    Assert.assertEquals(outputLog, expectedLog);
+    assertEquals(outputLog, expectedLog);
   }
 
   @Test
-  public void testActivate() throws Exception {
+  void testActivate() throws Exception {
     var skyLaunch = new SkyLaunch();
     var logs = tapSystemOutNormalized(skyLaunch::activate)
             .split("\n");
@@ -71,10 +71,10 @@ public class SkyLaunchTest {
     final var expectedLog2 = "Play SKYLAUNCH_SOUND with volumn 1";
     final var log3 = getLogContent(logs[2]);
     final var expectedLog3 = "Spawn 100 particle with type SKYLAUNCH_PARTICLE";
-    Assert.assertEquals(logs.length, expectedSize);
-    Assert.assertEquals(log1, expectedLog1);
-    Assert.assertEquals(log2, expectedLog2);
-    Assert.assertEquals(log3, expectedLog3);
+    assertEquals(logs.length, expectedSize);
+    assertEquals(log1, expectedLog1);
+    assertEquals(log2, expectedLog2);
+    assertEquals(log3, expectedLog3);
   }
 
   private String getLogContent(Statement statement) throws Exception {
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index c869c98f4..a0c610514 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -38,11 +38,6 @@
       <artifactId>junit-jupiter-engine</artifactId>
       <scope>test</scope>
     </dependency>
-    <dependency>
-      <groupId>org.junit.jupiter</groupId>
-      <artifactId>junit-jupiter-migrationsupport</artifactId>
-      <scope>test</scope>
-    </dependency>
   </dependencies>
   <build>
     <plugins>
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
index 6981c332e..9901126f6 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
@@ -68,7 +68,7 @@ public final class RainbowFishSerializer {
     var map = Map.of(
         "name", rainbowFish.getName(),
         "age", String.format("%d", rainbowFish.getAge()),
-            "lengthMeters", String.format("%d", rainbowFish.getLengthMeters()),
+            LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
             WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons()),
         "angry", Boolean.toString(rainbowFish.getAngry()),
         "hungry", Boolean.toString(rainbowFish.getHungry()),
@@ -95,7 +95,7 @@ public final class RainbowFishSerializer {
     return new RainbowFish(
         map.get("name"),
         Integer.parseInt(map.get("age")),
-        Integer.parseInt(map.get("lengthMeters")),
+        Integer.parseInt(map.get(LENGTH_METERS)),
         Integer.parseInt(map.get(WEIGHT_TONS))
     );
   }
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
index 77d4276ff..bcb1f49a4 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java
@@ -23,14 +23,13 @@
 
 package com.iluwatar.tolerantreader;
 
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
 import java.io.File;
-import java.io.IOException;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
-import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
-
 /**
  * Application test
  */
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
index a6676bab0..451357c14 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishSerializerTest.java
@@ -25,26 +25,32 @@ package com.iluwatar.tolerantreader;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotSame;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import java.io.File;
-import org.junit.Rule;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
-import org.junit.jupiter.migrationsupport.rules.EnableRuleMigrationSupport;
-import org.junit.rules.TemporaryFolder;
+import org.junit.jupiter.api.io.TempDir;
 
 /**
  * Date: 12/30/15 - 18:39 PM
  *
  * @author Jeroen Meulemeester
  */
-@EnableRuleMigrationSupport
-public class RainbowFishSerializerTest {
+
+class RainbowFishSerializerTest {
 
   /**
    * Create a temporary folder, used to generate files in during this test
    */
-  @Rule
-  public final TemporaryFolder testFolder = new TemporaryFolder();
+  @TempDir
+  static Path testFolder;
+
+  @BeforeEach
+  void beforeEach() {
+    assertTrue(Files.isDirectory(testFolder));
+  }
 
   /**
    * Rainbow fish version 1 used during the tests
@@ -60,11 +66,11 @@ public class RainbowFishSerializerTest {
    * Verify if a fish, written as version 1 can be read back as version 1
    */
   @Test
-  public void testWriteV1ReadV1() throws Exception {
-    final var outputFile = this.testFolder.newFile();
-    RainbowFishSerializer.writeV1(V1, outputFile.getPath());
+  void testWriteV1ReadV1() throws Exception {
+    final var outputPath = Files.createFile(testFolder.resolve("outputFile"));
+    RainbowFishSerializer.writeV1(V1, outputPath.toString());
 
-    final var fish = RainbowFishSerializer.readV1(outputFile.getPath());
+    final var fish = RainbowFishSerializer.readV1(outputPath.toString());
     assertNotSame(V1, fish);
     assertEquals(V1.getName(), fish.getName());
     assertEquals(V1.getAge(), fish.getAge());
@@ -77,11 +83,11 @@ public class RainbowFishSerializerTest {
    * Verify if a fish, written as version 2 can be read back as version 1
    */
   @Test
-  public void testWriteV2ReadV1() throws Exception {
-    final var outputFile = this.testFolder.newFile();
-    RainbowFishSerializer.writeV2(V2, outputFile.getPath());
+  void testWriteV2ReadV1() throws Exception {
+    final var outputPath = Files.createFile(testFolder.resolve("outputFile2"));
+    RainbowFishSerializer.writeV2(V2, outputPath.toString());
 
-    final var fish = RainbowFishSerializer.readV1(outputFile.getPath());
+    final var fish = RainbowFishSerializer.readV1(outputPath.toString());
     assertNotSame(V2, fish);
     assertEquals(V2.getName(), fish.getName());
     assertEquals(V2.getAge(), fish.getAge());
@@ -89,4 +95,4 @@ public class RainbowFishSerializerTest {
     assertEquals(V2.getWeightTons(), fish.getWeightTons());
   }
 
-}
\ No newline at end of file
+}
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
index f743140d7..52e1fad38 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishTest.java
@@ -23,22 +23,22 @@
 
 package com.iluwatar.tolerantreader;
 
-import static org.junit.Assert.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/30/15 - 18:34 PM
  *
  * @author Jeroen Meulemeester
  */
-public class RainbowFishTest {
+class RainbowFishTest {
 
   /**
    * Verify if the getters of a {@link RainbowFish} return the expected values
    */
   @Test
-  public void testValues() {
+  void testValues() {
     final var fish = new RainbowFish("name", 1, 2, 3);
     assertEquals("name", fish.getName());
     assertEquals(1, fish.getAge());
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
index c23a74381..101ca701d 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
@@ -27,20 +27,20 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import org.junit.Test;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/30/15 - 18:35 PM
  *
  * @author Jeroen Meulemeester
  */
-public class RainbowFishV2Test {
+class RainbowFishV2Test {
 
   /**
    * Verify if the getters of a {@link RainbowFish} return the expected values
    */
   @Test
-  public void testValues() {
+  void testValues() {
     final var fish = new RainbowFishV2("name", 1, 2, 3, false, true, false);
     assertEquals("name", fish.getName());
     assertEquals(1, fish.getAge());
diff --git a/unit-of-work/pom.xml b/unit-of-work/pom.xml
index 1770a9742..82404b3bc 100644
--- a/unit-of-work/pom.xml
+++ b/unit-of-work/pom.xml
@@ -35,19 +35,9 @@
 
     <artifactId>unit-of-work</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-        </dependency>
-        <dependency>
-            <groupId>org.junit.vintage</groupId>
-            <artifactId>junit-vintage-engine</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
-            <version>5.0.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
index 79ece6058..99e582be1 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/AppTest.java
@@ -23,17 +23,17 @@
 
 package com.iluwatar.unitofwork;
 
-import org.junit.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * AppTest
  */
-public class AppTest {
+class AppTest {
 
   @Test
-  public void shouldExecuteWithoutException() {
+  void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
index e00340d84..760d4a21b 100644
--- a/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
+++ b/unit-of-work/src/test/java/com/iluwatar/unitofwork/StudentRepositoryTest.java
@@ -23,43 +23,32 @@
 
 package com.iluwatar.unitofwork;
 
-import static org.junit.Assert.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.never;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.verifyNoMoreInteractions;
-import static org.mockito.Mockito.verifyZeroInteractions;
 
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-import org.junit.Before;
-import org.junit.Test;
-import org.junit.runner.RunWith;
-import org.mockito.Mock;
-import org.mockito.runners.MockitoJUnitRunner;
+import org.junit.jupiter.api.Test;
 
 /**
  * tests {@link StudentRepository}
  */
-@RunWith(MockitoJUnitRunner.class)
-public class StudentRepositoryTest {
+
+class StudentRepositoryTest {
   private final Student student1 = new Student(1, "Ram", "street 9, cupertino");
   private final Student student2 = new Student(1, "Sham", "Z bridge, pune");
 
-  private Map<String, List<Student>> context;
-  @Mock
-  private StudentDatabase studentDatabase;
-  private StudentRepository studentRepository;
-
-  @Before
-  public void setUp() {
-    context = new HashMap<>();
-    studentRepository = new StudentRepository(context, studentDatabase);
-  }
+  private final Map<String, List<Student>> context = new HashMap<>();
+  private final StudentDatabase studentDatabase = mock(StudentDatabase.class);
+  private final StudentRepository studentRepository = new StudentRepository(context, studentDatabase);;
 
   @Test
-  public void shouldSaveNewStudentWithoutWritingToDb() {
+  void shouldSaveNewStudentWithoutWritingToDb() {
     studentRepository.registerNew(student1);
     studentRepository.registerNew(student2);
 
@@ -68,7 +57,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldSaveDeletedStudentWithoutWritingToDb() {
+  void shouldSaveDeletedStudentWithoutWritingToDb() {
     studentRepository.registerDeleted(student1);
     studentRepository.registerDeleted(student2);
 
@@ -77,7 +66,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldSaveModifiedStudentWithoutWritingToDb() {
+  void shouldSaveModifiedStudentWithoutWritingToDb() {
     studentRepository.registerModified(student1);
     studentRepository.registerModified(student2);
 
@@ -86,7 +75,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldSaveAllLocalChangesToDb() {
+  void shouldSaveAllLocalChangesToDb() {
     context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
     context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
     context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
@@ -99,7 +88,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldNotWriteToDbIfContextIsNull() {
+  void shouldNotWriteToDbIfContextIsNull() {
     var studentRepository = new StudentRepository(null, studentDatabase);
 
     studentRepository.commit();
@@ -108,16 +97,16 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldNotWriteToDbIfNothingToCommit() {
+  void shouldNotWriteToDbIfNothingToCommit() {
     var studentRepository = new StudentRepository(new HashMap<>(), studentDatabase);
 
     studentRepository.commit();
 
-    verifyZeroInteractions(studentDatabase);
+    verifyNoMoreInteractions(studentDatabase);
   }
 
   @Test
-  public void shouldNotInsertToDbIfNoRegisteredStudentsToBeCommitted() {
+  void shouldNotInsertToDbIfNoRegisteredStudentsToBeCommitted() {
     context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
     context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
 
@@ -127,7 +116,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldNotModifyToDbIfNotRegisteredStudentsToBeCommitted() {
+  void shouldNotModifyToDbIfNotRegisteredStudentsToBeCommitted() {
     context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
     context.put(UnitActions.DELETE.getActionValue(), List.of(student1));
 
@@ -137,7 +126,7 @@ public class StudentRepositoryTest {
   }
 
   @Test
-  public void shouldNotDeleteFromDbIfNotRegisteredStudentsToBeCommitted() {
+  void shouldNotDeleteFromDbIfNotRegisteredStudentsToBeCommitted() {
     context.put(UnitActions.INSERT.getActionValue(), List.of(student1));
     context.put(UnitActions.MODIFY.getActionValue(), List.of(student1));
 
@@ -145,4 +134,4 @@ public class StudentRepositoryTest {
 
     verify(studentDatabase, never()).delete(student1);
   }
-}
\ No newline at end of file
+}

From b423002e6ca877890cbeff9fd5079553af669e6d Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sat, 6 Mar 2021 16:56:02 +0530
Subject: [PATCH 235/254] updated Random() to SecureRandom() (#1670)

* updated Random() to SecureRandom()

* batch 2 of SecureRandom updates
---
 commander/src/main/java/com/iluwatar/commander/Order.java   | 4 ++--
 commander/src/main/java/com/iluwatar/commander/Retry.java   | 4 ++--
 commander/src/main/java/com/iluwatar/commander/Service.java | 5 +++--
 .../java/com/iluwatar/event/asynchronous/EventManager.java  | 6 +++---
 game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java | 4 ++--
 .../java/com/iluwatar/hexagonal/domain/LotteryNumbers.java  | 4 ++--
 .../java/com/iluwatar/hexagonal/sampledata/SampleData.java  | 4 ++--
 .../src/main/java/com/iluwatar/leaderfollowers/App.java     | 4 ++--
 .../java/com/iluwatar/masterworker/ArrayUtilityMethods.java | 4 ++--
 .../main/java/com/iluwatar/producer/consumer/Producer.java  | 4 ++--
 .../main/java/com/iluwatar/sharding/LookupShardManager.java | 4 ++--
 .../src/main/java/com/iluwatar/spatialpartition/App.java    | 4 ++--
 .../src/main/java/com/iluwatar/spatialpartition/Bubble.java | 4 ++--
 .../src/main/java/com/iluwatar/typeobject/CellPool.java     | 4 ++--
 .../src/main/java/com/iluwatar/updatemethod/World.java      | 4 ++--
 15 files changed, 32 insertions(+), 31 deletions(-)

diff --git a/commander/src/main/java/com/iluwatar/commander/Order.java b/commander/src/main/java/com/iluwatar/commander/Order.java
index ffc93cb59..ff2909237 100644
--- a/commander/src/main/java/com/iluwatar/commander/Order.java
+++ b/commander/src/main/java/com/iluwatar/commander/Order.java
@@ -23,8 +23,8 @@
 
 package com.iluwatar.commander;
 
+import java.security.SecureRandom;
 import java.util.Hashtable;
-import java.util.Random;
 
 /**
  * Order class holds details of the order.
@@ -45,7 +45,7 @@ public class Order { //can store all transactions ids also
   public final String id;
   final float price;
   final long createdTime;
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
   private static final String ALL_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";
   private static final Hashtable<String, Boolean> USED_IDS = new Hashtable<String, Boolean>();
   PaymentStatus paid;
diff --git a/commander/src/main/java/com/iluwatar/commander/Retry.java b/commander/src/main/java/com/iluwatar/commander/Retry.java
index e22990412..440e52f19 100644
--- a/commander/src/main/java/com/iluwatar/commander/Retry.java
+++ b/commander/src/main/java/com/iluwatar/commander/Retry.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.commander;
 
+import java.security.SecureRandom;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
-import java.util.Random;
 import java.util.concurrent.atomic.AtomicInteger;
 import java.util.function.Predicate;
 
@@ -56,7 +56,7 @@ public class Retry<T> {
     void handleIssue(T obj, Exception e);
   }
 
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
 
   private final Operation op;
   private final HandleErrorIssue<T> handleError;
diff --git a/commander/src/main/java/com/iluwatar/commander/Service.java b/commander/src/main/java/com/iluwatar/commander/Service.java
index 16f3da1dc..f063efd40 100644
--- a/commander/src/main/java/com/iluwatar/commander/Service.java
+++ b/commander/src/main/java/com/iluwatar/commander/Service.java
@@ -24,10 +24,11 @@
 package com.iluwatar.commander;
 
 import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
+
+import java.security.SecureRandom;
 import java.util.ArrayList;
 import java.util.Hashtable;
 import java.util.List;
-import java.util.Random;
 
 /**
  * Service class is an abstract class extended by all services in this example. They all have a
@@ -42,7 +43,7 @@ public abstract class Service {
 
   protected final Database database;
   public ArrayList<Exception> exceptionsList;
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
   private static final String ALL_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";
   private static final Hashtable<String, Boolean> USED_IDS = new Hashtable<>();
 
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
index 400920705..abd3e9be4 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
@@ -23,8 +23,8 @@
 
 package com.iluwatar.event.asynchronous;
 
+import java.security.SecureRandom;
 import java.util.Map;
-import java.util.Random;
 import java.util.concurrent.ConcurrentHashMap;
 
 /**
@@ -43,7 +43,7 @@ public class EventManager implements ThreadCompleteListener {
   public static final int MAX_ID = MAX_RUNNING_EVENTS;
   public static final int MAX_EVENT_TIME = 1800; // in seconds / 30 minutes.
   private int currentlyRunningSyncEvent = -1;
-  private final Random rand;
+  private final SecureRandom rand;
   private final Map<Integer, Event> eventPool;
 
   private static final String DOES_NOT_EXIST = " does not exist.";
@@ -52,7 +52,7 @@ public class EventManager implements ThreadCompleteListener {
    * EventManager constructor.
    */
   public EventManager() {
-    rand = new Random(1);
+    rand = new SecureRandom();
     eventPool = new ConcurrentHashMap<Integer, Event>(MAX_RUNNING_EVENTS);
 
   }
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
index 1ed1e9771..739b47a16 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/GameLoop.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.gameloop;
 
-import java.util.Random;
+import java.security.SecureRandom;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -80,7 +80,7 @@ public abstract class GameLoop {
    */
   protected void processInput() {
     try {
-      var lag = new Random().nextInt(200) + 50;
+      var lag = new SecureRandom().nextInt(200) + 50;
       Thread.sleep(lag);
     } catch (InterruptedException e) {
       logger.error(e.getMessage());
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
index 3e46b8113..4672b7688 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
@@ -24,10 +24,10 @@
 package com.iluwatar.hexagonal.domain;
 
 import com.google.common.base.Joiner;
+import java.security.SecureRandom;
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.PrimitiveIterator;
-import java.util.Random;
 import java.util.Set;
 
 /**
@@ -126,7 +126,7 @@ public class LotteryNumbers {
      * @param max the max value (inclusive)
      */
     public RandomNumberGenerator(int min, int max) {
-      randomIterator = new Random().ints(min, max + 1).iterator();
+      randomIterator = new SecureRandom().ints(min, max + 1).iterator();
     }
 
     /**
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
index 130f3b92e..9baa35179 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/sampledata/SampleData.java
@@ -30,9 +30,9 @@ import com.iluwatar.hexagonal.domain.LotteryService;
 import com.iluwatar.hexagonal.domain.LotteryTicket;
 import com.iluwatar.hexagonal.domain.LotteryTicketId;
 import com.iluwatar.hexagonal.domain.PlayerDetails;
+import java.security.SecureRandom;
 import java.util.AbstractMap.SimpleEntry;
 import java.util.List;
-import java.util.Random;
 import java.util.stream.Collectors;
 
 /**
@@ -41,7 +41,7 @@ import java.util.stream.Collectors;
 public class SampleData {
 
   private static final List<PlayerDetails> PLAYERS;
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
 
   static {
     PLAYERS = List.of(
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
index 924483e0b..b28331b1c 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/App.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.leaderfollowers;
 
-import java.util.Random;
+import java.security.SecureRandom;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 
@@ -84,7 +84,7 @@ public class App {
    * Add tasks.
    */
   private static void addTasks(TaskSet taskSet) throws InterruptedException {
-    var rand = new Random();
+    var rand = new SecureRandom();
     for (var i = 0; i < 5; i++) {
       var time = Math.abs(rand.nextInt(1000));
       taskSet.addTask(new Task(time));
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
index 1be04a7aa..c4ca47b95 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.masterworker;
 
-import java.util.Random;
+import java.security.SecureRandom;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -35,7 +35,7 @@ public class ArrayUtilityMethods {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(ArrayUtilityMethods.class);
 
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
 
   /**
    * Method arraysSame compares 2 arrays @param a1 and @param a2 and @return whether their values
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
index 010c5f93c..e34de106d 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.producer.consumer;
 
-import java.util.Random;
+import java.security.SecureRandom;
 
 /**
  * Class responsible for producing unit of work that can be expressed as {@link Item} and submitted
@@ -31,7 +31,7 @@ import java.util.Random;
  */
 public class Producer {
 
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
 
   private final ItemQueue queue;
 
diff --git a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
index ba530f15a..2e23bc946 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
@@ -23,9 +23,9 @@
 
 package com.iluwatar.sharding;
 
+import java.security.SecureRandom;
 import java.util.HashMap;
 import java.util.Map;
-import java.util.Random;
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -58,7 +58,7 @@ public class LookupShardManager extends ShardManager {
       return lookupMap.get(key);
     } else {
       var shardCount = shardMap.size();
-      return new Random().nextInt(shardCount - 1) + 1;
+      return new SecureRandom().nextInt(shardCount - 1) + 1;
     }
   }
 
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
index 5534fde5d..6138cc5d9 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
@@ -23,8 +23,8 @@
 
 package com.iluwatar.spatialpartition;
 
+import java.security.SecureRandom;
 import java.util.HashMap;
-import java.util.Random;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -112,7 +112,7 @@ public class App {
   public static void main(String[] args) {
     var bubbles1 = new HashMap<Integer, Bubble>();
     var bubbles2 = new HashMap<Integer, Bubble>();
-    var rand = new Random();
+    var rand = new SecureRandom();
     for (int i = 0; i < 10000; i++) {
       var b = new Bubble(rand.nextInt(300), rand.nextInt(300), i, rand.nextInt(2) + 1);
       bubbles1.put(i, b);
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
index a9a9d4562..668da581e 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
@@ -23,9 +23,9 @@
 
 package com.iluwatar.spatialpartition;
 
+import java.security.SecureRandom;
 import java.util.Collection;
 import java.util.HashMap;
-import java.util.Random;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -36,7 +36,7 @@ import org.slf4j.LoggerFactory;
 
 public class Bubble extends Point<Bubble> {
   private static final Logger LOGGER = LoggerFactory.getLogger(Bubble.class);
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
 
   final int radius;
 
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
index 3ca79cab6..5f49a3a2c 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CellPool.java
@@ -26,9 +26,9 @@ package com.iluwatar.typeobject;
 import com.iluwatar.typeobject.Candy.Type;
 
 import java.io.IOException;
+import java.security.SecureRandom;
 import java.util.ArrayList;
 import java.util.List;
-import java.util.Random;
 import org.json.simple.parser.ParseException;
 
 /**
@@ -38,7 +38,7 @@ import org.json.simple.parser.ParseException;
  */
 
 public class CellPool {
-  private static final Random RANDOM = new Random();
+  private static final SecureRandom RANDOM = new SecureRandom();
   public static final String FRUIT = "fruit";
   public static final String CANDY = "candy";
   List<Cell> pool;
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/World.java b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
index 89f8d726f..696fca5c0 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/World.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
@@ -23,9 +23,9 @@
 
 package com.iluwatar.updatemethod;
 
+import java.security.SecureRandom;
 import java.util.ArrayList;
 import java.util.List;
-import java.util.Random;
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -66,7 +66,7 @@ public class World {
    */
   private void processInput() {
     try {
-      int lag = new Random().nextInt(200) + 50;
+      int lag = new SecureRandom().nextInt(200) + 50;
       Thread.sleep(lag);
     } catch (InterruptedException e) {
       LOGGER.error(e.getMessage());

From 0e26a6adb5fd04470d3917642d903258159c953a Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 7 Mar 2021 22:46:50 +0530
Subject: [PATCH 236/254] Use property to set version and update dependencies 
 (#1671)

* formatting and versioning

* updated versions

* reverted checkstyle plugin version
---
 pom.xml | 34 +++++++++++++++++++++++++---------
 1 file changed, 25 insertions(+), 9 deletions(-)

diff --git a/pom.xml b/pom.xml
index 8b00646c5..54944b78c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -27,11 +27,14 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
+    
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
     <version>1.24.0-SNAPSHOT</version>
     <packaging>pom</packaging>
+
     <inceptionYear>2014-2021</inceptionYear>
+
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <sonar-maven-plugin.version>3.8.0.2131</sonar-maven-plugin.version>
@@ -65,6 +68,14 @@
         <system-lambda.version>1.1.0</system-lambda.version>
         <urm.version>2.0.0</urm.version>
         <mockito-junit-jupiter.version>3.5.0</mockito-junit-jupiter.version>
+        <byte-buddy.version>1.10.21</byte-buddy.version>
+        <javassist.version>3.27.0-GA</javassist.version>
+        <maven-surefire-plugin.version>3.0.0-M5</maven-surefire-plugin.version>
+        <maven-checkstyle-plugin.version>3.1.0</maven-checkstyle-plugin.version>
+        <directory-maven-plugin.version>0.3.1</directory-maven-plugin.version>
+        <license-maven-plugin.version>3.0</license-maven-plugin.version>
+        <urm-maven-plugin.version>1.4.8</urm-maven-plugin.version>
+
         <!-- SonarCloud -->
         <sonar.host.url>https://sonarcloud.io</sonar.host.url>
         <sonar.organization>iluwatar</sonar.organization>
@@ -72,6 +83,7 @@
         <sonar.moduleKey>${project.artifactId}</sonar.moduleKey>
         <sonar.projectName>Java Design Patterns</sonar.projectName>
     </properties>
+
     <modules>
         <module>abstract-factory</module>
         <module>tls</module>
@@ -223,13 +235,13 @@
             <dependency>
                 <groupId>net.bytebuddy</groupId>
                 <artifactId>byte-buddy</artifactId>
-                <version>1.9.7</version>
+                <version>${byte-buddy.version}</version>
                 <scope>test</scope>
             </dependency>
             <dependency>
                 <groupId>net.bytebuddy</groupId>
                 <artifactId>byte-buddy-agent</artifactId>
-                <version>1.9.7</version>
+                <version>${byte-buddy.version}</version>
                 <scope>test</scope>
             </dependency>
             <dependency>
@@ -354,7 +366,7 @@
             <dependency>
                 <groupId>org.javassist</groupId>
                 <artifactId>javassist</artifactId>
-                <version>3.26.0-GA</version>
+                <version>${javassist.version}</version>
             </dependency>
             <dependency>
                 <groupId>com.github.stefanbirkner</groupId>
@@ -395,16 +407,19 @@
                         <target>11</target>
                     </configuration>
                 </plugin>
+
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-surefire-plugin</artifactId>
-                    <version>3.0.0-M5</version>
+                    <version>${maven-surefire-plugin.version}</version>
                 </plugin>
+
                 <plugin>
                     <groupId>org.springframework.boot</groupId>
                     <artifactId>spring-boot-maven-plugin</artifactId>
                     <version>${spring-boot.version}</version>
                 </plugin>
+
                 <!-- Maven assembly plugin template for all child project to follow -->
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
@@ -427,6 +442,7 @@
                         </execution>
                     </executions>
                 </plugin>
+
                 <plugin>
                     <groupId>org.sonarsource.scanner.maven</groupId>
                     <artifactId>sonar-maven-plugin</artifactId>
@@ -439,7 +455,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-checkstyle-plugin</artifactId>
-                <version>3.1.0</version>
+                <version>${maven-checkstyle-plugin.version}</version>
                 <executions>
                     <execution>
                         <id>validate</id>
@@ -465,7 +481,7 @@
             <plugin>
                 <groupId>org.commonjava.maven.plugins</groupId>
                 <artifactId>directory-maven-plugin</artifactId>
-                <version>0.3.1</version>
+                <version>${directory-maven-plugin.version}</version>
                 <executions>
                     <execution>
                         <id>directories</id>
@@ -483,10 +499,11 @@
                     </execution>
                 </executions>
             </plugin>
+
             <plugin>
                 <groupId>com.mycila</groupId>
                 <artifactId>license-maven-plugin</artifactId>
-                <version>3.0</version>
+                <version>${license-maven-plugin.version}</version>
                 <configuration>
                     <header>com/mycila/maven/plugin/license/templates/MIT.txt</header>
                     <properties>
@@ -537,7 +554,7 @@
             <plugin>
                 <groupId>com.iluwatar.urm</groupId>
                 <artifactId>urm-maven-plugin</artifactId>
-                <version>1.4.8</version>
+                <version>${urm-maven-plugin.version}</version>
                 <configuration>
                     <!-- if outputDirectory is not set explicitly it will default to your build dir -->
                     <outputDirectory>${project.basedir}/etc</outputDirectory>
@@ -557,7 +574,6 @@
                     </execution>
                 </executions>
             </plugin>
-
         </plugins>
     </build>
 </project>

From 5cf2fe009bc2c04dab737d41523576c6149e605c Mon Sep 17 00:00:00 2001
From: va1m <vadims.public.box@gmail.com>
Date: Sat, 13 Mar 2021 13:19:21 +0100
Subject: [PATCH 237/254] =?UTF-8?q?=F0=9F=93=8DUse=20lombok,=20reformat,?=
 =?UTF-8?q?=20and=20optimize=20the=20code=20(#1560)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Use lombok, reformat, and optimize the code

* Fix merge conflicts and some sonar issues

Co-authored-by: va1m <va1m@email.com>
---
 .../com/iluwatar/abstractdocument/App.java    |   6 +-
 .../AbstractDocumentTest.java                 |  17 ++-
 .../iluwatar/abstractdocument/DomainTest.java |  13 ++-
 .../com/iluwatar/abstractfactory/App.java     |  22 ++--
 .../com/iluwatar/abstractfactory/Kingdom.java |  29 +----
 .../abstractfactory/AbstractFactoryTest.java  |  12 +-
 .../ConfigureForDosVisitor.java               |   6 +-
 .../ConfigureForUnixVisitor.java              |   6 +-
 .../com/iluwatar/acyclicvisitor/Hayes.java    |   6 +-
 .../com/iluwatar/acyclicvisitor/Zoom.java     |   6 +-
 .../ConfigureForDosVisitorTest.java           |  20 ++--
 .../ConfigureForUnixVisitorTest.java          |  25 ++--
 .../iluwatar/acyclicvisitor/HayesTest.java    |  24 ++--
 .../com/iluwatar/acyclicvisitor/ZoomTest.java |  26 ++---
 adapter/README.md                             |   5 +-
 .../java/com/iluwatar/adapter/Captain.java    |  18 ++-
 .../com/iluwatar/adapter/FishingBoat.java     |   7 +-
 .../iluwatar/adapter/FishingBoatAdapter.java  |   6 +-
 .../iluwatar/adapter/AdapterPatternTest.java  |  13 ++-
 .../aggregator/microservices/Aggregator.java  |   7 +-
 .../aggregator/microservices/Product.java     |  21 +---
 .../ProductInformationClientImpl.java         |   7 +-
 .../ProductInventoryClientImpl.java           |   7 +-
 .../microservices/AggregatorTest.java         |  10 +-
 .../microservice/InformationController.java   |   5 +-
 .../InformationControllerTest.java            |   8 +-
 .../microservice/InventoryController.java     |   5 +-
 .../microservice/InventoryControllerTest.java |   9 +-
 ambassador/README.md                          |   9 +-
 .../java/com/iluwatar/ambassador/Client.java  |   7 +-
 .../iluwatar/ambassador/RemoteService.java    |   8 +-
 .../ambassador/RemoteServiceStatus.java       |   3 +-
 .../ambassador/ServiceAmbassador.java         |  10 +-
 .../com/iluwatar/api/gateway/ApiGateway.java  |   7 +-
 .../iluwatar/api/gateway/DesktopProduct.java  |  21 +---
 .../iluwatar/api/gateway/ImageClientImpl.java |  14 +--
 .../iluwatar/api/gateway/MobileProduct.java   |  13 +--
 .../iluwatar/api/gateway/PriceClientImpl.java |  12 +-
 .../iluwatar/api/gateway/ApiGatewayTest.java  |   6 +-
 .../image/microservice/ImageController.java   |  11 +-
 .../microservice/ImageControllerTest.java     |   9 +-
 .../price/microservice/PriceController.java   |  11 +-
 .../microservice/PriceControllerTest.java     |   9 +-
 arrange-act-assert/README.md                  |  10 +-
 .../com/iluwatar/arrangeactassert/Cash.java   |   7 +-
 .../iluwatar/async/method/invocation/App.java |   6 +-
 .../main/java/com/iluwatar/balking/App.java   |   9 +-
 .../com/iluwatar/balking/WashingMachine.java  |  10 +-
 .../iluwatar/balking/WashingMachineState.java |   3 +-
 .../main/java/com/iluwatar/bridge/App.java    |   6 +-
 .../iluwatar/bridge/FlyingEnchantment.java    |   6 +-
 .../main/java/com/iluwatar/bridge/Hammer.java |  12 +-
 .../bridge/SoulEatingEnchantment.java         |   6 +-
 .../main/java/com/iluwatar/bridge/Sword.java  |  12 +-
 .../main/java/com/iluwatar/builder/App.java   |   7 +-
 .../main/java/com/iluwatar/builder/Armor.java |  12 +-
 .../java/com/iluwatar/builder/HairColor.java  |   6 +-
 .../java/com/iluwatar/builder/HairType.java   |  14 ++-
 .../java/com/iluwatar/builder/AppTest.java    |   1 -
 .../business/delegate/BusinessDelegate.java   |   3 +-
 .../business/delegate/BusinessLookup.java     |  11 +-
 .../business/delegate/EjbService.java         |   6 +-
 .../business/delegate/JmsService.java         |   6 +-
 .../business/delegate/ServiceType.java        |   3 +-
 .../delegate/BusinessDelegateTest.java        |  10 +-
 .../main/java/com/iluwatar/bytecode/App.java  |   5 +-
 .../com/iluwatar/bytecode/Instruction.java    |  15 +--
 .../com/iluwatar/bytecode/VirtualMachine.java |  10 +-
 .../java/com/iluwatar/bytecode/Wizard.java    |  40 +------
 .../iluwatar/bytecode/VirtualMachineTest.java |  24 ++--
 .../util/InstructionConverterUtilTest.java    |  10 +-
 .../main/java/com/iluwatar/caching/App.java   |   7 +-
 .../java/com/iluwatar/caching/CacheStore.java |   6 +-
 .../com/iluwatar/caching/CachingPolicy.java   |  18 +--
 .../java/com/iluwatar/caching/LruCache.java   |   8 +-
 .../com/iluwatar/caching/UserAccount.java     |  47 ++------
 callback/README.md                            |   3 +-
 .../main/java/com/iluwatar/callback/App.java  |   7 +-
 .../com/iluwatar/callback/SimpleTask.java     |  10 +-
 .../com/iluwatar/callback/CallbackTest.java   |   2 +-
 chain/README.md                               |   2 +-
 .../src/main/java/com/iluwatar/chain/App.java |   1 -
 .../com/iluwatar/chain/RequestHandler.java    |  12 +-
 .../java/com/iluwatar/chain/RequestType.java  |   4 +-
 .../java/com/iluwatar/chain/OrcKingTest.java  |   4 +-
 circuit-breaker/README.md                     |   1 +
 .../java/com/iluwatar/circuitbreaker/App.java |   6 +-
 .../DefaultCircuitBreakerTest.java            |   7 +-
 .../DelayedRemoteServiceTest.java             |   4 +-
 .../circuitbreaker/MonitoringServiceTest.java |  10 +-
 .../com/iluwatar/collectionpipeline/App.java  |   6 +-
 .../com/iluwatar/collectionpipeline/Car.java  |  80 ++-----------
 .../iluwatar/collectionpipeline/Category.java |   4 +-
 .../iluwatar/collectionpipeline/Person.java   |  17 +--
 .../iluwatar/collectionpipeline/AppTest.java  |  15 ++-
 .../iluwatar/combinator/CombinatorApp.java    |  12 +-
 .../combinator/CombinatorAppTest.java         |   3 +-
 .../com/iluwatar/combinator/FinderTest.java   |   3 +-
 .../com/iluwatar/combinator/FindersTest.java  |  20 ++--
 command/README.md                             |   4 +-
 .../main/java/com/iluwatar/command/Size.java  |  10 +-
 .../java/com/iluwatar/command/Target.java     |  29 +----
 .../java/com/iluwatar/command/Visibility.java |  10 +-
 .../java/com/iluwatar/command/Wizard.java     |   2 +
 .../com/iluwatar/command/CommandTest.java     |   4 +-
 .../com/iluwatar/commander/Commander.java     |  18 +--
 .../java/com/iluwatar/commander/Order.java    |  14 ++-
 .../java/com/iluwatar/commander/User.java     |  10 +-
 .../employeehandle/EmployeeDatabase.java      |  10 +-
 .../messagingservice/MessagingDatabase.java   |   8 +-
 .../messagingservice/MessagingService.java    |  22 ++--
 .../paymentservice/PaymentDatabase.java       |  11 +-
 .../paymentservice/PaymentService.java        |  14 +--
 .../com/iluwatar/commander/queue/Queue.java   |  10 --
 .../iluwatar/commander/queue/QueueTask.java   |  37 +++---
 .../shippingservice/ShippingDatabase.java     |   8 +-
 .../shippingservice/ShippingService.java      |   8 +-
 .../main/java/com/iluwatar/composite/App.java |  10 +-
 .../java/com/iluwatar/composite/Letter.java   |   7 +-
 .../com/iluwatar/composite/MessengerTest.java |  21 ++--
 .../main/java/com/iluwatar/converter/App.java |   8 +-
 .../com/iluwatar/converter/Converter.java     |  13 +--
 .../java/com/iluwatar/converter/User.java     |  66 ++---------
 .../java/com/iluwatar/converter/UserDto.java  |  65 ++---------
 .../com/iluwatar/converter/ConverterTest.java |  10 +-
 .../main/java/com/iluwatar/cqrs/app/App.java  |   5 +-
 .../iluwatar/cqrs/domain/model/Author.java    |  43 +------
 .../com/iluwatar/cqrs/domain/model/Book.java  |  43 +------
 .../java/com/iluwatar/cqrs/dto/Author.java    |  63 ++--------
 .../main/java/com/iluwatar/cqrs/dto/Book.java |  55 ++-------
 .../com/iluwatar/cqrs/util/HibernateUtil.java |   7 +-
 .../com/iluwatar/cqrs/IntegrationTest.java    |  16 +--
 dao/README.md                                 |   3 +-
 dao/src/main/java/com/iluwatar/dao/App.java   |  19 ++-
 .../main/java/com/iluwatar/dao/Customer.java  |  69 ++---------
 .../java/com/iluwatar/dao/DbCustomerDao.java  |  18 +--
 .../java/com/iluwatar/dao/CustomerTest.java   |  20 ++--
 .../com/iluwatar/dao/DbCustomerDaoTest.java   |  37 +++---
 .../iluwatar/dao/InMemoryCustomerDaoTest.java |  24 ++--
 data-bus/pom.xml                              |   3 -
 .../iluwatar/databus/AbstractDataType.java    |  15 +--
 .../iluwatar/databus/data/MessageData.java    |  12 +-
 .../iluwatar/databus/data/StartingData.java   |  12 +-
 .../iluwatar/databus/data/StoppingData.java   |  12 +-
 .../members/MessageCollectorMember.java       |   7 +-
 .../databus/members/StatusMember.java         |  26 ++---
 .../com/iluwatar/databus/DataBusTest.java     |   8 +-
 .../members/MessageCollectorMemberTest.java   |   6 +-
 .../databus/members/StatusMemberTest.java     |   8 +-
 .../iluwatar/data/locality/Application.java   |   6 +-
 .../data/locality/game/GameEntity.java        |   5 +-
 .../locality/game/component/AiComponent.java  |   6 +-
 .../game/component/PhysicsComponent.java      |   6 +-
 .../game/component/RenderComponent.java       |   6 +-
 .../component/manager/AiComponentManager.java |   6 +-
 .../manager/PhysicsComponentManager.java      |   6 +-
 .../manager/RenderComponentManager.java       |   6 +-
 .../data/locality/ApplicationTest.java        |   2 +-
 .../java/com/iluwatar/datamapper/App.java     |  14 +--
 .../java/com/iluwatar/datamapper/Student.java |  83 ++------------
 .../iluwatar/datamapper/DataMapperTest.java   |   4 +-
 .../com/iluwatar/datamapper/StudentTest.java  |   4 +-
 .../java/com/iluwatar/datatransfer/App.java   |   6 +-
 .../datatransfer/customer/CustomerDto.java    |  29 +----
 .../customer/CustomerResource.java            |  11 +-
 .../com/iluwatar/datatransfer/AppTest.java    |  20 ++--
 .../customer/CustomerResourceTest.java        |   9 +-
 decorator/README.md                           |   6 +-
 .../main/java/com/iluwatar/decorator/App.java |   6 +-
 .../com/iluwatar/decorator/ClubbedTroll.java  |  12 +-
 .../com/iluwatar/decorator/SimpleTroll.java   |   6 +-
 .../iluwatar/decorator/ClubbedTrollTest.java  |   4 +-
 .../iluwatar/decorator/SimpleTrollTest.java   |  14 +--
 .../simple/printers/CanonPrinter.java         |   6 +-
 .../simple/printers/EpsonPrinter.java         |   6 +-
 .../delegation/simple/printers/HpPrinter.java |   6 +-
 .../delegation/simple/DelegateTest.java       |  14 +--
 dependency-injection/README.md                |   3 +-
 .../injection/AdvancedSorceress.java          |   7 +-
 .../dependency/injection/AdvancedWizard.java  |   7 +-
 .../dependency/injection/Tobacco.java         |   6 +-
 .../injection/AdvancedSorceressTest.java      |   8 +-
 .../injection/AdvancedWizardTest.java         |   8 +-
 .../dependency/injection/GuiceWizardTest.java |  10 +-
 .../injection/SimpleWizardTest.java           |   8 +-
 .../main/java/com/iluwatar/dirtyflag/App.java |   6 +-
 .../com/iluwatar/dirtyflag/DataFetcher.java   |   6 +-
 .../java/com/iluwatar/dirtyflag/World.java    |   2 +-
 .../java/com/iluwatar/doublebuffer/App.java   |   6 +-
 .../java/com/iluwatar/doublebuffer/Pixel.java |  10 +-
 .../java/com/iluwatar/doublebuffer/Scene.java |   6 +-
 .../com/iluwatar/doublebuffer/AppTest.java    |   2 +-
 .../iluwatar/doublechecked/locking/App.java   |   7 +-
 .../doublechecked/locking/Inventory.java      |   6 +-
 .../doublechecked/locking/InventoryTest.java  |   8 +-
 .../java/com/iluwatar/doubledispatch/App.java |   6 +-
 .../iluwatar/doubledispatch/Meteoroid.java    |   6 +-
 .../iluwatar/doubledispatch/Rectangle.java    |  31 +----
 .../doubledispatch/SpaceStationMir.java       |   6 +-
 .../doubledispatch/FlamingAsteroidTest.java   |  12 +-
 .../doubledispatch/MeteoroidTest.java         |  12 +-
 .../doubledispatch/RectangleTest.java         |   8 +-
 .../doubledispatch/SpaceStationIssTest.java   |  12 +-
 .../doubledispatch/SpaceStationMirTest.java   |  12 +-
 eip-aggregator/pom.xml                        |   5 -
 .../routes/AggregatorRouteTest.java           |   4 +-
 .../MessageAggregationStrategyTest.java       |   6 +-
 .../com/iluwatar/eip/message/channel/App.java |   6 +-
 .../iluwatar/eip/publish/subscribe/App.java   |   6 +-
 eip-splitter/pom.xml                          |   6 -
 .../splitter/routes/SplitterRouteTest.java    |   4 +-
 eip-wire-tap/pom.xml                          |   6 -
 .../eip/wiretap/routes/WireTapRouteTest.java  |   4 +-
 .../com/iluwatar/event/aggregator/Event.java  |  13 ++-
 .../event/aggregator/KingJoffrey.java         |   6 +-
 .../iluwatar/event/aggregator/Weekday.java    |   8 +-
 .../event/aggregator/EventEmitterTest.java    |   4 +-
 .../iluwatar/event/aggregator/EventTest.java  |   4 +-
 .../event/aggregator/KingJoffreyTest.java     |   8 +-
 .../event/aggregator/KingsHandTest.java       |   4 +-
 .../event/aggregator/LordBaelishTest.java     |   2 +-
 .../event/aggregator/LordVarysTest.java       |   2 +-
 .../iluwatar/event/aggregator/ScoutTest.java  |   2 +-
 .../event/aggregator/WeekdayTest.java         |   4 +-
 .../com/iluwatar/event/asynchronous/App.java  |   6 +-
 .../iluwatar/event/asynchronous/Event.java    |  30 ++---
 .../event/asynchronous/EventManager.java      |   2 +-
 .../asynchronous/EventAsynchronousTest.java   |  12 +-
 .../iluwatar/eda/event/UserCreatedEvent.java  |  12 +-
 .../iluwatar/eda/event/UserUpdatedEvent.java  |  12 +-
 .../eda/handler/UserCreatedEventHandler.java  |   6 +-
 .../eda/handler/UserUpdatedEventHandler.java  |   6 +-
 .../java/com/iluwatar/eda/model/User.java     |  12 +-
 .../eda/event/UserCreatedEventTest.java       |   4 +-
 .../eda/framework/EventDispatcherTest.java    |   4 +-
 .../java/com/iluwatar/event/queue/App.java    |   6 +-
 .../java/com/iluwatar/event/queue/Audio.java  |   5 +-
 .../com/iluwatar/event/queue/PlayMessage.java |  28 ++---
 .../com/iluwatar/event/queue/AudioTest.java   |  18 +--
 .../com/iluwatar/event/sourcing/app/App.java  |   6 +-
 .../event/sourcing/domain/Account.java        |  63 ++--------
 .../sourcing/event/AccountCreateEvent.java    |  20 +---
 .../event/sourcing/event/DomainEvent.java     |  63 +---------
 .../sourcing/event/MoneyDepositEvent.java     |  20 +---
 .../sourcing/event/MoneyTransferEvent.java    |  29 +----
 .../src/test/java/IntegrationTest.java        |   6 +-
 .../execute/around/SimpleFileWriterTest.java  |  10 +-
 .../java/concreteextensions/Commander.java    |  17 +--
 .../java/concreteextensions/Sergeant.java     |  17 +--
 .../main/java/concreteextensions/Soldier.java |  16 +--
 .../src/main/java/units/Unit.java             |  12 +-
 .../concreteextensions/CommanderTest.java     |   4 +-
 .../java/concreteextensions/SergeantTest.java |   4 +-
 .../java/concreteextensions/SoldierTest.java  |   4 +-
 .../test/java/units/CommanderUnitTest.java    |   5 +-
 .../src/test/java/units/SergeantUnitTest.java |   5 +-
 .../src/test/java/units/SoldierUnitTest.java  |   5 +-
 .../src/test/java/units/UnitTest.java         |   4 +-
 facade/README.md                              |  12 +-
 .../iluwatar/facade/DwarvenCartOperator.java  |   6 +-
 .../iluwatar/facade/DwarvenGoldDigger.java    |   6 +-
 .../iluwatar/facade/DwarvenMineWorker.java    |   6 +-
 .../iluwatar/facade/DwarvenTunnelDigger.java  |   6 +-
 .../facade/DwarvenGoldmineFacadeTest.java     |  10 +-
 .../java/com/iluwatar/factorykit/App.java     |   6 +-
 .../com/iluwatar/factorykit/WeaponType.java   |   5 +-
 .../factorykit/factorykit/FactoryKitTest.java |  10 +-
 .../java/com/iluwatar/factory/method/App.java |  18 ++-
 .../factory/method/ElfBlacksmith.java         |   4 +-
 .../iluwatar/factory/method/ElfWeapon.java    |  14 +--
 .../factory/method/OrcBlacksmith.java         |   6 +-
 .../iluwatar/factory/method/OrcWeapon.java    |  14 +--
 .../iluwatar/factory/method/WeaponType.java   |  12 +-
 .../factory/method/FactoryMethodTest.java     |  10 +-
 .../main/java/com/iluwatar/factory/App.java   |  10 +-
 .../main/java/com/iluwatar/factory/Car.java   |   4 +-
 .../java/com/iluwatar/factory/CarType.java    |  27 ++---
 .../com/iluwatar/factory/CarsFactory.java     |   2 +-
 .../java/com/iluwatar/factory/Ferrari.java    |   2 +-
 .../java/com/iluwatar/factory/AppTest.java    |   8 +-
 .../com/iluwatar/factory/CarsFactoryTest.java |  10 +-
 .../java/com/iluwatar/featuretoggle/App.java  |   6 +-
 .../PropertiesFeatureToggleVersion.java       |  23 ++--
 .../com/iluwatar/featuretoggle/user/User.java |  12 +-
 .../featuretoggle/user/UserGroup.java         |   1 -
 .../PropertiesFeatureToggleVersionTest.java   |  10 +-
 .../TieredFeatureToggleVersionTest.java       |  10 +-
 .../featuretoggle/user/UserGroupTest.java     |  10 +-
 .../main/java/com/iluwatar/filterer/App.java  |  18 ++-
 .../SimpleProbabilisticThreatAwareSystem.java |  54 ++-------
 .../filterer/threat/SimpleProbableThreat.java |  36 ++----
 .../filterer/threat/SimpleThreat.java         |  47 +-------
 .../threat/SimpleThreatAwareSystem.java       |  45 ++------
 .../iluwatar/filterer/threat/ThreatType.java  |   6 +-
 ...pleProbabilisticThreatAwareSystemTest.java |  12 +-
 .../threat/SimpleThreatAwareSystemTest.java   |   2 +-
 .../com/iluwatar/fluentinterface/app/App.java |   6 +-
 .../lazy/LazyFluentIterable.java              |  11 +-
 .../simple/SimpleFluentIterable.java          |  11 +-
 .../fluentiterable/FluentIterableTest.java    |  24 ++--
 .../lazy/LazyFluentIterableTest.java          |   2 +-
 .../simple/SimpleFluentIterableTest.java      |   2 +-
 .../java/com/iluwatar/flux/action/Action.java |  12 +-
 .../com/iluwatar/flux/action/ActionType.java  |   3 +-
 .../com/iluwatar/flux/action/Content.java     |  11 +-
 .../com/iluwatar/flux/view/ContentView.java   |   6 +-
 .../java/com/iluwatar/flux/view/MenuView.java |   6 +-
 .../com/iluwatar/flux/action/ContentTest.java |   2 +-
 .../iluwatar/flux/action/MenuItemTest.java    |   2 +-
 .../flux/dispatcher/DispatcherTest.java       |   5 +-
 .../iluwatar/flux/store/ContentStoreTest.java |   2 +-
 .../iluwatar/flux/store/MenuStoreTest.java    |   2 +-
 .../iluwatar/flux/view/ContentViewTest.java   |   2 +-
 .../com/iluwatar/flux/view/MenuViewTest.java  |   4 +-
 flyweight/README.md                           |   6 +-
 .../com/iluwatar/flyweight/AlchemistShop.java |   6 +-
 .../com/iluwatar/flyweight/HealingPotion.java |   6 +-
 .../iluwatar/flyweight/HolyWaterPotion.java   |   6 +-
 .../flyweight/InvisibilityPotion.java         |   6 +-
 .../com/iluwatar/flyweight/PoisonPotion.java  |   6 +-
 .../iluwatar/flyweight/StrengthPotion.java    |   6 +-
 .../iluwatar/flyweight/AlchemistShopTest.java |   2 +-
 .../iluwatar/front/controller/ArcherView.java |   6 +-
 .../front/controller/CatapultView.java        |   6 +-
 .../iluwatar/front/controller/ErrorView.java  |   6 +-
 .../controller/ApplicationExceptionTest.java  |   6 +-
 .../main/java/com/iluwatar/gameloop/App.java  |   6 +-
 .../java/com/iluwatar/gameloop/AppTest.java   |   6 +-
 .../gameloop/FixedStepGameLoopTest.java       |   2 +-
 .../gameloop/FrameBasedGameLoopTest.java      |  11 +-
 .../iluwatar/gameloop/GameControllerTest.java |  18 +--
 .../com/iluwatar/gameloop/GameLoopTest.java   |  27 +++--
 .../gameloop/VariableStepGameLoopTest.java    |  13 ++-
 .../guarded/suspension/GuardedQueue.java      |   5 +-
 .../guarded/suspension/GuardedQueueTest.java  |   4 +-
 .../com/iluwatar/halfsynchalfasync/App.java   |   6 +-
 .../AsynchronousService.java                  |   6 +-
 .../AsynchronousServiceTest.java              |  18 ++-
 .../administration/ConsoleAdministration.java |   6 +-
 .../database/MongoTicketRepository.java       |   2 +-
 .../hexagonal/domain/LotteryNumbers.java      |  35 +-----
 .../hexagonal/domain/LotteryTicket.java       |  58 ++--------
 .../domain/LotteryTicketCheckResult.java      |  60 ++--------
 .../hexagonal/domain/LotteryTicketId.java     |  32 +-----
 .../hexagonal/domain/LotteryUtils.java        |   2 +-
 .../hexagonal/domain/PlayerDetails.java       |  98 ++--------------
 .../hexagonal/eventlog/StdOutEventLog.java    |   6 +-
 .../hexagonal/service/ConsoleLottery.java     |   6 +-
 .../database/MongoTicketRepositoryTest.java   |   2 +-
 .../filter/FilterManagerTest.java             |   4 +-
 .../intercepting/filter/OrderTest.java        |  10 +-
 .../java/com/iluwatar/interpreter/App.java    |   6 +-
 .../main/java/com/iluwatar/iterator/App.java  |   6 +-
 layers/README.md                              |   3 +-
 .../iluwatar/layers/view/CakeViewImpl.java    |   6 +-
 .../java/com/iluwatar/layers/app/AppTest.java |   2 +-
 .../com/iluwatar/layers/entity/CakeTest.java  |  30 +++--
 .../exception/CakeBakingExceptionTest.java    |   9 +-
 .../service/CakeBakingServiceImplTest.java    |  24 ++--
 .../layers/view/CakeViewImplTest.java         |  22 ++--
 .../java/com/iluwatar/lazy/loading/App.java   |   6 +-
 .../java/com/iluwatar/lazy/loading/Heavy.java |   6 +-
 .../iluwatar/lazy/loading/HolderNaive.java    |   6 +-
 .../lazy/loading/HolderThreadSafe.java        |   6 +-
 .../iluwatar/lazy/loading/Java8Holder.java    |   6 +-
 .../lazy/loading/AbstractHolderTest.java      |   6 +-
 .../com/iluwatar/lazy/loading/AppTest.java    |   2 +-
 .../leaderelection/AbstractInstance.java      |   6 +-
 .../com/iluwatar/leaderelection/Message.java  |  52 ++-------
 .../leaderelection/bully/BullyInstance.java   |   6 +-
 .../leaderelection/ring/RingInstance.java     |   7 +-
 .../iluwatar/leaderelection/MessageTest.java  |   8 +-
 .../bully/BullyMessageManagerTest.java        |  23 ++--
 .../bully/BullyinstanceTest.java              |  16 +--
 .../leaderelection/ring/RingInstanceTest.java |  16 +--
 .../ring/RingMessageManagerTest.java          |  21 ++--
 .../iluwatar/leaderfollowers/TaskHandler.java |   6 +-
 .../com/iluwatar/leaderfollowers/Worker.java  |  27 +----
 .../src/test/java/com/AppTest.java            |  11 +-
 .../src/test/java/com/TaskHandlerTest.java    |  14 +--
 .../src/test/java/com/TaskSetTest.java        |  28 ++---
 lombok.config                                 |   2 +
 marker/src/main/java/Guard.java               |   5 +-
 marker/src/main/java/Thief.java               |   5 +-
 marker/src/test/java/ThiefTest.java           |   2 +-
 .../java/com/iluwatar/masterworker/App.java   |   6 +-
 .../masterworker/ArrayUtilityMethods.java     |   6 +-
 .../iluwatar/mediator/PartyMemberBase.java    |   6 +-
 .../com/iluwatar/mediator/PartyImplTest.java  |   6 +-
 .../main/java/com/iluwatar/memento/App.java   |   6 +-
 .../java/com/iluwatar/memento/StarTest.java   |   4 +-
 .../model/view/controller/GiantView.java      |   6 +-
 .../view/controller/GiantControllerTest.java  |   8 +-
 .../model/view/controller/GiantModelTest.java |   6 +-
 .../model/view/controller/GiantViewTest.java  |   2 +-
 .../model/view/presenter/FileLoaderTest.java  |   2 +-
 .../presenter/FileSelectorPresenterTest.java  |  12 +-
 .../iluwatar/module/ConsoleLoggerModule.java  |   6 +-
 .../com/iluwatar/module/FileLoggerModule.java |   6 +-
 .../iluwatar/module/FileLoggerModuleTest.java |  14 +--
 .../src/main/java/com/iluwatar/monad/App.java |   6 +-
 .../test/java/com/iluwatar/monad/AppTest.java |   2 +-
 .../java/com/iluwatar/monad/MonadTest.java    |   6 +-
 .../java/com/iluwatar/monostate/Server.java   |   6 +-
 .../java/com/iluwatar/monostate/AppTest.java  |   2 +-
 .../iluwatar/monostate/LoadBalancerTest.java  |   4 +-
 .../main/java/com/iluwatar/multiton/App.java  |   6 +-
 .../java/com/iluwatar/multiton/AppTest.java   |   2 +-
 .../com/iluwatar/multiton/NazgulEnumTest.java |   6 +-
 .../com/iluwatar/multiton/NazgulTest.java     |   6 +-
 .../src/main/java/com/iluwatar/mute/App.java  |   6 +-
 .../dom/modules/simple/SimpleObjectTest.java  |   2 +-
 .../dom/modules/simple/SimpleObjectsTest.java |   7 +-
 .../domainapp/integtests/specs/RunSpecs.java  |   2 +-
 .../modules/simple/SimpleObjectIntegTest.java |  12 +-
 .../simple/SimpleObjectsIntegTest.java        |   1 +
 .../domainapp/webapp/SimpleApplication.java   |   6 +-
 null-object/README.md                         |   3 +-
 .../com/iluwatar/nullobject/NodeImpl.java     |   6 +-
 .../com/iluwatar/nullobject/TreeTest.java     |   8 +-
 .../test/RoyaltyObjectMotherTest.java         |  23 ++--
 .../java/com/iluwatar/object/pool/App.java    |   6 +-
 .../com/iluwatar/object/pool/AppTest.java     |   2 +-
 .../object/pool/OliphauntPoolTest.java        |  17 +--
 observer/README.md                            |   9 +-
 .../main/java/com/iluwatar/observer/App.java  |   6 +-
 .../java/com/iluwatar/observer/Hobbits.java   |   8 +-
 .../main/java/com/iluwatar/observer/Orcs.java |   6 +-
 .../java/com/iluwatar/observer/Weather.java   |   6 +-
 .../iluwatar/observer/generic/GHobbits.java   |   6 +-
 .../com/iluwatar/observer/generic/GOrcs.java  |   6 +-
 .../iluwatar/observer/generic/GWeather.java   |   6 +-
 .../java/com/iluwatar/observer/AppTest.java   |   6 +-
 .../com/iluwatar/observer/HobbitsTest.java    |   8 +-
 .../java/com/iluwatar/observer/OrcsTest.java  |   8 +-
 .../com/iluwatar/observer/WeatherTest.java    |  15 ++-
 .../observer/generic/GHobbitsTest.java        |   8 +-
 .../observer/generic/GWeatherTest.java        |  15 ++-
 .../iluwatar/observer/generic/OrcsTest.java   |   8 +-
 .../java/com/iluwatar/pageobject/App.java     |   6 +-
 .../pageobject/AlbumListPageTest.java         |   3 +-
 .../iluwatar/pageobject/AlbumPageTest.java    |   5 +-
 .../iluwatar/pageobject/LoginPageTest.java    |   3 +-
 .../iluwatar/pageobject/AlbumListPage.java    |   6 +-
 .../com/iluwatar/pageobject/AlbumPage.java    |   6 +-
 .../com/iluwatar/pageobject/LoginPage.java    |   6 +-
 .../pageobject/AlbumListPageTest.java         |   2 +-
 .../iluwatar/pageobject/AlbumPageTest.java    |   4 +-
 .../iluwatar/pageobject/LoginPageTest.java    |   2 +-
 .../com/iluwatar/partialresponse/App.java     |   5 +-
 .../com/iluwatar/pipeline/PipelineTest.java   |   2 +-
 .../com/iluwatar/poison/pill/Consumer.java    |   6 +-
 .../com/iluwatar/poison/pill/Producer.java    |   6 +-
 .../iluwatar/poison/pill/ConsumerTest.java    |   2 +-
 .../poison/pill/PoisonMessageTest.java        |  10 +-
 .../iluwatar/poison/pill/ProducerTest.java    |   4 +-
 .../poison/pill/SimpleMessageTest.java        |   4 +-
 pom.xml                                       |  16 +--
 priority-queue/README.md                      |   3 +-
 .../priority/queue/PriorityMessageQueue.java  |   6 +-
 .../com/iluwatar/priority/queue/Worker.java   |   6 +-
 .../queue/PriorityMessageQueueTest.java       |   8 +-
 .../priority/queue/QueueManagerTest.java      |   4 +-
 private-class-data/README.md                  |   4 +-
 .../privateclassdata/ImmutableStew.java       |   6 +-
 .../com/iluwatar/privateclassdata/Stew.java   |   6 +-
 .../privateclassdata/ImmutableStewTest.java   |   4 +-
 .../iluwatar/privateclassdata/StewTest.java   |   2 +-
 .../com/iluwatar/producer/consumer/App.java   |   7 +-
 .../iluwatar/producer/consumer/Consumer.java  |   6 +-
 .../producer/consumer/ConsumerTest.java       |   2 +-
 .../producer/consumer/ProducerTest.java       |   2 +-
 .../main/java/com/iluwatar/promise/App.java   |   6 +-
 .../java/com/iluwatar/promise/Utility.java    |   6 +-
 .../com/iluwatar/promise/PromiseTest.java     |  22 ++--
 .../main/java/com/iluwatar/property/App.java  |   6 +-
 .../com/iluwatar/property/CharacterTest.java  |  10 +-
 .../main/java/com/iluwatar/prototype/App.java |   6 +-
 .../java/com/iluwatar/prototype/Beast.java    |  19 +--
 .../java/com/iluwatar/prototype/ElfBeast.java |  27 +----
 .../java/com/iluwatar/prototype/ElfMage.java  |  26 +----
 .../com/iluwatar/prototype/ElfWarlord.java    |  21 +---
 .../iluwatar/prototype/HeroFactoryImpl.java   |  12 +-
 .../java/com/iluwatar/prototype/Mage.java     |  19 +--
 .../java/com/iluwatar/prototype/OrcBeast.java |  28 +----
 .../java/com/iluwatar/prototype/OrcMage.java  |  26 +----
 .../com/iluwatar/prototype/OrcWarlord.java    |  26 +----
 .../java/com/iluwatar/prototype/Warlord.java  |  19 +--
 .../java/com/iluwatar/prototype/AppTest.java  |   4 +-
 .../com/iluwatar/prototype/PrototypeTest.java |   4 +-
 proxy/README.md                               |   6 +-
 .../java/com/iluwatar/proxy/IvoryTower.java   |   6 +-
 .../main/java/com/iluwatar/proxy/Wizard.java  |   7 +-
 .../com/iluwatar/proxy/WizardTowerProxy.java  |   6 +-
 .../com/iluwatar/proxy/IvoryTowerTest.java    |   4 +-
 .../java/com/iluwatar/proxy/WizardTest.java   |   4 +-
 .../iluwatar/proxy/WizardTowerProxyTest.java  |   4 +-
 .../proxy/utils/InMemoryAppender.java         |   2 +-
 .../com/iluwatar/queue/load/leveling/App.java |   6 +-
 .../iluwatar/queue/load/leveling/Message.java |  15 +--
 .../queue/load/leveling/MessageQueue.java     |   6 +-
 .../queue/load/leveling/ServiceExecutor.java  |   6 +-
 .../queue/load/leveling/TaskGenerator.java    |   7 +-
 .../queue/load/leveling/MessageQueueTest.java |   4 +-
 .../queue/load/leveling/MessageTest.java      |   4 +-
 .../com/iluwatar/reactor/app/AppClient.java   |   6 +-
 .../iluwatar/reactor/app/LoggingHandler.java  |   6 +-
 .../reactor/framework/NioDatagramChannel.java |   6 +-
 .../reactor/framework/NioReactor.java         |   6 +-
 .../framework/NioServerSocketChannel.java     |   6 +-
 .../com/iluwatar/reactor/app/ReactorTest.java |  17 ++-
 .../com/iluwatar/reader/writer/lock/App.java  |   6 +-
 .../iluwatar/reader/writer/lock/Reader.java   |   6 +-
 .../reader/writer/lock/ReaderWriterLock.java  |   6 +-
 .../iluwatar/reader/writer/lock/Writer.java   |   6 +-
 .../writer/lock/ReaderAndWriterTest.java      |   6 +-
 .../reader/writer/lock/ReaderTest.java        |   4 +-
 .../reader/writer/lock/WriterTest.java        |   4 +-
 .../registry/CustomerRegistryTest.java        |   3 +-
 repository/pom.xml                            |   5 -
 .../java/com/iluwatar/repository/App.java     |   6 +-
 .../com/iluwatar/repository/AppConfig.java    |   6 +-
 .../java/com/iluwatar/repository/Person.java  |  97 ++--------------
 .../AnnotationBasedRepositoryTest.java        |  14 +--
 .../iluwatar/repository/AppConfigTest.java    |   7 +-
 .../iluwatar/repository/RepositoryTest.java   |  14 +--
 .../acquisition/is/initialization/App.java    |   6 +-
 .../is/initialization/SlidingDoor.java        |   6 +-
 .../is/initialization/TreasureChest.java      |   6 +-
 .../is/initialization/ClosableTest.java       |   4 +-
 .../com/iluwatar/retry/FindCustomerTest.java  |  10 +-
 .../retry/RetryExponentialBackoffTest.java    |   8 +-
 .../java/com/iluwatar/retry/RetryTest.java    |   9 +-
 .../roleobject/ApplicationRoleObject.java     |  16 ++-
 .../iluwatar/roleobject/CustomerCoreTest.java |   3 -
 .../saga/choreography/SagaApplication.java    |   5 +-
 .../saga/orchestration/SagaApplication.java   |   5 +-
 .../saga/orchestration/SagaOrchestrator.java  |   5 +-
 .../choreography/SagaApplicationTest.java     |   3 +-
 .../choreography/SagaChoreographyTest.java    |   1 -
 .../com/iluwatar/separatedinterface/App.java  |   6 +-
 .../invoice/InvoiceGeneratorTest.java         |  11 +-
 .../taxes/DomesticTaxCalculatorTest.java      |   8 +-
 .../taxes/ForeignTaxCalculatorTest.java       |   8 +-
 .../main/java/com/iluwatar/servant/App.java   |   6 +-
 .../java/com/iluwatar/servant/KingTest.java   |  18 +--
 .../java/com/iluwatar/servant/QueenTest.java  |  10 +-
 .../com/iluwatar/servant/ServantTest.java     |  10 +-
 .../serverless/baas/model/Address.java        | 106 +++--------------
 .../serverless/baas/model/Person.java         |  85 ++------------
 .../iluwatar/serverless/faas/LambdaInfo.java  | 108 ++----------------
 .../com/iluwatar/servicelayer/app/App.java    |   6 +-
 .../servicelayer/hibernate/HibernateUtil.java |   6 +-
 .../servicelayer/common/BaseDaoTest.java      |  10 +-
 .../magic/MagicServiceImplTest.java           |  12 +-
 .../servicelayer/spell/SpellDaoImplTest.java  |   4 +-
 .../spellbook/SpellbookDaoImplTest.java       |   4 +-
 .../wizard/WizardDaoImplTest.java             |   4 +-
 .../iluwatar/servicelocator/InitContext.java  |   6 +-
 .../iluwatar/servicelocator/ServiceCache.java |   6 +-
 .../iluwatar/servicelocator/ServiceImpl.java  |   6 +-
 .../servicelocator/ServiceLocatorTest.java    |   6 +-
 .../main/java/com/iluwatar/sharding/Data.java |   4 +-
 .../iluwatar/sharding/HashShardManager.java   |   6 +-
 .../iluwatar/sharding/LookupShardManager.java |   8 +-
 .../iluwatar/sharding/RangeShardManager.java  |   6 +-
 .../com/iluwatar/sharding/ShardManager.java   |   7 +-
 .../iluwatar/sharding/ShardManagerTest.java   |   2 +-
 .../main/java/com/iluwatar/singleton/App.java |   6 +-
 .../ThreadSafeDoubleCheckLocking.java         |   2 +-
 .../com/iluwatar/singleton/SingletonTest.java |   6 +-
 .../com/iluwatar/spatialpartition/App.java    |   5 +-
 .../com/iluwatar/spatialpartition/Bubble.java |   5 +-
 .../specialcase/InsufficientFunds.java        |   6 +-
 .../com/iluwatar/specification/app/App.java   |   6 +-
 .../iluwatar/specification/property/Mass.java |  10 +-
 .../specification/creature/CreatureTest.java  |  20 ++--
 .../selector/ColorSelectorTest.java           |   4 +-
 .../selector/CompositeSelectorsTest.java      |   8 +-
 .../selector/MassSelectorTest.java            |   2 +-
 .../selector/MovementSelectorTest.java        |   2 +-
 .../selector/SizeSelectorTest.java            |   2 +-
 state/README.md                               |   6 +-
 .../java/com/iluwatar/state/AngryState.java   |   6 +-
 .../com/iluwatar/state/PeacefulState.java     |   6 +-
 .../java/com/iluwatar/state/MammothTest.java  |   4 +-
 .../java/com/iluwatar/stepbuilder/App.java    |   6 +-
 .../stepbuilder/CharacterStepBuilderTest.java |  13 +--
 .../iluwatar/strangler/HalfArithmetic.java    |   7 +-
 .../com/iluwatar/strangler/HalfSource.java    |   7 +-
 .../com/iluwatar/strangler/NewArithmetic.java |   9 +-
 .../com/iluwatar/strangler/NewSource.java     |   7 +-
 .../com/iluwatar/strangler/OldArithmetic.java |   7 +-
 .../com/iluwatar/strangler/OldSource.java     |   5 +-
 .../strangler/HalfArithmeticTest.java         |  11 +-
 .../iluwatar/strangler/HalfSourceTest.java    |   9 +-
 .../iluwatar/strangler/NewArithmeticTest.java |  11 +-
 .../com/iluwatar/strangler/NewSourceTest.java |  10 +-
 .../iluwatar/strangler/OldArithmeticTest.java |   8 +-
 .../com/iluwatar/strangler/OldSourceTest.java |   8 +-
 strategy/README.md                            |   9 +-
 .../main/java/com/iluwatar/strategy/App.java  |  10 +-
 .../com/iluwatar/strategy/LambdaStrategy.java |   6 +-
 .../com/iluwatar/strategy/MeleeStrategy.java  |   6 +-
 .../iluwatar/strategy/ProjectileStrategy.java |   6 +-
 .../com/iluwatar/strategy/SpellStrategy.java  |   6 +-
 .../iluwatar/strategy/DragonSlayerTest.java   |   4 +-
 .../com/iluwatar/subclasssandbox/App.java     |   6 +-
 .../subclasssandbox/GroundDiveTest.java       |   5 +-
 .../subclasssandbox/SkyLaunchTest.java        |   4 +-
 template-method/README.md                     |   9 +-
 .../templatemethod/HitAndRunMethod.java       |   6 +-
 .../templatemethod/StealingMethod.java        |   6 +-
 .../iluwatar/templatemethod/SubtleMethod.java |   6 +-
 .../templatemethod/HalflingThiefTest.java     |   4 +-
 .../templatemethod/StealingMethodTest.java    |   8 +-
 thread-pool/README.md                         |   3 +-
 .../java/com/iluwatar/threadpool/App.java     |   6 +-
 .../java/com/iluwatar/threadpool/Worker.java  |   6 +-
 .../com/iluwatar/threadpool/TaskTest.java     |   6 +-
 .../com/iluwatar/threadpool/WorkerTest.java   |   2 +-
 throttling/README.md                          |   3 +-
 .../java/com/iluwatar/throttling/App.java     |   6 +-
 .../com/iluwatar/throttling/CallsCount.java   |   6 +-
 .../iluwatar/throttling/B2BServiceTest.java   |   2 +-
 .../com/iluwatar/throttling/TenantTest.java   |   2 +-
 tls/src/main/java/com/iluwatar/tls/App.java   |   6 +-
 .../com/iluwatar/tls/DateFormatCallable.java  |   7 +-
 .../iluwatar/tls/DateFormatCallableTest.java  |   6 +-
 ...FormatCallableTestIncorrectDateFormat.java |   6 +-
 .../DateFormatCallableTestMultiThread.java    |   6 +-
 .../java/com/iluwatar/tolerantreader/App.java |   8 +-
 .../iluwatar/tolerantreader/RainbowFish.java  |  30 +----
 .../tolerantreader/RainbowFishSerializer.java |  14 +--
 .../tolerantreader/RainbowFishV2.java         |  14 +--
 .../tolerantreader/RainbowFishV2Test.java     |   6 +-
 .../iluwatar/trampoline/TrampolineApp.java    |  10 +-
 .../trampoline/TrampolineAppTest.java         |   5 +-
 transaction-script/README.md                  |   2 +-
 .../com/iluwatar/transactionscript/App.java   |   2 +-
 .../com/iluwatar/transactionscript/Hotel.java |   7 +-
 .../transactionscript/HotelDaoImpl.java       |   5 +-
 .../com/iluwatar/transactionscript/Room.java  |  98 ++--------------
 .../transactionscript/HotelDaoImplTest.java   |  45 ++++----
 .../iluwatar/transactionscript/HotelTest.java |  27 ++---
 .../iluwatar/transactionscript/RoomTest.java  |  26 ++---
 .../main/java/com/iluwatar/twin/BallItem.java |  12 +-
 .../java/com/iluwatar/twin/BallThread.java    |  12 +-
 .../main/java/com/iluwatar/twin/GameItem.java |   6 +-
 .../java/com/iluwatar/twin/BallItemTest.java  |   6 +-
 .../com/iluwatar/twin/BallThreadTest.java     |   8 +-
 .../java/com/iluwatar/typeobject/App.java     |   7 +-
 .../java/com/iluwatar/typeobject/Candy.java   |  18 ++-
 .../com/iluwatar/typeobject/CandyGame.java    |   6 +-
 .../java/com/iluwatar/typeobject/Cell.java    |  16 +--
 unit-of-work/README.md                        |   2 +-
 .../java/com/iluwatar/unitofwork/Student.java |  30 +----
 .../unitofwork/StudentRepository.java         |  18 +--
 .../com/iluwatar/unitofwork/UnitActions.java  |  13 +--
 .../java/com/iluwatar/updatemethod/App.java   |   6 +-
 .../com/iluwatar/updatemethod/Entity.java     |  11 +-
 .../com/iluwatar/updatemethod/Skeleton.java   |   6 +-
 .../com/iluwatar/updatemethod/Statue.java     |   2 +-
 .../java/com/iluwatar/updatemethod/World.java |   9 +-
 .../com/iluwatar/updatemethod/AppTest.java    |   4 +-
 .../iluwatar/updatemethod/SkeletonTest.java   |   1 -
 .../java/com/iluwatar/value/object/App.java   |   6 +-
 .../com/iluwatar/value/object/HeroStat.java   |  72 ++----------
 .../iluwatar/value/object/HeroStatTest.java   |  10 +-
 visitor/README.md                             |   9 +-
 .../iluwatar/visitor/CommanderVisitor.java    |   6 +-
 .../com/iluwatar/visitor/SergeantVisitor.java |   6 +-
 .../com/iluwatar/visitor/SoldierVisitor.java  |   6 +-
 .../java/com/iluwatar/visitor/UnitTest.java   |   2 +-
 .../com/iluwatar/visitor/VisitorTest.java     |   6 +-
 zh/adapter/README.md                          |   5 +-
 zh/chain/README.md                            |   2 +-
 zh/decorator/README.md                        |   6 +-
 zh/facade/README.md                           |  12 +-
 zh/observer/README.md                         |   9 +-
 zh/strategy/README.md                         |   9 +-
 681 files changed, 2472 insertions(+), 4966 deletions(-)
 create mode 100644 lombok.config

diff --git a/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java b/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
index a14d8f292..59ca86135 100644
--- a/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
+++ b/abstract-document/src/main/java/com/iluwatar/abstractdocument/App.java
@@ -27,8 +27,7 @@ import com.iluwatar.abstractdocument.domain.Car;
 import com.iluwatar.abstractdocument.domain.enums.Property;
 import java.util.List;
 import java.util.Map;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Abstract Document pattern enables handling additional, non-static properties. This pattern
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * <p>In Abstract Document pattern,({@link AbstractDocument}) fully implements {@link Document})
  * interface. Traits are then defined to enable access to properties in usual, static way.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
index 9fad18d1a..c301b85eb 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/AbstractDocumentTest.java
@@ -23,19 +23,18 @@
 
 package com.iluwatar.abstractdocument;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertTrue;
+import org.junit.jupiter.api.Test;
 
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.*;
 
 /**
  * AbstractDocument test class
  */
-public class AbstractDocumentTest {
+class AbstractDocumentTest {
 
   private static final String KEY = "key";
   private static final String VALUE = "value";
@@ -50,13 +49,13 @@ public class AbstractDocumentTest {
   private final DocumentImplementation document = new DocumentImplementation(new HashMap<>());
 
   @Test
-  public void shouldPutAndGetValue() {
+  void shouldPutAndGetValue() {
     document.put(KEY, VALUE);
     assertEquals(VALUE, document.get(KEY));
   }
 
   @Test
-  public void shouldRetrieveChildren() {
+  void shouldRetrieveChildren() {
     var children = List.of(Map.of(), Map.of());
 
     document.put(KEY, children);
@@ -67,14 +66,14 @@ public class AbstractDocumentTest {
   }
 
   @Test
-  public void shouldRetrieveEmptyStreamForNonExistingChildren() {
+  void shouldRetrieveEmptyStreamForNonExistingChildren() {
     var children = document.children(KEY, DocumentImplementation::new);
     assertNotNull(children);
     assertEquals(0, children.count());
   }
 
   @Test
-  public void shouldIncludePropsInToString() {
+  void shouldIncludePropsInToString() {
     var props = Map.of(KEY, (Object) VALUE);
     var document = new DocumentImplementation(props);
     assertTrue(document.toString().contains(KEY));
diff --git a/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java b/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
index bafdb7247..a0e129083 100644
--- a/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
+++ b/abstract-document/src/test/java/com/iluwatar/abstractdocument/DomainTest.java
@@ -23,19 +23,20 @@
 
 package com.iluwatar.abstractdocument;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
 import com.iluwatar.abstractdocument.domain.Car;
 import com.iluwatar.abstractdocument.domain.Part;
 import com.iluwatar.abstractdocument.domain.enums.Property;
+import org.junit.jupiter.api.Test;
+
 import java.util.List;
 import java.util.Map;
-import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
 /**
  * Test for Part and Car
  */
-public class DomainTest {
+class DomainTest {
 
   private static final String TEST_PART_TYPE = "test-part-type";
   private static final String TEST_PART_MODEL = "test-part-model";
@@ -45,7 +46,7 @@ public class DomainTest {
   private static final long TEST_CAR_PRICE = 1L;
 
   @Test
-  public void shouldConstructPart() {
+  void shouldConstructPart() {
     var partProperties = Map.of(
         Property.TYPE.toString(), TEST_PART_TYPE,
         Property.MODEL.toString(), TEST_PART_MODEL,
@@ -58,7 +59,7 @@ public class DomainTest {
   }
 
   @Test
-  public void shouldConstructCar() {
+  void shouldConstructCar() {
     var carProperties = Map.of(
         Property.MODEL.toString(), TEST_CAR_MODEL,
         Property.PRICE.toString(), TEST_CAR_PRICE,
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index db464a231..d208002a7 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.abstractfactory;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * and its implementations ( {@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses
  * both concrete implementations to create a king, a castle and an army.
  */
+@Slf4j
 public class App implements Runnable {
 
-  private static Logger log = LoggerFactory.getLogger(App.class);
-
   private final Kingdom kingdom = new Kingdom();
 
   public Kingdom getKingdom() {
@@ -62,17 +60,17 @@ public class App implements Runnable {
 
   @Override
   public void run() {
-    log.info("Elf Kingdom");
+    LOGGER.info("Elf Kingdom");
     createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
-    log.info(kingdom.getArmy().getDescription());
-    log.info(kingdom.getCastle().getDescription());
-    log.info(kingdom.getKing().getDescription());
+    LOGGER.info(kingdom.getArmy().getDescription());
+    LOGGER.info(kingdom.getCastle().getDescription());
+    LOGGER.info(kingdom.getKing().getDescription());
 
-    log.info("Orc Kingdom");
+    LOGGER.info("Orc Kingdom");
     createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
-    log.info(kingdom.getArmy().getDescription());
-    log.info(kingdom.getCastle().getDescription());
-    log.info(kingdom.getKing().getDescription());
+    LOGGER.info(kingdom.getArmy().getDescription());
+    LOGGER.info(kingdom.getCastle().getDescription());
+    LOGGER.info(kingdom.getKing().getDescription());
   }
 
   /**
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
index 9326c5096..f78e67875 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Kingdom.java
@@ -23,36 +23,17 @@
 
 package com.iluwatar.abstractfactory;
 
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
 public class Kingdom {
 
   private King king;
   private Castle castle;
   private Army army;
 
-  public King getKing() {
-    return king;
-  }
-
-  public Castle getCastle() {
-    return castle;
-  }
-
-  public Army getArmy() {
-    return army;
-  }
-
-  public void setKing(King king) {
-    this.king = king;
-  }
-
-  public void setCastle(Castle castle) {
-    this.castle = castle;
-  }
-
-  public void setArmy(Army army) {
-    this.army = army;
-  }
-
   /**
    * The factory of kingdom factories.
    */
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
index 582862b30..3136ee29f 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AbstractFactoryTest.java
@@ -31,12 +31,12 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 /**
  * Test for abstract factory.
  */
-public class AbstractFactoryTest {
+class AbstractFactoryTest {
 
   private final App app = new App();
 
   @Test
-  public void king() {
+  void king() {
     app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
@@ -51,7 +51,7 @@ public class AbstractFactoryTest {
   }
 
   @Test
-  public void castle() {
+  void castle() {
     app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
@@ -66,7 +66,7 @@ public class AbstractFactoryTest {
   }
 
   @Test
-  public void army() {
+  void army() {
     app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
@@ -81,7 +81,7 @@ public class AbstractFactoryTest {
   }
 
   @Test
-  public void createElfKingdom() {
+  void createElfKingdom() {
     app.createKingdom(Kingdom.FactoryMaker.KingdomType.ELF);
     final var kingdom = app.getKingdom();
 
@@ -97,7 +97,7 @@ public class AbstractFactoryTest {
   }
 
   @Test
-  public void createOrcKingdom() {
+  void createOrcKingdom() {
     app.createKingdom(Kingdom.FactoryMaker.KingdomType.ORC);
     final var kingdom = app.getKingdom();
 
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
index 5313fd6bc..bfe7f6646 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitor.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.acyclicvisitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ConfigureForDosVisitor class implements both zoom's and  hayes' visit method for Dos
  * manufacturer.
  */
+@Slf4j
 public class ConfigureForDosVisitor implements AllModemVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForDosVisitor.class);
-
   @Override
   public void visit(Hayes hayes) {
     LOGGER.info(hayes + " used with Dos configurator.");
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
index 3f570d212..1f465967f 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitor.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.acyclicvisitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ConfigureForUnixVisitor class implements zoom's visit method for Unix manufacturer, unlike
  * traditional visitor pattern, this class may selectively implement visit for other modems.
  */
+@Slf4j
 public class ConfigureForUnixVisitor implements ZoomVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForUnixVisitor.class);
-
   @Override
   public void visit(Zoom zoom) {
     LOGGER.info(zoom + " used with Unix configurator.");
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
index db10bfd2c..3e30258f5 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Hayes.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.acyclicvisitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Hayes class implements its accept method.
  */
+@Slf4j
 public class Hayes extends Modem {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForDosVisitor.class);
-
   /**
    * Accepts all visitors but honors only HayesVisitor.
    */
diff --git a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
index 6486c7a5c..01e7e7aca 100644
--- a/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
+++ b/acyclic-visitor/src/main/java/com/iluwatar/acyclicvisitor/Zoom.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.acyclicvisitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Zoom class implements its accept method.
  */
+@Slf4j
 public class Zoom extends Modem {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConfigureForDosVisitor.class);
-
   /**
    * Accepts all visitors but honors only ZoomVisitor.
    */
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
index 99424eb32..b41fc956c 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForDosVisitorTest.java
@@ -35,34 +35,34 @@ import uk.org.lidalia.slf4jtest.TestLoggerFactory;
 /**
  * ConfigureForDosVisitor test class
  */
-public class ConfigureForDosVisitorTest {
+class ConfigureForDosVisitorTest {
 
   private final TestLogger logger = TestLoggerFactory.getTestLogger(ConfigureForDosVisitor.class);
-  
+
   @Test
-  public void testVisitForZoom() {    
+  void testVisitForZoom() {
     var conDos = new ConfigureForDosVisitor();
     var zoom = new Zoom();
-    
+
     conDos.visit(zoom);
-    
+
     assertThat(logger.getLoggingEvents())
         .extracting("level", "message")
         .contains(tuple(INFO, zoom + " used with Dos configurator."));
   }
-  
+
   @Test
-  public void testVisitForHayes() {
+  void testVisitForHayes() {
     var conDos = new ConfigureForDosVisitor();
     var hayes = new Hayes();
-    
+
     conDos.visit(hayes);
-    
+
     assertThat(logger.getLoggingEvents())
         .extracting("level", "message")
         .contains(tuple(INFO, hayes + " used with Dos configurator."));
   }
-  
+
   @AfterEach
   public void clearLoggers() {
     TestLoggerFactory.clear();
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
index 5473e95ef..d2ea55809 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ConfigureForUnixVisitorTest.java
@@ -23,35 +23,34 @@
 
 package com.iluwatar.acyclicvisitor;
 
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.Test;
+import uk.org.lidalia.slf4jtest.TestLogger;
+import uk.org.lidalia.slf4jtest.TestLoggerFactory;
+
 import static org.assertj.core.api.Assertions.assertThat;
 import static org.assertj.core.groups.Tuple.tuple;
 import static uk.org.lidalia.slf4jext.Level.INFO;
 
-import org.junit.jupiter.api.AfterEach;
-import org.junit.jupiter.api.Test;
-
-import uk.org.lidalia.slf4jtest.TestLogger;
-import uk.org.lidalia.slf4jtest.TestLoggerFactory;
-
 /**
  * ConfigureForUnixVisitor test class
  */
-public class ConfigureForUnixVisitorTest {
-  
+class ConfigureForUnixVisitorTest {
+
   private static final TestLogger LOGGER = TestLoggerFactory.getTestLogger(ConfigureForUnixVisitor.class);
-  
+
   @AfterEach
   public void clearLoggers() {
     TestLoggerFactory.clear();
   }
-  
+
   @Test
-  public void testVisitForZoom() {
+  void testVisitForZoom() {
     var conUnix = new ConfigureForUnixVisitor();
     var zoom = new Zoom();
-    
+
     conUnix.visit(zoom);
-    
+
     assertThat(LOGGER.getLoggingEvents())
         .extracting("level", "message")
         .contains(tuple(INFO, zoom + " used with Unix configurator."));
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
index a2ded206f..eaf9fb152 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/HayesTest.java
@@ -23,34 +23,32 @@
 
 package com.iluwatar.acyclicvisitor;
 
-import static org.mockito.Matchers.eq;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.verifyZeroInteractions;
-
 import org.junit.jupiter.api.Test;
 
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.*;
+
 /**
  * Hayes test class
  */
-public class HayesTest {
+class HayesTest {
 
   @Test
-  public void testAcceptForDos() {  
+  void testAcceptForDos() {
     var hayes = new Hayes();
     var mockVisitor = mock(ConfigureForDosVisitor.class);
-    
+
     hayes.accept(mockVisitor);
-    verify((HayesVisitor)mockVisitor).visit(eq(hayes));
+    verify((HayesVisitor) mockVisitor).visit(eq(hayes));
   }
-  
+
   @Test
-  public void testAcceptForUnix() {    
+  void testAcceptForUnix() {
     var hayes = new Hayes();
     var mockVisitor = mock(ConfigureForUnixVisitor.class);
-    
+
     hayes.accept(mockVisitor);
-    
+
     verifyZeroInteractions(mockVisitor);
   }
 }
diff --git a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
index 923632228..4373fe818 100644
--- a/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
+++ b/acyclic-visitor/src/test/java/com/iluwatar/acyclicvisitor/ZoomTest.java
@@ -24,32 +24,32 @@
 package com.iluwatar.acyclicvisitor;
 
 
-import static org.mockito.Matchers.eq;
-import static org.mockito.Mockito.verify;
-import static org.mockito.Mockito.mock;
-
 import org.junit.jupiter.api.Test;
 
+import static org.mockito.Matchers.eq;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+
 /**
  * Zoom test class
  */
-public class ZoomTest {
-  
+class ZoomTest {
+
   @Test
-  public void testAcceptForDos() {  
+  void testAcceptForDos() {
     var zoom = new Zoom();
     var mockVisitor = mock(ConfigureForDosVisitor.class);
-    
+
     zoom.accept(mockVisitor);
-    verify((ZoomVisitor)mockVisitor).visit(eq(zoom));
+    verify((ZoomVisitor) mockVisitor).visit(eq(zoom));
   }
-  
+
   @Test
-  public void testAcceptForUnix() {
+  void testAcceptForUnix() {
     var zoom = new Zoom();
     var mockVisitor = mock(ConfigureForUnixVisitor.class);
-    
+
     zoom.accept(mockVisitor);
-    verify((ZoomVisitor)mockVisitor).visit(eq(zoom));
+    verify((ZoomVisitor) mockVisitor).visit(eq(zoom));
   }
 }
diff --git a/adapter/README.md b/adapter/README.md
index aef4cdb69..65ffa4fc6 100644
--- a/adapter/README.md
+++ b/adapter/README.md
@@ -42,8 +42,8 @@ public interface RowingBoat {
   void row();
 }
 
+@Slf4j
 public class FishingBoat {
-  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class);
   public void sail() {
     LOGGER.info("The fishing boat is sailing");
   }
@@ -70,10 +70,9 @@ public class Captain {
 Now let's say the pirates are coming and our captain needs to escape but there is only fishing boat available. We need to create an adapter that allows the captain to operate the fishing boat with his rowing boat skills.
 
 ```java
+@Slf4j
 public class FishingBoatAdapter implements RowingBoat {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoatAdapter.class);
-
   private final FishingBoat boat;
 
   public FishingBoatAdapter() {
diff --git a/adapter/src/main/java/com/iluwatar/adapter/Captain.java b/adapter/src/main/java/com/iluwatar/adapter/Captain.java
index 9e6c9f816..036792e8c 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/Captain.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/Captain.java
@@ -23,24 +23,20 @@
 
 package com.iluwatar.adapter;
 
+import lombok.AllArgsConstructor;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+
 /**
  * The Captain uses {@link RowingBoat} to sail. <br> This is the client in the pattern.
  */
+@Setter
+@NoArgsConstructor
+@AllArgsConstructor
 public final class Captain {
 
   private RowingBoat rowingBoat;
 
-  public Captain() {
-  }
-
-  public Captain(final RowingBoat boat) {
-    this.rowingBoat = boat;
-  }
-
-  void setRowingBoat(final RowingBoat boat) {
-    this.rowingBoat = boat;
-  }
-
   void row() {
     rowingBoat.row();
   }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java b/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
index a6af76040..38866dc33 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/FishingBoat.java
@@ -23,18 +23,15 @@
 
 package com.iluwatar.adapter;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
-import org.slf4j.Logger;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Device class (adaptee in the pattern). We want to reuse this class. Fishing boat moves by
  * sailing.
  */
+@Slf4j
 final class FishingBoat {
 
-  private static final Logger LOGGER = getLogger(FishingBoat.class);
-
   void sail() {
     LOGGER.info("The fishing boat is sailing");
   }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java b/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
index 84035d62e..73c7dd60e 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/FishingBoatAdapter.java
@@ -29,11 +29,7 @@ package com.iluwatar.adapter;
  */
 public class FishingBoatAdapter implements RowingBoat {
 
-  private final FishingBoat boat;
-
-  public FishingBoatAdapter() {
-    boat = new FishingBoat();
-  }
+  private final FishingBoat boat = new FishingBoat();
 
   public final void row() {
     boat.sail();
diff --git a/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java b/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
index c8291400d..fc55cd69e 100644
--- a/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
+++ b/adapter/src/test/java/com/iluwatar/adapter/AdapterPatternTest.java
@@ -23,18 +23,19 @@
 
 package com.iluwatar.adapter;
 
-import static org.mockito.Mockito.spy;
-import static org.mockito.Mockito.verify;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 import java.util.HashMap;
 import java.util.Map;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
+
+import static org.mockito.Mockito.spy;
+import static org.mockito.Mockito.verify;
 
 /**
  * Test class
  */
-public class AdapterPatternTest {
+class AdapterPatternTest {
 
   private Map<String, Object> beans;
 
@@ -64,7 +65,7 @@ public class AdapterPatternTest {
    * by the client ({@link Captain} ).
    */
   @Test
-  public void testAdapter() {
+  void testAdapter() {
     var captain = (Captain) beans.get(ROWING_BEAN);
 
     // when captain moves
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
index c467a25d0..209187bd7 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Aggregator.java
@@ -26,8 +26,7 @@ package com.iluwatar.aggregator.microservices;
 import static java.util.Objects.requireNonNullElse;
 
 import javax.annotation.Resource;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 /**
@@ -37,20 +36,18 @@ import org.springframework.web.bind.annotation.RestController;
 @RestController
 public class Aggregator {
 
-
   @Resource
   private ProductInformationClient informationClient;
 
   @Resource
   private ProductInventoryClient inventoryClient;
 
-
   /**
    * Retrieves product data.
    *
    * @return a Product.
    */
-  @RequestMapping(path = "/product", method = RequestMethod.GET)
+  @GetMapping("/product")
   public Product getProduct() {
 
     var product = new Product();
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
index ca9af3de1..f451728b9 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/Product.java
@@ -23,9 +23,14 @@
 
 package com.iluwatar.aggregator.microservices;
 
+import lombok.Getter;
+import lombok.Setter;
+
 /**
  * Encapsulates all the data for a Product that clients will request.
  */
+@Getter
+@Setter
 public class Product {
 
   /**
@@ -39,20 +44,4 @@ public class Product {
    */
   private int productInventories;
 
-  public String getTitle() {
-    return title;
-  }
-
-  public void setTitle(String title) {
-    this.title = title;
-  }
-
-  public int getProductInventories() {
-    return productInventories;
-  }
-
-  public void setProductInventories(int productInventories) {
-    this.productInventories = productInventories;
-  }
-
 }
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
index 4164a5e6d..2fcad382e 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInformationClientImpl.java
@@ -28,18 +28,16 @@ import java.net.URI;
 import java.net.http.HttpClient;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
 
 /**
  * An adapter to communicate with information micro-service.
  */
+@Slf4j
 @Component
 public class ProductInformationClientImpl implements ProductInformationClient {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ProductInformationClientImpl.class);
-
   @Override
   public String getProductTitle() {
     var request = HttpRequest.newBuilder()
@@ -54,6 +52,7 @@ public class ProductInformationClientImpl implements ProductInformationClient {
       LOGGER.error("IOException Occurred", ioe);
     } catch (InterruptedException ie) {
       LOGGER.error("InterruptedException Occurred", ie);
+      Thread.currentThread().interrupt();
     }
     return null;
   }
diff --git a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
index 6ed566ac4..cc78d2d8d 100644
--- a/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
+++ b/aggregator-microservices/aggregator-service/src/main/java/com/iluwatar/aggregator/microservices/ProductInventoryClientImpl.java
@@ -28,18 +28,16 @@ import java.net.URI;
 import java.net.http.HttpClient;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
 
 /**
  * An adapter to communicate with inventory micro-service.
  */
+@Slf4j
 @Component
 public class ProductInventoryClientImpl implements ProductInventoryClient {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ProductInventoryClientImpl.class);
-
   @Override
   public Integer getProductInventories() {
     var response = "";
@@ -56,6 +54,7 @@ public class ProductInventoryClientImpl implements ProductInventoryClient {
       LOGGER.error("IOException Occurred", ioe);
     } catch (InterruptedException ie) {
       LOGGER.error("InterruptedException Occurred", ie);
+      Thread.currentThread().interrupt();
     }
     if ("".equalsIgnoreCase(response)) {
       return null;
diff --git a/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
index f8ff2173e..2ffa9cd42 100644
--- a/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
+++ b/aggregator-microservices/aggregator-service/src/test/java/com/iluwatar/aggregator/microservices/AggregatorTest.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.aggregator.microservices;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.mockito.Mockito.when;
-
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.mockito.InjectMocks;
 import org.mockito.Mock;
 import org.mockito.MockitoAnnotations;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.when;
+
 /**
  * Test Aggregation of domain objects
  */
-public class AggregatorTest {
+class AggregatorTest {
 
   @InjectMocks
   private Aggregator aggregator;
@@ -55,7 +55,7 @@ public class AggregatorTest {
    * Tests getting the data for a desktop client
    */
   @Test
-  public void testGetProduct() {
+  void testGetProduct() {
     var title = "The Product Title.";
     var inventories = 5;
 
diff --git a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
index a8b60ffb8..4849e4228 100644
--- a/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
+++ b/aggregator-microservices/information-microservice/src/main/java/com/iluwatar/information/microservice/InformationController.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.information.microservice;
 
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 /**
@@ -38,7 +37,7 @@ public class InformationController {
    *
    * @return product inventory.
    */
-  @RequestMapping(value = "/information", method = RequestMethod.GET)
+  @GetMapping("/information")
   public String getProductTitle() {
     return "The Product Title.";
   }
diff --git a/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
index d3e07c552..909392d1d 100644
--- a/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
+++ b/aggregator-microservices/information-microservice/src/test/java/com/iluwatar/information/microservice/InformationControllerTest.java
@@ -23,17 +23,17 @@
 
 package com.iluwatar.information.microservice;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Test for Information Rest Controller
  */
-public class InformationControllerTest {
+class InformationControllerTest {
 
   @Test
-  public void shouldGetProductTitle() {
+  void shouldGetProductTitle() {
     var infoController = new InformationController();
     var title = infoController.getProductTitle();
     assertEquals("The Product Title.", title);
diff --git a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
index e40835860..0e40507cc 100644
--- a/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
+++ b/aggregator-microservices/inventory-microservice/src/main/java/com/iluwatar/inventory/microservice/InventoryController.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.inventory.microservice;
 
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 /**
@@ -38,7 +37,7 @@ public class InventoryController {
    *
    * @return product inventory.
    */
-  @RequestMapping(value = "/inventories", method = RequestMethod.GET)
+  @GetMapping("/inventories")
   public int getProductInventories() {
     return 5;
   }
diff --git a/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
index 5d278dd76..9a85f1d5a 100644
--- a/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
+++ b/aggregator-microservices/inventory-microservice/src/test/java/com/iluwatar/inventory/microservice/InventoryControllerTest.java
@@ -23,16 +23,17 @@
 
 package com.iluwatar.inventory.microservice;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Test Inventory Rest Controller
  */
-public class InventoryControllerTest {
+class InventoryControllerTest {
+
   @Test
-  public void testGetProductInventories() {
+  void testGetProductInventories() {
     var inventoryController = new InventoryController();
     var numberOfInventories = inventoryController.getProductInventories();
     assertEquals(5, numberOfInventories);
diff --git a/ambassador/README.md b/ambassador/README.md
index dfba18649..9010c44b6 100644
--- a/ambassador/README.md
+++ b/ambassador/README.md
@@ -48,9 +48,8 @@ interface RemoteServiceInterface {
 A remote services represented as a singleton.
 
 ```java
+@Slf4j
 public class RemoteService implements RemoteServiceInterface {
-
-    private static final Logger LOGGER = LoggerFactory.getLogger(RemoteService.class);
     private static RemoteService service = null;
 
     static synchronized RemoteService getRemoteService() {
@@ -80,9 +79,8 @@ public class RemoteService implements RemoteServiceInterface {
 A service ambassador adding additional features such as logging, latency checks
 
 ```java
+@Slf4j
 public class ServiceAmbassador implements RemoteServiceInterface {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(ServiceAmbassador.class);
   private static final int RETRIES = 3;
   private static final int DELAY_MS = 3000;
 
@@ -132,9 +130,8 @@ public class ServiceAmbassador implements RemoteServiceInterface {
 A client has a local service ambassador used to interact with the remote service:
 
 ```java
+@Slf4j
 public class Client {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(Client.class);
   private final ServiceAmbassador serviceAmbassador = new ServiceAmbassador();
 
   long useService(int value) {
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/Client.java b/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
index dde44bd3f..0ec258016 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/Client.java
@@ -23,20 +23,19 @@
 
 package com.iluwatar.ambassador;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A simple Client.
  */
+@Slf4j
 public class Client {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Client.class);
   private final ServiceAmbassador serviceAmbassador = new ServiceAmbassador();
 
   long useService(int value) {
     var result = serviceAmbassador.doRemoteFunction(value);
-    LOGGER.info("Service result: " + result);
+    LOGGER.info("Service result: {}", result);
     return result;
   }
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
index c2524ad47..18a2d2214 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteService.java
@@ -26,15 +26,14 @@ package com.iluwatar.ambassador;
 import static java.lang.Thread.sleep;
 
 import com.iluwatar.ambassador.util.RandomProvider;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A remote legacy application represented by a Singleton implementation.
  */
+@Slf4j
 public class RemoteService implements RemoteServiceInterface {
   private static final int THRESHOLD = 200;
-  private static final Logger LOGGER = LoggerFactory.getLogger(RemoteService.class);
   private static RemoteService service = null;
   private final RandomProvider randomProvider;
 
@@ -73,8 +72,9 @@ public class RemoteService implements RemoteServiceInterface {
       sleep(waitTime);
     } catch (InterruptedException e) {
       LOGGER.error("Thread sleep state interrupted", e);
+      Thread.currentThread().interrupt();
     }
     return waitTime <= THRESHOLD ? value * 10
-            : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();
+        : RemoteServiceStatus.FAILURE.getRemoteServiceStatusValue();
   }
 }
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
index 64cb6eaac..e7ee06af9 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/RemoteServiceStatus.java
@@ -33,8 +33,7 @@ package com.iluwatar.ambassador;
  */
 
 public enum RemoteServiceStatus {
-  FAILURE(-1)
-  ;
+  FAILURE(-1);
 
   private final long remoteServiceStatusValue;
 
diff --git a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
index 771da8602..bd8481d00 100644
--- a/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
+++ b/ambassador/src/main/java/com/iluwatar/ambassador/ServiceAmbassador.java
@@ -26,17 +26,16 @@ package com.iluwatar.ambassador;
 import static com.iluwatar.ambassador.RemoteServiceStatus.FAILURE;
 import static java.lang.Thread.sleep;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ServiceAmbassador provides an interface for a ({@link Client}) to access ({@link RemoteService}).
  * The interface adds logging, latency testing and usage of the service in a safe way that will not
  * add stress to the remote service when connectivity issues occur.
  */
+@Slf4j
 public class ServiceAmbassador implements RemoteServiceInterface {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ServiceAmbassador.class);
   private static final int RETRIES = 3;
   private static final int DELAY_MS = 3000;
 
@@ -53,7 +52,7 @@ public class ServiceAmbassador implements RemoteServiceInterface {
     var result = RemoteService.getRemoteService().doRemoteFunction(value);
     var timeTaken = System.currentTimeMillis() - startTime;
 
-    LOGGER.info("Time taken (ms): " + timeTaken);
+    LOGGER.info("Time taken (ms): {}", timeTaken);
     return result;
   }
 
@@ -67,12 +66,13 @@ public class ServiceAmbassador implements RemoteServiceInterface {
       }
 
       if ((result = checkLatency(value)) == FAILURE.getRemoteServiceStatusValue()) {
-        LOGGER.info("Failed to reach remote: (" + (i + 1) + ")");
+        LOGGER.info("Failed to reach remote: ({})", i + 1);
         retries++;
         try {
           sleep(DELAY_MS);
         } catch (InterruptedException e) {
           LOGGER.error("Thread sleep state interrupted", e);
+          Thread.currentThread().interrupt();
         }
       } else {
         break;
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
index 6d0cde3d3..df060b562 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ApiGateway.java
@@ -24,8 +24,7 @@
 package com.iluwatar.api.gateway;
 
 import javax.annotation.Resource;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 /**
@@ -45,7 +44,7 @@ public class ApiGateway {
    *
    * @return Product information for clients on a desktop
    */
-  @RequestMapping(path = "/desktop", method = RequestMethod.GET)
+  @GetMapping("/desktop")
   public DesktopProduct getProductDesktop() {
     var desktopProduct = new DesktopProduct();
     desktopProduct.setImagePath(imageClient.getImagePath());
@@ -58,7 +57,7 @@ public class ApiGateway {
    *
    * @return Product information for clients on a mobile device
    */
-  @RequestMapping(path = "/mobile", method = RequestMethod.GET)
+  @GetMapping("/mobile")
   public MobileProduct getProductMobile() {
     var mobileProduct = new MobileProduct();
     mobileProduct.setPrice(priceClient.getPrice());
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
index e4660c31a..0b0d3cde3 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/DesktopProduct.java
@@ -23,10 +23,16 @@
 
 package com.iluwatar.api.gateway;
 
+import lombok.Getter;
+import lombok.Setter;
+
 /**
  * Encapsulates all of the information that a desktop client needs to display a product.
  */
+@Getter
+@Setter
 public class DesktopProduct {
+
   /**
    * The price of the product.
    */
@@ -37,19 +43,4 @@ public class DesktopProduct {
    */
   private String imagePath;
 
-  public String getPrice() {
-    return price;
-  }
-
-  public void setPrice(String price) {
-    this.price = price;
-  }
-
-  public String getImagePath() {
-    return imagePath;
-  }
-
-  public void setImagePath(String imagePath) {
-    this.imagePath = imagePath;
-  }
 }
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
index 2ec726693..b98d06bf2 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/ImageClientImpl.java
@@ -23,24 +23,21 @@
 
 package com.iluwatar.api.gateway;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
 import java.io.IOException;
 import java.net.URI;
 import java.net.http.HttpClient;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
 import java.net.http.HttpResponse.BodyHandlers;
-
-import org.slf4j.Logger;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
 
 /**
  * An adapter to communicate with the Image microservice.
  */
+@Slf4j
 @Component
 public class ImageClientImpl implements ImageClient {
-  private static final Logger LOGGER = getLogger(ImageClientImpl.class);
 
   /**
    * Makes a simple HTTP Get request to the Image microservice.
@@ -60,8 +57,11 @@ public class ImageClientImpl implements ImageClient {
       var httpResponse = httpClient.send(httpGet, BodyHandlers.ofString());
       logResponse(httpResponse);
       return httpResponse.body();
-    } catch (IOException | InterruptedException e) {
-      LOGGER.error("Failure occurred while getting image path", e);
+    } catch (IOException ioe) {
+      LOGGER.error("Failure occurred while getting image path", ioe);
+    } catch (InterruptedException ie) {
+      LOGGER.error("Failure occurred while getting image path", ie);
+      Thread.currentThread().interrupt();
     }
 
     return null;
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
index e59af3693..5fc395c90 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/MobileProduct.java
@@ -23,20 +23,17 @@
 
 package com.iluwatar.api.gateway;
 
+import lombok.Getter;
+import lombok.Setter;
+
 /**
  * Encapsulates all of the information that mobile client needs to display a product.
  */
+@Getter
+@Setter
 public class MobileProduct {
   /**
    * The price of the product.
    */
   private String price;
-
-  public String getPrice() {
-    return price;
-  }
-
-  public void setPrice(String price) {
-    this.price = price;
-  }
 }
diff --git a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
index 801b9a3b6..f5a7b8b5d 100644
--- a/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
+++ b/api-gateway/api-gateway-service/src/main/java/com/iluwatar/api/gateway/PriceClientImpl.java
@@ -23,25 +23,22 @@
 
 package com.iluwatar.api.gateway;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
 import java.io.IOException;
 import java.net.URI;
 import java.net.http.HttpClient;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
 import java.net.http.HttpResponse.BodyHandlers;
-
-import org.slf4j.Logger;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
 
 
 /**
  * An adapter to communicate with the Price microservice.
  */
+@Slf4j
 @Component
 public class PriceClientImpl implements PriceClient {
-  private static final Logger LOGGER = getLogger(PriceClientImpl.class);
 
   /**
    * Makes a simple HTTP Get request to the Price microservice.
@@ -61,8 +58,11 @@ public class PriceClientImpl implements PriceClient {
       var httpResponse = httpClient.send(httpGet, BodyHandlers.ofString());
       logResponse(httpResponse);
       return httpResponse.body();
-    } catch (IOException | InterruptedException e) {
+    } catch (IOException e) {
       LOGGER.error("Failure occurred while getting price info", e);
+    } catch (InterruptedException e) {
+      LOGGER.error("Failure occurred while getting price info", e);
+      Thread.currentThread().interrupt();
     }
 
     return null;
diff --git a/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java b/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
index 5de617fc6..94e76583e 100644
--- a/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
+++ b/api-gateway/api-gateway-service/src/test/java/com/iluwatar/api/gateway/ApiGatewayTest.java
@@ -35,7 +35,7 @@ import org.mockito.MockitoAnnotations;
 /**
  * Test API Gateway Pattern
  */
-public class ApiGatewayTest {
+class ApiGatewayTest {
 
   @InjectMocks
   private ApiGateway apiGateway;
@@ -55,7 +55,7 @@ public class ApiGatewayTest {
    * Tests getting the data for a desktop client
    */
   @Test
-  public void testGetProductDesktop() {
+  void testGetProductDesktop() {
     var imagePath = "/product-image.png";
     var price = "20";
     when(imageClient.getImagePath()).thenReturn(imagePath);
@@ -71,7 +71,7 @@ public class ApiGatewayTest {
    * Tests getting the data for a mobile client
    */
   @Test
-  public void testGetProductMobile() {
+  void testGetProductMobile() {
     var price = "20";
     when(priceClient.getPrice()).thenReturn(price);
 
diff --git a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
index 232c7004c..44828b269 100644
--- a/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
+++ b/api-gateway/image-microservice/src/main/java/com/iluwatar/image/microservice/ImageController.java
@@ -23,27 +23,24 @@
 
 package com.iluwatar.image.microservice;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
-import org.slf4j.Logger;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 
 /**
  * Exposes the Image microservice's endpoints.
  */
+@Slf4j
 @RestController
 public class ImageController {
-  private static final Logger LOGGER = getLogger(ImageController.class);
 
   /**
    * An endpoint for a user to retrieve an image path.
    *
    * @return An image path
    */
-  @RequestMapping(value = "/image-path", method = RequestMethod.GET)
+  @GetMapping("/image-path")
   public String getImagePath() {
     LOGGER.info("Successfully found image path");
     return "/product-image.png";
diff --git a/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java b/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
index d1a6caf91..4d455a94f 100644
--- a/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
+++ b/api-gateway/image-microservice/src/test/java/com/iluwatar/image/microservice/ImageControllerTest.java
@@ -23,16 +23,17 @@
 
 package com.iluwatar.image.microservice;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Test for Image Rest Controller
  */
-public class ImageControllerTest {
+class ImageControllerTest {
+
   @Test
-  public void testGetImagePath() {
+  void testGetImagePath() {
     var imageController = new ImageController();
     var imagePath = imageController.getImagePath();
     assertEquals("/product-image.png", imagePath);
diff --git a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
index 7502e0c24..045749c8d 100644
--- a/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
+++ b/api-gateway/price-microservice/src/main/java/com/iluwatar/price/microservice/PriceController.java
@@ -23,27 +23,24 @@
 
 package com.iluwatar.price.microservice;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
-import org.slf4j.Logger;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RequestMethod;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 
 /**
  * Exposes the Price microservice's endpoints.
  */
+@Slf4j
 @RestController
 public class PriceController {
-  private static final Logger LOGGER = getLogger(PriceController.class);
 
   /**
    * An endpoint for a user to retrieve a product's price.
    *
    * @return A product's price
    */
-  @RequestMapping(value = "/price", method = RequestMethod.GET)
+  @GetMapping("/price")
   public String getPrice() {
     LOGGER.info("Successfully found price info");
     return "20";
diff --git a/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java b/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
index 4fcc69ebc..b727d3890 100644
--- a/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
+++ b/api-gateway/price-microservice/src/test/java/com/iluwatar/price/microservice/PriceControllerTest.java
@@ -23,16 +23,17 @@
 
 package com.iluwatar.price.microservice;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
-
 import org.junit.jupiter.api.Test;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 /**
  * Test for Price Rest Controller
  */
-public class PriceControllerTest {
+class PriceControllerTest {
+
   @Test
-  public void testgetPrice() {
+  void testgetPrice() {
     var priceController = new PriceController();
     var price = priceController.getPrice();
     assertEquals("20", price);
diff --git a/arrange-act-assert/README.md b/arrange-act-assert/README.md
index 6b3cb4058..23efdd71e 100644
--- a/arrange-act-assert/README.md
+++ b/arrange-act-assert/README.md
@@ -81,10 +81,10 @@ Then we write our unit tests according to Arrange/Act/Assert pattern. Notice the
 separated steps for each unit test.
 
 ```java
-public class CashAAATest {
+class CashAAATest {
 
   @Test
-  public void testPlus() {
+  void testPlus() {
     //Arrange
     var cash = new Cash(3);
     //Act
@@ -94,7 +94,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testMinus() {
+  void testMinus() {
     //Arrange
     var cash = new Cash(8);
     //Act
@@ -105,7 +105,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testInsufficientMinus() {
+  void testInsufficientMinus() {
     //Arrange
     var cash = new Cash(1);
     //Act
@@ -116,7 +116,7 @@ public class CashAAATest {
   }
 
   @Test
-  public void testUpdate() {
+  void testUpdate() {
     //Arrange
     var cash = new Cash(5);
     //Act
diff --git a/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java b/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
index 317848ae0..53b002f0a 100644
--- a/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
+++ b/arrange-act-assert/src/main/java/com/iluwatar/arrangeactassert/Cash.java
@@ -23,18 +23,17 @@
 
 package com.iluwatar.arrangeactassert;
 
+import lombok.AllArgsConstructor;
+
 /**
  * Arrange/Act/Assert (AAA) is a unit test pattern. In this simple example, we have a ({@link Cash})
  * object for plus, minus and counting amount.
  */
+@AllArgsConstructor
 public class Cash {
 
   private int amount;
 
-  Cash(int amount) {
-    this.amount = amount;
-  }
-
   //plus
   void plus(int addend) {
     amount += addend;
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
index 13959f1e3..04902a94c 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.async.method.invocation;
 
 import java.util.concurrent.Callable;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This application demonstrates the async method invocation pattern. Key parts of the pattern are
@@ -55,10 +54,9 @@ import org.slf4j.LoggerFactory;
  * @see java.util.concurrent.CompletableFuture
  * @see java.util.concurrent.ExecutorService
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/balking/src/main/java/com/iluwatar/balking/App.java b/balking/src/main/java/com/iluwatar/balking/App.java
index 7d66724b5..68b5eb44a 100644
--- a/balking/src/main/java/com/iluwatar/balking/App.java
+++ b/balking/src/main/java/com/iluwatar/balking/App.java
@@ -23,11 +23,9 @@
 
 package com.iluwatar.balking;
 
-import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * In Balking Design Pattern if an object’s method is invoked when it is in an inappropriate state,
@@ -40,11 +38,9 @@ import org.slf4j.LoggerFactory;
  * been already washing and any other thread execute wash() it can't do that once again and returns
  * doing nothing.
  */
-
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Entry Point.
    *
@@ -61,6 +57,7 @@ public class App {
       executorService.awaitTermination(10, TimeUnit.SECONDS);
     } catch (InterruptedException ie) {
       LOGGER.error("ERROR: Waiting on executor service shutdown!");
+      Thread.currentThread().interrupt();
     }
   }
 
diff --git a/balking/src/main/java/com/iluwatar/balking/WashingMachine.java b/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
index 401aa5feb..1da2b0204 100644
--- a/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
+++ b/balking/src/main/java/com/iluwatar/balking/WashingMachine.java
@@ -24,15 +24,14 @@
 package com.iluwatar.balking;
 
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Washing machine class.
  */
+@Slf4j
 public class WashingMachine {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(WashingMachine.class);
   private final DelayProvider delayProvider;
   private WashingMachineState washingMachineState;
 
@@ -44,7 +43,8 @@ public class WashingMachine {
       try {
         Thread.sleep(timeUnit.toMillis(interval));
       } catch (InterruptedException ie) {
-        ie.printStackTrace();
+        LOGGER.error("", ie);
+        Thread.currentThread().interrupt();
       }
       task.run();
     });
@@ -71,7 +71,7 @@ public class WashingMachine {
       var machineState = getWashingMachineState();
       LOGGER.info("{}: Actual machine state: {}", Thread.currentThread().getName(), machineState);
       if (this.washingMachineState == WashingMachineState.WASHING) {
-        LOGGER.error("ERROR: Cannot wash if the machine has been already washing!");
+        LOGGER.error("Cannot wash if the machine has been already washing!");
         return;
       }
       this.washingMachineState = WashingMachineState.WASHING;
diff --git a/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java b/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
index 90ad0d9b4..f652a841f 100644
--- a/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
+++ b/balking/src/main/java/com/iluwatar/balking/WashingMachineState.java
@@ -28,5 +28,6 @@ package com.iluwatar.balking;
  * as well as during washing.
  */
 public enum WashingMachineState {
-  ENABLED, WASHING
+  ENABLED,
+  WASHING
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/App.java b/bridge/src/main/java/com/iluwatar/bridge/App.java
index 218d65b54..639d53f58 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/App.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.bridge;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Composition over inheritance. The Bridge pattern can also be thought of as two layers of
@@ -39,10 +38,9 @@ import org.slf4j.LoggerFactory;
  * enchantments. We can easily combine any weapon with any enchantment using composition instead of
  * creating deep class hierarchy.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
index c2300c03d..436b11a70 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingEnchantment.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.bridge;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * FlyingEnchantment.
  */
+@Slf4j
 public class FlyingEnchantment implements Enchantment {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(FlyingEnchantment.class);
-
   @Override
   public void onActivate() {
     LOGGER.info("The item begins to glow faintly.");
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Hammer.java b/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
index b535c403c..834a2c54a 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Hammer.java
@@ -23,22 +23,18 @@
 
 package com.iluwatar.bridge;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.AllArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Hammer.
  */
+@Slf4j
+@AllArgsConstructor
 public class Hammer implements Weapon {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Hammer.class);
-
   private final Enchantment enchantment;
 
-  public Hammer(Enchantment enchantment) {
-    this.enchantment = enchantment;
-  }
-
   @Override
   public void wield() {
     LOGGER.info("The hammer is wielded.");
diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
index 286272aab..746b827f6 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingEnchantment.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.bridge;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SoulEatingEnchantment.
  */
+@Slf4j
 public class SoulEatingEnchantment implements Enchantment {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SoulEatingEnchantment.class);
-
   @Override
   public void onActivate() {
     LOGGER.info("The item spreads bloodlust.");
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Sword.java b/bridge/src/main/java/com/iluwatar/bridge/Sword.java
index f669c5516..ef9764eca 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Sword.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Sword.java
@@ -23,22 +23,18 @@
 
 package com.iluwatar.bridge;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.AllArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Sword.
  */
+@Slf4j
+@AllArgsConstructor
 public class Sword implements Weapon {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Sword.class);
-
   private final Enchantment enchantment;
 
-  public Sword(Enchantment enchantment) {
-    this.enchantment = enchantment;
-  }
-
   @Override
   public void wield() {
     LOGGER.info("The sword is wielded.");
diff --git a/builder/src/main/java/com/iluwatar/builder/App.java b/builder/src/main/java/com/iluwatar/builder/App.java
index 950e018cc..e62dd8ceb 100644
--- a/builder/src/main/java/com/iluwatar/builder/App.java
+++ b/builder/src/main/java/com/iluwatar/builder/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.builder;
 
 import com.iluwatar.builder.Hero.Builder;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The intention of the Builder pattern is to find a solution to the telescoping constructor
@@ -48,10 +47,9 @@ import org.slf4j.LoggerFactory;
  * configuration for the {@link Hero} object can be done using the fluent {@link Builder} interface.
  * When configuration is ready the build method is called to receive the final {@link Hero} object.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
@@ -76,6 +74,5 @@ public class App {
         .withWeapon(Weapon.BOW)
         .build();
     LOGGER.info(thief.toString());
-
   }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/Armor.java b/builder/src/main/java/com/iluwatar/builder/Armor.java
index 7f1dc5164..0ed7be12e 100644
--- a/builder/src/main/java/com/iluwatar/builder/Armor.java
+++ b/builder/src/main/java/com/iluwatar/builder/Armor.java
@@ -23,19 +23,21 @@
 
 package com.iluwatar.builder;
 
+import lombok.AllArgsConstructor;
+
 /**
  * Armor enumeration.
  */
+@AllArgsConstructor
 public enum Armor {
 
-  CLOTHES("clothes"), LEATHER("leather"), CHAIN_MAIL("chain mail"), PLATE_MAIL("plate mail");
+  CLOTHES("clothes"),
+  LEATHER("leather"),
+  CHAIN_MAIL("chain mail"),
+  PLATE_MAIL("plate mail");
 
   private final String title;
 
-  Armor(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/builder/src/main/java/com/iluwatar/builder/HairColor.java b/builder/src/main/java/com/iluwatar/builder/HairColor.java
index 9437a4cd5..361bd5556 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairColor.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairColor.java
@@ -28,7 +28,11 @@ package com.iluwatar.builder;
  */
 public enum HairColor {
 
-  WHITE, BLOND, RED, BROWN, BLACK;
+  WHITE,
+  BLOND,
+  RED,
+  BROWN,
+  BLACK;
 
   @Override
   public String toString() {
diff --git a/builder/src/main/java/com/iluwatar/builder/HairType.java b/builder/src/main/java/com/iluwatar/builder/HairType.java
index 882bdd7c5..9342031f6 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairType.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairType.java
@@ -23,20 +23,22 @@
 
 package com.iluwatar.builder;
 
+import lombok.AllArgsConstructor;
+
 /**
  * HairType enumeration.
  */
+@AllArgsConstructor
 public enum HairType {
 
-  BALD("bald"), SHORT("short"), CURLY("curly"), LONG_STRAIGHT("long straight"), LONG_CURLY(
-      "long curly");
+  BALD("bald"),
+  SHORT("short"),
+  CURLY("curly"),
+  LONG_STRAIGHT("long straight"),
+  LONG_CURLY("long curly");
 
   private final String title;
 
-  HairType(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/builder/src/test/java/com/iluwatar/builder/AppTest.java b/builder/src/test/java/com/iluwatar/builder/AppTest.java
index 2f32066e1..1c9ccddfa 100644
--- a/builder/src/test/java/com/iluwatar/builder/AppTest.java
+++ b/builder/src/test/java/com/iluwatar/builder/AppTest.java
@@ -41,7 +41,6 @@ class AppTest {
 
   @Test
   void shouldExecuteApplicationWithoutException() {
-
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
index f2dfc49f6..d1255bf5f 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
@@ -29,7 +29,6 @@ package com.iluwatar.business.delegate;
 public class BusinessDelegate {
 
   private BusinessLookup lookupService;
-  private BusinessService businessService;
   private ServiceType serviceType;
 
   public void setLookupService(BusinessLookup businessLookup) {
@@ -41,7 +40,7 @@ public class BusinessDelegate {
   }
 
   public void doTask() {
-    businessService = lookupService.getBusinessService(serviceType);
+    BusinessService businessService = lookupService.getBusinessService(serviceType);
     businessService.doProcessing();
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
index dabe9664c..07ad6342e 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
@@ -23,9 +23,12 @@
 
 package com.iluwatar.business.delegate;
 
+import lombok.Setter;
+
 /**
  * Class for performing service lookups.
  */
+@Setter
 public class BusinessLookup {
 
   private EjbService ejbService;
@@ -45,12 +48,4 @@ public class BusinessLookup {
       return jmsService;
     }
   }
-
-  public void setJmsService(JmsService jmsService) {
-    this.jmsService = jmsService;
-  }
-
-  public void setEjbService(EjbService ejbService) {
-    this.ejbService = ejbService;
-  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
index 4c90c1377..6813dfec1 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.business.delegate;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Service EJB implementation.
  */
+@Slf4j
 public class EjbService implements BusinessService {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(EjbService.class);
-
   @Override
   public void doProcessing() {
     LOGGER.info("EjbService is now processing");
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
index 1f218a402..932c5038d 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.business.delegate;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Service JMS implementation.
  */
+@Slf4j
 public class JmsService implements BusinessService {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(JmsService.class);
-
   @Override
   public void doProcessing() {
     LOGGER.info("JmsService is now processing");
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
index 68e1bbf72..503f30797 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
@@ -28,5 +28,6 @@ package com.iluwatar.business.delegate;
  */
 public enum ServiceType {
 
-  EJB, JMS
+  EJB,
+  JMS
 }
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
index b474ff4a6..b59759328 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
@@ -35,19 +35,17 @@ import static org.mockito.Mockito.verify;
  * tiers. By using the pattern we gain loose coupling between the tiers. The Business Delegate
  * encapsulates knowledge about how to locate, connect to, and interact with the business objects
  * that make up the application.
- * 
+ *
  * <p>Some of the services the Business Delegate uses are instantiated directly, and some can be
  * retrieved through service lookups. The Business Delegate itself may contain business logic too
  * potentially tying together multiple service calls, exception handling, retrying etc.
  */
-public class BusinessDelegateTest {
+class BusinessDelegateTest {
 
   private EjbService ejbService;
 
   private JmsService jmsService;
 
-  private BusinessLookup businessLookup;
-
   private BusinessDelegate businessDelegate;
 
   /**
@@ -59,7 +57,7 @@ public class BusinessDelegateTest {
     ejbService = spy(new EjbService());
     jmsService = spy(new JmsService());
 
-    businessLookup = spy(new BusinessLookup());
+    BusinessLookup businessLookup = spy(new BusinessLookup());
     businessLookup.setEjbService(ejbService);
     businessLookup.setJmsService(jmsService);
 
@@ -73,7 +71,7 @@ public class BusinessDelegateTest {
    * service and makes the service call.
    */
   @Test
-  public void testBusinessDelegate() {
+  void testBusinessDelegate() {
 
     // setup a client object
     var client = new Client(businessDelegate);
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/App.java b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
index d3754cf2c..4d41fe6b9 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/App.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.bytecode;
 
 import com.iluwatar.bytecode.util.InstructionConverterUtil;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The intention of Bytecode pattern is to give behavior the flexibility of data by encoding it as
@@ -40,8 +39,8 @@ import org.slf4j.LoggerFactory;
  * ensure the behavior being defined can’t break the game, you need to sandbox it from the rest of
  * the codebase.
  */
+@Slf4j
 public class App {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   /**
    * Main app method.
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
index ceec9b464..52b6e325a 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
@@ -23,9 +23,14 @@
 
 package com.iluwatar.bytecode;
 
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
 /**
  * Representation of instructions understandable by virtual machine.
  */
+@AllArgsConstructor
+@Getter
 public enum Instruction {
 
   LITERAL(1),
@@ -40,15 +45,7 @@ public enum Instruction {
   ADD(10),
   DIVIDE(11);
 
-  private final int value;
-
-  Instruction(int value) {
-    this.value = value;
-  }
-
-  public int getIntValue() {
-    return value;
-  }
+  private final int intValue;
 
   /**
    * Converts integer value to Instruction.
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
index c05b159db..526a8a377 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
@@ -24,10 +24,12 @@
 package com.iluwatar.bytecode;
 
 import java.util.Stack;
+import lombok.Getter;
 
 /**
  * Implementation of virtual machine.
  */
+@Getter
 public class VirtualMachine {
 
   private final Stack<Integer> stack = new Stack<>();
@@ -108,10 +110,6 @@ public class VirtualMachine {
     }
   }
 
-  public Stack<Integer> getStack() {
-    return stack;
-  }
-
   public void setHealth(int wizard, int amount) {
     wizards[wizard].setHealth(amount);
   }
@@ -135,8 +133,4 @@ public class VirtualMachine {
   public int getAgility(int wizard) {
     return wizards[wizard].getAgility();
   }
-
-  public Wizard[] getWizards() {
-    return wizards;
-  }
 }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
index fb258cc13..4db97f119 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
@@ -23,15 +23,18 @@
 
 package com.iluwatar.bytecode;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This class represent game objects which properties can be changed by instructions interpreted by
  * virtual machine.
  */
+@Setter
+@Getter
+@Slf4j
 public class Wizard {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Wizard.class);
 
   private int health;
 
@@ -41,30 +44,6 @@ public class Wizard {
   private int numberOfPlayedSounds;
   private int numberOfSpawnedParticles;
 
-  public int getHealth() {
-    return health;
-  }
-
-  public void setHealth(int health) {
-    this.health = health;
-  }
-
-  public int getAgility() {
-    return agility;
-  }
-
-  public void setAgility(int agility) {
-    this.agility = agility;
-  }
-
-  public int getWisdom() {
-    return wisdom;
-  }
-
-  public void setWisdom(int wisdom) {
-    this.wisdom = wisdom;
-  }
-
   public void playSound() {
     LOGGER.info("Playing sound");
     numberOfPlayedSounds++;
@@ -75,11 +54,4 @@ public class Wizard {
     numberOfSpawnedParticles++;
   }
 
-  public int getNumberOfPlayedSounds() {
-    return numberOfPlayedSounds;
-  }
-
-  public int getNumberOfSpawnedParticles() {
-    return numberOfSpawnedParticles;
-  }
 }
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
index 5ddf57a6b..1fbe72014 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/VirtualMachineTest.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.bytecode;
 
-import org.junit.jupiter.api.Test;
-
 import static com.iluwatar.bytecode.Instruction.*;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertThrows;
 
+import org.junit.jupiter.api.Test;
+
 /**
- * Test for {@Link VirtualMachine}
+ * Test for {@link VirtualMachine}
  */
-public class VirtualMachineTest {
+class VirtualMachineTest {
 
   @Test
-  public void testLiteral() {
+  void testLiteral() {
     var bytecode = new int[2];
     bytecode[0] = LITERAL.getIntValue();
     bytecode[1] = 10;
@@ -48,7 +48,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testSetHealth() {
+  void testSetHealth() {
     var wizardNumber = 0;
     var bytecode = new int[5];
     bytecode[0] = LITERAL.getIntValue();
@@ -64,7 +64,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testSetAgility() {
+  void testSetAgility() {
     var wizardNumber = 0;
     var bytecode = new int[5];
     bytecode[0] = LITERAL.getIntValue();
@@ -80,7 +80,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testSetWisdom() {
+  void testSetWisdom() {
     var wizardNumber = 0;
     var bytecode = new int[5];
     bytecode[0] = LITERAL.getIntValue();
@@ -96,7 +96,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testGetHealth() {
+  void testGetHealth() {
     var wizardNumber = 0;
     var bytecode = new int[8];
     bytecode[0] = LITERAL.getIntValue();
@@ -115,7 +115,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testPlaySound() {
+  void testPlaySound() {
     var wizardNumber = 0;
     var bytecode = new int[3];
     bytecode[0] = LITERAL.getIntValue();
@@ -130,7 +130,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testSpawnParticles() {
+  void testSpawnParticles() {
     var wizardNumber = 0;
     var bytecode = new int[3];
     bytecode[0] = LITERAL.getIntValue();
@@ -145,7 +145,7 @@ public class VirtualMachineTest {
   }
 
   @Test
-  public void testInvalidInstruction() {
+  void testInvalidInstruction() {
     var bytecode = new int[1];
     bytecode[0] = 999;
     var vm = new VirtualMachine();
diff --git a/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java b/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
index 2b4f0bada..89486a8f7 100644
--- a/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
+++ b/bytecode/src/test/java/com/iluwatar/bytecode/util/InstructionConverterUtilTest.java
@@ -24,16 +24,16 @@
 package com.iluwatar.bytecode.util;
 
 import com.iluwatar.bytecode.Instruction;
-import com.iluwatar.bytecode.util.InstructionConverterUtil;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
 /**
- * Test for {@Link InstructionConverterUtil}
+ * Test for {@link InstructionConverterUtil}
  */
-public class InstructionConverterUtilTest {
+class InstructionConverterUtilTest {
+
   @Test
-  public void testEmptyInstruction() {
+  void testEmptyInstruction() {
     var instruction = "";
 
     var bytecode = InstructionConverterUtil.convertToByteCode(instruction);
@@ -42,7 +42,7 @@ public class InstructionConverterUtilTest {
   }
 
   @Test
-  public void testInstructions() {
+  void testInstructions() {
     var instructions = "LITERAL 35 SET_HEALTH SET_WISDOM SET_AGILITY PLAY_SOUND"
         + " SPAWN_PARTICLES GET_HEALTH ADD DIVIDE";
 
diff --git a/caching/src/main/java/com/iluwatar/caching/App.java b/caching/src/main/java/com/iluwatar/caching/App.java
index b8b226550..f5df323aa 100644
--- a/caching/src/main/java/com/iluwatar/caching/App.java
+++ b/caching/src/main/java/com/iluwatar/caching/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.caching;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Caching pattern describes how to avoid expensive re-acquisition of resources by not releasing
@@ -60,11 +59,9 @@ import org.slf4j.LoggerFactory;
  * @see LruCache
  * @see CachingPolicy
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
-
   /**
    * Program entry point.
    *
diff --git a/caching/src/main/java/com/iluwatar/caching/CacheStore.java b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
index c6767ed2e..156f024d4 100644
--- a/caching/src/main/java/com/iluwatar/caching/CacheStore.java
+++ b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
@@ -26,16 +26,14 @@ package com.iluwatar.caching;
 import java.util.List;
 import java.util.Optional;
 import java.util.stream.Collectors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The caching strategies are implemented in this class.
  */
+@Slf4j
 public class CacheStore {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CacheStore.class);
-
   private static LruCache cache;
 
   private CacheStore() {
diff --git a/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
index 3bd948070..0a42cf812 100644
--- a/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
+++ b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.caching;
 
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
 /**
  * Enum class containing the four caching strategies implemented in the pattern.
  */
+@AllArgsConstructor
+@Getter
 public enum CachingPolicy {
-  THROUGH("through"), AROUND("around"), BEHIND("behind"), ASIDE("aside");
+  THROUGH("through"),
+  AROUND("around"),
+  BEHIND("behind"),
+  ASIDE("aside");
 
   private final String policy;
-
-  CachingPolicy(String policy) {
-    this.policy = policy;
-  }
-
-  public String getPolicy() {
-    return policy;
-  }
 }
diff --git a/caching/src/main/java/com/iluwatar/caching/LruCache.java b/caching/src/main/java/com/iluwatar/caching/LruCache.java
index 88aeb2318..a320e35dc 100644
--- a/caching/src/main/java/com/iluwatar/caching/LruCache.java
+++ b/caching/src/main/java/com/iluwatar/caching/LruCache.java
@@ -27,8 +27,7 @@ import java.util.ArrayList;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Data structure/implementation of the application's cache. The data structure consists of a hash
@@ -37,11 +36,10 @@ import org.slf4j.LoggerFactory;
  * the data is moved to the front of the list to depict itself as the most-recently-used data. The
  * LRU data is always at the end of the list.
  */
+@Slf4j
 public class LruCache {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(LruCache.class);
-
-  class Node {
+  static class Node {
     String userId;
     UserAccount userAccount;
     Node previous;
diff --git a/caching/src/main/java/com/iluwatar/caching/UserAccount.java b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
index 7fbccbca3..3681a931b 100644
--- a/caching/src/main/java/com/iluwatar/caching/UserAccount.java
+++ b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
@@ -23,49 +23,20 @@
 
 package com.iluwatar.caching;
 
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
+
 /**
  * Entity class (stored in cache and DB) used in the application.
  */
+@Setter
+@Getter
+@AllArgsConstructor
+@ToString
 public class UserAccount {
   private String userId;
   private String userName;
   private String additionalInfo;
-
-  /**
-   * Constructor.
-   */
-  public UserAccount(String userId, String userName, String additionalInfo) {
-    this.userId = userId;
-    this.userName = userName;
-    this.additionalInfo = additionalInfo;
-  }
-
-  public String getUserId() {
-    return userId;
-  }
-
-  public void setUserId(String userId) {
-    this.userId = userId;
-  }
-
-  public String getUserName() {
-    return userName;
-  }
-
-  public void setUserName(String userName) {
-    this.userName = userName;
-  }
-
-  public String getAdditionalInfo() {
-    return additionalInfo;
-  }
-
-  public void setAdditionalInfo(String additionalInfo) {
-    this.additionalInfo = additionalInfo;
-  }
-
-  @Override
-  public String toString() {
-    return userId + ", " + userName + ", " + additionalInfo;
-  }
 }
diff --git a/callback/README.md b/callback/README.md
index 34543f0bb..2f45df0c0 100644
--- a/callback/README.md
+++ b/callback/README.md
@@ -54,10 +54,9 @@ public abstract class Task {
   public abstract void execute();
 }
 
+@Slf4j
 public final class SimpleTask extends Task {
 
-  private static final Logger LOGGER = getLogger(SimpleTask.class);
-
   @Override
   public void execute() {
     LOGGER.info("Perform some important activity and after call the callback method.");
diff --git a/callback/src/main/java/com/iluwatar/callback/App.java b/callback/src/main/java/com/iluwatar/callback/App.java
index 8f504bb03..9bb4eb748 100644
--- a/callback/src/main/java/com/iluwatar/callback/App.java
+++ b/callback/src/main/java/com/iluwatar/callback/App.java
@@ -23,19 +23,16 @@
 
 package com.iluwatar.callback;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
-import org.slf4j.Logger;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Callback pattern is more native for functional languages where functions are treated as
  * first-class citizens. Prior to Java 8 callbacks can be simulated using simple (alike command)
  * interfaces.
  */
+@Slf4j
 public final class App {
 
-  private static final Logger LOGGER = getLogger(App.class);
-
   private App() {
   }
 
diff --git a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
index 0c380cd22..a56457a17 100644
--- a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
+++ b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
@@ -23,20 +23,16 @@
 
 package com.iluwatar.callback;
 
-import static org.slf4j.LoggerFactory.getLogger;
-
-import org.slf4j.Logger;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation of task that need to be executed.
  */
+@Slf4j
 public final class SimpleTask extends Task {
 
-  private static final Logger LOGGER = getLogger(SimpleTask.class);
-
   @Override
   public void execute() {
-    LOGGER.info("Perform some important activity and after call the"
-        + " callback method.");
+    LOGGER.info("Perform some important activity and after call the callback method.");
   }
 }
diff --git a/callback/src/test/java/com/iluwatar/callback/CallbackTest.java b/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
index 300acba24..80c42a5a6 100644
--- a/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/CallbackTest.java
@@ -38,7 +38,7 @@ public class CallbackTest {
   private Integer callingCount = 0;
 
   @Test
-  public void test() {
+  void test() {
     Callback callback = () -> callingCount++;
 
     var task = new SimpleTask();
diff --git a/chain/README.md b/chain/README.md
index 8b0508833..bedd64cff 100644
--- a/chain/README.md
+++ b/chain/README.md
@@ -68,8 +68,8 @@ public enum RequestType {
 Then the request handler hierarchy
 
 ```java
+@Slf4j
 public abstract class RequestHandler {
-  private static final Logger LOGGER = LoggerFactory.getLogger(RequestHandler.class);
   private final RequestHandler next;
 
   public RequestHandler(RequestHandler next) {
diff --git a/chain/src/main/java/com/iluwatar/chain/App.java b/chain/src/main/java/com/iluwatar/chain/App.java
index 16641dfb4..d019dd08c 100644
--- a/chain/src/main/java/com/iluwatar/chain/App.java
+++ b/chain/src/main/java/com/iluwatar/chain/App.java
@@ -47,6 +47,5 @@ public class App {
     king.makeRequest(new Request(RequestType.DEFEND_CASTLE, "defend castle"));
     king.makeRequest(new Request(RequestType.TORTURE_PRISONER, "torture prisoner"));
     king.makeRequest(new Request(RequestType.COLLECT_TAX, "collect tax"));
-
   }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
index c174e22f2..ec3f52d99 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
@@ -23,22 +23,18 @@
 
 package com.iluwatar.chain;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.AllArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * RequestHandler.
  */
+@Slf4j
+@AllArgsConstructor
 public abstract class RequestHandler {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(RequestHandler.class);
-
   private final RequestHandler next;
 
-  public RequestHandler(RequestHandler next) {
-    this.next = next;
-  }
-
   /**
    * Request handler.
    */
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestType.java b/chain/src/main/java/com/iluwatar/chain/RequestType.java
index 3742f3b02..9ef796bac 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestType.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestType.java
@@ -28,6 +28,8 @@ package com.iluwatar.chain;
  */
 public enum RequestType {
 
-  DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
+  DEFEND_CASTLE,
+  TORTURE_PRISONER,
+  COLLECT_TAX
 
 }
diff --git a/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java b/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
index 8da944340..285f5a772 100644
--- a/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
+++ b/chain/src/test/java/com/iluwatar/chain/OrcKingTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class OrcKingTest {
+class OrcKingTest {
 
   /**
    * All possible requests
@@ -45,7 +45,7 @@ public class OrcKingTest {
   );
 
   @Test
-  public void testMakeRequest() {
+  void testMakeRequest() {
     final var king = new OrcKing();
 
     REQUESTS.forEach(request -> {
diff --git a/circuit-breaker/README.md b/circuit-breaker/README.md
index b3a360b33..85fd5e00f 100644
--- a/circuit-breaker/README.md
+++ b/circuit-breaker/README.md
@@ -54,6 +54,7 @@ The service architecture is as follows:
 In terms of code, the end user application is:
 
 ```java
+@Slf4j
 public class App {
 
   private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
diff --git a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
index 898ac2c26..1510319fa 100644
--- a/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
+++ b/circuit-breaker/src/main/java/com/iluwatar/circuitbreaker/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.circuitbreaker;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>
@@ -55,10 +54,9 @@ import org.slf4j.LoggerFactory;
  * recovers, it goes back to the closed state and the cycle continues.
  * </p>
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
index b8b031dc8..9fe05c7d8 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DefaultCircuitBreakerTest.java
@@ -35,7 +35,7 @@ public class DefaultCircuitBreakerTest {
 
   //long timeout, int failureThreshold, long retryTimePeriod
   @Test
-  public void testEvaluateState() {
+  void testEvaluateState() {
     var circuitBreaker = new DefaultCircuitBreaker(null, 1, 1, 100);
     //Right now, failureCount<failureThreshold, so state should be closed
     assertEquals(circuitBreaker.getState(), "CLOSED");
@@ -57,7 +57,7 @@ public class DefaultCircuitBreakerTest {
   }
 
   @Test
-  public void testSetStateForBypass() {
+  void testSetStateForBypass() {
     var circuitBreaker = new DefaultCircuitBreaker(null, 1, 1, 2000 * 1000 * 1000);
     //Right now, failureCount<failureThreshold, so state should be closed
     //Bypass it and set it to open
@@ -66,7 +66,7 @@ public class DefaultCircuitBreakerTest {
   }
 
   @Test
-  public void testApiResponses() throws RemoteServiceException {
+  void testApiResponses() throws RemoteServiceException {
     RemoteService mockService = new RemoteService() {
       @Override
       public String call() throws RemoteServiceException {
@@ -79,6 +79,5 @@ public class DefaultCircuitBreakerTest {
     var serviceStartTime = System.nanoTime() - 60 * 1000 * 1000 * 1000;
     var response = circuitBreaker.attemptRequest();
     assertEquals(response, "Remote Success");
-
   }
 }
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
index fb7a512cf..f3be97409 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/DelayedRemoteServiceTest.java
@@ -31,7 +31,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Monitoring Service test
  */
-public class DelayedRemoteServiceTest {
+class DelayedRemoteServiceTest {
 
   /**
    * Testing immediate response of the delayed service.
@@ -39,7 +39,7 @@ public class DelayedRemoteServiceTest {
    * @throws RemoteServiceException
    */
   @Test
-  public void testDefaultConstructor() throws RemoteServiceException {
+  void testDefaultConstructor() throws RemoteServiceException {
     Assertions.assertThrows(RemoteServiceException.class, () -> {
       var obj = new DelayedRemoteService();
       obj.call();
diff --git a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
index 57408a236..77c9c9414 100644
--- a/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
+++ b/circuit-breaker/src/test/java/com/iluwatar/circuitbreaker/MonitoringServiceTest.java
@@ -30,18 +30,18 @@ import org.junit.jupiter.api.Test;
 /**
  * Monitoring Service test
  */
-public class MonitoringServiceTest {
+class MonitoringServiceTest {
 
   //long timeout, int failureThreshold, long retryTimePeriod
   @Test
-  public void testLocalResponse() {
+  void testLocalResponse() {
     var monitoringService = new MonitoringService(null,null);
     var response = monitoringService.localResourceResponse();
     assertEquals(response, "Local Service is working");
   }
 
   @Test
-  public void testDelayedRemoteResponseSuccess() {
+  void testDelayedRemoteResponseSuccess() {
     var delayedService = new DelayedRemoteService(System.nanoTime()-2*1000*1000*1000, 2);
     var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
         1,
@@ -54,7 +54,7 @@ public class MonitoringServiceTest {
   }
 
   @Test
-  public void testDelayedRemoteResponseFailure() {
+  void testDelayedRemoteResponseFailure() {
     var delayedService = new DelayedRemoteService(System.nanoTime(), 2);
     var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
         1,
@@ -66,7 +66,7 @@ public class MonitoringServiceTest {
   }
 
   @Test
-  public void testQuickRemoteServiceResponse() {
+  void testQuickRemoteServiceResponse() {
     var delayedService = new QuickRemoteService();
     var delayedServiceCircuitBreaker = new DefaultCircuitBreaker(delayedService, 3000,
         1,
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
index 218248900..4a3b2b85c 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.collectionpipeline;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * In imperative-style programming, it is common to use for and while loops for most kinds of data
@@ -35,10 +34,9 @@ import org.slf4j.LoggerFactory;
  * create sophisticated programs where data flow from upstream to downstream and is passed through a
  * series of transformations.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
index 52a3aabd9..eada9987a 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Car.java
@@ -23,86 +23,20 @@
 
 package com.iluwatar.collectionpipeline;
 
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * A Car class that has the properties of make, model, year and category.
  */
+@Getter
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class Car {
   private final String make;
   private final String model;
   private final int year;
   private final Category category;
 
-  /**
-   * Constructor to create an instance of car.
-   *
-   * @param make       the make of the car
-   * @param model      the model of the car
-   * @param yearOfMake the year of built of the car
-   * @param category   the {@link Category} of the car
-   */
-  public Car(String make, String model, int yearOfMake, Category category) {
-    this.make = make;
-    this.model = model;
-    this.year = yearOfMake;
-    this.category = category;
-  }
-
-  @Override
-  public int hashCode() {
-    final int prime = 31;
-    int result = 1;
-    result = prime * result + ((category == null) ? 0 : category.hashCode());
-    result = prime * result + ((make == null) ? 0 : make.hashCode());
-    result = prime * result + ((model == null) ? 0 : model.hashCode());
-    result = prime * result + year;
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    Car other = (Car) obj;
-    if (category != other.category) {
-      return false;
-    }
-    if (make == null) {
-      if (other.make != null) {
-        return false;
-      }
-    } else if (!make.equals(other.make)) {
-      return false;
-    }
-    if (model == null) {
-      if (other.model != null) {
-        return false;
-      }
-    } else if (!model.equals(other.model)) {
-      return false;
-    }
-    return year == other.year;
-  }
-
-  public String getMake() {
-    return make;
-  }
-
-  public String getModel() {
-    return model;
-  }
-
-  public int getYear() {
-    return year;
-  }
-
-  public Category getCategory() {
-    return category;
-  }
 }
\ No newline at end of file
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
index 72a06a0a9..6a58991c9 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Category.java
@@ -27,5 +27,7 @@ package com.iluwatar.collectionpipeline;
  * Enum for the category of car.
  */
 public enum Category {
-  JEEP, SEDAN, CONVERTIBLE
+  JEEP,
+  SEDAN,
+  CONVERTIBLE
 }
diff --git a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
index fd438f8ec..8b508d6ed 100644
--- a/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
+++ b/collection-pipeline/src/main/java/com/iluwatar/collectionpipeline/Person.java
@@ -24,23 +24,16 @@
 package com.iluwatar.collectionpipeline;
 
 import java.util.List;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * A Person class that has the list of cars that the person owns and use.
  */
+@Getter
+@RequiredArgsConstructor
 public class Person {
+
   private final List<Car> cars;
 
-  /**
-   * Constructor to create an instance of person.
-   *
-   * @param cars the list of cars owned
-   */
-  public Person(List<Car> cars) {
-    this.cars = cars;
-  }
-
-  public List<Car> getCars() {
-    return cars;
-  }
 }
\ No newline at end of file
diff --git a/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java b/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
index bc05ea98f..1567d3ff2 100644
--- a/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
+++ b/collection-pipeline/src/test/java/com/iluwatar/collectionpipeline/AppTest.java
@@ -27,32 +27,31 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import java.util.List;
 import java.util.Map;
+import lombok.extern.slf4j.Slf4j;
 import org.junit.jupiter.api.Test;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Tests that Collection Pipeline methods work as expected.
  */
-public class AppTest {
-  private static final Logger LOGGER = LoggerFactory.getLogger(AppTest.class);
+@Slf4j
+class AppTest {
 
   private final List<Car> cars = CarFactory.createCars();
 
   @Test
-  public void testGetModelsAfter2000UsingFor() {
+  void testGetModelsAfter2000UsingFor() {
     var models = ImperativeProgramming.getModelsAfter2000(cars);
     assertEquals(List.of("Avenger", "Wrangler", "Focus", "Cascada"), models);
   }
 
   @Test
-  public void testGetModelsAfter2000UsingPipeline() {
+  void testGetModelsAfter2000UsingPipeline() {
     var models = FunctionalProgramming.getModelsAfter2000(cars);
     assertEquals(List.of("Avenger", "Wrangler", "Focus", "Cascada"), models);
   }
 
   @Test
-  public void testGetGroupingOfCarsByCategory() {
+  void testGetGroupingOfCarsByCategory() {
     var modelsExpected = Map.of(
         Category.CONVERTIBLE, List.of(
             new Car("Buick", "Cascada", 2016, Category.CONVERTIBLE),
@@ -74,7 +73,7 @@ public class AppTest {
   }
 
   @Test
-  public void testGetSedanCarsOwnedSortedByDate() {
+  void testGetSedanCarsOwnedSortedByDate() {
     var john = new Person(cars);
     var modelsExpected = List.of(
         new Car("Dodge", "Avenger", 2010, Category.SEDAN),
diff --git a/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java b/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
index d13550bf1..53404ecab 100644
--- a/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
+++ b/combinator/src/main/java/com/iluwatar/combinator/CombinatorApp.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.combinator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 
 /**
@@ -41,13 +40,9 @@ import org.slf4j.LoggerFactory;
  * {@link Finder#and(Finder)}
  * Using them the became possible to get more complex functions {@link Finders}
  */
+@Slf4j
 public class CombinatorApp {
 
-  /**
-   * Logger.
-   */
-  private static final Logger LOGGER = LoggerFactory.getLogger(CombinatorApp.class);
-
   /**
    * main.
    * @param args args
@@ -63,14 +58,13 @@ public class CombinatorApp {
     res = finder.find(text());
     LOGGER.info("the result of specialized(and) query[{}] is {}", queriesAnd, res);
 
-    finder = Finders.advancedFinder("it was","kingdom","sea");
+    finder = Finders.advancedFinder("it was", "kingdom", "sea");
     res = finder.find(text());
     LOGGER.info("the result of advanced query is {}", res);
 
     res = Finders.filteredFinder(" was ", "many", "child").find(text());
     LOGGER.info("the result of filtered query is {}", res);
 
-
   }
 
   private static String text() {
diff --git a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
index 2400496dd..705fab9ae 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/CombinatorAppTest.java
@@ -31,11 +31,10 @@ class CombinatorAppTest {
 
   /**
    * Issue: Add at least one assertion to this test case.
-   *
+   * <p>
    * Solution: Inserted assertion to check whether the execution of the main method in {@link CombinatorApp#main(String[])}
    * throws an exception.
    */
-
   @Test
   void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> CombinatorApp.main(new String[]{}));
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
index bbd6e7f1e..d87c71e2b 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FinderTest.java
@@ -35,7 +35,6 @@ class FinderTest {
 
     var result = Finder.contains("second").find(example);
     assertEquals(1, result.size());
-    assertEquals("the second one ", result.get(0));
+    assertEquals( "the second one ", result.get(0));
   }
-
 }
diff --git a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
index 688ebdf47..4c5a6a614 100644
--- a/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
+++ b/combinator/src/test/java/com/iluwatar/combinator/FindersTest.java
@@ -35,36 +35,36 @@ class FindersTest {
 
   @Test
   void advancedFinderTest() {
-    var res = advancedFinder("it was","kingdom","sea").find(text());
+    var res = advancedFinder("it was", "kingdom", "sea").find(text());
     assertEquals(1, res.size());
-    assertEquals("It was many and many a year ago,", res.get(0));
+    assertEquals( "It was many and many a year ago,", res.get(0));
   }
 
   @Test
   void filteredFinderTest() {
     var res = filteredFinder(" was ", "many", "child").find(text());
     assertEquals(1, res.size());
-    assertEquals("But we loved with a love that was more than love-", res.get(0));
+    assertEquals( "But we loved with a love that was more than love-", res.get(0));
   }
 
   @Test
   void specializedFinderTest() {
-    var res = specializedFinder("love","heaven").find(text());
+    var res = specializedFinder("love", "heaven").find(text());
     assertEquals(1, res.size());
-    assertEquals("With a love that the winged seraphs of heaven", res.get(0));
+    assertEquals( "With a love that the winged seraphs of heaven", res.get(0));
   }
 
   @Test
   void expandedFinderTest() {
-    var res = expandedFinder("It was","kingdom").find(text());
+    var res = expandedFinder("It was", "kingdom").find(text());
     assertEquals(3, res.size());
-    assertEquals("It was many and many a year ago,", res.get(0));
-    assertEquals("In a kingdom by the sea,", res.get(1));
-    assertEquals("In this kingdom by the sea;", res.get(2));
+    assertEquals( "It was many and many a year ago,", res.get(0));
+    assertEquals( "In a kingdom by the sea,", res.get(1));
+    assertEquals( "In this kingdom by the sea;", res.get(2));
   }
 
 
-  private String text(){
+  private String text() {
     return
         "It was many and many a year ago,\n"
             + "In a kingdom by the sea,\n"
diff --git a/command/README.md b/command/README.md
index 08783679b..204aca5fb 100644
--- a/command/README.md
+++ b/command/README.md
@@ -39,6 +39,7 @@ Wikipedia says
 Here's the sample code with wizard and goblin. Let's start from the `Wizard` class.
 
 ```java
+@Slf4j
 public class Wizard {
 
   private final Deque<Command> undoStack = new LinkedList<>();
@@ -77,10 +78,9 @@ public class Wizard {
 Next, we have the goblin who's the target of the spells.
 
 ```java
+@Slf4j
 public abstract class Target {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Target.class);
-
   private Size size;
 
   private Visibility visibility;
diff --git a/command/src/main/java/com/iluwatar/command/Size.java b/command/src/main/java/com/iluwatar/command/Size.java
index 446a80ab3..070524f82 100644
--- a/command/src/main/java/com/iluwatar/command/Size.java
+++ b/command/src/main/java/com/iluwatar/command/Size.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.command;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Enumeration for target size.
  */
+@RequiredArgsConstructor
 public enum Size {
 
-  SMALL("small"), NORMAL("normal");
+  SMALL("small"),
+  NORMAL("normal");
 
   private final String title;
 
-  Size(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/command/src/main/java/com/iluwatar/command/Target.java b/command/src/main/java/com/iluwatar/command/Target.java
index 50d3c0122..940bc020d 100644
--- a/command/src/main/java/com/iluwatar/command/Target.java
+++ b/command/src/main/java/com/iluwatar/command/Target.java
@@ -23,39 +23,22 @@
 
 package com.iluwatar.command;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Base class for spell targets.
  */
+@Setter
+@Slf4j
+@Getter
 public abstract class Target {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Target.class);
-
   private Size size;
 
   private Visibility visibility;
 
-  public Size getSize() {
-    return size;
-  }
-
-  public void setSize(Size size) {
-    this.size = size;
-  }
-
-  public Visibility getVisibility() {
-    return visibility;
-  }
-
-  public void setVisibility(Visibility visibility) {
-    this.visibility = visibility;
-  }
-
-  @Override
-  public abstract String toString();
-
   /**
    * Print status.
    */
diff --git a/command/src/main/java/com/iluwatar/command/Visibility.java b/command/src/main/java/com/iluwatar/command/Visibility.java
index 0a49ee6b2..4885a69c2 100644
--- a/command/src/main/java/com/iluwatar/command/Visibility.java
+++ b/command/src/main/java/com/iluwatar/command/Visibility.java
@@ -23,19 +23,19 @@
 
 package com.iluwatar.command;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Enumeration for target visibility.
  */
+@RequiredArgsConstructor
 public enum Visibility {
 
-  VISIBLE("visible"), INVISIBLE("invisible");
+  VISIBLE("visible"),
+  INVISIBLE("invisible");
 
   private final String title;
 
-  Visibility(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/command/src/main/java/com/iluwatar/command/Wizard.java b/command/src/main/java/com/iluwatar/command/Wizard.java
index 5ff3a6d9f..4ea84e8c3 100644
--- a/command/src/main/java/com/iluwatar/command/Wizard.java
+++ b/command/src/main/java/com/iluwatar/command/Wizard.java
@@ -25,10 +25,12 @@ package com.iluwatar.command;
 
 import java.util.Deque;
 import java.util.LinkedList;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Wizard is the invoker of the commands.
  */
+@Slf4j
 public class Wizard {
 
   private final Deque<Runnable> undoStack = new LinkedList<>();
diff --git a/command/src/test/java/com/iluwatar/command/CommandTest.java b/command/src/test/java/com/iluwatar/command/CommandTest.java
index e9f362142..d21982a07 100644
--- a/command/src/test/java/com/iluwatar/command/CommandTest.java
+++ b/command/src/test/java/com/iluwatar/command/CommandTest.java
@@ -41,7 +41,7 @@ import org.junit.jupiter.api.Test;
  * objects are held by a client object (app). The client decides which commands to execute at which
  * points. To execute a command, it passes the command object to the invoker object.
  */
-public class CommandTest {
+class CommandTest {
 
   private static final String GOBLIN = "Goblin";
 
@@ -51,7 +51,7 @@ public class CommandTest {
    * wizard keeps track of the spells undone, so they can be redone.
    */
   @Test
-  public void testCommand() {
+  void testCommand() {
 
     var wizard = new Wizard();
     var goblin = new Goblin();
diff --git a/commander/src/main/java/com/iluwatar/commander/Commander.java b/commander/src/main/java/com/iluwatar/commander/Commander.java
index 097b92bae..59cdc9b22 100644
--- a/commander/src/main/java/com/iluwatar/commander/Commander.java
+++ b/commander/src/main/java/com/iluwatar/commander/Commander.java
@@ -174,7 +174,7 @@ public class Commander {
         if (!l.isEmpty()) {
           if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
             LOG.debug("Order " + order.id + ": Error in connecting to payment service,"
-                    + " trying again..");
+                + " trying again..");
           } else {
             LOG.debug("Order " + order.id + ": Error in creating payment request..");
           }
@@ -195,8 +195,8 @@ public class Commander {
         if (PaymentDetailsErrorException.class.isAssignableFrom(err.getClass())) {
           if (!finalSiteMsgShown) {
             LOG.info("There was an error in payment. Your account/card details "
-                    + "may have been incorrect. "
-                    + "Meanwhile, your order has been converted to COD and will be shipped.");
+                + "may have been incorrect. "
+                + "Meanwhile, your order has been converted to COD and will be shipped.");
             finalSiteMsgShown = true;
           }
           LOG.error("Order " + order.id + ": Payment details incorrect, failed..");
@@ -206,14 +206,14 @@ public class Commander {
           if (o.messageSent.equals(MessageSent.NONE_SENT)) {
             if (!finalSiteMsgShown) {
               LOG.info("There was an error in payment. We are on it, and will get back to you "
-                      + "asap. Don't worry, your order has been placed and will be shipped.");
+                  + "asap. Don't worry, your order has been placed and will be shipped.");
               finalSiteMsgShown = true;
             }
             LOG.warn("Order " + order.id + ": Payment error, going to queue..");
             sendPaymentPossibleErrorMsg(o);
           }
           if (o.paid.equals(PaymentStatus.TRYING) && System
-                  .currentTimeMillis() - o.createdTime < paymentTime) {
+              .currentTimeMillis() - o.createdTime < paymentTime) {
             var qt = new QueueTask(o, TaskType.PAYMENT, -1);
             updateQueue(qt);
           }
@@ -475,7 +475,7 @@ public class Commander {
   }
 
   private void handlePaymentPossibleErrorMsgRetryOperation(Order order, List<Exception> l)
-          throws Exception {
+      throws Exception {
     if (!l.isEmpty()) {
       if (DatabaseUnavailableException.class.isAssignableFrom(l.get(0).getClass())) {
         LOG.debug("Order " + order.id + ": Error in connecting to messaging service "
@@ -539,10 +539,10 @@ public class Commander {
       var qt = queue.peek(); //this should probably be cloned here
       //this is why we have retry for doTasksInQueue
       LOG.trace("Order " + qt.order.id + ": Started doing task of type " + qt.getType());
-      if (qt.firstAttemptTime == -1) {
-        qt.firstAttemptTime = System.currentTimeMillis();
+      if (qt.getFirstAttemptTime() == -1) {
+        qt.setFirstAttemptTime(System.currentTimeMillis());
       }
-      if (System.currentTimeMillis() - qt.firstAttemptTime >= queueTaskTime) {
+      if (System.currentTimeMillis() - qt.getFirstAttemptTime() >= queueTaskTime) {
         tryDequeue();
         LOG.trace("Order " + qt.order.id + ": This queue task of type " + qt.getType()
             + " does not need to be done anymore (timeout), dequeue..");
diff --git a/commander/src/main/java/com/iluwatar/commander/Order.java b/commander/src/main/java/com/iluwatar/commander/Order.java
index ff2909237..32e92a6bc 100644
--- a/commander/src/main/java/com/iluwatar/commander/Order.java
+++ b/commander/src/main/java/com/iluwatar/commander/Order.java
@@ -24,7 +24,8 @@
 package com.iluwatar.commander;
 
 import java.security.SecureRandom;
-import java.util.Hashtable;
+import java.util.HashMap;
+import java.util.Map;
 
 /**
  * Order class holds details of the order.
@@ -33,11 +34,16 @@ import java.util.Hashtable;
 public class Order { //can store all transactions ids also
 
   enum PaymentStatus {
-    NOT_DONE, TRYING, DONE
+    NOT_DONE,
+    TRYING,
+    DONE
   }
 
   enum MessageSent {
-    NONE_SENT, PAYMENT_FAIL, PAYMENT_TRYING, PAYMENT_SUCCESSFUL
+    NONE_SENT,
+    PAYMENT_FAIL,
+    PAYMENT_TRYING,
+    PAYMENT_SUCCESSFUL
   }
 
   final User user;
@@ -47,7 +53,7 @@ public class Order { //can store all transactions ids also
   final long createdTime;
   private static final SecureRandom RANDOM = new SecureRandom();
   private static final String ALL_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";
-  private static final Hashtable<String, Boolean> USED_IDS = new Hashtable<String, Boolean>();
+  private static final Map<String, Boolean> USED_IDS = new HashMap<>();
   PaymentStatus paid;
   MessageSent messageSent; //to avoid sending error msg on page and text more than once
   boolean addedToEmployeeHandle; //to avoid creating more to enqueue
diff --git a/commander/src/main/java/com/iluwatar/commander/User.java b/commander/src/main/java/com/iluwatar/commander/User.java
index f43821913..f7592105c 100644
--- a/commander/src/main/java/com/iluwatar/commander/User.java
+++ b/commander/src/main/java/com/iluwatar/commander/User.java
@@ -23,17 +23,13 @@
 
 package com.iluwatar.commander;
 
+import lombok.AllArgsConstructor;
+
 /**
  * User class contains details of user who places order.
  */
-
+@AllArgsConstructor
 public class User {
   String name;
   String address;
-
-  User(String name, String address) {
-    this.name = name;
-    this.address = address;
-  }
-
 }
diff --git a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
index 92baa6da3..8e028f947 100644
--- a/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/employeehandle/EmployeeDatabase.java
@@ -26,18 +26,16 @@ package com.iluwatar.commander.employeehandle;
 import com.iluwatar.commander.Database;
 import com.iluwatar.commander.Order;
 import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
-import java.util.Hashtable;
+
+import java.util.HashMap;
+import java.util.Map;
 
 /**
  * The Employee Database is where orders which have encountered some issue(s) are added.
  */
 
 public class EmployeeDatabase extends Database<Order> {
-  private final Hashtable<String, Order> data;
-
-  public EmployeeDatabase() {
-    this.data = new Hashtable<>();
-  }
+  private final Map<String, Order> data = new HashMap<>();
 
   @Override
   public Order add(Order o) throws DatabaseUnavailableException {
diff --git a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
index 42c208d2b..bf7a15aa4 100644
--- a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingDatabase.java
@@ -24,20 +24,16 @@
 package com.iluwatar.commander.messagingservice;
 
 import com.iluwatar.commander.Database;
-import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
 import com.iluwatar.commander.messagingservice.MessagingService.MessageRequest;
 import java.util.Hashtable;
+import java.util.Map;
 
 /**
  * The MessagingDatabase is where the MessageRequest is added.
  */
 
 public class MessagingDatabase extends Database<MessageRequest> {
-  private final Hashtable<String, MessageRequest> data;
-
-  public MessagingDatabase() {
-    this.data = new Hashtable<>();
-  }
+  private final Map<String, MessageRequest> data = new Hashtable<>();
 
   @Override
   public MessageRequest add(MessageRequest r) {
diff --git a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
index ac5154d1b..90219e8c2 100644
--- a/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
+++ b/commander/src/main/java/com/iluwatar/commander/messagingservice/MessagingService.java
@@ -25,8 +25,8 @@ package com.iluwatar.commander.messagingservice;
 
 import com.iluwatar.commander.Service;
 import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The MessagingService is used to send messages to user regarding their order and payment status.
@@ -34,21 +34,19 @@ import org.slf4j.LoggerFactory;
  * is added to the {@link com.iluwatar.commander.employeehandle.EmployeeDatabase}.
  */
 
+@Slf4j
 public class MessagingService extends Service {
-  private static final Logger LOGGER = LoggerFactory.getLogger(MessagingService.class);
 
   enum MessageToSend {
-    PAYMENT_FAIL, PAYMENT_TRYING, PAYMENT_SUCCESSFUL
+    PAYMENT_FAIL,
+    PAYMENT_TRYING,
+    PAYMENT_SUCCESSFUL
   }
 
-  class MessageRequest {
-    String reqId;
-    MessageToSend msg;
-
-    MessageRequest(String reqId, MessageToSend msg) {
-      this.reqId = reqId;
-      this.msg = msg;
-    }
+  @RequiredArgsConstructor
+  static class MessageRequest {
+    final String reqId;
+    final MessageToSend msg;
   }
 
   public MessagingService(MessagingDatabase db, Exception... exc) {
diff --git a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
index 655c301e5..4223b4e77 100644
--- a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentDatabase.java
@@ -24,22 +24,17 @@
 package com.iluwatar.commander.paymentservice;
 
 import com.iluwatar.commander.Database;
-import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
 import com.iluwatar.commander.paymentservice.PaymentService.PaymentRequest;
 import java.util.Hashtable;
+import java.util.Map;
 
 /**
  * PaymentDatabase is where the PaymentRequest is added, along with details.
  */
-
 public class PaymentDatabase extends Database<PaymentRequest> {
 
-  private final Hashtable<String, PaymentRequest> data;
-
-  public PaymentDatabase() {
-    this.data = new Hashtable<>();
-    //0-fail, 1-error, 2-success
-  }
+  //0-fail, 1-error, 2-success
+  private final Map<String, PaymentRequest> data = new Hashtable<>();
 
   @Override
   public PaymentRequest add(PaymentRequest r) {
diff --git a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
index 4b74c5f17..9b5d00328 100644
--- a/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
+++ b/commander/src/main/java/com/iluwatar/commander/paymentservice/PaymentService.java
@@ -25,6 +25,7 @@ package com.iluwatar.commander.paymentservice;
 
 import com.iluwatar.commander.Service;
 import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
+import lombok.RequiredArgsConstructor;
 
 /**
  * The PaymentService class receives request from the {@link com.iluwatar.commander.Commander} and
@@ -33,16 +34,11 @@ import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
 
 public class PaymentService extends Service {
 
-  class PaymentRequest {
-    String transactionId;
-    float payment;
+  @RequiredArgsConstructor
+  static class PaymentRequest {
+    final String transactionId;
+    final float payment;
     boolean paid;
-
-    PaymentRequest(String transactionId, float payment) {
-      this.transactionId = transactionId;
-      this.payment = payment;
-      this.paid = false;
-    }
   }
 
   public PaymentService(PaymentDatabase db, Exception... exc) {
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/Queue.java b/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
index 69c7a0490..4c6efbe9a 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/Queue.java
@@ -30,7 +30,6 @@ import com.iluwatar.commander.exceptions.IsEmptyException;
  *
  * @param <T> is the type of object the queue will hold.
  */
-
 public class Queue<T> {
 
   private Node<T> front;
@@ -47,15 +46,6 @@ public class Queue<T> {
     }
   }
 
-  /**
-   * Queue constructor.
-   */
-  Queue() {
-    front = null;
-    rear = null;
-    size = 0;
-  }
-
   boolean isEmpty() {
     return size == 0;
   }
diff --git a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
index 7056e7197..702844268 100644
--- a/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
+++ b/commander/src/main/java/com/iluwatar/commander/queue/QueueTask.java
@@ -24,43 +24,34 @@
 package com.iluwatar.commander.queue;
 
 import com.iluwatar.commander.Order;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.Setter;
 
 /**
  * QueueTask object is the object enqueued in queue.
  */
-
+@RequiredArgsConstructor
 public class QueueTask {
 
   /**
    * TaskType is the type of task to be done.
    */
-
   public enum TaskType {
-    MESSAGING, PAYMENT, EMPLOYEE_DB
+    MESSAGING,
+    PAYMENT,
+    EMPLOYEE_DB
   }
 
-  public Order order;
-  public TaskType taskType;
-  public int messageType; //0-fail, 1-error, 2-success
+  public final Order order;
+  public final TaskType taskType;
+  public final int messageType; //0-fail, 1-error, 2-success
+  
   /*we could have varargs Object instead to pass in any parameter instead of just message type
   but keeping it simple here*/
-  public long firstAttemptTime; //when first time attempt made to do task
-
-  /**
-   * QueueTask constructor.
-   *
-   * @param o           is the order for which the queuetask is being created
-   * @param t           is the type of task to be done
-   * @param messageType if it is a message, which type of message - this could have instead been
-   *                    object varargs, and contained all additional details related to tasktype.
-   */
-
-  public QueueTask(Order o, TaskType t, int messageType) {
-    this.order = o;
-    this.taskType = t;
-    this.messageType = messageType;
-    this.firstAttemptTime = -1;
-  }
+  @Getter
+  @Setter
+  private long firstAttemptTime = -1L; //when first time attempt made to do task
 
   /**
    * getType method.
diff --git a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
index 77807456c..bd8cd63f9 100644
--- a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
+++ b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingDatabase.java
@@ -24,9 +24,9 @@
 package com.iluwatar.commander.shippingservice;
 
 import com.iluwatar.commander.Database;
-import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
 import com.iluwatar.commander.shippingservice.ShippingService.ShippingRequest;
 import java.util.Hashtable;
+import java.util.Map;
 
 /**
  * ShippingDatabase is where the ShippingRequest objects are added.
@@ -34,11 +34,7 @@ import java.util.Hashtable;
 
 public class ShippingDatabase extends Database<ShippingRequest> {
 
-  private final Hashtable<String, ShippingRequest> data;
-
-  public ShippingDatabase() {
-    this.data = new Hashtable<>();
-  }
+  private final Map<String, ShippingRequest> data = new Hashtable<>();
 
   @Override
   public ShippingRequest add(ShippingRequest r) {
diff --git a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
index c8c70c2d8..f1ed4ccec 100644
--- a/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
+++ b/commander/src/main/java/com/iluwatar/commander/shippingservice/ShippingService.java
@@ -25,6 +25,7 @@ package com.iluwatar.commander.shippingservice;
 
 import com.iluwatar.commander.Service;
 import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
+import lombok.AllArgsConstructor;
 
 /**
  * ShippingService class receives request from {@link com.iluwatar.commander.Commander} class and
@@ -33,16 +34,11 @@ import com.iluwatar.commander.exceptions.DatabaseUnavailableException;
 
 public class ShippingService extends Service {
 
+  @AllArgsConstructor
   static class ShippingRequest {
     String transactionId;
     String item;
     String address;
-
-    ShippingRequest(String transactionId, String item, String address) {
-      this.transactionId = transactionId;
-      this.item = item;
-      this.address = address;
-    }
   }
 
   public ShippingService(ShippingDatabase db, Exception... exc) {
diff --git a/composite/src/main/java/com/iluwatar/composite/App.java b/composite/src/main/java/com/iluwatar/composite/App.java
index 56f2c747e..0660557ca 100644
--- a/composite/src/main/java/com/iluwatar/composite/App.java
+++ b/composite/src/main/java/com/iluwatar/composite/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.composite;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Composite pattern is a partitioning design pattern. The Composite pattern describes that a
@@ -35,15 +34,14 @@ import org.slf4j.LoggerFactory;
  *
  * <p>In this example we have sentences composed of words composed of letters. All of the objects
  * can be treated through the same interface ({@link LetterComposite}).
- * 
+ *
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
-   * 
+   *
    * @param args command line args
    */
   public static void main(String[] args) {
diff --git a/composite/src/main/java/com/iluwatar/composite/Letter.java b/composite/src/main/java/com/iluwatar/composite/Letter.java
index 322faf1eb..ad2cbd1c3 100644
--- a/composite/src/main/java/com/iluwatar/composite/Letter.java
+++ b/composite/src/main/java/com/iluwatar/composite/Letter.java
@@ -23,17 +23,16 @@
 
 package com.iluwatar.composite;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Letter.
  */
+@RequiredArgsConstructor
 public class Letter extends LetterComposite {
 
   private final char character;
 
-  public Letter(char c) {
-    this.character = c;
-  }
-
   @Override
   protected void printThisBefore() {
     System.out.print(character);
diff --git a/composite/src/test/java/com/iluwatar/composite/MessengerTest.java b/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
index 65dc29958..e36dfed01 100644
--- a/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
+++ b/composite/src/test/java/com/iluwatar/composite/MessengerTest.java
@@ -23,22 +23,21 @@
 
 package com.iluwatar.composite;
 
-import org.junit.jupiter.api.AfterEach;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
 
 import java.io.ByteArrayOutputStream;
 import java.io.PrintStream;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/11/15 - 8:12 PM
  *
  * @author Jeroen Meulemeester
  */
-public class MessengerTest {
+class MessengerTest {
 
   /**
    * The buffer used to capture every write to {@link System#out}
@@ -54,7 +53,7 @@ public class MessengerTest {
    * Inject the mocked std-out {@link PrintStream} into the {@link System} class before each test
    */
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     this.stdOutBuffer = new ByteArrayOutputStream();
     System.setOut(new PrintStream(stdOutBuffer));
   }
@@ -63,7 +62,7 @@ public class MessengerTest {
    * Removed the mocked std-out {@link PrintStream} again from the {@link System} class
    */
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     System.setOut(realStdOut);
   }
 
@@ -71,7 +70,7 @@ public class MessengerTest {
    * Test the message from the orcs
    */
   @Test
-  public void testMessageFromOrcs() {
+  void testMessageFromOrcs() {
     final var messenger = new Messenger();
     testMessage(
         messenger.messageFromOrcs(),
@@ -83,7 +82,7 @@ public class MessengerTest {
    * Test the message from the elves
    */
   @Test
-  public void testMessageFromElves() {
+  void testMessageFromElves() {
     final var messenger = new Messenger();
     testMessage(
         messenger.messageFromElves(),
diff --git a/converter/src/main/java/com/iluwatar/converter/App.java b/converter/src/main/java/com/iluwatar/converter/App.java
index c68b3b5e2..dc3eab53a 100644
--- a/converter/src/main/java/com/iluwatar/converter/App.java
+++ b/converter/src/main/java/com/iluwatar/converter/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.converter;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Converter pattern is a behavioral design pattern which allows a common way of bidirectional
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  * isomorphic types). Moreover, the pattern introduces a common way of converting a collection of
  * objects between types.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
@@ -47,7 +45,7 @@ public class App {
 
     UserDto dtoUser = new UserDto("John", "Doe", true, "whatever[at]wherever.com");
     User user = userConverter.convertFromDto(dtoUser);
-    LOGGER.info("Entity converted from DTO:" + user);
+    LOGGER.info("Entity converted from DTO: {}", user);
 
     var users = List.of(
         new User("Camile", "Tough", false, "124sad"),
diff --git a/converter/src/main/java/com/iluwatar/converter/Converter.java b/converter/src/main/java/com/iluwatar/converter/Converter.java
index d8c1108d5..a40650faf 100644
--- a/converter/src/main/java/com/iluwatar/converter/Converter.java
+++ b/converter/src/main/java/com/iluwatar/converter/Converter.java
@@ -27,6 +27,7 @@ import java.util.Collection;
 import java.util.List;
 import java.util.function.Function;
 import java.util.stream.Collectors;
+import lombok.RequiredArgsConstructor;
 
 /**
  * Generic converter, thanks to Java8 features not only provides a way of generic bidirectional
@@ -36,22 +37,12 @@ import java.util.stream.Collectors;
  * @param <T> DTO representation's type
  * @param <U> Domain representation's type
  */
+@RequiredArgsConstructor
 public class Converter<T, U> {
 
   private final Function<T, U> fromDto;
   private final Function<U, T> fromEntity;
 
-  /**
-   * Constructor.
-   *
-   * @param fromDto    Function that converts given dto entity into the domain entity.
-   * @param fromEntity Function that converts given domain entity into the dto entity.
-   */
-  public Converter(final Function<T, U> fromDto, final Function<U, T> fromEntity) {
-    this.fromDto = fromDto;
-    this.fromEntity = fromEntity;
-  }
-
   /**
    * Converts DTO to Entity.
    *
diff --git a/converter/src/main/java/com/iluwatar/converter/User.java b/converter/src/main/java/com/iluwatar/converter/User.java
index 1ead0c55c..f8b528a56 100644
--- a/converter/src/main/java/com/iluwatar/converter/User.java
+++ b/converter/src/main/java/com/iluwatar/converter/User.java
@@ -23,69 +23,21 @@
 
 package com.iluwatar.converter;
 
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
 
 /**
  * User class.
  */
+@ToString
+@EqualsAndHashCode
+@Getter
+@RequiredArgsConstructor
 public class User {
   private final String firstName;
   private final String lastName;
-  private final boolean isActive;
+  private final boolean active;
   private final String userId;
-
-  /**
-   * Constructor.
-   *
-   * @param firstName user's first name
-   * @param lastName  user's last name
-   * @param isActive  flag indicating whether the user is active
-   * @param userId    user's identificator
-   */
-  public User(String firstName, String lastName, boolean isActive, String userId) {
-    this.firstName = firstName;
-    this.lastName = lastName;
-    this.isActive = isActive;
-    this.userId = userId;
-  }
-
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public String getLastName() {
-    return lastName;
-  }
-
-  public boolean isActive() {
-    return isActive;
-  }
-
-  public String getUserId() {
-    return userId;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var user = (User) o;
-    return isActive == user.isActive && Objects.equals(firstName, user.firstName) && Objects
-        .equals(lastName, user.lastName) && Objects.equals(userId, user.userId);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(firstName, lastName, isActive, userId);
-  }
-
-  @Override
-  public String toString() {
-    return "User{" + "firstName='" + firstName + '\'' + ", lastName='" + lastName + '\''
-        + ", isActive=" + isActive + ", userId='" + userId + '\'' + '}';
-  }
 }
diff --git a/converter/src/main/java/com/iluwatar/converter/UserDto.java b/converter/src/main/java/com/iluwatar/converter/UserDto.java
index bf1af5036..0717c4952 100644
--- a/converter/src/main/java/com/iluwatar/converter/UserDto.java
+++ b/converter/src/main/java/com/iluwatar/converter/UserDto.java
@@ -23,70 +23,23 @@
 
 package com.iluwatar.converter;
 
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
 
 /**
  * User DTO class.
  */
+@RequiredArgsConstructor
+@Getter
+@EqualsAndHashCode
+@ToString
 public class UserDto {
 
   private final String firstName;
   private final String lastName;
-  private final boolean isActive;
+  private final boolean active;
   private final String email;
 
-  /**
-   * Constructor.
-   *
-   * @param firstName user's first name
-   * @param lastName  user's last name
-   * @param isActive  flag indicating whether the user is active
-   * @param email     user's email address
-   */
-  public UserDto(String firstName, String lastName, boolean isActive, String email) {
-    this.firstName = firstName;
-    this.lastName = lastName;
-    this.isActive = isActive;
-    this.email = email;
-  }
-
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public String getLastName() {
-    return lastName;
-  }
-
-  public boolean isActive() {
-    return isActive;
-  }
-
-  public String getEmail() {
-    return email;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var userDto = (UserDto) o;
-    return isActive == userDto.isActive && Objects.equals(firstName, userDto.firstName) && Objects
-        .equals(lastName, userDto.lastName) && Objects.equals(email, userDto.email);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(firstName, lastName, isActive, email);
-  }
-
-  @Override
-  public String toString() {
-    return "UserDto{" + "firstName='" + firstName + '\'' + ", lastName='" + lastName + '\''
-        + ", isActive=" + isActive + ", email='" + email + '\'' + '}';
-  }
 }
diff --git a/converter/src/test/java/com/iluwatar/converter/ConverterTest.java b/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
index 79c874032..d7358d8a4 100644
--- a/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
+++ b/converter/src/test/java/com/iluwatar/converter/ConverterTest.java
@@ -32,7 +32,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests for {@link Converter}
  */
-public class ConverterTest {
+class ConverterTest {
 
   private final UserConverter userConverter = new UserConverter();
 
@@ -40,7 +40,7 @@ public class ConverterTest {
    * Tests whether a converter created of opposite functions holds equality as a bijection.
    */
   @Test
-  public void testConversionsStartingFromDomain() {
+  void testConversionsStartingFromDomain() {
     var u1 = new User("Tom", "Hanks", true, "tom@hanks.com");
     var u2 = userConverter.convertFromDto(userConverter.convertFromEntity(u1));
     assertEquals(u1, u2);
@@ -50,7 +50,7 @@ public class ConverterTest {
    * Tests whether a converter created of opposite functions holds equality as a bijection.
    */
   @Test
-  public void testConversionsStartingFromDto() {
+  void testConversionsStartingFromDto() {
     var u1 = new UserDto("Tom", "Hanks", true, "tom@hanks.com");
     var u2 = userConverter.convertFromEntity(userConverter.convertFromDto(u1));
     assertEquals(u1, u2);
@@ -61,7 +61,7 @@ public class ConverterTest {
    * instantiated allowing various different conversion strategies to be implemented.
    */
   @Test
-  public void testCustomConverter() {
+  void testCustomConverter() {
     var converter = new Converter<UserDto, User>(
         userDto -> new User(
             userDto.getFirstName(),
@@ -85,7 +85,7 @@ public class ConverterTest {
    * domain users returns an equal collection.
    */
   @Test
-  public void testCollectionConversion() {
+  void testCollectionConversion() {
     var users = List.of(
         new User("Camile", "Tough", false, "124sad"),
         new User("Marti", "Luther", true, "42309fd"),
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java b/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
index 5be436e6a..1d8f69348 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/app/App.java
@@ -27,8 +27,7 @@ import com.iluwatar.cqrs.commandes.CommandServiceImpl;
 import com.iluwatar.cqrs.constants.AppConstants;
 import com.iluwatar.cqrs.queries.QueryServiceImpl;
 import com.iluwatar.cqrs.util.HibernateUtil;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * CQRS : Command Query Responsibility Segregation. A pattern used to separate query services from
@@ -41,8 +40,8 @@ import org.slf4j.LoggerFactory;
  * data model to persist(insert,update,delete) objects to a database. And a query side that uses
  * native queries to get data from the database and return objects as DTOs (Data transfer Objects).
  */
+@Slf4j
 public class App {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   /**
    * Program entry point.
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
index a904cb608..aafc4efb1 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Author.java
@@ -27,10 +27,16 @@ import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
 import javax.persistence.GenerationType;
 import javax.persistence.Id;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * This is an Author entity. It is used by Hibernate for persistence.
  */
+@ToString
+@Getter
+@Setter
 @Entity
 public class Author {
   @Id
@@ -56,41 +62,4 @@ public class Author {
   protected Author() {
   }
 
-  public long getId() {
-    return id;
-  }
-
-  public void setId(long id) {
-    this.id = id;
-  }
-
-  public String getUsername() {
-    return username;
-  }
-
-  public void setUsername(String username) {
-    this.username = username;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public void setName(String name) {
-    this.name = name;
-  }
-
-  public String getEmail() {
-    return email;
-  }
-
-  public void setEmail(String email) {
-    this.email = email;
-  }
-
-  @Override
-  public String toString() {
-    return "Author [name=" + name + ", email=" + email + "]";
-  }
-
 }
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
index d3ac74e22..c885ffb7a 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/domain/model/Book.java
@@ -28,11 +28,17 @@ import javax.persistence.GeneratedValue;
 import javax.persistence.GenerationType;
 import javax.persistence.Id;
 import javax.persistence.ManyToOne;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * This is a Book entity. It is used by Hibernate for persistence. Many books can be written by one
  * {@link Author}
  */
+@ToString
+@Setter
+@Getter
 @Entity
 public class Book {
   @Id
@@ -59,41 +65,4 @@ public class Book {
   protected Book() {
   }
 
-  public long getId() {
-    return id;
-  }
-
-  public void setId(long id) {
-    this.id = id;
-  }
-
-  public String getTitle() {
-    return title;
-  }
-
-  public void setTitle(String title) {
-    this.title = title;
-  }
-
-  public double getPrice() {
-    return price;
-  }
-
-  public void setPrice(double price) {
-    this.price = price;
-  }
-
-  public Author getAuthor() {
-    return author;
-  }
-
-  public void setAuthor(Author author) {
-    this.author = author;
-  }
-
-  @Override
-  public String toString() {
-    return "Book [title=" + title + ", price=" + price + ", author=" + author + "]";
-  }
-
 }
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
index 91ddfce5a..46983b8c9 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Author.java
@@ -23,67 +23,24 @@
 
 package com.iluwatar.cqrs.dto;
 
-import java.util.Objects;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
 
 /**
  * This is a DTO (Data Transfer Object) author, contains only useful information to be returned.
  */
+@ToString
+@EqualsAndHashCode
+@Getter
+@NoArgsConstructor
+@AllArgsConstructor
 public class Author {
 
   private String name;
   private String email;
   private String username;
 
-  /**
-   * Constructor.
-   *
-   * @param name     name of the author
-   * @param email    email of the author
-   * @param username username of the author
-   */
-  public Author(String name, String email, String username) {
-    this.name = name;
-    this.email = email;
-    this.username = username;
-  }
-
-  public Author() {
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public String getEmail() {
-    return email;
-  }
-
-  public String getUsername() {
-    return username;
-  }
-
-  @Override
-  public String toString() {
-    return "AuthorDTO [name=" + name + ", email=" + email + ", username=" + username + "]";
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(username, name, email);
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!(obj instanceof Author)) {
-      return false;
-    }
-    var other = (Author) obj;
-    return username.equals(other.getUsername()) && email.equals(other.getEmail()) && name
-        .equals(other.getName());
-
-  }
-
 }
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
index fb1f6200c..5088e98fe 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/dto/Book.java
@@ -23,58 +23,23 @@
 
 package com.iluwatar.cqrs.dto;
 
-import java.util.Objects;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
 
 /**
  * This is a DTO (Data Transfer Object) book, contains only useful information to be returned.
  */
+@ToString
+@EqualsAndHashCode
+@Getter
+@AllArgsConstructor
+@NoArgsConstructor
 public class Book {
 
   private String title;
   private double price;
 
-  /**
-   * Constructor.
-   *
-   * @param title title of the book
-   * @param price price of the book
-   */
-  public Book(String title, double price) {
-    this.title = title;
-    this.price = price;
-  }
-
-  public Book() {
-  }
-
-  public String getTitle() {
-    return title;
-  }
-
-  public double getPrice() {
-    return price;
-  }
-
-  @Override
-  public String toString() {
-    return "BookDTO [title=" + title + ", price=" + price + "]";
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(title, price);
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!(obj instanceof Book)) {
-      return false;
-    }
-    var book = (Book) obj;
-    return title.equals(book.getTitle()) && price == book.getPrice();
-  }
-
 }
diff --git a/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java b/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
index 3c3e2ce14..5ae535861 100644
--- a/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
+++ b/cqrs/src/main/java/com/iluwatar/cqrs/util/HibernateUtil.java
@@ -23,20 +23,19 @@
 
 package com.iluwatar.cqrs.util;
 
+import lombok.extern.slf4j.Slf4j;
 import org.hibernate.SessionFactory;
 import org.hibernate.boot.MetadataSources;
 import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * This class simply returns one instance of {@link SessionFactory} initialized when the application
  * is started.
  */
+@Slf4j
 public class HibernateUtil {
 
   private static final SessionFactory SESSIONFACTORY = buildSessionFactory();
-  private static final Logger LOGGER = LoggerFactory.getLogger(HibernateUtil.class);
 
   private static SessionFactory buildSessionFactory() {
 
@@ -46,7 +45,7 @@ public class HibernateUtil {
       return new MetadataSources(registry).buildMetadata().buildSessionFactory();
     } catch (Exception ex) {
       StandardServiceRegistryBuilder.destroy(registry);
-      LOGGER.error("Initial SessionFactory creation failed." + ex);
+      LOGGER.error("Initial SessionFactory creation failed.", ex);
       throw new ExceptionInInitializerError(ex);
     }
   }
diff --git a/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java b/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
index 64d4a38e8..51c182df6 100644
--- a/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
+++ b/cqrs/src/test/java/com/iluwatar/cqrs/IntegrationTest.java
@@ -38,12 +38,12 @@ import org.junit.jupiter.api.Test;
 /**
  * Integration test of IQueryService and ICommandService with h2 data
  */
-public class IntegrationTest {
+class IntegrationTest {
 
   private static IQueryService queryService;
 
   @BeforeAll
-  public static void initializeAndPopulateDatabase() {
+  static void initializeAndPopulateDatabase() {
     var commandService = new CommandServiceImpl();
     queryService = new QueryServiceImpl();
 
@@ -67,7 +67,7 @@ public class IntegrationTest {
   }
 
   @Test
-  public void testGetAuthorByUsername() {
+  void testGetAuthorByUsername() {
     var author = queryService.getAuthorByUsername("username1");
     assertEquals("username1", author.getUsername());
     assertEquals("name1", author.getName());
@@ -75,7 +75,7 @@ public class IntegrationTest {
   }
 
   @Test
-  public void testGetUpdatedAuthorByUsername() {
+  void testGetUpdatedAuthorByUsername() {
     var author = queryService.getAuthorByUsername("new_username2");
     var expectedAuthor = new Author("new_name2", "new_email2", "new_username2");
     assertEquals(expectedAuthor, author);
@@ -83,14 +83,14 @@ public class IntegrationTest {
   }
 
   @Test
-  public void testGetBook() {
+  void testGetBook() {
     var book = queryService.getBook("title1");
     assertEquals("title1", book.getTitle());
     assertEquals(10, book.getPrice(), 0.01);
   }
 
   @Test
-  public void testGetAuthorBooks() {
+  void testGetAuthorBooks() {
     var books = queryService.getAuthorBooks("username1");
     assertEquals(2, books.size());
     assertTrue(books.contains(new Book("title1", 10)));
@@ -98,13 +98,13 @@ public class IntegrationTest {
   }
 
   @Test
-  public void testGetAuthorBooksCount() {
+  void testGetAuthorBooksCount() {
     var bookCount = queryService.getAuthorBooksCount("username1");
     assertEquals(new BigInteger("2"), bookCount);
   }
 
   @Test
-  public void testGetAuthorsCount() {
+  void testGetAuthorsCount() {
     var authorCount = queryService.getAuthorsCount();
     assertEquals(new BigInteger("2"), authorCount);
   }
diff --git a/dao/README.md b/dao/README.md
index 29e64a74f..9e2d6992a 100644
--- a/dao/README.md
+++ b/dao/README.md
@@ -74,10 +74,9 @@ public class InMemoryCustomerDao implements CustomerDao {
   ...
 }
 
+@Slf4j
 public class DbCustomerDao implements CustomerDao {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DbCustomerDao.class);
-
   private final DataSource dataSource;
 
   public DbCustomerDao(DataSource dataSource) {
diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java
index 4de690ed3..5c1d36923 100644
--- a/dao/src/main/java/com/iluwatar/dao/App.java
+++ b/dao/src/main/java/com/iluwatar/dao/App.java
@@ -26,9 +26,8 @@ package com.iluwatar.dao;
 import java.sql.SQLException;
 import java.util.List;
 import javax.sql.DataSource;
+import lombok.extern.slf4j.Slf4j;
 import org.h2.jdbcx.JdbcDataSource;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Data Access Object (DAO) is an object that provides an abstract interface to some type of
@@ -42,9 +41,9 @@ import org.slf4j.LoggerFactory;
  * without directly interacting with the data source. The below example demonstrates basic CRUD
  * operations: select, add, update, and delete.
  */
+@Slf4j
 public class App {
   private static final String DB_URL = "jdbc:h2:~/dao";
-  private static final Logger log = LoggerFactory.getLogger(App.class);
   private static final String ALL_CUSTOMERS = "customerDao.getAllCustomers(): ";
 
   /**
@@ -86,23 +85,23 @@ public class App {
 
   private static void performOperationsUsing(final CustomerDao customerDao) throws Exception {
     addCustomers(customerDao);
-    log.info(ALL_CUSTOMERS);
+    LOGGER.info(ALL_CUSTOMERS);
     try (var customerStream = customerDao.getAll()) {
-      customerStream.forEach((customer) -> log.info(customer.toString()));
+      customerStream.forEach(customer -> LOGGER.info(customer.toString()));
     }
-    log.info("customerDao.getCustomerById(2): " + customerDao.getById(2));
+    LOGGER.info("customerDao.getCustomerById(2): " + customerDao.getById(2));
     final var customer = new Customer(4, "Dan", "Danson");
     customerDao.add(customer);
-    log.info(ALL_CUSTOMERS + customerDao.getAll());
+    LOGGER.info(ALL_CUSTOMERS + customerDao.getAll());
     customer.setFirstName("Daniel");
     customer.setLastName("Danielson");
     customerDao.update(customer);
-    log.info(ALL_CUSTOMERS);
+    LOGGER.info(ALL_CUSTOMERS);
     try (var customerStream = customerDao.getAll()) {
-      customerStream.forEach((cust) -> log.info(cust.toString()));
+      customerStream.forEach(cust -> LOGGER.info(cust.toString()));
     }
     customerDao.delete(customer);
-    log.info(ALL_CUSTOMERS + customerDao.getAll());
+    LOGGER.info(ALL_CUSTOMERS + customerDao.getAll());
   }
 
   private static void addCustomers(CustomerDao customerDao) throws Exception {
diff --git a/dao/src/main/java/com/iluwatar/dao/Customer.java b/dao/src/main/java/com/iluwatar/dao/Customer.java
index 3cf6bd4a9..d5c0c583e 100644
--- a/dao/src/main/java/com/iluwatar/dao/Customer.java
+++ b/dao/src/main/java/com/iluwatar/dao/Customer.java
@@ -23,70 +23,25 @@
 
 package com.iluwatar.dao;
 
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
+
 /**
  * A customer POJO that represents the data that will be read from the data source.
  */
+@Setter
+@Getter
+@ToString
+@EqualsAndHashCode(onlyExplicitlyIncluded = true)
+@AllArgsConstructor
 public class Customer {
 
+  @EqualsAndHashCode.Include
   private int id;
   private String firstName;
   private String lastName;
 
-  /**
-   * Creates an instance of customer.
-   */
-  public Customer(int id, String firstName, String lastName) {
-    this.id = id;
-    this.firstName = firstName;
-    this.lastName = lastName;
-  }
-
-  public int getId() {
-    return id;
-  }
-
-  public void setId(final int id) {
-    this.id = id;
-  }
-
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public void setFirstName(final String firstName) {
-    this.firstName = firstName;
-  }
-
-  public String getLastName() {
-    return lastName;
-  }
-
-  public void setLastName(final String lastName) {
-    this.lastName = lastName;
-  }
-
-  @Override
-  public String toString() {
-    return "Customer{" + "id=" + getId() + ", firstName='" + getFirstName() + '\'' + ", lastName='"
-        + getLastName() + '\'' + '}';
-  }
-
-  @Override
-  public boolean equals(final Object that) {
-    var isEqual = false;
-    if (this == that) {
-      isEqual = true;
-    } else if (that != null && getClass() == that.getClass()) {
-      final var customer = (Customer) that;
-      if (getId() == customer.getId()) {
-        isEqual = true;
-      }
-    }
-    return isEqual;
-  }
-
-  @Override
-  public int hashCode() {
-    return getId();
-  }
 }
diff --git a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
index 811ef5a55..6065b32bb 100644
--- a/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/DbCustomerDao.java
@@ -34,28 +34,18 @@ import java.util.function.Consumer;
 import java.util.stream.Stream;
 import java.util.stream.StreamSupport;
 import javax.sql.DataSource;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * An implementation of {@link CustomerDao} that persists customers in RDBMS.
  */
+@Slf4j
+@RequiredArgsConstructor
 public class DbCustomerDao implements CustomerDao {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DbCustomerDao.class);
-
   private final DataSource dataSource;
 
-  /**
-   * Creates an instance of {@link DbCustomerDao} which uses provided <code>dataSource</code> to
-   * store and retrieve customer information.
-   *
-   * @param dataSource a non-null dataSource.
-   */
-  public DbCustomerDao(DataSource dataSource) {
-    this.dataSource = dataSource;
-  }
-
   /**
    * Get all customers as Java Stream.
    *
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
index ccfcba142..492325153 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
@@ -32,7 +32,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests {@link Customer}.
  */
-public class CustomerTest {
+class CustomerTest {
 
   private Customer customer;
   private static final int ID = 1;
@@ -40,33 +40,33 @@ public class CustomerTest {
   private static final String LASTNAME = "Churchill";
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     customer = new Customer(ID, FIRSTNAME, LASTNAME);
   }
 
   @Test
-  public void getAndSetId() {
+  void getAndSetId() {
     final var newId = 2;
     customer.setId(newId);
     assertEquals(newId, customer.getId());
   }
 
   @Test
-  public void getAndSetFirstname() {
+  void getAndSetFirstname() {
     final var newFirstname = "Bill";
     customer.setFirstName(newFirstname);
     assertEquals(newFirstname, customer.getFirstName());
   }
 
   @Test
-  public void getAndSetLastname() {
+  void getAndSetLastname() {
     final var newLastname = "Clinton";
     customer.setLastName(newLastname);
     assertEquals(newLastname, customer.getLastName());
   }
 
   @Test
-  public void notEqualWithDifferentId() {
+  void notEqualWithDifferentId() {
     final var newId = 2;
     final var otherCustomer = new Customer(newId, FIRSTNAME, LASTNAME);
     assertNotEquals(customer, otherCustomer);
@@ -74,21 +74,21 @@ public class CustomerTest {
   }
 
   @Test
-  public void equalsWithSameObjectValues() {
+  void equalsWithSameObjectValues() {
     final var otherCustomer = new Customer(ID, FIRSTNAME, LASTNAME);
     assertEquals(customer, otherCustomer);
     assertEquals(customer.hashCode(), otherCustomer.hashCode());
   }
 
   @Test
-  public void equalsWithSameObjects() {
+  void equalsWithSameObjects() {
     assertEquals(customer, customer);
     assertEquals(customer.hashCode(), customer.hashCode());
   }
 
   @Test
-  public void testToString() {
-    assertEquals(String.format("Customer{id=%s, firstName='%s', lastName='%s'}",
+  void testToString() {
+    assertEquals(String.format("Customer(id=%s, firstName=%s, lastName=%s)",
         customer.getId(), customer.getFirstName(), customer.getLastName()), customer.toString());
   }
 }
diff --git a/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java b/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
index 7375ebd64..1c78fbba0 100644
--- a/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/DbCustomerDaoTest.java
@@ -46,7 +46,7 @@ import org.mockito.Mockito;
 /**
  * Tests {@link DbCustomerDao}.
  */
-public class DbCustomerDaoTest {
+class DbCustomerDaoTest {
 
   private static final String DB_URL = "jdbc:h2:~/dao";
   private DbCustomerDao dao;
@@ -58,7 +58,7 @@ public class DbCustomerDaoTest {
    * @throws SQLException if there is any error while creating schema.
    */
   @BeforeEach
-  public void createSchema() throws SQLException {
+  void createSchema() throws SQLException {
     try (var connection = DriverManager.getConnection(DB_URL);
          var statement = connection.createStatement()) {
       statement.execute(CustomerSchemaSql.CREATE_SCHEMA_SQL);
@@ -89,10 +89,10 @@ public class DbCustomerDaoTest {
      * Represents the scenario when DAO operations are being performed on a non existing customer.
      */
     @Nested
-    public class NonExistingCustomer {
+    class NonExistingCustomer {
 
       @Test
-      public void addingShouldResultInSuccess() throws Exception {
+      void addingShouldResultInSuccess() throws Exception {
         try (var allCustomers = dao.getAll()) {
           assumeTrue(allCustomers.count() == 1);
         }
@@ -106,7 +106,7 @@ public class DbCustomerDaoTest {
       }
 
       @Test
-      public void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
+      void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
         final var nonExistingCustomer = new Customer(2, "Robert", "Englund");
         var result = dao.delete(nonExistingCustomer);
 
@@ -115,7 +115,7 @@ public class DbCustomerDaoTest {
       }
 
       @Test
-      public void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
+      void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
         final var nonExistingId = getNonExistingCustomerId();
         final var newFirstname = "Douglas";
         final var newLastname = "MacArthur";
@@ -127,7 +127,7 @@ public class DbCustomerDaoTest {
       }
 
       @Test
-      public void retrieveShouldReturnNoCustomer() throws Exception {
+      void retrieveShouldReturnNoCustomer() throws Exception {
         assertFalse(dao.getById(getNonExistingCustomerId()).isPresent());
       }
     }
@@ -137,10 +137,10 @@ public class DbCustomerDaoTest {
      * customer.
      */
     @Nested
-    public class ExistingCustomer {
+    class ExistingCustomer {
 
       @Test
-      public void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception {
+      void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception {
         var existingCustomer = new Customer(1, "Freddy", "Krueger");
         var result = dao.add(existingCustomer);
 
@@ -150,7 +150,7 @@ public class DbCustomerDaoTest {
       }
 
       @Test
-      public void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception {
+      void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception {
         var result = dao.delete(existingCustomer);
 
         assertTrue(result);
@@ -159,7 +159,7 @@ public class DbCustomerDaoTest {
       }
 
       @Test
-      public void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws
+      void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws
           Exception {
         final var newFirstname = "Bernard";
         final var newLastname = "Montgomery";
@@ -180,7 +180,7 @@ public class DbCustomerDaoTest {
    * unavailable.
    */
   @Nested
-  public class ConnectivityIssue {
+  class ConnectivityIssue {
 
     private static final String EXCEPTION_CAUSE = "Connection not available";
 
@@ -204,21 +204,21 @@ public class DbCustomerDaoTest {
     }
 
     @Test
-    public void addingACustomerFailsWithExceptionAsFeedbackToClient() {
+    void addingACustomerFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.add(new Customer(2, "Bernard", "Montgomery"));
       });
     }
 
     @Test
-    public void deletingACustomerFailsWithExceptionAsFeedbackToTheClient() {
+    void deletingACustomerFailsWithExceptionAsFeedbackToTheClient() {
       assertThrows(Exception.class, () -> {
         dao.delete(existingCustomer);
       });
     }
 
     @Test
-    public void updatingACustomerFailsWithFeedbackToTheClient() {
+    void updatingACustomerFailsWithFeedbackToTheClient() {
       final var newFirstname = "Bernard";
       final var newLastname = "Montgomery";
       assertThrows(Exception.class, () -> {
@@ -227,14 +227,14 @@ public class DbCustomerDaoTest {
     }
 
     @Test
-    public void retrievingACustomerByIdFailsWithExceptionAsFeedbackToClient() {
+    void retrievingACustomerByIdFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.getById(existingCustomer.getId());
       });
     }
 
     @Test
-    public void retrievingAllCustomersFailsWithExceptionAsFeedbackToClient() {
+    void retrievingAllCustomersFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.getAll();
       });
@@ -248,7 +248,7 @@ public class DbCustomerDaoTest {
    * @throws SQLException if any error occurs.
    */
   @AfterEach
-  public void deleteSchema() throws SQLException {
+  void deleteSchema() throws SQLException {
     try (var connection = DriverManager.getConnection(DB_URL);
          var statement = connection.createStatement()) {
       statement.execute(CustomerSchemaSql.DELETE_SCHEMA_SQL);
@@ -261,7 +261,6 @@ public class DbCustomerDaoTest {
     }
   }
 
-
   /**
    * An arbitrary number which does not correspond to an active Customer id.
    *
diff --git a/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java b/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
index d4cc79303..9ff9e6a85 100644
--- a/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/InMemoryCustomerDaoTest.java
@@ -35,13 +35,13 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests {@link InMemoryCustomerDao}.
  */
-public class InMemoryCustomerDaoTest {
+class InMemoryCustomerDaoTest {
 
   private InMemoryCustomerDao dao;
   private static final Customer CUSTOMER = new Customer(1, "Freddy", "Krueger");
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     dao = new InMemoryCustomerDao();
     assertTrue(dao.add(CUSTOMER));
   }
@@ -51,10 +51,10 @@ public class InMemoryCustomerDaoTest {
    * customer.
    */
   @Nested
-  public class NonExistingCustomer {
+  class NonExistingCustomer {
 
     @Test
-    public void addingShouldResultInSuccess() throws Exception {
+    void addingShouldResultInSuccess() throws Exception {
       try (var allCustomers = dao.getAll()) {
         assumeTrue(allCustomers.count() == 1);
       }
@@ -68,7 +68,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
+    void deletionShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
       final var nonExistingCustomer = new Customer(2, "Robert", "Englund");
       var result = dao.delete(nonExistingCustomer);
 
@@ -77,7 +77,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
+    void updationShouldBeFailureAndNotAffectExistingCustomers() throws Exception {
       final var nonExistingId = getNonExistingCustomerId();
       final var newFirstname = "Douglas";
       final var newLastname = "MacArthur";
@@ -89,7 +89,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void retrieveShouldReturnNoCustomer() throws Exception {
+    void retrieveShouldReturnNoCustomer() throws Exception {
       assertFalse(dao.getById(getNonExistingCustomerId()).isPresent());
     }
   }
@@ -99,10 +99,10 @@ public class InMemoryCustomerDaoTest {
    * customer.
    */
   @Nested
-  public class ExistingCustomer {
+  class ExistingCustomer {
 
     @Test
-    public void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception {
+    void addingShouldResultInFailureAndNotAffectExistingCustomers() throws Exception {
       var result = dao.add(CUSTOMER);
 
       assertFalse(result);
@@ -111,7 +111,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception {
+    void deletionShouldBeSuccessAndCustomerShouldBeNonAccessible() throws Exception {
       var result = dao.delete(CUSTOMER);
 
       assertTrue(result);
@@ -120,7 +120,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws
+    void updationShouldBeSuccessAndAccessingTheSameCustomerShouldReturnUpdatedInformation() throws
         Exception {
       final var newFirstname = "Bernard";
       final var newLastname = "Montgomery";
@@ -135,7 +135,7 @@ public class InMemoryCustomerDaoTest {
     }
 
     @Test
-    public void retriveShouldReturnTheCustomer() {
+    void retriveShouldReturnTheCustomer() {
       var optionalCustomer = dao.getById(CUSTOMER.getId());
 
       assertTrue(optionalCustomer.isPresent());
diff --git a/data-bus/pom.xml b/data-bus/pom.xml
index b9d57e091..6355b5682 100644
--- a/data-bus/pom.xml
+++ b/data-bus/pom.xml
@@ -27,9 +27,6 @@
          xmlns="http://maven.apache.org/POM/4.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <modelVersion>4.0.0</modelVersion>
-    <properties>
-        <lombok.version>1.16.14</lombok.version>
-    </properties>
     <parent>
         <groupId>com.iluwatar</groupId>
         <artifactId>java-design-patterns</artifactId>
diff --git a/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java b/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
index 90d996291..64efbed9f 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/AbstractDataType.java
@@ -47,22 +47,17 @@ SOFTWARE.
 
 package com.iluwatar.databus;
 
+import lombok.Getter;
+import lombok.Setter;
+
 /**
  * Base for data to send via the Data-Bus.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@Getter
+@Setter
 public class AbstractDataType implements DataType {
 
   private DataBus dataBus;
-
-  @Override
-  public DataBus getDataBus() {
-    return dataBus;
-  }
-
-  @Override
-  public void setDataBus(DataBus dataBus) {
-    this.dataBus = dataBus;
-  }
 }
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java b/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
index 26173f417..f79eab084 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/MessageData.java
@@ -25,24 +25,20 @@ package com.iluwatar.databus.data;
 
 import com.iluwatar.databus.AbstractDataType;
 import com.iluwatar.databus.DataType;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
 
 /**
  * An event raised when a string message is sent.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@Getter
+@AllArgsConstructor
 public class MessageData extends AbstractDataType {
 
   private final String message;
 
-  public MessageData(String message) {
-    this.message = message;
-  }
-
-  public String getMessage() {
-    return message;
-  }
-
   public static DataType of(final String message) {
     return new MessageData(message);
   }
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java b/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
index 0b2b2d9b6..5225061c1 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/StartingData.java
@@ -26,24 +26,20 @@ package com.iluwatar.databus.data;
 import com.iluwatar.databus.AbstractDataType;
 import com.iluwatar.databus.DataType;
 import java.time.LocalDateTime;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * An event raised when applications starts, containing the start time of the application.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@RequiredArgsConstructor
+@Getter
 public class StartingData extends AbstractDataType {
 
   private final LocalDateTime when;
 
-  public StartingData(LocalDateTime when) {
-    this.when = when;
-  }
-
-  public LocalDateTime getWhen() {
-    return when;
-  }
-
   public static DataType of(final LocalDateTime when) {
     return new StartingData(when);
   }
diff --git a/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java b/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
index 1d415135e..a08db1ead 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/data/StoppingData.java
@@ -26,24 +26,20 @@ package com.iluwatar.databus.data;
 import com.iluwatar.databus.AbstractDataType;
 import com.iluwatar.databus.DataType;
 import java.time.LocalDateTime;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * An event raised when applications stops, containing the stop time of the application.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@RequiredArgsConstructor
+@Getter
 public class StoppingData extends AbstractDataType {
 
   private final LocalDateTime when;
 
-  public StoppingData(LocalDateTime when) {
-    this.when = when;
-  }
-
-  public LocalDateTime getWhen() {
-    return when;
-  }
-
   public static DataType of(final LocalDateTime when) {
     return new StoppingData(when);
   }
diff --git a/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java b/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
index 26ed6b24f..b06045ddc 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/members/MessageCollectorMember.java
@@ -28,17 +28,16 @@ import com.iluwatar.databus.Member;
 import com.iluwatar.databus.data.MessageData;
 import java.util.ArrayList;
 import java.util.List;
-import java.util.logging.Logger;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Receiver of Data-Bus events that collects the messages from each {@link MessageData}.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@Slf4j
 public class MessageCollectorMember implements Member {
 
-  private static final Logger LOGGER = Logger.getLogger(MessageCollectorMember.class.getName());
-
   private final String name;
 
   private final List<String> messages = new ArrayList<>();
@@ -55,7 +54,7 @@ public class MessageCollectorMember implements Member {
   }
 
   private void handleEvent(MessageData data) {
-    LOGGER.info(String.format("%s sees message %s", name, data.getMessage()));
+    LOGGER.info("{} sees message {}", name, data.getMessage());
     messages.add(data.getMessage());
   }
 
diff --git a/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java b/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
index 65ba87745..03804a46b 100644
--- a/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
+++ b/data-bus/src/main/java/com/iluwatar/databus/members/StatusMember.java
@@ -29,27 +29,26 @@ import com.iluwatar.databus.data.MessageData;
 import com.iluwatar.databus.data.StartingData;
 import com.iluwatar.databus.data.StoppingData;
 import java.time.LocalDateTime;
-import java.util.logging.Logger;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Receiver of Data-Bus events.
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
+@Getter
+@Slf4j
+@RequiredArgsConstructor
 public class StatusMember implements Member {
 
-  private static final Logger LOGGER = Logger.getLogger(StatusMember.class.getName());
-
   private final int id;
 
   private LocalDateTime started;
 
   private LocalDateTime stopped;
 
-  public StatusMember(int id) {
-    this.id = id;
-  }
-
   @Override
   public void accept(final DataType data) {
     if (data instanceof StartingData) {
@@ -61,21 +60,14 @@ public class StatusMember implements Member {
 
   private void handleEvent(StartingData data) {
     started = data.getWhen();
-    LOGGER.info(String.format("Receiver #%d sees application started at %s", id, started));
+    LOGGER.info("Receiver {} sees application started at {}", id, started);
   }
 
   private void handleEvent(StoppingData data) {
     stopped = data.getWhen();
-    LOGGER.info(String.format("Receiver #%d sees application stopping at %s", id, stopped));
-    LOGGER.info(String.format("Receiver #%d sending goodbye message", id));
+    LOGGER.info("Receiver {} sees application stopping at {}", id, stopped);
+    LOGGER.info("Receiver {} sending goodbye message", id);
     data.getDataBus().publish(MessageData.of(String.format("Goodbye cruel world from #%d!", id)));
   }
 
-  public LocalDateTime getStarted() {
-    return started;
-  }
-
-  public LocalDateTime getStopped() {
-    return stopped;
-  }
 }
diff --git a/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java b/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
index 3f8aa88b0..9278c965b 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/DataBusTest.java
@@ -36,7 +36,7 @@ import org.mockito.MockitoAnnotations;
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
-public class DataBusTest {
+class DataBusTest {
 
   @Mock
   private Member member;
@@ -45,12 +45,12 @@ public class DataBusTest {
   private DataType event;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     MockitoAnnotations.initMocks(this);
   }
 
   @Test
-  public void publishedEventIsReceivedBySubscribedMember() {
+  void publishedEventIsReceivedBySubscribedMember() {
     //given
     final var dataBus = DataBus.getInstance();
     dataBus.subscribe(member);
@@ -61,7 +61,7 @@ public class DataBusTest {
   }
 
   @Test
-  public void publishedEventIsNotReceivedByMemberAfterUnsubscribing() {
+  void publishedEventIsNotReceivedByMemberAfterUnsubscribing() {
     //given
     final var dataBus = DataBus.getInstance();
     dataBus.subscribe(member);
diff --git a/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java b/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
index c6f5b3b40..67ff8ca6b 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/members/MessageCollectorMemberTest.java
@@ -36,10 +36,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
-public class MessageCollectorMemberTest {
+class MessageCollectorMemberTest {
 
   @Test
-  public void collectMessageFromMessageData() {
+  void collectMessageFromMessageData() {
     //given
     final var message = "message";
     final var messageData = new MessageData(message);
@@ -51,7 +51,7 @@ public class MessageCollectorMemberTest {
   }
 
   @Test
-  public void collectIgnoresMessageFromOtherDataTypes() {
+  void collectIgnoresMessageFromOtherDataTypes() {
     //given
     final var startingData = new StartingData(LocalDateTime.now());
     final var collector = new MessageCollectorMember("collector");
diff --git a/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java b/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
index b7be285ee..8f59b1a14 100644
--- a/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
+++ b/data-bus/src/test/java/com/iluwatar/databus/members/StatusMemberTest.java
@@ -39,10 +39,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Paul Campbell (pcampbell@kemitix.net)
  */
-public class StatusMemberTest {
+class StatusMemberTest {
 
   @Test
-  public void statusRecordsTheStartTime() {
+  void statusRecordsTheStartTime() {
     //given
     final var startTime = LocalDateTime.of(2017, Month.APRIL, 1, 19, 9);
     final var startingData = new StartingData(startTime);
@@ -54,7 +54,7 @@ public class StatusMemberTest {
   }
 
   @Test
-  public void statusRecordsTheStopTime() {
+  void statusRecordsTheStopTime() {
     //given
     final var stop = LocalDateTime.of(2017, Month.APRIL, 1, 19, 12);
     final var stoppingData = new StoppingData(stop);
@@ -67,7 +67,7 @@ public class StatusMemberTest {
   }
 
   @Test
-  public void statusIgnoresMessageData() {
+  void statusIgnoresMessageData() {
     //given
     final var messageData = new MessageData("message");
     final var statusMember = new StatusMember(1);
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/Application.java b/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
index 0930cae56..0325130a8 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/Application.java
@@ -24,8 +24,7 @@
 package com.iluwatar.data.locality;
 
 import com.iluwatar.data.locality.game.GameEntity;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Use the Data Locality pattern is when you have a performance problem. Take advantage of that to
@@ -35,10 +34,9 @@ import org.slf4j.LoggerFactory;
  * <p>Example:  Game loop that processes a bunch of game entities. Those entities are decomposed
  * into different domains  — AI, physics, and rendering — using the Component pattern.
  */
+@Slf4j
 public class Application {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Application.class);
-
   private static final int NUM_ENTITIES = 5;
 
   /**
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
index 340b021f9..e7495424c 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/GameEntity.java
@@ -26,8 +26,7 @@ package com.iluwatar.data.locality.game;
 import com.iluwatar.data.locality.game.component.manager.AiComponentManager;
 import com.iluwatar.data.locality.game.component.manager.PhysicsComponentManager;
 import com.iluwatar.data.locality.game.component.manager.RenderComponentManager;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The game Entity maintains a big array of pointers . Each spin of the game loop, we need to run
@@ -39,8 +38,8 @@ import org.slf4j.LoggerFactory;
  *
  * <p>Render them using their render components.
  */
+@Slf4j
 public class GameEntity {
-  private static final Logger LOGGER = LoggerFactory.getLogger(GameEntity.class);
 
   private final AiComponentManager aiComponentManager;
   private final PhysicsComponentManager physicsComponentManager;
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
index 58d4c5784..6f895f709 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/AiComponent.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.data.locality.game.component;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation of AI component for Game.
  */
+@Slf4j
 public class AiComponent implements Component {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AiComponent.class);
-
   /**
    * Update ai component.
    */
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
index 4636336c2..fa6f5bf1d 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/PhysicsComponent.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.data.locality.game.component;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation of Physics Component of Game.
  */
+@Slf4j
 public class PhysicsComponent implements Component {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PhysicsComponent.class);
-
   /**
    * update physics component of game.
    */
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
index 5415c4281..696414469 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/RenderComponent.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.data.locality.game.component;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation of Render Component of Game.
  */
+@Slf4j
 public class RenderComponent implements Component {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(RenderComponent.class);
-
   @Override
   public void update() {
     // do nothing
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
index 034dd2db1..58b67d524 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/AiComponentManager.java
@@ -26,16 +26,14 @@ package com.iluwatar.data.locality.game.component.manager;
 import com.iluwatar.data.locality.game.component.AiComponent;
 import com.iluwatar.data.locality.game.component.Component;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * AI component manager for Game.
  */
+@Slf4j
 public class AiComponentManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AiComponentManager.class);
-
   private static final int MAX_ENTITIES = 10000;
 
   private final int numEntities;
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
index dc70ba0cc..32885da61 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/PhysicsComponentManager.java
@@ -26,16 +26,14 @@ package com.iluwatar.data.locality.game.component.manager;
 import com.iluwatar.data.locality.game.component.Component;
 import com.iluwatar.data.locality.game.component.PhysicsComponent;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Physics component Manager for Game.
  */
+@Slf4j
 public class PhysicsComponentManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PhysicsComponentManager.class);
-
   private static final int MAX_ENTITIES = 10000;
 
   private final int numEntities;
diff --git a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
index ffc1b4303..804a82667 100644
--- a/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
+++ b/data-locality/src/main/java/com/iluwatar/data/locality/game/component/manager/RenderComponentManager.java
@@ -26,16 +26,14 @@ package com.iluwatar.data.locality.game.component.manager;
 import com.iluwatar.data.locality.game.component.Component;
 import com.iluwatar.data.locality.game.component.RenderComponent;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Render component manager for Game.
  */
+@Slf4j
 public class RenderComponentManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(RenderComponentManager.class);
-
   private static final int MAX_ENTITIES = 10000;
 
   private final int numEntities;
diff --git a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
index 7be4e9d44..a0d710139 100644
--- a/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
+++ b/data-locality/src/test/java/com/iluwatar/data/locality/ApplicationTest.java
@@ -42,6 +42,6 @@ class ApplicationTest {
 
   @Test
   void shouldExecuteGameApplicationWithoutException() {
-    assertDoesNotThrow(() -> Application.main(new String[] {}));
+    assertDoesNotThrow(() -> Application.main(new String[]{}));
   }
 }
\ No newline at end of file
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/App.java b/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
index e1aa6ecb6..6f4e3a5f0 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.datamapper;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Data Mapper (DM) is a layer of software that separates the in-memory objects from the
@@ -36,12 +35,11 @@ import org.slf4j.LoggerFactory;
  *
  * <p>The below example demonstrates basic CRUD operations: Create, Read, Update, and Delete.
  */
+@Slf4j
 public final class App {
 
-  private static final Logger log = LoggerFactory.getLogger(App.class);
   private static final String STUDENT_STRING = "App.main(), student : ";
 
-
   /**
    * Program entry point.
    *
@@ -58,12 +56,12 @@ public final class App {
     /* Add student in respectibe store */
     mapper.insert(student);
 
-    log.debug(STUDENT_STRING + student + ", is inserted");
+    LOGGER.debug(STUDENT_STRING + student + ", is inserted");
 
     /* Find this student */
     final var studentToBeFound = mapper.find(student.getStudentId());
 
-    log.debug(STUDENT_STRING + studentToBeFound + ", is searched");
+    LOGGER.debug(STUDENT_STRING + studentToBeFound + ", is searched");
 
     /* Update existing student object */
     student = new Student(student.getStudentId(), "AdamUpdated", 'A');
@@ -71,8 +69,8 @@ public final class App {
     /* Update student in respectibe db */
     mapper.update(student);
 
-    log.debug(STUDENT_STRING + student + ", is updated");
-    log.debug(STUDENT_STRING + student + ", is going to be deleted");
+    LOGGER.debug(STUDENT_STRING + student + ", is updated");
+    LOGGER.debug(STUDENT_STRING + student + ", is going to be deleted");
 
     /* Delete student in db */
     mapper.delete(student);
diff --git a/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java b/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
index ec9de8090..cd1fb888e 100644
--- a/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
+++ b/data-mapper/src/main/java/com/iluwatar/datamapper/Student.java
@@ -24,88 +24,27 @@
 package com.iluwatar.datamapper;
 
 import java.io.Serializable;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * Class defining Student.
  */
+@EqualsAndHashCode(onlyExplicitlyIncluded = true)
+@ToString
+@Getter
+@Setter
+@AllArgsConstructor
 public final class Student implements Serializable {
 
   private static final long serialVersionUID = 1L;
 
+  @EqualsAndHashCode.Include
   private int studentId;
   private String name;
   private char grade;
 
-
-  /**
-   * Use this constructor to create a Student with all details.
-   *
-   * @param studentId as unique student id
-   * @param name      as student name
-   * @param grade     as respective grade of student
-   */
-  public Student(final int studentId, final String name, final char grade) {
-    this.studentId = studentId;
-    this.name = name;
-    this.grade = grade;
-  }
-
-  public int getStudentId() {
-    return studentId;
-  }
-
-  public void setStudentId(final int studentId) {
-    this.studentId = studentId;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public void setName(final String name) {
-    this.name = name;
-  }
-
-  public char getGrade() {
-    return grade;
-  }
-
-  public void setGrade(final char grade) {
-    this.grade = grade;
-  }
-
-  @Override
-  public boolean equals(final Object inputObject) {
-
-    boolean isEqual = false;
-
-    /* Check if both objects are same */
-    if (this == inputObject) {
-
-      isEqual = true;
-    } else if (inputObject != null && getClass() == inputObject.getClass()) {
-
-      final var inputStudent = (Student) inputObject;
-
-      /* If student id matched */
-      if (this.getStudentId() == inputStudent.getStudentId()) {
-
-        isEqual = true;
-      }
-    }
-
-    return isEqual;
-  }
-
-  @Override
-  public int hashCode() {
-
-    /* Student id is assumed to be unique */
-    return this.getStudentId();
-  }
-
-  @Override
-  public String toString() {
-    return "Student [studentId=" + studentId + ", name=" + name + ", grade=" + grade + "]";
-  }
 }
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
index 25ab47eb1..cc953999c 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/DataMapperTest.java
@@ -37,13 +37,13 @@ import org.junit.jupiter.api.Test;
  * Data Mapper itself is even unknown to the domain layer.
  * <p>
  */
-public class DataMapperTest {
+class DataMapperTest {
 
   /**
    * This test verify that first data mapper is able to perform all CRUD operations on Student
    */
   @Test
-  public void testFirstDataMapper() {
+  void testFirstDataMapper() {
 
     /* Create new data mapper of first type */
     final var mapper = new StudentDataMapperImpl();
diff --git a/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java b/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
index 7153ae790..b7b82a4c3 100644
--- a/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
+++ b/data-mapper/src/test/java/com/iluwatar/datamapper/StudentTest.java
@@ -31,7 +31,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests {@link Student}.
  */
-public final class StudentTest {
+final class StudentTest {
 
   /**
    * This API tests the equality behaviour of Student object Object Equality should work as per
@@ -40,7 +40,7 @@ public final class StudentTest {
    * @throws Exception if any execution error during test
    */
   @Test
-  public void testEquality() throws Exception {
+  void testEquality() throws Exception {
 
     /* Create some students */
     final var firstStudent = new Student(1, "Adam", 'A');
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
index ae9aadf32..aa8f192c4 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/App.java
@@ -31,8 +31,7 @@ import com.iluwatar.datatransfer.product.ProductResource;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Data Transfer Object pattern is a design pattern in which an data transfer object is used to
@@ -50,10 +49,9 @@ import org.slf4j.LoggerFactory;
  * thought as a traditional example and the second is an enum based implementation.
  *
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Method as act client and request to server for details.
    *
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
index 6f653de53..2fee00d30 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerDto.java
@@ -23,39 +23,20 @@
 
 package com.iluwatar.datatransfer.customer;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * {@link CustomerDto} is a data transfer object POJO. Instead of sending individual information to
  * client We can send related information together in POJO.
  *
  * <p>Dto will not have any business logic in it.
  */
+@Getter
+@RequiredArgsConstructor
 public class CustomerDto {
   private final String id;
   private final String firstName;
   private final String lastName;
 
-  /**
-   * Constructor.
-   *
-   * @param id        customer id
-   * @param firstName customer first name
-   * @param lastName  customer last name
-   */
-  public CustomerDto(String id, String firstName, String lastName) {
-    this.id = id;
-    this.firstName = firstName;
-    this.lastName = lastName;
-  }
-
-  public String getId() {
-    return id;
-  }
-
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public String getLastName() {
-    return lastName;
-  }
 }
diff --git a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
index 2c5b88663..c9e4fa261 100644
--- a/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
+++ b/data-transfer-object/src/main/java/com/iluwatar/datatransfer/customer/CustomerResource.java
@@ -24,23 +24,16 @@
 package com.iluwatar.datatransfer.customer;
 
 import java.util.List;
+import lombok.RequiredArgsConstructor;
 
 /**
  * The resource class which serves customer information. This class act as server in the demo. Which
  * has all customer details.
  */
+@RequiredArgsConstructor
 public class CustomerResource {
   private final List<CustomerDto> customers;
 
-  /**
-   * Initialise resource with existing customers.
-   *
-   * @param customers initialize resource with existing customers. Act as database.
-   */
-  public CustomerResource(List<CustomerDto> customers) {
-    this.customers = customers;
-  }
-
   /**
    * Get all customers.
    *
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
index 5cd12868f..c170593af 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/AppTest.java
@@ -29,15 +29,15 @@ import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 class AppTest {
 
-    /**
-     * Issue: Add at least one assertion to this test case.
-     *
-     * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
-     * throws an exception.
-     */
+  /**
+   * Issue: Add at least one assertion to this test case.
+   *
+   * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
+   * throws an exception.
+   */
 
-    @Test
-    void shouldExecuteApplicationWithoutException() {
-        assertDoesNotThrow(() -> App.main(new String[]{}));
-    }
+  @Test
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
 }
diff --git a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
index 1a9e7eb84..e106cf002 100644
--- a/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
+++ b/data-transfer-object/src/test/java/com/iluwatar/datatransfer/customer/CustomerResourceTest.java
@@ -36,9 +36,10 @@ import org.junit.jupiter.api.Test;
 /**
  * tests {@link CustomerResource}.
  */
-public class CustomerResourceTest {
+class CustomerResourceTest {
+
   @Test
-  public void shouldGetAllCustomers() {
+  void shouldGetAllCustomers() {
     var customers = List.of(new CustomerDto("1", "Melody", "Yates"));
     var customerResource = new CustomerResource(customers);
     var allCustomers = customerResource.getAllCustomers();
@@ -50,7 +51,7 @@ public class CustomerResourceTest {
   }
 
   @Test
-  public void shouldSaveCustomer() {
+  void shouldSaveCustomer() {
     var customer = new CustomerDto("1", "Rita", "Reynolds");
     var customerResource = new CustomerResource(new ArrayList<>());
 
@@ -63,7 +64,7 @@ public class CustomerResourceTest {
   }
 
   @Test
-  public void shouldDeleteCustomer() {
+  void shouldDeleteCustomer() {
     var customer = new CustomerDto("1", "Terry", "Nguyen");
     var customers = new ArrayList<>(List.of(customer));
     var customerResource = new CustomerResource(customers);
diff --git a/decorator/README.md b/decorator/README.md
index 7ac0bb94c..ae1287b54 100644
--- a/decorator/README.md
+++ b/decorator/README.md
@@ -51,10 +51,9 @@ public interface Troll {
   void fleeBattle();
 }
 
+@Slf4j
 public class SimpleTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTroll.class);
-
   @Override
   public void attack() {
     LOGGER.info("The troll tries to grab you!");
@@ -75,10 +74,9 @@ public class SimpleTroll implements Troll {
 Next we want to add club for the troll. We can do it dynamically by using a decorator:
 
 ```java
+@Slf4j
 public class ClubbedTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ClubbedTroll.class);
-
   private final Troll decorated;
 
   public ClubbedTroll(Troll decorated) {
diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java
index c74b52c83..90ea972f6 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/App.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.decorator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Decorator pattern is a more flexible alternative to subclassing. The Decorator class
@@ -36,10 +35,9 @@ import org.slf4j.LoggerFactory;
  * battle. Then we decorate the {@link SimpleTroll} with a {@link ClubbedTroll} and perform the
  * attack again. You can see how the behavior changes after the decoration.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java b/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
index ab7fcbe53..96a6d4b30 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/ClubbedTroll.java
@@ -23,22 +23,18 @@
 
 package com.iluwatar.decorator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Decorator that adds a club for the troll.
  */
+@Slf4j
+@RequiredArgsConstructor
 public class ClubbedTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ClubbedTroll.class);
-
   private final Troll decorated;
 
-  public ClubbedTroll(Troll decorated) {
-    this.decorated = decorated;
-  }
-
   @Override
   public void attack() {
     decorated.attack();
diff --git a/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java b/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
index a9bf2bdad..cd382bce7 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/SimpleTroll.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.decorator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SimpleTroll implements {@link Troll} interface directly.
  */
+@Slf4j
 public class SimpleTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTroll.class);
-
   @Override
   public void attack() {
     LOGGER.info("The troll tries to grab you!");
diff --git a/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java b/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
index 1bb677a4e..e576b86c1 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/ClubbedTrollTest.java
@@ -34,10 +34,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests for {@link ClubbedTroll}
  */
-public class ClubbedTrollTest {
+class ClubbedTrollTest {
 
   @Test
-  public void testClubbedTroll() {
+  void testClubbedTroll() {
     // Create a normal troll first, but make sure we can spy on it later on.
     final var simpleTroll = spy(new SimpleTroll());
 
diff --git a/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java b/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
index 2d98a120d..8a2fa1999 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/SimpleTrollTest.java
@@ -38,22 +38,22 @@ import org.slf4j.LoggerFactory;
 /**
  * Tests for {@link SimpleTroll}
  */
-public class SimpleTrollTest {
+class SimpleTrollTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(SimpleTroll.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
   @Test
-  public void testTrollActions() {
+  void testTrollActions() {
     final var troll = new SimpleTroll();
     assertEquals(10, troll.getAttackPower());
 
@@ -70,7 +70,7 @@ public class SimpleTrollTest {
 
     private final List<ILoggingEvent> log = new LinkedList<>();
 
-    public InMemoryAppender(Class clazz) {
+    InMemoryAppender(Class clazz) {
       ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this);
       start();
     }
@@ -80,11 +80,11 @@ public class SimpleTrollTest {
       log.add(eventObject);
     }
 
-    public String getLastMessage() {
+    String getLastMessage() {
       return log.get(log.size() - 1).getMessage();
     }
 
-    public int getLogSize() {
+    int getLogSize() {
       return log.size();
     }
   }
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
index 025dbe92b..3084b1d4c 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/CanonPrinter.java
@@ -24,8 +24,7 @@
 package com.iluwatar.delegation.simple.printers;
 
 import com.iluwatar.delegation.simple.Printer;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Specialised Implementation of {@link Printer} for a Canon Printer, in this case the message to be
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  *
  * @see Printer
  */
+@Slf4j
 public class CanonPrinter implements Printer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CanonPrinter.class);
-
   /**
    * {@inheritDoc}
    */
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
index ef0026cb8..cfa8ecb72 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/EpsonPrinter.java
@@ -24,8 +24,7 @@
 package com.iluwatar.delegation.simple.printers;
 
 import com.iluwatar.delegation.simple.Printer;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Specialised Implementation of {@link Printer} for a Epson Printer, in this case the message to be
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  *
  * @see Printer
  */
+@Slf4j
 public class EpsonPrinter implements Printer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(EpsonPrinter.class);
-
   /**
    * {@inheritDoc}
    */
diff --git a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
index 0e9af1284..871537ce8 100644
--- a/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
+++ b/delegation/src/main/java/com/iluwatar/delegation/simple/printers/HpPrinter.java
@@ -24,8 +24,7 @@
 package com.iluwatar.delegation.simple.printers;
 
 import com.iluwatar.delegation.simple.Printer;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Specialised Implementation of {@link Printer} for a HP Printer, in this case the message to be
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  *
  * @see Printer
  */
+@Slf4j
 public class HpPrinter implements Printer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HpPrinter.class);
-
   /**
    * {@inheritDoc}
    */
diff --git a/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java b/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
index 093549428..29ec7a544 100644
--- a/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
+++ b/delegation/src/test/java/com/iluwatar/delegation/simple/DelegateTest.java
@@ -41,24 +41,24 @@ import org.slf4j.LoggerFactory;
 /**
  * Test for Delegation Pattern
  */
-public class DelegateTest {
+class DelegateTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender();
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
   private static final String MESSAGE = "Test Message Printed";
 
   @Test
-  public void testCanonPrinter() throws Exception {
+  void testCanonPrinter() throws Exception {
     var printerController = new PrinterController(new CanonPrinter());
     printerController.print(MESSAGE);
 
@@ -66,7 +66,7 @@ public class DelegateTest {
   }
 
   @Test
-  public void testHpPrinter() throws Exception {
+  void testHpPrinter() throws Exception {
     var printerController = new PrinterController(new HpPrinter());
     printerController.print(MESSAGE);
 
@@ -74,7 +74,7 @@ public class DelegateTest {
   }
 
   @Test
-  public void testEpsonPrinter() throws Exception {
+  void testEpsonPrinter() throws Exception {
     var printerController = new PrinterController(new EpsonPrinter());
     printerController.print(MESSAGE);
 
@@ -84,7 +84,7 @@ public class DelegateTest {
   /**
    * Logging Appender
    */
-  private class InMemoryAppender extends AppenderBase<ILoggingEvent> {
+  private static class InMemoryAppender extends AppenderBase<ILoggingEvent> {
 
     private final List<ILoggingEvent> log = new LinkedList<>();
 
diff --git a/dependency-injection/README.md b/dependency-injection/README.md
index e5bf93387..e03f492c6 100644
--- a/dependency-injection/README.md
+++ b/dependency-injection/README.md
@@ -37,10 +37,9 @@ Wikipedia says
 Let's first introduce the `Tobacco` interface and the concrete brands.
 
 ```java
+@Slf4j
 public abstract class Tobacco {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Tobacco.class);
-
   public void smoke(Wizard wizard) {
     LOGGER.info("{} smoking {}", wizard.getClass().getSimpleName(),
         this.getClass().getSimpleName());
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
index edbe039b9..453af18b1 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedSorceress.java
@@ -23,18 +23,17 @@
 
 package com.iluwatar.dependency.injection;
 
+import lombok.Setter;
+
 /**
  * AdvancedSorceress implements inversion of control. It depends on abstraction that can be injected
  * through its setter.
  */
+@Setter
 public class AdvancedSorceress implements Wizard {
 
   private Tobacco tobacco;
 
-  public void setTobacco(Tobacco tobacco) {
-    this.tobacco = tobacco;
-  }
-
   @Override
   public void smoke() {
     tobacco.smoke(this);
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
index 46758a718..2912f927a 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
@@ -23,18 +23,17 @@
 
 package com.iluwatar.dependency.injection;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * AdvancedWizard implements inversion of control. It depends on abstraction that can be injected
  * through its constructor.
  */
+@RequiredArgsConstructor
 public class AdvancedWizard implements Wizard {
 
   private final Tobacco tobacco;
 
-  public AdvancedWizard(Tobacco tobacco) {
-    this.tobacco = tobacco;
-  }
-
   @Override
   public void smoke() {
     tobacco.smoke(this);
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
index 191655e79..72adf3972 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.dependency.injection;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Tobacco abstraction.
  */
+@Slf4j
 public abstract class Tobacco {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Tobacco.class);
-
   public void smoke(Wizard wizard) {
     LOGGER.info("{} smoking {}", wizard.getClass().getSimpleName(),
         this.getClass().getSimpleName());
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
index d985d5975..3d53c0074 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedSorceressTest.java
@@ -38,17 +38,17 @@ import org.junit.jupiter.api.Test;
  * @author Stanislav Kapinus
  */
 
-public class AdvancedSorceressTest {
+class AdvancedSorceressTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(Tobacco.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -57,7 +57,7 @@ public class AdvancedSorceressTest {
    * her through the setter's parameter
    */
   @Test
-  public void testSmokeEveryThing() throws Exception {
+  void testSmokeEveryThing() throws Exception {
 
     List<Tobacco> tobaccos = List.of(
         new OldTobyTobacco(),
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
index bd5046389..cf8013bae 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AdvancedWizardTest.java
@@ -37,17 +37,17 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class AdvancedWizardTest {
+class AdvancedWizardTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(Tobacco.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -56,7 +56,7 @@ public class AdvancedWizardTest {
    * through the constructor parameter
    */
   @Test
-  public void testSmokeEveryThing() throws Exception {
+  void testSmokeEveryThing() throws Exception {
 
     List<Tobacco> tobaccos = List.of(
         new OldTobyTobacco(),
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
index 658ab2876..2c7988512 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/GuiceWizardTest.java
@@ -38,17 +38,17 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class GuiceWizardTest {
+class GuiceWizardTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(Tobacco.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -57,7 +57,7 @@ public class GuiceWizardTest {
    * through the constructor parameter
    */
   @Test
-  public void testSmokeEveryThingThroughConstructor() throws Exception {
+  void testSmokeEveryThingThroughConstructor() throws Exception {
 
     List<Tobacco> tobaccos = List.of(
         new OldTobyTobacco(),
@@ -82,7 +82,7 @@ public class GuiceWizardTest {
    * through the Guice google inject framework
    */
   @Test
-  public void testSmokeEveryThingThroughInjectionFramework() throws Exception {
+  void testSmokeEveryThingThroughInjectionFramework() throws Exception {
 
     List<Class<? extends Tobacco>> tobaccos = List.of(
         OldTobyTobacco.class,
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
index b67005ad8..f5a4f9235 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/SimpleWizardTest.java
@@ -35,17 +35,17 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class SimpleWizardTest {
+class SimpleWizardTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(Tobacco.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -54,7 +54,7 @@ public class SimpleWizardTest {
    * OldTobyTobacco}
    */
   @Test
-  public void testSmoke() {
+  void testSmoke() {
     final var simpleWizard = new SimpleWizard();
     simpleWizard.smoke();
     assertEquals("SimpleWizard smoking OldTobyTobacco", appender.getLastMessage());
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
index 49c96d3a1..93eb01af2 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/App.java
@@ -25,8 +25,7 @@ package com.iluwatar.dirtyflag;
 
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This application demonstrates the <b>Dirty Flag</b> pattern. The dirty flag behavioral pattern
@@ -51,10 +50,9 @@ import org.slf4j.LoggerFactory;
  * re-fetches from <i>world.txt</i> when needed. {@link World} mainly serves the data to the
  * front-end.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program execution point.
    */
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
index 5d5c981fe..e71dd636f 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/DataFetcher.java
@@ -29,18 +29,16 @@ import java.io.FileReader;
 import java.io.IOException;
 import java.util.List;
 import java.util.stream.Collectors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A mock database manager -- Fetches data from a raw file.
  *
  * @author swaisuan
  */
+@Slf4j
 public class DataFetcher {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DataFetcher.class);
-
   private final String filename = "world.txt";
   private long lastFetched;
 
diff --git a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
index 1c5f7e81f..076653002 100644
--- a/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
+++ b/dirty-flag/src/main/java/com/iluwatar/dirtyflag/World.java
@@ -37,7 +37,7 @@ public class World {
   private final DataFetcher df;
 
   public World() {
-    this.countries = new ArrayList<String>();
+    this.countries = new ArrayList<>();
     this.df = new DataFetcher();
   }
 
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
index 7b510eddd..a2587e1c8 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/App.java
@@ -24,9 +24,8 @@
 package com.iluwatar.doublebuffer;
 
 import java.util.List;
+import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.lang3.tuple.MutablePair;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Double buffering is a term used to describe a device that has two buffers. The usage of multiple
@@ -35,10 +34,9 @@ import org.slf4j.LoggerFactory;
  * separate frame is being buffered to be shown next. This method makes animations and games look
  * more realistic than the same done in a single buffer mode.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program main entry point.
    *
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
index 3e4ba93a4..95891c337 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Pixel.java
@@ -28,12 +28,6 @@ package com.iluwatar.doublebuffer;
  */
 public enum Pixel {
 
-  WHITE(0),
-  BLACK(1);
-
-  private final int color;
-
-  Pixel(int color) {
-    this.color = color;
-  }
+  WHITE,
+  BLACK;
 }
diff --git a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
index 7f6d7fffe..413b15f43 100644
--- a/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
+++ b/double-buffer/src/main/java/com/iluwatar/doublebuffer/Scene.java
@@ -24,17 +24,15 @@
 package com.iluwatar.doublebuffer;
 
 import java.util.List;
+import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.lang3.tuple.Pair;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Scene class. Render the output frame.
  */
+@Slf4j
 public class Scene {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Scene.class);
-
   private final Buffer[] frameBuffers;
 
   private int current;
diff --git a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
index f6e25566f..2e43be3ae 100644
--- a/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
+++ b/double-buffer/src/test/java/com/iluwatar/doublebuffer/AppTest.java
@@ -34,7 +34,7 @@ class AppTest {
 
   /**
    * Issue: Add at least one assertion to this test case.
-   *
+   * <p>
    * Solution: Inserted assertion to check whether the execution of the main method in {@link App#main(String[])}
    * throws an exception.
    */
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
index a61e41550..b74639433 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.doublechecked.locking;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Double Checked Locking is a concurrency design pattern used to reduce the overhead of acquiring a
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * locking to add item to inventory. In this method, the thread which gets the lock first adds the
  * item.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
@@ -63,6 +61,7 @@ public class App {
       executorService.awaitTermination(5, TimeUnit.SECONDS);
     } catch (InterruptedException e) {
       LOGGER.error("Error waiting for ExecutorService shutdown");
+      Thread.currentThread().interrupt();
     }
   }
 }
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
index 735195645..bae88899b 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
@@ -27,16 +27,14 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.concurrent.locks.Lock;
 import java.util.concurrent.locks.ReentrantLock;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Inventory.
  */
+@Slf4j
 public class Inventory {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Inventory.class);
-
   private final int inventorySize;
   private final List<Item> items;
   private final Lock lock;
diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
index 5ecd8ddca..53417786d 100644
--- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
+++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/InventoryTest.java
@@ -47,17 +47,17 @@ import org.slf4j.LoggerFactory;
  *
  * @author Jeroen Meulemeester
  */
-public class InventoryTest {
+class InventoryTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(Inventory.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -79,7 +79,7 @@ public class InventoryTest {
    * item limit.
    */
   @Test
-  public void testAddItem() throws Exception {
+  void testAddItem() throws Exception {
     assertTimeout(ofMillis(10000), () -> {
       // Create a new inventory with a limit of 1000 items and put some load on the add method
       final var inventory = new Inventory(INVENTORY_SIZE);
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
index 0774516c7..e0816b022 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.doubledispatch;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * When a message with a parameter is sent to an object, the resultant behaviour is defined by the
@@ -46,10 +45,9 @@ import org.slf4j.LoggerFactory;
  * coordinates. If there is an overlap, then the objects collide utilizing the Double Dispatch
  * pattern.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
index 58c28c43a..c1f3f8233 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
@@ -24,16 +24,14 @@
 package com.iluwatar.doubledispatch;
 
 import com.iluwatar.doubledispatch.constants.AppConstants;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Meteoroid game object.
  */
+@Slf4j
 public class Meteoroid extends GameObject {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Meteoroid.class);
-
   public Meteoroid(int left, int top, int right, int bottom) {
     super(left, top, right, bottom);
   }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
index 1fbae4635..f448faa8a 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
@@ -23,9 +23,14 @@
 
 package com.iluwatar.doubledispatch;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * Rectangle has coordinates and can be checked for overlap against other Rectangles.
  */
+@Getter
+@RequiredArgsConstructor
 public class Rectangle {
 
   private final int left;
@@ -33,32 +38,6 @@ public class Rectangle {
   private final int right;
   private final int bottom;
 
-  /**
-   * Constructor.
-   */
-  public Rectangle(int left, int top, int right, int bottom) {
-    this.left = left;
-    this.top = top;
-    this.right = right;
-    this.bottom = bottom;
-  }
-
-  public int getLeft() {
-    return left;
-  }
-
-  public int getTop() {
-    return top;
-  }
-
-  public int getRight() {
-    return right;
-  }
-
-  public int getBottom() {
-    return bottom;
-  }
-
   boolean intersectsWith(Rectangle r) {
     return !(r.getLeft() > getRight() || r.getRight() < getLeft() || r.getTop() > getBottom() || r
         .getBottom() < getTop());
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
index 13d0a6d75..27f806bce 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
@@ -24,16 +24,14 @@
 package com.iluwatar.doubledispatch;
 
 import com.iluwatar.doubledispatch.constants.AppConstants;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Space station Mir game object.
  */
+@Slf4j
 public class SpaceStationMir extends GameObject {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SpaceStationMir.class);
-
   public SpaceStationMir(int left, int top, int right, int bottom) {
     super(left, top, right, bottom);
   }
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
index 173f3fcba..bb3c5bdee 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/FlamingAsteroidTest.java
@@ -34,7 +34,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
+class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
 
   @Override
   final FlamingAsteroid getTestedObject() {
@@ -45,7 +45,7 @@ public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
    * Test the constructor parameters
    */
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var asteroid = new FlamingAsteroid(1, 2, 3, 4);
     assertEquals(1, asteroid.getLeft());
     assertEquals(2, asteroid.getTop());
@@ -60,7 +60,7 @@ public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
    * Test what happens we collide with an asteroid
    */
   @Test
-  public void testCollideFlamingAsteroid() {
+  void testCollideFlamingAsteroid() {
     testCollision(
         new FlamingAsteroid(1, 2, 3, 4),
         false, true,
@@ -72,7 +72,7 @@ public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
    * Test what happens we collide with an meteoroid
    */
   @Test
-  public void testCollideMeteoroid() {
+  void testCollideMeteoroid() {
     testCollision(
         new Meteoroid(1, 1, 3, 4),
         false, false,
@@ -84,7 +84,7 @@ public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
    * Test what happens we collide with ISS
    */
   @Test
-  public void testCollideSpaceStationIss() {
+  void testCollideSpaceStationIss() {
     testCollision(
         new SpaceStationIss(1, 1, 3, 4),
         true, true,
@@ -96,7 +96,7 @@ public class FlamingAsteroidTest extends CollisionTest<FlamingAsteroid> {
    * Test what happens we collide with MIR
    */
   @Test
-  public void testCollideSpaceStationMir() {
+  void testCollideSpaceStationMir() {
     testCollision(
         new SpaceStationMir(1, 1, 3, 4),
         true, true,
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
index d49026261..4a715589f 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/MeteoroidTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class MeteoroidTest extends CollisionTest<Meteoroid> {
+class MeteoroidTest extends CollisionTest<Meteoroid> {
 
   @Override
   final Meteoroid getTestedObject() {
@@ -44,7 +44,7 @@ public class MeteoroidTest extends CollisionTest<Meteoroid> {
    * Test the constructor parameters
    */
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var meteoroid = new Meteoroid(1, 2, 3, 4);
     assertEquals(1, meteoroid.getLeft());
     assertEquals(2, meteoroid.getTop());
@@ -59,7 +59,7 @@ public class MeteoroidTest extends CollisionTest<Meteoroid> {
    * Test what happens we collide with an asteroid
    */
   @Test
-  public void testCollideFlamingAsteroid() {
+  void testCollideFlamingAsteroid() {
     testCollision(
         new FlamingAsteroid(1, 1, 3, 4),
         false, true,
@@ -71,7 +71,7 @@ public class MeteoroidTest extends CollisionTest<Meteoroid> {
    * Test what happens we collide with an meteoroid
    */
   @Test
-  public void testCollideMeteoroid() {
+  void testCollideMeteoroid() {
     testCollision(
         new Meteoroid(1, 1, 3, 4),
         false, false,
@@ -83,7 +83,7 @@ public class MeteoroidTest extends CollisionTest<Meteoroid> {
    * Test what happens we collide with ISS
    */
   @Test
-  public void testCollideSpaceStationIss() {
+  void testCollideSpaceStationIss() {
     testCollision(
         new SpaceStationIss(1, 1, 3, 4),
         true, false,
@@ -95,7 +95,7 @@ public class MeteoroidTest extends CollisionTest<Meteoroid> {
    * Test what happens we collide with MIR
    */
   @Test
-  public void testCollideSpaceStationMir() {
+  void testCollideSpaceStationMir() {
     testCollision(
         new SpaceStationMir(1, 1, 3, 4),
         true, false,
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
index 628838dc5..ada5cf9cd 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
@@ -32,13 +32,13 @@ import org.junit.jupiter.api.Test;
 /**
  * Unit test for Rectangle
  */
-public class RectangleTest {
+class RectangleTest {
 
   /**
    * Test if the values passed through the constructor matches the values fetched from the getters
    */
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var rectangle = new Rectangle(1, 2, 3, 4);
     assertEquals(1, rectangle.getLeft());
     assertEquals(2, rectangle.getTop());
@@ -51,7 +51,7 @@ public class RectangleTest {
    * #toString()}
    */
   @Test
-  public void testToString() throws Exception {
+  void testToString() throws Exception {
     final var rectangle = new Rectangle(1, 2, 3, 4);
     assertEquals("[1,2,3,4]", rectangle.toString());
   }
@@ -60,7 +60,7 @@ public class RectangleTest {
    * Test if the {@link Rectangle} class can detect if it intersects with another rectangle.
    */
   @Test
-  public void testIntersection() {
+  void testIntersection() {
     assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(0, 0, 1, 1)));
     assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(-1, -5, 7, 8)));
     assertFalse(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(2, 2, 3, 3)));
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
index 7138160d5..9a6cd78b5 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationIssTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
+class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
 
   @Override
   final SpaceStationIss getTestedObject() {
@@ -44,7 +44,7 @@ public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
    * Test the constructor parameters
    */
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var iss = new SpaceStationIss(1, 2, 3, 4);
     assertEquals(1, iss.getLeft());
     assertEquals(2, iss.getTop());
@@ -59,7 +59,7 @@ public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
    * Test what happens we collide with an asteroid
    */
   @Test
-  public void testCollideFlamingAsteroid() {
+  void testCollideFlamingAsteroid() {
     testCollision(
         new FlamingAsteroid(1, 1, 3, 4),
         false, true,
@@ -71,7 +71,7 @@ public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
    * Test what happens we collide with an meteoroid
    */
   @Test
-  public void testCollideMeteoroid() {
+  void testCollideMeteoroid() {
     testCollision(
         new Meteoroid(1, 1, 3, 4),
         false, false,
@@ -83,7 +83,7 @@ public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
    * Test what happens we collide with ISS
    */
   @Test
-  public void testCollideSpaceStationIss() {
+  void testCollideSpaceStationIss() {
     testCollision(
         new SpaceStationIss(1, 1, 3, 4),
         true, false,
@@ -95,7 +95,7 @@ public class SpaceStationIssTest extends CollisionTest<SpaceStationIss> {
    * Test what happens we collide with MIR
    */
   @Test
-  public void testCollideSpaceStationMir() {
+  void testCollideSpaceStationMir() {
     testCollision(
         new SpaceStationMir(1, 1, 3, 4),
         true, false,
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
index d72f71172..3c4fb7de0 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/SpaceStationMirTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
+class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
 
   @Override
   final SpaceStationMir getTestedObject() {
@@ -44,7 +44,7 @@ public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
    * Test the constructor parameters
    */
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var mir = new SpaceStationMir(1, 2, 3, 4);
     assertEquals(1, mir.getLeft());
     assertEquals(2, mir.getTop());
@@ -59,7 +59,7 @@ public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
    * Test what happens we collide with an asteroid
    */
   @Test
-  public void testCollideFlamingAsteroid() {
+  void testCollideFlamingAsteroid() {
     testCollision(
         new FlamingAsteroid(1, 1, 3, 4),
         false, true,
@@ -71,7 +71,7 @@ public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
    * Test what happens we collide with an meteoroid
    */
   @Test
-  public void testCollideMeteoroid() {
+  void testCollideMeteoroid() {
     testCollision(
         new Meteoroid(1, 1, 3, 4),
         false, false,
@@ -83,7 +83,7 @@ public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
    * Test what happens we collide with ISS
    */
   @Test
-  public void testCollideSpaceStationIss() {
+  void testCollideSpaceStationIss() {
     testCollision(
         new SpaceStationIss(1, 1, 3, 4),
         true, false,
@@ -95,7 +95,7 @@ public class SpaceStationMirTest extends CollisionTest<SpaceStationMir> {
    * Test what happens we collide with MIR
    */
   @Test
-  public void testCollideSpaceStationMir() {
+  void testCollideSpaceStationMir() {
     testCollision(
         new SpaceStationMir(1, 1, 3, 4),
         true, false,
diff --git a/eip-aggregator/pom.xml b/eip-aggregator/pom.xml
index 06733a51e..d06f26262 100644
--- a/eip-aggregator/pom.xml
+++ b/eip-aggregator/pom.xml
@@ -61,11 +61,6 @@
         </dependency>
 
         <!-- Testing -->
-        <dependency>
-            <groupId>com.github.sbrannen</groupId>
-            <artifactId>spring-test-junit5</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
index 17f9ea61d..305201694 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/AggregatorRouteTest.java
@@ -49,7 +49,7 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
 @ActiveProfiles("test")
 @EnableAutoConfiguration
 @ComponentScan
-public class AggregatorRouteTest {
+class AggregatorRouteTest {
 
   @EndpointInject(uri = "{{entry}}")
   private ProducerTemplate entry;
@@ -64,7 +64,7 @@ public class AggregatorRouteTest {
    */
   @Test
   @DirtiesContext
-  public void testSplitter() throws Exception {
+  void testSplitter() throws Exception {
 
     // Three items in one entry message
     entry.sendBody("TEST1");
diff --git a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
index 9279f11eb..40c15b370 100644
--- a/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
+++ b/eip-aggregator/src/test/java/com/iluwatar/eip/aggregator/routes/MessageAggregationStrategyTest.java
@@ -32,10 +32,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests MessageAggregationStrategy
  */
-public class MessageAggregationStrategyTest {
+class MessageAggregationStrategyTest {
 
   @Test
-  public void testAggregate() {
+  void testAggregate() {
     var mas = new MessageAggregationStrategy();
     var oldExchange = new DefaultExchange((CamelContext) null);
     oldExchange.getIn().setBody("TEST1");
@@ -49,7 +49,7 @@ public class MessageAggregationStrategyTest {
   }
 
   @Test
-  public void testAggregateOldNull() {
+  void testAggregateOldNull() {
     var mas = new MessageAggregationStrategy();
 
     var newExchange = new DefaultExchange((CamelContext) null);
diff --git a/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java b/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
index 9d8a4644d..05fe94dba 100644
--- a/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
+++ b/eip-message-channel/src/main/java/com/iluwatar/eip/message/channel/App.java
@@ -23,10 +23,9 @@
 
 package com.iluwatar.eip.message.channel;
 
+import lombok.extern.slf4j.Slf4j;
 import org.apache.camel.builder.RouteBuilder;
 import org.apache.camel.impl.DefaultCamelContext;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * When two applications communicate with each other using a messaging system they first need to
@@ -48,10 +47,9 @@ import org.slf4j.LoggerFactory;
  * Channel is established from the Direct component to console output. No actual messages are sent,
  * only the established routes are printed to standard output.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java b/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
index 3d04c631c..ef586a563 100644
--- a/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
+++ b/eip-publish-subscribe/src/main/java/com/iluwatar/eip/publish/subscribe/App.java
@@ -23,10 +23,9 @@
 
 package com.iluwatar.eip.publish.subscribe;
 
+import lombok.extern.slf4j.Slf4j;
 import org.apache.camel.builder.RouteBuilder;
 import org.apache.camel.impl.DefaultCamelContext;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * There are well-established patterns for implementing broadcasting. The Observer pattern describes
@@ -45,10 +44,9 @@ import org.slf4j.LoggerFactory;
  * <p>In this example we use Apache Camel to establish a Publish-Subscribe Channel from
  * "direct-origin" to "mock:foo", "mock:bar" and "stream:out".
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/eip-splitter/pom.xml b/eip-splitter/pom.xml
index 57c28125a..feda75c58 100644
--- a/eip-splitter/pom.xml
+++ b/eip-splitter/pom.xml
@@ -60,13 +60,7 @@
             <artifactId>jaxb-api</artifactId>
         </dependency>
 
-
         <!-- Testing -->
-        <dependency>
-            <groupId>com.github.sbrannen</groupId>
-            <artifactId>spring-test-junit5</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
index cdd930985..bc48e9ab4 100644
--- a/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
+++ b/eip-splitter/src/test/java/com/iluwatar/eip/splitter/routes/SplitterRouteTest.java
@@ -47,7 +47,7 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
 @ActiveProfiles("test")
 @EnableAutoConfiguration
 @ComponentScan
-public class SplitterRouteTest {
+class SplitterRouteTest {
 
   @EndpointInject(uri = "{{entry}}")
   private ProducerTemplate entry;
@@ -62,7 +62,7 @@ public class SplitterRouteTest {
    */
   @Test
   @DirtiesContext
-  public void testSplitter() throws Exception {
+  void testSplitter() throws Exception {
 
     // Three items in one entry message
     entry.sendBody(new String[]{"TEST1", "TEST2", "TEST3"});
diff --git a/eip-wire-tap/pom.xml b/eip-wire-tap/pom.xml
index 365f793dd..d7c2d1568 100644
--- a/eip-wire-tap/pom.xml
+++ b/eip-wire-tap/pom.xml
@@ -60,13 +60,7 @@
             <artifactId>jaxb-api</artifactId>
         </dependency>
 
-
         <!-- Testing -->
-        <dependency>
-            <groupId>com.github.sbrannen</groupId>
-            <artifactId>spring-test-junit5</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-engine</artifactId>
diff --git a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
index 2323d8bf9..49bb043c4 100644
--- a/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
+++ b/eip-wire-tap/src/test/java/com/iluwatar/eip/wiretap/routes/WireTapRouteTest.java
@@ -49,7 +49,7 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
 @ActiveProfiles("test")
 @EnableAutoConfiguration
 @ComponentScan
-public class WireTapRouteTest {
+class WireTapRouteTest {
 
   @EndpointInject(uri = "{{entry}}")
   private ProducerTemplate entry;
@@ -67,7 +67,7 @@ public class WireTapRouteTest {
    */
   @Test
   @DirtiesContext
-  public void testWireTap() throws Exception {
+  void testWireTap() throws Exception {
     entry.sendBody("TEST");
 
     endpoint.expectedMessageCount(1);
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
index be74d14e6..61b9d713a 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
@@ -23,20 +23,21 @@
 
 package com.iluwatar.event.aggregator;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Event enumeration.
  */
+@RequiredArgsConstructor
 public enum Event {
 
-  STARK_SIGHTED("Stark sighted"), WARSHIPS_APPROACHING("Warships approaching"), TRAITOR_DETECTED(
-      "Traitor detected");
+  STARK_SIGHTED("Stark sighted"),
+  WARSHIPS_APPROACHING("Warships approaching"),
+  TRAITOR_DETECTED("Traitor detected");
 
   private final String description;
 
-  Event(String description) {
-    this.description = description;
-  }
-
+  @Override
   public String toString() {
     return description;
   }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
index 014ca89c0..55666451b 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.event.aggregator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * KingJoffrey observes events from {@link KingsHand}.
  */
+@Slf4j
 public class KingJoffrey implements EventObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(KingJoffrey.class);
-
   @Override
   public void onEvent(Event e) {
     LOGGER.info("Received event from the King's Hand: {}", e.toString());
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
index fcd367e25..0f93a90db 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
@@ -23,9 +23,12 @@
 
 package com.iluwatar.event.aggregator;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Weekday enumeration.
  */
+@RequiredArgsConstructor
 public enum Weekday {
 
   MONDAY("Monday"),
@@ -38,10 +41,7 @@ public enum Weekday {
 
   private final String description;
 
-  Weekday(String description) {
-    this.description = description;
-  }
-
+  @Override
   public String toString() {
     return description;
   }
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
index dcf1c71e3..1378ead9e 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventEmitterTest.java
@@ -41,7 +41,7 @@ import org.junit.jupiter.api.Test;
  * @param <E> Type of Event Emitter
  * @author Jeroen Meulemeester
  */
-public abstract class EventEmitterTest<E extends EventEmitter> {
+abstract class EventEmitterTest<E extends EventEmitter> {
 
   /**
    * Factory used to create a new instance of the test object with a default observer
@@ -81,7 +81,7 @@ public abstract class EventEmitterTest<E extends EventEmitter> {
    * is executed twice, once without a default emitter and once with
    */
   @Test
-  public void testAllDays() {
+  void testAllDays() {
     testAllDaysWithoutDefaultObserver(specialDay, event);
     testAllDaysWithDefaultObserver(specialDay, event);
   }
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
index 891bbd10c..38e621acf 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/EventTest.java
@@ -34,13 +34,13 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class EventTest {
+class EventTest {
 
   /**
    * Verify if every event has a non-null, non-empty description
    */
   @Test
-  public void testToString() {
+  void testToString() {
     Arrays.stream(Event.values()).map(Event::toString).forEach(toString -> {
       assertNotNull(toString);
       assertFalse(toString.trim().isEmpty());
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
index deb468e40..6195ac0bf 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingJoffreyTest.java
@@ -41,17 +41,17 @@ import org.slf4j.LoggerFactory;
  *
  * @author Jeroen Meulemeester
  */
-public class KingJoffreyTest {
+class KingJoffreyTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender(KingJoffrey.class);
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -59,7 +59,7 @@ public class KingJoffreyTest {
    * Test if {@link KingJoffrey} tells us what event he received
    */
   @Test
-  public void testOnEvent() {
+  void testOnEvent() {
     final var kingJoffrey = new KingJoffrey();
 
     IntStream.range(0, Event.values().length).forEach(i -> {
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
index 8a8d4eaef..51229b155 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/KingsHandTest.java
@@ -38,7 +38,7 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class KingsHandTest extends EventEmitterTest<KingsHand> {
+class KingsHandTest extends EventEmitterTest<KingsHand> {
 
   /**
    * Create a new test instance, using the correct object factory
@@ -53,7 +53,7 @@ public class KingsHandTest extends EventEmitterTest<KingsHand> {
    * just a mocked observer.
    */
   @Test
-  public void testPassThrough() throws Exception {
+  void testPassThrough() throws Exception {
     final var observer = mock(EventObserver.class);
     final var kingsHand = new KingsHand(observer);
 
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
index 5fe55f136..e227c80d7 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordBaelishTest.java
@@ -28,7 +28,7 @@ package com.iluwatar.event.aggregator;
  *
  * @author Jeroen Meulemeester
  */
-public class LordBaelishTest extends EventEmitterTest<LordBaelish> {
+class LordBaelishTest extends EventEmitterTest<LordBaelish> {
 
   /**
    * Create a new test instance, using the correct object factory
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
index c00c9002e..d0dcd42bd 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/LordVarysTest.java
@@ -28,7 +28,7 @@ package com.iluwatar.event.aggregator;
  *
  * @author Jeroen Meulemeester
  */
-public class LordVarysTest extends EventEmitterTest<LordVarys> {
+class LordVarysTest extends EventEmitterTest<LordVarys> {
 
   /**
    * Create a new test instance, using the correct object factory
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
index 90bb8e45c..3a13869d2 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/ScoutTest.java
@@ -28,7 +28,7 @@ package com.iluwatar.event.aggregator;
  *
  * @author Jeroen Meulemeester
  */
-public class ScoutTest extends EventEmitterTest<Scout> {
+class ScoutTest extends EventEmitterTest<Scout> {
 
   /**
    * Create a new test instance, using the correct object factory
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
index 47d1d015e..e3bae241d 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/WeekdayTest.java
@@ -34,10 +34,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class WeekdayTest {
+class WeekdayTest {
 
   @Test
-  public void testToString() {
+  void testToString() {
     Arrays.stream(Weekday.values()).forEach(weekday -> {
       final String toString = weekday.toString();
       assertNotNull(toString);
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
index 79159314f..fd7282fc2 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.event.asynchronous;
 import java.io.IOException;
 import java.util.Properties;
 import java.util.Scanner;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This application demonstrates the <b>Event-based Asynchronous</b> pattern. Essentially, users (of
@@ -55,10 +54,9 @@ import org.slf4j.LoggerFactory;
  * @see EventManager
  * @see Event
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   public static final String PROP_FILE_NAME = "config.properties";
 
   boolean interactiveMode = false;
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
index 323689e5d..77d6ab8c4 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/Event.java
@@ -23,40 +23,25 @@
 
 package com.iluwatar.event.asynchronous;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Each Event runs as a separate/individual thread.
  */
+@Slf4j
+@RequiredArgsConstructor
 public class Event implements IEvent, Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Event.class);
-
   private final int eventId;
   private final int eventTime;
-  private final boolean isSynchronous;
+  @Getter
+  private final boolean synchronous;
   private Thread thread;
   private boolean isComplete = false;
   private ThreadCompleteListener eventListener;
 
-  /**
-   * Constructor.
-   *
-   * @param eventId       event ID
-   * @param eventTime     event time
-   * @param isSynchronous is of synchronous type
-   */
-  public Event(final int eventId, final int eventTime, final boolean isSynchronous) {
-    this.eventId = eventId;
-    this.eventTime = eventTime;
-    this.isSynchronous = isSynchronous;
-  }
-
-  public boolean isSynchronous() {
-    return isSynchronous;
-  }
-
   @Override
   public void start() {
     thread = new Thread(this);
@@ -88,6 +73,7 @@ public class Event implements IEvent, Runnable {
       try {
         Thread.sleep(1000); // Sleep for 1 second.
       } catch (InterruptedException e) {
+        Thread.currentThread().interrupt();
         return;
       }
     }
diff --git a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
index abd3e9be4..dd83e23a9 100644
--- a/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
+++ b/event-asynchronous/src/main/java/com/iluwatar/event/asynchronous/EventManager.java
@@ -53,7 +53,7 @@ public class EventManager implements ThreadCompleteListener {
    */
   public EventManager() {
     rand = new SecureRandom();
-    eventPool = new ConcurrentHashMap<Integer, Event>(MAX_RUNNING_EVENTS);
+    eventPool = new ConcurrentHashMap<>(MAX_RUNNING_EVENTS);
 
   }
 
diff --git a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
index a590d2be8..9ece86a7a 100644
--- a/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
+++ b/event-asynchronous/src/test/java/com/iluwatar/event/asynchronous/EventAsynchronousTest.java
@@ -35,11 +35,11 @@ import org.slf4j.LoggerFactory;
 /**
  * Application test
  */
-public class EventAsynchronousTest {
+class EventAsynchronousTest {
   private static final Logger LOGGER = LoggerFactory.getLogger(EventAsynchronousTest.class);
 
   @Test
-  public void testAsynchronousEvent() {
+  void testAsynchronousEvent() {
     var eventManager = new EventManager();
     try {
       var aEventId = eventManager.createAsync(60);
@@ -55,7 +55,7 @@ public class EventAsynchronousTest {
   }
 
   @Test
-  public void testSynchronousEvent() {
+  void testSynchronousEvent() {
     var eventManager = new EventManager();
     try {
       var sEventId = eventManager.create(60);
@@ -72,7 +72,7 @@ public class EventAsynchronousTest {
   }
 
   @Test
-  public void testUnsuccessfulSynchronousEvent() {
+  void testUnsuccessfulSynchronousEvent() {
     assertThrows(InvalidOperationException.class, () -> {
       var eventManager = new EventManager();
       try {
@@ -87,7 +87,7 @@ public class EventAsynchronousTest {
   }
 
   @Test
-  public void testFullSynchronousEvent() {
+  void testFullSynchronousEvent() {
     var eventManager = new EventManager();
     try {
       var eventTime = 1;
@@ -110,7 +110,7 @@ public class EventAsynchronousTest {
   }
 
   @Test
-  public void testFullAsynchronousEvent() {
+  void testFullAsynchronousEvent() {
     var eventManager = new EventManager();
     try {
       var eventTime = 1;
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
index 9b11125dd..0a50be401 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserCreatedEvent.java
@@ -24,21 +24,17 @@
 package com.iluwatar.eda.event;
 
 import com.iluwatar.eda.model.User;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * The {@link UserCreatedEvent} should should be dispatched whenever a user has been created. This
  * class can be extended to contain details about the user has been created. In this example, the
  * entire {@link User} object is passed on as data with the event.
  */
+@RequiredArgsConstructor
+@Getter
 public class UserCreatedEvent extends AbstractEvent {
 
   private final User user;
-
-  public UserCreatedEvent(User user) {
-    this.user = user;
-  }
-
-  public User getUser() {
-    return user;
-  }
 }
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
index 6df09f97d..beab7fbf8 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/event/UserUpdatedEvent.java
@@ -24,21 +24,17 @@
 package com.iluwatar.eda.event;
 
 import com.iluwatar.eda.model.User;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * The {@link UserUpdatedEvent} should should be dispatched whenever a user has been updated. This
  * class can be extended to contain details about the user has been updated. In this example, the
  * entire {@link User} object is passed on as data with the event.
  */
+@RequiredArgsConstructor
+@Getter
 public class UserUpdatedEvent extends AbstractEvent {
 
   private final User user;
-
-  public UserUpdatedEvent(User user) {
-    this.user = user;
-  }
-
-  public User getUser() {
-    return user;
-  }
 }
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
index e8805d90f..793ace392 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserCreatedEventHandler.java
@@ -25,16 +25,14 @@ package com.iluwatar.eda.handler;
 
 import com.iluwatar.eda.event.UserCreatedEvent;
 import com.iluwatar.eda.framework.Handler;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Handles the {@link UserCreatedEvent} message.
  */
+@Slf4j
 public class UserCreatedEventHandler implements Handler<UserCreatedEvent> {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(UserCreatedEventHandler.class);
-
   @Override
   public void onEvent(UserCreatedEvent event) {
     LOGGER.info("User '{}' has been Created!", event.getUser().getUsername());
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
index ee2b64ac0..976c6ab46 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/handler/UserUpdatedEventHandler.java
@@ -25,16 +25,14 @@ package com.iluwatar.eda.handler;
 
 import com.iluwatar.eda.event.UserUpdatedEvent;
 import com.iluwatar.eda.framework.Handler;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Handles the {@link UserUpdatedEvent} message.
  */
+@Slf4j
 public class UserUpdatedEventHandler implements Handler<UserUpdatedEvent> {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(UserUpdatedEventHandler.class);
-
   @Override
   public void onEvent(UserUpdatedEvent event) {
     LOGGER.info("User '{}' has been Updated!", event.getUser().getUsername());
diff --git a/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java b/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
index 43bd8da49..4d28c7605 100644
--- a/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
+++ b/event-driven-architecture/src/main/java/com/iluwatar/eda/model/User.java
@@ -25,20 +25,16 @@ package com.iluwatar.eda.model;
 
 import com.iluwatar.eda.event.UserCreatedEvent;
 import com.iluwatar.eda.event.UserUpdatedEvent;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * This {@link User} class is a basic pojo used to demonstrate user data sent along with the {@link
  * UserCreatedEvent} and {@link UserUpdatedEvent} events.
  */
+@RequiredArgsConstructor
+@Getter
 public class User {
 
   private final String username;
-
-  public User(String username) {
-    this.username = username;
-  }
-
-  public String getUsername() {
-    return username;
-  }
 }
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
index 97c368513..67e420fd0 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/event/UserCreatedEventTest.java
@@ -31,14 +31,14 @@ import org.junit.jupiter.api.Test;
 /**
  * {@link UserCreatedEventTest} tests and verifies {@link AbstractEvent} behaviour.
  */
-public class UserCreatedEventTest {
+class UserCreatedEventTest {
 
   /**
    * This unit test should correctly return the {@link AbstractEvent} class type when calling the
    * {@link AbstractEvent#getType() getType} method.
    */
   @Test
-  public void testGetEventType() {
+  void testGetEventType() {
     var user = new User("iluwatar");
     var userCreatedEvent = new UserCreatedEvent(user);
     assertEquals(UserCreatedEvent.class, userCreatedEvent.getType());
diff --git a/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java b/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
index 7d0fb2346..1283aab1c 100644
--- a/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
+++ b/event-driven-architecture/src/test/java/com/iluwatar/eda/framework/EventDispatcherTest.java
@@ -36,14 +36,14 @@ import org.junit.jupiter.api.Test;
 /**
  * Event Dispatcher unit tests to assert and verify correct event dispatcher behaviour
  */
-public class EventDispatcherTest {
+class EventDispatcherTest {
 
   /**
    * This unit test should register events and event handlers correctly with the event dispatcher
    * and events should be dispatched accordingly.
    */
   @Test
-  public void testEventDriverPattern() {
+  void testEventDriverPattern() {
 
     var dispatcher = spy(new EventDispatcher());
     var userCreatedEventHandler = spy(new UserCreatedEventHandler());
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/App.java b/event-queue/src/main/java/com/iluwatar/event/queue/App.java
index 2987d0e06..8d779623d 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/App.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/App.java
@@ -27,8 +27,7 @@ import java.io.BufferedReader;
 import java.io.IOException;
 import java.io.InputStreamReader;
 import javax.sound.sampled.UnsupportedAudioFileException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Event or message queues provide an asynchronous communications protocol, meaning that the sender
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * enqueues the request and returns. The request processor then processes items from the queue at a
  * later time.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java b/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
index 1b97095c7..7d7bf2a34 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/Audio.java
@@ -29,16 +29,15 @@ import javax.sound.sampled.AudioInputStream;
 import javax.sound.sampled.AudioSystem;
 import javax.sound.sampled.LineUnavailableException;
 import javax.sound.sampled.UnsupportedAudioFileException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This class implements the Event Queue pattern.
  *
  * @author mkuprivecz
  */
+@Slf4j
 public class Audio {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Audio.class);
   private static final Audio INSTANCE = new Audio();
 
   private static final int MAX_PENDING = 16;
diff --git a/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java b/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
index da462c74c..4364483bd 100644
--- a/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
+++ b/event-queue/src/main/java/com/iluwatar/event/queue/PlayMessage.java
@@ -24,36 +24,22 @@
 package com.iluwatar.event.queue;
 
 import javax.sound.sampled.AudioInputStream;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import lombok.Setter;
 
 /**
  * The Event Queue's queue will store the instances of this class.
  *
  * @author mkuprivecz
  */
+@Getter
+@AllArgsConstructor
 public class PlayMessage {
 
-  private AudioInputStream stream;
+  private final AudioInputStream stream;
 
+  @Setter
   private float volume;
 
-  public PlayMessage(AudioInputStream stream, float volume) {
-    setStream(stream);
-    setVolume(volume);
-  }
-
-  public AudioInputStream getStream() {
-    return stream;
-  }
-
-  private void setStream(AudioInputStream stream) {
-    this.stream = stream;
-  }
-
-  public float getVolume() {
-    return volume;
-  }
-
-  public void setVolume(float volume) {
-    this.volume = volume;
-  }
 }
diff --git a/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java b/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
index bfe16c839..9e2cdcbc6 100644
--- a/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
+++ b/event-queue/src/test/java/com/iluwatar/event/queue/AudioTest.java
@@ -23,22 +23,21 @@
 
 package com.iluwatar.event.queue;
 
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-
-import javax.sound.sampled.UnsupportedAudioFileException;
-import java.io.IOException;
-
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+import java.io.IOException;
+import javax.sound.sampled.UnsupportedAudioFileException;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
 
 /**
  * Testing the Audio service of the Queue
  * @author mkuprivecz
  *
  */
-public class AudioTest {
+class AudioTest {
 
   private Audio audio;
 
@@ -46,6 +45,7 @@ public class AudioTest {
   void createAudioInstance() {
     audio = new Audio();
   }
+
   /**
    * Test here that the playSound method works correctly
    * @throws UnsupportedAudioFileException when the audio file is not supported 
@@ -53,7 +53,7 @@ public class AudioTest {
    * @throws InterruptedException when the test is interrupted externally
    */
   @Test
-  public void testPlaySound() throws UnsupportedAudioFileException, IOException, InterruptedException {
+  void testPlaySound() throws UnsupportedAudioFileException, IOException, InterruptedException {
     audio.playSound(audio.getAudioStream("./etc/Bass-Drum-1.wav"), -10.0f);
     // test that service is started
     assertTrue(audio.isServiceRunning());
@@ -72,7 +72,7 @@ public class AudioTest {
    * @throws InterruptedException when the test is interrupted externally
    */
   @Test
-  public void testQueue() throws UnsupportedAudioFileException, IOException, InterruptedException {
+  void testQueue() throws UnsupportedAudioFileException, IOException, InterruptedException {
     audio.playSound(audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f);
     audio.playSound(audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f);
     audio.playSound(audio.getAudioStream("./etc/Bass-Drum-1.aif"), -10.0f);
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
index dd67366ee..6635dddf7 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/app/App.java
@@ -30,8 +30,7 @@ import com.iluwatar.event.sourcing.processor.DomainEventProcessor;
 import com.iluwatar.event.sourcing.state.AccountAggregate;
 import java.math.BigDecimal;
 import java.util.Date;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Event Sourcing : Instead of storing just the current state of the data in a domain, use an
@@ -50,9 +49,8 @@ import org.slf4j.LoggerFactory;
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Slf4j
 public class App {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
   /**
    * The constant ACCOUNT OF DAENERYS.
    */
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
index bb4ba7e12..3f4945d1b 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/domain/Account.java
@@ -28,8 +28,10 @@ import com.iluwatar.event.sourcing.event.MoneyDepositEvent;
 import com.iluwatar.event.sourcing.event.MoneyTransferEvent;
 import com.iluwatar.event.sourcing.state.AccountAggregate;
 import java.math.BigDecimal;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This is the Account class that holds the account info, the account number, account owner name and
@@ -38,66 +40,19 @@ import org.slf4j.LoggerFactory;
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Setter
+@Getter
+@RequiredArgsConstructor
+@Slf4j
 public class Account {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Account.class);
-
   private final int accountNo;
   private final String owner;
-  private BigDecimal money;
+  private BigDecimal money = BigDecimal.ZERO;
 
   private static final String MSG =
       "Some external api for only realtime execution could be called here.";
 
-  /**
-   * Instantiates a new Account.
-   *
-   * @param accountNo the account no
-   * @param owner     the owner
-   */
-  public Account(int accountNo, String owner) {
-    this.accountNo = accountNo;
-    this.owner = owner;
-    money = BigDecimal.ZERO;
-  }
-
-  /**
-   * Gets account no.
-   *
-   * @return the account no
-   */
-  public int getAccountNo() {
-    return accountNo;
-  }
-
-  /**
-   * Gets owner.
-   *
-   * @return the owner
-   */
-  public String getOwner() {
-    return owner;
-  }
-
-  /**
-   * Gets money.
-   *
-   * @return the money
-   */
-  public BigDecimal getMoney() {
-    return money;
-  }
-
-  /**
-   * Sets money.
-   *
-   * @param money the money
-   */
-  public void setMoney(BigDecimal money) {
-    this.money = money;
-  }
-
-
   /**
    * Copy account.
    *
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
index 1d7b042dd..0845590eb 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/AccountCreateEvent.java
@@ -25,6 +25,7 @@ package com.iluwatar.event.sourcing.event;
 
 import com.iluwatar.event.sourcing.domain.Account;
 import com.iluwatar.event.sourcing.state.AccountAggregate;
+import lombok.Getter;
 
 /**
  * This is the class that implements account create event. Holds the necessary info for an account
@@ -33,6 +34,7 @@ import com.iluwatar.event.sourcing.state.AccountAggregate;
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Getter
 public class AccountCreateEvent extends DomainEvent {
 
   private final int accountNo;
@@ -52,24 +54,6 @@ public class AccountCreateEvent extends DomainEvent {
     this.owner = owner;
   }
 
-  /**
-   * Gets account no.
-   *
-   * @return the account no
-   */
-  public int getAccountNo() {
-    return accountNo;
-  }
-
-  /**
-   * Gets owner.
-   *
-   * @return the owner
-   */
-  public String getOwner() {
-    return owner;
-  }
-
   @Override
   public void process() {
     var account = AccountAggregate.getAccount(accountNo);
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
index 059970f6d..05c0c2173 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/DomainEvent.java
@@ -24,12 +24,18 @@
 package com.iluwatar.event.sourcing.event;
 
 import java.io.Serializable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.Setter;
 
 /**
  * This is the base class for domain events. All events must extend this class.
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Setter
+@Getter
+@RequiredArgsConstructor
 public abstract class DomainEvent implements Serializable {
 
   private final long sequenceId;
@@ -37,66 +43,9 @@ public abstract class DomainEvent implements Serializable {
   private final String eventClassName;
   private boolean realTime = true;
 
-  /**
-   * Instantiates a new Domain event.
-   *
-   * @param sequenceId     the sequence id
-   * @param createdTime    the created time
-   * @param eventClassName the event class name
-   */
-  public DomainEvent(long sequenceId, long createdTime, String eventClassName) {
-    this.sequenceId = sequenceId;
-    this.createdTime = createdTime;
-    this.eventClassName = eventClassName;
-  }
-
-  /**
-   * Gets sequence id.
-   *
-   * @return the sequence id
-   */
-  public long getSequenceId() {
-    return sequenceId;
-  }
-
-  /**
-   * Gets created time.
-   *
-   * @return the created time
-   */
-  public long getCreatedTime() {
-    return createdTime;
-  }
-
-  /**
-   * Is real time boolean.
-   *
-   * @return the boolean
-   */
-  public boolean isRealTime() {
-    return realTime;
-  }
-
-  /**
-   * Sets real time.
-   *
-   * @param realTime the real time
-   */
-  public void setRealTime(boolean realTime) {
-    this.realTime = realTime;
-  }
-
   /**
    * Process.
    */
   public abstract void process();
 
-  /**
-   * Gets event class name.
-   *
-   * @return the event class name
-   */
-  public String getEventClassName() {
-    return eventClassName;
-  }
 }
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
index 9acf0d506..27bcd15b7 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyDepositEvent.java
@@ -26,6 +26,7 @@ package com.iluwatar.event.sourcing.event;
 import com.iluwatar.event.sourcing.state.AccountAggregate;
 import java.math.BigDecimal;
 import java.util.Optional;
+import lombok.Getter;
 
 /**
  * This is the class that implements money deposit event. Holds the necessary info for a money
@@ -34,6 +35,7 @@ import java.util.Optional;
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Getter
 public class MoneyDepositEvent extends DomainEvent {
 
   private final BigDecimal money;
@@ -53,24 +55,6 @@ public class MoneyDepositEvent extends DomainEvent {
     this.accountNo = accountNo;
   }
 
-  /**
-   * Gets money.
-   *
-   * @return the money
-   */
-  public BigDecimal getMoney() {
-    return money;
-  }
-
-  /**
-   * Gets account no.
-   *
-   * @return the account no
-   */
-  public int getAccountNo() {
-    return accountNo;
-  }
-
   @Override
   public void process() {
     var account = Optional.ofNullable(AccountAggregate.getAccount(accountNo))
diff --git a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
index b76f8e22f..51f0a23b1 100644
--- a/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
+++ b/event-sourcing/src/main/java/com/iluwatar/event/sourcing/event/MoneyTransferEvent.java
@@ -26,6 +26,7 @@ package com.iluwatar.event.sourcing.event;
 import com.iluwatar.event.sourcing.state.AccountAggregate;
 import java.math.BigDecimal;
 import java.util.Optional;
+import lombok.Getter;
 
 /**
  * This is the class that implements money transfer event. Holds the necessary info for a money
@@ -34,6 +35,7 @@ import java.util.Optional;
  *
  * <p>Created by Serdar Hamzaogullari on 06.08.2017.
  */
+@Getter
 public class MoneyTransferEvent extends DomainEvent {
 
   private final BigDecimal money;
@@ -57,33 +59,6 @@ public class MoneyTransferEvent extends DomainEvent {
     this.accountNoTo = accountNoTo;
   }
 
-  /**
-   * Gets money.
-   *
-   * @return the money
-   */
-  public BigDecimal getMoney() {
-    return money;
-  }
-
-  /**
-   * Gets account no which the money comes from.
-   *
-   * @return the account no from
-   */
-  public int getAccountNoFrom() {
-    return accountNoFrom;
-  }
-
-  /**
-   * Gets account no which the money goes to.
-   *
-   * @return the account no to
-   */
-  public int getAccountNoTo() {
-    return accountNoTo;
-  }
-
   @Override
   public void process() {
     var accountFrom = Optional.ofNullable(AccountAggregate.getAccount(accountNoFrom))
diff --git a/event-sourcing/src/test/java/IntegrationTest.java b/event-sourcing/src/test/java/IntegrationTest.java
index dfa405809..1530e6e17 100644
--- a/event-sourcing/src/test/java/IntegrationTest.java
+++ b/event-sourcing/src/test/java/IntegrationTest.java
@@ -40,7 +40,7 @@ import org.junit.jupiter.api.Test;
  * <p>
  * Created by Serdar Hamzaogullari on 19.08.2017.
  */
-public class IntegrationTest {
+class IntegrationTest {
 
   /**
    * The Domain event processor.
@@ -51,7 +51,7 @@ public class IntegrationTest {
    * Initialize.
    */
   @BeforeEach
-  public void initialize() {
+  void initialize() {
     eventProcessor = new DomainEventProcessor();
   }
 
@@ -59,7 +59,7 @@ public class IntegrationTest {
    * Test state recovery.
    */
   @Test
-  public void testStateRecovery() {
+  void testStateRecovery() {
     eventProcessor.reset();
 
     eventProcessor.process(new AccountCreateEvent(
diff --git a/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
index 621dccee6..a927ab246 100644
--- a/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
+++ b/execute-around/src/test/java/com/iluwatar/execute/around/SimpleFileWriterTest.java
@@ -42,19 +42,19 @@ import org.junit.rules.TemporaryFolder;
  * @author Jeroen Meulemeester
  */
 @EnableRuleMigrationSupport
-public class SimpleFileWriterTest {
+class SimpleFileWriterTest {
 
   @Rule
   public final TemporaryFolder testFolder = new TemporaryFolder();
 
   @Test
-  public void testWriterNotNull() throws Exception {
+  void testWriterNotNull() throws Exception {
     final var temporaryFile = this.testFolder.newFile();
     new SimpleFileWriter(temporaryFile.getPath(), Assertions::assertNotNull);
   }
 
   @Test
-  public void testCreatesNonExistentFile() throws Exception {
+  void testCreatesNonExistentFile() throws Exception {
     final var nonExistingFile = new File(this.testFolder.getRoot(), "non-existing-file");
     assertFalse(nonExistingFile.exists());
 
@@ -63,7 +63,7 @@ public class SimpleFileWriterTest {
   }
 
   @Test
-  public void testContentsAreWrittenToFile() throws Exception {
+  void testContentsAreWrittenToFile() throws Exception {
     final var testMessage = "Test message";
 
     final var temporaryFile = this.testFolder.newFile();
@@ -74,7 +74,7 @@ public class SimpleFileWriterTest {
   }
 
   @Test
-  public void testRipplesIoExceptionOccurredWhileWriting() {
+  void testRipplesIoExceptionOccurredWhileWriting() {
     var message = "Some error";
     assertThrows(IOException.class, () -> {
       final var temporaryFile = this.testFolder.newFile();
diff --git a/extension-objects/src/main/java/concreteextensions/Commander.java b/extension-objects/src/main/java/concreteextensions/Commander.java
index 6981d303c..24d8351fc 100644
--- a/extension-objects/src/main/java/concreteextensions/Commander.java
+++ b/extension-objects/src/main/java/concreteextensions/Commander.java
@@ -24,29 +24,24 @@
 package concreteextensions;
 
 import abstractextensions.CommanderExtension;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import units.CommanderUnit;
 
 /**
  * Class defining Commander.
  */
+@Getter
+@RequiredArgsConstructor
+@Slf4j
 public class Commander implements CommanderExtension {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Commander.class);
-
   private final CommanderUnit unit;
 
-  public Commander(CommanderUnit commanderUnit) {
-    this.unit = commanderUnit;
-  }
-
   @Override
   public void commanderReady() {
     LOGGER.info("[Commander] " + unit.getName() + " is ready!");
   }
 
-  public CommanderUnit getUnit() {
-    return unit;
-  }
 }
diff --git a/extension-objects/src/main/java/concreteextensions/Sergeant.java b/extension-objects/src/main/java/concreteextensions/Sergeant.java
index 97dc80443..0f10466f2 100644
--- a/extension-objects/src/main/java/concreteextensions/Sergeant.java
+++ b/extension-objects/src/main/java/concreteextensions/Sergeant.java
@@ -24,29 +24,24 @@
 package concreteextensions;
 
 import abstractextensions.SergeantExtension;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import units.SergeantUnit;
 
 /**
  * Class defining Sergeant.
  */
+@Getter
+@RequiredArgsConstructor
+@Slf4j
 public class Sergeant implements SergeantExtension {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Sergeant.class);
-
   private final SergeantUnit unit;
 
-  public Sergeant(SergeantUnit sergeantUnit) {
-    this.unit = sergeantUnit;
-  }
-
   @Override
   public void sergeantReady() {
     LOGGER.info("[Sergeant] " + unit.getName() + " is ready!");
   }
 
-  public SergeantUnit getUnit() {
-    return unit;
-  }
 }
diff --git a/extension-objects/src/main/java/concreteextensions/Soldier.java b/extension-objects/src/main/java/concreteextensions/Soldier.java
index 65f50f254..74b45089b 100644
--- a/extension-objects/src/main/java/concreteextensions/Soldier.java
+++ b/extension-objects/src/main/java/concreteextensions/Soldier.java
@@ -24,28 +24,24 @@
 package concreteextensions;
 
 import abstractextensions.SoldierExtension;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import units.SoldierUnit;
 
 /**
  * Class defining Soldier.
  */
+@Getter
+@RequiredArgsConstructor
+@Slf4j
 public class Soldier implements SoldierExtension {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Soldier.class);
 
   private final SoldierUnit unit;
 
-  public Soldier(SoldierUnit soldierUnit) {
-    this.unit = soldierUnit;
-  }
-
   @Override
   public void soldierReady() {
     LOGGER.info("[Soldier] " + unit.getName() + " is ready!");
   }
 
-  public SoldierUnit getUnit() {
-    return unit;
-  }
 }
diff --git a/extension-objects/src/main/java/units/Unit.java b/extension-objects/src/main/java/units/Unit.java
index 799a473a4..4847ec06a 100644
--- a/extension-objects/src/main/java/units/Unit.java
+++ b/extension-objects/src/main/java/units/Unit.java
@@ -24,10 +24,14 @@
 package units;
 
 import abstractextensions.UnitExtension;
+import lombok.Getter;
+import lombok.Setter;
 
 /**
  * Class defining Unit, other units will extend this class.
  */
+@Setter
+@Getter
 public class Unit {
 
   private String name;
@@ -37,14 +41,6 @@ public class Unit {
     this.name = name;
   }
 
-  public String getName() {
-    return name;
-  }
-
-  public void setName(String name) {
-    this.name = name;
-  }
-
   public UnitExtension getUnitExtension(String extensionName) {
     return null;
   }
diff --git a/extension-objects/src/test/java/concreteextensions/CommanderTest.java b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
index 4378131e6..79e219588 100644
--- a/extension-objects/src/test/java/concreteextensions/CommanderTest.java
+++ b/extension-objects/src/test/java/concreteextensions/CommanderTest.java
@@ -57,9 +57,9 @@ class CommanderTest {
 
     List<ILoggingEvent> logsList = listAppender.list;
     assertEquals("[Commander] " + commander.getUnit().getName() + " is ready!", logsList.get(0)
-            .getMessage());
+        .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
-            .getLevel());
+        .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/concreteextensions/SergeantTest.java b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
index 0d24d0fe3..8b59c3b48 100644
--- a/extension-objects/src/test/java/concreteextensions/SergeantTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SergeantTest.java
@@ -55,9 +55,9 @@ class SergeantTest {
 
     List<ILoggingEvent> logsList = listAppender.list;
     assertEquals("[Sergeant] " + sergeant.getUnit().getName() + " is ready!", logsList.get(0)
-            .getMessage());
+        .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
-            .getLevel());
+        .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/concreteextensions/SoldierTest.java b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
index 48af362c1..6286bf7a8 100644
--- a/extension-objects/src/test/java/concreteextensions/SoldierTest.java
+++ b/extension-objects/src/test/java/concreteextensions/SoldierTest.java
@@ -55,9 +55,9 @@ class SoldierTest {
 
     List<ILoggingEvent> logsList = listAppender.list;
     assertEquals("[Soldier] " + soldier.getUnit().getName() + " is ready!", logsList.get(0)
-            .getMessage());
+        .getMessage());
     assertEquals(Level.INFO, logsList.get(0)
-            .getLevel());
+        .getLevel());
   }
 
 }
\ No newline at end of file
diff --git a/extension-objects/src/test/java/units/CommanderUnitTest.java b/extension-objects/src/test/java/units/CommanderUnitTest.java
index 11fc84240..e15106c90 100644
--- a/extension-objects/src/test/java/units/CommanderUnitTest.java
+++ b/extension-objects/src/test/java/units/CommanderUnitTest.java
@@ -31,9 +31,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class CommanderUnitTest {
+class CommanderUnitTest {
+
   @Test
-  public void getUnitExtension() {
+  void getUnitExtension() {
     final var unit = new CommanderUnit("CommanderUnitName");
 
     assertNull(unit.getUnitExtension("SoldierExtension"));
diff --git a/extension-objects/src/test/java/units/SergeantUnitTest.java b/extension-objects/src/test/java/units/SergeantUnitTest.java
index 3afa2cc81..6db646371 100644
--- a/extension-objects/src/test/java/units/SergeantUnitTest.java
+++ b/extension-objects/src/test/java/units/SergeantUnitTest.java
@@ -31,9 +31,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class SergeantUnitTest {
+class SergeantUnitTest {
+
   @Test
-  public void getUnitExtension() {
+  void getUnitExtension() {
     final var unit = new SergeantUnit("SergeantUnitName");
 
     assertNull(unit.getUnitExtension("SoldierExtension"));
diff --git a/extension-objects/src/test/java/units/SoldierUnitTest.java b/extension-objects/src/test/java/units/SoldierUnitTest.java
index 51c8c63ca..cba9dbb48 100644
--- a/extension-objects/src/test/java/units/SoldierUnitTest.java
+++ b/extension-objects/src/test/java/units/SoldierUnitTest.java
@@ -31,9 +31,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class SoldierUnitTest {
+class SoldierUnitTest {
+
   @Test
-  public void getUnitExtension() {
+  void getUnitExtension() {
     final var unit = new SoldierUnit("SoldierUnitName");
 
     assertNotNull(unit.getUnitExtension("SoldierExtension"));
diff --git a/extension-objects/src/test/java/units/UnitTest.java b/extension-objects/src/test/java/units/UnitTest.java
index cbb90ff24..ec194e10b 100644
--- a/extension-objects/src/test/java/units/UnitTest.java
+++ b/extension-objects/src/test/java/units/UnitTest.java
@@ -31,10 +31,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Created by Srdjan on 03-May-17.
  */
-public class UnitTest {
+class UnitTest {
 
   @Test
-  public void testConstGetSet() throws Exception {
+  void testConstGetSet() throws Exception {
     final var name = "testName";
     final var unit = new Unit(name);
     assertEquals(name, unit.getName());
diff --git a/facade/README.md b/facade/README.md
index f6765e325..f08aecdb2 100644
--- a/facade/README.md
+++ b/facade/README.md
@@ -38,10 +38,9 @@ Let's take our goldmine example from above. Here we have the dwarven mine worker
 there's a base class `DwarvenMineWorker`:
 
 ```java
+@Slf4j
 public abstract class DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenMineWorker.class);
-
   public void goToSleep() {
     LOGGER.info("{} goes to sleep.", name());
   }
@@ -99,10 +98,9 @@ Then we have the concrete dwarf classes `DwarvenTunnelDigger`, `DwarvenGoldDigge
 `DwarvenCartOperator`:
 
 ```java
+@Slf4j
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} creates another promising tunnel.", name());
@@ -114,10 +112,9 @@ public class DwarvenTunnelDigger extends DwarvenMineWorker {
   }
 }
 
+@Slf4j
 public class DwarvenGoldDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenGoldDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} digs for gold.", name());
@@ -129,10 +126,9 @@ public class DwarvenGoldDigger extends DwarvenMineWorker {
   }
 }
 
+@Slf4j
 public class DwarvenCartOperator extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenCartOperator.class);
-
   @Override
   public void work() {
     LOGGER.info("{} moves gold chunks out of the mine.", name());
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
index db383e47b..14881f3e7 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.facade;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * DwarvenCartOperator is one of the goldmine subsystems.
  */
+@Slf4j
 public class DwarvenCartOperator extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenCartOperator.class);
-
   @Override
   public void work() {
     LOGGER.info("{} moves gold chunks out of the mine.", name());
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
index 6a1a8f057..70c946e40 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.facade;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * DwarvenGoldDigger is one of the goldmine subsystems.
  */
+@Slf4j
 public class DwarvenGoldDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenGoldDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} digs for gold.", name());
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
index a6b832cd1..d963f1da5 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
@@ -24,16 +24,14 @@
 package com.iluwatar.facade;
 
 import java.util.Arrays;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * DwarvenMineWorker is one of the goldmine subsystems.
  */
+@Slf4j
 public abstract class DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenMineWorker.class);
-
   public void goToSleep() {
     LOGGER.info("{} goes to sleep.", name());
   }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
index 2fea7955a..f5bb6dd4f 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.facade;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * DwarvenTunnelDigger is one of the goldmine subsystems.
  */
+@Slf4j
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} creates another promising tunnel.", name());
diff --git a/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java b/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
index d93ba2a5e..2eccf3b4f 100644
--- a/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
+++ b/facade/src/test/java/com/iluwatar/facade/DwarvenGoldmineFacadeTest.java
@@ -41,17 +41,17 @@ import org.slf4j.LoggerFactory;
  *
  * @author Jeroen Meulemeester
  */
-public class DwarvenGoldmineFacadeTest {
+class DwarvenGoldmineFacadeTest {
 
   private InMemoryAppender appender;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     appender = new InMemoryAppender();
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     appender.stop();
   }
 
@@ -63,7 +63,7 @@ public class DwarvenGoldmineFacadeTest {
    * See if the workers are doing what's expected from them on each step.
    */
   @Test
-  public void testFullWorkDay() {
+  void testFullWorkDay() {
     final var goldMine = new DwarvenGoldmineFacade();
     goldMine.startNewDay();
 
@@ -108,7 +108,7 @@ public class DwarvenGoldmineFacadeTest {
     assertEquals(15, appender.getLogSize());
   }
 
-  private class InMemoryAppender extends AppenderBase<ILoggingEvent> {
+  private static class InMemoryAppender extends AppenderBase<ILoggingEvent> {
 
     private final List<ILoggingEvent> log = new LinkedList<>();
 
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/App.java b/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
index 580e60006..e5f0b4285 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.factorykit;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Factory-kit is a creational pattern which defines a factory of immutable content with separated
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * an input representing an instance of {@link WeaponType} that needs to be mapped explicitly with
  * desired class type in the factory instance.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
index cc4a1df1f..42fd89c4e 100644
--- a/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
+++ b/factory-kit/src/main/java/com/iluwatar/factorykit/WeaponType.java
@@ -27,5 +27,8 @@ package com.iluwatar.factorykit;
  * Enumerates {@link Weapon} types.
  */
 public enum WeaponType {
-  SWORD, AXE, BOW, SPEAR
+  SWORD,
+  AXE,
+  BOW,
+  SPEAR
 }
diff --git a/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java b/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
index f05dd4f8a..79241a9f5 100644
--- a/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
+++ b/factory-kit/src/test/java/com/iluwatar/factorykit/factorykit/FactoryKitTest.java
@@ -37,12 +37,12 @@ import org.junit.jupiter.api.Test;
 /**
  * Test Factory Kit Pattern
  */
-public class FactoryKitTest {
+class FactoryKitTest {
 
   private WeaponFactory factory;
 
   @BeforeEach
-  public void init() {
+  void init() {
     factory = WeaponFactory.factory(builder -> {
       builder.add(WeaponType.SPEAR, Spear::new);
       builder.add(WeaponType.AXE, Axe::new);
@@ -55,7 +55,7 @@ public class FactoryKitTest {
    * {@link Spear}
    */
   @Test
-  public void testSpearWeapon() {
+  void testSpearWeapon() {
     var weapon = factory.create(WeaponType.SPEAR);
     verifyWeapon(weapon, Spear.class);
   }
@@ -65,7 +65,7 @@ public class FactoryKitTest {
    * {@link Axe}
    */
   @Test
-  public void testAxeWeapon() {
+  void testAxeWeapon() {
     var weapon = factory.create(WeaponType.AXE);
     verifyWeapon(weapon, Axe.class);
   }
@@ -76,7 +76,7 @@ public class FactoryKitTest {
    * {@link Sword}
    */
   @Test
-  public void testWeapon() {
+  void testWeapon() {
     var weapon = factory.create(WeaponType.SWORD);
     verifyWeapon(weapon, Sword.class);
   }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
index ee92abe24..126114a84 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/App.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.factory.method;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Factory Method is a creational design pattern which uses factory methods to deal with the
@@ -37,14 +36,13 @@ import org.slf4j.LoggerFactory;
  * creating objects ({@link Blacksmith#manufactureWeapon}). The concrete subclasses (
  * {@link OrcBlacksmith}, {@link ElfBlacksmith}) then override the method to produce objects of
  * their liking.
- * 
+ *
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private final Blacksmith blacksmith;
-  
+
   /**
    * Creates an instance of <code>App</code> which will use <code>blacksmith</code> to manufacture 
    * the weapons for war.
@@ -56,22 +54,22 @@ public class App {
   public App(Blacksmith blacksmith) {
     this.blacksmith = blacksmith;
   }
-  
+
   /**
    * Program entry point.
-   * 
+   *
    * @param args command line args
    */
   public static void main(String[] args) {
     // Lets go to war with Orc weapons
     var app = new App(new OrcBlacksmith());
     app.manufactureWeapons();
-    
+
     // Lets go to war with Elf weapons
     app = new App(new ElfBlacksmith());
     app.manufactureWeapons();
   }
-  
+
   private void manufactureWeapons() {
     var weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
     LOGGER.info(weapon.toString());
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
index 4c49ebaa3..d801f43b8 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
@@ -24,7 +24,7 @@
 package com.iluwatar.factory.method;
 
 import java.util.Arrays;
-import java.util.HashMap;
+import java.util.EnumMap;
 import java.util.Map;
 
 /**
@@ -35,7 +35,7 @@ public class ElfBlacksmith implements Blacksmith {
   private static final Map<WeaponType, ElfWeapon> ELFARSENAL;
 
   static {
-    ELFARSENAL = new HashMap<>(WeaponType.values().length);
+    ELFARSENAL = new EnumMap<>(WeaponType.class);
     Arrays.stream(WeaponType.values()).forEach(type -> ELFARSENAL.put(type, new ElfWeapon(type)));
   }
 
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
index e3b436554..321f24873 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
@@ -23,24 +23,20 @@
 
 package com.iluwatar.factory.method;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * ElfWeapon.
  */
+@RequiredArgsConstructor
+@Getter
 public class ElfWeapon implements Weapon {
 
   private final WeaponType weaponType;
 
-  public ElfWeapon(WeaponType weaponType) {
-    this.weaponType = weaponType;
-  }
-
   @Override
   public String toString() {
     return "Elven " + weaponType;
   }
-
-  @Override
-  public WeaponType getWeaponType() {
-    return weaponType;
-  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
index d97bfc92a..1ef87b86f 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
@@ -24,7 +24,7 @@
 package com.iluwatar.factory.method;
 
 import java.util.Arrays;
-import java.util.HashMap;
+import java.util.EnumMap;
 import java.util.Map;
 
 /**
@@ -35,10 +35,10 @@ public class OrcBlacksmith implements Blacksmith {
   private static final Map<WeaponType, OrcWeapon> ORCARSENAL;
 
   static {
-    ORCARSENAL = new HashMap<>(WeaponType.values().length);
+    ORCARSENAL = new EnumMap<>(WeaponType.class);
     Arrays.stream(WeaponType.values()).forEach(type -> ORCARSENAL.put(type, new OrcWeapon(type)));
   }
-  
+
   @Override
   public Weapon manufactureWeapon(WeaponType weaponType) {
     return ORCARSENAL.get(weaponType);
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
index c3a9c8688..560c7aaf7 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
@@ -23,24 +23,20 @@
 
 package com.iluwatar.factory.method;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * OrcWeapon.
  */
+@RequiredArgsConstructor
+@Getter
 public class OrcWeapon implements Weapon {
 
   private final WeaponType weaponType;
 
-  public OrcWeapon(WeaponType weaponType) {
-    this.weaponType = weaponType;
-  }
-
   @Override
   public String toString() {
     return "Orcish " + weaponType;
   }
-
-  @Override
-  public WeaponType getWeaponType() {
-    return weaponType;
-  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
index b600f5a25..8f7fc1aa4 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
@@ -23,19 +23,21 @@
 
 package com.iluwatar.factory.method;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * WeaponType enumeration.
  */
+@RequiredArgsConstructor
 public enum WeaponType {
 
-  SHORT_SWORD("short sword"), SPEAR("spear"), AXE("axe"), UNDEFINED("");
+  SHORT_SWORD("short sword"),
+  SPEAR("spear"),
+  AXE("axe"),
+  UNDEFINED("");
 
   private final String title;
 
-  WeaponType(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
index f7bbf6f97..a206c06b4 100644
--- a/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
+++ b/factory-method/src/test/java/com/iluwatar/factory/method/FactoryMethodTest.java
@@ -40,14 +40,14 @@ import org.junit.jupiter.api.Test;
  * implementation it is referring to.
  * </p>
  */
-public class FactoryMethodTest {
+class FactoryMethodTest {
 
   /**
    * Testing {@link OrcBlacksmith} to produce a SPEAR asserting that the Weapon is an instance of
    * {@link OrcWeapon}.
    */
   @Test
-  public void testOrcBlacksmithWithSpear() {
+  void testOrcBlacksmithWithSpear() {
     var blacksmith = new OrcBlacksmith();
     var weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
     verifyWeapon(weapon, WeaponType.SPEAR, OrcWeapon.class);
@@ -58,7 +58,7 @@ public class FactoryMethodTest {
    * {@link OrcWeapon}.
    */
   @Test
-  public void testOrcBlacksmithWithAxe() {
+  void testOrcBlacksmithWithAxe() {
     var blacksmith = new OrcBlacksmith();
     var weapon = blacksmith.manufactureWeapon(WeaponType.AXE);
     verifyWeapon(weapon, WeaponType.AXE, OrcWeapon.class);
@@ -69,7 +69,7 @@ public class FactoryMethodTest {
    * of {@link ElfWeapon}.
    */
   @Test
-  public void testElfBlacksmithWithShortSword() {
+  void testElfBlacksmithWithShortSword() {
     var blacksmith = new ElfBlacksmith();
     var weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD);
     verifyWeapon(weapon, WeaponType.SHORT_SWORD, ElfWeapon.class);
@@ -80,7 +80,7 @@ public class FactoryMethodTest {
    * {@link ElfWeapon}.
    */
   @Test
-  public void testElfBlacksmithWithSpear() {
+  void testElfBlacksmithWithSpear() {
     var blacksmith = new ElfBlacksmith();
     var weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
     verifyWeapon(weapon, WeaponType.SPEAR, ElfWeapon.class);
diff --git a/factory/src/main/java/com/iluwatar/factory/App.java b/factory/src/main/java/com/iluwatar/factory/App.java
index 554baeeb1..732f5458f 100644
--- a/factory/src/main/java/com/iluwatar/factory/App.java
+++ b/factory/src/main/java/com/iluwatar/factory/App.java
@@ -23,22 +23,20 @@
 
 package com.iluwatar.factory;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Factory is an object for creating other objects, it providing Providing a static method to 
  * create and return objects of varying classes, in order to hide the implementation logic 
  * and makes client code focus on usage rather then objects initialization and management.
- * 
+ *
  * <p>In this example the CarFactory is the factory class and it provides a static method to 
  * create different cars.
  */
 
+@Slf4j
 public class App {
-  
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-  
+
   /**
    * Program main entry point.
    */
diff --git a/factory/src/main/java/com/iluwatar/factory/Car.java b/factory/src/main/java/com/iluwatar/factory/Car.java
index e1f82d41e..e1e248fb4 100644
--- a/factory/src/main/java/com/iluwatar/factory/Car.java
+++ b/factory/src/main/java/com/iluwatar/factory/Car.java
@@ -27,7 +27,7 @@ package com.iluwatar.factory;
  * Car interface.
  */
 public interface Car {
-  
+
   String getDescription();
-  
+
 }
diff --git a/factory/src/main/java/com/iluwatar/factory/CarType.java b/factory/src/main/java/com/iluwatar/factory/CarType.java
index 33d5a521a..074ea32bc 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarType.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarType.java
@@ -24,22 +24,19 @@
 package com.iluwatar.factory;
 
 import java.util.function.Supplier;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
+/**
+ * Enumeration for different types of cars.
+ */
+@RequiredArgsConstructor
+@Getter
 public enum CarType {
-  
-  /**
-   * Enumeration for different types of cars.
-   */
-  FORD(Ford::new), 
+
+  FORD(Ford::new),
   FERRARI(Ferrari::new);
-  
-  private final Supplier<Car> constructor; 
-  
-  CarType(Supplier<Car> constructor) {
-    this.constructor = constructor;
-  }
-  
-  public Supplier<Car> getConstructor() {
-    return this.constructor;
-  }
+
+  private final Supplier<Car> constructor;
+
 }
diff --git a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
index a802da039..941552065 100644
--- a/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
+++ b/factory/src/main/java/com/iluwatar/factory/CarsFactory.java
@@ -27,7 +27,7 @@ package com.iluwatar.factory;
  * Factory of cars.
  */
 public class CarsFactory {
-  
+
   /**
    * Factory method takes as parameter a car type and initiate the appropriate class.
    */
diff --git a/factory/src/main/java/com/iluwatar/factory/Ferrari.java b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
index 294a04fcc..c11ee3679 100644
--- a/factory/src/main/java/com/iluwatar/factory/Ferrari.java
+++ b/factory/src/main/java/com/iluwatar/factory/Ferrari.java
@@ -27,7 +27,7 @@ package com.iluwatar.factory;
  * Ferrari implementation.
  */
 public class Ferrari implements Car {
-   
+
   static final String DESCRIPTION = "This is Ferrari.";
 
   @Override
diff --git a/factory/src/test/java/com/iluwatar/factory/AppTest.java b/factory/src/test/java/com/iluwatar/factory/AppTest.java
index 69a581e88..9bb244500 100644
--- a/factory/src/test/java/com/iluwatar/factory/AppTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/AppTest.java
@@ -29,9 +29,9 @@ import org.junit.jupiter.api.Test;
 
 class AppTest {
 
-	@Test
-	void shouldExecuteWithoutExceptions() {
-		assertDoesNotThrow(() -> App.main(new String[]{}));
-	}
+  @Test
+  void shouldExecuteWithoutExceptions() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
 
 }
diff --git a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
index b93ca91f5..c29cbbeb4 100644
--- a/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
+++ b/factory/src/test/java/com/iluwatar/factory/CarsFactoryTest.java
@@ -29,10 +29,10 @@ import org.junit.jupiter.api.Test;
 
 class CarsFactoryTest {
 
-	@Test
-	void shouldReturnFerrariInstance() {
-		final var ferrari = CarsFactory.getCar(CarType.FERRARI);
-		assertTrue(ferrari instanceof Ferrari);
-	}
+  @Test
+  void shouldReturnFerrariInstance() {
+    final var ferrari = CarsFactory.getCar(CarType.FERRARI);
+    assertTrue(ferrari instanceof Ferrari);
+  }
 
 }
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
index e00fb45a4..5c1e47f65 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/App.java
@@ -29,8 +29,7 @@ import com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersi
 import com.iluwatar.featuretoggle.user.User;
 import com.iluwatar.featuretoggle.user.UserGroup;
 import java.util.Properties;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Feature Toggle pattern allows for complete code executions to be turned on or off with ease.
@@ -45,10 +44,9 @@ import org.slf4j.LoggerFactory;
  * <p>Note that this pattern can easily introduce code complexity, and if not kept in check can
  * result in redundant unmaintained code within the codebase.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Block 1 shows the {@link PropertiesFeatureToggleVersion} being run with {@link Properties}
    * setting the feature toggle to enabled.
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
index 631f90687..8f1503634 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersion.java
@@ -26,6 +26,7 @@ package com.iluwatar.featuretoggle.pattern.propertiesversion;
 import com.iluwatar.featuretoggle.pattern.Service;
 import com.iluwatar.featuretoggle.user.User;
 import java.util.Properties;
+import lombok.Getter;
 
 /**
  * This example of the Feature Toogle pattern is less dynamic version than {@link
@@ -40,9 +41,15 @@ import java.util.Properties;
  * @see com.iluwatar.featuretoggle.pattern.tieredversion.TieredFeatureToggleVersion
  * @see User
  */
+@Getter
 public class PropertiesFeatureToggleVersion implements Service {
 
-  private final boolean isEnhanced;
+  /**
+   * True if the welcome message to be returned is the enhanced venison or not. For
+   * this service it will see the value of the boolean that was set in the constructor {@link
+   * PropertiesFeatureToggleVersion#PropertiesFeatureToggleVersion(Properties)}
+   */
+  private final boolean enhanced;
 
   /**
    * Creates an instance of {@link PropertiesFeatureToggleVersion} using the passed {@link
@@ -59,7 +66,7 @@ public class PropertiesFeatureToggleVersion implements Service {
       throw new IllegalArgumentException("No Properties Provided.");
     } else {
       try {
-        isEnhanced = (boolean) properties.get("enhancedWelcome");
+        enhanced = (boolean) properties.get("enhancedWelcome");
       } catch (Exception e) {
         throw new IllegalArgumentException("Invalid Enhancement Settings Provided.");
       }
@@ -87,16 +94,4 @@ public class PropertiesFeatureToggleVersion implements Service {
 
     return "Welcome to the application.";
   }
-
-  /**
-   * Method that checks if the welcome message to be returned is the enhanced venison or not. For
-   * this service it will see the value of the boolean that was set in the constructor {@link
-   * PropertiesFeatureToggleVersion#PropertiesFeatureToggleVersion(Properties)}
-   *
-   * @return Boolean value {@code true} if enhanced.
-   */
-  @Override
-  public boolean isEnhanced() {
-    return isEnhanced;
-  }
 }
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
index 7c7dc5d6b..395c473af 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/User.java
@@ -23,23 +23,17 @@
 
 package com.iluwatar.featuretoggle.user;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Used to demonstrate the purpose of the feature toggle. This class actually has nothing to do with
  * the pattern.
  */
+@RequiredArgsConstructor
 public class User {
 
   private final String name;
 
-  /**
-   * Default Constructor setting the username.
-   *
-   * @param name {@link String} to represent the name of the user.
-   */
-  public User(String name) {
-    this.name = name;
-  }
-
   /**
    * {@inheritDoc}
    *
diff --git a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
index ec4e21a91..523a6cb30 100644
--- a/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
+++ b/feature-toggle/src/main/java/com/iluwatar/featuretoggle/user/UserGroup.java
@@ -38,7 +38,6 @@ public class UserGroup {
   private static final List<User> freeGroup = new ArrayList<>();
   private static final List<User> paidGroup = new ArrayList<>();
 
-
   /**
    * Add the passed {@link User} to the free user group list.
    *
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
index 9fa8d9052..c7d703f51 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/propertiesversion/PropertiesFeatureToggleVersionTest.java
@@ -35,17 +35,17 @@ import org.junit.jupiter.api.Test;
 /**
  * Test Properties Toggle
  */
-public class PropertiesFeatureToggleVersionTest {
+class PropertiesFeatureToggleVersionTest {
 
   @Test
-  public void testNullPropertiesPassed() {
+  void testNullPropertiesPassed() {
     assertThrows(IllegalArgumentException.class, () -> {
       new PropertiesFeatureToggleVersion(null);
     });
   }
 
   @Test
-  public void testNonBooleanProperty() {
+  void testNonBooleanProperty() {
     assertThrows(IllegalArgumentException.class, () -> {
       final var properties = new Properties();
       properties.setProperty("enhancedWelcome", "Something");
@@ -54,7 +54,7 @@ public class PropertiesFeatureToggleVersionTest {
   }
 
   @Test
-  public void testFeatureTurnedOn() {
+  void testFeatureTurnedOn() {
     final var properties = new Properties();
     properties.put("enhancedWelcome", true);
     var service = new PropertiesFeatureToggleVersion(properties);
@@ -64,7 +64,7 @@ public class PropertiesFeatureToggleVersionTest {
   }
 
   @Test
-  public void testFeatureTurnedOff() {
+  void testFeatureTurnedOff() {
     final var properties = new Properties();
     properties.put("enhancedWelcome", false);
     var service = new PropertiesFeatureToggleVersion(properties);
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
index de45d9254..4feb4207d 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/pattern/tieredversion/TieredFeatureToggleVersionTest.java
@@ -35,34 +35,34 @@ import org.junit.jupiter.api.Test;
 /**
  * Test Tiered Feature Toggle
  */
-public class TieredFeatureToggleVersionTest {
+class TieredFeatureToggleVersionTest {
 
   final User paidUser = new User("Jamie Coder");
   final User freeUser = new User("Alan Defect");
   final Service service = new TieredFeatureToggleVersion();
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     UserGroup.addUserToPaidGroup(paidUser);
     UserGroup.addUserToFreeGroup(freeUser);
   }
 
   @Test
-  public void testGetWelcomeMessageForPaidUser() {
+  void testGetWelcomeMessageForPaidUser() {
     final var welcomeMessage = service.getWelcomeMessage(paidUser);
     final var expected = "You're amazing Jamie Coder. Thanks for paying for this awesome software.";
     assertEquals(expected, welcomeMessage);
   }
 
   @Test
-  public void testGetWelcomeMessageForFreeUser() {
+  void testGetWelcomeMessageForFreeUser() {
     final var welcomeMessage = service.getWelcomeMessage(freeUser);
     final var expected = "I suppose you can use this software.";
     assertEquals(expected, welcomeMessage);
   }
 
   @Test
-  public void testIsEnhancedAlwaysTrueAsTiered() {
+  void testIsEnhancedAlwaysTrueAsTiered() {
     assertTrue(service.isEnhanced());
   }
 }
diff --git a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
index db1569cf4..f4768d541 100644
--- a/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
+++ b/feature-toggle/src/test/java/com/iluwatar/featuretoggle/user/UserGroupTest.java
@@ -32,24 +32,24 @@ import org.junit.jupiter.api.Test;
 /**
  * Test User Group specific feature
  */
-public class UserGroupTest {
+class UserGroupTest {
 
   @Test
-  public void testAddUserToFreeGroup() {
+  void testAddUserToFreeGroup() {
     var user = new User("Free User");
     UserGroup.addUserToFreeGroup(user);
     assertFalse(UserGroup.isPaid(user));
   }
 
   @Test
-  public void testAddUserToPaidGroup() {
+  void testAddUserToPaidGroup() {
     var user = new User("Paid User");
     UserGroup.addUserToPaidGroup(user);
     assertTrue(UserGroup.isPaid(user));
   }
 
   @Test
-  public void testAddUserToPaidWhenOnFree() {
+  void testAddUserToPaidWhenOnFree() {
     var user = new User("Paid User");
     UserGroup.addUserToFreeGroup(user);
     assertThrows(IllegalArgumentException.class, () -> {
@@ -58,7 +58,7 @@ public class UserGroupTest {
   }
 
   @Test
-  public void testAddUserToFreeWhenOnPaid() {
+  void testAddUserToFreeWhenOnPaid() {
     var user = new User("Free User");
     UserGroup.addUserToPaidGroup(user);
     assertThrows(IllegalArgumentException.class, () -> {
diff --git a/filterer/src/main/java/com/iluwatar/filterer/App.java b/filterer/src/main/java/com/iluwatar/filterer/App.java
index 2555dd7f8..d25c73a55 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/App.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/App.java
@@ -31,12 +31,9 @@ import com.iluwatar.filterer.threat.SimpleThreatAwareSystem;
 import com.iluwatar.filterer.threat.Threat;
 import com.iluwatar.filterer.threat.ThreatAwareSystem;
 import com.iluwatar.filterer.threat.ThreatType;
-
 import java.util.List;
 import java.util.function.Predicate;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This demo class represent how {@link com.iluwatar.filterer.domain.Filterer} pattern is used to
@@ -46,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * The thing is to keep it simple if we add new subtype of {@link Threat}
  * (for example {@link ProbableThreat}) - we still need to be able to filter by it's properties.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   public static void main(String[] args) {
     filteringSimpleThreats();
     filteringSimpleProbableThreats();
@@ -62,7 +58,7 @@ public class App {
    * as predicate argument.
    */
   private static void filteringSimpleProbableThreats() {
-    LOGGER.info(" ### Filtering ProbabilisticThreatAwareSystem by probability ###");
+    LOGGER.info("### Filtering ProbabilisticThreatAwareSystem by probability ###");
 
     var trojanArcBomb = new SimpleProbableThreat("Trojan-ArcBomb", 1, ThreatType.TROJAN, 0.99);
     var rootkit = new SimpleProbableThreat("Rootkit-Kernel", 2, ThreatType.ROOTKIT, 0.8);
@@ -70,14 +66,14 @@ public class App {
     List<ProbableThreat> probableThreats = List.of(trojanArcBomb, rootkit);
 
     var probabilisticThreatAwareSystem =
-            new SimpleProbabilisticThreatAwareSystem("Sys-1", probableThreats);
+        new SimpleProbabilisticThreatAwareSystem("Sys-1", probableThreats);
 
     LOGGER.info("Filtering ProbabilisticThreatAwareSystem. Initial : "
-            + probabilisticThreatAwareSystem);
+        + probabilisticThreatAwareSystem);
 
     //Filtering using filterer
     var filteredThreatAwareSystem = probabilisticThreatAwareSystem.filtered()
-            .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
+        .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 
     LOGGER.info("Filtered by probability = 0.99 : " + filteredThreatAwareSystem);
   }
@@ -100,7 +96,7 @@ public class App {
 
     //Filtering using Filterer
     var rootkitThreatAwareSystem = threatAwareSystem.filtered()
-            .by(threat -> threat.type() == ThreatType.ROOTKIT);
+        .by(threat -> threat.type() == ThreatType.ROOTKIT);
 
     LOGGER.info("Filtered by threatType = ROOTKIT : " + rootkitThreatAwareSystem);
   }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
index ea431042a..ac16e6614 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystem.java
@@ -23,29 +23,24 @@
 
 package com.iluwatar.filterer.threat;
 
-import com.google.common.collect.ImmutableList;
 import com.iluwatar.filterer.domain.Filterer;
-
 import java.util.List;
-import java.util.Objects;
 import java.util.function.Predicate;
 import java.util.stream.Collectors;
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
 
 /**
  * {@inheritDoc}
  */
+@ToString
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreatAwareSystem {
 
   private final String systemId;
-  private final ImmutableList<ProbableThreat> threats;
-
-  public SimpleProbabilisticThreatAwareSystem(
-          final String systemId,
-          final List<ProbableThreat> threats
-  ) {
-    this.systemId = systemId;
-    this.threats = ImmutableList.copyOf(threats);
-  }
+  private final List<ProbableThreat> threats;
 
   /**
    * {@inheritDoc}
@@ -72,42 +67,15 @@ public class SimpleProbabilisticThreatAwareSystem implements ProbabilisticThreat
   }
 
   private ProbabilisticThreatAwareSystem filteredGroup(
-          final Predicate<? super ProbableThreat> predicate
-  ) {
+      final Predicate<? super ProbableThreat> predicate) {
     return new SimpleProbabilisticThreatAwareSystem(this.systemId, filteredItems(predicate));
   }
 
   private List<ProbableThreat> filteredItems(
-          final Predicate<? super ProbableThreat> predicate
-  ) {
+      final Predicate<? super ProbableThreat> predicate) {
     return this.threats.stream()
-            .filter(predicate)
-            .collect(Collectors.toList());
+        .filter(predicate)
+        .collect(Collectors.toUnmodifiableList());
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var that = (SimpleProbabilisticThreatAwareSystem) o;
-    return systemId.equals(that.systemId)
-            && threats.equals(that.threats);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(systemId, threats);
-  }
-
-  @Override
-  public String toString() {
-    return "SimpleProbabilisticThreatAwareSystem{"
-            + "systemId='" + systemId + '\''
-            + ", threats=" + threats
-            + '}';
-  }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
index 5c1183fb2..307e6d41b 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleProbableThreat.java
@@ -23,20 +23,18 @@
 
 package com.iluwatar.filterer.threat;
 
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
 
 /**
  * {@inheritDoc}
  */
+@EqualsAndHashCode(callSuper = false)
 public class SimpleProbableThreat extends SimpleThreat implements ProbableThreat {
 
   private final double probability;
 
-  public SimpleProbableThreat(final String name,
-                              final int id,
-                              final ThreatType threatType,
-                              final double probability
-  ) {
+  public SimpleProbableThreat(final String name, final int id, final ThreatType threatType,
+                              final double probability) {
     super(threatType, id, name);
     this.probability = probability;
   }
@@ -49,31 +47,11 @@ public class SimpleProbableThreat extends SimpleThreat implements ProbableThreat
     return probability;
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    if (!super.equals(o)) {
-      return false;
-    }
-    var that = (SimpleProbableThreat) o;
-    return Double.compare(that.probability, probability) == 0;
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(super.hashCode(), probability);
-  }
-
   @Override
   public String toString() {
     return "SimpleProbableThreat{"
-            + "probability=" + probability
-            + "} "
-            + super.toString();
+        + "probability=" + probability
+        + "} "
+        + super.toString();
   }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
index ab1977bc8..44294b1db 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreat.java
@@ -23,30 +23,22 @@
 
 package com.iluwatar.filterer.threat;
 
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
 
 /**
  * Represents a simple threat.
  */
+@ToString
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class SimpleThreat implements Threat {
 
   private final ThreatType threatType;
   private final int id;
   private final String name;
 
-  /**
-   * Constructor.
-   *
-   * @param threatType {@link ThreatType}.
-   * @param id         threat id.
-   * @param name       threat name.
-   */
-  public SimpleThreat(final ThreatType threatType, final int id, String name) {
-    this.threatType = threatType;
-    this.id = id;
-    this.name = name;
-  }
-
   /**
    * {@inheritDoc}
    */
@@ -71,31 +63,4 @@ public class SimpleThreat implements Threat {
     return threatType;
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var that = (SimpleThreat) o;
-    return id == that.id
-            && threatType == that.threatType
-            && Objects.equals(name, that.name);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(threatType, id, name);
-  }
-
-  @Override
-  public String toString() {
-    return "SimpleThreat{"
-            + "threatType=" + threatType
-            + ", id=" + id
-            + ", name='" + name + '\''
-            + '}';
-  }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
index 428521ad9..7a165c3f3 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystem.java
@@ -23,27 +23,25 @@
 
 package com.iluwatar.filterer.threat;
 
-import com.google.common.collect.ImmutableList;
 import com.iluwatar.filterer.domain.Filterer;
-
 import java.util.ArrayList;
 import java.util.List;
-import java.util.Objects;
 import java.util.function.Predicate;
 import java.util.stream.Collectors;
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
 
 /**
  * {@inheritDoc}
  */
+@ToString
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 
   private final String systemId;
-  private final ImmutableList<Threat> issues;
-
-  public SimpleThreatAwareSystem(final String systemId, final List<Threat> issues) {
-    this.systemId = systemId;
-    this.issues = ImmutableList.copyOf(issues);
-  }
+  private final List<Threat> issues;
 
   /**
    * {@inheritDoc}
@@ -75,33 +73,8 @@ public class SimpleThreatAwareSystem implements ThreatAwareSystem {
 
   private List<Threat> filteredItems(Predicate<? super Threat> predicate) {
     return this.issues.stream()
-            .filter(predicate)
-            .collect(Collectors.toList());
+        .filter(predicate)
+        .collect(Collectors.toUnmodifiableList());
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var that = (SimpleThreatAwareSystem) o;
-    return systemId.equals(that.systemId)
-            && issues.equals(that.issues);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(systemId, issues);
-  }
-
-  @Override
-  public String toString() {
-    return "SimpleThreatAwareSystem{"
-            + "systemId='" + systemId
-            + '\'' + ", issues=" + issues
-            + '}';
-  }
 }
diff --git a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
index 4c9a23b21..417db3e0c 100644
--- a/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
+++ b/filterer/src/main/java/com/iluwatar/filterer/threat/ThreatType.java
@@ -23,4 +23,8 @@
 
 package com.iluwatar.filterer.threat;
 
-public enum ThreatType { TROJAN, WORM, ROOTKIT }
+public enum ThreatType {
+  TROJAN,
+  WORM,
+  ROOTKIT
+}
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
index 082496175..50fca774c 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleProbabilisticThreatAwareSystemTest.java
@@ -23,13 +23,13 @@
 
 package com.iluwatar.filterer.threat;
 
-import org.junit.jupiter.api.Test;
-
-import java.util.List;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
+import java.util.List;
+import org.junit.jupiter.api.Test;
+
 class SimpleProbabilisticThreatAwareSystemTest {
+
   @Test
   void shouldFilterByProbability() {
     //given
@@ -38,11 +38,11 @@ class SimpleProbabilisticThreatAwareSystemTest {
     List<ProbableThreat> probableThreats = List.of(trojan, rootkit);
 
     var simpleProbabilisticThreatAwareSystem =
-            new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
+        new SimpleProbabilisticThreatAwareSystem("System-1", probableThreats);
 
     //when
     var filtered = simpleProbabilisticThreatAwareSystem.filtered()
-            .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
+        .by(probableThreat -> Double.compare(probableThreat.probability(), 0.99) == 0);
 
     //then
     assertEquals(filtered.threats().size(), 1);
diff --git a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
index 9f93fa50f..d8b28e18a 100644
--- a/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
+++ b/filterer/src/test/java/com/iluwatar/filterer/threat/SimpleThreatAwareSystemTest.java
@@ -41,7 +41,7 @@ class SimpleThreatAwareSystemTest {
 
     //when
     var rootkitThreatAwareSystem = threatAwareSystem.filtered()
-            .by(threat -> threat.type() == ThreatType.ROOTKIT);
+        .by(threat -> threat.type() == ThreatType.ROOTKIT);
 
     //then
     assertEquals(rootkitThreatAwareSystem.threats().size(), 1);
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index c51c488c7..51519b427 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -30,8 +30,7 @@ import java.util.List;
 import java.util.StringJoiner;
 import java.util.function.Function;
 import java.util.function.Predicate;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Fluent Interface pattern is useful when you want to provide an easy readable, flowing API.
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * demonstrated with a simple number list that is filtered, transformed and collected. The result is
  * printed afterwards.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index d6acd1771..c5f600b1f 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -30,6 +30,7 @@ import java.util.List;
 import java.util.Optional;
 import java.util.function.Function;
 import java.util.function.Predicate;
+import lombok.RequiredArgsConstructor;
 
 /**
  * This is a lazy implementation of the FluentIterable interface. It evaluates all chained
@@ -37,19 +38,11 @@ import java.util.function.Predicate;
  *
  * @param <E> the type of the objects the iteration is about
  */
+@RequiredArgsConstructor
 public class LazyFluentIterable<E> implements FluentIterable<E> {
 
   private final Iterable<E> iterable;
 
-  /**
-   * This constructor creates a new LazyFluentIterable. It wraps the given iterable.
-   *
-   * @param iterable the iterable this FluentIterable works on.
-   */
-  protected LazyFluentIterable(Iterable<E> iterable) {
-    this.iterable = iterable;
-  }
-
   /**
    * This constructor can be used to implement anonymous subclasses of the LazyFluentIterable.
    */
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index 0c6a3b4af..55aa86767 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -32,6 +32,7 @@ import java.util.Spliterator;
 import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.Predicate;
+import lombok.RequiredArgsConstructor;
 
 /**
  * This is a simple implementation of the FluentIterable interface. It evaluates all chained
@@ -39,19 +40,11 @@ import java.util.function.Predicate;
  *
  * @param <E> the type of the objects the iteration is about
  */
+@RequiredArgsConstructor
 public class SimpleFluentIterable<E> implements FluentIterable<E> {
 
   private final Iterable<E> iterable;
 
-  /**
-   * This constructor creates a copy of a given iterable's contents.
-   *
-   * @param iterable the iterable this interface copies to work on.
-   */
-  protected SimpleFluentIterable(Iterable<E> iterable) {
-    this.iterable = iterable;
-  }
-
   /**
    * Filters the contents of Iterable using the given predicate, leaving only the ones which satisfy
    * the predicate.
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
index 7eb2b59c1..275134adc 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterableTest.java
@@ -53,7 +53,7 @@ public abstract class FluentIterableTest {
   protected abstract FluentIterable<Integer> createFluentIterable(final Iterable<Integer> integers);
 
   @Test
-  public void testFirst() {
+  void testFirst() {
     final var integers = List.of(1, 2, 3, 10, 9, 8);
     final var first = createFluentIterable(integers).first();
     assertNotNull(first);
@@ -62,7 +62,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testFirstEmptyCollection() {
+  void testFirstEmptyCollection() {
     final var integers = Collections.<Integer>emptyList();
     final var first = createFluentIterable(integers).first();
     assertNotNull(first);
@@ -70,7 +70,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testFirstCount() {
+  void testFirstCount() {
     final var integers = List.of(1, 2, 3, 10, 9, 8);
     final var first4 = createFluentIterable(integers)
         .first(4)
@@ -86,7 +86,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testFirstCountLessItems() {
+  void testFirstCountLessItems() {
     final var integers = List.of(1, 2, 3);
     final var first4 = createFluentIterable(integers)
         .first(4)
@@ -101,7 +101,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testLast() {
+  void testLast() {
     final var integers = List.of(1, 2, 3, 10, 9, 8);
     final var last = createFluentIterable(integers).last();
     assertNotNull(last);
@@ -110,7 +110,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testLastEmptyCollection() {
+  void testLastEmptyCollection() {
     final var integers = Collections.<Integer>emptyList();
     final var last = createFluentIterable(integers).last();
     assertNotNull(last);
@@ -118,7 +118,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testLastCount() {
+  void testLastCount() {
     final var integers = List.of(1, 2, 3, 10, 9, 8);
     final var last4 = createFluentIterable(integers)
         .last(4)
@@ -133,7 +133,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testLastCountLessItems() {
+  void testLastCountLessItems() {
     final var integers = List.of(1, 2, 3);
     final var last4 = createFluentIterable(integers)
         .last(4)
@@ -148,7 +148,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testFilter() {
+  void testFilter() {
     final var integers = List.of(1, 2, 3, 10, 9, 8);
     final var evenItems = createFluentIterable(integers)
         .filter(i -> i % 2 == 0)
@@ -162,7 +162,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testMap() {
+  void testMap() {
     final var integers = List.of(1, 2, 3);
     final var longs = createFluentIterable(integers)
         .map(Integer::longValue)
@@ -176,7 +176,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testForEach() {
+  void testForEach() {
     final var integers = List.of(1, 2, 3);
 
     final Consumer<Integer> consumer = mock(Consumer.class);
@@ -190,7 +190,7 @@ public abstract class FluentIterableTest {
   }
 
   @Test
-  public void testSpliterator() throws Exception {
+  void testSpliterator() throws Exception {
     final var integers = List.of(1, 2, 3);
     final var split = createFluentIterable(integers).spliterator();
     assertNotNull(split);
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
index 9a88e5bba..02e41bb91 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterableTest.java
@@ -31,7 +31,7 @@ import com.iluwatar.fluentinterface.fluentiterable.FluentIterableTest;
  *
  * @author Jeroen Meulemeester
  */
-public class LazyFluentIterableTest extends FluentIterableTest {
+class LazyFluentIterableTest extends FluentIterableTest {
 
   @Override
   protected FluentIterable<Integer> createFluentIterable(Iterable<Integer> integers) {
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
index 85e358cf1..fbe1bb270 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterableTest.java
@@ -31,7 +31,7 @@ import com.iluwatar.fluentinterface.fluentiterable.FluentIterableTest;
  *
  * @author Jeroen Meulemeester
  */
-public class SimpleFluentIterableTest extends FluentIterableTest {
+class SimpleFluentIterableTest extends FluentIterableTest {
 
   @Override
   protected FluentIterable<Integer> createFluentIterable(Iterable<Integer> integers) {
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Action.java b/flux/src/main/java/com/iluwatar/flux/action/Action.java
index 5dff8444b..9a22b0cd1 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Action.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Action.java
@@ -23,18 +23,16 @@
 
 package com.iluwatar.flux.action;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * Action is the data payload dispatched to the stores when something happens.
  */
+@RequiredArgsConstructor
+@Getter
 public abstract class Action {
 
   private final ActionType type;
 
-  public Action(ActionType type) {
-    this.type = type;
-  }
-
-  public ActionType getType() {
-    return type;
-  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
index bb852279f..25bd2962f 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
@@ -28,6 +28,7 @@ package com.iluwatar.flux.action;
  */
 public enum ActionType {
 
-  MENU_ITEM_SELECTED, CONTENT_CHANGED
+  MENU_ITEM_SELECTED,
+  CONTENT_CHANGED
 
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Content.java b/flux/src/main/java/com/iluwatar/flux/action/Content.java
index 5832a0f45..e0bd87f1a 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Content.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Content.java
@@ -23,20 +23,19 @@
 
 package com.iluwatar.flux.action;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Content items.
  */
+@RequiredArgsConstructor
 public enum Content {
 
-  PRODUCTS("Products - This page lists the company's products."), COMPANY(
-      "Company - This page displays information about the company.");
+  PRODUCTS("Products - This page lists the company's products."),
+  COMPANY("Company - This page displays information about the company.");
 
   private final String title;
 
-  Content(String title) {
-    this.title = title;
-  }
-
   @Override
   public String toString() {
     return title;
diff --git a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
index e194d46f9..a02fcacef 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
@@ -26,16 +26,14 @@ package com.iluwatar.flux.view;
 import com.iluwatar.flux.action.Content;
 import com.iluwatar.flux.store.ContentStore;
 import com.iluwatar.flux.store.Store;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ContentView is a concrete view.
  */
+@Slf4j
 public class ContentView implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ContentView.class);
-
   private Content content = Content.PRODUCTS;
 
   @Override
diff --git a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
index 090cab5c7..3d62a82e9 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
@@ -27,16 +27,14 @@ import com.iluwatar.flux.action.MenuItem;
 import com.iluwatar.flux.dispatcher.Dispatcher;
 import com.iluwatar.flux.store.MenuStore;
 import com.iluwatar.flux.store.Store;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * MenuView is a concrete view.
  */
+@Slf4j
 public class MenuView implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(MenuView.class);
-
   private MenuItem selected = MenuItem.HOME;
 
   @Override
diff --git a/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java b/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
index d99e17a13..a25cb630b 100644
--- a/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/action/ContentTest.java
@@ -36,7 +36,7 @@ import org.junit.jupiter.api.Test;
 public class ContentTest {
 
   @Test
-  public void testToString() {
+  void testToString() {
     for (final var content : Content.values()) {
       final var toString = content.toString();
       assertNotNull(toString);
diff --git a/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java b/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
index b8772b69c..f5726062e 100644
--- a/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/action/MenuItemTest.java
@@ -36,7 +36,7 @@ import org.junit.jupiter.api.Test;
 public class MenuItemTest {
 
   @Test
-  public void testToString() {
+  void testToString() {
     for (final var menuItem : MenuItem.values()) {
       final var toString = menuItem.toString();
       assertNotNull(toString);
diff --git a/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java b/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
index b8491b514..a8fc7e01b 100644
--- a/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/dispatcher/DispatcherTest.java
@@ -38,7 +38,6 @@ import com.iluwatar.flux.action.ContentAction;
 import com.iluwatar.flux.action.MenuAction;
 import com.iluwatar.flux.action.MenuItem;
 import com.iluwatar.flux.store.Store;
-import java.util.List;
 import java.util.stream.Collectors;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -67,13 +66,13 @@ public class DispatcherTest {
   }
 
   @Test
-  public void testGetInstance() {
+  void testGetInstance() {
     assertNotNull(Dispatcher.getInstance());
     assertSame(Dispatcher.getInstance(), Dispatcher.getInstance());
   }
 
   @Test
-  public void testMenuItemSelected() {
+  void testMenuItemSelected() {
     final var dispatcher = Dispatcher.getInstance();
 
     final var store = mock(Store.class);
diff --git a/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java b/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
index 264502e3e..79b83a97c 100644
--- a/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/store/ContentStoreTest.java
@@ -46,7 +46,7 @@ import org.junit.jupiter.api.Test;
 public class ContentStoreTest {
 
   @Test
-  public void testOnAction() {
+  void testOnAction() {
     final var contentStore = new ContentStore();
 
     final var view = mock(View.class);
diff --git a/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java b/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
index 1a3be2fa4..837f2526a 100644
--- a/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/store/MenuStoreTest.java
@@ -46,7 +46,7 @@ import org.junit.jupiter.api.Test;
 public class MenuStoreTest {
 
   @Test
-  public void testOnAction() {
+  void testOnAction() {
     final var menuStore = new MenuStore();
 
     final var view = mock(View.class);
diff --git a/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java b/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
index 11b69857f..49de88da7 100644
--- a/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/view/ContentViewTest.java
@@ -41,7 +41,7 @@ import org.junit.jupiter.api.Test;
 public class ContentViewTest {
 
   @Test
-  public void testStoreChanged() {
+  void testStoreChanged() {
     final var store = mock(ContentStore.class);
     when(store.getContent()).thenReturn(Content.PRODUCTS);
 
diff --git a/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java b/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
index 6813c61b7..2bd036232 100644
--- a/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/view/MenuViewTest.java
@@ -45,7 +45,7 @@ import org.junit.jupiter.api.Test;
 public class MenuViewTest {
 
   @Test
-  public void testStoreChanged() {
+  void testStoreChanged() {
     final var store = mock(MenuStore.class);
     when(store.getSelected()).thenReturn(MenuItem.HOME);
 
@@ -57,7 +57,7 @@ public class MenuViewTest {
   }
 
   @Test
-  public void testItemClicked() {
+  void testItemClicked() {
     final var store = mock(Store.class);
     Dispatcher.getInstance().registerStore(store);
 
diff --git a/flyweight/README.md b/flyweight/README.md
index fbefd3740..8a794f63d 100644
--- a/flyweight/README.md
+++ b/flyweight/README.md
@@ -42,24 +42,24 @@ public interface Potion {
   void drink();
 }
 
+@Slf4j
 public class HealingPotion implements Potion {
-  private static final Logger LOGGER = LoggerFactory.getLogger(HealingPotion.class);
   @Override
   public void drink() {
     LOGGER.info("You feel healed. (Potion={})", System.identityHashCode(this));
   }
 }
 
+@Slf4j
 public class HolyWaterPotion implements Potion {
-  private static final Logger LOGGER = LoggerFactory.getLogger(HolyWaterPotion.class);
   @Override
   public void drink() {
     LOGGER.info("You feel blessed. (Potion={})", System.identityHashCode(this));
   }
 }
 
+@Slf4j
 public class InvisibilityPotion implements Potion {
-  private static final Logger LOGGER = LoggerFactory.getLogger(InvisibilityPotion.class);
   @Override
   public void drink() {
     LOGGER.info("You become invisible. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
index 140bad760..135712718 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
@@ -24,16 +24,14 @@
 package com.iluwatar.flyweight;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * AlchemistShop holds potions on its shelves. It uses PotionFactory to provide the potions.
  */
+@Slf4j
 public class AlchemistShop {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AlchemistShop.class);
-
   private final List<Potion> topShelf;
   private final List<Potion> bottomShelf;
 
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
index 368c25326..ef750117e 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.flyweight;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * HealingPotion.
  */
+@Slf4j
 public class HealingPotion implements Potion {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HealingPotion.class);
-
   @Override
   public void drink() {
     LOGGER.info("You feel healed. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
index 30c980769..c594939ca 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.flyweight;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * HolyWaterPotion.
  */
+@Slf4j
 public class HolyWaterPotion implements Potion {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HolyWaterPotion.class);
-
   @Override
   public void drink() {
     LOGGER.info("You feel blessed. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
index 8ae18279e..7e5ffccf3 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.flyweight;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * InvisibilityPotion.
  */
+@Slf4j
 public class InvisibilityPotion implements Potion {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(InvisibilityPotion.class);
-
   @Override
   public void drink() {
     LOGGER.info("You become invisible. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
index 816c8634b..470c7fc3f 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.flyweight;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * PoisonPotion.
  */
+@Slf4j
 public class PoisonPotion implements Potion {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PoisonPotion.class);
-
   @Override
   public void drink() {
     LOGGER.info("Urgh! This is poisonous. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
index bceccfe01..0c5bbc433 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.flyweight;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * StrengthPotion.
  */
+@Slf4j
 public class StrengthPotion implements Potion {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(StrengthPotion.class);
-
   @Override
   public void drink() {
     LOGGER.info("You feel strong. (Potion={})", System.identityHashCode(this));
diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
index 83516e8a3..4f76ee5ee 100644
--- a/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
+++ b/flyweight/src/test/java/com/iluwatar/flyweight/AlchemistShopTest.java
@@ -37,7 +37,7 @@ import org.junit.jupiter.api.Test;
 public class AlchemistShopTest {
 
   @Test
-  public void testShop() {
+  void testShop() {
     final var shop = new AlchemistShop();
 
     final var bottomShelf = shop.getBottomShelf();
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
index 7f567c8c4..16893fb6a 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.front.controller;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * View for archers.
  */
+@Slf4j
 public class ArcherView implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ArcherView.class);
-
   @Override
   public void display() {
     LOGGER.info("Displaying archers");
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
index 9f23fb608..b24b53164 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.front.controller;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * View for catapults.
  */
+@Slf4j
 public class CatapultView implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CatapultView.class);
-
   @Override
   public void display() {
     LOGGER.info("Displaying catapults");
diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
index 22757514a..4779ef7a5 100644
--- a/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
+++ b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.front.controller;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * View for errors.
  */
+@Slf4j
 public class ErrorView implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ErrorView.class);
-
   @Override
   public void display() {
     LOGGER.error("Error 500");
diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
index 15ccd5caa..ba3bd5467 100644
--- a/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
+++ b/front-controller/src/test/java/com/iluwatar/front/controller/ApplicationExceptionTest.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.front.controller;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertSame;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/13/15 - 1:35 PM
  *
@@ -35,7 +35,7 @@ import static org.junit.jupiter.api.Assertions.assertSame;
 public class ApplicationExceptionTest {
 
   @Test
-  public void testCause() {
+  void testCause() {
     final var cause = new Exception();
     assertSame(cause, new ApplicationException(cause).getCause());
   }
diff --git a/game-loop/src/main/java/com/iluwatar/gameloop/App.java b/game-loop/src/main/java/com/iluwatar/gameloop/App.java
index cccba9098..002558a8e 100644
--- a/game-loop/src/main/java/com/iluwatar/gameloop/App.java
+++ b/game-loop/src/main/java/com/iluwatar/gameloop/App.java
@@ -23,18 +23,16 @@
 
 package com.iluwatar.gameloop;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A game loop runs continuously during gameplay. Each turn of the loop, it processes
  * user input without blocking, updates the game state, and renders the game. It tracks
  * the passage of time to control the rate of gameplay.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Each type of game loop will run for 2 seconds.
    */
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
index e01bf0c1e..dab983e5e 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/AppTest.java
@@ -23,17 +23,17 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * App unit test class.
  */
 public class AppTest {
 
   @Test
-  public void shouldExecuteApplicationWithoutException() {
+  void shouldExecuteApplicationWithoutException() {
     assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
index 6c282f7d5..5817d9260 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FixedStepGameLoopTest.java
@@ -47,7 +47,7 @@ public class FixedStepGameLoopTest {
   }
 
   @Test
-  public void testUpdate() {
+  void testUpdate() {
     gameLoop.update();
     assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
   }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
index e6e7a75e7..3e5a30c8e 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/FrameBasedGameLoopTest.java
@@ -27,26 +27,27 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * FrameBasedGameLoop unit test class.
  */
-public class FrameBasedGameLoopTest {
+class FrameBasedGameLoopTest {
 
   private FrameBasedGameLoop gameLoop;
 
   @BeforeEach
-  public void setup() {
+  void setup() {
     gameLoop = new FrameBasedGameLoop();
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     gameLoop = null;
   }
 
-  @org.junit.jupiter.api.Test
-  public void testUpdate() {
+  @Test
+  void testUpdate() {
     gameLoop.update();
     assertEquals(0.5f, gameLoop.controller.getBulletPosition(), 0);
   }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
index d15bc4054..d6b7ca459 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameControllerTest.java
@@ -23,11 +23,13 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.jupiter.api.Assertions;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
-public class GameControllerTest {
+class GameControllerTest {
 
   private GameController controller;
 
@@ -41,15 +43,15 @@ public class GameControllerTest {
     controller = null;
   }
 
-  @org.junit.jupiter.api.Test
-  public void testMoveBullet() {
+  @Test
+  void testMoveBullet() {
     controller.moveBullet(1.5f);
-    Assertions.assertEquals(1.5f, controller.bullet.getPosition(), 0);
+    assertEquals(1.5f, controller.bullet.getPosition(), 0);
   }
 
-  @org.junit.jupiter.api.Test
-  public void testGetBulletPosition() {
-    Assertions.assertEquals(controller.bullet.getPosition(), controller.getBulletPosition(), 0);
+  @Test
+  void testGetBulletPosition() {
+    assertEquals(controller.bullet.getPosition(), controller.getBulletPosition(), 0);
   }
 
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
index 7edb65204..ec141cf81 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/GameLoopTest.java
@@ -23,14 +23,17 @@
 
 package com.iluwatar.gameloop;
 
+import static org.junit.jupiter.api.Assertions.assertFalse;
+
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * GameLoop unit test class.
  */
-public class GameLoopTest {
+class GameLoopTest {
 
   private GameLoop gameLoop;
 
@@ -38,33 +41,33 @@ public class GameLoopTest {
    * Create mock implementation of GameLoop.
    */
   @BeforeEach
-  public void setup() {
+  void setup() {
     gameLoop = new GameLoop() {
       @Override
-      protected void processGameLoop() {}
+      protected void processGameLoop() {
+      }
     };
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     gameLoop = null;
   }
 
-  @org.junit.jupiter.api.Test
-  public void testRun() {
+  @Test
+  void testRun() {
     gameLoop.run();
     Assertions.assertEquals(GameStatus.RUNNING, gameLoop.status);
   }
 
-  @org.junit.jupiter.api.Test
-  public void testStop() {
+  @Test
+  void testStop() {
     gameLoop.stop();
     Assertions.assertEquals(GameStatus.STOPPED, gameLoop.status);
   }
 
-  @org.junit.jupiter.api.Test
-  public void testIsGameRunning() {
-    Assertions.assertFalse(gameLoop.isGameRunning());
+  @Test
+  void testIsGameRunning() {
+    assertFalse(gameLoop.isGameRunning());
   }
-
 }
diff --git a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
index ca2c0262b..cb0148783 100644
--- a/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
+++ b/game-loop/src/test/java/com/iluwatar/gameloop/VariableStepGameLoopTest.java
@@ -23,29 +23,30 @@
 
 package com.iluwatar.gameloop;
 
-import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
 
 /**
  * VariableStepGameLoop unit test class.
  */
-public class VariableStepGameLoopTest {
+class VariableStepGameLoopTest {
 
   private VariableStepGameLoop gameLoop;
 
   @BeforeEach
-  public void setup() {
+  void setup() {
     gameLoop = new VariableStepGameLoop();
   }
 
   @AfterEach
-  public void tearDown() {
+  void tearDown() {
     gameLoop = null;
   }
 
-  @org.junit.jupiter.api.Test
-  public void testUpdate() {
+  @Test
+  void testUpdate() {
     gameLoop.update(20L);
     Assertions.assertEquals(0.01f, gameLoop.controller.getBulletPosition(), 0);
   }
diff --git a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
index abc124be1..91bd67fb4 100644
--- a/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
+++ b/guarded-suspension/src/main/java/com/iluwatar/guarded/suspension/GuardedQueue.java
@@ -25,8 +25,7 @@ package com.iluwatar.guarded.suspension;
 
 import java.util.LinkedList;
 import java.util.Queue;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Guarded Queue is an implementation for Guarded Suspension Pattern Guarded suspension pattern is
@@ -35,8 +34,8 @@ import org.slf4j.LoggerFactory;
  *
  * @see <a href="http://java-design-patterns.com/patterns/guarded-suspension/">http://java-design-patterns.com/patterns/guarded-suspension/</a>
  */
+@Slf4j
 public class GuardedQueue {
-  private static final Logger LOGGER = LoggerFactory.getLogger(GuardedQueue.class);
   private final Queue<Integer> sourceList;
 
   public GuardedQueue() {
diff --git a/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java b/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
index 683f3c1e1..e4a17499a 100644
--- a/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
+++ b/guarded-suspension/src/test/java/com/iluwatar/guarded/suspension/GuardedQueueTest.java
@@ -36,7 +36,7 @@ public class GuardedQueueTest {
   private volatile Integer value;
 
   @Test
-  public void testGet() {
+  void testGet() {
     var g = new GuardedQueue();
     var executorService = Executors.newFixedThreadPool(2);
     executorService.submit(() -> value = g.get());
@@ -51,7 +51,7 @@ public class GuardedQueueTest {
   }
 
   @Test
-  public void testPut() {
+  void testPut() {
     var g = new GuardedQueue();
     g.put(12);
     assertEquals(Integer.valueOf(12), g.get());
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
index de4591a22..5f771574d 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.halfsynchalfasync;
 
 import java.util.concurrent.LinkedBlockingQueue;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This application demonstrates Half-Sync/Half-Async pattern. Key parts of the pattern are {@link
@@ -60,10 +59,9 @@ import org.slf4j.LoggerFactory;
  * tasks are executed. Our implementation is just one simple way of implementing this pattern, there
  * are many variants possible as described in its applications.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
index 6361e5d41..4ade8c0af 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
@@ -29,8 +29,7 @@ import java.util.concurrent.ExecutorService;
 import java.util.concurrent.FutureTask;
 import java.util.concurrent.ThreadPoolExecutor;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This is the asynchronous layer which does not block when a new request arrives. It just passes
@@ -39,9 +38,8 @@ import org.slf4j.LoggerFactory;
  * thread picks up the task and executes it synchronously in background and the result is posted
  * back to the caller via callback.
  */
+@Slf4j
 public class AsynchronousService {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(AsynchronousService.class);
   /*
    * This represents the queuing layer as well as synchronous layer of the pattern. The thread pool
    * contains worker threads which execute the tasks in blocking/synchronous manner. Long running
diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
index 05c2272b6..fa7f42e40 100644
--- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
+++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java
@@ -23,13 +23,6 @@
 
 package com.iluwatar.halfsynchalfasync;
 
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import org.mockito.InOrder;
-
-import java.io.IOException;
-import java.util.concurrent.LinkedBlockingQueue;
-
 import static org.mockito.Matchers.eq;
 import static org.mockito.Mockito.doThrow;
 import static org.mockito.Mockito.inOrder;
@@ -40,6 +33,11 @@ import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.verifyNoMoreInteractions;
 import static org.mockito.Mockito.when;
 
+import java.io.IOException;
+import java.util.concurrent.LinkedBlockingQueue;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/12/15 - 11:15 PM
  *
@@ -56,7 +54,7 @@ public class AsynchronousServiceTest {
   }
 
   @Test
-  public void testPerfectExecution() throws Exception {
+  void testPerfectExecution() throws Exception {
     final var result = new Object();
     when(task.call()).thenReturn(result);
     service.execute(task);
@@ -72,7 +70,7 @@ public class AsynchronousServiceTest {
   }
 
   @Test
-  public void testCallException() throws Exception {
+  void testCallException() throws Exception {
     final var exception = new IOException();
     when(task.call()).thenThrow(exception);
     service.execute(task);
@@ -88,7 +86,7 @@ public class AsynchronousServiceTest {
   }
 
   @Test
-  public void testPreCallException() {
+  void testPreCallException() {
     final var exception = new IllegalStateException();
     doThrow(exception).when(task).onPreCall();
     service.execute(task);
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
index f14e6925f..abe6de900 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/administration/ConsoleAdministration.java
@@ -30,16 +30,14 @@ import com.iluwatar.hexagonal.module.LotteryModule;
 import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader;
 import com.iluwatar.hexagonal.sampledata.SampleData;
 import java.util.Scanner;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Console interface for lottery administration.
  */
+@Slf4j
 public class ConsoleAdministration {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConsoleAdministration.class);
-
   /**
    * Program entry point.
    */
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
index 728c2e057..d3659818a 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/database/MongoTicketRepository.java
@@ -147,7 +147,7 @@ public class MongoTicketRepository implements LotteryTicketRepository {
     doc.put("email", ticket.getPlayerDetails().getEmail());
     doc.put("bank", ticket.getPlayerDetails().getBankAccount());
     doc.put("phone", ticket.getPlayerDetails().getPhoneNumber());
-    doc.put("numbers", ticket.getNumbers().getNumbersAsString());
+    doc.put("numbers", ticket.getLotteryNumbers().getNumbersAsString());
     ticketsCollection.insertOne(doc);
     return Optional.of(new LotteryTicketId(ticketId));
   }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
index 4672b7688..ec4bd691e 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryNumbers.java
@@ -29,11 +29,15 @@ import java.util.Collections;
 import java.util.HashSet;
 import java.util.PrimitiveIterator;
 import java.util.Set;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
 
 /**
  * Value object representing lottery numbers. This lottery uses sets of 4 numbers. The numbers must
  * be unique and between 1 and 20.
  */
+@EqualsAndHashCode
+@ToString
 public class LotteryNumbers {
 
   private final Set<Integer> numbers;
@@ -106,11 +110,6 @@ public class LotteryNumbers {
     }
   }
 
-  @Override
-  public String toString() {
-    return "LotteryNumbers{" + "numbers=" + numbers + '}';
-  }
-
   /**
    * Helper class for generating random numbers.
    */
@@ -139,30 +138,4 @@ public class LotteryNumbers {
     }
   }
 
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + ((numbers == null) ? 0 : numbers.hashCode());
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (LotteryNumbers) obj;
-    if (numbers == null) {
-      return other.numbers == null;
-    } else {
-      return numbers.equals(other.numbers);
-    }
-  }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
index 9017e4480..f96b6fbee 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicket.java
@@ -23,63 +23,22 @@
 
 package com.iluwatar.hexagonal.domain;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
+
 /**
  * Immutable value object representing lottery ticket.
  */
+@Getter
+@ToString
+@RequiredArgsConstructor
 public class LotteryTicket {
 
-  private LotteryTicketId id;
+  private final LotteryTicketId id;
   private final PlayerDetails playerDetails;
   private final LotteryNumbers lotteryNumbers;
 
-  /**
-   * Constructor.
-   */
-  public LotteryTicket(LotteryTicketId id, PlayerDetails details, LotteryNumbers numbers) {
-    this.id = id;
-    playerDetails = details;
-    lotteryNumbers = numbers;
-  }
-
-  /**
-   * Get player details.
-   *
-   * @return player details
-   */
-  public PlayerDetails getPlayerDetails() {
-    return playerDetails;
-  }
-
-  /**
-   * Get lottery numbers.
-   *
-   * @return lottery numbers
-   */
-  public LotteryNumbers getNumbers() {
-    return lotteryNumbers;
-  }
-
-  /**
-   * Get ticket id.
-   *
-   * @return id
-   */
-  public LotteryTicketId getId() {
-    return id;
-  }
-
-  /**
-   * Set ticket id.
-   */
-  public void setId(LotteryTicketId id) {
-    this.id = id;
-  }
-
-  @Override
-  public String toString() {
-    return playerDetails.toString() + " " + lotteryNumbers.toString();
-  }
-
   @Override
   public int hashCode() {
     final var prime = 31;
@@ -114,4 +73,5 @@ public class LotteryTicket {
       return playerDetails.equals(other.playerDetails);
     }
   }
+
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
index 5cc7bf6b2..10e5fc358 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketCheckResult.java
@@ -23,9 +23,16 @@
 
 package com.iluwatar.hexagonal.domain;
 
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * Represents lottery ticket check result.
  */
+@Getter
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class LotteryTicketCheckResult {
 
   /**
@@ -37,64 +44,15 @@ public class LotteryTicketCheckResult {
     TICKET_NOT_SUBMITTED
   }
 
-  private final CheckResult checkResult;
+  private final CheckResult result;
   private final int prizeAmount;
 
   /**
    * Constructor.
    */
   public LotteryTicketCheckResult(CheckResult result) {
-    checkResult = result;
+    this.result = result;
     prizeAmount = 0;
   }
 
-  /**
-   * Constructor.
-   */
-  public LotteryTicketCheckResult(CheckResult result, int amount) {
-    checkResult = result;
-    prizeAmount = amount;
-  }
-
-  /**
-   * Get result.
-   *
-   * @return check result
-   */
-  public CheckResult getResult() {
-    return checkResult;
-  }
-
-  /**
-   * Get prize amount.
-   *
-   * @return prize amount
-   */
-  public int getPrizeAmount() {
-    return prizeAmount;
-  }
-
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + ((checkResult == null) ? 0 : checkResult.hashCode());
-    result = prime * result + prizeAmount;
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (LotteryTicketCheckResult) obj;
-    return checkResult == other.checkResult && prizeAmount == other.prizeAmount;
-  }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
index 4ab167fce..624854cb7 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryTicketId.java
@@ -24,10 +24,16 @@
 package com.iluwatar.hexagonal.domain;
 
 import java.util.concurrent.atomic.AtomicInteger;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * Lottery ticked id.
  */
+@Getter
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class LotteryTicketId {
 
   private static final AtomicInteger numAllocated = new AtomicInteger(0);
@@ -37,35 +43,9 @@ public class LotteryTicketId {
     this.id = numAllocated.incrementAndGet();
   }
 
-  public LotteryTicketId(int id) {
-    this.id = id;
-  }
-
-  public int getId() {
-    return id;
-  }
-
   @Override
   public String toString() {
     return String.format("%d", id);
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    var that = (LotteryTicketId) o;
-
-    return id == that.id;
-  }
-
-  @Override
-  public int hashCode() {
-    return id;
-  }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
index 562ca140d..6b7bcf12b 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/LotteryUtils.java
@@ -44,7 +44,7 @@ public class LotteryUtils {
   ) {
     var optional = repository.findById(id);
     if (optional.isPresent()) {
-      if (optional.get().getNumbers().equals(winningNumbers)) {
+      if (optional.get().getLotteryNumbers().equals(winningNumbers)) {
         return new LotteryTicketCheckResult(CheckResult.WIN_PRIZE, 1000);
       } else {
         return new LotteryTicketCheckResult(CheckResult.NO_PRIZE);
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
index d40024a6a..9df222b57 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/domain/PlayerDetails.java
@@ -23,98 +23,22 @@
 
 package com.iluwatar.hexagonal.domain;
 
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
+
 /**
  * Immutable value object containing lottery player details.
  */
+@EqualsAndHashCode
+@ToString
+@Getter
+@RequiredArgsConstructor
 public class PlayerDetails {
 
-  private final String emailAddress;
-  private final String bankAccountNumber;
+  private final String email;
+  private final String bankAccount;
   private final String phoneNumber;
 
-  /**
-   * Constructor.
-   */
-  public PlayerDetails(String email, String bankAccount, String phone) {
-    emailAddress = email;
-    bankAccountNumber = bankAccount;
-    phoneNumber = phone;
-  }
-
-  /**
-   * Get email.
-   *
-   * @return email
-   */
-  public String getEmail() {
-    return emailAddress;
-  }
-
-  /**
-   * Get back account number.
-   *
-   * @return bank account number
-   */
-  public String getBankAccount() {
-    return bankAccountNumber;
-  }
-
-  /**
-   * Get phone number.
-   *
-   * @return phone number
-   */
-  public String getPhoneNumber() {
-    return phoneNumber;
-  }
-
-  @Override
-  public String toString() {
-    return "PlayerDetails{" + "emailAddress='" + emailAddress + '\''
-        + ", bankAccountNumber='" + bankAccountNumber + '\''
-        + ", phoneNumber='" + phoneNumber + '\'' + '}';
-  }
-
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + ((bankAccountNumber == null) ? 0 : bankAccountNumber.hashCode());
-    result = prime * result + ((emailAddress == null) ? 0 : emailAddress.hashCode());
-    result = prime * result + ((phoneNumber == null) ? 0 : phoneNumber.hashCode());
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (PlayerDetails) obj;
-    if (bankAccountNumber == null) {
-      if (other.bankAccountNumber != null) {
-        return false;
-      }
-    } else if (!bankAccountNumber.equals(other.bankAccountNumber)) {
-      return false;
-    }
-    if (emailAddress == null) {
-      if (other.emailAddress != null) {
-        return false;
-      }
-    } else if (!emailAddress.equals(other.emailAddress)) {
-      return false;
-    }
-    if (phoneNumber == null) {
-      return other.phoneNumber == null;
-    } else {
-      return phoneNumber.equals(other.phoneNumber);
-    }
-  }
 }
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
index 4bee37103..373660c3c 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/eventlog/StdOutEventLog.java
@@ -24,16 +24,14 @@
 package com.iluwatar.hexagonal.eventlog;
 
 import com.iluwatar.hexagonal.domain.PlayerDetails;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Standard output event log.
  */
+@Slf4j
 public class StdOutEventLog implements LotteryEventLog {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(StdOutEventLog.class);
-
   @Override
   public void ticketSubmitted(PlayerDetails details) {
     LOGGER.info("Lottery ticket for {} was submitted. Bank account {} was charged for 3 credits.",
diff --git a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
index bc17c3662..ee503fe69 100644
--- a/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
+++ b/hexagonal/src/main/java/com/iluwatar/hexagonal/service/ConsoleLottery.java
@@ -29,16 +29,14 @@ import com.iluwatar.hexagonal.domain.LotteryService;
 import com.iluwatar.hexagonal.module.LotteryModule;
 import com.iluwatar.hexagonal.mongo.MongoConnectionPropertiesLoader;
 import java.util.Scanner;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Console interface for lottery players.
  */
+@Slf4j
 public class ConsoleLottery {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConsoleLottery.class);
-
   /**
    * Program entry point.
    */
diff --git a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
index eb9369ef6..4473ce49e 100644
--- a/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
+++ b/hexagonal/src/test/java/com/iluwatar/hexagonal/database/MongoTicketRepositoryTest.java
@@ -88,7 +88,7 @@ class MongoTicketRepositoryTest {
     assertEquals("foo@bar.com", ticket.getPlayerDetails().getEmail());
     assertEquals("123-123", ticket.getPlayerDetails().getBankAccount());
     assertEquals("07001234", ticket.getPlayerDetails().getPhoneNumber());
-    assertEquals(original.getNumbers(), ticket.getNumbers());
+    assertEquals(original.getLotteryNumbers(), ticket.getLotteryNumbers());
     // clear the collection
     repository.deleteAll();
     assertEquals(0, repository.getTicketsCollection().count());
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
index 1a94a8b80..f24699168 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/FilterManagerTest.java
@@ -41,7 +41,7 @@ import org.junit.jupiter.api.Test;
 public class FilterManagerTest {
 
   @Test
-  public void testFilterRequest() {
+  void testFilterRequest() {
     final var target = mock(Target.class);
     final var filterManager = new FilterManager();
     assertEquals("RUNNING...", filterManager.filterRequest(mock(Order.class)));
@@ -49,7 +49,7 @@ public class FilterManagerTest {
   }
 
   @Test
-  public void testAddFilter() {
+  void testAddFilter() {
     final var target = mock(Target.class);
     final var filterManager = new FilterManager();
 
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
index ab08d2dfe..00f16ec84 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/OrderTest.java
@@ -37,35 +37,35 @@ public class OrderTest {
   private static final String EXPECTED_VALUE = "test";
 
   @Test
-  public void testSetName() {
+  void testSetName() {
     final var order = new Order();
     order.setName(EXPECTED_VALUE);
     assertEquals(EXPECTED_VALUE, order.getName());
   }
 
   @Test
-  public void testSetContactNumber() {
+  void testSetContactNumber() {
     final var order = new Order();
     order.setContactNumber(EXPECTED_VALUE);
     assertEquals(EXPECTED_VALUE, order.getContactNumber());
   }
 
   @Test
-  public void testSetAddress() {
+  void testSetAddress() {
     final var order = new Order();
     order.setAddress(EXPECTED_VALUE);
     assertEquals(EXPECTED_VALUE, order.getAddress());
   }
 
   @Test
-  public void testSetDepositNumber() {
+  void testSetDepositNumber() {
     final var order = new Order();
     order.setDepositNumber(EXPECTED_VALUE);
     assertEquals(EXPECTED_VALUE, order.getDepositNumber());
   }
 
   @Test
-  public void testSetOrder() {
+  void testSetOrder() {
     final var order = new Order();
     order.setOrderItem(EXPECTED_VALUE);
     assertEquals(EXPECTED_VALUE, order.getOrderItem());
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/App.java b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
index c0c4dce63..ebff7b532 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/App.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.interpreter;
 
 import java.util.Stack;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Interpreter pattern is a design pattern that specifies how to evaluate sentences in a
@@ -36,10 +35,9 @@ import org.slf4j.LoggerFactory;
  * <p>In this example we use the Interpreter pattern to break sentences into expressions ({@link
  * Expression}) that can be evaluated and as a whole form the result.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java
index 6141f7fcc..230d67fb4 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/App.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/App.java
@@ -32,8 +32,7 @@ import com.iluwatar.iterator.bst.BstIterator;
 import com.iluwatar.iterator.bst.TreeNode;
 import com.iluwatar.iterator.list.ItemType;
 import com.iluwatar.iterator.list.TreasureChest;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Iterator pattern is a design pattern in which an iterator is used to traverse a container and
@@ -43,10 +42,9 @@ import org.slf4j.LoggerFactory;
  * ({@link TreasureChest}). This way the collection can change its internal implementation without
  * affecting its clients.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private static final TreasureChest TREASURE_CHEST = new TreasureChest();
 
   private static void demonstrateTreasureChestIteratorForType(ItemType itemType) {
diff --git a/layers/README.md b/layers/README.md
index d29ad40d0..1c8a695a0 100644
--- a/layers/README.md
+++ b/layers/README.md
@@ -82,10 +82,9 @@ public interface View {
 
 }
 
+@Slf4j
 public class CakeViewImpl implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CakeViewImpl.class);
-
   private final CakeBakingService cakeBakingService;
 
   public CakeViewImpl(CakeBakingService cakeBakingService) {
diff --git a/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java b/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
index 76674c025..d477d49ed 100644
--- a/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/view/CakeViewImpl.java
@@ -24,16 +24,14 @@
 package com.iluwatar.layers.view;
 
 import com.iluwatar.layers.service.CakeBakingService;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * View implementation for displaying cakes.
  */
+@Slf4j
 public class CakeViewImpl implements View {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CakeViewImpl.class);
-
   private final CakeBakingService cakeBakingService;
 
   public CakeViewImpl(CakeBakingService cakeBakingService) {
diff --git a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
index 22be5a810..84af96ee1 100644
--- a/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/app/AppTest.java
@@ -28,7 +28,7 @@ import org.junit.jupiter.api.Test;
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 /**
- * 
+ *
  * Application test
  *
  */
diff --git a/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java b/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
index 106ef1e0f..e8ed3bf9f 100644
--- a/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/entity/CakeTest.java
@@ -23,19 +23,15 @@
 
 package com.iluwatar.layers.entity;
 
-import com.iluwatar.layers.entity.Cake;
-import com.iluwatar.layers.entity.CakeLayer;
-import com.iluwatar.layers.entity.CakeTopping;
-import org.junit.jupiter.api.Test;
-
-import java.util.HashSet;
-import java.util.Set;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+import java.util.HashSet;
+import java.util.Set;
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/15/15 - 8:02 PM
  *
@@ -44,7 +40,7 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 public class CakeTest {
 
   @Test
-  public void testSetId() {
+  void testSetId() {
     final var cake = new Cake();
     assertNull(cake.getId());
 
@@ -54,7 +50,7 @@ public class CakeTest {
   }
 
   @Test
-  public void testSetTopping() {
+  void testSetTopping() {
     final var cake = new Cake();
     assertNull(cake.getTopping());
 
@@ -64,21 +60,21 @@ public class CakeTest {
   }
 
   @Test
-  public void testSetLayers() {
+  void testSetLayers() {
     final var cake = new Cake();
     assertNotNull(cake.getLayers());
     assertTrue(cake.getLayers().isEmpty());
 
     final var expectedLayers = Set.of(
-            new CakeLayer("layer1", 1000),
-            new CakeLayer("layer2", 2000),
-            new CakeLayer("layer3", 3000));
+        new CakeLayer("layer1", 1000),
+        new CakeLayer("layer2", 2000),
+        new CakeLayer("layer3", 3000));
     cake.setLayers(expectedLayers);
     assertEquals(expectedLayers, cake.getLayers());
   }
 
   @Test
-  public void testAddLayer() {
+  void testAddLayer() {
     final var cake = new Cake();
     assertNotNull(cake.getLayers());
     assertTrue(cake.getLayers().isEmpty());
@@ -101,7 +97,7 @@ public class CakeTest {
   }
 
   @Test
-  public void testToString() {
+  void testToString() {
     final var topping = new CakeTopping("topping", 20);
     topping.setId(2345L);
 
@@ -114,7 +110,7 @@ public class CakeTest {
     cake.addLayer(layer);
 
     final var expected = "id=1234 topping=id=2345 name=topping calories=20 "
-            + "layers=[id=3456 name=layer calories=100]";
+        + "layers=[id=3456 name=layer calories=100]";
     assertEquals(expected, cake.toString());
 
   }
diff --git a/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java b/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
index 253a8634f..a14ed8997 100644
--- a/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/exception/CakeBakingExceptionTest.java
@@ -23,12 +23,11 @@
 
 package com.iluwatar.layers.exception;
 
-import com.iluwatar.layers.exception.CakeBakingException;
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNull;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/15/15 - 7:57 PM
  *
@@ -37,14 +36,14 @@ import static org.junit.jupiter.api.Assertions.assertNull;
 public class CakeBakingExceptionTest {
 
   @Test
-  public void testConstructor() {
+  void testConstructor() {
     final var exception = new CakeBakingException();
     assertNull(exception.getMessage());
     assertNull(exception.getCause());
   }
 
   @Test
-  public void testConstructorWithMessage() {
+  void testConstructorWithMessage() {
     final var expectedMessage = "message";
     final var exception = new CakeBakingException(expectedMessage);
     assertEquals(expectedMessage, exception.getMessage());
diff --git a/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java b/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
index 465d8f034..3b8d8fc1e 100644
--- a/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/service/CakeBakingServiceImplTest.java
@@ -23,17 +23,19 @@
 
 package com.iluwatar.layers.service;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
 import com.iluwatar.layers.dto.CakeInfo;
 import com.iluwatar.layers.dto.CakeLayerInfo;
 import com.iluwatar.layers.dto.CakeToppingInfo;
 import com.iluwatar.layers.exception.CakeBakingException;
-import com.iluwatar.layers.service.CakeBakingServiceImpl;
-import org.junit.jupiter.api.Test;
-
 import java.util.Collections;
 import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/15/15 - 9:55 PM
@@ -43,7 +45,7 @@ import static org.junit.jupiter.api.Assertions.*;
 public class CakeBakingServiceImplTest {
 
   @Test
-  public void testLayers() {
+  void testLayers() {
     final var service = new CakeBakingServiceImpl();
 
     final var initialLayers = service.getAvailableLayers();
@@ -66,7 +68,7 @@ public class CakeBakingServiceImplTest {
   }
 
   @Test
-  public void testToppings() {
+  void testToppings() {
     final var service = new CakeBakingServiceImpl();
 
     final var initialToppings = service.getAvailableToppings();
@@ -89,7 +91,7 @@ public class CakeBakingServiceImplTest {
   }
 
   @Test
-  public void testBakeCakes() throws CakeBakingException {
+  void testBakeCakes() throws CakeBakingException {
     final var service = new CakeBakingServiceImpl();
 
     final var initialCakes = service.getAllCakes();
@@ -126,7 +128,7 @@ public class CakeBakingServiceImplTest {
   }
 
   @Test
-  public void testBakeCakeMissingTopping() {
+  void testBakeCakeMissingTopping() {
     final var service = new CakeBakingServiceImpl();
 
     final var layer1 = new CakeLayerInfo("Layer1", 1000);
@@ -141,7 +143,7 @@ public class CakeBakingServiceImplTest {
   }
 
   @Test
-  public void testBakeCakeMissingLayer() {
+  void testBakeCakeMissingLayer() {
     final var service = new CakeBakingServiceImpl();
 
     final var initialCakes = service.getAllCakes();
@@ -161,7 +163,7 @@ public class CakeBakingServiceImplTest {
   }
 
   @Test
-  public void testBakeCakesUsedLayer() throws CakeBakingException {
+  void testBakeCakesUsedLayer() throws CakeBakingException {
     final var service = new CakeBakingServiceImpl();
 
     final var initialCakes = service.getAllCakes();
diff --git a/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java b/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
index ed0ff3803..e348c1d8b 100644
--- a/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/view/CakeViewImplTest.java
@@ -23,6 +23,10 @@
 
 package com.iluwatar.layers.view;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
 import ch.qos.logback.classic.Logger;
 import ch.qos.logback.classic.spi.ILoggingEvent;
 import ch.qos.logback.core.AppenderBase;
@@ -30,19 +34,13 @@ import com.iluwatar.layers.dto.CakeInfo;
 import com.iluwatar.layers.dto.CakeLayerInfo;
 import com.iluwatar.layers.dto.CakeToppingInfo;
 import com.iluwatar.layers.service.CakeBakingService;
-import com.iluwatar.layers.view.CakeViewImpl;
+import java.util.LinkedList;
+import java.util.List;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 import org.slf4j.LoggerFactory;
 
-import java.util.LinkedList;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.mockito.Mockito.mock;
-import static org.mockito.Mockito.when;
-
 /**
  * Date: 12/15/15 - 10:04 PM
  *
@@ -66,12 +64,12 @@ public class CakeViewImplTest {
    * Verify if the cake view renders the expected result
    */
   @Test
-  public void testRender() {
+  void testRender() {
 
     final var layers = List.of(
-            new CakeLayerInfo("layer1", 1000),
-            new CakeLayerInfo("layer2", 2000),
-            new CakeLayerInfo("layer3", 3000));
+        new CakeLayerInfo("layer1", 1000),
+        new CakeLayerInfo("layer2", 2000),
+        new CakeLayerInfo("layer3", 3000));
 
     final var cake = new CakeInfo(new CakeToppingInfo("topping", 1000), layers);
     final var cakes = List.of(cake);
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
index a4b268403..6b1927a9d 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.lazy.loading;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Lazy loading idiom defers object creation until needed.
@@ -34,10 +33,9 @@ import org.slf4j.LoggerFactory;
  * <p>Additional information and lazy loading flavours are described in
  * http://martinfowler.com/eaaCatalog/lazyLoad.html
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
index f0cbc6e93..ed4255200 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.lazy.loading;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Heavy objects are expensive to create.
  */
+@Slf4j
 public class Heavy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Heavy.class);
-
   /**
    * Constructor.
    */
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
index d42f09ecb..d351336ce 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.lazy.loading;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Simple implementation of the lazy loading idiom. However, this is not thread safe.
  */
+@Slf4j
 public class HolderNaive {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HolderNaive.class);
-
   private Heavy heavy;
 
   /**
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
index 7a3196172..8224535bf 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.lazy.loading;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Same as HolderNaive but with added synchronization. This implementation is thread safe, but each
  * {@link #getHeavy()} call costs additional synchronization overhead.
  */
+@Slf4j
 public class HolderThreadSafe {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HolderThreadSafe.class);
-
   private Heavy heavy;
 
   /**
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
index ba0c2de40..226876254 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
@@ -24,17 +24,15 @@
 package com.iluwatar.lazy.loading;
 
 import java.util.function.Supplier;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This lazy loader is thread safe and more efficient than {@link HolderThreadSafe}. It utilizes
  * Java 8 functional interface {@link Supplier} as {@link Heavy} factory.
  */
+@Slf4j
 public class Java8Holder {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Java8Holder.class);
-
   private Supplier<Heavy> heavy = this::createAndCacheHeavy;
 
   public Java8Holder() {
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
index 5e46ab678..7bbf37dc1 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AbstractHolderTest.java
@@ -23,14 +23,14 @@
 
 package com.iluwatar.lazy.loading;
 
-import org.junit.jupiter.api.Test;
-
 import static java.time.Duration.ofMillis;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertNull;
 import static org.junit.jupiter.api.Assertions.assertSame;
 import static org.junit.jupiter.api.Assertions.assertTimeout;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/19/15 - 11:58 AM
  *
@@ -56,7 +56,7 @@ public abstract class AbstractHolderTest {
    * This test shows that the heavy field is not instantiated until the method getHeavy is called
    */
   @Test
-  public void testGetHeavy() throws Exception {
+  void testGetHeavy() throws Exception {
     assertTimeout(ofMillis(3000), () -> {
       assertNull(getInternalHeavyValue());
       assertNotNull(getHeavy());
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
index 6a3f6ccac..8ffdcbfa2 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
@@ -28,7 +28,7 @@ import org.junit.jupiter.api.Test;
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 /**
- * 
+ *
  * Application test
  *
  */
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
index 0a26808e9..15e48fa96 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/AbstractInstance.java
@@ -25,16 +25,14 @@ package com.iluwatar.leaderelection;
 
 import java.util.Queue;
 import java.util.concurrent.ConcurrentLinkedQueue;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Abstract class of all the instance implementation classes.
  */
+@Slf4j
 public abstract class AbstractInstance implements Instance, Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AbstractInstance.class);
-
   protected static final int HEARTBEAT_INTERVAL = 5000;
   private static final String INSTANCE = "Instance ";
 
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java b/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
index b6fa0f9a8..f99d5a477 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/Message.java
@@ -23,55 +23,23 @@
 
 package com.iluwatar.leaderelection;
 
-import java.util.Objects;
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
 
 /**
  * Message used to transport data between instances.
  */
+@Setter
+@Getter
+@EqualsAndHashCode
+@AllArgsConstructor
+@NoArgsConstructor
 public class Message {
 
   private MessageType type;
-
   private String content;
 
-  public Message() {
-  }
-
-  public Message(MessageType type, String content) {
-    this.type = type;
-    this.content = content;
-  }
-
-  public MessageType getType() {
-    return type;
-  }
-
-  public void setType(MessageType type) {
-    this.type = type;
-  }
-
-  public String getContent() {
-    return content;
-  }
-
-  public void setContent(String content) {
-    this.content = content;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-    var message = (Message) o;
-    return type == message.type && Objects.equals(content, message.content);
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(type, content);
-  }
 }
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
index acf50faa9..fd6f36f0c 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/bully/BullyInstance.java
@@ -26,8 +26,7 @@ package com.iluwatar.leaderelection.bully;
 import com.iluwatar.leaderelection.AbstractInstance;
 import com.iluwatar.leaderelection.Message;
 import com.iluwatar.leaderelection.MessageManager;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Impelemetation with bully algorithm. Each instance should have a sequential id and is able to
@@ -38,9 +37,8 @@ import org.slf4j.LoggerFactory;
  * it will return an alive message (in this sample return true) and then send election message with
  * its ID. If not, the original instance will send leader message to all the other instances.
  */
+@Slf4j
 public class BullyInstance extends AbstractInstance {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(BullyInstance.class);
   private static final String INSTANCE = "Instance ";
 
   /**
diff --git a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
index a7c4a4551..cc3100f9e 100644
--- a/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
+++ b/leader-election/src/main/java/com/iluwatar/leaderelection/ring/RingInstance.java
@@ -27,10 +27,8 @@ import com.iluwatar.leaderelection.AbstractInstance;
 import com.iluwatar.leaderelection.Message;
 import com.iluwatar.leaderelection.MessageManager;
 import java.util.Arrays;
-import java.util.List;
 import java.util.stream.Collectors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation with token ring algorithm. The instances in the system are organized as a ring.
@@ -43,9 +41,8 @@ import org.slf4j.LoggerFactory;
  * smallest ID to be the new leader, and then send a leader message to other instances to inform the
  * result.
  */
+@Slf4j
 public class RingInstance extends AbstractInstance {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(RingInstance.class);
   private static final String INSTANCE = "Instance ";
 
   /**
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
index ce36ccc2f..61776c6ce 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/MessageTest.java
@@ -23,23 +23,23 @@
 
 package com.iluwatar.leaderelection;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Message test case.
  */
 public class MessageTest {
 
   @Test
-  public void testGetType() {
+  void testGetType() {
     var message = new Message(MessageType.HEARTBEAT, "");
     assertEquals(MessageType.HEARTBEAT, message.getType());
   }
 
   @Test
-  public void testGetContent() {
+  void testGetContent() {
     var content = "test";
     var message = new Message(MessageType.HEARTBEAT, content);
     assertEquals(content, message.getContent());
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
index de1cdc480..b04b76597 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyMessageManagerTest.java
@@ -23,14 +23,17 @@
 
 package com.iluwatar.leaderelection.bully;
 
-import com.iluwatar.leaderelection.*;
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
 
-import java.lang.reflect.Field;
+import com.iluwatar.leaderelection.AbstractInstance;
+import com.iluwatar.leaderelection.Instance;
+import com.iluwatar.leaderelection.Message;
+import com.iluwatar.leaderelection.MessageType;
 import java.util.Map;
 import java.util.Queue;
-
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * BullyMessageManager unit test.
@@ -38,7 +41,7 @@ import static org.junit.jupiter.api.Assertions.*;
 public class BullyMessageManagerTest {
 
   @Test
-  public void testSendHeartbeatMessage() {
+  void testSendHeartbeatMessage() {
     var instance1 = new BullyInstance(null, 1, 1);
     Map<Integer, Instance> instanceMap = Map.of(1, instance1);
     var messageManager = new BullyMessageManager(instanceMap);
@@ -46,7 +49,7 @@ public class BullyMessageManagerTest {
   }
 
   @Test
-  public void testSendElectionMessageNotAccepted() {
+  void testSendElectionMessageNotAccepted() {
     try {
       var instance1 = new BullyInstance(null, 1, 1);
       var instance2 = new BullyInstance(null, 1, 2);
@@ -71,7 +74,7 @@ public class BullyMessageManagerTest {
   }
 
   @Test
-  public void testElectionMessageAccepted() {
+  void testElectionMessageAccepted() {
     var instance1 = new BullyInstance(null, 1, 1);
     var instance2 = new BullyInstance(null, 1, 2);
     var instance3 = new BullyInstance(null, 1, 3);
@@ -84,7 +87,7 @@ public class BullyMessageManagerTest {
   }
 
   @Test
-  public void testSendLeaderMessage() {
+  void testSendLeaderMessage() {
     try {
       var instance1 = new BullyInstance(null, 1, 1);
       var instance2 = new BullyInstance(null, 1, 2);
@@ -108,7 +111,7 @@ public class BullyMessageManagerTest {
   }
 
   @Test
-  public void testSendHeartbeatInvokeMessage() {
+  void testSendHeartbeatInvokeMessage() {
     try {
       var instance1 = new BullyInstance(null, 1, 1);
       var instance2 = new BullyInstance(null, 1, 2);
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
index b6836983b..8baab03f2 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/bully/BullyinstanceTest.java
@@ -23,15 +23,15 @@
 
 package com.iluwatar.leaderelection.bully;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import com.iluwatar.leaderelection.AbstractInstance;
 import com.iluwatar.leaderelection.Message;
 import com.iluwatar.leaderelection.MessageType;
-import org.junit.jupiter.api.Test;
-
-import java.lang.reflect.Field;
 import java.util.Queue;
-
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * BullyInstance unit test.
@@ -39,7 +39,7 @@ import static org.junit.jupiter.api.Assertions.*;
 public class BullyinstanceTest {
 
   @Test
-  public void testOnMessage() {
+  void testOnMessage() {
     try {
       final var bullyInstance = new BullyInstance(null, 1, 1);
       var bullyMessage = new Message(MessageType.HEARTBEAT, "");
@@ -55,7 +55,7 @@ public class BullyinstanceTest {
   }
 
   @Test
-  public void testIsAlive() {
+  void testIsAlive() {
     try {
       final var bullyInstance = new BullyInstance(null, 1, 1);
       var instanceClass = AbstractInstance.class;
@@ -69,7 +69,7 @@ public class BullyinstanceTest {
   }
 
   @Test
-  public void testSetAlive() {
+  void testSetAlive() {
     final var bullyInstance = new BullyInstance(null, 1, 1);
     bullyInstance.setAlive(false);
     assertFalse(bullyInstance.isAlive());
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
index 69bc636de..f3e9b4552 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingInstanceTest.java
@@ -23,15 +23,15 @@
 
 package com.iluwatar.leaderelection.ring;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.fail;
+
 import com.iluwatar.leaderelection.AbstractInstance;
 import com.iluwatar.leaderelection.Message;
 import com.iluwatar.leaderelection.MessageType;
-import org.junit.jupiter.api.Test;
-
-import java.lang.reflect.Field;
 import java.util.Queue;
-
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * RingInstance unit test.
@@ -39,7 +39,7 @@ import static org.junit.jupiter.api.Assertions.*;
 public class RingInstanceTest {
 
   @Test
-  public void testOnMessage() {
+  void testOnMessage() {
     try {
       final var ringInstance = new RingInstance(null, 1, 1);
       var ringMessage = new Message(MessageType.HEARTBEAT, "");
@@ -54,7 +54,7 @@ public class RingInstanceTest {
   }
 
   @Test
-  public void testIsAlive() {
+  void testIsAlive() {
     try {
       final var ringInstance = new RingInstance(null, 1, 1);
       var ringInstanceClass = AbstractInstance.class;
@@ -68,7 +68,7 @@ public class RingInstanceTest {
   }
 
   @Test
-  public void testSetAlive() {
+  void testSetAlive() {
     final var ringInstance = new RingInstance(null, 1, 1);
     ringInstance.setAlive(false);
     assertFalse(ringInstance.isAlive());
diff --git a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
index fe4590a02..aea516c05 100644
--- a/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
+++ b/leader-election/src/test/java/com/iluwatar/leaderelection/ring/RingMessageManagerTest.java
@@ -23,14 +23,17 @@
 
 package com.iluwatar.leaderelection.ring;
 
-import com.iluwatar.leaderelection.*;
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.fail;
 
-import java.lang.reflect.Field;
+import com.iluwatar.leaderelection.AbstractInstance;
+import com.iluwatar.leaderelection.Instance;
+import com.iluwatar.leaderelection.Message;
+import com.iluwatar.leaderelection.MessageType;
 import java.util.Map;
 import java.util.Queue;
-
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * RingMessageManager unit test.
@@ -38,7 +41,7 @@ import static org.junit.jupiter.api.Assertions.*;
 public class RingMessageManagerTest {
 
   @Test
-  public void testSendHeartbeatMessage() {
+  void testSendHeartbeatMessage() {
     var instance1 = new RingInstance(null, 1, 1);
     Map<Integer, Instance> instanceMap = Map.of(1, instance1);
     var messageManager = new RingMessageManager(instanceMap);
@@ -46,7 +49,7 @@ public class RingMessageManagerTest {
   }
 
   @Test
-  public void testSendElectionMessage() {
+  void testSendElectionMessage() {
     try {
       var instance1 = new RingInstance(null, 1, 1);
       var instance2 = new RingInstance(null, 1, 2);
@@ -68,7 +71,7 @@ public class RingMessageManagerTest {
   }
 
   @Test
-  public void testSendLeaderMessage() {
+  void testSendLeaderMessage() {
     try {
       var instance1 = new RingInstance(null, 1, 1);
       var instance2 = new RingInstance(null, 1, 2);
@@ -89,7 +92,7 @@ public class RingMessageManagerTest {
   }
 
   @Test
-  public void testSendHeartbeatInvokeMessage() {
+  void testSendHeartbeatInvokeMessage() {
     try {
       var instance1 = new RingInstance(null, 1, 1);
       var instance2 = new RingInstance(null, 1, 2);
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
index 81f2ed044..d4d1f5f54 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/TaskHandler.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.leaderfollowers;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The TaskHandler is used by the {@link Worker} to process the newly arrived task.
  */
+@Slf4j
 public class TaskHandler {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(TaskHandler.class);
-
   /**
    * This interface handles one task at a time.
    */
diff --git a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
index 773eb1c6a..6c7caed24 100644
--- a/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
+++ b/leader-followers/src/main/java/com/iluwatar/leaderfollowers/Worker.java
@@ -23,14 +23,14 @@
 
 package com.iluwatar.leaderfollowers;
 
-import java.util.Objects;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.EqualsAndHashCode;
+import lombok.extern.slf4j.Slf4j;
 
+@EqualsAndHashCode(onlyExplicitlyIncluded = true)
+@Slf4j
 public class Worker implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
-
+  @EqualsAndHashCode.Include
   private final long id;
   private final WorkCenter workCenter;
   private final TaskSet taskSet;
@@ -72,25 +72,10 @@ public class Worker implements Runnable {
         workCenter.addWorker(this);
       } catch (InterruptedException e) {
         LOGGER.warn("Worker interrupted");
+        Thread.currentThread().interrupt();
         return;
       }
     }
   }
 
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (!(o instanceof Worker)) {
-      return false;
-    }
-    var worker = (Worker) o;
-    return id == worker.id;
-  }
-
-  @Override
-  public int hashCode() {
-    return Objects.hash(id);
-  }
 }
diff --git a/leader-followers/src/test/java/com/AppTest.java b/leader-followers/src/test/java/com/AppTest.java
index e764304d6..450a3a59d 100644
--- a/leader-followers/src/test/java/com/AppTest.java
+++ b/leader-followers/src/test/java/com/AppTest.java
@@ -26,18 +26,17 @@ package com;
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 import com.iluwatar.leaderfollowers.App;
+
 import org.junit.jupiter.api.Test;
 
 /**
- *
  * Application test
- *
  */
 class AppTest {
 
-    @Test
-    void shouldExecuteApplicationWithoutException() {
-        assertDoesNotThrow(() -> App.main(new String[]{}));
-    }
+  @Test
+  void shouldExecuteApplicationWithoutException() {
+    assertDoesNotThrow(() -> App.main(new String[]{}));
+  }
 
 }
diff --git a/leader-followers/src/test/java/com/TaskHandlerTest.java b/leader-followers/src/test/java/com/TaskHandlerTest.java
index b3e2f7577..07727726e 100644
--- a/leader-followers/src/test/java/com/TaskHandlerTest.java
+++ b/leader-followers/src/test/java/com/TaskHandlerTest.java
@@ -34,12 +34,12 @@ import org.junit.jupiter.api.Test;
  */
 class TaskHandlerTest {
 
-    @Test
-    void testHandleTask() throws InterruptedException {
-        var taskHandler = new TaskHandler();
-        var handle = new Task(100);
-        taskHandler.handleTask(handle);
-        assertTrue(handle.isFinished());
-    }
+  @Test
+  void testHandleTask() throws InterruptedException {
+    var taskHandler = new TaskHandler();
+    var handle = new Task(100);
+    taskHandler.handleTask(handle);
+    assertTrue(handle.isFinished());
+  }
 
 }
diff --git a/leader-followers/src/test/java/com/TaskSetTest.java b/leader-followers/src/test/java/com/TaskSetTest.java
index af5f6b8a0..2c3b2b003 100644
--- a/leader-followers/src/test/java/com/TaskSetTest.java
+++ b/leader-followers/src/test/java/com/TaskSetTest.java
@@ -34,20 +34,20 @@ import org.junit.jupiter.api.Test;
  */
 class TaskSetTest {
 
-    @Test
-    void testAddTask() throws InterruptedException {
-        var taskSet = new TaskSet();
-        taskSet.addTask(new Task(10));
-        assertEquals(1, taskSet.getSize());
-    }
+  @Test
+  void testAddTask() throws InterruptedException {
+    var taskSet = new TaskSet();
+    taskSet.addTask(new Task(10));
+    assertEquals(1, taskSet.getSize());
+  }
 
-    @Test
-    void testGetTask() throws InterruptedException {
-        var taskSet = new TaskSet();
-        taskSet.addTask(new Task(100));
-        Task task = taskSet.getTask();
-        assertEquals(100, task.getTime());
-        assertEquals(0, taskSet.getSize());
-    }
+  @Test
+  void testGetTask() throws InterruptedException {
+    var taskSet = new TaskSet();
+    taskSet.addTask(new Task(100));
+    Task task = taskSet.getTask();
+    assertEquals(100, task.getTime());
+    assertEquals(0, taskSet.getSize());
+  }
 
 }
diff --git a/lombok.config b/lombok.config
new file mode 100644
index 000000000..753b316b5
--- /dev/null
+++ b/lombok.config
@@ -0,0 +1,2 @@
+lombok.log.fieldName = LOGGER
+
diff --git a/marker/src/main/java/Guard.java b/marker/src/main/java/Guard.java
index edf585263..23ad81edb 100644
--- a/marker/src/main/java/Guard.java
+++ b/marker/src/main/java/Guard.java
@@ -21,14 +21,13 @@
  * THE SOFTWARE.
  */
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class defining Guard.
  */
+@Slf4j
 public class Guard implements Permission {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Guard.class);
 
   protected void enter() {
     LOGGER.info("You can enter");
diff --git a/marker/src/main/java/Thief.java b/marker/src/main/java/Thief.java
index 9f068d46f..cf44b0872 100644
--- a/marker/src/main/java/Thief.java
+++ b/marker/src/main/java/Thief.java
@@ -21,14 +21,13 @@
  * THE SOFTWARE.
  */
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class defining Thief.
  */
+@Slf4j
 public class Thief {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Thief.class);
 
   protected void steal() {
     LOGGER.info("Steal valuable items");
diff --git a/marker/src/test/java/ThiefTest.java b/marker/src/test/java/ThiefTest.java
index e1eaf1e40..669779337 100644
--- a/marker/src/test/java/ThiefTest.java
+++ b/marker/src/test/java/ThiefTest.java
@@ -32,7 +32,7 @@ import org.junit.jupiter.api.Test;
  */
 public class ThiefTest {
   @Test
-  public void testThief() {
+  void testThief() {
     var thief = new Thief();
     assertThat(thief, not(instanceOf(Permission.class)));
   }
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
index 8f2c6296b..a611335ad 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/App.java
@@ -29,8 +29,7 @@ import com.iluwatar.masterworker.system.systemmaster.ArrayTransposeMaster;
 import com.iluwatar.masterworker.system.systemmaster.Master;
 import com.iluwatar.masterworker.system.systemworkers.ArrayTransposeWorker;
 import com.iluwatar.masterworker.system.systemworkers.Worker;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>The <b><em>Master-Worker</em></b> pattern is used when the problem at hand can be solved by
@@ -55,10 +54,9 @@ import org.slf4j.LoggerFactory;
  * ArrayInput} and {@link ArrayResult}.</p>
  */
 
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
index c4ca47b95..0dc0b56d1 100644
--- a/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
+++ b/master-worker-pattern/src/main/java/com/iluwatar/masterworker/ArrayUtilityMethods.java
@@ -24,17 +24,15 @@
 package com.iluwatar.masterworker;
 
 import java.security.SecureRandom;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class ArrayUtilityMethods has some utility methods for matrices and arrays.
  */
 
+@Slf4j
 public class ArrayUtilityMethods {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ArrayUtilityMethods.class);
-
   private static final SecureRandom RANDOM = new SecureRandom();
 
   /**
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
index 6ec619752..b176c9145 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.mediator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Abstract base class for party members.
  */
+@Slf4j
 public abstract class PartyMemberBase implements PartyMember {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PartyMemberBase.class);
-
   protected Party party;
 
   @Override
diff --git a/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java b/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
index 293708890..f814cf89e 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/PartyImplTest.java
@@ -23,13 +23,13 @@
 
 package com.iluwatar.mediator;
 
-import org.junit.jupiter.api.Test;
-
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.verifyNoMoreInteractions;
 import static org.mockito.Mockito.verifyZeroInteractions;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/19/15 - 10:00 PM
  *
@@ -42,7 +42,7 @@ public class PartyImplTest {
    * other member gets it. Also check members don't get their own actions.
    */
   @Test
-  public void testPartyAction() {
+  void testPartyAction() {
     final var partyMember1 = mock(PartyMember.class);
     final var partyMember2 = mock(PartyMember.class);
 
diff --git a/memento/src/main/java/com/iluwatar/memento/App.java b/memento/src/main/java/com/iluwatar/memento/App.java
index 217bb741a..29beadc65 100644
--- a/memento/src/main/java/com/iluwatar/memento/App.java
+++ b/memento/src/main/java/com/iluwatar/memento/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.memento;
 
 import java.util.Stack;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Memento pattern is a software design pattern that provides the ability to restore an object
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * contains the state of the object. Later on the memento can be set back to the object restoring
  * the state.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/memento/src/test/java/com/iluwatar/memento/StarTest.java b/memento/src/test/java/com/iluwatar/memento/StarTest.java
index b90a67768..1707a626c 100644
--- a/memento/src/test/java/com/iluwatar/memento/StarTest.java
+++ b/memento/src/test/java/com/iluwatar/memento/StarTest.java
@@ -38,7 +38,7 @@ public class StarTest {
    * Verify the stages of a dying sun, without going back in time
    */
   @Test
-  public void testTimePasses() {
+  void testTimePasses() {
     final var star = new Star(StarType.SUN, 1, 2);
     assertEquals("sun age: 1 years mass: 2 tons", star.toString());
 
@@ -65,7 +65,7 @@ public class StarTest {
    * Verify some stage of a dying sun, but go back in time to test the memento
    */
   @Test
-  public void testSetMemento() {
+  void testSetMemento() {
     final var star = new Star(StarType.SUN, 1, 2);
     final var firstMemento = star.getMemento();
     assertEquals("sun age: 1 years mass: 2 tons", star.toString());
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
index c19f1e188..d7d000b20 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.model.view.controller;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * GiantView displays the giant.
  */
+@Slf4j
 public class GiantView {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(GiantView.class);
-
   public void displayGiant(GiantModel giant) {
     LOGGER.info(giant.toString());
   }
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
index 65cde953f..e9c6aecdd 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantControllerTest.java
@@ -41,7 +41,7 @@ public class GiantControllerTest {
    * Verify if the controller passes the health level through to the model and vice versa
    */
   @Test
-  public void testSetHealth() {
+  void testSetHealth() {
     final var model = mock(GiantModel.class);
     final var view = mock(GiantView.class);
     final var controller = new GiantController(model, view);
@@ -65,7 +65,7 @@ public class GiantControllerTest {
    * Verify if the controller passes the fatigue level through to the model and vice versa
    */
   @Test
-  public void testSetFatigue() {
+  void testSetFatigue() {
     final var model = mock(GiantModel.class);
     final var view = mock(GiantView.class);
     final var controller = new GiantController(model, view);
@@ -89,7 +89,7 @@ public class GiantControllerTest {
    * Verify if the controller passes the nourishment level through to the model and vice versa
    */
   @Test
-  public void testSetNourishment() {
+  void testSetNourishment() {
     final var model = mock(GiantModel.class);
     final var view = mock(GiantView.class);
     final var controller = new GiantController(model, view);
@@ -110,7 +110,7 @@ public class GiantControllerTest {
   }
 
   @Test
-  public void testUpdateView() {
+  void testUpdateView() {
     final var model = mock(GiantModel.class);
     final var view = mock(GiantView.class);
     final var controller = new GiantController(model, view);
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
index c820e5f1b..af657d41b 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantModelTest.java
@@ -38,7 +38,7 @@ public class GiantModelTest {
    * Verify if the health value is set properly though the constructor and setter
    */
   @Test
-  public void testSetHealth() {
+  void testSetHealth() {
     final var model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED);
     assertEquals(Health.HEALTHY, model.getHealth());
     var messageFormat = "The giant looks %s, alert and saturated.";
@@ -53,7 +53,7 @@ public class GiantModelTest {
    * Verify if the fatigue level is set properly though the constructor and setter
    */
   @Test
-  public void testSetFatigue() {
+  void testSetFatigue() {
     final var model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED);
     assertEquals(Fatigue.ALERT, model.getFatigue());
     var messageFormat = "The giant looks healthy, %s and saturated.";
@@ -68,7 +68,7 @@ public class GiantModelTest {
    * Verify if the nourishment level is set properly though the constructor and setter
    */
   @Test
-  public void testSetNourishment() {
+  void testSetNourishment() {
     final var model = new GiantModel(Health.HEALTHY, Fatigue.ALERT, Nourishment.SATURATED);
     assertEquals(Nourishment.SATURATED, model.getNourishment());
     var messageFormat = "The giant looks healthy, alert and %s.";
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
index 59537f5b2..b100617b5 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/GiantViewTest.java
@@ -60,7 +60,7 @@ public class GiantViewTest {
    * standard out stream, nothing more, nothing less.
    */
   @Test
-  public void testDisplayGiant() {
+  void testDisplayGiant() {
     final var view = new GiantView();
 
     final var model = mock(GiantModel.class);
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
index e7a5abdc3..6f8810208 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileLoaderTest.java
@@ -35,7 +35,7 @@ import org.junit.jupiter.api.Test;
 public class FileLoaderTest {
 
   @Test
-  public void testLoadData() {
+  void testLoadData() {
     final var fileLoader = new FileLoader();
     fileLoader.setFileName("non-existing-file");
     assertNull(fileLoader.loadData());
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
index 954c13817..1700e3087 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
@@ -67,7 +67,7 @@ public class FileSelectorPresenterTest {
    * Tests if the Presenter was successfully connected with the View.
    */
   @Test
-  public void wiring() {
+  void wiring() {
     presenter.start();
 
     assertNotNull(stub.getPresenter());
@@ -78,7 +78,7 @@ public class FileSelectorPresenterTest {
    * Tests if the name of the file changes.
    */
   @Test
-  public void updateFileNameToLoader() {
+  void updateFileNameToLoader() {
     var expectedFile = "Stamatis";
     stub.setFileName(expectedFile);
 
@@ -93,7 +93,7 @@ public class FileSelectorPresenterTest {
    * empty string.
    */
   @Test
-  public void fileConfirmationWhenNameIsNull() {
+  void fileConfirmationWhenNameIsNull() {
     stub.setFileName(null);
 
     presenter.start();
@@ -108,7 +108,7 @@ public class FileSelectorPresenterTest {
    * Tests if we receive a confirmation when we attempt to open a file that it doesn't exist.
    */
   @Test
-  public void fileConfirmationWhenFileDoesNotExist() {
+  void fileConfirmationWhenFileDoesNotExist() {
     stub.setFileName("RandomName.txt");
 
     presenter.start();
@@ -123,7 +123,7 @@ public class FileSelectorPresenterTest {
    * Tests if we can open the file, when it exists.
    */
   @Test
-  public void fileConfirmationWhenFileExists() {
+  void fileConfirmationWhenFileExists() {
     stub.setFileName("etc/data/test.txt");
     presenter.start();
     presenter.fileNameChanged();
@@ -137,7 +137,7 @@ public class FileSelectorPresenterTest {
    * Tests if the view closes after cancellation.
    */
   @Test
-  public void cancellation() {
+  void cancellation() {
     presenter.start();
     presenter.cancelled();
 
diff --git a/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java b/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
index 32ae77db1..e8e79bce5 100644
--- a/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
+++ b/module/src/main/java/com/iluwatar/module/ConsoleLoggerModule.java
@@ -24,8 +24,7 @@
 package com.iluwatar.module;
 
 import java.io.PrintStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The ConsoleLoggerModule is responsible for showing logs on System Console.
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  * <p>The below example demonstrates a Console logger module, which can print simple and error
  * messages in two designated formats
  */
+@Slf4j
 public final class ConsoleLoggerModule {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ConsoleLoggerModule.class);
-
   private static ConsoleLoggerModule singleton = null;
 
   public PrintStream output = null;
diff --git a/module/src/main/java/com/iluwatar/module/FileLoggerModule.java b/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
index 590988cbd..337f4a567 100644
--- a/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
+++ b/module/src/main/java/com/iluwatar/module/FileLoggerModule.java
@@ -26,8 +26,7 @@ package com.iluwatar.module;
 import java.io.FileNotFoundException;
 import java.io.FileOutputStream;
 import java.io.PrintStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The FileLoggerModule is responsible for showing logs on File System.
@@ -35,10 +34,9 @@ import org.slf4j.LoggerFactory;
  * <p>The below example demonstrates a File logger module, which can print simple and error
  * messages in two designated files
  */
+@Slf4j
 public final class FileLoggerModule {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(FileLoggerModule.class);
-
   private static FileLoggerModule singleton = null;
 
   private static final String OUTPUT_FILE = "output.txt";
diff --git a/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java b/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
index 2386f16ad..302062e3a 100644
--- a/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
+++ b/module/src/test/java/com/iluwatar/module/FileLoggerModuleTest.java
@@ -30,9 +30,8 @@ import java.io.BufferedReader;
 import java.io.FileNotFoundException;
 import java.io.FileReader;
 import java.io.IOException;
+import lombok.extern.slf4j.Slf4j;
 import org.junit.jupiter.api.Test;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * The Module pattern can be considered a Creational pattern and a Structural pattern. It manages
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * The below example demonstrates a JUnit test for testing two different modules: File Logger and
  * Console Logger
  */
+@Slf4j
 public final class FileLoggerModuleTest {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(FileLoggerModuleTest.class);
-
   private static final String OUTPUT_FILE = "output.txt";
   private static final String ERROR_FILE = "error.txt";
 
@@ -61,7 +59,7 @@ public final class FileLoggerModuleTest {
    * @throws IOException if program is not able to find log files (output.txt and error.txt)
    */
   @Test
-  public void testFileMessage() throws IOException {
+  void testFileMessage() throws IOException {
 
     /* Get singleton instance of File Logger Module */
     final var fileLoggerModule = FileLoggerModule.getSingleton();
@@ -85,7 +83,7 @@ public final class FileLoggerModuleTest {
    * @throws IOException if program is not able to find log files (output.txt and error.txt)
    */
   @Test
-  public void testNoFileMessage() throws IOException {
+  void testNoFileMessage() throws IOException {
 
     /* Get singleton instance of File Logger Module */
     final var fileLoggerModule = FileLoggerModule.getSingleton();
@@ -107,7 +105,7 @@ public final class FileLoggerModuleTest {
    *                               error.txt)
    */
   @Test
-  public void testFileErrorMessage() throws FileNotFoundException {
+  void testFileErrorMessage() throws FileNotFoundException {
 
     /* Get singleton instance of File Logger Module */
     final var fileLoggerModule = FileLoggerModule.getSingleton();
@@ -132,7 +130,7 @@ public final class FileLoggerModuleTest {
    *                               error.txt)
    */
   @Test
-  public void testNoFileErrorMessage() throws FileNotFoundException {
+  void testNoFileErrorMessage() throws FileNotFoundException {
 
     /* Get singleton instance of File Logger Module */
     final var fileLoggerModule = FileLoggerModule.getSingleton();
diff --git a/monad/src/main/java/com/iluwatar/monad/App.java b/monad/src/main/java/com/iluwatar/monad/App.java
index 040161ef2..36bf9d676 100644
--- a/monad/src/main/java/com/iluwatar/monad/App.java
+++ b/monad/src/main/java/com/iluwatar/monad/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.monad;
 import java.util.Objects;
 import java.util.function.Function;
 import java.util.function.Predicate;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Monad pattern defines a monad structure, that enables chaining operations in pipelines and
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * <p>As a validation result {@link Validator#get()} either returns valid object
  * or throws {@link IllegalStateException} with list of exceptions collected during validation.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/monad/src/test/java/com/iluwatar/monad/AppTest.java b/monad/src/test/java/com/iluwatar/monad/AppTest.java
index 41e60e980..f7ecc6d50 100644
--- a/monad/src/test/java/com/iluwatar/monad/AppTest.java
+++ b/monad/src/test/java/com/iluwatar/monad/AppTest.java
@@ -31,7 +31,7 @@ import org.junit.jupiter.api.Test;
 public class AppTest {
 
   @Test
-  public void testMain() {
+  void testMain() {
     App.main(new String[]{});
   }
 
diff --git a/monad/src/test/java/com/iluwatar/monad/MonadTest.java b/monad/src/test/java/com/iluwatar/monad/MonadTest.java
index da90f0dd0..6613b1955 100644
--- a/monad/src/test/java/com/iluwatar/monad/MonadTest.java
+++ b/monad/src/test/java/com/iluwatar/monad/MonadTest.java
@@ -35,7 +35,7 @@ import org.junit.jupiter.api.Test;
 public class MonadTest {
 
   @Test
-  public void testForInvalidName() {
+  void testForInvalidName() {
     var tom = new User(null, 21, Sex.MALE, "tom@foo.bar");
     assertThrows(
         IllegalStateException.class,
@@ -46,7 +46,7 @@ public class MonadTest {
   }
 
   @Test
-  public void testForInvalidAge() {
+  void testForInvalidAge() {
     var john = new User("John", 17, Sex.MALE, "john@qwe.bar");
     assertThrows(
         IllegalStateException.class,
@@ -58,7 +58,7 @@ public class MonadTest {
   }
 
   @Test
-  public void testForValid() {
+  void testForValid() {
     var sarah = new User("Sarah", 42, Sex.FEMALE, "sarah@det.org");
     var validated = Validator.of(sarah)
         .validate(User::getName, Objects::nonNull, "name cannot be null")
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
index e86a5f374..e88a7c752 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Server.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.monostate;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Server class. Each Server sits behind a LoadBalancer which delegates the call to the servers
  * in a simplistic Round Robin fashion.
  */
+@Slf4j
 public class Server {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Server.class);
-
   public final String host;
   public final int port;
   public final int id;
diff --git a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
index 427a6e920..f03b7fa5a 100644
--- a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
+++ b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
@@ -31,7 +31,7 @@ import org.junit.jupiter.api.Test;
 public class AppTest {
 
   @Test
-  public void testMain() {
+  void testMain() {
     App.main(new String[]{});
   }
 
diff --git a/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java b/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
index e649ebb60..c091571bd 100644
--- a/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
+++ b/monostate/src/test/java/com/iluwatar/monostate/LoadBalancerTest.java
@@ -43,7 +43,7 @@ import org.junit.jupiter.api.Test;
 public class LoadBalancerTest {
 
   @Test
-  public void testSameStateAmongstAllInstances() {
+  void testSameStateAmongstAllInstances() {
     final var firstBalancer = new LoadBalancer();
     final var secondBalancer = new LoadBalancer();
     firstBalancer.addServer(new Server("localhost", 8085, 6));
@@ -54,7 +54,7 @@ public class LoadBalancerTest {
   }
 
   @Test
-  public void testServe() {
+  void testServe() {
     final var server = mock(Server.class);
     when(server.getHost()).thenReturn("testhost");
     when(server.getPort()).thenReturn(1234);
diff --git a/multiton/src/main/java/com/iluwatar/multiton/App.java b/multiton/src/main/java/com/iluwatar/multiton/App.java
index 994424e34..e21cd11a2 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/App.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.multiton;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Whereas Singleton design pattern introduces single globally accessible object the Multiton
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * <p>In the enum implementation {@link NazgulEnum} is the multiton. It is static and mutable
  * because of the way java supports enums.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
index dd3f8af5d..0a092dcf3 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
@@ -31,7 +31,7 @@ import org.junit.jupiter.api.Test;
 public class AppTest {
 
   @Test
-  public void test() {
+  void test() {
     App.main(new String[]{});
   }
 }
diff --git a/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java b/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
index 18bdcf99a..5c0aa4f08 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/NazgulEnumTest.java
@@ -23,7 +23,7 @@
 
 package com.iluwatar.multiton;
 
-import static org.junit.jupiter.api.Assertions.*;
+import static org.junit.jupiter.api.Assertions.assertSame;
 
 import org.junit.jupiter.api.Test;
 
@@ -34,11 +34,11 @@ import org.junit.jupiter.api.Test;
 class NazgulEnumTest {
 
   /**
-   * Check that multiple calls to any one of the instances in the multiton returns 
+   * Check that multiple calls to any one of the instances in the multiton returns
    * only that one particular instance, and do that for all instances in multiton
    */
   @Test
-  public void testTheSameObjectIsReturnedWithMultipleCalls() {
+  void testTheSameObjectIsReturnedWithMultipleCalls() {
     for (var i = 0; i < NazgulEnum.values().length; i++) {
       var instance1 = NazgulEnum.values()[i];
       var instance2 = NazgulEnum.values()[i];
diff --git a/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java b/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
index 4563d7bcc..88255c015 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/NazgulTest.java
@@ -23,12 +23,12 @@
 
 package com.iluwatar.multiton;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 import static org.junit.jupiter.api.Assertions.assertSame;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/22/15 - 22:28 AM
  *
@@ -40,7 +40,7 @@ public class NazgulTest {
    * Verify if {@link Nazgul#getInstance(NazgulName)} returns the correct Nazgul multiton instance
    */
   @Test
-  public void testGetInstance() {
+  void testGetInstance() {
     for (final var name : NazgulName.values()) {
       final var nazgul = Nazgul.getInstance(name);
       assertNotNull(nazgul);
diff --git a/mute-idiom/src/main/java/com/iluwatar/mute/App.java b/mute-idiom/src/main/java/com/iluwatar/mute/App.java
index 773ea690b..c5af59e9d 100644
--- a/mute-idiom/src/main/java/com/iluwatar/mute/App.java
+++ b/mute-idiom/src/main/java/com/iluwatar/mute/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.mute;
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 import java.util.Optional;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Mute pattern is utilized when we need to suppress an exception due to an API flaw or in situation
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * </code>
  * </pre> every time we need to ignore an exception.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
index 126bae2e5..9310c8224 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
@@ -40,7 +40,7 @@ public class SimpleObjectTest {
   public void setUp() {
     simpleObject = new SimpleObject();
   }
-  
+
   @Test
   public void testName() {
     // given
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
index 0c090dd2e..a5f052b64 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
@@ -23,10 +23,9 @@
 
 package domainapp.dom.modules.simple;
 
-import com.google.common.collect.Lists;
-
 import static org.junit.Assert.assertEquals;
 
+import com.google.common.collect.Lists;
 import java.util.List;
 import org.apache.isis.applib.DomainObjectContainer;
 import org.apache.isis.core.unittestsupport.jmocking.JUnitRuleMockery2;
@@ -56,7 +55,7 @@ public class SimpleObjectsTest {
     simpleObjects = new SimpleObjects();
     simpleObjects.container = mockContainer;
   }
-  
+
   @Test
   public void testCreate() {
 
@@ -83,7 +82,7 @@ public class SimpleObjectsTest {
     assertEquals(simpleObject, obj);
     assertEquals(objectName, obj.getName());
   }
-  
+
   @Test
   public void testListAll() {
 
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
index d077528a1..54bb425cc 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
@@ -35,7 +35,7 @@ import cucumber.api.junit.Cucumber;
 @RunWith(Cucumber.class)
 @CucumberOptions(format = {"html:target/cucumber-html-report", "json:target/cucumber.json"},
     glue = {"classpath:domainapp.integtests.specglue"}, strict = true, tags = {"~@backlog",
-        "~@ignore"})
+    "~@ignore"})
 public class RunSpecs {
   // intentionally empty
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
index 3cf4efd18..03ad6183b 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java
@@ -50,7 +50,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
   RecreateSimpleObjects fs;
   SimpleObject simpleObjectPojo;
   SimpleObject simpleObjectWrapped;
-  
+
   private static final String NEW_NAME = "new name";
 
   @Before
@@ -64,7 +64,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
     assertNotNull(simpleObjectPojo);
     simpleObjectWrapped = wrap(simpleObjectPojo);
   }
-  
+
   @Test
   public void testNameAccessible() {
     /* when */
@@ -72,7 +72,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
     // then
     assertEquals(fs.names.get(0), name);
   }
-  
+
   @Test
   public void testNameCannotBeUpdatedDirectly() {
 
@@ -82,7 +82,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
     // when
     simpleObjectWrapped.setName(NEW_NAME);
   }
-  
+
   @Test
   public void testUpdateName() {
 
@@ -92,7 +92,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
     // then
     assertEquals(NEW_NAME, simpleObjectWrapped.getName());
   }
-  
+
   @Test
   public void testUpdateNameFailsValidation() {
 
@@ -103,7 +103,7 @@ public class SimpleObjectIntegTest extends SimpleAppIntegTest {
     // when
     simpleObjectWrapped.updateName(NEW_NAME + "!");
   }
-  
+
   @Test
   public void testInterpolatesName() {
 
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
index be4e5ccfd..fe1e8ca3a 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java
@@ -46,6 +46,7 @@ public class SimpleObjectsIntegTest extends SimpleAppIntegTest {
 
   @Inject
   FixtureScripts fixtureScripts;
+
   @Inject
   SimpleObjects simpleObjects;
 
diff --git a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
index 95cd3ea01..980d43845 100644
--- a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
+++ b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
@@ -37,14 +37,13 @@ import java.io.IOException;
 import java.io.InputStream;
 import java.nio.charset.Charset;
 import javax.servlet.http.HttpServletRequest;
+import lombok.extern.slf4j.Slf4j;
 import org.apache.isis.viewer.wicket.viewer.IsisWicketApplication;
 import org.apache.isis.viewer.wicket.viewer.integration.wicket.AuthenticatedWebSessionForIsis;
 import org.apache.wicket.Session;
 import org.apache.wicket.request.Request;
 import org.apache.wicket.request.Response;
 import org.apache.wicket.request.http.WebRequest;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 
 /**
@@ -63,9 +62,8 @@ import org.slf4j.LoggerFactory;
  * &lt;/filter&gt;
  * </pre>
  */
+@Slf4j
 public class SimpleApplication extends IsisWicketApplication {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(SimpleApplication.class);
   private static final long serialVersionUID = 1L;
 
   /**
diff --git a/null-object/README.md b/null-object/README.md
index 0e95453cb..3d01f829e 100644
--- a/null-object/README.md
+++ b/null-object/README.md
@@ -57,10 +57,9 @@ We have two implementations of `Node`. The normal implementation `NodeImpl` and
 empty nodes.
 
 ```java
+@Slf4j
 public class NodeImpl implements Node {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(NodeImpl.class);
-
   private final String name;
   private final Node left;
   private final Node right;
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
index 5cbeda88f..18fae1e85 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.nullobject;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation for binary tree's normal nodes.
  */
+@Slf4j
 public class NodeImpl implements Node {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(NodeImpl.class);
-
   private final String name;
   private final Node left;
   private final Node right;
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java b/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
index f51171946..f8a702157 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/TreeTest.java
@@ -88,7 +88,7 @@ public class TreeTest {
    * Node#getTreeSize()} of 7 {@link Node}s in total.
    */
   @Test
-  public void testTreeSize() {
+  void testTreeSize() {
     assertEquals(7, TREE_ROOT.getTreeSize());
   }
 
@@ -96,7 +96,7 @@ public class TreeTest {
    * Walk through the tree and verify if every item is handled
    */
   @Test
-  public void testWalk() {
+  void testWalk() {
     TREE_ROOT.walk();
 
     assertTrue(appender.logContains("root"));
@@ -110,7 +110,7 @@ public class TreeTest {
   }
 
   @Test
-  public void testGetLeft() {
+  void testGetLeft() {
     final var level1 = TREE_ROOT.getLeft();
     assertNotNull(level1);
     assertEquals("level1_a", level1.getName());
@@ -130,7 +130,7 @@ public class TreeTest {
   }
 
   @Test
-  public void testGetRight() {
+  void testGetRight() {
     final var level1 = TREE_ROOT.getRight();
     assertNotNull(level1);
     assertEquals("level1_b", level1.getName());
diff --git a/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java b/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
index b167a06a0..d15ada4e2 100644
--- a/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
+++ b/object-mother/src/test/java/com/iluwatar/objectmother/test/RoyaltyObjectMotherTest.java
@@ -23,23 +23,22 @@
 
 package com.iluwatar.objectmother.test;
 
-import com.iluwatar.objectmother.King;
-import com.iluwatar.objectmother.Queen;
-import com.iluwatar.objectmother.Royalty;
-import com.iluwatar.objectmother.RoyaltyObjectMother;
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
+import com.iluwatar.objectmother.King;
+import com.iluwatar.objectmother.Queen;
+import com.iluwatar.objectmother.RoyaltyObjectMother;
+import org.junit.jupiter.api.Test;
+
 /**
  * Test Generation of Royalty Types using the object-mother
  */
 public class RoyaltyObjectMotherTest {
 
   @Test
-  public void unsuccessfulKingFlirt() {
+  void unsuccessfulKingFlirt() {
     var soberUnhappyKing = RoyaltyObjectMother.createSoberUnhappyKing();
     var flirtyQueen = RoyaltyObjectMother.createFlirtyQueen();
     soberUnhappyKing.flirt(flirtyQueen);
@@ -47,7 +46,7 @@ public class RoyaltyObjectMotherTest {
   }
 
   @Test
-  public void queenIsBlockingFlirtCauseDrunkKing() {
+  void queenIsBlockingFlirtCauseDrunkKing() {
     var drunkUnhappyKing = RoyaltyObjectMother.createDrunkKing();
     var notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen();
     drunkUnhappyKing.flirt(notFlirtyQueen);
@@ -55,7 +54,7 @@ public class RoyaltyObjectMotherTest {
   }
 
   @Test
-  public void queenIsBlockingFlirt() {
+  void queenIsBlockingFlirt() {
     var soberHappyKing = RoyaltyObjectMother.createHappyKing();
     var notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen();
     soberHappyKing.flirt(notFlirtyQueen);
@@ -63,7 +62,7 @@ public class RoyaltyObjectMotherTest {
   }
 
   @Test
-  public void successfullKingFlirt() {
+  void successfullKingFlirt() {
     var soberHappyKing = RoyaltyObjectMother.createHappyKing();
     var flirtyQueen = RoyaltyObjectMother.createFlirtyQueen();
     soberHappyKing.flirt(flirtyQueen);
@@ -71,7 +70,7 @@ public class RoyaltyObjectMotherTest {
   }
 
   @Test
-  public void testQueenType() {
+  void testQueenType() {
     var flirtyQueen = RoyaltyObjectMother.createFlirtyQueen();
     var notFlirtyQueen = RoyaltyObjectMother.createNotFlirtyQueen();
     assertEquals(flirtyQueen.getClass(), Queen.class);
@@ -79,7 +78,7 @@ public class RoyaltyObjectMotherTest {
   }
 
   @Test
-  public void testKingType() {
+  void testKingType() {
     var drunkKing = RoyaltyObjectMother.createDrunkKing();
     var happyDrunkKing = RoyaltyObjectMother.createHappyDrunkKing();
     var happyKing = RoyaltyObjectMother.createHappyKing();
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
index 4c544d8e0..381cc1b01 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.object.pool;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * When it is necessary to work with a large number of objects that are particularly expensive to
@@ -44,10 +43,9 @@ import org.slf4j.LoggerFactory;
  * ObjectPool}. {@link Oliphaunt}s can be checked out from the pool and later returned to it. The
  * pool tracks created instances and their status (available, inUse).
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
index fd90b48c9..202a162c8 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
@@ -26,7 +26,7 @@ package com.iluwatar.object.pool;
 import org.junit.jupiter.api.Test;
 
 /**
- * 
+ *
  * Application test
  *
  */
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
index e78a895e2..0b22aa434 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/OliphauntPoolTest.java
@@ -23,26 +23,29 @@
 
 package com.iluwatar.object.pool;
 
-import org.junit.jupiter.api.Test;
+import static java.time.Duration.ofMillis;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotSame;
+import static org.junit.jupiter.api.Assertions.assertSame;
+import static org.junit.jupiter.api.Assertions.assertTimeout;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import java.util.List;
-
-import static java.time.Duration.ofMillis;
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * Date: 12/27/15 - 1:05 AM
  *
  * @author Jeroen Meulemeester
  */
-public class OliphauntPoolTest {
+class OliphauntPoolTest {
 
   /**
    * Use the same object 100 times subsequently. This should not take much time since the heavy
    * object instantiation is done only once. Verify if we get the same object each time.
    */
   @Test
-  public void testSubsequentCheckinCheckout() {
+  void testSubsequentCheckinCheckout() {
     assertTimeout(ofMillis(5000), () -> {
       final var pool = new OliphauntPool();
       assertEquals("Pool available=0 inUse=0", pool.toString());
@@ -71,7 +74,7 @@ public class OliphauntPoolTest {
    * object instantiation is done only once. Verify if we get the same object each time.
    */
   @Test
-  public void testConcurrentCheckinCheckout() {
+  void testConcurrentCheckinCheckout() {
     assertTimeout(ofMillis(5000), () -> {
       final var pool = new OliphauntPool();
       assertEquals(pool.toString(), "Pool available=0 inUse=0");
diff --git a/observer/README.md b/observer/README.md
index cbde540ab..1834f68ef 100644
--- a/observer/README.md
+++ b/observer/README.md
@@ -46,20 +46,18 @@ public interface WeatherObserver {
   void update(WeatherType currentWeather);
 }
 
+@Slf4j
 public class Orcs implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class);
-
   @Override
   public void update(WeatherType currentWeather) {
     LOGGER.info("The orcs are facing " + currentWeather.getDescription() + " weather now");
   }
 }
 
+@Slf4j
 public class Hobbits implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class);
-
   @Override
   public void update(WeatherType currentWeather) {
     switch (currentWeather) {
@@ -72,10 +70,9 @@ public class Hobbits implements WeatherObserver {
 Then here's the `Weather` that is constantly changing.
 
 ```java
+@Slf4j
 public class Weather {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class);
-
   private WeatherType currentWeather;
   private final List<WeatherObserver> observers;
 
diff --git a/observer/src/main/java/com/iluwatar/observer/App.java b/observer/src/main/java/com/iluwatar/observer/App.java
index df8ac8dfc..f261651fe 100644
--- a/observer/src/main/java/com/iluwatar/observer/App.java
+++ b/observer/src/main/java/com/iluwatar/observer/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.observer;
 import com.iluwatar.observer.generic.GHobbits;
 import com.iluwatar.observer.generic.GOrcs;
 import com.iluwatar.observer.generic.GWeather;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Observer pattern is a software design pattern in which an object, called the subject,
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * <p>In this example {@link Weather} has a state that can be observed. The {@link Orcs} and {@link
  * Hobbits} register as observers and receive notifications when the {@link Weather} changes.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/observer/src/main/java/com/iluwatar/observer/Hobbits.java b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
index 09ac75ceb..c6c8a295c 100644
--- a/observer/src/main/java/com/iluwatar/observer/Hobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
@@ -23,18 +23,16 @@
 
 package com.iluwatar.observer;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Hobbits.
  */
+@Slf4j
 public class Hobbits implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class);
-
   @Override
   public void update(WeatherType currentWeather) {
-    LOGGER.info("The hobbits are facing " + currentWeather.getDescription() + " weather now");
+    LOGGER.info("The hobbits are facing {} weather now", currentWeather.getDescription());
   }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/Orcs.java b/observer/src/main/java/com/iluwatar/observer/Orcs.java
index 396ae78d8..0f3307b71 100644
--- a/observer/src/main/java/com/iluwatar/observer/Orcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/Orcs.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.observer;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Orcs.
  */
+@Slf4j
 public class Orcs implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class);
-
   @Override
   public void update(WeatherType currentWeather) {
     LOGGER.info("The orcs are facing " + currentWeather.getDescription() + " weather now");
diff --git a/observer/src/main/java/com/iluwatar/observer/Weather.java b/observer/src/main/java/com/iluwatar/observer/Weather.java
index 70ad63345..0ee7f7f73 100644
--- a/observer/src/main/java/com/iluwatar/observer/Weather.java
+++ b/observer/src/main/java/com/iluwatar/observer/Weather.java
@@ -25,17 +25,15 @@ package com.iluwatar.observer;
 
 import java.util.ArrayList;
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Weather can be observed by implementing {@link WeatherObserver} interface and registering as
  * listener.
  */
+@Slf4j
 public class Weather {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class);
-
   private WeatherType currentWeather;
   private final List<WeatherObserver> observers;
 
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
index 1e6f99aee..fd410d78d 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
@@ -24,16 +24,14 @@
 package com.iluwatar.observer.generic;
 
 import com.iluwatar.observer.WeatherType;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * GHobbits.
  */
+@Slf4j
 public class GHobbits implements Race {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(GHobbits.class);
-
   @Override
   public void update(GWeather weather, WeatherType weatherType) {
     LOGGER.info("The hobbits are facing " + weatherType.getDescription() + " weather now");
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
index 59e4dfd54..410550353 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
@@ -24,16 +24,14 @@
 package com.iluwatar.observer.generic;
 
 import com.iluwatar.observer.WeatherType;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * GOrcs.
  */
+@Slf4j
 public class GOrcs implements Race {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(GOrcs.class);
-
   @Override
   public void update(GWeather weather, WeatherType weatherType) {
     LOGGER.info("The orcs are facing " + weatherType.getDescription() + " weather now");
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
index 46d44bd83..e829ebeb8 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
@@ -24,16 +24,14 @@
 package com.iluwatar.observer.generic;
 
 import com.iluwatar.observer.WeatherType;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * GWeather.
  */
+@Slf4j
 public class GWeather extends Observable<GWeather, Race, WeatherType> {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(GWeather.class);
-
   private WeatherType currentWeather;
 
   public GWeather() {
diff --git a/observer/src/test/java/com/iluwatar/observer/AppTest.java b/observer/src/test/java/com/iluwatar/observer/AppTest.java
index e16a59872..059fadd31 100644
--- a/observer/src/test/java/com/iluwatar/observer/AppTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/AppTest.java
@@ -23,12 +23,12 @@
 
 package com.iluwatar.observer;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
- * 
+ *
  * Application test
  *
  */
diff --git a/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java b/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
index 67d3f2068..455d07a1d 100644
--- a/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/HobbitsTest.java
@@ -36,10 +36,10 @@ public class HobbitsTest extends WeatherObserverTest<Hobbits> {
   @Override
   public Collection<Object[]> dataProvider() {
     return List.of(
-            new Object[]{WeatherType.SUNNY, "The hobbits are facing Sunny weather now"},
-            new Object[]{WeatherType.RAINY, "The hobbits are facing Rainy weather now"},
-            new Object[]{WeatherType.WINDY, "The hobbits are facing Windy weather now"},
-            new Object[]{WeatherType.COLD, "The hobbits are facing Cold weather now"});
+        new Object[]{WeatherType.SUNNY, "The hobbits are facing Sunny weather now"},
+        new Object[]{WeatherType.RAINY, "The hobbits are facing Rainy weather now"},
+        new Object[]{WeatherType.WINDY, "The hobbits are facing Windy weather now"},
+        new Object[]{WeatherType.COLD, "The hobbits are facing Cold weather now"});
   }
 
   /**
diff --git a/observer/src/test/java/com/iluwatar/observer/OrcsTest.java b/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
index 40af6638a..446628618 100644
--- a/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/OrcsTest.java
@@ -36,10 +36,10 @@ public class OrcsTest extends WeatherObserverTest<Orcs> {
   @Override
   public Collection<Object[]> dataProvider() {
     return List.of(
-            new Object[]{WeatherType.SUNNY, "The orcs are facing Sunny weather now"},
-            new Object[]{WeatherType.RAINY, "The orcs are facing Rainy weather now"},
-            new Object[]{WeatherType.WINDY, "The orcs are facing Windy weather now"},
-            new Object[]{WeatherType.COLD, "The orcs are facing Cold weather now"});
+        new Object[]{WeatherType.SUNNY, "The orcs are facing Sunny weather now"},
+        new Object[]{WeatherType.RAINY, "The orcs are facing Rainy weather now"},
+        new Object[]{WeatherType.WINDY, "The orcs are facing Windy weather now"},
+        new Object[]{WeatherType.COLD, "The orcs are facing Cold weather now"});
   }
 
   /**
diff --git a/observer/src/test/java/com/iluwatar/observer/WeatherTest.java b/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
index c2ca327e4..938331299 100644
--- a/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/WeatherTest.java
@@ -23,12 +23,6 @@
 
 package com.iluwatar.observer;
 
-import com.iluwatar.observer.utils.InMemoryAppender;
-import org.junit.jupiter.api.AfterEach;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-import org.mockito.InOrder;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.mockito.Mockito.inOrder;
 import static org.mockito.Mockito.mock;
@@ -36,6 +30,11 @@ import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.verifyNoMoreInteractions;
 import static org.mockito.Mockito.verifyZeroInteractions;
 
+import com.iluwatar.observer.utils.InMemoryAppender;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
 /**
  * Date: 12/27/15 - 11:08 AM
  *
@@ -60,7 +59,7 @@ public class WeatherTest {
    * observer again and verify that there are no more notifications.
    */
   @Test
-  public void testAddRemoveObserver() {
+  void testAddRemoveObserver() {
     final var observer = mock(WeatherObserver.class);
 
     final var weather = new Weather();
@@ -83,7 +82,7 @@ public class WeatherTest {
    * Verify if the weather passes in the order of the {@link WeatherType}s
    */
   @Test
-  public void testTimePasses() {
+  void testTimePasses() {
     final var observer = mock(WeatherObserver.class);
     final var weather = new Weather();
     weather.addObserver(observer);
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java b/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
index 5fef1a3cd..252778ef6 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/GHobbitsTest.java
@@ -38,10 +38,10 @@ public class GHobbitsTest extends ObserverTest<GHobbits> {
   @Override
   public Collection<Object[]> dataProvider() {
     return List.of(
-            new Object[]{WeatherType.SUNNY, "The hobbits are facing Sunny weather now"},
-            new Object[]{WeatherType.RAINY, "The hobbits are facing Rainy weather now"},
-            new Object[]{WeatherType.WINDY, "The hobbits are facing Windy weather now"},
-            new Object[]{WeatherType.COLD, "The hobbits are facing Cold weather now"}
+        new Object[]{WeatherType.SUNNY, "The hobbits are facing Sunny weather now"},
+        new Object[]{WeatherType.RAINY, "The hobbits are facing Rainy weather now"},
+        new Object[]{WeatherType.WINDY, "The hobbits are facing Windy weather now"},
+        new Object[]{WeatherType.COLD, "The hobbits are facing Cold weather now"}
     );
   }
 
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java b/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
index 6f062e048..2c2721e24 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/GWeatherTest.java
@@ -23,16 +23,19 @@
 
 package com.iluwatar.observer.generic;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.inOrder;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoMoreInteractions;
+import static org.mockito.Mockito.verifyZeroInteractions;
+
 import com.iluwatar.observer.WeatherObserver;
 import com.iluwatar.observer.WeatherType;
 import com.iluwatar.observer.utils.InMemoryAppender;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
-import org.mockito.InOrder;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.mockito.Mockito.*;
 
 /**
  * Date: 12/27/15 - 11:08 AM
@@ -58,7 +61,7 @@ public class GWeatherTest {
    * observer again and verify that there are no more notifications.
    */
   @Test
-  public void testAddRemoveObserver() {
+  void testAddRemoveObserver() {
     final var observer = mock(Race.class);
 
     final var weather = new GWeather();
@@ -81,7 +84,7 @@ public class GWeatherTest {
    * Verify if the weather passes in the order of the {@link WeatherType}s
    */
   @Test
-  public void testTimePasses() {
+  void testTimePasses() {
     final var observer = mock(Race.class);
     final var weather = new GWeather();
     weather.addObserver(observer);
diff --git a/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java b/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
index 5f0cef1d6..cb27ed1b4 100644
--- a/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/generic/OrcsTest.java
@@ -38,10 +38,10 @@ public class OrcsTest extends ObserverTest<GOrcs> {
   @Override
   public Collection<Object[]> dataProvider() {
     return List.of(
-            new Object[]{WeatherType.SUNNY, "The orcs are facing Sunny weather now"},
-            new Object[]{WeatherType.RAINY, "The orcs are facing Rainy weather now"},
-            new Object[]{WeatherType.WINDY, "The orcs are facing Windy weather now"},
-            new Object[]{WeatherType.COLD, "The orcs are facing Cold weather now"}
+        new Object[]{WeatherType.SUNNY, "The orcs are facing Sunny weather now"},
+        new Object[]{WeatherType.RAINY, "The orcs are facing Rainy weather now"},
+        new Object[]{WeatherType.WINDY, "The orcs are facing Windy weather now"},
+        new Object[]{WeatherType.COLD, "The orcs are facing Cold weather now"}
     );
   }
 
diff --git a/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java b/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
index f3f152518..bb5b6d952 100644
--- a/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
+++ b/page-object/sample-application/src/main/java/com/iluwatar/pageobject/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.pageobject;
 import java.awt.Desktop;
 import java.io.File;
 import java.io.IOException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Page Object pattern wraps an UI component with an application specific API allowing you to
@@ -49,10 +48,9 @@ import org.slf4j.LoggerFactory;
  * example is just to provide a simple version that showcase the intentions of this pattern and how
  * this pattern is used in order to understand it.
  */
+@Slf4j
 public final class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private App() {
   }
 
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
index ff35635cf..4dce7aabc 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
@@ -27,7 +27,6 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.gargoylesoftware.htmlunit.WebClient;
 import com.iluwatar.pageobject.pages.AlbumListPage;
-import com.iluwatar.pageobject.pages.AlbumPage;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
@@ -44,7 +43,7 @@ public class AlbumListPageTest {
   }
 
   @Test
-  public void testSelectAlbum() {
+  void testSelectAlbum() {
     var albumPage = albumListPage.selectAlbum("21");
     albumPage.navigateToPage();
     assertTrue(albumPage.isAt());
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
index a68bf51ad..55af9746e 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
@@ -26,7 +26,6 @@ package com.iluwatar.pageobject;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.gargoylesoftware.htmlunit.WebClient;
-import com.iluwatar.pageobject.pages.AlbumListPage;
 import com.iluwatar.pageobject.pages.AlbumPage;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -44,7 +43,7 @@ public class AlbumPageTest {
   }
 
   @Test
-  public void testSaveAlbum() {
+  void testSaveAlbum() {
 
     var albumPageAfterChanges = albumPage
         .changeAlbumTitle("25")
@@ -59,7 +58,7 @@ public class AlbumPageTest {
   }
 
   @Test
-  public void testCancelChanges() {
+  void testCancelChanges() {
     var albumListPage = albumPage.cancelChanges();
     albumListPage.navigateToPage();
     assertTrue(albumListPage.isAt());
diff --git a/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java b/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
index a3ee088e5..8ba1e92fd 100644
--- a/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
+++ b/page-object/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
@@ -26,7 +26,6 @@ package com.iluwatar.pageobject;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
 import com.gargoylesoftware.htmlunit.WebClient;
-import com.iluwatar.pageobject.pages.AlbumListPage;
 import com.iluwatar.pageobject.pages.LoginPage;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -44,7 +43,7 @@ public class LoginPageTest {
   }
 
   @Test
-  public void testLogin() {
+  void testLogin() {
     var albumListPage = loginPage
         .enterUsername("admin")
         .enterPassword("password")
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
index f943ee178..71a28651a 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumListPage.java
@@ -28,15 +28,13 @@ import com.gargoylesoftware.htmlunit.html.HtmlAnchor;
 import com.gargoylesoftware.htmlunit.html.HtmlPage;
 import java.io.IOException;
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Page Object encapsulating the Album List page (album-list.html)
  */
+@Slf4j
 public class AlbumListPage extends Page {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(AlbumListPage.class);
   private static final String ALBUM_LIST_HTML_FILE = "album-list.html";
   private static final String PAGE_URL = "file:" + AUT_PATH + ALBUM_LIST_HTML_FILE;
 
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
index ca238222f..67339f161 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/AlbumPage.java
@@ -30,15 +30,13 @@ import com.gargoylesoftware.htmlunit.html.HtmlSelect;
 import com.gargoylesoftware.htmlunit.html.HtmlSubmitInput;
 import com.gargoylesoftware.htmlunit.html.HtmlTextInput;
 import java.io.IOException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Page Object encapsulating the Album Page (album-page.html)
  */
+@Slf4j
 public class AlbumPage extends Page {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(AlbumPage.class);
   private static final String ALBUM_PAGE_HTML_FILE = "album-page.html";
   private static final String PAGE_URL = "file:" + AUT_PATH + ALBUM_PAGE_HTML_FILE;
 
diff --git a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
index e5a0d5053..78b559b4a 100644
--- a/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
+++ b/page-object/test-automation/src/main/java/com/iluwatar/pageobject/LoginPage.java
@@ -29,15 +29,13 @@ import com.gargoylesoftware.htmlunit.html.HtmlPasswordInput;
 import com.gargoylesoftware.htmlunit.html.HtmlSubmitInput;
 import com.gargoylesoftware.htmlunit.html.HtmlTextInput;
 import java.io.IOException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Page Object encapsulating the Login Page (login.html)
  */
+@Slf4j
 public class LoginPage extends Page {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(LoginPage.class);
   private static final String LOGIN_PAGE_HTML_FILE = "login.html";
   private static final String PAGE_URL = "file:" + AUT_PATH + LOGIN_PAGE_HTML_FILE;
 
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
index c5d8fc701..58052583f 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumListPageTest.java
@@ -42,7 +42,7 @@ public class AlbumListPageTest {
   }
 
   @Test
-  public void testSelectAlbum() {
+  void testSelectAlbum() {
     var albumPage = albumListPage.selectAlbum("21");
     albumPage.navigateToPage();
     assertTrue(albumPage.isAt());
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
index 27af5713d..99a141f53 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/AlbumPageTest.java
@@ -42,7 +42,7 @@ public class AlbumPageTest {
   }
 
   @Test
-  public void testSaveAlbum() {
+  void testSaveAlbum() {
 
     var albumPageAfterChanges = albumPage
         .changeAlbumTitle("25")
@@ -57,7 +57,7 @@ public class AlbumPageTest {
   }
 
   @Test
-  public void testCancelChanges() {
+  void testCancelChanges() {
     var albumListPage = albumPage.cancelChanges();
     albumListPage.navigateToPage();
     assertTrue(albumListPage.isAt());
diff --git a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
index 80b0ba8d4..bd3333706 100644
--- a/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
+++ b/page-object/test-automation/src/test/java/com/iluwatar/pageobject/LoginPageTest.java
@@ -42,7 +42,7 @@ public class LoginPageTest {
   }
 
   @Test
-  public void testLogin() {
+  void testLogin() {
     var albumListPage = loginPage
         .enterUsername("admin")
         .enterPassword("password")
diff --git a/partial-response/src/main/java/com/iluwatar/partialresponse/App.java b/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
index 58d50d4c2..ba842bc1d 100644
--- a/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
+++ b/partial-response/src/main/java/com/iluwatar/partialresponse/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.partialresponse;
 
 import java.util.Map;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Partial response pattern is a design pattern in which client specifies fields to fetch to
@@ -35,8 +34,8 @@ import org.slf4j.LoggerFactory;
  * <p>{@link VideoResource} act as server to serve video information.
  */
 
+@Slf4j
 public class App {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   /**
    * Method as act client and request to server for video details.
diff --git a/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java b/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
index e54085be8..0e45226c9 100644
--- a/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
+++ b/pipeline/src/test/java/com/iluwatar/pipeline/PipelineTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
 public class PipelineTest {
 
   @Test
-  public void testAddHandlersToPipeline() {
+  void testAddHandlersToPipeline() {
     var filters = new Pipeline<>(new RemoveAlphabetsHandler())
         .addHandler(new RemoveDigitsHandler())
         .addHandler(new ConvertToCharArrayHandler());
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
index b0264c298..0992bdaf1 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
@@ -24,16 +24,14 @@
 package com.iluwatar.poison.pill;
 
 import com.iluwatar.poison.pill.Message.Headers;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class responsible for receiving and handling submitted to the queue messages.
  */
+@Slf4j
 public class Consumer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Consumer.class);
-
   private final MqSubscribePoint queue;
   private final String name;
 
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
index 5df72daf2..f303c2b9f 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
@@ -25,17 +25,15 @@ package com.iluwatar.poison.pill;
 
 import com.iluwatar.poison.pill.Message.Headers;
 import java.util.Date;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class responsible for producing unit of work that can be expressed as message and submitted to
  * queue.
  */
+@Slf4j
 public class Producer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Producer.class);
-
   private final MqPublishPoint queue;
   private final String name;
   private boolean isStopped;
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
index 2b6105133..cbc274b6f 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/ConsumerTest.java
@@ -56,7 +56,7 @@ public class ConsumerTest {
   }
 
   @Test
-  public void testConsume() throws Exception {
+  void testConsume() throws Exception {
     final var messages = List.of(
         createMessage("you", "Hello!"),
         createMessage("me", "Hi!"),
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
index 30e57708b..5a0deb61d 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/PoisonMessageTest.java
@@ -37,33 +37,33 @@ import org.junit.jupiter.api.Test;
 public class PoisonMessageTest {
 
   @Test
-  public void testAddHeader() {
+  void testAddHeader() {
     assertThrows(UnsupportedOperationException.class, () -> {
       POISON_PILL.addHeader(Headers.SENDER, "sender");
     });
   }
 
   @Test
-  public void testGetHeader() {
+  void testGetHeader() {
     assertThrows(UnsupportedOperationException.class, () -> {
       POISON_PILL.getHeader(Headers.SENDER);
     });
   }
 
   @Test
-  public void testGetHeaders() {
+  void testGetHeaders() {
     assertThrows(UnsupportedOperationException.class, POISON_PILL::getHeaders);
   }
 
   @Test
-  public void testSetBody() {
+  void testSetBody() {
     assertThrows(UnsupportedOperationException.class, () -> {
       POISON_PILL.setBody("Test message.");
     });
   }
 
   @Test
-  public void testGetBody() {
+  void testGetBody() {
     assertThrows(UnsupportedOperationException.class, POISON_PILL::getBody);
   }
 
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
index 3b6545c0f..8bcc1fe3f 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/ProducerTest.java
@@ -43,7 +43,7 @@ import org.mockito.ArgumentCaptor;
 public class ProducerTest {
 
   @Test
-  public void testSend() throws Exception {
+  void testSend() throws Exception {
     final var publishPoint = mock(MqPublishPoint.class);
     final var producer = new Producer("producer", publishPoint);
     verifyZeroInteractions(publishPoint);
@@ -63,7 +63,7 @@ public class ProducerTest {
   }
 
   @Test
-  public void testStop() throws Exception {
+  void testStop() throws Exception {
     final var publishPoint = mock(MqPublishPoint.class);
     final var producer = new Producer("producer", publishPoint);
     verifyZeroInteractions(publishPoint);
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
index 1295d8234..72ecf9c32 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/SimpleMessageTest.java
@@ -39,7 +39,7 @@ import org.junit.jupiter.api.Test;
 public class SimpleMessageTest {
 
   @Test
-  public void testGetHeaders() {
+  void testGetHeaders() {
     final var message = new SimpleMessage();
     assertNotNull(message.getHeaders());
     assertTrue(message.getHeaders().isEmpty());
@@ -52,7 +52,7 @@ public class SimpleMessageTest {
   }
 
   @Test
-  public void testUnModifiableHeaders() {
+  void testUnModifiableHeaders() {
     final var message = new SimpleMessage();
     final var headers = message.getHeaders();
     assertThrows(UnsupportedOperationException.class, () -> {
diff --git a/pom.xml b/pom.xml
index 54944b78c..7e332a436 100644
--- a/pom.xml
+++ b/pom.xml
@@ -27,7 +27,7 @@
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
-    
+
     <groupId>com.iluwatar</groupId>
     <artifactId>java-design-patterns</artifactId>
     <version>1.24.0-SNAPSHOT</version>
@@ -46,7 +46,6 @@
         <junit.version>4.12</junit.version>
         <junit-jupiter.version>5.7.1</junit-jupiter.version>
         <junit-vintage.version>${junit-jupiter.version}</junit-vintage.version>
-        <sping-test-junit5.version>1.0.2</sping-test-junit5.version>
         <compiler.version>3.8.1</compiler.version>
         <jacoco.version>0.8.6</jacoco.version>
         <commons-dbcp.version>1.4</commons-dbcp.version>
@@ -68,6 +67,7 @@
         <system-lambda.version>1.1.0</system-lambda.version>
         <urm.version>2.0.0</urm.version>
         <mockito-junit-jupiter.version>3.5.0</mockito-junit-jupiter.version>
+        <lombok.version>1.18.14</lombok.version>
         <byte-buddy.version>1.10.21</byte-buddy.version>
         <javassist.version>3.27.0-GA</javassist.version>
         <maven-surefire-plugin.version>3.0.0-M5</maven-surefire-plugin.version>
@@ -316,12 +316,6 @@
                 <version>${junit-vintage.version}</version>
                 <scope>test</scope>
             </dependency>
-            <dependency>
-                <groupId>com.github.sbrannen</groupId>
-                <artifactId>spring-test-junit5</artifactId>
-                <version>${sping-test-junit5.version}</version>
-                <scope>test</scope>
-            </dependency>
             <dependency>
                 <groupId>org.mockito</groupId>
                 <artifactId>mockito-core</artifactId>
@@ -393,6 +387,12 @@
             <artifactId>logback-core</artifactId>
             <version>${logback.version}</version>
         </dependency>
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <version>${lombok.version}</version>
+            <scope>provided</scope>
+        </dependency>
     </dependencies>
 
     <build>
diff --git a/priority-queue/README.md b/priority-queue/README.md
index 8481915be..f657b80c7 100644
--- a/priority-queue/README.md
+++ b/priority-queue/README.md
@@ -122,10 +122,9 @@ public class QueueManager {
 `Worker` constantly polls `QueueManager` for highest priority message and processes it.
 
 ```java
+@Slf4j
 public class Worker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
-
   private final QueueManager queueManager;
 
   public Worker(QueueManager queueManager) {
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
index 6994c9d23..a52893f46 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/PriorityMessageQueue.java
@@ -25,18 +25,16 @@ package com.iluwatar.priority.queue;
 
 import static java.util.Arrays.copyOf;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Keep high Priority message on top using maxHeap.
  *
  * @param <T> :  DataType to push in Queue
  */
+@Slf4j
 public class PriorityMessageQueue<T extends Comparable> {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PriorityMessageQueue.class);
-
   private int size = 0;
 
   private int capacity;
diff --git a/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java b/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
index 979984e62..e86aa2cf0 100644
--- a/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
+++ b/priority-queue/src/main/java/com/iluwatar/priority/queue/Worker.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.priority.queue;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Message Worker.
  */
+@Slf4j
 public class Worker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
-
   private final QueueManager queueManager;
 
   public Worker(QueueManager queueManager) {
diff --git a/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java b/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
index 1921dec5b..b6ae4670e 100644
--- a/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
+++ b/priority-queue/src/test/java/com/iluwatar/priority/queue/PriorityMessageQueueTest.java
@@ -35,7 +35,7 @@ public class PriorityMessageQueueTest {
 
 
   @Test
-  public void remove() {
+  void remove() {
     var stringPriorityMessageQueue = new PriorityMessageQueue<>(new String[2]);
     var pushMessage = "test";
     stringPriorityMessageQueue.add(pushMessage);
@@ -43,7 +43,7 @@ public class PriorityMessageQueueTest {
   }
 
   @Test
-  public void add() {
+  void add() {
     var stringPriorityMessageQueue = new PriorityMessageQueue<>(new Integer[2]);
     stringPriorityMessageQueue.add(1);
     stringPriorityMessageQueue.add(5);
@@ -53,7 +53,7 @@ public class PriorityMessageQueueTest {
   }
 
   @Test
-  public void isEmpty() {
+  void isEmpty() {
     var stringPriorityMessageQueue = new PriorityMessageQueue<>(new Integer[2]);
     assertTrue(stringPriorityMessageQueue.isEmpty());
     stringPriorityMessageQueue.add(1);
@@ -62,7 +62,7 @@ public class PriorityMessageQueueTest {
   }
 
   @Test
-  public void testEnsureSize() {
+  void testEnsureSize() {
     var stringPriorityMessageQueue = new PriorityMessageQueue<>(new Integer[2]);
     assertTrue(stringPriorityMessageQueue.isEmpty());
     stringPriorityMessageQueue.add(1);
diff --git a/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java b/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
index 73463fb52..d9f5e4527 100644
--- a/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
+++ b/priority-queue/src/test/java/com/iluwatar/priority/queue/QueueManagerTest.java
@@ -33,7 +33,7 @@ import org.junit.jupiter.api.Test;
 public class QueueManagerTest {
 
   @Test
-  public void publishMessage() {
+  void publishMessage() {
     var queueManager = new QueueManager(2);
     var testMessage = new Message("Test Message", 1);
     queueManager.publishMessage(testMessage);
@@ -42,7 +42,7 @@ public class QueueManagerTest {
   }
 
   @Test
-  public void receiveMessage() {
+  void receiveMessage() {
     var queueManager = new QueueManager(2);
     var testMessage1 = new Message("Test Message 1", 1);
     queueManager.publishMessage(testMessage1);
diff --git a/private-class-data/README.md b/private-class-data/README.md
index 5d0e6eb51..e4f1f0969 100644
--- a/private-class-data/README.md
+++ b/private-class-data/README.md
@@ -37,8 +37,8 @@ Taking our stew example from above. First we have a `Stew` class where its data
 private class data, making the stew's ingredient mutable to class methods. 
 
 ```java
+@Slf4j
 public class Stew {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Stew.class);
   private int numPotatoes;
   private int numCarrots;
   private int numMeat;
@@ -99,8 +99,8 @@ public class StewData {
     return numPeppers;
   }
 }
+@Slf4j
 public class ImmutableStew {
-  private static final Logger LOGGER = LoggerFactory.getLogger(ImmutableStew.class);
   private final StewData data;
   public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
     data = new StewData(numPotatoes, numCarrots, numMeat, numPeppers);
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
index 49aef81e1..04b18490d 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.privateclassdata;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Immutable stew class, protected with Private Class Data pattern.
  */
+@Slf4j
 public class ImmutableStew {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ImmutableStew.class);
-
   private final StewData data;
 
   public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
index e4b80457a..25fa0a530 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.privateclassdata;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Mutable stew class.
  */
+@Slf4j
 public class Stew {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Stew.class);
-
   private int numPotatoes;
   private int numCarrots;
   private int numMeat;
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
index e8cfcbc5d..7b4d85ba1 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/ImmutableStewTest.java
@@ -53,7 +53,7 @@ public class ImmutableStewTest {
    * Verify if mixing the stew doesn't change the internal state
    */
   @Test
-  public void testMix() {
+  void testMix() {
     var stew = new Stew(1, 2, 3, 4);
     var expectedMessage = "Mixing the stew we find: 1 potatoes, 2 carrots, 3 meat and 4 peppers";
 
@@ -69,7 +69,7 @@ public class ImmutableStewTest {
    * Verify if tasting the stew actually removes one of each ingredient
    */
   @Test
-  public void testDrink() {
+  void testDrink() {
     final var stew = new Stew(1, 2, 3, 4);
     stew.mix();
 
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
index 07b512b75..6474c5e48 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/StewTest.java
@@ -53,7 +53,7 @@ public class StewTest {
    * Verify if mixing the stew doesn't change the internal state
    */
   @Test
-  public void testMix() {
+  void testMix() {
     final var stew = new ImmutableStew(1, 2, 3, 4);
     final var expectedMessage = "Mixing the immutable stew we find: 1 potatoes, "
         + "2 carrots, 3 meat and 4 peppers";
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
index 18f1cc1ff..089494742 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
@@ -23,11 +23,9 @@
 
 package com.iluwatar.producer.consumer;
 
-import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Producer Consumer Design pattern is a classic concurrency or threading pattern which reduces
@@ -39,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * different timing require to produce item or consuming item. by using producer consumer pattern
  * both Producer and Consumer Thread can work with different speed.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
index 0b4149558..9fc16df66 100644
--- a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.producer.consumer;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class responsible for consume the {@link Item} produced by {@link Producer}.
  */
+@Slf4j
 public class Consumer {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Consumer.class);
-
   private final ItemQueue queue;
 
   private final String name;
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
index 8e7ad61f8..a0345cae2 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ConsumerTest.java
@@ -40,7 +40,7 @@ public class ConsumerTest {
   private static final int ITEM_COUNT = 5;
 
   @Test
-  public void testConsume() throws Exception {
+  void testConsume() throws Exception {
     final var queue = spy(new ItemQueue());
     for (var id = 0; id < ITEM_COUNT; id++) {
       queue.put(new Item("producer", id));
diff --git a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
index 2b386d305..a95efa84f 100644
--- a/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
+++ b/producer-consumer/src/test/java/com/iluwatar/producer/consumer/ProducerTest.java
@@ -40,7 +40,7 @@ import org.junit.jupiter.api.Test;
 public class ProducerTest {
 
   @Test
-  public void testProduce() {
+  void testProduce() {
     assertTimeout(ofMillis(6000), () -> {
       final var queue = mock(ItemQueue.class);
       final var producer = new Producer("producer", queue);
diff --git a/promise/src/main/java/com/iluwatar/promise/App.java b/promise/src/main/java/com/iluwatar/promise/App.java
index 440478f38..a53b759c9 100644
--- a/promise/src/main/java/com/iluwatar/promise/App.java
+++ b/promise/src/main/java/com/iluwatar/promise/App.java
@@ -29,8 +29,7 @@ import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Promise object is used for asynchronous computations. A Promise represents an operation that
@@ -60,10 +59,9 @@ import org.slf4j.LoggerFactory;
  *
  * @see CompletableFuture
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private static final String DEFAULT_URL =
       "https://raw.githubusercontent.com/iluwatar/java-design-patterns/master/promise/README.md";
   private final ExecutorService executor;
diff --git a/promise/src/main/java/com/iluwatar/promise/Utility.java b/promise/src/main/java/com/iluwatar/promise/Utility.java
index b55c48a93..544d7e53b 100644
--- a/promise/src/main/java/com/iluwatar/promise/Utility.java
+++ b/promise/src/main/java/com/iluwatar/promise/Utility.java
@@ -36,16 +36,14 @@ import java.util.Map;
 import java.util.Map.Entry;
 import java.util.function.Function;
 import java.util.stream.Collectors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Utility to perform various operations.
  */
+@Slf4j
 public class Utility {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Utility.class);
-
   /**
    * Calculates character frequency of the file provided.
    *
diff --git a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
index f3450ee00..2c35fb124 100644
--- a/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
+++ b/promise/src/test/java/com/iluwatar/promise/PromiseTest.java
@@ -36,7 +36,6 @@ import java.util.concurrent.ExecutionException;
 import java.util.concurrent.Executor;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
 import java.util.function.Consumer;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
@@ -44,7 +43,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests Promise class.
  */
-public class PromiseTest {
+class PromiseTest {
 
   private Executor executor;
   private Promise<Integer> promise;
@@ -56,7 +55,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void promiseIsFulfilledWithTheResultantValueOfExecutingTheTask()
+  void promiseIsFulfilledWithTheResultantValueOfExecutingTheTask()
       throws InterruptedException, ExecutionException {
     promise.fulfillInAsync(new NumberCrunchingTask(), executor);
 
@@ -66,7 +65,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void promiseIsFulfilledWithAnExceptionIfTaskThrowsAnException()
+  void promiseIsFulfilledWithAnExceptionIfTaskThrowsAnException()
       throws InterruptedException {
     testWaitingForeverForPromiseToBeFulfilled();
     testWaitingSomeTimeForPromiseToBeFulfilled();
@@ -120,7 +119,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void dependentPromiseIsFulfilledAfterTheConsumerConsumesTheResultOfThisPromise()
+  void dependentPromiseIsFulfilledAfterTheConsumerConsumesTheResultOfThisPromise()
       throws InterruptedException, ExecutionException {
     var dependentPromise = promise
         .fulfillInAsync(new NumberCrunchingTask(), executor)
@@ -132,7 +131,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void dependentPromiseIsFulfilledWithAnExceptionIfConsumerThrowsAnException()
+  void dependentPromiseIsFulfilledWithAnExceptionIfConsumerThrowsAnException()
       throws InterruptedException {
     var dependentPromise = promise
         .fulfillInAsync(new NumberCrunchingTask(), executor)
@@ -160,7 +159,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void dependentPromiseIsFulfilledAfterTheFunctionTransformsTheResultOfThisPromise()
+  void dependentPromiseIsFulfilledAfterTheFunctionTransformsTheResultOfThisPromise()
       throws InterruptedException, ExecutionException {
     var dependentPromise = promise
         .fulfillInAsync(new NumberCrunchingTask(), executor)
@@ -176,7 +175,7 @@ public class PromiseTest {
   }
 
   @Test
-  public void dependentPromiseIsFulfilledWithAnExceptionIfTheFunctionThrowsException()
+  void dependentPromiseIsFulfilledWithAnExceptionIfTheFunctionThrowsException()
       throws InterruptedException {
     var dependentPromise = promise
         .fulfillInAsync(new NumberCrunchingTask(), executor)
@@ -204,17 +203,18 @@ public class PromiseTest {
   }
 
   @Test
-  public void fetchingAnAlreadyFulfilledPromiseReturnsTheFulfilledValueImmediately()
+  void fetchingAnAlreadyFulfilledPromiseReturnsTheFulfilledValueImmediately()
       throws ExecutionException {
     var promise = new Promise<Integer>();
     promise.fulfill(NumberCrunchingTask.CRUNCHED_NUMBER);
 
-    promise.get(1000, TimeUnit.SECONDS);
+    Integer result = promise.get(1000, TimeUnit.SECONDS);
+    assertEquals(NumberCrunchingTask.CRUNCHED_NUMBER, result);
   }
 
   @SuppressWarnings("unchecked")
   @Test
-  public void exceptionHandlerIsCalledWhenPromiseIsFulfilledExceptionally() {
+  void exceptionHandlerIsCalledWhenPromiseIsFulfilledExceptionally() {
     var promise = new Promise<>();
     var exceptionHandler = mock(Consumer.class);
     promise.onError(exceptionHandler);
diff --git a/property/src/main/java/com/iluwatar/property/App.java b/property/src/main/java/com/iluwatar/property/App.java
index d646c6787..5979ea84d 100644
--- a/property/src/main/java/com/iluwatar/property/App.java
+++ b/property/src/main/java/com/iluwatar/property/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.property;
 
 import com.iluwatar.property.Character.Type;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Property pattern is also known as Prototype inheritance.
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  *
  * <p>In this example we demonstrate {@link Character} instantiation using the Property pattern.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/property/src/test/java/com/iluwatar/property/CharacterTest.java b/property/src/test/java/com/iluwatar/property/CharacterTest.java
index 59113f28a..228364fba 100644
--- a/property/src/test/java/com/iluwatar/property/CharacterTest.java
+++ b/property/src/test/java/com/iluwatar/property/CharacterTest.java
@@ -40,7 +40,7 @@ import org.junit.jupiter.api.Test;
 public class CharacterTest {
 
   @Test
-  public void testPrototypeStats() throws Exception {
+  void testPrototypeStats() throws Exception {
     final var prototype = new Character();
 
     for (final var stat : Stats.values()) {
@@ -60,7 +60,7 @@ public class CharacterTest {
   }
 
   @Test
-  public void testCharacterStats() {
+  void testCharacterStats() {
     final var prototype = new Character();
     Arrays.stream(Stats.values()).forEach(stat -> prototype.set(stat, stat.ordinal()));
 
@@ -73,7 +73,7 @@ public class CharacterTest {
   }
 
   @Test
-  public void testToString() {
+  void testToString() {
     final var prototype = new Character();
     prototype.set(Stats.ARMOR, 1);
     prototype.set(Stats.AGILITY, 2);
@@ -91,7 +91,7 @@ public class CharacterTest {
   }
 
   @Test
-  public void testName() {
+  void testName() {
     final var prototype = new Character();
     prototype.set(Stats.ARMOR, 1);
     prototype.set(Stats.INTELLECT, 2);
@@ -107,7 +107,7 @@ public class CharacterTest {
   }
 
   @Test
-  public void testType() {
+  void testType() {
     final var prototype = new Character();
     prototype.set(Stats.ARMOR, 1);
     prototype.set(Stats.INTELLECT, 2);
diff --git a/prototype/src/main/java/com/iluwatar/prototype/App.java b/prototype/src/main/java/com/iluwatar/prototype/App.java
index eb81c792d..998106ec9 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/App.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.prototype;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Prototype pattern is a creational design pattern in software development. It is used when the
@@ -36,10 +35,9 @@ import org.slf4j.LoggerFactory;
  * <p>In this example we have a factory class ({@link HeroFactoryImpl}) producing objects by
  * cloning the existing ones. The factory's prototype objects are given as constructor parameters.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Beast.java b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
index 359c1f280..ecae07063 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Beast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
@@ -23,29 +23,20 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
 /**
  * Beast.
  */
+@EqualsAndHashCode
+@NoArgsConstructor
 public abstract class Beast implements Prototype {
 
-  public Beast() {
-  }
-
   public Beast(Beast source) {
   }
 
   @Override
   public abstract Beast copy();
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    return getClass() == obj.getClass();
-  }
-
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
index cfa1e1f3f..830bad95c 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+
 /**
  * ElfBeast.
  */
+@EqualsAndHashCode(callSuper = true)
+@RequiredArgsConstructor
 public class ElfBeast extends Beast {
 
   private final String helpType;
 
-  public ElfBeast(String helpType) {
-    this.helpType = helpType;
-  }
-
   public ElfBeast(ElfBeast elfBeast) {
     super(elfBeast);
     this.helpType = elfBeast.helpType;
@@ -49,22 +50,4 @@ public class ElfBeast extends Beast {
     return "Elven eagle helps in " + helpType;
   }
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (ElfBeast) obj;
-    if (helpType == null) {
-      return other.helpType == null;
-    }
-    return helpType.equals(other.helpType);
-  }
-
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
index 6345749b3..7f5183349 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+
 /**
  * ElfMage.
  */
+@EqualsAndHashCode(callSuper = true)
+@RequiredArgsConstructor
 public class ElfMage extends Mage {
 
   private final String helpType;
 
-  public ElfMage(String helpType) {
-    this.helpType = helpType;
-  }
-
   public ElfMage(ElfMage elfMage) {
     super(elfMage);
     this.helpType = elfMage.helpType;
@@ -49,21 +50,4 @@ public class ElfMage extends Mage {
     return "Elven mage helps in " + helpType;
   }
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (ElfMage) obj;
-    if (helpType == null) {
-      return other.helpType == null;
-    }
-    return helpType.equals(other.helpType);
-  }
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
index c435976a0..b45ae693e 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
@@ -23,9 +23,12 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+
 /**
  * ElfWarlord.
  */
+@EqualsAndHashCode
 public class ElfWarlord extends Warlord {
 
   private final String helpType;
@@ -48,22 +51,4 @@ public class ElfWarlord extends Warlord {
   public String toString() {
     return "Elven warlord helps in " + helpType;
   }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (ElfWarlord) obj;
-    if (helpType == null) {
-      return other.helpType == null;
-    }
-    return helpType.equals(other.helpType);
-  }
 }
\ No newline at end of file
diff --git a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
index f3c67f542..772cb27f8 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
@@ -23,24 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Concrete factory class.
  */
+@RequiredArgsConstructor
 public class HeroFactoryImpl implements HeroFactory {
 
   private final Mage mage;
   private final Warlord warlord;
   private final Beast beast;
 
-  /**
-   * Constructor.
-   */
-  public HeroFactoryImpl(Mage mage, Warlord warlord, Beast beast) {
-    this.mage = mage;
-    this.warlord = warlord;
-    this.beast = beast;
-  }
-
   /**
    * Create mage.
    */
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Mage.java b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
index fb4344c6d..a1a847358 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Mage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
@@ -23,29 +23,20 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
 /**
  * Mage.
  */
+@EqualsAndHashCode
+@NoArgsConstructor
 public abstract class Mage implements Prototype {
 
-  public Mage() {
-  }
-
   public Mage(Mage source) {
   }
 
   @Override
   public abstract Mage copy();
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    return getClass() == obj.getClass();
-  }
-
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
index 032d1c2ab..4c8936356 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+
 /**
  * OrcBeast.
  */
+@EqualsAndHashCode(callSuper = false)
+@RequiredArgsConstructor
 public class OrcBeast extends Beast {
 
   private final String weapon;
 
-  public OrcBeast(String weapon) {
-    this.weapon = weapon;
-  }
-
   public OrcBeast(OrcBeast orcBeast) {
     super(orcBeast);
     this.weapon = orcBeast.weapon;
@@ -49,23 +50,4 @@ public class OrcBeast extends Beast {
     return "Orcish wolf attacks with " + weapon;
   }
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (OrcBeast) obj;
-    if (weapon == null) {
-      return other.weapon == null;
-    }
-    return weapon.equals(other.weapon);
-  }
-
-
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
index 24b62739c..a7361ec80 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+
 /**
  * OrcMage.
  */
+@EqualsAndHashCode(callSuper = true)
+@RequiredArgsConstructor
 public class OrcMage extends Mage {
 
   private final String weapon;
 
-  public OrcMage(String weapon) {
-    this.weapon = weapon;
-  }
-
   public OrcMage(OrcMage orcMage) {
     super(orcMage);
     this.weapon = orcMage.weapon;
@@ -49,21 +50,4 @@ public class OrcMage extends Mage {
     return "Orcish mage attacks with " + weapon;
   }
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (OrcMage) obj;
-    if (weapon == null) {
-      return other.weapon == null;
-    }
-    return weapon.equals(other.weapon);
-  }
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
index 85446fb5a..1096cc979 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
@@ -23,17 +23,18 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.RequiredArgsConstructor;
+
 /**
  * OrcWarlord.
  */
+@EqualsAndHashCode(callSuper = true)
+@RequiredArgsConstructor
 public class OrcWarlord extends Warlord {
 
   private final String weapon;
 
-  public OrcWarlord(String weapon) {
-    this.weapon = weapon;
-  }
-
   public OrcWarlord(OrcWarlord orcWarlord) {
     super(orcWarlord);
     this.weapon = orcWarlord.weapon;
@@ -49,21 +50,4 @@ public class OrcWarlord extends Warlord {
     return "Orcish warlord attacks with " + weapon;
   }
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (!super.equals(obj)) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (OrcWarlord) obj;
-    if (weapon == null) {
-      return other.weapon == null;
-    }
-    return weapon.equals(other.weapon);
-  }
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
index d4135bc7e..7176ccf0c 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
@@ -23,29 +23,20 @@
 
 package com.iluwatar.prototype;
 
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
 /**
  * Warlord.
  */
+@EqualsAndHashCode
+@NoArgsConstructor
 public abstract class Warlord implements Prototype {
 
-  public Warlord() {
-  }
-
   public Warlord(Warlord source) {
   }
 
   @Override
   public abstract Warlord copy();
 
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    return getClass() == obj.getClass();
-  }
-
 }
diff --git a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
index 595f4af6f..757f0aa41 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.prototype;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Application test
  */
diff --git a/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java b/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
index 653f25547..b22f7ba8e 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/PrototypeTest.java
@@ -39,7 +39,7 @@ import org.junit.jupiter.params.provider.MethodSource;
  * @param <P> Prototype
  * @author Jeroen Meulemeester
  */
-public class PrototypeTest<P extends Prototype> {
+class PrototypeTest<P extends Prototype> {
   static Collection<Object[]> dataProvider() {
     return List.of(
         new Object[]{new OrcBeast("axe"), "Orcish wolf attacks with axe"},
@@ -53,7 +53,7 @@ public class PrototypeTest<P extends Prototype> {
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testPrototype(P testedPrototype, String expectedToString) {
+  void testPrototype(P testedPrototype, String expectedToString) {
     assertEquals(expectedToString, testedPrototype.toString());
 
     final var clone = testedPrototype.copy();
diff --git a/proxy/README.md b/proxy/README.md
index edf223b23..5b569d244 100644
--- a/proxy/README.md
+++ b/proxy/README.md
@@ -49,10 +49,9 @@ public interface WizardTower {
   void enter(Wizard wizard);
 }
 
+@Slf4j
 public class IvoryTower implements WizardTower {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class);
-
   public void enter(Wizard wizard) {
     LOGGER.info("{} enters the tower.", wizard);
   }
@@ -81,10 +80,9 @@ public class Wizard {
 Then we have the `WizardTowerProxy` to add access control to `WizardTower`.
 
 ```java
+@Slf4j
 public class WizardTowerProxy implements WizardTower {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(WizardTowerProxy.class);
-
   private static final int NUM_WIZARDS_ALLOWED = 3;
 
   private int numWizards;
diff --git a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
index e359908a9..dd459aac8 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/IvoryTower.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.proxy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The object to be proxied.
  */
+@Slf4j
 public class IvoryTower implements WizardTower {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(IvoryTower.class);
-
   public void enter(Wizard wizard) {
     LOGGER.info("{} enters the tower.", wizard);
   }
diff --git a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
index bdeed212e..c16c32a9c 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
@@ -23,17 +23,16 @@
 
 package com.iluwatar.proxy;
 
+import lombok.RequiredArgsConstructor;
+
 /**
  * Wizard.
  */
+@RequiredArgsConstructor
 public class Wizard {
 
   private final String name;
 
-  public Wizard(String name) {
-    this.name = name;
-  }
-
   @Override
   public String toString() {
     return name;
diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
index 9d8fa5944..9a9f4ab8d 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.proxy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The proxy controlling access to the {@link IvoryTower}.
  */
+@Slf4j
 public class WizardTowerProxy implements WizardTower {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(WizardTowerProxy.class);
-
   private static final int NUM_WIZARDS_ALLOWED = 3;
 
   private int numWizards;
diff --git a/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java b/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
index c1b929458..c054e8048 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/IvoryTowerTest.java
@@ -35,7 +35,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests for {@link IvoryTower}
  */
-public class IvoryTowerTest {
+class IvoryTowerTest {
 
   private InMemoryAppender appender;
 
@@ -50,7 +50,7 @@ public class IvoryTowerTest {
   }
 
   @Test
-  public void testEnter() {
+  void testEnter() {
     final var wizards = List.of(
         new Wizard("Gandalf"),
         new Wizard("Dumbledore"),
diff --git a/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java b/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
index cfcb21b04..0f42c7e54 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/WizardTest.java
@@ -31,10 +31,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests for {@link Wizard}
  */
-public class WizardTest {
+class WizardTest {
 
   @Test
-  public void testToString() {
+  void testToString() {
     List.of("Gandalf", "Dumbledore", "Oz", "Merlin")
         .forEach(name -> assertEquals(name, new Wizard(name).toString()));
   }
diff --git a/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java b/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
index 3314ffe0c..236afc682 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/WizardTowerProxyTest.java
@@ -35,7 +35,7 @@ import org.junit.jupiter.api.Test;
 /**
  * Tests for {@link WizardTowerProxy}
  */
-public class WizardTowerProxyTest {
+class WizardTowerProxyTest {
 
   private InMemoryAppender appender;
 
@@ -50,7 +50,7 @@ public class WizardTowerProxyTest {
   }
 
   @Test
-  public void testEnter() throws Exception {
+  void testEnter() {
     final var wizards = List.of(
         new Wizard("Gandalf"),
         new Wizard("Dumbledore"),
diff --git a/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java b/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
index 8fa13c20f..fc4698bed 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/utils/InMemoryAppender.java
@@ -37,7 +37,7 @@ import org.slf4j.LoggerFactory;
 public class InMemoryAppender extends AppenderBase<ILoggingEvent> {
   private final List<ILoggingEvent> log = new LinkedList<>();
 
-  public InMemoryAppender(Class clazz) {
+  public InMemoryAppender(Class<?> clazz) {
     ((Logger) LoggerFactory.getLogger(clazz)).addAppender(this);
     start();
   }
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
index 430317246..8cac84552 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.queue.load.leveling;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Many solutions in the cloud involve running tasks that invoke services. In this environment, if a
@@ -58,10 +57,9 @@ import org.slf4j.LoggerFactory;
  * MessageQueue. The service executor class {@link ServiceExecutor} will pick up one task at a time
  * from the Queue and execute them.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   //Executor shut down time limit.
   private static final int SHUTDOWN_TIME = 15;
 
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
index aaf0c69a4..c30b27ed8 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/Message.java
@@ -23,22 +23,17 @@
 
 package com.iluwatar.queue.load.leveling;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * Message class with only one parameter.
  */
+@Getter
+@RequiredArgsConstructor
 public class Message {
   private final String msg;
 
-  // Parameter constructor.
-  public Message(String msg) {
-    this.msg = msg;
-  }
-
-  // Get Method for attribute msg.
-  public String getMsg() {
-    return msg;
-  }
-
   @Override
   public String toString() {
     return msg;
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
index c4177ef72..5c03ff8ab 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/MessageQueue.java
@@ -25,17 +25,15 @@ package com.iluwatar.queue.load.leveling;
 
 import java.util.concurrent.ArrayBlockingQueue;
 import java.util.concurrent.BlockingQueue;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * MessageQueue class. In this class we will create a Blocking Queue and submit/retrieve all the
  * messages from it.
  */
+@Slf4j
 public class MessageQueue {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private final BlockingQueue<Message> blkQueue;
 
   // Default constructor when called creates Blocking Queue object. 
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
index 0c9f96143..1828788c3 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/ServiceExecutor.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.queue.load.leveling;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ServiceExecuotr class. This class will pick up Messages one by one from the Blocking Queue and
  * process them.
  */
+@Slf4j
 public class ServiceExecutor implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private final MessageQueue msgQueue;
 
   public ServiceExecutor(MessageQueue msgQueue) {
diff --git a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
index 3b4755b25..19a5077f3 100644
--- a/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
+++ b/queue-load-leveling/src/main/java/com/iluwatar/queue/load/leveling/TaskGenerator.java
@@ -23,18 +23,15 @@
 
 package com.iluwatar.queue.load.leveling;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * TaskGenerator class. Each TaskGenerator thread will be a Worker which submit's messages to the
  * queue. We need to mention the message count for each of the TaskGenerator threads.
  */
+@Slf4j
 public class TaskGenerator implements Task, Runnable {
 
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   // MessageQueue reference using which we will submit our messages.
   private final MessageQueue msgQueue;
 
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
index ff43b3298..08ccfe2de 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageQueueTest.java
@@ -30,10 +30,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Test case for submitting and retrieving messages from Blocking Queue.
  */
-public class MessageQueueTest {
+class MessageQueueTest {
 
   @Test
-  public void messageQueueTest() {
+  void messageQueueTest() {
 
     var msgQueue = new MessageQueue();
 
diff --git a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
index dd14b5144..f18807dd0 100644
--- a/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
+++ b/queue-load-leveling/src/test/java/com/iluwatar/queue/load/leveling/MessageTest.java
@@ -30,10 +30,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Test case for creating and checking the Message.
  */
-public class MessageTest {
+class MessageTest {
 
   @Test
-  public void messageTest() {
+  void messageTest() {
 
     // Parameterized constructor test.
     var testMsg = "Message Test";
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index 1ddd2c34c..4009fdb16 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -35,17 +35,15 @@ import java.net.UnknownHostException;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Represents the clients of Reactor pattern. Multiple clients are run concurrently and send logging
  * requests to Reactor.
  */
+@Slf4j
 public class AppClient {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AppClient.class);
-
   private final ExecutorService service = Executors.newFixedThreadPool(4);
 
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
index a3501971c..fd1bcae78 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
@@ -28,17 +28,15 @@ import com.iluwatar.reactor.framework.ChannelHandler;
 import com.iluwatar.reactor.framework.NioDatagramChannel.DatagramPacket;
 import java.nio.ByteBuffer;
 import java.nio.channels.SelectionKey;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Logging server application logic. It logs the incoming requests on standard console and returns a
  * canned acknowledgement back to the remote peer.
  */
+@Slf4j
 public class LoggingHandler implements ChannelHandler {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(LoggingHandler.class);
-
   private static final byte[] ACK = "Data logged successfully".getBytes();
 
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index fbddc12c6..299e65257 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -30,16 +30,14 @@ import java.net.SocketAddress;
 import java.nio.ByteBuffer;
 import java.nio.channels.DatagramChannel;
 import java.nio.channels.SelectionKey;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A wrapper over {@link DatagramChannel} which can read and write data on a DatagramChannel.
  */
+@Slf4j
 public class NioDatagramChannel extends AbstractNioChannel {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(NioDatagramChannel.class);
-
   private final int port;
 
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index 65a69b646..2db01bf88 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -32,8 +32,7 @@ import java.util.concurrent.ConcurrentLinkedQueue;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This class acts as Synchronous Event De-multiplexer and Initiation Dispatcher of Reactor pattern.
@@ -50,10 +49,9 @@ import org.slf4j.LoggerFactory;
  * possible edge cases which are required in a real application. This implementation is meant to
  * demonstrate the fundamental concepts that lie behind Reactor pattern.
  */
+@Slf4j
 public class NioReactor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(NioReactor.class);
-
   private final Selector selector;
   private final Dispatcher dispatcher;
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index 351ee4b19..97142c58b 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -30,17 +30,15 @@ import java.nio.ByteBuffer;
 import java.nio.channels.SelectionKey;
 import java.nio.channels.ServerSocketChannel;
 import java.nio.channels.SocketChannel;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A wrapper over {@link NioServerSocketChannel} which can read and write data on a {@link
  * SocketChannel}.
  */
+@Slf4j
 public class NioServerSocketChannel extends AbstractNioChannel {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(NioServerSocketChannel.class);
-
   private final int port;
 
   /**
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
index fd3eab523..7e3383b2d 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/ReactorTest.java
@@ -23,23 +23,20 @@
 
 package com.iluwatar.reactor.app;
 
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
 import com.iluwatar.reactor.framework.SameThreadDispatcher;
 import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
 import java.io.IOException;
+import lombok.extern.slf4j.Slf4j;
 import org.junit.jupiter.api.Test;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertNull;
 
 /**
  * This class tests the Distributed Logging service by starting a Reactor and then sending it
  * concurrent logging requests using multiple clients.
  */
-public class ReactorTest {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(ReactorTest.class);
+@Slf4j
+class ReactorTest {
 
   /**
    * Test the application using pooled thread dispatcher.
@@ -48,7 +45,7 @@ public class ReactorTest {
    * @throws InterruptedException if interrupted while stopping the application.
    */
   @Test
-  public void testAppUsingThreadPoolDispatcher() throws IOException, InterruptedException {
+  void testAppUsingThreadPoolDispatcher() throws IOException, InterruptedException {
     LOGGER.info("testAppUsingThreadPoolDispatcher start");
     var app = new App(new ThreadPoolDispatcher(2));
     app.start();
@@ -80,7 +77,7 @@ public class ReactorTest {
    * @throws InterruptedException if interrupted while stopping the application.
    */
   @Test
-  public void testAppUsingSameThreadDispatcher() throws IOException, InterruptedException {
+  void testAppUsingSameThreadDispatcher() throws IOException, InterruptedException {
     LOGGER.info("testAppUsingSameThreadDispatcher start");
     var app = new App(new SameThreadDispatcher());
     app.start();
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
index d703cc691..a857db2d7 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.reader.writer.lock;
 import java.util.concurrent.Executors;
 import java.util.concurrent.ThreadLocalRandom;
 import java.util.concurrent.TimeUnit;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * In a multiple thread applications, the threads may try to synchronize the shared resources
@@ -45,10 +44,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author hongshuwei@gmail.com
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
index 4abdd5220..715ae08b7 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Reader.java
@@ -24,16 +24,14 @@
 package com.iluwatar.reader.writer.lock;
 
 import java.util.concurrent.locks.Lock;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Reader class, read when it acquired the read lock.
  */
+@Slf4j
 public class Reader implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Reader.class);
-
   private final Lock readLock;
 
   private final String name;
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
index 621084b59..2b487f5eb 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/ReaderWriterLock.java
@@ -29,8 +29,7 @@ import java.util.concurrent.TimeUnit;
 import java.util.concurrent.locks.Condition;
 import java.util.concurrent.locks.Lock;
 import java.util.concurrent.locks.ReadWriteLock;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Class responsible for control the access for reader or writer
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * <p>Allows multiple readers to hold the lock at same time, but if any writer holds the lock then
  * readers wait. If reader holds the lock then writer waits. This lock is not fair.
  */
+@Slf4j
 public class ReaderWriterLock implements ReadWriteLock {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ReaderWriterLock.class);
-
 
   private final Object readerMutex = new Object();
 
diff --git a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
index b215c457b..9c908aa24 100644
--- a/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
+++ b/reader-writer-lock/src/main/java/com/iluwatar/reader/writer/lock/Writer.java
@@ -24,16 +24,14 @@
 package com.iluwatar.reader.writer.lock;
 
 import java.util.concurrent.locks.Lock;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Writer class, write when it acquired the write lock.
  */
+@Slf4j
 public class Writer implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Writer.class);
-
   private final Lock writeLock;
 
   private final String name;
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
index ddd19087d..65e0f0e9b 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderAndWriterTest.java
@@ -37,7 +37,7 @@ import org.slf4j.LoggerFactory;
 /**
  * @author hongshuwei@gmail.com
  */
-public class ReaderAndWriterTest {
+class ReaderAndWriterTest {
 
   private InMemoryAppender appender;
 
@@ -57,7 +57,7 @@ public class ReaderAndWriterTest {
    * Verify reader and writer can only get the lock to read and write orderly
    */
   @Test
-  public void testReadAndWrite() throws Exception {
+  void testReadAndWrite() throws Exception {
 
     var lock = new ReaderWriterLock();
 
@@ -87,7 +87,7 @@ public class ReaderAndWriterTest {
    * Verify reader and writer can only get the lock to read and write orderly
    */
   @Test
-  public void testWriteAndRead() throws Exception {
+  void testWriteAndRead() throws Exception {
 
     var executeService = Executors.newFixedThreadPool(2);
     var lock = new ReaderWriterLock();
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
index 5621a8d6a..f405b6e7b 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/ReaderTest.java
@@ -38,7 +38,7 @@ import org.slf4j.LoggerFactory;
 /**
  * @author hongshuwei@gmail.com
  */
-public class ReaderTest {
+class ReaderTest {
 
   private InMemoryAppender appender;
 
@@ -58,7 +58,7 @@ public class ReaderTest {
    * Verify that multiple readers can get the read lock concurrently
    */
   @Test
-  public void testRead() throws Exception {
+  void testRead() throws Exception {
 
     var executeService = Executors.newFixedThreadPool(2);
     var lock = new ReaderWriterLock();
diff --git a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
index 8be8c93e5..28d18acdc 100644
--- a/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
+++ b/reader-writer-lock/src/test/java/com/iluwatar/reader/writer/lock/WriterTest.java
@@ -38,7 +38,7 @@ import org.slf4j.LoggerFactory;
 /**
  * @author hongshuwei@gmail.com
  */
-public class WriterTest {
+class WriterTest {
 
   private InMemoryAppender appender;
 
@@ -58,7 +58,7 @@ public class WriterTest {
    * Verify that multiple writers will get the lock in order.
    */
   @Test
-  public void testWrite() throws Exception {
+  void testWrite() throws Exception {
 
     var executeService = Executors.newFixedThreadPool(2);
     var lock = new ReaderWriterLock();
diff --git a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
index 54c800cd8..c25e7f7c6 100644
--- a/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
+++ b/registry/src/test/java/com/iluwatar/registry/CustomerRegistryTest.java
@@ -59,9 +59,8 @@ public class CustomerRegistryTest {
   }
 
   @Test
-  public void shouldReturnNullWhenQueriedCustomerIsNotInRegistry() {
+  void shouldReturnNullWhenQueriedCustomerIsNotInRegistry() {
     Customer customerWithId5 = customerRegistry.getCustomer("5");
     assertNull(customerWithId5);
   }
-
 }
diff --git a/repository/pom.xml b/repository/pom.xml
index 197528ad7..b92c606ba 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -33,11 +33,6 @@
     </parent>
     <artifactId>repository</artifactId>
     <dependencies>
-        <dependency>
-            <groupId>com.github.sbrannen</groupId>
-            <artifactId>spring-test-junit5</artifactId>
-            <scope>test</scope>
-        </dependency>
         <dependency>
             <groupId>org.springframework.data</groupId>
             <artifactId>spring-data-jpa</artifactId>
diff --git a/repository/src/main/java/com/iluwatar/repository/App.java b/repository/src/main/java/com/iluwatar/repository/App.java
index e46bc75a5..3a9ec0296 100644
--- a/repository/src/main/java/com/iluwatar/repository/App.java
+++ b/repository/src/main/java/com/iluwatar/repository/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.repository;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.context.support.ClassPathXmlApplicationContext;
 
 /**
@@ -43,10 +42,9 @@ import org.springframework.context.support.ClassPathXmlApplicationContext;
  * also performed. Underneath we have configured in-memory H2 database for which schema is created
  * and dropped on each run.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/repository/src/main/java/com/iluwatar/repository/AppConfig.java b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
index 15684dc15..f2018423e 100644
--- a/repository/src/main/java/com/iluwatar/repository/AppConfig.java
+++ b/repository/src/main/java/com/iluwatar/repository/AppConfig.java
@@ -26,10 +26,9 @@ package com.iluwatar.repository;
 import java.util.List;
 import java.util.Properties;
 import javax.sql.DataSource;
+import lombok.extern.slf4j.Slf4j;
 import org.apache.commons.dbcp.BasicDataSource;
 import org.hibernate.jpa.HibernatePersistenceProvider;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 import org.springframework.boot.SpringBootConfiguration;
 import org.springframework.context.annotation.AnnotationConfigApplicationContext;
 import org.springframework.context.annotation.Bean;
@@ -42,10 +41,9 @@ import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
  */
 @EnableJpaRepositories
 @SpringBootConfiguration
+@Slf4j
 public class AppConfig {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AppConfig.class);
-
   /**
    * Creation of H2 db.
    *
diff --git a/repository/src/main/java/com/iluwatar/repository/Person.java b/repository/src/main/java/com/iluwatar/repository/Person.java
index ba02cd6c4..4d385cd70 100644
--- a/repository/src/main/java/com/iluwatar/repository/Person.java
+++ b/repository/src/main/java/com/iluwatar/repository/Person.java
@@ -26,11 +26,21 @@ package com.iluwatar.repository;
 import javax.persistence.Entity;
 import javax.persistence.GeneratedValue;
 import javax.persistence.Id;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * Person entity.
  */
+@ToString
+@EqualsAndHashCode
+@Setter
+@Getter
 @Entity
+@NoArgsConstructor
 public class Person {
 
   @Id
@@ -38,12 +48,8 @@ public class Person {
   private Long id;
   private String name;
   private String surname;
-
   private int age;
 
-  public Person() {
-  }
-
   /**
    * Constructor.
    */
@@ -53,87 +59,4 @@ public class Person {
     this.age = age;
   }
 
-  public Long getId() {
-    return id;
-  }
-
-  public void setId(Long id) {
-    this.id = id;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public void setName(String name) {
-    this.name = name;
-  }
-
-  public String getSurname() {
-    return surname;
-  }
-
-  public void setSurname(String surname) {
-    this.surname = surname;
-  }
-
-  public int getAge() {
-    return age;
-  }
-
-  public void setAge(int age) {
-    this.age = age;
-  }
-
-  @Override
-  public String toString() {
-    return "Person [id=" + id + ", name=" + name + ", surname=" + surname + ", age=" + age + "]";
-  }
-
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + age;
-    result = prime * result + (id == null ? 0 : id.hashCode());
-    result = prime * result + (name == null ? 0 : name.hashCode());
-    result = prime * result + (surname == null ? 0 : surname.hashCode());
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (Person) obj;
-    if (age != other.age) {
-      return false;
-    }
-    if (id == null) {
-      if (other.id != null) {
-        return false;
-      }
-    } else if (!id.equals(other.id)) {
-      return false;
-    }
-    if (name == null) {
-      if (other.name != null) {
-        return false;
-      }
-    } else if (!name.equals(other.name)) {
-      return false;
-    }
-    if (surname == null) {
-      return other.surname == null;
-    }
-    return surname.equals(other.surname);
-  }
-
 }
diff --git a/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java b/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
index d2e8f3b83..6de15a742 100644
--- a/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AnnotationBasedRepositoryTest.java
@@ -43,7 +43,7 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
  */
 @ExtendWith(SpringExtension.class)
 @SpringBootTest(classes = {AppConfig.class})
-public class AnnotationBasedRepositoryTest {
+class AnnotationBasedRepositoryTest {
 
   @Resource
   private PersonRepository repository;
@@ -64,13 +64,13 @@ public class AnnotationBasedRepositoryTest {
   }
 
   @Test
-  public void testFindAll() {
+  void testFindAll() {
     var actuals = Lists.newArrayList(repository.findAll());
     assertTrue(actuals.containsAll(persons) && persons.containsAll(actuals));
   }
 
   @Test
-  public void testSave() {
+  void testSave() {
     var terry = repository.findByName("Terry");
     terry.setSurname("Lee");
     terry.setAge(47);
@@ -82,7 +82,7 @@ public class AnnotationBasedRepositoryTest {
   }
 
   @Test
-  public void testDelete() {
+  void testDelete() {
     var terry = repository.findByName("Terry");
     repository.delete(terry);
 
@@ -91,12 +91,12 @@ public class AnnotationBasedRepositoryTest {
   }
 
   @Test
-  public void testCount() {
+  void testCount() {
     assertEquals(4, repository.count());
   }
 
   @Test
-  public void testFindAllByAgeBetweenSpec() {
+  void testFindAllByAgeBetweenSpec() {
     var persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40));
 
     assertEquals(3, persons.size());
@@ -104,7 +104,7 @@ public class AnnotationBasedRepositoryTest {
   }
 
   @Test
-  public void testFindOneByNameEqualSpec() {
+  void testFindOneByNameEqualSpec() {
     var actual = repository.findOne(new PersonSpecifications.NameEqualSpec("Terry"));
     assertTrue(actual.isPresent());
     assertEquals(terry, actual.get());
diff --git a/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java b/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
index 5fec985e1..3bc705634 100644
--- a/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AppConfigTest.java
@@ -26,7 +26,6 @@ package com.iluwatar.repository;
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotNull;
 
-import java.sql.ResultSet;
 import java.sql.SQLException;
 import javax.sql.DataSource;
 import org.junit.jupiter.api.Test;
@@ -41,7 +40,7 @@ import org.springframework.transaction.annotation.Transactional;
  */
 @ExtendWith(SpringExtension.class)
 @SpringBootTest(classes = {AppConfig.class})
-public class AppConfigTest {
+class AppConfigTest {
 
   @Autowired
   DataSource dataSource;
@@ -50,7 +49,7 @@ public class AppConfigTest {
    * Test for bean instance
    */
   @Test
-  public void testDataSource() {
+  void testDataSource() {
     assertNotNull(dataSource);
   }
 
@@ -59,7 +58,7 @@ public class AppConfigTest {
    */
   @Test
   @Transactional
-  public void testQuery() throws SQLException {
+  void testQuery() throws SQLException {
     var resultSet = dataSource.getConnection().createStatement().executeQuery("SELECT 1");
     var expected = "1";
     String result = null;
diff --git a/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java b/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
index 86604e1bf..1697ff6f0 100644
--- a/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/RepositoryTest.java
@@ -43,7 +43,7 @@ import org.springframework.test.context.junit.jupiter.SpringExtension;
  */
 @ExtendWith(SpringExtension.class)
 @SpringBootTest(properties = {"locations=classpath:applicationContext.xml"})
-public class RepositoryTest {
+class RepositoryTest {
 
   @Resource
   private PersonRepository repository;
@@ -64,13 +64,13 @@ public class RepositoryTest {
   }
 
   @Test
-  public void testFindAll() {
+  void testFindAll() {
     var actuals = Lists.newArrayList(repository.findAll());
     assertTrue(actuals.containsAll(persons) && persons.containsAll(actuals));
   }
 
   @Test
-  public void testSave() {
+  void testSave() {
     var terry = repository.findByName("Terry");
     terry.setSurname("Lee");
     terry.setAge(47);
@@ -82,7 +82,7 @@ public class RepositoryTest {
   }
 
   @Test
-  public void testDelete() {
+  void testDelete() {
     var terry = repository.findByName("Terry");
     repository.delete(terry);
 
@@ -91,12 +91,12 @@ public class RepositoryTest {
   }
 
   @Test
-  public void testCount() {
+  void testCount() {
     assertEquals(4, repository.count());
   }
 
   @Test
-  public void testFindAllByAgeBetweenSpec() {
+  void testFindAllByAgeBetweenSpec() {
     var persons = repository.findAll(new PersonSpecifications.AgeBetweenSpec(20, 40));
 
     assertEquals(3, persons.size());
@@ -104,7 +104,7 @@ public class RepositoryTest {
   }
 
   @Test
-  public void testFindOneByNameEqualSpec() {
+  void testFindOneByNameEqualSpec() {
     var actual = repository.findOne(new PersonSpecifications.NameEqualSpec("Terry"));
     assertTrue(actual.isPresent());
     assertEquals(terry, actual.get());
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
index a1f12bcc8..0663d53ad 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.resource.acquisition.is.initialization;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Resource Acquisition Is Initialization pattern was developed for exception safe resource
@@ -45,10 +44,9 @@ import org.slf4j.LoggerFactory;
  *
  * <p>http://docs.oracle.com/javase/7/docs/technotes/guides/language/try-with-resources.html
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
index 829f2997c..75e8b0ebd 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.resource.acquisition.is.initialization;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SlidingDoor resource.
  */
+@Slf4j
 public class SlidingDoor implements AutoCloseable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SlidingDoor.class);
-
   public SlidingDoor() {
     LOGGER.info("Sliding door opens.");
   }
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
index cfcd4893a..254db17a0 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
@@ -24,16 +24,14 @@
 package com.iluwatar.resource.acquisition.is.initialization;
 
 import java.io.Closeable;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * TreasureChest resource.
  */
+@Slf4j
 public class TreasureChest implements Closeable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(TreasureChest.class);
-
   public TreasureChest() {
     LOGGER.info("Treasure chest opens.");
   }
diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
index cc901eed5..c74676be1 100644
--- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
+++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/ClosableTest.java
@@ -40,7 +40,7 @@ import org.slf4j.LoggerFactory;
  *
  * @author Jeroen Meulemeester
  */
-public class ClosableTest {
+class ClosableTest {
 
   private InMemoryAppender appender;
 
@@ -55,7 +55,7 @@ public class ClosableTest {
   }
 
   @Test
-  public void testOpenClose() {
+  void testOpenClose() {
     try (final var ignored = new SlidingDoor(); final var ignored1 = new TreasureChest()) {
       assertTrue(appender.logContains("Sliding door opens."));
       assertTrue(appender.logContains("Treasure chest opens."));
diff --git a/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java b/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
index 045be73dc..89901fbf9 100644
--- a/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/FindCustomerTest.java
@@ -34,22 +34,20 @@ import org.junit.jupiter.api.Test;
  *
  * @author George Aristy (george.aristy@gmail.com)
  */
-public class FindCustomerTest {
+class FindCustomerTest {
   /**
    * Returns the given result with no exceptions.
    */
   @Test
-  public void noExceptions() throws Exception {
+  void noExceptions() throws Exception {
     assertThat(new FindCustomer("123").perform(), is("123"));
   }
 
   /**
    * Throws the given exception.
-   *
-   * @throws Exception the expected exception
    */
   @Test
-  public void oneException() {
+  void oneException() {
     var findCustomer = new FindCustomer("123", new BusinessException("test"));
     assertThrows(BusinessException.class, findCustomer::perform);
   }
@@ -60,7 +58,7 @@ public class FindCustomerTest {
    * @throws Exception not an expected exception
    */
   @Test
-  public void resultAfterExceptions() throws Exception {
+  void resultAfterExceptions() throws Exception {
     final var op = new FindCustomer(
         "123",
         new CustomerNotFoundException("not found"),
diff --git a/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java b/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
index 91bcc1419..b01d5908e 100644
--- a/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/RetryExponentialBackoffTest.java
@@ -34,12 +34,12 @@ import org.junit.jupiter.api.Test;
  *
  * @author George Aristy (george.aristy@gmail.com)
  */
-public class RetryExponentialBackoffTest {
+class RetryExponentialBackoffTest {
   /**
    * Should contain all errors thrown.
    */
   @Test
-  public void errors() {
+  void errors() {
     final var e = new BusinessException("unhandled");
     final var retry = new RetryExponentialBackoff<String>(
         () -> {
@@ -62,7 +62,7 @@ public class RetryExponentialBackoffTest {
    * it to attempt twice.
    */
   @Test
-  public void attempts() {
+  void attempts() {
     final var e = new BusinessException("unhandled");
     final var retry = new RetryExponentialBackoff<String>(
         () -> {
@@ -85,7 +85,7 @@ public class RetryExponentialBackoffTest {
    * it to ignore the exception that will be thrown.
    */
   @Test
-  public void ignore() {
+  void ignore() {
     final var e = new CustomerNotFoundException("customer not found");
     final var retry = new RetryExponentialBackoff<String>(
         () -> {
diff --git a/retry/src/test/java/com/iluwatar/retry/RetryTest.java b/retry/src/test/java/com/iluwatar/retry/RetryTest.java
index c137209e9..15350150f 100644
--- a/retry/src/test/java/com/iluwatar/retry/RetryTest.java
+++ b/retry/src/test/java/com/iluwatar/retry/RetryTest.java
@@ -34,12 +34,13 @@ import org.junit.jupiter.api.Test;
  *
  * @author George Aristy (george.aristy@gmail.com)
  */
-public class RetryTest {
+class RetryTest {
+
   /**
    * Should contain all errors thrown.
    */
   @Test
-  public void errors() {
+  void errors() {
     final var e = new BusinessException("unhandled");
     final var retry = new Retry<String>(
         () -> {
@@ -62,7 +63,7 @@ public class RetryTest {
    * it to attempt twice.
    */
   @Test
-  public void attempts() {
+  void attempts() {
     final var e = new BusinessException("unhandled");
     final var retry = new Retry<String>(
         () -> {
@@ -85,7 +86,7 @@ public class RetryTest {
    * it to ignore the exception that will be thrown.
    */
   @Test
-  public void ignore() {
+  void ignore() {
     final var e = new CustomerNotFoundException("customer not found");
     final var retry = new Retry<String>(
         () -> {
diff --git a/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java b/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
index 30572ddad..9299b08a3 100644
--- a/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
+++ b/role-object/src/main/java/com/iluwatar/roleobject/ApplicationRoleObject.java
@@ -26,8 +26,7 @@ package com.iluwatar.roleobject;
 import static com.iluwatar.roleobject.Role.Borrower;
 import static com.iluwatar.roleobject.Role.Investor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The Role Object pattern suggests to model context-specific views of an object as separate role
@@ -56,10 +55,9 @@ import org.slf4j.LoggerFactory;
  * to return a reference to the corresponding object. The loan application may now use this
  * reference to call Borrower-specific operations.
  */
+@Slf4j
 public class ApplicationRoleObject {
 
-  private static final Logger logger = LoggerFactory.getLogger(Role.class);
-
   /**
    * Main entry point.
    *
@@ -68,12 +66,12 @@ public class ApplicationRoleObject {
   public static void main(String[] args) {
     var customer = Customer.newCustomer(Borrower, Investor);
 
-    logger.info(" the new customer created : {}", customer);
+    LOGGER.info(" the new customer created : {}", customer);
 
     var hasBorrowerRole = customer.hasRole(Borrower);
-    logger.info(" customer has a borrowed role - {}", hasBorrowerRole);
+    LOGGER.info(" customer has a borrowed role - {}", hasBorrowerRole);
     var hasInvestorRole = customer.hasRole(Investor);
-    logger.info(" customer has an investor role - {}", hasInvestorRole);
+    LOGGER.info(" customer has an investor role - {}", hasInvestorRole);
 
     customer.getRole(Investor, InvestorRole.class)
         .ifPresent(inv -> {
@@ -85,10 +83,10 @@ public class ApplicationRoleObject {
 
     customer.getRole(Investor, InvestorRole.class)
         .map(InvestorRole::invest)
-        .ifPresent(logger::info);
+        .ifPresent(LOGGER::info);
 
     customer.getRole(Borrower, BorrowerRole.class)
         .map(BorrowerRole::borrow)
-        .ifPresent(logger::info);
+        .ifPresent(LOGGER::info);
   }
 }
diff --git a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
index a17b3034f..178b361cf 100644
--- a/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
+++ b/role-object/src/test/java/com/iluwatar/roleobject/CustomerCoreTest.java
@@ -74,7 +74,6 @@ class CustomerCoreTest {
     assertFalse(invRole.isPresent());
   }
 
-
   @Test
   void toStringTest() {
     var core = new CustomerCore();
@@ -87,8 +86,6 @@ class CustomerCoreTest {
 
     core = new CustomerCore();
     assertEquals("Customer{roles=[]}", core.toString());
-
-
   }
 
 }
\ No newline at end of file
diff --git a/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java b/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
index 03da8e8a4..136c11a65 100644
--- a/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
+++ b/saga/src/main/java/com/iluwatar/saga/choreography/SagaApplication.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.saga.choreography;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This pattern is used in distributed services to perform a group of operations atomically. This is
@@ -44,8 +43,8 @@ import org.slf4j.LoggerFactory;
  * @see com.iluwatar.saga.choreography.Saga
  * @see Service
  */
+@Slf4j
 public class SagaApplication {
-  private static final Logger LOGGER = LoggerFactory.getLogger(SagaApplication.class);
 
   /**
    * main method.
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
index 43dc1464a..3b009505e 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaApplication.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.saga.orchestration;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This pattern is used in distributed services to perform a group of operations atomically. This is
@@ -45,8 +44,8 @@ import org.slf4j.LoggerFactory;
  * @see SagaOrchestrator
  * @see Service
  */
+@Slf4j
 public class SagaApplication {
-  private static final Logger LOGGER = LoggerFactory.getLogger(SagaApplication.class);
 
   /**
    * method to show common saga logic.
diff --git a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
index 9972192c7..6c8ad9006 100644
--- a/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
+++ b/saga/src/main/java/com/iluwatar/saga/orchestration/SagaOrchestrator.java
@@ -28,16 +28,15 @@ import static com.iluwatar.saga.orchestration.Saga.Result.CRASHED;
 import static com.iluwatar.saga.orchestration.Saga.Result.FINISHED;
 import static com.iluwatar.saga.orchestration.Saga.Result.ROLLBACK;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 
 /**
  * The orchestrator that manages all the transactions and directs the participant services to
  * execute local transactions based on events.
  */
+@Slf4j
 public class SagaOrchestrator {
-  private static final Logger LOGGER = LoggerFactory.getLogger(SagaOrchestrator.class);
   private final Saga saga;
   private final ServiceDiscoveryService sd;
   private final CurrentState state;
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
index 67ac0f2fa..fde832369 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaApplicationTest.java
@@ -26,14 +26,13 @@ package com.iluwatar.saga.choreography;
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 import com.iluwatar.saga.orchestration.SagaApplication;
-import org.junit.jupiter.api.Test;
 
+import org.junit.jupiter.api.Test;
 
 /***
  * empty test
  */
 class SagaApplicationTest {
-
   @Test
   void shouldExecuteWithoutException() {
     assertDoesNotThrow(() -> SagaApplication.main(new String[]{}));
diff --git a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
index 749a66ac5..b97d22cfa 100644
--- a/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
+++ b/saga/src/test/java/com/iluwatar/saga/choreography/SagaChoreographyTest.java
@@ -32,7 +32,6 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
  */
 class SagaChoreographyTest {
 
-
   @Test
   void executeTest() {
     var sd = serviceDiscovery();
diff --git a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
index 046970644..f8884eda3 100644
--- a/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
+++ b/separated-interface/src/main/java/com/iluwatar/separatedinterface/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.separatedinterface;
 import com.iluwatar.separatedinterface.invoice.InvoiceGenerator;
 import com.iluwatar.separatedinterface.taxes.DomesticTaxCalculator;
 import com.iluwatar.separatedinterface.taxes.ForeignTaxCalculator;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>The Separated Interface pattern encourages to separate the interface definition and
@@ -38,10 +37,9 @@ import org.slf4j.LoggerFactory;
  * {@link com.iluwatar.separatedinterface.invoice.TaxCalculator} implementations located in separate
  * packages, to receive different responses for both of the implementations.</p>
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   public static final double PRODUCT_COST = 50.0;
 
   /**
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
index e1fb2302b..97455dfb6 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/invoice/InvoiceGeneratorTest.java
@@ -23,17 +23,20 @@
 
 package com.iluwatar.separatedinterface.invoice;
 
+import static org.mockito.Mockito.doReturn;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-import static org.mockito.Mockito.*;
-
-public class InvoiceGeneratorTest {
+class InvoiceGeneratorTest {
 
   private InvoiceGenerator target;
 
   @Test
-  public void testGenerateTax() {
+  void testGenerateTax() {
     var productCost = 50.0;
     var tax = 10.0;
     TaxCalculator taxCalculatorMock = mock(TaxCalculator.class);
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
index 895d66edb..e06c407b8 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/DomesticTaxCalculatorTest.java
@@ -26,16 +26,16 @@ package com.iluwatar.separatedinterface.taxes;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-public class DomesticTaxCalculatorTest {
+class DomesticTaxCalculatorTest {
 
   private DomesticTaxCalculator target;
 
   @Test
-  public void testTaxCalculation(){
+  void testTaxCalculation() {
     target = new DomesticTaxCalculator();
 
-    var tax=target.calculate(100.0);
-    Assertions.assertEquals(tax,20.0);
+    var tax = target.calculate(100.0);
+    Assertions.assertEquals(tax, 20.0);
   }
 
 }
diff --git a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
index e756297f2..ea05e4a7b 100644
--- a/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
+++ b/separated-interface/src/test/java/com/iluwatar/separatedinterface/taxes/ForeignTaxCalculatorTest.java
@@ -26,16 +26,16 @@ package com.iluwatar.separatedinterface.taxes;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
-public class ForeignTaxCalculatorTest {
+class ForeignTaxCalculatorTest {
 
   private ForeignTaxCalculator target;
 
   @Test
-  public void testTaxCalculation(){
+  void testTaxCalculation() {
     target = new ForeignTaxCalculator();
 
-    var tax=target.calculate(100.0);
-    Assertions.assertEquals(tax,60.0);
+    var tax = target.calculate(100.0);
+    Assertions.assertEquals(tax, 60.0);
   }
 
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/App.java b/servant/src/main/java/com/iluwatar/servant/App.java
index b10861f6b..b56c16ca0 100644
--- a/servant/src/main/java/com/iluwatar/servant/App.java
+++ b/servant/src/main/java/com/iluwatar/servant/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.servant;
 
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 
 /**
@@ -35,10 +34,9 @@ import org.slf4j.LoggerFactory;
  *
  * <p>In this example {@link Servant} is serving {@link King} and {@link Queen}.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private static final Servant jenkins = new Servant("Jenkins");
   private static final Servant travis = new Servant("Travis");
 
diff --git a/servant/src/test/java/com/iluwatar/servant/KingTest.java b/servant/src/test/java/com/iluwatar/servant/KingTest.java
index f769389c3..667166b92 100644
--- a/servant/src/test/java/com/iluwatar/servant/KingTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/KingTest.java
@@ -33,17 +33,17 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class KingTest {
+class KingTest {
 
   @Test
-  public void testHungrySoberUncomplimentedKing() {
+  void testHungrySoberUncomplimentedKing() {
     final var king = new King();
     king.changeMood();
     assertFalse(king.getMood());
   }
 
   @Test
-  public void testFedSoberUncomplimentedKing() {
+  void testFedSoberUncomplimentedKing() {
     final var king = new King();
     king.getFed();
     king.changeMood();
@@ -51,7 +51,7 @@ public class KingTest {
   }
 
   @Test
-  public void testHungryDrunkUncomplimentedKing() {
+  void testHungryDrunkUncomplimentedKing() {
     final var king = new King();
     king.getDrink();
     king.changeMood();
@@ -59,7 +59,7 @@ public class KingTest {
   }
 
   @Test
-  public void testHungrySoberComplimentedKing() {
+  void testHungrySoberComplimentedKing() {
     final var king = new King();
     king.receiveCompliments();
     king.changeMood();
@@ -67,7 +67,7 @@ public class KingTest {
   }
 
   @Test
-  public void testFedDrunkUncomplimentedKing() {
+  void testFedDrunkUncomplimentedKing() {
     final var king = new King();
     king.getFed();
     king.getDrink();
@@ -76,7 +76,7 @@ public class KingTest {
   }
 
   @Test
-  public void testFedSoberComplimentedKing() {
+  void testFedSoberComplimentedKing() {
     final var king = new King();
     king.getFed();
     king.receiveCompliments();
@@ -85,7 +85,7 @@ public class KingTest {
   }
 
   @Test
-  public void testFedDrunkComplimentedKing() {
+  void testFedDrunkComplimentedKing() {
     final var king = new King();
     king.getFed();
     king.getDrink();
@@ -95,7 +95,7 @@ public class KingTest {
   }
 
   @Test
-  public void testHungryDrunkComplimentedKing() {
+  void testHungryDrunkComplimentedKing() {
     final King king = new King();
     king.getDrink();
     king.receiveCompliments();
diff --git a/servant/src/test/java/com/iluwatar/servant/QueenTest.java b/servant/src/test/java/com/iluwatar/servant/QueenTest.java
index 1a86d0afb..93dcb30bd 100644
--- a/servant/src/test/java/com/iluwatar/servant/QueenTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/QueenTest.java
@@ -34,10 +34,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class QueenTest {
+class QueenTest {
 
   @Test
-  public void testNotFlirtyUncomplemented() {
+  void testNotFlirtyUncomplemented() {
     final var queen = new Queen();
     queen.setFlirtiness(false);
     queen.changeMood();
@@ -45,7 +45,7 @@ public class QueenTest {
   }
 
   @Test
-  public void testNotFlirtyComplemented() {
+  void testNotFlirtyComplemented() {
     final var queen = new Queen();
     queen.setFlirtiness(false);
     queen.receiveCompliments();
@@ -54,14 +54,14 @@ public class QueenTest {
   }
 
   @Test
-  public void testFlirtyUncomplemented() {
+  void testFlirtyUncomplemented() {
     final var queen = new Queen();
     queen.changeMood();
     assertFalse(queen.getMood());
   }
 
   @Test
-  public void testFlirtyComplemented() {
+  void testFlirtyComplemented() {
     final var queen = new Queen();
     queen.receiveCompliments();
     queen.changeMood();
diff --git a/servant/src/test/java/com/iluwatar/servant/ServantTest.java b/servant/src/test/java/com/iluwatar/servant/ServantTest.java
index db6cdf341..6e9bbec47 100644
--- a/servant/src/test/java/com/iluwatar/servant/ServantTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/ServantTest.java
@@ -37,10 +37,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class ServantTest {
+class ServantTest {
 
   @Test
-  public void testFeed() {
+  void testFeed() {
     final var royalty = mock(Royalty.class);
     final var servant = new Servant("test");
     servant.feed(royalty);
@@ -49,7 +49,7 @@ public class ServantTest {
   }
 
   @Test
-  public void testGiveWine() {
+  void testGiveWine() {
     final var royalty = mock(Royalty.class);
     final var servant = new Servant("test");
     servant.giveWine(royalty);
@@ -58,7 +58,7 @@ public class ServantTest {
   }
 
   @Test
-  public void testGiveCompliments() {
+  void testGiveCompliments() {
     final var royalty = mock(Royalty.class);
     final var servant = new Servant("test");
     servant.giveCompliments(royalty);
@@ -67,7 +67,7 @@ public class ServantTest {
   }
 
   @Test
-  public void testCheckIfYouWillBeHanged() {
+  void testCheckIfYouWillBeHanged() {
     final var goodMoodRoyalty = mock(Royalty.class);
     when(goodMoodRoyalty.getMood()).thenReturn(true);
 
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
index 4df66ecd5..9d0321851 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Address.java
@@ -26,116 +26,36 @@ package com.iluwatar.serverless.baas.model;
 import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBAttribute;
 import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBDocument;
 import java.io.Serializable;
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * Address class Created by dheeraj.mummarareddy on 3/4/18.
  */
+@Getter
+@Setter
+@EqualsAndHashCode
+@ToString
 @DynamoDBDocument
 public class Address implements Serializable {
 
   private static final long serialVersionUID = 6760844284799736970L;
 
-  private String addressLineOne;
-  private String addressLineTwo;
-  private String city;
-  private String state;
-  private String zipCode;
-
   @DynamoDBAttribute(attributeName = "addressLineOne")
-  public String getAddressLineOne() {
-    return addressLineOne;
-  }
-
-  public void setAddressLineOne(String addressLineOne) {
-    this.addressLineOne = addressLineOne;
-  }
+  private String addressLineOne;
 
   @DynamoDBAttribute(attributeName = "addressLineTwo")
-  public String getAddressLineTwo() {
-    return addressLineTwo;
-  }
-
-  public void setAddressLineTwo(String addressLineTwo) {
-    this.addressLineTwo = addressLineTwo;
-  }
+  private String addressLineTwo;
 
   @DynamoDBAttribute(attributeName = "city")
-  public String getCity() {
-    return city;
-  }
-
-  public void setCity(String city) {
-    this.city = city;
-  }
+  private String city;
 
   @DynamoDBAttribute(attributeName = "state")
-  public String getState() {
-    return state;
-  }
-
-  public void setState(String state) {
-    this.state = state;
-  }
+  private String state;
 
   @DynamoDBAttribute(attributeName = "zipCode")
-  public String getZipCode() {
-    return zipCode;
-  }
+  private String zipCode;
 
-  public void setZipCode(String zipCode) {
-    this.zipCode = zipCode;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    var address = (Address) o;
-
-    if (!Objects.equals(addressLineOne, address.addressLineOne)) {
-      return false;
-    }
-
-    if (!Objects.equals(addressLineTwo, address.addressLineTwo)) {
-      return false;
-    }
-
-    if (!Objects.equals(city, address.city)) {
-      return false;
-    }
-
-    if (!Objects.equals(state, address.state)) {
-      return false;
-    }
-
-    return Objects.equals(zipCode, address.zipCode);
-  }
-
-  @Override
-  public int hashCode() {
-    var result = addressLineOne != null ? addressLineOne.hashCode() : 0;
-    result = 31 * result + (addressLineTwo != null ? addressLineTwo.hashCode() : 0);
-    result = 31 * result + (city != null ? city.hashCode() : 0);
-    result = 31 * result + (state != null ? state.hashCode() : 0);
-    result = 31 * result + (zipCode != null ? zipCode.hashCode() : 0);
-    return result;
-  }
-
-  @Override
-  public String toString() {
-    return "Address{"
-        + "addressLineOne='" + addressLineOne + '\''
-        + ", addressLineTwo='" + addressLineTwo + '\''
-        + ", city='" + city + '\''
-        + ", state='" + state + '\''
-        + ", zipCode='" + zipCode + '\''
-        + '}';
-  }
 }
diff --git a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
index 4c13080b4..092d9b12d 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/baas/model/Person.java
@@ -29,96 +29,35 @@ import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBHashKey;
 import com.amazonaws.services.dynamodbv2.datamodeling.DynamoDBTable;
 import com.fasterxml.jackson.annotation.JsonProperty;
 import java.io.Serializable;
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * Person class Created by dheeraj.mummarareddy on 3/4/18.
  */
+@Getter
+@Setter
+@ToString
+@EqualsAndHashCode
 @DynamoDBTable(tableName = "persons")
 public class Person implements Serializable {
 
   private static final long serialVersionUID = -3413087924608627075L;
 
-  private String id;
-  private String firstName;
-  private String lastName;
-  private Address address;
-
   @JsonProperty(access = JsonProperty.Access.READ_ONLY)
   @DynamoDBHashKey(attributeName = "id")
   @DynamoDBAutoGeneratedKey
-  public String getId() {
-    return id;
-  }
-
-  public void setId(String id) {
-    this.id = id;
-  }
+  private String id;
 
   @DynamoDBAttribute(attributeName = "firstName")
-  public String getFirstName() {
-    return firstName;
-  }
-
-  public void setFirstName(String firstName) {
-    this.firstName = firstName;
-  }
+  private String firstName;
 
   @DynamoDBAttribute(attributeName = "lastName")
-  public String getLastName() {
-    return lastName;
-  }
-
-  public void setLastName(String lastName) {
-    this.lastName = lastName;
-  }
+  private String lastName;
 
   @DynamoDBAttribute(attributeName = "address")
-  public Address getAddress() {
-    return address;
-  }
+  private Address address;
 
-  public void setAddress(Address address) {
-    this.address = address;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    Person person = (Person) o;
-
-    if (!Objects.equals(firstName, person.firstName)) {
-      return false;
-    }
-
-    if (!Objects.equals(lastName, person.lastName)) {
-      return false;
-    }
-
-    return Objects.equals(address, person.address);
-  }
-
-  @Override
-  public int hashCode() {
-    var result = firstName != null ? firstName.hashCode() : 0;
-    result = 31 * result + (lastName != null ? lastName.hashCode() : 0);
-    result = 31 * result + (address != null ? address.hashCode() : 0);
-    return result;
-  }
-
-  @Override
-  public String toString() {
-    return "Person{"
-        + "id='" + id + '\''
-        + ", firstName='" + firstName + '\''
-        + ", lastName='" + lastName + '\''
-        + ", address=" + address
-        + '}';
-  }
 }
diff --git a/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java b/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
index 0302983e2..e50202649 100644
--- a/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
+++ b/serverless/src/main/java/com/iluwatar/serverless/faas/LambdaInfo.java
@@ -24,11 +24,18 @@
 package com.iluwatar.serverless.faas;
 
 import java.io.Serializable;
-import java.util.Objects;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
 
 /**
  * Lambda context information.
  */
+@ToString
+@EqualsAndHashCode
+@Setter
+@Getter
 public class LambdaInfo implements Serializable {
 
   private static final long serialVersionUID = 3936130599040848923L;
@@ -40,103 +47,4 @@ public class LambdaInfo implements Serializable {
   private String functionVersion;
   private Integer memoryLimitInMb;
 
-  public String getAwsRequestId() {
-    return awsRequestId;
-  }
-
-  public void setAwsRequestId(String awsRequestId) {
-    this.awsRequestId = awsRequestId;
-  }
-
-  public String getLogGroupName() {
-    return logGroupName;
-  }
-
-  public void setLogGroupName(String logGroupName) {
-    this.logGroupName = logGroupName;
-  }
-
-  public String getLogStreamName() {
-    return logStreamName;
-  }
-
-  public void setLogStreamName(String logStreamName) {
-    this.logStreamName = logStreamName;
-  }
-
-  public String getFunctionName() {
-    return functionName;
-  }
-
-  public void setFunctionName(String functionName) {
-    this.functionName = functionName;
-  }
-
-  public String getFunctionVersion() {
-    return functionVersion;
-  }
-
-  public void setFunctionVersion(String functionVersion) {
-    this.functionVersion = functionVersion;
-  }
-
-  public Integer getMemoryLimitInMb() {
-    return memoryLimitInMb;
-  }
-
-  public void setMemoryLimitInMb(Integer memoryLimitInMb) {
-    this.memoryLimitInMb = memoryLimitInMb;
-  }
-
-  @Override
-  public String toString() {
-    return "LambdaInfo{"
-        + "awsRequestId='" + awsRequestId + '\''
-        + ", logGroupName='" + logGroupName + '\''
-        + ", logStreamName='" + logStreamName + '\''
-        + ", functionName='" + functionName + '\''
-        + ", functionVersion='" + functionVersion + '\''
-        + ", memoryLimitInMb=" + memoryLimitInMb
-        + '}';
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    LambdaInfo that = (LambdaInfo) o;
-
-    if (!Objects.equals(awsRequestId, that.awsRequestId)) {
-      return false;
-    }
-    if (!Objects.equals(logGroupName, that.logGroupName)) {
-      return false;
-    }
-    if (!Objects.equals(logStreamName, that.logStreamName)) {
-      return false;
-    }
-    if (!Objects.equals(functionName, that.functionName)) {
-      return false;
-    }
-    if (!Objects.equals(functionVersion, that.functionVersion)) {
-      return false;
-    }
-    return Objects.equals(memoryLimitInMb, that.memoryLimitInMb);
-  }
-
-  @Override
-  public int hashCode() {
-    var result = awsRequestId != null ? awsRequestId.hashCode() : 0;
-    result = 31 * result + (logGroupName != null ? logGroupName.hashCode() : 0);
-    result = 31 * result + (logStreamName != null ? logStreamName.hashCode() : 0);
-    result = 31 * result + (functionName != null ? functionName.hashCode() : 0);
-    result = 31 * result + (functionVersion != null ? functionVersion.hashCode() : 0);
-    result = 31 * result + (memoryLimitInMb != null ? memoryLimitInMb.hashCode() : 0);
-    return result;
-  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
index 78f2fffb6..d484fb17c 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
@@ -31,8 +31,7 @@ import com.iluwatar.servicelayer.spellbook.Spellbook;
 import com.iluwatar.servicelayer.spellbook.SpellbookDaoImpl;
 import com.iluwatar.servicelayer.wizard.Wizard;
 import com.iluwatar.servicelayer.wizard.WizardDaoImpl;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 
 /**
@@ -52,9 +51,8 @@ import org.slf4j.LoggerFactory;
  * dao, service). For persistence the example uses in-memory H2 database which is populated on each
  * application startup.
  */
+@Slf4j
 public class App {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
   public static final String BOOK_OF_IDORES = "Book of Idores";
 
   /**
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
index fdc269aea..3c8fef0e4 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
@@ -26,18 +26,16 @@ package com.iluwatar.servicelayer.hibernate;
 import com.iluwatar.servicelayer.spell.Spell;
 import com.iluwatar.servicelayer.spellbook.Spellbook;
 import com.iluwatar.servicelayer.wizard.Wizard;
+import lombok.extern.slf4j.Slf4j;
 import org.hibernate.SessionFactory;
 import org.hibernate.cfg.Configuration;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * Produces the Hibernate {@link SessionFactory}.
  */
+@Slf4j
 public final class HibernateUtil {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HibernateUtil.class);
-
   /**
    * The cached session factory.
    */
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
index bc47481fa..7c05b6cef 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/common/BaseDaoTest.java
@@ -93,7 +93,7 @@ public abstract class BaseDaoTest<E extends BaseEntity, D extends DaoBaseImpl<E>
   }
 
   @Test
-  public void testFind() {
+  void testFind() {
     final var all = this.dao.findAll();
     for (final var entity : all) {
       final var byId = this.dao.find(entity.getId());
@@ -103,7 +103,7 @@ public abstract class BaseDaoTest<E extends BaseEntity, D extends DaoBaseImpl<E>
   }
 
   @Test
-  public void testDelete() {
+  void testDelete() {
     final var originalEntities = this.dao.findAll();
     this.dao.delete(originalEntities.get(1));
     this.dao.delete(originalEntities.get(2));
@@ -114,14 +114,14 @@ public abstract class BaseDaoTest<E extends BaseEntity, D extends DaoBaseImpl<E>
   }
 
   @Test
-  public void testFindAll() {
+  void testFindAll() {
     final var all = this.dao.findAll();
     assertNotNull(all);
     assertEquals(INITIAL_COUNT, all.size());
   }
 
   @Test
-  public void testSetId() {
+  void testSetId() {
     final var entity = this.factory.apply("name");
     assertNull(entity.getId());
 
@@ -131,7 +131,7 @@ public abstract class BaseDaoTest<E extends BaseEntity, D extends DaoBaseImpl<E>
   }
 
   @Test
-  public void testSetName() {
+  void testSetName() {
     final var entity = this.factory.apply("name");
     assertEquals("name", entity.getName());
     assertEquals("name", entity.toString());
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
index 6e03c660d..0d5456d85 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/magic/MagicServiceImplTest.java
@@ -46,10 +46,10 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class MagicServiceImplTest {
+class MagicServiceImplTest {
 
   @Test
-  public void testFindAllWizards() {
+  void testFindAllWizards() {
     final var wizardDao = mock(WizardDao.class);
     final var spellbookDao = mock(SpellbookDao.class);
     final var spellDao = mock(SpellDao.class);
@@ -63,7 +63,7 @@ public class MagicServiceImplTest {
   }
 
   @Test
-  public void testFindAllSpellbooks() {
+  void testFindAllSpellbooks() {
     final var wizardDao = mock(WizardDao.class);
     final var spellbookDao = mock(SpellbookDao.class);
     final var spellDao = mock(SpellDao.class);
@@ -77,7 +77,7 @@ public class MagicServiceImplTest {
   }
 
   @Test
-  public void testFindAllSpells() {
+  void testFindAllSpells() {
     final var wizardDao = mock(WizardDao.class);
     final var spellbookDao = mock(SpellbookDao.class);
     final var spellDao = mock(SpellDao.class);
@@ -91,7 +91,7 @@ public class MagicServiceImplTest {
   }
 
   @Test
-  public void testFindWizardsWithSpellbook() {
+  void testFindWizardsWithSpellbook() {
     final var bookname = "bookname";
     final var spellbook = mock(Spellbook.class);
     final var wizards = Set.of(
@@ -122,7 +122,7 @@ public class MagicServiceImplTest {
   }
 
   @Test
-  public void testFindWizardsWithSpell() throws Exception {
+  void testFindWizardsWithSpell() throws Exception {
     final var wizards = Set.of(
         mock(Wizard.class),
         mock(Wizard.class),
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
index 98ca75481..ee5180c1a 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/spell/SpellDaoImplTest.java
@@ -34,14 +34,14 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class SpellDaoImplTest extends BaseDaoTest<Spell, SpellDaoImpl> {
+class SpellDaoImplTest extends BaseDaoTest<Spell, SpellDaoImpl> {
 
   public SpellDaoImplTest() {
     super(Spell::new, new SpellDaoImpl());
   }
 
   @Test
-  public void testFindByName() {
+  void testFindByName() {
     final var dao = getDao();
     final var allSpells = dao.findAll();
     for (final var spell : allSpells) {
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
index 273cc9f31..cd58d31d2 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImplTest.java
@@ -34,14 +34,14 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class SpellbookDaoImplTest extends BaseDaoTest<Spellbook, SpellbookDaoImpl> {
+class SpellbookDaoImplTest extends BaseDaoTest<Spellbook, SpellbookDaoImpl> {
 
   public SpellbookDaoImplTest() {
     super(Spellbook::new, new SpellbookDaoImpl());
   }
 
   @Test
-  public void testFindByName() {
+  void testFindByName() {
     final var dao = getDao();
     final var allBooks = dao.findAll();
     for (final var book : allBooks) {
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
index 32ca3f3af..708fa5587 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/wizard/WizardDaoImplTest.java
@@ -34,14 +34,14 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class WizardDaoImplTest extends BaseDaoTest<Wizard, WizardDaoImpl> {
+class WizardDaoImplTest extends BaseDaoTest<Wizard, WizardDaoImpl> {
 
   public WizardDaoImplTest() {
     super(Wizard::new, new WizardDaoImpl());
   }
 
   @Test
-  public void testFindByName() {
+  void testFindByName() {
     final var dao = getDao();
     final var allWizards = dao.findAll();
     for (final var spell : allWizards) {
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
index bee10f5d9..11faff347 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.servicelocator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * For JNDI lookup of services from the web.xml. Will match name of the service name that is being
@@ -32,10 +31,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author saifasif
  */
+@Slf4j
 public class InitContext {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(InitContext.class);
-
   /**
    * Perform the lookup based on the service name. The returned object will need to be casted into a
    * {@link Service}
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
index 670b5abe9..3a8dae3fd 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
@@ -25,8 +25,7 @@ package com.iluwatar.servicelocator;
 
 import java.util.HashMap;
 import java.util.Map;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The service cache implementation which will cache services that are being created. On first hit,
@@ -36,10 +35,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author saifasif
  */
+@Slf4j
 public class ServiceCache {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ServiceCache.class);
-
   private final Map<String, Service> serviceCache;
 
   public ServiceCache() {
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
index 8247dd631..a712d896d 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.servicelocator;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This is a single service implementation of a sample service. This is the actual service that will
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author saifasif
  */
+@Slf4j
 public class ServiceImpl implements Service {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ServiceImpl.class);
-
   private final String serviceName;
   private final int id;
 
diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
index 28bcb6122..118ab9302 100644
--- a/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
+++ b/service-locator/src/test/java/com/iluwatar/servicelocator/ServiceLocatorTest.java
@@ -37,13 +37,13 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class ServiceLocatorTest {
+class ServiceLocatorTest {
 
   /**
    * Verify if we just receive 'null' when requesting a non-existing service
    */
   @Test
-  public void testGetNonExistentService() {
+  void testGetNonExistentService() {
     assertNull(ServiceLocator.getService("fantastic/unicorn/service"));
     assertNull(ServiceLocator.getService("another/fantastic/unicorn/service"));
   }
@@ -52,7 +52,7 @@ public class ServiceLocatorTest {
    * Verify if we get the same cached instance when requesting the same service twice
    */
   @Test
-  public void testServiceCache() {
+  void testServiceCache() {
     final var serviceNames = List.of("jndi/serviceA", "jndi/serviceB");
 
     for (final var serviceName : serviceNames) {
diff --git a/sharding/src/main/java/com/iluwatar/sharding/Data.java b/sharding/src/main/java/com/iluwatar/sharding/Data.java
index 9261f2e34..a8c461703 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/Data.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/Data.java
@@ -77,8 +77,8 @@ public class Data {
   @Override
   public String toString() {
     return "Data {" + "key="
-      + key + ", value='" + value
-      + '\'' + ", type=" + type + '}';
+        + key + ", value='" + value
+        + '\'' + ", type=" + type + '}';
   }
 }
 
diff --git a/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
index 8577d2e11..10bb55198 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/HashShardManager.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.sharding;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ShardManager with hash strategy. The purpose of this strategy is to reduce the
@@ -32,10 +31,9 @@ import org.slf4j.LoggerFactory;
  * in a way that achieves a balance between the size of each shard and the average
  * load that each shard will encounter.
  */
+@Slf4j
 public class HashShardManager extends ShardManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HashShardManager.class);
-
   @Override
   public int storeData(Data data) {
     var shardId = allocateShard(data);
diff --git a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
index 2e23bc946..dd94da128 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/LookupShardManager.java
@@ -26,19 +26,17 @@ package com.iluwatar.sharding;
 import java.security.SecureRandom;
 import java.util.HashMap;
 import java.util.Map;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import java.util.Random;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ShardManager with lookup strategy. In this strategy the sharding logic implements
  * a map that routes a request for data to the shard that contains that data by using
  * the shard key.
  */
+@Slf4j
 public class LookupShardManager extends ShardManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(LookupShardManager.class);
-
   private final Map<Integer, Integer> lookupMap = new HashMap<>();
 
   @Override
diff --git a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
index 12dc6ce22..8a52627b9 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/RangeShardManager.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.sharding;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ShardManager with range strategy. This strategy groups related items together in the same shard,
  * and orders them by shard key.
  */
+@Slf4j
 public class RangeShardManager extends ShardManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(RangeShardManager.class);
-
   @Override
   public int storeData(Data data) {
     var shardId = allocateShard(data);
diff --git a/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java b/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
index f128db462..955e68530 100644
--- a/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
+++ b/sharding/src/main/java/com/iluwatar/sharding/ShardManager.java
@@ -25,17 +25,14 @@ package com.iluwatar.sharding;
 
 import java.util.HashMap;
 import java.util.Map;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Abstract class for ShardManager.
  */
+@Slf4j
 public abstract class ShardManager {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ShardManager.class);
-
   protected Map<Integer, Shard> shardMap;
 
   public ShardManager() {
diff --git a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
index 14d0cf244..0e8f336ae 100644
--- a/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
+++ b/sharding/src/test/java/com/iluwatar/sharding/ShardManagerTest.java
@@ -85,7 +85,7 @@ class ShardManagerTest {
     assertEquals(shard, tmpShard);
   }
 
-  class TestShardManager extends ShardManager {
+  static class TestShardManager extends ShardManager {
 
     @Override
     public int storeData(Data data) {
diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index dff78c77d..4c02262d2 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.singleton;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>Singleton pattern ensures that the class can have only one existing instance per Java
@@ -61,10 +60,9 @@ import org.slf4j.LoggerFactory;
  * {@link InitializingOnDemandHolderIdiom}. However, this implementation requires at least Java 8
  * API level to work.</p>
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
index ff373f415..d3a164d37 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
@@ -58,7 +58,7 @@ public final class ThreadSafeDoubleCheckLocking {
   public static ThreadSafeDoubleCheckLocking getInstance() {
     // local variable increases performance by 25 percent
     // Joshua Bloch "Effective Java, Second Edition", p. 283-284
-    
+
     var result = instance;
     // Check if singleton instance is initialized.
     // If it is initialized then we can return the instance.
diff --git a/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java b/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
index cbb1f944b..5c155ebdd 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/SingletonTest.java
@@ -49,7 +49,7 @@ import org.junit.jupiter.api.Test;
  * @author Jeroen Meulemeester
  * @author Richard Jones
  */
-public abstract class SingletonTest<S> {
+abstract class SingletonTest<S> {
 
   /**
    * The singleton's getInstance method.
@@ -69,7 +69,7 @@ public abstract class SingletonTest<S> {
    * Test the singleton in a non-concurrent setting.
    */
   @Test
-  public void testMultipleCallsReturnTheSameObjectInSameThread() {
+  void testMultipleCallsReturnTheSameObjectInSameThread() {
     // Create several instances in the same calling thread
     var instance1 = this.singletonInstanceMethod.get();
     var instance2 = this.singletonInstanceMethod.get();
@@ -84,7 +84,7 @@ public abstract class SingletonTest<S> {
    * Test singleton instance in a concurrent setting.
    */
   @Test
-  public void testMultipleCallsReturnTheSameObjectInDifferentThreads() throws Exception {
+  void testMultipleCallsReturnTheSameObjectInDifferentThreads() throws Exception {
     assertTimeout(ofMillis(10000), () -> {
       // Create 10000 tasks and inside each callable instantiate the singleton class
       final var tasks = IntStream.range(0, 10000)
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
index 6138cc5d9..647de399a 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/App.java
@@ -25,8 +25,7 @@ package com.iluwatar.spatialpartition;
 
 import java.security.SecureRandom;
 import java.util.HashMap;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>The idea behind the <b>Spatial Partition</b> design pattern is to enable efficient location
@@ -57,8 +56,8 @@ import org.slf4j.LoggerFactory;
  * speed of the game.</p>
  */
 
+@Slf4j
 public class App {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
   private static final String BUBBLE = "Bubble ";
 
   static void noSpatialPartition(int numOfMovements, HashMap<Integer, Bubble> bubbles) {
diff --git a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
index 668da581e..243b76230 100644
--- a/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
+++ b/spatial-partition/src/main/java/com/iluwatar/spatialpartition/Bubble.java
@@ -26,16 +26,15 @@ package com.iluwatar.spatialpartition;
 import java.security.SecureRandom;
 import java.util.Collection;
 import java.util.HashMap;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Bubble class extends Point. In this example, we create several bubbles in the field, let them
  * move and keep track of which ones have popped and which ones remain.
  */
 
+@Slf4j
 public class Bubble extends Point<Bubble> {
-  private static final Logger LOGGER = LoggerFactory.getLogger(Bubble.class);
   private static final SecureRandom RANDOM = new SecureRandom();
 
   final int radius;
diff --git a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
index 37e61b83f..32e373d2a 100644
--- a/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
+++ b/special-case/src/main/java/com/iluwatar/specialcase/InsufficientFunds.java
@@ -23,13 +23,11 @@
 
 package com.iluwatar.specialcase;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
+@Slf4j
 public class InsufficientFunds implements ReceiptViewModel {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(InsufficientFunds.class);
-
   private String userName;
   private Double amount;
   private String itemName;
diff --git a/specification/src/main/java/com/iluwatar/specification/app/App.java b/specification/src/main/java/com/iluwatar/specification/app/App.java
index 6b27e2ebe..025f385df 100644
--- a/specification/src/main/java/com/iluwatar/specification/app/App.java
+++ b/specification/src/main/java/com/iluwatar/specification/app/App.java
@@ -40,8 +40,7 @@ import com.iluwatar.specification.selector.MovementSelector;
 import java.util.List;
 import java.util.Objects;
 import java.util.function.Predicate;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * <p>The central idea of the Specification pattern is to separate the statement of how to match a
@@ -54,10 +53,9 @@ import org.slf4j.LoggerFactory;
  *
  * <p>http://martinfowler.com/apsupp/spec.pdf</p>
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Mass.java b/specification/src/main/java/com/iluwatar/specification/property/Mass.java
index c400bb8ff..a83e66aae 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Mass.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Mass.java
@@ -23,9 +23,12 @@
 
 package com.iluwatar.specification.property;
 
+import lombok.EqualsAndHashCode;
+
 /**
  * Mass property.
  */
+@EqualsAndHashCode
 public class Mass {
 
   private final double value;
@@ -57,11 +60,4 @@ public class Mass {
     return title;
   }
 
-  @Override
-  public final boolean equals(Object obj) {
-    if (!(obj instanceof Mass)) {
-      return false;
-    }
-    return ((Mass) obj).value == this.value;
-  }
 }
diff --git a/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java b/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
index 446add357..d5386cece 100644
--- a/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/creature/CreatureTest.java
@@ -40,7 +40,7 @@ import org.junit.jupiter.params.provider.MethodSource;
  *
  * @author Jeroen Meulemeester
  */
-public class CreatureTest {
+class CreatureTest {
 
   /**
    * @return The tested {@link Creature} instance and its expected specs
@@ -64,40 +64,40 @@ public class CreatureTest {
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testGetName(Creature testedCreature, String name) {
+  void testGetName(Creature testedCreature, String name) {
     assertEquals(name, testedCreature.getName());
   }
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testGetSize(Creature testedCreature, String name, Size size) {
+  void testGetSize(Creature testedCreature, String name, Size size) {
     assertEquals(size, testedCreature.getSize());
   }
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testGetMovement(Creature testedCreature, String name, Size size, Movement movement) {
+  void testGetMovement(Creature testedCreature, String name, Size size, Movement movement) {
     assertEquals(movement, testedCreature.getMovement());
   }
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testGetColor(Creature testedCreature, String name, Size size, Movement movement,
-                           Color color) {
+  void testGetColor(Creature testedCreature, String name, Size size, Movement movement,
+                    Color color) {
     assertEquals(color, testedCreature.getColor());
   }
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testGetMass(Creature testedCreature, String name, Size size, Movement movement,
-                          Color color, Mass mass) {
+  void testGetMass(Creature testedCreature, String name, Size size, Movement movement,
+                   Color color, Mass mass) {
     assertEquals(mass, testedCreature.getMass());
   }
 
   @ParameterizedTest
   @MethodSource("dataProvider")
-  public void testToString(Creature testedCreature, String name, Size size, Movement movement,
-                           Color color, Mass mass) {
+  void testToString(Creature testedCreature, String name, Size size, Movement movement,
+                    Color color, Mass mass) {
     final var toString = testedCreature.toString();
     assertNotNull(toString);
     assertEquals(String
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
index 844236bea..e6debfcad 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/ColorSelectorTest.java
@@ -37,13 +37,13 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class ColorSelectorTest {
+class ColorSelectorTest {
 
   /**
    * Verify if the color selector gives the correct results
    */
   @Test
-  public void testColor() {
+  void testColor() {
     final var greenCreature = mock(Creature.class);
     when(greenCreature.getColor()).thenReturn(Color.GREEN);
 
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java b/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
index 68cb972bf..15e7b0316 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/CompositeSelectorsTest.java
@@ -33,13 +33,13 @@ import com.iluwatar.specification.property.Mass;
 import com.iluwatar.specification.property.Movement;
 import org.junit.jupiter.api.Test;
 
-public class CompositeSelectorsTest {
+class CompositeSelectorsTest {
 
   /**
    * Verify if the conjunction selector gives the correct results.
    */
   @Test
-  public void testAndComposition() {
+  void testAndComposition() {
     final var swimmingHeavyCreature = mock(Creature.class);
     when(swimmingHeavyCreature.getMovement()).thenReturn(Movement.SWIMMING);
     when(swimmingHeavyCreature.getMass()).thenReturn(new Mass(100.0));
@@ -58,7 +58,7 @@ public class CompositeSelectorsTest {
    * Verify if the disjunction selector gives the correct results.
    */
   @Test
-  public void testOrComposition() {
+  void testOrComposition() {
     final var swimmingHeavyCreature = mock(Creature.class);
     when(swimmingHeavyCreature.getMovement()).thenReturn(Movement.SWIMMING);
     when(swimmingHeavyCreature.getMass()).thenReturn(new Mass(100.0));
@@ -77,7 +77,7 @@ public class CompositeSelectorsTest {
    * Verify if the negation selector gives the correct results.
    */
   @Test
-  public void testNotComposition() {
+  void testNotComposition() {
     final var swimmingHeavyCreature = mock(Creature.class);
     when(swimmingHeavyCreature.getMovement()).thenReturn(Movement.SWIMMING);
     when(swimmingHeavyCreature.getMass()).thenReturn(new Mass(100.0));
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
index 131d269b8..a3b084e1b 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/MassSelectorTest.java
@@ -38,7 +38,7 @@ public class MassSelectorTest {
    * Verify if the mass selector gives the correct results.
    */
   @Test
-  public void testMass() {
+  void testMass() {
     final var lightCreature = mock(Creature.class);
     when(lightCreature.getMass()).thenReturn(new Mass(50.0));
 
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
index 5de71e3e7..4b70ed222 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/MovementSelectorTest.java
@@ -43,7 +43,7 @@ public class MovementSelectorTest {
    * Verify if the movement selector gives the correct results.
    */
   @Test
-  public void testMovement() {
+  void testMovement() {
     final var swimmingCreature = mock(Creature.class);
     when(swimmingCreature.getMovement()).thenReturn(Movement.SWIMMING);
 
diff --git a/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java b/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
index ee3995c07..8aab625fc 100644
--- a/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/selector/SizeSelectorTest.java
@@ -43,7 +43,7 @@ public class SizeSelectorTest {
    * Verify if the size selector gives the correct results
    */
   @Test
-  public void testMovement() {
+  void testMovement() {
     final var normalCreature = mock(Creature.class);
     when(normalCreature.getSize()).thenReturn(Size.NORMAL);
 
diff --git a/state/README.md b/state/README.md
index 7ee201be2..155cea0cb 100644
--- a/state/README.md
+++ b/state/README.md
@@ -48,10 +48,9 @@ public interface State {
   void observe();
 }
 
+@Slf4j
 public class PeacefulState implements State {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PeacefulState.class);
-
   private final Mammoth mammoth;
 
   public PeacefulState(Mammoth mammoth) {
@@ -69,10 +68,9 @@ public class PeacefulState implements State {
   }
 }
 
+@Slf4j
 public class AngryState implements State {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AngryState.class);
-
   private final Mammoth mammoth;
 
   public AngryState(Mammoth mammoth) {
diff --git a/state/src/main/java/com/iluwatar/state/AngryState.java b/state/src/main/java/com/iluwatar/state/AngryState.java
index 0598782a9..f03783d28 100644
--- a/state/src/main/java/com/iluwatar/state/AngryState.java
+++ b/state/src/main/java/com/iluwatar/state/AngryState.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.state;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Angry state.
  */
+@Slf4j
 public class AngryState implements State {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(AngryState.class);
-
   private final Mammoth mammoth;
 
   public AngryState(Mammoth mammoth) {
diff --git a/state/src/main/java/com/iluwatar/state/PeacefulState.java b/state/src/main/java/com/iluwatar/state/PeacefulState.java
index c535509d5..eefa0168c 100644
--- a/state/src/main/java/com/iluwatar/state/PeacefulState.java
+++ b/state/src/main/java/com/iluwatar/state/PeacefulState.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.state;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Peaceful state.
  */
+@Slf4j
 public class PeacefulState implements State {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(PeacefulState.class);
-
   private final Mammoth mammoth;
 
   public PeacefulState(Mammoth mammoth) {
diff --git a/state/src/test/java/com/iluwatar/state/MammothTest.java b/state/src/test/java/com/iluwatar/state/MammothTest.java
index 799be46c6..cf506bc8f 100644
--- a/state/src/test/java/com/iluwatar/state/MammothTest.java
+++ b/state/src/test/java/com/iluwatar/state/MammothTest.java
@@ -60,7 +60,7 @@ public class MammothTest {
    * value.
    */
   @Test
-  public void testTimePasses() {
+  void testTimePasses() {
     final var mammoth = new Mammoth();
 
     mammoth.observe();
@@ -89,7 +89,7 @@ public class MammothTest {
    * Verify if {@link Mammoth#toString()} gives the expected value
    */
   @Test
-  public void testToString() {
+  void testToString() {
     final var toString = new Mammoth().toString();
     assertNotNull(toString);
     assertEquals("The mammoth", toString);
diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
index 4406df229..2eab16b22 100644
--- a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
+++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.stepbuilder;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Step Builder Pattern
@@ -56,10 +55,9 @@ import org.slf4j.LoggerFactory;
  *
  * @see <a href="http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html">http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html</a>
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
index 89b56beb3..5bc565030 100644
--- a/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
+++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/CharacterStepBuilderTest.java
@@ -41,7 +41,7 @@ public class CharacterStepBuilderTest {
    * Build a new wizard {@link Character} and verify if it has the expected attributes
    */
   @Test
-  public void testBuildWizard() {
+  void testBuildWizard() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Merlin")
         .wizardClass("alchemist")
@@ -69,7 +69,7 @@ public class CharacterStepBuilderTest {
    * expected attributes
    */
   @Test
-  public void testBuildPoorWizard() {
+  void testBuildPoorWizard() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Merlin")
         .wizardClass("alchemist")
@@ -88,7 +88,7 @@ public class CharacterStepBuilderTest {
    * Build a new wizard {@link Character} and verify if it has the expected attributes
    */
   @Test
-  public void testBuildWeakWizard() {
+  void testBuildWeakWizard() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Merlin")
         .wizardClass("alchemist")
@@ -104,12 +104,11 @@ public class CharacterStepBuilderTest {
 
   }
 
-
   /**
    * Build a new warrior {@link Character} and verify if it has the expected attributes
    */
   @Test
-  public void testBuildWarrior() {
+  void testBuildWarrior() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Cuauhtemoc")
         .fighterClass("aztec")
@@ -137,7 +136,7 @@ public class CharacterStepBuilderTest {
    * expected attributes
    */
   @Test
-  public void testBuildPoorWarrior() {
+  void testBuildPoorWarrior() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Poor warrior")
         .fighterClass("none")
@@ -157,7 +156,7 @@ public class CharacterStepBuilderTest {
    * has the expected attributes
    */
   @Test
-  public void testBuildWeakWarrior() {
+  void testBuildWeakWarrior() {
     final var character = CharacterStepBuilder.newBuilder()
         .name("Weak warrior")
         .fighterClass("none")
diff --git a/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
index 61b3e5d07..4fce53a35 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/HalfArithmetic.java
@@ -23,15 +23,14 @@
 
 package com.iluwatar.strangler;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * System under migration. Depends on old version source ({@link OldSource}) and
  * developing one ({@link HalfSource}).
  */
+@Slf4j
 public class HalfArithmetic {
-  private static final Logger LOGGER = LoggerFactory.getLogger(HalfArithmetic.class);
   private static final String VERSION = "1.5";
 
   private final HalfSource newSource;
@@ -65,7 +64,7 @@ public class HalfArithmetic {
   /**
    * Chech if has any zero.
    * @param nums numbers need to check
-   * @return  if has any zero, return true, else, return false
+   * @return if has any zero, return true, else, return false
    */
   public boolean ifHasZero(int... nums) {
     LOGGER.info("Arithmetic check zero {}", VERSION);
diff --git a/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java b/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
index 90b1fed6c..43b7fff36 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/HalfSource.java
@@ -24,15 +24,14 @@
 package com.iluwatar.strangler;
 
 import java.util.Arrays;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Source under development. Replace part of old source and has added some new features.
  */
+@Slf4j
 public class HalfSource {
-  private static final Logger LOGGER = LoggerFactory.getLogger(HalfSource.class);
-  private static final  String VERSION = "1.5";
+  private static final String VERSION = "1.5";
 
   /**
    * Implement accumulate sum with new technique.
diff --git a/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
index c2ddfe290..3d33c901d 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/NewArithmetic.java
@@ -23,15 +23,14 @@
 
 package com.iluwatar.strangler;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * System after whole migration. Only depends on new version source ({@link NewSource}).
  */
+@Slf4j
 public class NewArithmetic {
-  private static final Logger LOGGER = LoggerFactory.getLogger(NewArithmetic.class);
-  private static final  String VERSION = "2.0";
+  private static final String VERSION = "2.0";
 
   private final NewSource source;
 
@@ -62,7 +61,7 @@ public class NewArithmetic {
   /**
    * Chech if has any zero.
    * @param nums numbers need to check
-   * @return  if has any zero, return true, else, return false
+   * @return if has any zero, return true, else, return false
    */
   public boolean ifHasZero(int... nums) {
     LOGGER.info("Arithmetic check zero {}", VERSION);
diff --git a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
index 5861ba11f..e3182a1e4 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/NewSource.java
@@ -24,16 +24,15 @@
 package com.iluwatar.strangler;
 
 import java.util.Arrays;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * New source. Completely covers functionalities of old source with new techniques
  * and also has some new features.
  */
+@Slf4j
 public class NewSource {
-  private static final Logger LOGGER = LoggerFactory.getLogger(NewSource.class);
-  private static final  String VERSION = "2.0";
+  private static final String VERSION = "2.0";
   public static final String SOURCE_MODULE = "Source module {}";
 
   public int accumulateSum(int... nums) {
diff --git a/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java b/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
index 3295a6fd5..670a572bf 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/OldArithmetic.java
@@ -23,15 +23,14 @@
 
 package com.iluwatar.strangler;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Old version system depends on old version source ({@link OldSource}).
  */
+@Slf4j
 public class OldArithmetic {
-  private static final Logger LOGGER = LoggerFactory.getLogger(OldArithmetic.class);
-  private static final  String VERSION = "1.0";
+  private static final String VERSION = "1.0";
 
   private final OldSource source;
 
diff --git a/strangler/src/main/java/com/iluwatar/strangler/OldSource.java b/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
index dbccfc0c4..f5ffe2216 100644
--- a/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
+++ b/strangler/src/main/java/com/iluwatar/strangler/OldSource.java
@@ -23,14 +23,13 @@
 
 package com.iluwatar.strangler;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Old source with techniques out of date.
  */
+@Slf4j
 public class OldSource {
-  private static final Logger LOGGER = LoggerFactory.getLogger(OldSource.class);
   private static final String VERSION = "1.0";
 
   /**
diff --git a/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
index 410199e97..11f94fa03 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/HalfArithmeticTest.java
@@ -23,9 +23,10 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * Test methods in HalfArithmetic
@@ -34,17 +35,17 @@ class HalfArithmeticTest {
   private static final HalfArithmetic arithmetic = new HalfArithmetic(new HalfSource(), new OldSource());
 
   @Test
-  public void testSum() {
+  void testSum() {
     assertEquals(0, arithmetic.sum(-1, 0, 1));
   }
 
   @Test
-  public void testMul() {
+  void testMul() {
     assertEquals(0, arithmetic.mul(-1, 0, 1));
   }
 
   @Test
-  public void testIfHasZero() {
+  void testIfHasZero() {
     assertTrue(arithmetic.ifHasZero(-1, 0, 1));
   }
 }
\ No newline at end of file
diff --git a/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
index 31577842b..3d681a296 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/HalfSourceTest.java
@@ -23,11 +23,10 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
-
+import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 
-import static org.junit.jupiter.api.Assertions.assertEquals;
+import org.junit.jupiter.api.Test;
 
 /**
  * Test methods in HalfSource
@@ -36,12 +35,12 @@ public class HalfSourceTest {
   private static final HalfSource source = new HalfSource();
 
   @Test
-  public void testAccumulateSum() {
+  void testAccumulateSum() {
     assertEquals(0, source.accumulateSum(-1, 0, 1));
   }
 
   @Test
-  public void testIfNonZero() {
+  void testIfNonZero() {
     assertFalse(source.ifNonZero(-1, 0, 1));
   }
 }
diff --git a/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
index 3fa38f4a7..237fd5a50 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/NewArithmeticTest.java
@@ -23,9 +23,10 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
 
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * Test methods in NewArithmetic
@@ -34,17 +35,17 @@ class NewArithmeticTest {
   private static final NewArithmetic arithmetic = new NewArithmetic(new NewSource());
 
   @Test
-  public void testSum() {
+  void testSum() {
     assertEquals(0, arithmetic.sum(-1, 0, 1));
   }
 
   @Test
-  public void testMul() {
+  void testMul() {
     assertEquals(0, arithmetic.mul(-1, 0, 1));
   }
 
   @Test
-  public void testIfHasZero() {
+  void testIfHasZero() {
     assertTrue(arithmetic.ifHasZero(-1, 0, 1));
   }
 }
\ No newline at end of file
diff --git a/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
index 89a078e84..b51c69ab1 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/NewSourceTest.java
@@ -23,11 +23,11 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Test methods in NewSource
  */
@@ -35,17 +35,17 @@ public class NewSourceTest {
   private static final NewSource source = new NewSource();
 
   @Test
-  public void testAccumulateSum() {
+  void testAccumulateSum() {
     assertEquals(0, source.accumulateSum(-1, 0, 1));
   }
 
   @Test
-  public void testAccumulateMul() {
+  void testAccumulateMul() {
     assertEquals(0, source.accumulateMul(-1, 0, 1));
   }
 
   @Test
-  public void testIfNonZero() {
+  void testIfNonZero() {
     assertFalse(source.ifNonZero(-1, 0, 1));
   }
 }
diff --git a/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java b/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
index 8090d7a56..afe662345 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/OldArithmeticTest.java
@@ -23,9 +23,9 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
+import static org.junit.jupiter.api.Assertions.assertEquals;
 
-import static org.junit.jupiter.api.Assertions.*;
+import org.junit.jupiter.api.Test;
 
 /**
  * Test methods in OldArithmetic
@@ -34,12 +34,12 @@ class OldArithmeticTest {
   private static final OldArithmetic arithmetic = new OldArithmetic(new OldSource());
 
   @Test
-  public void testSum() {
+  void testSum() {
     assertEquals(0, arithmetic.sum(-1, 0, 1));
   }
 
   @Test
-  public void testMul() {
+  void testMul() {
     assertEquals(0, arithmetic.mul(-1, 0, 1));
   }
 }
\ No newline at end of file
diff --git a/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java b/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
index f072033d4..e099efee0 100644
--- a/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
+++ b/strangler/src/test/java/com/iluwatar/strangler/OldSourceTest.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.strangler;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
+import org.junit.jupiter.api.Test;
+
 /**
  * Test methods in OldSource
  */
@@ -34,12 +34,12 @@ public class OldSourceTest {
   private static final OldSource source = new OldSource();
 
   @Test
-  public void testAccumulateSum() {
+  void testAccumulateSum() {
     assertEquals(0, source.accumulateSum(-1, 0, 1));
   }
 
   @Test
-  public void testAccumulateMul() {
+  void testAccumulateMul() {
     assertEquals(0, source.accumulateMul(-1, 0, 1));
   }
 }
diff --git a/strategy/README.md b/strategy/README.md
index 2d2cbf9c4..d617ec024 100644
--- a/strategy/README.md
+++ b/strategy/README.md
@@ -44,30 +44,27 @@ public interface DragonSlayingStrategy {
   void execute();
 }
 
+@Slf4j
 public class MeleeStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(MeleeStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("With your Excalibur you sever the dragon's head!");
   }
 }
 
+@Slf4j
 public class ProjectileStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ProjectileStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You shoot the dragon with the magical crossbow and it falls dead on the ground!");
   }
 }
 
+@Slf4j
 public class SpellStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SpellStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You cast the spell of disintegration and the dragon vaporizes in a pile of dust!");
diff --git a/strategy/src/main/java/com/iluwatar/strategy/App.java b/strategy/src/main/java/com/iluwatar/strategy/App.java
index 9abab0b01..8554ce3ff 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/App.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/App.java
@@ -23,11 +23,10 @@
 
 package com.iluwatar.strategy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
- * 
+ *
  * <p>The Strategy pattern (also known as the policy pattern) is a software design pattern that
  * enables an algorithm's behavior to be selected at runtime.</p>
  *
@@ -37,12 +36,11 @@ import org.slf4j.LoggerFactory;
  *
  * <p>In this example ({@link DragonSlayingStrategy}) encapsulates an algorithm. The containing
  * object ({@link DragonSlayer}) can alter its behavior by changing its strategy.</p>
- * 
+ *
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-  
   /**
    * Program entry point.
    *
diff --git a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
index 3c017a26c..abee70417 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/LambdaStrategy.java
@@ -23,13 +23,11 @@
 
 package com.iluwatar.strategy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
+@Slf4j
 public class LambdaStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(LambdaStrategy.class);
-
   public enum Strategy implements DragonSlayingStrategy {
     MeleeStrategy(() -> LOGGER.info(
         "With your Excalibur you severe the dragon's head!")),
diff --git a/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
index 658427279..06a567030 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/MeleeStrategy.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.strategy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Melee strategy.
  */
+@Slf4j
 public class MeleeStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(MeleeStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("With your Excalibur you sever the dragon's head!");
diff --git a/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
index a88179259..6c6c73bcc 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/ProjectileStrategy.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.strategy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Projectile strategy.
  */
+@Slf4j
 public class ProjectileStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ProjectileStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You shoot the dragon with the magical crossbow and it falls dead on the ground!");
diff --git a/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java b/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
index 6199d303a..70572bb6d 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/SpellStrategy.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.strategy;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Spell strategy.
  */
+@Slf4j
 public class SpellStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SpellStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You cast the spell of disintegration and the dragon vaporizes in a pile of dust!");
diff --git a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
index c675ffcc2..d3b0fe0c9 100644
--- a/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
+++ b/strategy/src/test/java/com/iluwatar/strategy/DragonSlayerTest.java
@@ -40,7 +40,7 @@ public class DragonSlayerTest {
    * Verify if the dragon slayer uses the strategy during battle.
    */
   @Test
-  public void testGoToBattle() {
+  void testGoToBattle() {
     final var strategy = mock(DragonSlayingStrategy.class);
     final var dragonSlayer = new DragonSlayer(strategy);
 
@@ -53,7 +53,7 @@ public class DragonSlayerTest {
    * Verify if the dragon slayer uses the new strategy during battle after a change of strategy.
    */
   @Test
-  public void testChangeStrategy() {
+  void testChangeStrategy() {
     final var initialStrategy = mock(DragonSlayingStrategy.class);
     final var dragonSlayer = new DragonSlayer(initialStrategy);
 
diff --git a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
index 0d0305967..dae2f512e 100644
--- a/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
+++ b/subclass-sandbox/src/main/java/com/iluwatar/subclasssandbox/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.subclasssandbox;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The subclass sandbox pattern describes a basic idea, while not having a lot
@@ -33,10 +32,9 @@ import org.slf4j.LoggerFactory;
  * while all subclasses shouldn't have to be touched. So the base class has to be
  * able to provide all of the operations a derived class needs to perform.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Entry point of the main program.
    * @param args Program runtime arguments.
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
index 8452e2df7..dee1ebce5 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/GroundDiveTest.java
@@ -27,6 +27,7 @@ import static com.github.stefanbirkner.systemlambda.SystemLambda.tapSystemOutNor
 import static org.junit.jupiter.api.Assertions.assertEquals;
 
 import com.github.stefanbirkner.systemlambda.Statement;
+
 import org.junit.jupiter.api.Test;
 
 /**
@@ -55,7 +56,7 @@ class GroundDiveTest {
   void testSpawnParticles() throws Exception {
     var groundDive = new GroundDive();
     final var outputLog = getLogContent(
-            () -> groundDive.spawnParticles("PARTICLE_TYPE", 100));
+        () -> groundDive.spawnParticles("PARTICLE_TYPE", 100));
     final var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
     assertEquals(outputLog, expectedLog);
   }
@@ -64,7 +65,7 @@ class GroundDiveTest {
   void testActivate() throws Exception {
     var groundDive = new GroundDive();
     var logs = tapSystemOutNormalized(groundDive::activate)
-            .split("\n");
+        .split("\n");
     final var expectedSize = 3;
     final var log1 = logs[0].split("-")[1].trim() + " -" + logs[0].split("-")[2].trim();
     final var expectedLog1 = "Move to ( 0.0, 0.0, -20.0 )";
diff --git a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
index eb9b58406..c0c86c09f 100644
--- a/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
+++ b/subclass-sandbox/src/test/java/com/iluwatar/subclasssandbox/SkyLaunchTest.java
@@ -54,7 +54,7 @@ class SkyLaunchTest {
   void testSpawnParticles() throws Exception {
     var skyLaunch = new SkyLaunch();
     var outputLog = getLogContent(
-            () -> skyLaunch.spawnParticles("PARTICLE_TYPE", 100));
+        () -> skyLaunch.spawnParticles("PARTICLE_TYPE", 100));
     var expectedLog = "Spawn 100 particle with type PARTICLE_TYPE";
     assertEquals(outputLog, expectedLog);
   }
@@ -63,7 +63,7 @@ class SkyLaunchTest {
   void testActivate() throws Exception {
     var skyLaunch = new SkyLaunch();
     var logs = tapSystemOutNormalized(skyLaunch::activate)
-            .split("\n");
+        .split("\n");
     final var expectedSize = 3;
     final var log1 = getLogContent(logs[0]);
     final var expectedLog1 = "Move to ( 0.0, 0.0, 20.0 )";
diff --git a/template-method/README.md b/template-method/README.md
index 23dd4d242..2b6a9c3ff 100644
--- a/template-method/README.md
+++ b/template-method/README.md
@@ -39,10 +39,9 @@ Wikipedia says
 Let's first introduce the template method class along with its concrete implementations.
 
 ```java
+@Slf4j
 public abstract class StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(StealingMethod.class);
-
   protected abstract String pickTarget();
 
   protected abstract void confuseTarget(String target);
@@ -57,10 +56,9 @@ public abstract class StealingMethod {
   }
 }
 
+@Slf4j
 public class SubtleMethod extends StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SubtleMethod.class);
-
   @Override
   protected String pickTarget() {
     return "shop keeper";
@@ -77,10 +75,9 @@ public class SubtleMethod extends StealingMethod {
   }
 }
 
+@Slf4j
 public class HitAndRunMethod extends StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HitAndRunMethod.class);
-
   @Override
   protected String pickTarget() {
     return "old goblin woman";
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
index bc550989a..ba4753062 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.templatemethod;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * HitAndRunMethod implementation of {@link StealingMethod}.
  */
+@Slf4j
 public class HitAndRunMethod extends StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(HitAndRunMethod.class);
-
   @Override
   protected String pickTarget() {
     return "old goblin woman";
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
index cdf2c11e3..76f750a5b 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/StealingMethod.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.templatemethod;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * StealingMethod defines skeleton for the algorithm.
  */
+@Slf4j
 public abstract class StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(StealingMethod.class);
-
   protected abstract String pickTarget();
 
   protected abstract void confuseTarget(String target);
diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
index 4ac7e30c6..034fd4335 100644
--- a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
+++ b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.templatemethod;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SubtleMethod implementation of {@link StealingMethod}.
  */
+@Slf4j
 public class SubtleMethod extends StealingMethod {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SubtleMethod.class);
-
   @Override
   protected String pickTarget() {
     return "shop keeper";
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
index 02beef759..236a29392 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/HalflingThiefTest.java
@@ -40,7 +40,7 @@ public class HalflingThiefTest {
    * Verify if the thief uses the provided stealing method
    */
   @Test
-  public void testSteal() {
+  void testSteal() {
     final var method = mock(StealingMethod.class);
     final var thief = new HalflingThief(method);
 
@@ -54,7 +54,7 @@ public class HalflingThiefTest {
    * Verify if the thief uses the provided stealing method, and the new method after changing it
    */
   @Test
-  public void testChangeMethod() {
+  void testChangeMethod() {
     final var initialMethod = mock(StealingMethod.class);
     final var thief = new HalflingThief(initialMethod);
 
diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
index 58f4bef31..911df7137 100644
--- a/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
+++ b/template-method/src/test/java/com/iluwatar/templatemethod/StealingMethodTest.java
@@ -104,7 +104,7 @@ public abstract class StealingMethodTest<M extends StealingMethod> {
    * Verify if the thief picks the correct target
    */
   @Test
-  public void testPickTarget() {
+  void testPickTarget() {
     assertEquals(expectedTarget, this.method.pickTarget());
   }
 
@@ -112,7 +112,7 @@ public abstract class StealingMethodTest<M extends StealingMethod> {
    * Verify if the target confusing step goes as planned
    */
   @Test
-  public void testConfuseTarget() {
+  void testConfuseTarget() {
     assertEquals(0, appender.getLogSize());
 
     this.method.confuseTarget(this.expectedTarget);
@@ -124,7 +124,7 @@ public abstract class StealingMethodTest<M extends StealingMethod> {
    * Verify if the stealing step goes as planned
    */
   @Test
-  public void testStealTheItem() {
+  void testStealTheItem() {
     assertEquals(0, appender.getLogSize());
 
     this.method.stealTheItem(this.expectedTarget);
@@ -136,7 +136,7 @@ public abstract class StealingMethodTest<M extends StealingMethod> {
    * Verify if the complete steal process goes as planned
    */
   @Test
-  public void testSteal() {
+  void testSteal() {
     this.method.steal();
 
     assertTrue(appender.logContains(this.expectedTargetResult));
diff --git a/thread-pool/README.md b/thread-pool/README.md
index de6403fe8..bc3c47fdc 100644
--- a/thread-pool/README.md
+++ b/thread-pool/README.md
@@ -102,10 +102,9 @@ Next we present a runnable `Worker` class that the thread pool will utilize to h
 peeling and coffee making.
 
 ```java
+@Slf4j
 public class Worker implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
-
   private final Task task;
 
   public Worker(final Task task) {
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
index 6562b68fb..9357c56a9 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java
@@ -26,8 +26,7 @@ package com.iluwatar.threadpool;
 import java.util.List;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Thread Pool pattern is where a number of threads are created to perform a number of tasks, which
@@ -42,10 +41,9 @@ import org.slf4j.LoggerFactory;
  * ExecutorService} with fixed number of threads (Thread Pool) and use them to execute the {@link
  * Worker}s.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
index 797d9f693..2bb166d4b 100644
--- a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
+++ b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java
@@ -23,17 +23,15 @@
 
 package com.iluwatar.threadpool;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Worker implements {@link Runnable} and thus can be executed by {@link
  * java.util.concurrent.ExecutorService}.
  */
+@Slf4j
 public class Worker implements Runnable {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Worker.class);
-
   private final Task task;
 
   public Worker(final Task task) {
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
index 66052659c..460093db1 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/TaskTest.java
@@ -83,7 +83,7 @@ public abstract class TaskTest<T extends Task> {
    * threads
    */
   @Test
-  public void testIdGeneration() throws Exception {
+  void testIdGeneration() throws Exception {
     assertTimeout(ofMillis(10000), () -> {
       final var service = Executors.newFixedThreadPool(THREAD_COUNT);
 
@@ -113,7 +113,7 @@ public abstract class TaskTest<T extends Task> {
    * a given number of times
    */
   @Test
-  public void testTimeMs() {
+  void testTimeMs() {
     for (var i = 0; i < 10; i++) {
       assertEquals(this.expectedExecutionTime * i, this.factory.apply(i).getTimeMs());
     }
@@ -123,7 +123,7 @@ public abstract class TaskTest<T extends Task> {
    * Verify if the task has some sort of {@link T#toString()}, different from 'null'
    */
   @Test
-  public void testToString() {
+  void testToString() {
     assertNotNull(this.factory.apply(0).toString());
   }
 
diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
index 854642ae1..a2c2b6c22 100644
--- a/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
+++ b/thread-pool/src/test/java/com/iluwatar/threadpool/WorkerTest.java
@@ -41,7 +41,7 @@ public class WorkerTest {
    * Verify if a worker does the actual job
    */
   @Test
-  public void testRun() {
+  void testRun() {
     final var task = mock(Task.class);
     final var worker = new Worker(task);
     verifyZeroInteractions(task);
diff --git a/throttling/README.md b/throttling/README.md
index 4a77638e1..dd46d11df 100644
--- a/throttling/README.md
+++ b/throttling/README.md
@@ -58,9 +58,8 @@ public class Tenant {
   }
 }
 
+@Slf4j
 public final class CallsCount {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(CallsCount.class);
   private final Map<String, AtomicLong> tenantCallsCount = new ConcurrentHashMap<>();
 
   public void addTenant(String tenantName) {
diff --git a/throttling/src/main/java/com/iluwatar/throttling/App.java b/throttling/src/main/java/com/iluwatar/throttling/App.java
index cc3eb11c6..ab8aa8601 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/App.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/App.java
@@ -27,8 +27,7 @@ import com.iluwatar.throttling.timer.ThrottleTimerImpl;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Throttling pattern is a design pattern to throttle or limit the use of resources or even a
@@ -41,10 +40,9 @@ import org.slf4j.LoggerFactory;
  * ({@link Tenant}) is the Tenant POJO class with which many tenants can be created ({@link
  * B2BService}) is the service which is consumed by the tenants and is throttled.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Application entry point.
    *
diff --git a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
index d5ba4e132..88a80d481 100644
--- a/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
+++ b/throttling/src/main/java/com/iluwatar/throttling/CallsCount.java
@@ -26,17 +26,15 @@ package com.iluwatar.throttling;
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.concurrent.atomic.AtomicLong;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A class to keep track of the counter of different Tenants.
  *
  * @author drastogi
  */
+@Slf4j
 public final class CallsCount {
-
-  private static final Logger LOGGER = LoggerFactory.getLogger(CallsCount.class);
   private final Map<String, AtomicLong> tenantCallsCount = new ConcurrentHashMap<>();
 
   /**
diff --git a/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java b/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
index 78dcd3ea8..93cf3efaa 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/B2BServiceTest.java
@@ -37,7 +37,7 @@ public class B2BServiceTest {
   private final CallsCount callsCount = new CallsCount();
 
   @Test
-  public void dummyCustomerApiTest() {
+  void dummyCustomerApiTest() {
     var tenant = new Tenant("testTenant", 2, callsCount);
     // In order to assure that throttling limits will not be reset, we use an empty throttling implementation
     var timer = (Throttler) () -> {
diff --git a/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java b/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
index d9aabc9a9..2ea33ec3d 100644
--- a/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
+++ b/throttling/src/test/java/com/iluwatar/throttling/TenantTest.java
@@ -34,7 +34,7 @@ import org.junit.jupiter.api.Test;
 public class TenantTest {
 
   @Test
-  public void constructorTest() {
+  void constructorTest() {
     assertThrows(InvalidParameterException.class, () -> {
       new Tenant("FailTenant", -1, new CallsCount());
     });
diff --git a/tls/src/main/java/com/iluwatar/tls/App.java b/tls/src/main/java/com/iluwatar/tls/App.java
index 26adafc69..644d47abd 100644
--- a/tls/src/main/java/com/iluwatar/tls/App.java
+++ b/tls/src/main/java/com/iluwatar/tls/App.java
@@ -25,8 +25,7 @@ package com.iluwatar.tls;
 
 import java.util.Calendar;
 import java.util.concurrent.Executors;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * ThreadLocal pattern
@@ -58,10 +57,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author Thomas Bauer, 2017
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java b/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
index 9f1743ae2..d084fdc0e 100644
--- a/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
+++ b/tls/src/main/java/com/iluwatar/tls/DateFormatCallable.java
@@ -27,8 +27,7 @@ import java.text.DateFormat;
 import java.text.SimpleDateFormat;
 import java.util.concurrent.Callable;
 import java.util.stream.IntStream;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * DateFormatCallable converts string dates to a date format using SimpleDateFormat. The date format
@@ -42,9 +41,9 @@ import org.slf4j.LoggerFactory;
  *
  * @author Thomas Bauer, 2017
  */
+@Slf4j
 public class DateFormatCallable implements Callable<Result> {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DateFormatCallable.class);
   // class variables (members)
   private final ThreadLocal<DateFormat> df;    //TLTL
   // private DateFormat df;                 //NTLNTL
@@ -86,7 +85,7 @@ public class DateFormatCallable implements Callable<Result> {
       }
     });
 
-    LOGGER.info(Thread.currentThread() + " finished processing part of the thread");
+    LOGGER.info("{} finished processing part of the thread", Thread.currentThread());
 
     return result;
   }
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
index 9713c9b39..9d1eeaa27 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTest.java
@@ -122,7 +122,7 @@ public class DateFormatCallableTest {
    * 15.12.2015
    */
   @Test
-  public void testDateValues() {
+  void testDateValues() {
     assertEquals(expectedDateValues, createdDateValues);
   }
 
@@ -131,7 +131,7 @@ public class DateFormatCallableTest {
    * deliver 5 date values
    */
   @Test
-  public void testCounterDateValues() {
+  void testCounterDateValues() {
     assertEquals(expectedCounterDateValues, result.getDateList().size());
   }
 
@@ -140,7 +140,7 @@ public class DateFormatCallableTest {
    * deliver no exceptions
    */
   @Test
-  public void testCounterExceptions() {
+  void testCounterExceptions() {
     assertEquals(expectedCounterExceptions, result.getExceptionList().size());
   }
 }
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
index 7b7e33ffd..33db95608 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestIncorrectDateFormat.java
@@ -96,7 +96,7 @@ public class DateFormatCallableTestIncorrectDateFormat {
    * same exception
    */
   @Test
-  public void testExceptions() {
+  void testExceptions() {
     assertEquals(expectedExceptions, result.getExceptionList());
   }
 
@@ -105,7 +105,7 @@ public class DateFormatCallableTestIncorrectDateFormat {
    * deliver no date values
    */
   @Test
-  public void testCounterDateValues() {
+  void testCounterDateValues() {
     assertEquals(expectedCounterDateValues, result.getDateList().size());
   }
 
@@ -114,7 +114,7 @@ public class DateFormatCallableTestIncorrectDateFormat {
    * deliver 5 exceptions
    */
   @Test
-  public void testCounterExceptions() {
+  void testCounterExceptions() {
     assertEquals(expectedCounterExceptions, result.getExceptionList().size());
   }
 }
diff --git a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
index a0a8a7430..1d63e8da0 100644
--- a/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
+++ b/tls/src/test/java/com/iluwatar/tls/DateFormatCallableTestMultiThread.java
@@ -134,7 +134,7 @@ public class DateFormatCallableTestMultiThread {
    * 15.12.2015 by each thread
    */
   @Test
-  public void testDateValues() {
+  void testDateValues() {
     for (var createdDateValue : createdDateValues) {
       assertEquals(expectedDateValues, createdDateValue);
     }
@@ -145,7 +145,7 @@ public class DateFormatCallableTestMultiThread {
    * deliver 5 date values by each thread
    */
   @Test
-  public void testCounterDateValues() {
+  void testCounterDateValues() {
     for (var value : result) {
       assertEquals(expectedCounterDateValues, value.getDateList().size());
     }
@@ -156,7 +156,7 @@ public class DateFormatCallableTestMultiThread {
    * deliver no exceptions
    */
   @Test
-  public void testCounterExceptions() {
+  void testCounterExceptions() {
     for (var value : result) {
       assertEquals(expectedCounterExceptions, value.getExceptionList().size());
     }
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
index abe200753..748d2effd 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java
@@ -24,8 +24,7 @@
 package com.iluwatar.tolerantreader;
 
 import java.io.IOException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Tolerant Reader is an integration pattern that helps creating robust communication systems. The
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * schema. Fortunately the reading method has been designed with the Tolerant Reader pattern and
  * does not break even though {@link RainbowFishV2} has new fields that are serialized.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    */
@@ -63,7 +61,7 @@ public class App {
     LOGGER.info(
         "fishV2 name={} age={} length={} weight={} sleeping={} hungry={} angry={}",
         fishV2.getName(), fishV2.getAge(), fishV2.getLengthMeters(), fishV2.getWeightTons(),
-        fishV2.getHungry(), fishV2.getAngry(), fishV2.getSleeping());
+        fishV2.isHungry(), fishV2.isAngry(), fishV2.isSleeping());
     RainbowFishSerializer.writeV2(fishV2, "fish2.out");
     // Read V2 with V1 method
     var deserializedFishV2 = RainbowFishSerializer.readV1("fish2.out");
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
index 579c5ee2a..c15fd5b57 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFish.java
@@ -24,10 +24,14 @@
 package com.iluwatar.tolerantreader;
 
 import java.io.Serializable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
 
 /**
  * RainbowFish is the initial schema.
  */
+@Getter
+@RequiredArgsConstructor
 public class RainbowFish implements Serializable {
 
   private static final long serialVersionUID = 1L;
@@ -37,30 +41,4 @@ public class RainbowFish implements Serializable {
   private final int lengthMeters;
   private final int weightTons;
 
-  /**
-   * Constructor.
-   */
-  public RainbowFish(String name, int age, int lengthMeters, int weightTons) {
-    this.name = name;
-    this.age = age;
-    this.lengthMeters = lengthMeters;
-    this.weightTons = weightTons;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public int getAge() {
-    return age;
-  }
-
-  public int getLengthMeters() {
-    return lengthMeters;
-  }
-
-  public int getWeightTons() {
-    return weightTons;
-  }
-
 }
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
index 9901126f6..22fd84f85 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java
@@ -51,8 +51,8 @@ public final class RainbowFishSerializer {
     var map = Map.of(
         "name", rainbowFish.getName(),
         "age", String.format("%d", rainbowFish.getAge()),
-            LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
-            WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons())
+        LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
+        WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons())
     );
 
     try (var fileOut = new FileOutputStream(filename);
@@ -68,11 +68,11 @@ public final class RainbowFishSerializer {
     var map = Map.of(
         "name", rainbowFish.getName(),
         "age", String.format("%d", rainbowFish.getAge()),
-            LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
-            WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons()),
-        "angry", Boolean.toString(rainbowFish.getAngry()),
-        "hungry", Boolean.toString(rainbowFish.getHungry()),
-        "sleeping", Boolean.toString(rainbowFish.getSleeping())
+        LENGTH_METERS, String.format("%d", rainbowFish.getLengthMeters()),
+        WEIGHT_TONS, String.format("%d", rainbowFish.getWeightTons()),
+        "angry", Boolean.toString(rainbowFish.isAngry()),
+        "hungry", Boolean.toString(rainbowFish.isHungry()),
+        "sleeping", Boolean.toString(rainbowFish.isSleeping())
     );
 
     try (var fileOut = new FileOutputStream(filename);
diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
index cffdb87af..5120ff006 100644
--- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
+++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishV2.java
@@ -23,9 +23,12 @@
 
 package com.iluwatar.tolerantreader;
 
+import lombok.Getter;
+
 /**
  * RainbowFishV2 is the evolved schema.
  */
+@Getter
 public class RainbowFishV2 extends RainbowFish {
 
   private static final long serialVersionUID = 1L;
@@ -49,15 +52,4 @@ public class RainbowFishV2 extends RainbowFish {
     this.angry = angry;
   }
 
-  public boolean getSleeping() {
-    return sleeping;
-  }
-
-  public boolean getHungry() {
-    return hungry;
-  }
-
-  public boolean getAngry() {
-    return angry;
-  }
 }
diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
index 101ca701d..b09efe9e0 100644
--- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
+++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/RainbowFishV2Test.java
@@ -46,9 +46,9 @@ class RainbowFishV2Test {
     assertEquals(1, fish.getAge());
     assertEquals(2, fish.getLengthMeters());
     assertEquals(3, fish.getWeightTons());
-    assertFalse(fish.getSleeping());
-    assertTrue(fish.getHungry());
-    assertFalse(fish.getAngry());
+    assertFalse(fish.isSleeping());
+    assertTrue(fish.isHungry());
+    assertFalse(fish.isAngry());
   }
 
 }
\ No newline at end of file
diff --git a/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java b/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
index 754a55d2c..32a3f1850 100644
--- a/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
+++ b/trampoline/src/main/java/com/iluwatar/trampoline/TrampolineApp.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.trampoline;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Trampoline pattern allows to define recursive algorithms by iterative loop.
@@ -33,17 +32,16 @@ import org.slf4j.LoggerFactory;
  * and to interleave the execution of functions without hard coding them together or even using
  * threads.
  */
+@Slf4j
 public class TrampolineApp {
 
-  private static final Logger log = LoggerFactory.getLogger(TrampolineApp.class);
-
   /**
    * Main program for showing pattern. It does loop with factorial function.
    */
   public static void main(String[] args) {
-    log.info("start pattern");
+    LOGGER.info("start pattern");
     var result = loop(10, 1).result();
-    log.info("result {}", result);
+    LOGGER.info("result {}", result);
 
   }
 
diff --git a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
index 6eff6d99e..0c7503e54 100644
--- a/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
+++ b/trampoline/src/test/java/com/iluwatar/trampoline/TrampolineAppTest.java
@@ -30,11 +30,10 @@ import org.junit.jupiter.api.Test;
 /**
  * Test for trampoline pattern.
  */
-public class TrampolineAppTest {
-
+class TrampolineAppTest {
 
   @Test
-  public void testTrampolineWithFactorialFunction() {
+  void testTrampolineWithFactorialFunction() {
     long result = TrampolineApp.loop(10, 1).result();
     assertEquals(3_628_800, result);
   }
diff --git a/transaction-script/README.md b/transaction-script/README.md
index 3ae3cf4c1..bbbce5eb1 100644
--- a/transaction-script/README.md
+++ b/transaction-script/README.md
@@ -29,8 +29,8 @@ Programmatic example
 The `Hotel` class takes care of booking and cancelling room reservations.
 
 ```java
+@Slf4j
 public class Hotel {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   private final HotelDaoImpl hotelDao;
 
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
index db599cc2e..d26233c9f 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/App.java
@@ -67,7 +67,7 @@ public class App {
 
     // Print room booking status
     getRoomStatus(dao);
-  
+
     var hotel = new Hotel(dao);
 
     // Book rooms
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
index c00d0ae65..f189a0306 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/Hotel.java
@@ -23,11 +23,10 @@
 
 package com.iluwatar.transactionscript;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
+@Slf4j
 public class Hotel {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   private final HotelDaoImpl hotelDao;
 
@@ -65,7 +64,7 @@ public class Hotel {
    * @throws Exception if any error
    */
   public void cancelRoomBooking(int roomNumber) throws Exception {
-  
+
     var room = hotelDao.getById(roomNumber);
 
     if (room.isEmpty()) {
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
index f289712a3..ae56ed2e5 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/HotelDaoImpl.java
@@ -33,11 +33,10 @@ import java.util.function.Consumer;
 import java.util.stream.Stream;
 import java.util.stream.StreamSupport;
 import javax.sql.DataSource;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
+@Slf4j
 public class HotelDaoImpl implements HotelDao {
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
 
   private final DataSource dataSource;
 
diff --git a/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java b/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
index 868f860ca..1ca397087 100644
--- a/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
+++ b/transaction-script/src/main/java/com/iluwatar/transactionscript/Room.java
@@ -23,9 +23,20 @@
 
 package com.iluwatar.transactionscript;
 
+import lombok.AllArgsConstructor;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.ToString;
+
 /**
  * A room POJO that represents the data that will be read from the data source.
  */
+@Setter
+@Getter
+@ToString
+@EqualsAndHashCode
+@AllArgsConstructor
 public class Room {
 
   private int id;
@@ -33,91 +44,4 @@ public class Room {
   private int price;
   private boolean booked;
 
-  /**
-   * Create an instance of room.
-   * @param id room id
-   * @param roomType room type
-   * @param price room price
-   * @param booked room booking status
-   */
-  public Room(int id, String roomType, int price, boolean booked) {
-    this.id = id;
-    this.roomType = roomType;
-    this.price = price;
-    this.booked = booked;
-  }
-
-  public int getId() {
-    return id;
-  }
-
-  public void setId(int id) {
-    this.id = id;
-  }
-
-  public String getRoomType() {
-    return roomType;
-  }
-
-  public void setRoomType(String roomType) {
-    this.roomType = roomType;
-  }
-
-  public int getPrice() {
-    return price;
-  }
-
-  public void setPrice(int price) {
-    this.price = price;
-  }
-
-  public boolean isBooked() {
-    return booked;
-  }
-
-  public void setBooked(boolean booked) {
-    this.booked = booked;
-  }
-
-  @Override
-  public boolean equals(Object o) {
-    if (this == o) {
-      return true;
-    }
-    if (o == null || getClass() != o.getClass()) {
-      return false;
-    }
-
-    Room room = (Room) o;
-
-    if (id != room.id) {
-      return false;
-    }
-    if (price != room.price) {
-      return false;
-    }
-    if (booked != room.booked) {
-      return false;
-    }
-    return roomType.equals(room.roomType);
-  }
-
-  @Override
-  public int hashCode() {
-    int result = id;
-    result = 31 * result + roomType.hashCode();
-    result = 31 * result + price;
-    result = 31 * result + (booked ? 1 : 0);
-    return result;
-  }
-
-  @Override
-  public String toString() {
-    return "Room{"
-        + "id=" + id
-        + ", roomType=" + roomType
-        + ", price=" + price
-        + ", booked=" + booked
-        + '}';
-  }
 }
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
index 67eb52def..c6b52ef4f 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelDaoImplTest.java
@@ -23,6 +23,18 @@
 
 package com.iluwatar.transactionscript;
 
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assumptions.assumeTrue;
+import static org.mockito.Mockito.doReturn;
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.mock;
+
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.SQLException;
+import javax.sql.DataSource;
 import org.h2.jdbcx.JdbcDataSource;
 import org.junit.jupiter.api.AfterEach;
 import org.junit.jupiter.api.Assertions;
@@ -31,15 +43,6 @@ import org.junit.jupiter.api.Nested;
 import org.junit.jupiter.api.Test;
 import org.mockito.Mockito;
 
-import javax.sql.DataSource;
-import java.sql.Connection;
-import java.sql.DriverManager;
-import java.sql.SQLException;
-
-import static org.junit.jupiter.api.Assertions.*;
-import static org.junit.jupiter.api.Assumptions.assumeTrue;
-import static org.mockito.Mockito.*;
-
 /**
  * Tests {@link HotelDaoImpl}.
  */
@@ -90,7 +93,7 @@ public class HotelDaoImplTest {
     public class NonExistingRoom {
 
       @Test
-      public void addingShouldResultInSuccess() throws Exception {
+      void addingShouldResultInSuccess() throws Exception {
         try (var allRooms = dao.getAll()) {
           assumeTrue(allRooms.count() == 1);
         }
@@ -104,7 +107,7 @@ public class HotelDaoImplTest {
       }
 
       @Test
-      public void deletionShouldBeFailureAndNotAffectExistingRooms() throws Exception {
+      void deletionShouldBeFailureAndNotAffectExistingRooms() throws Exception {
         final var nonExistingRoom = new Room(2, "Double", 80, false);
         var result = dao.delete(nonExistingRoom);
 
@@ -113,7 +116,7 @@ public class HotelDaoImplTest {
       }
 
       @Test
-      public void updationShouldBeFailureAndNotAffectExistingRooms() throws Exception {
+      void updationShouldBeFailureAndNotAffectExistingRooms() throws Exception {
         final var nonExistingId = getNonExistingRoomId();
         final var newRoomType = "Double";
         final var newPrice = 80;
@@ -125,7 +128,7 @@ public class HotelDaoImplTest {
       }
 
       @Test
-      public void retrieveShouldReturnNoRoom() throws Exception {
+      void retrieveShouldReturnNoRoom() throws Exception {
         assertFalse(dao.getById(getNonExistingRoomId()).isPresent());
       }
     }
@@ -138,7 +141,7 @@ public class HotelDaoImplTest {
     public class ExistingRoom {
 
       @Test
-      public void addingShouldResultInFailureAndNotAffectExistingRooms() throws Exception {
+      void addingShouldResultInFailureAndNotAffectExistingRooms() throws Exception {
         var existingRoom = new Room(1, "Single", 50, false);
         var result = dao.add(existingRoom);
 
@@ -148,7 +151,7 @@ public class HotelDaoImplTest {
       }
 
       @Test
-      public void deletionShouldBeSuccessAndRoomShouldBeNonAccessible() throws Exception {
+      void deletionShouldBeSuccessAndRoomShouldBeNonAccessible() throws Exception {
         var result = dao.delete(existingRoom);
 
         Assertions.assertTrue(result);
@@ -157,7 +160,7 @@ public class HotelDaoImplTest {
       }
 
       @Test
-      public void updationShouldBeSuccessAndAccessingTheSameRoomShouldReturnUpdatedInformation() throws
+      void updationShouldBeSuccessAndAccessingTheSameRoomShouldReturnUpdatedInformation() throws
           Exception {
         final var newRoomType = "Double";
         final var newPrice = 80;
@@ -204,21 +207,21 @@ public class HotelDaoImplTest {
     }
 
     @Test
-    public void addingARoomFailsWithExceptionAsFeedbackToClient() {
+    void addingARoomFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.add(new Room(2, "Double", 80, false));
       });
     }
 
     @Test
-    public void deletingARoomFailsWithExceptionAsFeedbackToTheClient() {
+    void deletingARoomFailsWithExceptionAsFeedbackToTheClient() {
       assertThrows(Exception.class, () -> {
         dao.delete(existingRoom);
       });
     }
 
     @Test
-    public void updatingARoomFailsWithFeedbackToTheClient() {
+    void updatingARoomFailsWithFeedbackToTheClient() {
       final var newRoomType = "Double";
       final var newPrice = 80;
       final var newBookingStatus = false;
@@ -228,14 +231,14 @@ public class HotelDaoImplTest {
     }
 
     @Test
-    public void retrievingARoomByIdFailsWithExceptionAsFeedbackToClient() {
+    void retrievingARoomByIdFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.getById(existingRoom.getId());
       });
     }
 
     @Test
-    public void retrievingAllRoomsFailsWithExceptionAsFeedbackToClient() {
+    void retrievingAllRoomsFailsWithExceptionAsFeedbackToClient() {
       assertThrows(Exception.class, () -> {
         dao.getAll();
       });
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
index b0b7f8bd4..061261400 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/HotelTest.java
@@ -23,19 +23,20 @@
 
 package com.iluwatar.transactionscript;
 
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+import java.util.List;
+import javax.sql.DataSource;
 import org.h2.jdbcx.JdbcDataSource;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
-import javax.sql.DataSource;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.*;
-
 /**
  * Tests {@link Hotel}
  */
-public class HotelTest {
+class HotelTest {
 
   private static final String H2_DB_URL = "jdbc:h2:~/test";
 
@@ -54,20 +55,20 @@ public class HotelTest {
   }
 
   @Test
-  public void bookingRoomShouldChangeBookedStatusToTrue() throws Exception {
+  void bookingRoomShouldChangeBookedStatusToTrue() throws Exception {
     hotel.bookRoom(1);
     assertTrue(dao.getById(1).get().isBooked());
   }
 
   @Test()
-  public void bookingRoomWithInvalidIdShouldRaiseException() {
+  void bookingRoomWithInvalidIdShouldRaiseException() {
     assertThrows(Exception.class, () -> {
       hotel.bookRoom(getNonExistingRoomId());
     });
   }
 
   @Test()
-  public void bookingRoomAgainShouldRaiseException() {
+  void bookingRoomAgainShouldRaiseException() {
     assertThrows(Exception.class, () -> {
       hotel.bookRoom(1);
       hotel.bookRoom(1);
@@ -75,12 +76,12 @@ public class HotelTest {
   }
 
   @Test
-  public void NotBookingRoomShouldNotChangeBookedStatus() throws Exception {
+  void NotBookingRoomShouldNotChangeBookedStatus() throws Exception {
     assertFalse(dao.getById(1).get().isBooked());
   }
 
   @Test
-  public void cancelRoomBookingShouldChangeBookedStatus() throws Exception {
+  void cancelRoomBookingShouldChangeBookedStatus() throws Exception {
     hotel.bookRoom(1);
     assertTrue(dao.getById(1).get().isBooked());
     hotel.cancelRoomBooking(1);
@@ -88,14 +89,14 @@ public class HotelTest {
   }
 
   @Test
-  public void cancelRoomBookingWithInvalidIdShouldRaiseException() {
+  void cancelRoomBookingWithInvalidIdShouldRaiseException() {
     assertThrows(Exception.class, () -> {
       hotel.cancelRoomBooking(getNonExistingRoomId());
     });
   }
 
   @Test
-  public void cancelRoomBookingForUnbookedRoomShouldRaiseException() {
+  void cancelRoomBookingForUnbookedRoomShouldRaiseException() {
     assertThrows(Exception.class, () -> {
       hotel.cancelRoomBooking(1);
     });
diff --git a/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java b/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
index 022c2e023..6c33083a8 100644
--- a/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
+++ b/transaction-script/src/test/java/com/iluwatar/transactionscript/RoomTest.java
@@ -23,16 +23,16 @@
 
 package com.iluwatar.transactionscript;
 
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertNotEquals;
 
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
 /**
  * Tests {@link Room}.
  */
-public class RoomTest {
+class RoomTest {
 
   private Room room;
   private static final int ID = 1;
@@ -41,33 +41,33 @@ public class RoomTest {
   private static final boolean BOOKED = false;
 
   @BeforeEach
-  public void setUp() {
+  void setUp() {
     room = new Room(ID, ROOMTYPE, PRICE, BOOKED);
   }
 
   @Test
-  public void getAndSetId() {
+  void getAndSetId() {
     final var newId = 2;
     room.setId(newId);
     assertEquals(newId, room.getId());
   }
 
   @Test
-  public void getAndSetRoomType() {
+  void getAndSetRoomType() {
     final var newRoomType = "Double";
     room.setRoomType(newRoomType);
     assertEquals(newRoomType, room.getRoomType());
   }
 
   @Test
-  public void getAndSetLastName() {
+  void getAndSetLastName() {
     final var newPrice = 60;
     room.setPrice(newPrice);
     assertEquals(newPrice, room.getPrice());
   }
 
   @Test
-  public void notEqualWithDifferentId() {
+  void notEqualWithDifferentId() {
     final var newId = 2;
     final var otherRoom = new Room(newId, ROOMTYPE, PRICE, BOOKED);
     assertNotEquals(room, otherRoom);
@@ -75,21 +75,21 @@ public class RoomTest {
   }
 
   @Test
-  public void equalsWithSameObjectValues() {
+  void equalsWithSameObjectValues() {
     final var otherRoom = new Room(ID, ROOMTYPE, PRICE, BOOKED);
     assertEquals(room, otherRoom);
     assertEquals(room.hashCode(), otherRoom.hashCode());
   }
 
   @Test
-  public void equalsWithSameObjects() {
+  void equalsWithSameObjects() {
     assertEquals(room, room);
     assertEquals(room.hashCode(), room.hashCode());
   }
 
   @Test
-  public void testToString() {
-    assertEquals(String.format("Room{id=%s, roomType=%s, price=%s, booked=%s}",
+  void testToString() {
+    assertEquals(String.format("Room(id=%s, roomType=%s, price=%s, booked=%s)",
         room.getId(), room.getRoomType(), room.getPrice(), room.isBooked()), room.toString());
   }
 }
diff --git a/twin/src/main/java/com/iluwatar/twin/BallItem.java b/twin/src/main/java/com/iluwatar/twin/BallItem.java
index 4498a5c43..a838fa040 100644
--- a/twin/src/main/java/com/iluwatar/twin/BallItem.java
+++ b/twin/src/main/java/com/iluwatar/twin/BallItem.java
@@ -23,26 +23,22 @@
 
 package com.iluwatar.twin;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This class represents a Ball which extends {@link GameItem} and implements the logic for ball
  * item, like move and draw. It hold a reference of {@link BallThread} to delegate the suspend and
  * resume task.
  */
+@Slf4j
 public class BallItem extends GameItem {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(BallItem.class);
-
   private boolean isSuspended;
 
+  @Setter
   private BallThread twin;
 
-  public void setTwin(BallThread twin) {
-    this.twin = twin;
-  }
-
   @Override
   public void doDraw() {
 
diff --git a/twin/src/main/java/com/iluwatar/twin/BallThread.java b/twin/src/main/java/com/iluwatar/twin/BallThread.java
index e9465f73c..115ea0c0a 100644
--- a/twin/src/main/java/com/iluwatar/twin/BallThread.java
+++ b/twin/src/main/java/com/iluwatar/twin/BallThread.java
@@ -23,28 +23,24 @@
 
 package com.iluwatar.twin;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.Setter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This class is a UI thread for drawing the {@link BallItem}, and provide the method for suspend
  * and resume. It hold the reference of {@link BallItem} to delegate the draw task.
  */
 
+@Slf4j
 public class BallThread extends Thread {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(BallThread.class);
-
+  @Setter
   private BallItem twin;
 
   private volatile boolean isSuspended;
 
   private volatile boolean isRunning = true;
 
-  public void setTwin(BallItem twin) {
-    this.twin = twin;
-  }
-
   /**
    * Run the thread.
    */
diff --git a/twin/src/main/java/com/iluwatar/twin/GameItem.java b/twin/src/main/java/com/iluwatar/twin/GameItem.java
index ef986997b..e0bac01bc 100644
--- a/twin/src/main/java/com/iluwatar/twin/GameItem.java
+++ b/twin/src/main/java/com/iluwatar/twin/GameItem.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.twin;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * GameItem is a common class which provides some common methods for game object.
  */
+@Slf4j
 public abstract class GameItem {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(GameItem.class);
-
   /**
    * Template method, do some common logic before draw.
    */
diff --git a/twin/src/test/java/com/iluwatar/twin/BallItemTest.java b/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
index 5c927b35c..997de03b6 100644
--- a/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/BallItemTest.java
@@ -60,7 +60,7 @@ public class BallItemTest {
   }
 
   @Test
-  public void testClick() {
+  void testClick() {
     final var ballThread = mock(BallThread.class);
     final var ballItem = new BallItem();
     ballItem.setTwin(ballThread);
@@ -78,7 +78,7 @@ public class BallItemTest {
   }
 
   @Test
-  public void testDoDraw() {
+  void testDoDraw() {
     final var ballItem = new BallItem();
     final var ballThread = mock(BallThread.class);
     ballItem.setTwin(ballThread);
@@ -92,7 +92,7 @@ public class BallItemTest {
   }
 
   @Test
-  public void testMove() {
+  void testMove() {
     final var ballItem = new BallItem();
     final var ballThread = mock(BallThread.class);
     ballItem.setTwin(ballThread);
diff --git a/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java b/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
index f42c29f5e..a9504bc20 100644
--- a/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
+++ b/twin/src/test/java/com/iluwatar/twin/BallThreadTest.java
@@ -42,13 +42,13 @@ import org.junit.jupiter.api.Test;
  *
  * @author Jeroen Meulemeester
  */
-public class BallThreadTest {
+class BallThreadTest {
 
   /**
    * Verify if the {@link BallThread} can be resumed
    */
   @Test
-  public void testSuspend() {
+  void testSuspend() {
     assertTimeout(ofMillis(5000), () -> {
       final var ballThread = new BallThread();
 
@@ -74,7 +74,7 @@ public class BallThreadTest {
    * Verify if the {@link BallThread} can be resumed
    */
   @Test
-  public void testResume() {
+  void testResume() {
     assertTimeout(ofMillis(5000), () -> {
       final var ballThread = new BallThread();
 
@@ -104,7 +104,7 @@ public class BallThreadTest {
    * Verify if the {@link BallThread} is interruptible
    */
   @Test
-  public void testInterrupt() {
+  void testInterrupt() {
     assertTimeout(ofMillis(5000), () -> {
       final var ballThread = new BallThread();
       final var exceptionHandler = mock(UncaughtExceptionHandler.class);
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
index e9b42d659..d7602b9a1 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/App.java
@@ -23,11 +23,9 @@
 
 package com.iluwatar.typeobject;
 
-import java.io.FileNotFoundException;
 import java.io.IOException;
+import lombok.extern.slf4j.Slf4j;
 import org.json.simple.parser.ParseException;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
 /**
  * <p>Type object pattern is the pattern we use when the OOP concept of creating a base class and
@@ -47,10 +45,9 @@ import org.slf4j.LoggerFactory;
  * the game and the {@link App} class has the game itself.</p>
  */
 
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * Program entry point.
    *
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
index a7b038664..946971714 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Candy.java
@@ -23,10 +23,15 @@
 
 package com.iluwatar.typeobject;
 
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.Setter;
+
 /**
  * The Candy class has a field type, which represents the 'type' of candy. The objects are created
  * by parsing the candy.json file.
  */
+@Getter(AccessLevel.PACKAGE)
 public class Candy {
 
   enum Type {
@@ -37,6 +42,8 @@ public class Candy {
   String name;
   Candy parent;
   String parentName;
+
+  @Setter
   private int points;
   private final Type type;
 
@@ -48,15 +55,4 @@ public class Candy {
     this.parentName = parentName;
   }
 
-  int getPoints() {
-    return this.points;
-  }
-
-  void setPoints(int a) {
-    this.points = a;
-  }
-
-  Type getType() {
-    return this.type;
-  }
 }
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
index d80b6a775..d803d1313 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/CandyGame.java
@@ -26,18 +26,16 @@ package com.iluwatar.typeobject;
 import com.iluwatar.typeobject.Candy.Type;
 import java.util.ArrayList;
 import java.util.List;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The CandyGame class contains the rules for the continuation of the game and has the game matrix
  * (field 'cells') and totalPoints gained during the game.
  */
 
+@Slf4j
 public class CandyGame {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CandyGame.class);
-
   Cell[][] cells;
   CellPool pool;
   int totalPoints;
diff --git a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
index 54de9bc95..94f909784 100644
--- a/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
+++ b/typeobjectpattern/src/main/java/com/iluwatar/typeobject/Cell.java
@@ -24,28 +24,20 @@
 package com.iluwatar.typeobject;
 
 import com.iluwatar.typeobject.Candy.Type;
+import lombok.AllArgsConstructor;
+import lombok.NoArgsConstructor;
 
 /**
  * The Cell object is what the game matrix is made of and contains the candy which is to be crushed
  * or collected as reward.
  */
+@AllArgsConstructor
+@NoArgsConstructor
 public class Cell {
   Candy candy;
   int positionX;
   int positionY;
 
-  Cell(Candy candy, int positionX, int positionY) {
-    this.candy = candy;
-    this.positionX = positionX;
-    this.positionY = positionY;
-  }
-
-  Cell() {
-    this.candy = null;
-    this.positionX = 0;
-    this.positionY = 0;
-  }
-
   void crush(CellPool pool, Cell[][] cellMatrix) {
     //take out from this position and put back in pool
     pool.addNewCell(this);
diff --git a/unit-of-work/README.md b/unit-of-work/README.md
index 01aa8e5d7..b8a300937 100644
--- a/unit-of-work/README.md
+++ b/unit-of-work/README.md
@@ -83,8 +83,8 @@ public interface IUnitOfWork<T> {
   void commit();
 }
 
+@Slf4j
 public class StudentRepository implements IUnitOfWork<Student> {
-  private static final Logger LOGGER = LoggerFactory.getLogger(StudentRepository.class);
 
   private final Map<String, List<Student>> context;
   private final StudentDatabase studentDatabase;
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
index 74d0581e7..b3de369b4 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/Student.java
@@ -23,36 +23,18 @@
 
 package com.iluwatar.unitofwork;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
 /**
  * {@link Student} is an entity.
  */
+@Getter
+@RequiredArgsConstructor
 public class Student {
+
   private final Integer id;
   private final String name;
   private final String address;
 
-  /**
-   * Constructor.
-   *
-   * @param id      student unique id
-   * @param name    name of student
-   * @param address address of student
-   */
-  public Student(Integer id, String name, String address) {
-    this.id = id;
-    this.name = name;
-    this.address = address;
-  }
-
-  public String getName() {
-    return name;
-  }
-
-  public Integer getId() {
-    return id;
-  }
-
-  public String getAddress() {
-    return address;
-  }
 }
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
index d11f07aa2..991aef12a 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/StudentRepository.java
@@ -26,29 +26,19 @@ package com.iluwatar.unitofwork;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * {@link StudentRepository} Student database repository. supports unit of work for student data.
  */
+@Slf4j
+@RequiredArgsConstructor
 public class StudentRepository implements IUnitOfWork<Student> {
-  private static final Logger LOGGER = LoggerFactory.getLogger(StudentRepository.class);
 
   private final Map<String, List<Student>> context;
   private final StudentDatabase studentDatabase;
 
-  /**
-   * Constructor.
-   *
-   * @param context         set of operations to be perform during commit.
-   * @param studentDatabase Database for student records.
-   */
-  public StudentRepository(Map<String, List<Student>> context, StudentDatabase studentDatabase) {
-    this.context = context;
-    this.studentDatabase = studentDatabase;
-  }
-
   @Override
   public void registerNew(Student student) {
     LOGGER.info("Registering {} for insert in context.", student.getName());
diff --git a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
index ede021742..60701be69 100644
--- a/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
+++ b/unit-of-work/src/main/java/com/iluwatar/unitofwork/UnitActions.java
@@ -23,18 +23,15 @@
 
 package com.iluwatar.unitofwork;
 
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+@Getter
+@RequiredArgsConstructor
 public enum UnitActions {
   INSERT("INSERT"),
   DELETE("DELETE"),
   MODIFY("MODIFY");
 
   private final String actionValue;
-
-  UnitActions(String actionValue) {
-    this.actionValue = actionValue;
-  }
-
-  public String getActionValue() {
-    return actionValue;
-  }
 }
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/App.java b/update-method/src/main/java/com/iluwatar/updatemethod/App.java
index e964eb478..b036a0cb2 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/App.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.updatemethod;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * This pattern simulate a collection of independent objects by telling each to
@@ -32,10 +31,9 @@ import org.slf4j.LoggerFactory;
  * of objects. Each object implements an update method that simulates one frame of
  * the object’s behavior. Each frame, the game updates every object in the collection.
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   private static final int GAME_RUNNING_TIME = 2000;
 
   /**
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java b/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
index b8fbac3df..9033c804a 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Entity.java
@@ -23,6 +23,8 @@
 
 package com.iluwatar.updatemethod;
 
+import lombok.Getter;
+import lombok.Setter;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -35,6 +37,8 @@ public abstract class Entity {
 
   protected int id;
 
+  @Getter
+  @Setter
   protected int position;
 
   public Entity(int id) {
@@ -44,11 +48,4 @@ public abstract class Entity {
 
   public abstract void update();
 
-  public int getPosition() {
-    return position;
-  }
-
-  public void setPosition(int position) {
-    this.position = position;
-  }
 }
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java b/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
index b28b35790..5e0ed27ac 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Skeleton.java
@@ -51,9 +51,9 @@ public class Skeleton extends Entity {
    * Constructor of Skeleton.
    *
    * @param id id of skeleton
-   * @param postition position of skeleton
+   * @param position position of skeleton
    */
-  public Skeleton(int id, int postition) {
+  public Skeleton(int id, int position) {
     super(id);
     this.position = position;
     patrollingLeft = false;
@@ -72,7 +72,7 @@ public class Skeleton extends Entity {
         patrollingLeft = true;
       }
     }
-    logger.info("Skeleton " + id + " is on position " + position + ".");
+    logger.info("Skeleton {} is on position {}.", id, position);
   }
 }
 
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java b/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
index 11b6f2438..eac4cbd00 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/Statue.java
@@ -57,7 +57,7 @@ public class Statue extends Entity {
 
   @Override
   public void update() {
-    if (++ frames == delay) {
+    if (++frames == delay) {
       shootLightning();
       frames = 0;
     }
diff --git a/update-method/src/main/java/com/iluwatar/updatemethod/World.java b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
index 696fca5c0..f4a86cec2 100644
--- a/update-method/src/main/java/com/iluwatar/updatemethod/World.java
+++ b/update-method/src/main/java/com/iluwatar/updatemethod/World.java
@@ -26,17 +26,15 @@ package com.iluwatar.updatemethod;
 import java.security.SecureRandom;
 import java.util.ArrayList;
 import java.util.List;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import java.util.Random;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * The game world class. Maintain all the objects existed in the game frames.
  */
+@Slf4j
 public class World {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(World.class);
-
   protected List<Entity> entities;
 
   protected volatile boolean isRunning;
@@ -70,6 +68,7 @@ public class World {
       Thread.sleep(lag);
     } catch (InterruptedException e) {
       LOGGER.error(e.getMessage());
+      Thread.currentThread().interrupt();
     }
   }
 
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
index 9c5c2a1e2..b7590ec9b 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/AppTest.java
@@ -23,10 +23,10 @@
 
 package com.iluwatar.updatemethod;
 
-import org.junit.jupiter.api.Test;
-
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
+import org.junit.jupiter.api.Test;
+
 class AppTest {
 
   @Test
diff --git a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
index a30dd26cb..620dfde73 100644
--- a/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
+++ b/update-method/src/test/java/com/iluwatar/updatemethod/SkeletonTest.java
@@ -31,7 +31,6 @@ import static org.junit.jupiter.api.Assertions.assertEquals;
 import static org.junit.jupiter.api.Assertions.assertFalse;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 
-
 class SkeletonTest {
 
   private static Skeleton skeleton;
diff --git a/value-object/src/main/java/com/iluwatar/value/object/App.java b/value-object/src/main/java/com/iluwatar/value/object/App.java
index 3c91c54f3..49375e94c 100644
--- a/value-object/src/main/java/com/iluwatar/value/object/App.java
+++ b/value-object/src/main/java/com/iluwatar/value/object/App.java
@@ -23,8 +23,7 @@
 
 package com.iluwatar.value.object;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * A Value Object are objects which follow value semantics rather than reference semantics. This
@@ -40,10 +39,9 @@ import org.slf4j.LoggerFactory;
  * <p>For more specific and strict rules to implement value objects check the rules from Stephen
  * Colebourne's term VALJO : http://blog.joda.org/2014/03/valjos-value-java-objects.html
  */
+@Slf4j
 public class App {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(App.class);
-
   /**
    * This practice creates three HeroStats(Value object) and checks equality between those.
    */
diff --git a/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java b/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
index 118658646..4d060ee0f 100644
--- a/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
+++ b/value-object/src/main/java/com/iluwatar/value/object/HeroStat.java
@@ -23,6 +23,11 @@
 
 package com.iluwatar.value.object;
 
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.ToString;
+
 /**
  * HeroStat is a value object.
  *
@@ -30,6 +35,10 @@ package com.iluwatar.value.object;
  *     http://docs.oracle.com/javase/8/docs/api/java/lang/doc-files/ValueBased.html
  *     </a>
  */
+@Getter
+@ToString
+@EqualsAndHashCode
+@RequiredArgsConstructor
 public class HeroStat {
 
   // Stats for a hero
@@ -38,74 +47,11 @@ public class HeroStat {
   private final int intelligence;
   private final int luck;
 
-  // All constructors must be private.
-  private HeroStat(int strength, int intelligence, int luck) {
-    this.strength = strength;
-    this.intelligence = intelligence;
-    this.luck = luck;
-  }
-
   // Static factory method to create new instances.
   public static HeroStat valueOf(int strength, int intelligence, int luck) {
     return new HeroStat(strength, intelligence, luck);
   }
 
-  public int getStrength() {
-    return strength;
-  }
-
-  public int getIntelligence() {
-    return intelligence;
-  }
-
-  public int getLuck() {
-    return luck;
-  }
-
-  /*
-   * Recommended to provide a static factory method capable of creating an instance from the formal
-   * string representation declared like this. public static HeroStat parse(String string) {}
-   */
-
-  // toString, hashCode, equals
-
-  @Override
-  public String toString() {
-    return "HeroStat [strength=" + strength + ", intelligence=" + intelligence
-        + ", luck=" + luck + "]";
-  }
-
-  @Override
-  public int hashCode() {
-    final var prime = 31;
-    var result = 1;
-    result = prime * result + intelligence;
-    result = prime * result + luck;
-    result = prime * result + strength;
-    return result;
-  }
-
-  @Override
-  public boolean equals(Object obj) {
-    if (this == obj) {
-      return true;
-    }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
-      return false;
-    }
-    var other = (HeroStat) obj;
-    if (intelligence != other.intelligence) {
-      return false;
-    }
-    if (luck != other.luck) {
-      return false;
-    }
-    return strength == other.strength;
-  }
-
   // The clone() method should not be public. Just don't override it.
 
 }
diff --git a/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java b/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
index 27645673d..daf94064e 100644
--- a/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
+++ b/value-object/src/test/java/com/iluwatar/value/object/HeroStatTest.java
@@ -33,17 +33,17 @@ import org.junit.jupiter.api.Test;
 /**
  * Unit test for HeroStat.
  */
-public class HeroStatTest {
+class HeroStatTest {
 
   /**
    * Tester for equals() and hashCode() methods of a class. Using guava's EqualsTester.
    *
    * @see <a href="http://static.javadoc.io/com.google.guava/guava-testlib/19.0/com/google/common/testing/EqualsTester.html">
-   *     http://static.javadoc.io/com.google.guava/guava-testlib/19.0/com/google/common/testing/EqualsTester.html
-   *     </a>
+   * http://static.javadoc.io/com.google.guava/guava-testlib/19.0/com/google/common/testing/EqualsTester.html
+   * </a>
    */
   @Test
-  public void testEquals() {
+  void testEquals() {
     var heroStatA = HeroStat.valueOf(3, 9, 2);
     var heroStatB = HeroStat.valueOf(3, 9, 2);
     new EqualsTester().addEqualityGroup(heroStatA, heroStatB).testEquals();
@@ -54,7 +54,7 @@ public class HeroStatTest {
    * different.
    */
   @Test
-  public void testToString() {
+  void testToString() {
     var heroStatA = HeroStat.valueOf(3, 9, 2);
     var heroStatB = HeroStat.valueOf(3, 9, 2);
     var heroStatC = HeroStat.valueOf(3, 9, 8);
diff --git a/visitor/README.md b/visitor/README.md
index 75a032a47..c33b0c8e0 100644
--- a/visitor/README.md
+++ b/visitor/README.md
@@ -121,10 +121,9 @@ public class Soldier extends Unit {
 Here are then some concrete visitors.
 
 ```java
+@Slf4j
 public class CommanderVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CommanderVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     // Do nothing
@@ -141,10 +140,9 @@ public class CommanderVisitor implements UnitVisitor {
   }
 }
 
+@Slf4j
 public class SergeantVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SergeantVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     // Do nothing
@@ -161,10 +159,9 @@ public class SergeantVisitor implements UnitVisitor {
   }
 }
 
+@Slf4j
 public class SoldierVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SoldierVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     LOGGER.info("Greetings {}", soldier);
diff --git a/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
index 92d242106..cf91623bf 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/CommanderVisitor.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.visitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * CommanderVisitor.
  */
+@Slf4j
 public class CommanderVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(CommanderVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     // Do nothing
diff --git a/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
index 089c467a8..f4bf23d5a 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/SergeantVisitor.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.visitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SergeantVisitor.
  */
+@Slf4j
 public class SergeantVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SergeantVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     // Do nothing
diff --git a/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java b/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
index 0a0de0f7a..eb931e238 100644
--- a/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
+++ b/visitor/src/main/java/com/iluwatar/visitor/SoldierVisitor.java
@@ -23,16 +23,14 @@
 
 package com.iluwatar.visitor;
 
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * SoldierVisitor.
  */
+@Slf4j
 public class SoldierVisitor implements UnitVisitor {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SoldierVisitor.class);
-
   @Override
   public void visitSoldier(Soldier soldier) {
     LOGGER.info("Greetings {}", soldier);
diff --git a/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java b/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
index f41cce068..52689a027 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/UnitTest.java
@@ -55,7 +55,7 @@ public abstract class UnitTest<U extends Unit> {
   }
 
   @Test
-  public void testAccept() {
+  void testAccept() {
     final var children = new Unit[5];
     Arrays.setAll(children, (i) -> mock(Unit.class));
 
diff --git a/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java b/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
index 4e9f8d958..694be7ab2 100644
--- a/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
+++ b/visitor/src/test/java/com/iluwatar/visitor/VisitorTest.java
@@ -96,7 +96,7 @@ public abstract class VisitorTest<V extends UnitVisitor> {
   }
 
   @Test
-  public void testVisitCommander() {
+  void testVisitCommander() {
     this.visitor.visitCommander(new Commander());
     if (this.commanderResponse.isPresent()) {
       assertEquals(this.commanderResponse.get(), appender.getLastMessage());
@@ -105,7 +105,7 @@ public abstract class VisitorTest<V extends UnitVisitor> {
   }
 
   @Test
-  public void testVisitSergeant() {
+  void testVisitSergeant() {
     this.visitor.visitSergeant(new Sergeant());
     if (this.sergeantResponse.isPresent()) {
       assertEquals(this.sergeantResponse.get(), appender.getLastMessage());
@@ -114,7 +114,7 @@ public abstract class VisitorTest<V extends UnitVisitor> {
   }
 
   @Test
-  public void testVisitSoldier() {
+  void testVisitSoldier() {
     this.visitor.visitSoldier(new Soldier());
     if (this.soldierResponse.isPresent()) {
       assertEquals(this.soldierResponse.get(), appender.getLastMessage());
diff --git a/zh/adapter/README.md b/zh/adapter/README.md
index b00d757a6..e029404b5 100644
--- a/zh/adapter/README.md
+++ b/zh/adapter/README.md
@@ -41,8 +41,8 @@ public interface RowingBoat {
   void row();
 }
 
+@Slf4j
 public class FishingBoat {
-  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoat.class);
   public void sail() {
     LOGGER.info("The fishing boat is sailing");
   }
@@ -68,10 +68,9 @@ public class Captain {
 现在海盗来了，我们的船长需要逃跑但是只有一个渔船可用。我们需要创建一个可以让船长使用其划船技能来操作渔船的适配器。
 
 ```java
+@Slf4j
 public class FishingBoatAdapter implements RowingBoat {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(FishingBoatAdapter.class);
-
   private final FishingBoat boat;
 
   public FishingBoatAdapter() {
diff --git a/zh/chain/README.md b/zh/chain/README.md
index 00d9ef012..5a06d0ca8 100644
--- a/zh/chain/README.md
+++ b/zh/chain/README.md
@@ -61,8 +61,8 @@ public enum RequestType {
 然后是请求处理器的层次结构
 
 ```java
+@Slf4j
 public abstract class RequestHandler {
-  private static final Logger LOGGER = LoggerFactory.getLogger(RequestHandler.class);
   private final RequestHandler next;
 
   public RequestHandler(RequestHandler next) {
diff --git a/zh/decorator/README.md b/zh/decorator/README.md
index 6163017af..fc00f9b92 100644
--- a/zh/decorator/README.md
+++ b/zh/decorator/README.md
@@ -40,10 +40,9 @@ public interface Troll {
   void fleeBattle();
 }
 
+@Slf4j
 public class SimpleTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SimpleTroll.class);
-
   @Override
   public void attack() {
     LOGGER.info("The troll tries to grab you!");
@@ -64,10 +63,9 @@ public class SimpleTroll implements Troll {
 下面我们想为巨魔添加球棒。我们可以用装饰者来动态的实现。
 
 ```java
+@Slf4j
 public class ClubbedTroll implements Troll {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ClubbedTroll.class);
-
   private final Troll decorated;
 
   public ClubbedTroll(Troll decorated) {
diff --git a/zh/facade/README.md b/zh/facade/README.md
index 3784a5be6..2db44094b 100644
--- a/zh/facade/README.md
+++ b/zh/facade/README.md
@@ -31,10 +31,9 @@ tags:
 使用上面金矿的例子。这里我们有矮人的矿工等级制度。
 
 ```java
+@Slf4j
 public abstract class DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenMineWorker.class);
-
   public void goToSleep() {
     LOGGER.info("{} goes to sleep.", name());
   }
@@ -87,10 +86,9 @@ public abstract class DwarvenMineWorker {
   }
 }
 
+@Slf4j
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenTunnelDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} creates another promising tunnel.", name());
@@ -102,10 +100,9 @@ public class DwarvenTunnelDigger extends DwarvenMineWorker {
   }
 }
 
+@Slf4j
 public class DwarvenGoldDigger extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenGoldDigger.class);
-
   @Override
   public void work() {
     LOGGER.info("{} digs for gold.", name());
@@ -117,10 +114,9 @@ public class DwarvenGoldDigger extends DwarvenMineWorker {
   }
 }
 
+@Slf4j
 public class DwarvenCartOperator extends DwarvenMineWorker {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(DwarvenCartOperator.class);
-
   @Override
   public void work() {
     LOGGER.info("{} moves gold chunks out of the mine.", name());
diff --git a/zh/observer/README.md b/zh/observer/README.md
index 8a4b80a07..3cc89ade2 100644
--- a/zh/observer/README.md
+++ b/zh/observer/README.md
@@ -42,20 +42,18 @@ public interface WeatherObserver {
   void update(WeatherType currentWeather);
 }
 
+@Slf4j
 public class Orcs implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Orcs.class);
-
   @Override
   public void update(WeatherType currentWeather) {
     LOGGER.info("The orcs are facing " + currentWeather.getDescription() + " weather now");
   }
 }
 
+@Slf4j
 public class Hobbits implements WeatherObserver {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Hobbits.class);
-
   @Override
   public void update(WeatherType currentWeather) {
     switch (currentWeather) {
@@ -67,10 +65,9 @@ public class Hobbits implements WeatherObserver {
 然后这里是不断变化的天气。
 
 ```java
+@Slf4j
 public class Weather {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(Weather.class);
-
   private WeatherType currentWeather;
   private final List<WeatherObserver> observers;
 
diff --git a/zh/strategy/README.md b/zh/strategy/README.md
index 29fe2e4eb..920c82345 100644
--- a/zh/strategy/README.md
+++ b/zh/strategy/README.md
@@ -40,30 +40,27 @@ public interface DragonSlayingStrategy {
   void execute();
 }
 
+@Slf4j
 public class MeleeStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(MeleeStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("With your Excalibur you sever the dragon's head!");
   }
 }
 
+@Slf4j
 public class ProjectileStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(ProjectileStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You shoot the dragon with the magical crossbow and it falls dead on the ground!");
   }
 }
 
+@Slf4j
 public class SpellStrategy implements DragonSlayingStrategy {
 
-  private static final Logger LOGGER = LoggerFactory.getLogger(SpellStrategy.class);
-
   @Override
   public void execute() {
     LOGGER.info("You cast the spell of disintegration and the dragon vaporizes in a pile of dust!");

From cbf184742550841d6d908b8a90526c13a9459e65 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sat, 13 Mar 2021 14:31:37 +0200
Subject: [PATCH 238/254] docs: add va1m as a contributor (#1674)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 27bacb604..2a97b4ec1 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1413,6 +1413,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "va1m",
+      "name": "va1m",
+      "avatar_url": "https://avatars.githubusercontent.com/u/17025445?v=4",
+      "profile": "https://github.com/va1m",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index da4c65bda..2e8443f09 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-155-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-156-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -307,6 +307,7 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/byoungju94"><img src="https://avatars.githubusercontent.com/u/42516378?v=4?s=100" width="100px;" alt=""/><br /><sub><b>byoungju94</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=byoungju94" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/moustafafarhat"><img src="https://avatars.githubusercontent.com/u/38836727?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Moustafa Farhat</b></sub></a><br /><a href="#translation-moustafafarhat" title="Translation">🌍</a></td>
     <td align="center"><a href="https://github.com/richardmr36"><img src="https://avatars.githubusercontent.com/u/19147333?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Martel Richard</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=richardmr36" title="Code">💻</a></td>
+    <td align="center"><a href="https://github.com/va1m"><img src="https://avatars.githubusercontent.com/u/17025445?v=4?s=100" width="100px;" alt=""/><br /><sub><b>va1m</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=va1m" title="Code">💻</a></td>
   </tr>
 </table>
 

From c8a2ef01d3f2d57998d631cba71e8c5c5a9d4d62 Mon Sep 17 00:00:00 2001
From: Noam Greenshtain <31648669+noamgrinch@users.noreply.github.com>
Date: Sun, 14 Mar 2021 08:23:41 +0200
Subject: [PATCH 239/254] pattern: Active-Object pattern. (#1660)

* Closes #65.

* Removed

* Removed unnecessary files. Added logging. Closes Fixes #1660.

* Added Terminition condition.

* Logger implemented. Removed maven wrapper.

* Added module to parent POM. removed .gitignore

* Replaced tabs with whitespaces, added Javadocs.

* Fixed more whitespaces problems.

* Fixed more checkstyle errors

* More checkstyle errors.

* Checkstyle errors.

* Final checkstyle cleanup

* Added UML file. Changed System.exit() to Runtime.

* Changed buisiness logic and readme.md file

* Changed typos and readme.md file

* Fixed checkstyle errors

* Fixed grammer errors and CircleCI bugs.

* Wrong readme.md

* Added Thread.interrupt() for after catching exception.

* Fixed SonarCloud code smells.

* Removed unused brackets.

* Changed main program exit logic. Added tests.

* Reverted abstract-factory

* Cleaned code

* Added static to loggers. cleaned code smells.

* Checkstyle errors.

* Code Smells.

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 .../com/iluwatar/abstractfactory/AppTest.java |  16 +--
 active-object/README.md                       | 124 ++++++++++++++++++
 active-object/etc/active-object.urm.PNG       | Bin 0 -> 19466 bytes
 active-object/etc/active-object.urm.puml      |  25 ++++
 active-object/pom.xml                         |  65 +++++++++
 .../iluwatar/activeobject/ActiveCreature.java |  95 ++++++++++++++
 .../java/com/iluwatar/activeobject/App.java   |  75 +++++++++++
 .../java/com/iluwatar/activeobject/Orc.java   |  14 ++
 .../activeobject/ActiveCreatureTest.java      |  19 +++
 .../com/iluwatar/activeobject/AppTest.java    |  14 ++
 pom.xml                                       |   1 +
 11 files changed, 438 insertions(+), 10 deletions(-)
 create mode 100644 active-object/README.md
 create mode 100644 active-object/etc/active-object.urm.PNG
 create mode 100644 active-object/etc/active-object.urm.puml
 create mode 100644 active-object/pom.xml
 create mode 100644 active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
 create mode 100644 active-object/src/main/java/com/iluwatar/activeobject/App.java
 create mode 100644 active-object/src/main/java/com/iluwatar/activeobject/Orc.java
 create mode 100644 active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
 create mode 100644 active-object/src/test/java/com/iluwatar/activeobject/AppTest.java

diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 02e4e93f4..c5589895d 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -28,20 +28,16 @@ import org.junit.jupiter.api.Test;
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
 
 /**
- * Tests that Abstract Factory example runs without errors.
+ * Issue: Add at least one assertion to this test case.
+ *
+ * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
+ * throws an exception.
  */
 class AppTest {
-
-  /**
-   * Issue: Add at least one assertion to this test case.
-   *
-   * Solution: Inserted assertion to check whether the execution of the main method in {@link App}
-   * throws an exception.
-   */
-
+    
   @Test
   void shouldExecuteApplicationWithoutException() {
 
-    assertDoesNotThrow(() -> App.main(new String[]{}));
+	  assertDoesNotThrow(() -> App.main(new String[]{}));
   }
 }
diff --git a/active-object/README.md b/active-object/README.md
new file mode 100644
index 000000000..108caebe4
--- /dev/null
+++ b/active-object/README.md
@@ -0,0 +1,124 @@
+---
+layout: pattern
+title: Active Object
+folder: active-object
+permalink: /patterns/active-object/
+categories: Concurrency
+tags:
+ - Performance
+---
+
+
+## Intent
+The active object design pattern decouples method execution from method invocation for objects that each reside in their thread of control. The goal is to introduce concurrency, by using asynchronous method invocation and a scheduler for handling requests.
+
+## Explanation
+
+The class that implements the active object pattern will contain a self-synchronization mechanism without using 'synchronized' methods.
+
+Real-world example
+
+>The Orcs are known for their wildness and untameable soul. It seems like they have their own thread of control based on previous behavior.
+
+To implement a creature that has its own thread of control mechanism and expose its API only and not the execution itself, we can use the Active Object pattern.
+
+
+**Programmatic Example**
+
+```java
+public abstract class ActiveCreature{
+  private final Logger logger = LoggerFactory.getLogger(ActiveCreature.class.getName());
+
+  private BlockingQueue<Runnable> requests;
+  
+  private String name;
+  
+  private Thread thread;
+
+  public ActiveCreature(String name) {
+    this.name = name;
+    this.requests = new LinkedBlockingQueue<Runnable>();
+    thread = new Thread(new Runnable() {
+        @Override
+        public void run() {
+          while (true) {
+            try {
+              requests.take().run();
+            } catch (InterruptedException e) { 
+              logger.error(e.getMessage());
+            }
+          }
+        }
+      }
+    );
+    thread.start();
+  }
+  
+  public void eat() throws InterruptedException {
+    requests.put(new Runnable() {
+        @Override
+        public void run() { 
+          logger.info("{} is eating!",name());
+          logger.info("{} has finished eating!",name());
+        }
+      }
+    );
+  }
+
+  public void roam() throws InterruptedException {
+    requests.put(new Runnable() {
+        @Override
+        public void run() { 
+          logger.info("{} has started to roam and the wastelands.",name());
+        }
+      }
+    );
+  }
+  
+  public String name() {
+    return this.name;
+  }
+}
+
+```
+
+We can see that any class that will extend the ActiveCreature class will have its own thread of control to execute and invocate methods.
+
+For example, the Orc class:
+```java
+public class Orc extends ActiveCreature {
+
+  public Orc(String name) {
+    super(name);
+  }
+
+}
+```
+
+Now, we can create multiple creatures such as Orcs, tell them to eat and roam and they will execute it on their own thread of control:
+```java
+  public static void main(String[] args) {  
+    var app = new App();
+    app.run();
+  }
+  
+  @Override
+  public void run() {
+    ActiveCreature creature;
+    try {
+      for (int i = 0;i < creatures;i++) {
+        creature = new Orc(Orc.class.getSimpleName().toString() + i);
+        creature.eat();
+        creature.roam();
+      }
+      Thread.sleep(1000);
+    } catch (InterruptedException e) {
+      logger.error(e.getMessage());
+    }
+    Runtime.getRuntime().exit(1);
+  }
+```
+
+## Class diagram
+
+![alt text](./etc/active-object.urm.png "Active Object class diagram")
\ No newline at end of file
diff --git a/active-object/etc/active-object.urm.PNG b/active-object/etc/active-object.urm.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..c14f66144ee297261111c1c05529c5d00ebe393e
GIT binary patch
literal 19466
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

literal 0
HcmV?d00001

diff --git a/active-object/etc/active-object.urm.puml b/active-object/etc/active-object.urm.puml
new file mode 100644
index 000000000..3fc3c8e1e
--- /dev/null
+++ b/active-object/etc/active-object.urm.puml
@@ -0,0 +1,25 @@
+@startuml
+package com.iluwatar.activeobject {
+  abstract class ActiveCreature {
+    - logger : Logger
+    - name : String
+    - requests : BlockingQueue<Runnable>
+    - thread : Thread
+    + ActiveCreature(name : String)
+    + eat()
+    + name() : String
+    + roam()
+  }
+  class App {
+    - creatures : Integer
+    - logger : Logger
+    + App()
+    + main(args : String[]) {static}
+    + run()
+  }
+  class Orc {
+    + Orc(name : String)
+  }
+}
+Orc --|> ActiveCreature 
+@enduml
\ No newline at end of file
diff --git a/active-object/pom.xml b/active-object/pom.xml
new file mode 100644
index 000000000..3ea22d4e2
--- /dev/null
+++ b/active-object/pom.xml
@@ -0,0 +1,65 @@
+<?xml version="1.0"?>
+<!--
+
+    The MIT License
+    Copyright © 2014-2021 Ilkka Seppälä
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+-->
+<project
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
+	xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<groupId>com.iluwatar</groupId>
+		<artifactId>java-design-patterns</artifactId>
+		<version>1.24.0-SNAPSHOT</version>
+	</parent>
+	<artifactId>active-object</artifactId>
+	<dependencies>
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter-engine</artifactId>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+	<build>
+		<plugins>
+			<!-- Maven assembly plugin is invoked with default setting which we have 
+				in parent pom and specifying the class having main method -->
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-assembly-plugin</artifactId>
+				<executions>
+					<execution>
+						<configuration>
+							<archive>
+								<manifest>
+									<mainClass>com.iluwatar.activeobject.App</mainClass>
+								</manifest>
+							</archive>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>
diff --git a/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java b/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
new file mode 100644
index 000000000..993a26eec
--- /dev/null
+++ b/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
@@ -0,0 +1,95 @@
+package com.iluwatar.activeobject;
+
+import java.util.concurrent.BlockingQueue;
+import java.util.concurrent.LinkedBlockingQueue;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * ActiveCreature class is the base of the active object example.
+ * @author Noam Greenshtain
+ *
+ */
+public abstract class ActiveCreature {
+  
+  private static final Logger logger = LoggerFactory.getLogger(ActiveCreature.class.getName());
+
+  private BlockingQueue<Runnable> requests;
+  
+  private String name;
+  
+  private Thread thread; // Thread of execution.
+  
+  private int status; // status of the thread of execution.
+
+  /**
+   * Constructor and initialization.
+   */
+  protected ActiveCreature(String name) {
+    this.name = name;
+    this.status = 0;
+    this.requests = new LinkedBlockingQueue<>();
+    thread = new Thread(() -> {
+      boolean infinite = true;
+      while (infinite) {
+        try {
+          requests.take().run();
+        } catch (InterruptedException e) {
+          if (this.status != 0) {
+            logger.error("Thread was interrupted. --> {}", e.getMessage()); 
+          }
+          infinite = false;
+          Thread.currentThread().interrupt();
+        }
+      }
+    });
+    thread.start();
+  }
+
+  /**
+   * Eats the porridge.
+   * @throws InterruptedException due to firing a new Runnable.
+   */
+  public void eat() throws InterruptedException {
+    requests.put(() -> {
+      logger.info("{} is eating!",name());
+      logger.info("{} has finished eating!",name());
+    });
+  }
+
+  /**
+   * Roam in the wastelands.
+   * @throws InterruptedException due to firing a new Runnable.
+   */
+  public void roam() throws InterruptedException {
+    requests.put(() ->
+        logger.info("{} has started to roam in the wastelands.",name())
+    );
+  }
+  
+  /**
+   * Returns the name of the creature.
+   * @return the name of the creature.
+   */
+  public String name() {
+    return this.name;
+  }
+  
+  /**
+   * Kills the thread of execution.
+   * @param status of the thread of execution. 0 == OK, the rest is logging an error.
+   */
+  public void kill(int status) {
+    this.status = status;
+    this.thread.interrupt();
+  }
+  
+  /**
+   * Returns the status of the thread of execution.
+   * @return the status of the thread of execution.
+   */
+  public int getStatus() {
+    return this.status;
+  }
+}
diff --git a/active-object/src/main/java/com/iluwatar/activeobject/App.java b/active-object/src/main/java/com/iluwatar/activeobject/App.java
new file mode 100644
index 000000000..d36d1023d
--- /dev/null
+++ b/active-object/src/main/java/com/iluwatar/activeobject/App.java
@@ -0,0 +1,75 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.activeobject;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The Active Object pattern helps to solve synchronization difficulties without using 
+ * 'synchronized' methods. The active object will contain a thread-safe data structure 
+ * (such as BlockingQueue) and use to synchronize method calls by moving the logic of the method
+ * into an invocator(usually a Runnable) and store it in the DSA.
+ * 
+ * <p>In this example, we fire 20 threads to modify a value in the target class.
+ */
+public class App implements Runnable {
+  
+  private static final Logger logger = LoggerFactory.getLogger(App.class.getName());
+  
+  private static final int NUM_CREATURES = 3;
+
+  /**
+   * Program entry point.
+   *
+   * @param args command line arguments.
+   */
+  public static void main(String[] args) {  
+    var app = new App();
+    app.run();
+  }
+  
+  @Override
+  public void run() {
+    List<ActiveCreature> creatures = new ArrayList<>();
+    try {
+      for (int i = 0;i < NUM_CREATURES;i++) {
+        creatures.add(new Orc(Orc.class.getSimpleName() + i));
+        creatures.get(i).eat();
+        creatures.get(i).roam();
+      }
+      Thread.sleep(1000);
+    } catch (InterruptedException e) {
+      logger.error(e.getMessage());
+      Thread.currentThread().interrupt();
+    } finally {
+      for (int i = 0;i < NUM_CREATURES;i++) {
+        creatures.get(i).kill(0);
+      }
+    }
+  }
+}
diff --git a/active-object/src/main/java/com/iluwatar/activeobject/Orc.java b/active-object/src/main/java/com/iluwatar/activeobject/Orc.java
new file mode 100644
index 000000000..3aaa986a3
--- /dev/null
+++ b/active-object/src/main/java/com/iluwatar/activeobject/Orc.java
@@ -0,0 +1,14 @@
+package com.iluwatar.activeobject;
+
+/**
+ * An implementation of the ActiveCreature class.
+ * @author Noam Greenshtain
+ *
+ */
+public class Orc extends ActiveCreature {
+
+  public Orc(String name) {
+    super(name);
+  }
+
+}
diff --git a/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java b/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
new file mode 100644
index 000000000..1561b4e2f
--- /dev/null
+++ b/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
@@ -0,0 +1,19 @@
+package com.iluwatar.activeobject;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+import org.junit.jupiter.api.Test;
+class ActiveCreatureTest {
+	
+	@Test
+	void executionTest() throws InterruptedException {
+		ActiveCreature orc = new Orc("orc1");
+		assertEquals("orc1",orc.name());
+		assertEquals(0,orc.getStatus());
+		orc.eat();
+		orc.roam();
+		orc.kill(0);
+	}
+	
+
+}
diff --git a/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java b/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java
new file mode 100644
index 000000000..e868a4c71
--- /dev/null
+++ b/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java
@@ -0,0 +1,14 @@
+package com.iluwatar.activeobject;
+
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+
+import org.junit.jupiter.api.Test;
+
+
+class AppTest {
+
+	  @Test
+	  void shouldExecuteApplicationWithoutException() {
+	    assertDoesNotThrow(() -> App.main(new String[]{}));
+	  }
+}
diff --git a/pom.xml b/pom.xml
index 7e332a436..60dae1679 100644
--- a/pom.xml
+++ b/pom.xml
@@ -221,6 +221,7 @@
         <module>separated-interface</module>
         <module>special-case</module>
         <module>parameter-object</module>
+        <module>active-object</module>
     </modules>
 
     <repositories>

From ccf350b6110576624ab08247f683c87a50f3f2ff Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Sun, 14 Mar 2021 16:07:39 +0200
Subject: [PATCH 240/254] docs: add noamgrinch as a contributor (#1675)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 5 ++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 2a97b4ec1..3efbfa79b 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1422,6 +1422,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "noamgrinch",
+      "name": "Noam Greenshtain",
+      "avatar_url": "https://avatars.githubusercontent.com/u/31648669?v=4",
+      "profile": "https://github.com/noamgrinch",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 2e8443f09..56c6a2af4 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-156-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-157-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -309,6 +309,9 @@ This project is licensed under the terms of the MIT license.
     <td align="center"><a href="https://github.com/richardmr36"><img src="https://avatars.githubusercontent.com/u/19147333?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Martel Richard</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=richardmr36" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/va1m"><img src="https://avatars.githubusercontent.com/u/17025445?v=4?s=100" width="100px;" alt=""/><br /><sub><b>va1m</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=va1m" title="Code">💻</a></td>
   </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/noamgrinch"><img src="https://avatars.githubusercontent.com/u/31648669?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Noam Greenshtain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=noamgrinch" title="Code">💻</a></td>
+  </tr>
 </table>
 
 <!-- markdownlint-restore -->

From 74abc7a0d6a4e0c48038be6ac1c999eb717ec527 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 14 Mar 2021 19:38:53 +0530
Subject: [PATCH 241/254] added license headers to active object pattern
 (#1676)

---
 .../iluwatar/activeobject/ActiveCreature.java | 23 +++++++++++++++++++
 .../java/com/iluwatar/activeobject/Orc.java   | 23 +++++++++++++++++++
 .../activeobject/ActiveCreatureTest.java      | 23 +++++++++++++++++++
 .../com/iluwatar/activeobject/AppTest.java    | 23 +++++++++++++++++++
 4 files changed, 92 insertions(+)

diff --git a/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java b/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
index 993a26eec..479dc0643 100644
--- a/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
+++ b/active-object/src/main/java/com/iluwatar/activeobject/ActiveCreature.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.activeobject;
 
 import java.util.concurrent.BlockingQueue;
diff --git a/active-object/src/main/java/com/iluwatar/activeobject/Orc.java b/active-object/src/main/java/com/iluwatar/activeobject/Orc.java
index 3aaa986a3..2bce5b2b0 100644
--- a/active-object/src/main/java/com/iluwatar/activeobject/Orc.java
+++ b/active-object/src/main/java/com/iluwatar/activeobject/Orc.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.activeobject;
 
 /**
diff --git a/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java b/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
index 1561b4e2f..8a4296a1f 100644
--- a/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
+++ b/active-object/src/test/java/com/iluwatar/activeobject/ActiveCreatureTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.activeobject;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
diff --git a/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java b/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java
index e868a4c71..c7b223d67 100644
--- a/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java
+++ b/active-object/src/test/java/com/iluwatar/activeobject/AppTest.java
@@ -1,3 +1,26 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
 package com.iluwatar.activeobject;
 
 import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;

From 77ffae5eccf607c03e3849a3b01d6210b786cbca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= <ilkka.seppala@gofore.com>
Date: Sun, 14 Mar 2021 16:26:24 +0200
Subject: [PATCH 242/254] Format active object README.md to display correctly
 on the web site

---
 active-object/README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/active-object/README.md b/active-object/README.md
index 108caebe4..6e26a8595 100644
--- a/active-object/README.md
+++ b/active-object/README.md
@@ -79,12 +79,12 @@ public abstract class ActiveCreature{
     return this.name;
   }
 }
-
 ```
 
 We can see that any class that will extend the ActiveCreature class will have its own thread of control to execute and invocate methods.
 
 For example, the Orc class:
+
 ```java
 public class Orc extends ActiveCreature {
 
@@ -96,6 +96,7 @@ public class Orc extends ActiveCreature {
 ```
 
 Now, we can create multiple creatures such as Orcs, tell them to eat and roam and they will execute it on their own thread of control:
+
 ```java
   public static void main(String[] args) {  
     var app = new App();
@@ -121,4 +122,4 @@ Now, we can create multiple creatures such as Orcs, tell them to eat and roam an
 
 ## Class diagram
 
-![alt text](./etc/active-object.urm.png "Active Object class diagram")
\ No newline at end of file
+![alt text](./etc/active-object.urm.PNG "Active Object class diagram")

From e9106ccfc5aac333e880c6d55b062fd9f4eb8892 Mon Sep 17 00:00:00 2001
From: yonghong Xu <xuyonghong0822@gmail.com>
Date: Thu, 18 Mar 2021 13:19:45 +0800
Subject: [PATCH 243/254] fix spelling errors (#1679)

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 factory/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/factory/README.md b/factory/README.md
index 0037a9b51..180488828 100644
--- a/factory/README.md
+++ b/factory/README.md
@@ -105,7 +105,7 @@ Program output:
 
 ```java
 This is Ford.
-This Ferrari.
+This is Ferrari.
 ```
 
 ## Class Diagram

From 7e91322a433b39be73b33f52ccc85b59e07b9962 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Thu, 18 Mar 2021 07:37:34 +0200
Subject: [PATCH 244/254] Add explanation to Async Method Invocation pattern
 (#1680)

* #590 make the example more interesting and add an explanation

* #590 fix checkstyle

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 async-method-invocation/README.md             | 147 +++++++++++++++++-
 .../iluwatar/async/method/invocation/App.java |  29 ++--
 2 files changed, 159 insertions(+), 17 deletions(-)

diff --git a/async-method-invocation/README.md b/async-method-invocation/README.md
index 23910a631..0f56840af 100644
--- a/async-method-invocation/README.md
+++ b/async-method-invocation/README.md
@@ -9,21 +9,160 @@ tags:
 ---
 
 ## Intent
-Asynchronous method invocation is pattern where the calling thread
+
+Asynchronous method invocation is a pattern where the calling thread
 is not blocked while waiting results of tasks. The pattern provides parallel
 processing of multiple independent tasks and retrieving the results via
 callbacks or waiting until everything is done. 
 
+## Explanation
+
+Real world example
+
+> Launching space rockets is an exciting business. The mission command gives an order to launch and 
+> after some undetermined time, the rocket either launches successfully or fails miserably.
+
+In plain words
+
+> Asynchronous method invocation starts task processing and returns immediately before the task is 
+> ready. The results of the task processing are returned to the caller later.
+
+Wikipedia says
+
+> In multithreaded computer programming, asynchronous method invocation (AMI), also known as 
+> asynchronous method calls or the asynchronous pattern is a design pattern in which the call site 
+> is not blocked while waiting for the called code to finish. Instead, the calling thread is 
+> notified when the reply arrives. Polling for a reply is an undesired option.
+
+**Programmatic Example**
+
+In this example, we are launching space rockets and deploying lunar rovers.
+
+The application demonstrates the async method invocation pattern. The key parts of the pattern are 
+`AsyncResult` which is an intermediate container for an asynchronously evaluated value, 
+`AsyncCallback` which can be provided to be executed on task completion and `AsyncExecutor` that 
+manages the execution of the async tasks.
+
+```java
+public interface AsyncResult<T> {
+  boolean isCompleted();
+  T getValue() throws ExecutionException;
+  void await() throws InterruptedException;
+}
+```
+
+```java
+public interface AsyncCallback<T> {
+  void onComplete(T value, Optional<Exception> ex);
+}
+```
+
+```java
+public interface AsyncExecutor {
+  <T> AsyncResult<T> startProcess(Callable<T> task);
+  <T> AsyncResult<T> startProcess(Callable<T> task, AsyncCallback<T> callback);
+  <T> T endProcess(AsyncResult<T> asyncResult) throws ExecutionException, InterruptedException;
+}
+```
+
+`ThreadAsyncExecutor` is an implementation of `AsyncExecutor`. Some of its key parts are highlighted 
+next.
+
+```java
+public class ThreadAsyncExecutor implements AsyncExecutor {
+
+  @Override
+  public <T> AsyncResult<T> startProcess(Callable<T> task) {
+    return startProcess(task, null);
+  }
+
+  @Override
+  public <T> AsyncResult<T> startProcess(Callable<T> task, AsyncCallback<T> callback) {
+    var result = new CompletableResult<>(callback);
+    new Thread(
+            () -> {
+              try {
+                result.setValue(task.call());
+              } catch (Exception ex) {
+                result.setException(ex);
+              }
+            },
+            "executor-" + idx.incrementAndGet())
+        .start();
+    return result;
+  }
+
+  @Override
+  public <T> T endProcess(AsyncResult<T> asyncResult)
+      throws ExecutionException, InterruptedException {
+    if (!asyncResult.isCompleted()) {
+      asyncResult.await();
+    }
+    return asyncResult.getValue();
+  }
+}
+```
+
+Then we are ready to launch some rockets to see how everything works together.
+
+```java
+public static void main(String[] args) throws Exception {
+  // construct a new executor that will run async tasks
+  var executor = new ThreadAsyncExecutor();
+
+  // start few async tasks with varying processing times, two last with callback handlers
+  final var asyncResult1 = executor.startProcess(lazyval(10, 500));
+  final var asyncResult2 = executor.startProcess(lazyval("test", 300));
+  final var asyncResult3 = executor.startProcess(lazyval(50L, 700));
+  final var asyncResult4 = executor.startProcess(lazyval(20, 400), callback("Deploying lunar rover"));
+  final var asyncResult5 =
+      executor.startProcess(lazyval("callback", 600), callback("Deploying lunar rover"));
+
+  // emulate processing in the current thread while async tasks are running in their own threads
+  Thread.sleep(350); // Oh boy, we are working hard here
+  log("Mission command is sipping coffee");
+
+  // wait for completion of the tasks
+  final var result1 = executor.endProcess(asyncResult1);
+  final var result2 = executor.endProcess(asyncResult2);
+  final var result3 = executor.endProcess(asyncResult3);
+  asyncResult4.await();
+  asyncResult5.await();
+
+  // log the results of the tasks, callbacks log immediately when complete
+  log("Space rocket <" + result1 + "> launch complete");
+  log("Space rocket <" + result2 + "> launch complete");
+  log("Space rocket <" + result3 + "> launch complete");
+}
+```
+
+Here's the program console output.
+
+```java
+21:47:08.227 [executor-2] INFO com.iluwatar.async.method.invocation.App - Space rocket <test> launched successfully
+21:47:08.269 [main] INFO com.iluwatar.async.method.invocation.App - Mission command is sipping coffee
+21:47:08.318 [executor-4] INFO com.iluwatar.async.method.invocation.App - Space rocket <20> launched successfully
+21:47:08.335 [executor-4] INFO com.iluwatar.async.method.invocation.App - Deploying lunar rover <20>
+21:47:08.414 [executor-1] INFO com.iluwatar.async.method.invocation.App - Space rocket <10> launched successfully
+21:47:08.519 [executor-5] INFO com.iluwatar.async.method.invocation.App - Space rocket <callback> launched successfully
+21:47:08.519 [executor-5] INFO com.iluwatar.async.method.invocation.App - Deploying lunar rover <callback>
+21:47:08.616 [executor-3] INFO com.iluwatar.async.method.invocation.App - Space rocket <50> launched successfully
+21:47:08.617 [main] INFO com.iluwatar.async.method.invocation.App - Space rocket <10> launch complete
+21:47:08.617 [main] INFO com.iluwatar.async.method.invocation.App - Space rocket <test> launch complete
+21:47:08.618 [main] INFO com.iluwatar.async.method.invocation.App - Space rocket <50> launch complete
+```
+
 # Class diagram
+
 ![alt text](./etc/async-method-invocation.png "Async Method Invocation")
 
 ## Applicability
-Use async method invocation pattern when
+
+Use the async method invocation pattern when
 
 * You have multiple independent tasks that can run in parallel
 * You need to improve the performance of a group of sequential tasks
-* You have limited amount of processing capacity or long running tasks and the
-  caller should not wait the tasks to be ready
+* You have a limited amount of processing capacity or long-running tasks and the caller should not wait for the tasks to be ready
 
 ## Real world examples
 
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
index 04902a94c..b7d5e386b 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
@@ -27,10 +27,12 @@ import java.util.concurrent.Callable;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- * This application demonstrates the async method invocation pattern. Key parts of the pattern are
- * <code>AsyncResult</code> which is an intermediate container for an asynchronously evaluated
- * value, <code>AsyncCallback</code> which can be provided to be executed on task completion and
- * <code>AsyncExecutor</code> that manages the execution of the async tasks.
+ * In this example, we are launching space rockets and deploying lunar rovers.
+ *
+ * <p>The application demonstrates the async method invocation pattern. The key parts of the
+ * pattern are <code>AsyncResult</code> which is an intermediate container for an asynchronously
+ * evaluated value, <code>AsyncCallback</code> which can be provided to be executed on task
+ * completion and <code>AsyncExecutor</code> that manages the execution of the async tasks.
  *
  * <p>The main method shows example flow of async invocations. The main thread starts multiple
  * tasks with variable durations and then continues its own work. When the main thread has done it's
@@ -68,13 +70,14 @@ public class App {
     final var asyncResult1 = executor.startProcess(lazyval(10, 500));
     final var asyncResult2 = executor.startProcess(lazyval("test", 300));
     final var asyncResult3 = executor.startProcess(lazyval(50L, 700));
-    final var asyncResult4 = executor.startProcess(lazyval(20, 400), callback("Callback result 4"));
+    final var asyncResult4 = executor.startProcess(lazyval(20, 400),
+        callback("Deploying lunar rover"));
     final var asyncResult5 =
-        executor.startProcess(lazyval("callback", 600), callback("Callback result 5"));
+        executor.startProcess(lazyval("callback", 600), callback("Deploying lunar rover"));
 
     // emulate processing in the current thread while async tasks are running in their own threads
-    Thread.sleep(350); // Oh boy I'm working hard here
-    log("Some hard work done");
+    Thread.sleep(350); // Oh boy, we are working hard here
+    log("Mission command is sipping coffee");
 
     // wait for completion of the tasks
     final var result1 = executor.endProcess(asyncResult1);
@@ -84,9 +87,9 @@ public class App {
     asyncResult5.await();
 
     // log the results of the tasks, callbacks log immediately when complete
-    log("Result 1: " + result1);
-    log("Result 2: " + result2);
-    log("Result 3: " + result3);
+    log("Space rocket <" + result1 + "> launch complete");
+    log("Space rocket <" + result2 + "> launch complete");
+    log("Space rocket <" + result3 + "> launch complete");
   }
 
   /**
@@ -99,7 +102,7 @@ public class App {
   private static <T> Callable<T> lazyval(T value, long delayMillis) {
     return () -> {
       Thread.sleep(delayMillis);
-      log("Task completed with: " + value);
+      log("Space rocket <" + value + "> launched successfully");
       return value;
     };
   }
@@ -115,7 +118,7 @@ public class App {
       if (ex.isPresent()) {
         log(name + " failed: " + ex.map(Exception::getMessage).orElse(""));
       } else {
-        log(name + ": " + value);
+        log(name + " <" + value + ">");
       }
     };
   }

From 8fc64a2d38a1baf15652f2133a7d5586febab643 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Thu, 18 Mar 2021 22:13:28 +0200
Subject: [PATCH 245/254] docs: add qfxl as a contributor (#1681)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
---
 .all-contributorsrc | 9 +++++++++
 README.md           | 3 ++-
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 3efbfa79b..9cd167463 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1431,6 +1431,15 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "qfxl",
+      "name": "yonghong Xu",
+      "avatar_url": "https://avatars.githubusercontent.com/u/14086462?v=4",
+      "profile": "https://xuyonghong.cn/",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index 56c6a2af4..d315ed8ac 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-157-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-158-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -311,6 +311,7 @@ This project is licensed under the terms of the MIT license.
   </tr>
   <tr>
     <td align="center"><a href="https://github.com/noamgrinch"><img src="https://avatars.githubusercontent.com/u/31648669?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Noam Greenshtain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=noamgrinch" title="Code">💻</a></td>
+    <td align="center"><a href="https://xuyonghong.cn/"><img src="https://avatars.githubusercontent.com/u/14086462?v=4?s=100" width="100px;" alt=""/><br /><sub><b>yonghong Xu</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qfxl" title="Documentation">📖</a></td>
   </tr>
 </table>
 

From b5ed8b227857f0b446157d43fa98814630922444 Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Fri, 19 Mar 2021 01:52:37 +0530
Subject: [PATCH 246/254] labeling PR should trigger builds again for
 all-contributors bot (#1682)

---
 .github/workflows/maven-pr-builder.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index f529920ca..7166604ae 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -29,7 +29,7 @@ name: Java PR Builder
 on:
   pull_request:
     branches: [ master ]
-    types: [ opened, reopened, synchronize ]
+    types: [ opened, reopened, synchronize, labeled, unlabeled ]
 
 jobs:
   build:

From 2b7d181ac433f9af08ba5ddfe58c8d9712c58ae0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Sat, 20 Mar 2021 21:55:47 +0200
Subject: [PATCH 247/254] docs: add explanation for balking pattern (#1685)

* #590 explanation for balking pattern

* #590 fix checkstyle error

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 balking/README.md                             | 126 +++++++++++++++++-
 .../main/java/com/iluwatar/balking/App.java   |  15 ++-
 2 files changed, 127 insertions(+), 14 deletions(-)

diff --git a/balking/README.md b/balking/README.md
index 22257ac7b..9d3550ad5 100644
--- a/balking/README.md
+++ b/balking/README.md
@@ -9,19 +9,131 @@ tags:
 ---
 
 ## Intent
-Balking Pattern is used to prevent an object from executing certain code if it is an
-incomplete or inappropriate state
+
+Balking Pattern is used to prevent an object from executing a certain code if it is in an incomplete 
+or inappropriate state.
+
+## Explanation
+
+Real world example
+
+> There's a start-button in a washing machine to initiate the laundry washing. When the washing 
+> machine is inactive the button works as expected, but if it's already washing the button does
+> nothing.
+
+In plain words
+
+> Using the balking pattern, a certain code executes only if the object is in particular state.
+
+Wikipedia says
+
+> The balking pattern is a software design pattern that only executes an action on an object when 
+> the object is in a particular state. For example, if an object reads ZIP files and a calling 
+> method invokes a get method on the object when the ZIP file is not open, the object would "balk" 
+> at the request.
+
+**Programmatic Example**
+
+In this example implementation, `WashingMachine` is an object that has two states in which it can 
+be: ENABLED and WASHING. If the machine is ENABLED, the state changes to WASHING using a thread-safe
+method. On the other hand, if it already has been washing and any other thread executes `wash()` 
+it won't do that and returns without doing anything.
+
+Here are the relevant parts of the `WashingMachine` class.
+
+```java
+@Slf4j
+public class WashingMachine {
+
+  private final DelayProvider delayProvider;
+  private WashingMachineState washingMachineState;
+
+  public WashingMachine(DelayProvider delayProvider) {
+    this.delayProvider = delayProvider;
+    this.washingMachineState = WashingMachineState.ENABLED;
+  }
+
+  public WashingMachineState getWashingMachineState() {
+    return washingMachineState;
+  }
+
+  public void wash() {
+    synchronized (this) {
+      var machineState = getWashingMachineState();
+      LOGGER.info("{}: Actual machine state: {}", Thread.currentThread().getName(), machineState);
+      if (this.washingMachineState == WashingMachineState.WASHING) {
+        LOGGER.error("Cannot wash if the machine has been already washing!");
+        return;
+      }
+      this.washingMachineState = WashingMachineState.WASHING;
+    }
+    LOGGER.info("{}: Doing the washing", Thread.currentThread().getName());
+    this.delayProvider.executeAfterDelay(50, TimeUnit.MILLISECONDS, this::endOfWashing);
+  }
+
+  public synchronized void endOfWashing() {
+    washingMachineState = WashingMachineState.ENABLED;
+    LOGGER.info("{}: Washing completed.", Thread.currentThread().getId());
+  }
+}
+```
+
+Here's the simple `DelayProvider` interface used by the `WashingMachine`.
+
+```java
+public interface DelayProvider {
+  void executeAfterDelay(long interval, TimeUnit timeUnit, Runnable task);
+}
+```
+
+Now we introduce the application using the `WashingMachine`.
+
+```java
+  public static void main(String... args) {
+    final var washingMachine = new WashingMachine();
+    var executorService = Executors.newFixedThreadPool(3);
+    for (int i = 0; i < 3; i++) {
+      executorService.execute(washingMachine::wash);
+    }
+    executorService.shutdown();
+    try {
+      executorService.awaitTermination(10, TimeUnit.SECONDS);
+    } catch (InterruptedException ie) {
+      LOGGER.error("ERROR: Waiting on executor service shutdown!");
+      Thread.currentThread().interrupt();
+    }
+  }
+```
+
+Here is the console output of the program.
+
+```
+14:02:52.268 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Actual machine state: ENABLED
+14:02:52.272 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-2: Doing the washing
+14:02:52.272 [pool-1-thread-3] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-3: Actual machine state: WASHING
+14:02:52.273 [pool-1-thread-3] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!
+14:02:52.273 [pool-1-thread-1] INFO com.iluwatar.balking.WashingMachine - pool-1-thread-1: Actual machine state: WASHING
+14:02:52.273 [pool-1-thread-1] ERROR com.iluwatar.balking.WashingMachine - Cannot wash if the machine has been already washing!
+14:02:52.324 [pool-1-thread-2] INFO com.iluwatar.balking.WashingMachine - 14: Washing completed.
+```
 
 ## Class diagram
+
 ![alt text](./etc/balking.png "Balking")
 
 ## Applicability
+
 Use the Balking pattern when
 
-* you want to invoke an action on an object only when it is in a particular state
-* objects are generally only in a state that is prone to balking temporarily
-but for an unknown amount of time
+* You want to invoke an action on an object only when it is in a particular state
+* Objects are generally only in a state that is prone to balking temporarily but for an unknown 
+  amount of time
 
 ## Related patterns
-* Guarded Suspension Pattern
-* Double Checked Locking Pattern
+
+* [Guarded Suspension Pattern](https://java-design-patterns.com/patterns/guarded-suspension/)
+* [Double Checked Locking Pattern](https://java-design-patterns.com/patterns/double-checked-locking/)
+
+## Credits
+
+* [Patterns in Java: A Catalog of Reusable Design Patterns Illustrated with UML, 2nd Edition, Volume 1](https://www.amazon.com/gp/product/0471227293/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0471227293&linkId=0e39a59ffaab93fb476036fecb637b99)
diff --git a/balking/src/main/java/com/iluwatar/balking/App.java b/balking/src/main/java/com/iluwatar/balking/App.java
index 68b5eb44a..644a344f4 100644
--- a/balking/src/main/java/com/iluwatar/balking/App.java
+++ b/balking/src/main/java/com/iluwatar/balking/App.java
@@ -32,11 +32,11 @@ import lombok.extern.slf4j.Slf4j;
  * then the method will return without doing anything. Objects that use this pattern are generally
  * only in a state that is prone to balking temporarily but for an unknown amount of time
  *
- * <p>In this example implementation WashingMachine is an object that has two states in which it
- * can be: ENABLED and WASHING. If the machine is ENABLED the state is changed into WASHING that any
- * other thread can't invoke this action on this and then do the job. On the other hand if it have
- * been already washing and any other thread execute wash() it can't do that once again and returns
- * doing nothing.
+ * <p>In this example implementation, {@link WashingMachine} is an object that has two states in
+ * which it can be: ENABLED and WASHING. If the machine is ENABLED, the state changes to WASHING
+ * using a thread-safe method. On the other hand, if it already has been washing and any other
+ * thread executes {@link WashingMachine#wash()} it won't do that and returns without doing
+ * anything.
  */
 @Slf4j
 public class App {
@@ -54,11 +54,12 @@ public class App {
     }
     executorService.shutdown();
     try {
-      executorService.awaitTermination(10, TimeUnit.SECONDS);
+      if (!executorService.awaitTermination(10, TimeUnit.SECONDS)) {
+        executorService.shutdownNow();
+      }
     } catch (InterruptedException ie) {
       LOGGER.error("ERROR: Waiting on executor service shutdown!");
       Thread.currentThread().interrupt();
     }
   }
-
 }

From 794795acf5ed09485a072ee12104c4e7972de19c Mon Sep 17 00:00:00 2001
From: jinishavora <40777762+jinishavora@users.noreply.github.com>
Date: Mon, 22 Mar 2021 02:13:34 -0400
Subject: [PATCH 248/254] task: MVVM design pattern using zkoss framework.
 (#1678)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* MVVM design pattern using zkoss framework.

* MVVM Design pattern updates for issues reported by SonarCloud.

* MVVM Design pattern updates for coverage issues reported by SonarCloud.

* MVVM Design pattern updates for coverage issues (removing lombok @Data)
reported by SonarCloud.

* MVVM Design pattern updates for coverage issues reported by Sonar - TEST
cases added for Equals and ToString

* MVVM Design Pattern - updating missing/todo details.

* MVVM Design Pattern - adding lombok.config

* MVVM Design Pattern - Removing xml, updating pom.xml and README as per
suggested changes in code review

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* Update model-view-viewmodel/README.md

* MVVM Design Pattern - Updated pom.xml and Readme based on Suggested
changes

* added type as xml

* MVVM Design Patterm - root pom.xml and module pom.xml updated

* Update pom.xml

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
Co-authored-by: Ilkka Seppälä <iluwatar@users.noreply.github.com>
---
 model-view-viewmodel/README.md                | 145 ++++++++++++++++++
 .../etc/model-view-viewmodel.png              | Bin 0 -> 40539 bytes
 .../etc/model-view-viewmodel.urm.puml         |  43 ++++++
 model-view-viewmodel/lombok.config            |   2 +
 model-view-viewmodel/pom.xml                  | 115 ++++++++++++++
 .../src/main/assembly/webapp.xml              |  25 +++
 .../iluwatar/model/view/viewmodel/Book.java   |  37 +++++
 .../model/view/viewmodel/BookService.java     |  10 ++
 .../model/view/viewmodel/BookServiceImpl.java |  38 +++++
 .../model/view/viewmodel/BookViewModel.java   |  43 ++++++
 .../src/main/webapp/META-INF/MANIFEST.MF      |   8 +
 .../src/main/webapp/WEB-INF/web.xml           | 114 ++++++++++++++
 .../src/main/webapp/index.zul                 |  34 ++++
 .../model/view/viewmodel/BookTest.java        | 108 +++++++++++++
 pom.xml                                       |  10 +-
 15 files changed, 730 insertions(+), 2 deletions(-)
 create mode 100644 model-view-viewmodel/README.md
 create mode 100644 model-view-viewmodel/etc/model-view-viewmodel.png
 create mode 100644 model-view-viewmodel/etc/model-view-viewmodel.urm.puml
 create mode 100644 model-view-viewmodel/lombok.config
 create mode 100644 model-view-viewmodel/pom.xml
 create mode 100644 model-view-viewmodel/src/main/assembly/webapp.xml
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
 create mode 100644 model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
 create mode 100644 model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
 create mode 100644 model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
 create mode 100644 model-view-viewmodel/src/main/webapp/index.zul
 create mode 100644 model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java

diff --git a/model-view-viewmodel/README.md b/model-view-viewmodel/README.md
new file mode 100644
index 000000000..6df1ea5d7
--- /dev/null
+++ b/model-view-viewmodel/README.md
@@ -0,0 +1,145 @@
+---
+layout: pattern
+title: Model-View-ViewModel
+folder: model-view-viewmodel
+permalink: /patterns/model-view-viewmodel/
+categories: Architectural
+tags:
+ - Decoupling
+---
+
+## Also known as
+
+Model–View–Binder
+
+## Intent
+
+To apply "[Separation of Concerns](https://java-design-patterns.com/principles/#separation-of-concerns)" to separate the logic from the UI components and allow developers to work on UI without affecting the logic and vice versa.
+
+## Explanation
+
+Wikipedia says
+
+> Model–view–viewmodel (MVVM) is a software architectural pattern that facilitates the separation of the development of the graphical user interface (the view) – be it via a markup language or GUI code – from the development of the business logic or back-end logic (the model) so that the view is not dependent on any specific model platform. 
+
+**Programmatic Example**
+
+Zkoss implementation:
+
+> ViewModel will hold the business logic and expose the data from model to View
+
+```java
+public class BookViewModel {
+  @WireVariable
+  private List<Book> bookList;
+  private Book selectedBook;
+  private BookService bookService = new BookServiceImpl();
+  
+  public Book getSelectedBook() {
+    return selectedBook;
+  }
+
+  @NotifyChange("selectedBook")
+  public void setSelectedBook(Book selectedBook) {
+    this.selectedBook = selectedBook;
+  }
+
+  public List<Book> getBookList() {
+    return bookService.load();
+  }
+  
+  /** Deleting a book.
+   */
+  @Command
+  @NotifyChange({"selectedBook","bookList"})
+  public void deleteBook() {
+    if (selectedBook != null) {
+      getBookList().remove(selectedBook);
+      selectedBook = null;
+    }
+}
+```
+
+> View will have no logic, only UI elements
+
+```xml
+<zk>
+<window title="List of Books" border="normal" width="600px" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init('com.iluwatar.model.view.viewmodel.BookViewModel')">
+    <vbox hflex="true">
+        <listbox model="@bind(vm.bookList)" selectedItem="@bind(vm.selectedBook)" height="400px" mold="paging">
+            <listhead>
+                <listheader label="Book Name"/>
+                <listheader label="Author"/>               
+            </listhead>
+            <template name="model" var="book">
+                <listitem >
+                    <listcell label="@bind(book.name)"/>
+                    <listcell label="@bind(book.author)"/>
+                </listitem>
+            </template>
+        </listbox>
+    </vbox>
+    <toolbar>
+        <button label="Delete" onClick="@command('deleteBook')" disabled="@load(empty vm.selectedBook)" />
+    </toolbar>
+    <hbox style="margin-top:20px" visible="@bind(not empty vm.selectedBook)">
+		<vbox>
+			<hlayout>
+				Book Name : <label value="@bind(vm.selectedBook.name)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Author : <label value="@bind(vm.selectedBook.author)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Description : <label value="@bind(vm.selectedBook.description)" style="font-weight:bold"/>
+			</hlayout>
+		</vbox>
+	</hbox>
+</window>
+</zk>
+```
+
+Note: 
+* To deploy this, go to model-view-viewmodel folder and run: 
+* mvn clean install
+* mvn jetty:run -Djetty.http.port=9911
+* In browser, http://localhost:9911/model-view-viewmodel/
+
+## Class diagram
+
+![alt text](./etc/model-view-viewmodel.png "MVVM pattern class diagram")
+
+## Applicability
+
+* When looking for clean architecture, with better reusability, testability and maintainability.
+
+## Tutorials
+
+* [Zkoss Demo](https://www.zkoss.org/zkdemo/getting_started/mvvm)
+* [Learn MVVM](https://www.learnmvvm.com/)
+* [Android Developer CodeLabs](https://codelabs.developers.google.com/codelabs/android-databinding)
+
+## Typical Use Case
+
+* Android apps
+* .NET framework applications
+* JavaScript applications
+
+## Real world examples
+
+* ZK Framework [zkoss.org](https://www.zkoss.org/)
+* KnockoutJS [knockoutjs.com](https://knockoutjs.com/)
+
+## Consequences
+
+* John Gossman has criticized the MVVM pattern and its application in specific uses, stating that MVVM can be "overkill" when creating simple user interfaces. For larger applications, he believes that generalizing the viewmodel upfront can be difficult, and that large-scale data binding can lead to lower performance - Ref: [MVVM-Wiki](https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel)
+
+* Can be hard to design ViewModel for larger applications.
+* For complex databinding, debugging can be difficult.
+
+## Credits
+
+* [ZK MVVM](https://www.zkoss.org/wiki/ZK%20Developer's%20Reference/MVVM)
+* [GeeksforGeeks  MVVM Intro](https://www.geeksforgeeks.org/introduction-to-model-view-view-model-mvvm/)
+* [ZK MVVM Book](http://books.zkoss.org/zk-mvvm-book/9.5/)
+* [Microsoft MVVM](https://docs.microsoft.com/en-us/archive/msdn-magazine/2009/february/patterns-wpf-apps-with-the-model-view-viewmodel-design-pattern)
diff --git a/model-view-viewmodel/etc/model-view-viewmodel.png b/model-view-viewmodel/etc/model-view-viewmodel.png
new file mode 100644
index 0000000000000000000000000000000000000000..a775ec49fe5e7be79c931a9cb5845fe2737a6771
GIT binary patch
literal 40539
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
B2zdYi

literal 0
HcmV?d00001

diff --git a/model-view-viewmodel/etc/model-view-viewmodel.urm.puml b/model-view-viewmodel/etc/model-view-viewmodel.urm.puml
new file mode 100644
index 000000000..8cd7cb4b8
--- /dev/null
+++ b/model-view-viewmodel/etc/model-view-viewmodel.urm.puml
@@ -0,0 +1,43 @@
+@startuml
+package com.iluwatar.model.view.viewmodel {
+  class Book {
+    - author : String
+    - description : String
+    - name : String
+    + Book(name : String, author : String, description : String)
+    # canEqual(other : Object) : boolean
+    + equals(o : Object) : boolean
+    + getAuthor() : String
+    + getDescription() : String
+    + getName() : String
+    + hashCode() : int
+    + setAuthor(author : String)
+    + setDescription(description : String)
+    + setName(name : String)
+    + toString() : String
+  }
+  interface BookService {
+    + load() : List<Book> {abstract}
+  }
+  class BookServiceImpl {
+    - designPatternBooks : List<Book>
+    + BookServiceImpl()
+    + load() : List<Book>
+  }
+  class BookViewModel {
+    - bookList : List<Book>
+    - bookService : BookService
+    - selectedBook : Book
+    + BookViewModel()
+    + deleteBook()
+    + getBookList() : List<Book>
+    + getSelectedBook() : Book
+    + setSelectedBook(selectedBook : Book)
+  }
+}
+BookViewModel -->  "-bookService" BookService
+BookServiceImpl -->  "-designPatternBooks" Book
+BookViewModel -->  "-bookList" Book
+BookViewModel -->  "-selectedBook" Book
+BookServiceImpl ..|> BookService 
+@enduml
\ No newline at end of file
diff --git a/model-view-viewmodel/lombok.config b/model-view-viewmodel/lombok.config
new file mode 100644
index 000000000..a23edb413
--- /dev/null
+++ b/model-view-viewmodel/lombok.config
@@ -0,0 +1,2 @@
+config.stopBubbling = true
+lombok.addLombokGeneratedAnnotation = true
\ No newline at end of file
diff --git a/model-view-viewmodel/pom.xml b/model-view-viewmodel/pom.xml
new file mode 100644
index 000000000..971ae59f7
--- /dev/null
+++ b/model-view-viewmodel/pom.xml
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+	<parent>
+		<artifactId>java-design-patterns</artifactId>
+		<groupId>com.iluwatar</groupId>
+		<version>1.24.0-SNAPSHOT</version>
+	</parent>
+	<groupId>com.iluwatar</groupId>
+	<artifactId>model-view-viewmodel</artifactId>
+	<version>1.24.0-SNAPSHOT</version>
+	<properties>
+		<zk.version>9.0.0</zk.version>
+		<guava.version>19.0</guava.version>
+		<jetty-maven-plugin.version>9.4.28.v20200408</jetty-maven-plugin.version>
+		<maven-war-plugin.version>2.1.1</maven-war-plugin.version>
+		<maven-assembly-plugin.version>2.2</maven-assembly-plugin.version>
+		<maven.build.timestamp.format>yyyy-MM-dd</maven.build.timestamp.format>
+		<packname>-${project.version}-FL-${maven.build.timestamp}</packname>
+	</properties>
+	<packaging>war</packaging>
+	<name>model-view-viewmodel</name>
+	<description>model-view-viewmodel</description>
+	<licenses>
+		<license>
+			<name>GNU LESSER GENERAL PUBLIC LICENSE, Version 3</name>
+			<url>https://www.gnu.org/licenses/lgpl.html</url>
+			<distribution>repo</distribution>
+		</license>
+	</licenses>
+	<repositories>
+		<repository>
+			<id>ZK CE</id>
+			<name>ZK CE Repository</name>
+			<url>https://mavensync.zkoss.org/maven2</url>
+		</repository>
+		<repository>
+			<id>ZK EVAL</id>
+			<name>ZK Evaluation Repository</name>
+			<url>https://mavensync.zkoss.org/eval</url>
+		</repository>
+	</repositories>
+	<pluginRepositories>
+		<pluginRepository>
+			<id>zkmaven</id>
+			<name>ZK Maven Plugin Repository</name>
+			<url>https://mavensync.zkoss.org/maven2/</url>
+		</pluginRepository>
+	</pluginRepositories>
+	<dependencies>
+		<dependency>
+			<groupId>org.zkoss.zk</groupId>
+			<artifactId>zkbind</artifactId>
+			<version>${zk.version}</version>
+		</dependency>
+		<dependency>
+			<groupId>org.junit.jupiter</groupId>
+			<artifactId>junit-jupiter-engine</artifactId>
+			<scope>test</scope>
+		</dependency>
+		<dependency>
+			<groupId>com.google.guava</groupId>
+			<artifactId>guava-testlib</artifactId>
+			<version>${guava.version}</version>
+			<scope>test</scope>
+		</dependency>
+	</dependencies>
+	<build>
+		<finalName>${project.artifactId}</finalName>
+		<plugins>
+			<!-- Run with Jetty -->
+			<plugin>
+				<groupId>org.eclipse.jetty</groupId>
+				<artifactId>jetty-maven-plugin</artifactId>
+				<version>${jetty-maven-plugin.version}</version>
+				<configuration>
+					<webApp>
+						<contextPath>/${project.artifactId}</contextPath>
+						<allowDuplicateFragmentNames>true</allowDuplicateFragmentNames>
+					</webApp>
+					<scanIntervalSeconds>5</scanIntervalSeconds>
+				</configuration>
+			</plugin>
+			<!-- Build war -->
+			<plugin>
+				<artifactId>maven-war-plugin</artifactId>
+				<groupId>org.apache.maven.plugins</groupId>
+				<version>${maven-war-plugin.version}</version>
+			</plugin>
+			<!-- Pack zips -->
+			<plugin>
+				<artifactId>maven-assembly-plugin</artifactId>
+				<version>${maven-assembly-plugin.version}</version>
+				<executions>
+					<execution>
+						<id>webapp</id>
+						<phase>package</phase>
+						<goals>
+							<goal>single</goal>
+						</goals>
+						<configuration>
+							<finalName>model-view-viewmodel${packname}</finalName>
+							<appendAssemblyId>false</appendAssemblyId>
+							<descriptors>
+								<descriptor>src/main/assembly/webapp.xml</descriptor>
+							</descriptors>
+						</configuration>
+					</execution>
+				</executions>
+			</plugin>
+		</plugins>
+	</build>
+</project>
diff --git a/model-view-viewmodel/src/main/assembly/webapp.xml b/model-view-viewmodel/src/main/assembly/webapp.xml
new file mode 100644
index 000000000..153904efc
--- /dev/null
+++ b/model-view-viewmodel/src/main/assembly/webapp.xml
@@ -0,0 +1,25 @@
+<assembly
+	xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
+	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+	xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0 http://maven.apache.org/xsd/assembly-1.1.0.xsd">
+	<id>webapp</id>
+	<formats>
+		<format>zip</format>
+	</formats>
+	<fileSets>
+		<fileSet>
+			<directory>${project.basedir}/src/main/java</directory>
+			<outputDirectory>/${project.artifactId}/src</outputDirectory>
+		</fileSet>
+		<fileSet>
+			<directory>${project.basedir}/src/main/webapp</directory>
+			<outputDirectory>/${project.artifactId}/WebContent</outputDirectory>
+		</fileSet>
+	</fileSets>
+	<files>
+		<file>
+			<source>${project.build.directory}/${project.artifactId}.war</source>
+			<outputDirectory>/</outputDirectory>
+		</file>
+	</files>
+</assembly>
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
new file mode 100644
index 000000000..b2a924152
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/Book.java
@@ -0,0 +1,37 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.model.view.viewmodel;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@AllArgsConstructor
+@Data
+public class Book {
+
+  private String name;
+  private String author;
+  private String description;
+
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
new file mode 100644
index 000000000..f01066960
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookService.java
@@ -0,0 +1,10 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.List;
+
+public interface BookService {
+  /* List all books
+   * @return all books
+   */
+  public List<Book> load();
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
new file mode 100644
index 000000000..e9b440843
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookServiceImpl.java
@@ -0,0 +1,38 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class BookServiceImpl implements BookService {
+  private List<Book> designPatternBooks = new ArrayList<>();
+
+  /** Initializes Book Data.
+  * To be used and passed along in load method
+  * In this case, list design pattern books are initialized to be loaded.
+  */
+  public BookServiceImpl() {
+    designPatternBooks.add(new Book(
+        "Head First Design Patterns: A Brain-Friendly Guide",
+        "Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+        "Head First Design Patterns Description"));
+    designPatternBooks.add(new Book(
+        "Design Patterns: Elements of Reusable Object-Oriented Software",
+        "Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides",
+        "Design Patterns Description"));
+    designPatternBooks.add(new Book(
+        "Patterns of Enterprise Application Architecture", "Martin Fowler",
+        "Patterns of Enterprise Application Architecture Description"));
+    designPatternBooks.add(new Book(
+        "Design Patterns Explained", "Alan Shalloway, James Trott",
+        "Design Patterns Explained Description"));
+    designPatternBooks.add(new Book(
+        "Applying UML and Patterns: An Introduction to "
+         + "Object-Oriented Analysis and Design and Iterative Development",
+        "Craig Larman", "Applying UML and Patterns Description"));
+  }
+
+  public List<Book> load() {
+    return designPatternBooks;
+  }
+
+}
diff --git a/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
new file mode 100644
index 000000000..6563df723
--- /dev/null
+++ b/model-view-viewmodel/src/main/java/com/iluwatar/model/view/viewmodel/BookViewModel.java
@@ -0,0 +1,43 @@
+package com.iluwatar.model.view.viewmodel;
+
+import java.util.List;
+
+import org.zkoss.bind.annotation.Command;
+import org.zkoss.bind.annotation.NotifyChange;
+import org.zkoss.zk.ui.select.annotation.WireVariable;
+
+public class BookViewModel {
+  
+  @WireVariable
+  private List<Book> bookList;
+  private Book selectedBook;
+  private BookService bookService = new BookServiceImpl();
+  
+  public Book getSelectedBook() {
+    return selectedBook;
+  }
+
+  @NotifyChange("selectedBook")
+  public void setSelectedBook(Book selectedBook) {
+    this.selectedBook = selectedBook;
+  }
+
+  public List<Book> getBookList() {
+    return bookService.load();
+  }
+  
+  /** Deleting a book.
+   * When event is triggered on click of Delete button, 
+   * this method will be notified with the selected entry that will be referenced
+   * and used to delete the selected book from the list of books. 
+   */
+  @Command
+  @NotifyChange({"selectedBook","bookList"})
+  public void deleteBook() {
+    if (selectedBook != null) {
+      getBookList().remove(selectedBook);
+      selectedBook = null;
+    }
+  }
+
+}
diff --git a/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF b/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
new file mode 100644
index 000000000..4e0a32ad6
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/META-INF/MANIFEST.MF
@@ -0,0 +1,8 @@
+Manifest-Version: 1.0
+Specification-Title: ZK Application
+Specification-Version: 1.0
+Specification-Vendor: 
+Implementation-Title: 
+Implementation-URL: http://your-website/
+Implementation-Version: 1.0
+Implementation-Vendor: 
diff --git a/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml b/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
new file mode 100644
index 000000000..24af77bbb
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/WEB-INF/web.xml
@@ -0,0 +1,114 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> 
+
+	<description><![CDATA[My ZK Application]]></description>
+	<display-name>model-view-viewmodel</display-name>
+
+	<!-- ZK -->
+	<listener>
+		<description>ZK listener for session cleanup</description>
+		<listener-class>org.zkoss.zk.ui.http.HttpSessionListener</listener-class>
+	</listener>
+	<servlet>
+		<description>ZK loader for ZUML pages</description>
+		<servlet-name>zkLoader</servlet-name>
+		<servlet-class>org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class>
+
+		<!-- Must. Specifies URI of the update engine (DHtmlUpdateServlet).
+		It must be the same as <url-pattern> for the update engine.
+		-->
+		<init-param>
+			<param-name>update-uri</param-name>
+			<param-value>/zkau</param-value>
+		</init-param>
+		<load-on-startup>1</load-on-startup><!-- Must -->
+	</servlet>
+	<servlet-mapping>
+		<servlet-name>zkLoader</servlet-name>
+		<url-pattern>*.zul</url-pattern>
+	</servlet-mapping>
+	<servlet-mapping>
+		<servlet-name>zkLoader</servlet-name>
+		<url-pattern>*.zhtml</url-pattern>
+	</servlet-mapping>
+	<servlet>
+		<description>The asynchronous update engine for ZK</description>
+		<servlet-name>auEngine</servlet-name>
+		<servlet-class>org.zkoss.zk.au.http.DHtmlUpdateServlet</servlet-class>
+	</servlet>
+	<servlet-mapping>
+		<servlet-name>auEngine</servlet-name>
+		<url-pattern>/zkau/*</url-pattern>
+	</servlet-mapping>
+	<session-config>
+		<session-timeout>60</session-timeout>
+	</session-config>
+
+	<!-- [Optional] MIME mapping -->
+	<mime-mapping>
+		<extension>doc</extension>
+		<mime-type>application/vnd.ms-word</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>gif</extension>
+		<mime-type>image/gif</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>htm</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>html</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>jpeg</extension>
+		<mime-type>image/jpeg</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>jpg</extension>
+		<mime-type>image/jpeg</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>js</extension>
+		<mime-type>text/javascript</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>pdf</extension>
+		<mime-type>application/pdf</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>png</extension>
+		<mime-type>image/png</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>txt</extension>
+		<mime-type>text/plain</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>xls</extension>
+		<mime-type>application/vnd.ms-excel</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>xml</extension>
+		<mime-type>text/xml</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>zhtml</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+	<mime-mapping>
+		<extension>zul</extension>
+		<mime-type>text/html</mime-type>
+	</mime-mapping>
+
+	<welcome-file-list>
+		<welcome-file>index.zul</welcome-file>
+		<welcome-file>index.zhtml</welcome-file>
+		<welcome-file>index.html</welcome-file>
+		<welcome-file>index.htm</welcome-file>
+	</welcome-file-list>
+</web-app>
diff --git a/model-view-viewmodel/src/main/webapp/index.zul b/model-view-viewmodel/src/main/webapp/index.zul
new file mode 100644
index 000000000..9cdab7144
--- /dev/null
+++ b/model-view-viewmodel/src/main/webapp/index.zul
@@ -0,0 +1,34 @@
+<zk>
+<window title="List of Books" border="normal" width="600px" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init('com.iluwatar.model.view.viewmodel.BookViewModel')">
+    <vbox hflex="true">
+        <listbox model="@bind(vm.bookList)" selectedItem="@bind(vm.selectedBook)" height="400px" mold="paging">
+            <listhead>
+                <listheader label="Book Name"/>
+                <listheader label="Author"/>               
+            </listhead>
+            <template name="model" var="book">
+                <listitem >
+                    <listcell label="@bind(book.name)"/>
+                    <listcell label="@bind(book.author)"/>
+                </listitem>
+            </template>
+        </listbox>
+    </vbox>
+    <toolbar>
+        <button label="Delete" onClick="@command('deleteBook')" disabled="@load(empty vm.selectedBook)" />
+    </toolbar>
+    <hbox style="margin-top:20px" visible="@bind(not empty vm.selectedBook)">
+		<vbox>
+			<hlayout>
+				Book Name : <label value="@bind(vm.selectedBook.name)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Author : <label value="@bind(vm.selectedBook.author)" style="font-weight:bold"/>
+			</hlayout>
+			<hlayout>
+				Book Description : <label value="@bind(vm.selectedBook.description)" style="font-weight:bold"/>
+			</hlayout>
+		</vbox>
+	</hbox>
+</window>
+</zk>
\ No newline at end of file
diff --git a/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java b/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java
new file mode 100644
index 000000000..40a4d89d0
--- /dev/null
+++ b/model-view-viewmodel/src/test/java/com/iluwatar/model/view/viewmodel/BookTest.java
@@ -0,0 +1,108 @@
+/*
+ * The MIT License
+ * Copyright © 2014-2021 Ilkka Seppälä
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+package com.iluwatar.model.view.viewmodel;
+
+import static org.hamcrest.CoreMatchers.is;
+import static org.hamcrest.CoreMatchers.not;
+import static org.junit.Assert.assertThat;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import java.util.List;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import com.google.common.testing.EqualsTester;
+
+class BookTest {
+
+  BookViewModel bvm;
+  Book testBook;
+  List<Book> testBookList;
+  Book testBookTwo;
+  Book testBookThree;
+  
+  @BeforeEach
+  void setUp() {
+    bvm = new BookViewModel();
+    testBook = new Book("Head First Design Patterns: A Brain-Friendly Guide",
+    		"Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+    		"Head First Design Patterns Description");
+    testBookList = bvm.getBookList();
+    testBookTwo = new Book("Head First Design Patterns: A Brain-Friendly Guide",
+	  		"Eric Freeman, Bert Bates, Kathy Sierra, Elisabeth Robson",
+	  		"Head First Design Patterns Description");
+    testBookThree = new Book("Design Patterns: Elements of Reusable Object-Oriented Software",
+            "Erich Gamma, Richard Helm, Ralph Johnson, and John Vlissides",
+            "Design Patterns Description");
+  }
+
+  @Test
+  void testBookModel() {
+	assertNotNull(testBook);
+  }
+  
+  @Test
+  void testEquals() {
+    new EqualsTester().addEqualityGroup(testBook, testBookTwo).testEquals();
+  }
+
+  @Test
+  void testToString() {
+    assertThat(testBook.toString(), is(testBookTwo.toString()));
+    assertThat(testBook.toString(), is(not(testBookThree.toString())));
+  }
+  
+  @Test
+  void testHashCode() {
+    assertTrue(testBook.equals(testBookTwo) && testBookTwo.equals(testBook));
+    assertEquals(testBook.hashCode(), testBookTwo.hashCode());
+  }
+  
+  @Test
+  void testLoadData() {
+    assertNotNull(testBookList);
+    assertTrue(testBookList.get(0).toString().contains("Head First Design Patterns"));
+  }
+
+  @Test
+  void testSelectedData() {
+	bvm.setSelectedBook(testBook);
+    assertNotNull(bvm.getSelectedBook());
+    assertEquals(testBook.toString(), bvm.getSelectedBook().toString());
+    assertTrue(true, bvm.getSelectedBook().toString());
+  }
+
+  @Test
+  void testDeleteData() {
+    bvm.setSelectedBook(testBook);
+    assertNotNull(bvm.getSelectedBook());
+    assertTrue(testBookList.get(0).toString().contains("Head First Design Patterns"));
+    bvm.deleteBook();
+    assertNull(bvm.getSelectedBook());
+    assertFalse(testBookList.get(0).toString().contains("Head First Design Patterns"));
+  }
+
+}
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 60dae1679..12a448464 100644
--- a/pom.xml
+++ b/pom.xml
@@ -75,6 +75,7 @@
         <directory-maven-plugin.version>0.3.1</directory-maven-plugin.version>
         <license-maven-plugin.version>3.0</license-maven-plugin.version>
         <urm-maven-plugin.version>1.4.8</urm-maven-plugin.version>
+	<commons-io.version>2.6</commons-io.version>
 
         <!-- SonarCloud -->
         <sonar.host.url>https://sonarcloud.io</sonar.host.url>
@@ -222,6 +223,7 @@
         <module>special-case</module>
         <module>parameter-object</module>
         <module>active-object</module>
+        <module>model-view-viewmodel</module>
     </modules>
 
     <repositories>
@@ -369,9 +371,13 @@
                 <version>${system-lambda.version}</version>
                 <scope>test</scope>
             </dependency>
-        </dependencies>
+		    <dependency>
+			    <groupId>commons-io</groupId>
+			    <artifactId>commons-io</artifactId>
+			    <version>${commons-io.version}</version>
+		        </dependency>
+            </dependencies>
     </dependencyManagement>
-
     <dependencies>
         <dependency>
             <groupId>org.slf4j</groupId>

From 7ac468db20bb69492b91d741a2cfc1755c2b2841 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Mon, 22 Mar 2021 08:34:56 +0200
Subject: [PATCH 249/254] docs: #590 refactor and add explanation for business
 delegate (#1686)

Type: docs and refactoring

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 business-delegate/README.md                   | 143 +++++++++++++++++-
 business-delegate/etc/business-delegate.png   | Bin 24283 -> 0 bytes
 business-delegate/etc/business-delegate.ucls  | 136 -----------------
 .../etc/business-delegate.urm.png             | Bin 0 -> 50060 bytes
 .../etc/business-delegate.urm.puml            |  61 +++-----
 .../com/iluwatar/business/delegate/App.java   |  22 ++-
 .../business/delegate/BusinessDelegate.java   |  18 +--
 .../business/delegate/BusinessLookup.java     |  17 ++-
 .../{Client.java => MobileClient.java}        |  10 +-
 .../{EjbService.java => NetflixService.java}  |   6 +-
 .../business/delegate/ServiceType.java        |  33 ----
 ...ervice.java => VideoStreamingService.java} |   4 +-
 .../{JmsService.java => YouTubeService.java}  |   6 +-
 .../delegate/BusinessDelegateTest.java        |  47 +++---
 14 files changed, 220 insertions(+), 283 deletions(-)
 delete mode 100644 business-delegate/etc/business-delegate.png
 delete mode 100644 business-delegate/etc/business-delegate.ucls
 create mode 100644 business-delegate/etc/business-delegate.urm.png
 rename business-delegate/src/main/java/com/iluwatar/business/delegate/{Client.java => MobileClient.java} (84%)
 rename business-delegate/src/main/java/com/iluwatar/business/delegate/{EjbService.java => NetflixService.java} (89%)
 delete mode 100644 business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
 rename business-delegate/src/main/java/com/iluwatar/business/delegate/{BusinessService.java => VideoStreamingService.java} (92%)
 rename business-delegate/src/main/java/com/iluwatar/business/delegate/{JmsService.java => YouTubeService.java} (89%)

diff --git a/business-delegate/README.md b/business-delegate/README.md
index b00c67819..886781632 100644
--- a/business-delegate/README.md
+++ b/business-delegate/README.md
@@ -9,21 +9,156 @@ tags:
 ---
 
 ## Intent
+
 The Business Delegate pattern adds an abstraction layer between
 presentation and business tiers. By using the pattern we gain loose coupling
 between the tiers and encapsulate knowledge about how to locate, connect to,
 and interact with the business objects that make up the application.
 
+## Explanation
+
+Real world example
+
+> A mobile phone application promises to stream any movie in existence to your phone. It captures
+> the user's search string and passes this on to the business delegate. The business delegate
+> selects the most suitable video streaming service and plays the video from there.
+
+In Plain Words
+
+> Business delegate adds an abstraction layer between the presentation and business tiers.
+
+Wikipedia says
+
+> Business delegate is a Java EE design pattern. This pattern is directing to reduce the coupling 
+> in between business services and the connected presentation tier, and to hide the implementation 
+> details of services (including lookup and accessibility of EJB architecture). Business delegates 
+> acts as an adaptor to invoke business objects from the presentation tier.
+
+**Programmatic Example**
+
+First, we have an abstraction for video streaming services and a couple of implementations.
+
+```java
+public interface VideoStreamingService {
+  void doProcessing();
+}
+
+@Slf4j
+public class NetflixService implements VideoStreamingService {
+  @Override
+  public void doProcessing() {
+    LOGGER.info("NetflixService is now processing");
+  }
+}
+
+@Slf4j
+public class YouTubeService implements VideoStreamingService {
+  @Override
+  public void doProcessing() {
+    LOGGER.info("YouTubeService is now processing");
+  }
+}
+```
+
+Then we have a lookup service that decides which video streaming service is used.
+
+```java
+@Setter
+public class BusinessLookup {
+
+  private NetflixService netflixService;
+  private YouTubeService youTubeService;
+
+  public VideoStreamingService getBusinessService(String movie) {
+    if (movie.toLowerCase(Locale.ROOT).contains("die hard")) {
+      return netflixService;
+    } else {
+      return youTubeService;
+    }
+  }
+}
+```
+
+The business delegate uses a business lookup to route movie playback requests to a suitable
+video streaming service.
+
+```java
+@Setter
+public class BusinessDelegate {
+
+  private BusinessLookup lookupService;
+
+  public void playbackMovie(String movie) {
+    VideoStreamingService videoStreamingService = lookupService.getBusinessService(movie);
+    videoStreamingService.doProcessing();
+  }
+}
+```
+
+The mobile client utilizes business delegate to call the business tier.
+
+```java
+public class MobileClient {
+
+  private final BusinessDelegate businessDelegate;
+
+  public MobileClient(BusinessDelegate businessDelegate) {
+    this.businessDelegate = businessDelegate;
+  }
+
+  public void playbackMovie(String movie) {
+    businessDelegate.playbackMovie(movie);
+  }
+}
+```
+
+Finally, we can show the full example in action.
+
+```java
+  public static void main(String[] args) {
+
+    // prepare the objects
+    var businessDelegate = new BusinessDelegate();
+    var businessLookup = new BusinessLookup();
+    businessLookup.setNetflixService(new NetflixService());
+    businessLookup.setYouTubeService(new YouTubeService());
+    businessDelegate.setLookupService(businessLookup);
+
+    // create the client and use the business delegate
+    var client = new MobileClient(businessDelegate);
+    client.playbackMovie("Die Hard 2");
+    client.playbackMovie("Maradona: The Greatest Ever");
+  }
+```
+
+Here is the console output.
+
+```
+21:15:33.790 [main] INFO com.iluwatar.business.delegate.NetflixService - NetflixService is now processing
+21:15:33.794 [main] INFO com.iluwatar.business.delegate.YouTubeService - YouTubeService is now processing
+```
+
 ## Class diagram
-![alt text](./etc/business-delegate.png "Business Delegate")
+
+![alt text](./etc/business-delegate.urm.png "Business Delegate")
+
+## Related patterns
+
+* [Service locator pattern](https://java-design-patterns.com/patterns/service-locator/)
 
 ## Applicability
+
 Use the Business Delegate pattern when
 
-* you want loose coupling between presentation and business tiers
-* you want to orchestrate calls to multiple business services
-* you want to encapsulate service lookups and service calls
+* You want loose coupling between presentation and business tiers
+* You want to orchestrate calls to multiple business services
+* You want to encapsulate service lookups and service calls
+
+## Tutorials
+
+* [Business Delegate Pattern at TutorialsPoint](https://www.tutorialspoint.com/design_pattern/business_delegate_pattern.htm)
 
 ## Credits
 
 * [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=48d37c67fb3d845b802fa9b619ad8f31)
+* [Core J2EE Patterns: Best Practices and Design Strategies](https://www.amazon.com/gp/product/0130648841/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=0130648841&linkId=a0100de2b28c71ede8db1757fb2b5947)
diff --git a/business-delegate/etc/business-delegate.png b/business-delegate/etc/business-delegate.png
deleted file mode 100644
index 928cf934645b8447540ddfb344c04220105b3db3..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 24283
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

diff --git a/business-delegate/etc/business-delegate.ucls b/business-delegate/etc/business-delegate.ucls
deleted file mode 100644
index 668a6579e..000000000
--- a/business-delegate/etc/business-delegate.ucls
+++ /dev/null
@@ -1,136 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.1.8" icons="true" automaticImage="PNG" always-add-relationships="false" generalizations="true" 
-  realizations="true" associations="true" dependencies="false" nesting-relationships="true">  
-  <class id="1" language="java" name="com.iluwatar.business.delegate.BusinessDelegate" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="272" y="219"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.business.delegate.Client" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="272" y="64"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <enumeration id="3" language="java" name="com.iluwatar.business.delegate.ServiceType" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="89" y="383"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </enumeration>  
-  <interface id="4" language="java" name="com.iluwatar.business.delegate.BusinessService" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="630" y="365"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </interface>  
-  <class id="5" language="java" name="com.iluwatar.business.delegate.JmsService" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="489" y="210"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="6" language="java" name="com.iluwatar.business.delegate.BusinessLookup" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="360" y="399"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="7" language="java" name="com.iluwatar.business.delegate.EjbService" project="business-delegate" 
-    file="/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java" binary="false" 
-    corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="668" y="210"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <realization id="8">    
-    <end type="SOURCE" refId="7"/>    
-    <end type="TARGET" refId="4"/>  
-  </realization>  
-  <association id="9">    
-    <end type="SOURCE" refId="1" navigable="false">      
-      <attribute id="10" name="lookupService">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </attribute>      
-      <multiplicity id="11" minimum="0" maximum="1">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="6" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <association id="12">    
-    <end type="SOURCE" refId="1" navigable="false">      
-      <attribute id="13" name="serviceType">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </attribute>      
-      <multiplicity id="14" minimum="0" maximum="1">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="3" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <realization id="15">    
-    <end type="SOURCE" refId="5"/>    
-    <end type="TARGET" refId="4"/>  
-  </realization>  
-  <association id="16">    
-    <end type="SOURCE" refId="2" navigable="false">      
-      <attribute id="17" name="businessDelegate">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </attribute>      
-      <multiplicity id="18" minimum="0" maximum="1">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="1" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <association id="19">    
-    <end type="SOURCE" refId="1" navigable="false">      
-      <attribute id="20" name="businessService">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </attribute>      
-      <multiplicity id="21" minimum="0" maximum="1">        
-        <position height="0" width="0" x="0" y="0"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="4" navigable="true"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/business-delegate/etc/business-delegate.urm.png b/business-delegate/etc/business-delegate.urm.png
new file mode 100644
index 0000000000000000000000000000000000000000..4dca6c263b99ddc3898218250c4da67fc6d71314
GIT binary patch
literal 50060
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
Y%N4F4Gn;|10UDZ&q=G~`Qpfdw0UUnbEC2ui

literal 0
HcmV?d00001

diff --git a/business-delegate/etc/business-delegate.urm.puml b/business-delegate/etc/business-delegate.urm.puml
index 40aa2d6f0..407e3e12d 100644
--- a/business-delegate/etc/business-delegate.urm.puml
+++ b/business-delegate/etc/business-delegate.urm.puml
@@ -5,53 +5,42 @@ package com.iluwatar.business.delegate {
     + main(args : String[]) {static}
   }
   class BusinessDelegate {
-    - businessService : BusinessService
     - lookupService : BusinessLookup
-    - serviceType : ServiceType
     + BusinessDelegate()
-    + doTask()
-    + setLookupService(businessLookup : BusinessLookup)
-    + setServiceType(serviceType : ServiceType)
+    + playbackMovie(movie : String)
+    + setLookupService(lookupService : BusinessLookup)
   }
   class BusinessLookup {
-    - ejbService : EjbService
-    - jmsService : JmsService
+    - netflixService : NetflixService
+    - youTubeService : YouTubeService
     + BusinessLookup()
-    + getBusinessService(serviceType : ServiceType) : BusinessService
-    + setEjbService(ejbService : EjbService)
-    + setJmsService(jmsService : JmsService)
+    + getBusinessService(movie : String) : VideoStreamingService
+    + setNetflixService(netflixService : NetflixService)
+    + setYouTubeService(youTubeService : YouTubeService)
   }
-  interface BusinessService {
+  class MobileClient {
+    - businessDelegate : BusinessDelegate
+    + MobileClient(businessDelegate : BusinessDelegate)
+    + playbackMovie(movie : String)
+  }
+  class NetflixService {
+    - LOGGER : Logger {static}
+    + NetflixService()
+    + doProcessing()
+  }
+  interface VideoStreamingService {
     + doProcessing() {abstract}
   }
-  class Client {
-    - businessDelegate : BusinessDelegate
-    + Client(businessDelegate : BusinessDelegate)
-    + doTask()
-  }
-  class EjbService {
+  class YouTubeService {
     - LOGGER : Logger {static}
-    + EjbService()
+    + YouTubeService()
     + doProcessing()
   }
-  class JmsService {
-    - LOGGER : Logger {static}
-    + JmsService()
-    + doProcessing()
-  }
-  enum ServiceType {
-    + EJB {static}
-    + JMS {static}
-    + valueOf(name : String) : ServiceType {static}
-    + values() : ServiceType[] {static}
-  }
 }
-BusinessLookup -->  "-ejbService" EjbService
-BusinessDelegate -->  "-serviceType" ServiceType
-Client -->  "-businessDelegate" BusinessDelegate
-BusinessDelegate -->  "-businessService" BusinessService
+BusinessLookup -->  "-netflixService" NetflixService
+BusinessLookup -->  "-youTubeService" YouTubeService
+MobileClient -->  "-businessDelegate" BusinessDelegate
 BusinessDelegate -->  "-lookupService" BusinessLookup
-BusinessLookup -->  "-jmsService" JmsService
-EjbService ..|> BusinessService 
-JmsService ..|> BusinessService 
+NetflixService ..|> VideoStreamingService 
+YouTubeService ..|> VideoStreamingService 
 @enduml
\ No newline at end of file
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
index 8bd4d12c6..e87ca9c64 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
@@ -33,9 +33,9 @@ package com.iluwatar.business.delegate;
  * retrieved through service lookups. The Business Delegate itself may contain business logic too
  * potentially tying together multiple service calls, exception handling, retrying etc.
  *
- * <p>In this example the client ({@link Client}) utilizes a business delegate (
- * {@link BusinessDelegate}) to execute a task. The Business Delegate then selects the appropriate
- * service and makes the service call.
+ * <p>In this example the client ({@link MobileClient}) utilizes a business delegate (
+ * {@link BusinessDelegate}) to search for movies in video streaming services. The Business Delegate
+ * then selects the appropriate service and makes the service call.
  */
 public class App {
 
@@ -46,18 +46,16 @@ public class App {
    */
   public static void main(String[] args) {
 
+    // prepare the objects
     var businessDelegate = new BusinessDelegate();
     var businessLookup = new BusinessLookup();
-    businessLookup.setEjbService(new EjbService());
-    businessLookup.setJmsService(new JmsService());
-
+    businessLookup.setNetflixService(new NetflixService());
+    businessLookup.setYouTubeService(new YouTubeService());
     businessDelegate.setLookupService(businessLookup);
-    businessDelegate.setServiceType(ServiceType.EJB);
 
-    var client = new Client(businessDelegate);
-    client.doTask();
-
-    businessDelegate.setServiceType(ServiceType.JMS);
-    client.doTask();
+    // create the client and use the business delegate
+    var client = new MobileClient(businessDelegate);
+    client.playbackMovie("Die Hard 2");
+    client.playbackMovie("Maradona: The Greatest Ever");
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
index d1255bf5f..6246145e7 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
@@ -23,24 +23,18 @@
 
 package com.iluwatar.business.delegate;
 
+import lombok.Setter;
+
 /**
  * BusinessDelegate separates the presentation and business tiers.
  */
+@Setter
 public class BusinessDelegate {
 
   private BusinessLookup lookupService;
-  private ServiceType serviceType;
 
-  public void setLookupService(BusinessLookup businessLookup) {
-    this.lookupService = businessLookup;
-  }
-
-  public void setServiceType(ServiceType serviceType) {
-    this.serviceType = serviceType;
-  }
-
-  public void doTask() {
-    BusinessService businessService = lookupService.getBusinessService(serviceType);
-    businessService.doProcessing();
+  public void playbackMovie(String movie) {
+    VideoStreamingService videoStreamingService = lookupService.getBusinessService(movie);
+    videoStreamingService.doProcessing();
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
index 07ad6342e..0369c04e8 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
@@ -23,6 +23,7 @@
 
 package com.iluwatar.business.delegate;
 
+import java.util.Locale;
 import lombok.Setter;
 
 /**
@@ -31,21 +32,21 @@ import lombok.Setter;
 @Setter
 public class BusinessLookup {
 
-  private EjbService ejbService;
+  private NetflixService netflixService;
 
-  private JmsService jmsService;
+  private YouTubeService youTubeService;
 
   /**
-   * Gets service instance based on service type.
+   * Gets service instance based on given movie search string.
    *
-   * @param serviceType Type of service instance to be returned.
+   * @param movie Search string for the movie.
    * @return Service instance.
    */
-  public BusinessService getBusinessService(ServiceType serviceType) {
-    if (serviceType.equals(ServiceType.EJB)) {
-      return ejbService;
+  public VideoStreamingService getBusinessService(String movie) {
+    if (movie.toLowerCase(Locale.ROOT).contains("die hard")) {
+      return netflixService;
     } else {
-      return jmsService;
+      return youTubeService;
     }
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/MobileClient.java
similarity index 84%
rename from business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
rename to business-delegate/src/main/java/com/iluwatar/business/delegate/MobileClient.java
index 4d5c151e3..2cfb6f344 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/MobileClient.java
@@ -24,17 +24,17 @@
 package com.iluwatar.business.delegate;
 
 /**
- * Client utilizes BusinessDelegate to call the business tier.
+ * MobileClient utilizes BusinessDelegate to call the business tier.
  */
-public class Client {
+public class MobileClient {
 
   private final BusinessDelegate businessDelegate;
 
-  public Client(BusinessDelegate businessDelegate) {
+  public MobileClient(BusinessDelegate businessDelegate) {
     this.businessDelegate = businessDelegate;
   }
 
-  public void doTask() {
-    businessDelegate.doTask();
+  public void playbackMovie(String movie) {
+    businessDelegate.playbackMovie(movie);
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/NetflixService.java
similarity index 89%
rename from business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
rename to business-delegate/src/main/java/com/iluwatar/business/delegate/NetflixService.java
index 6813dfec1..ae9da8747 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/NetflixService.java
@@ -26,13 +26,13 @@ package com.iluwatar.business.delegate;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- * Service EJB implementation.
+ * NetflixService implementation.
  */
 @Slf4j
-public class EjbService implements BusinessService {
+public class NetflixService implements VideoStreamingService {
 
   @Override
   public void doProcessing() {
-    LOGGER.info("EjbService is now processing");
+    LOGGER.info("NetflixService is now processing");
   }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
deleted file mode 100644
index 503f30797..000000000
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
+++ /dev/null
@@ -1,33 +0,0 @@
-/*
- * The MIT License
- * Copyright © 2014-2021 Ilkka Seppälä
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-package com.iluwatar.business.delegate;
-
-/**
- * Enumeration for service types.
- */
-public enum ServiceType {
-
-  EJB,
-  JMS
-}
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/VideoStreamingService.java
similarity index 92%
rename from business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
rename to business-delegate/src/main/java/com/iluwatar/business/delegate/VideoStreamingService.java
index 20845841f..3c8b7e3fb 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/VideoStreamingService.java
@@ -24,9 +24,9 @@
 package com.iluwatar.business.delegate;
 
 /**
- * Interface for service implementations.
+ * Interface for video streaming service implementations.
  */
-public interface BusinessService {
+public interface VideoStreamingService {
 
   void doProcessing();
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/YouTubeService.java
similarity index 89%
rename from business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
rename to business-delegate/src/main/java/com/iluwatar/business/delegate/YouTubeService.java
index 932c5038d..aa79e7309 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/YouTubeService.java
@@ -26,13 +26,13 @@ package com.iluwatar.business.delegate;
 import lombok.extern.slf4j.Slf4j;
 
 /**
- * Service JMS implementation.
+ * YouTubeService implementation.
  */
 @Slf4j
-public class JmsService implements BusinessService {
+public class YouTubeService implements VideoStreamingService {
 
   @Override
   public void doProcessing() {
-    LOGGER.info("JmsService is now processing");
+    LOGGER.info("YouTubeService is now processing");
   }
 }
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
index b59759328..8cd5e2021 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/BusinessDelegateTest.java
@@ -26,25 +26,20 @@ package com.iluwatar.business.delegate;
 import org.junit.jupiter.api.BeforeEach;
 import org.junit.jupiter.api.Test;
 
+
+import static org.mockito.ArgumentMatchers.anyString;
 import static org.mockito.Mockito.spy;
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 
 /**
- * The Business Delegate pattern adds an abstraction layer between the presentation and business
- * tiers. By using the pattern we gain loose coupling between the tiers. The Business Delegate
- * encapsulates knowledge about how to locate, connect to, and interact with the business objects
- * that make up the application.
- *
- * <p>Some of the services the Business Delegate uses are instantiated directly, and some can be
- * retrieved through service lookups. The Business Delegate itself may contain business logic too
- * potentially tying together multiple service calls, exception handling, retrying etc.
+ * Tests for the {@link BusinessDelegate}
  */
 class BusinessDelegateTest {
 
-  private EjbService ejbService;
+  private NetflixService netflixService;
 
-  private JmsService jmsService;
+  private YouTubeService youTubeService;
 
   private BusinessDelegate businessDelegate;
 
@@ -54,19 +49,19 @@ class BusinessDelegateTest {
    */
   @BeforeEach
   public void setup() {
-    ejbService = spy(new EjbService());
-    jmsService = spy(new JmsService());
+    netflixService = spy(new NetflixService());
+    youTubeService = spy(new YouTubeService());
 
     BusinessLookup businessLookup = spy(new BusinessLookup());
-    businessLookup.setEjbService(ejbService);
-    businessLookup.setJmsService(jmsService);
+    businessLookup.setNetflixService(netflixService);
+    businessLookup.setYouTubeService(youTubeService);
 
     businessDelegate = spy(new BusinessDelegate());
     businessDelegate.setLookupService(businessLookup);
   }
 
   /**
-   * In this example the client ({@link Client}) utilizes a business delegate (
+   * In this example the client ({@link MobileClient}) utilizes a business delegate (
    * {@link BusinessDelegate}) to execute a task. The Business Delegate then selects the appropriate
    * service and makes the service call.
    */
@@ -74,26 +69,20 @@ class BusinessDelegateTest {
   void testBusinessDelegate() {
 
     // setup a client object
-    var client = new Client(businessDelegate);
-
-    // set the service type
-    businessDelegate.setServiceType(ServiceType.EJB);
+    var client = new MobileClient(businessDelegate);
 
     // action
-    client.doTask();
+    client.playbackMovie("Die hard");
 
-    // verifying that the businessDelegate was used by client during doTask() method.
-    verify(businessDelegate).doTask();
-    verify(ejbService).doProcessing();
-
-    // set the service type
-    businessDelegate.setServiceType(ServiceType.JMS);
+    // verifying that the businessDelegate was used by client during playbackMovie() method.
+    verify(businessDelegate).playbackMovie(anyString());
+    verify(netflixService).doProcessing();
 
     // action
-    client.doTask();
+    client.playbackMovie("Maradona");
 
     // verifying that the businessDelegate was used by client during doTask() method.
-    verify(businessDelegate, times(2)).doTask();
-    verify(jmsService).doProcessing();
+    verify(businessDelegate, times(2)).playbackMovie(anyString());
+    verify(youTubeService).doProcessing();
   }
 }

From c413e0902e3c718ff84b34c1f086648d853c0789 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Mon, 22 Mar 2021 08:49:46 +0200
Subject: [PATCH 250/254] docs: #590 add explanation for bytecode pattern
 (#1687)

Type: docs and refactoring

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 bytecode/README.md                            | 224 +++++++++++++++++-
 bytecode/etc/bytecode.png                     | Bin 19866 -> 0 bytes
 bytecode/etc/bytecode.ucls                    |  49 ----
 bytecode/etc/bytecode.urm.png                 | Bin 68283 -> 86123 bytes
 bytecode/etc/bytecode.urm.puml                |  10 +-
 .../main/java/com/iluwatar/bytecode/App.java  |  42 ++--
 .../com/iluwatar/bytecode/Instruction.java    |  22 +-
 .../com/iluwatar/bytecode/VirtualMachine.java |  26 +-
 .../java/com/iluwatar/bytecode/Wizard.java    |   5 +-
 .../util/InstructionConverterUtil.java        |   2 -
 10 files changed, 277 insertions(+), 103 deletions(-)
 delete mode 100644 bytecode/etc/bytecode.png
 delete mode 100644 bytecode/etc/bytecode.ucls

diff --git a/bytecode/README.md b/bytecode/README.md
index ee3f96ed8..115f0b96a 100644
--- a/bytecode/README.md
+++ b/bytecode/README.md
@@ -9,18 +9,234 @@ tags:
 ---
 
 ## Intent
-Allows to encode behaviour as instructions for virtual machine.
+
+Allows encoding behavior as instructions for a virtual machine.
+
+## Explanation
+
+Real world example
+
+> A team is working on a new game where wizards battle against each other. The wizard behavior 
+> needs to be carefully adjusted and iterated hundreds of times through playtesting. It's not 
+> optimal to ask the programmer to make changes each time the game designer wants to vary the 
+> behavior, so the wizard behavior is implemented as a data-driven virtual machine.
+
+In plain words
+
+> Bytecode pattern enables behavior driven by data instead of code.
+
+[Gameprogrammingpatterns.com](https://gameprogrammingpatterns.com/bytecode.html) documentation 
+states:
+
+> An instruction set defines the low-level operations that can be performed. A series of 
+> instructions is encoded as a sequence of bytes. A virtual machine executes these instructions one 
+> at a time, using a stack for intermediate values. By combining instructions, complex high-level 
+> behavior can be defined.
+
+**Programmatic Example**
+
+One of the most important game objects is the `Wizard` class.
+
+```java
+@AllArgsConstructor
+@Setter
+@Getter
+@Slf4j
+public class Wizard {
+
+  private int health;
+  private int agility;
+  private int wisdom;
+  private int numberOfPlayedSounds;
+  private int numberOfSpawnedParticles;
+
+  public void playSound() {
+    LOGGER.info("Playing sound");
+    numberOfPlayedSounds++;
+  }
+
+  public void spawnParticles() {
+    LOGGER.info("Spawning particles");
+    numberOfSpawnedParticles++;
+  }
+}
+```
+
+Next, we show the available instructions for our virtual machine. Each of the instructions has its 
+own semantics on how it operates with the stack data. For example, the ADD instruction takes the top
+two items from the stack, adds them together and pushes the result to the stack.
+
+```java
+@AllArgsConstructor
+@Getter
+public enum Instruction {
+
+  LITERAL(1),         // e.g. "LITERAL 0", push 0 to stack
+  SET_HEALTH(2),      // e.g. "SET_HEALTH", pop health and wizard number, call set health
+  SET_WISDOM(3),      // e.g. "SET_WISDOM", pop wisdom and wizard number, call set wisdom
+  SET_AGILITY(4),     // e.g. "SET_AGILITY", pop agility and wizard number, call set agility
+  PLAY_SOUND(5),      // e.g. "PLAY_SOUND", pop value as wizard number, call play sound
+  SPAWN_PARTICLES(6), // e.g. "SPAWN_PARTICLES", pop value as wizard number, call spawn particles
+  GET_HEALTH(7),      // e.g. "GET_HEALTH", pop value as wizard number, push wizard's health
+  GET_AGILITY(8),     // e.g. "GET_AGILITY", pop value as wizard number, push wizard's agility
+  GET_WISDOM(9),      // e.g. "GET_WISDOM", pop value as wizard number, push wizard's wisdom
+  ADD(10),            // e.g. "ADD", pop 2 values, push their sum
+  DIVIDE(11);         // e.g. "DIVIDE", pop 2 values, push their division
+  // ...
+}
+```
+
+At the heart of our example is the `VirtualMachine` class. It takes instructions as input and
+executes them to provide the game object behavior.
+
+```java
+@Getter
+@Slf4j
+public class VirtualMachine {
+
+  private final Stack<Integer> stack = new Stack<>();
+
+  private final Wizard[] wizards = new Wizard[2];
+
+  public VirtualMachine() {
+    wizards[0] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),
+        0, 0);
+    wizards[1] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),
+        0, 0);
+  }
+
+  public VirtualMachine(Wizard wizard1, Wizard wizard2) {
+    wizards[0] = wizard1;
+    wizards[1] = wizard2;
+  }
+
+  public void execute(int[] bytecode) {
+    for (var i = 0; i < bytecode.length; i++) {
+      Instruction instruction = Instruction.getInstruction(bytecode[i]);
+      switch (instruction) {
+        case LITERAL:
+          // Read the next byte from the bytecode.
+          int value = bytecode[++i];
+          // Push the next value to stack
+          stack.push(value);
+          break;
+        case SET_AGILITY:
+          var amount = stack.pop();
+          var wizard = stack.pop();
+          setAgility(wizard, amount);
+          break;
+        case SET_WISDOM:
+          amount = stack.pop();
+          wizard = stack.pop();
+          setWisdom(wizard, amount);
+          break;
+        case SET_HEALTH:
+          amount = stack.pop();
+          wizard = stack.pop();
+          setHealth(wizard, amount);
+          break;
+        case GET_HEALTH:
+          wizard = stack.pop();
+          stack.push(getHealth(wizard));
+          break;
+        case GET_AGILITY:
+          wizard = stack.pop();
+          stack.push(getAgility(wizard));
+          break;
+        case GET_WISDOM:
+          wizard = stack.pop();
+          stack.push(getWisdom(wizard));
+          break;
+        case ADD:
+          var a = stack.pop();
+          var b = stack.pop();
+          stack.push(a + b);
+          break;
+        case DIVIDE:
+          a = stack.pop();
+          b = stack.pop();
+          stack.push(b / a);
+          break;
+        case PLAY_SOUND:
+          wizard = stack.pop();
+          getWizards()[wizard].playSound();
+          break;
+        case SPAWN_PARTICLES:
+          wizard = stack.pop();
+          getWizards()[wizard].spawnParticles();
+          break;
+        default:
+          throw new IllegalArgumentException("Invalid instruction value");
+      }
+      LOGGER.info("Executed " + instruction.name() + ", Stack contains " + getStack());
+    }
+  }
+
+  public void setHealth(int wizard, int amount) {
+    wizards[wizard].setHealth(amount);
+  }
+  // other setters ->
+  // ...
+}
+```
+
+Now we can show the full example utilizing the virtual machine.
+
+```java
+  public static void main(String[] args) {
+
+    var vm = new VirtualMachine(
+        new Wizard(45, 7, 11, 0, 0),
+        new Wizard(36, 18, 8, 0, 0));
+
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_HEALTH"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_AGILITY"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_WISDOM"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("ADD"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 2"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("DIVIDE"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("ADD"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("SET_HEALTH"));
+  }
+```
+
+Here is the console output.
+
+```
+16:20:10.193 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0]
+16:20:10.196 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 0]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_HEALTH, Stack contains [0, 45]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 0]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_AGILITY, Stack contains [0, 45, 7]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 7, 0]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed GET_WISDOM, Stack contains [0, 45, 7, 11]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed ADD, Stack contains [0, 45, 18]
+16:20:10.197 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed LITERAL, Stack contains [0, 45, 18, 2]
+16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed DIVIDE, Stack contains [0, 45, 9]
+16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed ADD, Stack contains [0, 54]
+16:20:10.198 [main] INFO com.iluwatar.bytecode.VirtualMachine - Executed SET_HEALTH, Stack contains []
+```
 
 ## Class diagram
+
 ![alt text](./etc/bytecode.urm.png "Bytecode class diagram")
 
 ## Applicability
+
 Use the Bytecode pattern when you have a lot of behavior you need to define and your
 game’s implementation language isn’t a good fit because:
 
-* it’s too low-level, making it tedious or error-prone to program in.
-* iterating on it takes too long due to slow compile times or other tooling issues.
-* it has too much trust. If you want to ensure the behavior being defined can’t break the game, you need to sandbox it from the rest of the codebase.
+* It’s too low-level, making it tedious or error-prone to program in.
+* Iterating on it takes too long due to slow compile times or other tooling issues.
+* It has too much trust. If you want to ensure the behavior being defined can’t break the game, you need to sandbox it from the rest of the codebase.
+
+## Related patterns
+
+* [Interpreter](https://java-design-patterns.com/patterns/interpreter/)
 
 ## Credits
 
diff --git a/bytecode/etc/bytecode.png b/bytecode/etc/bytecode.png
deleted file mode 100644
index 31b6bc6edba64cfb51910e5d2c5322be46e7c075..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 19866
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
D@r6J8

diff --git a/bytecode/etc/bytecode.ucls b/bytecode/etc/bytecode.ucls
deleted file mode 100644
index 3ec390458..000000000
--- a/bytecode/etc/bytecode.ucls
+++ /dev/null
@@ -1,49 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<class-diagram version="1.2.3" icons="true" always-add-relationships="false" generalizations="true" realizations="true" 
-  associations="true" dependencies="false" nesting-relationships="true" router="FAN">  
-  <class id="1" language="java" name="com.iluwatar.bytecode.VirtualMachine" project="bytecode" 
-    file="/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="455" y="173"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="2" language="java" name="com.iluwatar.bytecode.App" project="bytecode" 
-    file="/bytecode/src/main/java/com/iluwatar/bytecode/App.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="148" y="110"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <class id="3" language="java" name="com.iluwatar.bytecode.Wizard" project="bytecode" 
-    file="/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java" binary="false" corner="BOTTOM_RIGHT">    
-    <position height="-1" width="-1" x="148" y="416"/>    
-    <display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-      sort-features="false" accessors="true" visibility="true">      
-      <attributes public="true" package="true" protected="true" private="true" static="true"/>      
-      <operations public="true" package="true" protected="true" private="true" static="true"/>    
-    </display>  
-  </class>  
-  <association id="4">    
-    <end type="SOURCE" refId="1" navigable="false" variant="ASSOCIATION">      
-      <attribute id="5" name="wizards">        
-        <position height="18" width="48" x="296" y="291"/>      
-      </attribute>      
-      <multiplicity id="6" minimum="0" maximum="2147483647">        
-        <position height="0" width="0" x="-327" y="-27"/>      
-      </multiplicity>    
-    </end>    
-    <end type="TARGET" refId="3" navigable="true" variant="ASSOCIATION"/>    
-    <display labels="true" multiplicity="true"/>  
-  </association>  
-  <classifier-display autosize="true" stereotype="true" package="true" initial-value="false" signature="true" 
-    sort-features="false" accessors="true" visibility="true">    
-    <attributes public="true" package="true" protected="true" private="true" static="true"/>    
-    <operations public="true" package="true" protected="true" private="true" static="true"/>  
-  </classifier-display>  
-  <association-display labels="true" multiplicity="true"/>
-</class-diagram>
\ No newline at end of file
diff --git a/bytecode/etc/bytecode.urm.png b/bytecode/etc/bytecode.urm.png
index 82036a78a9b1f87bc89556c63fa401ab3a9d99a6..51335fa0a4b40a73957b56e79805aa9aed7e4cd1 100644
GIT binary patch
literal 86123
zcmbTe1yq#V8#RuBfg%>&(v76Fh)7Cz!w}L)!w`ZBN_VGpJEXu+D&0M_(lLP4(C{79
zt5@&u`_}sZS$D0wkl}q#JZC?9@8>zZm6H*}#2~;xLqo%q5Pz(IhK4SVhIZcn%6afF
zd3-zi;D2=XqH6XKYa15}BV&6sF(WG@TYY;YLox#wvS;@8HoPn>HWvC;_70X7%n)nK
zTdX`pXlNH0OqJB^|M_>cbKo(~34tnOR-+GZx>rPa#)xU6-+eZyl%4yio+_Q1tV2}(
zuBd;_bCt5;79Eji5uWRaOKzHEEVal49=rKzZCzjQi}yCiuNjHv*L_aa+t+zn+3S;%
z0UO6K+vj?{dkwwbRs!#lNtvYXxn;e819$iHmaJ~gspsGnsd__VW~aAbDqEgT-)d66
z{eXP>=`GeZenC_8=-EduvkfnN@4aDcaH|dWv8d6ZdSuN?y1m_ItD7w7bZ`N}>K-y`
zwG(u|CNd7^LJ2p4inMr!EbkK|cME%xq|RPsZEhz&`A2@{v;T;kaCW<Ax(s<2398hK
zhrOQPr?Gkr`?&XE*EYLlP*L0D3a0gIh3ILjB)W`TY>7Kjz5Z=)#jr31nxh}QHoJ=2
zQ%dx<N6cSu4*wuxP{Sr8#OLHtuexIW4r5*DKDuAFE_B7`n8J%V`0G6vSGUm>hNku>
z6{ShHIj}C45gV<%xBZrGJ>Yjy87o;q;W5#X)?2<CcCm=HXC+;CHJzp2GU#-_2zwQN
z(54_ub`58=*2#ya^WLfwOx)qh6|wV%DgsT4-2@)v)(VAkNjjKs7R0oWZnn=P;+h-6
zv?#xfKg_6f^9T{o6-ZVj*17Yxk#oE>iUY4EK)X1j{4GY<xp1-$>=7HY;O7fQQBqRb
zPs8M4J~_`gNy}A~R2cRKWwLV;d&%S5(@NAh$ED6Ezlh`%PpQU<zRoZ!i%@>bX8L+m
z+=oH86|SCp;>=`J7#Sd_zIMcFlGxD!b1IashMhdHv*EtiFn+X@IOb3-sN4UrN6)eT
zb7&BG@gvQp&4IcGTJ3;$#T_(!<7LMxssb60_~l~~g~DyGqkCtpS4Tu(g%Q1eKxC4Y
z*k_=vXhl=Uhv69RKhlFHO%;&FMOe^|qoc$=%}RMrOGkLiyxL{NO53YYmYmDnZ<Lhq
z=7GGP{Cj*q<91q=0y-zdr+VIeSX<8spD?toyLzIorEGCtb6b;Vj;P*ez2J7LQm21j
znjqzN3|1tGJ9#KW&jr3W_+|QB$J(c<c(3?wIaURFic4}&PJ1(rO3w+|aiDd*P}Gq?
zLwkWH@mN^NSqGVT)%nKoNwcEVyT|v0y&vE6r@A+!=9jBMpDGUVFHqWxZptW78C1}G
zW_dM(YBX=?jrgmcQHFBF?JAq1vhmzw`q4bt+|FsMKCkh70=%`_d1~XBe~P9%mffT)
zLA?uJXKg$m@JR$5%O76|rW<Y7|M><DfyIjY=bIPA7a&;we1o|E?;j|#LOf@h0*TS?
zCO~)B=wzw?`Ph7lUQ-fL+yylBh3fTM#U$x}e$XMTA8?EuDM_v+zV_mZs_L-t%S(U!
z9&1z53B3tgeU?dg68NgDtZc*o=a;1~HIb+#%+4C}T4u^7*V-*~QHTX42tZLo1)6P-
z{`nNf>tp=GFJJV`MCv?_IcQdIRgb+|TzqC`v$H%H$^PJIe<4{$MrL)aLRMCm#@cgx
zvDbXKknY+ULY;ll-epCh&#YEVF^6Pv`aH7srXqk`N9RO+HZQ7CDb%X`{Q2=FDmFG2
zjIYLSA*lG~k6%N3;SKR@I$4{j=HcP#Tj<AF^}FW#Rws_2sDn-aj<khzD%~rXZt1gI
zOl;4mKc}ascgAy*3b@{tow@Mi0WZ{92N4VN^Ih@WMLIREEVX+EISLsB9M9fcPYJep
ze*4l;YT9o$ko|RWadCROFY{@9BA=6_R47fl>!jOO=ku8+uvRY4&Yv3_C*Uq6vdMx<
zZ<CX!`ZA<4K4N@!LJ9~7m~KuuO&Ns?xNfINm|<ts?avcRM$^iBSFRLlSNF}nICp{8
z9c<@4QNJETNlA>SVW;`Zc`C7NMt;}~Dz$F=%-U56g6?sfD+4(*-#C=AQjR{+bgqn5
ztY^!oJyX%sBWsVQu>3gN8lH1ZB^4Fm=l71fH~-}Lu%A(*NNI0SRW~Ey&6_Jaki|DW
zUFp1u2?<)-+I$Yn_DIBi(~XbBEW8{wt~>8G2jCLn)V(rxA^6Y@0{qkCbx(gBrcoHA
zd9FP=D=UkX-}&aBtA<6wA5$sm<m6<$8pWjfWZzIx-D5CUxwT5s+ijxUatxu+f#Bog
z3%^6{+bTJfuU_K3F|BkVgHCs|2_xV>YQ1KcBtC-h5X2J<`#ysv%s|u^J}>Y3$p<sS
z<LhhOm@!IC%>s?GZ{KX#-j!-|v`<Z)PS!wYy9N09i8fF8dLCeD$jRxLkwmg6q>D$=
zD?bb4l)k|r0)5F?Q&hxaK1*l~7cRL$%=?+Tq@=`jb9peYl+cuoi79Y6286#n^{Rv!
zR$goe3Y<+u6^0YM%3-Bx9>iKKfy7gX@2fx+$7Q)ZH&<rA)Hg6N05*Qw)a_^7v0kIb
zKUB<;3B`A8u}kep*RJzOygv5!4owV}p;MRjB)s*AUY)O;j2)FB6`lDJmqo|Wsl7E*
zr^<e5Z)3({q^R!XU_&Fh2@fJ<@c9ZC9XINtx_Ml}eMr+%e-_=>>FGzFMOu|?W&^a6
zuU@@+Z_qIr?oaI$7Z&z$v;>?1--N6w^f~n{5F+KCryg+wrNv?Rf}SV*PiuE4q4_@H
zG_rk$&z{j{Knx6MYizzgl8k0h4LTlvIDxnHhLVa(praa#^zPlq;UYfQL%W%JHr@pq
z*qJ(T?2lR3$tz~;_zlwnz~YHG9WhD%`g_t8VA9|u8t=!vjZ}jfptlRzd_ij`j~5FM
z3JS6a!#|Ws<b_E%Mpt{Do>&xv{pR2?YP-voQ-2rIon#UG=8YQM`9784!6L;$d|ccp
z+{I4vIw4m8wv@Pdwp{ARG|Z6DgoGoxb}9e%lKC>rF%=!1a}1xXdhd*kjO6=pnh){2
zZC>(<k0(^$7}kMy3J=LRK+-ARrGUuYtVHM4Ss5yT*g36FcFsR}@`RUPy~sJxwkuia
z^y4)a`;{Tg-|>qN%ZJfyHQ90m3UmjSWOdTWCUsC_zX=pzNA&Tb^!4>`utDk!TW`lP
z>ee3BdtCshhFJ$LuEI`Do%#6f?HjTI+ucH^9ah5O=oy#^d``?`QIQO)f&-g<)0_D&
z*0uYYN;-ib5hg}PFakBGt*tFWNN~P8x%*`9`QA5u6@>{r({3yRjztQ5yZH_mHN*@R
zKC~4jCMwGFeb5-o;H<B&2WM^k#K-!87(--6^ZRQ1rH@b2tIuG^ZsBvVqYz^Xj7DTE
zRpfF~xT^F}p>{kqpCeLyi9xk6f?0c1*cj<~yrVkA3LxLOGfrLxoF@d~Oey(rk!}_d
z+id=IDC^mo1zYEUN`O~XaObg3ZTijM=cve*j%CAT)^etW-c5F-V0Z}ip_YoIpCg0n
zKBT9!?r06C87T%yErPA2xERri0yu&iJ%8W*VB6Ql`p(|o-UI&osA*36H-Ui}mjF2a
zD~NDG5cw82Aljmsq^K*wYA!b*5SS)AUtFFL9LB`p#cgkH8iX4_SSk%RSCyEcP+d0E
ztGYTN23FhI7T;o&6h$|wkVgV%igvYQnpkk=ssVb8ysWsmUU=!%KtgV6RYv9_QzU1F
z_<d)c$B$nrCFOIn&wd8@lkVmKp$*4WUk@>9=d)jwE70Kdh3lgu?!D&I(XO(8-a<%6
z#>N&FWdK!nRd@)0!h;mL0w&bZzxVUd>oH4nqL5pr4l6@c{@MHcrPGc6(Ey&o_xSku
zeF{<RC~m9q#ojbufB$QPJjNY(^Wt+&N$xKb$sqf3D9ZhBUq5BA%{sK6^6~Qe`1pjO
z8-bypt`yb1d-o3UVdHb%>9O^5mzh9;$XE{3+lS-YyK57kr^inF_mGL_i-)3Fbfeff
z2}PiS%*@P`l%HE$TSrD>9d|&0dLAs%l#722!d)Fq5`ZdvYS~hpX^rJ;38--n#5jN9
z!b@-OZybU@=Mi&FF;L+B4Wy|X%Fj!i9W3iRQGbvDv3?&A^%t-T2OK7iySHwE)F%%0
z7%tRq8$n$n+!EsDCHU)eh@M@5zX#L)ED>ACJEKvqJInvt?`y26`qAt7Y@d63pEr1;
zI}?!p9ES8|KrG_HF7~Q#ck!)%`HeHgcu+k{TRXdni3vh(E4al-acOC3M@PpsTxQx|
zlz}zK8~<=;WjGub92`7#?#0zo%dw%>)}`a!DG(oST3SRrM@*XK|NMfT-Aogv(HktZ
z_nsKW$kx6E_xr>@2BPPQtS_lRTMPxy!zASDnbSidNAS^N>Om4)WPH~zu`gu!{gZn5
zv<Kd>%MXk0b|BX4`F?UW1UX}vZl&$q>ub0mp*yY&F}c~|p-rIuq;D@y^h1x}E?YrF
zJhq#&62-fFv#e-U=bA{+{B72oNL3vTMMA9X*XNVlN`QcSq1|wApH4B;VygD|OT)|A
z)s0qtH2Vty0%$m10dip?6j%BJ3ylpKx^2OT9MSz}n}dksqoSTnp0tEg{C;wM!12aj
ztg0iWaESJb^SCq~6b-HC9Ag+Mr<sz0fq|>5tFiI?NQp`0Ycw>})$dQohq8%Y`lNrQ
z*j)QW@G2M{n*9qyWHh6CSV98a{SXCG3O!hR<Q?!V#`6IJ>4f(ob#!Za9UamE6&Jx{
zu7St!0<MVW52n8Kqys@C8xxt76toeAhF0(41=g*(9&thMRuTmyIo^G#n#$L;t^{Uw
zShiNwqf+DmHG(`uG!(vMretCr7fNTu8i|jA>7q6UK*IU^1>X|z4*i#=EUsJBHB@&t
z+^FexV?8>W4KC~?mi4523i4K>b+s<8XQ9r`VhS)!`+<l?e_RNh3JvYOt{(DS&l#Uq
zyEs93IDR<dd#Sd%Yi1B~VTzi)`%b5}YVDj?%Q>tyA|=)HBd@_2I6bKGp`X3c(DdrS
z1X3X20q?IIaG_?G*)?`22#yXi@F4@nI^^^vWyZeiA{2J(#yNT37P@DgJq7Fc>)Z(s
z^BdN!^9DDTi86c_-b#j52=zFmRMEGf(9eS901YhO8SQ@|+5>~tl^Th<HV#E+3ON+j
z?n><tmF_*?gyy3~>Vg4U=iy{Cls?}-P~msBspLJ~zXcW_ZSexw8~f{L+bLYpB*+a_
zEa+O^UEbnE4R20XoOTHXn8^+8mwLav5XBs*yx>1KH>b~hSdeYDF)g85XrYP=^|<)=
zK=NR9VX$SsQ=8X$(E;umY|ME++fgfzj?`RWm^uY4?iG)<3$*4rQM+r{dr&AmH%YSr
zaRKdx;EP}Ty={gJhI8{WOg~M6VQtgqB~cBh4ns+o3DXKym@8qs+l+@xS)T~FuHU$x
zKVGCO)|wGadg}NZ!$?~@F;97GqRw+EgnYsehe-iuz@t0m=Z`BJhLf*a^dyh~aK3pR
z_=iX)J~!v0`;d3)2NhFXApZ}2`UIe3r=WsYKB$U*N&YCDX1L6>|ATaFpOT3}AII}+
zJCxs##AUEYi+E=d?X44dJb$1q6YQ+IiU{ODl_E2ji3bMTGFVZep#^J`0^&dg3~kOS
z(r)#nVjGr^%xsu+<)7{h2VNSqbkun7emKv=b7;4fbTrI?!Xhzz?K4D4<GC_qMGrEy
zkoq}M<qpJDT{8CFS&$-9_?&LYNti5zjf}j7<19=69Vs;ghh^9rr#O6)s|e01SeCTt
zeGSKgLxyFuIR(5!V!m2~rQWnOv4BOXw-jPwZP89+#YTcI7N&G%u&L6eYo-eQh;Vi%
z2M1~?7VQ3fKm5ZBm!p7A5$B#wOQTSOaA;<;|Bqb?Cyv*N6)5a!N{V{Qd=gfrQF*uN
zBr7>g-L)^>Y0{(mniL=tdp$jI%*+|CyH?#+6M2Eh!9s#MJ@xld=EF_>Rq1SD9D(i{
z8d?P!UJBHl)bzQDUQ>?*zN5+ZxnKB@q6(=iG$3pshBkh2sTQkCqeU$SxsODF>9I8-
z*tKg8jzLc3w@{OnR4qj2u%i0BDRH9}Ou9YV``iyoqo-ieQz#P!rO0(+sPMHN^8c}w
zQ9V|50Vgj^kb$nvwZ=3KWwvwXNY4|Oog{&&kY;LG670bseB>oe@7s5TBI)Jv4sn>4
zS=3mgZfD74gvXkI!^6$TQ99p~DsZv~2|gl*iYfzQ2+$K>=w!9p32SY#Cfj~VL0vs~
z3Z_~iX9Cg!8k#!*z866N>FVz-4kAchJh#7|+&62sN{0z;yRIW+um%U)B8y;C71pK`
zRfDY>fRksM4|5F{naCMSwn<xCce5Eu(opiVeZznxCnk#fb6DVwXGpE+)O^g4-{?-B
zx{E)OYoV^{<TQNl0&j^l7*qCMb8uFf*<jD$V5RF0J%frgcIp2djc%)28O)fb3}VtW
z+1^QI^h~$%?iB2_T#_$WSewbP{eMh=(6)qoc-_`^K>R7BXui31UBV~`lL$^n`7vbo
zn5QM^KUh%!<0h&tHEMJ{{nl<reYXXn8z)FTk;lZ8S9r7d`QH&|Z-JEX^$i~FE$$w4
zk#&K36?Wm*)p*Q))hGSG!6!iLYMtQ8-rV)b%J2a$om46ICby~Vm987Tr4j!VM=N05
zvo439K8aa=v-ULmh%i6W+&v}Xa;vfCqra+ZUH6}9PlEUxEjF;LDI^q`e89FhaoQ1M
zbKm1*84I;mj38=!R!p~XOs%AUzDoO>PEF0Vvqbr?&_2sdVr`wZ05e+-(<(TSNox~9
z<#8tpakeDxBR3#l#_B*qKzm5~JCk&W!hE-x|BB)73HI+5(?gO^T>0yTAk)9yi#7Bk
zYbkW#x1#=@2GGF6exv~}d?+9cXK$>Z{GEYGreMheGi^bXAlWCrNj`Um`MkfA4`4Qc
zk>IbN;W+be9RFW$|DNgpMlU?5IQQS{8q<!@tuFu63)}nlwPrTfsJ%+15V^FzKDWAx
zk3X{frD1N`?FyUd-;c7xKiu2H(kQ>a^UbEtZsA3Q#HBMtqI<qRnfmG#tgDO4b5B2#
zjMQ8DKMBwR$(<l>0k=t68R*)M?pr<|21Hf4rRJlRp}?^4EUDNqFB89@pv9@W@c;Sy
zddSw+!$vVnq43S-M0fB6e(U7O$i;<)$oTjg3v~-;XLdSW{V#WJH*s0uF}C=UDgJ#P
zZsHv_UAt^0a9nYm$uXDhAL?^s^}hZ`J<0Lfn(ofdxugB3jNl2lj6GZ^1;LB4_x_3j
z?|MXZ?CAbbqI(}@2A!BTBaMj=z5@#j7D$4WAbG%G_bsA6)??xI#8Uq6_d_Yx5j0d!
z&3oU~a#T94PuJJCF*4!r0sLZC`}QmZPU`8#(c1n$hYqEff?-`VKbVV7o8vh-(ZR>p
zCEUF3mLWOk?nd7;)zYE@un%`(P9%ix@4dbfP?JiQHZ9V_j{7$&u|Sgl7dKdY5qvRN
z4s$n^$o`IaX%5s)L%ts`sQ<365a(X3g54LGleoV3olgEMEd6H(o08@(=$X6iPB^uN
z<9+)M#W9VDXr>j7%HpiLy6B1u6GOwimzSfZ_Jxik#tSE;wibdzF&5^HRdW<12)L5n
zcV*;WW|^piWzJO0>KiooC8PeaF9r}HC<-aYEphHWCa};hV-lqEzdc6^e#q#JKoIiK
z*UomYPw+*Ad|RyE7CL$_*(NI)H}v5-Q_eTk>eXee34e3BqFderKWB5#B?%_>3d_O|
z=rzE{=jZ2v0eb@+0JV!=Fz!u0)TPK{;HsR(XGC&%$rRu-i@kTbDy*k&fQ|P<Z{!r;
zze#!XpB2^<>!Fj(n%iFLcUl{FnQaLLHqm62gOvJ}7I1{??_CLSpLu<uBI#sINioiL
zpz%8WVPXhtx&9|TmlKfX1dra6Qdv!m0v(*QwZKh>b9X>4N5KU|TKWq#>m0O;IX@_B
zeN>>kjSXvAs&1V}TsZ2@gykc9dk)SIK=QTWN0CoaoGc`J^78PM0sB-yAQ67tn<iGI
zT}|DIZuXrvpNHrgn=NQMp(Mg1GKn1Szif+QQA^=KsjI)mrjMv`TJQPzdgkM&_#E7h
zic448RQ~}47x*!1%y_r-_2fk<jwU=t6Cm(gVkk~V&5MBX!hHXJDBS&rq*))Yq+mgt
z{T>?^n`(QUke9D7N-N9`=O{7>xXbisI)Kxkhs%+9>B{XN=<UTscv$VUK0iAvp3L1}
z>JlZ=??QmZsS|7Tkvawu^9W)DvF^Ba<{}%(Bs{oJM`yY<-zgSM(%8Ru{+~&`aYBNi
z{Giv6mb&h7ByT!AGb8k@hb$X-cus3XaxBlJF>g}h{Mf9SKzA#vH6RIrCAkYka}>RD
zE^s6dQLAZ3m$68s<GBg|w*`9-RKDeC=}4trR_R?H?%ah=?kOT}tAzOYcwb*JEv<22
zW*=@ZiA3)0?=xvvDbeRYbUPjD?+>S*a^KbF8c7qwic43KKZv)kO|^e}n<}PyZM2Nx
z=?y&A7kz+)(ki51d77D?-b1<nNu$gx5~xn#=>fNQy)UEv%!RB2Zr%-95eJMmA-6tw
zt@~kLSGu~FmlvaMQ0Y}52QyJX9kS8W`^7yjIoMs7EqPX>@KsgUJ<|5xy?f4qsT7a+
z!k6uV`Q_lSI*`*3tmO2@YfkXRp6%s9|2D-f>Zfs!`8tJ->l)3K$R0d|Gu<YA-sE|D
zI0f7YM<n9;{^s1$(h^va&%YPinzki-FOoiTcO&PaCk2J3k&ys1UB%pR;i`>2qoA8J
zOQUxfY+;b>bbMm6#veP+hfLx}2nBGXUS7sBCh3@%NK~&jYLAi^+-Hu`Ei+RtUW*``
z0%jvu`CWEYS6A2Ut5*HuFkm(^>cAfiJ~VBMhQrRoIw7?iHM^6LaN8;8wQ-*Ed&Wi#
zD*1~c!~Bxgi1%K7EbwpV?Oqz1=PBpmkdVkc2`%?G-akB?s&)!Ks`T~s6`AzBOt2t)
z4Wmt}Gi_7U?=C1aU_34MY1KD+W*w5TyR%~y=r$9`{cI>z#1~=c=*aaH)FUDtDV}C#
zWNZ+ygJ5b)7m!%h=L{baw41-KsrofYwZduwG2Rx*ph%IE0~|{howV}}=cX+~_ufcx
zSdI>~x0^5ZW#r`K@HwshT0;W}mayYb^#csI-yZhk?;iHx4-cE$_@{@>^0$XQ03hO*
zhaHElLRRk5!5xHm-}`BsJB9F29JNVD%=3e7Q^^k>KJ-ihBeEw-;T|RBD{KfVNsFVh
zKO*Ap5P&=s|13WPGi`UAYQ7rm_;9yBJ##Rk<J<n$f@zpEOP<&2R!@(dWb^0Ga;{%L
zzK&p4EhIWD@~XPucS}N2(ly43RFIbT4Ylue{CmloDKnykjq`oW&o(QjJkl~HSFnrZ
z1NYE!Di%|hZ*Bz~gIYH2X-T)>r~bYD^Jnt<1<co;;s>gOCHVj2Xg{>r`dk|-FhX+c
zmT;Y7#NJ|B@S?SunHfL^y89LgRux8a^3+GKF@m`sURw3_C0d{ZQym8M!^H(X|9Z8k
ztf7fX2?3~zY<+7byl7=*W!R_-UFE#2&Nmns8uZ2+oQ;+RoJHpX&5EGTi5e((JRv^*
z(l^7JY0lhRq+~ld0!qXNNiZSLlcQ@a@SXxqZvMbzmhai)PGHRuff@0D<%@qZ*E}1_
zuuv^16Sh$K996mxN<|~-XAyl#)AcnUBV&i~JfW%GvtqaX%?p=rfCF3Qym3#xAtol~
zHkBmsar=Z$kJzixpW=ja*{qFMT4;hI$-Z2>iytuQYxd{k6<j!hUWtrsG}BuJmZbja
zUW|~Z;9+$0*H6Cc62PGs08p3`Y}gUYzM!uk9BqiC8Y9KVp8L;iJY#mFYJt<6)YOgp
zJ*~cNBJs8m`+0ylP<;>t2tIv^zKIXdXT~e-rp2mBae5HpsjEGy7rKY(s6k2bX*e;T
zWBN8o3X;*xt7Kb&pwPl#9+Q`6USixyo262qfed^;8nQB6q<910R>emEug+|co~t#0
z7b-J3HWsfOW9{-3H@8yMs4b$>=Ick1k+i*1LiKZ_>>TR3N_3Y;4$mt{xIh+JVMd@r
zLT6+QEdKaa;2<N*&<zf@m$0@bslRP(Ja;w#u;!LMs<v@X!MayuP;g*8BLIO=8?FEF
z;Q@aj%WtFX*YvQAUcw@oG^3<#0ay>bguw{AmK(MLI8gWR-{)AGn`@+Q<dU^*oE^*2
zK%r`939ov3daCGwRF7q}8vP_m$m8gN`NL|*)hEFuPsbWDSksb1Lh7ka?+|cXNf)YV
z>GZ!gvkEo%1_#x^9Da3k<CeGTCB_o_%T03BgvFEO-BIDdktv81nS6iVBJ?A15pcF2
z%m&`QiH|QK1*@T-P{l2hhry;Vq*sbgQ!x7;`@RF^PG<t$?}k$YW7A1j;sxNbZtm`G
z?iAqNogJ=rIt0cGOx;g^HJDh+=qeVLQ&mi{{cxe>fCHOpPzH-m;`E_Q7%dHh`Rn;n
zfaZ-&P45jVD@TgpePrbN`EKeh%s)tVy)&d+Fj=L-O1t<?T(T^K4%`_an`VVoVrVEi
zlM&DNf;fqQE5IDNL`YMBevpzCa)cXkmCXaoNHz?MR8WgvL?`;FE-eiL%3|t|RbJrl
zoJ9u6UV((NM~73VIMKuQsc@#azm4}$hyU-!JI@c}-7gTEl&teCt)YXoDJ(4f&teH%
zAOnxawUv~rzkM@~X12`Ou7UdEFvW!=@F#XE5L#q@@>LD{s=B~%m-JM)Jt}qfQ)`D*
zY*W5WjgCu@!D=*%HHGi#C#*bL0h6v4$5ov$mMbIvKXfIYHPXvLPj;q+2I2K0ltK)6
z`1X@<7w~2@z&>z<|08SSCQtS@N^esU6={tWCK>gxA*2B&@;c;Njz#rUIZ(7#5mxf<
zxS}^DJ>D5E&^*>X)eyOH3bc!#8F}?D`Z=cG`%d)Mty_S#lrA`}j%FlaCi%E4l6@~0
zT>FcG5`Jf(VPTo*moH~;#kR<(<|<7NSKOl`tJiE()if_FF1~$y1h=&-iDvT0#IkN;
z+tSwl8c;*NE{vwCy3puPL$^r|{iXQEyfE+Tf^-Us_m6n6o(Ui3g3S4^3AanHx~+5x
znuhg7q%oJ<&Y5tUACzo|Qb-KuscvlKu-ZSvib~@`NXHFnkmnkHeAN)~!5x|$AAhYn
z)M|ElV5M^yLCRbD&dr5el-f}2m)b!_lZ*H~;N@jjdyghNv-NY1HK9((!R{v6<P)np
z4`Ou<%lEMy1!Y>m8#F!B6pj^BBbAhdQ(Y~CIm7Wqu;GqZNbw&CpojE2E;b)#=9QXq
zSs>;Q?7nd3rIWFup438Qmxl^0ot;ar;g-K|4HhCvaU8{%TX`2AmRa^pUN>&M+UdET
zo>3H+vBUDtN5qQG?<a=E$FHodO#;9KoF^kA!^qfJ=Yx%~`r`g~1Oku0lqS~L-8v%V
zYHtsS6&%k0=+SxT4u+5;V`L}&;r7B>OLEDPo3_20T0cu25mWcZ?rvMl-e}0wG9`pX
zcfB*dS|91a@*|t_LqPY3Yuk^43}!#bcQiCvyHlQ?M|&I3pFf}dR$(#njxn9ZYWzbg
zvdQf`d;T{eVGL6xgcfh#Ktmf#dss_&wgCUK7@V6t&bkB6WY~2yix|tX@?Lextd*Iu
zkt(0^(v%;c*Lw%^Tuyd4cvJ%m3H)i#oC!mcTY_limsUVxD1-xCFEbyuny89gUpW3g
z2x<c8m15#w^0Qt?uf`S}8?hjwR1Zm%;8gb^_?h0V-(pkPE8w_>&{K}}f^Z1-S@~vj
za`&4=Q39J0#!f$AnhL6&yIUS$AJkqk%(J3^2*BgE3IPhV$ht9wtZuSqESbMDs8b<8
z#uKSVFXim~0hdnURYtX=Wm;i46T_(?aU{Q+b4FDc5TWW`=EIH;cyUMt;kZSh9CHjW
z+ZsY23H@>6fzMVVe#x7RVbSbKIeb^Zt&ibnQAm3S6ovLZCb7N;5*O-;#~L$zt~Q7x
zspxWrgUK2Zf1Ib{GD%&=IdwGMh8-1i&c^YoCT>TUnKXUEOo8EoR&<+sXVhiI`=21i
z&_@P0cc<%t_gz~8g(WXo)?^%D3ZQ8yHr54&R2RiZKbthrurxI5xTIyr(ru(ps9s%3
zbJxR}=6=Zt8@R1ewQH2HQ4Cd1L74`BNoQV(OrqIXIaR6Eg!n<l`J(r(t8j;39Q8FT
zDlYW;MdA6|{>2xYCii;I_SBzjj|X@=UxxZUq1uv)K~-uBeWhQ%pg9QM!Jn6mY&$$q
zp+vvvEVXZDUJ&J`t^mM^5>iyi&cM*y-Oa$w4IL>)0O;M61lcw2_w1ZigxNphK4!al
zF;<GPZS?N0vaxZdTLQn1HTIdcD|+*YDC*yijKy4Ax7pCP$r5nkb5)C`XB71pdq^0?
z`c(-_^UE~g)r)ZseFQYpc+zjjDt3VbpCD8xQS#T4{`peLBvu9i0c}AUlA;QX7cg!b
zJi!5-bP|_7q}JC{A_A9YonzXQ?WJ|p%5Z1~r+b-jyGC9k``9wCoh?d{8e4C7EHP24
zsj2Ci%ExpaK5Oj|;-Bt&H~q6Gd*0$rI@@1_hwADy%Uya7>By}qq2(@y$@Hb_ihP@g
z4WvgVn(xTDHEXV1R99zg)A&(-+kfB!pQJ}?noM}lKxTNTP}gkWcu~mrf8dgy5hOW+
zqd?UEpl=rFuL~C#%>QrWVBWSHeHW3^m6z)z8MM!8)OZxZ)UN0$omCf+nV`(cn=$CO
z*WF~aj85JXXCOb+C$C7`78V@dyix!}cjwjW^9FlznmE?85+xKTJRG)4N8ntfiHQLl
z=k1XV=msd#`Pv+mQLJv1e8NGjZWUEjK4iAhQC`*c{(Yvd2aiT=eqEjFlcwS2kKER4
zT+a#;E13VWre2s}b5OWFr-Zaud9s-Izi<k78!ZTmmoZMFiK}j-u~_FLou6zjfG)<q
z#WmV+%>#a`ok5*y{el=gl&15B%q4N|>El^iSyxb_Eyw)6@Qwtn{2!ug%9W>P=W7($
zRr5OG3bA=PvqSGIzO1I2Q0YW8{+QU?M4fZV3>#09lt`q)8(Ptpp1_ld<|KeaTVMWF
z9li6)lng~|XYab8?T*+GodCbA*ieB-<?cx;#h@}kqR;-t&Na$t0X00Zeugi0RFf^?
zZ4gs7>ZI#8s-D!;gfRK<hNtl_fwmF^7k^#~{?~ZCR{lGQT6L7IS=!5!S!;vM1t;(&
z^G>Y^ZGS$T-R;7j$|*ug>pCX~KWjt=6T<-Z=m$4<1`_@cT8XFQlB48~r6$huI6s56
z+!?*&yZQYMnpS7t<M1@2e1QL;I@M!X<dab5(Spqbxt}8{cV>Gim-_jzRX%AOERzLc
zl5$VLw^f#~)=nABwS4CykB_Rb#zdkyC)}1vhCuhpL)6sJ+YWBl8#ivKRdJ{!vP4Bk
z`&LS4zRLxCpj9Z@5Ux^`)cfIi0j{n+y=tNKA*wSYH7-Bp5i(FALub6qJd}gS{h%5s
zB?HsR8(y$((oQQZN{dwtXVZ4SK!@sdbg}ds#5p84IH<C>4n{+x%Mr~I*33V5;(mLp
z%|e&g^O;NghtS?RI@*>Zr*#yKY$2rNE@YUPFRJY}3CS9e_4-SN+GE)(MC{bA-@X(w
zCMF5`x`JMzBI9skUii_VYV!NGkvC55(Xy#i?}4*Mnv8K)(NfW_ET$=I8yjP1D~`0E
z=m6>1;IVF;=zf{G>Qk8{=7I>ER00zI7K8AsS0Sb~$(|>nN@&GK8y>b1G@$T{Hs<p^
zWJ?~i4GnmfQx)b;%3BSG-^hr{lMCW1c-H$aaWcT!^T1d8k^_rkdB7+lywA+h!@gfi
z`DgK#Si!`vF)#O_#(O;rz^oV7_qXCbPTgtHEv)M%M72AR24k8jPxbr(y`*YDECd@@
zT)tgyhu%?>oG5UV#_91jXCL!&9Fnk{WuAxNM#Qj7M01~Ehb`M<(Xwk;){aYkDk75^
zmc8$;hG`BRjV1`2Yq`EIw}>UZJKNkh`-zadkke_6RuU9Q=a!e<4z^uCg|~U`8(o-7
zcmRt6`uA{yN?C)G^DSdliCrtHhx4|`1HFd}!@8dPO@Z1Gg7(iu8~x@K6pSVP2a0rG
zs&rDvbLNeu2;U5-scA8*xdi$uM1LF}#?S!HGDwSW9z-zWausQld&gSeF2Sf+o7M-T
zP+m&vg8k-}PwPTERAgndO-UaMWQB-_-s{`w>CJf@^GY(iAMI5zDA7vYQYtg6J=|p>
zW=q!uxrLVYUS6g12Bm3(>kcRr%fF^JU2F6Yz9-NJsvS)MZ;h9xJjTXrpqfAdf#O}o
z<nm*l<y^``*Ui}~E=z)FI>oqUX~{V1XJ1#x4zuwpT~&POxYy;;XBc96cSyCXN~3T{
zx$+l;PHu@_#Za$yFxRYw6LMM%<=@&QK%jED$)`lGyMg?M89a@P_C2g;F~phOO?(&2
zm<|beh!&UUYm$?{K6FVGb76e?#ElJatFrn>Hl7vGSAGVO#kHrQX>O0MkmuznHFiB9
za)cx^dqy%qi`nuwJ36Sg+aJ$ibJD616BGB=d1jTE)VXhn(x@=?AMHZ`HDzXc#8vCG
zF1C9lo1iw9E^#G8AGs>3vcd^MlM&-P08WcHT`DVgG;G^M-=wX8Om&rNv)pz08XsWP
zhNecP;i&ksIhbQJ{qJh~br)`~7KP$3s~xdGuT}M?ROLxuE4QBF2epur{<x--hL?;O
zeJvj*tIFaf*T(l{RUXP?mlW-;o1mlbgKn@zph=bbMk);*QE3Q;lGn2#rpfP%?zStZ
zNU9Aq)2E`-X{D!xaxG*;n+4<b?iSUd6ury_-G+;jKbeJC7rEUD(0XNp#4f|vLq_61
z;;0q~c^}H~<?Gk9q0l^*7MqmTPN-3nTXvzO=d=UK9E=0Mq4lB6B#WTgVQhrZ8Zxae
zVrUyBA<@6ME0Wm#Sfx@SW7B@*-gj!UPXJZens-nwh<g$}6UTYHWJ`pnHWK0#3HpkM
zGum3K`t#qsQOzk&68JRVMeK0w>f=_Zr1|J0!UywZfByol#^FqG>zVDS{1J!8fqr6Y
z%3p=o)qXo#H^>K8L7`qS3|9X=?RS*Fb`O7Sz^r?SZtV6PxmEZOORwWbQjO}HsHb^*
ziz>bkF(7r2W>v<gFw9CtNg|#wrCRt{6w_8KiIh}M;Bn?tUGea^rX=aIygYUu&72rx
z<&IjC2k$#NJ4Ia$fyVRZd{Xk-)b#mmIQC!|hSFQ|^(86CaJQ{_7P@-&S<7mFDLS0J
z(D@Gh5zybE^3n}D7q2&a4=5WSpj75R;}pJ#F3%U=x~6*la$MZ{n-r)j&Ec!#@)1Ga
z7j(bYwa58ueL>bKSJPSH02aw0L^0FZXa6-%r^YW>_I0WV^nJpkDHsjdbXw|6KJ|^$
z!#eS}>sZ#Pt?oQNd*}V+(}a4A76u^?e#@^PpX=*Ct*H@+tx(N(ZSWRr@|dU^F@T)5
zvk(gIeR)c+RhHYmUbp`0f32fZ7^Ht7pTosXv%=JUw6N`*pkKC{rn+gXOy`e&5rqdF
zrhR;U=F7UC0)iZ+)ceX94u}G187vD=B5r`=tX0B%a-w$|HaloOh!Me-b6;M5^?Cx%
z<{APw`*t7PC5`q$`s34+#HJwkyUhymi3vn>I!2pYTdp&Ks_K}VtC7~;q5ctcimr#K
zi>9`15vdk~exuh}QEk`B<0eSN`41WNtWcS*+I_~|a$30o__ypG#<v~Ft!Md&vTOW*
zVDm*9k=UF>>xuoteaABb9djUmwA4RkblSp^Jzho$2{<mdylTHna{nC*G|6mvz!SK4
zeS?FsaBhYabslY-5xy<I$_tn5se6n4hUiHev(AH7Ou2Vr!Natdn<j${%XC18ef_&{
z`QFB_Sl$>~DAFbHp-6O+{8CgEOOc~~mY^5HC;(<s<+^hSaNGs)J}IJ5YeZ2WIrlum
zUn&PcjM0*y`)K<*qTTwCoi4X+H>jrSHIn%7)x|kJ6ngHf$K<5w9sm<UM_rI=x#UHi
zN-+ZbEYSu(f(s<h<AarrKFYGEW<K*bLTM~?;k5q4n&|b2_;3>sba)udOxxzwG_TRo
zo0Qf;J{_*Y4PZOHV8&R!{0e-wD~&&jn&JU|0Q^7VTMq|vI;?xRq(OA^%kh|Xys2$>
zl69`iPAWr+(hFse`Hq7EO<eJroSxTw3@g117y5F4mWCR(5T441yXylm$hG}1E}N+*
z2v5xUPQpfvPl&P5{2_C2VAbw^Cqn3<0hVU&6U=ez2%rlMU5vwc*OZ^Fw!LCXod8h=
zx=2p<7Y6UDgbMuVWpSDL)ywi>2=ua)q#|V!C9~B0@u7aTk3`IG5Rc9T3!z#-w~7)~
z4MaEXN#w@NRA#-!?wTm*P&YUiZ+s2Yr9wwbOOi?JLD0R9DbFd;P!iDavKpuKwgS-p
zAWum-JqH}btdDZ`6V{=8d`@|qm?COjH#fWC+cq^`WlIE|$V=}dk3Idt)061R=QFr>
zT_m}`aXP)>*FT&VRsX3W__r9ogzk!2JFi0;9oqJ839B}{eK2`;qT^3QpnY#*TuY_E
zm0vHD`0YP|`Z9DKLAWVM#{HK=VRCwhb5`9*c4T2K9V>(Yg2Z$=jngk0BHTQ3X$_-F
z_r%9bQrqp%8t$hWYtDM~@P$)n+{rdOS!aP#4*y*LSq&RmW!-Y<*#KSNL7`CTsDWJU
z55OPV#K>qq7o&$<75^iJ0rAA;V6#U%nZ0-X<oeC#`t$<Q03L;U`HjIKr>WWuL;F_j
zpDjH|;--j**t^6MyRF!ToP2ztIHm~J4^q)Xcb6p6rjv#0-o9h>OBtWgzI@&J=vme~
z`qo+!p`@W)Wf9<SfwEw}+I{7oN13y;OMwIeCqeGMH&{woi&G*&y)72CT59?!BjHTK
zzYz16y9UTp<7Bw1MUlas0QFb*24w~Jg@lAy%veQZN_BKB!M&P?C1V%ff|ws4Pl=z_
zjm$yEzZDUst-8=FHEi%ShV_GKKd<4}#YbdD3Rnpbo{NW5lh2~%bW3&L*w{>tbpFK|
z*y#l?j=cFJOdCT3Fqb8patBgmHe0xs<jmB&;aMvF*sJ40wx0t+Cnkez85S~wyd(%8
z-P=4461W(v{l_WP(u5UE&%GP)4!9!Op6PsYEH9aK{yco4lh9$Y$IqbAuUIz!tnC0;
z7SP=rp`#Vnf&f~lkAPrWkOu<EWuE2&(CU9|6AHI=*4R^%+ty*+-o=Jb|Lg2@P~(U@
z)W<b}u5W06BYwrH_gGFb1k>-Ac-!nKdXbk9@yRO_=h@?){8Gy1=9ki&rRKx;Hn&uZ
zJgi#?pIQR4#h85ksA8(iXep4eF2u)fVNQr)gEx3nEiT|K&C4TP@#bu9qGI7c67P3;
z1saO(mHBPX$d!aGzz51>rSPK-8vRY(@Rysnw~y(T&JjOTcX)l%&~)P+<9DmUS|({9
zTh69=GUk?WU?l|HvLIX?<2G5kdgl@-V+Urm)=RBxkb*RwDQ)`vq~vzd7Hx1wEB{vb
zIqwdtyd467BRH?WD+0bi!(!h+jYG-g0g9CYufohe5AmtK@>9TI2L9BGF7v7n8~9L7
z0axPI`A`+s>vqrSlye9C4Tnc)ah2Fd97K}5bZcBMF+|1jN_jNvu%D{`JfTVZt!TpY
zVS}!i;JyAIOEBVY)h0e+tK2Pda(pA>S!QiEueiI)S$0w%S5UMwwd2aclu?M`olo{l
z^tQ6so%aJSq|@UbH?c-tm_crQe0!zcls4$?T$+nssX6r^1+TXT$kP_N3W~i~FbjA<
zCr$YkmS3X)Vk5iGRE$SmodF@f_b)N_zA~vebyGG`(j*oT+DjLmRSTB4fDmgjPkTAN
zsOGl!O=mjtQFrAZf!%o<$l_2bA%3?3jZ+k%U~<k4r`VyRh+4a^2|MSAvnjO%wy!t-
z65D5sH|c~7B)Y{hwT`GT-@RS35e5wI&~UiZ`px6O;8QZz_r=xKD=EUEeKcz>``wa1
zG7KatTzC~W$Fs~bmebzOjzy%VlCLI@T6Lx7<p3s}tMiBUI+YaltK0nTf9aSG_5mQr
zxdvB?1!n^R5KVqK$a9#Y35z{-6zkhH$1!r_KvnaG#;-UuLU%wb4olngj><Vew`NCl
z&)JnM-Hzgd`h0{Dvfo=={;;(2Xp(l@CM8MM(}r#8*YUcQd>wd(GOMts_feEiPO8Pb
zefhsC18D%A;^xR(^cw%2>VpiCB9$YmY%0W{{V~dCqQ7RWcfLngQn4$IWel5Z@iiIy
z?{jBxO|@Q1Qzd<$&iBI8PO$qmdExFKJ;vZ#+Nq(__|7`NV*85BCEHDp4f(O|^rPn{
zq{kT?-D7zIj<rp-fKk`hVoRJmH|ZzJWqra%+ag=V^LM9Kr}D#)2ETs^LEW3J4{sVW
z|2}XQvl!0Kd)W>^F9{LRMoL>vGO*8!I4C#yn|%4bU4Re}un>LN*`7LlbyiI<?%6~D
z9=|hbY?WLSk{pFYGlxYy`V!N{<`4y1NTWe3%~g7@B$Gcd0g&-4;GF)7{<ncz=SFN&
z%ryx(!JE}5;Jd&TN(%Q9`3b!?Y!Ux99XnFyVAo8L>hr}$Fp#>d>`fUm&dk5s=;+JU
zHS0(%HZHCwa(_q6e<!>EB%%OxPt5%2qvA{^Ln2%{ZzhxG&}Y?u{~OQqol73y5%yNX
z^`SZlixIfj;0QRH4_qEgvoxC}a^y$J!NKJUn;Pt2N~1)4{_&CY0rm^BmPfoK+=}e~
zgx%vWb4hQRE!AN#tLV}%Zw68+6jeH8M~V|V_>VK}Z99DFgcFB{gW#nZ-_{4m(wH^d
z-(8XMIbQ=|Idz)=MF!BtzPV{Qte#oglB2i;CeG{Wq4={Vp*u7+#XvD*?m$(l;BtSF
zC*t2&B<OEQcBR;R;Fn2to@KWqf}3dZ>+TcJ;gpp)Ny{9UZ6}fALSG-xBexru%{cw<
z3E~G3VUv1W2>+2<g4Yq<Nx}`ljmGJFyN4h5>yZX5mq)zwjpc3F9#)0^@p7=&#ooUS
zvJdA+YkzEO)93Jp24lGjOxMXj$g;HoB`7J}|IL@aU_3kgDS{HNhgkjb;b36={|iU2
z`e2p0|KlBYlcy7E&maBiL%uO2Yr**aY`r}>XlT{<>=84!@ZLgwxGhrP!g;v)Kz3Nn
zUQR^L3DHEEIUf<RKNjhvRNLDC3o7?G5ZH&2ssxmj0m_VxrEdEXz<Ag22O12}^^y)?
z!%{ri&M1RIq2N9mCyxtn`{_)ufc>qMy1r=+myKx^5uH!V!$qNohL4}fb{C%>3=>4j
z?(7{x<&_6=UtUfw!n(is@Nd(T@vH=3@cX#3x@E8Wb8n`fCEvY;o)-BHDy%w_Zf+Tw
zAds+Gx+53_PhLhbi3sqIuaEQ8+cN7;&d<$l{HtcFFf0q28!-zDyJ%$cGq#Tp)vKLY
z4EBMf@i^XzwjM`_E{XW6DCMg$QyFEF3qjUbG@k>zU#)f=QE~~i_0WO>b%~wC5Pgfz
z-!A3`8U00dVR+VCmmgN_EhtY5j{S%Rj;IaW-9<iBn6Hza9gmG(>^((=MBc%2OQ~lQ
zRiXCgiI1169P+}eseM6P2X*5;>DX8)dL>#Yz!Dd5TW6|v?_K{~`&fFy{#LV`vd>Y#
z@pNN25FX?gtb5o{(!IU6jt`x}sL98o{|G^n$FIrqB#8fUs_%WX4GC;9I~xp#&I6m3
zrMf`ov-Z*svXakJ?%YM-+9T*lZ(*l0GNL-zcbS_vX3@kUB$<>JWB~pAzya8|beNL{
z4vXkxxFj{)r2BoPofu3xJ*)fbjT<4jha1haxH`^W82*9BEOizsmpYP#n(Dbxz_=vj
zx*nx^W8}jhnf5=6<;>Ia#1I_82l#E@3%65FE#OMevVjl3l-7@y#MD$yV9-z)(FYuZ
z)<x>y<&_reuAh}!hfWM)p`>z~uOEQjKRKB+yE<GD-^q^hJgHQ*M6zffj3EGjdK@Vy
z1&WFd=kcI?;s0K<TCy-NvKFo12jyRfu%T7%4Ij$;EYKrn=H`S?l4p@x3Iy!I_IuwX
z*${pN7eW1567=(LE`atKoyubEwrG+@8o=GXG2U}T(rJ{oOjKXSlnoG|a^1l=MV5T!
zhY0CCGzsIlI#T<`(xCsSd;QAX7gZmQ;r`%y02)8mK)Tz3YdG{y)ZNr}eX`NZD>9?i
zE$}#&eFZd1)cX_*x!8jJvQrsKYua9)%7HZFY&LAASL{;U(;)`BUUN2F_N3@(d=n$M
zVVNacloeU^AwmHUx_NpHho69dy_qzU5PhWh|2d@3+YBkAEgQAGPpa$|>OVYxd30O@
z$^)0s_jlGNk^<CgOP*mHR)L~&43MKHvB(lL<-7y8ok5z-OS23P@s{d8g|;9*1}}Z>
zJw=a;t*V~;bI)AP@vecE;}ZK?U^_XhsVM@Z+<w~})Y^)g!%q&(Pl061ED2JP&r?a^
z7!p{TZY-FnD$CeR?@H7>IaqlT#exr2kd}6;QW5`75lS%*2=Pb!j%Uz{|8&OuDbAAd
zz2C|B3&sbb>_UxY12c-|!{r!qYpqgHDMaqf0|COM!696H?5)16-13vE^#WrzpO!4d
z_;u7B!sj(TzuYP`Vbq^Y9C-8Sfww^|@aT(h6z`OCtGSJ>?a@ln@iN<a(BNe={z2Ho
zBX})P8L-n{vEz|L9~C*Ta&6Wa*gQ$dx?j0v{LzZ8`Px)BFqor`YNQrp-~7@q_dcA@
zwS@CFr&JwXt>tw*a*ms3dM4qmerb??Aa-r75G*^!@&1C&65$fuD3;4&FM$C6_H6`^
zn@bX2>FK86UdvU?0({(EVPIxojD@1y`rnBjAMBWe3n*|)&GYT)cUZW%&hDy!zr7Gv
zl$Y}VoaQpEJfq*G!3vuJp7X8dh&oR?s9ldUhzCJ_IKKZoy6r?ZqebAZDdDmgslDW^
z&{kBE)<bgcg6oFd)+b>fO}U(aLAPEvC8jN8`1CjCgYYj4R9(PRiWX{6ZEm^EU@URF
zgN@&XIS#WF=jInCqv9O}Yb=b-evWTvwU+$_(wr@9%S?00N?W5KQd#!dK+nl+c_vA%
z5APfMOTcZQt;N_?^^zy7SVgh>Q>SZJu3k07rH-4MQ6#5X=rwvH1D|WpqE*qp@>Aq}
zF=Tym!&R)NHKeoc-(*~usFhJ*Q@I|QjZ5Q{QWv3us~7g}aqelqtnbb;HVJ_SI}=k^
z$ZntR?wTd&P}3;V2?SB9(3LH3Ee``;P2HyCOHdx>X|Y-ksm{z*OPtkc%`CPDwaKS(
zujHs4mX*d}GYq1bVey0Tg><XFw|C54cAEn7^`}3Ruh)+Gch)#s`T}i{?77B?_k38g
zchjwXD?q>+OZ@8SLY`{3p8q(!vKq9n6k{t;h3x!REw{AJ4RYxuLgZo%!Gfw39_1T9
z^^9_v6<62+5q{x}$x@@24CIBdwXQ;cG$?4t47^iruS=uWRngHmTh0f~M+T;5S!s|B
z%?ih?^p1cx&XGowA7K72&Yc})<}*vTMQ|xHbCul@gW)pp(_<FJ+R2Z<oSh37N233N
z7wI+_m64GD8=bAMG@3MhKsW$z@~bJN`(6jT$&jL!S&P4IY%=$3qZcE2-58RrIw#E(
z+3Ka(^TB#bK}4sc)vBP~T+d2nE9p+2ZZG9z&HWkk2Tp6%7}#yamw<=42`&ZV2h^HV
zm5s-2@<UjPnp1XY1w{}07R4zwdK+H0XGpXh{Kow&g)htqi@NS-OBa91gDfwsX32V1
z=+*^I0}P;L1MNwm@%k>5XG)xop0b(*XDA|r3Q`ArGww+_SFi${=EgNgwgQdx*IiT@
z9E{07ukfFhW4(b;NB-$rc#BgTPR3tQ5PEYg81?qMws0OrNMXH-VpN}An|KK>zpVfU
z(h_2or}7k1QHDtmVVM}{<v`u#0N0cs*Yb*Dc66Fe+8OLH#8K99Q%7%b%Dq$0^8seF
z;yaIH0zRjce!XpNhMc*kh%A9jE)?Sn)%A09!c6G~oAMW)UGB4rpeA4O|1YGlwO;zF
z+Fa#e4k!Tf<7+01&6(iK;%nNhQZ*Q&)J%NfmY(RjzO@N|#LWY5BTU(ooK_!^WFb%K
znWkXU#@%l=CbARV3H!C%w6(mT<9$8nBXCdj%8ZN!PcDDkGDSwSB;O_?x_R@<>WpHl
zY%+?m1lgZ9O?p;QMS5L}ikeJPSQ#xN-hRp9wl}lzIp%Y+yk4`a`@Ect$`D3pnb?zZ
zzraBKM$jy_WJ33&Y4AVpv!v|O1FMzCt%x62A7lxkbR|kTxUplDx{}mfpjz;nx1*Ro
zpr-Unq`i};1v1CbE1+gxfJXE<U*e1%iVg%%6Y5@|ieikFmcMCPw%wE$>Qs;(MW|j2
z*izr{o9xcg2X@G10WvCDO3<8$XU>18K-{k?)#Q)Fl1*|u*#tS4v^w88;ki-A8x>vx
z{t(V0y)u1oK4{eh*Zf*%=J=#wel<|s66w~GP$-LbRm4FK6!<cJTt&J<S)fs77E9NC
zXMH#XTwE+r>8t?WonqFBNEL^<u|jwpXP%Tlus8Y(G&Q4g*uk}hg|$V4)#YXBy8AwG
z-O!0@T$o!~gK^t#yQB2R25G4UzNDa*V3_y)WO=zF)uc4FL%=T=4fnqKD*M32decws
zL{PMU7)rvFcj8#}zKsS`LS#+b<Z;=r1PZ*4L;A3b7Jv&J0#0juB9k|}00-~(qcaeq
z|0FmT5y26N52csbxDNi5#JlK~VfMS6Eu@XA<8}%IEF-oqkGB_+p)|5V`^US9=(%4#
zPutT!9v?U)a4ZpXwYOBOD6|JMlHS@_esjxx1mT?Qw&`g(%Aqm<k;8{d4iso=pCAQR
zAEMBNw)1~CKLBJSUn0)~odFJu--^ll-~CEh|E<p16K74m2lz|3Ie00)RUD$5B?E2)
z+}5bDqEvU<sV20=?m~oTdmL<}=nC8JEuY>2tx10@$#cpX_PoRF&O4C0<VT)#1^BIa
zubMpiGg-`r3kh!D#v>vkbJ3GjD$;pvfX(Hc1kY8@%RIXtJVQ)K_$ffZbhuD7kYEr4
zV>8Xw5$Vj~lMKJqdUli*xLZSZug@&@_5y>0&h_f`e11pdLr22#JpysS_0O6OPIL9x
z<_ja?;84?u$dmx<R3eeDB4RROc>IEb0mu*GG(sMkYzz!A5GR|we;x2gkfz7n&u%`J
z31*yI>R&;R#lil?E`Q!!6Zw8~Z30|ezO_MLIrpO$*?59w*>V`D<T+fQVpK5rj^RUc
zvZ|F83K$Y!zjmroTW8~CJ|cvQOxD$aJKVS|N$D-V|AD(Ez3~#?5X@y@=*{krcrskN
z;r5c-n9Gp!cf$XyTJJW87VxBIH{kBCfw3v_O;v5}x;vj`2E6`_8PjXHLD#OCFR!k)
z!fQtL*iALeU;la2?)8K?_a-~W^3MGKVed`jq3qkZ@%F9=6;hT^NwQ@pTa<*5eK%#_
zh3s2V$dY|u%Wg2nF2+>$Ewb;jZ-Z<z7{mWJv|M%H_y6;}dEPy}s?RiYp6Bm8*6;B>
zj>8;9LZhirT@`<ov{3MGP^K|IGD&2%J9`6*DFPMO^dv$JjbCUrsrFIJKdM5obK6S*
z<3Gjf-IivWH{IMcAm8HR>|9WZ16_#&TMi47t30BqDZ19x^}1aD<!XOGKxgt_l(HW}
z+5m6?#469jDpCQ5f?SgJ?7~7q<Yrb3c)0&Y`kcW(+UI^z#zIXPAoe^__&1~M_X9Yb
z6gn>&{`Q<fJRX-RI!OBcJc)yxxt2EOH$goVH1?f1;nbHq54s92ML|>-D^H!erp?`h
z{-XyF8|Y<#nqEXW+wleB?B2H|{7Fv&!4Lq}F8+Rr{p9Bg-LnPpF!@;zV)_xkzX(V}
z*4Me7e*Sivq|nwDU8HsXU&w7%3s>Yp=brK17iEAq37Vc;kOa9GwO-$Wbb=hJA&6>f
zc2=U~XUObiznx?9_3FZ-iosIL&mvWfM9;0$)-3I+!}=a~lu&2_)(uEeQzijV@4(Y2
z6|kPP><5`YP`?RxYH6hjm4}v~sxJJT8{(Y)>1!&JPZf!8S9T15Lf#AgO2ejBX|Mxa
zb65Wv$dIdT??4^6bTroPA2EWz2{|^`i^lKkrM^C{li^@i>xu5z`QW$`Lf=kRbRs;o
zokY5wKFk=ZRki~(XMr<}4Eh)fSVcgGVsv)b+Yw3`XK}zNf>h)U7*5azk=~C#h^C)*
zJv1%VNW2zO<>Qr)c=j8{;F%KmeqiH2m6E-G3iQHtA1AWlmQ)K38GKNmM9H2kVSF+W
zF+x{;OuUrtP~JFJ4W4yeTWEWQ68{71@_Oi#P=#r=vWC%YHub(aY=8}2wFlK9P+QGY
z%A~}8+4Uhx4!0yebH<`)A)Dkg7(!D3oY=j4=7l5$vI+cCBaW`{3Vd&tqa%asqj_Q1
zYSXVE7}?<g(;h}kS;aJkczJ!OLC0RPjrG^-k<QbRr^>8Fcm4?->^CnJ<3yKPEdjb$
z3TMO~$dWlYMl@c6su#e-_g6e){Z+E!?>|uHV1YaJFfnlf#0pf-bq39v`k_z;`;}3L
z&4tS>tRsA?E5gm0VZ}p>J<zWeb~4Qh#TwNOcxscSAT*qsNu{OJUq3TTOtW(4;^nUE
zujjUMlEWHXwH4oqYdBCdoGGoN8)o&XI+|&srX;65e7ZBg+S$%=d(8^7!c2R#!y?Ry
ze63WcVof*@L36GAm^km%!(%<5?)`P38K1n$-uJm(!n(7N;t`j?1lH|zcWe~pnpIiY
z%PJ=u^TSLfHQ^*-J+GN^KxA487v%X&s|(0}BR~`@X!{)XWi~<J+L#NJlwl7$Mq@yi
zeL;GER+K8+K<<maXNlW3nJHpI5M9L^Qn9(d4v+`}=QYsRS=b8vuE~JtUcbK6jwey)
zE$;aH%N+dtcQsR;dRW$h0f@K}-8h_KR1$&y{tQ3XBA2%Up^QS<FB-|r;8|8I^kb}R
z!WpKho(4IE<67Xj;5$L4VcI`ZEhbLWp7ZBno%C}9T!C(a*zZLzk*uf2tty^9B~+2X
zhIbYj1%-%Gi@9P!uXpG5aHH_EpH(hBYtZEbA$CZR-(j)$Kk!ok#4rh`PnPGAG91Pm
zT17^xL#47)0@>L`gC(wS(wm9|?p#FLo0rkI(@B**kcndXq$_FNlQTY8vKo;ELDqjs
z+)q0p8#d$yr0Wqt9}2W;i?=|5nki4h0_AKOvfMvbjevpq9R|DVv0~m=ky{h`IR&<c
z@-t7Sp&b^T&5_AHx%2FK3RMfh-qQ${K8c;0jUDRFjdCEg%-+ba9@f2u9tH5+&W<WI
zXWCGX3Yfk@d@AyC6gnmYu0|^;L1eKMr&YVammy_~+tObH)Vl6%U|G1>wfWgta<j|I
z7}wENmK^^$5-u$O%8$mEAgW5hKI4tz)rd2g;E^gII39?wItOAJs`H0_FlO4IgPQ$5
z#~mD8Kf6AdD0K_)#nT{y_K9GAMbR;!aw+B;-^YXZMf39S-{vF&Jm8V0KXTS{P2GDF
zZAY_dAJ!+~vyBX1->KZjBzW=X)6$00kuISX84NNvKy>|H-Rl^A_UC9wJ|iqds=6FN
zq3!10LRR#Q`-A4exLbxkuTJFa3g2rEg^3s8qh*GbOb;@MT~EY7x{P_0RCueUnJQ>m
z)d8d5dNpgh(2BRNEeYF3g2beu_IW0v!43BLtW3aTDMw60eUkLW#(s0F(Dxo<;RHFL
z5Z*yaw0m$eG_`!ApijQIjL&LUTsQcxm&&ClD0}a31pf^9{Vq|jR|t+e(G%3LNZ|-#
z54h!Ahd6LkaSMc_lO^|n68#@Xk&DHwttBJQBW7ykOXbo40~s)kplZm>b6&z<WL0N(
zHqWA`c&WPG_jWmgsP=JFrNt2jA&pptali_ci`#gsOfNwZcC@8c`@L?$ecniE>F~JV
z3Fr`A9joKYmFrkcu;+cLfX6ITAV#@D`#9IDFD)y}0oZvq9hVIj97x;~g#;eBkcz?0
znm1OnKPK5jN?D>RWOYmI7geK^E>ZNifJzd)?=*0cYFUrb!xbxM<yS7&T}kCc0-96^
zhTsktdI4|7_HI_Y7*h^huejL}X~iOS$Ib}Xn@8CH&>m1#Q$O-EFDmr2^k4jRpq7?o
zu4Ew2z<?2DYXbo!wx+yIblR`QdU-FoVjny^$*miQc}RF2eK}Cvt!mu)+|LN?uR>gL
zMp+*<du<A5Ygl)$CTr5bOpnH|2s#2ZG^w2lKP2=s{t-2cUB4$ST$)xti;$_SmIGlk
z+eduCoj?*$NI(b5z&Gc`zV>%>UbedKo7wQ*G>Plp_rbgd(6#J0d;$#oEY~RdQ0&x`
zBhnfFoxq$A&;md^&%2WEr`o$Lj@Pl`dxSUh)GG>&0qT<8S3%_L5nom2_Kas6n7-$L
z$_obQWb^ua9y`t)Od}W~oS9bv#Lbx7S{KvC2cZ?+vupx#D`+zj(iE<*uK9$W&vNIz
z!%|LhySMl8G|zy>q1=9bkctxm+>E@34fwIkuHL=y@IJac9lL-)i!kjt_Tpp_ga}J6
z)6(vXBP)R6H``8IvvzXmYCmfP9YiND&KfkMXUO4vHxk5ERj*DrGC%FK2%|@WAf)D-
zGdgICpnU7Q_y@E=gF`OH&{OtWLz;7Nw^Ng-w?aoSpAgBfoaP5J&Y|j{r5-3iCkcs^
z3x8Y6W@S3)ez<^h0<?b}Mo<hoXsVjWun1MfR$aIjgqZn2SNS*a?L10GL&IS?_{_d~
z(|)?y!8Wkd9Q{~~0WpdM6xX#S7GXd~=q%VaB3tes;`3tuw(AXvz;SyC7jfUVO#4<z
z2gJs-ESQQf3uN<caXpbf4jru#o~OJqt3I<o@!ntHK4$y?+<&yND$f0*o1rowUt{(V
z*tck;lBfqPLrRhRML*g?{+6Qk-8nGyNewzP1R%@L2vVyv>6z_c-9)H49~`DP%4Jse
zg_<at69y6ej%%%KcZ}zzO#7A@&^hAKY<Z>#AZ7|=lfURmz#Z+a3Qwg5R$-R-+v1C>
zT+@i<MW&uD4H9!YfzG>0!)8(Mr{C}@aq*W*fH@n?*MlhD&qIkc50pT)FE+d=nKS!H
z<=8U5B8y&4g)DqNm3Pp%llT|r703amxtYA1WBMJee<ClKnj&6X@v2>pdG8z^<ro~{
zAV~Gh3-r-5TWk>9XH0NiI`yT2D#`daIJrjS3f_HO^&mben~1fvPXxqMO;D_r1?s{N
z_y<M|j~4#x4IH%B{EBbyKRcOwCo^;REsk+0Bg?vzU^%qYDq0s#Ok!PXHDb~BsLuHI
z*^|3YHS0e@NRYCentV_<8$_Xqo|o?moi@Vv-CS(9fG(z~;L-f;!ovw7P{OgQ?Kw9k
z7{1wJ`HxB_`&&?@<qY^;DfME0vi6l>I#YO$t<f(id8>Z&@sPkLVa36vu1utPBlflt
z2$uTQF>$eL?N2W8(^@+v)%{O&&FGCm+G-8C8F=mUZ(q}|5H6|YDC=QJxEXp<HQsTD
zRn6RceGE{cwmuyXuYVubmoiZ5R#$Cgcynu_v}4N+gjJx(`QjH}-#FGQilX@P>n(y9
z?}evZ$FfscTh)HQyjAjNxHq*s>tnXDo!RGSZ{&Tu!nFP!fVltzkPvZ7x}&sr`RwSw
zUf!0$3p&9+2{d$J1GLI&toCq81`N9)JHS>VxMg={1WW<vbKWW{<2qlu#?yB}!mLg!
zqx2FPcO>bYiQ+6tW%hWWUTk}<RLL-pZ9{J;bRD3@M9#!+fak{o=~xrzPECOv^@e)}
z;u-v2%qed=g--HtO(%aU=xCrqY5riPOf-E<QR>zr_|JmWz?SG8bZCGvDwgmnh_Xw8
zNdyy~=Y}iN=~r+{fZPr^f$H#Tcfp4%$>`;gYB6uRTh!-Qb2h$Y@4R)FZf>RI$pJ>z
z5nvN$`ttGXVDuZPf{_sAHF-U?r+N_N65tP78uvkcxuE@>5>=y7d!pb1X3SAhC0C9!
zK~7#|Dd{i?Q9g5WNYKG8Jxk1N2&5sPHC6cf^#T=WrpQvhN!a*2OhYOFDl=#_IlTi?
zsRa^yV<Wcg$M0BF*xJd8hv|mT_*Ctm{wkK4P+m@w=KTdr5Mvas-Zt5Qlr@%n9FqLp
zSlJHB!<Bw<d0?H$5)?yz<SZ}SdW2kg$|NrQTV1#nh&A6n<m&o9#dRqP>*THTgJjF%
z$ayy;((o@XEP)vcUyMZEoUaesH(s&$=9-JyhupvVwLtb#+(^YxKMRIX;6~FwZ$R&1
zCULrEv#gv+qx*AP*Rc1mgWyb<3P_y5-k144`p7$)ucZ}3r?FV%QYy5?-WY{VTpC>8
zb`nN!xrvS~?r0~kwArr@+q=WsiB&G$+1MMeIsI_FJ3A3fmhM=-1iBeqb8bKV+!1>1
z^!(6Q0*HG_wpmZJSvjY|4H>xFsm=M!%VJ_L6$?<_d)=${$Y5Ru`148qhEl(~)%$z#
zNmc9ZoI&qSx{ncGc@!S!yq**sgm8N5RUwlkBU#ibXbGRI5&_K%vBFq^d+96>cX{bj
znvavz21J^?H}A6xo{SF(FH(pDb3+NO`!?p^4Eip^FQ05Jlu4?JGH!KxK=58>ZO?PP
z&8S7qQe%D_;XCG0sd6#LV}(U0>`Ib=-MgWvG2M0ZuMNvLTdXYYkH9fEh_&u2-q$Nz
zyCm9jY%-GFdzvKtEG8dxck5&m6k38gD-pNMqwVLpTsFQ*(k^8;&(9Yb=<H#TO5OJc
z(5%{9d_CoZ*9KWXsOG&GvW6)X8Ql%OvQ%Q3Wzlkh6x*VtI96`c=ufUx{JNQ?(+e$=
zv%Q`iJ*{bFEEOvIE)R4&d{aUxe_H!zZ2aMjbR8JU=?EY|ka8iS*poq5i`AyGgM;mp
zC*<d=K!P{d;FQE=tQ^lPt6BEeKk#hiB&oZgCOwb6CTNiFQF^Z)r3XvQV}(=?!;nTA
z=ub}o{<9fnRb|$*0cL(erCE*mbSrFKGUZs6gJLWP3Jtq0^V)Pc1C7!h2j7o5-%~nG
zoZGR-qwiM^cdK1pWu3mMP=U~C7k+E)<u-Tb%#w0jQ@G%Up0xl$j81f#;ZpLowUb&1
zmyBs>Y3|1E=)G8|W{KA1#CsKSaj$MB_ZDl|cF7!8-!a0ltn|){epgaoRywAua4qM+
zWW$$CThX7EeWe_bv|MA+qai_5vk&ffs~E0+7hE>U%AXIZHxyeK8_ij5VbkPoct6KC
zroFe1Lr$+f>qxP}40k=SWWX%DLtQp=3RioKOb5BOFXmk-H6tgdp?TR)0V5mK1Z;AV
zIyrKd;O{hV4f2&y>E9=VD{Ei-oSmnk)>a}F2u<GD&;Vn|%`#6E7DoB_^s4SKb~(<S
zGdGbW#bTEiQ<5%>6q32BT+4nuexp+4(pjZ=iHwc)%DH;ZY4QsAhU|6Ko=d~(@iO*J
zx8ov5O^K9T{B>uEWTzRQKDF;&eRpth;?m9C%OiPpd;SlOa{1xnc-Xb7&03_}SA-)l
zN*B#c29}4+Jy>@tP;U!Sy{f0rxmr&YoZK)iw*SaBh~p&`h%$CZI59pNux-+$p`gg~
zNM&FKL#ZIPYiZh8L4(0Oq5Ag1kNlpO*SLlgf#?dIJm<Q3Jjc3vfMq%+W~Y!@g%NGY
zr3_Vl5%+*6sa=BPO2YS!dzdQ%YhPsfMzZ2mVg((aD=WwF2AH@ZJt#zQfWX3MJ^HZO
z&wW+;zsTp@*G=2jnWoBGdE(n5`@1@usMgr_`;wB%d72u6$rT<rsI7KpGl|eSYeqD%
z4N`Aedp4(JqOMO%qFAwX$8vQ9EpI=HooQj`b6WH0%NthDh?sn2&r|7?y~gKGs5v%8
zo_*X};A-dcd6VU^+0L)I)Cr{~4!X&Sf)q3&307IV8(o32@iW=+<L<kwang}iU%pg7
z>sait^W~#wG)}ELVb8QzY%0H4H)>0EyM@hpO*2VE`0F}0eQSa+3N~2Sx$a7mzQ1PJ
zwHHq(`Q-{0FQFzR!e~hi2Xp9gKLnpm|FIqJFMJ{0W7b^)gQD$K7b=UYclJ9?6?nd|
z*HRDEH(lM}xf*m8edS-r?{>L%YVixIXu7MLw!NC&Gu>hy?I8LnY^l+*Oa-b_`QbW$
zc?K`euuix0gMIhfbT}A6XN=n^lff<!7b|55ZO@91rSh=3-uIPQtn=90osH))4@nY%
zig`c5DH2nw+u%0)W@kp~?i+<J%`BDmg}i=C$>a1TLBY=*F7wx0s&|udGlo-)n-24*
zDWtmCe!T6m3n?*{Pw3YK-E&WCcFcHeztc5b!K=5mo}Q;5JQ~QTvOrGg@fZr-Eg6s6
z(Lxf%e+Z$ZmoMimPh_-R4V_E}qU65wTw0p){jhqWe#86zexLK_?b8!M*8-(x$4*oz
zhm4s)p~Dhe#eTxO16ywUZ1DYnvpb7t$6gcT<u!#<Cr>u7=1@DE9jCstF+46C;zd2>
z>(gsBz-c>C+fV|%fO>GW2o=T%GZfeWO@D9?bq>4@&)$57S+2{|)G0p>dHC=#OqWI&
zJ*L~z_rC5A3*OWcTjXVoW=ei8UxUPykqO9;o@O6Y*047`*<X$0QRwm^T9n#bPgXHI
z*5b;#(06oQmSPh#RGfhOAY(0QT0K6+o}pz!spmW-)lyVFiXhGK?jIVV@3NZa@Q6BD
zKi=}J!ONG=ea-iZjD}fjcy^3u%<~>&6oY=f5U0UIYlYSQ?c^(K1$MKl`+JW57F)Wm
zmbr0v$F>Y9gsn$U!XZU7hQ@Hf+bL-mS~reW=XD$NMAE?79hizsK&PRbf8s6mE8~LH
zP3Np7MB~USEQ+y&EV@Fv*psd{v?p8t{iq*JD~*(6BW^qOd`DVRGJ0Ca4|a7fO)sfn
zZfjM$*}f*=%O(`ckaIWt_#*%CVcq-Px+HKoURGnIoTH$03zeMasJ{|zi|3nx#7&;v
z{0utB&(F`f2Dj00E~#FbG}d@RU41r^(LvB29lY=O5dXZF-{Wp))9E3d*8zOH$Z!L#
zW{s_V6WkuRnOo&MF$%6zzjRU9<T2lyR;_$(4IByW+31Ou6SN*Nw_amc_QM%hxHvtv
z9xBNFC96J89A@0icETLS8*`sPeabdu;N8944+6?otA9WC2QC*9&Fx2>u2Q#xjROmX
zq?oN?oI}?nN3++kM68a>+TA%lb%Y5lD<xT&r?Xf~%`YB_%MKAyd<n%><e4H4Wr-W=
z;Bo!j#g<>qv!J6K8;cL!kj)n7)H(pTNy1r1hQdYR(Pe7ag@C&5O!wsLz<ghwX!3>1
zrcfeL@25#)`Bpx+txu&!`;rJhw+23UldrvN*(<eHmjDbQ`-g`^4}wxOF$bjfEiyrs
z0-?{2{9#S<`Nxk?ZJ7IyC`646E*#NYk)<wuF%3a+8g=o@q8KgX4V=SNv1wq4nLUr$
z7Sz^ghHAlw$N{7Id`rN8&m-QUXmPf%ay)HYH9?IMGJK{>1I4-$V)`Ru`EJ-aYmHj+
zh*6&I9A9==(al|0zlIJgFE`oja*<C;1_R*bDzDV8SAGy=*(n{$kwWY)eN9Cay33F5
z6DGOjK-%Jtb|!<jiol^|c21SF992Gt)r%I_0-Z%4GyAi>rq5T`gr23Z)q)E)7iwwI
z+(jYY)Lgvn<{%2Tx4aq3P)|y;zvx=&%6ez3K++K@TRE_4r!o4hb4@j2M}5?xb2%4A
zvGN~B?zHBp<|gj{kiaqz)Sr^|G6|w2x4uYnzB&i1{X^V)_BAN^r>lLtl4vTOcLTJ*
za3BGxMHV#ve7-*oUdEpf6>89}Myf^2W<h_O$`#ma-Kzgk;JXk1@@LGFoP+NY=@aji
zbi6&wFx$QYRhk8~h`pytiW24xg<|VEtE~E$Y_@Mb@GjMM`82t>`i`dlWof|pIh?dz
zx-d)Azs_U*;^Rjm4tw7|i%Pks1G7>!ZlK^-p--%5?dbccGO}Sy<Km@R_8LRG#32r(
zfue!ZUoyfGY;VjroH+8Zz9mYw_tdFqivdmuHZjGJTcOzEcCsF9pT}fR(z~~TqFVEx
z$$PG-hL@!>M@f3zRv%RGIQ-jp=?-as#qqZBC9quOa71M$bArl><3hJMu4c0ud#ADJ
z^5r7x<)6Z%WPm*TO5600cR(!3`F>T@!Tm9<AY9E06JYvnipv<iwXL%Ay+)ZwV}DO4
zER2nK)=Gf4Xgko|YymLc?&N7n22o*RG*B=uq6CXeHX2k!nns>$P1R;-QpQqgSa<Ao
zUn{qLoWs(^KD|M{J(0(|K(%DBvhhBA=DknWXSQ<`lg)WViW@wrO<LHpqaaS>>}zNc
z4)!cdARLw~1Ujv{vvjd&&%i}1;1W94gyC-1tPmL~zdw{}yUG3=)rNK9NVEPf3*n=q
z;OWQ`|4SgqdRp$vUztt4S|N4(03AMN!RIpz+`;`R>HYDNFM5-Y_dW35+g*38gR0<i
zHQI@(onUbv-%&;B?Jt#SNm%uaB!Ue<i7XqfmnWIbTgLJ)e%|W16*YNR%b_W}Z!Pe0
z`@`|?<IkO8)!RlzF704gV|epn-t+9!Ys2(e%#}d|W7JCCc1c7?KaJr)ULG+WdbIW_
z;Y0t2s6%^PwPskb+ZKtEG3y}+X$A*An0QRsdEbaltF*P?DaHOGs;RPm{HvsEj;+fM
zi-t4U#6!0ExO9?`Vo$cDx7f7YK`a_|7Uf|bwLiVU2x@PNgkiE3AA*pmE7Fm-(wi4<
z@#Ai~0AHq9W)(D80&NLw7siC_oO!d|e5a=4$buJHOIZM!(CgA(&=oHaS322p&CT~(
zEHk-l%ggYhqVPxsFb6vWIKM%bD19!fT9Ka#iC%D&p7kaEfm9{K8j}vtkAzPa$fo>E
zu;@PJ^m}|Pb-J2as!P4VT9FF`ewBlmSEx?jgQ~whZrR6Rs)3~lta5X<XI7J2>CS$g
z)6~`$rH@p~bkJ0F@mP5`;;Oej8V3oe7G-<;hZv;!)gJoojBk)rm1Ekbf_XZXy3tD+
zXb9M<m0Yp@<<eIp%Od<hI6uD+ISDcS`)>s)bC}E1cuX~L$y%D>?s>d-6N~z1?J9QO
zh;BV;BI1kKTWcX2RGN9ZUHk^SS*hi)v@pX~IGKF=X%<RwlQhQos~*N7)GM>27j#m6
zXL87S;{0mm*>$^gy%qRnevK+NVRzM*s8BF$TY<+xpDVs@52#~SX6<#>I^7<p=VecO
zl{G{ui>HG4bWy-Ox88JD;`uTX()WIO0@Z}o$hzQaV-%`l`A&@n5=fG#CqP`Rb5;*&
z)Yj4o-P(%Ed0^*skW&=9$)iTK*3CIu=X!q&(|yaMBwu1~B%fo73zcuMJ&b9dI?gqX
zJ#&mgR;+0+6qk*<1jH2GY8kZw+F0n`jeg4svrtC@k&V#TTWG0PN~DjLHOtdHs%aiT
z5ljL^NHBQU4>4=o!t;nlP}EW{7||aP4q6#|*P`-_g82IS5jtt#w(E_e^>;guAG!Or
z{$GjM(kZzlf%VwAIlmkgX7kxosCpw_Kb#uGl7N6fc^?NUyv_t{9xdLE42Cn#cKRMY
z{=rONRHu|`?N+x`fMLrGW_Waz;e4Dx%hNZv=Irw7eO2Mqrw0#UfJ}M$ja?6>YU-qH
z=yH$3#BfDw4}yf1Ss01I+YMLiHkgF#-0~l%BlR`d`RA$Jya91EN@h*Y*mFX=Z)^1#
zq3#{ZkmDH670ee^Mxc&^`33Z@CkGJoFk|zPJ7(K!O<;I$kq2%lUCh2^fJrH7cRhLK
zt0oo%e4GK4_BTZJl9Q*+NUi&CGhTh4zh_XL*x!;52hqJdqJqc0?MISuALlu;yma+s
z@CaMOR{H59FWv|Jj0<C|->d+icbqZav(1=~w@3_?9umf>LTo$bH1nEbFH9cZ7hIkj
zbSjV2>6ti~YgW9^uU$%I`;44a2`Qf}Cna?+qF)9C2g5l%uPfVLzd8W`I0bX<fN7FJ
z!l!N~!8rboD4n&b5*FV8Kv<3vF`@WwY|t9E*GOp5w;YU}(oi)M=0-9)tmI9bGoAVE
z`I;(d<!HxB<qdIxubJ!RARw5JzjmWhQo>(V*R!k7f1*IJO8-+$yvX)FrF0ganI`2{
zWJPC!D*9$2he|jRjmv&NJlJLJOXrx&BI{s#dVQd?L1V}$z*zQXJzW~_*{pc(3rg@#
zz!1EuvMIG5`+J6+)vdt&Z$t9q)Nu);&&-ts;hxx~Xamm-7~i9B+NpXTl@CAZm$h(s
zfRQyRCi(}F1@LNYjgfCp=>+Osp&is0CFZV}`Sld;5=KTwV4kwA?V8@roW{&+$)RqF
zV2l@shsVkKr;h5*dSyz+`{jDt&5HU-t>>2b)QmEP?Tmtzd$Y!2U!IJ)**ROb#<a!H
z@>!^}bHI@wViyjBV~ccYzJONf8F2RRtjE5vBe+{NQ0qu-%LxXVuv@CR-#7a_wRa2|
z(Z0la)vNVTB-z-xrT;Df<=51>DW7xrJG+_q+N3n`1pl&l%;=RdcG|m|nsNP;RF5}8
z+9gD2wgacao12<`JU~o47uo??!6~>@Xc#_JYMCPp=8C{SOzEz*u)Bg$uv7pI!CkQE
z%kR4<?sflj$r~Pcv@CK9&0411i0l_+Q4_TRc~`R2#8FF5e72Y@l6c3_Dt(Xe+0Mo?
z1%x_mKYn%qukP@n=}Sm3n&)xxFCVcxb?1fG(>=us&R<~)ETl|?nOR1}dt+mR{9iYG
z$7bTy>N@jn;>sGgz53B*{4qy1fe8@lunHWSa;Ow{FA`u&JY##CeYtDXEku_(RN@s$
zU7JGa5r!w*5ASq!yk>r9)s&`o4>dpnMj~rhI&4z%?54Ma-CG5`!-*cxDrr6XO|u5T
z35*O$5L~I$dAlkDMkPs5{S4UYUpX=VzS+j6rcg()n+yjw32LRx(I*GE-C4Wb#Av_J
z%``cy_9Vg4ce{dFgkIvhLnZZOG#Ksg&wFV7-LBvJXI1(at^=XZcbcd@6Iu^eA-bKF
zAlcTQ>I!XtC<4Y7v{Q;AkJT)Pl;8O4H(+lKF4e`JORl%NX;oR$bF}u#M@F*8DA;l9
zCm#AuDpORoSB`unKM2xAQu#?0O*m+O1Q16=-o4P1fB5x`9?6k!#0LmtvO>Zcrm7g9
ziPD28{;1nAJ$Y?X{4db-XMZ*f{(iaca>}_5k~+%+u<rQQ378))h%X8^9W6ZL5((F*
z#VwUtFg*v+q$lat`Yfg=+b-Tg&CM<$9<jjB2i=S!tE2<_YnDICk+ZqJYQOpANOk>f
zva*AuhvXY6b*+c|{Rn}XCbmZvv$8z5D-FT8Rr}>(UHMUv4Ge#M3>_;ptmdswG)y4c
z%?WQG4b!9e*WHO4kr^MM)xYFFbO79*{(k0*p6381dD}-rL_GKW8&E%JsO^@QiKpke
z_TX$pGw6P(uaf|)u!u#G(jXJfnOPV^$|!c8Q(5j?Sq8qRKIq<s3xn>M5nlHqkd7my
zBc*d5L}=YoaR!=@K9C_>15lU(=XE!CPi48}QFk=z^vsSM8a<ml#@8<6Z+i|bNOF9V
zNf0gk*%;g!<lncZOW|tRnCuaEo{TIjsVDh3?VsT$zsqw(4j8^FtP*qk>0D!|_ePth
zKdx-d%Cb9a6!^igH3~>>xM8AzzEIg%x=cJ+!^x#=*5<PIRZFqT3oKbEKQ5?Jjyexs
z`tdEwn#aQj;Fa(T`R^b4%^90oqS-NvFpVS`6#+p(f!hWCLfQpS9?gEqE4~QSsV74=
zyf-iP>a}|kjhp!EF7$9gRVsPd*fbfgU!R){?lZ~DrsgjY$2Pna*<N8~(iH>CAckKi
z-pbmEhIlwLA0Z<$a4*)zr-Db_y!z^Np}7DcRWW^RsDL>{RP)t2Bzg=CS&4}9^721Y
z=&y9ptB#?9MVHssD{rDjaS_?IV29j1Amx4?ta`7lU@gT#a3HANp;a2>%ECv;cv|sr
z9C)IeC*TyUefh=FtqI$Yo<G0elM`7|G`-k|qy%W_0nm8PmFdJO)ol=;B~=ZrFu|iw
zL6x(?U_hu@b89PKF}egbTrmeCa62415Yf~hB8rkv63UjlKtOuqk<;GxtmKiq=bwP}
zg*zPI1ECw~;6I6c(m=Iw$j?+H+zO`M?<**{6B_z%!QnZhoCR1B2I6k_5+*ylqPp41
zNv-Cw+S)xMI0OJNj~?Mf-0v_j5Gm-f10!PtRaF2;88ED1+<jI_27@RP-gj%sMaEy@
zP<|NEE~U3~Y3_!8x_v6?sU^>gexP`#;f!fcC&7N0XQ#K%yZV$Izj^0U{YS3cyi?#y
z$uIgz`%e7$5F32CmpG;I$))4%1*Meu7xG)HrzBDM59j{ZheuOlfGlmDs7)%r;U|3L
zg&_F4_E|lksuBIPaRRbwej$2^-dq{<K&jb|z)wHpz`u~kdh&keco`&f1UEzB4SwMj
zsO>?LTr3tj#r^Gx+Y<co5_$v}t2+ESz8nMhJ4NLIR)%~d`1zIpa?x|H6LAMG=hvm~
zqTU=_sr>lQ-#Q9s%s(_~KY!?z_(kjw)1;EGnBIxpEBP!Gq_eTEtFys6?4&;c@fgrg
zsu!RU<lUc3Rhe<|)gJL;qnb4;QHzU@r=c49-VbM;F-0j-i&Bsum>X~pY^UG{_63Q4
zY};BTM$S0Q3^3iKZ_-L&*MZ$EI%h4CAk9OUb%xS+POHCYwhdUr*i4&7A0j&!bXAM?
zN`hBR&b<UI%rl+vVxaTR{OPu?{`7u#HcfEbM;yUBF297g<@|n#m|aUHSCItXUF-Pz
zCJ56|1r9jrnwrJh+U{hI$;+YKDi!8^i(u3|P?jo<qEqpF?a^`Pubpc4XNt73`3mN2
zSKkOx6fo^1b;mkHUF_^MdKeV*Y-N;&ijUZ|^Lmw5nPA(xv;dQ-p9z{77Pz&CUFwX`
z%-VYASA5HQ2ptS&$w*xTlC4$7#$BAUjUFs1N`3zsR9yS2-HU=nbyH_}9Hp-6NK3`u
zdTld##T8`rIcv3V@;p2ufl*`yGtQR50N)UX8`q1m%axX9$4clb<>JN|?xjr^8H?WT
zGsp2c_I#Jd1KuTOWivCB@;O5#+9(kU);~p#y0*G$*!NVP+l_g|b#f+|Am_q_grK8G
zRq)Am1PJPt5A*G&>K(K2i0SN<l#g7-Z2fW5mt8fqBGcS=Onn|Pz2-63RUN%4;B4!A
zYi>4DBZ@6Cr8(-DGphe0d;rXp?Fx4k`0z;IMC?r3Mgd6kPm^RwwN*K{H`McX5Ar>i
znpj!EjP2_>#e!*hR-owC)BQ8y|F*S?QGWXQ)w^qw#GUMoh2ah>VZRHNy}1n;P@kf?
z!ie15bf1eTO*V(*fQx@h6R{qIBYQDMc9I(&UDzGNC?lH~71ALWDS?jYhv^C{?Xn&k
z;D?FNOGsUpy79XVJa9aVe^dl><$S1SA~igAn3N(}Puc<-3glWXQnU3K*e19km#CRV
zx!PK2*phIkM5)AjF6{oTX;=<e3>aJWfQj3Z5-eme&#?t{10YPMBX@3baw->VAn97<
z1`#qlz~oPW@{W&mo<^{Wn(z&Pgo=-zyGQ82N&#z^7$ZI~&_C4<m?-Prg(EeWU9&ml
zqrx~#Tpd&U1CVbf;uuRwT`j!`$gLEsckuN#SKq^WTg7`Zx)KcoX;EarF(xJ5(7PEK
zask2C*=A>tWw)h&c)qt=&1q=$xLtbGX|nE$@Sx0ox@*o2W^+>$6HEJ()f-j!eARJY
zs5_?HY}1S`z=)POw$q^tBkUJ-dHD2VCpIhQh7KInQDDLJz<nlvqeEZz4Z|^FE>$gj
zwnk0EBDiur^uc13uVZ8KI{u=TgI&_7U|LW4-N)fgz*Q)VJ(91~9TB4ozM{jfd6T3)
zVSx0K`t*AH7*8uSS>kG!+xGM+`B4}y@@{iPC$oK1*~8Q|OLxK@nd+XP<=HPZ?hQ1a
z+G}|{`DYA3NzFm5GA5@L3?1xSo!rkc>xFsZU2G(+6Wu5s`bxZ<X0^=DPuGMf>R*Ip
zGp<OUSn%?6{~z+hE+x993d$R>kZzSd=>ega(x3|1(J=^0m~shQ<qlyE2c;4TiTm9|
zXU+g>T51j%5%EDG$E@5rsW+mKCv*x#J$U6#5i2nIvg1s2tio-3>UVYLgyN6tPUlfm
z<Hg?BJ{P$;zBI-#@NjBWIz$hrwRJGaj|#8ry4m=tiXNt#5yLKPax4Mu4Gm=x$Tx3r
zZF<%NQZ0^Bw3U$0f&qxVNF!s$7D;`pPx;e&m<p4>UJ=OT0?~GhbpZ|LNLEM4TbiM(
zIi_1Wj$hkrNF4db?v6(O^#yV`SjPPf1Om#+>b}JAWVf)VNgsKn<dY4Zw_QSIK}!j+
za<}^`IsY^-1UJ!rN41qU#vc5sl_$wu#r@^}w90hoTAn|z`nXX~)B#N9!$sva503P)
zrpgXvD+PcacJs}D1IH2)m3cel>G};bwC=^Xz&beI(s8)HRx4?LowLnOpNt#LpBMk4
zhj%bj2}k)D?IV%qd8gpWPOyV_VYmX3gJMAsM&Qw49}YYkjMPPF&dita$Cn!NTEuh}
z&FbV-J^2)qne5R4yd4?^Dl^;eGcM$~MTYAC&{T?Wl9*2Y@1Rj?h+7Uw&X=V+#BUd)
zpz;6jVti~+jIu88K?2+9MHwS2I*l1y`MwU_828Q28Q8;BUT4suepC%XR)R%=lzhZe
z4^6--r6J|?3s}&P%eDliR4}(ZXKx3)j&OB+Bo&*}jK@j<Pr%MDD04vmFtGNKZcm?V
z609O{M$9<BaRfmH2yuTp{ZC@3)S0uFiq~S(Fk#ARco@OfmiN>N<?V?8dqq&+Re1C7
z*tt-MoQ%wAru8JY1T<@!LpjIgMcYD{dWv?Ke2EdBTi*!-MC{Fs>-@>zUeSRq;0*vd
z7zl93c8X5L;hbxwF4)0>!yqYkU{||94BK-h2Q2e8LZfESMkdMBjc%))gPcByzCbio
z)^QOm`FwFi>b{tA0FW6sFYkV}M+<ijN;?ODhoVv@!}VgN>2OBJn{Y4;$q0Bske5JT
zy*dFZ*pvV^GiR*%5wQC(0WkIWacE-=;Ceh?9+uYHNDxRJEH(vIV`T$_EWffGP^fFs
zZJJ0sZuagLF#TW|%?I@3>5nhT2Sv#?z6K!Hp>+TG{)6MzL*@f<_hy<D6*C-GtjJu?
z>nm8T*E;CIWWf$?+2(K}X_kc~P;fSEX(VUP$ch7Q?A^PP9`Y?c6xfEI<6<}{x>w%P
zzVg0*e?uwb0=S1nQ6%h9ER|g1V0KR<_hK)?ET)wWZ<d#IPp+E&sZjiWxWRj%;dZ&p
z1B``f8S9^&ve>|2l%gl(<I%+zz>x1TQb6b7=UOLHIXBRopX_+i6&Dc(u-Z3o-)3o+
z6gsH7;da#U#FFiorzeQ?*k6DAcnjiD@hRMq@CXCi0pagY&;@a2XP4B;hqZr63?QbJ
z<5PBFV?_I?iMdh!sddD9D@}IT8+Nog{O_Q<CB-h0Q&UplX|+lN6ZltcmV~xJXR20-
zzrSA=)rAY)P&G*v0Z>A(`Mhxdfe)osQYKG26Wl}E8D#Ulz}23m>Q#&9<m1zF6A`IS
z-<5rYvc3pfA{jw4y3&=Y1QO1r8RsYjCEqff0#fC4uNs9iaHbzrES{R>Lu;mwK<Pw?
z{&cOz@OEPmTjdb|q_xjuQ8&;Q#4k41o6s#^+U5M^my-TEf1a<C1PbhyqNbraPfiYY
z0ihU^4PqE??f|1`zxB-Jhe;Hb@t63Iubp8c_|ww;&Mkm+A4s$~eE`A%TCqFZ8Y>LU
zI~YHirNNbAGkMOkTo8=RlOm!#0Uj01jqqi(-rWus(KNIgk29F>JkweB?OPn+f{}<g
zmE}+iqQTsQ7G8N&#hT-d-=<N1K%!FXsmNr<klTZ?&ym$1q5u4G7_Z*5qrFerSI#E!
zN{{^D`($T#bt{3Ilj*%)%l_M$#_g4@MUZee^uQqCgMh)lC5-JKK|wfefz`J}jmH&T
z<-E5mVy8r`QShX-OJ39@zpN$FA92rm{jxiu+UhYF_n)pJp-yBeHGLD}Tp->lyr$MX
zb4JKnzfO32s!m}}E}?&6R!wT;I`VIO*L^}7h1>_&V@A&T)vo&YLnVuw0D=G`5Jz)0
zya6~U(-wMdW%zkl(3o41hSo5Er9qsXcH2UIEZ&-pJ>ZfMzt|PPe&k><%!zxTx-S);
zG&fXc_vn%P(nU-ZE|iH;&Q1H4x3{^~*j}8IZH>?7_5JPkTa|2=ud;*P(<EmjV`HsB
z9?WsphEK2du0}%fMG6X5c_|S2KWtBO%pTgD_if{H^cW~?8Xvb$GpY|Xu8mTeCJ{yD
zf&$F2_N0_Opvyehv(|mZqB(lknKq95%u4T)T(G|Nl1MeEi+-(gzGixzlk@pOSWrw+
z4(f8-C#e2N6y|Rof)oF;++8HqDwejGPf(wI%P#(HW<wA!qPJ&P{A+Vai;9ed1)qIG
z<bZV|zoKhJ!_)A6^ibYaS3G~H8R7<KyLt0F5Iz73Q*!^)%f1Y(9T@+KDAYK=2?jD)
zs;nGD?fFWE8n{Sm50D5Hr`}@4UQ=QN<UIM&6b$*TVLTk5m~>||8&ncpEIy<eb?XUK
zBc8L<ztg#UH}doqKMK;`z2Fp4Z`J_a56``L19VYDiD1LUO<AeaX+rKU?{A<l%<HN~
zt<tgqoLu`B+D8KHVJcj6e)EC<v;LS?3mEeRXYI)u+1bNdyR7L}<C6@;U1u(+YM$Ho
zCvn}a@fbG?i+g$Q>yi%Xf2te^Q-dHhw@s$Gq*fTR5BL^RU}|Bh%jTp15wlYbkAecg
zNsby&H;W7jNdalvwa>A%aL|LrqA}fbcOywirdv(}U;6LSLQ7^S-*KO66x57%z_TP&
zA{sJeH071kL?wgs`IK|~s@c?U-w>%b1Vn)5C8C_&F8SEOS{FFqb9@<3TwGA)T5lc&
z7VrmQnmjtLS$cg8h<>Vz^z2Ab0}B@JH3!v?1uw#2cWYKrk$Ioz50L!#2p3M~YYQNh
zGB4&l5UKr@kL)$(|D|gn>(f*0<A|>})nms?#tpE^p2Bs*guU|;0HuFINEWIa<skZ3
zfuWWgXdSn=b-3?+m1sLFQANb+3AEmJx_QC+e5Q{7%GWoz?R6~J!X(D@p0WKx$vm@i
zxm1)%AFX9G;N|E9QSRj=#BSHqIBN5UTMVQ_AF8X<*h7wZ-&)KBzEd^(PVzw}V-AmA
z&W4^{BL&Vm((Jrq2#LgKEd4!~7T+xD(fl$8T8Kxj?x-)m@K#TU9@N&1{x8opKm5{L
z4QErYdr&n9H+EEks$RLBvbeSCslxNW@GD3#GnWv+1v%tpl}aingf}`6I+dk8V?y$k
z9MyY@ZgBUd_s@$M1~(ftP)i@uez`gz_4OID>)nV6kv%6_P<AjjW|YxzQ^!i&-K!G;
z#5g1}`2(5fU~%TA9{c7(^syavho;G!XdnU<I+&>-F*@3|*<|FR4JvQCfiY1bdIHof
z_TSBEbwK=Kr`Tfz9gAI(iI%PbB#43fU)tSwMLM4&ukV^^``$0@&iGM-iZ}-ngL;3_
z--!Y8k6femaiJ?_LN)LG)vF7jAq-!UQfc0h7w&->wH-OX@`I8xD88vDYBj9SUd?|$
zvJL+(jp3O7=TfvSw8frlQa&uqH*enNFE;{gx`0nPJ0R7fyr{|u65Elta-sp={WA0d
z&Wa``OHr)X@D@~1D=9INg=go1GE3!@4H<TG5n_2rlmmXud_U1<4je$)A;WD=S4!{@
z7D0Rr4AfA(7G7fR*wnUuR;QDlE%`r`I7z6?n%DC?E9r71l2{c&hWFZE>!4Umhp)lt
zN(?^5;rqvFYkXPF{kXFlK$rl!_tVLG6#>dB7>89@bz<b?<-Zb~@utcf;z8k(#ebq>
zH&gl{r@v9PLP}fy{4w#Pbx9%b50U*}V3wb-jqIQ9pRBOoyzBw{lRFL;dtW7?U>b(L
zKGlL`1=6Beux6G^zd>YY$a-LAXIB#Mn0IMChgAUjRbD<vBKl}^YGiqIY>ZvNIm}sl
z;@~Kb{Y<+bQ`do=I|9P4qv_4R(XVOgI^C)rklFZ1+Xda*U_}kAXHX7{B%g=Fl;@4y
zWsx3^*U%1s9V!dDX<w6UZSD9pq)PH2<z=)!vdx%`f;Iyfc5@w?R&PXlGU)AFlVSer
z^zTL-$1IgdZ^HKh$aS?p=Rukp)j#e4%m+0u5JWo_84>YXC#^J5)q=tEZ#%)z+VPPO
zBiT2?<02xmb9QS;1o1F9U!Rkr&dxJ{_T!Th{R;WGjr(KOiJ%G&6`O2rq2$m@d2~a^
zKOjI=zk-p0XntTlUrqP&Q_O`@ORVJjOi)^AV<T9uhv!A^!Qc){sI07l2SE!Z)}Br3
z%RX%MXf?9G<5A>VDj&4^H>d9)aRBVv5fJ4rq;34bp#CTrC=ZCCkT?gZ-}29L0U-f_
zkeyLGAQ+pAc&<$mt9-{`uq&Q@*@gFKnwvFqgq6XPhBnkd`{i50(f)|AS$tMxDD}x!
zV`qJdv!yegRC!>Hfm*OM9pq+Xp8KCGBjV#(yDn)yW{2qN1K1tUTsdUyTV?@l>4Ki8
z#9yxqI5J(_dP-#bbwqU9)dPEOI#xXZ>I>-|#im>6C0KT|fZc-<)2=l8#jM80$6qZ}
z=IOwyc6A$V?PBSN4?7xYVFI>OiGYJ5idKh#C>lz56o6ndy;j>$Rs=|_LHk@EM$-1%
zNB>mGKB|K!agYXf#kMoWS>sChL3(matNO$*M>Gxl>4<ibAdk+JTT))4`tYhBa)`hG
z3yO8GJEPNJL7Djm5s_Xm6#J8k@sHiJXR<2cktN*R#ibvPK>`s6uBcVjtq0^o<N>$L
zRfjWVN$n;%;l;NB7t~byhKQ#JB$ku!CaG#@MQ@&Kk5H=Nh8|2sHS1aU2l3GYmS8DV
zi3Unn+~a^L<K`x#qJPfSlC6iKcF+Gm0x10%qMhWP_8$&%rilx53p0ZS&i1=o$ecJ}
zzk+}$PJ<AJ&ksR%>^Kw;QZcb;@oH$Su1>DJu{ZZmirx0v6$T}z#yqkw2?N)P-1fFB
z72h7DOdxj3Wc$`<Jo`n$mn0J$=vzJO3KqEI65q)k4Iy53u{)`3bri8``+Xf{DM+&Y
z)L>PqHW0h6luriBtd`WD$Nm+t17Hy1db6T;V^ki&HFF4R12C5}@{>0yo@`{$AMSWn
z^MB?_hIL_J8bKML@t;@VyM8@O4fZyv%JUqz6?JEp0s;&yFWILIq{8$EuoEjxqfk@8
ztZxb{G__l!N~8_HMzw^AtE(ph$+BM;a#xCCf7<X?0uCpdW_bA1lJEX$$;DByn}3G?
z)U~7GvuH;ar}EBPtF^vQ3xom<Z!OO=tBMwR0^_~lW0!ySKSiGfEx`){RFHSJx3zgp
zN1mTC)(KDcXg*7nH<GPHXg{*&j<NUiCunJmF-!_`!dv39U$TcU>3W;L-1ersf;SDU
zzl`?(89J3xyZ0^7^s2-wvc<-}OL)I>^p{_`;3|Gl<4q|Cn95<%AptwSv1*A`?rm2u
z*F$YETw|;j(DUj)PhZCgL%zWmcFe);9Taw`2W*;`l^otrNVFXF#{>3v;lR}#)PdRo
zV){s4US3X4_w3`=P#D}TcA6Q4ndc`dXz(@gpLg(O4~I1zi;ar9p}2ACE?lDe;~GyC
zdyyNMKWiHZd4A-`&B33KD^S?i+T0vAV(j9wL-0Z`!0qL<ISa&STRNHF=JS>Wo)7~v
z<wI;YJUslG;1{q2*4W6%>gdhVMhf-n`ZdES*haQe=HI{j{w||j!Z`|n@H93Ysk^v+
ztff!Ax^*p5#1);p8UQxONq|E7L9q%<qdu|>&>j3E;{W~v3rrloCWimVH;*6Zg8xT3
z?f?4<zPyM3^Z!ol|FXb*WB!u3yV~FD{_33gKTK0VgNtoofk2`0(3ab4YIT-MwkYrs
z{p*CuA@pTTGtfRLklc@IH{qiEc7yP|mVfA9om2crfM1_dkL2;OAD=~gpADW(KKRjB
zZtJ6*wO3M300;B}b{BPq{#A(h+Y8uDu8V*jwLFG|bPF>wf>B3G`@TOfd{R#y{4AL*
zC}3R@6b38kx`hF;2ZgJBL;A;mdPqN2HdeU5z8pprER;Byh4p_?$wu9AdbA|RCKz+Y
zeI}r-DQO+sT69iao0<VF^FZ#AoSdAD45{lF($iB;?#n(XLFeOxT*%9Q(uu`gK}!X*
z`(@KlG5MD`g*NjlvZ<o;g+kaoLEzL<vm$FA^S$l^!_4I~^j1L^uzZq_)T^A}<?evu
z1@^sz1*dx?K*M=}hHnwnCY>8&z-Xg)#N^os7a}<I{Tr)vrUs_PRx9`K?7FdKE}vmK
zub_wAeQkObed?v;4{K0;49-|9xxF-8-Lr&+nT$9Z8u@F?1T{ShW#X$Nsa-n5bOs!;
zG`_5Ua1C0+ns1Ek>bO0g2fk%3dpt~*J4=^$ax0j`{aV0*M?3<S<vY2bFnx7n!)0q0
z!i8d648!b#aaya@cBX3N?yX2Bts5yuPs)yt1X&>k8A=>>`>4h^`JBkJbt+v{dll_)
zD%UyS`*!WZ2KkJyv;jc)A`D+BKe$n>0Mgpf+sbFGCs-#&d8WRwZ~h#D&)<D?WohgU
zYTPY(_YA3z1HhYI)nU4<H8lVaRRl-2i?3Z2K>%tfUIh$fios9OSaqrHPpA^gh3fW2
zFX?FT6y%^1Wun>KSCUDSk~nv(C0*3=6$e<*VZ}QmZ!NW~tW;Y7CTmrZE^cL28iCv~
zQ(7AAIesk1gv5{ukKzic?b!hy&^;nREx=>{zmG$=y|=+9^X%n($IWrB2RTI>?!F>f
zDs27bjTW0>D#4=I_Dspx_#Rsjt@DjMpBzO{<o82LE!OUljDVnDY3V75-FRX@kcqNd
z`j{Y_+xVi9lW%?2x??zkPk@G`8W5X<P(5ef&<o&gCY{%XgsR>O?S8N61`SSS!;0@@
zqItbfGt!}7IRS@ow+YX>I1s_jT&v-0_VYprsN>R@tV3I0^oPAoOPSUi)_$#(A|Em<
zG~Ab~xQuo-?lYae+=->#cY4~L^=Yu?<?$7ju1g;JU=y!kUH@!r#dmh^veCG$&Axb$
zf6cagf~0B%5R5QWZ*U`yWg;M;2Y|*@HmLHEGK#Rh2H_rJwZ0GtiY{<Uk2w$Y7=L@h
zOh;)H`4|^<5YE0A3(ZR_(W5uf@!?%LV}@3$$@so5faEZNFv@nWV*xN(E75>_*pO|y
zp~s#-nm3dPo-!srtO>n>EI4@%PT{K-32;-5bZG{AXXO1?v_RVNVDN8&h8b%NL@^h2
zZRB6+Da=O2nV&oz%QJd)z?9i)chblyYM{y)Fnl7BSSu|s7*yEVcoK)hO+5wFR1qBa
zJ=s(WEdHJ>ENVb=L6$E7x`W?jLyC-EJW|SNC5q<-O*U_EFOM^Kp8x?r*x{h9HQezI
zbL~IhL)u^h90NQ5<hc{Hu?h-x<mQ6{svnYF94!4H6?WAXDg$f7Z;;gWl$dfKv|+98
zgTw*41KJ$b^0gK0w!oB1i(&r0a7HwkDqhzNvesOM8i+Yq&H47fobqJ_jK*GlwQ{zi
z3|Dll>}W`jb^F+*u9o3kdcd1SV=%7U)8h-{;9gs503ppBpNzJ9s;Xowf+qaF;vIzR
z*oUQ3Gvu!AI10g!eBR1}2D_^P^dT*qIMalcybFr{cy$BpkbkRNp-)gjCG*~kS}{;C
z&{^dZ=5j$!>a40f2)uNY2-H`hzMxVV<qIb5_TG4`2Z&{mmMB)GR3D@?=ur}OuIYR2
z+xI5enkk6eLcN^@eSrzIcxI_Uvyy~YC~v1Q1GU44d;eBDxMhplgJG!SrlG5v>X}BW
zhCQFokt++K{F?*1p7VC*Jz8z5>>5KiKRHvoia)d=`9l~*XE6xUo@<8nWQhD=o$q?F
zpwZab^|cVU7A~WLi;o*2uX(#v>K_}Bg8j=%QEa<RYB4W9*R2qgU|;G|Yc=}{?_rI!
zu6Wl<bd=|KCDEK!!On(o_WUOu16@1sSLgTuL+WNMh(W$FgEMoBaF-8Mr@?${#+kQf
zPP2xi_dEF<+~$&N9>m07eO1naSKwMfJ<sK-VA~V&|1doez|@%5_@nIK(xYE(-I%q*
zSgvsLBXss7W1|zw${y99hVtU(-_c;sMpd-Ro)^~!gpL%02^zSX@5-wXy$HOgRW*Ql
z1CLbcm%eY;@7Gf{hHyZ07qvojchq*!CyO|}DjOrzh3OftA6z_M&-2*~w}2PpE3#GU
z1P&sgRW$gAUW^}({+fl&Fn*9HqftJCFbLgtEM;@G?s;$7F1&AL5KJWNvR3ILF0G6|
zus3{lNi~k*{u146c)es0K(6$cPGgg=l)yDsHsTTu(!-I8QE`OVhHOaO#HG~_4_W@<
zn}ES-STg)J7ndENvlc3~H#G^^FGM^=u<=`527Ww592Ac6Cglv1jY8!vxqc@2(;|m=
z>F7leK;O>oJL$`M93MwC9@+w2iQFhdgsX3m_E7O`&d{Cap_`s#LCf3indPs-wr-h4
zBMqi%r>3Tgi@672D`QAeurRPdmx8+VEC@Ls(t|h~|N8nkA=cV)U&|$dODDhQlUdEf
zXFu5)dAbu2Hq?mSdGo|Rf5^g?&!1m)>1Nw+J5Op5&2E)^xIGx;8#OLE&$^?=J6cT(
z?}G^F6`6Q9tL=GkPN(!dEp0^{$FTQ&U|BTDz_mNScrVJS-<<Oy5kutq_Nl)g#d;8K
ze+@x+{OJYo)xPUduFi*1eIK3PeEh`ejN;`oPOdtWwHbqq-0GrzG@G}L>qH(v&S+hn
zb36)!@fX};^EHwy8EOIGDBz7DPc>0<x=AcnGh<*JcdB&IFbzB7eNSSlr&j(U(1-K^
z!dj=mx6(Q$3Zf6A2}u98ZA~Y+*ebIl#5UjKK{G1K(@doarU=yLnAs@@s*aI4bfr?~
zg2N03UCV6KKkZ8K;{+R?vIifeb=A-8JjUW4j1VEAw3WBBTZ0T?UGy&2WZ2{LrtI=M
zV^h`8YIzUfb&Cq4;uZ-nz{)P4dpr&HvOmqo?088#Q9EppzW(uUZTf#a3VXL(k^O*w
zLB5L)q}0){=VQ)VeiWO|&ZsD(kg(yFd+<iSHrSSnVlbz?t_=u?V7!?qF1rr+);V*)
zL-S)z7A$jIomd6wGe^5(s?WZPVA0GFz*!-lxJ}8oRjI-~pc+w?g)ic)YZJpsT`RwY
zLj!8q#wrU8>41n32oV2#A+O_f?j_4y=G0zUs4)&yHlD{4yFZ3%7ubXjEHIcSQ&#NH
zE6f;`RBiUw-m$k5gb6}D$J}X>Ja)v^BQC(*gE6&WtsWYW8f*f}2>r-SQ0*<NO>*KR
zu5??Oh-AG7hCiJh^9SDO`VBNpg*nBj?FFF9sOHAJ7q$n{1!#`4#V+wowOl^00ERhN
zitahJ877BGG&;)no{X&V?NUi+xe8!tfMI=p?b+q{t&jr~ix1Wl_)*j657KE0v)=pY
zhdOuUR~B@zj^Sk+JBoeCYRfkRQ$(T8eD^V&e9&p&`jOL71bD8y@GhX!@r|lG?C%jK
z2izFHdOQ4v@YggcCnu-GhAWGBEEZ6Fnu~z%j5eMg2QZ*w5eZeVBj}{fVR=9XC=lyy
z)1bsyYNeBP>kvZ+V+oXTgzUT1V9t4z1T(xW0RtNGH<m{LA*#I{*7@-zCP#XH2oU0A
z8m3gv0)9PiQ4C4fvu)Hy3F_c7qM!O8*5IQ0fWz?rvG&$sRjAF^@Uak;lm-Q9K>?AH
zMnbw%Qb0r+0YO?Nq(e$tK)R({Nd@U{>DqvF!#5k_oF~5D8`t~aITshW_Z>59)~q#m
zb7*%eZH9y%!5gh=yS3)<&$qw+>eJH7t^}=*Ratx`xX1Q9${_>%Coo|4?W!B?s*b8J
zzJG7w_ypYs#by|pQ{J>Ei9`!W-<?-Nw@Eg&3h`dSlKtcSeL%4h8;!}b+nT+u{zb#s
zZn;Vx!9kmwGuAnh#fQm1;{4<LdF42mU;yF>`lZp`l?sh`&H~Zc0gjmb5}X4-RyQ92
zi^&ToOm7M)m8_P=c6{~$#NUwTL*IP<%m$=pcl{X8szr?fbg^9#`P#q`hQ^sflU3bk
z6MSP&x?aIBg=_dKhS1W^&>r6dY1+xYNjMdIaYB@UwitXN9Grub^_DpBBEv-dSg^vk
zirt>dYuRDM(D3BNmY;n`yYY_dA>U-QdAWQwxw^koJF@e8W4s(1SL(;cbrW=fM%c3;
zjFU**nI-zAh?#Y;b~EX33zvbRjxcHP$xzr?$nhAMxs*$_;3@o)F(>yQ!cf()j|*ZF
z#9g2c%B`#oB7!T#*!U+z$Q5LnwuB8DIj9C24=Rmyseiuz#J@z$c4(bMBPzPr5U4VM
zy!XBBz^68}U{Xbrt8<dU?#$PqO=i?=iTCpAL4*z|pUwPH*DIuGG?`|5)_!MMG6(2;
zd55}!{c3+gW;so*Xvw8Y+csB#yT)gY<g~2-@@K@eEe%5Fl~|o-{~lt!%C|23bJp4{
zF`gS$YHIu2)o7R3=Ps&fLR474fJM#DliV;tCp$)AUXdN;)Jg@rR3uR}f=)6kEZkFs
zyUVCG^eyfvrfjUk@L_7k&;DxYT&p7=><BIhgPM2te3|;hANDEE{0I+&0Wd`{2En)?
zH1+lCv%Te%(HP6|I<PWcK6Topr%aD?LgR{Gm8<_>Np%|3{Duf#d)jXyA+*lx;tznu
zO}i4v8&RI`6~z9GufYYv88h>iNgrB}?T0}aM6ocer00ql2nVJfEa9t}xdEH=$nyl8
zHv@y@3CRI8r1m3fMpB#i+oEZM`W`<-UPADXbyhiYTTcm}MmxyA--s=8<eA0RfxaL1
zh8H4hlxmKbGpxYxv~GZP5!|XS_VYhN?XlI92dZKG2jFOku!M2S!6Ib5<zt!_Pc3Jf
z7r@IbXRu&6_|X7lIgwFZ4CE7&1Y6TzuQyLH+?pZL&K}AJ$uK=R`TfP18dEN$inK-(
zl2QHNXGDL8#F6<;a%2mXGPnmVM~&JBhyhV<JM*pDE3VK$@K-TfXnd<)baqqEwS@t%
zFnXAO_xq>>az?UNnU%=$_!+%65{|asl60U^?amfxmVJaB=-sFo&}hqS8;F*DrS4GS
zaz7kL%tRr##^A=Y0A#rT#{w9}XR~Q4ty<C@htkPrv~XODyUSE7SN2$30R&rxC&4qc
zo+u*yQ&UXZCQ05f97<`KUoNUnLnTL@tx7tY##7|Qdi|KDIAmD&zq6y<l%?w78E?13
z=FI9_)jscJVPAXFCZKQdIJ>LMpBhFFeEk|y_y%Owu^g-Rbl3P|7+13ET~^0R;1CWm
z)o7OP!%L76$tAXWOujBBM_2d@b`BZ0!#8}~A#5Ps9nc;#*!8a(9NxO}G3Gna9nl;X
zFn<0oBk8P#I!wi0*&}Z)WR`8vZF$u9!rI?wu$;_cehgmzUbKiy9Yx87f&;=N%!E!O
z4Y<ZBR$%ug^_%Y<rRGXmp0$^{XTL%P-NUeXeRd1XjmM&7+3V9sB$EN$jM_d(4nL<n
zo_*P9S;5JA23UV_x1~O<!!QXLC6ED%9zj&*f2@T*XMl6q%gSd6i<_g%38dbN@ylBg
zd?hMXy{22YHkbpd!lB0pwy;Ildh><GxJqkpHWQRD^&4|KKlYpt-a_n(Vl%OX?7F|b
zoTcRx|89Vvr&7krsRdN&>`-6GAhtRg8z8rUn3&h0kU(o~Ba;<oL$LWKmn;!H<~U6v
z{j28oD%xIZA;&al>#rem$g_dF@7TsPlN4sU^5@|}&^e|Wg#BW=%X(GVn{|H&u=o{v
z&v5e__k4#0ACd|pR@(82lcVvl2<PTJFK8NMN-Vd~Y-{K1UD#0G!KlgS*yN<tS9$#S
zsj%><?ecM{z4pJzWwTH*!n%^7{rq?vBox|JjK`#4yKu+S3-}WkCT0(-+5F2>zr9QB
z-^#zDeH-3E=d#ERdh;Yx*3o`(pJvCt^m`2My;BU4XK-iy>bML-E2cZuF0*#BVXBC%
zO-%&}Ecg8W{7K!p7IaC~^9{Kpv567e3%8yW%?~VwH<yga&3e9!dNqn-!{KwZ5?WXu
zTQjyBUUpwFhZXtPYr{WtCW&H#(jIyUOC99fA+mR`(IYuJr#}Jyn3&4?%MZNlgPf6?
z#;2>cgJ2JiJv!m^OUUrHn?&ZL3nO>une@*Xep@Al-+W8-ri$m3Pd_jT+9*3<Z@`o?
z8nrN(rJh^P4vGA@-*!A)@w4`^!uzkN^LR-3_R$e}ooY`2$Klx6J0eAu-sMV*0c$nh
zHNF1|DQm)^-s$pd<W-<7&;G;R`Fv~9q07CtZ>sL*{#<@%t-@h)3z;V*$t{S?EAz96
z)jBl^e+kIitwcK23;a~^?<2APoj(AvpKEUC`f#z+YF@BO^tR@64N-fNnbnF;-jlta
zw4b%mq}%W0<0N_bdK}NSJ&vP&F8glOD-$;4<8XH7x%T0=eEOmcDnFtkG5X6tP=xkF
zeS>bqsuq+kNON=A=8~NqXppBG$zdv1^?`YGhGwy;6(BQ^QnNhap?r`{-%7ivtXuE(
z>f?m*aIul5rj0^Z5NJp;7ix|jLTYNpW%&(=!(V`d5^0lAT8s|sqxq$>eN|XUq>!Xj
z4?KoNT*SYENF0U9)2+nNKq+X9Hc<-rhkBK6dfF5XHEq3tU<s*Nnlxw_OX7|_1~KmA
zF$ho8Gr#;Bo(<yg0w9ayw)Lz-)xfRz6PT&={=LA~Z9^pMi|g?RvHtr%_OIr#vSgZ{
z0--GgOa;pkLr@3ubWQcDiZ<6let`LIEKF-4)k3O_`j;BCxs$;jRi@+Gx(<95mY~mr
zYuoF{Ced2Tso98~+C7LO4%|kA%dqjE8~A=J|BoS+a@%-?{T!r~tBp9>%Eg1}>md)0
zH&gLF8#qOow$%+_?oA{C@<?cAIw7eHu}ZpaDAI9TAhOVv4gi!fh88nD{||x6s|R2#
zIX-q-R5&#1j%y1XIM`F}VqAzAu{V?g4HUe7)59c*BrK64(tePz>te&_{lW%xs@z@V
zr-jn*+GiX=pBG?tGA@C8)uv|=VE=Js#B^;BG(qbe-~qnsDE=?ehOj7u^`KIPkpDOr
z004OJdSjQvZ;ONBJ+!e^a&vkWsRgA0Ss9YW@Bd8~SlI8%pwbziUcPZNqTixWRsPDF
zL^RTvJND~$ta*_I`N-7oY7$xJBU9?GdCMIbSqD%TI8Kb~di;A-bv&=Mst>J%Kn(-R
z#3<1+O88!ySihryqo9Q5f4#K75C6bj<cIUP_P_Xr6jX0#sHTo#oA#srR|OReyCePA
zit7A%rF3B6MEsvphkf({2`Ru8<RFXjS1pYrhJrpWr&;ut2Fek`d@jXMHliuOd9!4k
zaSY`oW4H%GgUiqD^8OWb`3M|0yi~&7)a|pV?0=4qn*~UuFjldX4YdroP!wgi7P`UK
zr2?Wt@#eX<Wv#-eSt&;tvXKM{xrg7~s5wUD_MuQBq_OleaI5yMyk<>Ju1fr?@R`V<
z))Y}(>q?e1GU-q*DKl)322TJ>f9Cwp^BD5$Iw=yK+Ev}C$bQaV+im5DE{XyVfvAXw
z_{8_mg-{KUau+v@c-1MAc2j%{1BaFHYAZ_|U)2HVJHKtsqV(s)GQ^smPC{udymcX*
zA^IArHZ4ucF|r^?s1cfhsVXIA!-YoOKcHeW9plkaZgz|dW&HpWS#5g*cbA9I8Th??
zd&l5_ynXlX=Jv43hvZhduy7Lz5aEc5iULdgHmGBzVzoG3f_fWirnP;H#02rKF5@4i
zoe?VbM{?W9Vzk7<@S%tD6;F|ObJTE@E|dR?#<*Jfva<2L;4%3F?1AM>toKYUyvH;1
zRipkNQ_)n?!z*;_Vqg$Qxah{O$&c1m3GKfIu^=5<_G6WEAWf2h0dM-C)?}(yqlLFe
zaKZrfxg0F_fw)GTQXw1(@7rU_(y$~WWbWLK3d%f1mM;uiZj7J6Doc`cb3atM9C#FE
z1tTnt!=dAWgjr$BZ384jto7z${k~P}d!UKwQ2*`+cPhw)^w&A}$r;E6t!L~&4NOSd
zS{l!x-&xhc$5#=>$O1os4k;IpfwsE}T`|Bg)eI%N7Hhk>%KsUaC&Xs(fL_|_MN2cx
zk5<XFHTfxj3F4Y#TIJL?$6;zjCY#ES20^Pe+XdTDIIi{U6d?LS|3y8+Y|Z8yi~RJr
zdrm+8w(KXc#i!!~8459k=kLux4j%LLUA)fN5Px^(D->c}{P2+ztiHbe;DdK7jcjg?
z<tM1t$oNRJO-H9#VaLH$X)pt0=|v>be1G76-}&UO_WLt+xSk+om6bzQ(qEg^iHX%U
zv|cgIj>F)tj1nA2p=i%OL?VG>wt@+mHQlkST7QKmsZKn{ugJbkk%`7p>qg=5cc8uV
z;ns0-lJwTWI8meR6=a3uDG|BjO-p)5>c(K1b#S>ybzNoLI8y`Cya`GWp^;}z4U%in
zOz2VG=}zIz*7C8)K`JJVEJw>#l}$hdodyorN|N8SL{>+*N%Q_zF4A)mg;dG-R>kX3
zFRMFSM-K_%RVa@=L~QvY$)+6fUkQm0EuW)_Cz4k7?UsJ$(T_SAP8Aoxp-2#1_gj=$
zZ`g()Vl%dk<tq8A2+3$^xMbtxc(u8O&p@pn>;uZlG;>xr;Z^Dj8`Pz?{H1I=|05Q?
zw$H635usk>^LFr;Q<xsxadPw&uBaBHg<m$)R)qf0KfT5<ZXB6O9&agew6m0?2aeLi
zfRO!vzlpn=2yfa|jNy#D7i%w;Q)|M*fFJ#@L7vIakCgWw7Z(LReU{Lh0a?DUmT6QU
zuuj3oFM9YlFctyPjGL3b%MNN;*C|XpQ-UOPPyg?f>r$kGwyMIr|B4yog07xYM!GEm
zNC0Q`d(pdoJFLud?7sABWmVfOxP#mW1n)38kPm9ijIMskl538#Ey}lJk*F6gh*P0K
z>7r&QaR!X_afE5B{TX<2Fn<+L*-&ZpTbQx&cnKRv@dTp%M}-#FkJOhib3<Zy#HHVl
zijDiqpL^_JTCAn*SNuNHcf-W+mMAKDwb#ES4O=($NXn*A$Ovrx+|%?JBm4)ZW+1MG
z2SbNKIQ04eBPdk`h94j84EN?|6%6P!bTN_ie)q=FXq64Vig$VhJHsb3LgLwau!{Q7
zh<ldf9EZHhCGDZGgbq_w6qmGg2Y7psby`+-Plat2qfBOFp<VcJrti90g;@lFqCo!m
zFMsipvQvH-r0ieBv6QaYk%0-7)%W2FyC$G2f9dtpi9n!uJJW19<)=H?<!4O)a{d=k
zjWQW7c4dVLpY)WJLh$D2{NB+gEe!k_0ZqMo#()}k1`Egt@fj}8yn3aKHYMZeys&;&
zHR~NkK|f4;;A-x_CNLZI&uI&~+T~)eL!;TzE&8%P&$ezTyZxf63ckHt^RxY7#+l3-
z_IC>6sXSQeOQf)#^{f3MX^K3F$=@|l0(&p7!y+1N$+tJF)68Z`b3U7#`Y3^Nv45oc
zs0d7MdAfBDZ%+;l!`MFqe<@OZ0-k!+?5G@iri#96|H!9|t+Cu(^z>4f!5>kzH@p7v
z8TcwbTQ9gSnOALvWAdp@c6wLYv#fVX*1;Iq?39!JC24?yFp<EhKe?yJ=wq|wT$8^e
z;-tWi@sYC9(#grzNvi!V96UK}Iddz~`;{+)$i3-O>^Y6J*W=zcUF8;KVInk6d#dIW
zp%_V=euG|3JFiEMrEY^eZa+Grr!ww#L6<{XhyAh6PUeyyOF;z5JO4cU@wp9zVg8d=
zb(1IU4*drPPjVB;E#@me^=12ZR(*d2uc%r$PS)d#I5e`(_2rRQx%NGpSI6tkUn1#x
z!Fg1TR(D5gFzDO*ZN%WfwE=qHyz!4S=-5nMX3R4y2b?ymSAZU?4W+9KE_K?QYV;=o
zXN+-!RmtVxOub8Fxmv?8_qu0uA&E`;<;o~GgZ81FG|je1%<^QH<)@eD&#wuVM0f4`
zlZbHJJ;5O9!*Ot#{xas(*^rcKtScM5lCHQ1uY*SQ<!TQ4|8>-reD*_o+^FZ-hK7qw
z+9Tc=Q?id!QfU=`n5n&8)Tyv#SC)h)NSCmc5B43XXc`|Iv{EyCRwAQPtS(b=X@5_M
zj^!-{yb;&crT*03Yz@cZVrsGW_>-=V1n<O8wH_fs_w4Ut(i5wXhRcUUL|_xnix^FQ
z2}Z}{`SBMDUsuQC$>H3^P$rZuQL-v!m}+cABRH}+ihB9cjXI+n=y*qyzUT06og;E(
zH{QHiMSycT(z7yQHSsMpBm^A>KdMqvy5TMmb;oGHVK^!v7V6I!VL(u82j~)dGGl+e
z-Ci5#-});1BkBQ*A>ZbYr*~~l`Gu$Zb5~QPo)47REZhRVEg%5n3i_4^mUqm^$mZ_u
zc9cU0Z~frSEDOPW_o=ydi~hND^`Bwtm!#PI{OqjYT0UL29fI)k5lED+k9VhnQu5RX
ze519n&M7GrR@-k-^k9*Y$n5Tx#^1}QrZqfs)?w(vGxiJPp490sCSA_$ajpXSz{I~<
zeW!fuUlx&?=#neNWnBDf9K7chPjIoyanBJ6HHOQdduURTXE9XBtocw_Sir>v#o+R@
zOgqX)J!z>Cw<BLCJslhI=qc5WxHFA|qyLoPrt22YI`MeXGku5toa;|<9Ms?q9vv6D
z&=}^{GB(pM9sHU3v+BLI+LJScp1OoM!T&gg7vTvRA>ruIp7E9ze?epH?dx2Hef|Az
zo9xZ?4I=b?$y*=9g&a2Lg-b@8U&hDN9y#=d_F=Ed#@zcdTwy<6ttFSepIU6J%XD|C
zFI(C`c<Cvso<O&p?e^hVRZ;C&-UlnYqx#n9H{=WPuGJR4_^oh*^PLZ_eqDV;)FgCw
zCfX$B1<KK1uW~J|${7?VZuQ&^yE@lqX43a9vg;y7Wq;0Sc153(00Sanz>J73Rn{U~
zIdgWVh0OQb+Rf@job7!N7O@fHa_pDupFfWgcFOWR)9@#;y)>328-GtiC@s^Y>ZKFG
z%P*<d$PugdjiKCged<CEC#F}BpLpxP9GZ=}lJ1SPp!%E~bU==jAF#c<>N4fx^7AK@
ztl*;gc;|l|9P}pj6txk<X7LE@PVrytN{;2*zkS<jZu%>a^ekMp3m00%2IKDKC%YUu
zh=@G&NzWcHm4`P^)+g%Xt?cZsbFl`msC@OPdU`$nrZ^_vE&Q<8?Y;zdiO(HyT|d9}
z#&seI@9Du*Pz-_DzkLOUi1Oz~PD#}c6p`z#MeB|z4b6YOiYT?zeWUl#RFFxLx|WZZ
z_hH$_O}@f%|D@TnIR_e=#x#O<oGVkqHxcNgsA~iI*yiSpL9Lsqx)F?8^e=bb#~)@r
z43Q8T>#*xA*c1(%r4M%%@Y0WnXP#;MbzqonvYV^itA1EP-174ldt#5jZEA{Pibsyv
zn)fANM8C9l31b@rZ4+3<YX%e(b8|$*i;l}fF7CCLE?r-XjNwtMua9@xmwEg+sK)gQ
zB2BwmCjZcfjf)F07k{NUoA4NGGumQZo<;8=6I02{m*J=$%RS|Kmwc_Q@H;5et#p~x
z-)xW7xGF34WY1JPIgK1_`KG>o_|V$fnU~8JEtbWwvXsD3O@UJWJy|{1S*a~y<WZX0
zLGuYa^U=jwU0C=NOS_G<v~*XCl6PJ_$7%z{b-_EO^^^9+e#ET%U6SpBE=fc0Z>)mP
zQOoqB{6It~E>SslLt^}d>-=Yz+C0g@!Ho%JIIPV2jf7ppeNL)y4K**?u8!<&Pue$E
zwY^K^D%t-Nfg}eqt72Sq;C7{${#h(rf^EN8tQs4wBIEGgD#p5j*N>ZF#vaQ+trvDx
zR~OCv1`+ZX(Ej|wZA2!$Vrl>?<__kS4PRg157b#ijSr9^qcQG&o5vMyCud$gy`gzm
zj`};WF9t$)TMF_F^{pT2>$czN#rPU(k&|!u2=4g1%MboHew0aEtDW^p$puXZ$AA+4
zT^OlT9op8?@+p0Hy~T9Dz;Q<grZ}o1I(kj|x5=?dNRE3|Ien7J4GmMXvdZ??(ex?b
z(v52tlo;M*h@xIIO)cGhWVQZ%wpD9nL{m`Ess8P*kHJF4CxKiqua|HbY?g-x#T@O+
z$|@=_h&Mk}$6bC<S^?lZX=7e3Qzb5WofJa0>r~^i@)1>=^vCpXUzU{Y{2;E&Q%24_
z94N@=%u`0!b^Y;u@nh9ft&_LY>!=5@+$={&8gj()E)}--Evh*m=2zY>hkLgvWY=AB
zSvRn`cdwoA;BmU3wP)uIxIk=<j-Fi#D7v!etapE;LSXygGO8uhc9tIN`t=7EAGn<z
zZh0=QO-1AR%HF)~B&wrvAqjuGQ1hhPc~$Vv@cLU$F3YXVS?V@v#@ZIo51cbA0nD%y
z##9A7R~*^dFS1u$aXcc)M$<74i{yMhQhHp{Os45i!*}9@-lgBPtx=3no{{N!2U!sh
z??F%6+IK(?c)rc(u;Z837J4%aUigw2i%Cl_4wqcHWa0ijTiu@GSVo*kGMLeLX`G+b
zvB-RMF+G*Edk5aCI@(m=VuL6}<gh+!R}mE8g(~3MalQ-Y(wRYmXnr@QjKA%-AeQ1}
zoqZU0Ki@C7%=(1O@(~AGxpXu>#oS_Vm0U(4-lELWdNHSUqrR8DecAHp!FIj3+w0er
zK={x3oMn09_jz}H$AVnj?qW6xPIroQw2Ij<%F0lYW+?8tjc<{dCjBm6D12vJ@$hHg
z)Vp6g2hZ=hJ>%6AX8Pi&+V8o~QIe2h)cpXRc$2E~)l;Qa^l3gh*Q>a<c>52qW>$87
zus!{Os+_ZWj*SY#X?<FE7e~6j(KBR+a;w^~oqwnVvoRncp?Wh#HeY-^`6H*s^Vog;
zejBM8CO}iq|D5qmR9)BhYnFh%`1xfU)=_rhvSY<kE-x)TTYnsvSaCfxE^egEdYJ$C
zo_k^GmizToDIyso8!I@Eq186&@8y$37i_r_g?wyEOznl--`NnzxE1x^rPS1};ai4y
zb?&Tscqp#DBZug0r9Be{QJ350|5#k?x7MjLGZhsT^a{GNHC~@@WNVac7n?~2#qpmc
zCkWw)yz;n0OMa$l5`j3M?K0E6^8Jwo8t>yc-U{?B0)lb;5WPpUGY02T9OR?!Sv{^h
zhsh&g5l66^-xM$Rg^>~cBAVDsdKF27jKw!(wiRV%9sH=9V*)GZwrD@+&3W<(%U?PO
z<a5Y`VKO}&&SYui&%QU0ax{J|1McwIR3kdyfoYK*=VK=Vy%61qW`rq#0c*tN@q9x<
z&-{SL;fA{HjkBLr9=h`i)Ptn7xU}@kXoafnLKnufgg2r%LmyOHP;tmJL^>*e0w~Wh
z4D>C$Tx(I<hNUDcD||qSa>UPQMam7^oV=Qw0+uhHxuK1ki}LDVZ)13C53;0$#A2WT
zJc69MW>{h_uj3NwZ#(YdNP~B$D)Tmis5@9{Z#If9?u@?hNT<imqp3iltGcpDnCCQc
z;TF=;FWR==yirKq2(iWYugAuwruQbMrZ8SfQ#X977bq4PzyWZmp05YSSJ9_0h!4^(
zC%r4)MiBYp<J}q)nEbOy`KSje(j-a65RMKH(VAHiZu_6`D0Snbqe;oewQ=Pv?jjT-
zW3$x<OaioYA*7<|U;hIruU<Nsi(86}<Yc?~g~Z6c6P4=?Os9_)cDLKL3{N#wEcZxO
zi+i=Rwe^0Uh?)AVUh@fAFOw1W!uA4==mLN-++apQGsM}jm6@3*2a+G`mem7DX=pK1
zqSc|SYX7oJ;=Z%ct&#q6LCZk5{apYuQ%J3$Ei%J&Uo$@@w9B-q!{yiAR2dL-XY5C^
zB3Y6#VWhEE#SQsWY(%a|ZZ2|k_IVQFXpwPmrPH2%FePb&s!gr-_qjRonmSSC$r{Je
za*+gilYcHq*@3)MtvXo`I$bjEwx^at^CI$OJnqWB1)JijoAr0xrO>T$c%Jb_G=y1y
z{|2waX17=_Ac*LjwcM^QjxFJ>J(3D$<JDB`>@i*EP^btSQz97gN-HY5HWJf<D72JB
zb~=1~G0V%@54VQ{h3(H~qe|zXj0$)K{@ASbxb8D^F`18VWils9?@i9fJVPnbU%*gE
z>y56YK9EF(3YQKxHy_WmCGB=Bg3s-eFcWW~tOuJicF>5oH}hh{Mt$wB;6OZAn2ubY
zU!NoQGrcRGX7cj*%4`;6zGBz-tIOb$cc!sf+*o_HAM$9xT8J!>@RFm6bH}yP5Jl&;
zdOl8$LvKaVz)2zX?i!SO8fWA+nW@ztWriI6!2i!3@pk8}wNa{eagNfv)E8X+;u)=3
zBC17m=!6$>L!u2<FEzCYsyNP7u1OY7`@Et7R&GZZ8=HY3a^5H32!(<fUk?Rg#Y43S
zN%3Jp;{vz-vSIvRop+83Ne|bW61bild+Yq5x1FcI;@D_|O#DxL4Da+jx5UN9KGV+A
z&Bn%-u2f4(Tp{!Z3qoCf!07Q&<{dG}fKYwxED_{dDCHlDt|mvsJ-4>LUv&Te7?~4H
z7o>7O;uxRSe<`F2+4sWv!f)SVGRzB|4<7wm5Km+farm<!_eLnouM;n3YV)ji%Z_{d
zp$S%4CPX!CY--UL6og%IeBQKqa2Ksk$?$j9EB3+KcGzqnG|BtDcL*ZfSfwY(YNLYU
zckUk48eo~3?$^QG-FE;eFfre$c{rFVtEu)bUhUXNxB2BybaeCd=)Ln1`QJb=|97~D
zMR9;kr|_>FcindqZTTKovZNvSRC!dX-O~zCyEf+X#qqB7>;{K9?!qZRYqY6`f2UD}
zp;ZcEf)rk@CEQH}0|Jv&Q+m}uLh($k_85-McWC@|%&{Qh@&YV_erDX0lsx|9MknDP
zuvAt7Oi>nQ@OxCX+9x^Ob^W6TPh_rh<eX%$UsSEz18*Pk2MC)brh}Qyu?N%dT~Bu5
zob<t4S6e;$h59mWuT`>nl9K8a6dEt<);wRD%)3+bH|NkSTm(U+X+>Mx+;OLx_u1t8
z_cts+DqgmKtXWfivNO)#KbNUf&S$rxa}fi9kByyY)GatI6~}`X$;@n~r(d_1yoCJV
zRS@(VRe0fhS`b#VpeYUpA;WS#%e+A)-$enJgFSl+X2<O-*SXvUUj5FlR-!T%gX^9h
z8~jI`bbL%&^iO-{J1wfeiW1+AcIP#K=E$W5gBERnKeR-x@7*dnF#+}aTSm{9`o@aQ
zE_H3p)v($;O`P|94`9=m;6y7v7k~T1oNR2fot<5Bwo_9az`yi6zYiKa{x+K8@;^S+
zo0mL%cIFzIn$s(zw<>Im?6wi?n1M8f-qV|rEMydhhyfS5St$NhZ<j1Vt(^8P>{f;N
zfW^qWu_BX;&9~|3GT;_6)!@?O)5%0#+XAI^{Lgyapd+4Als$&O=JXRyhPwc5fGquM
zYfnFs!2kazda+U#7a6JO_PR0{>Lc~?%`l+Bx@gE#fy61X-$?xM;TZM_`pJLQRzs0W
ze{M^rmNXKoCOSn*1l`6+nOSQTr{X@y`i6=soF&KcdmtjiNr=AtZ~%F{@H~IVqDJ^E
z8P|~zJmdvRm0$lHR;FsI!wXg-mK4mcBvF2UsLs-nO94rk9I<BjZ0$ZkvT>J#&Sc38
zzz3=3u87cF&LnH#cVJb`KeW-A--a+-TWdG3`WNwZ?bz4!V;H}eIPMF3pbIhiKZ*@;
z9yjgAC2OxM1h$`+vvlG;H=$G&)2S>CVGoWOt9BL_^OCj9vwQTuKkMPtQ$-*J=I8UE
zo&N0|^Ml)Q5%KZZ#EVO-<B8UD75ME*?hLhK;o}3oQsjuvTM*q?TYcw{;ClOSoOipn
z+N2)?R<|LZ!-8~s)3h8=BJL8C7vpedf`}P9C@Jmi@Yrta9Mfa8-g#W&$@Q8*Z7Dkj
zI3B2S0mF$rKmkOQU;S6zJ1=Cop^Cd-LsiX&%=K{om;Y2^Q0JDAwi}n|JwD=;oxm}2
zKGR@DDdX&lm<o(=bmT}aJigGmY0~@g$W)mD0lm8-YeSkD=m~nf0lnS8lB1)nEkX_E
zfe=XKsxg~Q*5BX1i>6O;x>b%S5EcKqo&^<oZ{AwOjk(tLsiqQq_>N;FWTvC()B(${
zsx#9O?{?8nR$4l-aGyx^vEaFyz1hcGnF(;wuuL8bEhh0K$2)I}Kiz_Gp<TswvO7g8
zZ8mV>E~!BfpNo_A!S-jdkUWl&XFx)|M}v1Iob6V%#gD`#qhIoC6q`O^D(%`-+2AtC
zvly?Kw~l7d9x6s3DKg<S*j^=zkL8W;;y=+GD1GMk_N@ZH_oq9>l*kgw`?SU+Y$W}&
zTu|v^w|E8)9hUUSDqQ*yoWz8p4X;5k)$l0gXX!yZ=6M5ma*u*N0Pe)fQhnF0MQtHn
zCY8)6-UAOhMRSe}{B2s<+4~_vk~QniUdfU=*tOa<Q$X_wS-`9i<A#rM><rBw#~tk#
zeSALFU&-vP>aA?sZw?y;(g%RX4H)yw{urNNoPGg;fDv5mL)YJbOAs<?h)2`s`gK1}
z7aj5H_uYA7r+e}PQEzmCPH=$I|C%#%14W>g7Kvaa>=z*So58u^&2UErrpFZrgfihV
z4lXXP+pIk$5T>Gr@>&3@(Ml74gm4YGB~2LB@hG6IY+-F}S){xEWW@f6Eluly+(Eaf
zyd<jsp~YBb+OsJX;E>J}^8zqgmw&rW-GLR=UD$Ak2FdFD_Z9st>4`RePaM?|xt<RM
z#O7uUY!HOyx^+Ck>EX?bwSogW6~*me7mD-Vtkdec&UdKm=wLbok@|2kGAbyNTsp|D
zZoWUs<Z3UN&+`gX*P=9uO_!-lZ_lJ|tV>0yD_zk<ni_6Vj{MYphj{i^cZZ7^I&t-Z
z9)zGzZ0|Yci~nBabk*oz>R%yHi~d!DLmHnW)#{$#(x$Z1iPH{xEqnU;ZmYA>@r={}
z%4(=GZ}3r4S#e=2%rvQk*l;skWLIp!;wL;T#vlxOBt1a6)~68?cx~|g2==xocOq~K
zv<|o@kV9__=0>b6?r&+xUn0g!Jc2NI6B~av)n%I$y>n_GO`o<pQ|;$<mAasR?^j5I
zD|B(`_$bGs@g-O8)+gGo{j;xOVz?IYpqFq^GFZ@)KU(c%CiLgZ`g)<hn2pRyPZy^`
zNJ{wJX!#A*ga@vO4QLFn{X{%a@?u{@FyOc291Kw)f(MXHloBER+S;?#ex|tMln;K+
z%SFStF5u%CJVy}H+dd|Al>1zJyi2k%aSe%jJk$R=&G^47E9~01VC%j0CS)<oau7`E
z=u5px)F`6_NTK}`GWPs4s#hxnMMOa5sx2<w8EqlcXJJ5SeYz<>Lr40f|4cr_|8IU&
z+)RO}uw4#{<WxSi-<Z{vZBKFBJ`|GAX35o^{WfPYa<gl$MLySOb!CO#Sgra{`P$HA
zgKPh)9(pVNk$cftGx(KUH=pM4=|~S6vrnHKkDmy6Pfvfo*M1LcZG~6k9oO^vjrN^n
z8*ObATaaJ>gJkL+zWd05BS&*^w8C!gNo&mgK+@Q@`0*Sjqc6^!Mu4h=gYQQ$xn>R0
z|D-`Z53I&end#9*%a^@Y(zR3~mqN)*2P+fVgf;fv>Cgwa)TYC(G*4-p3Xg?Ykv=h^
z+wf4;bi&#Y*_dSnHk6#4kA(djPIO<EI6B&<j~D9hLaHotexhGQga&X?z%-`6JVXmc
zUu($L;wH&X5|NsBL*Y$ldMMLu@9`yY^mDbdqbotOh?AXXL^4BK&5f_Bbc0Gyrl0!+
zgz5gh>n=-cS;Z})Ja;Q-`GWfh<ZiFVTl6!E9qz3)wNzC_EAD^)+}p9YSnGPc=b`s(
zF!Ux~t!iy&iBY%lT$@yLpwHzim^(~0dHp-vafpHZLW^<6eJ6B-w8)NlYUW|*{RM8r
zcJn$@ReIgPklEGo*In-rYYm-IuJ0Z#_UFR;)_XqA4jL#@tBsJy--Z-?59G(tmATG;
z90}by&6-^Douv=iKl4*mHZo3Dq#8ag(VM2Uc9`srGAz}Zljc2LVbu5}+lK}@iY|Eu
z8$NwlX5K<roGGl2`}KoW8E*zU=40E-Hru~TPDUdjeQxoSS3AGvxe255#y^Ntz7RyR
zYcx-=q_R$qcTlLdmmLWr(66OfF?lPn&-)@dx5H2W;M_jOgl=3;=Nosq-~=nofY^#i
zzUCZ5w@1JH%tJCtab-o#$nX~*4T;CAKbm2l+qio?<urHJp;njfz7J76g6NmPe-U#f
zE-FgcXo9(u^)9v<<;Qp)d%|NsZzCKM5|;&qGnMRko~e#s)=3>3*0mk}TNZ6p>Zx|V
zQ`Iy!6aZJ@oIwx}-M7Z{<HOm{xE7lZN>wJwj1K=K)=Ip*{>sM-xx5dfMKX)c&OwbY
z6M1ydWN6qfO2J~iSo-V;&sV5v1v()p3;Fs73>w=RX`D<<l=Sp|Y4TH_!PKg;l(%m)
zAuCk}#Gf7p5PzB8N>sJS!1dLf9GB5-l#KHU8G>|?pz9u&jW<;XB)Mn~yM(*jOWB?W
z&%6GrR=HM9qnQ4f7D-!?aG1ZmBRNWh<b}WTx(&Z}(JzsDWeDNXGj75qmV=o-z0&0a
zNq|A!Y?`BSgooSREJgnbWh!GuKOVo7OGnl2y0rb-l6B$&%2x<vuF~EwOcqZgsg0D9
zC};cYv+J?qcLZW{Dfc2P!_b17Dbc}SI@B1&@Q}SM?-t?m(_R0m*O#trT*26OIb17-
z$v+8FO5BERFAx~CWp=B>UU7hsktE~dfqrTo>&P0=k)8!(yxe}Lq+|ZULCKd^=~SsY
z--o<XZ83X!w##px5?;NxcTY=9>fN0@06V3L5B%nn({OR0c6`U)SEwiI&~ePI;rsk!
zpBeG?*thQ6%;J!o>*D5k%Cz5tp|P`&C&63d<Lzu`f;8iyLV38)m)dU=_v&0)pUC3B
z<P#RRRKwlSY>*CY<YPj^E-7K1WIkft=uNGRm$y<2|7Lg(*dyy6OjpP3i_^biwc2d>
zgmmZ3M7*I`Yhm)h<kwW?na<ia2OkLjOauSzY-y{>_>TpKHFpe}EdiU&K$}Ro_lI|G
z<z2mnE>-uu{?!+d8Gb~^I~S|xAKoHnpb!6rbVf$C*tYa<m3>!CT{l{S(goX4vs~%r
z=3v2a&_hk9Oe(=h>$zg`SG#rX?IA<U9pvX(Si7pLN#|3`pHT4fmcb8Q51)xKFWz}B
z5W~nil-8MK<A}rJzFb=kIL1?!`B9%{4Ig?c<Bj*!GN`=T%)pfhd2YTx`|CKFkKFVL
zw2*BzN;9QJSH1o?Z&xu`=CmSoXCh&@>UQNl*Y%~707it`<0QRpHhEB9ly5o^GaqO9
z(DS)*o-Lj@kDuN!x_~n+w3!zsyRa@Ms<n;rdQ>GEqn=^juCg^F>+<@b<Mix(3TK0P
zlU~cfX;WOP`{+TPMa<p6>%;D>?!u3!mz$b8nD@&r=6nL<uf=fj`Gvg=9bzt4c^jce
z$g|Tqlx5eBk#yR7{`9a`1f%H5vYrZNNM)tpCjll29MJ&N7vEo96q6LVezXx!CRZ&d
zN9Me#0wtXolQ+xznr*aPvN}d0muK^TDG?bH-nnr`!Y_*Dke%94%Gw;Aq)SJPcz2lN
zkg-P@psYCu2f_ZuSH}`Tn1)B<cMxS0cByJ*x3`?%d!kKA&9tc+5u$g|)G;c53scN^
z80W!D5`8Xu)Z?fw-Mjm;g79tt^2p#yzFb-y!pbpj@G$~f&fBTTPI3IoRhQNws*BlU
z0L{`~cgX3K${^3n=0bJ|4f^N$)v2if3FL8k7afg(M;k@cK}Jq%4D`FZdwI!ZP2M}P
zyyqLUBJVJvpufcG6N$EWQ~coU3$riYf77|vZb&+p%2?(0eH7t<clWlgr(k$>hlLc}
zU}pC0dgs`aAsc+z@!Pm3KV>|-nUaEn>$e?bCCR_$?7U~d9tG09NTp9MRlU|aGD8s0
zu<PN8I~k?o5Kl?f5n6I2V@0!pR`5Jdw>aN0ZFeJuC~QC2{9brA8*O<iM#JWF1@%YE
z^lx7fiV!RlC9YD*oMn76<kO+3$&<+7EI8VcCNInM@a_dyc8e83V+psTfSEY`6X-Go
zvp^ePEOx1X=ax$Knm<W5pcH{f!X7r0zTKG!L6I%C1XAXf(@r{G$_k2ZO<m9GQ?tGb
z!#DB*X;+*MO5bK{eOuIht!v<0sCXO41Q_XOZIl#e*Ed*hD#n}vxeB2czo*vS!%0+x
zM;<wO0;LUQWA#J{9jAVjwaGxxv0&GyalV8-#x(l<CiMA17JLSJm7McmE&Jln*Ts>z
z*!hIDbmd_#o>TR6uhL}|i$<$ZVpf$&|J^r*JVh?)i2-oleN~K7RLAe7qsZ=9zJ8j6
z5k71^0lo{mwP#58GA9~oBu$yno4);hhmOj#7QX3%|AyovE+CP7!Y$RERP)iHs86aj
zcwvw5JC&?9W+#Z*NI%@T%Cn={{_R^jkbh$O^bPearfRaV<9tr{TDlA9jz~1}T|O*g
zJStx5rVZ$NDtY}Xor11~zg9(fQpne@ZVRr%Klx~lqx~&QiS(C84w<QwvO^H!E_Aw0
zOj%!D=@+k47A-M9|Ff|2{7x;z8h3_sU$6P-o<)?r(Ue+oAA|rd-0uGL^j6}lm`U@A
zyu6;V-`e8FE9?e6Ad^**-y0wa<5{aWV>6(f;lXbx&JVnFRx~QKhb#aC$9;k$KuQd|
zxd+v;*?sIOQVH-Qd=XD~MSKrau_kFEE0xhGyY9rgq|ogNOXa&>WxDWq+5QY=#VUb_
z7lay}mmJr=6})VFIq~<VvhMELC%&5~v2SNd8R0DHBks}^(_`Z7T^v>w8o!`SecU~i
zt$|BiWJ@jPS#V56xIHptms)c>d+Yvakb;D+#Q=4(U`~ue>o4^Vf)TM1P&Ixpd&g@e
z;%CV|J@1R{i!WVE)d@k?`0L~O(Z6We*QmmNS3o*GT~sAt#2FZ{9O8N;@S5)njc#DQ
zhJ`er)pU3hE$k^Jv6ZcD;+x#>QVk~w>F@NS^F*niD&5mbNM^q8W0<CrE3*Y^mM2nV
zA4CIPh!@yQ6pV0sosJK;K~bC@k<5(9v$DGg?R`ri&I}vn5@@L2qB^otJ$_5Pd7g#W
z_Ct3y)c8o2J$?yLp|4S#cIf+r*RsSZb8)=-)EU(Zv8)a2N}RmcZvNueOphJRlKM}U
zh=LvjRKK%|Z;N(N8alnoPOpay7M5^bulD6oc)yWfF|W0(B(z<hY=|uto0mVlaD@hn
zre5?{O{Bh-*4BfjWdx~BGVuN|`}TslF0fEiI6y)LPjJY{{^*j#y1~#R=ykO(^eyqh
z^^}Q#{fDwzUFvV-Z=9+c?y&bnO*CZX_`IB#kn)pfil;d~F;B|lsN6<v-O?YRu47v1
zNk4r3+Muv;03>_>dsUS}4VH&Pe`y)ST*<wwP>;9KYp!G%k5v-jwdg(A)$T|ux^@3<
z%+Kc8c&whyL-i%M*-yPXSk7Udo$m)etSVg4<dmTM2h8-LevSFUT5hz5bhi+{0td#S
zSAbj_hh}8!mbB0+3jFunsR-g=*djh#Cmu-FAKzHC6ct0BzP&|9_qsqvY~HIKN}>H5
z8mNwEp!2}(0`MJ*n&V@J*KSn}llFQ#8t%MT4|Z~We9DW=(L=>+T-FNNs0|P%xzzH+
zifp#^6F0*zkr>sF6nY!S-8H!9z=(gz?Mr^2ZtFsGTO8T->+Fxk0*P1}y#~z>cMb0x
zO|^rLEG_Kq`-(6f*E3Q+ldTs34x~YkaB)0#D5>PjAV|=jGbd8W4#5K~qz0Or#9bt-
zXawz<O0?(+%1r?Yi+Vmbz>-bJk<Xn}^&77Vyg+fH$Y#2MjO?Ug>;VQQt(W58+d{U_
z$hXD&%IjBtscua#JLIQO!!rF_B#ZV48m`#_&Y~x-B%1$=p&t=+KBF++O&3Aw1TF7Z
z-N2CwdK7;BLDJsdE}*e1$Zc0`vc@B!rYK>IuzTmpy=ch$T-@aPF_~}kA^;qJA49t>
zf`SzJhV_%82yF-ab&_6`3-+!*J}>Eo_}7jN{krsBuFuAuLIN-6=R!dzARwt;BACB!
z*4+L}w!uWjcDSr@z?jy#z3e8E)Q1e^>^zq|dHY@Md^!z`vN5C1sk+{u%<K_$(+jDV
z#Iu|Uwf(!S`&rEYXxk?nylb4JGamRwV11jQF$h`Mv$<bDM#jwYxP*+r=B@yOwW)UH
z%qQOQ(L-&&bsy3Rg-r?~=`?SQytH!T>0h05Js?j1_D<$cU2_|8>w>*Kk!QOevy}Z!
zI=V!TawFumR1e!m>or!AiRGf;8R5VEjfs)*ZC_|{Ft9ApRjIEp%s(ngLZke?)HI>1
zYoXeF=RY{x{}X}8|Il8^w5@eHWd!bMmp{ZJ8;=_c)jzPPGfgip^tzzc;-{wEi`6*?
zx{-wJfq@@Ti^<<MDdghjHZW*qpriBgLsO`!3V()%1Pm&l<L<Mdp^tym^>XR83(hlm
z8q##L?nVAHcW5&G7gDxrv+Ru_?Ie)0uYAs5-ahTST=`A64l^QFADR)}tjU9yE{Yz9
zX>}T+9_()|rE~BeAVRRV#j<|!vCfh7{zwLRWr3(R0^Rk6t*lejBoS+!WoM#zATRy|
zlr{&e@k>`Su_;Avngv_8CuDCECSPY_50FFhJNbV)!>uc|q-*6%m3)8buxybZ2isNu
zqL#SE3H)<;Sy>F{26-2VD)w4*;__6k!aUVLIDkTePJ*Y*to_#Fm?yeLjX%+6=BoMU
zAc&af-}d)MhevDM(Uum*`T4jV`I6-cmmi3ZJKUnHa^2eMr=_CaO3gmmlRd*)ms>-c
zm#i+m6IAez7SYM7uPw-`3XNyH@fDH%BMY^JC_qvq5(Hb0a&v7*OP^kiQc#?oFS@zN
zr&E3C&8B;@(eB|-!jZS_V4UJ}%21XWKIN)e{UYt^hO8g^c<O-ZC&VqaAz+N5BEpT*
z^}6QAW(xCFNAh&zD%p?x9VF70q(FWZ=saT{sB2akYVF=NaZ0i?{F61-m5e8;ex|TU
zn|>ZyNmN)Fa8Rv4cS0<lx1x1)w5W7frSf3RF}KKs0Q!|zf#5vf+9#o1eaJky(9Wlk
zt)_i^M%m&f0<Ty4PMt&0gGv`*f9d_)L^cEKzlPX<Ia#UDf=3XV8j>f9Ob&uBErYtW
zBz`?iHFK5pGOO|Ce7=5kPyx`m5QxR(XsS#u%k!mU)Ll-OzrV8*i_dgiL8Dlv!5*Z3
z?>RjgTZf9q%D}lo7ob|DTcyGtAiLC8+dH@vAx9=L*{)5>_}$ao6H85{ZMo>Nk8dY0
zuL6ok^D&;vC(_0sdw4s98ylxeD;(R`SUseFQ>9UoQ}kvXtjfS24F-~zwltnBe2t4;
zjpU{CTcZi??>9Dj;viEu%{FLki%j@88wge<C1z(+U`(^B>I+%e(snY}Yqe)4LoQPu
zb<4&p5GQcj-q-sj7?p_Pup>8cX*b>)9WG_Af)+}sXAiRf44tpp>DyvbehE@y1Pa$Z
z@iH>cLa}tu)#c~+_9F3wCleFT70M4J&21K*ox1Z&O?1XBQ8l+MwDD0W=H;TRE)yO#
z@X{O4RS+XRbVCX3_=`D9nz?JkK{uDs-`T%OF3T^%>c8BZu}1D~R1faw#@X$nc_i4_
z9UsJ#fCQ10SPWyS&j{%@(>(!tVH0GeanT%@{b_4ASlN%#u|Y;v`KtaWjO6BaJjRh7
zQJLMzQW@t(^>cR*2vxaqz~?-96UX)K;+?FH2R$F}Bl~9>Nov!zq}fnD3Ri`tFCxE)
z^dymB1V--*6hLpf@3&U6!zTMsJW4<K`eK47y5=E^A@mZ#Wy}S1aUZZEo0SQ9{ej3Y
zB*Cd|dMyFM6PiBv+kX^!eNzt^H{$SX@<k!j6(WTSXP;qXk=^@2N`1WFe@4G?6P~<7
zfI@EGUbXJ+7aKr)hNIY*k!>3)O)V1b(mbL3!weNv$24c$Viio(D;qenU6YTxyF<db
z11EjAa>yKS*S5BLn13Hu$gXzW?BUI>ijU+h(yAB^oCNWac2zk65*ms>CsavG$op}9
zQ!bt<0zI+aN;fdBo2A{a?o<R<W@ssMkZUL~)WM=zS&E~2gO{h~(P!bk_gE3Eo=#Fy
zB=TQDSWsCNt&xe`M+)*qs!e^JWoF!4Q^_%up~(J~>7RZekngIuv7P3-61Eg@){F=%
za8Rq063rPD;gP+uT%Ah2GA4qnlS0fZ&0*cp!k#}4tESrB?6#wzbPFQ7hLFze{ujLD
zo)^z%5)&V9_%sa$d^kT*la**5=+~}zZY`THJiIYmHIN{LYAesLeWe%uLXI}YQe5w1
z1@sbMt$$e<*{kuLGcas#(gl&0exo0=AaWfV!*zc6NRg8W$5Z>x;hi$}8M%?^U8hH2
zg=js{@In>a`M5Ljdwsm;7)2n+Xug3Wh#+u+5aaSQakyhT<(qiVsTnlbhYRM&`i#4m
z?1SYn%^IE}GI>3V))d;Xn}4<{p+ELpsOX-TtF8%gio$3s@X3}RVdpIdv)6nzJ``p8
z{8o=G)VqD3Q6aM*2s}z%ocXC$vZF3|WHHInH$RMafxn9qNC0_ew))Rs%+KSv!NgSe
zqwJyOL@kDnPT;$D?3*dKn*M5f?Y1~nbnb}ty=;6b=mHK8{ocM!<QR|1Vro}<{_EcW
z=3V$jDSyt_(o!)8Lt*=y)@E<>Wl7zduD}^qB>H1aP#a*8Dmv9=BZ!cVjFi`Z)Z+hl
zKg#%!7tgt|N5XMjLB9nLSL8t00h!<yHQRhdCH^JpSkL;Vl2n}pNi4i@vV8h#hA+c-
zqN)lCxI{!$W5b45*!#XIo$?B{WV}LP5P@gX(e)Gyp0pud1p8W4gj^T5*0+qmaQ@iU
zgAcs&=Q?VLpdK(ZjbS>OSdR7xBVntY`ui6PRd)4>A|a%3jRpr7kje-G6>CtGLVUTE
z@ko98>0(cTep6SqbH)4yo7ZJY-|8)eOOEyxi%A;!dP5+M+%(A2b!?SVzK;z4R_%FP
zFI2v~)nKZvPn{NdSDaK$ERDOpXpHVrHT3%vG5sSzI3KUwo+}*t8!A-gIe@we#2r9J
z;6pBDT?VCTV?DS*Q<R5`Usc#Lh_+3Ct?Rh>7;-@OQY>_E^XV8F;VBXO^`T9UMY@C>
z7B)6Ix^(_9m|1r@CN}mdHsbhbs-R$wGWb-2s&N4;SU<O&U&n28Apa<w!BJW1-}I*~
z+|#vnM*u?Lwade)K*zL8JumSSE<fd6j)}Q2Z);<tCef@Wr0aUL?^1W7lcwXv`%_5b
zsh`SWVbnIz&QHK@J|b{LVP0U|x7wm4gFJIIYiM%o$XFP6#>ix7%<}elH;WqR^{?aI
z(pOx)CdbfaWQ6nG8YJ#CW2Uq*=f1BsKq4H``P18~xN;CgE%e4BCiFMY%6Lj5{y+?x
zAycg4?oSovs$|6Fphg-yyZ%YNW%R<t#4LP<sL@LM7p+k}=A(&JMRZ)exiVf{*nRrr
zNF6i!^HU7)<4rBU-HM6_5YuZL8^U_q2m&q})JPUX9wdXh>B-aTR`j$A7}U*xrPZ1f
z_q+L1;Lf4*-zbA8R3xUvNZ1@gwLg1cjmr(#t&SP3P1Y=J^sc{D`V0nud-{dS*5jCl
zTOA2SQN&W|k?B|eq#I-2bHM+hHGO1=J5yV2)ZIu*DvfITI<KTSX=0#<`(nf0%Xe8)
z>G9hsAH1@}I3LJ_i~@ZB6jAZVMBU52A@Y+*x=m|%KUX`J?lkG|f*B<dYCe$ABH;p7
zZ}aHq6<}@*0I3J>0)`}JeKCEwxBN4g=_2@yd%7jVr9Q{EMpwWL`AeK~v-d2!=Kj*<
znB4uFGrWAJ`F{8LfsZr(pwpj3`QDYB3(pDv?1vM`^BE+nuc@2ba3cvsxf`Cf$6)ob
z@gwe87Z@STg2zO*9#UdXP7Tk^rkEJtNq&+dfy_Wf2lGT|tI%)lv@|8=y6AV7`4b3<
zQIiCwuHlmEKwkak{73%<`Nbl3FJ`v-8Z6w$g1McQZ1i#LYm`HM1o)rLflhE=MIBs7
z(X4WK4xWju-W0+G`?`Va4mW<1Ou`qN%j`ES{fRM;*Col1_C~CESy)n`W~97MIDbJI
z-tv)^#(9HjXz#$DJiPlIwhZ>4YCVB*a*~4X#8ruZ(8F`#lq+kI8_*D9z!ZKmT3)mz
zdeKs)#7rYGw?0Ur_nXqC(=)$;CJEGMx)G?YDG=y(h3xF;v2HH7Ph;F_r;sX|vfO`y
zUyVRRw%BpI=@gBc4-L?isrgX#;#q1z0S>Qa1!UvP<IwZL5uT$E=Cl0HD{+srH&xUS
z`Z2!VMwIk}HLhVLcGf0EbPpV~sf1(e^#esp%gSyv6L9M4x=gMO^=2ya@<jO&bzfZQ
zOp1Tt&>E%m90$Bj7K0xj>P~R$?JN&Rz&TNL09Om#?FEHb6&0Y}b_{;t;aN-i+{YC^
zEx6@eYv;stNB0-wzt8XrQPj6pN*DdWLhpb1mJ>JSxG#D%5kNYz*7=h&fGNY1JWrNy
zx?5M^IN5#2miFVvS>QH7$iM}?AoqgMOWCA&c+k77ZEC90sd>>H^E>%lI5{1F5=370
zEN2y{d|+SukwD~wNXGljg#6xHkCIQD@EU>VUPATzod@(sDQd@MFIlJGlzY=DdJ6G-
zZEYZ1jmq~~sHkk}4XxH63F+plt;jwQeS`iJ9(aP{NM{kS0cMXV@J1fpiMa`fY)d-^
z^t8X*p|N`-bp-%xatwoR$EA*U4h^u{V0b18EMI%!gj6T(5d4t{Q@B_8gWfLwYNkr-
zReoy*mYFQGdM|B=b3L5Uy7v2_ek3_W-~1)Gs=;{dmt`fagJs}ck@devzhVh0M5@en
zY|<4n{8<750`XgQ5pVAH+y2S?deYqYwY5Db>I#*;-oB-9$R$;bMQQ}psW;JVU&oyL
z88`k$56Tos?P9|z`rAfB0$0V)f6gK(E>nickwTRJ_>r>0Kzq#Ip+8AUL{UMpaQL!U
zLuOB}abF=0q-~^bEI#*vl9~%ze|v#vrPec>zZ>;T`sgGkPckl_E@Vwy0yqaiZIZ&T
zrAa(yJuQ(pi?t&DZ0$2pVi0}c=(@Y_nhxBNHB~R5VY}0Di-O{NYCNBag?wX6OSbZ@
zc5s|13Gl5nds@;#XYIk#)6UV+=N<29x2RjZN9=+r4RpX0qmTJJeH7EvAy)T_jgJ_w
z3V(RIY}WhwI(PW?@~}vJE{tvH6_g3Rd~_vq=5s#Ef9Ccu0c399>1TQIf_3k^TmM44
z55aa%2)MTvJCkreaChlAt+|BI_=E6W?$!MKowY>1i6-PpBlXsPMoW-y;HKFO0->e;
zT)V^FCk^ZId|SSpt%8#kJprN4*g$D4{8@R>nQ=H3H8bfyiUnd(SY79(S_vca>w-ib
z`~u$Zv2@L)q~Jj^^&&HpQj>nGQ`M%kz!Ou`(&=QC{p+6#+WCm!lw6(c&QzU)fiXgn
zxV$DAB3uk+f=|;dK$%@n-2ZPqXvt9TxBt?EzQe>MRJoG#!2cq6i%ql7rIE9-T?%Go
zsPHHyn>%yg71Dp*_uXGjXg-~zv8-QCk{GGQ%Gr6B<FY)^H!Vi&MJgA#=%ifz#TX3O
z*!Z7ByDg?{pDJ>MBYEpGlncPjCB6`x2Xb<z^>mc!soE4)+Zaf@C@B#U!!UtR$QWX?
zTW(Do-UX0MyU8!Cj#F@OjH;8ReIRTDe}P)Xw$Qk9i7z`Hem^LKew$9tS=<5B$;^tY
z96MM_%5a%iHeIGp*^yDJ```Ib=q#buYT!e!_+Uo|#=<#h4f8*mNa^^8b$42<?Oh`t
zA-nr=omt`>sK6W+)0@)XS$=r=Z@UKFoalfYvrUIp>@p@<Cb7@7r{o1_!6{Y?3`@vk
z<Km?5PaylXdfL#hWn~A)6Fz~7MK<NU=}=)lwBXK0-#}z9i|u^=gcxL!io6@s)weQ0
zd0zFlMRMaxsQ3KdNSOw&@RubJ?{C@6W1SU$S(ux9F*`E1tlhJ2VWf<q>T*loxu+&b
z2g`$aBo+xjelTEs6Jcgg&Ms08P88oZlNE!B!)sh0jwq1P`|uY6DZb`d^K9r>=k`{h
z;XP*u6QCwogI4Jfs{dV`do#~+f{N-+<HW`Hz0eZjjoDbgd-hz_P3dc#A17X2B)xI{
zO7{Q9+Iz=y-Tr^WN~jPO*%T#vCY#F2mRV*-gpj?dP&Q>Hd+(LKl^xkDLfL!!*j%p<
z)!F&|UcdWsU)O#Adpb*>_vd&Y$Mf}E2NOB-rO$^60VC;f<fqvppFS$ub75q<l$dU}
zo&bYRS;i+$@-7BoOkZMjtou-O+1x`K!e{gBa#su7v`9phc;BNE`S=T-w2<6u@7Bfi
z{_^(Hf)9ZD*1xd;jwYMlc7u3YOyVV^k_G_i)M;r6s>6iX=b(N9Yvt*OeG?YhEcH8T
zr~c8r;-c}t5sOL%?$C!^g0Twl6I^XM#a8dQa8ZKtHr&VZz0&bX7}FxIsH5GjPQ}!R
zV}nS%GgYCDA(v%WNZux-ql1-nF`4AN<5M??i2~famQ(T#?d=`sKKBZ+{?+@5y`<$}
z51~N%EyVeRJloja-!BqfT{zlu?Jq4Yh3JF979PUN1LmPP8o7ttGH~B8%~dN}Q6`?p
zSvYe)eSeyj=cc&Ii3*>Ym^P40CbWI+qWhnj-|I|hj^Np01c_4SqEk<U->gQtO|0~c
z_SX*_E;~tb77e$uYjUqe%98c~-0#bgEr;pS;+DUn_VEUJ`>$c-01mbk{6x<cGD9Fh
zU~FC<RwJpR8WiHnV0Hpdsbn1NB@np0uS<3MHFb)U@n_A2hY&}>D>=balwC=!e`R9o
zmOLvU6O)#<vhtGwoMTobT6rU<tkur??`?P`+!|!VL-fhLsh|wv$(gyQ8A(ybXo#7V
z{%d6}9y*|(b-a##VF9r_fBF7zYonCMzH*DAL?mx9wt)M827-}mQMBWwYN1g&!JEqg
zWAr@QISAb|e!RvmsFQAPmF6zdc4I}voD1(5nd;lyFV~|83rr%TVju#VqxBKr!=AAL
zg`1g~vnSR(@%$boK<)g$p-XKTHbvp=lV406M0A0`?nEudydsqtyRx?|c(;OHM<A~Q
z@3i#lv-CKm&2|rQ18knb?4a;z4rF9-_!3`y>mw$r^55cJFMhOOb>)*5{W+zyOzS(t
zeSbXJN(?^wB%(i4754M*`0-6BQAFw36Ni$2Q__|ADm8f=jRDe8|6A_G(xXb<0HmGZ
z%Q(^f0oQeD0mTEVfS#oK^*>yamDax#!i55<jh;F?IFEI7d>vN#@>r@sH2E-!f~35s
zrcQs8awWED?nsI}3DPLXL6Alglwh#k&OCD9kwjXr^IF>9TQtIpdWQ3UH31EifTu$h
zM5QN9#nN+`VFqU<`HhHx8V3U$L-EET^F$?E<yEv8<Qt0xg#w$Kn==EfR&9~1W8|Gc
zHN^v8^l<W+FXDUB_JO0Vy`BA5kIF~8XqQHSH}3VnQ^m{+y}iVuezdf@T8@lfY!_$a
zTOm&1ePcv~_`I;jPZ-fUIrCh=d%mnX|3dVfo<Vzn{{<4Z#718tT`Z4E#%cll@c8w)
z1R>mj^~~R3@7l4H?f6<BbJuTVgA*xonUon^)y8@EZg;%vMzc37kdwdUybU%b$^|Gc
z&4UO|4|6mL=YpF)m#%NcMpu5|XzFd6Cbi72oB@V~tQ~Af6UQa>(zg@Yh%d`m?NC$T
z>u8;%oeQu|HMO_be5+lG;vLoGlP&EhQc%pkGunYzgvx)okGK*QwQ^-q&c5&$uHpIX
zwXM|g`Z1J6xYHCFjg%tkL!SiF<{9-etnzkA)PrZ5N>A~Kr@)&HSf;!{4h3u^EF9$L
z7n)eR7|^=p)lRoav_wE9x*;JM5!;?KkxE8;yz;yMtbDqA14B(cX;eT8)PCNFG04zx
zQsO=mZKB5iL7OJWXmfKF3%~VGFxk^%H~q@Q{ci*Sj0aGEuY#;g=Nw;a)1m*L#*_b_
z)Tej9)Tfe4+>OD)e0W+F72m-wg@NrLuT>*@%lOe{*pUOs|A<Y#yU_!MDt#>K57p#e
z_YsMS97DWL_Qza6wRn%rpwI9lb~T<QDpEa={tr~@X**0C%CY$K252Op*(wMHm{VL_
z9<MPJp6<*8<|hB+)SRTM(1C_$(!%Eb+m8}jO&^V1alHRpn-u-eGoW<m&+^uCZBtlN
zS~bDAI}Np5FYEpSi65yW?F=hu9`o+jI5+wyIq%uTZFu8%Q_GMhj<(>IBP7~kHlrmE
z!Q5jjaFI>@4DRNv(K<!_<FRuKD><R6iItR(?}KN5i&8~yN;DS5p&~eFdzSOsn;+dl
ziwE9SX}yoH!C9Dbp*dq=Xp6}`kI~F41yoJ~44mvMN7|iN35Fb?#vI>}6K~HB{`K$o
zUj5~k$GI`eS9w$ykc`AT2A1>7d0PKMs=1ds_5KH>x((SJ@YWk?KFVZzA&rb<+m*ON
zGz54H(4%oez5%JaID|n3Z#+Q=jqPdMGd5@IPF*@dtto3K5d_rDy?8HBt)PQr`h(P&
zdBl83DsJb>YwY!0aIGqM`-+_Pubes&v!1ifD#?H7+cZ$h+u2t*0QUZDj-kl>%^2U;
z!jFK;Ro+%YJ2|9L?T$vx_9|Fo+l={Fyb7vNw8ulzO5srg9Shr$Ou}pT1LROF%W+lf
zKpBCINza_bq;F5?$OUq4@6M|~cnm~yNgIUlJhuks_wL-NpW(8csvRt(*ah{e;GCYm
z3^wMvkj`iKmr$Pd@-iW7d{|s#Y&t|yIi7X|J$RrU|DbaIPSkkArV7Jn{PMrUV2WN1
zBs9tn(Lwnr(?pH$-?1q(FWd!%MQ(CeKu&0^hGW!2ZrOq0=Iz;XcPB1wJk#N_UIkfx
z(X8NajP&V68`Hww+Q;29N@ssBMc9-DbiS>0MjS=|MXY%>L0{boulCUXIGy|#uQsNp
z9bQuSD)7SF8#biij_XW3%i6o8S;v_CEnn+B+oW<ga=d-MlHabZfbF@7FPUn)I9LVb
zTe2*L^kh_2R9jSeFU4toZmXwR+d(rUmEB0!xZYr)3WV$yzlU=J2Q#w+;yKl6WkE*<
zcYcu!K(OP9hN_%=8A&`xsjh%?6&Y7^T(iXV7Ut*Qz9$R{;VAa5dX=$zJkfd?3~V2b
z7;iY_{0+$Id*Qp(b=}=i_9dIqtOr+^#iZ4BfJ7PpyJ$8T?#cO33(DYx6cf|b6nz{^
zkmLm!Fus)<)I^auKe)IV2XCHSNO7|kr+oOk`V7Sxhko;u%=wquj%#{wnBCW9>GI*;
z9I45j-p)s+%1vJ3Ryt@Ob&8qwrYZRBCWEy!(FSvF`4wJaoKJ%EYmGs$V8l(&zQsr)
zHGNd7HXzA&9ir_@e~T-iO(XTdYYT6|hw~7+3fzl=MX|)RCm{@td-j(!cvc%<<BZM1
zKr-9}f8)B9@PedyN?Fa{z?a|@g@uJ>_xSjbG0%(fdy#&hH(*{Qy>~%C<kSMC>4$T;
z$uSUj3lbklP>I!Tl#2}78jVR<B8j_#7<-McV@^l=``Z}(U<LJ76mo2^oPU;Uh8!D=
z0r0N8yH?97a|sAvfRiC}UwSb2pz7C}@I?tR3>V^SQUAid1vk(cj&X12DMKTl+?yNZ
z<E{)x{Rvt8jt%i5^-b0&sR~WQ|Im<w1GNd~Ou8IVYoo{cZbIOkwdq;maZ8R7ggW3j
zjg_huc={c17fBh{px(d@CxWN8kpF{{B8}=QE!tu=WlTq}H+qoGnENw-+Xx>md_qBy
z$`%*Ct4M&j{dyUCKODFEUN3tN;0nxPs`=FH@AJ)WWyIH<U||{w(FM<%u=L)>Fs^Lz
zpw}BSonEHpKsT4b^y~`w8}E+njDV&gYn}><#A674jf{NVLoB{B>J^k#!gPH52=Fr<
z)vqTxw|g#<>Hh9?%<@pYNInGPo{d%suc;{`RiEQjQ0}UhOHvuz=4W!Rm#F2Hhr4Gk
zAv&66WQwhM6;o9Q6i%;|fJi9;`l2S(U&Oyq9T3V>n|E`tibaJOxFYik^+^c)Dj$0K
zCEMk4YoB`wud`9XAt>8JiZ|hB1&iE$D_5J}FldB?5JAd_OsgAi^B3m!XMWet!XYk}
zqeHsiUMyougUw)T&7yWoNv1gS3W8E$`5Gj|)Bgr02Mq}sg*e~ID>rG9U;hg&=dK~q
z@<ZCO+p15`U%i!La2FDu%rp;0iP!497&qtp>FLTgQC%LOoM(pwIf9tw>PsEDXZO@L
zglQ<b%`LHFPI`98hHdZdXSp<8F7F76H#(0w8aJ)c3&(mL6kmZ-LLsnE3o-zdEzJ4{
zsSo({VYeHlwN+EUg7};f(4OtldGmcqtA4w5FHf?6*I*xHO{bXk%{!zb8_JO~e@joN
zeFU)yxy=AR`LHYPmewYAK)Kbgbszj4K=0d)B_jJ*@LX-3FcoPpd&>o(y9CjI_y<D$
zr~Y@Ay_4tMhTY~)9?)2IN!#qiX+)5iimed|zOydKYR<m&7#nlj?n9#L<82`<SH<={
zXmJvM#6SpP(cfl%8xq3N-`}60+t>jolTW$PFZ0;rkbnS3aE}FZ8~1Su3buF1je-M5
z92{tNJuNMa;PyUvudMN7u<+n4{{!?GuziYP?arnw3yY%14MH!)CY!bQq)I|(r#76u
zaOfZk``^)AHowh7T}H>U&wA6{{lFo~5c8TDY(@^5icAY4^Bp6v4SEslIbJ_F%`~qs
z(X%O?{&m7KW`tKP_I>=Y9n6qnxEGRE)#Q<jAufJk-uW(9t6G2&h`w-xvgBmy5QzaH
zUE3MlSG)E3qpzJid@uM`fy1ls>sK_S#mh%&7e6Goc#8FxXA79d*V*IH9zf$Oq`+{L
zduJE?hr5So%^nY|FD&dlX9Fkudsbav;Q@Ffz}p8WWzWe;2~LuCfw&aGSYSOfQ8Wo3
z{%FChowJmS?C*I`=l&b?C|~?MB08fI{J1y$(U@(-*4vgaLD4`l&RQ{lNQMR5DAEn>
z7%aR&E~Sa+PYndx%0u)DR3Su3yQNRyFJim;M+>IZ7POx8TzP&3>MZE5s*yWYP>gnx
z@VZ#p|1~eoeL5!ZGI9#BRBV@H&CTUZRQ>P2<o}Am{eQ#lig?5I+3kX(VQj$cbQCjJ
zw<Zgg+b%=7t(8dOrH`a}=dHpa*(KXzDw&(dUL==(p=AhvIzKUyhK=q1!Qi5!j_y~f
zq<ct6y+9Pq8~qXkDFZ05{@G@K#c9i(>Zm{lQ22-_T)f(IxZchjI8e&oJz9<S1gbDh
z`<XmL74BhaRJ-u28q5PryYcEN_axS+?Mal@xeA?xH{p%HigX$egPBUCY_3jyf!Ae>
z*_Ma3h!5dk+<w`)22W-qB+yQI=ZH?O4s5p++MjO&UL7h;v!dA1RB6`;%|JGX?$N-a
zE1z=I!urxf44^m)8tjBwD#0uZ*?72ty0^&WN47@GTXyJe-Z&Kw<Go7ug8fX~2OuFa
zcLrFQncZ||z_E?AtaEf|Fn3hDIsv$aI<#nqIo82ofNqSSIDlG#&j|303ru@l1AD8D
zL(mZB!PYqz$vvJ|enNdx@!*_aL)UVRl0=iUw?Q~v2PM#-q+cuV%;doQdVBv>ew%02
z5T?hEx+@5c{+{6X7WNs~Sjd-s{bn!03ydm0{ht$F_w-yR#cRG)dm*C~xSz^yO}AaN
zHp}Tl>mN0yTpAn6G@Cp7AO`-TZ94>$`!h$wO0|C3A--SPpa|nc13Sch-Xa4Oz7ind
z-k-noJN=DR<AS)K2`?r7j`|{fPXuAFA&Dl$!_Oc7YL;HbhRPRubx;hSLERZ6Qx*PH
zx|!0oZB59UT(kr;rf@5qif_4pr%mukkqrW#gRU@KImHi(`jIC&+MfN8Ci3N&9Sj@;
zb5;SS{|E9>5w(982T<YztIGp2?)1ggzuF0|&WH{6_m4x+rjuw;B#+b(8s%oAT9I~~
zCpwLw4f)tWE3>p=?FHlCV01bI|MWRG$k~_+7-mfMQM7Sy1SF#?80piUJ0=J0Uavf<
z6*F~sWQUH7yH2r0zx?qDsaOyE&2}9A{PtJK1N4E7x!&-uvpKZyM=I<eKo1Wxnn6Kf
zTlOH?|7nUeNl0*yATzV>-?cb*b{2~b<WHUV2ic{gHlZ0vJX}{TP?c1rz^294ajs|V
z7w0GC`4ZaK_SYoibk1eceir42_<PD}507PG5sz!9p7=w_<0(or_ce3#x8=4u3tdTM
z?ie4GZ9%2Q3nU$z+CKq@#75U)>^ex1QrrWt6^+S&Huf(En1EImZe8Uk=p=a%!*Twa
zK$WwpY1v=TM7KQ_fps2-30Sj+!#}V3@1(=_C@<oepM?UH<&nV^vWqMQ*;Tnb@xz72
z_Hu!?pvINu^Bc5n`}$V*=4dTL%0=<cnMNRt-N^4`E>BLP7y7PLA`24S2%}Vm^`YA5
zOON|<@VWYtf7)-<IG4a(r=HN@ruaMdFoWOq@};KS0$4>7rQ_NE2)o{s=d{7ub7^Nr
zPhI``q>l~0<md)j(Z#}hxZ$v<lBN9a)o`bf1i<e0Azb3PsqK37HM?e9KZ849f2XoX
z_c-3wbX|W-OwjeUSE0MiDKpPcxivY9M!PLc3^51-<|U-93&WIv;r;zj8<4#0%GGwh
zh(V>E?2c@j`N5;}9Vkmm%4%eV-_B%KKtOqkQ1<t8{_QcN{wrjzR|qJqtW7|!r_d-<
z{IRqIjJc*>_M;#P#xB(2f)f5ZZjtFPm7i^KuT0&H&ef>o!6zg9-S}{8E(Ja`7?tQ5
zoZhf~0y+s+94$Z4kw8x_<f8Y`9zKc{&BpDSR><SylfvQ7U<FD3-R~jF$_gC+j_2B6
zAW22iW_Ft6x1VtDU$`UmtiX@2cdZp1fBcu8TbCJJ>Uxx(n#$sObmi<9WNBY3_<eSE
z>|ej$?Mi<TShs<yTEDhn4AHAP9Q6?1PprX~ze^$rY*M5FeS<~pSM6S0(E2*N9J}hm
z_nqt;A8E81on*y{_6Ci`gI@>U+1Z@$#%n3lx-S&jK|R+B#NRc^x?TG~Qoscr>%Zv2
z0l5KsWuDB2P>OkPsW|x5`KdIRS}&_!ul;MwyX~|Yt<_M&lXk)Z{DhbL<ODnQXIaAu
zX5#Mh<2>*JH(c~Im7t|nS9oBKqFecasQ-d=ixukyU*!2Sz@EyFdi+i#pZ;U2qI;Vg
zbL_uzefVArRv)9dMqyJ+3yV{9(fJ4R^1{o#x}+p0^qAa|-LDf1wA$ZZvj0o%_W$$I
z|IuoPRozn)?A?bmo!`M!*3=XWAgGUkWul7oGty8CTFcQ~25Eg)V1B-Wa-X`heZw^*
zG5FztPlyP;{=cZX*vQlap>GwZ03Or^Q~ahRvMAjTz&V-49^+_dLx~JZ(=eWmJ=$N#
zyl%79y0K+;HykkPP$6dgWE!q)e~wl_-!~q+=bO+gx*78Qve7+1;eq9ocyusaC39la
z!YXBcgYvro@H*z++;4n98G2&(4(($PRvw5EsKoEzN2ZTke$XKs|B@rm9?9vO9jEev
zZU3iXK&)bkC#U^S;>Y;nK6s!ZrweiogE|Den*Q7L9dr{%h$4^(vc_;tK;70qh+%B@
zH)04xsi9sS*@mP1dzp2f&V&4)KMx_C4rZ3a)kc0r@{p8d>NxUC1Kix09T`xc5*(b@
zL*LU^?aGHR`bG9QUb~63g}a`}u(&uIDL?)W3}<W$J=WIxdi=F~XTNpgI6)roYU@}f
z(QpbOS*VgVOUrIr1t_w>wL9262lzZ~;Gcx=1yZ~A-om)UkYz$Ku$MsVMt~qh0XLvQ
z#$+H@z~lg+Tu0zc!}n5GGOk>bhBQ0lD3|B7MfRw0IJ^dA`;SG|d7x|h_5W<@@^qT~
zVtVE~ved&*8ais~>x=K%n>UhQO+=!H&SUh@{x9_Kf!8s$0_oFIojvwx8MM1-LmgLe
z!>Mcy-iWTJWk?>Th+D^Dt~Zp?>@5Eg(jI+!>?bI!Q8znGXe?K6!nIy0^*%@0&5BEn
z*K%`nrhaLqss<-+Exg{%{a>U{^<y2mnKvjC{E_FFEE402k>ORHQc0Z2fc;abmqwf{
z*$yyYh&Cc^<(fqcy-iJ5Md%j9+o6~YN9(#xKNeH{?USWtbMLRE<;ulju6oz|?C2kg
zXE^w^YBDZ#F#N4(hJH{Tkd3%aN1NuVso5~oDLdW{BwN)!8_A{JW7JSc_nP{R-4)v+
zxYs#JA*HXQ7YZi^JlM=%K$ppjt{Ekygb5|k(v>`xQ$k>FhE7U1;%cNq7@L<zKx;xN
zP*qt{NP}!3gh7-e95Q`pt{{3zk(*P<C_7E)e7GVHGX7|K_W}0#+G{K)4zibF$Vy@>
z-j_(u`qCvHNIE>mH92Wn8ay)zcLX2z5ubHjt&@hWpJfCaBg}8)1*{G2g+KEaSl=m%
ztWuZ!59FNlV1lc3H1^<+*LGjn{cNON4fVND*9vYCD_JvO+K7l;-HiC5IRGE`^p6w0
z5gKG39R5-)uL;pXeX+d21-V=9HAoa8K{ZBTJ8_jg7qh1%ER5v(2J9WiJ$ATgb^bHR
zn#Q^q3%WzxhXX2>zs!r*BnysHjoy<ESB{$J`WTH`LOFwZ-98WEZf{j{p22Xe%|Ip?
zhqFI{v?zpnXF|ar7ePn{<ctTuXfYH-55oxH*N2Uv!d-c?-(CK_-~H0X!t7;zMhB=&
zwj~FDu_X!HNNo{!2iOwBf!r!jFDUs7xOBF>e!ci?j&X1LxtGqzbVP&`fJpfI;`J|~
zoOrsz9qKdxc62E@{p0A;%%=`<@JOFIL}u?!8lWzA!D~F1Vq(s)fq9zasm4<a4t&?M
z&_B!l3+?WYKWZ~P+Qhm)O=6E;Z^7Rlu|;{QF~H2UXXb&bUNpK#;WZSbi5BTaU#1V8
zp2j>M+DRD<Zpu%aT8hCU?Ohc7AADLNhq^d8?0`q{SiSqPdNGqU*y1q4bRsyBEwzNa
z*M1*yNIv6=2}POS(@OB_5~n+y{@nEsvB9f<Ol+KA-!eOuHI$?EmqZvA`uU!oY_+5c
zL;I&b$W70590_zwo_-8F0Kj1apZ2?aQ0;s7+#d&+QszVQ8=ikOL7L}pLeKs#GrlLA
z3RYJzn@h&uI)mzePve~SA}2z^gW@#ip3!k7BP8LL2lnooVP{8t@RUv5L_2#4Ohp*F
zJ;qns^KYNQ^XYm$cO|3G8KhY6YmFydiyq(P^t3@uP))7Xl9S^qU+&-i#E{XffBGLg
z<-w8JvU*K=`r6@9%u&Qt7U}Z)v(zf3n4Sc<x2|*4OVY7_u$L90lQb4(XP&t$lvF3m
z67?lmTM-Y9;nppVz~JXjA4Y7usHt*-!Ybb8$V^0UP49d&vPB5^xJ6pJTUJ4neWXEN
z+n{ld^CRPfss(4n>#G={{JxbQE6crJoAU%-qhI<6pnOFV@xt{XFVq&Sb}W>g^Q{a5
zS~811!xxMCDD`7tbI_Zl<hG8fp_jWH#3(2z&yh84zWisnbLRr{Vt8#W9zG0%R;q!4
zvo0N02b6+>2Qf#jIq7uMVXeJST(;wShK4F#kD{F}uX$d~D;UB&-&J_yr4V?Bj(-IQ
z2Li6^Nbct4;Zfwf*LB#F&<Vfeg&Qmx?S*SiFO}Z-@}txUz)n4Xo(dIy^cY!3c>L=h
zFPwVL1Fx~Q$J<lzgIxA^kH{OyUy(j!L7;FU`_jrjH^F~L86awAz|qCIdx1fW9WnN)
zXG;`}d(cqAIOwGR^Roerqf0_X5S}OBC)qT*$Q)m7Fv0QuRwmP9ZMTf{FJRc-M$^Bd
zqy6;`Obf-?3*2n)Nq2n+wm6;*AQhp(chsKj5)ru*Rv(>6ai6LvCU7YGcsNgxJ5a#q
zC=1XFeUtYFp8Hq7gE*#Zss;5u``hCNgHo7zX?ZDMM22jZ+X%To#uWK7y}4lWgW%~X
z`x<c%b_UhMkspP|(_bUGmDL(ZL;JB>!MK-2-`o_t;={u3%lx@Du<~s8J*f)^5oT52
zQ)KOiiWtp?c`_L@MI#@4#_@?Xl1(A@Lwz-v*?Ea!nTli48J@(P!0$(dU_tbcH>R^1
zETrkXUGs|9bMfB*LFwX^z8f@6#;_-ix>joigNWwAs*4V+gICynli{+@{lyB3iuWxn
z;#m;9w%O<5g~Hl!TFBGVl$G{jezeBdJNxse!;czXyiW8pc9)?3wFS*RuRr@KV!<nz
zh>VQ*@@1RxhLm&X%(=N+7&DdKmj{icQ#1Ke=Y_7rBbO>?P%xn?<lUz@YO=OAQF*X>
zDhZ}5MENLxc2*GryUL-k1S*ZkoX3?jAC)saMt=7<h=`h+i`5Vl6W>*)2yS%WOtP-z
zCo`Tiwo<iOoa426O3}tZYaifm0WP^>(?dr@Mb-@2E|8zQbhmHow1hs1FOrUsH_VK^
zJmtr!c}3R)@sayxk9Ai^aBy(VBwS|}Uu2@TMzz&D{-Oxun~tB6(WqGKrT{$5O>l%B
zFRRS5Cky!><?CVyn4DU@f`g~0TEnk@d2Z)0Cj2rY0`o>&6ur^#Zt=bY-+66rtEpDq
z#v%pq>Gp%pTsJn~_cf(%>T8;G#BC-9b?Mp37A;~yfoRNBzshFsU@fiLc&@#kw0oEt
zN{!zJje6ml635<jL8J9aj)xW@IfJ5eODkKWTHtA_$=1lItQ>AeeVS1y;f9LJ-}2?7
zlu@q4*E<Aos%wagz7F(V4JxX9wmncI_rao|er-+pyrApkmzx{*vt0r_+Nl8wyA#d#
zcsAhvd2WiHH&qpUd!1su->aPU#zkvuUcQaAM=Xdf4i?6X&_spa&QOiW$`117VRSrj
zIF}R@bQ#=|OJs+0=68nNp5=*hD9=)rRpOwa+&KVOSM7jMAZmswk>lo#G+$p8$E_t|
zeEdrg3R=yep~{xyFzlKcJz^Rvvlel3x-~6V*B-ZCWMX)*w>8lU`{QeD67_PM#^A0o
z(q&~ur#s})n0N%$Bt-Vb;zqh=A1Oufal2y_U$8T#DU%r(XDF@jOsm0lY){@jGQkcl
z`DR3tR$hC~;?R#oaQmBqYiD2D!?aK4=KP?N{rdsE!CGDSe&>;wa%=LbPv`91(ue@7
zc@KO!At4yFa0M?XGyq<_e7V8SzI2t5drs)+yJfXn$;u;%?<K2-K38zoy@Yk^fdnY6
z389baY0|&k&bK}>*K0Y`?oT$fDu^xJaLNSd<1Vput^`Hr$qNagk&`{kx@Ew}>d~Xn
z;$q&>HVJd5XV2V=q(Ba#wM*)-uk(D^c5SOIj{V66!VVvHX<vSWXdWd9NU6z$g;tGL
z?hQ-s{(cgpRnCcb-7rdIB-4+V4C7r*w;QI)Blj(NBh~NPm1ylDvTT>sld=@<`4LOm
zcrIVfbtmq{vVysxFGNr8Z1elrQXRp&YQ7~dmF{iLiHT=$aQZ1+Xl@Wl-1IGa&jrha
zJl<dGW@)*jWBj9hYILDXlhYFnAj*uG-1ftI`7&Cuc|2hBASKR$v}5tEvQ~mePijC<
z>K5$Lse3SJ6FQ!?c-;Fy7ogtU`}Zs|0p$F5bQap9=q)TQOPzL5CZBzO`lBP<tbSTd
z$w0piA6?DVG-S@#89c7_!$mMNjUDzHWrQ?-GxGKsJ(w0;muAbzx;vZ;>uPKHD8C5Z
zp6cu33V|jezsaB{b5+yqKwebI<U{F2l1##7gDKvO-iJy0u|CMX{5n-_+xR!87E#a9
z0R`19PDG0A^4L&kb9Q-2!7gG5XLeg&5MML6O<TrOsM=7$$jT};6>P<u(a~i1<9@4F
z$*X>=^vbOTb@~yJGS0j1<z+=wqf8ccT(SStJJ3Sjpy^Zeer=wxAU!?u)%Yn?htBED
zN3xQ>l{ys+SMc%KOuzp?!%X(-D2=_!&oxjk878)eIOwfi=ZZ5%K8AyMk#1)vo(F}T
zrcNIsBTMX7qgq~sD$)n!_dZ-pfCWGIx-+|}MJ+80dO?QCq9Y=%;7!zLfS*sGH?xvZ
za}PZ%%wTH{KQk*1!C@SR25biMIk@R;AT-!-@&#X#jVa64WF^+;IR|^l!2$ow4-0Dh
z&88;YxnbxtO%Sa&Pv+Wyw}*{QQ%R+()Dq*+OvMHvZ)Rr8GaAZZAHC1$nql2fscpey
z^8G2)LOc*OlJP|?<8QiRtf;Ujpp$*P5UPJKgm2#mc<JCyzNDsydsI7nl20Z-k@KIv
zVOEyz27X!fEwocLHps(2J=+g!pWa#LU{_=gL;PVAgr(#a3{oxA$uKgjMCV_PV4$G*
zzxj38UhzGs42p@#cBEj)jZ9Csa4El*i*)*zr5jV#elHEG{agk%^tuMom5f^q6RqLH
zBO^<lopFP<ZOx6R)G|9&W8ok90x-%620_!sdC`4*{Q6?S#{VJ;EL1EA+=-f3c^Eab
zkk{|S7e$93)U^HnRK0?_)z5$CLsxD~LL%gu`g672pt0ep<cC;inUMSMd(tG;)p1-}
ztIj;oUc4xKs^H9y1LL={y?fFm`akuRl|saX&p;`yiW)i#@}FI%MdfC9p1M0uXsG&N
zF=tTZ`pkt3a|WGh7v0=SPhXKw2vNq|#Y92jy7_xM*=!$(sBqu;%Bi)~eY3)3D74s=
ztnZ4l<xB^<OM0ZIt%yt^v*2hYukJ*X%b?R`VGj<Gas)Av<BmhdaM_*+{4;j+VXiit
zYRwyDdx6{=dJl++GM|DiZ_eS_=8ssl8Vd%kv>UP2@H{MkKd2`-y491_{d<|j-E}PQ
z1!%Jv@5pgQ1mY6lP4pIKEO*2?bLA&aRL;zFfK+KZyuY<zA7P>29(^A>wiUJl7c#}?
zxtz}UBqVuHTG$>8B}=DORYie4ZNzST(rA<{E4%ygeF+JPA8SXuDh~kg>@+L&6h%f(
z1~;`v@;dKEoyNP>E&m3`EYV75ES1Ap^D_R_bc&ehYZh!`zFf;`x?Q+aA^I%l{5=w`
zXAei0t4G^2Vu_#nO`PApsH|3;9jg!3uGeqgoFm@*^2M#}s2W#I7@tXF_w##JRKuYi
z?fyajWS`P0MgTfb9PCQSxmGTC9G*HAT^FV`WpQe-08ntvo%TlZ@;#YPEnzr;DPv~M
zx8-Vul|nf)5fS#AM&=Q>8Cxr_V<8u`gaF&KBeBp?HQfkebbu{|Xu*zTM6E=Qi?6)H
zgS2?L<O+jjq@(WY%1pPB)zwba|A-}QmokCnsfdmIu2DFCf7iD;5qLSpF3#KkKp?8^
zii!|QBQU~T-mS1Qq~LC_oc5-1Uek+<h-mp5k=+0BOG`e5b3yImkl1b0TUexo&EY_(
z^ki$$tGYvCFF&0FF~>vuIr&MB7V`sNvs9PW`f}Utpjr?(Wjyq>kUJ3Njmgqzez&GA
z`N5%~C<-4&I=!chU}zgx(bgzgVKwM_WjQ4^c5AUUGZRmyJG993K+VPUw#d)2hLLyu
z%9cM|#)MBTvL5!m!yKRbP;5HvB=Kw{5`?(%&!2mPA^M-RIzAo}L*leBU?Tx{Ji=Ws
zFDN+>p`5LB5#l#xABDGtqvOq<Ae((%SHqy)mZm#~UplXp7r%We^I44CaC~VbIxeSa
zAVN)UYoh<c1@G0mme$A&LNRjlF|SW|i(mLDr=uUB!2%}!Js?Do?A7#+Q=2$`TgiJF
zhlBx2fHzicb;fAc0{5q;$#_Sebtj8RNfC}uPB!$r_pZ)ZwjY?n6hRBuFQhQ4@;U8p
zFxA@)I|77Oe-U}d&zFC-m0dPllmE>jG&_=&D_cwz^o}X@;t?s3Qouqt8-;63$`o>C
z7&#w#=-j&Q;u2L~Sn@YUV$?K{?)A2P^dNtHJb_zU|4u(Jb~{%_L@)PTtSGVRhvr4o
zeD0&n2KDt4RUV$t*#t;zM0C%~WT<O*Yq>dGNof+B<aUWo)<c~IMzi-yx7nGp#Y{~<
z6kUqFp8^Y!jqOYpxfvUqoPW_kr5{$A%EDL1RL8aX3m4+WZ~-*kzZu>9BbM>8Pl$!;
zi^J0Z>7XY6&rl;oiv&#~+cL;!PnE639CwwAmiAL^ZO8(XNI2fMk&l<%#?)6KyefsJ
zHiAizvUFIkKX8$0gKLtOhX;Zv&SGsON|3wmXB$^K@7;Gp#|bo^6uc=#_%58A^J+~{
z*Wn>KUMyThRi}q9=C5Zvx8Z45ZheB3BAf;rVD4-?a!uE2f0swWN*UT+z@(vTcES1#
zGaJNdGKYCI(oLXf&7&ZOTSIl%WoyZnsZGHR18b%}{PRHf-Dls{vhz~hQg0(7<&3&m
zE*lkuTdl1yqTe~j2YOU)ciGtpGuhc_^nELrUQNlk41c=oI2Mj|VeoX(!!&V|sXMNK
zYo>*NLEM(927zZ^6KRLEF8<_Aq7_qH*qGIDLgo8rO%SFGWk^3gFewzQm~^Dqf+DYu
zHreKx4h9pGk<l4(**&jJF%YY_qjy2>Ys&lh^!lng3nEccF#<ocvlnT8T;WDSAAw$M
z60D`AMWA!<&Za5EByKeLp>NVXRReWYPJKW7p;Lc$FDt8dBssssi#~4p2Hqj?urX-~
z+%Zg->mN{v8jC?Qnz&fuFc0VVaP?6;wU5dWpN4LG@z{E84Lkd^1@+xG%Wxukuc9==
z2x3am<HC+Vj@{*S#NKf{vo|;4e&9B@SYlRLpq1tx)Y)SB*TdPWQ^0|Tb6Yiyc!L0T
zDdd$o$J6>V(*;}db{h>=BZtGt9g*e@apZzYxX($`M9<REJvyq}89y5-t_i>*5kOC6
z#dlFZ?{TT!zQz;<C>Mw0@?+YZM3YRu@z*xZxy8ki43(94H`;wLn^XmvFU8Bac$4fH
ztqshHiQl++lS$KQ+6Lv7I{l*i*9Zmt1luGiQ=~{!VKr#GetxokeO*FgBq5!~iGn4T
zz`5<iW<eh}JB*|W@%JEBTk-hQEm%X%0fr*Uo<Dlk#5SiVvu-`A7@V3Vc8rg`8kL@e
z+Ectd{AQZAfnws#o4td>tpn`W*Guy_zb(ERG}E`YzfI<Bf_;2!hB)cX<m&XW4;|g1
zLUp#u9cj91Zx?NI*Yald(vMiju`~>fVdPT!@27>YduG&mG5AdwR-Ekc!0_CPnfVE6
zlcS1^iXWpNBzbc&7tx=!i8;u~?{G$9<i#Y*F>c!VdHm~@3gIHj;+ukzZ0-V!>}&(4
zF$hUJv;eBS1=Z>p!+d;`S1f2bEpq{L{?er}=u7?79$p;CZeZi+SS}{^#@k@<+}e7#
z^|CFRwI32nIbUS~FHCXv++fpVs=3V{$2-CWD62o&5p;<iQC^%uPMq3$@b#lC`2PCI
z72t7Xj{hVJ8}bJ>Q1^a37GgG#qohC;ftm^-5%LGTphBKdKS#a?pFP?SH@b(Xdm|hX
zg_E8bVi_4qg2JlONc2=5fkaQ8&MZ~j6Z1-D8d34d*!j=dPdFQRG8v4h#|Ol4<J)Tx
zGT^)UQKMYB7omP`3f<iZvcesJyTLiw)?26{7uX-l*ixrL!b!Y;zz>KcTYbk}Rq_cR
zpSrU%?-K*&$<u2J2P3#b63WWwv!eRox<EFYh0BBQ3WWu19<c@X;gKeMpcEACr5v@v
zsz*7Fw;!+i1?`2MwC%59ScP8{R%uD054fGnL_{|yTbWbz`ycpqfo$-(SwIwlF+mT_
z%DWtuN^5KH54T&_zQWi$(i*N?_~Zp;6tF)#O^-FCMA2=x5UvOF^ZO|We*DFHU5RmS
z7+ch8_n|3gPZFj(2={$Li;usz9fj~VBBclRL-e`}yiZ)iBz%cZ>tEZZzDAG<Rtd50
zW{-{87Tz%S(p&iW{Aw00mnesbg)hS?AyyRYKb%<viKE3DS@$JPT6L~!ns5Mh^NX~6
z68AkZ&#%o5_S(*L2t<lsQ?#;r`iEhW=FT^eO+=T|my&uvVbVK@=9LodK*^AanWb~W
zEXA;Mv$3azcBQ4ULk5D^cIoQKX_2oj&5vZfT3buIQ*P2UG`*G}7pQpK<>i&omuWAp
z_&z3vX+(E4_7f@)Pi*}t>7O3okG~&AAtlY4lw)@DJPj}q)~Gpv+mJ|iDr59frPVB^
zZUYt;&enKC#Iq=yM{qzQ2NX7bK6T*R-;CwIK#?75VYVzqF;N9^`f=>EZosf}$iZX_
z#!SgdG2Re=szXTSBzDGuzGkH=l>K6QdliPDoUkeAlzYp|4q2qbdaI9j6AOx7$ost2
zhT#Neqy?sd0m(M09dQ}7D-7>ND?h?^2C7?Y;Y&&HCG`iZcgGuWT(*YE4<%SHko7#G
zfve}<>wo<qXB)w150jy*T+!227983!#eSRCeyy0d!Bz%mDdEQUV<t+C&nhC3Oui|z
ztfZjp0$Sm0OBsC^zm3k--Yl_?qNG&ynvM6dU+bXEQT+uEe;QLu53P#THln}o3Qk}Q
z4J(!x#&=qs=t^?NtBT}R5uOdYi3#U~>Bz0h0+~}^sR9bjZOz&{RP+D}H1$99JSMeD
zhtMxZrDi0VB(C^hnw<Prz-1t>XEUdG?FLQc+UjiG=Eee%@K5R_V4-%LRjB))cXjD+
zE)MyPnr986sH(u5lalr|OYJChv|TLjU3MPDt<<e_CD)#*j9Lc&Y?(+JTt5}FDDGAc
zv*EIx;DHM6La0sf@W`O8blQ;|Z)~I&<lG*}TMX9BpDKh3W)b42sv|5J&#0r&pFDXq
zC;|7%98dH`uFswx?B+I?=Cm?PB+E)D0IcB;z#4VRxBO9af2paL*s)o>4Gm_BClYcL
zDdsPnVoPtQmRq{GlvP(_q=bV(ZY^ST|25f#ojc}^Z&~~(T((oFrHS*{@lwi)bmdPC
z#?SXl(nw!etS4xs(YNtg3cQDX^+=op?r46|%9xWK>io!7WKcIH6<vPV;kt1h>&GEh
zdAB&i7rUOncS#_FPjJ&OvI&VY+xS?`@#;<fH(V3i`JfdI$NG`)uZW0p5KF@xbadCb
z1|nYJYt}{P5lmH>k7G24UJh<PjEr6J(CHo+@O0km1GjC|y<0{V;vU|t`fKa+4B0O8
zw_l`B(sO&ST1WuRmO^``hXa9U3wPK{M&w+`uS2_X{!Z!Fsr`In%dg``vnXCGc_rJ!
zF!@V78wv#_TDC3met~u^+;opGd0M)KL_g%Kuh0Co?BP=!$RYKeFV@S9M(IJsM?xZ+
zV`RX`7MLgKU=@^MTu#C%kkvOJDPzHOl@G@n+vo-Ik+WO7wn$SQxv}wm&w*o=y*@2_
zh&9H3s<}5~x<lD&VZc8s+BE38(0Rr}o5czwRl*d{n*QtY8n6W#&A-jO*w`e{*mMRq
z-5#;Opavt>D5OXvX_mw#Bvw|QC)N0jp_~sXsE4_x3^O$3iM?Zaeq(ZB;LT|#%LYw`
zfdWHay61a{x9Hg9u{7T7f5A^Y0(nJF^D*3@^8uvIOFgp}t9*0bo4s(*z_arsyx3x>
z8kU{M`G%+UQuuc}k<0pqX+`!aGWcCflU9bad&A|Ur4NO%lVgL}MPkJpVXQ5GNlhkZ
z9ou{^i5i<dPBcP1<&@SpRO;i2kd5u(HnZTQrWiUKBAAd}|Hphz`(x;13Qu!<XL+j7
z@H*$yZ0x!2cf`=2E3~OwTW2!j-Eb?tk@dB#wIx~57YuX<sQGf;UoDrBEfx>Oq7@K`
zN`1(<_puZ|oRl}{rJ|Z_AuPu+(jhXcykJt~GkfyaGb=u5-%IBFe%L<TcrlIJ*@0lR
z&~AO|+F!_(;YR$aRa~m`I(5zgWeu9PpWr}ktaCSSo9RR?XwcNiGEKbK8C??oycXT9
z+;I;s1e9}_>$yo=X`XOb<C+O_lI@Y@gWY?x3`p@4zVC&O)75-acd?TyiZ_quvRaz#
ztd9-_BN#MI)~&`3tBQjtBt=i<o&7j_Hkvy>;!?!zB#G0~ll|BV3VUA_eK`--G;(T=
zAqSA$D;z<|=`M-vy{!ROOZIw?b&odt(I)07TuNwTlGfN2wysZ~hWR!)#%!IM;`njO
zvmRow2neViJifi!VT~!BQ0gzfF?)GwZqT2B=qPRI`tY^MI<Hsp@f`aT`QWcM9;tX_
zZ*K#Sb;-M+QD$fJPI^|#AjcTtx1WS*pX9LaIR7;bL^tj3lgW-#eVhsE8a(aY`4Ak=
zXy^{Rdya6CMie{TEk!|OKdlX^yJKpN+IfDwo0e-pZEb~b@f8eicox{e_zD<&bx<`%
zaxbEE&COmu1UJp8MII>XuTLq~6G}eVUHBHzgWnd;?lnjq9it+@7F~+|UO4=}04+1Q
zNb*yF{;7w+4jco2%T=qpcX^Z~%gewAi(@J8TkQsSRPG%t?~!1Mzq_NbV_jQU?9FjI
zXzYh(<*Pyt6cHZ4Y46^?q{!Im!dOQNE-9srMkDJ@H4V`~&BW$=EC%kk-m-nC@DdEH
z3*Xp1=Ll@^=8HZh@^%~UbV<s-Ele;%J<V6Iu#4}5eAH=#l|(zYsthALP2Snu-`Sl%
zogNsvx$=B-eZDo|nw-&aSRwL!n|rBPOuj>G?z`~Zx92epdMvUk=NKgd=d?@+Tv^y>
zyw&**2Z>(<Vh*hZVX_nvQ#2a36q2C>9G<)6!xH89Th8n^C)K@L80g^On~4eM<-%{F
z?uxH7c2m1-e<kh39**?%FFTtrPZSjH=BCF6ZIRy=7Z=IN$c%QF<LB|(SOWXDboCfn
z@KB#?{YKRPBP;l60QHB}|B;djG#<11_JXY7uzk}C5SKB|HrEY+(^9Cd+NOMSL<%Qp
zne{q;Z;<2UjDTyEXkGp0k4A8B=dy;%C7`$T(<2Nt68=KPJ!aW9_mHxgwU#J){WjJ*
zw2!X_-ggP8w7H1MYVTh*`MtvaX<udvugx>4PGF*GlB^JuW))x_9v!9P`@Z}oME2uH
zd78zaKj(fSV21@?Ld~a~^5bdRz}0=s4>OYdAmq$&olIdZgqwlL(D=N+*)VriFJ;c<
zaXysa!vLtz2f(~vG?R7VdUDpe@9<kcUNBM@4c?wfXl2qMpOo^>F0;k?@n)mL7d*B3
zIn_+D8*xG;4ECp;{G2|94wtioA1~!A=cmsNPk$~dDg6Cuo!G(l%V|0F(1d6j`n%Lr
zdi}8)QpRxd0E73wc~9yC(#7f=+a8IdX)|1V4VOn`xrpudWzm=1QB*uz-LM~FX47S7
zy}x~-p34TGpgJS#Yg?)xMfG@A;sigN;v8pCgd3;&@rN|+DtO4%1@M2A$HIy6?nfRp
z_>_XbCzvOey0WVdZ}1b67q`dv<MjY2nx2vEcD;8`T`o|iKf6lk4dSPi_wD!uAt?MR
zw_b<5mC2WIen(1<7i_vZpP4iUWzB1CM;GJvSDr)Ro0b30moFcAY@Ri8JbxUg#x3#~
zo;l6Fgp3T{%eJ<t49FCpM&+k)TnH;Z(@h)(VE4+_%5(nbKghiCPoL)V0>}U4X+?XP
zHVX+o{kA9p{=2N`6a_s$Ye{IM-g6m&CMm3&8Z~x+0KW8&abgZQ+r4sgnF_qMYj<6a
z4qWmyK`XxPeWV>X^q2#H3Q}<XO3;a~RC0o~6Nl@UDdd-BgE*TrSo`^QOgooafe4kO
zX&#l|-i)0K0dLJeOlS{tn9c2D4VQw5C;0}S3QL$M`tGeQa>wB|dJ3X#e#Cq~^V*ul
zI8BUS<-|r%Ota$SPp=GnHp{H+6)UJThR~U4cb|#WV*p3hgo-CLj=FhP0`443234vj
zg<6(e6wzLv6jHSHKxuu7pB?74TXLQuMvn1Lt(^$8dZ`xcHw2q4Luv(f@9F!CUaDNb
z{e9x0r$0DbV;ncmCZa*Lz}BK#O6qQAk$737hHpWIXpnU6>ZF8~nkKV<4zce#N)IG|
zPpk#N9CmPAzByf`^OwHr{Vj_5g?d>*0N>A2OOap!`;Q%8ze1jmx4U##YYi_M2v3Ri
z;utN157qqqyz)~YpD_EAaK6WUjvJd5nQj82v6E8FE7S{CT<b{So19BaN%?{xPI`)D
z&rst(72^Vvp*2v7B?6r{S7(KhI<x}<EB@)bE)X~NO>YLZ5Wu;&i&$(}w!9K1@$?h7
zCAHV4{*$EVs>PqE|LDrSZ*ej1+?2uVIGiwJEM+mxwtqJqU(SBxZSf>_{ulkOG$rNG
zq^vse<2@DRLN)f;@WpChtl(r)6IPSyLOs3M?ge;%E|3z6SKZI6fk{Y@X{CXLS>Y8A
zo3+iF#nfQzQvS})EYNz9`fy=#i<!$hi4E~Y)FGm{nyw+EWFj`zBS8%3YJXypyn1iF
z&z`!*P~OWPgz(P$ghk9UMo!L(v*TMo-?$oeC0;C+9zxfAJMet6zws6C)XutN^Aor(
z2fe<e*@~e~rA)eu+*X96YmHd?Hg=;*+H|7|c7r{Nk=uXa@L&98M(TFWaHTWQz222{
z^f>Zu{$ytIvADl9UnQ;0R(`V)c5(4@c#ox{cCR0Zo9`27O~~C@Y2(E#MZq{V_yvaV
zixd=JpU^D)xMMI>RB(9UXhH2k{fmHQMaLx-m*b~=&cNit$;Re>X`(d^WzX^zCDwU<
zU0o`~q8hkfZM}7$_Rcjt|L~buu)2-13Gh&%?Q-^m2iL%m+2hidXjIP|Xif6$v_}Z&
zm0eRARM*V0-9K~vW`VDli`W`SP@4UN(BE+*s}GPe5-Q1Ff*9x9CuQd2-A3?MNll&p
z?AWm*i_OxHZXJ^(VCuE13u1NE3EqC-X8$lY9XQ>eW^b^(;yCE^9pd$nFVApj1c~NT
zGrqO^B<YO5(7W|e?8tMG_U#9@2{Jd&r&f2FyhD^k_!bPpJCoJl*nj3f-<Q~9ru`9^
z{gG?uRXnLTN>i$%U5Px_-E~$Ef<c|RaL4xOVn7Q3e?Bl%Gdx;za@eK#z-cDR%1?lM
z_l5W*-i$9`@Fz{rEn=Y%$<934D{mT34j!wgEwf!+TjjRZmiVybsbD{=x#4y0@@v@k
zl9V5O_$+Y#9c1o5Yk4)0a=#l+>!xyQ7GXWKsR1P;f#2vl+Ve=}z6`>lWRqNvRH|!l
zzrlRac56BYt@pO9ZSl;K6wi4^wGr&hS(;QTGZ`8V!}sSn2Bmlkw?9XL7<TN_!A&J1
zI-SMImYbJS2l|ngt1~*uo)Mhn?BQVUpy1}QG?9yO?0F&TN1RSEdc(9=`BsDMkMV9V
z*A!_bFV}r+c!B6S`Y+$m^)F(cDf<3>g))2Qd~4y|O3I|y4S?^xr+z<Oj$-!t`qkbm
z9mvBc6#V2Tz{pZJ#&&_(ME;FzoAVQw2W-yrNZSV(BkIGLAx<$d)-^X|CRp+Or|x;)
zy3AG_N=h25%UkEW)MeuEJ<!0FrR*y>vA$+;S%p0~#tp?}a=Hy4`fXMgUja?V)$wx=
zf9IMS-u<*%0h#wcn6&RNZ|#{3JdQ<&9;;Vf3Mm5OhUqcYm;9i{$ZhwcM7d3tzt_2O
z2-2cj>Cz6PN8C9<{9^a!4#cmGA0D{gKBicgu2}L0Ap|Kh!Io3_wpb@w+sLRo+<P@z
zvx=jK`<F{$;4r{1OY7)~9!&ZyKqGhCXiAErYcEtEmc39vsKw!&RCoX#4$;l(R~b!0
z*VeNJCnj49Kh+%t-tY+sP!?2|=Ht>JtiF8nytjAX%6d)JE?tiOx;~H^>b<ZD%a3iZ
zlJ$f<O`7_9y%#jJtCL9GhJ(LEw=1S#ep}h(qvkWRdX+(H!+`R&`M1jDhUfir!lNE(
z{rBnMSWo!L*53G;Lha+-9=~CHUA~KW6ZnKPv&+kQPdlyJ`0SoL>rF&q5Wm%+;Gpwo
zpH-uXk%9MppNrD_-ge5S_p0VsAR)Z8WatDjPL+j#<pQn^BjPk&d4<+39IGG~D8tcB
z{L3n!&BP=nBcooy<<*U+EWd-Kz;&OC&*mElj^&iFf-DzLBgQ9~15zw7y65B2v1UYK
z^7Z*mm_oZua)~8ff@#=9t|yMfD7tEnNCeeqm_(N%4*|n=_djH}$wbzB!}r_Dc@6sV
zkB2i<a*NPUu-4jJ?H1RZEg6dL-^`dr4wV}VLRen@bkwD13zI1^rR?GS58I>fDpr@|
zs}y5XJBPMaLIU(lZy}iy3GNTt=&qbp-_d?80=a3*(MiCX)BWKT=dUUcCWys8Oe>A1
zA+ogEdu56|zq3}^`_Y52RVXk!Sp|0{hJhDSWhRpjdXr%ok?8onmnv&1`R6vBzUqIU
z*p7sbZ>INmD)GcUDO~#$klTGQt$k2nE%E}V)iZ`5>Hu_<5n$^<zf6yYCq`sQM5?9c
zW=_uam(j5AnxLS@R@Gg({#0;0_G9p{BRAU5P0!nFwr9s!s2Kfoq(5=tM3Vl-351R)
zkr)1dp~s&{>$)!Z;ok}dUmsVG(pPC1a`^pD7;^>g8&hpj`wRJ0-0XsaQLi(>2lG=9
z1ADF#bXJkgXC~ZbIWegh!N#%ua{tmo-+QCC#lj0e!D|H%aFhN!Xj(mFRc>HhObO=j
z<41`lkK=`hVWC^SZfCRoK^!LuL<tFF%$~Drm4b)cL^lL>Y4U;Q<hF#_p&W2~<I}ff
zCL<N!kYD0%M;vx&1xkFVro+~f?^~)p!*%IgSzU&^BbV~tK+XAy$q@_`HO?5|-;7k~
zV?_vRW>w@Koz0*3vsSy3Y!aETSG#~mtbl@I9lUk>DN?o6S!iw+{OB|hyy*H~D_ANf
zxNj42v{(HGM2uIjD#~m&$#@EI3_^n|2*7tpJU5gDMHu{M3T+GDE*n0L2fIP8WEetl
z`*H1Z)sWE6&z~-UNfxrfG<OWISCR~ek!ShO`5{_h+qk(O*v&@qs(83>pFwvJKs+o4
zB4AufbsQ9^?lE%mY^a(O5=F|D+iNZAOm~p4XNs`?)c4u$%XkTv$w?O|M()qn)jcro
ztI#iQNKMP+vzzbJHmTaZ@l!IaibcQm&fv@aHkM8DDma)kRD8f`_CU#c`ZO2~U+|zI
zrG%7B-GyE{M#isjfks=KCeB^CC<1Gxx!fKTdOA8OUdyZ-tcbYq%Qyeht|uq6@R+t>
zW}8_Drgy>+JXY}=%|RY;FCuvSR^#X9n<v~k&17z@&%ztlngRmk7xkirdMNp`JY|zR
z_$6(yFUz$>WwZI)$FLLM;)hH-VPO>Jdv4c82W02rdNp(HpGFeQT8CZRtE=j<U^D^p
zOa9eDae(YiiNr*{{(J*m?&lJqC9OvcEp!udxS?-q7S06>Iu+&_2)ZII0NRJjm2b}R
zoIfUULI3%#^%#u5+)tc!T{mVP5K|YKjmo_K>3sIpTyAQRyh_pq$zjC8xBTR&(!O_u
zd;jw60gd|O*tCbY(+f&KFjPE8K(^P@>zpq125qMo4%)OuY)Q$>-*a)<?MajEib2H?
zby*d;Q2Nbw<WUpaz$YX6(GwG5SSi>h9B2PqLuW11D*B`-3l`$iJLaq9Z{J=EhM+)8
zDvGm(z&BmCoxHq@pus>X<Q_cf0;6({26teTEx;CFQZ+c>Be^U6;nr9d3oGKpfmjd%
zAGxHu1`LvxUv?X!(LFzYWFw|sTVF4}gRA&PBr3R!&idh85dpI%SSboa>jp4DthcC-
zhNIjQ7|y2Fpa(GH9sGPF&lXhaXxn>5VW^GYapc0;l}L{HS@2%$S~kC%?(RP7fHB&v
z>RU6KyBkMZWW@%!vDIH=u{#=mAq5rG;DeoE+x5nge>{az88gLZ6owr?PBDqYO?=nc
zEtv|vk!n1U&@z!+?$sZKbQy$A7DV*HrpVo0H_-jy#~!!?P<m+pe1V9CN5oYA<ov3t
zs$~SPVtE+m5_^==YUPV7Z5BTm8e|t<Z>aiVXEW6EGssda{P;Cy>e%x;nC&iaT9O|F
z+W-?&7W5;)^|At{z3HX7!4n$XogbfA?s|9Y36pRb-A8O6i`ASvz@UwtFI~%b>s5AH
zQhy6R7tnENEXPINc9(2jO8CPqwL>yCyO1Kf{w9d%Jum*ylhT{(DhNa051@wasGv|c
z`BggL&^J&Jui#Mr>*L5GevH-oOkAd;qpNy#HT8lI5ADet2!h3v!Ej?nue_UU{s;9(
zva*~Ub;q6_Phdzf{+se6>Pl)!(CZibOX1$~BZ=vX0qK6f+o9f0#R-Z>d#Z06U}UJl
zyuOy28VGMC^FtPCzMO2}%8ima5Q}>m)4k@OBg15Vo%Ki~{aOTPio8R2vZ6!`|K3H{
zCov7Fc@vz_<3Z@SNzTOFzSK+qPz`+aFZM2+>?&pp*Ur9rXra5jf+W$N<!*;pQnA7b
z=u$=w|5q9M@&5&1=-H1Uk>3X{!!B9IS=nz4%-E=danWrsx!=)1Io`HGPCoNZ0?haD
z=b~Q1*)fd=fB0_EB~X5mzWw7>0baVhfmvsC!5Iw3e54mt=F@->t{#0aukL8N(mD(u
z_I4$^yEb3iG}9R$`+H!<9L%Oz$oLqv7{7IT;tw|cqir!$B_(@^@WZ@U2>u=LLLsH>
z$XD<?o0Q*?>_s)^3$ZnDve$J_%T$I93{kKlT#xpyNCXF0h*7H_4BA*Cxu%UBt)tB&
z?z^Ns1wUa%7<?xIvdq#j5tSHX9NNa#_1j26LWaLR^{)@}u5KVG$gCI+pWph@yo2M%
zPhe@kdskDVd>5qLH|&OZA2^r8^K@f8eX*LqN{_ex(mz8;Z)YxVjV`A|{*pOGQ>1-J
z|B*TU=>Kxua~7Y|l`Q}%kU2gpoPd+?U6Xb7<`uO2muK6-KnLd+Xe#(i&cKv!&0M^X
ziH_m8JX9?6fN1aCyRB5GKVodw`)~4JnwuZB&Hg!7wyKcN><+<SPhZ^E`F?}D_>ksp
zr)Q6k)f;<zdXJV$Fp$Y~&;*Bs+ymBmtF)|WZ>gL=_=-xuf_!uYyTPR!fSlVKQ!Y<~
z_E(_SydI1|*i3J=Ke(|lEgMM#_RpVBJo1iKY6ZdK?P*d`q^}t{RFj%Bknbqy>cYIU
z0`pKT;V6#n&f2Nf-XzIAps$dpR3zw;hKt}d?i%g_|2>$UY5ML-hJ-xv5=2Hl82|pd
z|EDwHmvNgrNHh-iNiKf9`>n`no|0<3ccijhRKx?aT{y%&5!E-^r5gU%EP$H<?(Zx8
z`>Rx4+;?lISKeK#Gnt=0{Qp-zGs)yzzs;q#Q^2;bsK}Df+jp5>eq{eA;8dpT`5VB~
z&W|4bD!_UrKCt=ZXW&$bA+Q*VubsO5Zcvuc+E(df0j-btKq(Y0u=loxzv2A!;YrKn
zNkYIi1~<JgYpCRP%3By1>F1|H);6UFB^G`9^R|W4*~s`ga5qKJt^4<zb$%V`bpD~e
z%4N+W;M{0U`<`E6HOFGkzB)QpN~-$TD&Q!ATD;~gUFbrpnB8GITo;0XQ>a_HK?O4t
zN`!+3V9}O7cYg*3c~N2JSKy{}Ew|vkIXAnf08hGce|>GgZGGK);0^=epk&3wi;LMg
ze(z0eK6rQU-z}NS8n&gcCQrGy<Klt%$c#5<ujVAZ0p2;U_wGjecfa~=xwj|fA5}kp
z{=bw!{Kc*oSAE^uc*D(0f#vY4>h~+1_B8@a5C#Kwq+&+pSlrIvA%8f}20eNieEq7n
zTf8hvS1Bd=KCmMIY+&p&1@>R&#C&gH-1`F5@NE5SSDa=pdT)>A)Jwogq9D+`h>L2H
zu26FRx-{Wr|J=pLfN{QBe%|+!>hFQuc}re?(%5?c$-_$E$$0%eJPX$Y8wtQgN5N-u
zGK-2HJv!<+2U=k64FW|WH<BBl9Q!xV(C{kX8DJ3v94Gvl{w;VJkGTJP;3{N>GmOA8
z?wlqtu$yvJC4S!mu0;NKzW!Nw=+ymRujRbm4ph>>iIjpjP2335)?kUhfCSDS09BQ-
zA(gc`Z~FIcY-$26N@lphII9fQ@8^V+ut$KaYT(L!Aw@IRMs=4NNL_;Sz1s{xXZxvw
zoc(6urAwFo{Q2|d&6}?RERMip-PPpnr6=CO1+K0~>p{+32)4zx1lU63QUJBk9FP5m
zsEjaqcxj9GWPRU*>F4MD<p+h?7N8D}P3;;b8rs^6C4f7`>bXINI+}_3?tqy4;b^z`
ze`e4gEnSHHo72w+eJKDA762Wx7v13N>tcVS7`z0y3|{FdaP_=sJjh&ul;n#o-k0@!
z_nEK)n{%)2L4kc?mv}O8J?yDkuxUVLSLFkFKx4OktEvrwH5XVT%T;$^Z8X7oRobzC
zr>1H@s;|@3)Lg&!+pQdqCIv8h)oEm8<P+D-?l^&YMcT2rwR<ayMPZt?GvmP$FYfi)
z-iu*{80q-c`_}abjsi~@c9kdp7ex~HLWuX9heK5d{GIg8v_gQzvf&^960ybIBC}*Z
PfMUqg)z4*}Q$iB}mN*&K

literal 68283
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

diff --git a/bytecode/etc/bytecode.urm.puml b/bytecode/etc/bytecode.urm.puml
index d675ae398..224e909ef 100644
--- a/bytecode/etc/bytecode.urm.puml
+++ b/bytecode/etc/bytecode.urm.puml
@@ -3,7 +3,6 @@ package com.iluwatar.bytecode {
   class App {
     - LOGGER : Logger {static}
     + App()
-    - interpretInstruction(instruction : String, vm : VirtualMachine) {static}
     + main(args : String[]) {static}
   }
   enum Instruction {
@@ -18,22 +17,25 @@ package com.iluwatar.bytecode {
     + SET_HEALTH {static}
     + SET_WISDOM {static}
     + SPAWN_PARTICLES {static}
-    - value : int
+    - intValue : int
     + getInstruction(value : int) : Instruction {static}
     + getIntValue() : int
     + valueOf(name : String) : Instruction {static}
     + values() : Instruction[] {static}
   }
   class VirtualMachine {
+    - LOGGER : Logger {static}
     - stack : Stack<Integer>
     - wizards : Wizard[]
     + VirtualMachine()
+    + VirtualMachine(wizard1 : Wizard, wizard2 : Wizard)
     + execute(bytecode : int[])
     + getAgility(wizard : int) : int
     + getHealth(wizard : int) : int
     + getStack() : Stack<Integer>
     + getWisdom(wizard : int) : int
     + getWizards() : Wizard[]
+    - randomInt(min : int, max : int) : int
     + setAgility(wizard : int, amount : int)
     + setHealth(wizard : int, amount : int)
     + setWisdom(wizard : int, amount : int)
@@ -45,7 +47,7 @@ package com.iluwatar.bytecode {
     - numberOfPlayedSounds : int
     - numberOfSpawnedParticles : int
     - wisdom : int
-    + Wizard()
+    + Wizard(health : int, agility : int, wisdom : int, numberOfPlayedSounds : int, numberOfSpawnedParticles : int)
     + getAgility() : int
     + getHealth() : int
     + getNumberOfPlayedSounds() : int
@@ -54,6 +56,8 @@ package com.iluwatar.bytecode {
     + playSound()
     + setAgility(agility : int)
     + setHealth(health : int)
+    + setNumberOfPlayedSounds(numberOfPlayedSounds : int)
+    + setNumberOfSpawnedParticles(numberOfSpawnedParticles : int)
     + setWisdom(wisdom : int)
     + spawnParticles()
   }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/App.java b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
index 4d41fe6b9..f76a8e6a4 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/App.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/App.java
@@ -49,33 +49,21 @@ public class App {
    */
   public static void main(String[] args) {
 
-    var wizard = new Wizard();
-    wizard.setHealth(45);
-    wizard.setAgility(7);
-    wizard.setWisdom(11);
+    var vm = new VirtualMachine(
+        new Wizard(45, 7, 11, 0, 0),
+        new Wizard(36, 18, 8, 0, 0));
 
-    var vm = new VirtualMachine();
-    vm.getWizards()[0] = wizard;
-
-    String literal = "LITERAL 0";
-
-    interpretInstruction(literal, vm);
-    interpretInstruction(literal, vm);
-    interpretInstruction("GET_HEALTH", vm);
-    interpretInstruction(literal, vm);
-    interpretInstruction("GET_AGILITY", vm);
-    interpretInstruction(literal, vm);
-    interpretInstruction("GET_WISDOM ", vm);
-    interpretInstruction("ADD", vm);
-    interpretInstruction("LITERAL 2", vm);
-    interpretInstruction("DIVIDE", vm);
-    interpretInstruction("ADD", vm);
-    interpretInstruction("SET_HEALTH", vm);
-  }
-
-  private static void interpretInstruction(String instruction, VirtualMachine vm) {
-    vm.execute(InstructionConverterUtil.convertToByteCode(instruction));
-    var stack = vm.getStack();
-    LOGGER.info(instruction + String.format("%" + (12 - instruction.length()) + "s", "") + stack);
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_HEALTH"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_AGILITY"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 0"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("GET_WISDOM"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("ADD"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("LITERAL 2"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("DIVIDE"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("ADD"));
+    vm.execute(InstructionConverterUtil.convertToByteCode("SET_HEALTH"));
   }
 }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
index 52b6e325a..ad16fb7f2 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Instruction.java
@@ -33,17 +33,17 @@ import lombok.Getter;
 @Getter
 public enum Instruction {
 
-  LITERAL(1),
-  SET_HEALTH(2),
-  SET_WISDOM(3),
-  SET_AGILITY(4),
-  PLAY_SOUND(5),
-  SPAWN_PARTICLES(6),
-  GET_HEALTH(7),
-  GET_AGILITY(8),
-  GET_WISDOM(9),
-  ADD(10),
-  DIVIDE(11);
+  LITERAL(1),         // e.g. "LITERAL 0", push 0 to stack
+  SET_HEALTH(2),      // e.g. "SET_HEALTH", pop health and wizard number, call set health
+  SET_WISDOM(3),      // e.g. "SET_WISDOM", pop wisdom and wizard number, call set wisdom
+  SET_AGILITY(4),     // e.g. "SET_AGILITY", pop agility and wizard number, call set agility
+  PLAY_SOUND(5),      // e.g. "PLAY_SOUND", pop value as wizard number, call play sound
+  SPAWN_PARTICLES(6), // e.g. "SPAWN_PARTICLES", pop value as wizard number, call spawn particles
+  GET_HEALTH(7),      // e.g. "GET_HEALTH", pop value as wizard number, push wizard's health
+  GET_AGILITY(8),     // e.g. "GET_AGILITY", pop value as wizard number, push wizard's agility
+  GET_WISDOM(9),      // e.g. "GET_WISDOM", pop value as wizard number, push wizard's wisdom
+  ADD(10),            // e.g. "ADD", pop 2 values, push their sum
+  DIVIDE(11);         // e.g. "DIVIDE", pop 2 values, push their division
 
   private final int intValue;
 
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
index 526a8a377..ee223b5d8 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/VirtualMachine.java
@@ -24,12 +24,15 @@
 package com.iluwatar.bytecode;
 
 import java.util.Stack;
+import java.util.concurrent.ThreadLocalRandom;
 import lombok.Getter;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * Implementation of virtual machine.
  */
 @Getter
+@Slf4j
 public class VirtualMachine {
 
   private final Stack<Integer> stack = new Stack<>();
@@ -37,12 +40,21 @@ public class VirtualMachine {
   private final Wizard[] wizards = new Wizard[2];
 
   /**
-   * Constructor.
+   * No-args constructor.
    */
   public VirtualMachine() {
-    for (var i = 0; i < wizards.length; i++) {
-      wizards[i] = new Wizard();
-    }
+    wizards[0] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),
+        0, 0);
+    wizards[1] = new Wizard(randomInt(3, 32), randomInt(3, 32), randomInt(3, 32),
+        0, 0);
+  }
+
+  /**
+   * Constructor taking the wizards as arguments.
+   */
+  public VirtualMachine(Wizard wizard1, Wizard wizard2) {
+    wizards[0] = wizard1;
+    wizards[1] = wizard2;
   }
 
   /**
@@ -57,6 +69,7 @@ public class VirtualMachine {
         case LITERAL:
           // Read the next byte from the bytecode.
           int value = bytecode[++i];
+          // Push the next value to stack
           stack.push(value);
           break;
         case SET_AGILITY:
@@ -107,6 +120,7 @@ public class VirtualMachine {
         default:
           throw new IllegalArgumentException("Invalid instruction value");
       }
+      LOGGER.info("Executed " + instruction.name() + ", Stack contains " + getStack());
     }
   }
 
@@ -133,4 +147,8 @@ public class VirtualMachine {
   public int getAgility(int wizard) {
     return wizards[wizard].getAgility();
   }
+
+  private int randomInt(int min, int max) {
+    return ThreadLocalRandom.current().nextInt(min, max + 1);
+  }
 }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
index 4db97f119..ce62b276a 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/Wizard.java
@@ -23,6 +23,7 @@
 
 package com.iluwatar.bytecode;
 
+import lombok.AllArgsConstructor;
 import lombok.Getter;
 import lombok.Setter;
 import lombok.extern.slf4j.Slf4j;
@@ -31,16 +32,15 @@ import lombok.extern.slf4j.Slf4j;
  * This class represent game objects which properties can be changed by instructions interpreted by
  * virtual machine.
  */
+@AllArgsConstructor
 @Setter
 @Getter
 @Slf4j
 public class Wizard {
 
   private int health;
-
   private int agility;
   private int wisdom;
-
   private int numberOfPlayedSounds;
   private int numberOfSpawnedParticles;
 
@@ -53,5 +53,4 @@ public class Wizard {
     LOGGER.info("Spawning particles");
     numberOfSpawnedParticles++;
   }
-
 }
diff --git a/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java b/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
index 196d2b55d..ab7643129 100644
--- a/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
+++ b/bytecode/src/main/java/com/iluwatar/bytecode/util/InstructionConverterUtil.java
@@ -73,6 +73,4 @@ public class InstructionConverterUtil {
       return false;
     }
   }
-
-
 }

From b525d871b48834a12516ca33d4d7ff06510670e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Tue, 23 Mar 2021 07:59:20 +0200
Subject: [PATCH 251/254] docs: Fix mvvm readme (#1689)

---
 model-view-viewmodel/README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/model-view-viewmodel/README.md b/model-view-viewmodel/README.md
index 6df1ea5d7..928b5a06f 100644
--- a/model-view-viewmodel/README.md
+++ b/model-view-viewmodel/README.md
@@ -99,11 +99,11 @@ public class BookViewModel {
 </zk>
 ```
 
-Note: 
-* To deploy this, go to model-view-viewmodel folder and run: 
-* mvn clean install
-* mvn jetty:run -Djetty.http.port=9911
-* In browser, http://localhost:9911/model-view-viewmodel/
+To deploy the example, go to model-view-viewmodel folder and run:
+
+* `mvn clean install`
+* `mvn jetty:run -Djetty.http.port=9911`
+* Open browser to address: http://localhost:9911/model-view-viewmodel/
 
 ## Class diagram
 

From 74f5cfa670fc78dcce4bd425c8bb492b340c2a01 Mon Sep 17 00:00:00 2001
From: "allcontributors[bot]"
 <46447321+allcontributors[bot]@users.noreply.github.com>
Date: Tue, 23 Mar 2021 14:12:32 +0530
Subject: [PATCH 252/254] docs: add jinishavora as a contributor (#1688)

* docs: update README.md [skip ci]

* docs: update .all-contributorsrc [skip ci]

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
Co-authored-by: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
---
 .all-contributorsrc | 10 ++++++++++
 README.md           |  3 ++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/.all-contributorsrc b/.all-contributorsrc
index 9cd167463..250042777 100644
--- a/.all-contributorsrc
+++ b/.all-contributorsrc
@@ -1440,6 +1440,16 @@
       "contributions": [
         "doc"
       ]
+    },
+    {
+      "login": "jinishavora",
+      "name": "jinishavora",
+      "avatar_url": "https://avatars.githubusercontent.com/u/40777762?v=4",
+      "profile": "https://www.linkedin.com/in/jinisha-vora",
+      "contributions": [
+        "review",
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 4,
diff --git a/README.md b/README.md
index d315ed8ac..36bded46f 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=iluwatar_java-design-patterns&metric=coverage)](https://sonarcloud.io/dashboard?id=iluwatar_java-design-patterns)
 [![Join the chat at https://gitter.im/iluwatar/java-design-patterns](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/iluwatar/java-design-patterns?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-158-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-159-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <br/>
@@ -312,6 +312,7 @@ This project is licensed under the terms of the MIT license.
   <tr>
     <td align="center"><a href="https://github.com/noamgrinch"><img src="https://avatars.githubusercontent.com/u/31648669?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Noam Greenshtain</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=noamgrinch" title="Code">💻</a></td>
     <td align="center"><a href="https://xuyonghong.cn/"><img src="https://avatars.githubusercontent.com/u/14086462?v=4?s=100" width="100px;" alt=""/><br /><sub><b>yonghong Xu</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/commits?author=qfxl" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://www.linkedin.com/in/jinisha-vora"><img src="https://avatars.githubusercontent.com/u/40777762?v=4?s=100" width="100px;" alt=""/><br /><sub><b>jinishavora</b></sub></a><br /><a href="https://github.com/iluwatar/java-design-patterns/pulls?q=is%3Apr+reviewed-by%3Ajinishavora" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/iluwatar/java-design-patterns/commits?author=jinishavora" title="Code">💻</a></td>
   </tr>
 </table>
 

From 6d7084f18d2ef25f4bbb8a1d1f4cb5e4a48a474b Mon Sep 17 00:00:00 2001
From: Subhrodip Mohanta <subhrodipmohanta@gmail.com>
Date: Sun, 28 Mar 2021 12:45:42 +0530
Subject: [PATCH 253/254] remove labelling trigger (#1692)

---
 .github/workflows/maven-pr-builder.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/maven-pr-builder.yml b/.github/workflows/maven-pr-builder.yml
index 7166604ae..f529920ca 100644
--- a/.github/workflows/maven-pr-builder.yml
+++ b/.github/workflows/maven-pr-builder.yml
@@ -29,7 +29,7 @@ name: Java PR Builder
 on:
   pull_request:
     branches: [ master ]
-    types: [ opened, reopened, synchronize, labeled, unlabeled ]
+    types: [ opened, reopened, synchronize ]
 
 jobs:
   build:

From eb8f9db575d3edd230345362cb5d449fb3255ad2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?=
 <iluwatar@users.noreply.github.com>
Date: Sun, 28 Mar 2021 14:02:29 +0300
Subject: [PATCH 254/254] #590 add explanation for caching pattern (#1693)

Co-authored-by: Subhrodip Mohanta <hello@subho.xyz>
---
 caching/README.md                             | 314 +++++++++++++++++-
 .../java/com/iluwatar/caching/AppManager.java |   4 +-
 .../java/com/iluwatar/caching/DbManager.java  |  10 +-
 3 files changed, 319 insertions(+), 9 deletions(-)

diff --git a/caching/README.md b/caching/README.md
index 912f1d218..89487fc42 100644
--- a/caching/README.md
+++ b/caching/README.md
@@ -10,20 +10,326 @@ tags:
 ---
 
 ## Intent
-To avoid expensive re-acquisition of resources by not releasing
-the resources immediately after their use. The resources retain their identity, are kept in some
-fast-access storage, and are re-used to avoid having to acquire them again.
+
+The caching pattern avoids expensive re-acquisition of resources by not releasing them immediately 
+after use. The resources retain their identity, are kept in some fast-access storage, and are 
+re-used to avoid having to acquire them again.
+
+## Explanation
+
+Real world example
+
+> A team is working on a website that provides new homes for abandoned cats. People can post their
+> cats on the website after registering, but all the new posts require approval from one of the
+> site moderators. The user accounts of the site moderators contain a specific flag and the data
+> is stored in a MongoDB database. Checking for the moderator flag each time a post is viewed 
+> becomes expensive and it's a good idea to utilize caching here.
+
+In plain words
+
+> Caching pattern keeps frequently needed data in fast-access storage to improve performance.
+
+Wikipedia says:
+
+> In computing, a cache is a hardware or software component that stores data so that future 
+> requests for that data can be served faster; the data stored in a cache might be the result of 
+> an earlier computation or a copy of data stored elsewhere. A cache hit occurs when the requested 
+> data can be found in a cache, while a cache miss occurs when it cannot. Cache hits are served by 
+> reading data from the cache, which is faster than recomputing a result or reading from a slower 
+> data store; thus, the more requests that can be served from the cache, the faster the system 
+> performs.
+
+**Programmatic Example**
+
+Let's first look at the data layer of our application. The interesting classes are `UserAccount`
+which is a simple Java object containing the user account details, and `DbManager` which handles
+reading and writing of these objects to/from MongoDB database.
+
+```java
+@Setter
+@Getter
+@AllArgsConstructor
+@ToString
+public class UserAccount {
+  private String userId;
+  private String userName;
+  private String additionalInfo;
+}
+
+@Slf4j
+public final class DbManager {
+
+  private static MongoClient mongoClient;
+  private static MongoDatabase db;
+
+  private DbManager() { /*...*/ }
+
+  public static void createVirtualDb() { /*...*/ }
+
+  public static void connect() throws ParseException { /*...*/ }
+
+  public static UserAccount readFromDb(String userId) { /*...*/ }
+
+  public static void writeToDb(UserAccount userAccount) { /*...*/ }
+
+  public static void updateDb(UserAccount userAccount) { /*...*/ }
+
+  public static void upsertDb(UserAccount userAccount) { /*...*/ }
+}
+```
+
+In the example, we are demonstrating various different caching policies
+
+* Write-through writes data to the cache and DB in a single transaction
+* Write-around writes data immediately into the DB instead of the cache
+* Write-behind writes data into the cache initially whilst the data is only written into the DB 
+  when the cache is full
+* Cache-aside pushes the responsibility of keeping the data synchronized in both data sources to 
+  the application itself
+* Read-through strategy is also included in the aforementioned strategies and it returns data from 
+  the cache to the caller if it exists, otherwise queries from DB and stores it into the cache for 
+  future use.
+  
+The cache implementation in `LruCache` is a hash table accompanied by a doubly 
+linked-list. The linked-list helps in capturing and maintaining the LRU data in the cache. When 
+data is queried (from the cache), added (to the cache), or updated, the data is moved to the front 
+of the list to depict itself as the most-recently-used data. The LRU data is always at the end of 
+the list.
+
+```java
+@Slf4j
+public class LruCache {
+
+  static class Node {
+    String userId;
+    UserAccount userAccount;
+    Node previous;
+    Node next;
+
+    public Node(String userId, UserAccount userAccount) {
+      this.userId = userId;
+      this.userAccount = userAccount;
+    }
+  }
+  
+  /* ... omitted details ... */
+
+  public LruCache(int capacity) {
+    this.capacity = capacity;
+  }
+
+  public UserAccount get(String userId) {
+    if (cache.containsKey(userId)) {
+      var node = cache.get(userId);
+      remove(node);
+      setHead(node);
+      return node.userAccount;
+    }
+    return null;
+  }
+
+  public void set(String userId, UserAccount userAccount) {
+    if (cache.containsKey(userId)) {
+      var old = cache.get(userId);
+      old.userAccount = userAccount;
+      remove(old);
+      setHead(old);
+    } else {
+      var newNode = new Node(userId, userAccount);
+      if (cache.size() >= capacity) {
+        LOGGER.info("# Cache is FULL! Removing {} from cache...", end.userId);
+        cache.remove(end.userId); // remove LRU data from cache.
+        remove(end);
+        setHead(newNode);
+      } else {
+        setHead(newNode);
+      }
+      cache.put(userId, newNode);
+    }
+  }
+
+  public boolean contains(String userId) {
+    return cache.containsKey(userId);
+  }
+  
+  public void remove(Node node) { /* ... */ }
+  public void setHead(Node node) { /* ... */ }
+  public void invalidate(String userId) { /* ... */ }
+  public boolean isFull() { /* ... */ }
+  public UserAccount getLruData() { /* ... */ }
+  public void clear() { /* ... */ }
+  public List<UserAccount> getCacheDataInListForm() { /* ... */ }
+  public void setCapacity(int newCapacity) { /* ... */ }
+}
+```
+
+The next layer we are going to look at is `CacheStore` which implements the different caching
+strategies.
+
+```java
+@Slf4j
+public class CacheStore {
+
+  private static LruCache cache;
+
+  /* ... details omitted ... */
+
+  public static UserAccount readThrough(String userId) {
+    if (cache.contains(userId)) {
+      LOGGER.info("# Cache Hit!");
+      return cache.get(userId);
+    }
+    LOGGER.info("# Cache Miss!");
+    UserAccount userAccount = DbManager.readFromDb(userId);
+    cache.set(userId, userAccount);
+    return userAccount;
+  }
+
+  public static void writeThrough(UserAccount userAccount) {
+    if (cache.contains(userAccount.getUserId())) {
+      DbManager.updateDb(userAccount);
+    } else {
+      DbManager.writeToDb(userAccount);
+    }
+    cache.set(userAccount.getUserId(), userAccount);
+  }
+
+  public static void clearCache() {
+    if (cache != null) {
+      cache.clear();
+    }
+  }
+
+  public static void flushCache() {
+    LOGGER.info("# flushCache...");
+    Optional.ofNullable(cache)
+        .map(LruCache::getCacheDataInListForm)
+        .orElse(List.of())
+        .forEach(DbManager::updateDb);
+  }
+
+  /* ... omitted the implementation of other caching strategies ... */
+
+}
+```
+
+`AppManager` helps to bridge the gap in communication between the main class and the application's
+back-end. DB connection is initialized through this class. The chosen caching strategy/policy is
+also initialized here. Before the cache can be used, the size of the cache has to be set. Depending 
+on the chosen caching policy, `AppManager` will call the appropriate function in the `CacheStore` 
+class.
+
+```java
+@Slf4j
+public final class AppManager {
+
+  private static CachingPolicy cachingPolicy;
+
+  private AppManager() {
+  }
+
+  public static void initDb(boolean useMongoDb) { /* ... */ }
+
+  public static void initCachingPolicy(CachingPolicy policy) { /* ... */ }
+
+  public static void initCacheCapacity(int capacity) { /* ... */ }
+
+  public static UserAccount find(String userId) {
+    if (cachingPolicy == CachingPolicy.THROUGH || cachingPolicy == CachingPolicy.AROUND) {
+      return CacheStore.readThrough(userId);
+    } else if (cachingPolicy == CachingPolicy.BEHIND) {
+      return CacheStore.readThroughWithWriteBackPolicy(userId);
+    } else if (cachingPolicy == CachingPolicy.ASIDE) {
+      return findAside(userId);
+    }
+    return null;
+  }
+
+  public static void save(UserAccount userAccount) {
+    if (cachingPolicy == CachingPolicy.THROUGH) {
+      CacheStore.writeThrough(userAccount);
+    } else if (cachingPolicy == CachingPolicy.AROUND) {
+      CacheStore.writeAround(userAccount);
+    } else if (cachingPolicy == CachingPolicy.BEHIND) {
+      CacheStore.writeBehind(userAccount);
+    } else if (cachingPolicy == CachingPolicy.ASIDE) {
+      saveAside(userAccount);
+    }
+  }
+
+  public static String printCacheContent() {
+    return CacheStore.print();
+  }
+
+  /* ... details omitted ... */
+}
+```
+
+Here is what we do in the main class of the application.
+
+```java
+@Slf4j
+public class App {
+
+  public static void main(String[] args) {
+    AppManager.initDb(false);
+    AppManager.initCacheCapacity(3);
+    var app = new App();
+    app.useReadAndWriteThroughStrategy();
+    app.useReadThroughAndWriteAroundStrategy();
+    app.useReadThroughAndWriteBehindStrategy();
+    app.useCacheAsideStategy();
+  }
+
+  public void useReadAndWriteThroughStrategy() {
+    LOGGER.info("# CachingPolicy.THROUGH");
+    AppManager.initCachingPolicy(CachingPolicy.THROUGH);
+    var userAccount1 = new UserAccount("001", "John", "He is a boy.");
+    AppManager.save(userAccount1);
+    LOGGER.info(AppManager.printCacheContent());
+    AppManager.find("001");
+    AppManager.find("001");
+  }
+
+  public void useReadThroughAndWriteAroundStrategy() { /* ... */ }
+
+  public void useReadThroughAndWriteBehindStrategy() { /* ... */ }
+
+  public void useCacheAsideStategy() { /* ... */ }
+}
+```
+
+Finally, here is some of the console output from the program.
+
+```
+12:32:53.845 [main] INFO com.iluwatar.caching.App - # CachingPolicy.THROUGH
+12:32:53.900 [main] INFO com.iluwatar.caching.App - 
+--CACHE CONTENT--
+UserAccount(userId=001, userName=John, additionalInfo=He is a boy.)
+----
+```
 
 ## Class diagram
+
 ![alt text](./etc/caching.png "Caching")
 
 ## Applicability
+
 Use the Caching pattern(s) when
 
-* Repetitious acquisition, initialization, and release of the same resource causes unnecessary performance overhead.
+* Repetitious acquisition, initialization, and release of the same resource cause unnecessary 
+  performance overhead.
+
+## Related patterns
+
+* [Proxy](https://java-design-patterns.com/patterns/proxy/)
 
 ## Credits
 
 * [Write-through, write-around, write-back: Cache explained](http://www.computerweekly.com/feature/Write-through-write-around-write-back-Cache-explained)
 * [Read-Through, Write-Through, Write-Behind, and Refresh-Ahead Caching](https://docs.oracle.com/cd/E15357_01/coh.360/e15723/cache_rtwtwbra.htm#COHDG5177)
 * [Cache-Aside pattern](https://docs.microsoft.com/en-us/azure/architecture/patterns/cache-aside)
+* [Java EE 8 High Performance: Master techniques such as memory optimization, caching, concurrency, and multithreading to achieve maximum performance from your enterprise applications](https://www.amazon.com/gp/product/178847306X/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=178847306X&linkId=e948720055599f248cdac47da9125ff4)
+* [Java Performance: In-Depth Advice for Tuning and Programming Java 8, 11, and Beyond](https://www.amazon.com/gp/product/1492056111/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=1492056111&linkId=7e553581559b9ec04221259e52004b08)
+* [Effective Java](https://www.amazon.com/gp/product/B078H61SCH/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=B078H61SCH&linkId=f06607a0b48c76541ef19c5b8b9e7882)
+* [Java Performance: The Definitive Guide: Getting the Most Out of Your Code](https://www.amazon.com/gp/product/1449358454/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=1449358454&linkId=475c18363e350630cc0b39ab681b2687)
diff --git a/caching/src/main/java/com/iluwatar/caching/AppManager.java b/caching/src/main/java/com/iluwatar/caching/AppManager.java
index 6aca3f980..68c8a0d36 100644
--- a/caching/src/main/java/com/iluwatar/caching/AppManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/AppManager.java
@@ -25,6 +25,7 @@ package com.iluwatar.caching;
 
 import java.text.ParseException;
 import java.util.Optional;
+import lombok.extern.slf4j.Slf4j;
 
 /**
  * AppManager helps to bridge the gap in communication between the main class and the application's
@@ -33,6 +34,7 @@ import java.util.Optional;
  * Depending on the chosen caching policy, AppManager will call the appropriate function in the
  * CacheStore class.
  */
+@Slf4j
 public final class AppManager {
 
   private static CachingPolicy cachingPolicy;
@@ -50,7 +52,7 @@ public final class AppManager {
       try {
         DbManager.connect();
       } catch (ParseException e) {
-        e.printStackTrace();
+        LOGGER.error("Error connecting to MongoDB", e);
       }
     } else {
       DbManager.createVirtualDb();
diff --git a/caching/src/main/java/com/iluwatar/caching/DbManager.java b/caching/src/main/java/com/iluwatar/caching/DbManager.java
index 2e770632b..d02234969 100644
--- a/caching/src/main/java/com/iluwatar/caching/DbManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/DbManager.java
@@ -30,6 +30,7 @@ import com.mongodb.client.model.UpdateOptions;
 import java.text.ParseException;
 import java.util.HashMap;
 import java.util.Map;
+import lombok.extern.slf4j.Slf4j;
 import org.bson.Document;
 
 /**
@@ -41,6 +42,7 @@ import org.bson.Document;
  * underlying data storage (connect()) or a simple Java data structure to (temporarily) store the
  * data/objects during runtime (createVirtualDB()).</p>
  */
+@Slf4j
 public final class DbManager {
 
   private static MongoClient mongoClient;
@@ -83,7 +85,7 @@ public final class DbManager {
       try {
         connect();
       } catch (ParseException e) {
-        e.printStackTrace();
+        LOGGER.error("Error connecting to MongoDB", e);
       }
     }
     var iterable = db
@@ -110,7 +112,7 @@ public final class DbManager {
       try {
         connect();
       } catch (ParseException e) {
-        e.printStackTrace();
+        LOGGER.error("Error connecting to MongoDB", e);
       }
     }
     db.getCollection(CachingConstants.USER_ACCOUNT).insertOne(
@@ -132,7 +134,7 @@ public final class DbManager {
       try {
         connect();
       } catch (ParseException e) {
-        e.printStackTrace();
+        LOGGER.error("Error connecting to MongoDB", e);
       }
     }
     db.getCollection(CachingConstants.USER_ACCOUNT).updateOne(
@@ -153,7 +155,7 @@ public final class DbManager {
       try {
         connect();
       } catch (ParseException e) {
-        e.printStackTrace();
+        LOGGER.error("Error connecting to MongoDB", e);
       }
     }
     db.getCollection(CachingConstants.USER_ACCOUNT).updateOne(