Update from flow-php/flow@7f3c29f

Author: flow-php

changelog/index.html

@@ -345,7 +345,7 @@ <h2 class="text-xl mt-5">Description</h2>
     $connection,
     'orders',
     new OrderBy('created_at', Order::DESC),
-)
+);
 // read from a query using limit/offset pagination        
 from_dbal_limit_offset_qb(
     $connection,
@@ -366,7 +366,7 @@ <h2 class="text-xl mt-5">Description</h2>
     )
 );
 </code></pre>
-<p>Additionally, each of them allows setting dataset schema through  <code>$extractor-&gt;withSchema(Schema $schema)</code> method.</p>
+<p>Additionally, each of them allows setting a dataset schema through  <code>$extractor-&gt;withSchema(Schema $schema)</code> method.</p>
 
                     </article>
 

data_reading/database/index.html

@@ -396,7 +396,7 @@ <h1><a id="flow-php-data-frame" href="#content-data-frame" class="mr-2" aria-hid
 <p>Unlike loading an entire dataset at once, a Data Frame processes information in smaller, manageable chunks.<br />
 As it moves through the data, it only keeps a limited number of rows in memory at any given time.<br />
 This approach helps avoid running out of memory, making it efficient and scalable for handling large datasets.</p>
-<p>Simple example of reading from php array and writing to stdout.</p>
+<p>Simple example of reading from php a array and writing to stdout.</p>
 <pre class="language-php"><code class="language-php" data-controller="syntax-highlight">&lt;?php
 
 data_frame()

documentation/components/core/core/index.html

@@ -388,7 +388,7 @@ <h2 class="text-xl mt-5 mb-5" id="description">Description</h2>
     $connection,
     'orders',
     new OrderBy('created_at', Order::DESC),
-)
+);
 // read from a query using limit/offset pagination        
 from_dbal_limit_offset_qb(
     $connection,
@@ -409,7 +409,7 @@ <h2 class="text-xl mt-5 mb-5" id="description">Description</h2>
     )
 );
 </code></pre>
-<p>Additionally, each of them allows setting dataset schema through  <code>$extractor-&gt;withSchema(Schema $schema)</code> method.</p>
+<p>Additionally, each of them allows setting a dataset schema through  <code>$extractor-&gt;withSchema(Schema $schema)</code> method.</p>
 
                     </article>
 

documentation/example/data_reading/database/index.html

@@ -422,15 +422,15 @@ <h2><a id="flow-php-data-frame" href="#content-data-frame" class="mr-2" aria-hid
 <p>[!TIP]
 To maximize developer experience, Flow exposes a DSL (Domain Specific Language).
 Flow DSL is a set of functions that can be used to build a data processing pipeline.
-Entire project is written in Object-Oriented style, but DSL is a more convenient way to build a pipeline.
+The entire project is written in Object-Oriented style, but DSL is a more convenient way to build a pipeline.
 Whenever possible, use DSL functions instead of creating objects directly.</p>
 </blockquote>
 <p>It creates a new instance of the <code>Flow\ETL\Flow</code> class, which is the main class of the ETL.</p>
 <p><a href="/data_frame/#example">Data Frame Examples</a></p>
 <h2><a id="flow-php-extraction---reading" href="#content-extraction---reading" class="mr-2" aria-hidden="true" title="Permalink">#</a>Extraction - Reading</h2>
 <p>The first step in creating a data processing pipeline is to read the data from a data source.
 Extractors are responsible for reading data from a data source and converting it into a format that can be processed by Flow ETL.
-All extractors return \Generator and by design will throw rows one by one, this is to ensure that memory consumption is constant and low.</p>
+All extractors return \Generator and by design will return rows one by one - this is to ensure that memory consumption is constant and low.</p>
 <pre class="language-php"><code class="language-php" data-controller="syntax-highlight">data_frame()
     -&gt;read(from_csv(__DIR__ . '/orders_flow.csv'))
 </code></pre>
@@ -456,7 +456,7 @@ <h2><a id="flow-php-transformation" href="#content-transformation" class="mr-2"
 <li><code>...-&gt;cast('date')</code> - casts column to a date type.</li>
 <li><code>...-&gt;dateFormat('Y/m')</code> - format date using the <code>Y/m</code> format, as a result created_at becomes a string <code>2023/01</code>.</li>
 </ul>
