Pattern for matching an index with optional padding.
Common patterns that can be passed to assemble().
Assemble items in iterable into discreet collections.
patterns may be specified as a list of regular expressions to limit the returned collection possibilities. Use this when interested in collections that only match specific patterns. Each pattern must contain the expression from DIGITS_PATTERN exactly once.
A selection of common expressions are available in PATTERNS.
Note
If a pattern is supplied as a string it will be automatically compiled to a re.RegexObject instance for convenience.
When patterns is not specified, collections are formed by examining all possible groupings of the items in iterable based around common numerical components.
minimum_items dictates the minimum number of items a collection must have in order to be included in the result. The default is 2, filtering out single item collections.
Return tuple of two lists (collections, remainder) where ‘collections’ is a list of assembled Collection instances and ‘remainder’ is a list of items that did not belong to any collection.
Parse value into a Collection.
Use pattern to extract information from value. It may make use of the following keys:
- head - Common leading part of the collection.
- tail - Common trailing part of the collection.
- padding - Padding value in %0d format.
- range - Total range in the form start-end
- ranges - Comma separated ranges of indexes.
- holes - Comma separated ranges of missing indexes.
Note
holes only makes sense if range or ranges is also present.