qcanvas 1.2.0__py3-none-any.whl → 2026.1.19__py3-none-any.whl

qcanvas/ui/qml_components/qml_bridge_types.py

@@ -0,0 +1,95 @@
+from PySide6.QtCore import Property, QObject, Signal
+from PySide6.QtQml import ListProperty, QmlElement
+from libqcanvas.database.tables import ResourceDownloadState
+
+
+QML_IMPORT_NAME = "QCanvas"
+QML_IMPORT_MAJOR_VERSION = 1
+
+
+@QmlElement
+class Attachment(QObject):
+    file_name_changed = Signal()
+    resource_id_changed = Signal()
+    download_state_changed = Signal()
+
+    # Emitted by AttachmentsListDelegate when the user clicks on an attachment
+    opened = Signal(str)
+
+    def __init__(
+        self,
+        file_name: str,
+        resource_id: str,
+        download_state: ResourceDownloadState,
+        parent: QObject | None = None,
+    ):
+        super().__init__(parent)
+        self._file_name = file_name
+        self._resource_id = resource_id
+        self._download_state = download_state.name
+
+    @Property(str, notify=file_name_changed)
+    def file_name(self) -> str:
+        return self._file_name
+
+    @Property(str, notify=resource_id_changed)
+    def resource_id(self) -> str:
+        return self._resource_id
+
+    @Property(str, notify=download_state_changed)
+    def download_state(self) -> str:
+        return self._download_state
+
+    @download_state.setter
+    def download_state(self, value: ResourceDownloadState):
+        if value.name != self._download_state:
+            self._download_state = value.name
+            self.download_state_changed.emit()
+
+
+@QmlElement
+class Comment(QObject):
+    body_changed = Signal()
+    author_changed = Signal()
+    date_changed = Signal()
+    attachments_changed = Signal()
+
+    def __init__(
+        self,
+        body: str,
+        author: str,
+        date: str,
+        attachments: list[Attachment],
+        parent: QObject | None = None,
+    ):
+        super().__init__(parent)
+
+        self._body = body
+        self._author = author
+        self._date = date
+        self._attachments = attachments
+
+    @Property(str, notify=body_changed)
+    def body(self) -> str:
+        return self._body
+
+    @Property(str, notify=date_changed)
+    def date(self) -> str:
+        return self._date
+
+    @Property(str, notify=author_changed)
+    def author(self) -> str:
+        return self._author
+
+    def attachment(self, n) -> Attachment:
+        return self._attachments[n]
+
+    def attachment_count(self) -> int:
+        return len(self._attachments)
+
+    # You must set `count`, `at` and `notify` EXPLICTLY (even if you name them according to the examples, which examples are all inconsistent and wrong).
+    # Qt?? Are you ok???
+    # Oh and you have to use `.length` instead of `.count` on the QML side because javascript.
+    attachments = ListProperty(
+        Attachment, count=attachment_count, at=attachment, notify=attachments_changed
+    )

qcanvas/ui/qml_components/qml_pane.py

@@ -0,0 +1,21 @@
+from PySide6.QtCore import QUrl
+from PySide6.QtQuick import QQuickView
+from PySide6.QtWidgets import QGroupBox, QWidget
+
+from qcanvas.theme import app_theme
+from qcanvas.util.context_dict import ContextDict
+import qcanvas.util.ui_tools as ui
+
+
+class QmlPane(QGroupBox):
+    def __init__(self, qml_path: QUrl, parent: QWidget | None = None):
+        super().__init__(parent)
+        self.qview = QQuickView(parent)
+        self._qml_path = qml_path
+        self.ctx = ContextDict(self.qview.rootContext())
+        self.ctx["appTheme"] = app_theme
+
+        self.setLayout(ui.hbox(QWidget.createWindowContainer(self.qview, self)))
+
+    def load_view(self):
+        self.qview.setSource(self._qml_path)

qcanvas/ui/setup/setup_checker.py

@@ -1,6 +1,6 @@
 import logging
 
-import qcanvas.util.settings as settings
+import qcanvas.settings as settings
 from qcanvas.util.url_checker import is_url
 
 _logger = logging.getLogger(__name__)

qcanvas/ui/setup/setup_dialog.py

@@ -2,15 +2,26 @@ import logging
 from threading import Semaphore
 from typing import Optional
 
