tell / core /features.py
dmth10's picture
Upload 53 files
fb4fcd0 verified
Raw History Blame Contribute Delete
1.29 kB
"""
Every TELL tool is a Feature. To add one, subclass Feature in features.py,
decorate it with @register, and say which posts it wants. Nothing else changes.
"""
from .post import Post
class Feature:
name = "Feature"
description = ""
kinds: set[str] = set() # post kinds this looks at (empty = any kind)
needs_text = False # only run if there's readable text
ready = True # False = placeholder, shows as "coming soon"
def wants(self, post: Post) -> bool:
if self.kinds and post.kind not in self.kinds:
return False
if self.needs_text and not post.all_text:
return False
# a feature with no rules at all would grab every post, which is never what you want
return bool(self.kinds or self.needs_text)
def run(self, post: Post, options: dict) -> dict:
raise NotImplementedError(f"{self.name} has no run() yet")
_registry: list[Feature] = []
def register(cls):
if any(type(f) is cls for f in _registry):
return cls # module got imported twice, don't double up
_registry.append(cls())
return cls
def all_features() -> list[Feature]:
return list(_registry)
def pick(post: Post) -> list[Feature]:
return [f for f in _registry if f.wants(post)]