refactor!: Make Actor initialization stricter and more predictable (#576)

### Description

- All relevant parts of `Actor` are initialized in `async init,` not in
`__init__`.
- `Actor` is considered finalized after `Actor.init` was run. This also
means that the same configuration used by the `Actor` is set in the
global `service_locator`.
- There are three valid scenarios for setting up the configuration.
- Setting global configuration in `service_locator` before the
`Actor.init`
- Having no configuration set in `service_locator` and set it through
`Actor.(configuration=...)` and running `Actor.init()`
- Having no configuration set in `service_locator` and no configuration
passed to `Actor` will create and set implicit default configuration
- Properly set `ApifyFileSystemStorageClient` as local client to support
pre-existing input file.
- Depends on apify/crawlee-python/pull/1386
- Enable caching of `ApifyStorageClient` based on `token` and
`api_public_url` and update NDU storage handling.

### Issues

Rated to: #513, #590

### Testing

- Added many new initialization tests that show possible and prohibited
use cases
https://github.com/apify/apify-sdk-python/pull/576/files#diff-d64e1d346cc84a225ace3eb1d1ca826ff1e25c77064c9b1e0145552845fa7b41
- Running benchmark actor based on this and the related Crawlee branch

---------

Co-authored-by: Vlada Dusek <[email protected]>

Author: Pijukatel

docs/02_concepts/09_running_webserver.mdx

@@ -13,9 +13,9 @@ The URL is available in the following places:
 
 - In Apify Console, on the Actor run details page as the **Container URL** field.
 - In the API as the `container_url` property of the [Run object](https://docs.apify.com/api/v2#/reference/actors/run-object/get-run).
-- In the Actor as the `Actor.config.container_url` property.
+- In the Actor as the `Actor.configuration.container_url` property.
 
-The web server running inside the container must listen at the port defined by the `Actor.config.container_port` property. When running Actors locally, the port defaults to `4321`, so the web server will be accessible at `http://localhost:4321`.
+The web server running inside the container must listen at the port defined by the `Actor.configuration.container_port` property. When running Actors locally, the port defaults to `4321`, so the web server will be accessible at `http://localhost:4321`.
 
 ## Example
 

docs/02_concepts/code/07_webhook_preventing.py

@@ -7,7 +7,7 @@ async def main() -> None:
         webhook = Webhook(
             event_types=['ACTOR.RUN.FAILED'],
             request_url='https://example.com/run-failed',
-            idempotency_key=Actor.config.actor_run_id,
+            idempotency_key=Actor.configuration.actor_run_id,
         )
 
         # Add the webhook to the Actor.

docs/02_concepts/code/09_webserver.py

@@ -22,9 +22,9 @@ def run_server() -> None:
     # and save a reference to the server.
     global http_server
     with ThreadingHTTPServer(
-        ('', Actor.config.web_server_port), RequestHandler
+        ('', Actor.configuration.web_server_port), RequestHandler
     ) as server:
-        Actor.log.info(f'Server running on {Actor.config.web_server_port}')
+        Actor.log.info(f'Server running on {Actor.configuration.web_server_port}')
         http_server = server
         server.serve_forever()
 

docs/02_concepts/code/conditional_actor_charge.py

@@ -13,6 +13,6 @@ async def main() -> None:
         if Actor.get_charging_manager().get_pricing_info().is_pay_per_event:
             # highlight-end
             await Actor.push_data({'hello': 'world'}, 'dataset-item')
-        elif charged_items < (Actor.config.max_paid_dataset_items or 0):
+        elif charged_items < (Actor.configuration.max_paid_dataset_items or 0):
             await Actor.push_data({'hello': 'world'})
             charged_items += 1

docs/03_guides/code/03_playwright.py

@@ -40,7 +40,7 @@ async def main() -> None:
         async with async_playwright() as playwright:
             # Configure the browser to launch in headless mode as per Actor configuration.
             browser = await playwright.chromium.launch(
-                headless=Actor.config.headless,
+                headless=Actor.configuration.headless,
                 args=['--disable-gpu'],
             )
             context = await browser.new_context()

docs/03_guides/code/04_selenium.py

@@ -41,7 +41,7 @@ async def main() -> None:
         Actor.log.info('Launching Chrome WebDriver...')
         chrome_options = ChromeOptions()
 
-        if Actor.config.headless:
+        if Actor.configuration.headless:
             chrome_options.add_argument('--headless')
 
         chrome_options.add_argument('--no-sandbox')

docs/04_upgrading/upgrading_to_v3.md

@@ -9,6 +9,42 @@ This page summarizes the breaking changes between Apify Python SDK v2.x and v3.0
 
 Support for Python 3.9 has been dropped. The Apify Python SDK v3.x now requires Python 3.10 or later. Make sure your environment is running a compatible version before upgrading.
 
+## Actor initialization and ServiceLocator changes
+
+`Actor` initialization and global `service_locator` services setup is more strict and predictable.
+- Services in `Actor` can't be changed after calling `Actor.init`, entering the `async with Actor` context manager or after requesting them from the `Actor`.
+- Services in `Actor` can be different from services in Crawler.
+
+
+**Now (v3.0):**
+
+```python
+from crawlee.crawlers import BasicCrawler
+from crawlee.storage_clients import MemoryStorageClient
+from crawlee.configuration import Configuration
+from crawlee.events import LocalEventManager
+from apify import Actor
+
+async def main():
+
+    async with Actor():
+        # This crawler will use same services as Actor and global service_locator
+        crawler_1 = BasicCrawler()
+
+        # This crawler will use custom services
+        custom_configuration = Configuration()
+        custom_event_manager = LocalEventManager.from_config(custom_configuration)
+        custom_storage_client = MemoryStorageClient()
+        crawler_2 = BasicCrawler(
+            configuration=custom_configuration,
+            event_manager=custom_event_manager,
+            storage_client=custom_storage_client,
+        )
+```
+
+## Removed Actor.config property
+- `Actor.config` property has been removed. Use `Actor.configuration` instead.
+
 ## Storages
 
 <!-- TODO -->

pyproject.toml

@@ -36,7 +36,7 @@ keywords = [
 dependencies = [
     "apify-client>=2.0.0,<3.0.0",
     "apify-shared>=2.0.0,<3.0.0",
-    "crawlee==0.6.13b37",
+    "crawlee==0.6.13b42",
     "cachetools>=5.5.0",
     "cryptography>=42.0.0",
     "impit>=0.6.1",