Deployed 6d57622 with MkDocs version: 1.3.0

404.html

@@ -348,7 +348,7 @@
   
     <li class="md-nav__item">
       <a href="/how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

examples/simple-mag/train/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

examples/simple/data/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

examples/simple/deploy/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

examples/simple/train/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

explanation/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

how-to-guides/call-remote/index.html

@@ -348,7 +348,7 @@
   
     <li class="md-nav__item">
       <a href="../create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

how-to-guides/create-service/create-service.md

@@ -1,6 +1,6 @@
-# How to instantiate a GreatAI service
+# How to create a GreatAI service
 
-The core value of the `great-ai` library lies in its [great_ai.deploy.GreatAI][] class. In order to take advantage of it, you need to create an instance wrapping your code.
+The core value of `great-ai` lies in its [GreatAI][great_ai.deploy.GreatAI] class. In order to take advantage of it, you need to create an instance wrapping your code.
 
 Let's say that you have the following greeter function:
 
@@ -9,7 +9,7 @@ def my_greeter_function(your_name):
     return f'Hi {your_name}!'
 ```
 
-You can simply decorate (wrap) this function with the `GreatAI.create` factory.
+You can simply decorate (wrap) this function using the [@GreatAI.create][great_ai.deploy.GreatAI.create] factory.
 
 ```python title="greeter.py"
 from great_ai import GreatAI
@@ -20,7 +20,7 @@ def greeter(your_name):
 ```
 
 ??? info "Why not simply use `@GreatAI?`"
-    The purpose of the `GreatAI.create` is simply to provide you with type-checking through MyPy, Pylance, and similar libraries. However, the overloading support for `__new__` is lacking in MyPy, thus, a static factory method is used instead.
+    The purpose of the [@GreatAI.create][great_ai.deploy.GreatAI.create] is simply to provide you with type-checking through MyPy, Pylance, and similar libraries. However, the overloading support for `__new__` is lacking in MyPy, thus, a static factory method is used instead.
 
 ## With types
 
@@ -52,11 +52,11 @@ async def async_greeter(your_name: str) -> str:
 
 ## With decorators
 
-GreatAI can decorate already decorated functions. The only restriction is that `@GreatAI.create` always have to come last. There are two built-in decorators that you can use to customise your function.
+GreatAI can decorate already decorated functions. The only restriction is that [@GreatAI.create][great_ai.deploy.GreatAI.create]  always has to come last. There are two built-in decorators that you can use to customise your function but you can you use any third-party decorator as well.
 
 ### Using `use_model`
 
-If you have previously saved a model with `save_model`, you can inject it into your function by calling `use_model`.
+If you have previously saved a model with [save_model][great_ai.save_model], you can inject it into your function by calling [@use_model][great_ai.use_model].
 
 ```python title="greeter_with_model.py"
 from great_ai import GreatAI, use_model
@@ -72,15 +72,14 @@ assert type_safe_greeter('Andras').output == 'Hi Andras'
 1.  By default, the parameter named `model` will be replaced by the loaded model. This behaviour can be customised by setting the `model_kwarg_name`. This way, even multiple models can be injected into a single function.
 
 !!! important
-    You must call `@use_model` before `GreatAI.create`. Feel free to use `@use_model` in other places of the code base, it works equally well outside of GreatAI services. 
-
+    You must call [@use_model][great_ai.use_model] before [@GreatAI.create][great_ai.deploy.GreatAI.create]. Feel free to use [@use_model][great_ai.use_model] in other places of the codebase, it works equally well outside of GreatAI services. 
 
 ### Using `parameter`
 
-If you wish to turn of logging or specify custom validation for your parameters, you can use the `@parameter` decorator.
+If you wish to turn of logging or specify custom validation for your parameters, you can use the [@parameter][great_ai.parameter] decorator.
 
 !!! note
-    By default, all parameters that are not affected by an explicit `@parameter` or `@use_model` decorator, are automatically decorated with `@parameter` when `GreatAI.create` is called.
+    By default, all parameters that are not affected by an explicit [@parameter][great_ai.parameter] or [@use_model][great_ai.use_model] are automatically decorated with [@parameter][great_ai.parameter] when [@GreatAI.create][great_ai.deploy.GreatAI.create] is called.
 
 ```python title="greeter_with_validation.py"
 from great_ai import GreatAI, use_model
@@ -94,8 +93,7 @@ assert type_safe_greeter('Andras').output == 'Hi Andras'
 ```
 
 !!! important
