/clj-anki

A Clojure Anki-file interaction library to read and write .anki2 and .apkg files

Primary LanguageClojureEclipse Public License 1.0EPL-1.0

clj-anki

A Clojure library designed to allow programmatic interaction with Anki packages.

Build Status Clojars Project

Leiningen/Boot

[clj-anki "0.0.2"]

Gradle

compile "clj-anki:clj-anki:0.0.2"

Maven

<dependency>
  <groupId>clj-anki</groupId>
  <artifactId>clj-anki</artifactId>
  <version>0.0.2</version>
</dependency>

Usage

After including this library

(require '[clj-anki.core :as anki])

You can write questions, answers, and tags to Anki packages. For example, to write some math questions with the tag "math" to a file called "math.apkg", you could:

(let [cards [{:question "3 + 4" :answers ["7"] :tags #{"math"}}
             {:question "4 + 5" :answers ["9"] :tags #{"math"}}]]
  (anki/map-seq-to-package! cards "math.apkg"))

The resulting package you can import into Anki.

You can also read notes from Anki packages:

(anki/read-notes "math.apkg")

Which after the above returns:

({:question "4 + 5", :answers ["9"], :tags #{"math"}}
 {:question "3 + 4", :answers ["7"], :tags #{"math"}})

Slightly more in-depth documentation can be found here.

License

Copyright © 2016-2017 Archenoth

Distributed under the Eclipse Public License version 1.0