Данные и таблицы

Превратить CSV в JSON

Собирает JSON-массив, объект по ключу или JSONL из строк CSV и умеет приводить типы.

Python Windows macOS Linux Новичок
Скачать csv_to_json.py
Описание

Что делает скрипт

По умолчанию все значения остаются строками, чтобы не потерять ведущие нули. С флагом --typed скрипт распознаёт целые числа, дробные числа, true/false и null. Формат array даёт массив объектов, object требует ключевую колонку, lines пишет по объекту на строку. Исходный CSV не меняется.

Перед запуском
  • С --typed значения вида 007 могут превратиться в число 7. Не используйте его для артикулов.
Запуск

Быстрый старт

python csv_to_json.py --input data.csv --output data.json

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python csv_to_json.py --input users.csv --format object --key id
  • python csv_to_json.py --input events.csv --format lines --typed --output events.jsonl
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

csv_to_json.py

#!/usr/bin/env python3
"""Преобразование CSV в JSON."""
from __future__ import annotations

import argparse
import csv
import json
import re
from pathlib import Path


def convert_value(value: str):
    text = value.strip()
    if text == "":
        return ""
    lowered = text.casefold()
    if lowered in {"true", "false"}:
        return lowered == "true"
    if lowered in {"null", "none"}:
        return None
    if re.fullmatch(r"[+-]?\d+", text):
        try:
            return int(text)
        except ValueError:
            return value
    if re.fullmatch(r"[+-]?(?:\d+\.\d*|\d*\.\d+)(?:[eE][+-]?\d+)?", text):
        try:
            return float(text)
        except ValueError:
            return value
    return value


def main() -> int:
    parser = argparse.ArgumentParser(description="CSV в JSON")
    parser.add_argument("--input", type=Path, required=True, help="Исходный CSV")
    parser.add_argument("--output", type=Path, help="Результат, по умолчанию data.json или data.jsonl")
    parser.add_argument("--format", choices=["array", "object", "lines"], default="array", help="Формат JSON")
    parser.add_argument("--key", default="", help="Колонка ключа для формата object")
    parser.add_argument("--typed", action="store_true", help="Приводить числа и логические значения")
    parser.add_argument("--delimiter", default=",", help="Разделитель колонок")
    parser.add_argument("--force", action="store_true", help="Перезаписать выходной файл")
    args = parser.parse_args()

    source = args.input.expanduser().resolve()
    suffix = ".jsonl" if args.format == "lines" else ".json"
    target = (args.output or Path(f"data{suffix}")).expanduser().resolve()
    if not source.is_file():
        parser.error(f"Файл не найден: {source}")
    if source == target:
        parser.error("Выходной файл не должен совпадать с исходным")
    if target.exists() and not args.force:
        parser.error(f"Файл уже существует: {target}. Добавьте --force")
    if len(args.delimiter) != 1:
        parser.error("Разделитель должен состоять из одного символа")
    if args.format == "object" and not args.key:
        parser.error("Для формата object укажите --key")

    with source.open("r", encoding="utf-8-sig", newline="") as handle:
        reader = csv.DictReader(handle, delimiter=args.delimiter)
        if reader.fieldnames is None:
            parser.error("Не удалось прочитать заголовок")
        if args.format == "object" and args.key not in reader.fieldnames:
            parser.error(f"Нет колонки ключа: {args.key}")
        records = []
        for row in reader:
            record = {key: (convert_value(value) if args.typed else value) for key, value in row.items()}
            records.append(record)

    target.parent.mkdir(parents=True, exist_ok=True)
    if args.format == "lines":
        with target.open("w", encoding="utf-8") as handle:
            for record in records:
                handle.write(json.dumps(record, ensure_ascii=False) + "\n")
    elif args.format == "object":
        output = {}
        for record in records:
            output[str(record[args.key])] = record
        target.write_text(json.dumps(output, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
    else:
        target.write_text(json.dumps(records, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")

    print(f"Записей: {len(records)}")
    print(f"Формат: {args.format}")
    print(f"Результат: {target}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get data-csv-to-json
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Данные и таблицы

CSV, JSON, SQLite, Excel, очистка, объединение и отчёты.