API for adding content to the Kolibri content curation server

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for bjester from gravatar.com bjester Avatar for jredrejo from gravatar.com jredrejo Avatar for learneq from gravatar.com learneq Avatar for rtibbles from gravatar.com rtibbles

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT license)
  • Author: Learning Equality
  • Tags ricecooker
  • Requires: Python >=3.7, <3.11
Classifiers

Project description

ricecooker

PyPI pyversions build docs

The ricecooker library is a framework for automating the conversion of educational content into Kolibri content channels and uploading them to Kolibri Studio, which is the central content server for Kolibri.

📚 Ricecooker docs

Visit the documentation site at 📚 ricecooker.readthedocs.io for the full details about installation, getting started, API reference, and code examples.

Overview of Kolibri content

ricecooker is used to take openly licensed educational content available on the web and convert it into an offline-friendly package that can be imported into Kolibri.

The basic process of getting new content into Kolibri is as follows:

  • UPLOAD your content to Kolibri Studio either manually through the Kolibri Studio web interface or programmatically using a ricecooker-based content integration script.
  • PUBLISH the channel on Kolibri Studio to make it accessible for use in Kolibri.
  • IMPORT the the channel into Kolibri using the channel token displayed in Kolibri Studio after the PUBLISH step is done.

The diagram below illustrates how content flows within the Kolibri ecosystem and highlights the part which is covered by the ricecooker framework (bottom left).

Overview of steps for integrating external content sources for use in the Kolibri Learning Platform External content sources (left) are first uploaded to Kolibri Studio (middle), so they can be used in the Kolibri Learning Platform (right).

Further reading

The Ricecooker docs website is the best place to learn about writing automated content integration scripts.

Here are some links to other documents and guides you can read to learn about the other parts of the Kolibri content platform:

  • The Kolibri Content Integration Guide is a comprehensive guide to the decisions, processes, and tools for integrating external content sources for use in the Kolibri Learning Platform.
  • Read the Kolibri Studio docs to learn more about the Kolibri Studio features
  • Read the Kolibri docs to learn how to install Kolibri on your machine (useful for testing channels)

======= History

0.6.46 (2020-09-21)

  • Add ricecooker.utils.youtube, containing utilities for handling and caching YouTube videos and playlists.
  • Improve validation of m and n mastery model values in ExerciseNode.

0.6.45 (2020-07-25)

  • Remove SushiBar remote monitoring and remote command functionality

0.6.44 (2020-07-16)

  • Documentation overhaul and refresh, see ricecooker.readthedocs.io <https://ricecooker.readthedocs.io/>__
  • Add support for specifying a Channel tagline
  • Ensure we send extra_fields data for all node types
  • Make --reset behavior the default
  • Remove legacy code around compatibiliry_mode and BaseChef class
  • Improved caching logic (no caching for thumbnails and local paths, always cache youtube downloads)
  • Ensure chefs clean up after run (automatic temp files removal)
  • Added save_channel_tree_as_json full channel metadata as part of every run.
  • Added support for web content archiving
  • Further improvements to logging
  • Bugfix: deep deterministic cache keys for nested dicts values in ffmpeg_settings

0.6.42 (2020-04-10)

  • Added --sample N command line option. Run script with --sample 10 to produce a test version of the channel with 10 randomly selected nodes from the full channel. Use this to check transformations are working as expected.
  • Added dryrun command. Use the command ./sushichef.py dryrun to run the chef as normal but skip the step where the files get uploaded to Studio.
  • Added HTTP proxy functionality for YouTubeVideoFile and YouTubeSubtitleFile Set the PROXY_LIST env variable to a ;-separated list of {ip}:{port}. Ricecooker will detect the presence of the PROXY_LIST and use it when accessing resources via YoutubeDL. Alternatively, set USEPROXY env var to use a list of free proxy servers, which are very slow and not reliable.
  • Improved colored logging functionality and customizability of logging output.

0.6.40 (2020-02-07)

  • Changed default behaviour to upload the staging tree instead of the main tree
  • Added --deploy flag to reproduce old bahavior (upload to main tree)
  • Added thumbnail generating methods for audio, HTML5, PDF, and ePub nodes. Set the derive_thumbnail=True when creating the Node instance, or pass the command line argument --thumbnails to generate thumbnails for all nodes. Note: automatic thumbnail generation will only work if thumbnail is None.

