Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace CurrencySpace.axes with CurrencySpace.currencies in Quickstart #5

Merged
merged 1 commit into from
Jan 3, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ Full multi-currency support for python.

---

Quickstart Tutorial: https://grammacc.github.io/linearmoney/quickstart.html

Full Documentation: https://grammacc.github.io/linearmoney

License: [MIT](LICENSE)
Expand Down
2 changes: 1 addition & 1 deletion docs/404.html
Original file line number Diff line number Diff line change
Expand Up @@ -241,7 +241,7 @@


<li class="md-nav__item">
<a href="/linearmoney/quickstart_tutorial.html" class="md-nav__link">
<a href="/linearmoney/quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
2 changes: 1 addition & 1 deletion docs/FAQ.html
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@


<li class="md-nav__item">
<a href="quickstart_tutorial.html" class="md-nav__link">
<a href="quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
122 changes: 59 additions & 63 deletions docs/api_reference/linearmoney/vector.html

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/glossary.html
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@


<li class="md-nav__item">
<a href="quickstart_tutorial.html" class="md-nav__link">
<a href="quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
4 changes: 2 additions & 2 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@



<link rel="next" href="quickstart_tutorial.html">
<link rel="next" href="quickstart.html">


<link rel="icon" href="assets/images/favicon.png">
Expand Down Expand Up @@ -299,7 +299,7 @@


<li class="md-nav__item">
<a href="quickstart_tutorial.html" class="md-nav__link">
<a href="quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
2 changes: 1 addition & 1 deletion docs/linear_money_model.html
Original file line number Diff line number Diff line change
Expand Up @@ -252,7 +252,7 @@


<li class="md-nav__item">
<a href="quickstart_tutorial.html" class="md-nav__link">
<a href="quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
41 changes: 21 additions & 20 deletions docs/quickstart_tutorial.html → docs/quickstart.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@



<link rel="canonical" href="https://grammacc.github.io/linearmoney/quickstart_tutorial.html">
<link rel="canonical" href="https://grammacc.github.io/linearmoney/quickstart.html">


<link rel="prev" href="index.html">
Expand Down Expand Up @@ -274,7 +274,7 @@
<span class="md-nav__icon md-icon"></span>
</label>

<a href="quickstart_tutorial.html" class="md-nav__link md-nav__link--active">
<a href="quickstart.html" class="md-nav__link md-nav__link--active">


<span class="md-ellipsis">
Expand Down Expand Up @@ -635,7 +635,7 @@

<h1 id="quickstart-tutorial">Quickstart Tutorial</h1>
<p>In this quick start guide, we'll make a simple commandline currency converter.
Knowledge of commandline applications is not required to complete
Knowledge of commandline application development is not required to complete
this tutorial. However, a basic understanding of Python and running Python
scripts is assumed. It should take about 30 minutes to complete.</p>
<p>By the end of this tutorial, you should know how to:</p>
Expand Down Expand Up @@ -1031,14 +1031,14 @@ <h3 id="parsing-args">Parsing Args</h3>
<span class="s2">&quot;from_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;from_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 aplphabetic currency code</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;to_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;to_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 alphabetic currency code</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>
</code></pre></div>

Expand Down Expand Up @@ -1147,14 +1147,14 @@ <h3 id="parsing-args">Parsing Args</h3>
<span class="s2">&quot;from_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;from_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 aplphabetic currency code</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;to_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;to_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 alphabetic currency code</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>
<span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
<span class="n">readline</span> <span class="o">=</span> <span class="nb">input</span><span class="p">(</span><span class="s2">&quot;Currency Converter--&gt; &quot;</span><span class="p">)</span>
Expand Down Expand Up @@ -1257,21 +1257,22 @@ <h3 id="error-handling">Error handling</h3>
<div class="language-python"><pre><span></span><code><span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;from_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;from_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 aplphabetic currency code</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;to_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;to_currency&gt;&quot;</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 alphabetic currency code</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>
</code></pre></div>

