\j,FddlmZmZmZmZddlmZdZdZGddeZ y) )ListOptionalSequencecast) BaseProviderTlac eZdZdZdZdZ ddeedeeede efdZ dd e dee edeed e de ef d Z ddeedeeedefd Z dd e de deeedefdZdd e deeede efdZ dde de deeedefdZdd e deeede efdZdde deeedefdZ dde de deeede efdZy) 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| |}t|S|r6||jvrt|d|j|}t|S|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. z' is not recognized as a part of speech.)parts_of_speech ValueError word_listlistselfrrrs H/root/env/lib/python3.12/site-packages/faker/providers/lorem/__init__.pyget_words_listzProvider.get_words_listss6  $%IIT%9%99 N#33Z![\\ 00@ IIInbuniquec|j||}|r*ttt|j ||}|Sttt|j ||}|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.wordsAsi8''~Ub'c !$s)T-?-? RT-?-UVN! !tCy$"5"5i"5"KLrcP|j||}|jd|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.wordes,'' F zz!Y'**rnb_wordsvariable_nb_wordsc|dkry|r|j|d}|j|}t|j||}|dj |d<|j 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= 11(1BH''m'D TZZ89ZEF8>>#a""''.1J1JJJrc`td|Dcgc]}|j|c}Scc}w)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'] rr.)ranger4rrr_s r sentenceszProvider.sentencess+EJ!RLQq M :QQQ+ nb_sentencesvariable_nb_sentencesc|dkry|r|j|d}|jj|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,r.)r/r1r2r9)rr;r<rparas r paragraphzProvider.paragraphsP* 1  55l5JL""''|S`(ab rc`td|Dcgc]}|j|c}Scc}w)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'] rr.)r6r?r7s r paragraphszProvider.paragraphss+FK1b\R];RRRr: max_nb_charsc2g}|dkr td|dkr|sbd}||krH|r |jnd|j|z}|j||t |z }||krH|j |sb|ddj |dddz|d<t |dz }||xx|jz cc<n|d kre|sd}||krH|r |jnd|j|z}|j||t |z }||krH|j |sbnZ|sXd}||kr>|rd nd|j|z}|j||t |z }||kr>|j |sXdj|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.r&Nd ) rr1r'appendlenpopupperr3r4r?r2) rrBrtextsizer' last_indexr4r?s rrLz Provider.texts ! UV V " \)37D//R499[h9CiiDKK%CI%D\) 1gaj&&(4712;6DGTQJ   9 9 9  C \)7; 3 3t}}cp}GqqHKK)CM)D\) \))-2Vc9d dIKK *C N*D\) wwt}rnb_textsc`td|Dcgc]}|j||c}Scc}w)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'] r)r6rL)rrOrBrr8s rtextszProvider.textss,AFa@RS1 , 6SSSr:)NN)NNF)TN)rRN)rRTN)N)rRrTN)__name__ __module__ __qualname____doc__r1r3rrrrrintboolr$r'r4r9r?rArLrQrrr r s N)-15%  %  .% c %R-1(, " " S *"! "  " c "H +8C= +QYZ]Q^H_ +kn +koKK48KPXYabeYfPgK K> RC RHXc]4K RW[\_W` Rsw<@X`aijmanXo > SS SXhsm5L SX\]`Xa S778HSM;R7^a7tdhTT/2TIQRZ[^R_I`T cTrr N) typingrrrrr+r localizeddefault_localer r[rrr_s*11  HT|HTr