dedicated update or edit command that accepts a card ID

[oddish3]

Hi there,

Firstly, thank you for your open source work—I’ve been using apy on and off for the past year and really appreciate it

One area where I think there’s room for improvement is in seamlessly editing Anki cards. While the review command exists, it requires navigating through an interactive interface (and pressing “e” to edit) even when I simply want to fix a typo or adjust my math typesetting. A more direct command, for example:

apy edit cid:1740342619916

would allow for immediate editing of a specific card by its ID. This not only streamlines the workflow but also opens up opportunities for automation, making it easier to keep my Obsidian vault and Anki in sync without manual intervention (since i am not sure how you and others use your markdown files from apy add-from-file, for me i use it as the ground truth).

And in that case, for new and edited cards, i see utility in there being a

apy update-from-file <file>

function that would allow for new and edited cards (with cid for edited) to handle both.

I’ve encountered situations where I had to switch to the Anki GUI just to correct small errors, and this direct editing approach would solve that inconvenience. I do have limited time to contribute, but I’m open to helping out if there’s interest in developing this feature.

Thanks again

[lervag]

Firstly, thank you for your open source work—I’ve been using apy on and off for the past year and really appreciate it

Thanks for the kind words!

One area where I think there’s room for improvement is in seamlessly editing Anki cards. While the review command exists, it requires navigating through an interactive interface (and pressing “e” to edit) even when I simply want to fix a typo or adjust my math typesetting.

Yes; this is geared to my own usage, but I can see how others may want different workflows!

A more direct command, for example:

apy edit cid:1740342619916

Ok, so apy edit QUERY where QUERY needs to filter down to a single card? Or, what should the behaviour be if QUERY matches many cards?

since i am not sure how you and others use your markdown files from apy add-from-file, for me i use it as the ground truth.

I delete my files after adding them to Anki. I do keep personal notes, but in a very different way.

And in that case, for new and edited cards, i see utility in there being a

apy update-from-file <file>

This is harder. Not necessarily impossible, but we need to spec it. E.g., I think we need to ensure that the entries are specified by an ID and to give an error if the ID is not found.

function that would allow for new and edited cards (with cid for edited) to handle both.

Ah, so you mean you could use it as add-from-file, because if the ID is not found you add a new card/note?

Notice that the note ID/card ID is generated, so you won't know if until after you created the cards the first time.

I’ve encountered situations where I had to switch to the Anki GUI just to correct small errors, and this direct editing approach would solve that inconvenience. I do have limited time to contribute, but I’m open to helping out if there’s interest in developing this feature.

Let's start with the apy edit command. It should not be too hard, but I have a lot of busy days the next couple of weeks, so I can't promise on being very fast right now.

I think the important first step is to make a suitable spec. E.g., how does apy edit -h look like? This is the help for apy review, for comparison:

> apy review -h
Usage: apy review [OPTIONS] [QUERY]...

  Review/Edit notes that match QUERY.

  The default QUERY is "tag:marked OR -flag:0". This default can be customized
  in the config file `~/.config/apy/apy.json`, e.g. with

  {
    "query": "tag:marked OR tag:leech"
  }

Options:
  -m, --check-markdown-consistency
                                  Check for Markdown consistency
  -n, --cmc-range INTEGER         Number of days backwards to check
                                  consistency
  -h, --help                      Show this message and exit.

[oddish3]

made a PR for a basic edit function in #111

[lervag]

Great, thanks!

[lervag]

#111 was merged, so I'll close this. We alos have #112 regarding apy update-from-file, but no need to keep this issue open.