Skip to main content

A simple command-line flash card interface.

Project description

**Simplefc**
============

A simple command-line flash card interface.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

**Description**
~~~~~~~~~~~~~~~

Beyond grade school, rote memorization vanishes from many of our lives,
but it happens to be a very valuable tool for retention. Train yourself
to remember new words, friends' birthdays, or important political
figures with simplefc. When you happen upon a factoid, add it to a
simplefc flash card set, then practice nightly or weekly. Practice by
term, definition, or both. You can even hone your study sessions
according to how well you've performed on each entry.

**Contents**
~~~~~~~~~~~~

1. Requirements
2. Installation
3. Usage
4. Planned Updates
5. Contact the author

**1. Requirements**
~~~~~~~~~~~~~~~~~~~
Python 2.7 or 3.5 (may work on other versions)
Tested on Ubuntu 14.04 and OS X 10.10.2.
Currently unavailable for Windows.


**2. Installation**
~~~~~~~~~~~~~~~~~~~

1. Open terminal/command prompt and enter: ``pip install simplefc``.
Must have pip installed.
2. Install from source tarball: 1.Navigate to
https://github.com/vlahm/simplefc/tree/master/dist.
3. Right-click ``simplefc-1.1.5.tar.gz`` and save link to desired
location.
4. Navigate to the folder where you saved the tarball, then execute:
3. Optional: to share your flash card sets across devices, simply move the simplefc database location to a shared drive using ``simplefc change_dbpath path/to/shared_drive/newfile.db`` on all devices.

``tar -xzvf simplefc-1.1.5.tar.gz #just right-click and extract if on Windows``

``pip install simplefc-1.1.5/``

(The slash is important in the above command.)

**3. Usage**
~~~~~~~~~~~~

Flash cards are stored as “entries” and are grouped in “sets”.
Sets are stored in database files (.db) and accessed internally via sqlite3.

::

Usage:
simplefc [-h | --help]
simplefc [-v | --version]
simplefc create_set <setname>
simplefc add_entry <setname> (-M <entry>... | -F <file>...)
simplefc study [-tdbamfsr] <setname>
simplefc view_set <setname>
simplefc view_archive <setname>
simplefc unarchive <setname> <ID>...
simplefc delete_entry <setname> <ID>...
simplefc list_sets
simplefc delete_set <setname>
simplefc view_dbpath
simplefc change_dbpath <newpath>
simplefc reset_data <setname>

Arguments:
<setname> The name of a simplefc flashcard set. Cannot
contain spaces or special characters. Must begin
with a letter. Use '.' in place of a setname with
the 'study' command to study all sets at once.
<entry> An entry of the form 'term;;definition'.
<file> A text file containing unquoted entries of the
above form. Each entry must have its own line.
<ID> The identification number of an entry.
<newpath> The location of simplefc's database file. Use
'default' to restore the default location.

Options:
-h --help Show this page.
-v --version Show version.
-M Add entries manually.
-F Add entries from a file.
-t Study terms.
-d Study definitions.
-b Study with randomized terms and definitions.
-a 'All' - Include all entries.
-m 'Many' - Exclude easy entries (those with
correct:incorrect ratio >= 2).
-f 'Few' - Include only hard entries (those with
correct:incorrect ratio <= 0.75).
-s Go through entries sequentially (in the order
they were recorded).
-r Go through entries in random order.


Examples:
simplefc create_set BIO450_final
simplefc add_entry BIO450_final -M 'xanthophyll;;a yellow or brown carotenoid pigment found in plants' 'anthocyanin;;a red flavonoid pigment found in plants' "Kingsfoil;;aye, it's a weed!"
simplefc study -bar BIO450_final
simplefc delete_entry BIO450_final 1 3
simplefc delete_set BIO450_final

--------------

**4. Planned Updates**
~~~~~~~~~~~~~~~~~~~~~~

- Commands for writing/reading flash card sets to/from .csv files
- Better error handling. If you get cryptic, internal errors, and the
answers aren't in the docs, open an issue on my Github. See below.
- Graphical illustrations of progress based on detailed performance data.

--------------

**5. Contact the author**
~~~~~~~~~~~~~~~~~~~~~~~~~

Mike Vlah:
- vlahm13@gmail[dot]com
- https://github.com/vlahm
- https://linkedin.com/in/michaelvlah

Project details


Download files

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

Source Distribution

simplefc-1.1.5.tar.gz (12.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page