-    You must call `@parameter` before `GreatAI.create`. Feel free to use `@parameter` in other places of the code base, it works equally well outside of GreatAI services. 
-
+    You must call [@parameter][great_ai.parameter] before [@GreatAI.create][great_ai.deploy.GreatAI.create]. Feel free to use [@parameter][great_ai.parameter] in other places of the codebase, it works equally well outside of GreatAI services. 
 
 ## Complex example
 
@@ -107,7 +105,7 @@ from great_ai import save_model, GreatAI, parameter, use_model
 save_model(4, 'secret-number')  #(1)
 
 @GreatAI.create
-@parameter('positive_number', validator=lambda n: n > 0)
+@parameter('positive_number', validator=lambda n: n > 0, disable_logging=True)
 @use_model('secret-number', version='latest', model_kwarg_name='secret')
 def add_number(positive_number: int, secret: int) -> int:
     return positive_number + secret

how-to-guides/create-service/index.html

@@ -17,7 +17,7 @@
     
     
       
-        <title>How to instantiate a GreatAI service - GreatAI documentation</title>
+        <title>How to create a GreatAI service - GreatAI documentation</title>
       
     
     
@@ -70,7 +70,7 @@
     <div data-md-component="skip">
       
         
-        <a href="#how-to-instantiate-a-greatai-service" class="md-skip">
+        <a href="#how-to-create-a-greatai-service" class="md-skip">
           Skip to content
         </a>
       
@@ -103,7 +103,7 @@
         <div class="md-header__topic" data-md-component="header-topic">
           <span class="md-ellipsis">
             
-              How to instantiate a GreatAI service
+              How to create a GreatAI service
             
           </span>
         </div>
@@ -364,12 +364,12 @@
       
       
         <label class="md-nav__link md-nav__link--active" for="__toc">
-          How to instantiate a GreatAI service
+          How to create a GreatAI service
           <span class="md-nav__icon md-icon"></span>
         </label>
       
       <a href="./" class="md-nav__link md-nav__link--active">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
       
         
@@ -650,13 +650,13 @@
 
 
 
-<h1 id="how-to-instantiate-a-greatai-service">How to instantiate a GreatAI service<a class="headerlink" href="#how-to-instantiate-a-greatai-service" title="Permanent link">#</a></h1>
-<p>The core value of the <code>great-ai</code> library lies in its <a class="autorefs autorefs-internal" href="../../reference/#great_ai.GreatAI">great_ai.deploy.GreatAI</a> class. In order to take advantage of it, you need to create an instance wrapping your code.</p>
+<h1 id="how-to-create-a-greatai-service">How to create a GreatAI service<a class="headerlink" href="#how-to-create-a-greatai-service" title="Permanent link">#</a></h1>
+<p>The core value of <code>great-ai</code> lies in its <a class="autorefs autorefs-internal" href="../../reference/#great_ai.GreatAI">GreatAI</a> class. In order to take advantage of it, you need to create an instance wrapping your code.</p>
 <p>Let's say that you have the following greeter function:</p>
 <div class="highlight"><span class="filename">greeter.py</span><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="k">def</span> <span class="nf">my_greeter_function</span><span class="p">(</span><span class="n">your_name</span><span class="p">):</span>
 <a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a>    <span class="k">return</span> <span class="sa">f</span><span class="s1">&#39;Hi </span><span class="si">{</span><span class="n">your_name</span><span class="si">}</span><span class="s1">!&#39;</span>
 </code></pre></div>
-<p>You can simply decorate (wrap) this function with the <code>GreatAI.create</code> factory.</p>
+<p>You can simply decorate (wrap) this function using the <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a> factory.</p>
 <div class="highlight"><span class="filename">greeter.py</span><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="kn">from</span> <span class="nn">great_ai</span> <span class="kn">import</span> <span class="n">GreatAI</span>
 <a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a>
 <a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="nd">@GreatAI</span><span class="o">.</span><span class="n">create</span>
@@ -665,7 +665,7 @@
 </code></pre></div>
 <details class="info">
 <summary>Why not simply use <code>@GreatAI?</code></summary>
