feat: csv to ndjson converter script ✨

Author: leftkats

CSV_TO_NDJSON/README.md

@@ -0,0 +1,38 @@
+# README.md
+
+# CSV to NDJSON Converter
+
+This Python script converts a CSV file located in this folder into an NDJSON file saved in the same folder.
+
+## What is NDJSON?
+
+NDJSON (Newline Delimited JSON) is a convenient format for streaming JSON objects, where each line is a valid JSON object.  
+It’s widely used in data pipelines and tools such as **Google Cloud BigQuery**, **ElasticSearch**, and many other data processing platforms.
+
+## How to use
+
+1. Place your CSV file in this folder.
+2. Make sure you have Python 3 installed.
+3. Run the script from this folder with:
+
+   ```bash
+   python csv_to_ndjson.py input.csv output.ndjson
+
+
+#### Example 
+If you have a CSV file like this:
+
+```csv
+name,age,city
+Alice,30,New York
+Bob,25,Los Angeles
+```
+
+The output NDJSON will be:
+
+```json
+{"name":"Alice","age":"30","city":"New York"}
+{"name":"Bob","age":"25","city":"Los Angeles"}
+```
+
+Feel free to modify or extend it as needed.

CSV_TO_NDJSON/csv_to_ndjson.py

@@ -0,0 +1,39 @@
+# csv_to_ndjson.py
+import csv
+import json
+import sys
+import os
+
+
+def csv_to_ndjson(csv_filename, ndjson_filename):
+    base_dir = os.path.dirname(os.path.abspath(__file__))
+
+    csv_path = os.path.join(base_dir, csv_filename)
+    ndjson_path = os.path.join(base_dir, ndjson_filename)
+
+    try:
+        with (
+            open(csv_path, mode="r", encoding="utf-8") as f_csv,
+            open(ndjson_path, mode="w", encoding="utf-8") as f_ndjson,
+        ):
+            reader = csv.DictReader(f_csv)
+            for row in reader:
+                f_ndjson.write(
+                    json.dumps(row, ensure_ascii=False, separators=(",", ":")) + "\n"
+                )
+
+        print(f"Successfully converted '{csv_path}' to '{ndjson_path}'")
+
+    except FileNotFoundError:
+        print(f"Error: CSV file '{csv_path}' not found.")
+    except Exception as e:
+        print(f"An error occurred: {e}")
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("Usage: python csv_to_ndjson.py input.csv output.ndjson")
+    else:
+        csv_file = sys.argv[1]
+        ndjson_file = sys.argv[2]
+        csv_to_ndjson(csv_file, ndjson_file)