flashcard

README

flashcard

Description

A Go package for flashcard mainipulation and learning.

⚡️ The project is in rapid stage of development, issues and critics are welcome.

Features

• expressive API
• sqlite as a storage; others can be added via implementation of storage.CardRepo and storage.DeckRepo interfaces

Table of contents

• flashcard
  • Description
  • Features
  • Table of contents
  • Getting started
    • Installation
    • Usage

Getting started

See the documentation for further details.

Installation

go get github.com/k1gabyt0/flashcard

Usage

Documentation

Index

• Variables
• type Card
• type Deck
• type DeckManager
  • func NewManager(storage storage.Storage) DeckManager
  • func NewManagerWithService(service service.FlashcardService) DeckManager

Variables

var DefaultCardValidations = []valdy.CreateRuleFunc[value.Card]{
	validations.NotEmptyCardFront,
	validations.NotEmptyCardBack,
}

Types

type Card

type Card interface {
	GetDeck() Deck
	GetValue() value.Card

	Front() string
	SetFront(val string) error

	Back() string
	SetBack(val string) error

	Update(front, back string) error

	PutInDeck(deck Deck) error
	Delete() error
}

Card describes flashcard, stored in some deck.

type Deck

type Deck interface {
	GetValue() value.Deck

	GetName() string
	Rename(newName string) error

	ListAllCards() ([]Card, error)
	Count() (int, error)
	FilterCards(filterFunc func(value.Card) bool) ([]Card, error)

	FindCards(front, back string) ([]Card, error)
	FindCardsByFront(front string) ([]Card, error)

	AddCard(front, back string) (Card, error)

	Clear() error
	Delete() error
}

Deck is an interface that describes all opertions that deck of flashcards can do.

type DeckManager

type DeckManager interface {
	ListAllDecks() ([]Deck, error)
	Count() (int, error)
	CreateDeck(name string) (Deck, error)
	FindDeckByName(name string) (Deck, error)
	FilterDecks(filterFunc func(value.Deck) bool) ([]Deck, error)
}

DeckManager is an interface that describes deck management.

func NewManager

func NewManager(storage storage.Storage) DeckManager

NewManager creates new deckManager with passed storage.

func NewManagerWithService

func NewManagerWithService(service service.FlashcardService) DeckManager

NewManagerWithService creates new deckManager with passed service.