+from libqcanvas_clients.canvas import CanvasClient, CanvasClientConfig
+from libqcanvas_clients.panopto import PanoptoClient, PanoptoClientConfig
+from libqcanvas_clients.util.request_exceptions import ConfigInvalidError
+from PySide6.QtCore import Qt, QUrl, Slot
+from PySide6.QtGui import QDesktopServices, QIcon
+from PySide6.QtWidgets import (
+    QCheckBox,
+    QDialog,
+    QDialogButtonBox,
+    QErrorMessage,
+    QLabel,
+    QLineEdit,
+    QMessageBox,
+    QProgressBar,
+    QVBoxLayout,
+    QWidget,
+)
 from qasync import asyncSlot
-from qcanvas_api_clients.canvas import CanvasClient, CanvasClientConfig
-from qcanvas_api_clients.panopto import PanoptoClient, PanoptoClientConfig
-from qcanvas_api_clients.util.request_exceptions import ConfigInvalidError
-from qtpy.QtCore import Qt, QUrl, Signal, Slot
-from qtpy.QtGui import QDesktopServices, QIcon
-from qtpy.QtWidgets import *
-
-import qcanvas.util.settings as settings
+
+import qcanvas.settings as settings
 from qcanvas import icons
 from qcanvas.util.layouts import GridItem, grid_layout_widget, layout
 from qcanvas.util.url_checker import is_url
@@ -85,8 +96,6 @@ class _InputRow:
 
 
 class SetupDialog(QDialog):
-    closed = Signal()
-
     def __init__(self):
         super().__init__()
 
@@ -113,9 +122,11 @@ class SetupDialog(QDialog):
             is_password=True,
         )
         self._disable_panopto_checkbox = QCheckBox("Continue without Panopto")
+        self._disable_panopto_checkbox.setChecked(settings.client.panopto_disabled)
         self._disable_panopto_checkbox.checkStateChanged.connect(
             self._disable_panopto_check_changed
         )
+        self._panopto_url_box.enabled = not settings.client.panopto_disabled
         self._button_box = self._setup_button_box()
         self._waiting_indicator = self._setup_progress_bar()
 
@@ -254,7 +265,9 @@ class SetupDialog(QDialog):
             QMessageBox.StandardButton.Ok,
             self,
         )
-        msg.accepted.connect(self._open_panopto_login)
+        msg.accepted.connect(
+            self._open_panopto_login, Qt.ConnectionType.SingleShotConnection
+        )
         msg.show()
 
     @Slot()
@@ -274,8 +287,7 @@ class SetupDialog(QDialog):
 
         settings.client.canvas_api_key = self._canvas_api_key_box.text
 
-        self.closed.emit()
-        self.close()
+        self.accept()
 
     @Slot()
     def _help_requested(self) -> None:
@@ -288,7 +300,9 @@ class SetupDialog(QDialog):
             "Don't share this key. You can revoke it at any time.",
             parent=self,
         )
-        msg.accepted.connect(self._open_tutorial)
+        msg.accepted.connect(
+            self._open_tutorial, Qt.ConnectionType.SingleShotConnection
+        )
         msg.show()
 
     @Slot()

qcanvas/util/auto_downloader.py

@@ -1,12 +1,13 @@
 import asyncio
 import logging
 
-import qcanvas_backend.database.types as db
-from qcanvas_backend.net.resources.download.resource_manager import ResourceManager
-from qcanvas_backend.net.sync.sync_receipt import SyncReceipt
-from qtpy.QtWidgets import QMessageBox, QWidget
+from PySide6.QtCore import Qt
+from libqcanvas import db
+from libqcanvas.net.resources.download.resource_manager import ResourceManager
+from libqcanvas.net.sync.sync_receipt import SyncReceipt
+from PySide6.QtWidgets import QMessageBox, QWidget
 
-from qcanvas.util import settings
+import qcanvas.settings as settings
 
 _logger = logging.getLogger(__name__)
 
@@ -20,7 +21,7 @@ async def download_new_resources(
 ) -> None:
     resources_to_download = []
 
-    for file_id in receipt.updated_resources:
+    for file_id in receipt.updates[db.Resource]:
         resource = all_resources[file_id]
 
         if _should_auto_download_resource(resource, resource_manager=downloader):
