Package: catprompt
catpromptcatpromptis a command-line tool that simplifies the process of combining prompts in different files for programming with ChatGPT. It allows users to define a system prompt along with several functionality-specific prompts, which may include files with code, into a single prompt. The prompt files can be part of the project and later be used as the seed for documentation.Usingcatpromptwhen developing a large program with ChatGPT offers several advantages:System prompt consistency:By having a central system prompt, you can ensure that essential information or context is consistently provided to ChatGPT across different parts of your project. This helps maintain uniformity and coherence in the responses generated by ChatGPT.Modularity:catpromptallows you to divide prompts into separate files, enabling better organization of your project and keeping related prompts together. This makes it easier to maintain and update the code, as each functionality-specific prompt can be managed independently.Reusability:Withcatprompt, you can reuse prompts or code snippets across different parts of the project, avoiding duplication and improving consistency.Collaboration:Separating prompts into different files allows multiple team members to work on different aspects of the project simultaneously, without causing conflicts or requiring constant synchronization.Documentation:The prompt files can serve as a foundation for your project's documentation, making it easier to keep the documentation up-to-date and in sync with the code.UsageInstall catpromptCreate your prompt filesRun catprompt with the main prompt file[s] as a command-line argument, along with any options:catprompt [-r reverse_file] [-f flavor] path/to/prompt.txt [path/to/other-prompts.txt] [-c config_file]Use the processed content from the clipboard in ChatGPT.Options-c,--config: Specify one or more configuration files containing private words and flavors (default: ~/.catprompt.ini and ./catprompt.ini).-u,--unscramble: Reverse the scrambling of private words from a given file, output to stdout.-f,--flavor: Use a flavor to prefix the output, extracted from the config file.-v,--stay-verbose: Do not append "Be concise" to the prompt.Configuration Files (ini files)Configuration files (.iniformat) can be used to store private words and flavors. By default, catprompt looks for configuration files at~/.catprompt.iniand./catprompt.ini. You can specify other locations using the-cor--configoption.Private WordsPrivate words are words that should be scrambled in the output. To define private words, create a section calledPrivateWordsand list them as a comma-separated string under thelistkey:[PrivateWords]
list = private_word_1, private_word_2, private_word_3FlavorsFlavors are prefixes that can be added to the output. To define flavors, create a section calledFlavorsand list them as key-value pairs:[Flavors]
python = When programming in python follow the following rules, enclosed in ```:\n```\nAlways follow PEP-8 conventions.\n\nAlways prefer '' vs "" for strings. File names should be composed only with letters, numbers and dashes, not with underscores.\n\nThe first line of a python file is always # -*- coding: utf-8 -*-\n\nMake sure that the code formatting complies with PEP-8.\n\nUse pytest for tests.\n\nInput is from the command line whenever it makes sense. When the input is from the command line this is added at the end:\n\nif __name__ == '__main__':\n    main()\n\nand the functionality is implemented in main.
javascript = Your setup for javascript programming.You can use the-for--flavoroption to specify the desired flavor when runningcatprompt.Installationpip install catpromptorVisit the homepage athttps://github.com/juanre/catpromptDownload the package as a ZIP file or clone the repository using gitNavigate to the downloaded folder in your command-line interfaceRunpip install .to install the packageMake sure you havepipinstalled on your system. If not, you can find instructions on how to install pip here:https://pip.pypa.io/en/stable/installation/Prompt file formatLines starting with++are ignoredLines starting with+=should be followed by the name of a file to include. The file will be searched for in the directory of the original file, or in the working directory if not found there. The named file will be read, processed, and its content will replace the current line.Lines starting with+-should be followed by the name of a file to include, and a description. The file will processed as above, and its content prefaced by a line saying "[description] follows delimited by ``` and another line with just ``` and followed by a line with ```Lines starting with+#will cause the current line and all following lines in the file being processed to be ignoredSegments of a file can be tagged by adding a line that contains :prompt:tag at the beginning, and :/prompt:tag at the end. Include them by adding [tag] after the file name.ExampleLet's consider the following example with three files:main-prompt.txtThis is the main prompt.

++ This is a comment and will be ignored.
+= sub-prompt-1.txt
+- code-snippet.py The snippet of code
+- code-snippet.py [tag-1] The snippet of code limited to tag-1

This is the end of the main prompt.sub-prompt-1.txtThis is the sub-prompt 1.
+# Ignore the rest of this file
This line will be ignored.

This is useful to record the prompt that you used with this file,  which
you probably don't want when the file is included by another filecode-snippet.pydefexample_function_1():return"F1"# :prompt:tag-1defexample_function_2():return"F2"# :/prompt:tag-1defexample_function_3():return"F3"# :prompt:tag-1defexample_function_4():return"F4"# :/prompt:tag-1When runningcatprompt main-prompt.txt, the processed content will be:This is the main prompt.
This is the sub-prompt 1.
The snippet of code follows delimited by \`\`\`
\`\`\`
def example_function_1():
    return "F1"
# :prompt:tag-1
def example_function_2():
    return "F2"
# :/prompt:tag-1
def example_function_3():
    return "F3"
# :prompt:tag-1
def example_function_4():
    return "F4"
# :/prompt:tag-1
\`\`\`
The snippet of code limited to tag-1 follows delimited by \`\`\`
\`\`\`
def example_function_2():
    return "F2"
def example_function_4():
    return "F4"
\`\`\`
This is the end of the main prompt.This processed content will be copied to your clipboard, ready for use with ChatGPT.Use casesCombining a system prompt with functionality-specific prompts;Including code snippets in your prompts;Organizing prompt files as part of a project;Using prompt files as the seed for documentation.Developingmkdir ~/venv/catp && python -m venv ~/venv/catp
source ~/venv/catp/bin/activate
pip install --upgrade pip
pip install -e .
pip install ".[dev]"AuthorChatGPT-4, with prompting and editing help by Juan Reyero.