Skip to main content

wow very terminal doge

Project description

doge

PyPI - Version PyPI - Downloads PyPI - Python Version Ruff GitHub License

wow screenshot

doge is a simple motd script based on the slightly stupid but very funny doge meme. It prints random grammatically incorrect statements that are sometimes based on things from your computer.

If you have uv or pipx (you should!), you can try out doge without installing it permanently.
Just type uvx doge or pipx run doge in your terminal to see if you enjoy it. 🐶
If you do, uv tool install doge or pipx install doge to keep it around! 👍

Features

  • Randomly placed and colored random strings, complete with broken english.
  • Awesome Shibe 😎 in the terminal.
  • Fetching of system data, such as hostname, running processes, current user and $EDITOR.
  • If you have 🌈 lolcat, you can do this gem:
    while true; do doge | lolcat -a -d 100 -s 100 -p 1; done (thx hom3chuk)
  • stdin support: ls /usr/bin | doge will doge-print some of the executables found in /usr/bin. wow. There are also multiple command line switches that control filtering and statistical frequency of words. See doge -h, wow.
    • To use all dictionary words that start or end with "dog", try:
      egrep '(^dog|dog$)' /usr/share/dict/words | fgrep -v "'s" | doge

Notes

You need a terminal that supports 256 colors running on a system that supports unicode.

The terminal Shibe was created with hax0r Gimp skills and img2xterm.

Installation

There are several options for installing and running a Python CLI application such as doge.

Python-Based Install (Recommended)

The best way is to install doge directly from PyPI with either uv or pipx:

  • uv tool install doge -- this is the recommended method, but you need uv installed and configured.
    • uv is usually the best way to install and run Python-based applications from PyPI, so if you don't yet have it, you should! 👍
    • To install newer versions, run uv tool upgrade doge or uv tool upgrade --all.
  • The other option is to use pipx: pipx install doge

Alternatively, you could also:

Then, just add a call to doge at the bottom of your shell rc file.

If you don't want to install doge with the options above for whatever reason, there is a proper pyproject.toml included, so inside a virtual environment, python -m pip install -e . should work just fine.

Package Managers And Linux Distributions

Your package manager or Linux distribution might carry a downstream doge package.

If you choose this option, and experience any installation problems, then please report them to your downstream package maintainer.

Packaging status

Packaging status

Please note that it might take some time for downstream packages to catch up with PyPI. The recommended installation with uv or pipx will always give you the latest version.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

doge-3.9.0.tar.gz (64.6 kB view details)

Uploaded Source

Built Distribution

doge-3.9.0-py3-none-any.whl (34.4 kB view details)

Uploaded Python 3

File details

Details for the file doge-3.9.0.tar.gz.

File metadata

  • Download URL: doge-3.9.0.tar.gz
  • Upload date:
  • Size: 64.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.6

File hashes

Hashes for doge-3.9.0.tar.gz
Algorithm Hash digest
SHA256 fc8b9f0cc63c3e7857ee5841f6218b7ff2c01438d40111bb02388a5dc208cbea
MD5 54e5d4b5e76f3f02281540eb979543f1
BLAKE2b-256 72e0de83fe8b04c8c0e8b18a758e3b9f850058fdb391dd9b99b4bb2b74b4954c

See more details on using hashes here.

File details

Details for the file doge-3.9.0-py3-none-any.whl.

File metadata

  • Download URL: doge-3.9.0-py3-none-any.whl
  • Upload date:
  • Size: 34.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.6

File hashes

Hashes for doge-3.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 94953cddf8a46893bf2ae86dc7767d08c2a80f30a1e0a21eec0895e60687d53c
MD5 78daee54b38a3b3e71fad259eaf52ff4
BLAKE2b-256 852d7a57a0ef25064d20ba4b2187eff3cd62563f35ec2cc62ce41be06c4421ab

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page