Update version to

  1.0.3

  - Fix GitHub Actions
   workflow
  deprecation
  - Update country
  code validation
  - Add missing
  changelog entries

Author: עידן וילנסקי

.github/workflows/publish.yml

@@ -30,7 +30,7 @@ jobs:
       run: python -m build
 
     - name: Upload build artifacts
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: dist-files
         path: dist/
@@ -54,7 +54,7 @@ jobs:
         python-version: '3.8'
 
     - name: Download build artifacts
-      uses: actions/download-artifact@v3
+      uses: actions/download-artifact@v4
       with:
         name: dist-files
         path: dist/

CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.3] - 2025-08-19
+
+### Fixed
+- Updated GitHub Actions workflow to use `actions/upload-artifact@v4` and `actions/download-artifact@v4` to resolve CI/CD pipeline failures
+- Fixed deprecated action versions that were causing automatic build failures
+
+### Changed
+- Enhanced `validate_country_code()` function to accept both 2-letter ISO country codes and empty strings
+- Improved validation flexibility for country code parameters
+
+## [1.0.2] - 2025-08-18
+
+### Fixed
+- Resolved issues with zone opening functionality
+- Fixed zone management and configuration problems
+
+### Added
+- Created comprehensive test units for improved code reliability
+- Added unit tests for core SDK functionality
+
 ## [1.0.1] - 2025-08-11
 
 ### Changed

brightdata/__init__.py

@@ -32,7 +32,7 @@
     APIError
 )
 
-__version__ = "1.0.2"
+__version__ = "1.0.3"
 __author__ = "Bright Data"
 __email__ = "[email protected]"
 

brightdata/api/scraper.py

