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"
97 # Only return true if the permission is valid for *all* contexts
98 # See Package.checkPerm for package-specific contexts
99 def check(self, user):
100 if not user.is_authenticated:
103 if self == Permission.APPROVE_NEW or \
104 self == Permission.APPROVE_CHANGES or \
105 self == Permission.APPROVE_RELEASE or \
106 self == Permission.APPROVE_SCREENSHOT or \
107 self == Permission.SEE_THREAD:
108 return user.rank.atLeast(UserRank.EDITOR)
110 raise Exception("Non-global permission checked globally. Use Package.checkPerm or User.checkPerm instead.")
112 class User(db.Model, UserMixin):
113 id = db.Column(db.Integer, primary_key=True)
115 # User authentication information
116 username = db.Column(db.String(50, collation="NOCASE"), nullable=False, unique=True, index=True)
117 password = db.Column(db.String(255), nullable=False, server_default="")
118 reset_password_token = db.Column(db.String(100), nullable=False, server_default="")
120 rank = db.Column(db.Enum(UserRank))
123 github_username = db.Column(db.String(50, collation="NOCASE"), nullable=True, unique=True)
124 forums_username = db.Column(db.String(50, collation="NOCASE"), nullable=True, unique=True)
126 # User email information
127 email = db.Column(db.String(255), nullable=True, unique=True)
128 email_confirmed_at = db.Column(db.DateTime())
131 profile_pic = db.Column(db.String(255), nullable=True, server_default=None)
132 active = db.Column("is_active", db.Boolean, nullable=False, server_default="0")
133 display_name = db.Column(db.String(100), nullable=False, server_default="")
136 website_url = db.Column(db.String(255), nullable=True, default=None)
137 donate_url = db.Column(db.String(255), nullable=True, default=None)
140 notifications = db.relationship("Notification", primaryjoin="User.id==Notification.user_id")
142 # causednotifs = db.relationship("Notification", backref="causer", lazy="dynamic")
143 packages = db.relationship("Package", backref="author", lazy="dynamic")
144 requests = db.relationship("EditRequest", backref="author", lazy="dynamic")
145 threads = db.relationship("Thread", backref="author", lazy="dynamic")
146 tokens = db.relationship("APIToken", backref="owner", lazy="dynamic")
147 replies = db.relationship("ThreadReply", backref="author", lazy="dynamic")
149 def __init__(self, username, active=False, email=None, password=""):
150 self.username = username
151 self.email_confirmed_at = datetime.datetime.now() - datetime.timedelta(days=6000)
152 self.display_name = username
155 self.password = password
156 self.rank = UserRank.NOT_JOINED
158 def hasPassword(self):
159 return self.password != ""
161 def canAccessTodoList(self):
162 return Permission.APPROVE_NEW.check(self) or \
163 Permission.APPROVE_RELEASE.check(self) or \
164 Permission.APPROVE_CHANGES.check(self)
167 return self.rank.atLeast(UserRank.NEW_MEMBER)
169 def getProfilePicURL(self):
171 return self.profile_pic
173 return gravatar(self.email or "")
175 def checkPerm(self, user, perm):
176 if not user.is_authenticated:
179 if type(perm) == str:
180 perm = Permission[perm]
181 elif type(perm) != Permission:
182 raise Exception("Unknown permission given to User.checkPerm()")
184 # Members can edit their own packages, and editors can edit any packages
185 if perm == Permission.CHANGE_AUTHOR:
186 return user.rank.atLeast(UserRank.EDITOR)
187 elif perm == Permission.CHANGE_RANK or perm == Permission.CHANGE_DNAME:
188 return user.rank.atLeast(UserRank.MODERATOR)
189 elif perm == Permission.CHANGE_EMAIL:
190 return user == self or (user.rank.atLeast(UserRank.MODERATOR) and user.rank.atLeast(self.rank))
191 elif perm == Permission.CREATE_TOKEN:
193 return user.rank.atLeast(UserRank.MEMBER)
195 return user.rank.atLeast(UserRank.MODERATOR) and user.rank.atLeast(self.rank)
197 raise Exception("Permission {} is not related to users".format(perm.name))
199 def canCommentRL(self):
200 hour_ago = datetime.datetime.utcnow() - datetime.timedelta(hours=1)
201 return ThreadReply.query.filter_by(author=self) \
202 .filter(ThreadReply.created_at > hour_ago).count() < 4
204 def canOpenThreadRL(self):
205 hour_ago = datetime.datetime.utcnow() - datetime.timedelta(hours=1)
206 return Thread.query.filter_by(author=self) \
207 .filter(Thread.created_at > hour_ago).count() < 2
209 def __eq__(self, other):
210 if not self.is_authenticated or not other.is_authenticated:
214 return self.id == other.id
216 class UserEmailVerification(db.Model):
217 id = db.Column(db.Integer, primary_key=True)
218 user_id = db.Column(db.Integer, db.ForeignKey("user.id"))
219 email = db.Column(db.String(100))
220 token = db.Column(db.String(32))
221 user = db.relationship("User", foreign_keys=[user_id])
223 class Notification(db.Model):
224 id = db.Column(db.Integer, primary_key=True)
225 user_id = db.Column(db.Integer, db.ForeignKey("user.id"))
226 causer_id = db.Column(db.Integer, db.ForeignKey("user.id"))
227 user = db.relationship("User", foreign_keys=[user_id])
228 causer = db.relationship("User", foreign_keys=[causer_id])
230 title = db.Column(db.String(100), nullable=False)
231 url = db.Column(db.String(200), nullable=True)
233 def __init__(self, us, cau, titl, ur):
235 title = title[:99] + "…"
243 class License(db.Model):
244 id = db.Column(db.Integer, primary_key=True)
245 name = db.Column(db.String(50), nullable=False, unique=True)
246 is_foss = db.Column(db.Boolean, nullable=False, default=True)
248 def __init__(self, v, is_foss=True):
250 self.is_foss = is_foss
256 class PackageType(enum.Enum):
262 return self.name.lower()
270 return PackageType[name.upper()]
276 return [(choice, choice.value) for choice in cls]
279 def coerce(cls, item):
280 return item if type(item) == PackageType else PackageType[item]
283 class PackagePropertyKey(enum.Enum):
286 short_desc = "Short Description"
290 media_license = "Media License"
292 provides = "Provides"
295 issueTracker = "Issue Tracker"
296 forums = "Forum Topic ID"
298 def convert(self, value):
299 if self == PackagePropertyKey.tags:
300 return ",".join([t.title for t in value])
301 elif self == PackagePropertyKey.provides:
302 return ",".join([t.name for t in value])
306 provides = db.Table("provides",
307 db.Column("package_id", db.Integer, db.ForeignKey("package.id"), primary_key=True),
308 db.Column("metapackage_id", db.Integer, db.ForeignKey("meta_package.id"), primary_key=True)
311 tags = db.Table("tags",
312 db.Column("tag_id", db.Integer, db.ForeignKey("tag.id"), primary_key=True),
313 db.Column("package_id", db.Integer, db.ForeignKey("package.id"), primary_key=True)
316 class Dependency(db.Model):
317 id = db.Column(db.Integer, primary_key=True)
318 depender_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
319 package_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
320 package = db.relationship("Package", foreign_keys=[package_id])
321 meta_package_id = db.Column(db.Integer, db.ForeignKey("meta_package.id"), nullable=True)
322 optional = db.Column(db.Boolean, nullable=False, default=False)
323 __table_args__ = (db.UniqueConstraint("depender_id", "package_id", "meta_package_id", name="_dependency_uc"), )
325 def __init__(self, depender=None, package=None, meta=None):
329 self.depender = depender
331 packageProvided = package is not None
332 metaProvided = meta is not None
334 if packageProvided and not metaProvided:
335 self.package = package
336 elif metaProvided and not packageProvided:
337 self.meta_package = meta
339 raise Exception("Either meta or package must be given, but not both!")
342 if self.meta_package:
343 return self.meta_package.name
345 return self.package.name
350 if self.package is not None:
351 return self.package.author.username + "/" + self.package.name
352 elif self.meta_package is not None:
353 return self.meta_package.name
355 raise Exception("Meta and package are both none!")
358 def SpecToList(depender, spec, cache={}):
360 arr = spec.split(",")
363 pattern1 = re.compile("^([a-z0-9_]+)$")
364 pattern2 = re.compile("^([A-Za-z0-9_]+)/([a-z0-9_]+)$")
371 if pattern1.match(x):
372 meta = MetaPackage.GetOrCreate(x, cache)
373 retval.append(Dependency(depender, meta=meta))
375 m = pattern2.match(x)
376 username = m.group(1)
378 user = User.query.filter_by(username=username).first()
380 raise Exception("Unable to find user " + username)
382 package = Package.query.filter_by(author=user, name=name).first()
384 raise Exception("Unable to find package " + name + " by " + username)
386 retval.append(Dependency(depender, package=package))
391 class Package(db.Model):
392 query_class = ArticleQuery
394 id = db.Column(db.Integer, primary_key=True)
397 author_id = db.Column(db.Integer, db.ForeignKey("user.id"))
398 name = db.Column(db.Unicode(100), nullable=False)
399 title = db.Column(db.Unicode(100), nullable=False)
400 short_desc = db.Column(db.Unicode(200), nullable=False)
401 desc = db.Column(db.UnicodeText, nullable=True)
402 type = db.Column(db.Enum(PackageType))
403 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
405 name_valid = db.CheckConstraint("name ~* '^[a-z0-9_]+$'")
407 search_vector = db.Column(TSVectorType("name", "title", "short_desc", "desc", \
408 weights={ "name": "A", "title": "B", "short_desc": "C", "desc": "D" }))
410 license_id = db.Column(db.Integer, db.ForeignKey("license.id"), nullable=False, default=1)
411 license = db.relationship("License", foreign_keys=[license_id])
412 media_license_id = db.Column(db.Integer, db.ForeignKey("license.id"), nullable=False, default=1)
413 media_license = db.relationship("License", foreign_keys=[media_license_id])
415 approved = db.Column(db.Boolean, nullable=False, default=False)
416 soft_deleted = db.Column(db.Boolean, nullable=False, default=False)
418 score = db.Column(db.Float, nullable=False, default=0)
420 review_thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=True, default=None)
421 review_thread = db.relationship("Thread", foreign_keys=[review_thread_id])
424 repo = db.Column(db.String(200), nullable=True)
425 website = db.Column(db.String(200), nullable=True)
426 issueTracker = db.Column(db.String(200), nullable=True)
427 forums = db.Column(db.Integer, nullable=True)
429 provides = db.relationship("MetaPackage", \
430 secondary=provides, lazy="subquery", order_by=db.asc("name"), \
431 backref=db.backref("packages", lazy="dynamic", order_by=db.desc("score")))
433 dependencies = db.relationship("Dependency", backref="depender", lazy="dynamic", foreign_keys=[Dependency.depender_id])
435 tags = db.relationship("Tag", secondary=tags, lazy="subquery",
436 backref=db.backref("packages", lazy=True))
438 releases = db.relationship("PackageRelease", backref="package",
439 lazy="dynamic", order_by=db.desc("package_release_releaseDate"))
441 screenshots = db.relationship("PackageScreenshot", backref="package",
442 lazy="dynamic", order_by=db.asc("package_screenshot_id"))
444 requests = db.relationship("EditRequest", backref="package",
447 def __init__(self, package=None):
451 self.author_id = package.author_id
452 self.created_at = package.created_at
453 self.approved = package.approved
455 for e in PackagePropertyKey:
456 setattr(self, e.name, getattr(package, e.name))
459 return self.license.is_foss and self.media_license.is_foss
461 def getSortedDependencies(self, is_hard=None):
462 query = self.dependencies
463 if is_hard is not None:
464 query = query.filter_by(optional=not is_hard)
467 deps.sort(key = lambda x: x.getName())
470 def getSortedHardDependencies(self):
471 return self.getSortedDependencies(True)
473 def getSortedOptionalDependencies(self):
474 return self.getSortedDependencies(False)
479 elif self.review_thread_id:
481 elif (self.type == PackageType.GAME or \
482 self.type == PackageType.TXP) and \
483 self.screenshots.count() == 0:
485 elif not self.getDownloadRelease():
487 elif "Other" in self.license.name or "Other" in self.media_license.name:
492 def getAsDictionaryKey(self):
495 "author": self.author.display_name,
496 "type": self.type.toName(),
499 def getAsDictionaryShort(self, base_url, version=None, protonum=None):
500 tnurl = self.getThumbnailURL(1)
501 release = self.getDownloadRelease(version=version, protonum=protonum)
505 "author": self.author.display_name,
506 "short_description": self.short_desc,
507 "type": self.type.toName(),
508 "release": release and release.id,
509 "thumbnail": (base_url + tnurl) if tnurl is not None else None
512 def getAsDictionary(self, base_url, version=None, protonum=None):
513 tnurl = self.getThumbnailURL(1)
514 release = self.getDownloadRelease(version=version, protonum=protonum)
516 "author": self.author.display_name,
519 "short_description": self.short_desc,
521 "type": self.type.toName(),
522 "created_at": self.created_at,
524 "license": self.license.name,
525 "media_license": self.media_license.name,
528 "website": self.website,
529 "issue_tracker": self.issueTracker,
530 "forums": self.forums,
532 "provides": [x.name for x in self.provides],
533 "thumbnail": (base_url + tnurl) if tnurl is not None else None,
534 "screenshots": [base_url + ss.url for ss in self.screenshots],
536 "url": base_url + self.getDownloadURL(),
537 "release": release and release.id,
539 "score": round(self.score * 10) / 10
542 def getThumbnailURL(self, level=2):
543 screenshot = self.screenshots.filter_by(approved=True).order_by(db.asc(PackageScreenshot.id)).first()
544 return screenshot.getThumbnailURL(level) if screenshot is not None else None
546 def getMainScreenshotURL(self):
547 screenshot = self.screenshots.filter_by(approved=True).order_by(db.asc(PackageScreenshot.id)).first()
548 return screenshot.url if screenshot is not None else None
550 def getDetailsURL(self):
551 return url_for("packages.view",
552 author=self.author.username, name=self.name)
554 def getEditURL(self):
555 return url_for("packages.create_edit",
556 author=self.author.username, name=self.name)
558 def getApproveURL(self):
559 return url_for("packages.approve",
560 author=self.author.username, name=self.name)
562 def getRemoveURL(self):
563 return url_for("packages.remove",
564 author=self.author.username, name=self.name)
566 def getNewScreenshotURL(self):
567 return url_for("packages.create_screenshot",
568 author=self.author.username, name=self.name)
570 def getCreateReleaseURL(self):
571 return url_for("packages.create_release",
572 author=self.author.username, name=self.name)
574 def getCreateEditRequestURL(self):
575 return url_for("create_edit_editrequest_page",
576 author=self.author.username, name=self.name)
578 def getBulkReleaseURL(self):
579 return url_for("packages.bulk_change_release",
580 author=self.author.username, name=self.name)
582 def getDownloadURL(self):
583 return url_for("packages.download",
584 author=self.author.username, name=self.name)
586 def getDownloadRelease(self, version=None, protonum=None):
587 if version is None and protonum is not None:
588 version = MinetestRelease.query.filter(MinetestRelease.protocol >= int(protonum)).first()
589 if version is not None:
595 for rel in self.releases:
596 if rel.approved and (version is None or
597 ((rel.min_rel is None or rel.min_rel_id <= version) and \
598 (rel.max_rel is None or rel.max_rel_id >= version))):
603 def getDownloadCount(self):
605 for release in self.releases:
606 counter += release.downloads
609 def checkPerm(self, user, perm):
610 if not user.is_authenticated:
613 if type(perm) == str:
614 perm = Permission[perm]
615 elif type(perm) != Permission:
616 raise Exception("Unknown permission given to Package.checkPerm()")
618 isOwner = user == self.author
620 if perm == Permission.CREATE_THREAD:
621 return user.rank.atLeast(UserRank.MEMBER)
623 # Members can edit their own packages, and editors can edit any packages
624 if perm == Permission.MAKE_RELEASE or perm == Permission.ADD_SCREENSHOTS:
625 return isOwner or user.rank.atLeast(UserRank.EDITOR)
627 if perm == Permission.EDIT_PACKAGE or perm == Permission.APPROVE_CHANGES:
629 return user.rank.atLeast(UserRank.MEMBER if self.approved else UserRank.NEW_MEMBER)
631 return user.rank.atLeast(UserRank.EDITOR)
633 # Anyone can change the package name when not approved, but only editors when approved
634 elif perm == Permission.CHANGE_NAME:
635 return not self.approved or user.rank.atLeast(UserRank.EDITOR)
637 # Editors can change authors and approve new packages
638 elif perm == Permission.APPROVE_NEW or perm == Permission.CHANGE_AUTHOR:
639 return user.rank.atLeast(UserRank.EDITOR)
641 elif perm == Permission.APPROVE_RELEASE or perm == Permission.APPROVE_SCREENSHOT:
642 return user.rank.atLeast(UserRank.TRUSTED_MEMBER if isOwner else UserRank.EDITOR)
644 # Moderators can delete packages
645 elif perm == Permission.DELETE_PACKAGE or perm == Permission.UNAPPROVE_PACKAGE \
646 or perm == Permission.CHANGE_RELEASE_URL:
647 return user.rank.atLeast(UserRank.MODERATOR)
650 raise Exception("Permission {} is not related to packages".format(perm.name))
652 def setStartScore(self):
653 downloads = db.session.query(func.sum(PackageRelease.downloads)). \
654 filter(PackageRelease.package_id == self.id).scalar() or 0
658 topic = self.forums and ForumTopic.query.get(self.forums)
660 months = (datetime.datetime.now() - topic.created_at).days / 30
662 forum_score = topic.views / max(years, 0.0416) + 80*min(max(months, 0.5), 6)
663 forum_bonus = topic.views + topic.posts
665 self.score = max(downloads, forum_score * 0.6) + forum_bonus
667 if self.getMainScreenshotURL() is None:
670 if not self.license.is_foss or not self.media_license.is_foss:
674 class MetaPackage(db.Model):
675 id = db.Column(db.Integer, primary_key=True)
676 name = db.Column(db.String(100), unique=True, nullable=False)
677 dependencies = db.relationship("Dependency", backref="meta_package", lazy="dynamic")
679 def __init__(self, name=None):
686 def ListToSpec(list):
687 return ",".join([str(x) for x in list])
690 def GetOrCreate(name, cache={}):
693 mp = MetaPackage.query.filter_by(name=name).first()
696 mp = MetaPackage(name)
703 def SpecToList(spec, cache={}):
705 arr = spec.split(",")
708 pattern = re.compile("^([a-z0-9_]+)$")
715 if not pattern.match(x):
718 retval.append(MetaPackage.GetOrCreate(x, cache))
723 id = db.Column(db.Integer, primary_key=True)
724 name = db.Column(db.String(100), unique=True, nullable=False)
725 title = db.Column(db.String(100), nullable=False)
726 backgroundColor = db.Column(db.String(6), nullable=False)
727 textColor = db.Column(db.String(6), nullable=False)
729 def __init__(self, title, backgroundColor="000000", textColor="ffffff"):
731 self.backgroundColor = backgroundColor
732 self.textColor = textColor
735 regex = re.compile("[^a-z_]")
736 self.name = regex.sub("", self.title.lower().replace(" ", "_"))
739 class MinetestRelease(db.Model):
740 id = db.Column(db.Integer, primary_key=True)
741 name = db.Column(db.String(100), unique=True, nullable=False)
742 protocol = db.Column(db.Integer, nullable=False, default=0)
744 def __init__(self, name=None, protocol=0):
746 self.protocol = protocol
749 return None if self.name == "None" else self
752 class PackageRelease(db.Model):
753 id = db.Column(db.Integer, primary_key=True)
755 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
756 title = db.Column(db.String(100), nullable=False)
757 releaseDate = db.Column(db.DateTime, nullable=False)
758 url = db.Column(db.String(200), nullable=False)
759 approved = db.Column(db.Boolean, nullable=False, default=False)
760 task_id = db.Column(db.String(37), nullable=True)
761 commit_hash = db.Column(db.String(41), nullable=True, default=None)
762 downloads = db.Column(db.Integer, nullable=False, default=0)
764 min_rel_id = db.Column(db.Integer, db.ForeignKey("minetest_release.id"), nullable=True, server_default=None)
765 min_rel = db.relationship("MinetestRelease", foreign_keys=[min_rel_id])
767 max_rel_id = db.Column(db.Integer, db.ForeignKey("minetest_release.id"), nullable=True, server_default=None)
768 max_rel = db.relationship("MinetestRelease", foreign_keys=[max_rel_id])
770 # If the release is approved, then the task_id must be null and the url must be present
771 CK_approval_valid = db.CheckConstraint("not approved OR (task_id IS NULL AND (url = '') IS NOT FALSE)")
773 def getEditURL(self):
774 return url_for("packages.edit_release",
775 author=self.package.author.username,
776 name=self.package.name,
779 def getDeleteURL(self):
780 return url_for("packages.delete_release",
781 author=self.package.author.username,
782 name=self.package.name,
785 def getDownloadURL(self):
786 return url_for("packages.download_release",
787 author=self.package.author.username,
788 name=self.package.name,
793 self.releaseDate = datetime.datetime.now()
795 def approve(self, user):
796 if self.package.approved and \
797 not self.package.checkPerm(user, Permission.APPROVE_RELEASE):
800 assert self.task_id is None and self.url is not None and self.url != ""
805 def checkPerm(self, user, perm):
806 if not user.is_authenticated:
809 if type(perm) == str:
810 perm = Permission[perm]
811 elif type(perm) != Permission:
812 raise Exception("Unknown permission given to PackageRelease.checkPerm()")
814 isOwner = user == self.package.author
816 if perm == Permission.DELETE_RELEASE:
817 if user.rank.atLeast(UserRank.ADMIN):
820 if not (isOwner or user.rank.atLeast(UserRank.EDITOR)):
823 if not self.package.approved or self.task_id is not None:
826 count = PackageRelease.query \
827 .filter_by(package_id=self.package_id) \
828 .filter(PackageRelease.id > self.id) \
833 raise Exception("Permission {} is not related to releases".format(perm.name))
836 # class PackageReview(db.Model):
837 # id = db.Column(db.Integer, primary_key=True)
838 # package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
839 # thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=False)
840 # recommend = db.Column(db.Boolean, nullable=False, default=True)
843 class PackageScreenshot(db.Model):
844 id = db.Column(db.Integer, primary_key=True)
845 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
846 title = db.Column(db.String(100), nullable=False)
847 url = db.Column(db.String(100), nullable=False)
848 approved = db.Column(db.Boolean, nullable=False, default=False)
851 def getEditURL(self):
852 return url_for("packages.edit_screenshot",
853 author=self.package.author.username,
854 name=self.package.name,
857 def getThumbnailURL(self, level=2):
858 return self.url.replace("/uploads/", ("/thumbnails/{:d}/").format(level))
861 class APIToken(db.Model):
862 id = db.Column(db.Integer, primary_key=True)
863 access_token = db.Column(db.String(34), unique=True)
864 name = db.Column(db.String(100), nullable=False)
865 owner_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
866 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
868 def canOperateOnPackage(self, package):
869 return packages.count() == 0 or package in packages
872 class EditRequest(db.Model):
873 id = db.Column(db.Integer, primary_key=True)
875 package_id = db.Column(db.Integer, db.ForeignKey("package.id"))
876 author_id = db.Column(db.Integer, db.ForeignKey("user.id"))
878 title = db.Column(db.String(100), nullable=False)
879 desc = db.Column(db.String(1000), nullable=True)
884 status = db.Column(db.Integer, nullable=False, default=0)
886 changes = db.relationship("EditRequestChange", backref="request",
890 return url_for("view_editrequest_page",
891 author=self.package.author.username,
892 name=self.package.name,
895 def getApproveURL(self):
896 return url_for("approve_editrequest_page",
897 author=self.package.author.username,
898 name=self.package.name,
901 def getRejectURL(self):
902 return url_for("reject_editrequest_page",
903 author=self.package.author.username,
904 name=self.package.name,
907 def getEditURL(self):
908 return url_for("create_edit_editrequest_page",
909 author=self.package.author.username,
910 name=self.package.name,
913 def applyAll(self, package):
914 for change in self.changes:
915 change.apply(package)
918 def checkPerm(self, user, perm):
919 if not user.is_authenticated:
922 if type(perm) == str:
923 perm = Permission[perm]
924 elif type(perm) != Permission:
925 raise Exception("Unknown permission given to EditRequest.checkPerm()")
927 isOwner = user == self.author
929 # Members can edit their own packages, and editors can edit any packages
930 if perm == Permission.EDIT_EDITREQUEST:
931 return isOwner or user.rank.atLeast(UserRank.EDITOR)
934 raise Exception("Permission {} is not related to packages".format(perm.name))
939 class EditRequestChange(db.Model):
940 id = db.Column(db.Integer, primary_key=True)
942 request_id = db.Column(db.Integer, db.ForeignKey("edit_request.id"))
943 key = db.Column(db.Enum(PackagePropertyKey), nullable=False)
945 # TODO: make diff instead
946 oldValue = db.Column(db.Text, nullable=True)
947 newValue = db.Column(db.Text, nullable=True)
949 def apply(self, package):
950 if self.key == PackagePropertyKey.tags:
952 for tagTitle in self.newValue.split(","):
953 tag = Tag.query.filter_by(title=tagTitle.strip()).first()
954 package.tags.append(tag)
957 setattr(package, self.key.name, self.newValue)
960 watchers = db.Table("watchers",
961 db.Column("user_id", db.Integer, db.ForeignKey("user.id"), primary_key=True),
962 db.Column("thread_id", db.Integer, db.ForeignKey("thread.id"), primary_key=True)
965 class Thread(db.Model):
966 id = db.Column(db.Integer, primary_key=True)
968 package_id = db.Column(db.Integer, db.ForeignKey("package.id"), nullable=True)
969 package = db.relationship("Package", foreign_keys=[package_id])
971 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
972 title = db.Column(db.String(100), nullable=False)
973 private = db.Column(db.Boolean, server_default="0")
975 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
977 replies = db.relationship("ThreadReply", backref="thread", lazy="dynamic")
979 watchers = db.relationship("User", secondary=watchers, lazy="subquery", \
980 backref=db.backref("watching", lazy=True))
983 def getSubscribeURL(self):
984 return url_for("threads.subscribe",
987 def getUnsubscribeURL(self):
988 return url_for("threads.unsubscribe",
991 def checkPerm(self, user, perm):
992 if not user.is_authenticated:
993 return not self.private
995 if type(perm) == str:
996 perm = Permission[perm]
997 elif type(perm) != Permission:
998 raise Exception("Unknown permission given to Thread.checkPerm()")
1000 isOwner = user == self.author or (self.package is not None and self.package.author == user)
1002 if perm == Permission.SEE_THREAD:
1003 return not self.private or isOwner or user.rank.atLeast(UserRank.EDITOR)
1006 raise Exception("Permission {} is not related to threads".format(perm.name))
1008 class ThreadReply(db.Model):
1009 id = db.Column(db.Integer, primary_key=True)
1010 thread_id = db.Column(db.Integer, db.ForeignKey("thread.id"), nullable=False)
1011 comment = db.Column(db.String(500), nullable=False)
1012 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
1013 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
1016 REPO_BLACKLIST = [".zip", "mediafire.com", "dropbox.com", "weebly.com", \
1017 "minetest.net", "dropboxusercontent.com", "4shared.com", \
1018 "digitalaudioconcepts.com", "hg.intevation.org", "www.wtfpl.net", \
1019 "imageshack.com", "imgur.com"]
1021 class ForumTopic(db.Model):
1022 topic_id = db.Column(db.Integer, primary_key=True, autoincrement=False)
1023 author_id = db.Column(db.Integer, db.ForeignKey("user.id"), nullable=False)
1024 author = db.relationship("User")
1026 wip = db.Column(db.Boolean, server_default="0")
1027 discarded = db.Column(db.Boolean, server_default="0")
1029 type = db.Column(db.Enum(PackageType), nullable=False)
1030 title = db.Column(db.String(200), nullable=False)
1031 name = db.Column(db.String(30), nullable=True)
1032 link = db.Column(db.String(200), nullable=True)
1034 posts = db.Column(db.Integer, nullable=False)
1035 views = db.Column(db.Integer, nullable=False)
1037 created_at = db.Column(db.DateTime, nullable=False, default=datetime.datetime.utcnow)
1039 def getRepoURL(self):
1040 if self.link is None:
1043 for item in REPO_BLACKLIST:
1044 if item in self.link:
1047 return self.link.replace("repo.or.cz/w/", "repo.or.cz/")
1049 def getAsDictionary(self):
1051 "author": self.author.username,
1053 "type": self.type.toName(),
1054 "title": self.title,
1055 "id": self.topic_id,
1057 "posts": self.posts,
1058 "views": self.views,
1060 "discarded": self.discarded,
1061 "created_at": self.created_at.isoformat(),
1064 def checkPerm(self, user, perm):
1065 if not user.is_authenticated:
1068 if type(perm) == str:
1069 perm = Permission[perm]
1070 elif type(perm) != Permission:
1071 raise Exception("Unknown permission given to ForumTopic.checkPerm()")
1073 if perm == Permission.TOPIC_DISCARD:
1074 return self.author == user or user.rank.atLeast(UserRank.EDITOR)
1077 raise Exception("Permission {} is not related to topics".format(perm.name))
1081 user_manager = UserManager(app, db, User)