Skip to main content

Blank random words in a text

Project description

Buca

Buca is a small Python script to blank some words in a text. I feed it with lyrics and it gives me a text with blanks I can then fill when listening to the song. It’s very helpful for vocabulary when learning a new language.

Install

pip3 install buca

Usage

buca [--ratio RATIO] [--fixed-size] [--numbers] [--max-count COUNT] [<file>]
  • --ratio RATIO: change the default blank-to-word ratio. The default is 0.12, i.e. about 12% of the words are removed.
  • --fixed-size: by default, missing words are replaced with a sequence of _ of the length of the word. Using this option changes that to a fixed length that doesn’t depend on the word.
  • --numbers: prefix blanks with an index, starting at 1. If you don’t want to print the text, you can report those numbers on a piece of paper.
  • --max-count COUNT: limit the blanked words count.

If <file> is not provided or if it’s -, the script reads on STDIN.

Because it relies on randomness, each invocation of the script on the same text should have different results. The number of blanked words may also change.

Note that a word is defined as a sequence of two or more alphanumerical characters.

Examples

Raw text:

Le cose che abbiamo in comune sono 4850
le conto da sempre, da quando mi hai detto
"ma dai, pure tu sei degli anno '60?"
abbiamo due braccia, due mani
due gambe, due piedi
due orecchie ed un solo cervello

Default parameters

$ buca example.txt
Le cose che abbiamo in comune sono 4850
le conto da sempre, da ______ __ hai detto
"ma dai, pure tu sei degli anno '__?"
abbiamo due braccia, due mani
___ gambe, due piedi
due orecchie ed un solo cervello

Increased ratio

$ buca --ratio 0.2 example.txt
Le cose che abbiamo __ comune sono ____
le conto da sempre, da quando __ hai detto
"ma dai, pure tu sei degli ____ '60?"
_______ due braccia, ___ ____
due gambe, due piedi
due ________ __ un solo cervello

Fixed-size

$ buca --fixed-size example.txt
Le cose che abbiamo in comune sono 4850
_____ conto da sempre, da quando mi hai _____
"ma dai, pure tu sei degli anno '60?"
abbiamo due braccia, due _____
due gambe, due piedi
due orecchie ed un solo cervello

With numbers

$ buca --numbers example.txt
Le (1) ____ che abbiamo in comune sono (2) ____
le conto da sempre, da quando mi hai detto
"ma dai, pure tu sei degli anno '60?"
abbiamo due braccia, due mani
(3) ___ gambe, due piedi
due orecchie (4) __ un solo cervello

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for buca, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size buca-0.0.2-py3-none-any.whl (4.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size buca-0.0.2.tar.gz (4.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page