wonderwordsmodule
Wonderwords 2.2
С легкостью генерировать случайные слова и предложения в Python
GitHub Repository | Pypi | Документация
Wonderwords - это пакет Python, полезный для генерации случайных слов и структурированных случайных предложений. Он также поставляется с красочным интерфейсом командной строки для быстрого генерации случайных слов. Последняя версия доступна на GitHub, в то время как стабильная версия доступна на PYPI.
Вот на что способно Wonderwords:
Чтобы установить последнюю версию WonderWords, используйте свой любимый диспетчер пакетов для индекса пакета Python для установки пакета wonderwords . Например, с PIP:
pip install wonderwordsДля обновления Wonderwords с помощью PIP -использования:
pip install --upgrade wonderwordsЧтобы убедиться, что установка сработала, импортируйте Wonderwords в Python:
import wonderwords Если вы получите ошибку ModuleNotFound , убедитесь, что вы установили Wonderwords с шага выше. Для дальнейших вопросов откройте новую проблему со страницы Github.
В этом разделе кратко описать использование Wonderwords. Поскольку Wonderwords имеет интерфейс командной строки и модуль Python, вы найдете два подраздела.
Базовый класс генерации случайных слов - это класс RandomWord . Вы можете генерировать слова с помощью метода 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" ]) Вы также можете получить список всех слов, соответствующих некоторым критериям, используя метод 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 ) Вы также можете генерировать случайный список слов с помощью метода random_words . Это очень похоже на метод фильтра, за исключением того, что вы указываете количество слов для возврата, и слова выбираются случайным образом. Если не хватает слов, чтобы удовлетворить сумму, NoWordsToChooseFrom исключение, которое поднимается:
# 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 ) Генерировать случайные предложения легко использовать класс 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 () Слова организованы в категориях, таких как «существительные», «глаголы» и «прилагательные». Что если у вас есть свои собственные категории слов? Вы можете указать свои пользовательские категории при создании класса 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.*" )Наконец, начиная с версии 2.3, Wonderwords явно поддерживает фильтрацию ненормативной лексики из списков слов. На данный момент это рудиментарно:
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 ))Более продвинутое использование (и учебное пособие!) Находит в документации, например, добавление пользовательских категорий слов. Полную документацию со всей информацией можно найти по адресу: https://wonderwords.readthedocs.io
ПРИМЕЧАНИЕ . Перед использованием интерфейса командной строки (CLI) убедитесь, что вы установили все необходимые зависимости для CLI, используя pip install wonderwords[cli] . Wonderwords обычно не требуют зависимостей, но использует богатые для цветного вывода в командной строке.
WonderWords также предоставляет интерфейс командной строки, который можно использовать с командой wonderwords . Использование:
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
Основные команды:
-w : генерировать случайное слово-f : что работает очень похоже на функцию filter , чтобы вернуть все слова, соответствующие определенным критериям-l LIST : Получите список LIST случайных слов-s {bb,ss,bba,s} : генерировать случайное предложение:bb : голый костный предложениеss : простое предложение (голый костный предложение с прямым объектом)bba : голый костный предложение с прилагательнымs : генерировать простое предложение с прилагательным На ранних этапах Wonderwords не имела установленной системы управления версиями, и, следовательно, версии до v2.0.0-alpha находятся в беспорядке. Начиная с версии 2 Alpha, Wonderwords использует семанское управление версиями .
Wonderwords открыты и распространяется по лицензии MIT. Смотрите лицензию для более подробной информации.
Все вклады приветствуются, и мы надеемся, что Wonderwords продолжат расти. Начните с чтения CONTRIBUTING.md для внесения руководящих принципов и того, как начать.
Wonderwords стали возможными благодаря следующим работам:
profanitylist.txt от Robertjgabriel/Google-Profanity-Words по лицензии Apache-2.0
