refactor!: Enforce keyword-only arguments across all public and internal APIs

Add `*` separator to all function and method signatures (117 functions across 16 files)
to enforce keyword-only argument passing. Update all internal callers (707 call sites in
src/ and tests/), documentation examples (31 docs files), and website examples to use
keyword syntax.

BREAKING CHANGE: All function parameters (beyond self/cls) are now keyword-only.
Callers must use `func(param=value)` instead of `func(value)`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: vdusek

docs/01_overview/code/01_usage_async.py

@@ -5,17 +5,17 @@
 
 
 async def main() -> None:
-    apify_client = ApifyClientAsync(TOKEN)
+    apify_client = ApifyClientAsync(token=TOKEN)
 
     # Start an Actor and wait for it to finish.
-    actor_client = apify_client.actor('john-doe/my-cool-actor')
+    actor_client = apify_client.actor(actor_id='john-doe/my-cool-actor')
     call_result = await actor_client.call()
 
     if call_result is None:
         print('Actor run failed.')
         return
 
     # Fetch results from the Actor run's default dataset.
-    dataset_client = apify_client.dataset(call_result.default_dataset_id)
+    dataset_client = apify_client.dataset(dataset_id=call_result.default_dataset_id)
     list_items_result = await dataset_client.list_items()
     print(f'Dataset: {list_items_result}')

docs/01_overview/code/01_usage_sync.py

@@ -5,17 +5,17 @@
 
 
 def main() -> None:
-    apify_client = ApifyClient(TOKEN)
+    apify_client = ApifyClient(token=TOKEN)
 
     # Start an Actor and wait for it to finish.
-    actor_client = apify_client.actor('john-doe/my-cool-actor')
+    actor_client = apify_client.actor(actor_id='john-doe/my-cool-actor')
     call_result = actor_client.call()
 
     if call_result is None:
         print('Actor run failed.')
         return
 
     # Fetch results from the Actor run's default dataset.
-    dataset_client = apify_client.dataset(call_result.default_dataset_id)
+    dataset_client = apify_client.dataset(dataset_id=call_result.default_dataset_id)
     list_items_result = dataset_client.list_items()
     print(f'Dataset: {list_items_result}')

docs/01_overview/code/02_auth_async.py

@@ -5,4 +5,4 @@
 
 async def main() -> None:
     # Client initialization with the API token.
-    apify_client = ApifyClientAsync(TOKEN)
+    apify_client = ApifyClientAsync(token=TOKEN)

docs/01_overview/code/02_auth_sync.py

@@ -5,4 +5,4 @@
 
 def main() -> None:
     # Client initialization with the API token.
-    apify_client = ApifyClient(TOKEN)
+    apify_client = ApifyClient(token=TOKEN)

docs/01_overview/code/03_dataset_async.py

@@ -4,8 +4,8 @@
 
 
 async def main() -> None:
-    apify_client = ApifyClientAsync(TOKEN)
-    dataset_client = apify_client.dataset('dataset-id')
+    apify_client = ApifyClientAsync(token=TOKEN)
+    dataset_client = apify_client.dataset(dataset_id='dataset-id')
 
     # Lists items from the Actor's dataset.
     dataset_items = (await dataset_client.list_items()).items

docs/01_overview/code/03_dataset_sync.py

@@ -4,8 +4,8 @@
 
 
 def main() -> None:
-    apify_client = ApifyClient(TOKEN)
-    dataset_client = apify_client.dataset('dataset-id')
+    apify_client = ApifyClient(token=TOKEN)
+    dataset_client = apify_client.dataset(dataset_id='dataset-id')
 
     # Lists items from the Actor's dataset.
     dataset_items = dataset_client.list_items().items

docs/01_overview/code/03_input_async.py

@@ -4,8 +4,8 @@
 
 
 async def main() -> None:
-    apify_client = ApifyClientAsync(TOKEN)
-    actor_client = apify_client.actor('username/actor-name')
+    apify_client = ApifyClientAsync(token=TOKEN)
+    actor_client = apify_client.actor(actor_id='username/actor-name')
 
     # Define the input for the Actor.
     run_input = {

docs/01_overview/code/03_input_sync.py

@@ -4,8 +4,8 @@
 
 
 def main() -> None:
-    apify_client = ApifyClient(TOKEN)
-    actor_client = apify_client.actor('username/actor-name')
+    apify_client = ApifyClient(token=TOKEN)
+    actor_client = apify_client.actor(actor_id='username/actor-name')
 
     # Define the input for the Actor.
     run_input = {

docs/02_concepts/code/01_async_support.py

@@ -6,12 +6,12 @@
 
 
 async def main() -> None:
-    apify_client = ApifyClientAsync(TOKEN)
-    actor_client = apify_client.actor('my-actor-id')
+    apify_client = ApifyClientAsync(token=TOKEN)
+    actor_client = apify_client.actor(actor_id='my-actor-id')
 
     # Start the Actor and get the run ID
     run_result = await actor_client.start()
-    run_client = apify_client.run(run_result.id)
+    run_client = apify_client.run(run_id=run_result.id)
     log_client = run_client.log()
 
     # Stream the logs

docs/02_concepts/code/02_collection_async.py

@@ -4,7 +4,7 @@
 
 
 async def main() -> None:
-    apify_client = ApifyClientAsync(TOKEN)
+    apify_client = ApifyClientAsync(token=TOKEN)
 
     # Collection clients do not require a parameter
     actor_collection_client = apify_client.actors()