mukimov

Tiny cross-platform Python library: password prompt that shows * for each typed character — like getpass(), but with visual feedback.

from mukimov import stars

password = stars("Password: ")
print(password)

Terminal:

Password: ********

password contains the real text ("12345678"), only * are shown on screen.

Features

• Only standard library, zero dependencies
• Windows (msvcrt) + Linux/macOS (termios/tty)
• Each character is immediately replaced with *
• Backspace correctly deletes the last *
• Enter finishes input
• Real password is never printed
• Ctrl+C → KeyboardInterrupt, Ctrl+D on empty input → EOFError
• Falls back to getpass (no echo) when stdin is not a TTY (pipes, IDE, CI)

Install

pip install .

For development:

pip install -e .[test]  # or: pip install -e . && pip install pytest
pytest -q

Usage

from mukimov import stars

username = input("Username: ")
password = stars("Password: ")

print(username)

Username: mukimov
Password: ********

Custom mask character:

password = stars("Password: ", mask="#")

More examples — each typed character is echoed with your symbol, but the returned value is always the real password:

from mukimov import stars

password = stars("Password: ")       # input 12345 -> shows: Password: *****
password = stars("Password: ", "/")  # input 12345 -> shows: Password: /////
password = stars("Secret: ", "#")    # input hello -> shows: Secret: #####
password = stars("Password: ", "•")  # unicode masks work too

mask must be exactly one character, otherwise ValueError is raised:

stars("Password: ", "")    # ValueError: mask must be exactly one character
stars("Password: ", "/*")  # ValueError: mask must be exactly one character

Build & publish to PyPI

python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*

Test PyPI first:

python -m twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ mukimov

License

MIT