[](https://github.com/VaasuDevanS/cowsay-python/actions/workflows/cowsay.yaml)
[](https://codecov.io/gh/VaasuDevanS/cowsay-python)
[](https://app.codacy.com/gh/VaasuDevanS/cowsay-python/dashboard)
[](https://github.com/VaasuDevanS/cowsay-python)
<br>
[](https://pepy.tech/project/cowsay)
[](https://pepy.tech/project/cowsay)
[](https://pepy.tech/project/cowsay)
# Introduction
A python API / Command-line tool for the famous linux `cowsay`. <br>
Take a look at [CHANGELOG.md](https://github.com/VaasuDevanS/cowsay-python/blob/main/CHANGELOG.md) for the changes.
# Brief History
`cowsay` for GNU/Linux was initially written in perl by Tony Monroe. More info
[here](https://en.wikipedia.org/wiki/Cowsay).
# Installation
```console
pip install cowsay
```
# API Usage
```console
>>> import cowsay
>>> cowsay.cow('Hello World')
___________
| Hello World |
===========
\
\
^__^
(oo)\_______
(__)\ )\/\
||----w |
|| ||
>>> print(cowsay.get_output_string('cow', 'Hello World'))
___________
| Hello World |
===========
\
\
^__^
(oo)\_______
(__)\ )\/\
||----w |
|| ||
>>> cowsay.cow('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris blandit rhoncus nibh. Mauris mi mauris, molestie vel metus sit amet, aliquam vulputate nibh.')
_________________________________________________
/ \
| Lorem ipsum dolor sit amet, consectetur adipiscin |
| g elit. Mauris blandit rhoncus nibh. Mauris mi ma |
| uris, molestie vel metus sit amet, aliquam vulput |
| ate nibh. |
\ /
=================================================
\
\
^__^
(oo)\_______
(__)\ )\/\
||----w |
|| ||
>>> my_fish = r'''
\
\
/`·.¸
/¸...¸`:·
¸.·´ ¸ `·.¸.·´)
: © ):´; ¸ {
`·.¸ `· ¸.·´\`·¸)
`\\´´\¸.·´
'''
>>> cowsay.draw('Sharks are my best friend', my_fish)
_________________________
| Sharks are my best friend |
=========================
\
\
/`·.¸
/¸...¸`:·
¸.·´ ¸ `·.¸.·´)
: © ):´; ¸ {
`·.¸ `· ¸.·´\`·¸)
`\\´´\¸.·´
```
# Command Line Usage
```console
$ cowsay -t "Hello World"
___________
| Hello World |
===========
\
\
^__^
(oo)\_______
(__)\ )\/\
||----w |
|| ||
$ cowsay -t "Hello World" -c "tux"
___________
| Hello World |
===========
\
\
\
.--.
|o_o |
|:_/ |
// \ \
(| | )
/'\_ _/`\
\___)=(___/
```
# More Characters
```console
>>> cowsay.char_names
['beavis', 'cheese', 'cow', 'daemon', 'dragon', 'fox', 'ghostbusters', 'kitty',
'meow', 'miki', 'milk', 'octopus', 'pig', 'stegosaurus', 'stimpy', 'trex',
'turkey', 'turtle', 'tux']
>>> cowsay.char_funcs
{'beavis': <function func at 0x104b734c0>,
'cheese': <function func at 0x104d285e0>,
...
'tux': <function func at 0x104d28f70>}
>>> len(cowsay.chars)
19
```
# Contributing
<a href="https://github.com/VaasuDevanS/cowsay-python/graphs/contributors">
<img src="https://contrib.rocks/image?repo=VaasuDevanS/cowsay-python&columns=5" />
</a>
Guide: [CONTRIBUTING.md](https://github.com/VaasuDevanS/cowsay-python/blob/main/CONTRIBUTING.md)
Raw data
{
"_id": null,
"home_page": "https://github.com/VaasuDevanS/cowsay-python",
"name": "cowsay",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Vaasudevan Srinivasan",
"author_email": "vaasuceg.96@gmail.com",
"download_url": "",
"platform": null,
"description": "\n[](https://github.com/VaasuDevanS/cowsay-python/actions/workflows/cowsay.yaml)\n[](https://codecov.io/gh/VaasuDevanS/cowsay-python)\n[](https://app.codacy.com/gh/VaasuDevanS/cowsay-python/dashboard)\n\n[](https://github.com/VaasuDevanS/cowsay-python)\n<br>\n\n[](https://pepy.tech/project/cowsay)\n[](https://pepy.tech/project/cowsay)\n[](https://pepy.tech/project/cowsay)\n\n\n# Introduction\n\nA python API / Command-line tool for the famous linux `cowsay`. <br>\nTake a look at [CHANGELOG.md](https://github.com/VaasuDevanS/cowsay-python/blob/main/CHANGELOG.md) for the changes.\n\n\n# Brief History\n`cowsay` for GNU/Linux was initially written in perl by Tony Monroe. More info \n[here](https://en.wikipedia.org/wiki/Cowsay).\n\n\n# Installation\n```console\npip install cowsay\n```\n\n\n# API Usage\n```console\n>>> import cowsay\n\n>>> cowsay.cow('Hello World')\n ___________\n| Hello World |\n ===========\n \\\n \\\n ^__^\n (oo)\\_______\n (__)\\ )\\/\\\n ||----w |\n || ||\n\n\n>>> print(cowsay.get_output_string('cow', 'Hello World'))\n ___________\n| Hello World |\n ===========\n \\\n \\\n ^__^\n (oo)\\_______\n (__)\\ )\\/\\\n ||----w |\n || ||\n\n\n>>> cowsay.cow('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris blandit rhoncus nibh. Mauris mi mauris, molestie vel metus sit amet, aliquam vulputate nibh.')\n _________________________________________________\n / \\\n| Lorem ipsum dolor sit amet, consectetur adipiscin |\n| g elit. Mauris blandit rhoncus nibh. Mauris mi ma |\n| uris, molestie vel metus sit amet, aliquam vulput |\n| ate nibh. |\n \\ /\n =================================================\n \\\n \\\n ^__^\n (oo)\\_______\n (__)\\ )\\/\\\n ||----w |\n || ||\n\n\n>>> my_fish = r'''\n\\\n \\ \n /`\u00b7.\u00b8\n /\u00b8...\u00b8`:\u00b7\n \u00b8.\u00b7\u00b4 \u00b8 `\u00b7.\u00b8.\u00b7\u00b4)\n: \u00a9 ):\u00b4; \u00b8 {\n `\u00b7.\u00b8 `\u00b7 \u00b8.\u00b7\u00b4\\`\u00b7\u00b8)\n `\\\\\u00b4\u00b4\\\u00b8.\u00b7\u00b4\n'''\n\n>>> cowsay.draw('Sharks are my best friend', my_fish)\n _________________________\n| Sharks are my best friend |\n =========================\n \\\n \\ \n /`\u00b7.\u00b8\n /\u00b8...\u00b8`:\u00b7\n \u00b8.\u00b7\u00b4 \u00b8 `\u00b7.\u00b8.\u00b7\u00b4)\n : \u00a9 ):\u00b4; \u00b8 {\n `\u00b7.\u00b8 `\u00b7 \u00b8.\u00b7\u00b4\\`\u00b7\u00b8)\n `\\\\\u00b4\u00b4\\\u00b8.\u00b7\u00b4\n```\n\n\n# Command Line Usage\n```console\n$ cowsay -t \"Hello World\"\n ___________\n| Hello World |\n ===========\n \\\n \\\n ^__^\n (oo)\\_______\n (__)\\ )\\/\\\n ||----w |\n || ||\n\n\n$ cowsay -t \"Hello World\" -c \"tux\"\n ___________\n| Hello World |\n ===========\n \\\n \\\n \\\n .--.\n |o_o |\n |:_/ |\n // \\ \\\n (| | )\n /'\\_ _/`\\\n \\___)=(___/\n```\n\n\n# More Characters\n```console\n>>> cowsay.char_names\n['beavis', 'cheese', 'cow', 'daemon', 'dragon', 'fox', 'ghostbusters', 'kitty',\n'meow', 'miki', 'milk', 'octopus', 'pig', 'stegosaurus', 'stimpy', 'trex', \n'turkey', 'turtle', 'tux']\n\n\n>>> cowsay.char_funcs\n{'beavis': <function func at 0x104b734c0>, \n'cheese': <function func at 0x104d285e0>, \n...\n'tux': <function func at 0x104d28f70>}\n\n\n>>> len(cowsay.chars)\n19\n```\n\n# Contributing\n<a href=\"https://github.com/VaasuDevanS/cowsay-python/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=VaasuDevanS/cowsay-python&columns=5\" />\n</a>\n\nGuide: [CONTRIBUTING.md](https://github.com/VaasuDevanS/cowsay-python/blob/main/CONTRIBUTING.md)\n",
"bugtrack_url": null,
"license": "GNU-GPL",
"summary": "The famous cowsay for GNU/Linux is now available for python",
"version": "6.1",
"project_urls": {
"Homepage": "https://github.com/VaasuDevanS/cowsay-python"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f11363c0a02c44024ee16f664e0b36eefeb22d54e93531630bd99e237986f534",
"md5": "8fe287e84772d7595c611d236cae4fdc",
"sha256": "274b1e6fc1b966d53976333eb90ac94cb07a450a700b455af9fbdf882244b30a"
},
"downloads": -1,
"filename": "cowsay-6.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8fe287e84772d7595c611d236cae4fdc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 25560,
"upload_time": "2023-09-25T16:30:01",
"upload_time_iso_8601": "2023-09-25T16:30:01.619675Z",
"url": "https://files.pythonhosted.org/packages/f1/13/63c0a02c44024ee16f664e0b36eefeb22d54e93531630bd99e237986f534/cowsay-6.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-25 16:30:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "VaasuDevanS",
"github_project": "cowsay-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "cowsay"
}
JSON
