Pushed basic skeleton, will test it further and update it.

Author: JavierLuna

Diff for: .gitignore

@@ -99,3 +99,6 @@ ENV/
 
 # mypy
 .mypy_cache/
+
+# sqlite files
+*.sqlite

Diff for: app/__init__.py

@@ -0,0 +1,26 @@
+from flask import Flask
+from flask_marshmallow import Marshmallow
+from flask_sqlalchemy import SQLAlchemy
+
+from config import config
+
+db = SQLAlchemy()
+ma = Marshmallow()
+
+
+def create_app(config_name='default'):
+	app = Flask(__name__, static_folder='./static')
+	app.config.from_object(config[config_name])
+	config[config_name].init_app(app)
+
+	# Plugins initialization goes here
+	db.init_app(app)
+	ma.init_app(app)
+
+	from .views import views as views_blueprint
+	app.register_blueprint(views_blueprint)
+
+	from .api.v1 import api_v1 as api_v1_blueprint
+	app.register_blueprint(api_v1_blueprint, url_prefix='/api/v1')
+
+	return app

Diff for: app/api/__init__.py

@@ -0,0 +1 @@
+from . import v1

Diff for: app/api/v1/__init__.py

@@ -0,0 +1,20 @@
+from flask import Blueprint, g
+from flask_httpauth import HTTPTokenAuth
+
+from app.models.user import User
+
+api_v1 = Blueprint('v1', __name__)
+auth_v1 = HTTPTokenAuth(scheme='Token')
+
+
+@auth_v1.verify_token
+def verify_token(token):
+	user = User.verify_auth_token(token)
+	if user:
+		g.user = user
+		g.token = token
+		return True
+	return False
+
+
+from . import auth, father, son, errors

Diff for: app/api/v1/auth/__init__.py

@@ -0,0 +1 @@
+from . import views

Diff for: app/api/v1/auth/schemas.py

@@ -0,0 +1,8 @@
+from marshmallow import fields
+
+from app import ma
+
+
+class LoginUserSchema(ma.Schema):
+	email = fields.Email(required=True)
+	password = fields.Str(required=True)

Diff for: app/api/v1/auth/views.py

@@ -0,0 +1,25 @@
+from flask import request, abort
+from app.api.v1.exceptions import ValidationError
+from app.api.v1.utils import json
+from app.models.user import User
+from .schemas import LoginUserSchema
+from .. import api_v1
+
+
+
+
+@api_v1.route('/auth/login', methods=['POST'])
+@json
+def auth_login():
+	json_data = request.get_json()
+	if not json_data:
+		abort(400)
+	schema = LoginUserSchema()
+	result = schema.load(json_data)
+	if result.errors:
+		raise ValidationError(result.errors)
+	user = User.query.filter_by(email=result.data['email']).first()
+	if user is not None and user.verify_password(result.data['password']):
+		return {'token': user.generate_auth_token().decode('ascii')}
+	else:
+		abort(401)

Diff for: app/api/v1/errors.py

@@ -0,0 +1,45 @@
+from app.api.v1 import api_v1, auth_v1
+from app.api.v1.exceptions import ValidationError
+from app.api.v1.utils import json
+
+
+@api_v1.errorhandler(400)
+@json
+def bad_request(e):
+	return {'error': 'Bad request, did you include all the data correctly?'}, 400
+
+
+@api_v1.errorhandler(401)
+@json
+def unauthorized(e):
+	return {'error': 'Unauthorized, did not provide proper auth credentials'}, 401
+
+
+@api_v1.errorhandler(404)
+@json
+def not_found(e):
+	return {'error': 'Not found'}, 404
+
+
+@api_v1.errorhandler(405)
+@json
+def not_allowed(e):
+	return {'error': 'Method not allowed'}, 405
+
+
+@api_v1.errorhandler(500)
+@json
+def internal_server_error(e):
+	return {'error': 'Internal server error'}, 500
+
+
+@api_v1.errorhandler(ValidationError)
+@json
+def validation_error(e):
+	return {'error': 'Bad request, did you include all the data correctly?', 'info': e.info}, 400
+
+
+@auth_v1.error_handler
+@json
+def auth_error():
+	return {'error': 'Unauthorized, did not provide proper auth credentials'}, 401

