From 7498cf4a994605abe1e728db9fced50a6d4924ce Mon Sep 17 00:00:00 2001
From: Bob van de Vijver <bobvandevijver@hotmail.com>
Date: Sun, 25 Feb 2018 15:09:23 +0100
Subject: [PATCH] Added some convenience methods

---
 Latex/Base/Standalone.php        |  2 --
 Latex/LatexBase.php              | 51 ++++++++++++++++++++++++++------
 Latex/LatexBaseInterface.php     | 38 +++++++++++++++++++++---
 Resources/doc/base/Article.md    |  6 +++-
 Resources/doc/base/Book.md       |  6 +++-
 Resources/doc/base/Letter.md     |  6 +++-
 Resources/doc/base/Standalone.md |  4 +++
 7 files changed, 95 insertions(+), 18 deletions(-)

diff --git a/Latex/Base/Standalone.php b/Latex/Base/Standalone.php
index 0a3542e..b9fe9b5 100644
--- a/Latex/Base/Standalone.php
+++ b/Latex/Base/Standalone.php
@@ -10,8 +10,6 @@ class Standalone extends LatexBase
    * Article constructor, sets defaults
    *
    * @param string $filename
-   *
-   * @throws \BobV\LatexBundle\Exception\LatexException
    */
   public function __construct($filename) {
     // Define standard values
diff --git a/Latex/LatexBase.php b/Latex/LatexBase.php
index d9a5724..0d6df56 100644
--- a/Latex/LatexBase.php
+++ b/Latex/LatexBase.php
@@ -1,4 +1,5 @@
 <?php
+
 namespace BobV\LatexBundle\Latex;
 
 use BobV\LatexBundle\Exception\LatexException;
@@ -16,8 +17,6 @@ class LatexBase extends LatexParams implements LatexBaseInterface
 
   /**
    * @param string $filename
-   *
-   * @throws \BobV\LatexBundle\Exception\LatexException
    */
   public function __construct($filename)
   {
@@ -81,7 +80,7 @@ public function getFileName()
   /**
    * @param string $fileName
    *
-   * @return LatexInterface $this
+   * @return LatexBaseInterface $this
    */
   public function setFileName($fileName)
   {
@@ -101,7 +100,7 @@ public function getTemplate()
   /**
    * @param string $template
    *
-   * @return LatexInterface $this
+   * @return LatexBaseInterface $this
    */
   public function setTemplate($template)
   {
@@ -113,28 +112,46 @@ public function setTemplate($template)
   /**
    * @return array
    */
-  public function getDependencies(){
+  public function getDependencies()
+  {
     return $this->dependencies;
   }
 
   /**
    * @param $dependency
    *
-   * @return LatexInterface $this
+   * @return LatexBaseInterface $this
    */
-  public function addDependency($dependency){
+  public function addDependency($dependency)
+  {
     $this->dependencies[] = $dependency;
 
     return $this;
   }
 
+  /**
+   * To add multiple dependencies locations
+   *
+   * @param $dependencies
+   *
+   * @return LatexBaseInterface
+   */
+  public function addDependencies($dependencies)
+  {
+    foreach ($dependencies as $dependency) {
+      $this->addDependency($dependency);
+    }
+
+    return $this;
+  }
+
   /**
    * Add an package to include
    *
    * @param $package
    * @param $options
    *
-   * @return LatexInterface $this
+   * @return LatexBaseInterface $this
    */
   public function addPackage($package, $options = '')
   {
@@ -146,9 +163,25 @@ public function addPackage($package, $options = '')
 
     $this->params['packages'][] = array(
         'p' => $package,
-        'o' => $options
+        'o' => $options,
     );
 
     return $this;
   }
+
+  /**
+   * Add multiple packages to include (without options)
+   *
+   * @param $packages
+   *
+   * @return mixed
+   */
+  public function addPackages($packages)
+  {
+    foreach ($packages as $package) {
+      $this->addPackage($package);
+    }
+
+    return $this;
+  }
 }
diff --git a/Latex/LatexBaseInterface.php b/Latex/LatexBaseInterface.php
index 4278dc3..7cfeb06 100644
--- a/Latex/LatexBaseInterface.php
+++ b/Latex/LatexBaseInterface.php
@@ -1,4 +1,5 @@
 <?php
+
 namespace BobV\LatexBundle\Latex;
 
 interface LatexBaseInterface extends LatexInterface
@@ -22,7 +23,7 @@ public function getFileName();
    *
    * @param string $fileName
    *
-   * @return LatexInterface
+   * @return LatexBaseInterface
    */
   public function setFileName($fileName);
 
@@ -36,9 +37,38 @@ public function getDependencies();
   /**
    * To add an dependency location
    *
-   * @param $depedency
+   * @param $dependency
    *
-   * @return LatexInterface
+   * @return LatexBaseInterface
    */
-  public function addDependency($depedency);
+  public function addDependency($dependency);
+
+  /**
+   * To add multiple dependencies locations
+   *
+   * @param $dependencies
+   *
+   * @return LatexBaseInterface
+   */
+  public function addDependencies($dependencies);
+
+  /**
+   * Add an package to include
+   *
+   * @param $package
+   * @param $options
+   *
+   * @return LatexBaseInterface $this
+   */
+  public function addPackage($package, $options = '');
+
+  /**
+   * Add multiple packages to include (without options)
+   *
+   * @param $packages
+   *
+   * @return mixed
+   */
+  public function addPackages($packages);
+
 }
diff --git a/Resources/doc/base/Article.md b/Resources/doc/base/Article.md
index 363c03a..e1437ab 100644
--- a/Resources/doc/base/Article.md
+++ b/Resources/doc/base/Article.md
@@ -50,10 +50,14 @@ new Article($filename)
 
 This class also has an `addPackage($package, $options = '')` method. Use this if you need to include extra packages.
 
+As convenience, multiple packages can be added with a single invocation of `addPackages($packages)`. However, this is without package options. 
+
 ### Add dependency
 
 This class also has an `addDependency($dependency)` method. Use this if you need to copy files from a certain dir to the compilation dir.
 
+As convenience, multiple dependencies can be added with a single invocation of `addDependencies($dependencies)`.
+
 ### Template
 
-See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/article.tex.twig).
\ No newline at end of file
+See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/article.tex.twig).
diff --git a/Resources/doc/base/Book.md b/Resources/doc/base/Book.md
index 1cced74..54d09b0 100644
--- a/Resources/doc/base/Book.md
+++ b/Resources/doc/base/Book.md
@@ -52,10 +52,14 @@ new Book($filename)
 
 This class also has an `addPackage($package, $options = '')` method. Use this if you need to include extra packages.
 
+As convenience, multiple packages can be added with a single invocation of `addPackages($packages)`. However, this is without package options. 
+
 ### Add dependency
 
 This class also has an `addDependency($dependency)` method. Use this if you need to copy files from a certain dir to the compilation dir.
 
+As convenience, multiple dependencies can be added with a single invocation of `addDependencies($dependencies)`.
+
 ### Template
 
-See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/book.tex.twig).
\ No newline at end of file
+See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/book.tex.twig).
diff --git a/Resources/doc/base/Letter.md b/Resources/doc/base/Letter.md
index 37ff274..2e9f2ed 100644
--- a/Resources/doc/base/Letter.md
+++ b/Resources/doc/base/Letter.md
@@ -41,10 +41,14 @@ new Letter($filename)
 
 This class also has an `addPackage($package, $options = '')` method. Use this if you need to include extra packages.
 
