Skip to main content

Parse strings using a specification based on the Python format() syntax.

Project description

Parse strings using a specification based on the Python format() syntax.

Anonymous (fixed-position), named and typed values are supported. Also the alignment operators will cause whitespace (or another alignment character) to be stripped from the value.

You may not use both fixed and named values in your format string.

The types supported in “:type” expressions are the regular expression character group types d, D, w, W, s, S and not the string format types.

So, for example, some fixed-position parsing:

>>> r = parse('hello {}', 'hello world')
>>> r.fixed
('world', )
>>> r = parse('hello {:d} {:w}', 'hello 12 people')
>>> r.fixed
('12', 'people')

And some named parsing:

>>> r = parse('{greeting} {name}', 'hello world')
>>> r.named
{'greeting': 'hello', 'name': 'world'}
>>> r = parse('hello {^} world', 'hello  there     world')
>>> r.fixed
('there', )

A ValueError will be raised if there is no match:

>>> r = parse('hello {name:w}', 'hello 12')
ValueError: ...

See also the unit tests at the end of the module for some more examples.


This code is copyright 2011 eKit.com Inc (http://www.ekit.com/) See the end of the source file for the license of use.

Project details


Download files

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

Source Distribution

parse-1.0.0.tar.gz (3.8 kB view details)

Uploaded Source

File details

Details for the file parse-1.0.0.tar.gz.

File metadata

  • Download URL: parse-1.0.0.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for parse-1.0.0.tar.gz
Algorithm Hash digest
SHA256 545fd0e4862011896316f3c36ab6b672733ecc4a06ac3d84b6e16a1f4caac9a7
MD5 3897c25ec45853b1e8314d04c175d19b
BLAKE2b-256 87a5286d63ead2f448cb677ba6927cb3d2927e94930440d6333b634ea8b7f645

See more details on using hashes here.

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