style: apply ruff formatting

Author: Smartappli

tracker/admin.py

@@ -130,14 +130,21 @@ class ObservationSessionAdmin(admin.ModelAdmin):
     inlines = [SessionVideoInline, VariableValueInline]
 
 
-
-
 @admin.register(ObservationSegment)
 class ObservationSegmentAdmin(admin.ModelAdmin):
-    list_display = ('session', 'title', 'start_seconds', 'end_seconds', 'status', 'assignee', 'reviewer')
+    list_display = (
+        'session',
+        'title',
+        'start_seconds',
+        'end_seconds',
+        'status',
+        'assignee',
+        'reviewer',
+    )
     list_filter = ('session__project', 'status')
     search_fields = ('session__title', 'title', 'notes', 'assignee__username', 'reviewer__username')
 
+
 @admin.register(ObservationEvent)
 class ObservationEventAdmin(admin.ModelAdmin):
     list_display = (

tracker/compatibility.py

@@ -74,8 +74,6 @@ def _resolve_annotation_items(payload: dict[str, Any]) -> list[dict[str, Any]]:
     return []
 
 
-
-
 def _resolve_segment_items(payload: dict[str, Any]) -> list[dict[str, Any]]:
     if payload.get('schema', '').startswith('pybehaviorlog-'):
         return [item for item in payload.get('segments', []) if isinstance(item, dict)]
@@ -103,13 +101,19 @@ def normalize_session_payload(payload: dict[str, Any]) -> dict[str, Any]:
         event_kind = str(item.get('event_kind') or item.get('type') or 'point').lower()
         events.append(
             {
-                'time': _normalize_time(item.get('time') or item.get('timestamp_seconds') or item.get('start')),
+                'time': _normalize_time(
+                    item.get('time') or item.get('timestamp_seconds') or item.get('start')
+                ),
                 'behavior': str(behavior),
                 'event_kind': event_kind,
                 'modifiers': _string_list(item.get('modifiers')),
                 'subjects': _string_list(item.get('subjects') or item.get('subject')),
-                'comment': str(item.get('comment') or item.get('comment_start') or item.get('image_path') or ''),
-                'frame_index': int(item.get('frame_index') or item.get('frame') or 0) if str(item.get('frame_index') or item.get('frame') or '').strip() else None,
+                'comment': str(
+                    item.get('comment') or item.get('comment_start') or item.get('image_path') or ''
+                ),
+                'frame_index': int(item.get('frame_index') or item.get('frame') or 0)
+                if str(item.get('frame_index') or item.get('frame') or '').strip()
+                else None,
             }
         )
     events.sort(key=lambda item: (item['time'], item['behavior'], item['event_kind']))
@@ -124,12 +128,14 @@ def normalize_session_payload(payload: dict[str, Any]) -> dict[str, Any]:
     annotations.sort(key=lambda item: (item['time'], item['text']))
     segments = []
     for item in _resolve_segment_items(payload):
-        segments.append({
-            'title': str(item.get('title') or ''),
-            'start': _normalize_time(item.get('start_seconds') or item.get('start')),
-            'end': _normalize_time(item.get('end_seconds') or item.get('end')),
-            'status': str(item.get('status') or ''),
-        })
+        segments.append(
+            {
+                'title': str(item.get('title') or ''),
+                'start': _normalize_time(item.get('start_seconds') or item.get('start')),
+                'end': _normalize_time(item.get('end_seconds') or item.get('end')),
+                'status': str(item.get('status') or ''),
+            }
+        )
     segments.sort(key=lambda item: (item['start'], item['end'], item['title']))
     variables = payload.get('variables') or payload.get('independent_variables') or {}
     if not isinstance(variables, dict):
@@ -139,7 +145,9 @@ def normalize_session_payload(payload: dict[str, Any]) -> dict[str, Any]:
         'events': events,
         'annotations': annotations,
         'variables': {str(key): str(value) for key, value in sorted(variables.items())},
-        'media_paths': sorted(_string_list(payload.get('media_paths') or payload.get('image_paths'))),
+        'media_paths': sorted(
+            _string_list(payload.get('media_paths') or payload.get('image_paths'))
+        ),
         'segments': segments,
     }
 
@@ -169,6 +177,7 @@ def compare_session_payloads(expected: dict[str, Any], actual: dict[str, Any]) -
 
 def normalize_project_payload(payload: dict[str, Any]) -> dict[str, Any]:
     """Normalize project-like payloads for BORIS/PyBehaviorLog round-trip comparisons."""
