Skip to main content

Library for parsing IMS-LOM xml records.

Project description

Build Status PyPI pyversions PyPI version


This is a Python library for reading and writing IMS-LOM files. Almost all fields are supported, but only one language will be supported for language-specific langstring elements. The reader supports common vCard field extraction with vobject.

Reader Usage

Basically, import the class and tell it to parse a lom file. The parsed data will be available in the lom attribute dict. By default, it reads the en language, but another can be set on init. To start parsing, initialize the class and use one of two public methods, parsePath or parseString.

basic example

from pylom.reader import LomReader

lomreader = LomReader()

# Bloodbath of B-R5RB

fieldset example

from pylom.reader import LomReader

lomreader = LomReader()
lomreader.parsePath("test/records/ims-complete.xml", ["title","location"])

# Only the title and location field results are available in the lom dict

Writer Usage

The writer class is used by providing it with a dictionary with all the values you want in your record. Like the reader class the instance can be called with a language argument for all the langstring elements. After parsing, the lom record is available in the lom attribute.

basic example

from pylom.writer import LomWriter

lomwriter = LomWriter()
lomwriter.parseDict({"title": "Bloodbath of B-R5RB"})

custom vocabularies

By default, all vocabulary sources are set to LOMv1.0, but they can be changed by setting the vocabulary_sources after creating the instance.

from pylom.writer import LomWriter

lomwriter = LomWriter()
lomwriter.vocabulary_sources.update( { "aggregationlevel": "my-source" } )
lomwriter.parseDict({"aggregationlevel": "2"})

input values

For easy implementation, many of the values can be provided as needed. For instance, any basic element or langstring element can be provided as string or as a list of strings.

Vocabulary elements can be provided as a single string or a list of strings, using the class default vocabulary source, or as a single dictionary, with separate source and value values.

More detailed examples can be inferred from the test_writer_elements test cases.

from pylom.writer import LomWriter

lomwriter = LomWriter()
lomdict = {
    "title": "Bloodbath of B-R5RB",
    "keyword": ["Eve Online", "Halloween War"],
    "aggregationlevel": {"source": "my-source", "value": "2" },
    "context": ["school", "higher education"] }



To Do


  • implement all LOM fields
  • support IEEE binding
  • cleanup options, trim, unique, etc
  • application profile validation
  • value validation


  • vocabulary, provide list of source/value dicts
  • more LOM-spec aware validation, for instance, prevent multiple title fields

Project details

Download files

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

Files for pylom, version 1.6.3
Filename, size File type Python version Upload date Hashes
Filename, size pylom-1.6.3-py3-none-any.whl (16.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pylom-1.6.3.tar.gz (16.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page