updated actions as well as readme

Author: justrach

.github/workflows/release.yml

@@ -24,47 +24,31 @@ jobs:
       with:
         python-version: '3.10'
 
-    - name: Set up Go module structure
-      run: |
-        # Create proper Go module structure for correct imports
-        mkdir -p $HOME/go/src/github.com/justrach
-        cp -r $GITHUB_WORKSPACE $HOME/go/src/github.com/justrach/pathik
-        echo "GOPATH=$HOME/go" >> $GITHUB_ENV
-        echo "WORKING_DIR=$HOME/go/src/github.com/justrach/pathik" >> $GITHUB_ENV
-    
     - name: Install dependencies
       run: |
-        cd ${{ env.WORKING_DIR }}
         python -m pip install --upgrade pip
         pip install setuptools wheel twine build requests
     
     - name: Extract version from tag
       id: get_version
-      run: |
-        cd ${{ env.WORKING_DIR }}
-        echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
+      run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
 
     - name: Build binaries for all platforms
-      run: |
-        cd ${{ env.WORKING_DIR }}
-        python build_binary.py --all
+      run: python build_binary.py --all
 
     - name: Check output structure
       run: |
-        cd ${{ env.WORKING_DIR }}
         find . -name "pathik_bin*" | sort
     
     - name: Debug pathik directory
       run: |
-        cd ${{ env.WORKING_DIR }}
         echo "Contents of the bin directory:"
         ls -la pathik/bin/ || echo "Directory not found"
         echo "Searching for all binary files:"
         find pathik -type f -name "pathik_bin*" || echo "No binaries found"
     
     - name: Prepare binaries with unique names
       run: |
-        cd ${{ env.WORKING_DIR }}
         mkdir -p release_assets
         cp pathik/bin/darwin_amd64/pathik_bin release_assets/pathik_bin_darwin_amd64
         cp pathik/bin/darwin_arm64/pathik_bin release_assets/pathik_bin_darwin_arm64
@@ -82,11 +66,10 @@ jobs:
         draft: false
         prerelease: false
         token: ${{ secrets.GITHUB_TOKEN }}
-        files: ${{ env.WORKING_DIR }}/release_assets/*
+        files: release_assets/*
 
     - name: Build Python package
       run: |
-        cd ${{ env.WORKING_DIR }}
         # Ensure version numbers match
         sed -i "s/VERSION = '.*'/VERSION = '${{ env.VERSION }}'/g" setup.py
         sed -i "s/__version__ = \".*\"/__version__ = \"${{ env.VERSION }}\"/g" pathik/__init__.py
@@ -99,7 +82,6 @@ jobs:
         TWINE_USERNAME: __token__
         TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
       run: |
-        cd ${{ env.WORKING_DIR }}
         twine upload dist/*
 
   publish-npm:
@@ -124,20 +106,11 @@ jobs:
     - name: Extract version from tag
       run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_ENV
 
-    - name: Set up working directory
-      run: |
-        mkdir -p $HOME/go/src/github.com/justrach
-        cp -r $GITHUB_WORKSPACE $HOME/go/src/github.com/justrach/pathik
-        echo "WORKING_DIR=$HOME/go/src/github.com/justrach/pathik" >> $GITHUB_ENV
-    
     - name: Create JS package binaries directory
-      run: |
-        cd ${{ env.WORKING_DIR }}
-        mkdir -p pathik-js/bin
+      run: mkdir -p pathik-js/bin
 
     - name: Download released binaries
       run: |
-        cd ${{ env.WORKING_DIR }}
         # Create a temporary directory to download the binaries
         mkdir -p temp_binaries
         
@@ -151,7 +124,6 @@ jobs:
 
     - name: Copy binaries to JS package
       run: |
-        cd ${{ env.WORKING_DIR }}
         # Create platform-specific directories
         mkdir -p pathik-js/bin/darwin-amd64
         mkdir -p pathik-js/bin/darwin-arm64
@@ -177,18 +149,18 @@ jobs:
     
     - name: Update package version
       run: |
-        cd ${{ env.WORKING_DIR }}/pathik-js
+        cd pathik-js
         npm version ${{ env.VERSION }} --no-git-tag-version
         cat package.json | grep version
     
     - name: Install dependencies
       run: |
-        cd ${{ env.WORKING_DIR }}/pathik-js
+        cd pathik-js
         npm install
     
     - name: Publish to npm
       run: |
-        cd ${{ env.WORKING_DIR }}/pathik-js
+        cd pathik-js
         npm publish
       env:
         NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} 

README.md

@@ -15,6 +15,7 @@ A high-performance web crawler implemented in Go with Python and JavaScript bind
 - Cloudflare R2 integration
 - Kafka streaming support
 - Memory-efficient (uses ~10x less memory than browser automation tools)
+- Automatic binary version management
 
 ## Performance Benchmarks
 
@@ -58,6 +59,31 @@ pip install pathik
 
 The package will automatically download the correct binary for your platform from GitHub releases on first use.
 
+### Binary Version Management
+
+Pathik now automatically handles binary version checking and updates:
+
+- When you install or upgrade the Python package, it will check if the binary matches the package version
+- If the versions don't match, it will automatically download the correct binary
+- You can manually check and update the binary with:
+  ```python
+  # Force binary update
+  import pathik
+  from pathik.crawler import get_binary_path
+  binary_path = get_binary_path(force_download=True)
+  ```
+
+- Command line options:
+  ```bash
+  # Check if binary is up to date
+  pathik --check-binary
+  
+  # Force update of the binary
+  pathik --force-update-binary
+  ```
+
+This ensures you always have the correct binary version with all the latest features, especially when using new functionality like Kafka streaming with session IDs.
+
 ## Usage
 
 ### Python API