Re: Org mode API

[Ihor Radchenko <yantar92@posteo.net>]

"Dr. Arne Babenhauserheide" <arne_bab@web.de> writes:

>> May you elaborate a bit on the problems with Org mode API?
>
> I use it to gather all entries for a kanban table and it took me a long
> time to understand the match and scope and to find what exactly I get
> from org-map-entries,¹ how to get the filtering and scope right,

What exactly was the difficulty? Is there anything that is not clear in
the docstring?

> ... and how
> to post-process the elemets.²

In your function I just see you getting headline title and CUSTOM_ID
property. I am not sure what difficulty you are talking about.

Did you see <https://orgmode.org/manual/Using-the-Property-API.html> and
<https://orgmode.org/manual/Using-the-Mapping-API.html>?

> And it’s not efficient, because org-map-entries actually gives me far
> more than what I need — what I’d actually need is to get the nth org
> element matching match and scope for which the passed function does not
> return nil.

How do you expect Org API to allow such a query? Do you need something
akin tree-sitter query syntax?

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>