org-ql

Note: The next release, 0.5, may include changes which will require minor updates to written queries (e.g. a few predicates may be renamed). Users who wish to avoid those changes happening unexpectedly in their configs should avoid upgrading org-ql beyond 0.4 automatically, as they will be pushed to the master branch when ready.

Added

• Commands
  • helm-org-ql-views, which shows one of org-ql-views selected with Helm.
  • org-ql-search can search files in org-directory; customization options are available in the org-ql-search group.
  • org-ql-view-refresh can be called with a prefix argument to adjust search parameters.
• Queries
  • Negation of terms in plain queries using !. For example, tags:space !moon to exclude entries which contain moon.
  • Predicates outline-path (alias olp) and outline-path-segment (alias olps).
  • Predicate src, which matches Org Babel source blocks.
  • Predicates parent and ancestors. (Thanks to Josh Moller-Mara.)
  • Alias h for heading predicate.
  • Alias r for regexp predicate. (Thanks to Feng Shu.)
• Info manual.
• Function helm-org-ql-source, which returns a Helm source that searches given buffers/files with helm-org-ql. It can be used for custom Helm commands that search certain files.
• Display a message when views are refreshed. (Thanks to xeijin.)
• Respect Org Agenda restriction in org-ql-block. (Thanks to Ihor Radchenko for reporting.)
• Option org-ql-view-sidebar-sort-views.
• Mouseover help-echo text for org-ql-views default view names.
• "Dangling tasks" default view in org-ql-views. (Users who have modified org-ql-views from the default will not see the new view unless they copy it into their config.)

Changed

• Some default org-ql-view views (users who have modified org-ql-views from the default will not see the new views unless they copy them into their config):
  • Rename some views.
  • "Stuck projects" view (now uses descendants instead of children, which is more useful.

Fixed

• Inherit file tags when org-tag-inheritance is enabled. (Fixes #55. Thanks to Mikhail Skorzhinskiy.)
• Call helm-make-source directly instead of using helm-build-sync-source macro. (Fixes #60. Thanks to Matt Huszagh for reporting.)
• Search/view buffers now always end with a newline, which prevents side-scrolling of the window when calling end-of-buffer.
• Face for done to-do keywords in org-ql-view buffers. (Thanks to Yiming Chen.)
• Make view buffers read-only. (Fixes #72. Thanks to xeijin.)
• Sorting with single sorter specified as an atom. (Thanks to Jeff Filipovits.)
• Autoload for org-ql-block agenda block. (Fixes #53. Thanks to reports from Gus Cantieni, Karl Voit, rieje, and Jake | Junxuan.)

Internal

• Added generic node data cache to speed up recursive, tree-based queries.