Skip to main content

Lightweight API that helps consumers generate random passwords and phrases.

Project description


countersign - A signal or password given in reply to a soldier on guard.

Countersign is a light-weight python library for generating highly customizable passwords.


Requires python 3.6 or above

pip install countersign



In countersign terms passwords are simply random character strings that are slightly configurable.

To generate a random password, import the password() function.

from countersign.password import password

# By default, generates some random password using 'string.printable' characters of length 8
generated_password = password()

Configuration can be accomplished as seen below.

from countersign.password import password

# Generates password of all unique characters using
# the characters '12345' with a length of 2
generated_password = password(characters='12345', length=2, unique=True)

If you require multiple random passwords to be generated at a time, use the passwords() function. The function returns a python generator that yields an unlimited count of random passwords and can bee configured the same as the password() function.

from countersign.password import passwords

# Returns a python generator capable of producing passwords with default characteristics
password_generator = passwords()


Passphrases are more structured passwords following certain configured patterns and even using given world dictionaries. Completely random passwords are great but sometimes a more human memorable pattern is more ideal.

Similar to passwords, passphrases can be constructed and configured the same way.

from countersign.passphrase import passphrase

words = ['Test', 'Word', 'More', 'Words']

# Passphrase using the words [Test, Word, More, Words] with no digit generation strategy. By default the passphrase consists of three given words.
# Produces something like: WordMoreTest
generated_passphrase = passphrase(words)

Passphrases can also be configured with a digit generation strategy which tells the passphrase generator to inject digit groups wherever specified.

from countersign.passphrase import passphrase, DigitGenerationStrategy, DigitPlacementStrategy

words = ['Test', 'Word', 'More', 'Words']

strategy = DigitGenerationStrategy(digit_count=3, placement=DigitPlacementStrategy.AFTER)

# Produces something like: WordWordsTest947
generated_passphrase = passphrase(words, digit_strategy=strategy)

Digit placement strategies include:

  • BEFORE 123TestWords

  • AFTER TestWords123

  • BEFORE_AND_AFTER 123TestWords123

  • IN_BETWEEN Test123Words

  • AROUND 123Test123Words123

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

countersign-0.1.0.tar.gz (4.8 kB view hashes)

Uploaded source

Built Distribution

countersign-0.1.0-py3-none-any.whl (5.5 kB view hashes)

Uploaded py3

Supported by

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