@@ -36,7 +37,8 @@ async def download_new_resources(
         msg.accepted.connect(
             lambda: asyncio.get_running_loop().create_task(
                 downloader.batch_download(resources_to_download),
-            )
+            ),
+            Qt.ConnectionType.SingleShotConnection,
         )
     else:
         await downloader.batch_download(resources_to_download)

qcanvas/util/basic_fonts.py

@@ -1,5 +1,5 @@
-from qtpy.QtGui import QFont
-from qtpy.QtWidgets import QLabel
+from PySide6.QtGui import QFont
+from PySide6.QtWidgets import QLabel
 
 normal_font = QFont()
 bold_font = QFont()

qcanvas/util/context_dict.py

@@ -0,0 +1,12 @@
+from PySide6.QtQml import QQmlContext
+
+
+class ContextDict:
+    def __init__(self, context: QQmlContext):
+        self._context = context
+
+    def __getitem__(self, item):
+        return self._context.contextProperty(item)
+
+    def __setitem__(self, key, value):
+        self._context.setContextProperty(key, value)

qcanvas/util/file_icons.py

@@ -1,9 +1,10 @@
 import logging
 import os.path
 
-from qtpy.QtCore import QFileInfo, QMimeDatabase
-from qtpy.QtGui import QIcon
-from qtpy.QtWidgets import QApplication, QFileIconProvider, QStyle
+import cachetools
+from PySide6.QtCore import QFileInfo, QMimeDatabase
+from PySide6.QtGui import QIcon
+from PySide6.QtWidgets import QApplication, QFileIconProvider, QStyle
 
 import qcanvas.util.runtime as runtime
 
@@ -18,13 +19,9 @@ if runtime.is_running_on_windows:
 
 else:
     _mime_database = QMimeDatabase()
-    # This must be initialised lazily because the QApplication might not be initialised at this time
-    _default_icon: QIcon | None = None
     _icon_for_suffix: dict[str, QIcon] = {}
 
     def icon_for_filename(file_name: str) -> QIcon:
-        global _default_icon
-
         file_suffix = os.path.splitext(file_name)[1]
 
         # Check if we already know what icon this file type has
@@ -39,16 +36,11 @@ else:
                 _icon_for_suffix[file_suffix] = icon
                 return icon
 
-        _lazy_init_default_icon()
-
-        # No icon for this type of file was found, return default icon
-        _icon_for_suffix[file_suffix] = _default_icon
-        return _default_icon
-
-    def _lazy_init_default_icon() -> None:
-        global _default_icon
+        # No icon for this type of file was found, use default icon
+        icon = _default_icon()
+        _icon_for_suffix[file_suffix] = icon
+        return icon
 
-        if _default_icon is None:
-            _default_icon = QApplication.style().standardIcon(
-                QStyle.StandardPixmap.SP_FileIcon
-            )
+    @cachetools.cached(cachetools.LRUCache(maxsize=1))
+    def _default_icon() -> QIcon:
+        return QApplication.style().standardIcon(QStyle.StandardPixmap.SP_FileIcon)

qcanvas/util/layouts.py

@@ -1,13 +1,11 @@
 import logging
-from typing import *
+from typing import Iterable, NamedTuple
 
-from qtpy.QtCore import Qt
-from qtpy.QtWidgets import *
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import QGridLayout, QLayout, QWidget
 
 _logger = logging.getLogger(__name__)
 
-T = TypeVar("T")
-
 
 class GridItem(NamedTuple):
     widget: QWidget
@@ -16,13 +14,13 @@ class GridItem(NamedTuple):
     alignment: Qt.AlignmentFlag = Qt.AlignmentFlag.AlignLeft
 
 
-def layout_widget(layout_type: Type[T], *items: QWidget, **kwargs) -> QWidget:
+def layout_widget[T](layout_type: type[T], *items: QWidget, **kwargs) -> QWidget:
     widget = QWidget()
     widget.setLayout(layout(layout_type, *items, **kwargs))
     return widget
 
 
-def layout(layout_type: Type[T], *items: QWidget | QLayout, **kwargs) -> T:
+def layout[T](layout_type: type[T], *items: QWidget | QLayout, **kwargs) -> T:
     result_layout: QLayout = layout_type(**kwargs)
 
     for item in items:

qcanvas/util/paths.py

@@ -4,21 +4,30 @@ from pathlib import Path
 
 import cachetools
 import platformdirs
