Web и API

Загрузить файл на HTTP-эндпоинт

Отправляет файл multipart-запросом с дополнительными полями формы.

Python Windows macOS Linux Средний
Скачать file_upload.py
Описание

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

Скрипт проверяет файл, определяет MIME-тип и отправляет multipart POST на указанный эндпоинт. Поля формы можно добавить несколько раз через --form, ответ печатается как JSON или текст. Предназначен для собственных тестовых API и локальных загрузчиков.

Перед запуском
  • Загружайте файлы только на собственный сервер или тестовый эндпоинт.
Запуск

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

python file_upload.py http://127.0.0.1:8000/upload --file ./demo.txt

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

Примеры

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

  • python file_upload.py http://127.0.0.1:8000/upload --file report.pdf --form user=demo
  • python file_upload.py https://example.com/api/upload --file image.png --field image --timeout 30
Зависимости

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

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Python-пакет requests HTTP-клиент для Python
Windows py -m pip install requests
macOS python3 -m pip install requests
Linux python3 -m pip install requests
Исходник

file_upload.py

#!/usr/bin/env python3
"""Multipart-загрузка файла."""
from __future__ import annotations

import argparse
import json
import mimetypes
from pathlib import Path

import requests


def main() -> int:
    parser = argparse.ArgumentParser(description="Загрузить файл на HTTP-эндпоинт")
    parser.add_argument("url", help="Адрес загрузки")
    parser.add_argument("--file", type=Path, required=True, help="Файл для отправки")
    parser.add_argument("--field", default="file", help="Имя файлового поля")
    parser.add_argument("--form", action="append", default=[], metavar="KEY=VALUE")
    parser.add_argument("--timeout", type=float, default=30.0)
    parser.add_argument("--output", type=Path, help="Сохранить ответ")
    args = parser.parse_args()

    path = args.file.expanduser()
    if not path.is_file():
        parser.error(f"Файл не найден: {path}")
    if path.stat().st_size == 0:
        parser.error("Нельзя отправить пустой файл")

    data = {}
    for item in args.form:
        if "=" not in item:
            parser.error(f"Поле формы должно быть KEY=VALUE: {item}")
        key, value = item.split("=", 1)
        data[key] = value

    mime = mimetypes.guess_type(path.name)[0] or "application/octet-stream"
    print(f"Файл: {path} ({path.stat().st_size} байт, {mime})")
    print(f"Эндпоинт: {args.url}")
    try:
        with path.open("rb") as handle:
            files = {args.field: (path.name, handle, mime)}
            response = requests.post(args.url, files=files, data=data, timeout=args.timeout)
    except requests.RequestException as error:
        print(f"Ошибка загрузки: {error}")
        return 2

    print(f"Статус: {response.status_code}")
    print(f"Content-Type: {response.headers.get('Content-Type', 'не указан')}")
    if args.output:
        args.output.write_bytes(response.content)
        print(f"Сохранено: {args.output}")

    content_type = response.headers.get("Content-Type", "").lower()
    if "json" in content_type:
        try:
            print(json.dumps(response.json(), ensure_ascii=False, indent=2)[:8000])
        except ValueError:
            print(response.text[:2000])
    else:
        print(response.text[:2000])
    return 0 if response.ok else 1


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

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

CLI 1.0.0

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

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

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

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

Категория

Web и API

HTTP, API, сайты, заголовки, SSL и проверка веб-сервисов.