Реализация загрузки данных на сервер средствами Python

Альтернативные сценарии

Как загрузить несколько файлов одновременно?

Для отправки нескольких файлов используется один и тот же ключ для всех файлов, либо разные ключи. Сервер получает их через request.files.getlist('files').

# Сервер
from werkzeug.utils import secure_filename

@app.route('/upload_multiple', methods=['POST'])
def upload_multiple():
    if 'files' not in request.files:
        return 'No files', 400
    files = request.files.getlist('files')
    saved_names = []
    for f in files:
        if f.filename:
            filename = secure_filename(f.filename)
            f.save(os.path.join(UPLOAD_FOLDER, filename))
            saved_names.append(filename)
    return jsonify({'files': saved_names})

Url запрос python (работа с url в python)

# Клиент (отправка двух файлов)
import requests
url = 'http://127.0.0.1:5000/upload_multiple'
files = [('files', open('a.txt', 'rb')), ('files', open('b.txt', 'rb'))]
r = requests.post(url, files=files)
print(r.json())

Python urllib request (отправка запросов с помощью urllib.request в python)

Как передать вместе с файлом дополнительные поля (например, описание)?

В клиенте передаются два отдельных словаря: files и data. Сервер получает поля из request.form.

# Клиент
files = {'file': open('photo.jpg', 'rb')}
data = {'description': 'Отпуск 2024'}
r = requests.post(url, files=files, data=data)

# Сервер
@app.route('/upload_with_desc', methods=['POST'])
def upload_with_desc():
    desc = request.form.get('description', '')
    file = request.files['file']
    # ... сохранение и возврат результата

Files upload python (загрузка файлов на сервер с помощью python (requests, flask))

Как ограничить размер и тип загружаемого файла на сервере?

Flask позволяет установить MAX_CONTENT_LENGTH. Для проверки типа используется свойство content_type или библиотека python-magic для определения MIME-типа по содержимому.

app.config['MAX_CONTENT_LENGTH'] = 16 * 1024 * 1024  # 16 MB

ALLOWED_EXTENSIONS = {'png', 'jpg', 'jpeg', 'gif'}

def allowed_file(filename):
    return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS

@app.route('/upload_restricted', methods=['POST'])
def upload_restricted():
    file = request.files.get('file')
    if not file or not allowed_file(file.filename):
        return 'Invalid file type', 400
    # дополнительная проверка MIME по магии
    import magic
    mime = magic.from_buffer(file.read(2048), mime=True)
    if mime not in ['image/png', 'image/jpeg']:
        return 'Content type not allowed', 400
    file.seek(0)  # вернуть указатель в начало
    # сохранение...

Python requests method (методы http-запросов в python (get, post, put, delete) с requests)

Как обрабатывать большие файлы без полной загрузки в память?

По умолчанию Flask загружает весь файл в память, если размер превышает порог (по умолчанию 500 KB). Для потоковой обработки можно работать с request.stream и сохранять данные частями.

@app.route('/upload_stream', methods=['POST'])
def upload_stream():
    # Используем request.stream для чтения по частям
    with open('output.bin', 'wb') as f:
        while True:
            chunk = request.stream.read(8192)
            if not chunk:
                break
            f.write(chunk)
    return 'Stream uploaded', 200

Python request data (извлечение данных из http-запроса (request) в python)

Клиент отправляет файл обычным способом, но сервер не вызывает file.save(), а читает сырой поток.

Как загрузить файл из браузера (HTML-форма) и обработать на сервере?

Сервер остаётся тем же. клиент - HTML-страница с формой и атрибутом enctype="multipart/form-data". Python requests может имитировать такую отправку.

На сервере обработка идентична примеру из базового решения.