strings.py
113 lines
| 2.6 KiB
| text/x-python
|
PythonLexer
|
r10676 | """String filters. | ||
|
r10433 | |||
|
r10676 | Contains a collection of useful string manipulation filters for use in Jinja | ||
templates. | ||||
|
r10433 | """ | ||
#----------------------------------------------------------------------------- | ||||
# Copyright (c) 2013, the IPython Development Team. | ||||
# | ||||
# Distributed under the terms of the Modified BSD License. | ||||
# | ||||
# The full license is in the file COPYING.txt, distributed with this software. | ||||
#----------------------------------------------------------------------------- | ||||
#----------------------------------------------------------------------------- | ||||
# Imports | ||||
#----------------------------------------------------------------------------- | ||||
# Our own imports | ||||
|
r10676 | import textwrap | ||
|
r11089 | |||
|
r10433 | #----------------------------------------------------------------------------- | ||
# Functions | ||||
#----------------------------------------------------------------------------- | ||||
|
r10676 | |||
|
r11088 | __all__ = [ | ||
'wrap', | ||||
'strip_dollars', | ||||
'rm_fake', | ||||
'python_comment', | ||||
'get_lines' | ||||
] | ||||
|
r10433 | def wrap(text, width=100): | ||
|
r10676 | """ | ||
Intelligently wrap text. | ||||
Wrap text without breaking words if possible. | ||||
Parameters | ||||
---------- | ||||
text : str | ||||
Text to wrap. | ||||
width : int, optional | ||||
Number of characters to wrap to, default 100. | ||||
""" | ||||
|
r10433 | |||
|
r10676 | split_text = text.split('\n') | ||
wrp = map(lambda x:textwrap.wrap(x,width), split_text) | ||||
|
r10433 | wrpd = map('\n'.join, wrp) | ||
|
r10434 | return '\n'.join(wrpd) | ||
def strip_dollars(text): | ||||
|
r10676 | """ | ||
Remove all dollar symbols from text | ||||
Parameters | ||||
---------- | ||||
text : str | ||||
Text to remove dollars from | ||||
""" | ||||
|
r10434 | |||
|
r10485 | return text.strip('$') | ||
|
r10882 | |||
|
r10676 | def rm_fake(text): | ||
""" | ||||
Remove all occurrences of '/files/' from text | ||||
Parameters | ||||
---------- | ||||
text : str | ||||
Text to remove '/files/' from | ||||
""" | ||||
return text.replace('/files/', '') | ||||
|
r10485 | |||
|
r10676 | def python_comment(text): | ||
""" | ||||
Build a Python comment line from input text. | ||||
Parameters | ||||
---------- | ||||
text : str | ||||
Text to comment out. | ||||
""" | ||||
#Replace line breaks with line breaks and comment symbols. | ||||
#Also add a comment symbol at the beginning to comment out | ||||
#the first line. | ||||
return '# '+'\n# '.join(text.split('\n')) | ||||
|
r10485 | |||
|
r10676 | def get_lines(text, start=None,end=None): | ||
|
r10485 | """ | ||
Split the input text into separate lines and then return the | ||||
lines that the caller is interested in. | ||||
|
r10676 | |||
Parameters | ||||
---------- | ||||
text : str | ||||
Text to parse lines from. | ||||
start : int, optional | ||||
First line to grab from. | ||||
end : int, optional | ||||
Last line to grab from. | ||||
|
r10485 | """ | ||
# Split the input into lines. | ||||
|
r10676 | lines = text.split("\n") | ||
|
r10485 | |||
# Return the right lines. | ||||
return "\n".join(lines[start:end]) #re-join | ||||