Загрузить файл на HTTP-эндпоинт
Отправляет файл multipart-запросом с дополнительными полями формы.
Что делает скрипт
Скрипт проверяет файл, определяет 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=demopython file_upload.py https://example.com/api/upload --file image.png --field image --timeout 30
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install requests
python3 -m pip install requests
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.