Diff for: app/api/v1/exceptions.py

@@ -0,0 +1,3 @@
+class ValidationError(Exception):
+	def __init__(self, info):
+		self.info = info

Diff for: app/api/v1/father/__init__.py

@@ -0,0 +1 @@
+from . import views

Diff for: app/api/v1/father/schemas.py

@@ -0,0 +1,9 @@
+from app import ma
+from app.models.father import Father
+
+
+class FatherSchema(ma.ModelSchema):
+	class Meta:
+		model = Father
+		dump_only = ('id',)
+		exclude = ('sons',)

Diff for: app/api/v1/father/views.py

@@ -0,0 +1,37 @@
+from app.api.v1 import api_v1, auth_v1
+from app.api.v1.father.schemas import FatherSchema
+from app.api.v1.utils import paginate, detail, create, partialupdate, delete
+from app.models.father import Father
+
+
+@api_v1.route('/father', methods=['GET'])
+@paginate(FatherSchema)
+def list_fathers():
+	return Father.query
+
+
+@api_v1.route('/father/<int:id>', methods=['GET'])
+@detail(FatherSchema)
+def detail_father(id):
+	return Father.query.get_or_404(id)
+
+
+@api_v1.route('/father', methods=['POST'])
+@auth_v1.login_required
+@create(FatherSchema)
+def create_father():
+	pass
+
+
+@api_v1.route('/father/<int:id>', methods=['PATCH'])
+@auth_v1.login_required
+@partialupdate(FatherSchema)
+def update_father(id):
+	return Father.query.get_or_404(id)
+
+
+@api_v1.route('/father/<int:id>', methods=['DELETE'])
+@auth_v1.login_required
+@delete
+def delete_father(id):
+	return Father.query.get_or_404(id)

Diff for: app/api/v1/son/__init__.py

@@ -0,0 +1 @@
+from . import views

Diff for: app/api/v1/son/schemas.py

@@ -0,0 +1,13 @@
+from marshmallow import fields
+
+from app import ma
+from app.api.v1.father.schemas import FatherSchema
+from app.models.son import Son
+
+
+class SonSchema(ma.ModelSchema):
+	father = fields.Nested(FatherSchema, dump_only=True)
+
+	class Meta:
+		model = Son
+		dump_only = ('id',)

Diff for: app/api/v1/son/views.py

@@ -0,0 +1,46 @@
+from flask import request
+
+from app.api.v1 import api_v1, auth_v1
+from app.api.v1.son.schemas import SonSchema
+from app.api.v1.utils import paginate, detail, create, partialupdate, delete
+from app.models.father import Father
+from app.models.son import Son
+
+
+@api_v1.route('/son', methods=['GET'])
+@paginate(SonSchema)
+def list_sons():
+	return Son.query
+
+
+@api_v1.route('/son/<int:id>', methods=['GET'])
+@detail(SonSchema)
+def detail_son(id):
+	return Son.query.get_or_404(id)
+
+
+def pair_with_father(son_object):
+	request_json = request.get_json()
+	if request_json['father']:
+		son_object.father = Father.query.get_or_404(int(request_json['father']))
+
+
+@api_v1.route('/son', methods=['POST'])
+@auth_v1.login_required
+@create(SonSchema, after_function=pair_with_father)
+def create_son():
+	pass
+
+
+@api_v1.route('/son/<int:id>', methods=['PATCH'])
+@auth_v1.login_required
+@partialupdate(SonSchema)
+def update_son(id):
+	return Son.query.get_or_404(id)
+
+
+@api_v1.route('/son/<int:id>', methods=['DELETE'])
+@auth_v1.login_required
+@delete
+def delete_son(id):
+	return Son.query.get_or_404(id)

