Python implementation of PVL (Parameter Value Language)
Project description
Python implementation of PVL (Parameter Value Language)
Free software: BSD license
Documentation: http://pvl.readthedocs.org.
Support for Python 2, 3 and pypi.
Proudly part of the PlanetaryPy Toolkit
PVL is a markup language, similar to xml, commonly employed for entries in the Planetary Database System used by NASA to store mission data, among other uses. This package supports both encoding a decoding a superset of PVL, including the USGS Isis Cube Label and NASA PDS 3 Label dialects.
Installation
At the command line:
$ pip install pvl
Basic Usage
pvl exposes an API familiar to users of the standard library json module.
Decoding is primarily done through pvl.load for file like objects and pvl.loads for strings:
>>> import pvl >>> module = pvl.loads(""" ... foo = bar ... items = (1, 2, 3) ... END ... """) >>> print module PVLModule([ (u'foo', u'bar') (u'items', [1, 2, 3]) ]) >>> print module['foo'] bar
You may also use pvl.load to read a label directly from an image:
>>> import pvl >>> label = pvl.load('pattern.cub') >>> print label PVLModule([ (u'IsisCube', PVLObject([ (u'Core', PVLObject([ (u'StartByte', 65537) (u'Format', u'Tile') # output truncated... >>> print label['IsisCube']['Core']['StartByte'] 65537
Similarly, encoding pvl modules is done through pvl.dump and pvl.dumps:
>>> import pvl >>> print pvl.dumps({ ... 'foo': 'bar', ... 'items': [1, 2, 3] ... }) items = (1, 2, 3) foo = bar END
PVLModule objects may also be pragmatically built up to control the order of parameters as well as duplicate keys:
>>> import pvl >>> module = pvl.PVLModule({'foo': 'bar'}) >>> module.append('items', [1, 2, 3]) >>> print pvl.dumps(module) foo = bar items = (1, 2, 3) END
A PVLModule is a dict like container that preserves ordering as well as allows multiple values for the same key. It provides a similar similar semantics to a list of key/value tuples but with dict style access:
>>> import pvl >>> module = pvl.PVLModule([ ... ('foo', 'bar'), ... ('items', [1, 2, 3]), ... ('foo', 'remember me?'), ... ]) >>> print module['foo'] bar >>> print module.getlist('foo') ['bar', 'remember me?'] >>> print module.items() [('foo', 'bar'), ('items', [1, 2, 3]), ('foo', u'remember me?')] >>> print pvl.dumps(module) foo = bar items = (1, 2, 3) foo = "remember me?" END
For more information on custom serilization and deseralization see the full documentation.
Contributing
Feedback, issues, and contributions are always gratefully welcomed. See the contributing guide for details on how to help and setup a development environment.
History
0.2.0 (2015-08-13)
Drastically increase test coverage.
Lots of bug fixes.
Add Cube and PDS encoders.
Cleanup README.
Use pvl specification terminology.
Added element access by index and slice.
0.1.1 (2015-06-01)
Fixed issue with reading Pancam PDS Products.
0.1.0 (2015-05-30)
First release on PyPI.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.