<p>The <code>axes</code> of our <code>currency_space</code> are of course the valid currency codes that we have
<p>The <a href="api_reference/linearmoney/vector.html#CurrencySpace.currencies"><code>currencies</code></a>
of our <code>currency_space</code> are of course the valid currency codes that we have
forex rates for, so now, if we rerun with these changes, we'll see that passing in bad
input for the <code>&lt;from_currency&gt;</code> or <code>&lt;to_currency&gt;</code> arguments, such as <code>"10 bad USD"</code> or
<code>"10 USD bad"</code> gives an appropriate error message and doesn't crash our prompt.</p>
Expand All @@ -1293,18 +1294,18 @@ <h3 id="error-handling">Error handling</h3>
<span class="s2">&quot;from_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;from_currency&gt;&quot;</span><span class="p">,</span>
<span class="nb">type</span><span class="o">=</span><span class="n">_upper_code</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 aplphabetic currency code</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;to_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;to_currency&gt;&quot;</span><span class="p">,</span>
<span class="nb">type</span><span class="o">=</span><span class="n">_upper_code</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 alphabetic currency code</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>
</code></pre></div>

Expand Down Expand Up @@ -1397,18 +1398,18 @@ <h2 id="complete-script">Complete Script</h2>
<span class="s2">&quot;from_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;from_currency&gt;&quot;</span><span class="p">,</span>
<span class="nb">type</span><span class="o">=</span><span class="n">_upper_code</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 aplphabetic currency code</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> of the &lt;amount&gt;. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="n">parser</span><span class="o">.</span><span class="n">add_argument</span><span class="p">(</span>
<span class="s2">&quot;to_currency&quot;</span><span class="p">,</span>
<span class="n">metavar</span><span class="o">=</span><span class="s2">&quot;&lt;to_currency&gt;&quot;</span><span class="p">,</span>
<span class="nb">type</span><span class="o">=</span><span class="n">_upper_code</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="p">,</span>
<span class="n">choices</span><span class="o">=</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="p">,</span>
<span class="n">help</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;&quot;&quot;The case-insensitive ISO 4217 alphabetic currency code</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">axes</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="s2"> to convert the &lt;amount&gt; to. Accepted values: </span><span class="si">{</span><span class="n">currency_space</span><span class="o">.</span><span class="n">currencies</span><span class="si">}</span><span class="s2">.&quot;&quot;&quot;</span><span class="p">,</span>
<span class="p">)</span>

<span class="k">while</span> <span class="kc">True</span><span class="p">:</span>
Expand Down
4 changes: 2 additions & 2 deletions docs/recipes.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<link rel="canonical" href="https://grammacc.github.io/linearmoney/recipes.html">


<link rel="prev" href="quickstart_tutorial.html">
<link rel="prev" href="quickstart.html">


<link rel="next" href="glossary.html">
Expand Down Expand Up @@ -254,7 +254,7 @@


<li class="md-nav__item">
<a href="quickstart_tutorial.html" class="md-nav__link">
<a href="quickstart.html" class="md-nav__link">


<span class="md-ellipsis">
Expand Down
2 changes: 1 addition & 1 deletion docs/search/search_index.json

Large diffs are not rendered by default.

14 changes: 7 additions & 7 deletions docs/sitemap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2,32 +2,32 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://grammacc.github.io/linearmoney/index.html</loc>
<lastmod>2024-01-02</lastmod>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://grammacc.github.io/linearmoney/FAQ.html</loc>
<lastmod>2024-01-02</lastmod>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://grammacc.github.io/linearmoney/glossary.html</loc>
<lastmod>2024-01-02</lastmod>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://grammacc.github.io/linearmoney/linear_money_model.html</loc>
<lastmod>2024-01-02</lastmod>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://grammacc.github.io/linearmoney/quickstart_tutorial.html</loc>
<lastmod>2024-01-02</lastmod>
<loc>https://grammacc.github.io/linearmoney/quickstart.html</loc>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
<url>
<loc>https://grammacc.github.io/linearmoney/recipes.html</loc>
<lastmod>2024-01-02</lastmod>
<lastmod>2024-01-03</lastmod>
<changefreq>daily</changefreq>
</url>
</urlset>
Binary file modified docs/sitemap.xml.gz
Binary file not shown.
Loading