Skip to main content

A PDF page/image randomizer, or flashcard quiz from a PDF.

Project description

pdf-shuffle

PyPI version shields.io PyPI license

A PDF page/image randomizer, or flashcard quiz from a PDF. Or randomize files from a folder.

Installation

$ pip install pdf-shuffle

Usage

pdf-shuffle comes with 2 CLI applications:

$ pdf-shuffle --help
Usage: pdf-shuffle [OPTIONS] FILENAME

Options:
  --start INTEGER
  --end TEXT
  --step INTEGER
  --random / --no-random
  --host TEXT
  --port INTEGER
  --help                  Show this message and exit.
$ pdf-shuffle test.pdf

And,

$ pdf-quiz --help
Usage: pdf-quiz [OPTIONS] FILENAME

Options:
  --start INTEGER
  --end TEXT
  --step INTEGER
  --random / --no-random
  --host TEXT
  --port INTEGER
  --help                  Show this message and exit.
$ pdf-quiz quiz.pdf

Of course, you can invoke the app from a Python script as well.

from pdf_shuffle import init
init('test.pdf')

Or,

from pdf_shuffle import init_quiz
init_quiz('quiz.pdf')

You can also random files in a folder:

from pdf_shuffle import init
init('test/')

Advanced usage

By default, quiz.pdf means, excluding the first slide, every first and second slides are front of the card and back of the card, respectively. You can change that, with:

import os, json
os.environ['PAGE_RANDOM'] = json.dumps([2, 3, 5, 9, 12])

Spaced-repetition system (SRS)

If you are looking into extending the app with SRS, you might try, srs-sqlite, which I currently use.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pdf_shuffle-0.2.1-py2.py3-none-any.whl (14.9 kB) Copy SHA256 hash SHA256 Wheel py2.py3
pdf-shuffle-0.2.1.tar.gz (6.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page