Skip to content

Speakr is a personal, self-hosted web application designed for transcribing audio recordings

Python
4.4 KB
Raw Blame
"""
NamingTemplate model for user-defined recording title formatting.

This module defines the NamingTemplate model for storing
custom templates for generating recording titles from filenames,
metadata, and AI-generated content.
"""

import json
import re
import os
from datetime import datetime
from src.database import db


class NamingTemplate(db.Model):
    """Stores user-defined templates for recording title generation."""

    id = db.Column(db.Integer, primary_key=True)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
    name = db.Column(db.String(100), nullable=False)
    template = db.Column(db.Text, nullable=False)  # e.g., "{{phone}} - {{date}} {{ai_title}}"
    description = db.Column(db.String(500), nullable=True)
    regex_patterns = db.Column(db.Text, nullable=True)  # JSON: {"phone": "\\d{10}", "caller": "^([^-]+)"}
    is_default = db.Column(db.Boolean, default=False)
    created_at = db.Column(db.DateTime, default=datetime.utcnow)
    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)

    # Relationships
    user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('naming_templates', lazy=True, cascade='all, delete-orphan'))

    def to_dict(self):
        """Convert model to dictionary representation."""
        return {
            'id': self.id,
            'name': self.name,
            'template': self.template,
            'description': self.description,
            'regex_patterns': json.loads(self.regex_patterns) if self.regex_patterns else {},
            'is_default': self.is_default,
            'created_at': self.created_at.isoformat() if self.created_at else None,
            'updated_at': self.updated_at.isoformat() if self.updated_at else None
        }

    def get_regex_patterns(self):
        """Parse and return regex patterns as dictionary."""
        if not self.regex_patterns:
            return {}
        try:
            return json.loads(self.regex_patterns)
        except json.JSONDecodeError:
            return {}

    def needs_ai_title(self):
        """Check if template requires AI-generated title."""
        return '{{ai_title}}' in self.template

    def apply(self, original_filename, meeting_date=None, ai_title=None):
        """
        Apply this template to generate a recording title.

        Args:
            original_filename: The original filename of the recording
            meeting_date: Optional datetime of the recording
            ai_title: Optional AI-generated title

        Returns:
            Generated title string, or None if template produces empty result
        """
        # Start with template
        result = self.template

        # Get filename without extension for {{filename}}
        filename_no_ext = os.path.splitext(original_filename)[0] if original_filename else ''

        # Build built-in variables
        variables = {
            'ai_title': ai_title or '',
            'filename': filename_no_ext,
            'filename_full': original_filename or '',
            'date': meeting_date.strftime('%Y-%m-%d') if meeting_date else '',
            'datetime': meeting_date.strftime('%Y-%m-%d %H:%M') if meeting_date else '',
            'time': meeting_date.strftime('%H:%M') if meeting_date else '',
            'year': meeting_date.strftime('%Y') if meeting_date else '',
            'month': meeting_date.strftime('%m') if meeting_date else '',
            'day': meeting_date.strftime('%d') if meeting_date else '',
        }

        # Extract custom variables from filename using regex patterns
        regex_patterns = self.get_regex_patterns()
        for var_name, pattern in regex_patterns.items():
            try:
                match = re.search(pattern, filename_no_ext)
                if match:
                    # Use first capture group if exists, else full match
                    variables[var_name] = match.group(1) if match.groups() else match.group(0)
                else:
                    variables[var_name] = ''
            except re.error as e:
                # Invalid regex - log and treat as empty
                variables[var_name] = ''

        # Replace all variables in template
        for var_name, value in variables.items():
            result = result.replace('{{' + var_name + '}}', value)

        # Clean up result
        result = result.strip()

        # If result is empty or only whitespace, return None
        if not result:
            return None

        return result