-<p>The purpose of the <code>GreatAI.create</code> is simply to provide you with type-checking through MyPy, Pylance, and similar libraries. However, the overloading support for <code>__new__</code> is lacking in MyPy, thus, a static factory method is used instead.</p>
+<p>The purpose of the <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a> is simply to provide you with type-checking through MyPy, Pylance, and similar libraries. However, the overloading support for <code>__new__</code> is lacking in MyPy, thus, a static factory method is used instead.</p>
 </details>
 <h2 id="with-types">With types<a class="headerlink" href="#with-types" title="Permanent link">#</a></h2>
 <p><a href="https://realpython.com/python-type-checking/" target="_blank">Type annotating your codebase</a> can save you from lots of trivial mistakes, that's why it's highly advised. Simply add the expected types to your function's signature.</p>
@@ -687,9 +687,9 @@
 <a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>    <span class="k">return</span> <span class="sa">f</span><span class="s1">&#39;Hi </span><span class="si">{</span><span class="n">your_name</span><span class="si">}</span><span class="s1">!&#39;</span>
 </code></pre></div>
 <h2 id="with-decorators">With decorators<a class="headerlink" href="#with-decorators" title="Permanent link">#</a></h2>
-<p>GreatAI can decorate already decorated functions. The only restriction is that <code>@GreatAI.create</code> always have to come last. There are two built-in decorators that you can use to customise your function.</p>
+<p>GreatAI can decorate already decorated functions. The only restriction is that <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a>  always has to come last. There are two built-in decorators that you can use to customise your function but you can you use any third-party decorator as well.</p>
 <h3 id="using-use_model">Using <code>use_model</code><a class="headerlink" href="#using-use_model" title="Permanent link">#</a></h3>
-<p>If you have previously saved a model with <code>save_model</code>, you can inject it into your function by calling <code>use_model</code>.</p>
+<p>If you have previously saved a model with <a class="autorefs autorefs-internal" href="../../reference/#great_ai.save_model">save_model</a>, you can inject it into your function by calling <a class="autorefs autorefs-internal" href="../../reference/#great_ai.use_model">@use_model</a>.</p>
 <div class="highlight"><span class="filename">greeter_with_model.py</span><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="kn">from</span> <span class="nn">great_ai</span> <span class="kn">import</span> <span class="n">GreatAI</span><span class="p">,</span> <span class="n">use_model</span>
 <a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a>
 <a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nd">@GreatAI</span><span class="o">.</span><span class="n">create</span>
@@ -704,13 +704,13 @@
 </ol>
 <div class="admonition important">
 <p class="admonition-title">Important</p>
-<p>You must call <code>@use_model</code> before <code>GreatAI.create</code>. Feel free to use <code>@use_model</code> in other places of the code base, it works equally well outside of GreatAI services. </p>
+<p>You must call <a class="autorefs autorefs-internal" href="../../reference/#great_ai.use_model">@use_model</a> before <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a>. Feel free to use <a class="autorefs autorefs-internal" href="../../reference/#great_ai.use_model">@use_model</a> in other places of the codebase, it works equally well outside of GreatAI services. </p>
 </div>
 <h3 id="using-parameter">Using <code>parameter</code><a class="headerlink" href="#using-parameter" title="Permanent link">#</a></h3>
-<p>If you wish to turn of logging or specify custom validation for your parameters, you can use the <code>@parameter</code> decorator.</p>
+<p>If you wish to turn of logging or specify custom validation for your parameters, you can use the <a class="autorefs autorefs-internal" href="../../reference/#great_ai.parameter">@parameter</a> decorator.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>
-<p>By default, all parameters that are not affected by an explicit <code>@parameter</code> or <code>@use_model</code> decorator, are automatically decorated with <code>@parameter</code> when <code>GreatAI.create</code> is called.</p>
+<p>By default, all parameters that are not affected by an explicit <a class="autorefs autorefs-internal" href="../../reference/#great_ai.parameter">@parameter</a> or <a class="autorefs autorefs-internal" href="../../reference/#great_ai.use_model">@use_model</a> are automatically decorated with <a class="autorefs autorefs-internal" href="../../reference/#great_ai.parameter">@parameter</a> when <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a> is called.</p>
 </div>
 <div class="highlight"><span class="filename">greeter_with_validation.py</span><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="kn">from</span> <span class="nn">great_ai</span> <span class="kn">import</span> <span class="n">GreatAI</span><span class="p">,</span> <span class="n">use_model</span>
 <a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>