+As convenience, multiple packages can be added with a single invocation of `addPackages($packages)`. However, this is without package options. 
+
 ### Add dependency
 
 This class also has an `addDependency($dependency)` method. Use this if you need to copy files from a certain dir to the compilation dir.
 
+As convenience, multiple dependencies can be added with a single invocation of `addDependencies($dependencies)`.
+
 ### Template
 
-See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/letter.tex.twig).
\ No newline at end of file
+See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/letter.tex.twig).
diff --git a/Resources/doc/base/Standalone.md b/Resources/doc/base/Standalone.md
index 8a5abc0..eeff748 100644
--- a/Resources/doc/base/Standalone.md
+++ b/Resources/doc/base/Standalone.md
@@ -26,10 +26,14 @@ new Standalone($filename)
 
 This class also has an `addPackage($package, $options = '')` method. Use this if you need to include extra packages.
 
+As convenience, multiple packages can be added with a single invocation of `addPackages($packages)`. However, this is without package options. 
+
 ### Add dependency
 
 This class also has an `addDependency($dependency)` method. Use this if you need to copy files from a certain dir to the compilation dir.
 
+As convenience, multiple dependencies can be added with a single invocation of `addDependencies($dependencies)`.
+
 ### Template
 
 See [here](https://github.com/bobvandevijver/latex-bundle/blob/master/Resources/views/Base/standalone.tex.twig).