@ -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="7749392637-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="7749392637-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="4909429010-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="4909429010-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="5817025421-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="5817025421-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="2804627576-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="2804627576-2">(</span><spanclass="p"data-group-id="2804627576-2">)</span><spanclass="p"data-group-id="2804627576-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="2675580516-1">%{</span><spanclass="w">
</span><spanclass="p"data-group-id="2675580516-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="6451495579-1">%{</span><spanclass="ss">last_30_days</span><spanclass="p">:</span><spanclass="w"></span><spanclass="n">usage_cycle</span><spanclass="p"data-group-id="6451495579-2">(</span><spanclass="p"data-group-id="6451495579-2">)</span><spanclass="p"data-group-id="6451495579-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="0744119237-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="0744119237-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="0744119237-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="0744119237-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="0744119237-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="0744119237-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="7143583320-1">(</span><spanclass="w"></span><spanclass="p"data-group-id="7143583320-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="7143583320-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="7143583320-3">)</span><spanclass="w"></span><spanclass="p"data-group-id="7143583320-2">)</span><spanclass="w"></span><spanclass="o">|</span><spanclass="w"></span><spanclass="s">"*"</span><spanclass="w"></span><spanclass="p"data-group-id="7143583320-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="9197838498-21">}</span><spanclass="p"data-group-id="9197838498-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="9197838498-24">}</span><spanclass="p"data-group-id="9197838498-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="2782103913-21">}</span><spanclass="p"data-group-id="2782103913-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="2782103913-24">}</span><spanclass="p"data-group-id="2782103913-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="3913879254-22">}</span><spanclass="p"data-group-id="3913879254-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="0628487159-22">}</span><spanclass="p"data-group-id="0628487159-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="3913879254-43">}</span><spanclass="p"data-group-id="3913879254-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="0628487159-43">}</span><spanclass="p"data-group-id="0628487159-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="8713118902-38">}</span><spanclass="p"data-group-id="8713118902-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="5987578818-38">}</span><spanclass="p"data-group-id="5987578818-37">}</span><spanclass="w">
</span><spanclass="p"data-group-id="2002902062-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2002902062-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="2002902062-5">}</span><spanclass="p"data-group-id="2002902062-4">}</span></code></pre>
</span><spanclass="p"data-group-id="7272518523-4">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="7272518523-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="7272518523-5">}</span><spanclass="p"data-group-id="7272518523-4">}</span></code></pre>
</span><spanclass="p"data-group-id="8612062955-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="8612062955-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8612062955-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="8612062955-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="8612062955-9">}</span><spanclass="p"data-group-id="8612062955-8">}</span></code></pre>
</span><spanclass="p"data-group-id="3038041594-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="3038041594-6">}</span><spanclass="w">
</span><spanclass="p"data-group-id="3038041594-8">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="3038041594-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="3038041594-9">}</span><spanclass="p"data-group-id="3038041594-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="4535928951-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="4535928951-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="2312500670-8">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollars des États-Unis"</span><spanclass="p"data-group-id="2312500670-8">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4535928951-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="4535928951-10">}</span></code></pre>
</span><spanclass="p"data-group-id="2312500670-10">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"dollar des États-Unis"</span><spanclass="p"data-group-id="2312500670-10">}</span></code></pre>
</span><spanclass="p"data-group-id="0411838673-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="0411838673-4">}</span><spanclass="p"data-group-id="0411838673-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="4676447085-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="4676447085-4">}</span><spanclass="p"data-group-id="4676447085-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0411838673-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="0411838673-7">}</span><spanclass="p"data-group-id="0411838673-6">}</span></code></pre>
</span><spanclass="p"data-group-id="4676447085-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="4676447085-7">}</span><spanclass="p"data-group-id="4676447085-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="9154427730-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="9154427730-5">}</span><spanclass="p"data-group-id="9154427730-4">}</span></code></pre>
</span><spanclass="p"data-group-id="8022979116-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="8022979116-5">}</span><spanclass="p"data-group-id="8022979116-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="9391695042-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="9514518508-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="3150448042-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="3150448042-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="3150448042-4">}</span><spanclass="p"data-group-id="3150448042-3">}</span></code></pre>
</span><spanclass="p"data-group-id="9825350446-3">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="9825350446-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="9825350446-4">}</span><spanclass="p"data-group-id="9825350446-3">}</span></code></pre>
</span><spanclass="p"data-group-id="2577124007-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="2577124007-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="2577124007-6">}</span><spanclass="p"data-group-id="2577124007-5">}</span></code></pre>
</span><spanclass="p"data-group-id="6968574626-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6968574626-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="6968574626-6">}</span><spanclass="p"data-group-id="6968574626-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="9949551355-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="9949551355-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9949551355-8">}</span></code></pre><p>Note that return value is not guaranteed to be a valid
</span><spanclass="p"data-group-id="8246946153-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="8246946153-9">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8246946153-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="9291889790-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="5319700642-1">do</span><spanclass="w">
</span><spanclass="k"data-group-id="9291889790-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="5319700642-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="9184399987-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="9184399987-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="8311386736-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="8311386736-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="0041223798-9">}</span><spanclass="p"data-group-id="0041223798-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="7363044145-9">}</span><spanclass="p"data-group-id="7363044145-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="6406359400-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="6406359400-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="0680531521-1">(</span><spanclass="s">"100 US dollars"</span><spanclass="p"data-group-id="0680531521-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="6406359400-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="6406359400-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="0680531521-6">(</span><spanclass="s">"100 dollars des États-Unis"</span><spanclass="p"data-group-id="0680531521-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="6518155468-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="6518155468-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="6287629021-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="6287629021-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="6518155468-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="6518155468-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="6518155468-9">}</span><spanclass="p"data-group-id="6518155468-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="6287629021-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="6287629021-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="6287629021-9">}</span><spanclass="p"data-group-id="6287629021-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="8116856331-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="8116856331-2">]</span><spanclass="w">
</span><spanclass="p"data-group-id="3224465635-2">[</span><spanclass="ss">:percent</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">" of linguists"</span><spanclass="p"data-group-id="3224465635-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="8116856331-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="8116856331-3">]</span></code></pre>
</span><spanclass="p"data-group-id="3224465635-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="3224465635-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="0299719184-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="0299719184-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0299719184-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="0299719184-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="2377831008-5">(</span><spanclass="s">"The prize is 23"</span><spanclass="p"data-group-id="2377831008-5">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2377831008-6">[</span><spanclass="s">"The prize is "</span><spanclass="p">,</span><spanclass="w"></span><spanclass="mi">23</span><spanclass="p"data-group-id="2377831008-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="0299719184-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="0299719184-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0299719184-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="0299719184-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="2377831008-7">(</span><spanclass="s">"The lottery number is 23 for the next draw"</span><spanclass="p"data-group-id="2377831008-7">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2377831008-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="2377831008-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="0299719184-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="0299719184-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0299719184-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="0299719184-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="2377831008-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="2377831008-9">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2377831008-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="2377831008-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="9425570458-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="9425570458-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="9905384045-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="9905384045-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="9425570458-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="9425570458-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="9905384045-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="9905384045-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="9854038076-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="9854038076-2">fn</span><spanclass="w">
</span><spanclass="p"data-group-id="9854038076-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="9854038076-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="5620840973-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="5620840973-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="3593102462-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="3593102462-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9404320078-12">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"1,244 US dollars"</span><spanclass="p"data-group-id="9404320078-12">}</span><spanclass="w">
</span><spanclass="p"data-group-id="3593102462-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="3593102462-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9404320078-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="9404320078-15">}</span><spanclass="w">
</span><spanclass="p"data-group-id="3593102462-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="3593102462-16">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9404320078-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="9404320078-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="1733913262-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="1733913262-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="1733913262-3">}</span><spanclass="p"data-group-id="1733913262-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="2707338932-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="2707338932-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="2707338932-3">}</span><spanclass="p"data-group-id="2707338932-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="3262960426-3">}</span><spanclass="p"data-group-id="3262960426-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="0012979363-3">}</span><spanclass="p"data-group-id="0012979363-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="0909389261-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="0909389261-4">}</span><spanclass="p"data-group-id="0909389261-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="6585093760-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="6585093760-4">}</span><spanclass="p"data-group-id="6585093760-3">}</span><spanclass="w">
</span><spanclass="p"data-group-id="0909389261-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="0909389261-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="0909389261-6">}</span><spanclass="p"data-group-id="0909389261-5">}</span></code></pre>
</span><spanclass="p"data-group-id="6585093760-5">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="6585093760-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="6585093760-6">}</span><spanclass="p"data-group-id="6585093760-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="2710573367-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="2710573367-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="0170416351-1">(</span><spanclass="ss">:und</span><spanclass="p"data-group-id="0170416351-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2710573367-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="7714551601-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="7714551601-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="5596666192-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="5596666192-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0170416351-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="7995723432-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:und</span><spanclass="p"data-group-id="7995723432-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="8439116082-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="8439116082-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="6540792254-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="6540792254-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="2195200272-1">(</span><spanclass="ss">:en</span><spanclass="p"data-group-id="2195200272-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="6540792254-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="5123784489-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="5123784489-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="9912887766-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="9912887766-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="2195200272-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="6212992717-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="ss">:en</span><spanclass="p"data-group-id="6212992717-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="8274839399-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="8274839399-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="7347853420-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="7347853420-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="0069439084-1">(</span><spanclass="s">"en"</span><spanclass="p"data-group-id="0069439084-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="7347853420-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="3661708891-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="3661708891-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="0098033695-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="0098033695-1">)</span><spanclass="w">
</span><spanclass="p"data-group-id="0069439084-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="6240685079-1">(</span><spanclass="mi">123</span><spanclass="p">,</span><spanclass="w"></span><spanclass="s">"en"</span><spanclass="p"data-group-id="6240685079-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="6580704391-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="6580704391-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="2002153315-2">(</span><spanclass="p"data-group-id="2002153315-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="2002153315-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="2002153315-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="5778719832-2">(</span><spanclass="p"data-group-id="5778719832-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="5778719832-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="5778719832-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="2002153315-5">(</span><spanclass="p"data-group-id="2002153315-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="2002153315-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="2002153315-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="5778719832-5">(</span><spanclass="p"data-group-id="5778719832-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="5778719832-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="5778719832-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="1842091850-5">}</span><spanclass="p"data-group-id="1842091850-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="9070812986-5">}</span><spanclass="p"data-group-id="9070812986-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="3571573445-12">}</span><spanclass="p"data-group-id="3571573445-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="0519734719-12">}</span><spanclass="p"data-group-id="0519734719-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="7253422754-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="7253422754-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="7253422754-19">}</span><spanclass="p"data-group-id="7253422754-18">}</span></code></pre>
</span><spanclass="p"data-group-id="5135808806-18">{</span><spanclass="ss">:error</span><spanclass="p">,</span><spanclass="w"></span><spanclass="p"data-group-id="5135808806-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="5135808806-19">}</span><spanclass="p"data-group-id="5135808806-18">}</span></code></pre>
</span><spanclass="p"data-group-id="9431721563-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="9431721563-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8389144598-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="8389144598-7">}</span><spanclass="w">
</span><spanclass="p"data-group-id="9431721563-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="9431721563-10">}</span><spanclass="w">
</span><spanclass="p"data-group-id="8389144598-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="8389144598-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="0175643054-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="0175643054-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="6220670779-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="6220670779-1">)</span><spanclass="w">
<p>Populates event session columns with data from sessions table.</p><p>Run via: ./bin/plausible rpc "Plausible.DataMigration.PopulateEventSessionColumns.run"
Monitor via ./bin/plausible rpc "Plausible.DataMigration.PopulateEventSessionColumns.report_progress"</p><p>Suggested to run in a screen/tmux session to be able to easily monitor</p><p>SQL files available at: priv/data_migrations/PopulateEventSessionColumns/sql</p>
@ -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="1597292263-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="1597292263-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="8746060035-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="8746060035-1">)</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="2694445677-1">(</span><spanclass="p"data-group-id="2694445677-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="1105286553-1">(</span><spanclass="p"data-group-id="1105286553-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="8409299914-1">(</span><spanclass="p"data-group-id="8409299914-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="8575571468-1">(</span><spanclass="p"data-group-id="8575571468-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="9197448768-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="9197448768-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="0179201734-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="0179201734-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="6275123198-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="6275123198-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="5152186683-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="5152186683-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="9299620698-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9299620698-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="8014121384-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="8014121384-1">)</span><spanclass="w">
@ -178,30 +178,30 @@ scope of importer logic and is expected to be implemented separately.</p><h2 id=
</h2>
<p>In case it's necessary to run the whole import job fully synchronously, the
<ahref="Plausible.Workers.ImportAnalytics.html"><codeclass="inline">Plausible.Workers.ImportAnalytics</code></a> worker sends an <ahref="https://hexdocs.pm/oban/2.17.2/Oban.Notifier.html"><codeclass="inline">Oban.Notifier</code></a> message
on completion, failure or transient failure of the import.</p><p>A basic usage scenario looks like this:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="7146027641-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">job</span><spanclass="p"data-group-id="7146027641-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Plausible.Imported.NoopImporter</span><spanclass="o">.</span><spanclass="n">new_import</span><spanclass="p"data-group-id="7146027641-2">(</span><spanclass="w">
on completion, failure or transient failure of the import.</p><p>A basic usage scenario looks like this:</p><pre><codeclass="makeup elixir"translate="no"><spanclass="p"data-group-id="5277269190-1">{</span><spanclass="ss">:ok</span><spanclass="p">,</span><spanclass="w"></span><spanclass="n">job</span><spanclass="p"data-group-id="5277269190-1">}</span><spanclass="w"></span><spanclass="o">=</span><spanclass="w"></span><spanclass="nc">Plausible.Imported.NoopImporter</span><spanclass="o">.</span><spanclass="n">new_import</span><spanclass="p"data-group-id="5277269190-2">(</span><spanclass="w">
</span><spanclass="nc">IO</span><spanclass="o">.</span><spanclass="n">puts</span><spanclass="p"data-group-id="7146027641-15">(</span><spanclass="s">"Job didn't finish in 15 seconds"</span><spanclass="p"data-group-id="7146027641-15">)</span><spanclass="w">
</span><spanclass="k"data-group-id="7146027641-5">end</span></code></pre><p>In a more realistic scenario, job scheduling will be done inside a GenServer process
</span><spanclass="nc">IO</span><spanclass="o">.</span><spanclass="n">puts</span><spanclass="p"data-group-id="5277269190-15">(</span><spanclass="s">"Job didn't finish in 15 seconds"</span><spanclass="p"data-group-id="5277269190-15">)</span><spanclass="w">
</span><spanclass="k"data-group-id="5277269190-5">end</span></code></pre><p>In a more realistic scenario, job scheduling will be done inside a GenServer process
like LiveView, where notifications can be listened for via <codeclass="inline">handle_info/2</code>.</p>
@ -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="0742106660-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="0742106660-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="9251675934-1">(</span><spanclass="s">"create table ecto_ch_demo(a UInt64, b String) engine Null"</span><spanclass="p"data-group-id="9251675934-1">)</span><spanclass="w">