gi,NddlmZmZmZmZddlmZdZdZGddeZ dS) )ListOptionalSequencecast) BaseProviderTlac >eZdZdZdZdZ ddeedeeede efdZ dd e dee edeed e de ef d Z ddeedeeedefdZ d de de deeedefdZd!d e deeede efdZ d"de de deeedefdZd!d e deeede efdZd#de deeedefdZ d$de de deeede efdZdS)%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.  .Npart_of_speech ext_word_listreturnc||}n2|r)||jvrt|d|j|}n|j}t|S)a$Get list of words. ``ext_word_list`` is a parameter that allows the user to provide a list of words to be used instead of the built-in word list. If ``ext_word_list`` is provided, then the value of ``part_of_speech`` is ignored. ``part_of_speech`` is a parameter that defines to what part of speech the returned word belongs. If ``ext_word_list`` is not ``None``, then ``part_of_speech`` is ignored. If the value of ``part_of_speech`` does not correspond to an existent part of speech according to the set locale, then an exception is raised. :sample: part_of_speech="abc", ext_word_list=['abc', 'def', 'ghi', 'jkl'] :sample: part_of_speech="abc" :sample: ext_word_list=['abc', 'def', 'ghi', 'jkl'] .. 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. Nz' is not recognized as a part of speech.)parts_of_speech ValueError word_listlistselfrrrs v/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/faker/providers/lorem/__init__.pyget_words_listzProvider.get_words_lists`6  $%II  'T%999 N![![![\\\ 0@ IIFnbuniquec|||}|r7ttt|||}|Sttt|||}|S)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 ``word_list`` is not provided, the method will use a default value of None, which will result in the method calling the ``get_words_list`` method to get the word list. If ``word_list`` is provided, the method will use the provided 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. :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 )rr)length)rrrstr random_samplerandom_choices)rrrrrrunique_samplessampless rwordszProvider.wordsAs}8''~Ub'cc  "!$s)T-?-? RT-?-U-UVVN! !tCy$"5"5i"5"K"KLLrcf|||}|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)rr%rs rwordz Provider.wordes2'' FF zz!Y''**rTnb_wordsvariable_nb_wordsc6|dkrdS|r||d}||}t|||}|d|d<|j||jzS)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'minr)rr)randomize_nb_elementsrrr%titleword_connectorjoinsentence_punctuation)rr*r+rrr%s rsentencezProvider.sentencers& q==2  C11(1BBH''m'DD TZZ89ZEEFF8>>##a"''..1JJJrc@fdtd|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'] c<g|]}Sr0)r6.0_rrs r z&Provider.sentences..s'QQQq M ::QQQrrrangerrrs` `r sentenceszProvider.sentencess,RQQQQE!RLLQQQQr nb_sentencesvariable_nb_sentencesc|dkrdS|r||d}|j|||}|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'] rr-r'r.r0)r1r3r4rA)rrBrCrparas r paragraphzProvider.paragraphsa* 1  2  K55l5JJL"''|S`(a(abb rc@fdtd|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'] c<g|]}Sr9)rFr:s rr=z'Provider.paragraphs..s'RRR];;RRRrrr>r@s` `r paragraphszProvider.paragraphss,SRRRRU1b\\RRRRr max_nb_charscg}|dkrtd|dkr|smd}||krO|r|jnd||z}|||t |z }||kO||m|dd|dddz|d<t |dz }||xx|jz cc<n|d krp|smd}||krO|r|jnd||z}|||t |z }||kO||mnj|shd}||krJ|rd nd| |z}|||t |z }||kJ||hd |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-r0r'Nd ) rr3r(appendlenpopupperr5r6rFr4) rrKrtextsizer( last_indexr6rFs rrUz Provider.textsC !  UVV V "   \))37?D//R499[h9CiCiiDKK%%%CII%D\))  1gaj&&((47122;6DGTQJ     9 9     C   \))7; C 3 3t}}cp}GqGqqHKK)))CMM)D\))   \)))-!52Vc9d9d dIKK ***C NN*D\))  wwt}}rnb_textscDfdtd|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'] c<g|]}S)rU)r;r<rrKrs rr=z"Provider.texts..s'SSS1 , 66SSSrrr>)rrXrKrs` ``rtextszProvider.textss2TSSSSSa@R@RSSSSr)NN)rNNF)r)TN)rN)rTN)rJN)rrJN)__name__ __module__ __qualname____doc__r3r5rr rrrintboolr%r(r6rArFrIrUr\r[rrr r s  N)-15%%  %  .% c %%%%R-1(, "" " S *"! "  " c """"H + +8C= +QYZ]Q^H_ +kn + + + +koKKK48KPXYabeYfPgK KKKK> R RC RHXc]4K RW[\_W` R R R Rsw<@X`aijmanXo > S SS SXhsm5L SX\]`Xa S S S S7778HSM;R7^a7777tdhTTT/2TIQRZ[^R_I`T cTTTTTTrr N) typingrrrrr-r localizeddefault_localer r[rrrfs111111111111  HTHTHTHTHT|HTHTHTHTHTr