0.6.38 (2019-12-27)

  • Added support the h5p content kind and h5p file type
  • Removed monkey-patching of localStorage and document.cookie in the helper method download_static_assets
  • Added validation logic for tags
  • Improved error reporting

0.6.36 (2019-09-25)

  • Added support for tags using the JsonChef workflow
  • Added validation step to ensure subtitles file are unique for each language code
  • Document new SlidesShow content kind coming in Kolibri 0.13
  • Added docs with detailed instruction for content upload and update workflows
  • Bugfixes to file extension logic and improved error handling around subtitles

0.6.32 (2019-08-01)

  • Updated documentation to use top-level headings
  • Removed support for Python 3.4
  • Removed support for the "sous chef" workflow

0.6.31 (2019-07-01)

  • Handle more subtitle convertible formats: SRT, TTML, SCC, DFXP, and SAMI

0.6.30 (2019-05-01)

  • Updated docs build scripts to make ricecooker docs available on read the docs
  • Added corrections command line script for making bulk edits to content metadata
  • Added StudioApi client to support CRUD (created, read, update, delete) Studio actions
  • Added pdf-splitting helper methods (see ricecooker/utils/pdf.py)

0.6.23 (2018-11-08)

  • Updated le-utils and pressurcooker dependencies to latest version
  • Added support for ePub files (EPubFile s can be added of DocumentNode s)
  • Added tag support
  • Changed default value for STUDIO_URL to api.studio.learningequality.org
  • Added aggregator and provider fields for content nodes
  • Various bugfixes to image processing in exercises
  • Changed validation logic to use self.filename to check file format is in self.allowed_formats
  • Added is_youtube_subtitle_file_supported_language helper function to support importing youtube subs
  • Added srt2vtt subtitles conversion
  • Added static assets downloader helper method in utils.downloader.download_static_assets
  • Added LineCook chef functions to --generate CSV from directory structure
  • Fixed the always randomize=True bug
  • Docs: general content node metadata guidelines
  • Docs: video compression instructions and helper scripts convertvideo.bat and convertvideo.sh

0.6.17 (2018-04-20)

0.6.15 (2018-03-06)

  • Added support for non-mp4 video files, with auto-conversion using ffmpeg. See git diff b1d15fa 87f2528
  • Added CSV exercises workflow support to LineCook chef class
  • Added --nomonitor CLI argument to disable sushibar functionality
  • Defined new ENV variables:
    • PHANTOMJS_PATH: set this to a phantomjs binary (instead of assuming one in node_modules)
    • STUDIO_URL (alias CONTENTWORKSHOP_URL): set to URL of Kolibri Studio server where to upload files
  • Various fixes to support sushi chefs
  • Removed minimize_html_css_js utility function from ricecooker/utils/html.py to remove dependency on css_html_js_minify and support Py3.4 fully.

0.6.9 (2017-11-14)

  • Changed default logging level to --verbose
  • Added support for cronjobs scripts via --cmdsock (see docs/daemonization.md)
  • Added tools for creating HTML5Zip files in utils/html_writer.py
  • Added utility for downloading HTML with optional js support in utils/downloader.py
  • Added utils/path_builder.py and utils/data_writer.py for creating souschef archives (zip archive that contains files in a folder hierarchy + Channel.csv + Content.csv)

0.6.7 (2017-10-04)

  • Sibling content nodes are now required to have unique source_id
  • The field copyright_holder is required for all licenses other than public domain

0.6.7 (2017-10-04)

  • Sibling content nodes are now required to have unique source_id
  • The field copyright_holder is required for all licenses other than public domain

0.6.6 (2017-09-29)

  • Added JsonTreeChef class for creating channels from ricecooker json trees
  • Added LineCook chef class to support souschef-based channel workflows

