Set scope to tree or region

[hubisan]

Org-map-entries has a scope argument that determines the scope of the command.

It supports the following values among others:

tree    The subtree started with the entry at point
region  The entries within the active region, if any

Can this be done with org-ql (limit the headlines parsed to a subtree or region)?

[hubisan]

I found a working solution:

(with-current-buffer (org-get-indirect-buffer)
  (org-narrow-to-subtree)
  ;; (narrow-to-region)
  (org-ql (current-buffer) nil :narrow t :action (org-get-outline-path t))
  (kill-current-buffer))

Can this be added with a keyword :scope with values tree and region?

[alphapapa]

Hi,

For region, :narrow t already does that.

For tree, I am thinking about how to best implement more complex search targets. See notes at https://github.com/alphapapa/org-ql/blob/master/notes.org#a-outline-path-in-buffers-files-arg It should probably also accept markers, or maybe (buffer . pos) cells. It will require some refactoring in a few places, so I'll probably do that for version 0.3 or something like that.

Thanks.

[hubisan]

Sounds promising. This is actually close to the capturing templates target element syntax.

So BUFFERS-FILES can be one of the following expression or an expression which evaluates to a list of files, buffers or one of the following expressions:

• Outline path (olp "file or buffer name" "Level 1 heading" "Level 2" ...)
  Search the subtree of parent heading matching outline path in file or buffer.
• ID (id "file or buffer name" "id_name")
  Search the subtree of parent heading matching ID in file or buffer.
• Point (point "file or buffer name" point)
  Search the subtree at point in file or buffer.
• Marker (marker #<marker>):
  Search the subtree at marker.

Maybe in addition:

• Bookmark (bookmark "file or buffer name" "bookmark name")
  Search the subtree at bookmark.
• Function (function (lambda () (...)))
  Search the subtree at the location returned by function)

An example:

(org-ql (buffer
         "~/org/ideas.org"
         (olp "~/org/inbox.org" "Emacs" "Ideas")
         (id "~/org/someday.org" "ideas")
         (point "~/org/tickler.org" 312))
  (todo "NEXT"))

To include the parent an option could be added:

(olp "~/org/inbox.org" "Emacs" "Ideas" :parent t)

And thx a lot for making org-ql.