-<p>You can find all available functions in the <a href="../src/core/etl/src/Flow/ETL/DSL/functions.php">DSL</a>.</p>
+<p>You can find all available functions in the <a target="_blank" href="https://github.com/flow-php/flow/blob/1.x/src/core/etl/src/Flow/ETL/DSL/functions.php">DSL</a>.</p>
 <blockquote>
 <p>[!TIP]
 DSL is nothing more than a set of functions that return instances of Flow PHP objects.
@@ -479,22 +479,22 @@ <h2><a id="flow-php-loading---writing" href="#content-loading---writing" class="
 <p>Second write is writing the data to a CSV file, we're using the <code>mode()</code> function to set the save mode to <code>overwrite</code>.
 There are three save modes available:</p>
 <ul>
-<li><code>SaveMode::Append</code> - If data sink already exists, data will be appended. This solution might cause data duplication since it's not check if given rows already existed.</li>
-<li><code>SaveMode::ExceptionIfExists</code> - If data sink already exists error will be thrown.</li>
+<li><code>SaveMode::Append</code> - If data sink already exists, data will be appended. This solution might cause data duplication since it does not check if the given rows already exist.</li>
+<li><code>SaveMode::ExceptionIfExists</code> - If data sink already exists an error will be thrown.</li>
 <li><code>SaveMode::Ignore</code> - If data sink already exists, writing will be skipped.</li>
 <li><code>SaveMode::Overwrite</code> - If data sink already exists, it will be removed and written again.</li>
 </ul>
 <blockquote>
 <p>[!NOTE]
 Append mode is not really appending anything to existing files, instead it creates a folder in which it stores outputs under randomized file names.
-It can be later read using glob-pattern, for example <code>from_csv('/path/to/folder/*.csv')</code>.</p>
+It can be later read using a glob-pattern, for example <code>from_csv('/path/to/folder/*.csv')</code>.</p>
 </blockquote>
 <p><a href="/data_writing/#example">Loaders Examples</a></p>
 <h2><a id="flow-php-lazy-execution" href="#content-lazy-execution" class="mr-2" aria-hidden="true" title="Permalink">#</a>Lazy Execution</h2>
 <p>Flow ETL is using lazy execution, which means that the pipeline will not be executed until you call the <code>run()</code> function.</p>
 <pre class="language-php"><code class="language-php" data-controller="syntax-highlight">    -&gt;run();
 </code></pre>
-<p>There are few more triggering functions, like <code>fetch()</code>, you can find which functions are <code>@lazy</code> or <code>@trigger</code> looking at
+<p>There are few more triggering functions, like <code>fetch()</code>. You can find which functions are <code>@lazy</code> or <code>@trigger</code> by looking at
 the <a target="_blank" href="https://github.com/flow-php/flow/blob/1.x/src/core/etl/src/Flow/ETL/DataFrame.php">DataFrame</a> source code.</p>
 
 

documentation/quick-start/index.html

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog/2025-01-25/data-processing-in-php</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-08-08/scalar-functions</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-04-04/building-custom-extractor-google-analytics</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url></urlset>
+<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog/2025-01-25/data-processing-in-php</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-08-08/scalar-functions</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/blog/2024-04-04/building-custom-extractor-google-analytics</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>weekly</changefreq><priority>1.0</priority></url></urlset>

sitemap.blog.xml

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/documentation</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/changelog</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url></urlset>
+<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" ><url><loc>https://flow-php.com/blog</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/documentation</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/changelog</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url><url><loc>https://flow-php.com/</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod><changefreq>daily</changefreq><priority>1.0</priority></url></urlset>

sitemap.default.xml

@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><sitemapindex xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/siteindex.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://flow-php.com/sitemap.default.xml</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.examples.xml</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.blog.xml</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.documentation.xml</loc><lastmod>2025-03-10T11:06:25+00:00</lastmod></sitemap></sitemapindex>
+<?xml version="1.0" encoding="UTF-8"?><sitemapindex xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9 http://www.sitemaps.org/schemas/sitemap/0.9/siteindex.xsd" xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><sitemap><loc>https://flow-php.com/sitemap.default.xml</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.examples.xml</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.blog.xml</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod></sitemap><sitemap><loc>https://flow-php.com/sitemap.documentation.xml</loc><lastmod>2025-03-14T09:43:14+00:00</lastmod></sitemap></sitemapindex>