Diff for: app/api/v1/utils.py

@@ -0,0 +1,109 @@
+from functools import wraps
+
+from flask import jsonify, request, current_app, abort
+from marshmallow import ValidationError
+from sqlalchemy.exc import IntegrityError
+
+from app import db
+
+
+def json(f):
+	@wraps(f)
+	def wrapped(*args, **kwargs):
+		rv = f(*args, **kwargs)
+		code = 200
+		if isinstance(rv, tuple):
+			code = rv[1]
+			rv = rv[0]
+		return jsonify(rv), code
+
+	return wrapped
+
+
+def paginate(schema):
+	def inception(f):
+		@wraps(f)
+		def wrapped(*args, **kwargs):
+			s = schema(many=True)
+			page = request.args.get('page', 1, type=int)
+			rv = f(*args, **kwargs)
+			paginator = rv.paginate(page, per_page=current_app.config['RESULTS_PER_API_CALL'], error_out=False)
+			resulting_data = {'objects': s.dump(paginator.items, many=True).data,
+			                  'next_page': paginator.next_num if paginator.has_next else None,
+			                  'prev_page': paginator.prev_num if paginator.has_prev else None,
+			                  'pages': paginator.pages,
+			                  'total_objects': paginator.total}
+			return jsonify(resulting_data)
+
+		return wrapped
+
+	return inception
+
+
+def detail(schema):
+	def inception(f):
+		@wraps(f)
+		def wrapped(*args, **kwargs):
+			s = schema()
+			instance = f(*args, **kwargs)
+			return jsonify(s.dump(instance).data)
+
+		return wrapped
+
+	return inception
+
+
+def create(schema, after_function=None):
+	def inception(f):
+		@wraps(f)
+		def wrapped(*args, **kwargs):
+			s = schema()
+			raw_data = request.get_json()
+			result = s.load(raw_data)
+			if result.errors:
+				raise ValidationError(result.errors)
+			new_object = result.data
+			if after_function is not None:
+				after_function(new_object)
+			db.session.add(new_object)
+			try:
+				db.session.commit()
+				return jsonify(s.dump(new_object).data), 201
+			except IntegrityError:
+				db.session.rollback()
+				abort(500)
+
+		return wrapped
+
+	return inception
+
+
+def partialupdate(schema, after_function=None):
+	def inception(f):
+		@wraps(f)
+		def wrapped(*args, **kwargs):
+			s = schema()
+			raw_data = request.get_json()
+			instance = f(*args, **kwargs)
+			result = s.load(raw_data, instance=instance)
+			if result.errors:
+				raise ValidationError(result.errors)
+			new_object = result.data
+			if after_function is not None:
+				after_function(new_object)
+			return jsonify(s.dump(result.data).data)
+
+		return wrapped
+
+	return inception
+
+
+def delete(f):
+	@wraps(f)
+	def wrapped(*args, **kwargs):
+		instance = f(*args, **kwargs)
+		db.session.delete(instance)
+		db.session.commit()
+		return '', 204
+
+	return wrapped

Diff for: app/models/__init__.py

@@ -0,0 +1 @@
+from . import father, son, user

Diff for: app/models/father.py

@@ -0,0 +1,10 @@
+from app import db
+
+
+class Father(db.Model):
+	__tablename__ = "fathers"
+
+	id = db.Column(db.Integer, primary_key=True)
+	name = db.Column(db.String(200), nullable=False)
+
+	sons = db.relationship('Son', backref='father', lazy='dynamic')

Diff for: app/models/son.py

@@ -0,0 +1,9 @@
+from app import db
+
+class Son(db.Model):
+	__tablename__ = "sons"
+
+	id = db.Column(db.Integer, primary_key=True)
+	name = db.Column(db.String(150))
+
+	father_id = db.Column(db.Integer, db.ForeignKey('fathers.id'))