ryg/royalnet
ryg/royalnet
1
Fork 0
mirror of https://github.com/RYGhub/royalnet.git synced 2024-11-23 11:34:18 +00:00
Code Activity

Stuffy stuff

Browse source
This commit is contained in:
Steffo 2020-06-22 18:08:09 +02:00
parent 6e8d963f99
commit cfb9f2017b
Signed by: steffo
GPG key ID: 896A80F55F7C97F0
5 changed files with 56 additions and 81 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
README.md
View file

@ -8,11 +8,11 @@ This pack adds a small Wiki to Royalnet, allowing communities to create their ow
[Packs."wikipack"]
# The roles that are authorized by default to complete certain actions.
# Setting them to an empty string disables the authentication requirement, allowing unauthenticated users that privilege
# Setting them to * disables the authentication requirement, allowing unauthenticated users that privilege
[Packs."wikipack".roles]
# Users with this role will be able to view wiki pages that do not have a different role set.
view = ""
view = "*"
# Users with this role will be able to create new wiki pages.
create = "wiki_create"

94
wikipack/stars/api_wiki.py
View file

@ -22,8 +22,12 @@ class ApiWikiStar(rca.ApiStar):
"title": "The title of the page.",
"contents": "The contents of the page.",
"format": "(Optional) The format of the page. Default is 'gfm' for GitHub Flavored Markdown.",
"role_to_view": "(Optional) The role required to view this page. Be careful to not lock yourself out!",
"role_to_edit": "(Optional) The role required to edit this page. Be careful to not lock yourself out!",
"role_to_view": "(Optional) The role required to view this page.\n\n"
"A * means unauthenticated users can view this page.\n\n"
"Be careful to not lock yourself out!",
"role_to_edit": "(Optional) The role required to edit this page.\n\n"
"A * means unauthenticated users can edit this page.\n\n"
"Be careful to not lock yourself out!",
},
"put": {
"page_id": "The id of the wiki page to create a new revision of.",
@ -31,8 +35,12 @@ class ApiWikiStar(rca.ApiStar):
"title": "The title of the page.",
"contents": "The contents of the page.",
"format": "The format of the page. Default is 'gfm' for GitHub Flavored Markdown.",
"role_to_view": "The role required to view this page. Be careful to not lock yourself out!",
"role_to_edit": "The role required to edit this page. Be careful to not lock yourself out!",
"role_to_view": "The role required to view this page.\n\n"
"A * means unauthenticated users can view this page.\n\n"
"Be careful to not lock yourself out!",
"role_to_edit": "The role required to edit this page.\n\n"
"A * means unauthenticated users can edit this page.\n\n"
"Be careful to not lock yourself out!",
},
"delete": {
"page_id": "The id of the wiki page to delete.",
@ -48,12 +56,10 @@ class ApiWikiStar(rca.ApiStar):
@property
def default_view_role(self) -> str:
return self.config["wikipack"]["roles"]["view"]
return self.config["roles"]["view"]
async def can_view(self, user: rbt.User, page: WikiPage) -> bool:
lr = page.latest_revision
if lr.role_to_view == "":
async def can_view(self, user: rbt.User, lr: WikiRevision) -> bool:
if lr.role_to_view == "*":
return True
if lr.role_to_view:
@ -64,12 +70,10 @@ class ApiWikiStar(rca.ApiStar):
@property
def default_edit_role(self) -> str:
return self.config["wikipack"]["roles"]["edit"]
return self.config["roles"]["edit"]
async def can_edit(self, user: rbt.User, page: WikiPage) -> bool:
lr = page.latest_revision
if lr.role_to_edit == "":
async def can_edit(self, user: rbt.User, lr: WikiRevision) -> bool:
if lr.role_to_edit == "*":
return True
if lr.role_to_edit:
@ -80,19 +84,22 @@ class ApiWikiStar(rca.ApiStar):
@property
def create_role(self) -> str:
return self.config["wikipack"]["roles"]["create"]
return self.config["roles"]["create"]
async def can_create(self, user: rbt.User) -> bool:
if self.create_role == "*":
return True
if self.create_role in user.roles or self.admin_role in user.roles:
return True
return False
@property
def delete_role(self) -> str:
return self.config["wikipack"]["roles"]["delete"]
return self.config["roles"]["delete"]
async def can_delete(self, user: rbt.User) -> bool:
if self.delete_role == "":
if self.delete_role == "*":
return True
if self.delete_role in user.roles or self.admin_role in user.roles:
@ -101,28 +108,32 @@ class ApiWikiStar(rca.ApiStar):
@property
def admin_role(self) -> str:
return self.config["wikipack"]["roles"]["admin"]
return self.config["roles"]["admin"]
async def find_page(self, data: rca.ApiData) -> Tuple[WikiPage, WikiRevision]:
WikiPageT = self.alchemy.get(WikiPage)
async def find_lr(self, data: rca.ApiData) -> WikiRevision:
WikiRevisionT = self.alchemy.get(WikiRevision)
page_id = data.int("page_id")
page: WikiPage = await ru.asyncify(
data.session.query(WikiPageT).filter_by(page_id=page_id).one_or_none
lr: WikiRevision = await ru.asyncify(
data.session
.query(WikiRevisionT)
.filter_by(page_id=page_id)
.order_by(WikiRevisionT.revision_id.desc())
.first
)
if page is None:
if lr is None:
raise rca.NotFoundError(f"No page found with the id `{page_id}`.")
return page, page.latest_revision
return lr
async def get(self, data: rca.ApiData) -> ru.JSON:
"""Get the details of a specific Wiki page."""
page, lr = await self.find_page(data)
lr = await self.find_lr(data)
user = await data.user()
if not self.can_view(user, page):
if not await self.can_view(user, lr):
raise rca.ForbiddenError(f"Viewing this page requires the `{lr.role_to_view}` role.")
return lr.json()
@ -133,7 +144,7 @@ class ApiWikiStar(rca.ApiStar):
user = await data.user()
if not self.can_create(user):
if not await self.can_create(user):
raise rca.ForbiddenError(f"Creating a new page requires the `{self.create_role}` role.")
category = data.str("category", optional=False)
@ -143,12 +154,7 @@ class ApiWikiStar(rca.ApiStar):
role_to_view = data.str("role_to_view", optional=True)
role_to_edit = data.str("role_to_edit", optional=True)
page = WikiPage()
data.session.add(page)
data.session.flush()
nr: WikiRevision = WikiRevisionT(
page_id=page.page_id,
category=category,
title=title,
contents=contents,
@ -160,7 +166,7 @@ class ApiWikiStar(rca.ApiStar):
)
data.session.add(nr)
await data.session.commit()
await data.session_commit()
return nr.json()
@ -168,10 +174,10 @@ class ApiWikiStar(rca.ApiStar):
"""Edit a specific Wiki page, creating a new revision."""
WikiRevisionT = self.alchemy.get(WikiRevision)
page, lr = await self.find_page(data)
lr = await self.find_lr(data)
user = await data.user()
if not self.can_edit(user, page):
if not await self.can_edit(user, lr):
raise rca.ForbiddenError(f"Editing this page requires the `{lr.role_to_edit}` role.")
category = data.str("category", optional=True)
@ -182,7 +188,7 @@ class ApiWikiStar(rca.ApiStar):
role_to_edit = data.str("role_to_edit", optional=True)
nr: WikiRevision = WikiRevisionT(
page_id=page.page_id,
page_id=lr.page_id,
category=category or lr.category,
title=title or lr.title,
contents=contents or lr.contents,
@ -194,29 +200,33 @@ class ApiWikiStar(rca.ApiStar):
)
data.session.add(nr)
await data.session.commit()
await data.session_commit()
return nr.json()
async def delete(self, data: rca.ApiData) -> ru.JSON:
"""Delete a specific Wiki page and all its revisions."""
WikiRevisionT = self.alchemy.get(WikiRevision)
WikiDeletionT = self.alchemy.get(WikiDeletion)
page, lr = await self.find_page(data)
lr = await self.find_lr(data)
user = await data.user()
if not self.can_delete(user):
if not await self.can_delete(user):
raise rca.ForbiddenError(f"Deleting pages requires the `{self.delete_role}` role.")
deletion = WikiDeletionT(
page_id=page.page_id,
page_id=lr.page_id,
deleted_by=user,
timestamp=datetime.datetime.now(),
)
data.session.delete(page)
pages = await ru.asyncify(
data.session.query(WikiRevisionT).filter_by(page_id=lr.page_id).all
)
data.session.delete(pages)
data.session.add(deletion)
await data.session.commit()
await data.session_commit()
return deletion.json()

2
wikipack/tables/__init__.py
View file

@ -1,11 +1,9 @@
# Imports go here!
from .wikipage import WikiPage
from .wikirevision import WikiRevision
from .wikideletion import WikiDeletion
# Enter the tables of your Pack here!
available_tables = [
WikiPage,
WikiRevision,
WikiDeletion,
]

23
wikipack/tables/wikipage.py
View file

@ -1,23 +0,0 @@
from typing import *
from sqlalchemy import *
from sqlalchemy.orm import *
from sqlalchemy.ext.declarative import declared_attr
if TYPE_CHECKING:
from .wikirevision import WikiRevision
class WikiPage:
__tablename__ = "wikipages"
@declared_attr
def page_id(self) -> int:
return Column(Integer, primary_key=True)
@declared_attr
def latest_revision_id(self) -> int:
return Column(Integer, ForeignKey("wikirevisions.revision_id"), nullable=False)
@declared_attr
def latest_revision(self) -> "WikiRevision":
return relationship("WikiRevision", foreign_keys=self.latest_revision_id, uselist=False)

14
wikipack/tables/wikirevision.py
View file

@ -8,7 +8,6 @@ import datetime
if TYPE_CHECKING:
from royalnet.backpack.tables import User
from .wikipage import WikiPage
class WikiRevision:
@ -16,17 +15,11 @@ class WikiRevision:
@declared_attr
def page_id(self) -> int:
return Column(Integer, ForeignKey("wikipages.page_id"), nullable=False)
@declared_attr
def page(self) -> "WikiPage":
return relationship("WikiPage",
foreign_keys=self.page_id,
backref=backref("revisions", cascade="save-update, merge, delete"))
return Column(Integer, Sequence('wikirevision_page_id_seq'), primary_key=True)
@declared_attr
def revision_id(self) -> int:
return Column(Integer, primary_key=True)
return Column(Integer, Sequence('wikirevision_revision_id_seq'), primary_key=True)
@declared_attr
def category(self) -> str:
@ -66,9 +59,6 @@ class WikiRevision:
def role_to_edit(self) -> str:
return Column(String)
def set_as_latest(self) -> None:
self.page.latest_revision = self
def json_list(self):
return {
"page_id": self.page_id,