diff --git a/coverage/covindex.html b/coverage/covindex.html
index d26583e..ea34bdc 100644
--- a/coverage/covindex.html
+++ b/coverage/covindex.html
@@ -130,7 +130,7 @@
     <div class="content">
         <p>
             <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_2b703ede0196a3c0___init___py.html b/coverage/d_2b703ede0196a3c0___init___py.html
index b770939..1921034 100644
--- a/coverage/d_2b703ede0196a3c0___init___py.html
+++ b/coverage/d_2b703ede0196a3c0___init___py.html
@@ -93,7 +93,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_2b703ede0196a3c0_cli_py.html b/coverage/d_2b703ede0196a3c0_cli_py.html
index 681db02..03efd6e 100644
--- a/coverage/d_2b703ede0196a3c0_cli_py.html
+++ b/coverage/d_2b703ede0196a3c0_cli_py.html
@@ -272,7 +272,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_678a5ac99edfd408___init___py.html b/coverage/d_678a5ac99edfd408___init___py.html
index cacc6cb..bf360db 100644
--- a/coverage/d_678a5ac99edfd408___init___py.html
+++ b/coverage/d_678a5ac99edfd408___init___py.html
@@ -72,7 +72,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_678a5ac99edfd408___main___py.html b/coverage/d_678a5ac99edfd408___main___py.html
index 9c616d1..9858ee3 100644
--- a/coverage/d_678a5ac99edfd408___main___py.html
+++ b/coverage/d_678a5ac99edfd408___main___py.html
@@ -74,7 +74,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_678a5ac99edfd408__version_py.html b/coverage/d_678a5ac99edfd408__version_py.html
index 5feae25..7b532eb 100644
--- a/coverage/d_678a5ac99edfd408__version_py.html
+++ b/coverage/d_678a5ac99edfd408__version_py.html
@@ -65,7 +65,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_678a5ac99edfd408_exceptions_py.html b/coverage/d_678a5ac99edfd408_exceptions_py.html
index 4ba65ba..117802f 100644
--- a/coverage/d_678a5ac99edfd408_exceptions_py.html
+++ b/coverage/d_678a5ac99edfd408_exceptions_py.html
@@ -113,7 +113,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_9c7e16c5deec493b___init___py.html b/coverage/d_9c7e16c5deec493b___init___py.html
index 4341508..b66742d 100644
--- a/coverage/d_9c7e16c5deec493b___init___py.html
+++ b/coverage/d_9c7e16c5deec493b___init___py.html
@@ -80,7 +80,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_e89a57001f83f3a6___init___py.html b/coverage/d_e89a57001f83f3a6___init___py.html
index 2229e89..1ae9dec 100644
--- a/coverage/d_e89a57001f83f3a6___init___py.html
+++ b/coverage/d_e89a57001f83f3a6___init___py.html
@@ -67,7 +67,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/coverage/d_e89a57001f83f3a6_pages_py.html b/coverage/d_e89a57001f83f3a6_pages_py.html
index b9db6ff..5bc8561 100644
--- a/coverage/d_e89a57001f83f3a6_pages_py.html
+++ b/coverage/d_e89a57001f83f3a6_pages_py.html
@@ -542,7 +542,7 @@
     <div class="content">
         <p>
             <a class="nav" href="covindex.html">&#xab; index</a> &nbsp; &nbsp; <a class="nav" href="https://coverage.readthedocs.io">coverage.py v6.1.2</a>,
-            created at 2021-11-23 21:15 +0000
+            created at 2021-11-24 17:57 +0000
         </p>
     </div>
 </footer>
diff --git a/home/changelog/index.html b/home/changelog/index.html
index e23dd6a..eafef1e 100644
--- a/home/changelog/index.html
+++ b/home/changelog/index.html
@@ -393,6 +393,33 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#v103-2021-11-23" class="md-nav__link">
+    v1.0.3 - 2021-11-23
+  </a>
+  
+    <nav class="md-nav" aria-label="v1.0.3 - 2021-11-23">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#documentation" class="md-nav__link">
+    Documentation
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#miscellaneous-tasks" class="md-nav__link">
+    Miscellaneous Tasks
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#v102-2021-11-23" class="md-nav__link">
     v1.0.2 - 2021-11-23
@@ -401,6 +428,13 @@
     <nav class="md-nav" aria-label="v1.0.2 - 2021-11-23">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#documentation_1" class="md-nav__link">
+    Documentation
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#features" class="md-nav__link">
     Features
@@ -409,7 +443,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#miscellaneous-tasks" class="md-nav__link">
+  <a href="#miscellaneous-tasks_1" class="md-nav__link">
     Miscellaneous Tasks
   </a>
   
@@ -429,7 +463,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
+  <a href="#documentation_2" class="md-nav__link">
     Documentation
   </a>
   
@@ -449,7 +483,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#documentation_1" class="md-nav__link">
+  <a href="#documentation_3" class="md-nav__link">
     Documentation
   </a>
   
@@ -885,6 +919,33 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#v103-2021-11-23" class="md-nav__link">
+    v1.0.3 - 2021-11-23
+  </a>
+  
+    <nav class="md-nav" aria-label="v1.0.3 - 2021-11-23">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#documentation" class="md-nav__link">
+    Documentation
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#miscellaneous-tasks" class="md-nav__link">
+    Miscellaneous Tasks
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#v102-2021-11-23" class="md-nav__link">
     v1.0.2 - 2021-11-23
@@ -893,6 +954,13 @@
     <nav class="md-nav" aria-label="v1.0.2 - 2021-11-23">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#documentation_1" class="md-nav__link">
+    Documentation
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#features" class="md-nav__link">
     Features
@@ -901,7 +969,7 @@
 </li>
         
           <li class="md-nav__item">
-  <a href="#miscellaneous-tasks" class="md-nav__link">
+  <a href="#miscellaneous-tasks_1" class="md-nav__link">
     Miscellaneous Tasks
   </a>
   
@@ -921,7 +989,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
+  <a href="#documentation_2" class="md-nav__link">
     Documentation
   </a>
   
@@ -941,7 +1009,7 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#documentation_1" class="md-nav__link">
+  <a href="#documentation_3" class="md-nav__link">
     Documentation
   </a>
   
@@ -986,26 +1054,43 @@
                 <h1 id="changelog">Changelog<a class="headerlink" href="#changelog" title="Permanent link">¤</a></h1>
 <p>All notable changes to this project will be documented in this file.</p>
 <!-- marker -->
+<h2 id="v103-2021-11-23"><a href="https://github.com/tembo-pages/tembo-core/commits/v1.0.3">v1.0.3</a> - 2021-11-23<a class="headerlink" href="#v103-2021-11-23" title="Permanent link">¤</a></h2>
+<p><small><a href="https://github.com/tembo-pages/tembo-core/compare/v1.0.2..v1.0.3">Compare with v1.0.2</a></small></p>
+<h3 id="documentation">Documentation<a class="headerlink" href="#documentation" title="Permanent link">¤</a></h3>
+<ul>
+<li>Update changelog (<a href="https://github.com/tembo-pages/tembo-core/commit/f33f215c7ef563dbddfcfde3818f1bfd0d1547a2">f33f21</a>)</li>
+<li>Update changelog (<a href="https://github.com/tembo-pages/tembo-core/commit/d8415067730e1310a426f6dd97304a436097760a">d84150</a>)</li>
+</ul>
+<h3 id="miscellaneous-tasks">Miscellaneous Tasks<a class="headerlink" href="#miscellaneous-tasks" title="Permanent link">¤</a></h3>
+<ul>
+<li>Update duties.py (<a href="https://github.com/tembo-pages/tembo-core/commit/d9e13b5c351d5be7c1f1dd60cf389b62d63ecd5b">d9e13b</a>)</li>
+</ul>
 <h2 id="v102-2021-11-23"><a href="https://github.com/tembo-pages/tembo-core/commits/v1.0.2">v1.0.2</a> - 2021-11-23<a class="headerlink" href="#v102-2021-11-23" title="Permanent link">¤</a></h2>
 <p><small><a href="https://github.com/tembo-pages/tembo-core/compare/v1.0.1..v1.0.2">Compare with v1.0.1</a></small></p>
