kenjutsu.format module

kenjutsu.format.reformat_slice(a_slice, a_length=None)

Takes a slice and reformats it to fill in as many undefined values as possible.

Parameters:

• a_slice (slice) – a slice to reformat.
• a_length (int) – a length to fill for stopping if not provided.

Returns:

a new slice with as many values filled in as

possible.

Return type:

(slice)

Examples

>>> reformat_slice(slice(2, -1, None))
slice(2, -1, 1)

>>> reformat_slice(slice(2, -1, None), 10)
slice(2, 9, 1)

kenjutsu.format.reformat_slices(slices, lengths=None)

Takes a tuple of slices and reformats them to fill in as many undefined values as possible.

Parameters:

• slices (tuple(slice)) – a tuple of slices to reformat.
• lengths (tuple(int)) – a tuple of lengths to fill.

Returns:

a tuple of slices with all default

values filled if possible.

Return type:

(slice)

Examples

>>> reformat_slices(
...     (
...         slice(None),
...         slice(3, None),
...         slice(None, 5),
...         slice(None, None, 2)
...     ),
...     (10, 13, 15, 20)
... )
(slice(0, 10, 1), slice(3, 13, 1), slice(0, 5, 1), slice(0, 20, 2))