wonderwordsmodule
Wonderwords 2.2
Gerar palavras e frases aleatórias com facilidade em python
Repositório do GitHub | Pypi | Documentação
Wonderwords é um pacote python útil para gerar palavras aleatórias e frases aleatórias estruturadas. Ele também vem com uma interface de linha de comando colorida para gerar rapidamente palavras aleatórias. A versão mais recente está disponível no GitHub enquanto a versão estável está disponível no Pypi.
Aqui está o que a Wonderwords é capaz de:
Para instalar a versão mais recente do WonderWords, use seu gerenciador de pacotes favorito para o Pycon Package Index para instalar o pacote wonderwords . Por exemplo, com PIP:
pip install wonderwordsPara atualizar o Wonderwords com o uso do PIP:
pip install --upgrade wonderwordsPara verificar se a instalação funcionou, importe as palavras -chave no Python:
import wonderwords Se você receber um erro ModuleNotFound , verifique se você instalou palavras -admiração a partir da etapa acima. Para mais questões, abra uma nova edição na página do Github.
Esta seção descreverá brevemente o uso do Wonderwords. Como o Wonderwords possui uma interface de linha de comando e módulo Python, você encontrará duas subseções.
A classe base de geração de palavras aleatórias é a classe RandomWord . Você pode gerar palavras com o método word :
from wonderwords import RandomWord
r = RandomWord ()
# generate a random word
r . word ()
# random word that starts with a and ends with en
r . word ( starts_with = "a" , ends_with = "en" )
# generate a random noun or adjective, by default all parts of speech are included
r . word ( include_parts_of_speech = [ "nouns" , "adjectives" ])
# generate a random word between the length of 3 and 8 characters
r . word ( word_min_length = 3 , word_max_length = 8 )
# generate a random word with a custom Python regular expression
r . word ( regex = ".*a" )
# some of the words in the default word lists have spaces, such as 'contact lens'
# this option disables them
r . word ( exclude_with_spaces = True )
# you can combine multiple filtering options
r . word ( starts_with = "ru" , word_max_length = 10 , include_parts_of_speech = [ "verbs" ]) Você também pode obter uma lista de todas as palavras que correspondem a alguns critérios usando o método filter :
# get a list of ALL words that start with "am"
r . filter ( starts_with = "am" )
# you can use all the options found in the word method:
r . filter ( ends_with = "k" , include_parts_of_speech = [ "verbs" ], word_min_length = 4 ) Você também pode gerar uma lista aleatória de palavras com o método random_words . É muito parecido com o método do filtro, exceto que você especifica a quantidade de palavras para retornar, e as palavras são escolhidas aleatoriamente. Se não houver palavras suficientes para satisfazer a quantidade, uma exceção NoWordsToChooseFrom é levantada:
# get a list of 3 random nouns
r . random_words ( 3 , include_parts_of_speech = [ "nouns" ])
# you can use all the options found in the word method
r . random_words ( 5 , starts_with = "o" , word_min_length = 10 )
# if the amount of words you want to get is larger than the amount of words
# there are, a NoWordsToChooseFrom exception is raised:
r . random_words ( 100 , starts_with = "n" , word_min_length = 16 )
# there are less than 100 words that are at least 16 letters long and start with
# n, so an exception is raised
# you can silence the NoWordsToChooseFrom exception and return all words even
# if there are less, by setting return_less_if_necessary to True
r . random_words ( 100 , starts_with = "n" , word_min_length = 16 , return_less_if_necessary = True ) A geração de frases aleatórias é fácil usando a classe RandomSentence :
from wonderwords import RandomSentence
s = RandomSentence ()
# Get a random bare-bone sentence
s . bare_bone_sentence ()
# Get a random bare-bone sentence with a direct object
s . simple_sentence ()
# Get a random bare-bone sentence with an adjective
s . bare_bone_with_adjective ()
# Get a random sentence with a subject, predicate, direct object and adjective
s . sentence () As palavras são organizadas em categorias, como "substantivos", "verbos" e "adjetivos". E se você tivesse suas próprias categorias de palavras? Você pode especificar suas categorias personalizadas ao instanciar a classe RandomWord :
from wonderwords import RandomWord
cars = [ "Chevrolet" , "Subaru" , "Tesla" ]
airplanes = [ "Boeing" , "Airbus" , "Cessna" ]
w = RandomWord ( cars = cars , airplanes = airplanes )
# Will return a random car or airplane
w . word ()
# Will return a random car
w . word ( include_categories = [ "cars" ])
# You can also mix and match custom categories with defaults
from wonderwords import Defaults
proper_nouns = [ "Austin" , "Seattle" , "New York" ]
w2 = RandomWord ( proper_nouns = proper_nouns , common_nouns = Defaults . NOUNS )
# Will return either Seattle or seat
w . word ( regex = "[Ss]eat.*" )Finalmente, começando com a versão 2.3, o Wonderwords possui suporte explícito para filtrar palavrões de listas de palavras. No momento, isso é rudimentar:
from wonderwords import is_profanity , filter_profanity
# Test against words that could possibly be offensive. Good of user-facing apps.
is_profanity ( "apple" ) # False
# Can be done with a list
words = [ ... ]
# The function returns a generator, so we convert it to a list
words_clean = list ( filter_profanity ( words ))O uso mais avançado (e um tutorial!) É encontrado na documentação, como adicionar categorias personalizadas de palavras. A documentação completa com todas as informações pode ser encontrada em: https://wonderwords.readthedocs.io
Nota : Antes de usar a interface da linha de comando (CLI), verifique se você instalou todas as dependências necessárias para a CLI usando pip install wonderwords[cli] . O Wonderwords normalmente não requer dependências, mas usa rico para saída colorida na linha de comando.
O Wonderwords também fornece uma interface de linha de comando, que pode ser usada com o comando wonderwords . Uso:
usage: wonderwords [-h] [-w] [-f] [-l LIST] [-s {bb,ss,bba,s}] [-v] [-S STARTS_WITH] [-e ENDS_WITH]
[-p {noun,verb,adjective,nouns,verbs,adjectives} [{noun,verb,adjective,nouns,verbs,adjectives} ...]]
[-m WORD_MIN_LENGTH] [-M WORD_MAX_LENGTH] [-r REGEX] [-x] [-d DELIMITER] [-E]
Generate random words and sentences from the command line. Here is a full list of available commands. To learn more
about each command, go to the documentation at https://wonderwords.readthedocs.io
options:
-h, --help show this help message and exit
-w, --word, --random-word
generate a random word
-f, --filter get a list of all known words matching the criteria specified
-l LIST, --list LIST return a list of a certain length of random words
-s {bb,ss,bba,s}, --sentence {bb,ss,bba,s}
return a sentence based on the structure chosen
-v, --version print the version number and exit
-S STARTS_WITH, --starts-with STARTS_WITH
strings the random word(s) should start with
-e ENDS_WITH, --ends-with ENDS_WITH
strings the random word(s) should end with
-p {noun,verb,adjective,nouns,verbs,adjectives} [{noun,verb,adjective,nouns,verbs,adjectives} ...], --parts-of-speech {noun,verb,adjective,nouns,verbs,adjectives} [{noun,verb,adjective,nouns,verbs,adjectives} ...]
only include certain parts of speech (by default all parts of speech are included)
-m WORD_MIN_LENGTH, --word-min-length WORD_MIN_LENGTH
minimum length of the word(s)
-M WORD_MAX_LENGTH, --word-max-length WORD_MAX_LENGTH
maximum length of the word(s)
-r REGEX, --regex REGEX, --re REGEX, --regular-expression REGEX
a python-style regular expression for the word(s) to match
-x, --exclude-with-spaces
exclude open compounds, such as 'contact lens'
-d DELIMITER, --delimiter DELIMITER
specify the delimiter to put between a list of words, default is ', '
-E, --suppress-error-on-less
suppress errors when less words are returned in a list then wanted
Os comandos básicos são:
-w : gerar uma palavra aleatória-f : que funciona como a função filter para retornar todas as palavras que correspondem a um determinado critério-l LIST : Obtenha uma lista de palavras aleatórias LIST-s {bb,ss,bba,s} : Gere uma frase aleatória:bb : frase de osso nuass : frase simples (frase de osso nu com objeto direto)bba : frase de osso nu com adjetivos : gerar uma frase simples com um adjetivo Durante seus estágios iniciais, o Wonderwords não tinha um sistema de versão definido e, portanto, as versões antes v2.0.0-alpha estão em desordem. Começando com a versão 2 Alpha, o Wonderwords usa versão semática .
O Wonderwords é de código aberto e é distribuído sob a licença do MIT. Consulte a licença para obter mais detalhes.
Todas as contribuições são bem -vindas e esperamos que as palavras -admiração continuem crescendo. Comece lendo LEITURA CONTRIBUTING.md PARA DIREITAS COLVORTAS E COMO COMENHAR.
Wonderwords foi possível graças aos seguintes trabalhos:
profanitylist.txt de Robertjgabriel/Google-Profanity-Words sob a licença Apache-2.0