-from qtpy.QtCore import QSettings
+from PySide6.QtCore import QSettings
 
-from qcanvas.util.runtime import *
+from qcanvas.util.runtime import (
+    is_running_as_compiled,
+    is_running_as_flatpak,
+    is_running_portable,
+)
 
 _logger = logging.getLogger(__name__)
 
 
-def ui_storage() -> Path:
-    return root() / ".UI"
-
-
 def data_storage() -> Path:
     return root()
 
 
+def config_storage() -> Path:
+    if is_running_portable:
+        return root()
+    else:
+        path = platformdirs.user_config_path("QCanvasTeam", "QCanvas")
+        path.mkdir(parents=True, exist_ok=True)
+        return path
+
+
 def client_settings() -> QSettings:
     if is_running_portable:
         return QSettings("QCanvas.ini", QSettings.Format.IniFormat)
@@ -35,6 +44,8 @@ def root() -> Path:
         root_path = Path(os.environ["XDG_DATA_HOME"])
     elif not is_running_portable and is_running_as_compiled:
         root_path = platformdirs.user_data_path("QCanvasReborn", "QCanvasTeam")
+    elif not is_running_portable:
+        _logger.warning("Don't know how we're being run? Are you running from source?")
 
     print("Root path", root_path.absolute())
     _logger.debug("Root path %s", root_path.absolute())

qcanvas/util/qurl_util.py

@@ -1,7 +1,7 @@
 import logging
 from pathlib import Path
 
-from qtpy.QtCore import QUrl
+from PySide6.QtCore import QUrl
 
 _logger = logging.getLogger(__name__)
 

qcanvas/util/ui_tools.py

@@ -1,14 +1,124 @@
-import logging
-from typing import Any
+from typing import Any, Sequence
 
-from qtpy.QtGui import QIcon, QKeySequence, QPixmap
-from qtpy.QtWidgets import *
+from PySide6.QtCore import QSize
+from PySide6.QtGui import QAction, QIcon, QKeySequence, QPixmap, QFont
+from PySide6.QtWidgets import (
+    QMenu,
+    QSizePolicy,
+    QLabel,
+    QWidget,
+    QFormLayout,
+    QDockWidget,
+    QLayout,
+    QHBoxLayout,
+    QVBoxLayout,
+)
 
-_logger = logging.getLogger(__name__)
 
+def font(*, point_size: float | int | None = None, bold: bool | None = None) -> QFont:
+    _font = QFont()
 