+
     def _item_names(value: Any, *, key: str = 'name', fallback: str = 'label') -> list[str]:
         results = []
         if isinstance(value, dict):
@@ -200,15 +209,21 @@ def _item_names(value: Any, *, key: str = 'name', fallback: str = 'label') -> li
         if isinstance(observations, list):
             for observation in observations:
                 if isinstance(observation, dict):
-                    session_titles.append(str(observation.get('title') or observation.get('description') or ''))
+                    session_titles.append(
+                        str(observation.get('title') or observation.get('description') or '')
+                    )
     return {
         'schema_family': str(payload.get('schema') or 'unknown'),
         'categories': _item_names(payload.get('categories')),
         'behaviors': _item_names(payload.get('behaviors')),
         'modifiers': _item_names(payload.get('modifiers')),
         'subject_groups': _item_names(payload.get('subject_groups')),
         'subjects': _item_names(payload.get('subjects')),
-        'variables': _item_names(payload.get('variables') or payload.get('independent_variables'), key='label', fallback='name'),
+        'variables': _item_names(
+            payload.get('variables') or payload.get('independent_variables'),
+            key='label',
+            fallback='name',
+        ),
         'templates': _item_names(payload.get('observation_templates')),
         'sessions': sorted(item for item in session_titles if item),
     }
@@ -219,7 +234,16 @@ def compare_project_payloads(expected: dict[str, Any], actual: dict[str, Any]) -
     actual_normalized = normalize_project_payload(actual)
     mismatches = [
         key
-        for key in ('categories', 'behaviors', 'modifiers', 'subject_groups', 'subjects', 'variables', 'templates', 'sessions')
+        for key in (
+            'categories',
+            'behaviors',
+            'modifiers',
+            'subject_groups',
+            'subjects',
+            'variables',
+            'templates',
+            'sessions',
+        )
         if expected_normalized[key] != actual_normalized[key]
     ]
     return {
@@ -230,7 +254,9 @@ def compare_project_payloads(expected: dict[str, Any], actual: dict[str, Any]) -
     }
 
 
-def build_roundtrip_report(expected: dict[str, Any], actual: dict[str, Any], family: str) -> dict[str, Any]:
+def build_roundtrip_report(
+    expected: dict[str, Any], actual: dict[str, Any], family: str
+) -> dict[str, Any]:
     """Build a machine-readable round-trip report for CI and fixture certification."""
     comparator = compare_project_payloads if family == 'project' else compare_session_payloads
     comparison = comparator(expected, actual)

tracker/forms.py

@@ -127,12 +127,9 @@ class Meta:
 
 
 class EthogramImportForm(forms.Form):
-
     file = forms.FileField(
         label=_('File'),
-        help_text=_(
-            'JSON export from PyBehaviorLog 0.9.1 or BORIS-compatible JSON.'
-        ),
+        help_text=_('JSON export from PyBehaviorLog 0.9.1 or BORIS-compatible JSON.'),
     )
     replace_existing = forms.BooleanField(
         required=False,
@@ -164,7 +161,12 @@ class ProjectBORISImportForm(forms.Form):
 
 
 class SessionImportForm(forms.Form):
-    file = forms.FileField(label=_('File'), help_text=_('PyBehaviorLog 0.9.1 JSON, BORIS observation JSON, spreadsheet-like session tables, or CowLog plain-text coding results.'))
+    file = forms.FileField(
+        label=_('File'),
+        help_text=_(
+            'PyBehaviorLog 0.9.1 JSON, BORIS observation JSON, spreadsheet-like session tables, or CowLog plain-text coding results.'
+        ),
+    )
     clear_existing = forms.BooleanField(
         required=False,
         label=_('Delete existing events and annotations before import'),
@@ -187,7 +189,12 @@ class Meta:
             'description': forms.TextInput(),
             'key_binding': forms.TextInput(attrs={'maxlength': 1}),
         }
-        labels = {'name': _('Name'), 'description': _('Description'), 'key_binding': _('Key binding'), 'sort_order': _('Sort order')}
+        labels = {
+            'name': _('Name'),
+            'description': _('Description'),
+            'key_binding': _('Key binding'),
+            'sort_order': _('Sort order'),
+        }
 
     def clean_key_binding(self):
         return self.cleaned_data['key_binding'].upper()
@@ -201,7 +208,12 @@ class Meta:
             'description': forms.TextInput(),
             'color': forms.TextInput(attrs={'type': 'color'}),
         }
