4.0.0-beta1
Pre-release
Pre-release
Install with:
pip install --pre --upgrade ralph-malph
Features
Added
- Backends: Add
Writable
andListable
interfaces to distinguish supported
functionalities amongdata
backends - Backends: Add
max_statements
option to data backendsread
method - Backends: Add
prefetch
option to async data backendsread
method - Backends: Add
concurrency
option to async data backendswrite
method - Backends: Add
get_backends
function to automatically discover backends
for CLI and LRS usage - Backends: Add client options for WSDataBackend
- Backends: Add
READ_CHUNK_SIZE
andWRITE_CHUNK_SIZE
data backend settings - Models: Implement Pydantic model for LRS Statements resource query parameters
- Models: Implement xAPI LMS Profile statements validation
- Models: Add
EdX
toxAPI
converters for enrollment events - Project: Add aliases for
ralph-malph
extra dependencies:backends
and
full
Changed
- Arnold: Add variable to override PVC name in arnold deployment
- API:
GET /statements
now has "mine" option which matches statements that
have an authority field matching that of the user - API: Invalid parameters now return 400 status code
- API: Forwarding PUT now uses PUT (instead of POST)
- API: Incoming statements are enriched with
id
,timestamp
,stored
andauthority
- API: Add
RALPH_LRS_RESTRICT_BY_AUTHORITY
option making?mine=True
implicit - API: Add
RALPH_LRS_RESTRICT_BY_SCOPE
option enabling endpoint access
control by user scopes - API: Enhance 'limit' query parameter's validation
- API: Variable
RUNSERVER_AUTH_BACKEND
becomesRUNSERVER_AUTH_BACKENDS
, and
multiple authentication methods are supported simultaneously - Backends: Refactor LRS Statements resource query parameters defined for
ralph
API - Backends: Refactor
database
,storage
,http
andstream
backends under
the unifieddata
backend interface [BC] - Backends: Refactor LRS
query_statements
andquery_statements_by_ids
backends methods under the unifiedlrs
backend interface [BC] - Backends: Update
statementId
andvoidedStatementId
to snake_case,
with camelCase alias, inLRSStatementsQuery
- Backends: Replace reference to a JSON column in ClickHouse with
function calls on the String column [BC] - CLI: User credentials must now include an "agent" field which can be created
using the cli - CLI: Change
push
towrite
andfetch
toread
[BC] - CLI: Change
-c --chunk-size
option to-s --chunk-size
[BC] - CLI: Change websocket backend name
-b ws
to-b async_ws
along with it's
uri option--ws-uri
to--async-ws-uri
[BC] - CLI: List cli usage strings in alphabetical order
- CLI: Change backend configuration environment variable prefixes from
RALPH_BACKENDS__{{DATABASE|HTTP|STORAGE|STREAM}}__{{BACKEND}}__{{OPTION}}
toRALPH_BACKENDS__DATA__{{BACKEND}}__{{OPTION}}
- Models: The xAPI
context.contextActivities.category
field is now mandatory
in the video and virtual classroom profiles. [BC] - Upgrade base python version to 3.12 for the development stack and Docker
image - Upgrade
bcrypt
to4.1.2
- Upgrade
cachetools
to5.3.2
- Upgrade
fastapi
to0.105.0
- Upgrade
sentry_sdk
to1.39.1
- Upgrade
uvicorn
to0.24.0.post1
Fixed
- API: Fix a typo ('attachements' -> 'attachments') to ensure compliance with
the LRS specification and prevent potential silent bugs
Removed
- Project: Drop support for Python 3.7
- Models: Remove
school
,course
,module
context extensions in Edx to xAPI
base converter - Models: Remove
name
field inVideoActivity
xAPI model mistakenly used in
video
profile - CLI: Remove
DEFAULT_BACKEND_CHUNK_SIZE
environment variable configuration