From 4f61c4b2fc32898446e71d554c8118f03e1d3d20 Mon Sep 17 00:00:00 2001
From: Dmitry Ermakovich <dmitry.ermakovich@testit.software>
Date: Wed, 27 May 2026 09:58:43 +0300
Subject: [PATCH] feat: bump core, update docs

---
 README.md                                             | 11 +++++++++++
 testit-adapter-behave/setup.py                        |  2 +-
 testit-adapter-nose/setup.py                          |  2 +-
 testit-adapter-pytest/setup.py                        |  2 +-
 testit-adapter-robotframework/setup.py                |  2 +-
 testit-python-commons/setup.py                        |  2 +-
 .../services/sync_storage/sync_storage_runner.py      |  2 +-
 update_versions.sh                                    |  2 +-
 8 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index a6cb39b..8bf3f0e 100644
--- a/README.md
+++ b/README.md
@@ -57,6 +57,17 @@ Status](https://img.shields.io/pypi/v/testit-python-commons?style=plastic)](http
 
 You can change nothing, it's full compatible with previous versions of adapters for local run on all OS.
 
+### How to run in an isolated environment?
+
+The adapter tries to download the correct sync-storage version from GitHub. If that is not possible, prepare the sync-storage binary yourself:
+
+1. Find the sync-storage version for your adapter release: check out the release tag and look for the `SYNC_STORAGE_VERSION` value. You can use our [script](https://github.com/testit-tms/adapters-python/tree/main/scripts/get_sync_storage_version.sh).
+
+2. Download the correct binary for your OS and version from our [release page](https://github.com/testit-tms/sync-storage-public/releases).
+
+3. Place the downloaded binary at `./build/.caches/syncstorage-v0.3.3-windows_amd64.exe` in your test project (the version in the filename is an example).
+
+4. Run your tests as usual; the adapter will pick up and run the version specified in `SYNC_STORAGE_VERSION`.
 
 ### How to run 4.0+ with CI/CD?
 
diff --git a/testit-adapter-behave/setup.py b/testit-adapter-behave/setup.py
index 8c1cbd0..bf0bcad 100644
--- a/testit-adapter-behave/setup.py
+++ b/testit-adapter-behave/setup.py
@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "4.2.3"
+VERSION = "4.2.4"
 
 setup(
     name='testit-adapter-behave',
diff --git a/testit-adapter-nose/setup.py b/testit-adapter-nose/setup.py
index 17853d3..279f34e 100644
--- a/testit-adapter-nose/setup.py
+++ b/testit-adapter-nose/setup.py
@@ -1,6 +1,6 @@
 from setuptools import setup, find_packages
 
-VERSION = "4.2.3"
+VERSION = "4.2.4"
 
 setup(
     name='testit-adapter-nose',
diff --git a/testit-adapter-pytest/setup.py b/testit-adapter-pytest/setup.py
index 7c4fa61..833526b 100644
--- a/testit-adapter-pytest/setup.py
+++ b/testit-adapter-pytest/setup.py
@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "4.2.3"
+VERSION = "4.2.4"
 
 setup(
     name='testit-adapter-pytest',
diff --git a/testit-adapter-robotframework/setup.py b/testit-adapter-robotframework/setup.py
index 773fd3c..8b23d10 100644
--- a/testit-adapter-robotframework/setup.py
+++ b/testit-adapter-robotframework/setup.py
@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "4.2.3"
+VERSION = "4.2.4"
 
 setup(
     name='testit-adapter-robotframework',
diff --git a/testit-python-commons/setup.py b/testit-python-commons/setup.py
index 1148b8c..5969e83 100644
--- a/testit-python-commons/setup.py
+++ b/testit-python-commons/setup.py
@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = "4.2.3"
+VERSION = "4.2.4"
 
 setup(
     name='testit-python-commons',
diff --git a/testit-python-commons/src/testit_python_commons/services/sync_storage/sync_storage_runner.py b/testit-python-commons/src/testit_python_commons/services/sync_storage/sync_storage_runner.py
index c1fc1e6..8e0bfc7 100644
--- a/testit-python-commons/src/testit_python_commons/services/sync_storage/sync_storage_runner.py
+++ b/testit-python-commons/src/testit_python_commons/services/sync_storage/sync_storage_runner.py
@@ -40,7 +40,7 @@ class SyncStorageRunner:
     across multiple workers.
     """
 
-    SYNC_STORAGE_VERSION = "v0.3.3"
+    SYNC_STORAGE_VERSION = "v0.3.4"
     SYNC_STORAGE_REPO_URL = (
         "https://github.com/testit-tms/sync-storage-public/releases/download/"
     )
diff --git a/update_versions.sh b/update_versions.sh
index 32c0dac..a2eb663 100644
--- a/update_versions.sh
+++ b/update_versions.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 
-NEW_VERSION="4.2.3"
+NEW_VERSION="4.2.4"
 TESTIT_API_CLIENT_VERSION="7.5.10"
 
 echo "Updating all adapters to version: $NEW_VERSION"