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

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

alt text

Starting a Learning Session

flashcard start

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.

alt text

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.0.tar.gz (8.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.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: flashcard_cli-1.1.0.tar.gz
  • Upload date:
  • Size: 8.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.0.tar.gz
Algorithm Hash digest
SHA256 07db85e7e8df67d95d1f23d527cd16d9be631e49765e98c7df1d321589fc09d9
MD5 59dc359c3bfb2306c23cd3194e8b006b
BLAKE2b-256 f0763e6d73582783631793699ffff772c503a31290b4781a7b43ce0fabd89487

See more details on using hashes here.

File details

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

File metadata

  • Download URL: flashcard_cli-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 db7bbbbfdfb7ab5265d197ba19016c0ea909ca65ef69c8faa73ebb7ee5cacd53
MD5 99a09ddf1a77285af8854926c33c7308
BLAKE2b-256 8e3b7d315a002482b8fbdd53d75ce28059740ff0c553a30d0a63c30ee2735154

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