Skip to main content

A terminal-based flashcard system.

Project description

Flashcard CLI - Your Terminal-Based Learning Companion

Flashcard CLI is a powerful and versatile command-line tool designed to help you learn and memorize information effectively using flashcards. Whether you're a student, a professional, or simply someone who enjoys learning, Flashcard CLI provides a convenient and engaging way to study and review your knowledge. alt text

Key Features

  • Easy to Use: Simple and intuitive command-line interface.
  • Customizable: Create and manage your own flashcard decks.
  • Interactive Learning: Engaging learning sessions with performance tracking.
  • Terminal-Based: Study without distractions, right in your terminal.

Installation

pip install flashcard-cli

(Image: Screenshot of the installation process)

Usage

Adding Flashcards

flashcard add

alt text This command will prompt you to enter a question and answer for your flashcard. The flashcard will be saved to flashcards.json by default.

Starting a Learning Session

flashcard start

alt text

This command will start a learning session, presenting each flashcard in a visually appealing card-like panel. The system will wait for you to press Enter to reveal the answer, then ask if you got it right. After all flashcards, it will show a summary of your performance.

Other Commands

  • flashcard manage: manag flascard with edit and delete.

alt text

Configuration

Troubleshooting

Make sure that the Flashcard CLI is installed correctly and that the flashcard command is in your system's PATH.

Development

To install in editable mode:

pip install -e .

Publishing to PyPI

To publish the package to PyPI, you need to build the package and then upload it to PyPI.

Build the Package

python -m build

This will create a dist directory with the built package.

Upload to PyPI

twine upload dist/*

Note: You will need to have twine installed (pip install twine) and have a PyPI account.

GitHub Workflow for PyPI Release

To automate the release process to PyPI, you can set up a GitHub workflow. See .github/workflows/release.yml for the workflow configuration.

Note:

  • You will need to configure a PyPI API token as a secret in your GitHub repository settings.

Contributing

Contributions are welcome! Please submit a pull request with your changes.

License

This project is licensed under the MIT License.

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

flashcard_cli-1.1.1.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

flashcard_cli-1.1.1-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file flashcard_cli-1.1.1.tar.gz.

File metadata

  • Download URL: flashcard_cli-1.1.1.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for flashcard_cli-1.1.1.tar.gz
Algorithm Hash digest
SHA256 6bd262a3f8f83079809fa4e3c2a4ffd6759e3c02e3f214fd9056c2b99b1cf5e0
MD5 521fb7c04dcbc894d6c14c13b9f6ca4b
BLAKE2b-256 c9d0d9a4d566f28fb3b3c9ddd944f7de92dc6dfbb68eb81678fa137de76f4831

See more details on using hashes here.

File details

Details for the file flashcard_cli-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: flashcard_cli-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.23

File hashes

Hashes for flashcard_cli-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3c8a71501d440eb4cbc850c0bdd12b11d07f16a36565668c9c1de89545e8abf2
MD5 3c5e989dedef7dd2c2c72f6c329ebad1
BLAKE2b-256 2bbc7b0bea11724cb3d6971dc746e5f44c787efac57e7f9c96644d094fac7f56

See more details on using hashes here.

Supported by

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