Welcome to random_words’s documentation!

Contents:

How to use

Random words:

>>> from random_words import RandomWords
>>> rw = RandomWords()
>>> rw.random_word()
'ditto'

>>> rw.random_word(min_letter_count=10)
'recombinations'

>>> rw.random_word('y')
yards

>>> rw.random_word('a', min_letter_count=14)
'accomplishments'

>>> rw.random_words(count=10)
['runs', 'experience', 'comments', 'freedom', 'permit', 'honks', 'pins', 'texts', 'grant', 'fathers']

>>> rw.random_words(count=10, min_letter_count=14)
['superstructure', 'documentations', 'authorizations', 'administrations', 'responsibilities', 'multiplication', 'representative', 'reinforcements', 'accountabilities', 'telecommunication']

>>> rw.random_words(letter='r', count=5)
['raincoat', 'reactance', 'room', 'relocation', 'rudders']

>>> rw.random_words(letter='r', count=5, min_letter_count=6)
['recordkeeping', 'return', 'recapitulation', 'rowers', 'rheostat']

>>> rw.random_words(letter=None, count=2)
['tides', 'eights']

>>> rw.random_words(letter=None, count=2, min_letter_count=10)
['centerline', 'forecastles']

Random nicks:

>>> from random_words import RandomNicknames
>>> rn = RandomNicknames()

>>> rn.random_nick()
'Fredrick'

>>> rn.random_nick('y')
'York'

>>> rn.random_nick(letter='r', gender='m')
'Roosevelt'

>>> rn.random_nick(letter='r', gender='f')
'Rene'

>>> rn.random_nicks()
['Fionn']

>>> rn.random_nicks(count=10)
['Kristy', 'Imani', 'Delbert', 'Brevyn', 'Jasmin', 'Genevieve', 'Clodagh', 'Graham', 'Sondra', 'Ed']

>>> rn.random_nicks(letter='u', gender='f', count=4)
['Una', 'Uma', 'Ursula', 'Ulrica']

>>> rn.random_nicks(letter='a', gender='m', count=4)
['Anthony', 'Alec', 'Antonio', 'Adam']

>>> rn.random_nicks(gender='m', count=5)
['Elijah', 'Abraham', 'Noel', 'Myles', 'Pedro']

>>> rn.random_nicks(gender='f', count=5)
['Sabrina', 'Debbie', 'Jerri', 'Savannah', 'Wendy']

Random e-mails:

>>> from random_words import RandomEmails
>>> rand_mails = RandomEmails()

>>> rand_mails.randomMail()
'ernest@mail2java.com'

>>> rand_mails.randomMails()
['annmarie@mail2xox.com']

>>> rand_mails.randomMails(15)
['patrice@keko.com.ar', 'conor@mail2atom.com', 'vihan@mail2carolyn.com', 'felicia@looksmart.com.au', 'quinlan@accessgcc.com', 'aimee@china.net.vg', 'kate@mail2christmas.com', 'geoffrey@frommiami.com', 'lillie@comic.com', 'trinity@nagpal.net', 'bennett@webmail.co.za', 'jesse@chaiyomail.com', 'chase@iespana.es', 'mya@ijustdontcare.com', 'ramona@uole.com']

Lorem ipsum:

>>> from random_words import LoremIpsum
>>> li = LoremIpsum()
>>> li.get_sentence()
'Luctus molestie mazim netus temporsuspendisse, tristique nihil vestibulumnulla clita possim.'

>>> li.get_sentences(5)
'Esse erosin magnis cursus, in ullamcorper sapien et accusam. Arcu fringilla metusdonec. Magna tempus elitr lorem esse antesuspendisse, mi fusce luctus lacusnulla nullam porta. Takimata tation porttitor, amet aliquammauris enimsed dapibus. Assum lectus accusam fermentumfusce, iaculis turpis senectus id nunccurabitur.'

>>> li.get_sentences_list(5)
['Platea egestas delenit curae iaculis ullamcorper.', 'Felissed sagittis volutpat vitae, lacus nullam massapellentesque urnapraesent.', 'Dapibusnam vitae nulla, consectetuer conguenulla luptatum urnamorbi.', 'Ante nostra vero nihil eu odio.', 'Invidunt interdum condimentum ametduis, leopraesent tempus placerat aaenean ad.']

random_words Package

random_words Package

lorem_ipsum Module

class random_words.lorem_ipsum.LoremIpsum[source]

Bases: object

MAX_WORDS = 15
MIN_WORDS = 2
get_sentence()[source]

Return a sentence.

Returns:string with sentence
Return type:str
get_sentences(sentences=1)[source]

Return sentences in string.

Parameters:sentences (int) – how many sentences.
Returns:string with sentences
Return type:str
get_sentences_list(sentences=1)[source]

Return sentences in list.

Parameters:sentences (int) – how many sentences
Returns:list of strings with sentence
Return type:list
static make_sentence(list_words)[source]

Return a sentence from list of words.

Parameters:list_words (list) – list of words
Returns:sentence
Return type:str

random_words Module

class random_words.random_words.Random(file)[source]

Bases: dict

static check_int(a, count)[source]

Checks count

Parameters:count (int) – count number ;)
Raises:ValueError
load_dmails(file)[source]

Load list from file for random mails

Parameters:file (str) – filename
load_file(file)[source]
Parameters:file (str) – filename
load_nicknames(file)[source]

Load dict from file for random nicknames.

Parameters:file (str) – filename
load_nouns(file)[source]

Load dict from file for random words.

Parameters:file (str) – filename
class random_words.random_words.RandomEmails[source]

Bases: random_words.random_words.Random

randomMail()[source]

Return random e-mail.

Return type:str
Returns:random e-mail
randomMails(count=1)[source]

Return random e-mails.

Return type:list
Returns:list of random e-mails
class random_words.random_words.RandomNicknames[source]

Bases: random_words.random_words.Random

random_nick(letter=None, gender=None)[source]

Return random nick.

Parameters:
  • letter (str) – letter
  • gender (str) – 'f' for female, 'm' for male and None for both
Return type:

str
Returns:

random nick
random_nicks(letter=None, gender='u', count=1)[source]

Return list of random nicks.

Parameters:
  • letter (str) – letter
  • gender (str) – 'f' for female, 'm' for male and None for both
  • count (int) – how much nicks
Return type:

list
Returns:

list of random nicks
Raises:

ValueError
class random_words.random_words.RandomWords[source]

Bases: random_words.random_words.Random

random_word(letter=None, min_letter_count=1)[source]

Return random word.

Parameters:
  • letter (str) – letter
  • min_letter_count (int) – minimum letter count
Return type:

str
Returns:

random word
random_words(letter=None, min_letter_count=1, count=1)[source]

Returns list of random words.

Parameters:
  • letter (str) – letter
  • min_letter_count (int) – minimum letter count
  • count (int) – how much words
Return type:

list
Returns:

list of random words
Raises:

ValueError

Indices and tables