B `[#@s(ddlmZdZdZGdddeZdS)) BaseProviderTZlac@sheZdZdZdZdZdddZdd d Zdd dZdddZ dddZ dddZ d ddZ d!ddZ dS)"ProvideraImplement default lorem provider for Faker. .. important:: The default locale of the lorem provider is ``la``. When using a locale without a localized lorem provider, the ``la`` lorem provider will be used, so generated words will be in pseudo-Latin. The locale used for the standard provider docs was ``en_US``, and ``en_US`` has a localized lorem provider which is why the samples here show words in American English.  .NFcCs.|r|n|j}|r |j||dS|j||dS)aGenerate a tuple of words. The ``nb`` argument controls the number of words in the resulting list, and if ``ext_word_list`` is provided, words from that list will be used instead of those from the locale provider's built-in word list. If ``unique`` is ``True``, this method will return a list containing unique words. Under the hood, |random_sample| will be used for sampling without replacement. If ``unique`` is ``False``, |random_choices| is used instead, and the list returned may contain duplicates. .. warning:: Depending on the length of a locale provider's built-in word list or on the length of ``ext_word_list`` if provided, a large ``nb`` can exhaust said lists if ``unique`` is ``True``, raising an exception. :sample: :sample: nb=5 :sample: nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'] :sample: nb=4, ext_word_list=['abc', 'def', 'ghi', 'jkl'], unique=True )length) word_listZ random_sampleZrandom_choices)selfnb ext_word_listuniquerr M/home/dcms/DCMS/lib/python3.7/site-packages/faker/providers/lorem/__init__.pywordsszProvider.wordscCs|d|dS)zGenerate a word. This method uses |words| under the hood with the ``nb`` argument set to ``1`` to generate the result. :sample: :sample: ext_word_list=['abc', 'def', 'ghi', 'jkl'] )r)r r r r rword3s z Provider.wordTcCsR|dkr dS|r|j|dd}t|j||d}|d|d<|j||jS)aGenerate a sentence. The ``nb_words`` argument controls how many words the sentence will contain, and setting ``variable_nb_words`` to ``False`` will generate the exact amount, while setting it to ``True`` (default) will generate a random amount (+/-40%, minimum of 1) using |randomize_nb_elements|. Under the hood, |words| is used to generate the words, so the argument ``ext_word_list`` works in the same way here as it would in that method. :sample: nb_words=10 :sample: nb_words=10, variable_nb_words=False :sample: nb_words=10, ext_word_list=['abc', 'def', 'ghi', 'jkl'] :sample: nb_words=10, variable_nb_words=True, ext_word_list=['abc', 'def', 'ghi', 'jkl'] rr)min)r r )randomize_nb_elementslistrtitleword_connectorjoinsentence_punctuation)r Znb_wordsZvariable_nb_wordsr rr r rsentence>szProvider.sentencecsfddtd|DS)aGenerate a list of sentences. This method uses |sentence| under the hood to generate sentences, and the ``nb`` argument controls exactly how many sentences the list will contain. The ``ext_word_list`` argument works in exactly the same way as well. :sample: :sample: nb=5 :sample: nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'] csg|]}jdqS))r )r).0_)r r r r fsz&Provider.sentences..r)range)r r r r )r r r sentencesZs zProvider.sentencescCs8|dkr dS|r|j|dd}|j|j||d}|S)a@Generate a paragraph. The ``nb_sentences`` argument controls how many sentences the paragraph will contain, and setting ``variable_nb_sentences`` to ``False`` will generate the exact amount, while setting it to ``True`` (default) will generate a random amount (+/-40%, minimum of 1) using |randomize_nb_elements|. Under the hood, |sentences| is used to generate the sentences, so the argument ``ext_word_list`` works in the same way here as it would in that method. :sample: nb_sentences=5 :sample: nb_sentences=5, variable_nb_sentences=False :sample: nb_sentences=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'] :sample: nb_sentences=5, variable_nb_sentences=False, ext_word_list=['abc', 'def', 'ghi', 'jkl'] rrr)r)r )rrrr!)r Z nb_sentencesZvariable_nb_sentencesr parar r r paragraphis  zProvider.paragraphcsfddtd|DS)a~Generate a list of paragraphs. This method uses |paragraph| under the hood to generate paragraphs, and the ``nb`` argument controls exactly how many sentences the list will contain. The ``ext_word_list`` argument works in exactly the same way as well. :sample: nb=5 :sample: nb=5, ext_word_list=['abc', 'def', 'ghi', 'jkl'] csg|]}jdqS))r )r#)rr)r r r rrsz'Provider.paragraphs..r)r )r r r r )r r r paragraphss zProvider.paragraphsc Cs~g}|dkrtd|dkrxR|snd}x<||krb|r:|jnd|j|d}|||t|7}q(W|qW|dd|ddd|d<t|d}|||j7<n|d krx|sd}x>||kr|r|jnd|j|d}|||t|7}qW|qWn\xZ|srd}x@||krd|r:d nd|j |d}|||t|7}q&W|qWd |S) a"Generate a text string. The ``max_nb_chars`` argument controls the approximate number of characters the text string will have, and depending on its value, this method may use either |words|, |sentences|, or |paragraphs| for text generation. The ``ext_word_list`` argument works in exactly the same way it would in any of those methods. :sample: max_nb_chars=20 :sample: max_nb_chars=80 :sample: max_nb_chars=160 :sample: ext_word_list=['abc', 'def', 'ghi', 'jkl'] z6text() can only generate text of at least 5 charactersrr)r rNd ) ValueErrorrrappendlenpopupperrrr#r) r max_nb_charsr textsizer last_indexrr#r r rr0sD    $        z Provider.textcsfddtd|DS)aGenerate a list of text strings. The ``nb_texts`` argument controls how many text strings the list will contain, and this method uses |text| under the hood for text generation, so the two remaining arguments, ``max_nb_chars`` and ``ext_word_list`` will work in exactly the same way as well. :sample: nb_texts=5 :sample: nb_texts=5, max_nb_chars=50 :sample: nb_texts=5, max_nb_chars=50, ext_word_list=['abc', 'def', 'ghi', 'jkl'] csg|]}qSr )r0)rr)r r/r r rrsz"Provider.texts..r)r )r Znb_textsr/r r )r r/r rtextss zProvider.texts)rNF)N)rTN)rN)rTN)rN)r%N)rr%N)__name__ __module__ __qualname____doc__rrrrrr!r#r$r0r3r r r rr s       =rN)rrZ localizedZdefault_localerr r r rs