app/blueprints/api/endpoints.py

   1 # Content DB
   2 # Copyright (C) 2018  rubenwardy
   3 #
   4 # This program is free software: you can redistribute it and/or modify
   5 # it under the terms of the GNU General Public License as published by
   6 # the Free Software Foundation, either version 3 of the License, or
   7 # (at your option) any later version.
   8 #
   9 # This program is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 # GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License
  15 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
  16
  17
  18 from flask import *
  19 from flask_user import *
  20 from . import bp
  21 from .auth import is_api_authd
  22 from .support import error, handleCreateRelease
  23 from app import csrf
  24 from app.models import *
  25 from app.utils import is_package_page
  26 from app.markdown import render_markdown
  27 from app.querybuilder import QueryBuilder
  28
  29 @bp.route("/api/packages/")
  30 def packages():
  31         qb    = QueryBuilder(request.args)
  32         query = qb.buildPackageQuery()
  33         ver   = qb.getMinetestVersion()
  34
  35         pkgs = [package.getAsDictionaryShort(current_app.config["BASE_URL"], version=ver) \
  36                         for package in query.all()]
  37         return jsonify(pkgs)
  38
  39
  40 @bp.route("/api/scores/")
  41 def package_scores():
  42         qb    = QueryBuilder(request.args)
  43         query = qb.buildPackageQuery()
  44
  45         pkgs = [{ "author": package.author.username, "name": package.name, "score": package.score } \
  46                         for package in query.all()]
  47         return jsonify(pkgs)
  48
  49
  50 @bp.route("/api/packages/<author>/<name>/")
  51 @is_package_page
  52 def package(package):
  53         return jsonify(package.getAsDictionary(current_app.config["BASE_URL"]))
  54
  55
  56 @bp.route("/api/packages/<author>/<name>/dependencies/")
  57 @is_package_page
  58 def package_dependencies(package):
  59         ret = []
  60
  61         for dep in package.dependencies:
  62                 name = None
  63                 fulfilled_by = None
  64
  65                 if dep.package:
  66                         name = dep.package.name
  67                         fulfilled_by = [ dep.package.getAsDictionaryKey() ]
  68
  69                 elif dep.meta_package:
  70                         name = dep.meta_package.name
  71                         fulfilled_by = [ pkg.getAsDictionaryKey() for pkg in dep.meta_package.packages]
  72
  73                 else:
  74                         raise "Malformed dependency"
  75
  76                 ret.append({
  77                         "name": name,
  78                         "is_optional": dep.optional,
  79                         "packages": fulfilled_by
  80                 })
  81
  82         return jsonify(ret)
  83
  84
  85 @bp.route("/api/packages/<author>/<name>/releases/")
  86 @is_package_page
  87 def list_releases(package):
  88         releases = package.releases.filter_by(approved=True).all()
  89         return jsonify([ rel.getAsDictionary() for rel in releases ])
  90
  91
  92 @bp.route("/api/topics/")
  93 def topics():
  94         qb     = QueryBuilder(request.args)
  95         query  = qb.buildTopicQuery(show_added=True)
  96         return jsonify([t.getAsDictionary() for t in query.all()])
  97
  98
  99 @bp.route("/api/topic_discard/", methods=["POST"])
 100 @login_required
 101 def topic_set_discard():
 102         tid = request.args.get("tid")
 103         discard = request.args.get("discard")
 104         if tid is None or discard is None:
 105                 abort(400)
 106
 107         topic = ForumTopic.query.get(tid)
 108         if not topic.checkPerm(current_user, Permission.TOPIC_DISCARD):
 109                 abort(403)
 110
 111         topic.discarded = discard == "true"
 112         db.session.commit()
 113
 114         return jsonify(topic.getAsDictionary())
 115
 116
 117 @bp.route("/api/minetest_versions/")
 118 def versions():
 119         return jsonify([{ "name": rel.name, "protocol_version": rel.protocol }\
 120                         for rel in MinetestRelease.query.all() if rel.getActual() is not None])
 121
 122
 123 @bp.route("/api/whoami/")
 124 @is_api_authd
 125 def whoami(token):
 126         if token is None:
 127                 return jsonify({ "is_authenticated": False, "username": None })
 128         else:
 129                 return jsonify({ "is_authenticated": True, "username": token.owner.username })
 130
 131
 132 @bp.route("/api/markdown/", methods=["POST"])
 133 @csrf.exempt
 134 def markdown():
 135         return render_markdown(request.data.decode("utf-8"))
 136
 137
 138 @bp.route("/api/packages/<author>/<name>/releases/new/", methods=["POST"])
 139 @csrf.exempt
 140 @is_package_page
 141 @is_api_authd
 142 def create_release(token, package):
 143         json = request.json
 144         if json is None:
 145                 return error(400, "JSON post data is required")
 146
 147         for option in ["method", "title", "ref"]:
 148                 if json.get(option) is None:
 149                         return error(400, option + " is required in the POST data")
 150
 151
 152         if json["method"].lower() != "git":
 153                 return error(400, "Release-creation methods other than git are not supported")
 154
 155         return handleCreateRelease(token, package, json["title"], json["ref"])