[BOT] post-merge updates

README.md

@@ -31,7 +31,7 @@ addon | version | maintainers | summary
 [fs_product_brand_multi_image](fs_product_brand_multi_image/) | 17.0.1.0.0 | [![lmignon](https://github.com/lmignon.png?size=30px)](https://github.com/lmignon) | Link images to product brands
 [fs_product_multi_image](fs_product_multi_image/) | 17.0.1.0.0 | [![lmignon](https://github.com/lmignon.png?size=30px)](https://github.com/lmignon) | Manage multi images from extenal file system on product
 [fs_product_multi_media](fs_product_multi_media/) | 17.0.1.0.0 | [![lmignon](https://github.com/lmignon.png?size=30px)](https://github.com/lmignon) | Link media to products and categories
-[fs_storage](fs_storage/) | 17.0.1.0.2 |  | Implement the concept of Storage with amazon S3, sftp...
+[fs_storage](fs_storage/) | 17.0.2.0.0 |  | Implement the concept of Storage with amazon S3, sftp...
 [image_tag](image_tag/) | 17.0.1.0.0 |  | Image tag model
 
 [//]: # (end addons)

fs_storage/README.rst

@@ -7,7 +7,7 @@ Filesystem Storage Backend
    !! This file is generated by oca-gen-addon-readme !!
    !! changes will be overwritten.                   !!
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-   !! source digest: sha256:6e7abac468ff2942178ac2df68774f75820b618173acf8c7b76f51fbdbe3b7bc
+   !! source digest: sha256:07c52fc9fe367da79feadc09de58055fb840d44872e33a4970312410c930111a
    !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
 
 .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
@@ -108,21 +108,38 @@ When you create a new backend, you must specify the following:
 
 -  The name of the backend. This is the name that will be used to
    identify the backend into Odoo
+
 -  The code of the backend. This code will identify the backend into the
    store_fname field of the ir.attachment model. This code must be
    unique. It will be used as scheme. example of the store_fname field:
    ``odoofs://abs34Tg11``.
+
 -  The protocol used by the backend. The protocol refers to the
    supported protocols of the fsspec python package.
+
 -  A directory path. This is a root directory from which the filesystem
    will be mounted. This directory must exist.
+
 -  The protocol options. These are the options that will be passed to
    the fsspec python package when creating the filesystem. These options
    depend on the protocol used and are described in the fsspec
    documentation.
+
 -  Resolve env vars. This options resolves the protocol options values
    starting with $ from environment variables
 
+-  Check Connection Method. If set, Odoo will always check the
+   connection before using a storage and it will remove the fs
+   connection from the cache if the check fails.
+
+   -  ``Create Marker file``: create a hidden file on remote and then
+      check it exists with Use it if you have write access to the remote
+      and if it is not an issue to leave the marker file in the root
+      directory.
+   -  ``List file``: list all files from the root directory. You can use
+      it if the directory path does not contain a big list of files (for
+      performance reasons)
+
 Some protocols defined in the fsspec package are wrappers around other
 protocols. For example, the SimpleCacheFileSystem protocol is a wrapper
 around any local filesystem protocol. In such cases, you must specify
@@ -212,6 +229,16 @@ Known issues / Roadmap
 Changelog
 =========
 
+17.0.2.0.0 (2024-10-07)
+-----------------------
+
+Features
+~~~~~~~~
+
+-  Invalidate FS filesystem object cache when the connection fails,
+   forcing a reconnection.
+   (`#320 <https://github.com/OCA/storage/issues/320>`__)
+
 16.0.1.1.0 (2023-12-22)
 -----------------------
 

fs_storage/__manifest__.py

@@ -5,7 +5,7 @@
 {
     "name": "Filesystem Storage Backend",
     "summary": "Implement the concept of Storage with amazon S3, sftp...",
-    "version": "17.0.1.0.2",
+    "version": "17.0.2.0.0",
     "category": "FS Storage",
     "website": "https://github.com/OCA/storage",
     "author": " ACSONE SA/NV, Odoo Community Association (OCA)",

fs_storage/readme/HISTORY.md

@@ -1,3 +1,10 @@
+## 17.0.2.0.0 (2024-10-07)
+
+### Features
+
+- Invalidate FS filesystem object cache when the connection fails, forcing a reconnection. ([#320](https://github.com/OCA/storage/issues/320))
+
+
 ## 16.0.1.1.0 (2023-12-22)
 
 **Features**

fs_storage/static/description/index.html

@@ -367,7 +367,7 @@ <h1 class="title">Filesystem Storage Backend</h1>
 !! This file is generated by oca-gen-addon-readme !!
 !! changes will be overwritten.                   !!
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
-!! source digest: sha256:6e7abac468ff2942178ac2df68774f75820b618173acf8c7b76f51fbdbe3b7bc
+!! source digest: sha256:07c52fc9fe367da79feadc09de58055fb840d44872e33a4970312410c930111a
 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
 <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/lgpl-3.0-standalone.html"><img alt="License: LGPL-3" src="https://img.shields.io/badge/licence-LGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/storage/tree/17.0/fs_storage"><img alt="OCA/storage" src="https://img.shields.io/badge/github-OCA%2Fstorage-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/storage-17-0/storage-17-0-fs_storage"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/storage&amp;target_branch=17.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
 <p>This addon is a technical addon that allows you to define filesystem
@@ -442,16 +442,20 @@ <h1 class="title">Filesystem Storage Backend</h1>
 </li>
 <li><a class="reference internal" href="#known-issues-roadmap" id="toc-entry-5">Known issues / Roadmap</a></li>
 <li><a class="reference internal" href="#changelog" id="toc-entry-6">Changelog</a><ul>
-<li><a class="reference internal" href="#section-1" id="toc-entry-7">16.0.1.1.0 (2023-12-22)</a></li>
-<li><a class="reference internal" href="#section-2" id="toc-entry-8">16.0.1.0.3 (2023-10-17)</a></li>
-<li><a class="reference internal" href="#section-3" id="toc-entry-9">16.0.1.0.2 (2023-10-09)</a></li>
+<li><a class="reference internal" href="#section-1" id="toc-entry-7">17.0.2.0.0 (2024-10-07)</a><ul>
+<li><a class="reference internal" href="#features" id="toc-entry-8">Features</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#bug-tracker" id="toc-entry-10">Bug Tracker</a></li>
-<li><a class="reference internal" href="#credits" id="toc-entry-11">Credits</a><ul>
-<li><a class="reference internal" href="#authors" id="toc-entry-12">Authors</a></li>
-<li><a class="reference internal" href="#contributors" id="toc-entry-13">Contributors</a></li>
-<li><a class="reference internal" href="#maintainers" id="toc-entry-14">Maintainers</a></li>
+<li><a class="reference internal" href="#section-2" id="toc-entry-9">16.0.1.1.0 (2023-12-22)</a></li>
+<li><a class="reference internal" href="#section-3" id="toc-entry-10">16.0.1.0.3 (2023-10-17)</a></li>
+<li><a class="reference internal" href="#section-4" id="toc-entry-11">16.0.1.0.2 (2023-10-09)</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#bug-tracker" id="toc-entry-12">Bug Tracker</a></li>
+<li><a class="reference internal" href="#credits" id="toc-entry-13">Credits</a><ul>
+<li><a class="reference internal" href="#authors" id="toc-entry-14">Authors</a></li>
+<li><a class="reference internal" href="#contributors" id="toc-entry-15">Contributors</a></li>
+<li><a class="reference internal" href="#maintainers" id="toc-entry-16">Maintainers</a></li>
 </ul>
 </li>
 </ul>
@@ -478,6 +482,18 @@ <h2><a class="toc-backref" href="#toc-entry-2">Configuration</a></h2>
 documentation.</li>
 <li>Resolve env vars. This options resolves the protocol options values
 starting with $ from environment variables</li>
+<li>Check Connection Method. If set, Odoo will always check the
+connection before using a storage and it will remove the fs
+connection from the cache if the check fails.<ul>
+<li><tt class="docutils literal">Create Marker file</tt>: create a hidden file on remote and then
+check it exists with Use it if you have write access to the remote
+and if it is not an issue to leave the marker file in the root
+directory.</li>
+<li><tt class="docutils literal">List file</tt>: list all files from the root directory. You can use
+it if the directory path does not contain a big list of files (for
+performance reasons)</li>
+</ul>
+</li>
 </ul>
 <p>Some protocols defined in the fsspec package are wrappers around other
 protocols. For example, the SimpleCacheFileSystem protocol is a wrapper
@@ -564,25 +580,36 @@ <h1><a class="toc-backref" href="#toc-entry-5">Known issues / Roadmap</a></h1>
 <div class="section" id="changelog">
 <h1><a class="toc-backref" href="#toc-entry-6">Changelog</a></h1>
 <div class="section" id="section-1">
-<h2><a class="toc-backref" href="#toc-entry-7">16.0.1.1.0 (2023-12-22)</a></h2>
+<h2><a class="toc-backref" href="#toc-entry-7">17.0.2.0.0 (2024-10-07)</a></h2>
+<div class="section" id="features">
+<h3><a class="toc-backref" href="#toc-entry-8">Features</a></h3>
+<ul class="simple">
+<li>Invalidate FS filesystem object cache when the connection fails,
+forcing a reconnection.
+(<a class="reference external" href="https://github.com/OCA/storage/issues/320">#320</a>)</li>
+</ul>
+</div>
+</div>
+<div class="section" id="section-2">
+<h2><a class="toc-backref" href="#toc-entry-9">16.0.1.1.0 (2023-12-22)</a></h2>
 <p><strong>Features</strong></p>
 <ul class="simple">
 <li>Add parameter on storage backend to resolve protocol options values
 starting with $ from environment variables
 (<a class="reference external" href="https://github.com/OCA/storage/issues/303">#303</a>)</li>
 </ul>
 </div>
-<div class="section" id="section-2">
-<h2><a class="toc-backref" href="#toc-entry-8">16.0.1.0.3 (2023-10-17)</a></h2>
+<div class="section" id="section-3">
+<h2><a class="toc-backref" href="#toc-entry-10">16.0.1.0.3 (2023-10-17)</a></h2>
 <p><strong>Bugfixes</strong></p>
 <ul class="simple">
 <li>Fix access to technical models to be able to upload attachments for
 users with basic access
 (<a class="reference external" href="https://github.com/OCA/storage/issues/289">#289</a>)</li>
 </ul>
 </div>
-<div class="section" id="section-3">
-<h2><a class="toc-backref" href="#toc-entry-9">16.0.1.0.2 (2023-10-09)</a></h2>
+<div class="section" id="section-4">
+<h2><a class="toc-backref" href="#toc-entry-11">16.0.1.0.2 (2023-10-09)</a></h2>
 <p><strong>Bugfixes</strong></p>
 <ul class="simple">
 <li>Avoid config error when using the webdav protocol. The auth option is
@@ -595,30 +622,30 @@ <h2><a class="toc-backref" href="#toc-entry-9">16.0.1.0.2 (2023-10-09)</a></h2>
 </div>
 </div>
 <div class="section" id="bug-tracker">
-<h1><a class="toc-backref" href="#toc-entry-10">Bug Tracker</a></h1>
+<h1><a class="toc-backref" href="#toc-entry-12">Bug Tracker</a></h1>
 <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/storage/issues">GitHub Issues</a>.
 In case of trouble, please check there if your issue has already been reported.
 If you spotted it first, help us to smash it by providing a detailed and welcomed
 <a class="reference external" href="https://github.com/OCA/storage/issues/new?body=module:%20fs_storage%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
 <p>Do not contact contributors directly about support or help with technical issues.</p>
 </div>
 <div class="section" id="credits">
-<h1><a class="toc-backref" href="#toc-entry-11">Credits</a></h1>
+<h1><a class="toc-backref" href="#toc-entry-13">Credits</a></h1>
 <div class="section" id="authors">
-<h2><a class="toc-backref" href="#toc-entry-12">Authors</a></h2>
+<h2><a class="toc-backref" href="#toc-entry-14">Authors</a></h2>
 <ul class="simple">
 <li>ACSONE SA/NV</li>
 </ul>
 </div>
 <div class="section" id="contributors">
-<h2><a class="toc-backref" href="#toc-entry-13">Contributors</a></h2>
+<h2><a class="toc-backref" href="#toc-entry-15">Contributors</a></h2>
 <ul class="simple">
 <li>Laurent Mignon &lt;<a class="reference external" href="mailto:laurent.mignon&#64;acsone.eu">laurent.mignon&#64;acsone.eu</a>&gt;</li>
 <li>Sébastien BEAU &lt;<a class="reference external" href="mailto:sebastien.beau&#64;akretion.com">sebastien.beau&#64;akretion.com</a>&gt;</li>
 </ul>
 </div>
 <div class="section" id="maintainers">
-<h2><a class="toc-backref" href="#toc-entry-14">Maintainers</a></h2>
+<h2><a class="toc-backref" href="#toc-entry-16">Maintainers</a></h2>
 <p>This module is maintained by the OCA.</p>
 <a class="reference external image-reference" href="https://odoo-community.org">
 <img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" />