cowsay

6.1 · active · verified Thu Apr 16

The `cowsay` Python library provides a Python API and command-line tool for the famous `cowsay` program, generating ASCII art of a cow (or other animals) with a custom message in a speech bubble. It's an active project, currently at version 6.1, with releases occurring periodically, often yearly or semi-annually, as seen with updates in 2023.

Common errors

```
ModuleNotFoundError: No module named 'cowsay'
```
cause The `cowsay` package is not installed in the currently active Python environment, or the environment where it was installed is not the one being used. This is common when using virtual environments incorrectly or having multiple Python installations.

fix Ensure you have activated the correct virtual environment if using one, and run `pip install cowsay`. If you have multiple Python versions, try `python -m pip install cowsay` to ensure it installs for the correct interpreter.
```
cowsay installed but won't import / No module named 'cowsay' despite pip list showing cowsay
```
cause This often happens due to a conflict between the script's filename and the library name (`cowsay.py`) or an activated virtual environment not being correctly recognized by your IDE/editor.

fix First, rename your Python script if it's named `cowsay.py`. If that doesn't fix it, ensure your IDE (like VS Code) is configured to use the same Python interpreter where you ran `pip install cowsay`. Look for an option to select the Python interpreter or activate your virtual environment before running the script.

Warnings

breaking Version 6.0 of `cowsay` dropped official support for Python 3.5. Users on Python 3.5 or older will need to either upgrade their Python version or pin to an older `cowsay` version (e.g., `cowsay<6.0`).
Fix: Upgrade your Python environment to 3.8+ or use `pip install 'cowsay<6.0'`.
gotcha Naming your Python script `cowsay.py` will cause import conflicts, leading to `ModuleNotFoundError` or unexpected behavior when trying to `import cowsay`. The Python interpreter will try to import your local file instead of the installed library.
Fix: Rename your script to something other than `cowsay.py` (e.g., `my_cowsay_app.py`).
gotcha When using `cowsay.cow()` or similar functions, the output is printed directly to stdout. If you need to capture the output for further processing or display in a GUI, use `cowsay.get_output_string()` instead.
Fix: Replace `cowsay.cow(message)` with `output = cowsay.get_output_string('cow', message)` and then `print(output)` or process `output` as needed.

Install

pip install cowsay Install latest version

Imports

cowsay
```
import cowsay
```
The primary module for all cowsay functionalities.
cow
```
import cowsay
cowsay.cow('message')
```
The main function to make the cow speak.
get_output_string
```
import cowsay
cowsay.get_output_string('cow', 'message')
```
Returns the ASCII art as a string instead of printing directly.

Quickstart

This quickstart demonstrates how to import the `cowsay` library, make the default cow say a message, use a different animal like Tux, and retrieve the ASCII art as a string using `get_output_string` instead of printing directly.

import cowsay

def main():
    message = 'Hello, AI Agent! This is cowsay v6.1.'
    cowsay.cow(message)
    
    print('\n--- Different animal example ---')
    cowsay.tux('I am Tux, the Linux penguin!')

    print('\n--- Getting output as string ---')
    ascii_art = cowsay.get_output_string('dragon', 'Beware of dragons!')
    print(ascii_art)

if __name__ == '__main__':
    main()

view raw JSON →