wonderwordsmodule
Wonderwords 2.2
Pythonで簡単にランダムな単語と文を生成します
GitHubリポジトリ| Pypi |ドキュメント
WonderWordsは、ランダムな単語と構造化されたランダム文を生成するのに役立つPythonパッケージです。また、ランダムな単語を迅速に生成するためのカラフルなコマンドラインインターフェイスも付属しています。最新バージョンはGitHubで利用でき、StableバージョンはPypiで利用できます。
WonderWordsができることは次のとおりです。
WonderWordsの最新バージョンをインストールするには、Python Package Indexのお気に入りのパッケージマネージャーを使用して、 wonderwordsパッケージをインストールします。たとえば、PIPで：
pip install wonderwordsPIPの使用でWonderwordsをアップグレードするには：
pip install --upgrade wonderwordsインストールが機能したことを確認するには、PythonにWonderwordsをインポートします。
import wonderwords ModuleNotFoundエラーが発生した場合は、上記のステップからWonderwordsをインストールしていることを確認してください。さらなる問題については、GitHubページから新しい問題を開きます。
このセクションでは、Wonderwordsの使用法について簡単に説明します。 WonderwordsにはコマンドラインインターフェイスとPythonモジュールがあるため、2つのサブセクションがあります。
ベースランダムワード生成クラスは、 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）を使用する前に、 pip install wonderwords[cli]を使用して、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アルファから始めて、WonderwordsはSematicバージョンを使用します。
WonderWordsはオープンソースであり、MITライセンスの下で配布されています。詳細については、ライセンスを参照してください。
すべての貢献は大歓迎です。WonderWordsが成長し続けることを願っています。貢献ガイドラインと開始方法については、 CONTRIBUTING.md読むことから始めます。
Wonderwordsは、次の作品のおかげで可能になりました。
profanitylist.txt
