**Changed:** Documentation - Update the examples with json.dump and json.load by passing additional keyword arguments.

Author: rmoralespp

CHANGELOG.md

@@ -1,5 +1,6 @@
 ## Releases
 
+- **Changed:** Documentation - Update the examples with `json.dump` and `json.load` by passing additional keyword arguments.
 - **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.

docs/dump.md

@@ -1,6 +1,6 @@
 # Dump an iterable to a JSON Lines file incrementally.
 
-Dump JSON Lines (jsonl) files incrementally, supporting both uncompressed and compressed formats and allowing
+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
@@ -133,6 +133,8 @@ jsonl.dump(data, MyCustomFile2(), text_mode=True)
 
 #### Dump data with a custom serialization
 
+##### Passing a `json_dumps` function
+
 The `json_dumps` parameter allows for custom serialization and must take a Python object and return a
 JSON-formatted string.
 
@@ -161,8 +163,27 @@ jsonl.dump(data, "foo.jsonl", json_dumps=ujson.dumps, ensure_ascii=False)
 
 # Dump the data using the orjson library.
 jsonl.dump(data, "var.jsonl", json_dumps=orjson.dumps)
-
-# Dumping data into a JSON file with compact output using separators (',', ':')
-# to remove unnecessary whitespaces.
-jsonl.dump(data, "bar.jsonl", separators=(',', ':'))
 ```
+
+##### Passing additional keyword arguments
+
+The  `jsonl.dump` function accepts additional keyword arguments that are passed directly to the underlying
+serialization function (by default, `json.dumps`). This allows for customization of the serialization process,
+such as controlling indentation, sorting keys, or handling special data types.
+
+Here’s an example that demonstrates how to use additional keyword arguments to customize the JSON serialization:
+
+```python
+# -*- coding: utf-8 -*-
+
+import json
+
+import jsonl
+
+data = [
+    {"name": "Gilbert", "wins": [["straight", "7♣"], ["one pair", "10♥"]]},
+    {"name": "May", "wins": []},
+]
+# Dump the data with compact separators to minimize file size.
+jsonl.dump(data, "compact.jsonl", separators=(',', ':'))
+```

docs/load.md

@@ -1,4 +1,4 @@
-# Load JSON Lines files 
+# Load JSON Lines files
 
 Load JSON Lines **(jsonl)** files incrementally, supporting both uncompressed and compressed formats, handling broken
 lines, and allowing custom deserialization and opener callbacks.
@@ -45,7 +45,7 @@ Check [note](#note-compression) for more details
 
 import jsonl
 
-path = "file.jsonl.gz" # gzip compressed file, but it can be ".bz2" or ".xz"
+path = "file.jsonl.gz"  # gzip compressed file, but it can be ".bz2" or ".xz"
 
 # Example data to save in the file
 data = [
@@ -90,7 +90,7 @@ with open(path) as fp:
 
 #### Load from a URL
 
-You can load a JSON Lines directly from a URL incrementally, if needed you can also create custom 
+You can load a JSON Lines directly from a URL incrementally, if needed you can also create custom
 requests using `urllib.request.Request`.
 
 ```python
@@ -140,6 +140,8 @@ WARNING:root:Broken line at 2: Expecting ',' delimiter: line 2 column 1 (char 28
 
 #### Load a file using a custom deserialization
 
+##### Passing a `json_loads` function
+
 The `json_loads` parameter allows for custom deserialization and must take a JSON-formatted
 string as input and return a Python object.
 
@@ -185,6 +187,37 @@ print(tuple(iterator1))
 print(tuple(iterator2))
 ```
 
+##### Passing additional keyword arguments
+
+The  `jsonl.load` function also accepts additional keyword arguments that are passed to the underlying
+JSON deserialization function (by default, `json.loads`). This is useful when you want to customize the behavior of the
+deserialization
+
+Here’s an example using the built-in `json` module to parse float values as `decimal.Decimal`:
+
+```python
+# -*- coding: utf-8 -*-
+
+import decimal
+
+import jsonl
+
+path = "file.jsonl"
+
+# Example data to save in the file with `float` values
+data = [
+    {"name": "Gilbert", "wins_avg": 2.5},
+    {"name": "May", "wins_avg": 3.75},
+]
+
+# Save the data to the jsonl file
+jsonl.dump(data, path)
+
+# Load the data back, parsing `float` values as `decimal.Decimal` using the `parse_float` keyword argument
+iterator = jsonl.load(path, parse_float=decimal.Decimal)
+print(tuple(iterator))
+```
+
 #### 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: