What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

Breaking change

⚠️ Important This release is number 7.0.0 because significant improvements to the Boolean code required a tiny breaking change, to a feature that we expect was hardly used.

Any Boolean filters with mixed delimiters, like this, will now give an error:

(not done) AND "is recurring"

They must be changed to use consistent delimiters. Example fixed lines:

(not done) AND (is recurring)
"not done" AND "is recurring"

See Breaking Changes for full details of these changes.

Boolean filters radically improved

Boolean filters can now contain parentheses - (....)- and double quotes - " - so long as the sub-expressions do not end with any closing delimiters.

The Troubleshooting Boolean Filters guide shows patterns to use, to get any Boolean filter to work now, however complex.

Breaking change:

• Disallow mixing delimiter types in Boolean queries by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2762

New features:

• Provide better Boolean help messages by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2761
• Support square brackets and curly braces to surround Boolean sub-expressions by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2763
• Fix any missing spaces around Boolean operators by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2767
• Further improve Boolean help messages by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2770

Bug fixes:

• 'explain' omitted the instruction line in some Boolean expressions by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2719
• allow Boolean filters such as "description includes abc" by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2755
• allow filters with ( ) and " delimiters in Boolean filters by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2759

Documentation: Combining Filters - Tasks User Guide - Obsidian Publish

Main changes

Here are the other most notable user-visible changes.

🌟 Features

• Add timing code to Tasks code block rendering code by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2740
  • See Console timing facilities in Tasks in the Contributing guide.

📖 Documentation

• Add Resources page by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2733
• Document many improvements to Boolean searches by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2772

🛠️ Behind the scenes

Improvements made to new features prior to their release:

Other changes:

• refactor: adopt SASS and break up styles.css file by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2717
• refactor: move TasksFile object to TaskLocation by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2752
• refactor: Introduce BooleanDelimiters class by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2754
• refactor: Start new code for preprocessing Boolean instructions by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2756
• refactor: Implement new preprocessor for Boolean searches by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2758
• vault: Speed up rendering in the Tasks demo vault by @claremacrae in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2741
• vault: explore parent child tasks with dataview by @ilandikov in https://github.com/obsidian-tasks-group/obsidian-tasks/pull/2769

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• https://github.com/obsidian-tasks-group/obsidian-tasks/compare/6.2.0…7.0.0

🙏 Support Tasks development

• https://github.com/sponsors/claremacrae