@ -1143,23 +1143,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="2272428768-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="2272428768-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="9072916598-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9072916598-1">)</span><spanclass="w">
@ -727,12 +727,12 @@ this user owns + StatsAPI if the user has a configured Stats API key.</p><p>Give
<p>Queries the ClickHouse database for the monthly pageview usage. If the given user's
subscription is <codeclass="inline">active</code>, <codeclass="inline">past_due</code>, or a <codeclass="inline">deleted</code> (but not yet expired), a map
with the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="5942759396-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="5942759396-1">}</span></code></pre><p>In all other cases of the subscription status (or a <codeclass="inline">free_10k</code> subscription which
does not have a <codeclass="inline">last_bill_date</code> defined) - the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="6166634772-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="6166634772-2">(</span><spanclass="p"data-group-id="6166634772-2">)</span><spanclass="p"data-group-id="6166634772-1">}</span></code></pre><p>Given only a user as input, the usage is queried from across all the sites that the
with the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="7816792965-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="7816792965-1">}</span></code></pre><p>In all other cases of the subscription status (or a <codeclass="inline">free_10k</code> subscription which
does not have a <codeclass="inline">last_bill_date</code> defined) - the following structure is returned:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="7289572391-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="7289572391-2">(</span><spanclass="p"data-group-id="7289572391-2">)</span><spanclass="p"data-group-id="7289572391-1">}</span></code></pre><p>Given only a user as input, the usage is queried from across all the sites that the
user owns. Alternatively, given an optional argument of <codeclass="inline">site_ids</code>, the usage from
the set of natural languages that are preferred as a response to the request.
Language tags function are provided in <ahref="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.LanguageTag.html"><codeclass="inline">Cldr.LanguageTag</code></a>.</p><p>The format of an <codeclass="inline">Accept-Language</code> header is as follows in <codeclass="inline">ABNF</code> format:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="nc">Accept</span><spanclass="o">-</span><spanclass="nc">Language</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="s">"Accept-Language"</span><spanclass="w"></span><spanclass="s">":"</span><spanclass="w">
</span><spanclass="n">language</span><spanclass="o">-</span><spanclass="n">range</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="p"data-group-id="3236520543-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="3236520543-2">(</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="o">*</span><spanclass="p"data-group-id="3236520543-3">(</span><spanclass="w"></span><spanclass="s">"-"</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="p"data-group-id="3236520543-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="3236520543-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="3236520543-1">)</span></code></pre><p>Each language-range MAY be given an associated quality value which represents an
</span><spanclass="n">language</span><spanclass="o">-</span><spanclass="n">range</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="p"data-group-id="3426532795-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="3426532795-2">(</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="o">*</span><spanclass="p"data-group-id="3426532795-3">(</span><spanclass="w"></span><spanclass="s">"-"</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="o">*</span><spanclass="mi">8</span><spanclass="nc">ALPHA</span><spanclass="w"></span><spanclass="p"data-group-id="3426532795-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="3426532795-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="3426532795-1">)</span></code></pre><p>Each language-range MAY be given an associated quality value which represents an
estimate of the user's preference for the languages specified by that range. The
quality value defaults to "q=1". For example,</p><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="nc">Accept</span><spanclass="o">-</span><spanclass="ss">Language</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">da</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">en</span><spanclass="o">-</span><spanclass="n">gb</span><spanclass="p">;</span><spanclass="n">q</span><spanclass="o">=</span><spanclass="mf">0.8</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">en</span><spanclass="p">;</span><spanclass="n">q</span><spanclass="o">=</span><spanclass="mf">0.7</span></code></pre><p>would mean: "I prefer Danish, but will accept British English and other types of English."</p>
</section>
@ -261,54 +261,54 @@ a configured <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html"><code class="
</span><spanclass="s">"No configured locale could be matched to </span><spanclass="se">\"</span><spanclass="s">xx,yy;q=0.3</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="0262659499-21">}</span><spanclass="p"data-group-id="0262659499-20">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="0262659499-24">}</span><spanclass="p"data-group-id="0262659499-23">}</span></code></pre>
</span><spanclass="s">"No configured locale could be matched to </span><spanclass="se">\"</span><spanclass="s">xx,yy;q=0.3</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="5431019597-21">}</span><spanclass="p"data-group-id="5431019597-20">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="5431019597-24">}</span><spanclass="p"data-group-id="5431019597-23">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="parse/1">
@ -369,95 +369,95 @@ wuth an error tuple for each invalid tag added at the end of the list.</p><h2 id
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="6080804675-22">}</span><spanclass="p"data-group-id="6080804675-21">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="2439077663-22">}</span><spanclass="p"data-group-id="2439077663-21">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="6080804675-43">}</span><spanclass="p"data-group-id="6080804675-42">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="2439077663-43">}</span><spanclass="p"data-group-id="2439077663-42">}</span><spanclass="w">
</span><spanclass="gt">** (Cldr.AcceptLanguageError) "Expected a BCP47 language tag. Could not parse the remaining "g" starting at position 11
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="1959490644-38">}</span><spanclass="p"data-group-id="1959490644-37">}</span><spanclass="w">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">g</span><spanclass="se">\"</span><spanclass="s"> starting at position 11"</span><spanclass="p"data-group-id="4949522372-38">}</span><spanclass="p"data-group-id="4949522372-37">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6386153341-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6386153341-5">{</span><spanclass="nc">Cldr.UnknownCurrencyError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">GGG</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="6386153341-5">}</span><spanclass="p"data-group-id="6386153341-4">}</span></code></pre>
</span><spanclass="p"data-group-id="2906384892-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2906384892-5">{</span><spanclass="nc">Cldr.UnknownCurrencyError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">GGG</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="2906384892-5">}</span><spanclass="p"data-group-id="2906384892-4">}</span></code></pre>
</span><spanclass="p"data-group-id="9623870857-6">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Required options are missing. Required options are [:name, :digits]"</span><spanclass="p"data-group-id="9623870857-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9623870857-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="9623870857-9">{</span><spanclass="nc">Cldr.CurrencyAlreadyDefined</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Currency :XAE is already defined."</span><spanclass="p"data-group-id="9623870857-9">}</span><spanclass="p"data-group-id="9623870857-8">}</span></code></pre>
</span><spanclass="p"data-group-id="6047780994-6">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Required options are missing. Required options are [:name, :digits]"</span><spanclass="p"data-group-id="6047780994-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6047780994-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6047780994-9">{</span><spanclass="nc">Cldr.CurrencyAlreadyDefined</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"Currency :XAE is already defined."</span><spanclass="p"data-group-id="6047780994-9">}</span><spanclass="p"data-group-id="6047780994-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="pluralize/3">
@ -1355,20 +1355,20 @@ default is <a href="Plausible.Cldr.html#get_locale/0"><code class="inline">Plaus
</span><spanclass="p"data-group-id="9316866791-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="9316866791-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="2448714045-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="2448714045-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9316866791-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="9316866791-10">}</span></code></pre>
</span><spanclass="p"data-group-id="2448714045-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="2448714045-10">}</span></code></pre>
</span><spanclass="p"data-group-id="8463117807-4">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">tv</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8463117807-4">}</span><spanclass="p"data-group-id="8463117807-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="1234742146-4">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">tv</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="1234742146-4">}</span><spanclass="p"data-group-id="1234742146-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8463117807-7">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8463117807-7">}</span><spanclass="p"data-group-id="8463117807-6">}</span></code></pre>
</span><spanclass="p"data-group-id="1234742146-7">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="1234742146-7">}</span><spanclass="p"data-group-id="1234742146-6">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="new/1">
@ -683,12 +683,12 @@ be a territory.</p><h2 id="territory_from_host/1-arguments" class="section-headi
</span><spanclass="p"data-group-id="5587221798-5">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="5587221798-5">}</span><spanclass="p"data-group-id="5587221798-4">}</span></code></pre>
</span><spanclass="p"data-group-id="9181451863-5">{</span><spanclass="nc">Cldr.UnknownLocaleError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"No locale was identified for territory </span><spanclass="se">\"</span><spanclass="s">com</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="9181451863-5">}</span><spanclass="p"data-group-id="9181451863-4">}</span></code></pre>
</span><spanclass="s">"The number system :finance is unknown for the locale named :en. Valid number systems are %{default: :latn, native: :latn}"</span><spanclass="p"data-group-id="4471631348-10">}</span><spanclass="w">
</span><spanclass="s">"The number system :finance is unknown for the locale named :en. Valid number systems are %{default: :latn, native: :latn}"</span><spanclass="p"data-group-id="0515950933-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8060361736-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="8060361736-4">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="8060361736-4">}</span><spanclass="p"data-group-id="8060361736-3">}</span></code></pre>
</span><spanclass="p"data-group-id="2912754906-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2912754906-4">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="2912754906-4">}</span><spanclass="p"data-group-id="2912754906-3">}</span></code></pre>
</span><spanclass="p"data-group-id="2356463476-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2356463476-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="2356463476-6">}</span><spanclass="p"data-group-id="2356463476-5">}</span></code></pre>
</span><spanclass="p"data-group-id="4633653786-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="4633653786-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="4633653786-6">}</span><spanclass="p"data-group-id="4633653786-5">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="number_systems_for!/1">
@ -613,20 +613,20 @@ actual system name.</p><h2 id="system_name_from/2-examples" class="section-headi
</span><spanclass="p"data-group-id="5217740216-9">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :nope is unknown"</span><spanclass="p"data-group-id="5217740216-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="5217740216-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
</span><spanclass="p"data-group-id="9561311089-9">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :nope is unknown"</span><spanclass="p"data-group-id="9561311089-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9561311089-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
number system for the given locale as demonstrated in the third example.</p>
</section>
</section>
@ -673,16 +673,16 @@ is recommended.</p></li></ul><h2 id="to_system/2-examples" class="section-headin
@ -162,12 +162,12 @@ digits between number systems. For example from :arabic to :latn. Since genera
transliteration map is slow, pairs of transliterations can be configured so that the
transliteration map is created at compile time and therefore speeding up transliteration at
run time.</p><p>To configure these transliteration pairs, add the to the <codeclass="inline">use Cldr</code> configuration
in a backend module:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="kd">defmodule</span><spanclass="w"></span><spanclass="nc">MyApp.Cldr</span><spanclass="w"></span><spanclass="k"data-group-id="5635494748-1">do</span><spanclass="w">
in a backend module:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="kd">defmodule</span><spanclass="w"></span><spanclass="nc">MyApp.Cldr</span><spanclass="w"></span><spanclass="k"data-group-id="0365019214-1">do</span><spanclass="w">
</span><spanclass="k"data-group-id="5635494748-1">end</span></code></pre><p>Where each tuple in the list configures one transliteration map. In this example, two maps are
</span><spanclass="k"data-group-id="0365019214-1">end</span></code></pre><p>Where each tuple in the list configures one transliteration map. In this example, two maps are
configured: from <codeclass="inline">:latn</code> to <codeclass="inline">:thai</code> and from <codeclass="inline">:arab</code> to <codeclass="inline">:thai</code>.</p><p>A list of configurable number systems is returned by <ahref="https://hexdocs.pm/ex_cldr_numbers/2.32.3/Cldr.Number.System.html#numeric_systems/0"><codeclass="inline">Cldr.Number.System.numeric_systems/0</code></a>.</p><p>If a transliteration is requested between two number pairs that have not been configured for
precompilation, a warning is logged.</p>
</section>
@ -281,22 +281,22 @@ and <a href="Plausible.Cldr.Number.System.html#number_systems_for/1"><code class
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number.Transliterate</span><spanclass="o">.</span><spanclass="n">transliterate</span><spanclass="p"data-group-id="3639238021-6">(</span><spanclass="s">"Some number is: 123556"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"th"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"thai"</span><spanclass="p"data-group-id="3639238021-6">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number.Transliterate</span><spanclass="o">.</span><spanclass="n">transliterate</span><spanclass="p"data-group-id="2032049656-6">(</span><spanclass="s">"Some number is: 123556"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"th"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"thai"</span><spanclass="p"data-group-id="2032049656-6">)</span><spanclass="w">
</span><spanclass="s">"Some number is: ๑๒๓๕๕๖"</span></code></pre>
</span><spanclass="s">"The string </span><spanclass="se">\"</span><spanclass="s">+1.000,34</span><spanclass="se">\"</span><spanclass="s"> could not be parsed as a number"</span><spanclass="p"data-group-id="5984811756-9">}</span><spanclass="p"data-group-id="5984811756-8">}</span></code></pre>
</span><spanclass="s">"The string </span><spanclass="se">\"</span><spanclass="s">+1.000,34</span><spanclass="se">\"</span><spanclass="s"> could not be parsed as a number"</span><spanclass="p"data-group-id="4314392101-9">}</span><spanclass="p"data-group-id="4314392101-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_currencies/2">
@ -525,17 +525,17 @@ financial instruments.</p></li></ul><h2 id="resolve_currencies/2-examples" class
</a>
<spanclass="text">Examples</span>
</h2>
<pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="4161032479-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="4161032479-1">)</span><spanclass="w">
<pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="6096016951-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="6096016951-1">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="4161032479-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="4161032479-6">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="6096016951-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="6096016951-6">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="0331905223-5">(</span><spanclass="s">"dollars des États-Unis"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="0331905223-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="9029612232-5">(</span><spanclass="s">"dollars des États-Unis"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="9029612232-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="0331905223-7">(</span><spanclass="s">"not a known currency"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="0331905223-7">)</span><spanclass="w">
</span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">not a known currency</span><spanclass="se">\"</span><spanclass="s"> is unknown or not supported"</span><spanclass="p"data-group-id="0331905223-9">}</span><spanclass="p"data-group-id="0331905223-8">}</span></code></pre>
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_currency</span><spanclass="p"data-group-id="9029612232-7">(</span><spanclass="s">"not a known currency"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"fr"</span><spanclass="p"data-group-id="9029612232-7">)</span><spanclass="w">
</span><spanclass="s">"The currency </span><spanclass="se">\"</span><spanclass="s">not a known currency</span><spanclass="se">\"</span><spanclass="s"> is unknown or not supported"</span><spanclass="p"data-group-id="9029612232-9">}</span><spanclass="p"data-group-id="9029612232-8">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_per/2">
@ -688,13 +688,13 @@ The default is <code class="inline">options[:backend].get_locale()</code></li></
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_per</span><spanclass="w"></span><spanclass="s">"% of linguists"</span><spanclass="w">
</span><spanclass="p"data-group-id="7972324399-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="7972324399-2">]</span><spanclass="w">
</span><spanclass="p"data-group-id="2034499568-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="2034499568-2">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">resolve_per</span><spanclass="w"></span><spanclass="s">"% of linguists %"</span><spanclass="w">
</span><spanclass="p"data-group-id="7972324399-3">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:percent</span><spanclass="p"data-group-id="7972324399-3">]</span></code></pre>
</span><spanclass="p"data-group-id="2034499568-3">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:percent</span><spanclass="p"data-group-id="2034499568-3">]</span></code></pre>
</section>
</section>
<sectionclass="detail"id="resolve_pers/2">
@ -751,9 +751,9 @@ The default is <code class="inline">options[:backend].get_locale()</code></li></
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="8586171456-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="8586171456-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="8586171456-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="8586171456-6">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="5816409804-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="5816409804-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="5816409804-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="5816409804-6">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="8586171456-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="8586171456-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="8586171456-8">[</span><spanclass="s">"The lottery number is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" for the next draw"</span><spanclass="p"data-group-id="8586171456-8">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="5816409804-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="5816409804-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="5816409804-8">[</span><spanclass="s">"The lottery number is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" for the next draw"</span><spanclass="p"data-group-id="5816409804-8">]</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="8586171456-9">(</span><spanclass="s">"The loss is -1.000 euros"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"de"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">number</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:integer</span><spanclass="p"data-group-id="8586171456-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="8586171456-10">[</span><spanclass="s">"The loss is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="o">-</span><spanclass="mi">1000</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" euros"</span><spanclass="p"data-group-id="8586171456-10">]</span></code></pre>
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">scan</span><spanclass="p"data-group-id="5816409804-9">(</span><spanclass="s">"The loss is -1.000 euros"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"de"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">number</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:integer</span><spanclass="p"data-group-id="5816409804-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="5816409804-10">[</span><spanclass="s">"The loss is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="o">-</span><spanclass="mi">1000</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" euros"</span><spanclass="p"data-group-id="5816409804-10">]</span></code></pre>
<p>Wrapping elements is particularly useful when formatting a number with a
currency symbol and the requirement is to have different HTML formatting
applied to the symbol than the number. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="7640874913-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="7640874913-2">fn</span><spanclass="w">
applied to the symbol than the number. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="4726231057-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="4726231057-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="7640874913-3">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="7640874913-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.3/Phoenix.HTML.Tag.html#content_tag/3"><codeclass="inline">Phoenix.HTML.Tag.content_tag/3</code></a>
</span><spanclass="p"data-group-id="4726231057-3">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="4726231057-3">}</span></code></pre><p>It is also possible and recommended to use the <ahref="https://hexdocs.pm/phoenix_html/3.3.3/Phoenix.HTML.Tag.html#content_tag/3"><codeclass="inline">Phoenix.HTML.Tag.content_tag/3</code></a>
function if wrapping HTML tags since these will ensure HTML entities are
correctly encoded. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="1221680302-1">(</span><spanclass="mi">100</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:currency</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">currency</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:USD</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">wrapper</span><spanclass="p">:</span><spanclass="w"></span><spanclass="k"data-group-id="1221680302-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="1221680302-6">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="1221680302-6">}</span></code></pre><p>When formatting a number the format is parsed into format elements that might include
</span><spanclass="p"data-group-id="1531662756-6">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"<span class=</span><spanclass="se">\"</span><spanclass="s">symbol</span><spanclass="se">\"</span><spanclass="s">>$</span><span class=</span><spanclass="se">\"</span><spanclass="s">number</span><spanclass="se">\"</span><spanclass="s">>100.00</span>"</span><spanclass="p"data-group-id="1531662756-6">}</span></code></pre><p>When formatting a number the format is parsed into format elements that might include
a currency symbol, a literal string, inserted text between a currency symbol and the
currency amount, a percent sign, the number itself and several other elements. In
some cases it is helpful to be apply specific formatting to each element.
@ -1168,80 +1168,80 @@ inserted in the final formatted number.</p><h2 id="to_string/2-returns" class="s
</span><spanclass="p"data-group-id="7953390649-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="7953390649-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6015153196-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="6015153196-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7953390649-15">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred thirty-four"</span><spanclass="p"data-group-id="7953390649-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6015153196-15">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred thirty-four"</span><spanclass="p"data-group-id="6015153196-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="7953390649-16">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred and thirty-four"</span><spanclass="p"data-group-id="7953390649-16">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6015153196-16">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"one thousand two hundred and thirty-four"</span><spanclass="p"data-group-id="6015153196-16">}</span><spanclass="w">
<p>An error tuple <codeclass="inline">{:error, reason}</code> will be returned if an error is detected.
The two most likely causes of an error return are:</p><ul><li>A format cannot be compiled. In this case the error tuple will look like:</li></ul><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="3986340896-1">(</span><spanclass="mi">12345</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"0#"</span><spanclass="p"data-group-id="3986340896-1">)</span><spanclass="w">
</span><spanclass="s">"Decimal format compiler: syntax error before: </span><spanclass="se">\"</span><spanclass="s">#</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="3986340896-3">}</span><spanclass="p"data-group-id="3986340896-2">}</span></code></pre><ul><li>The format style requested is not defined for the <codeclass="inline">locale</code> and
The two most likely causes of an error return are:</p><ul><li>A format cannot be compiled. In this case the error tuple will look like:</li></ul><pre><codeclass="makeup elixir"translate="no"><spanclass="w"></span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="8526670446-1">(</span><spanclass="mi">12345</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"0#"</span><spanclass="p"data-group-id="8526670446-1">)</span><spanclass="w">
</span><spanclass="s">"Decimal format compiler: syntax error before: </span><spanclass="se">\"</span><spanclass="s">#</span><spanclass="se">\"</span><spanclass="s">"</span><spanclass="p"data-group-id="8526670446-3">}</span><spanclass="p"data-group-id="8526670446-2">}</span></code></pre><ul><li>The format style requested is not defined for the <codeclass="inline">locale</code> and
<codeclass="inline">number_system</code>. This happens typically when the number system is
<codeclass="inline">:algorithmic</code> rather than the more common <codeclass="inline">:numeric</code>. In this case the error
</span><spanclass="s">"The locale :he with number system :hebr does not define a format :percent"</span><spanclass="p"data-group-id="6655243497-3">}</span><spanclass="p"data-group-id="6655243497-2">}</span></code></pre>
</span><spanclass="s">"The locale :he with number system :hebr does not define a format :percent"</span><spanclass="p"data-group-id="0998407177-3">}</span><spanclass="p"data-group-id="0998407177-2">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="to_string!/2">
@ -1346,17 +1346,17 @@ returned by <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html#known_number_sy
</span><spanclass="p"data-group-id="0036004518-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :unknown is unknown"</span><spanclass="p"data-group-id="0036004518-4">}</span><spanclass="p"data-group-id="0036004518-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="3663833881-4">{</span><spanclass="nc">Cldr.UnknownNumberSystemError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system :unknown is unknown"</span><spanclass="p"data-group-id="3663833881-4">}</span><spanclass="p"data-group-id="3663833881-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0036004518-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="0036004518-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="0036004518-6">}</span><spanclass="p"data-group-id="0036004518-5">}</span></code></pre>
</span><spanclass="p"data-group-id="3663833881-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="3663833881-6">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="3663833881-6">}</span><spanclass="p"data-group-id="3663833881-5">}</span></code></pre>
<p>Functions to implement the number system rule-based-number-format rules of CLDR.</p><p>These rules are defined only on the "und" locale and represent specialised
number formatting.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.32.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="9744162380-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="9744162380-1">)</span><spanclass="w">
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="3973717978-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="3973717978-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="9744162380-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">roman_upper</span><spanclass="p"data-group-id="9402800922-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="9402800922-1">)</span><spanclass="w">
</span><spanclass="s">"CXXIII"</span></code></pre><p>This particular call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="7218620119-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:roman</span><spanclass="p"data-group-id="7218620119-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="3973717978-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.NumberSystem</span><spanclass="o">.</span><spanclass="n">roman_upper</span><spanclass="p"data-group-id="0243836399-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="0243836399-1">)</span><spanclass="w">
</span><spanclass="s">"CXXIII"</span></code></pre><p>This particular call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="0456478256-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:roman</span><spanclass="p"data-group-id="0456478256-1">)</span><spanclass="w">
<p>Functions to implement the ordinal rule-based-number-format rules of CLDR.</p><p>As CLDR notes, the data is incomplete or non-existent for many languages. It
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.32.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="0993754612-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="0993754612-1">)</span><spanclass="w">
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="1522187351-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="1522187351-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0993754612-5">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">digits_ordinal</span><spanclass="p"data-group-id="9230622559-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="9230622559-1">)</span><spanclass="w">
</span><spanclass="s">"123rd"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="0696626370-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ordinal</span><spanclass="p"data-group-id="0696626370-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="1522187351-5">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Ordinal</span><spanclass="o">.</span><spanclass="n">digits_ordinal</span><spanclass="p"data-group-id="8526862664-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="8526862664-1">)</span><spanclass="w">
</span><spanclass="s">"123rd"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="4586709874-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ordinal</span><spanclass="p"data-group-id="4586709874-1">)</span><spanclass="w">
<p>Functions to implement the spellout rule-based-number-format rules of CLDR.</p><p>As CLDR notes, the data is incomplete or non-existent for many languages. It
is considered complete for English however.</p><p>The standard public API for RBNF is via the <ahref="https://hexdocs.pm/ex_cldr_numbers/2.32.3/Cldr.Number.html#to_string/2"><codeclass="inline">Cldr.Number.to_string/2</code></a> function.</p><p>The functions on this module are defined at compile time based upon the RBNF rules
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="6701128237-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="6701128237-1">)</span><spanclass="w">
defined in the Unicode CLDR data repository. Available rules are identified by:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">rule_sets</span><spanclass="p"data-group-id="5857921170-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="5857921170-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="6701128237-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">spellout_ordinal</span><spanclass="p"data-group-id="0784209575-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="0784209575-1">)</span><spanclass="w">
</span><spanclass="s">"one hundred twenty-third"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="9836686644-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:spellout</span><spanclass="p"data-group-id="9836686644-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="5857921170-3">]</span></code></pre><p>A rule can then be invoked on an available rule_set. For example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Rbnf.Spellout</span><spanclass="o">.</span><spanclass="n">spellout_ordinal</span><spanclass="p"data-group-id="8097778367-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="8097778367-1">)</span><spanclass="w">
</span><spanclass="s">"one hundred twenty-third"</span></code></pre><p>This call is equivalent to the call through the public API of:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr.Number</span><spanclass="o">.</span><spanclass="n">to_string</span><spanclass="p"data-group-id="7633860021-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:spellout</span><spanclass="p"data-group-id="7633860021-1">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="2889458160-2">(</span><spanclass="p"data-group-id="2889458160-3">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="2889458160-3">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p"data-group-id="2889458160-2">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="5410901535-2">(</span><spanclass="p"data-group-id="5410901535-3">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="5410901535-3">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p"data-group-id="5410901535-2">)</span><spanclass="w">
</span><spanclass="s">"And furthermore…there is much to be done"</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="2889458160-5">(</span><spanclass="p"data-group-id="2889458160-6">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="2889458160-6">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:word</span><spanclass="p"data-group-id="2889458160-5">)</span><spanclass="w">
</span><spanclass="gp unselectable">iex></span><spanclass="nc">Plausible.Cldr</span><spanclass="o">.</span><spanclass="n">ellipsis</span><spanclass="p"data-group-id="5410901535-5">(</span><spanclass="p"data-group-id="5410901535-6">[</span><spanclass="s">"And furthermore"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"there is much to be done"</span><spanclass="p"data-group-id="5410901535-6">]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">locale</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:ja</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">format</span><spanclass="p">:</span><spanclass="w"></span><spanclass="ss">:word</span><spanclass="p"data-group-id="5410901535-5">)</span><spanclass="w">
</span><spanclass="s">"And furthermore … there is much to be done"</span></code></pre>
</section>
</section>
@ -715,23 +715,23 @@ take an optional locale parameter for which a locale is not supplied.</p><h2 id=
</span><spanclass="s">"Locale #Cldr.LanguageTag<de [validated]> does not map to a known gettext locale name"</span><spanclass="p"data-group-id="4986153251-5">}</span><spanclass="p"data-group-id="4986153251-4">}</span></code></pre>
</span><spanclass="s">"Locale #Cldr.LanguageTag<de [validated]> does not map to a known gettext locale name"</span><spanclass="p"data-group-id="1479620211-5">}</span><spanclass="p"data-group-id="1479620211-4">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="put_locale/1">
@ -1345,29 +1345,29 @@ of a language tag.</p><h2 id="put_locale/1-examples" class="section-heading">
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">!</span><spanclass="se">\"</span><spanclass="s"> starting at position 15"</span><spanclass="p"data-group-id="3080383195-12">}</span><spanclass="p"data-group-id="3080383195-11">}</span></code></pre>
</span><spanclass="s">"Expected a BCP47 language tag. Could not parse the remaining </span><spanclass="se">\"</span><spanclass="s">!</span><spanclass="se">\"</span><spanclass="s"> starting at position 15"</span><spanclass="p"data-group-id="7795946914-12">}</span><spanclass="p"data-group-id="7795946914-11">}</span></code></pre>
</section>
</section>
<sectionclass="detail"id="quote/2">
@ -1416,10 +1416,10 @@ The default is <a href="https://hexdocs.pm/ex_cldr/2.37.5/Cldr.html#get_locale/0
</span><spanclass="p"data-group-id="9013268474-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="9013268474-19">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zzz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="9013268474-19">}</span><spanclass="p"data-group-id="9013268474-18">}</span></code></pre>
</span><spanclass="p"data-group-id="1245483680-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="1245483680-19">{</span><spanclass="nc">Cldr.InvalidLanguageError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The language </span><spanclass="se">\"</span><spanclass="s">zzz</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="1245483680-19">}</span><spanclass="p"data-group-id="1245483680-18">}</span></code></pre>
</span><spanclass="p"data-group-id="0413574598-7">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type :latn is unknown"</span><spanclass="p"data-group-id="0413574598-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9834761452-7">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type :latn is unknown"</span><spanclass="p"data-group-id="9834761452-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0413574598-10">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type </span><spanclass="se">\"</span><spanclass="s">bork</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="0413574598-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9834761452-10">{</span><spanclass="nc">Cldr.UnknownNumberSystemTypeError</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"The number system type </span><spanclass="se">\"</span><spanclass="s">bork</span><spanclass="se">\"</span><spanclass="s"> is invalid"</span><spanclass="p"data-group-id="9834761452-10">}</span><spanclass="w">
@ -845,23 +845,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <codeclass="inline">insert_all/2</code> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="3962287156-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="3962287156-1">)</span><spanclass="w">
<p>Similar to <codeclass="inline">insert_all/2</code> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="2695557545-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="2695557545-1">)</span><spanclass="w">
@ -1152,23 +1152,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="1394761360-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1394761360-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="5298946690-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="5298946690-1">)</span><spanclass="w">
@ -294,11 +294,11 @@ tables into the format of <code class="inline">imported_*</code> tables for a w
<sectionclass="docstring">
<p>Renders filename for the Zip archive containing the exported CSV files.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">archive_filename</span><spanclass="p"data-group-id="7644682042-1">(</span><spanclass="s">"plausible.io"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ld">~D[2021-01-01]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ld">~D[2024-12-31]</span><spanclass="p"data-group-id="7644682042-1">)</span><spanclass="w">
<p>Renders filename for the Zip archive containing the exported CSV files.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">archive_filename</span><spanclass="p"data-group-id="6756696268-1">(</span><spanclass="s">"plausible.io"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ld">~D[2021-01-01]</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ld">~D[2024-12-31]</span><spanclass="p"data-group-id="6756696268-1">)</span><spanclass="w">
@ -617,14 +617,14 @@ tables into the format of <code class="inline">imported_*</code> tables for a w
</div>
<p>Creates a streamable Zip archive from the provided (named) Ecto queries.</p><p>Example usage:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="8466436249-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">pool</span><spanclass="p"data-group-id="8466436249-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Ch</span><spanclass="o">.</span><spanclass="n">start_link</span><spanclass="p"data-group-id="8466436249-2">(</span><spanclass="ss">pool_size</span><spanclass="p">:</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="p"data-group-id="8466436249-2">)</span><spanclass="w">
<p>Creates a streamable Zip archive from the provided (named) Ecto queries.</p><p>Example usage:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="1219188589-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">pool</span><spanclass="p"data-group-id="1219188589-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Ch</span><spanclass="o">.</span><spanclass="n">start_link</span><spanclass="p"data-group-id="1219188589-2">(</span><spanclass="ss">pool_size</span><spanclass="p">:</span><spanclass="w"></span><spanclass="mi">1</span><spanclass="p"data-group-id="1219188589-2">)</span><spanclass="w">
@ -260,8 +260,8 @@ and MaxMind license key.</p></div>
</a>
<spanclass="text">Examples</span>
</h2>
<p> In the case of a DB-IP database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="5307192795-1">(</span><spanclass="p"data-group-id="5307192795-1">)</span><spanclass="w">
</span><spanclass="s">"DBIP-City-Lite"</span></code></pre><p> In the case of a MaxMind database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="3119678138-1">(</span><spanclass="p"data-group-id="3119678138-1">)</span><spanclass="w">
<p> In the case of a DB-IP database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="0734778217-1">(</span><spanclass="p"data-group-id="0734778217-1">)</span><spanclass="w">
</span><spanclass="s">"DBIP-City-Lite"</span></code></pre><p> In the case of a MaxMind database:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">database_type</span><spanclass="p"data-group-id="7474148450-1">(</span><spanclass="p"data-group-id="7474148450-1">)</span><spanclass="w">
<p> Loading from a local file:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="8914067338-1">(</span><spanclass="ss">path</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"/etc/plausible/dbip-city.mmdb"</span><spanclass="p"data-group-id="8914067338-1">)</span><spanclass="w">
</span><spanclass="ss">:ok</span></code></pre><p> Downloading a MaxMind DB (this license key is no longer active):</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="3683496836-1">(</span><spanclass="ss">license_key</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"LNpsJCCKPis6XvBP"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">edition</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"GeoLite2-City"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">async</span><spanclass="p">:</span><spanclass="w"></span><spanclass="no">true</span><spanclass="p"data-group-id="3683496836-1">)</span><spanclass="w">
<p> Loading from a local file:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="3127937927-1">(</span><spanclass="ss">path</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"/etc/plausible/dbip-city.mmdb"</span><spanclass="p"data-group-id="3127937927-1">)</span><spanclass="w">
</span><spanclass="ss">:ok</span></code></pre><p> Downloading a MaxMind DB (this license key is no longer active):</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">load_db</span><spanclass="p"data-group-id="5333652496-1">(</span><spanclass="ss">license_key</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"LNpsJCCKPis6XvBP"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">edition</span><spanclass="p">:</span><spanclass="w"></span><spanclass="s">"GeoLite2-City"</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">async</span><spanclass="p">:</span><spanclass="w"></span><spanclass="no">true</span><spanclass="p"data-group-id="5333652496-1">)</span><spanclass="w">
</span><spanclass="s">"pt-BR"</span><spanclass="w"></span><spanclass="p">=></span><spanclass="w"></span><spanclass="s">"América do Norte"</span><spanclass="p">,</span><spanclass="w">
@ -1143,23 +1143,23 @@ pool to disconnect within the given interval.</p><p>See <a href="https://hexdocs
<sectionclass="docstring">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="3617013985-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="3617013985-1">)</span><spanclass="w">
<p>Similar to <ahref="#insert_all/2"><codeclass="inline">insert_all/2</code></a> but with the following differences:</p><ul><li>accepts rows as streams or lists</li><li>sends rows as a chunked request</li><li>doesn't autogenerate ids or does any other preprocessing</li></ul><p>Example:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="nc">Repo</span><spanclass="o">.</span><spanclass="n">query!</span><spanclass="p"data-group-id="2598723856-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="2598723856-1">)</span><spanclass="w">
<p>Extracts min/max date range from a list of uploads.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">date_range</span><spanclass="p"data-group-id="0543499796-1">(</span><spanclass="p"data-group-id="0543499796-2">[</span><spanclass="w">
<p>Extracts min/max date range from a list of uploads.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">date_range</span><spanclass="p"data-group-id="9042043183-1">(</span><spanclass="p"data-group-id="9042043183-2">[</span><spanclass="w">
<p>Extracts the table name from the provided filename.</p><p>Raises if the filename doesn't conform to the expected format.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">extract_table</span><spanclass="p"data-group-id="8477095409-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="8477095409-1">)</span><spanclass="w">
<p>Extracts table name and min/max dates from the filename.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">parse_filename!</span><spanclass="p"data-group-id="9083921331-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="9083921331-1">)</span><spanclass="w">
<p>Extracts table name and min/max dates from the filename.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">parse_filename!</span><spanclass="p"data-group-id="6934283425-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="6934283425-1">)</span><spanclass="w">
<p>Checks if the provided filename conforms to the expected format.</p><p>Examples:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="gp unselectable">iex></span><spanclass="n">valid_filename?</span><spanclass="p"data-group-id="0011170653-1">(</span><spanclass="s">"my_data.csv"</span><spanclass="p"data-group-id="0011170653-1">)</span><spanclass="w">