@@ -26,9 +26,9 @@ def scrape(
         self,
         url: Union[str, List[str]],
         zone: str,
-        response_format: str = "json",
+        response_format: str = "raw",
         method: str = "GET", 
-        country: str = "us",
+        country: str = "",
         data_format: str = "markdown",
         async_request: bool = False,
         max_workers: int = 10,
@@ -42,10 +42,10 @@ def scrape(
         **Parameters:**
         - `url` (str | List[str]): Single URL string or list of URLs to scrape
         - `zone` (str): Your Bright Data zone identifier 
-        - `response_format` (str, optional): Response format - `"json"` for structured data, `"raw"` for HTML string (default: `"json"`)
+        - `response_format` (str, optional): Response format - `"json"` for structured data, `"raw"` for HTML string (default: `"raw"`)
         - `method` (str, optional): HTTP method for the request (default: `"GET"`)
         - `country` (str, optional): Two-letter ISO country code for proxy location (default: `"us"`)
-        - `data_format` (str, optional): Additional format transformation (default: `"markdown"`)
+        - `data_format` (str, optional): Additional format transformation (default: `"html"`)
         - `async_request` (bool, optional): Enable asynchronous processing (default: `False`)
         - `max_workers` (int, optional): Maximum parallel workers for multiple URLs (default: `10`)
         - `timeout` (int, optional): Request timeout in seconds (default: `30`)
@@ -142,7 +142,6 @@ def _perform_single_scrape(
             "url": url,
             "format": response_format,
             "method": method,
-            "country": country,
             "data_format": data_format
         }
 

brightdata/api/search.py

@@ -29,9 +29,9 @@ def search(
         query: Union[str, List[str]],
         search_engine: str = "google",
         zone: str = None,
-        response_format: str = "json",
+        response_format: str = "raw",
         method: str = "GET",
-        country: str = "us",
+        country: str = "",
         data_format: str = "markdown",
         async_request: bool = False,
         max_workers: int = 10,
@@ -47,7 +47,7 @@ def search(
         - `query` (str | List[str]): Search query string or list of search queries
         - `search_engine` (str, optional): Search engine to use - `"google"`, `"bing"`, or `"yandex"` (default: `"google"`)
         - `zone` (str, optional): Your Bright Data zone identifier (default: `None`)
-        - `response_format` (str, optional): Response format - `"json"` for structured data, `"raw"` for HTML string (default: `"json"`)
+        - `response_format` (str, optional): Response format - `"json"` for structured data, `"raw"` for HTML string (default: `"raw"`)
         - `method` (str, optional): HTTP method for the request (default: `"GET"`)
         - `country` (str, optional): Two-letter ISO country code for proxy location (default: `"us"`)
         - `data_format` (str, optional): Additional format transformation (default: `"markdown"`)
@@ -161,7 +161,6 @@ def _perform_single_search(
             "url": url,
             "format": response_format,
             "method": method,
-            "country": country,
             "data_format": data_format
         }
 

brightdata/client.py

@@ -138,9 +138,9 @@ def scrape(
         self,
         url: Union[str, List[str]],
         zone: str = None,
-        response_format: str = "json",
+        response_format: str = "raw",
         method: str = "GET", 
-        country: str = "us",
+        country: str = "",
         data_format: str = "markdown",
         async_request: bool = False,
         max_workers: int = None,
@@ -156,7 +156,7 @@ def scrape(
         - `zone` (str, optional): Zone identifier (default: auto-configured web_unlocker_zone)
         - `response_format` (str, optional): Response format - `"json"` for structured data, `"raw"` for HTML string (default: `"json"`)
         - `method` (str, optional): HTTP method for the request (default: `"GET"`)
-        - `country` (str, optional): Two-letter ISO country code for proxy location (default: `"us"`)
+        - `country` (str, optional): Two-letter ISO country code for proxy location (defaults to fastest connection)
         - `data_format` (str, optional): Additional format transformation (default: `"markdown"`)
         - `async_request` (bool, optional): Enable asynchronous processing (default: `False`)
         - `max_workers` (int, optional): Maximum parallel workers for multiple URLs (default: `10`)
@@ -201,9 +201,9 @@ def search(
         query: Union[str, List[str]],
         search_engine: str = "google",
         zone: str = None,
-        response_format: str = "json",
+        response_format: str = "raw",
         method: str = "GET",
-        country: str = "us",
+        country: str = "",
         data_format: str = "markdown",
         async_request: bool = False,
         max_workers: int = None,

brightdata/utils/validation.py

@@ -66,8 +66,11 @@ def validate_country_code(country: str) -> None:
         raise ValidationError(f"Country code must be a string, got {type(country).__name__}")
 
     country = country.strip().lower()
+    if len(country) == 0:
+        return
+    
     if len(country) != 2:
-        raise ValidationError("Country code must be exactly 2 characters (ISO 3166-1 alpha-2)")
+        raise ValidationError("Country code must be exactly 2 characters (ISO 3166-1 alpha-2) or empty")
 
     if not country.isalpha():
         raise ValidationError("Country code must contain only letters")

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "brightdata-sdk"
-version = "1.0.2"
+version = "1.0.3"
 description = "Python SDK for Bright Data Web Scraping and SERP APIs"
 authors = [
     {name = "Bright Data", email = "[email protected]"}
@@ -52,11 +52,11 @@ test = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/brightdata/brightdata-sdk-python"
-Documentation = "https://github.com/brightdata/brightdata-sdk-python#readme"
-Repository = "https://github.com/brightdata/brightdata-sdk-python"
-"Bug Reports" = "https://github.com/brightdata/brightdata-sdk-python/issues"
-Changelog = "https://github.com/brightdata/brightdata-sdk-python/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/brightdata/bright-data-sdk-python"
+Documentation = "https://github.com/brightdata/bright-data-sdk-python#readme"
+Repository = "https://github.com/brightdata/bright-data-sdk-python"
+"Bug Reports" = "https://github.com/brightdata/bright-data-sdk-python/issues"
+Changelog = "https://github.com/brightdata/bright-data-sdk-python/blob/main/CHANGELOG.md"
 
 [tool.setuptools.packages.find]
 include = ["brightdata*"]