Cookbook: Read and write files (#398)

ndonkoHenri · FeodorFitsner · web-flow · commit c8b6be6cfb17 · 2025-03-01T17:01:28.000-08:00
* initial commit

* truncate blog posts

* add cookbook page to sidebar

* Update docs/cookbook/read-and-write-files.md

Co-authored-by: Feodor Fitsner &lt;feodor@appveyor.com&gt;

* Update docs/cookbook/read-and-write-files.md

Co-authored-by: Feodor Fitsner &lt;feodor@appveyor.com&gt;

* update var name

* delete counter.png

* add video url

---------

Co-authored-by: Feodor Fitsner &lt;feodor@appveyor.com&gt;
diff --git a/blog/2022-06-12-using-custom-fonts-in-flet-app.md b/blog/2022-06-12-using-custom-fonts-in-flet-app.md
@@ -15,6 +15,8 @@ The following font formats are supported:
 
 Use [`page.fonts`](/docs/controls/page#fonts) property to import fonts.
 
+<!-- truncate -->
+
 Set `page.fonts` property to a dictionary where key is the font family name to refer that font and the value is the URL of the font file to import:
 
 ```python
diff --git a/blog/2022-07-14-drag-and-drop-release.md b/blog/2022-07-14-drag-and-drop-release.md
@@ -17,6 +17,8 @@ Take a look at [Drag-and-Drop example](https://github.com/flet-dev/examples/blob
 
 Explore [`Draggable`](/docs/controls/draggable) and [`DragTarget`](/docs/controls/dragtarget) controls, their properties and events.
 
+<!-- truncate -->
+
 ## Absolute positioning inside Stack
 
 All visible controls now have `left` `top`, `right` and `bottom` properties to let them be absolutely positioned inside [`Stack`](/docs/controls/stack), for example:
diff --git a/blog/2022-07-23-navigation-and-routing.md b/blog/2022-07-23-navigation-and-routing.md
@@ -21,6 +21,8 @@ Well, it took [more efforts](https://github.com/flet-dev/flet/pull/95/files) tha
 
 Explore [source code](https://github.com/flet-dev/examples/blob/main/python/apps/routing-navigation/building-views-on-route-change.py) of the example above.
 
+<!-- truncate -->
+
 ## Page route
 
 Page route is a portion of application URL after `#` symbol:
diff --git a/blog/2022-07-24-flet-mobile-strategy.md b/blog/2022-07-24-flet-mobile-strategy.md
@@ -11,6 +11,8 @@ New Flet developers are constantly asking if there is a way to package Flet prog
 
 In this post I would like to share our vision for Flet going mobile and provide a roadmap.
 
+<!-- truncate -->
+
 ## Server-Driven UI
 
 Flet is a Server-driven UI (SDUI) framework. SDUI is an emerging technology which is the best described in [Technology Radar post](https://www.thoughtworks.com/en-ca/radar/techniques/server-driven-ui):
diff --git a/blog/2022-08-03-control-refs.md b/blog/2022-08-03-control-refs.md
@@ -50,6 +50,8 @@ When more and mode controls and event handlers added it becomes challenging to k
 
 Is `first_name` a TextField, does it have autofocus set? Is greetings a `Row` or a `Column`?
 
+<!-- truncate -->
+
 ## `Ref` class
 
 Flet provides `Ref` utility class which allows to define a reference to the control, use that reference in event handlers and set the reference to a real control later, while building a tree. The idea comes from [React](https://reactjs.org/docs/refs-and-the-dom.html).
diff --git a/blog/2022-08-04-gradients-button-textfield-styles.md b/blog/2022-08-04-gradients-button-textfield-styles.md
@@ -11,6 +11,8 @@ We've just released [Flet 0.1.46](https://pypi.org/project/flet/0.1.46/) adding
 * Extensive styling for buttons, TextField and Dropdown controls
 * ...and more
 
+<!-- truncate -->
+
 ## Gradient backgrounds
 
 ### Linear gradient
diff --git a/blog/2022-08-21-fun-with-animations.md b/blog/2022-08-21-fun-with-animations.md
@@ -11,6 +11,8 @@ Flutter offers [multiple approaches](https://docs.flutter.dev/development/ui/ani
 
 We are starting with "implicit" animations which allows you to animate a control property by setting a target value; whenever that target value changes, the control animates the property from the old value to the new one.
 
+<!-- truncate -->
+
 ## Demo time
 
 <div style={{fontSize: "1.1rem", textAlign: "center", padding: "1rem" }}>
diff --git a/blog/2022-09-02-file-picker-and-uploads.md b/blog/2022-09-02-file-picker-and-uploads.md
@@ -21,6 +21,8 @@ File picker allows opening three dialogs:
 * **Save file** - choose directory and file name.
 * **Get directory** - select directory.
 
+<!-- truncate -->
+
 When running Flet app in a browser only "Pick files" option is available and it's used for uploads only as it, obviously, doesn't return a full path to a selected file.
 
 Where file picker really shines is a desktop! All three dialogs return full paths to selected files and directories - great assistance to your users!
diff --git a/blog/2022-09-27-user-authentication.md b/blog/2022-09-27-user-authentication.md
@@ -17,6 +17,8 @@ Traditionally, this release is not just about authentication, but it adds a ton
 
 <TOCInline toc={toc} maxHeadingLevel={2} />
 
+<!-- truncate -->
+
 ## Authentication
 
 Flet authentication features:
diff --git a/blog/2022-10-11-gesture-detector.md b/blog/2022-10-11-gesture-detector.md
@@ -13,6 +13,8 @@ Here is a simple example of an app which allows you to drag containers inside a
 
 <img src="/img/blog/gesture-detector/gesture-detector-demo.gif" className="screenshot-50" />
 
+<!-- truncate -->
+
 ```python
 import flet as ft
 
diff --git a/blog/2022-10-24-matplotlib-and-plotly-charts.md b/blog/2022-10-24-matplotlib-and-plotly-charts.md
@@ -32,6 +32,8 @@ Check the docs for Matplotlib and Plotly charting controls:
 
 Explore [Flet chart examples](https://github.com/flet-dev/examples/tree/main/python/controls/charts).
 
+<!-- truncate -->
+
 Learn Python libraries by examples:
 
 * [Matplotlib gallery](https://matplotlib.org/stable/gallery/index.html)
diff --git a/blog/2022-11-13-responsive-row-and-mobile-controls.md b/blog/2022-11-13-responsive-row-and-mobile-controls.md
@@ -24,6 +24,8 @@ ft.ResponsiveRow([
 ])
 ```
 
+<!-- truncate -->
+
 `ResponsiveRow` is "responsive" because it can adapt the size of its children to a changing screen (page, window) size. `col` property in the example above is a constant number which means the child will span 6 columns for any screen size.
 
 If `ResponsiveRow`'s child doesn't have `col` property specified it spans the maximum number of columns.
diff --git a/blog/2022-11-16-flet-versioning-and-pre-releases.md b/blog/2022-11-16-flet-versioning-and-pre-releases.md
@@ -13,6 +13,8 @@ From now on we'll be breaking releases into multiple pull requests with one feat
 
 Every PR merged into `main` branch will be publishing pre-release (developmental release) package to [pypi.org](https://pypi.org/project/flet/) having version format of `X.Y.Z.devN`.
 
+<!-- truncate -->
+
 ## Installing pre-releases
 
 To install Flet pre-release package use the following command:
diff --git a/blog/2022-12-08-flet-mobile-update.md b/blog/2022-12-08-flet-mobile-update.md
@@ -11,6 +11,8 @@ Our original approach to Flet running on a mobile device was Server-Driven UI. T
 
 I've been thinking on how to make Python runtime embedded into Flutter iOS or Android app to run user Python program. No doubt, it's technically possible as Kivy and BeeWare projects do that already.
 
+<!-- truncate -->
+
 ## Current Flet architecture
 
 The current architecture of Flet desktop app is shown on the diagram below:
diff --git a/blog/2023-02-06-standalone-flet-web-apps-with-pyodide.md b/blog/2023-02-06-standalone-flet-web-apps-with-pyodide.md
@@ -13,6 +13,8 @@ We've just released [Flet 0.4.0](https://pypi.org/project/flet/) with a super ex
 
 You can quickly build awesome single-page applications (SPA) entirely in Python and host them everywhere! No HTML, CSS or JavaScript required!
 
+<!-- truncate -->
+
 ## Quick Flet with Pyodide demo
 
 Install the latest Flet package:
diff --git a/blog/2023-04-12-flet-charts.md b/blog/2023-04-12-flet-charts.md
@@ -9,6 +9,8 @@ Last year we introduced support for [Matplotlib and Plotly charts](/blog/matplot
 
 Today we are releasing [Flet 0.5.2](https://pypi.org/project/flet/) with built-in charts 📊 based on the awesome [fl_chart](https://pub.dev/packages/fl_chart) library!
 
+<!-- truncate -->
+
 Three new chart controls have been introduced:
 
 ## LineChart
diff --git a/blog/2023-04-26-canvas.md b/blog/2023-04-26-canvas.md
@@ -15,6 +15,8 @@ Combine Canvas with [GestureDetector](/docs/controls/gesturedetector) and you ge
 
 [Example source](https://github.com/flet-dev/examples/blob/main/python/controls/canvas/canvas-flet-brush.py)
 
+<!-- truncate -->
+
 `Canvas` control is located in `flet.canvas` package. You need another import to use it:
 
 ```python
diff --git a/blog/2023-05-12-theming-and-scrollables.md b/blog/2023-05-12-theming-and-scrollables.md
@@ -14,6 +14,8 @@ The release also introduces theming improvements:
 * [Scrollbar theming](#scrollbar-theme)
 * [Tabs theming](#tabs-theming)
 
+<!-- truncate -->
+
 ## Controlling scroll position
 
 Scrollable controls (`Page`, `View`, `Column`, `Row`, `ListView` and `GridView`) introduce `scroll_to()` method to change their scroll position to either absolute `offset`, relative `delta` or jump to the control with specified `key`.
diff --git a/blog/2023-07-05-flet-for-ios.md b/blog/2023-07-05-flet-for-ios.md
@@ -17,6 +17,8 @@ But it's more than just testing Flet apps on the phone! Flet mobile app itself i
 
 I would like to thank [Kivy project](https://kivy.org/) for making a [toolchain for iOS](https://github.com/kivy/kivy-ios) which we used to compile Python interpreter and dependencies for iOS devices. We published [serious_python](https://pub.dev/packages/serious_python) package for adding Python runtime to any Flutter app.
 
+<!-- truncate -->
+
 ## FAQ
 
 ### When Android is supported?
diff --git a/blog/2023-07-08-flet-for-android.md b/blog/2023-07-08-flet-for-android.md
@@ -15,6 +15,8 @@ Similar to iOS, Flet for Android is a Flutter app written entirely in Python wit
 
 **[Follow this guide](/docs/getting-started/testing-on-android)** to get started with testing your Flet apps on Android. Explore the app, browse gallery, play with sample projects and app settings.
 
+<!-- truncate -->
+
 ## FAQ
 
 ### How to package my Flet app for Google Play?
diff --git a/blog/2023-08-30-flet-for-fastapi.md b/blog/2023-08-30-flet-for-fastapi.md
@@ -13,6 +13,8 @@ We've just released Flet 0.10.0 with FastAPI support!
 
 On the other hand, seasoned FastAPI developers can use Flet to easily add interactive, real-time dashboards and admin UI to their existing or new FastAPI services.
 
+<!-- truncate -->
+
 ## A minimal app example
 
 ```python
diff --git a/blog/2023-12-30-packaging-apps-for-distribution.md b/blog/2023-12-30-packaging-apps-for-distribution.md
@@ -8,6 +8,8 @@ tags: [releases]
 Dear friends! In the final post of this year I would like to thank you all for your contributions
 to Flet project whether it's spreading a word, submitting pull request, joining Discord discussion or a even sending an annoying bug report!
 
+<!-- truncate -->
+
 With your fantastic support we achieved a lot in year 2023:
 
 * 70+ controls (special thanks to [@ndonkoHenri](https://github.com/ndonkoHenri) for his tremendous contribution).
diff --git a/blog/2024-02-14-flet-adaptive-and-custom-controls.md b/blog/2024-02-14-flet-adaptive-and-custom-controls.md
@@ -13,6 +13,8 @@ We just released Flet 0.20.0 with the focus on:
 2) Extending Flet apps with 3rd-party Flutter packages.
 3) New controls: [`Video`](/docs/controls/video) (yay!), [`AudioRecorder`](/docs/controls/audiorecorder) and a bunch of `Cupertino`-like controls. Flet now includes 97 built-in controls!
 
+<!-- truncate -->
+
 :::warning
 Flet 0.20.0 includes a new [`Video`](/docs/controls/video) control. While macOS and Windows already include all required media libraries to test Flet apps on Linux, the [libmpv](https://mpv.io/) package must be installed. On Ubuntu/Debian in can be installed with:
 
diff --git a/blog/2024-03-06-flet-fastapi-and-async-api-improvements.md b/blog/2024-03-06-flet-fastapi-and-async-api-improvements.md
@@ -11,6 +11,8 @@ Flet 0.21.0 further improves web apps development experience as well as using as
 
 Here's what's new in Flet 0.21.0:
 
+<!-- truncate -->
+
 ## FastAPI with Uvicorn replaces built-in web server
 
 From very beginning of Flet life to serve web apps there was a built-in web server written in Go
diff --git a/blog/2024-04-10-controls-and-theming-enhancements.md b/blog/2024-04-10-controls-and-theming-enhancements.md
@@ -9,6 +9,8 @@ One month after the release of Flet 0.21.0, we are excited to announce the relea
 
 This release comes with a lot of enhancements, bug fixes, and deprecations:
 
+<!-- truncate -->
+
 ## Enhancements
 
 This was one of the main concerns while coming up with this release. Two types of enhancements were made:
diff --git a/blog/2024-05-01-flet-packaging-update.md b/blog/2024-05-01-flet-packaging-update.md
@@ -14,6 +14,8 @@ If your program uses only Python standard library then packaging process is rela
 
 However, problems may arise when your Flet program uses third-party packages, with thousands of them published on PyPI or Conda.
 
+<!-- truncate -->
+
 There are two kinds of third-party packages:
 
 ### Pure-Python packages
diff --git a/blog/2025-02-23-tap-into-native-android-and-ios-apis-with-pyjnius-and-pyobjus.md b/blog/2025-02-23-tap-into-native-android-and-ios-apis-with-pyjnius-and-pyobjus.md
@@ -1,11 +1,8 @@
 ---
 slug: tap-into-native-android-and-ios-apis-with-Pyjnius-and-pyobjus
 title: Tap into native Android and iOS APIs with Pyjnius and Pyobjus
-author: Feodor Fitsner
-author_title: Flet founder and developer
-author_url: https://github.com/FeodorFitsner
-author_image_url: https://avatars0.githubusercontent.com/u/5041459?s=400&v=4
-tags: [releases]
+author: feodor
+tags: [news]
 ---
 
 When building mobile apps with Flet, you may need to interact directly with platform-specific APIs. Whether it’s accessing system information, managing Bluetooth devices, or working with user preferences, **Pyjnius** and **Pyobjus** by Kivy provide a seamless way to bridge Python with Java (for Android) and Objective-C (for iOS).
diff --git a/blog/authors.yml b/blog/authors.yml
@@ -11,4 +11,7 @@ henri:
   name: Henri Ndonko
   title: Flet Contributor and Maintainer
   url: https://github.com/ndonkoHenri
-  image_url: https://avatars.githubusercontent.com/u/98978078?v=4
+  image_url: https://avatars.githubusercontent.com/u/98978078?v=4
+  socials:
+    github: ndonkoHenri
+    x: ndonkoHenri
diff --git a/docs/cookbook/assets.md b/docs/cookbook/assets.md
@@ -2,7 +2,6 @@
 title: Assets
 sidebar_label: Assets
 ---
-## Overview
 
 Flet apps can include both code and assets/resources. An asset is a file that is bundled and deployed with your app and is accessible at runtime. Common types of assets include static data (e.g., JSON files), configuration files, icons, images, videos, etc.
 
diff --git a/docs/cookbook/read-and-write-files.md b/docs/cookbook/read-and-write-files.md
diff --git a/docs/getting-started/custom-controls.md b/docs/getting-started/custom-controls.md
diff --git a/docs/reference/environment-variables.md b/docs/reference/environment-variables.md
diff --git a/sidebars.js b/sidebars.js
