docs: convert pycon to python blocks

Author: markdownpipe

README.md

@@ -36,33 +36,33 @@ pip install git+https://github.com/thewebscraping/tls-requests.git
 
 Start using TLS Requests with just a few lines of code. It automatically synchronizes headers based on your chosen browser identifier:
 
-```pycon
->>> import tls_requests
->>> # The library automatically injects matching User-Agent and Sec-CH-UA headers
->>> r = tls_requests.get("https://httpbin.org/headers", client_identifier="chrome_133")
->>> r.json()["headers"]["User-Agent"]
+```python
+import tls_requests
+# The library automatically injects matching User-Agent and Sec-CH-UA headers
+r = tls_requests.get("https://httpbin.org/headers", client_identifier="chrome_133")
+r.json()["headers"]["User-Agent"]
 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36'
 ```
 
 Basic automatically rotates for proxies and TLS identifiers:
 
-```pycon
->>> import tls_requests
->>> proxy_rotator = tls_requests.ProxyRotator([
+```python
+import tls_requests
+proxy_rotator = tls_requests.ProxyRotator([
     "http://user1:pass1@proxy.example.com:8080",
     "http://user2:pass2@proxy.example.com:8081",
     "socks5://proxy.example.com:8082",
     "proxy.example.com:8083",  # defaults to http
     "http://user:pass@proxy.example.com:8084|1.0|US",  # weight and region support
 ])
->>> r = tls_requests.get(
+r = tls_requests.get(
     "https://httpbin.org/get",
     proxy=proxy_rotator,
     client_identifier=tls_requests.TLSIdentifierRotator()
 )
->>> r
+r
 <Response [200 OK]>
->>> r.status_code
+r.status_code
 200
 ```
 
@@ -97,10 +97,10 @@ making it easy to scrape data or interact with websites that use sophisticated a
 
 **Example Code:**
 
-```pycon
->>> import tls_requests
->>> r = tls_requests.get('https://www.coingecko.com/')
->>> r
+```python
+import tls_requests
+r = tls_requests.get('https://www.coingecko.com/')
+r
 <Response [200]>
 ```
 
@@ -110,7 +110,7 @@ making it easy to scrape data or interact with websites that use sophisticated a
 ### **Enhanced Capabilities**
 
 *   **Browser-like TLS Fingerprinting**: Enables secure and reliable browser-mimicking connections.
-*   **Dynamic Header Synchronization**: Automatically extracts browser versions from `tls_identifier` and injects them into `User-Agent` and `sec-ch-ua` headers.
+*   **Dynamic Header Synchronization**: Automatically extracts browser versions from `client_identifier` and injects them into `User-Agent` and `sec-ch-ua` headers.
 *   **High-Performance Backend**: Built on a Go-based HTTP backend with **Protocol Racing** (Happy Eyeballs) enabled by default for faster connections.
 *   **Synchronous & Asynchronous Support**: Seamlessly switch between synchronous and asynchronous requests.
 *   **Protocol Support**: Fully compatible with HTTP/1.1, HTTP/2, and HTTP/3 (Alpha).

docs/advanced/async_client.md

@@ -69,6 +69,7 @@ The `AsyncClient` mirrors the `Client` API but requires the `await` keyword for
 
 ### Async Methods
 All request methods are coroutines:
+
 - `await client.get(url, ...)`
 - `await client.post(url, ...)`
 - `await client.put(url, ...)`

docs/advanced/client.md

@@ -87,6 +87,12 @@ The client supports all standard HTTP methods:
 - `client.options(url, **kwargs)`
 
 For more advanced scenarios like custom authentication or request hooks, refer to the dedicated guides in the [Advanced](../advanced/authentication.md) section.
+
+*   **Merging Headers and Cookies:**
+    Request-level values will override client-level values if there is a conflict.
+
+```python
+client_headers = {'X-Auth': 'client'}
 request_headers = {'X-Custom': 'request'}
 with tls_requests.Client(headers=client_headers) as client:
     response = client.get("https://httpbin.org/get", headers=request_headers)
@@ -99,14 +105,12 @@ with tls_requests.Client(headers=client_headers) as client:
 ```python
 with tls_requests.Client(auth=('user', 'pass')) as client:
     response = client.get("https://httpbin.org/get", auth=('admin', 'adminpass'))
-    print(response.request.headers['Authorization'])  # Encoded 'admin:adminpass'
-
+    # Authorization header would be encoded 'admin:adminpass'
 ```
 
 * * *
 
-Advanced Request Handling
--------------------------
+## Advanced Request Handling
 
 For more control, explicitly build and send `Request` instances:
 
@@ -122,15 +126,15 @@ To combine client- and request-level configurations:
 ```python
 with tls_requests.Client(headers={"X-Client-ID": "ABC123"}) as client:
     request = client.build_request("GET", "https://httpbin.org/json")
-    del request.headers["X-Client-ID"]  # Modify as needed
+    # request.headers["X-Client-ID"] is present, but you can modify it
+    del request.headers["X-Client-ID"]
     response = client.send(request)
     print(response)
 ```
 
 * * *
 
-File Uploads
-------------
+## File Uploads
 
 Upload files with control over file name, content, and MIME type:
 

docs/advanced/rotators.md

@@ -29,22 +29,22 @@ with tls_requests.Client(headers=tls_requests.HeaderRotator()) as client:
 **How to Override the Default Behavior:**
 
 -   **To rotate through your own list of headers**, pass a `list` of `dict`s:
-    ```python
-    my_headers = [{"User-Agent": "MyBot/1.0"}, {"User-Agent": "MyBot/2.0"}]
-    client = tls_requests.Client(headers=my_headers)
-    ```
+```python
+my_headers = [{"User-Agent": "MyBot/1.0"}, {"User-Agent": "MyBot/2.0"}]
+client = tls_requests.Client(headers=my_headers)
+```
 
 -   **To use a single, static set of headers (no rotation)**, pass a single `dict`:
-    ```python
-    static_headers = {"User-Agent": "Always-The-Same-Bot/1.0"}
-    client = tls_requests.Client(headers=static_headers)
-    ```
+```python
+static_headers = {"User-Agent": "Always-The-Same-Bot/1.0"}
+client = tls_requests.Client(headers=static_headers)
+```
 
 -   **To completely disable default headers**, pass `None`:
-    ```python
-    # This client will not add any default headers (like User-Agent).
-    client = tls_requests.Client(headers=None)
-    ```
+```python
+# This client will not add any default headers (like User-Agent).
+client = tls_requests.Client(headers=None)
+```
 
 * * *
 

docs/index.md

@@ -46,12 +46,12 @@ pip install git+https://github.com/thewebscraping/tls-requests.git
 
 Start using TLS Requests with just a few lines of code:
 
-```pycon
->>> import tls_requests
->>> r = tls_requests.get("https://httpbin.org/get")
->>> r
+```python
+import tls_requests
+r = tls_requests.get("https://httpbin.org/get")
+r
 <Response [200 OK]>
->>> r.status_code
+r.status_code
 200
 ```
 
@@ -88,10 +88,10 @@ Modern websites increasingly use **TLS Fingerprinting** and anti-bot tools like
 
 **Example Code:**
 
-```pycon
->>> import tls_requests
->>> r = tls_requests.get('https://www.coingecko.com/')
->>> r
+```python
+import tls_requests
+r = tls_requests.get('https://www.coingecko.com/')
+r
 <Response [200]>
 ```
 * * *