@@ -723,7 +723,7 @@
 </code></pre></div>
 <div class="admonition important">
 <p class="admonition-title">Important</p>
-<p>You must call <code>@parameter</code> before <code>GreatAI.create</code>. Feel free to use <code>@parameter</code> in other places of the code base, it works equally well outside of GreatAI services. </p>
+<p>You must call <a class="autorefs autorefs-internal" href="../../reference/#great_ai.parameter">@parameter</a> before <a class="autorefs autorefs-internal" href="../../reference/#great_ai.deploy.great_ai.GreatAI.create">@GreatAI.create</a>. Feel free to use <a class="autorefs autorefs-internal" href="../../reference/#great_ai.parameter">@parameter</a> in other places of the codebase, it works equally well outside of GreatAI services. </p>
 </div>
 <h2 id="complex-example">Complex example<a class="headerlink" href="#complex-example" title="Permanent link">#</a></h2>
 <p>Refer to the following example summarising the options you have when instantiating a GreatAI service.</p>
@@ -732,7 +732,7 @@
 <a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="n">save_model</span><span class="p">(</span><span class="mi">4</span><span class="p">,</span> <span class="s1">&#39;secret-number&#39;</span><span class="p">)</span>  <span class="c1">#(1)</span>
 <a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a>
 <a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a><span class="nd">@GreatAI</span><span class="o">.</span><span class="n">create</span>
-<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="nd">@parameter</span><span class="p">(</span><span class="s1">&#39;positive_number&#39;</span><span class="p">,</span> <span class="n">validator</span><span class="o">=</span><span class="k">lambda</span> <span class="n">n</span><span class="p">:</span> <span class="n">n</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">)</span>
+<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="nd">@parameter</span><span class="p">(</span><span class="s1">&#39;positive_number&#39;</span><span class="p">,</span> <span class="n">validator</span><span class="o">=</span><span class="k">lambda</span> <span class="n">n</span><span class="p">:</span> <span class="n">n</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">,</span> <span class="n">disable_logging</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
 <a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a><span class="nd">@use_model</span><span class="p">(</span><span class="s1">&#39;secret-number&#39;</span><span class="p">,</span> <span class="n">version</span><span class="o">=</span><span class="s1">&#39;latest&#39;</span><span class="p">,</span> <span class="n">model_kwarg_name</span><span class="o">=</span><span class="s1">&#39;secret&#39;</span><span class="p">)</span>
 <a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="k">def</span> <span class="nf">add_number</span><span class="p">(</span><span class="n">positive_number</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span> <span class="n">secret</span><span class="p">:</span> <span class="nb">int</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
 <a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a>    <span class="k">return</span> <span class="n">positive_number</span> <span class="o">+</span> <span class="n">secret</span>

how-to-guides/scraping/index.html

@@ -348,7 +348,7 @@
   
     <li class="md-nav__item">
       <a href="../create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

how-to-guides/store-models/index.html

@@ -348,7 +348,7 @@
   
     <li class="md-nav__item">
       <a href="../create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

how-to-guides/using-service/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

index.html

@@ -418,7 +418,7 @@
   
     <li class="md-nav__item">
       <a href="how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

open_s3/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

reference/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   
@@ -2470,7 +2470,7 @@ Returns:
     <nav class="md-footer__inner md-grid" aria-label="Footer" >
       
         
-        <a href="../how-to-guides/create-service/" class="md-footer__link md-footer__link--prev" aria-label="Previous: How to instantiate a GreatAI service" rel="prev">
+        <a href="../how-to-guides/create-service/" class="md-footer__link md-footer__link--prev" aria-label="Previous: How to create a GreatAI service" rel="prev">
           <div class="md-footer__button md-icon">
             <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
           </div>
@@ -2479,7 +2479,7 @@ Returns:
               <span class="md-footer__direction">
                 Previous
               </span>
-              How to instantiate a GreatAI service
+              How to create a GreatAI service
             </div>
           </div>
         </a>

reference/large-file/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

reference/utilities/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>
   

reference/views/index.html

@@ -353,7 +353,7 @@
   
     <li class="md-nav__item">
       <a href="../../how-to-guides/create-service/" class="md-nav__link">
-        How to instantiate a GreatAI service
+        How to create a GreatAI service
       </a>
     </li>