tomevault-io Search Skill
Purpose
Implement powerful search functionality for finding tasks.
Instructions
Basic Keyword Search
from typing import List
def search_tasks(self, keyword: str) -> List[dict]:
"""Search tasks by keyword in title and description."""
if not keyword:
return []
keyword = keyword.lower().strip()
def matches(task: dict) -> bool:
title = task.get('title', '').lower()
desc = task.get('description', '') or ''
desc = desc.lower()
return keyword in title or keyword in desc
return [t for t in self.get_all_tasks() if matches(t)]
Using TinyDB Query
def search_tasks(self, keyword: str) -> List[dict]:
"""Search using TinyDB query."""
keyword = keyword.lower()
return self.db.search(
(self.db.query.title.test(lambda t: keyword in t.lower())) |
(self.db.query.description.test(
lambda d: d is not None and keyword in d.lower()
))
)
Multi-Word Search
def search_all_words(self, query: str) -> List[dict]:
"""Search where ALL words must match."""
words = query.lower().split()
if not words:
return []
def matches_all(task: dict) -> bool:
text = f"{task.get('title', '')} {task.get('description', '')}".lower()
return all(word in text for word in words)
return [t for t in self.get_all_tasks() if matches_all(t)]
def search_any_word(self, query: str) -> List[dict]:
"""Search where ANY word can match."""
words = query.lower().split()
if not words:
return []
def matches_any(task: dict) -> bool:
text = f"{task.get('title', '')} {task.get('description', '')}".lower()
return any(word in text for word in words)
return [t for t in self.get_all_tasks() if matches_any(t)]
Search with Ranking
def search_ranked(self, keyword: str) -> List[dict]:
"""Search and rank by relevance."""
keyword = keyword.lower()
results = []
for task in self.get_all_tasks():
title = task.get('title', '').lower()
desc = (task.get('description', '') or '').lower()
score = 0
# Higher score for title matches
if keyword in title:
score += 10
# Even higher if starts with keyword
if title.startswith(keyword):
score += 5
# Lower score for description matches
if keyword in desc:
score += 3
if score > 0:
results.append((score, task))
# Sort by score descending
results.sort(key=lambda x: x[0], reverse=True)
return [task for _, task in results]
Search in Tags
def search_by_tag(self, tag: str) -> List[dict]:
"""Search tasks containing a specific tag."""
tag = tag.lower().strip()
return self.db.search(
self.db.query.tags.test(
lambda tags: tag in [t.lower() for t in tags]
)
)
def search_by_any_tag(self, tags: List[str]) -> List[dict]:
"""Search tasks containing any of the given tags."""
tags = [t.lower().strip() for t in tags]
return self.db.search(
self.db.query.tags.test(
lambda task_tags: any(
t.lower() in tags for t in task_tags
)
)
)
Full Search Service
class SearchService:
"""Comprehensive search functionality."""
def __init__(self, database):
self.db = database
def search(
self,
query: str = None,
tags: List[str] = None,
priority: str = None,
status: str = None,
include_completed: bool = True
) -> List[dict]:
"""Combined search with multiple criteria."""
tasks = self.db.get_all()
# Filter by keyword
if query:
query = query.lower()
tasks = [
t for t in tasks
if query in t.get('title', '').lower() or
query in (t.get('description', '') or '').lower()
]
# Filter by tags
if tags:
tags = [t.lower() for t in tags]
tasks = [
t for t in tasks
if any(tag.lower() in tags for tag in t.get('tags', []))
]
# Filter by priority
if priority:
tasks = [t for t in tasks if t.get('priority') == priority]
# Filter by status
if status:
tasks = [t for t in tasks if t.get('status') == status]
# Exclude completed
if not include_completed:
tasks = [t for t in tasks if t.get('status') != 'completed']
return tasks
Best Practices
- Always normalize search input (lowercase, strip)
- Handle None/empty values gracefully
- Implement case-insensitive matching
- Provide relevance ranking for better UX
- Support both AND and OR multi-word searches
- Cache results for repeated queries if needed
Converted and distributed by TomeVault — claim your Tome and manage your conversions.