2 # Copyright (C) 2018 rubenwardy
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.
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.
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/>.
20 from app import app, gravatar
21 from urllib.parse import urlparse
23 from flask import Flask, url_for
24 from flask_sqlalchemy import SQLAlchemy, BaseQuery
25 from flask_migrate import Migrate
26 from flask_user import login_required, UserManager, UserMixin
27 from sqlalchemy import func, CheckConstraint
28 from sqlalchemy_searchable import SearchQueryMixin
29 from sqlalchemy_utils.types import TSVectorType
30 from sqlalchemy_searchable import make_searchable
35 migrate = Migrate(app, db)
36 make_searchable(db.metadata)
39 class ArticleQuery(BaseQuery, SearchQueryMixin):
43 class UserRank(enum.Enum):
53 def atLeast(self, min):
54 return self.value >= min.value
57 return self.name.replace("_", " ").title()
60 return self.name.lower()
67 return [(choice, choice.getTitle()) for choice in cls]
70 def coerce(cls, item):
71 return item if type(item) == UserRank else UserRank[item]
74 class Permission(enum.Enum):
75 EDIT_PACKAGE = "EDIT_PACKAGE"
76 APPROVE_CHANGES = "APPROVE_CHANGES"
77 DELETE_PACKAGE = "DELETE_PACKAGE"
78 CHANGE_AUTHOR = "CHANGE_AUTHOR"
79 CHANGE_NAME = "CHANGE_NAME"
80 MAKE_RELEASE = "MAKE_RELEASE"
81 DELETE_RELEASE = "DELETE_RELEASE"
82 ADD_SCREENSHOTS = "ADD_SCREENSHOTS"
83 APPROVE_SCREENSHOT = "APPROVE_SCREENSHOT"
84 APPROVE_RELEASE = "APPROVE_RELEASE"
85 APPROVE_NEW = "APPROVE_NEW"
86 CHANGE_RELEASE_URL = "CHANGE_RELEASE_URL"
87 CHANGE_DNAME = "CHANGE_DNAME"
88 CHANGE_RANK = "CHANGE_RANK"
89 CHANGE_EMAIL = "CHANGE_EMAIL"
90 EDIT_EDITREQUEST = "EDIT_EDITREQUEST"
91 SEE_THREAD = "SEE_THREAD"
92 CREATE_THREAD = "CREATE_THREAD"
93 UNAPPROVE_PACKAGE = "UNAPPROVE_PACKAGE"
94 TOPIC_DISCARD = "TOPIC_DISCARD"
95 CREATE_TOKEN = "CREATE_TOKEN"
96 CHANGE_PROFILE_URLS = "CHANGE_PROFILE_URLS"
98 # Only return true if the permission is valid for *all* contexts
99 # See Package.checkPerm for package-specific contexts
100 def check(self, user):
101 if not user.is_authenticated:
104 if self == Permission.APPROVE_NEW or \
105 self == Permission.APPROVE_CHANGES or \
106 self == Permission.APPROVE_RELEASE or \
107 self == Permission.APPROVE_SCREENSHOT or \
108 self == Permission.SEE_THREAD:
109 return user.rank.atLeast(UserRank.EDITOR)
111 raise Exception("Non-global permission checked globally. Use Package.checkPerm or User.checkPerm instead.")
113 def display_name_default(context):
114 return context.get_current_parameters()["username"]
116 class User(db.Model, UserMixin):
117 id = db.Column(db.Integer, primary_key=True)
119 # User authentication information
120 username = db.Column(db.String(50, collation="NOCASE"), nullable=False, unique=True, index=True)
121 password = db.Column(db.String(255), nullable=False, server_default="")
122 reset_password_token = db.Column(db.String(100), nullable=False, server_default="")
124 rank = db.Column(db.Enum(UserRank))
127 github_username = db.Column(db.String(50, collation="NOCASE"), nullable=True, unique=True)
128 forums_username = db.Column(db.String(50, collation="NOCASE"), nullable=True, unique=True)
130 # Access token for webhook setup
131 github_access_token = db.Column(db.String(50), nullable=True, server_default=None)
133 # User email information
134 email = db.Column(db.String(255), nullable=True, unique=True)
135 email_confirmed_at = db.Column(db.DateTime())
138 profile_pic = db.Column(db.String(255), nullable=True, server_default=None)
139 active = db.Column("is_active", db.Boolean, nullable=False, server_default="0")
140 display_name = db.Column(db.String(100), nullable=False, default=display_name_default)
143 website_url = db.Column(db.String(255), nullable=True, default=None)
144 donate_url = db.Column(db.String(255), nullable=True, default=None)
147 notifications = db.relationship("Notification", primaryjoin="User.id==Notification.user_id")
149 # causednotifs = db.relationship("Notification", backref="causer", lazy="dynamic")
150 packages = db.relationship("Package", backref=db.backref("author", lazy="joined"), lazy="dynamic")
151 requests = db.relationship("EditRequest", backref="author", lazy="dynamic")
152 threads = db.relationship("Thread", backref="author", lazy="dynamic")
153 tokens = db.relationship("APIToken", backref="owner", lazy="dynamic")
154 replies = db.relationship("ThreadReply", backref="author", lazy="dynamic")
156 def __init__(self, username=None, active=False, email=None, password=""):
157 self.username = username
158 self.email_confirmed_at = datetime.datetime.now() - datetime.timedelta(days=6000)
159 self.display_name = username
162 self.password = password
163 self.rank = UserRank.NOT_JOINED
165 def hasPassword(self):
166 return self.password != ""
168 def canAccessTodoList(self):
169 return Permission.APPROVE_NEW.check(self) or \
170 Permission.APPROVE_RELEASE.check(self) or \
171 Permission.APPROVE_CHANGES.check(self)
174 return self.rank.atLeast(UserRank.NEW_MEMBER)
176 def getProfilePicURL(self):
178 return self.profile_pic
180 return gravatar(self.email or "")
182 def checkPerm(self, user, perm):
183 if not user.is_authenticated:
186 if type(perm) == str:
187 perm = Permission[perm]
188 elif type(perm) != Permission:
189 raise Exception("Unknown permission given to User.checkPerm()")
191 # Members can edit their own packages, and editors can edit any packages
192 if perm == Permission.CHANGE_AUTHOR:
193 return user.rank.atLeast(UserRank.EDITOR)
194 elif perm == Permission.CHANGE_RANK or perm == Permission.CHANGE_DNAME:
195 return user.rank.atLeast(UserRank.MODERATOR)
196 elif perm == Permission.CHANGE_EMAIL or perm == Permission.CHANGE_PROFILE_URLS:
197 return user == self or (user.rank.atLeast(UserRank.MODERATOR) and user.rank.atLeast(self.rank))
198 elif perm == Permission.CREATE_TOKEN:
200 return user.rank.atLeast(UserRank.MEMBER)
202 return user.rank.atLeast(UserRank.MODERATOR) and user.rank.atLeast(self.rank)
204 raise Exception("Permission {} is not related to users".format(perm.name))
206 def canCommentRL(self):
207 hour_ago = datetime.datetime.utcnow() - datetime.timedelta(hours=1)
208 return ThreadReply.query.filter_by(author=self) \
209 .filter(ThreadReply.created_at > hour_ago).count() < 4
211 def canOpenThreadRL(self):
212 hour_ago = datetime.datetime.utcnow() - datetime.timedelta(hours=1)
213 return Thread.query.filter_by(author=self) \
214 .filter(Thread.created_at > hour_ago).count() < 2
216 def __eq__(self, other):
220 if not self.is_authenticated or not other.is_authenticated:
224 return self.id == other.id
226 class UserEmailVerification(db.Model):
227 id = db.Column(db.Integer, primary_key=True)
228 user_id = db.Column(db.Integer, db.ForeignKey("user.id"))
229 email = db.Column(db.String(100))
230 token = db.Column(db.String(32))
231 user = db.relationship("User", foreign_keys=[user_id])
233 class Notification(db.Model):
234 id = db.Column(db.Integer, primary_key=True)
235 user_id = db.Column(db.Integer, db.ForeignKey("user.id"))
236 causer_id = db.Column(db.Integer, db.ForeignKey("user.id"))
237 user = db.relationship("User", foreign_keys=[user_id])
238 causer = db.relationship("User", foreign_keys=[causer_id])
240 title = db.Column(db.String(100), nullable=False)
241 url = db.Column(db.String(200), nullable=True)
243 def __init__(self, us, cau, titl, ur):
245 title = title[:99] + "…"
253 class License(db.Model):
254 id = db.Column(db.Integer, primary_key=True)
255 name = db.Column(db.String(50), nullable=False, unique=True)
256 is_foss = db.Column(db.Boolean, nullable=False, default=True)
258 def __init__(self, v, is_foss=True):
260 self.is_foss = is_foss
266 class PackageType(enum.Enum):
272 return self.name.lower()
280 return PackageType[name.upper()]
286 return [(choice, choice.value) for choice in cls]
289 def coerce(cls, item):
290 return item if type(item) == PackageType else PackageType[item]
293 class PackagePropertyKey(enum.Enum):
296 short_desc = "Short Description"
300 media_license = "Media License"
302 provides = "Provides"
305 issueTracker = "Issue Tracker"
306 forums = "Forum Topic ID"
308 def convert(self, value):
309 if self == PackagePropertyKey.tags:
310 return ",".join([t.title for t in value])
311 elif self == PackagePropertyKey.provides:
312 return ",".join([t.name for t in value])
316 provides = db.Table("provides",
317 db.Column("package_id", db.Integer, db.ForeignKey("package.id"), primary_key=True),
318 db.Column("metapackage_id", db.Integer, db.ForeignKey("meta_package.id"), primary_key=True)
321 tags = db.Table("tags",
322 db.Column("tag_id", db.Integer, db.ForeignKey("tag.id"), primary_key=True),
323 db.Column("package_id", db.Integer, db.ForeignKey("package.id"), primary_key=True)
326 class Dependency(db.Model):
327 id = db.Column(db.Integer, primary_key=True)
328 depender_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
329 package_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
330 package = db.relationship("Package", foreign_keys=[package_id])
331 meta_package_id = db.Column(db.Integer, db.ForeignKey("meta_package.id"), nullable=True)
332 optional = db.Column(db.Boolean, nullable=False, default=False)
333 __table_args__ = (db.UniqueConstraint("depender_id", "package_id", "meta_package_id", name="_dependency_uc"), )
335 def __init__(self, depender=None, package=None, meta=None):
339 self.depender = depender
341 packageProvided = package is not None
342 metaProvided = meta is not None
344 if packageProvided and not metaProvided:
345 self.package = package
346 elif metaProvided and not packageProvided:
347 self.meta_package = meta
349 raise Exception("Either meta or package must be given, but not both!")
352 if self.meta_package:
353 return self.meta_package.name
355 return self.package.name
360 if self.package is not None:
361 return self.package.author.username + "/" + self.package.name
362 elif self.meta_package is not None:
363 return self.meta_package.name
365 raise Exception("Meta and package are both none!")
368 def SpecToList(depender, spec, cache={}):
370 arr = spec.split(",")
373 pattern1 = re.compile("^([a-z0-9_]+)$")
374 pattern2 = re.compile("^([A-Za-z0-9_]+)/([a-z0-9_]+)$")
381 if pattern1.match(x):
382 meta = MetaPackage.GetOrCreate(x, cache)
383 retval.append(Dependency(depender, meta=meta))
385 m = pattern2.match(x)
386 username = m.group(1)
388 user = User.query.filter_by(username=username).first()
390 raise Exception("Unable to find user " + username)
392 package = Package.query.filter_by(author=user, name=name).first()
394 raise Exception("Unable to find package " + name + " by " + username)
396 retval.append(Dependency(depender, package=package))
401 class Package(db.Model):
402 query_class = ArticleQuery
404 id = db.Column(db.Integer, primary_key=True)
407 author_id = db.Column(db.Integer, db.ForeignKey("user.id"))
408 name = db.Column(db.Unicode(100), nullable=False)
409 title = db.Column(db.Unicode(100), nullable=False)
410 short_desc = db.Column(db.Unicode(200), nullable=False)
411 desc = db.Column(db.UnicodeText, nullable=True)
412 type = db.Column(db.Enum(PackageType))
413 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
415 name_valid = db.CheckConstraint("name ~* '^[a-z0-9_]+$'")
417 search_vector = db.Column(TSVectorType("name", "title", "short_desc", "desc", \
418 weights={ "name": "A", "title": "B", "short_desc": "C", "desc": "D" }))
420 license_id = db.Column(db.Integer, db.ForeignKey("license.id"), nullable=False, default=1)
421 license = db.relationship("License", foreign_keys=[license_id])
422 media_license_id = db.Column(db.Integer, db.ForeignKey("license.id"), nullable=False, default=1)
423 media_license = db.relationship("License", foreign_keys=[media_license_id])
425 approved = db.Column(db.Boolean, nullable=False, default=False)
426 soft_deleted = db.Column(db.Boolean, nullable=False, default=False)
428 score = db.Column(db.Float, nullable=False, default=0)
430 review_thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=True, default=None)
431 review_thread = db.relationship("Thread", foreign_keys=[review_thread_id])
434 repo = db.Column(db.String(200), nullable=True)
435 website = db.Column(db.String(200), nullable=True)
436 issueTracker = db.Column(db.String(200), nullable=True)
437 forums = db.Column(db.Integer, nullable=True)
439 provides = db.relationship("MetaPackage", \
440 secondary=provides, lazy="select", order_by=db.asc("name"), \
441 backref=db.backref("packages", lazy="dynamic", order_by=db.desc("score")))
443 dependencies = db.relationship("Dependency", backref="depender", lazy="dynamic", foreign_keys=[Dependency.depender_id])
445 tags = db.relationship("Tag", secondary=tags, lazy="select",
446 backref=db.backref("packages", lazy=True))
448 releases = db.relationship("PackageRelease", backref="package",
449 lazy="dynamic", order_by=db.desc("package_release_releaseDate"))
451 screenshots = db.relationship("PackageScreenshot", backref="package",
452 lazy="dynamic", order_by=db.asc("package_screenshot_id"))
454 requests = db.relationship("EditRequest", backref="package",
457 def __init__(self, package=None):
461 self.author_id = package.author_id
462 self.created_at = package.created_at
463 self.approved = package.approved
465 for e in PackagePropertyKey:
466 setattr(self, e.name, getattr(package, e.name))
469 return self.license.is_foss and self.media_license.is_foss
471 def getIsOnGitHub(self):
472 if self.repo is None:
475 url = urlparse(self.repo)
476 return url.netloc == "github.com"
478 def getGitHubFullName(self):
479 if self.repo is None:
482 url = urlparse(self.repo)
483 if url.netloc != "github.com":
487 m = re.search(r"^\/([^\/]+)\/([^\/]+)\/?$", url.path)
492 repo = m.group(2).replace(".git", "")
496 def getSortedDependencies(self, is_hard=None):
497 query = self.dependencies
498 if is_hard is not None:
499 query = query.filter_by(optional=not is_hard)
502 deps.sort(key = lambda x: x.getName())
505 def getSortedHardDependencies(self):
506 return self.getSortedDependencies(True)
508 def getSortedOptionalDependencies(self):
509 return self.getSortedDependencies(False)
514 elif self.review_thread_id:
516 elif (self.type == PackageType.GAME or \
517 self.type == PackageType.TXP) and \
518 self.screenshots.count() == 0:
520 elif not self.getDownloadRelease():
522 elif "Other" in self.license.name or "Other" in self.media_license.name:
527 def getAsDictionaryKey(self):
530 "author": self.author.display_name,
531 "type": self.type.toName(),
534 def getAsDictionaryShort(self, base_url, version=None, protonum=None):
535 tnurl = self.getThumbnailURL(1)
536 release = self.getDownloadRelease(version=version, protonum=protonum)
540 "author": self.author.display_name,
541 "short_description": self.short_desc,
542 "type": self.type.toName(),
543 "release": release and release.id,
544 "thumbnail": (base_url + tnurl) if tnurl is not None else None
547 def getAsDictionary(self, base_url, version=None, protonum=None):
548 tnurl = self.getThumbnailURL(1)
549 release = self.getDownloadRelease(version=version, protonum=protonum)
551 "author": self.author.display_name,
554 "short_description": self.short_desc,
556 "type": self.type.toName(),
557 "created_at": self.created_at.isoformat(),
559 "license": self.license.name,
560 "media_license": self.media_license.name,
563 "website": self.website,
564 "issue_tracker": self.issueTracker,
565 "forums": self.forums,
567 "provides": [x.name for x in self.provides],
568 "thumbnail": (base_url + tnurl) if tnurl is not None else None,
569 "screenshots": [base_url + ss.url for ss in self.screenshots],
571 "url": base_url + self.getDownloadURL(),
572 "release": release and release.id,
574 "score": round(self.score * 10) / 10
577 def getThumbnailURL(self, level=2):
578 screenshot = self.screenshots.filter_by(approved=True).order_by(db.asc(PackageScreenshot.id)).first()
579 return screenshot.getThumbnailURL(level) if screenshot is not None else None
581 def getMainScreenshotURL(self, absolute=False):
582 screenshot = self.screenshots.filter_by(approved=True).order_by(db.asc(PackageScreenshot.id)).first()
583 if screenshot is None:
587 from app.utils import abs_url
588 return abs_url(screenshot.url)
590 return screenshot.url
592 def getDetailsURL(self, absolute=False):
594 from app.utils import abs_url_for
595 return abs_url_for("packages.view",
596 author=self.author.username, name=self.name)
598 return url_for("packages.view",
599 author=self.author.username, name=self.name)
601 def getEditURL(self):
602 return url_for("packages.create_edit",
603 author=self.author.username, name=self.name)
605 def getApproveURL(self):
606 return url_for("packages.approve",
607 author=self.author.username, name=self.name)
609 def getRemoveURL(self):
610 return url_for("packages.remove",
611 author=self.author.username, name=self.name)
613 def getNewScreenshotURL(self):
614 return url_for("packages.create_screenshot",
615 author=self.author.username, name=self.name)
617 def getCreateReleaseURL(self):
618 return url_for("packages.create_release",
619 author=self.author.username, name=self.name)
621 def getCreateEditRequestURL(self):
622 return url_for("create_edit_editrequest_page",
623 author=self.author.username, name=self.name)
625 def getBulkReleaseURL(self):
626 return url_for("packages.bulk_change_release",
627 author=self.author.username, name=self.name)
629 def getDownloadURL(self):
630 return url_for("packages.download",
631 author=self.author.username, name=self.name)
633 def getDownloadRelease(self, version=None, protonum=None):
634 if version is None and protonum is not None:
635 version = MinetestRelease.query.filter(MinetestRelease.protocol >= int(protonum)).first()
636 if version is not None:
642 for rel in self.releases:
643 if rel.approved and (version is None or
644 ((rel.min_rel is None or rel.min_rel_id <= version) and \
645 (rel.max_rel is None or rel.max_rel_id >= version))):
650 def getDownloadCount(self):
652 for release in self.releases:
653 counter += release.downloads
656 def checkPerm(self, user, perm):
657 if not user.is_authenticated:
660 if type(perm) == str:
661 perm = Permission[perm]
662 elif type(perm) != Permission:
663 raise Exception("Unknown permission given to Package.checkPerm()")
665 isOwner = user == self.author
667 if perm == Permission.CREATE_THREAD:
668 return user.rank.atLeast(UserRank.MEMBER)
670 # Members can edit their own packages, and editors can edit any packages
671 if perm == Permission.MAKE_RELEASE or perm == Permission.ADD_SCREENSHOTS:
672 return isOwner or user.rank.atLeast(UserRank.EDITOR)
674 if perm == Permission.EDIT_PACKAGE or perm == Permission.APPROVE_CHANGES or perm == Permission.APPROVE_RELEASE:
676 return user.rank.atLeast(UserRank.MEMBER if self.approved else UserRank.NEW_MEMBER)
678 return user.rank.atLeast(UserRank.EDITOR)
680 # Anyone can change the package name when not approved, but only editors when approved
681 elif perm == Permission.CHANGE_NAME:
682 return not self.approved or user.rank.atLeast(UserRank.EDITOR)
684 # Editors can change authors and approve new packages
685 elif perm == Permission.APPROVE_NEW or perm == Permission.CHANGE_AUTHOR:
686 return user.rank.atLeast(UserRank.EDITOR)
688 elif perm == Permission.APPROVE_SCREENSHOT:
689 return user.rank.atLeast(UserRank.TRUSTED_MEMBER if isOwner else UserRank.EDITOR)
691 # Moderators can delete packages
692 elif perm == Permission.DELETE_PACKAGE or perm == Permission.UNAPPROVE_PACKAGE \
693 or perm == Permission.CHANGE_RELEASE_URL:
694 return user.rank.atLeast(UserRank.MODERATOR)
697 raise Exception("Permission {} is not related to packages".format(perm.name))
699 def setStartScore(self):
700 downloads = db.session.query(func.sum(PackageRelease.downloads)). \
701 filter(PackageRelease.package_id == self.id).scalar() or 0
705 topic = self.forums and ForumTopic.query.get(self.forums)
707 months = (datetime.datetime.now() - topic.created_at).days / 30
709 forum_score = topic.views / max(years, 0.0416) + 80*min(max(months, 0.5), 6)
710 forum_bonus = topic.views + topic.posts
712 self.score = max(downloads, forum_score * 0.6) + forum_bonus
714 if self.getMainScreenshotURL() is None:
717 if not self.license.is_foss or not self.media_license.is_foss:
721 class MetaPackage(db.Model):
722 id = db.Column(db.Integer, primary_key=True)
723 name = db.Column(db.String(100), unique=True, nullable=False)
724 dependencies = db.relationship("Dependency", backref="meta_package", lazy="dynamic")
726 def __init__(self, name=None):
733 def ListToSpec(list):
734 return ",".join([str(x) for x in list])
737 def GetOrCreate(name, cache={}):
740 mp = MetaPackage.query.filter_by(name=name).first()
743 mp = MetaPackage(name)
750 def SpecToList(spec, cache={}):
752 arr = spec.split(",")
755 pattern = re.compile("^([a-z0-9_]+)$")
762 if not pattern.match(x):
765 retval.append(MetaPackage.GetOrCreate(x, cache))
770 id = db.Column(db.Integer, primary_key=True)
771 name = db.Column(db.String(100), unique=True, nullable=False)
772 title = db.Column(db.String(100), nullable=False)
773 backgroundColor = db.Column(db.String(6), nullable=False)
774 textColor = db.Column(db.String(6), nullable=False)
776 def __init__(self, title, backgroundColor="000000", textColor="ffffff"):
778 self.backgroundColor = backgroundColor
779 self.textColor = textColor
782 regex = re.compile("[^a-z_]")
783 self.name = regex.sub("", self.title.lower().replace(" ", "_"))
786 class MinetestRelease(db.Model):
787 id = db.Column(db.Integer, primary_key=True)
788 name = db.Column(db.String(100), unique=True, nullable=False)
789 protocol = db.Column(db.Integer, nullable=False, default=0)
791 def __init__(self, name=None, protocol=0):
793 self.protocol = protocol
796 return None if self.name == "None" else self
799 class PackageRelease(db.Model):
800 id = db.Column(db.Integer, primary_key=True)
802 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
803 title = db.Column(db.String(100), nullable=False)
804 releaseDate = db.Column(db.DateTime, nullable=False)
805 url = db.Column(db.String(200), nullable=False)
806 approved = db.Column(db.Boolean, nullable=False, default=False)
807 task_id = db.Column(db.String(37), nullable=True)
808 commit_hash = db.Column(db.String(41), nullable=True, default=None)
809 downloads = db.Column(db.Integer, nullable=False, default=0)
811 min_rel_id = db.Column(db.Integer, db.ForeignKey("minetest_release.id"), nullable=True, server_default=None)
812 min_rel = db.relationship("MinetestRelease", foreign_keys=[min_rel_id])
814 max_rel_id = db.Column(db.Integer, db.ForeignKey("minetest_release.id"), nullable=True, server_default=None)
815 max_rel = db.relationship("MinetestRelease", foreign_keys=[max_rel_id])
817 # If the release is approved, then the task_id must be null and the url must be present
818 CK_approval_valid = db.CheckConstraint("not approved OR (task_id IS NULL AND (url = '') IS NOT FALSE)")
820 def getAsDictionary(self):
824 "url": self.url if self.url != "" else None,
825 "release_date": self.releaseDate.isoformat(),
826 "commit": self.commit_hash,
827 "downloads": self.downloads,
828 "min_protocol": self.min_rel and self.min_rel.protocol,
829 "max_protocol": self.max_rel and self.max_rel.protocol
832 def getEditURL(self):
833 return url_for("packages.edit_release",
834 author=self.package.author.username,
835 name=self.package.name,
838 def getDeleteURL(self):
839 return url_for("packages.delete_release",
840 author=self.package.author.username,
841 name=self.package.name,
844 def getDownloadURL(self):
845 return url_for("packages.download_release",
846 author=self.package.author.username,
847 name=self.package.name,
852 self.releaseDate = datetime.datetime.now()
854 def approve(self, user):
855 if self.package.approved and \
856 not self.package.checkPerm(user, Permission.APPROVE_RELEASE):
859 assert self.task_id is None and self.url is not None and self.url != ""
864 def checkPerm(self, user, perm):
865 if not user.is_authenticated:
868 if type(perm) == str:
869 perm = Permission[perm]
870 elif type(perm) != Permission:
871 raise Exception("Unknown permission given to PackageRelease.checkPerm()")
873 isOwner = user == self.package.author
875 if perm == Permission.DELETE_RELEASE:
876 if user.rank.atLeast(UserRank.ADMIN):
879 if not (isOwner or user.rank.atLeast(UserRank.EDITOR)):
882 if not self.package.approved or self.task_id is not None:
885 count = PackageRelease.query \
886 .filter_by(package_id=self.package_id) \
887 .filter(PackageRelease.id > self.id) \
892 raise Exception("Permission {} is not related to releases".format(perm.name))
895 # class PackageReview(db.Model):
896 # id = db.Column(db.Integer, primary_key=True)
897 # package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
898 # thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=False)
899 # recommend = db.Column(db.Boolean, nullable=False, default=True)
902 class PackageScreenshot(db.Model):
903 id = db.Column(db.Integer, primary_key=True)
904 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
905 title = db.Column(db.String(100), nullable=False)
906 url = db.Column(db.String(100), nullable=False)
907 approved = db.Column(db.Boolean, nullable=False, default=False)
910 def getEditURL(self):
911 return url_for("packages.edit_screenshot",
912 author=self.package.author.username,
913 name=self.package.name,
916 def getThumbnailURL(self, level=2):
917 return self.url.replace("/uploads/", ("/thumbnails/{:d}/").format(level))
920 class APIToken(db.Model):
921 id = db.Column(db.Integer, primary_key=True)
922 access_token = db.Column(db.String(34), unique=True)
924 name = db.Column(db.String(100), nullable=False)
925 owner_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
926 # owner is created using backref
928 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
930 package_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
931 package = db.relationship("Package", foreign_keys=[package_id])
933 def canOperateOnPackage(self, package):
934 if self.package and self.package != package:
937 return package.author == self.owner
940 class EditRequest(db.Model):
941 id = db.Column(db.Integer, primary_key=True)
943 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
944 author_id = db.Column(db.Integer, db.ForeignKey("user.id"))
946 title = db.Column(db.String(100), nullable=False)
947 desc = db.Column(db.String(1000), nullable=True)
952 status = db.Column(db.Integer, nullable=False, default=0)
954 changes = db.relationship("EditRequestChange", backref="request",
958 return url_for("view_editrequest_page",
959 author=self.package.author.username,
960 name=self.package.name,
963 def getApproveURL(self):
964 return url_for("approve_editrequest_page",
965 author=self.package.author.username,
966 name=self.package.name,
969 def getRejectURL(self):
970 return url_for("reject_editrequest_page",
971 author=self.package.author.username,
972 name=self.package.name,
975 def getEditURL(self):
976 return url_for("create_edit_editrequest_page",
977 author=self.package.author.username,
978 name=self.package.name,
981 def applyAll(self, package):
982 for change in self.changes:
983 change.apply(package)
986 def checkPerm(self, user, perm):
987 if not user.is_authenticated:
990 if type(perm) == str:
991 perm = Permission[perm]
992 elif type(perm) != Permission:
993 raise Exception("Unknown permission given to EditRequest.checkPerm()")
995 isOwner = user == self.author
997 # Members can edit their own packages, and editors can edit any packages
998 if perm == Permission.EDIT_EDITREQUEST:
999 return isOwner or user.rank.atLeast(UserRank.EDITOR)
1002 raise Exception("Permission {} is not related to packages".format(perm.name))
1007 class EditRequestChange(db.Model):
1008 id = db.Column(db.Integer, primary_key=True)
1010 request_id = db.Column(db.Integer, db.ForeignKey("edit_request.id"))
1011 key = db.Column(db.Enum(PackagePropertyKey), nullable=False)
1013 # TODO: make diff instead
1014 oldValue = db.Column(db.Text, nullable=True)
1015 newValue = db.Column(db.Text, nullable=True)
1017 def apply(self, package):
1018 if self.key == PackagePropertyKey.tags:
1019 package.tags.clear()
1020 for tagTitle in self.newValue.split(","):
1021 tag = Tag.query.filter_by(title=tagTitle.strip()).first()
1022 package.tags.append(tag)
1025 setattr(package, self.key.name, self.newValue)
1028 watchers = db.Table("watchers",
1029 db.Column("user_id", db.Integer, db.ForeignKey("user.id"), primary_key=True),
1030 db.Column("thread_id", db.Integer, db.ForeignKey("thread.id"), primary_key=True)
1033 class Thread(db.Model):
1034 id = db.Column(db.Integer, primary_key=True)
1036 package_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
1037 package = db.relationship("Package", foreign_keys=[package_id])
1039 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
1040 title = db.Column(db.String(100), nullable=False)
1041 private = db.Column(db.Boolean, server_default="0")
1043 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
1045 replies = db.relationship("ThreadReply", backref="thread", lazy="dynamic")
1047 watchers = db.relationship("User", secondary=watchers, lazy="subquery", \
1048 backref=db.backref("watching", lazy=True))
1051 def getSubscribeURL(self):
1052 return url_for("threads.subscribe",
1055 def getUnsubscribeURL(self):
1056 return url_for("threads.unsubscribe",
1059 def checkPerm(self, user, perm):
1060 if not user.is_authenticated:
1061 return not self.private
1063 if type(perm) == str:
1064 perm = Permission[perm]
1065 elif type(perm) != Permission:
1066 raise Exception("Unknown permission given to Thread.checkPerm()")
1068 isOwner = user == self.author or (self.package is not None and self.package.author == user)
1070 if perm == Permission.SEE_THREAD:
1071 return not self.private or isOwner or user.rank.atLeast(UserRank.EDITOR)
1074 raise Exception("Permission {} is not related to threads".format(perm.name))
1076 class ThreadReply(db.Model):
1077 id = db.Column(db.Integer, primary_key=True)
1078 thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=False)
1079 comment = db.Column(db.String(500), nullable=False)
1080 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
1081 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
1084 REPO_BLACKLIST = [".zip", "mediafire.com", "dropbox.com", "weebly.com", \
1085 "minetest.net", "dropboxusercontent.com", "4shared.com", \
1086 "digitalaudioconcepts.com", "hg.intevation.org", "www.wtfpl.net", \
1087 "imageshack.com", "imgur.com"]
1089 class ForumTopic(db.Model):
1090 topic_id = db.Column(db.Integer, primary_key=True, autoincrement=False)
1091 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
1092 author = db.relationship("User")
1094 wip = db.Column(db.Boolean, server_default="0")
1095 discarded = db.Column(db.Boolean, server_default="0")
1097 type = db.Column(db.Enum(PackageType), nullable=False)
1098 title = db.Column(db.String(200), nullable=False)
1099 name = db.Column(db.String(30), nullable=True)
1100 link = db.Column(db.String(200), nullable=True)
1102 posts = db.Column(db.Integer, nullable=False)
1103 views = db.Column(db.Integer, nullable=False)
1105 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
1107 def getRepoURL(self):
1108 if self.link is None:
1111 for item in REPO_BLACKLIST:
1112 if item in self.link:
1115 return self.link.replace("repo.or.cz/w/", "repo.or.cz/")
1117 def getAsDictionary(self):
1119 "author": self.author.username,
1121 "type": self.type.toName(),
1122 "title": self.title,
1123 "id": self.topic_id,
1125 "posts": self.posts,
1126 "views": self.views,
1128 "discarded": self.discarded,
1129 "created_at": self.created_at.isoformat(),
1132 def checkPerm(self, user, perm):
1133 if not user.is_authenticated:
1136 if type(perm) == str:
1137 perm = Permission[perm]
1138 elif type(perm) != Permission:
1139 raise Exception("Unknown permission given to ForumTopic.checkPerm()")
1141 if perm == Permission.TOPIC_DISCARD:
1142 return self.author == user or user.rank.atLeast(UserRank.EDITOR)
1145 raise Exception("Permission {} is not related to topics".format(perm.name))
1149 user_manager = UserManager(app, db, User)
1151 if app.config.get("LOG_SQL"):
1153 logging.basicConfig()
1154 logging.getLogger('sqlalchemy.engine').setLevel(logging.INFO)