+<h3 id="documentation_1">Documentation<a class="headerlink" href="#documentation_1" title="Permanent link">¤</a></h3>
+<ul>
+<li>Update CHANGELOG.md (<a href="https://github.com/tembo-pages/tembo-core/commit/2b5632955a0090e94d353bd407955371463b9416">2b5632</a>)</li>
+<li>Update license reference (<a href="https://github.com/tembo-pages/tembo-core/commit/e17882549a209955dbf6ab2c3582b13db4df4897">e17882</a>)</li>
+</ul>
 <h3 id="features">Features<a class="headerlink" href="#features" title="Permanent link">¤</a></h3>
 <ul>
 <li>Add garbage (<a href="https://github.com/tembo-pages/tembo-core/commit/b49d776712737deaa1aeb86dd40230c099198d5a">b49d77</a>)</li>
 </ul>
-<h3 id="miscellaneous-tasks">Miscellaneous Tasks<a class="headerlink" href="#miscellaneous-tasks" title="Permanent link">¤</a></h3>
+<h3 id="miscellaneous-tasks_1">Miscellaneous Tasks<a class="headerlink" href="#miscellaneous-tasks_1" title="Permanent link">¤</a></h3>
 <ul>
 <li>Prepare release v1.0.2 (<a href="https://github.com/tembo-pages/tembo-core/commit/e29ae6dadb1ca419d536db18f34d9d249012cc25">e29ae6</a>)</li>
 <li>Update cliff.toml (<a href="https://github.com/tembo-pages/tembo-core/commit/7ee36f28b5160251c37085744166c2a5b1e695e4">7ee36f</a>)</li>
 <li>Update duties.py with latest changelog duty (<a href="https://github.com/tembo-pages/tembo-core/commit/f6f2fe07b61e8fa8bd812bbc63a51d3f9705a448">f6f2fe</a>)</li>
+<li>Update cliff.toml &amp; duties.py (<a href="https://github.com/tembo-pages/tembo-core/commit/8c1d7632dded4f221c61d942b548c1552f5b8292">8c1d76</a>)</li>
 </ul>
 <h2 id="v101-2021-11-21"><a href="https://github.com/tembo-pages/tembo-core/commits/v1.0.1">v1.0.1</a> - 2021-11-21<a class="headerlink" href="#v101-2021-11-21" title="Permanent link">¤</a></h2>
 <p><small><a href="https://github.com/tembo-pages/tembo-core/compare/v1.0.0..v1.0.1">Compare with v1.0.0</a></small></p>
-<h3 id="documentation">Documentation<a class="headerlink" href="#documentation" title="Permanent link">¤</a></h3>
+<h3 id="documentation_2">Documentation<a class="headerlink" href="#documentation_2" title="Permanent link">¤</a></h3>
 <ul>
 <li>Update changelog (<a href="https://github.com/tembo-pages/tembo-core/commit/b710338a73add7ed93af1f76f3b9272e30ce41de">b71033</a>)</li>
 </ul>
 <h2 id="v100-2021-11-21"><a href="https://github.com/tembo-pages/tembo-core/commits/v1.0.0">v1.0.0</a> - 2021-11-21<a class="headerlink" href="#v100-2021-11-21" title="Permanent link">¤</a></h2>
-<h3 id="documentation_1">Documentation<a class="headerlink" href="#documentation_1" title="Permanent link">¤</a></h3>
+<h3 id="documentation_3">Documentation<a class="headerlink" href="#documentation_3" title="Permanent link">¤</a></h3>
 <ul>
 <li>Update changelog (<a href="https://github.com/tembo-pages/tembo-core/commit/26fe8118649bbff109233a80130a7323539f256f">26fe81</a>)</li>
 </ul>
