**Changed:** Documentation - Add UTF-8 headers to the Python code snippets shown.

Author: rmoralespp

CHANGELOG.md

@@ -1,7 +1,8 @@
 ## Releases
 
-- **Changed:** Enable more `ruff` rules and pass all checks
-- **Changed:** Docstrings - Enable all `sphinx-linter` rules and pass all checks
+- **Changed:** Documentation - Add UTF-8 headers to the Python code snippets shown.
+- **Changed:** Enable more `ruff` rules and pass all checks.
+- **Changed:** Docstrings - Enable all `sphinx-linter` rules and pass all checks.
 - **Fixed:** Tests - Delay the closing of the `http_server` fixture socket to ensure that the thread closes properly.
 
 ### v1.3.21 (2025-11-04)

docs/dump.md

@@ -3,9 +3,11 @@
 Dump JSON Lines (jsonl) files incrementally, supporting both uncompressed and compressed formats and allowing
 custom serialization and opener callbacks.
 
-#### Dump the data to an uncompressed file at the specified path.
+#### Dump the data to an uncompressed file at the specified path
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 data = [
@@ -16,13 +18,15 @@ data = [
 jsonl.dump(data, "file.jsonl")
 ```
 
-#### Dump the data to a compressed file at the specified path.
+#### Dump the data to a compressed file at the specified path
 
 !!! note
     Supported compression formats are: **gzip (.gz), bzip2 (.bz2), xz (.xz)**
     If a file extension is not provided or is unrecognized, the file will be assumed to be uncompressed.
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 data = [
@@ -43,9 +47,11 @@ jsonl.dump(data, "file.jsonl.xz")
 jsonl.dump(data, "file.jsonl.foo")
 ```
 
-#### Dump the data to the already opened file.
+#### Dump the data to the already opened file
 
 ```python
+# -*- coding: utf-8 -*-
+
 import gzip
 
 import jsonl
@@ -64,9 +70,11 @@ with gzip.open("file.jsonl.gz", mode="wb") as fd:
     jsonl.dump(data, fd, text_mode=False)
 ```
 
-#### Append the data to the end of the existing file.
+#### Append the data to the end of the existing file
 
 ```python
+# -*- coding: utf-8 -*-
+
 import gzip
 
 import jsonl
@@ -85,13 +93,14 @@ with open("file.jsonl", mode="at", encoding="utf-8") as fp:
     jsonl.dump(data, fp, text_mode=True)
 ```
 
-#### Dump the data to a custom file object.
+#### Dump the data to a custom file object
 
 !!! tip
     Use this feature when you need to write the data to a custom file object.
     The custom file object must have a `write` or `writelines` method.
 
 ```python
+# -*- coding: utf-8 -*-
 
 import jsonl
 
@@ -122,19 +131,21 @@ jsonl.dump(data, MyCustomFile1(), text_mode=True)
 jsonl.dump(data, MyCustomFile2(), text_mode=True)
 ```
 
-#### Dump data with a custom serialization.
+#### Dump data with a custom serialization
 
 The `json_dumps` parameter allows for custom serialization and must take a Python object and return a
 JSON-formatted string.
 
 The following example shows how to use the `json_dumps` parameter to serialize data with the `orjson` and `ujson `
 libraries. Make sure to install these libraries to run the example.
 
-```console
+```bash
 pip install orjson ujson # Ignore this command if these libraries are already installed.
 ```
 
 ```python
+# -*- coding: utf-8 -*-
+
 import orjson
 import ujson
 

docs/dump_archive.md

@@ -15,6 +15,8 @@
 **Example usage:**
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 data = [

docs/dump_fork.md

@@ -13,6 +13,8 @@ This example creates individual JSON Lines files for each player, storing their
 
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 
@@ -54,11 +56,13 @@ jsonl.dump_fork(generate_win_data())
 This example demonstrates how to dump data using different JSON libraries.
 You can install `orjson` and `ujson` to run the following example.
 
-```console
+```bash
 pip install orjson ujson # Ignore this command if these libraries are already installed.
 ```
 
 ```python
+# -*- coding: utf-8 -*-
+
 import orjson
 import ujson
 import jsonl

docs/dumps.md

@@ -1,6 +1,8 @@
-##### Serialize an iterable into a JSON Lines formatted string.
+##### Serialize an iterable into a JSON Lines formatted string
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 data = ({'foo': 1}, {'bar': 2})

docs/load.md

@@ -12,11 +12,12 @@ It also allows loading from URLs and `urllib` requests.
     If a file extension is not provided or is not recognized, the compression format will be automatically detected by reading the file's **"magic number."**
 
     If the detection fails, the file is considered uncompressed.
-```
 
-#### Load an uncompressed file given a path.
+#### Load an uncompressed file given a path
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 path = "file.jsonl"
@@ -35,11 +36,13 @@ iterator = jsonl.load(path)
 print(tuple(iterator))
 ```
 
-#### Load a compressed file given a path.
+#### Load a compressed file given a path
 
 Check [note](#note-compression) for more details
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 path = "file.jsonl.gz" # gzip compressed file, but it can be ".bz2" or ".xz"
@@ -58,12 +61,14 @@ iterator = jsonl.load(path)
 print(tuple(iterator))
 ```
 
-#### Load a file from an open file object.
+#### Load a file from an open file object
 
 !!! tip
     This is useful when you need to load a file from a custom source.
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 path = "file.jsonl"
@@ -83,12 +88,14 @@ with open(path) as fp:
     print(tuple(iterator))
 ```
 
-#### Load from a URL.
+#### Load from a URL
 
 You can load a JSON Lines directly from a URL incrementally, if needed you can also create custom 
 requests using `urllib.request.Request`.
 
 ```python
+# -*- coding: utf-8 -*-
+
 import urllib.request
 import jsonl
 
@@ -102,13 +109,15 @@ iterator = jsonl.load(req)
 print(tuple(iterator))
 ```
 
-#### Load a file containing broken lines.
+#### Load a file containing broken lines
 
 !!! warning
     If the **broken** parameter is set to `False`, the function will raise an `Exception` when it encounters a broken line.
     If set to `True`, the function will skip the broken line, continue reading the file, and log a warning message.
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 # Create a file with broken JSON lines
@@ -124,12 +133,12 @@ print(tuple(iterator))
 
 *Output:*
 
-```console
+```text
 WARNING:root:Broken line at 2: Expecting ',' delimiter: line 2 column 1 (char 28)
 ({'name': 'Gilbert', 'wins': [['straight', '7♣'], ['one pair', '10♥']]}, {'name': 'Richard', 'wins': []})
 ```
 
-#### Load a file using a custom deserialization.
+#### Load a file using a custom deserialization
 
 The `json_loads` parameter allows for custom deserialization and must take a JSON-formatted
 string as input and return a Python object.
@@ -141,13 +150,15 @@ string as input and return a Python object.
 The following example demonstrates how to use the `json_loads` parameter to deserialize the data
 using the `orjson` and `ujson` libraries. Make sure to install these libraries to run the example.
 
-```console
+```bash
 pip install orjson ujson # Ignore this command if these libraries are already installed.
 ```
 
 Now, you can use these libraries to load the JSON lines:
 
 ```python
+# -*- coding: utf-8 -*-
+
 import orjson
 import ujson
 
@@ -174,11 +185,13 @@ print(tuple(iterator1))
 print(tuple(iterator2))
 ```
 
-#### Load a file using a custom opener.
+#### Load a file using a custom opener
 
 The `opener` parameter allows loading files from custom sources, such as a ZIP archive. Here’s how to use it:
 
 ```python
+# -*- coding: utf-8 -*-
+
 import zipfile
 
 import jsonl

docs/load_archive.md

@@ -8,14 +8,16 @@ Allows to load multiple JSON Lines **(.jsonl)** files incrementally from a **ZIP
 - Filename filtering using Unix shell-style wildcards via `fnmatch`. Use a pattern (e.g., *.jsonl) to selectively load
   only matching files within the archive.
 - Support for both compressed and uncompressed `.jsonl` files inside the archive. (e.g., `*.jsonl.gz` or `*.jsonl.bz2`
-  or `*.jsonl.xz` **(Check [note](load.md#note-compression) for more details)**.
+  or `*.jsonl.xz`) **Check [note](load.md#note-compression) for more details**.
 - Graceful handling of malformed or broken lines.
 - Optional custom deserialization and opener callbacks for advanced use cases.
 
 
 **Load from a local archive**
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 path = "path/to/archive.zip"
@@ -30,6 +32,8 @@ for filename, iterator in jsonl.load_archive(path):
 You can load the archive from a URL, if needed you can also create custom requests using `urllib.request.Request`.
 
 ```python
+# -*- coding: utf-8 -*-
+
 import urllib.request
 
 import jsonl
@@ -63,6 +67,8 @@ For more information, refer to the [fnmatch documentation](https://docs.python.o
 
 
 ```python
+# -*- coding: utf-8 -*-
+
 import jsonl
 
 path = "path/to/archive.zip"

jsonl.py

@@ -215,7 +215,7 @@ def dumper(iterable, /, *, text_mode=True, json_dumps=None, **json_dumps_kwargs)
 
 
 def loader(stream, broken, /, *, json_loads=None, **json_loads_kwargs):
-    """Load a JSON Lines formatted stream into an iterable of Python objects."""
+    """Load a JSON Lines formatted stream into an object iterator."""
 
     deserialize = functools.partial(json_loads or _default_json_loads, **json_loads_kwargs)
     for lineno, line in enumerate(stream, start=1):