151bd13666
* Generate common/djangoapps import shims for LMS * Generate common/djangoapps import shims for Studio * Stop appending project root to sys.path * Stop appending common/djangoapps to sys.path * Import from common.djangoapps.course_action_state instead of course_action_state * Import from common.djangoapps.course_modes instead of course_modes * Import from common.djangoapps.database_fixups instead of database_fixups * Import from common.djangoapps.edxmako instead of edxmako * Import from common.djangoapps.entitlements instead of entitlements * Import from common.djangoapps.pipline_mako instead of pipeline_mako * Import from common.djangoapps.static_replace instead of static_replace * Import from common.djangoapps.student instead of student * Import from common.djangoapps.terrain instead of terrain * Import from common.djangoapps.third_party_auth instead of third_party_auth * Import from common.djangoapps.track instead of track * Import from common.djangoapps.util instead of util * Import from common.djangoapps.xblock_django instead of xblock_django * Add empty common/djangoapps/__init__.py to fix pytest collection * Fix pylint formatting violations * Exclude import_shims/ directory tree from linting
58 lines
2.4 KiB
Python
58 lines
2.4 KiB
Python
"""
|
|
API methods related to xblock state.
|
|
"""
|
|
|
|
|
|
from openedx.core.lib.cache_utils import CacheInvalidationManager
|
|
from common.djangoapps.xblock_django.models import XBlockConfiguration, XBlockStudioConfiguration
|
|
|
|
cacher = CacheInvalidationManager(model=XBlockConfiguration)
|
|
|
|
|
|
@cacher
|
|
def deprecated_xblocks():
|
|
"""
|
|
Return the QuerySet of deprecated XBlock types. Note that this method is independent of
|
|
`XBlockStudioConfigurationFlag` and `XBlockStudioConfiguration`.
|
|
"""
|
|
return XBlockConfiguration.objects.current_set().filter(deprecated=True)
|
|
|
|
|
|
@cacher
|
|
def disabled_xblocks():
|
|
"""
|
|
Return the QuerySet of disabled XBlock types (which should not render in the LMS).
|
|
Note that this method is independent of `XBlockStudioConfigurationFlag` and `XBlockStudioConfiguration`.
|
|
"""
|
|
return XBlockConfiguration.objects.current_set().filter(enabled=False)
|
|
|
|
|
|
def authorable_xblocks(allow_unsupported=False, name=None):
|
|
"""
|
|
This method returns the QuerySet of XBlocks that can be created in Studio (by default, only fully supported
|
|
and provisionally supported XBlocks), as stored in `XBlockStudioConfiguration`.
|
|
Note that this method does NOT check the value `XBlockStudioConfigurationFlag`, nor does it take into account
|
|
fully disabled xblocks (as returned by `disabled_xblocks`) or deprecated xblocks
|
|
(as returned by `deprecated_xblocks`).
|
|
|
|
Arguments:
|
|
allow_unsupported (bool): If `True`, enabled but unsupported XBlocks will also be returned.
|
|
Note that unsupported XBlocks are not recommended for use in courses due to non-compliance
|
|
with one or more of the base requirements, such as testing, accessibility, internationalization,
|
|
and documentation. Default value is `False`.
|
|
name (str): If provided, filters the returned XBlocks to those with the provided name. This is
|
|
useful for XBlocks with lots of template types.
|
|
Returns:
|
|
QuerySet: Returns authorable XBlocks, taking into account `support_level`, `enabled` and `name`
|
|
(if specified) as specified by `XBlockStudioConfiguration`. Does not take into account whether or not
|
|
`XBlockStudioConfigurationFlag` is enabled.
|
|
"""
|
|
blocks = XBlockStudioConfiguration.objects.current_set().filter(enabled=True)
|
|
if not allow_unsupported:
|
|
blocks = blocks.exclude(support_level=XBlockStudioConfiguration.UNSUPPORTED)
|
|
|
|
if name:
|
|
blocks = blocks.filter(name=name)
|
|
|
|
return blocks
|