diff --git a/search/search_index.json b/search/search_index.json
index aac238f..a27782d 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Tembo \u00a4 from tembo import Success v0.0.8","title":"Overview"},{"location":"#tembo","text":"from tembo import Success v0.0.8","title":"Tembo"},{"location":"cli_reference/main/","text":"CLI Reference \u00a4 tembo \u00a4 Tembo - an organiser for work notes. Usage: tembo <options> COMMAND [ARGS]... Options: Name Type Description Default -v , --version boolean Show the version and exit. False --help boolean Show this message and exit. False list \u00a4 List all scopes defined in the config.yml. Usage: tembo list <options> Options: Name Type Description Default --help boolean Show this message and exit. False new \u00a4 Create a new page. <scope> The name of the scope in the config.yml. <inputs> Any input token values that are defined in the config.yml for this scope. Accepts multiple inputs separated by a space. Example: tembo new meeting my_presentation Usage: tembo new <options> <scope> <inputs> Options: Name Type Description Default --dry-run boolean Show the full path of the page to be created without actually saving the page to disk and exit. False --example boolean Show the example command in the config.yml if it exists and exit. False --help boolean Show this message and exit. False","title":"tembo"},{"location":"cli_reference/main/#cli-reference","text":"","title":"CLI Reference"},{"location":"cli_reference/main/#tembo","text":"Tembo - an organiser for work notes. Usage: tembo <options> COMMAND [ARGS]... Options: Name Type Description Default -v , --version boolean Show the version and exit. False --help boolean Show this message and exit. False","title":"tembo"},{"location":"cli_reference/main/#list","text":"List all scopes defined in the config.yml. Usage: tembo list <options> Options: Name Type Description Default --help boolean Show this message and exit. False","title":"list"},{"location":"cli_reference/main/#new","text":"Create a new page. <scope> The name of the scope in the config.yml. <inputs> Any input token values that are defined in the config.yml for this scope. Accepts multiple inputs separated by a space. Example: tembo new meeting my_presentation Usage: tembo new <options> <scope> <inputs> Options: Name Type Description Default --dry-run boolean Show the full path of the page to be created without actually saving the page to disk and exit. False --example boolean Show the example command in the config.yml if it exists and exit. False --help boolean Show this message and exit. False","title":"new"},{"location":"code_reference/SUMMARY/","text":"__init__.py __main__.py _version.py cli __init__.py cli.py exceptions.py journal __init__.py pages.py utils __init__.py","title":"SUMMARY"},{"location":"code_reference/__init__/","text":"Tembo package. A simple folder organiser for your work notes.","title":"__init__.py"},{"location":"code_reference/__main__/","text":"Entrypoint module. Used when using python -m tembo to invoke the CLI.","title":"__main__.py"},{"location":"code_reference/_version/","text":"Module containing the version of tembo.","title":"_version.py"},{"location":"code_reference/exceptions/","text":"Module containing custom exceptions. BasePathDoesNotExistError ( Exception ) \u00a4 Raised if the base path does not exist. EmptyConfigYML ( Exception ) \u00a4 Raised if the config.yml file is empty. MandatoryKeyNotFound ( Exception ) \u00a4 Raised if a mandatory key is not found in the config.yml. MismatchedTokenError ( Exception ) \u00a4 Raised when the number of input tokens does not match the user config. Attributes: Name Type Description expected int number of input tokens in the user config. given int number of input tokens passed in. __init__ ( self , expected , given ) special \u00a4 Initialise the exception. Parameters: Name Type Description Default expected int number of input tokens in the user config. required given int number of input tokens passed in. required Source code in tembo/exceptions.py def __init__ ( self , expected : int , given : int ) -> None : \"\"\" Initialise the exception. Args: expected (int): number of input tokens in the user config. given (int): number of input tokens passed in. \"\"\" self . expected = expected self . given = given super () . __init__ () MissingConfigYML ( Exception ) \u00a4 Raised if the config.yml file is missing. ScopeNotFound ( Exception ) \u00a4 Raised if the scope does not exist in the config.yml. ScopedPageAlreadyExists ( Exception ) \u00a4 Raised if the scoped page file already exists. TemplateFileNotFoundError ( Exception ) \u00a4 Raised if the template file does not exist.","title":"exceptions.py"},{"location":"code_reference/exceptions/#tembo.exceptions.BasePathDoesNotExistError","text":"Raised if the base path does not exist.","title":"BasePathDoesNotExistError"},{"location":"code_reference/exceptions/#tembo.exceptions.EmptyConfigYML","text":"Raised if the config.yml file is empty.","title":"EmptyConfigYML"},{"location":"code_reference/exceptions/#tembo.exceptions.MandatoryKeyNotFound","text":"Raised if a mandatory key is not found in the config.yml.","title":"MandatoryKeyNotFound"},{"location":"code_reference/exceptions/#tembo.exceptions.MismatchedTokenError","text":"Raised when the number of input tokens does not match the user config. Attributes: Name Type Description expected int number of input tokens in the user config. given int number of input tokens passed in.","title":"MismatchedTokenError"},{"location":"code_reference/exceptions/#tembo.exceptions.MismatchedTokenError.__init__","text":"Initialise the exception. Parameters: Name Type Description Default expected int number of input tokens in the user config. required given int number of input tokens passed in. required Source code in tembo/exceptions.py def __init__ ( self , expected : int , given : int ) -> None : \"\"\" Initialise the exception. Args: expected (int): number of input tokens in the user config. given (int): number of input tokens passed in. \"\"\" self . expected = expected self . given = given super () . __init__ ()","title":"__init__()"},{"location":"code_reference/exceptions/#tembo.exceptions.MissingConfigYML","text":"Raised if the config.yml file is missing.","title":"MissingConfigYML"},{"location":"code_reference/exceptions/#tembo.exceptions.ScopeNotFound","text":"Raised if the scope does not exist in the config.yml.","title":"ScopeNotFound"},{"location":"code_reference/exceptions/#tembo.exceptions.ScopedPageAlreadyExists","text":"Raised if the scoped page file already exists.","title":"ScopedPageAlreadyExists"},{"location":"code_reference/exceptions/#tembo.exceptions.TemplateFileNotFoundError","text":"Raised if the template file does not exist.","title":"TemplateFileNotFoundError"},{"location":"code_reference/cli/__init__/","text":"Subpackage that contains the CLI application.","title":"__init__.py"},{"location":"code_reference/cli/cli/","text":"Submodule which contains the CLI implementation using Click. cli_message ( message ) \u00a4 Relay a message to the user using the CLI. Parameters: Name Type Description Default message str THe message to be displayed. required Source code in tembo/cli/cli.py def cli_message ( message : str ) -> None : \"\"\" Relay a message to the user using the CLI. Args: message (str): THe message to be displayed. \"\"\" click . echo ( f \"[TEMBO] { message } \ud83d\udc18\" )","title":"cli.py"},{"location":"code_reference/cli/cli/#tembo.cli.cli.cli_message","text":"Relay a message to the user using the CLI. Parameters: Name Type Description Default message str THe message to be displayed. required Source code in tembo/cli/cli.py def cli_message ( message : str ) -> None : \"\"\" Relay a message to the user using the CLI. Args: message (str): THe message to be displayed. \"\"\" click . echo ( f \"[TEMBO] { message } \ud83d\udc18\" )","title":"cli_message()"},{"location":"code_reference/journal/__init__/","text":"Subpackage containing the logic to create Tembo journals & pages.","title":"__init__.py"},{"location":"code_reference/journal/pages/","text":"Submodule containing the factories & page objects to create Tembo pages. Page \u00a4 Abstract Page class. This interface is used to define a Page object. A Page represents a note/page that will be saved to disk. Abstract This object is an abstract base class and should be implemented for each Page type. path : pathlib . Path property readonly \u00a4 When implemented this should return the full path of the page including the filename. Returns: Type Description pathlib.Path the path as a Path object. Abstract This property is abstract and should be implemented for each Page type. __init__ ( self , path , page_content ) special \u00a4 When implemented this should initalise a Page object. Parameters: Name Type Description Default path pathlib.Path the full path of the page including the filename as a Path . required page_content str the contents of the page. required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" When implemented this should initalise a Page object. Args: path (pathlib.Path): the full path of the page including the filename as a [Path][pathlib.Path]. page_content (str): the contents of the page. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError save_to_disk ( self ) \u00a4 When implemented this should save the page to disk. Returns: Type Description tembo.utils.Success A Tembo Success object. Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" When implemented this should save the page to disk. Returns: tembo.utils.Success: A Tembo [Success][tembo.utils.__init__.Success] object. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError PageCreator \u00a4 A PageCreator factory base class. This factory should implement methods to create Page objects. Abstract This factory is an abstract base class and should be implemented for each Page type. The private methods _check_base_path_exists() _convert_base_path_to_path() _load_template() are not abstract and are shared between all Page types. options : PageCreatorOptions property readonly \u00a4 When implemented this should return the PageCreatorOptions on the class. Returns: Type Description PageCreatorOptions the instance of PageCreatorOptions set on the class. Abstract This method is abstract and should be implemented for each Page type. __init__ ( self , options ) special \u00a4 When implemented this should initialise the PageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" When implemented this should initialise the `PageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions] !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError create_page ( self ) \u00a4 When implemented this should create a Page object. Returns: Type Description Page an implemented instance of Page such as ScopedPage . Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def create_page ( self ) -> Page : \"\"\" When implemented this should create a `Page` object. Returns: Page: an implemented instance of [Page][tembo.journal.pages.Page] such as [ScopedPage][tembo.journal.pages.ScopedPage]. !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError PageCreatorOptions dataclass \u00a4 Options dataclass to create a Page. This is passed to an implemented instance of PageCreator Attributes: Name Type Description base_path str The base path. page_path str The path of the page relative to the base path. filename str The filename of the page. extension str The extension of the page. name str The name of the scope. user_input Collection[str] | None User input tokens. example str | None User example command. template_path str | None The path which contains the templates. This should be the full path and not relative to the base path. template_filename str | None The template filename with extension relative to the template path. ScopedPage ( Page ) \u00a4 A page that uses substitute tokens. Attributes: Name Type Description path pathlib.Path a Path object of the page's filepath including the filename. page_content str the content of the page from the template. path : pathlib . Path property readonly \u00a4 Return the full path of the page. Returns: Type Description pathlib.path The full path of the page as a Path object. __init__ ( self , path , page_content ) special \u00a4 Initalise a scoped page object. Parameters: Name Type Description Default path pathlib.Path a Path object of the page's filepath including the filename. required page_content str the content of the page from the template. required Source code in tembo/journal/pages.py def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" Initalise a scoped page object. Args: path (pathlib.Path): a [Path][pathlib.Path] object of the page's filepath including the filename. page_content (str): the content of the page from the template. \"\"\" self . _path = path self . page_content = page_content __str__ ( self ) special \u00a4 Return a str representation of a ScopedPage . Examples: >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") Returns: Type Description str The ScopedPage as a str . Source code in tembo/journal/pages.py def __str__ ( self ) -> str : \"\"\" Return a `str` representation of a `ScopedPage`. Examples: ``` >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") ``` Returns: str: The `ScopedPage` as a `str`. \"\"\" return f 'ScopedPage(\" { self . path } \")' save_to_disk ( self ) \u00a4 Save the scoped page to disk and write the page_content . Exceptions: Type Description exceptions.ScopedPageAlreadyExists If the page already exists a ScopedPageAlreadyExists exception is raised. Returns: Type Description tembo.utils.Success A Success with the path of the ScopedPage as the message. Source code in tembo/journal/pages.py def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" Save the scoped page to disk and write the `page_content`. Raises: exceptions.ScopedPageAlreadyExists: If the page already exists a [ScopedPageAlreadyExists][tembo.exceptions.ScopedPageAlreadyExists] exception is raised. Returns: tembo.utils.Success: A [Success][tembo.utils.__init__.Success] with the path of the ScopedPage as the message. \"\"\" # create the parent directories scoped_page_file = pathlib . Path ( self . path ) scoped_page_file . parents [ 0 ] . mkdir ( parents = True , exist_ok = True ) if scoped_page_file . exists (): raise exceptions . ScopedPageAlreadyExists ( f \" { self . path } already exists\" ) with scoped_page_file . open ( \"w\" , encoding = \"utf-8\" ) as scoped_page : scoped_page . write ( self . page_content ) return tembo . utils . Success ( str ( self . path )) ScopedPageCreator ( PageCreator ) \u00a4 Factory to create a scoped page. Attributes: Name Type Description base_path str base path of tembo. page_path str path of the page relative to the base path. filename str filename relative to the page path. extension str extension of file. options : PageCreatorOptions property readonly \u00a4 Return the PageCreatorOptions instance set on the factory. Returns: Type Description PageCreatorOptions An instance of PageCreatorOptions . __init__ ( self , options ) special \u00a4 Initialise a ScopedPageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions . required Source code in tembo/journal/pages.py def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" Initialise a `ScopedPageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions]. \"\"\" self . _all_input_tokens : list [ str ] = [] self . _options = options create_page ( self ) \u00a4 Create a ScopedPage object. This method will Check the base_path exists Verify the input tokens match the number defined in the config.yml Substitue the input tokens in the filepath Load the template contents and substitue the input tokens Exceptions: Type Description exceptions.MismatchedTokenError Raises MismatchedTokenError if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError Raises BasePathDoesNotExistError if the base path does not exist. exceptions.TemplateFileNotFoundError Raises TemplateFileNotFoundError if the template file is specified but not found. Returns: Type Description Page A ScopedPage object using the PageCreatorOptions . Source code in tembo/journal/pages.py def create_page ( self ) -> Page : \"\"\" Create a [ScopedPage][tembo.journal.pages.ScopedPage] object. This method will - Check the `base_path` exists - Verify the input tokens match the number defined in the `config.yml` - Substitue the input tokens in the filepath - Load the template contents and substitue the input tokens Raises: exceptions.MismatchedTokenError: Raises [MismatchedTokenError][tembo.exceptions.MismatchedTokenError] if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError: Raises [BasePathDoesNotExistError][tembo.exceptions.BasePathDoesNotExistError] if the base path does not exist. exceptions.TemplateFileNotFoundError: Raises [TemplateFileNotFoundError][tembo.exceptions.TemplateFileNotFoundError] if the template file is specified but not found. Returns: Page: A [ScopedPage][tembo.journal.pages.ScopedPage] object using the `PageCreatorOptions`. \"\"\" try : self . _check_base_path_exists () except exceptions . BasePathDoesNotExistError as base_path_does_not_exist_error : raise base_path_does_not_exist_error self . _all_input_tokens = self . _get_input_tokens () try : self . _verify_input_tokens () except exceptions . MismatchedTokenError as mismatched_token_error : raise mismatched_token_error path = self . _convert_base_path_to_path () path = pathlib . Path ( self . _substitute_tokens ( str ( path ))) try : template_contents = self . _load_template () except exceptions . TemplateFileNotFoundError as template_not_found_error : raise template_not_found_error if self . options . template_filename is not None : template_contents = self . _substitute_tokens ( template_contents ) return ScopedPage ( path , template_contents )","title":"pages.py"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page","text":"Abstract Page class. This interface is used to define a Page object. A Page represents a note/page that will be saved to disk. Abstract This object is an abstract base class and should be implemented for each Page type.","title":"Page"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.path","text":"When implemented this should return the full path of the page including the filename. Returns: Type Description pathlib.Path the path as a Path object. Abstract This property is abstract and should be implemented for each Page type.","title":"path"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.__init__","text":"When implemented this should initalise a Page object. Parameters: Name Type Description Default path pathlib.Path the full path of the page including the filename as a Path . required page_content str the contents of the page. required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" When implemented this should initalise a Page object. Args: path (pathlib.Path): the full path of the page including the filename as a [Path][pathlib.Path]. page_content (str): the contents of the page. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.save_to_disk","text":"When implemented this should save the page to disk. Returns: Type Description tembo.utils.Success A Tembo Success object. Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" When implemented this should save the page to disk. Returns: tembo.utils.Success: A Tembo [Success][tembo.utils.__init__.Success] object. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError","title":"save_to_disk()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator","text":"A PageCreator factory base class. This factory should implement methods to create Page objects. Abstract This factory is an abstract base class and should be implemented for each Page type. The private methods _check_base_path_exists() _convert_base_path_to_path() _load_template() are not abstract and are shared between all Page types.","title":"PageCreator"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.options","text":"When implemented this should return the PageCreatorOptions on the class. Returns: Type Description PageCreatorOptions the instance of PageCreatorOptions set on the class. Abstract This method is abstract and should be implemented for each Page type.","title":"options"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.__init__","text":"When implemented this should initialise the PageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" When implemented this should initialise the `PageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions] !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.create_page","text":"When implemented this should create a Page object. Returns: Type Description Page an implemented instance of Page such as ScopedPage . Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def create_page ( self ) -> Page : \"\"\" When implemented this should create a `Page` object. Returns: Page: an implemented instance of [Page][tembo.journal.pages.Page] such as [ScopedPage][tembo.journal.pages.ScopedPage]. !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError","title":"create_page()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreatorOptions","text":"Options dataclass to create a Page. This is passed to an implemented instance of PageCreator Attributes: Name Type Description base_path str The base path. page_path str The path of the page relative to the base path. filename str The filename of the page. extension str The extension of the page. name str The name of the scope. user_input Collection[str] | None User input tokens. example str | None User example command. template_path str | None The path which contains the templates. This should be the full path and not relative to the base path. template_filename str | None The template filename with extension relative to the template path.","title":"PageCreatorOptions"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage","text":"A page that uses substitute tokens. Attributes: Name Type Description path pathlib.Path a Path object of the page's filepath including the filename. page_content str the content of the page from the template.","title":"ScopedPage"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.path","text":"Return the full path of the page. Returns: Type Description pathlib.path The full path of the page as a Path object.","title":"path"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.__init__","text":"Initalise a scoped page object. Parameters: Name Type Description Default path pathlib.Path a Path object of the page's filepath including the filename. required page_content str the content of the page from the template. required Source code in tembo/journal/pages.py def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" Initalise a scoped page object. Args: path (pathlib.Path): a [Path][pathlib.Path] object of the page's filepath including the filename. page_content (str): the content of the page from the template. \"\"\" self . _path = path self . page_content = page_content","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.__str__","text":"Return a str representation of a ScopedPage . Examples: >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") Returns: Type Description str The ScopedPage as a str . Source code in tembo/journal/pages.py def __str__ ( self ) -> str : \"\"\" Return a `str` representation of a `ScopedPage`. Examples: ``` >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") ``` Returns: str: The `ScopedPage` as a `str`. \"\"\" return f 'ScopedPage(\" { self . path } \")'","title":"__str__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.save_to_disk","text":"Save the scoped page to disk and write the page_content . Exceptions: Type Description exceptions.ScopedPageAlreadyExists If the page already exists a ScopedPageAlreadyExists exception is raised. Returns: Type Description tembo.utils.Success A Success with the path of the ScopedPage as the message. Source code in tembo/journal/pages.py def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" Save the scoped page to disk and write the `page_content`. Raises: exceptions.ScopedPageAlreadyExists: If the page already exists a [ScopedPageAlreadyExists][tembo.exceptions.ScopedPageAlreadyExists] exception is raised. Returns: tembo.utils.Success: A [Success][tembo.utils.__init__.Success] with the path of the ScopedPage as the message. \"\"\" # create the parent directories scoped_page_file = pathlib . Path ( self . path ) scoped_page_file . parents [ 0 ] . mkdir ( parents = True , exist_ok = True ) if scoped_page_file . exists (): raise exceptions . ScopedPageAlreadyExists ( f \" { self . path } already exists\" ) with scoped_page_file . open ( \"w\" , encoding = \"utf-8\" ) as scoped_page : scoped_page . write ( self . page_content ) return tembo . utils . Success ( str ( self . path ))","title":"save_to_disk()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator","text":"Factory to create a scoped page. Attributes: Name Type Description base_path str base path of tembo. page_path str path of the page relative to the base path. filename str filename relative to the page path. extension str extension of file.","title":"ScopedPageCreator"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.options","text":"Return the PageCreatorOptions instance set on the factory. Returns: Type Description PageCreatorOptions An instance of PageCreatorOptions .","title":"options"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.__init__","text":"Initialise a ScopedPageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions . required Source code in tembo/journal/pages.py def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" Initialise a `ScopedPageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions]. \"\"\" self . _all_input_tokens : list [ str ] = [] self . _options = options","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.create_page","text":"Create a ScopedPage object. This method will Check the base_path exists Verify the input tokens match the number defined in the config.yml Substitue the input tokens in the filepath Load the template contents and substitue the input tokens Exceptions: Type Description exceptions.MismatchedTokenError Raises MismatchedTokenError if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError Raises BasePathDoesNotExistError if the base path does not exist. exceptions.TemplateFileNotFoundError Raises TemplateFileNotFoundError if the template file is specified but not found. Returns: Type Description Page A ScopedPage object using the PageCreatorOptions . Source code in tembo/journal/pages.py def create_page ( self ) -> Page : \"\"\" Create a [ScopedPage][tembo.journal.pages.ScopedPage] object. This method will - Check the `base_path` exists - Verify the input tokens match the number defined in the `config.yml` - Substitue the input tokens in the filepath - Load the template contents and substitue the input tokens Raises: exceptions.MismatchedTokenError: Raises [MismatchedTokenError][tembo.exceptions.MismatchedTokenError] if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError: Raises [BasePathDoesNotExistError][tembo.exceptions.BasePathDoesNotExistError] if the base path does not exist. exceptions.TemplateFileNotFoundError: Raises [TemplateFileNotFoundError][tembo.exceptions.TemplateFileNotFoundError] if the template file is specified but not found. Returns: Page: A [ScopedPage][tembo.journal.pages.ScopedPage] object using the `PageCreatorOptions`. \"\"\" try : self . _check_base_path_exists () except exceptions . BasePathDoesNotExistError as base_path_does_not_exist_error : raise base_path_does_not_exist_error self . _all_input_tokens = self . _get_input_tokens () try : self . _verify_input_tokens () except exceptions . MismatchedTokenError as mismatched_token_error : raise mismatched_token_error path = self . _convert_base_path_to_path () path = pathlib . Path ( self . _substitute_tokens ( str ( path ))) try : template_contents = self . _load_template () except exceptions . TemplateFileNotFoundError as template_not_found_error : raise template_not_found_error if self . options . template_filename is not None : template_contents = self . _substitute_tokens ( template_contents ) return ScopedPage ( path , template_contents )","title":"create_page()"},{"location":"code_reference/utils/__init__/","text":"Subpackage containing utility objects. Success dataclass \u00a4 A Tembo success object. This is returned from Page methods such as save_to_disk() Attributes: Name Type Description message str A success message.","title":"__init__.py"},{"location":"code_reference/utils/__init__/#tembo.utils.__init__.Success","text":"A Tembo success object. This is returned from Page methods such as save_to_disk() Attributes: Name Type Description message str A success message.","title":"Success"},{"location":"home/changelog/","text":"Changelog \u00a4 All notable changes to this project will be documented in this file. v1.0.2 - 2021-11-23 \u00a4 Compare with v1.0.1 Features \u00a4 Add garbage ( b49d77 ) Miscellaneous Tasks \u00a4 Prepare release v1.0.2 ( e29ae6 ) Update cliff.toml ( 7ee36f ) Update duties.py with latest changelog duty ( f6f2fe ) v1.0.1 - 2021-11-21 \u00a4 Compare with v1.0.0 Documentation \u00a4 Update changelog ( b71033 ) v1.0.0 - 2021-11-21 \u00a4 Documentation \u00a4 Update changelog ( 26fe81 ) Features \u00a4 Initial commit ( fb7fec ) Build \u00a4 Update panaetius to 2.3.3 ( e5d2b2 )","title":"Changelog"},{"location":"home/changelog/#changelog","text":"All notable changes to this project will be documented in this file.","title":"Changelog"},{"location":"home/changelog/#v102-2021-11-23","text":"Compare with v1.0.1","title":"v1.0.2 - 2021-11-23"},{"location":"home/changelog/#features","text":"Add garbage ( b49d77 )","title":"Features"},{"location":"home/changelog/#miscellaneous-tasks","text":"Prepare release v1.0.2 ( e29ae6 ) Update cliff.toml ( 7ee36f ) Update duties.py with latest changelog duty ( f6f2fe )","title":"Miscellaneous Tasks"},{"location":"home/changelog/#v101-2021-11-21","text":"Compare with v1.0.0","title":"v1.0.1 - 2021-11-21"},{"location":"home/changelog/#documentation","text":"Update changelog ( b71033 )","title":"Documentation"},{"location":"home/changelog/#v100-2021-11-21","text":"","title":"v1.0.0 - 2021-11-21"},{"location":"home/changelog/#documentation_1","text":"Update changelog ( 26fe81 )","title":"Documentation"},{"location":"home/changelog/#features_1","text":"Initial commit ( fb7fec )","title":"Features"},{"location":"home/changelog/#build","text":"Update panaetius to 2.3.3 ( e5d2b2 )","title":"Build"},{"location":"home/license/","text":"ISC License Copyright (c) 2021 Daniel Tomlinson Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.","title":"License"},{"location":"coverage/","text":".md-content { max-width: none !important; } article h1, article > a { display: none; } var coviframe = document.getElementById(\"coviframe\"); function resizeIframe() { coviframe.style.height = coviframe.contentWindow.document.documentElement.offsetHeight + 'px'; } coviframe.contentWindow.document.body.onclick = function() { coviframe.contentWindow.location.reload(); }","title":"Coverage report"}]}
\ No newline at end of file
+{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"Tembo \u00a4 from tembo import Success v0.0.8","title":"Overview"},{"location":"#tembo","text":"from tembo import Success v0.0.8","title":"Tembo"},{"location":"cli_reference/main/","text":"CLI Reference \u00a4 tembo \u00a4 Tembo - an organiser for work notes. Usage: tembo <options> COMMAND [ARGS]... Options: Name Type Description Default -v , --version boolean Show the version and exit. False --help boolean Show this message and exit. False list \u00a4 List all scopes defined in the config.yml. Usage: tembo list <options> Options: Name Type Description Default --help boolean Show this message and exit. False new \u00a4 Create a new page. <scope> The name of the scope in the config.yml. <inputs> Any input token values that are defined in the config.yml for this scope. Accepts multiple inputs separated by a space. Example: tembo new meeting my_presentation Usage: tembo new <options> <scope> <inputs> Options: Name Type Description Default --dry-run boolean Show the full path of the page to be created without actually saving the page to disk and exit. False --example boolean Show the example command in the config.yml if it exists and exit. False --help boolean Show this message and exit. False","title":"tembo"},{"location":"cli_reference/main/#cli-reference","text":"","title":"CLI Reference"},{"location":"cli_reference/main/#tembo","text":"Tembo - an organiser for work notes. Usage: tembo <options> COMMAND [ARGS]... Options: Name Type Description Default -v , --version boolean Show the version and exit. False --help boolean Show this message and exit. False","title":"tembo"},{"location":"cli_reference/main/#list","text":"List all scopes defined in the config.yml. Usage: tembo list <options> Options: Name Type Description Default --help boolean Show this message and exit. False","title":"list"},{"location":"cli_reference/main/#new","text":"Create a new page. <scope> The name of the scope in the config.yml. <inputs> Any input token values that are defined in the config.yml for this scope. Accepts multiple inputs separated by a space. Example: tembo new meeting my_presentation Usage: tembo new <options> <scope> <inputs> Options: Name Type Description Default --dry-run boolean Show the full path of the page to be created without actually saving the page to disk and exit. False --example boolean Show the example command in the config.yml if it exists and exit. False --help boolean Show this message and exit. False","title":"new"},{"location":"code_reference/SUMMARY/","text":"__init__.py __main__.py _version.py cli __init__.py cli.py exceptions.py journal __init__.py pages.py utils __init__.py","title":"SUMMARY"},{"location":"code_reference/__init__/","text":"Tembo package. A simple folder organiser for your work notes.","title":"__init__.py"},{"location":"code_reference/__main__/","text":"Entrypoint module. Used when using python -m tembo to invoke the CLI.","title":"__main__.py"},{"location":"code_reference/_version/","text":"Module containing the version of tembo.","title":"_version.py"},{"location":"code_reference/exceptions/","text":"Module containing custom exceptions. BasePathDoesNotExistError ( Exception ) \u00a4 Raised if the base path does not exist. EmptyConfigYML ( Exception ) \u00a4 Raised if the config.yml file is empty. MandatoryKeyNotFound ( Exception ) \u00a4 Raised if a mandatory key is not found in the config.yml. MismatchedTokenError ( Exception ) \u00a4 Raised when the number of input tokens does not match the user config. Attributes: Name Type Description expected int number of input tokens in the user config. given int number of input tokens passed in. __init__ ( self , expected , given ) special \u00a4 Initialise the exception. Parameters: Name Type Description Default expected int number of input tokens in the user config. required given int number of input tokens passed in. required Source code in tembo/exceptions.py def __init__ ( self , expected : int , given : int ) -> None : \"\"\" Initialise the exception. Args: expected (int): number of input tokens in the user config. given (int): number of input tokens passed in. \"\"\" self . expected = expected self . given = given super () . __init__ () MissingConfigYML ( Exception ) \u00a4 Raised if the config.yml file is missing. ScopeNotFound ( Exception ) \u00a4 Raised if the scope does not exist in the config.yml. ScopedPageAlreadyExists ( Exception ) \u00a4 Raised if the scoped page file already exists. TemplateFileNotFoundError ( Exception ) \u00a4 Raised if the template file does not exist.","title":"exceptions.py"},{"location":"code_reference/exceptions/#tembo.exceptions.BasePathDoesNotExistError","text":"Raised if the base path does not exist.","title":"BasePathDoesNotExistError"},{"location":"code_reference/exceptions/#tembo.exceptions.EmptyConfigYML","text":"Raised if the config.yml file is empty.","title":"EmptyConfigYML"},{"location":"code_reference/exceptions/#tembo.exceptions.MandatoryKeyNotFound","text":"Raised if a mandatory key is not found in the config.yml.","title":"MandatoryKeyNotFound"},{"location":"code_reference/exceptions/#tembo.exceptions.MismatchedTokenError","text":"Raised when the number of input tokens does not match the user config. Attributes: Name Type Description expected int number of input tokens in the user config. given int number of input tokens passed in.","title":"MismatchedTokenError"},{"location":"code_reference/exceptions/#tembo.exceptions.MismatchedTokenError.__init__","text":"Initialise the exception. Parameters: Name Type Description Default expected int number of input tokens in the user config. required given int number of input tokens passed in. required Source code in tembo/exceptions.py def __init__ ( self , expected : int , given : int ) -> None : \"\"\" Initialise the exception. Args: expected (int): number of input tokens in the user config. given (int): number of input tokens passed in. \"\"\" self . expected = expected self . given = given super () . __init__ ()","title":"__init__()"},{"location":"code_reference/exceptions/#tembo.exceptions.MissingConfigYML","text":"Raised if the config.yml file is missing.","title":"MissingConfigYML"},{"location":"code_reference/exceptions/#tembo.exceptions.ScopeNotFound","text":"Raised if the scope does not exist in the config.yml.","title":"ScopeNotFound"},{"location":"code_reference/exceptions/#tembo.exceptions.ScopedPageAlreadyExists","text":"Raised if the scoped page file already exists.","title":"ScopedPageAlreadyExists"},{"location":"code_reference/exceptions/#tembo.exceptions.TemplateFileNotFoundError","text":"Raised if the template file does not exist.","title":"TemplateFileNotFoundError"},{"location":"code_reference/cli/__init__/","text":"Subpackage that contains the CLI application.","title":"__init__.py"},{"location":"code_reference/cli/cli/","text":"Submodule which contains the CLI implementation using Click. cli_message ( message ) \u00a4 Relay a message to the user using the CLI. Parameters: Name Type Description Default message str THe message to be displayed. required Source code in tembo/cli/cli.py def cli_message ( message : str ) -> None : \"\"\" Relay a message to the user using the CLI. Args: message (str): THe message to be displayed. \"\"\" click . echo ( f \"[TEMBO] { message } \ud83d\udc18\" )","title":"cli.py"},{"location":"code_reference/cli/cli/#tembo.cli.cli.cli_message","text":"Relay a message to the user using the CLI. Parameters: Name Type Description Default message str THe message to be displayed. required Source code in tembo/cli/cli.py def cli_message ( message : str ) -> None : \"\"\" Relay a message to the user using the CLI. Args: message (str): THe message to be displayed. \"\"\" click . echo ( f \"[TEMBO] { message } \ud83d\udc18\" )","title":"cli_message()"},{"location":"code_reference/journal/__init__/","text":"Subpackage containing the logic to create Tembo journals & pages.","title":"__init__.py"},{"location":"code_reference/journal/pages/","text":"Submodule containing the factories & page objects to create Tembo pages. Page \u00a4 Abstract Page class. This interface is used to define a Page object. A Page represents a note/page that will be saved to disk. Abstract This object is an abstract base class and should be implemented for each Page type. path : pathlib . Path property readonly \u00a4 When implemented this should return the full path of the page including the filename. Returns: Type Description pathlib.Path the path as a Path object. Abstract This property is abstract and should be implemented for each Page type. __init__ ( self , path , page_content ) special \u00a4 When implemented this should initalise a Page object. Parameters: Name Type Description Default path pathlib.Path the full path of the page including the filename as a Path . required page_content str the contents of the page. required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" When implemented this should initalise a Page object. Args: path (pathlib.Path): the full path of the page including the filename as a [Path][pathlib.Path]. page_content (str): the contents of the page. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError save_to_disk ( self ) \u00a4 When implemented this should save the page to disk. Returns: Type Description tembo.utils.Success A Tembo Success object. Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" When implemented this should save the page to disk. Returns: tembo.utils.Success: A Tembo [Success][tembo.utils.__init__.Success] object. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError PageCreator \u00a4 A PageCreator factory base class. This factory should implement methods to create Page objects. Abstract This factory is an abstract base class and should be implemented for each Page type. The private methods _check_base_path_exists() _convert_base_path_to_path() _load_template() are not abstract and are shared between all Page types. options : PageCreatorOptions property readonly \u00a4 When implemented this should return the PageCreatorOptions on the class. Returns: Type Description PageCreatorOptions the instance of PageCreatorOptions set on the class. Abstract This method is abstract and should be implemented for each Page type. __init__ ( self , options ) special \u00a4 When implemented this should initialise the PageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" When implemented this should initialise the `PageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions] !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError create_page ( self ) \u00a4 When implemented this should create a Page object. Returns: Type Description Page an implemented instance of Page such as ScopedPage . Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def create_page ( self ) -> Page : \"\"\" When implemented this should create a `Page` object. Returns: Page: an implemented instance of [Page][tembo.journal.pages.Page] such as [ScopedPage][tembo.journal.pages.ScopedPage]. !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError PageCreatorOptions dataclass \u00a4 Options dataclass to create a Page. This is passed to an implemented instance of PageCreator Attributes: Name Type Description base_path str The base path. page_path str The path of the page relative to the base path. filename str The filename of the page. extension str The extension of the page. name str The name of the scope. user_input Collection[str] | None User input tokens. example str | None User example command. template_path str | None The path which contains the templates. This should be the full path and not relative to the base path. template_filename str | None The template filename with extension relative to the template path. ScopedPage ( Page ) \u00a4 A page that uses substitute tokens. Attributes: Name Type Description path pathlib.Path a Path object of the page's filepath including the filename. page_content str the content of the page from the template. path : pathlib . Path property readonly \u00a4 Return the full path of the page. Returns: Type Description pathlib.path The full path of the page as a Path object. __init__ ( self , path , page_content ) special \u00a4 Initalise a scoped page object. Parameters: Name Type Description Default path pathlib.Path a Path object of the page's filepath including the filename. required page_content str the content of the page from the template. required Source code in tembo/journal/pages.py def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" Initalise a scoped page object. Args: path (pathlib.Path): a [Path][pathlib.Path] object of the page's filepath including the filename. page_content (str): the content of the page from the template. \"\"\" self . _path = path self . page_content = page_content __str__ ( self ) special \u00a4 Return a str representation of a ScopedPage . Examples: >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") Returns: Type Description str The ScopedPage as a str . Source code in tembo/journal/pages.py def __str__ ( self ) -> str : \"\"\" Return a `str` representation of a `ScopedPage`. Examples: ``` >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") ``` Returns: str: The `ScopedPage` as a `str`. \"\"\" return f 'ScopedPage(\" { self . path } \")' save_to_disk ( self ) \u00a4 Save the scoped page to disk and write the page_content . Exceptions: Type Description exceptions.ScopedPageAlreadyExists If the page already exists a ScopedPageAlreadyExists exception is raised. Returns: Type Description tembo.utils.Success A Success with the path of the ScopedPage as the message. Source code in tembo/journal/pages.py def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" Save the scoped page to disk and write the `page_content`. Raises: exceptions.ScopedPageAlreadyExists: If the page already exists a [ScopedPageAlreadyExists][tembo.exceptions.ScopedPageAlreadyExists] exception is raised. Returns: tembo.utils.Success: A [Success][tembo.utils.__init__.Success] with the path of the ScopedPage as the message. \"\"\" # create the parent directories scoped_page_file = pathlib . Path ( self . path ) scoped_page_file . parents [ 0 ] . mkdir ( parents = True , exist_ok = True ) if scoped_page_file . exists (): raise exceptions . ScopedPageAlreadyExists ( f \" { self . path } already exists\" ) with scoped_page_file . open ( \"w\" , encoding = \"utf-8\" ) as scoped_page : scoped_page . write ( self . page_content ) return tembo . utils . Success ( str ( self . path )) ScopedPageCreator ( PageCreator ) \u00a4 Factory to create a scoped page. Attributes: Name Type Description base_path str base path of tembo. page_path str path of the page relative to the base path. filename str filename relative to the page path. extension str extension of file. options : PageCreatorOptions property readonly \u00a4 Return the PageCreatorOptions instance set on the factory. Returns: Type Description PageCreatorOptions An instance of PageCreatorOptions . __init__ ( self , options ) special \u00a4 Initialise a ScopedPageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions . required Source code in tembo/journal/pages.py def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" Initialise a `ScopedPageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions]. \"\"\" self . _all_input_tokens : list [ str ] = [] self . _options = options create_page ( self ) \u00a4 Create a ScopedPage object. This method will Check the base_path exists Verify the input tokens match the number defined in the config.yml Substitue the input tokens in the filepath Load the template contents and substitue the input tokens Exceptions: Type Description exceptions.MismatchedTokenError Raises MismatchedTokenError if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError Raises BasePathDoesNotExistError if the base path does not exist. exceptions.TemplateFileNotFoundError Raises TemplateFileNotFoundError if the template file is specified but not found. Returns: Type Description Page A ScopedPage object using the PageCreatorOptions . Source code in tembo/journal/pages.py def create_page ( self ) -> Page : \"\"\" Create a [ScopedPage][tembo.journal.pages.ScopedPage] object. This method will - Check the `base_path` exists - Verify the input tokens match the number defined in the `config.yml` - Substitue the input tokens in the filepath - Load the template contents and substitue the input tokens Raises: exceptions.MismatchedTokenError: Raises [MismatchedTokenError][tembo.exceptions.MismatchedTokenError] if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError: Raises [BasePathDoesNotExistError][tembo.exceptions.BasePathDoesNotExistError] if the base path does not exist. exceptions.TemplateFileNotFoundError: Raises [TemplateFileNotFoundError][tembo.exceptions.TemplateFileNotFoundError] if the template file is specified but not found. Returns: Page: A [ScopedPage][tembo.journal.pages.ScopedPage] object using the `PageCreatorOptions`. \"\"\" try : self . _check_base_path_exists () except exceptions . BasePathDoesNotExistError as base_path_does_not_exist_error : raise base_path_does_not_exist_error self . _all_input_tokens = self . _get_input_tokens () try : self . _verify_input_tokens () except exceptions . MismatchedTokenError as mismatched_token_error : raise mismatched_token_error path = self . _convert_base_path_to_path () path = pathlib . Path ( self . _substitute_tokens ( str ( path ))) try : template_contents = self . _load_template () except exceptions . TemplateFileNotFoundError as template_not_found_error : raise template_not_found_error if self . options . template_filename is not None : template_contents = self . _substitute_tokens ( template_contents ) return ScopedPage ( path , template_contents )","title":"pages.py"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page","text":"Abstract Page class. This interface is used to define a Page object. A Page represents a note/page that will be saved to disk. Abstract This object is an abstract base class and should be implemented for each Page type.","title":"Page"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.path","text":"When implemented this should return the full path of the page including the filename. Returns: Type Description pathlib.Path the path as a Path object. Abstract This property is abstract and should be implemented for each Page type.","title":"path"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.__init__","text":"When implemented this should initalise a Page object. Parameters: Name Type Description Default path pathlib.Path the full path of the page including the filename as a Path . required page_content str the contents of the page. required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" When implemented this should initalise a Page object. Args: path (pathlib.Path): the full path of the page including the filename as a [Path][pathlib.Path]. page_content (str): the contents of the page. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.Page.save_to_disk","text":"When implemented this should save the page to disk. Returns: Type Description tembo.utils.Success A Tembo Success object. Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" When implemented this should save the page to disk. Returns: tembo.utils.Success: A Tembo [Success][tembo.utils.__init__.Success] object. !!! abstract This method is abstract and should be implemented for each `Page` type. \"\"\" raise NotImplementedError","title":"save_to_disk()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator","text":"A PageCreator factory base class. This factory should implement methods to create Page objects. Abstract This factory is an abstract base class and should be implemented for each Page type. The private methods _check_base_path_exists() _convert_base_path_to_path() _load_template() are not abstract and are shared between all Page types.","title":"PageCreator"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.options","text":"When implemented this should return the PageCreatorOptions on the class. Returns: Type Description PageCreatorOptions the instance of PageCreatorOptions set on the class. Abstract This method is abstract and should be implemented for each Page type.","title":"options"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.__init__","text":"When implemented this should initialise the PageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions required Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" When implemented this should initialise the `PageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions] !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreator.create_page","text":"When implemented this should create a Page object. Returns: Type Description Page an implemented instance of Page such as ScopedPage . Abstract This method is abstract and should be implemented for each Page type. Source code in tembo/journal/pages.py @abstractmethod def create_page ( self ) -> Page : \"\"\" When implemented this should create a `Page` object. Returns: Page: an implemented instance of [Page][tembo.journal.pages.Page] such as [ScopedPage][tembo.journal.pages.ScopedPage]. !!! abstract This method is abstract and should be implemented for each [Page][tembo.journal.pages.Page] type. \"\"\" raise NotImplementedError","title":"create_page()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.PageCreatorOptions","text":"Options dataclass to create a Page. This is passed to an implemented instance of PageCreator Attributes: Name Type Description base_path str The base path. page_path str The path of the page relative to the base path. filename str The filename of the page. extension str The extension of the page. name str The name of the scope. user_input Collection[str] | None User input tokens. example str | None User example command. template_path str | None The path which contains the templates. This should be the full path and not relative to the base path. template_filename str | None The template filename with extension relative to the template path.","title":"PageCreatorOptions"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage","text":"A page that uses substitute tokens. Attributes: Name Type Description path pathlib.Path a Path object of the page's filepath including the filename. page_content str the content of the page from the template.","title":"ScopedPage"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.path","text":"Return the full path of the page. Returns: Type Description pathlib.path The full path of the page as a Path object.","title":"path"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.__init__","text":"Initalise a scoped page object. Parameters: Name Type Description Default path pathlib.Path a Path object of the page's filepath including the filename. required page_content str the content of the page from the template. required Source code in tembo/journal/pages.py def __init__ ( self , path : pathlib . Path , page_content : str ) -> None : \"\"\" Initalise a scoped page object. Args: path (pathlib.Path): a [Path][pathlib.Path] object of the page's filepath including the filename. page_content (str): the content of the page from the template. \"\"\" self . _path = path self . page_content = page_content","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.__str__","text":"Return a str representation of a ScopedPage . Examples: >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") Returns: Type Description str The ScopedPage as a str . Source code in tembo/journal/pages.py def __str__ ( self ) -> str : \"\"\" Return a `str` representation of a `ScopedPage`. Examples: ``` >>> str(ScopedPage(Path(\"/home/bob/tembo/meetings/my_meeting_0.md\"), \"\")) ScopedPage(\"/home/bob/tembo/meetings/my_meeting_0.md\") ``` Returns: str: The `ScopedPage` as a `str`. \"\"\" return f 'ScopedPage(\" { self . path } \")'","title":"__str__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPage.save_to_disk","text":"Save the scoped page to disk and write the page_content . Exceptions: Type Description exceptions.ScopedPageAlreadyExists If the page already exists a ScopedPageAlreadyExists exception is raised. Returns: Type Description tembo.utils.Success A Success with the path of the ScopedPage as the message. Source code in tembo/journal/pages.py def save_to_disk ( self ) -> tembo . utils . Success : \"\"\" Save the scoped page to disk and write the `page_content`. Raises: exceptions.ScopedPageAlreadyExists: If the page already exists a [ScopedPageAlreadyExists][tembo.exceptions.ScopedPageAlreadyExists] exception is raised. Returns: tembo.utils.Success: A [Success][tembo.utils.__init__.Success] with the path of the ScopedPage as the message. \"\"\" # create the parent directories scoped_page_file = pathlib . Path ( self . path ) scoped_page_file . parents [ 0 ] . mkdir ( parents = True , exist_ok = True ) if scoped_page_file . exists (): raise exceptions . ScopedPageAlreadyExists ( f \" { self . path } already exists\" ) with scoped_page_file . open ( \"w\" , encoding = \"utf-8\" ) as scoped_page : scoped_page . write ( self . page_content ) return tembo . utils . Success ( str ( self . path ))","title":"save_to_disk()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator","text":"Factory to create a scoped page. Attributes: Name Type Description base_path str base path of tembo. page_path str path of the page relative to the base path. filename str filename relative to the page path. extension str extension of file.","title":"ScopedPageCreator"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.options","text":"Return the PageCreatorOptions instance set on the factory. Returns: Type Description PageCreatorOptions An instance of PageCreatorOptions .","title":"options"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.__init__","text":"Initialise a ScopedPageCreator factory. Parameters: Name Type Description Default options PageCreatorOptions An instance of PageCreatorOptions . required Source code in tembo/journal/pages.py def __init__ ( self , options : PageCreatorOptions ) -> None : \"\"\" Initialise a `ScopedPageCreator` factory. Args: options (PageCreatorOptions): An instance of [PageCreatorOptions][tembo.journal.pages.PageCreatorOptions]. \"\"\" self . _all_input_tokens : list [ str ] = [] self . _options = options","title":"__init__()"},{"location":"code_reference/journal/pages/#tembo.journal.pages.ScopedPageCreator.create_page","text":"Create a ScopedPage object. This method will Check the base_path exists Verify the input tokens match the number defined in the config.yml Substitue the input tokens in the filepath Load the template contents and substitue the input tokens Exceptions: Type Description exceptions.MismatchedTokenError Raises MismatchedTokenError if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError Raises BasePathDoesNotExistError if the base path does not exist. exceptions.TemplateFileNotFoundError Raises TemplateFileNotFoundError if the template file is specified but not found. Returns: Type Description Page A ScopedPage object using the PageCreatorOptions . Source code in tembo/journal/pages.py def create_page ( self ) -> Page : \"\"\" Create a [ScopedPage][tembo.journal.pages.ScopedPage] object. This method will - Check the `base_path` exists - Verify the input tokens match the number defined in the `config.yml` - Substitue the input tokens in the filepath - Load the template contents and substitue the input tokens Raises: exceptions.MismatchedTokenError: Raises [MismatchedTokenError][tembo.exceptions.MismatchedTokenError] if the number of input tokens does not match the number of unique input tokens defined. exceptions.BasePathDoesNotExistError: Raises [BasePathDoesNotExistError][tembo.exceptions.BasePathDoesNotExistError] if the base path does not exist. exceptions.TemplateFileNotFoundError: Raises [TemplateFileNotFoundError][tembo.exceptions.TemplateFileNotFoundError] if the template file is specified but not found. Returns: Page: A [ScopedPage][tembo.journal.pages.ScopedPage] object using the `PageCreatorOptions`. \"\"\" try : self . _check_base_path_exists () except exceptions . BasePathDoesNotExistError as base_path_does_not_exist_error : raise base_path_does_not_exist_error self . _all_input_tokens = self . _get_input_tokens () try : self . _verify_input_tokens () except exceptions . MismatchedTokenError as mismatched_token_error : raise mismatched_token_error path = self . _convert_base_path_to_path () path = pathlib . Path ( self . _substitute_tokens ( str ( path ))) try : template_contents = self . _load_template () except exceptions . TemplateFileNotFoundError as template_not_found_error : raise template_not_found_error if self . options . template_filename is not None : template_contents = self . _substitute_tokens ( template_contents ) return ScopedPage ( path , template_contents )","title":"create_page()"},{"location":"code_reference/utils/__init__/","text":"Subpackage containing utility objects. Success dataclass \u00a4 A Tembo success object. This is returned from Page methods such as save_to_disk() Attributes: Name Type Description message str A success message.","title":"__init__.py"},{"location":"code_reference/utils/__init__/#tembo.utils.__init__.Success","text":"A Tembo success object. This is returned from Page methods such as save_to_disk() Attributes: Name Type Description message str A success message.","title":"Success"},{"location":"home/changelog/","text":"Changelog \u00a4 All notable changes to this project will be documented in this file. v1.0.3 - 2021-11-23 \u00a4 Compare with v1.0.2 Documentation \u00a4 Update changelog ( f33f21 ) Update changelog ( d84150 ) Miscellaneous Tasks \u00a4 Update duties.py ( d9e13b ) v1.0.2 - 2021-11-23 \u00a4 Compare with v1.0.1 Documentation \u00a4 Update CHANGELOG.md ( 2b5632 ) Update license reference ( e17882 ) Features \u00a4 Add garbage ( b49d77 ) Miscellaneous Tasks \u00a4 Prepare release v1.0.2 ( e29ae6 ) Update cliff.toml ( 7ee36f ) Update duties.py with latest changelog duty ( f6f2fe ) Update cliff.toml & duties.py ( 8c1d76 ) v1.0.1 - 2021-11-21 \u00a4 Compare with v1.0.0 Documentation \u00a4 Update changelog ( b71033 ) v1.0.0 - 2021-11-21 \u00a4 Documentation \u00a4 Update changelog ( 26fe81 ) Features \u00a4 Initial commit ( fb7fec ) Build \u00a4 Update panaetius to 2.3.3 ( e5d2b2 )","title":"Changelog"},{"location":"home/changelog/#changelog","text":"All notable changes to this project will be documented in this file.","title":"Changelog"},{"location":"home/changelog/#v103-2021-11-23","text":"Compare with v1.0.2","title":"v1.0.3 - 2021-11-23"},{"location":"home/changelog/#documentation","text":"Update changelog ( f33f21 ) Update changelog ( d84150 )","title":"Documentation"},{"location":"home/changelog/#miscellaneous-tasks","text":"Update duties.py ( d9e13b )","title":"Miscellaneous Tasks"},{"location":"home/changelog/#v102-2021-11-23","text":"Compare with v1.0.1","title":"v1.0.2 - 2021-11-23"},{"location":"home/changelog/#documentation_1","text":"Update CHANGELOG.md ( 2b5632 ) Update license reference ( e17882 )","title":"Documentation"},{"location":"home/changelog/#features","text":"Add garbage ( b49d77 )","title":"Features"},{"location":"home/changelog/#miscellaneous-tasks_1","text":"Prepare release v1.0.2 ( e29ae6 ) Update cliff.toml ( 7ee36f ) Update duties.py with latest changelog duty ( f6f2fe ) Update cliff.toml & duties.py ( 8c1d76 )","title":"Miscellaneous Tasks"},{"location":"home/changelog/#v101-2021-11-21","text":"Compare with v1.0.0","title":"v1.0.1 - 2021-11-21"},{"location":"home/changelog/#documentation_2","text":"Update changelog ( b71033 )","title":"Documentation"},{"location":"home/changelog/#v100-2021-11-21","text":"","title":"v1.0.0 - 2021-11-21"},{"location":"home/changelog/#documentation_3","text":"Update changelog ( 26fe81 )","title":"Documentation"},{"location":"home/changelog/#features_1","text":"Initial commit ( fb7fec )","title":"Features"},{"location":"home/changelog/#build","text":"Update panaetius to 2.3.3 ( e5d2b2 )","title":"Build"},{"location":"home/license/","text":"ISC License Copyright (c) 2021 Daniel Tomlinson Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.","title":"License"},{"location":"coverage/","text":".md-content { max-width: none !important; } article h1, article > a { display: none; } var coviframe = document.getElementById(\"coviframe\"); function resizeIframe() { coviframe.style.height = coviframe.contentWindow.document.documentElement.offsetHeight + 'px'; } coviframe.contentWindow.document.body.onclick = function() { coviframe.contentWindow.location.reload(); }","title":"Coverage report"}]}
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index 0811eb5..d55ff61 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,77 +2,77 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/cli_reference/main/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>None</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/__init__/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/__main__/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/_version/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/exceptions/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/cli/__init__/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/cli/cli/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/journal/__init__/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/journal/pages/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/code_reference/utils/__init__/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/home/changelog/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/home/license/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://tembo-pages.github.io/tembo-core/coverage/</loc>
-         <lastmod>2021-11-23</lastmod>
+         <lastmod>2021-11-24</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 69d99d5..2af9137 100644
Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