luna_lms.storage.storage.Storage

class documentation

class Storage:

Known subclasses: luna_lms.storage.file_storage.FileStorage, luna_lms.storage.sqlite_storage.SQLiteStorage

Prototype class to handle all storage. Should be subclassed by implementations.

Method	`delete_course`	Delete the course identified by course.
Method	`delete_learning_content`	Delete the learning content identified by learning_content_id.
Method	`delete_variant`	Attempt to delete the variant identified by variant_id. Return a message in case of success.
Method	`find_courses`	Search for courses, and return a dict mapping their titles to their IDs, and IDs to titles.
Method	`get_cached_item`	Return an item from the course's cache as a dict.
Method	`get_course_metadata`	Return the metadata of the course as a dict.
Method	`get_course_titles`	Return a list of titles of existing courses.
Method	`get_directory`	Return a tuple (directory_name, html) with the name of the first directory found in the learning content, and the content of the first HTML file found in there. Both elements may be empty.
Method	`get_html`	Return the content of the first HTML file found in the learning content, or an empty string.
Method	`get_image`	Return the URI to the first image found in the learning content, or an empty string.
Method	`get_learning_contents`	Return a list of learning contents identifiers for a course in arbitrary order.
Method	`get_learning_contents_ordered`	Return a list of learning contents identifiers for a course in order.
Method	`get_learning_contents_titles`	Return a dictionary mapping learning contents identifiers to their titles.
Method	`get_variant_metadata`	Return the metadata of the variant as a dict.
Method	`get_variants`	Return a list of all variants for a learning content in a course.
Method	`get_variants_ids`	Return a list of identifiers of all variants for a learning content in a course.
Method	`write_course`	Create a new course. Return a message indicating success or failure.
Method	`write_learning_content`	Create a new learning content.
Method	`write_learning_contents_list`	Write an re-ordered list of learning contents into the course.
Method	`write_variant`	Write a variant consisting of a single or multiple files, and create the according meta files.

def delete_course(self, course): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Delete the course identified by course. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Return a message in case of success.

def delete_learning_content(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Delete the learning content identified by learning_content_id. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Return a message in case of success.

def delete_variant(self, course, learning_content_id, variant_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Attempt to delete the variant identified by variant_id. Return a message in case of success. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def find_courses(self): ¶

overridden in luna_lms.storage.file_storage.FileStorage, luna_lms.storage.sqlite_storage.SQLiteStorage

Search for courses, and return a dict mapping their titles to their IDs, and IDs to titles.

def get_cached_item(self, course, path): ¶

overridden in luna_lms.storage.sqlite_storage.SQLiteStorage

Return an item from the course's cache as a dict. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Example: { "path": "square.svg", "data": bytes('<?xml version="1.0" encoding="UTF-8" standalone="no"?><svg width="512" height="512" viewBox="0 0 135.46666 135.46667" version="1.1" id="svg5" xmlns="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg"><defs id="defs2" /><g id="layer1"><rect style="fill:#ba2bcd;fill-opacity:1;stroke:none;stroke-width:0.187088;stroke-linecap:square;stroke-linejoin:round" id="rect286" width="95.789398" height="95.789398" x="-47.894699" y="47.894699" transform="rotate(-45)" /></g></svg>', encoding = "utf-8"), "format": "image/svg+xml", "description": "A violet square, balancing on a corner." }

def get_course_metadata(self, course): ¶

overridden in luna_lms.storage.sqlite_storage.SQLiteStorage

Return the metadata of the course as a dict. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Example: { "identifier": "e0f59465-f984-45ef-9b3d-2cf29e9edcd8", "title": "Example Title", "description": "Example description.", "relation": "", "created": "2023-08-28", "modified": "2023-08-28", "dateAccepted": "", "issued": "", "contributor": "Jane", "requires": "Luna LMS 1.0.0", }

def get_course_titles(): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a list of titles of existing courses.

def get_directory(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a tuple (directory_name, html) with the name of the first directory found in the learning content, and the content of the first HTML file found in there. Both elements may be empty. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_html(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage, luna_lms.storage.sqlite_storage.SQLiteStorage

Return the content of the first HTML file found in the learning content, or an empty string. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_image(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return the URI to the first image found in the learning content, or an empty string. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_learning_contents(self, course): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a list of learning contents identifiers for a course in arbitrary order. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_learning_contents_ordered(self, course): ¶

overridden in luna_lms.storage.file_storage.FileStorage, luna_lms.storage.sqlite_storage.SQLiteStorage

Return a list of learning contents identifiers for a course in order. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_learning_contents_titles(self, course): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a dictionary mapping learning contents identifiers to their titles. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_variant_metadata(self, course, learning_content_id, variant): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return the metadata of the variant as a dict. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Example: { "identifier": "aa2835f3-c3e4-495a-bea8-3e283979e6e6", "format": "text/html", "type": "variant" }

def get_variants(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a list of all variants for a learning content in a course. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def get_variants_ids(self, course, learning_content_id): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Return a list of identifiers of all variants for a learning content in a course. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique.

def write_course(self, title): ¶

overridden in luna_lms.storage.file_storage.FileStorage, luna_lms.storage.sqlite_storage.SQLiteStorage

Create a new course. Return a message indicating success or failure.

def write_learning_content(self, course, learning_content_title): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Create a new learning content. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Return a message indicating success or failure.

def write_learning_contents_list(self, course, learning_contents_list): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Write an re-ordered list of learning contents into the course. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Return a message indicating success or failure.

def write_variant(self, course, learning_content_id, content, filename): ¶

overridden in luna_lms.storage.file_storage.FileStorage

Write a variant consisting of a single or multiple files, and create the according meta files. course can be an identifier or the course title. An identifier is recommended, since titles may not be unique. Return the MIME type of the last file written.