0.6.4 (2017-08-31)

  • Added language attribute for ContentNode (string key in internal repr. defined in le-utils)
  • Made language a required attribute for ChannelNode
  • Enabled sushibar.learningequality.org progress monitoring by default Set SUSHIBAR_URL env. var to control where progress is reported (e.g. http://localhost:8001)
  • Updated le-utils and pressurecooker dependencies to latest

0.6.2 (2017-07-07)

  • Clarify ricecooker is Python3 only (for now)
  • Use https:// and wss:// for SuhiBar reporting

0.6.0 (2017-06-28)

  • Remote progress reporting and logging to SushiBar (MVP version)
  • New API based on the SuchiChef classes
  • Support existing old-API chefs in compatibility mode

0.5.13 (2017-06-15)

  • Last stable release before SushiBar functionality was added
  • Renamed --do-not-activate argument to --stage

0.1.0 (2016-09-30)

  • First release on PyPI.

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for bjester from gravatar.com bjester Avatar for jredrejo from gravatar.com jredrejo Avatar for learneq from gravatar.com learneq Avatar for rtibbles from gravatar.com rtibbles

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: MIT License (MIT license)
  • Author: Learning Equality
  • Tags ricecooker
  • Requires: Python >=3.7, <3.11
Classifiers

Release history Release notifications | RSS feed

0.7.3

This version

0.7.2

0.7.1

0.7.0

0.7.0b6 pre-release

0.7.0b5 pre-release

0.7.0b4 pre-release

0.7.0b3 pre-release

0.7.0b2 pre-release

0.7.0b1 pre-release

0.6.46

0.6.45

0.6.44

0.6.43

0.6.42

0.6.41

0.6.40

0.6.39

0.6.38

0.6.37

0.6.36

0.6.35

0.6.34

0.6.33

0.6.32

0.6.31

0.6.30

0.6.29

0.6.28

0.6.27

0.6.26

0.6.25

0.6.24

0.6.23

0.6.22

0.6.21

0.6.20

0.6.19

0.6.18

0.6.17

0.6.16

0.6.15

0.6.13

0.6.12

0.6.11

0.6.10

0.6.9

0.6.8

0.6.7

0.6.6

0.6.4

0.6.3

0.6.2

0.6.0

0.5.13

0.5.12

0.5.11

0.5.10

0.5.9

0.5.8

0.5.7

0.5.6

0.5.5

0.5.5a0 pre-release

0.5.4

0.5.3

0.5.2

0.5.1

0.5.0

0.4.8

0.4.7

0.4.6

0.4.5

0.4.4

0.4.4a0 pre-release

0.4.3

0.4.2

0.4.1

0.4.0

0.3.1415926

0.3.141592

0.3.14159

0.3.1415

0.3.141

0.3.14

0.3.13

0.3.12

0.3.11

0.3.10

0.3.9

0.3.8

0.3.7

0.3.6

0.3.5

0.3.5rc20 pre-release

0.3.5rc19 pre-release

0.3.5rc18 pre-release

0.3.5rc17 pre-release

0.3.5rc16 pre-release

0.3.5rc15 pre-release

0.3.5rc14 pre-release

0.3.5rc13 pre-release

0.3.5rc12 pre-release

0.3.5rc11 pre-release

0.3.5rc10 pre-release

0.3.5rc9 pre-release

0.3.5rc8 pre-release

0.3.5rc7 pre-release

0.3.5rc6 pre-release

0.3.5rc5 pre-release

0.3.5rc4 pre-release

0.3.5rc3 pre-release

0.3.5rc2 pre-release

0.3.5rc1 pre-release

0.3.5rc0 pre-release

0.3.5b0 pre-release

0.3.5a0 pre-release

0.2.2

0.2.1

0.2.0

0.1.1

0.1.0

0.0.99

0.0.91

0.0.9

0.0.8

0.0.7

0.0.6

0.0.5

0.0.4

0.0.3

0.0.2

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ricecooker-0.7.2.tar.gz (7.7 MB view details)

Uploaded Source

Built Distribution

ricecooker-0.7.2-py2.py3-none-any.whl (139.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file ricecooker-0.7.2.tar.gz.

File metadata

  • Download URL: ricecooker-0.7.2.tar.gz
  • Upload date:
  • Size: 7.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.16

File hashes

Hashes for ricecooker-0.7.2.tar.gz
Algorithm Hash digest
SHA256 43222ecb725c309e8d3902f12b3e73e2bb9e86ba8e93850ffc51681498689e42
MD5 df589e727d76e7ec12f45b34cb5f050d
BLAKE2b-256 3501acdf8610000b7a4cd480677da03745c4bee884f1c6403d6addac4c923c17

See more details on using hashes here.

Provenance

File details

Details for the file ricecooker-0.7.2-py2.py3-none-any.whl.

File metadata

  • Download URL: ricecooker-0.7.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 139.1 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.7.16

File hashes

Hashes for ricecooker-0.7.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4a86aa856b51070b98e00f9013f5024f75aa4e473637525daf7a916affe71cb1
MD5 3480641a78605f42fd649d6d349accce
BLAKE2b-256 d38a1b09eb90fa3788bd81c13054a7fa26a8e93a0e98ac0da9020513658763dd

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page