Metadata-Version: 2.1
Name: pick3letters
Version: 1.0.0
Summary: Convert hex strings and magnet links to poetry or prose.
Home-page: https://github.com/seanlynch/pick3letters
Author: Sean R. Lynch
Author-email: seanl@literati.org
License: UNKNOWN
Keywords: bittorrent
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
License-File: COPYING

# Pick3letters

Pick3letters is a program to help inspire you to create poetry or
prose by taking a random string (hexadecimal strings and Torrent
magnet links are currently supported) and outputting lists of word
prefixes you can use. Just for fun, and for confirming that you used
the right prefixes, it also supports recovering the original hex
string or a working magnet link from the poetry or prose they came up
with.

# Usage

The output of pick3letters is a sequence of prefix lists, one per
line. For each line, choose a word of at least 4 letters that starts
with one of the prefixes. You may use capital letters and punctuation
at the end of a word, but any word that starts with punctuation or has
any punctuation mark within the prefix will be ignored during
decoding. Words shorter than 4 letters will also be ignored, making it
easy to insert articles, conjunctions, or fill words where needed
while still being able to check your work by "decoding" it.

To "encode", pass `-e`. To get back the original data, pass `-d`. If
your input or desired output is a hex string, pass `-x`, or if you
want to use a magnet link pass `-m`.

# The prefix list

The list of prefixes was generated with
`pick3letters/generate.py`. That takes a list of words and their
counts as input and generates a specified number of prefix lists as
output, such that the sum of counts of each prefix in a group is
approximately the same. It also allows filtering the list of words by
minimum count to avoid unusual prefixes or typoes. You can also change
the prefix length, the number of groups (which must be a power of 2),
and the minimum word length.

## Generating new prefix lists

You can run the generator with `python3 -m pick3letters.generate` for
usage information. For now, you'd need to replace prefixes.py with its
output, though at some point I'll probably add support for multiple
prefix lists.


