VgW(FddlmZmZmZmZddlmZdZdZGddeZ y) )ListOptionalSequencecast) BaseProviderTlac neZdZdZdZdZ ddedeedee ede d e ef d Z ddeedee ed efd Z dd ed e dee ed efdZddedee ed e efdZ ddede dee ed efdZddedee ed e efdZddedee ed efdZ ddededee ed e 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.  .Nnbpart_of_speech ext_word_listuniquereturnc,||}n:|r,||jvrt|d|j|}n |j}|r*ttt |j ||}|Sttt |j||}|S)aZGenerate 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. ``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. .. 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 z' is not recognized as a part of speech.)length)parts_of_speech ValueError word_listrrstr random_samplerandom_choices)selfrrrrrunique_samplessampless _/var/www/html/hubwallet-dev/venv/lib/python3.12/site-packages/faker/providers/lorem/__init__.pywordszProvider.wordssD  $%I T%9%99 N#33Z![\\ 00@ I !$s)T-?-? RT-?-UVN! !tCy$"5"5i"5"KLc.|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)r)rrrs rwordz Provider.wordLszz!^];A>>r nb_wordsvariable_nb_wordsc|dkry|r|j|d}t|j||}|dj|d<|jj ||j zS)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)rr)randomize_nb_elementslistrtitleword_connectorjoinsentence_punctuation)rr$r%rrs rsentencezProvider.sentenceWss& q= 11(1BHTZZ8=ZIJ8>>#a""''.1J1JJJr c`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)ranger0rrr_s r sentenceszProvider.sentencesus+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(r2)r*r-r.r6)rr8r9rparas r paragraphzProvider.paragraphsP* 1  55l5JL""''|S`(ab r c`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'] rr2)r3r<r4s r paragraphszProvider.paragraphss+FK1b\R];RRRr7 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'r2r"Nd ) rr-r#appendlenpopupperr/r0r<r.) rr?rtextsizer# last_indexr0r<s rrIz 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}r nb_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)r3rI)rrLr?rr5s rtextszProvider.textss,AFa@RS1 , 6SSSr7)NNF)NN)TN)rON)rOTN)N)rOrQN)__name__ __module__ __qualname____doc__r-r/intrrrboolrrr#r0r6r<r>rIrNr rr r s N(,15 0 0! 0  . 0  0 c 0d ?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 cTr r N) typingrrrrr'r localizeddefault_localer rXr rr\s*11  lT|lTr