A tool that can transform ASCII text with help of Python user code.
Python 3.6 is needed.
The transformer file imports some modules that are not part of the Python distribution. See transformers.py for details. It was considered to keep transformers still usable if they do not need these external modules.
See transformers.py for examples. You can add so called "transformers" there. A "transformer" takes the text that is currently in the main text field as parameter and returns some other text.
You can change, add and delete transformers while the tool is running.
@api.transformer("Say hello")
def t(text):
return "Hello " + textFor transform functions that consist only of one line, this syntax can be used alternatively:
api.transformer("Say hello")(lambda text: "Hello " + text)File to start the tool.
Configuration file. It allows you to alter the appearance of the tool and and switch on/off the debug mode (consists of additional messages).
Members of this module are supposed to be invoked by transformers. It should never be necessary to invoke methods of other modules of the application (e.g. gui or info).
Described above.
Message system of the application to output messages in the message area. Different kind of messages can be generated. Each message method can be given an arbitrary count of arguments that are separated by the sep argument.
Example:
api.message.info("This", "is a", "message separeted by", "line breaks", sep="\n")api.message.debug: This message line is only generated, if the debug switch in "config.py" is set toTrueapi.message.info: For informationapi.message.warn: To generate warningsapi.message.error: To say if something went wrong
A dialog to enter some data that may be needed by a Transformer. It consists of some text boxes to enter data and a label for each text box.
Example:
@api.transformer("Say Hello")
def t(text):
entries = [
api.DataEntry("Forename", validator=lambda value: value == "Tom"),
api.DataEntry("Surname", "Jones", validator=bool),
api.DataEntry("No meaning"),
]
sdd = api.SimpleDataDialog("Hello", entries)
if not sdd.canceled:
result = sdd.result
return "Hello {} {}".format(result["Forename"], result["Surname"])An api.DataEntry needs at least one argument - the value name. This value name appears as label for the corresponding text box and is used to address the corresponding value.
The second, optional argument is the default value that appears in its text box.
Additionally, a validator function can be given. This validator is executed when the user clicks on the OK button. It gets the text box value as parameter and is expected to return either True or False, depending on the criteria for the value. If you just want to validate that the text box is not empty, you can say validator=bool as in the second api.DataEntry in the example above.
api.SimpleDataDialog expects the dialog title as first parameter and the api.DataEntrys as second parameter. A call to api.SimpleDataDialog will return a dialog object, containing the result dictionary. The keys of this result dictionary are the value names (first parameter of api.DataEntry). The dialog object has a member cancaled, indicating whether the user closed the dialog via "Cancel" (or the close button of the window manager).
Directory where the tool (txttrans.pyw) is. Useful e.g. to put some files there that can be used by a transform handler.
This tool is made by Christian Dreier. If you find a copy somewhere, you find the original at GitHub.
You can use and copy this tool under the conditions of the MIT license.