-        labels = {'name': _('Name'), 'description': _('Description'), 'color': _('Color'), 'sort_order': _('Sort order')}
+        labels = {
+            'name': _('Name'),
+            'description': _('Description'),
+            'color': _('Color'),
+            'sort_order': _('Sort order'),
+        }
 
 
 class SubjectForm(forms.ModelForm):
@@ -214,7 +226,14 @@ class Meta:
             'color': forms.TextInput(attrs={'type': 'color'}),
             'groups': forms.CheckboxSelectMultiple(),
         }
-        labels = {'name': _('Name'), 'description': _('Description'), 'groups': _('Groups'), 'key_binding': _('Key binding'), 'color': _('Color'), 'sort_order': _('Sort order')}
+        labels = {
+            'name': _('Name'),
+            'description': _('Description'),
+            'groups': _('Groups'),
+            'key_binding': _('Key binding'),
+            'color': _('Color'),
+            'sort_order': _('Sort order'),
+        }
 
     def __init__(self, *args, project=None, **kwargs):
         super().__init__(*args, **kwargs)
@@ -236,7 +255,14 @@ class Meta:
             'set_values': forms.Textarea(attrs={'rows': 3}),
             'default_value': forms.TextInput(),
         }
-        labels = {'label': _('Label'), 'description': _('Description'), 'value_type': _('Value type'), 'set_values': _('Allowed values'), 'default_value': _('Default value'), 'sort_order': _('Sort order')}
+        labels = {
+            'label': _('Label'),
+            'description': _('Description'),
+            'value_type': _('Value type'),
+            'set_values': _('Allowed values'),
+            'default_value': _('Default value'),
+            'sort_order': _('Sort order'),
+        }
 
 
 class BehaviorForm(forms.ModelForm):
@@ -248,7 +274,15 @@ class Meta:
             'key_binding': forms.TextInput(attrs={'maxlength': 1}),
             'color': forms.TextInput(attrs={'type': 'color'}),
         }
-        labels = {'category': _('Category'), 'name': _('Name'), 'description': _('Description'), 'key_binding': _('Key binding'), 'color': _('Color'), 'mode': _('Mode'), 'sort_order': _('Sort order')}
+        labels = {
+            'category': _('Category'),
+            'name': _('Name'),
+            'description': _('Description'),
+            'key_binding': _('Key binding'),
+            'color': _('Color'),
+            'mode': _('Mode'),
+            'sort_order': _('Sort order'),
+        }
 
     def __init__(self, *args, project=None, **kwargs):
         super().__init__(*args, **kwargs)
@@ -279,7 +313,15 @@ class Meta:
             'subjects': forms.CheckboxSelectMultiple(),
             'variable_definitions': forms.CheckboxSelectMultiple(),
         }
-        labels = {'name': _('Name'), 'description': _('Description'), 'default_session_kind': _('Default session kind'), 'behaviors': _('Behaviors'), 'modifiers': _('Modifiers'), 'subjects': _('Subjects'), 'variable_definitions': _('Independent variables')}
+        labels = {
+            'name': _('Name'),
+            'description': _('Description'),
+            'default_session_kind': _('Default session kind'),
+            'behaviors': _('Behaviors'),
+            'modifiers': _('Modifiers'),
+            'subjects': _('Subjects'),
+            'variable_definitions': _('Independent variables'),
+        }
 
     def __init__(self, *args, project=None, **kwargs):
         super().__init__(*args, **kwargs)
@@ -308,11 +350,18 @@ def __init__(self, *args, **kwargs):
             self.fields['file'].required = False
 
 
-
 class ObservationSegmentForm(forms.ModelForm):
     class Meta:
         model = ObservationSegment
