file-upload [ATILLO] (from docs)

.gitignore

@@ -0,0 +1,2 @@
+venv
+.env

app.py

@@ -0,0 +1,30 @@
+import os
+import logging
+from flask import Flask
+from flask_sqlalchemy import SQLAlchemy
+from config import Config
+
+# Initialize Flask App
+app = Flask(__name__)
+app.config.from_object(Config)
+
+# Initialize database
+db = SQLAlchemy(app)
+
+# Configure logging
+os.makedirs(app.config['LOG_FOLDER'], exist_ok = True)
+logging.basicConfig(
+    filename=f"{app.config['LOG_FOLDER']}/app.log",
+    level = logging.INFO,
+    format = '%(asctime)s [%(levelname)s] %(message)s'
+)
+
+# Register blueprints
+from controllers.file_controller import file_bp
+
+app.register_blueprint(file_bp)
+# Create tables if not exist
+with app.app_context():
+    db.create_all()
+if __name__ == '__main__':
+    app.run(debug=True)

config.py

@@ -0,0 +1,14 @@
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+
+class Config:
+    SQLALCHEMY_DATABASE_URI = (
+        f"mysql+pymysql://{os.getenv('DB_USER')}:{os.getenv('DB_PASSWORD')}@"
+        f"{os.getenv('DB_HOST')}:{os.getenv('DB_PORT')}/{os.getenv('DB_NAME')}"
+    )
+    SQLALCHEMY_TRACK_MODIFICATIONS = False
+    UPLOAD_FOLDER = os.getenv('UPLOAD_FOLER', 'uploads')
+    LOG_FOLDER = 'logs'
+    DEBUG = True

controllers/file_controller.py

@@ -0,0 +1,64 @@
+import uuid
+from flask import Blueprint, request, jsonify, send_file
+from services.file_service import save_file, update_file, delete_file
+from models.uploaded_file import UploadedFile
+from app import app
+import logging
+
+file_bp = Blueprint('file_bp', __name__)
+
+# 🟢 POST — Upload file
+@file_bp.route('/upload', methods=['POST'])
+def upload_file():
+    try:
+        if 'file' not in request.files:
+            return jsonify({'message': 'No file uploaded'}), 400
+
+        file = request.files['file']
+        folder = f"{app.config['UPLOAD_FOLDER']}/{uuid.uuid4().hex}" # new  folder per request
+        uploaded = save_file(file, folder)
+        return jsonify({'message': 'Upload successful', 'id': uploaded.id, 'path': uploaded.file_path}), 201
+
+    except Exception as e:
+        logging.error(f"Upload error: {e}")
+        return jsonify({'message': str(e)}), 400
+
+
+# 🟡 GET — Retrieve file info or download
+@file_bp.route('/file/<int:file_id>', methods=['GET'])
+def get_file(file_id):
+    try:
+        file = UploadedFile.query.get(file_id)
+        if not file:
+            return jsonify({'message': 'File not found'}), 404
+
+        # You can test using Postman → GET http://localhost:5000/file/<id>
+        return send_file(file.file_path, as_attachment=True)
+    except Exception as e:
+        logging.error(f"Get error: {e}")
+    return jsonify({'message': str(e)}), 400
+
+# 🟠 PUT — Update file
+@file_bp.route('/file/<int:file_id>', methods=['PUT'])
+def update_existing_file(file_id):
+    try:
+        if 'file' not in request.files:
+            return jsonify({'message': 'No file provided'}), 400
+        file = request.files['file']
+        updated = update_file(file_id, file, app.config['UPLOAD_FOLDER'])
+        return jsonify({'message': 'File updated successfully', 'path': updated.file_path}), 200
+
+    except Exception as e:
+        logging.error(f"Update error: {e}")
+        return jsonify({'message': str(e)}), 400
+
+# 🔴 DELETE — Delete file
+@file_bp.route('/file/<int:file_id>', methods=['DELETE'])
+def delete_existing_file(file_id):
+    try:
+        delete_file(file_id)
+        return jsonify({'message': 'File deleted successfully'}), 200
+
+    except Exception as e:
+        logging.error(f"Delete error: {e}")
+        return jsonify({'message': str(e)}), 400

models/uploaded_file.py

@@ -0,0 +1,6 @@
+from app import db
+
+class UploadedFile(db.Model):
+    id = db.Column(db.Integer, primary_key = True)
+    filename = db.Column(db.String(255), nullable = False)
+    file_path = db.Column(db.String(255), nullable = False)

requirements.txt

@@ -0,0 +1,12 @@
+blinker==1.9.0
+click==8.3.0
+Flask==3.1.2
+Flask-SQLAlchemy==3.1.1
+itsdangerous==2.2.0
+Jinja2==3.1.6
+MarkupSafe==3.0.3
+PyMySQL==1.1.2
+python-dotenv==1.1.1
+SQLAlchemy==2.0.44
+typing_extensions==4.15.0
+Werkzeug==3.1.3

services/file_service.py

@@ -0,0 +1,49 @@
+import os
+import uuid
+from werkzeug.utils import secure_filename
+from models.uploaded_file import UploadedFile
+from app import db
+import logging
+ALLOWED_EXTENSIONS = {'png', 'jpg', 'jpeg', 'pdf', 'txt'}
+def allowed_file(filename):
+    return '.' in filename and filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
+def save_file(file, base_folder):
+    if not allowed_file(file.filename):
+        raise ValueError('File type not allowed')
+
+    os.makedirs(base_folder, exist_ok=True)
+    filename = secure_filename(file.filename)
+    unique_name = f"{uuid.uuid4().hex}_{filename}"
+    save_path = os.path.join(base_folder, unique_name)
+    file.save(save_path)
+    new_file = UploadedFile(filename=unique_name, file_path=save_path)
+    db.session.add(new_file)
+    db.session.commit()
+    logging.info(f"File saved: {save_path}")
+    return new_file
+
+def update_file(file_id, new_file, base_folder):
+    existing = UploadedFile.query.get(file_id)
+    if not existing:
+        raise ValueError('File not found')
+    if os.path.exists(existing.file_path):
+        os.remove(existing.file_path)
+
+    new_record = save_file(new_file, base_folder)
+    existing.filename = new_record.filename
+    existing.file_path = new_record.file_path
+    db.session.commit()
+    logging.info(f"File updated: ID={file_id}")
+    return existing
+
+def delete_file(file_id):
+    file_record = UploadedFile.query.get(file_id)
+    if not file_record:
+        raise ValueError('File not found')
+    if os.path.exists(file_record.file_path):
+        os.remove(file_record.file_path)
+        logging.info(f"File deleted from storage: {file_record.file_path}")
+
+    db.session.delete(file_record)
+    db.session.commit()
+    logging.info(f"Record deleted: ID={file_id}")