-def make_truncatable(widget: QWidget) -> None:
-    widget.setSizePolicy(QSizePolicy.Policy.Ignored, QSizePolicy.Policy.Fixed)
+    if point_size is not None:
+        if isinstance(point_size, int):
+            _font.setPointSize(point_size)
+        elif isinstance(point_size, float):
+            _font.setPointSizeF(point_size)
+        else:
+            raise TypeError("point_size")
+
+    if bold is not None:
+        _font.setBold(bold)
+
+    return _font
+
+
+_bold = font(bold=True)
+
+
+def label(text: str, *, font: QFont = None, allow_truncation: bool = False) -> QLabel:
+    _label = QLabel(text)
+
+    if font is not None:
+        _label.setFont(font)
+
+    if allow_truncation:
+        _label.setSizePolicy(QSizePolicy.Policy.Ignored, QSizePolicy.Policy.Fixed)
+
+    return _label
+
+
+def bold_label(text: str, *, allow_truncation: bool = False) -> QLabel:
+    return label(text, allow_truncation=allow_truncation, font=_bold)
+
+
+def form_layout(
+    rows: dict[str, QWidget], label_font: QFont | None = _bold, label_suffix: str = ":"
+) -> QFormLayout:
+    layout = QFormLayout()
+
+    for name, widget in rows.items():
+        if label_font:
+            layout.addRow(label(name + label_suffix, font=label_font), widget)
+        else:
+            layout.addRow(name + label_suffix, widget)
+
+    return layout
+
+
+def size(width: int, height: int):
+    return QSize(width, height)
+
+
+def dock_widget(
+    *,
+    widget: QWidget,
+    title: str | None = None,
+    hide: bool = False,
+    name: str | None = None,
+    min_size: QSize | None = None,
+    features: QDockWidget.DockWidgetFeature | None = None,
+    parent: QWidget | None = None,
+) -> QDockWidget:
+    dock = QDockWidget(title, parent)
+    dock.setWidget(widget)
+
+    if name is not None:
+        dock.setObjectName(name)
+
+    if min_size is not None:
+        dock.setMinimumSize(min_size)
+
+    if features is not None:
+        dock.setFeatures(features)
+
+    if hide:
+        dock.hide()
+
+    return dock
+
+
+def widget(layout: QLayout) -> QWidget:
+    widget = QWidget()
+    widget.setLayout(layout)
+    return widget
+
+
+def hbox(*items: QWidget | QLayout) -> QHBoxLayout:
+    _add_layout_items(layout := QHBoxLayout(), items)
+    return layout
+
+
+def vbox(*items: QWidget | QLayout) -> QVBoxLayout:
+    _add_layout_items(layout := QVBoxLayout(), items)
+    return layout
+
+
+def _add_layout_items(layout: QLayout, items: Sequence[QWidget | QLayout]):
+    for item in items:
+        if isinstance(item, QLayout):
+            layout.addItem(item)
+        else:
+            layout.addWidget(item)
 
 
 def create_qaction(
@@ -19,7 +129,7 @@ def create_qaction(
     triggered: Any = None,
     checkable: bool | None = None,
     checked: bool | None = None,
-    icon: QIcon | QPixmap | None = None
+    icon: QIcon | QPixmap | None = None,
 ) -> QAction:
     action = QAction(name)
 

qcanvas/util/url_checker.py

@@ -6,4 +6,4 @@ _logger = logging.getLogger(__name__)
 
 
 def is_url(url: str) -> bool:
-    return validators.url(url) == True
+    return validators.url(url)

qcanvas-2026.1.19.dist-info/METADATA

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: qcanvas
+Version: 2026.1.19
+Summary: View courses from Canvas LMS
+Author: QCanvas
+Author-email: QCanvas@noreply.codeberg.org
+Requires-Python: >=3.12,<3.13
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Database
+Classifier: Topic :: Internet
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Text Editors :: Text Processing
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Typing :: Typed
+Requires-Dist: aiofile (>=3.9.0,<4.0.0)
+Requires-Dist: aiosqlite (>=0.21.0,<0.22.0)
+Requires-Dist: asynctaskpool (>=0.2.1,<0.3.0)
+Requires-Dist: cachetools (>=6.2.4,<7.0.0)
+Requires-Dist: libqcanvas (>=0.5.7,<0.6.0)
+Requires-Dist: platformdirs (>=4.2.2,<5.0.0)
+Requires-Dist: pyqtdarktheme-fork (>=2.3.2,<3.0.0)
+Requires-Dist: qasync (>=0.28.0,<0.29.0)
+Requires-Dist: sqlalchemy (>=2.0.45,<3.0.0)
+Requires-Dist: validators (>=0.35.0,<0.36.0)
+Description-Content-Type: text/markdown
+
+# QCanvas
+
+QCanvas is an **unofficial** desktop client for Canvas LMS.
+
+https://codeberg.org/QCanvas/QCanvas
+
+https://github.com/QCanvas/QCanvasApp
+
+# Downloads
+
+<a href='https://flathub.org/apps/io.github.qcanvas.QCanvasApp'>
+    <img width='240' alt='Get it on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/>
+</a>
+
+You can download a **windows** version from [releases](https://github.com/QCanvas/QCanvasApp/releases)
+
+An appimage version is also available from releases but is not recommended.
+
+# Development/Run from source
+
+## Prerequisites
+
+- Python 3.12
+- Poetry
+
+## Get started
+
+```bash
+git clone https://github.com/QCanvas/QCanvasApp.git
+cd QCanvasApp
+
+# Install packages and stuff
+poetry install --with flatpak-exclude
+
+# Run QCanvas (If you run `poetry shell`, you can drop the `poetry run` part)
+poetry run qcanvas
+# Alternative
+poetry run python -m qcanvas
+```
+
+## Build custom AppImage
+
+> [!WARNING]
+> This is not recommended as the appimage produced by this process isn't a proper appimage. It's just a pyinstaller build bundled as an appimage.
+
+> [!IMPORTANT]
+> You will need [Appimagetool](https://github.com/AppImage/appimagetool)
+
+```bash
+bash ./dev_scripts/build_appimage
+```