-        fields = ['title', 'start_seconds', 'end_seconds', 'status', 'assignee', 'reviewer', 'notes']
+        fields = [
+            'title',
+            'start_seconds',
+            'end_seconds',
+            'status',
+            'assignee',
+            'reviewer',
+            'notes',
+        ]
         widgets = {'notes': forms.Textarea(attrs={'rows': 3})}
         labels = {
             'title': _('Title'),
@@ -328,7 +377,9 @@ def __init__(self, *args, project=None, **kwargs):
         super().__init__(*args, **kwargs)
         queryset = User.objects.order_by('username')
         if project is not None:
-            member_ids = list(project.memberships.values_list('user_id', flat=True)) + [project.owner_id]
+            member_ids = list(project.memberships.values_list('user_id', flat=True)) + [
+                project.owner_id
+            ]
             queryset = queryset.filter(pk__in=member_ids).distinct()
         self.fields['assignee'].queryset = queryset
         self.fields['reviewer'].queryset = queryset
@@ -338,7 +389,9 @@ def clean(self):
         start = cleaned.get('start_seconds')
         end = cleaned.get('end_seconds')
         if start is not None and end is not None and end < start:
-            self.add_error('end_seconds', _('End time must be greater than or equal to start time.'))
+            self.add_error(
+                'end_seconds', _('End time must be greater than or equal to start time.')
+            )
         return cleaned
 
 
@@ -438,9 +491,9 @@ def __init__(self, *args, project=None, **kwargs):
                     definition.value_type == IndependentVariableDefinition.TYPE_SET
                     and definition.set_values
                 ):
-                    help_text = (
-                        help_text + ' ' if help_text else ''
-                    ) + _('Allowed values: %(values)s') % {'values': definition.set_values}
+                    help_text = (help_text + ' ' if help_text else '') + _(
+                        'Allowed values: %(values)s'
+                    ) % {'values': definition.set_values}
                 field.help_text = help_text
                 self.fields[field_name] = field
                 initial_value = definition.default_value

tracker/management/commands/export_project_bundle.py

@@ -7,7 +7,7 @@
 
 
 class Command(BaseCommand):
-    help = "Export a PyBehaviorLog reproducibility bundle for a project."
+    help = 'Export a PyBehaviorLog reproducibility bundle for a project.'
 
     def add_arguments(self, parser):
         parser.add_argument('project_id', type=int)

tracker/management/commands/release_report.py

@@ -6,7 +6,7 @@
 
 
 class Command(BaseCommand):
-    help = "Print machine-readable release metadata for PyBehaviorLog."
+    help = 'Print machine-readable release metadata for PyBehaviorLog.'
 
     def handle(self, *args, **options):
         self.stdout.write(json.dumps(build_release_metadata(), indent=2, ensure_ascii=False))

tracker/models.py

@@ -256,7 +256,9 @@ class IndependentVariableDefinition(models.Model):
     label = models.CharField(max_length=120)
     description = models.CharField(max_length=255, blank=True)
     value_type = models.CharField(max_length=20, choices=TYPE_CHOICES, default=TYPE_TEXT)
-    set_values = models.TextField(blank=True, help_text=_('Comma-separated values for list fields.'))
+    set_values = models.TextField(
+        blank=True, help_text=_('Comma-separated values for list fields.')
+    )
     default_value = models.CharField(max_length=255, blank=True)
     sort_order = models.PositiveIntegerField(default=0)
 
@@ -563,7 +565,6 @@ def duration_seconds(self) -> float:
         return round(float(self.end_seconds - self.start_seconds), 3)
 
 
-
 class ObservationEvent(models.Model):
     KIND_POINT = 'point'
     KIND_START = 'start'

tracker/tests/test_compatibility.py

@@ -77,7 +77,6 @@ def test_session_import_view_accepts_cowlog_text(self):
         self.assertEqual(event.behavior.name, 'Eat')
         self.assertEqual(event.modifiers_display, 'Near')
 
-
     def test_load_session_import_payload_supports_state_intervals_from_tabular_rows(self):
         upload = SimpleUploadedFile(
             'boris_rows.csv',
@@ -181,15 +180,19 @@ def test_export_endpoints_for_compatibility_formats(self):
             event_kind=ObservationEvent.KIND_POINT,
             timestamp_seconds=Decimal('1.000'),
         )
-        response = self.client.get(reverse('tracker:session_export_cowlog_txt', args=[self.session.pk]))
+        response = self.client.get(
+            reverse('tracker:session_export_cowlog_txt', args=[self.session.pk])
+        )
         self.assertEqual(response.status_code, 200)
         self.assertIn('CowLog-compatible', response.content.decode('utf-8'))
         response = self.client.get(
             reverse('tracker:session_export_behavioral_sequences', args=[self.session.pk])
         )
         self.assertEqual(response.status_code, 200)
         self.assertIn('# observation id:', response.content.decode('utf-8'))
-        response = self.client.get(reverse('tracker:session_export_textgrid', args=[self.session.pk]))
+        response = self.client.get(
+            reverse('tracker:session_export_textgrid', args=[self.session.pk])
+        )
         self.assertEqual(response.status_code, 200)
         self.assertIn('TextGrid', response.content.decode('utf-8'))
         response = self.client.get(