1 """

     2 Utility functions for generating "lorem ipsum" Latin text.

     3 """

     4 

     5 import random

     6 

     7 COMMON_P = 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.'

     8 

     9 WORDS = ('exercitationem', 'perferendis', 'perspiciatis', 'laborum', 'eveniet',

    10         'sunt', 'iure', 'nam', 'nobis', 'eum', 'cum', 'officiis', 'excepturi',

    11         'odio', 'consectetur', 'quasi', 'aut', 'quisquam', 'vel', 'eligendi',

    12         'itaque', 'non', 'odit', 'tempore', 'quaerat', 'dignissimos',

    13         'facilis', 'neque', 'nihil', 'expedita', 'vitae', 'vero', 'ipsum',

    14         'nisi', 'animi', 'cumque', 'pariatur', 'velit', 'modi', 'natus',

    15         'iusto', 'eaque', 'sequi', 'illo', 'sed', 'ex', 'et', 'voluptatibus',

    16         'tempora', 'veritatis', 'ratione', 'assumenda', 'incidunt', 'nostrum',

    17         'placeat', 'aliquid', 'fuga', 'provident', 'praesentium', 'rem',

    18         'necessitatibus', 'suscipit', 'adipisci', 'quidem', 'possimus',

    19         'voluptas', 'debitis', 'sint', 'accusantium', 'unde', 'sapiente',

    20         'voluptate', 'qui', 'aspernatur', 'laudantium', 'soluta', 'amet',

    21         'quo', 'aliquam', 'saepe', 'culpa', 'libero', 'ipsa', 'dicta',

    22         'reiciendis', 'nesciunt', 'doloribus', 'autem', 'impedit', 'minima',

    23         'maiores', 'repudiandae', 'ipsam', 'obcaecati', 'ullam', 'enim',

    24         'totam', 'delectus', 'ducimus', 'quis', 'voluptates', 'dolores',

    25         'molestiae', 'harum', 'dolorem', 'quia', 'voluptatem', 'molestias',

    26         'magni', 'distinctio', 'omnis', 'illum', 'dolorum', 'voluptatum', 'ea',

    27         'quas', 'quam', 'corporis', 'quae', 'blanditiis', 'atque', 'deserunt',

    28         'laboriosam', 'earum', 'consequuntur', 'hic', 'cupiditate',

    29         'quibusdam', 'accusamus', 'ut', 'rerum', 'error', 'minus', 'eius',

    30         'ab', 'ad', 'nemo', 'fugit', 'officia', 'at', 'in', 'id', 'quos',

    31         'reprehenderit', 'numquam', 'iste', 'fugiat', 'sit', 'inventore',

    32         'beatae', 'repellendus', 'magnam', 'recusandae', 'quod', 'explicabo',

    33         'doloremque', 'aperiam', 'consequatur', 'asperiores', 'commodi',

    34         'optio', 'dolor', 'labore', 'temporibus', 'repellat', 'veniam',

    35         'architecto', 'est', 'esse', 'mollitia', 'nulla', 'a', 'similique',

    36         'eos', 'alias', 'dolore', 'tenetur', 'deleniti', 'porro', 'facere',

    37         'maxime', 'corrupti')

    38 

    39 COMMON_WORDS = ('lorem', 'ipsum', 'dolor', 'sit', 'amet', 'consectetur',

    40         'adipisicing', 'elit', 'sed', 'do', 'eiusmod', 'tempor', 'incididunt',

    41         'ut', 'labore', 'et', 'dolore', 'magna', 'aliqua')

    42 

    43 def sentence():

    44     """

    45     Returns a randomly generated sentence of lorem ipsum text.

    46 

    47     The first word is capitalized, and the sentence ends in either a period or

    48     question mark. Commas are added at random.

    49     """

    50     # Determine the number of comma-separated sections and number of words in

    51     # each section for this sentence.

    52     sections = [u' '.join(random.sample(WORDS, random.randint(3, 12))) for i in range(random.randint(1, 5))]

    53     s = u', '.join(sections)

    54     # Convert to sentence case and add end punctuation.

    55     return u'%s%s%s' % (s[0].upper(), s[1:], random.choice('?.'))

    56 

    57 def paragraph():

    58     """

    59     Returns a randomly generated paragraph of lorem ipsum text.

    60 

    61     The paragraph consists of between 1 and 4 sentences, inclusive.

    62     """

    63     return u' '.join([sentence() for i in range(random.randint(1, 4))])

    64 

    65 def paragraphs(count, common=True):

    66     """

    67     Returns a list of paragraphs as returned by paragraph().

    68 

    69     If `common` is True, then the first paragraph will be the standard

    70     'lorem ipsum' paragraph. Otherwise, the first paragraph will be random

    71     Latin text. Either way, subsequent paragraphs will be random Latin text.

    72     """

    73     paras = []

    74     for i in range(count):

    75         if common and i == 0:

    76             paras.append(COMMON_P)

    77         else:

    78             paras.append(paragraph())

    79     return paras

    80 

    81 def words(count, common=True):

    82     """

    83     Returns a string of `count` lorem ipsum words separated by a single space.

    84 

    85     If `common` is True, then the first 19 words will be the standard

    86     'lorem ipsum' words. Otherwise, all words will be selected randomly.

    87     """

    88     if common:

    89         word_list = list(COMMON_WORDS)

    90     else:

    91         word_list = []

    92     c = len(word_list)

    93     if count > c:

    94         count -= c

    95         while count > 0:

    96             c = min(count, len(WORDS))

    97             count -= c

    98             word_list += random.sample(WORDS, c)

    99     else:

   100         word_list = word_list[:count]

   101     return u' '.join(word_list)