.. Version 4.0.0+20191217

Installation Instructions

python setup.py install

Usage Examples

Command line:

python -m trashguy ABC

Python module:

from trashguy import TrashGuy

print(TrashGuy('ABC'))
print(TrashGuy('📂', '📊', '✉️'))

Python module as iterator:

from trashguy import TrashGuy

trash_guy = TrashGuy('ABC')

for frame in len(trash_guy):
    print(frame)

Telegram user-bot plugin:

from trashguy import TrashGuy, Symbols
import asyncio

# {client and handler code omitted}

user_input = event.message.text  # input from a given message

# Specifying keyword 'spacer=Symbols.SPACER_WIDE' prevents telegram from
# stripping leading spaces in the animation, the default is 'Symbols.SPACER_DEFAULT'.
# Specifying a value for keyword 'wrap' will wrap each frame of the animation
# in the provided string.
trash_animation = TrashGuy(user_input,
                           spacer=Symbols.SPACER_WIDE,
                           wrapper=Symbols.WRAPPER_MONOSPACE)  # single backtick

for frame in trash_animation:
    asyncio.sleep(0.4)  # external library for sleeping between frames
    await event.edit(frame)  # plays back the animation frame by frame in real time

Setting custom symbols with keyword arguments and printing as a newline-joined string:

from trashguy import TrashGuy, Symbols

trash_animation = TrashGuy(user_input,
                           sprite_can='\u2A06',
                           sprite_left='<(-.- <)',
                           sprite_right='(> -.-)>',
                           spacer=Symbols.SPACER_EMOJI,
                           wrapper=Symbols.WRAPPER_BLOCK_MONO)  # triple backticks

print(trash_animation)  # outputs entire animation with each frame separated by newline

Environment Setup

The environment setup steps are separated into three sections, the Text Editor, the Python Platform and the Operating System. Please follow the instructions for each part of the three sections that applies to you in the given order of setup.

Text Editors

Vim

• Open the vimrc file:

vim ~/.vimrc

• Add these lines to the file if they don't exist:

set encoding=utf-8  " The encoding displayed.
set fileencoding=utf-8  " The encoding written to file

• Save and close:

:wq

Emacs

You can force Emacs to read a file in a specific encoding with C-x RET c C-x C-f. If you opened a file and EMACS determined the encoding incorrectly, you can use M-x revert-buffer-with-coding-system, to reload the file with a named encoding.

You can change the encoding to use for the file when saving using C-x C-m f. You can also force this immediately by using C-x C-m c utf-8 RET C-x C-w RET. You can list all available encodings with M-x list-coding-systems.

You can also mark the entire file with C-x h and then try M-x recode-region. It will ask you for Text was really in and But was interpreted as.

Notepad++

You may set the character encoding in Notepad++ as shown in the below image:

If doing so still does not display the file correctly, try selecting Convert to UTF-8 and then save the file. If that still fails also, try selecting Convert to UTF-8-BOM instead, and save the file.

Python Platform

Trash Guy Script was written in Python 3.6.3. Backwards compatibility has not yet been tested.

To get your current python version type into the terminal:

python -c "import sys;print(sys.version)"

If the command fails to execute, it's possible that no python installation exists. In that case, please follow this guide.

Check the output of this command, it should say utf-8.

python -c "import sys;print(sys.stdout.encoding)"

If it returns any other value, try to set the default encoding with one of the following platform specific methods:

Operating Systems

Linux

Type this command to see your current locale settings:

locale

In the output of the command, check the variable LC_ALL= to see if it contains UTF-8. If it does not, try setting it by using the following commands:

locale-gen en_US.UTF-8
export LANG=en_US.UTF-8 LANGUAGE=en_US.en LC_ALL=en_US.UTF-8

Type the locale command again to confirm that LC_ALL=en_US.UTF-8 has been set.

To confirm that the default encoding has been successfully set, use the code in the snippet here.

Android

The Android platform default is always UTF-8, however, if the code file does not display correctly, it may have been corrupted. Try re-downloading it and try again. If that does not solve the problem, refer to the help documentation of the specific application/terminal emulator you are using with regards default encoding.

MacOS

Navigate to Terminal -> Preferences from Terminal’s menu bar.

In the Preferences window select the Settings -> Advanced tab. Then, under the Character encoding drop-down box, select Unicode (UTF-8) and tick the box Set locale environment variables on startup.

To confirm that the default encoding has been successfully set, use the code in the snippet here.

Windows

Go to Start -> Edit environment variables for your account or Start -> Edit the system environment variables -> Environment Variables... From the System variables section, click on New.. Under the Variable name: type in PYTHONIOENCODING Under the Variable value: type in utf-8

To confirm that the default encoding has been successfully set, use the code in the snippet here.

Like what you see?

⭐️ Star the repository and share with your friends! ⭐️

If you rewrite this software in a different programming language or create a derivative work, please be kind and include this notice and the below credit along with the license:

This work is based on the original TrashGuy animation (https://github.com/trash-guy/TrashGuy) written by Zac (https://t.me/Zacci).

Really like what you see?

Feel free to donate so we can get some marshmallows 😁

⭐️ Supporters and Contributors

YouTwitFace | Modified I/O for use with Telegram (TrashGuy v2.0.0)

Special thanks to the folks down at Telethon Off-topic for their help and support!