Skip to content

Commit 96b534f

Browse files
committed
api: Make displayName nullable
Signed-off-by: Zixuan James Li <[email protected]>
1 parent ea80de0 commit 96b534f

13 files changed

+19
-39
lines changed

lib/api/model/model.dart

+1-5
Original file line numberDiff line numberDiff line change
@@ -563,11 +563,7 @@ extension type const TopicName(String _value) {
563563
/// The string this topic is displayed as to the user in our UI.
564564
///
565565
/// At the moment this always equals [apiName].
566-
/// In the future this will become null for the "general chat" topic (#1250),
567-
/// so that UI code can identify when it needs to represent the topic
568-
/// specially in the way prescribed for "general chat".
569-
// TODO(#1250) carry out that plan
570-
String get displayName => _value;
566+
String? get displayName => _value.isEmpty ? null : _value;
571567

572568
/// The key to use for "same topic as" comparisons.
573569
String canonicalize() => apiName.toLowerCase();

lib/model/autocomplete.dart

-2
Original file line numberDiff line numberDiff line change
@@ -942,13 +942,11 @@ class TopicAutocompleteQuery extends AutocompleteQuery {
942942
bool testTopic(TopicName topic, PerAccountStore store) {
943943
// TODO(#881): Sort by match relevance, like web does.
944944

945-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
946945
if (topic.displayName == null) {
947946
return store.realmEmptyTopicDisplayName.toLowerCase()
948947
.contains(raw.toLowerCase());
949948
}
950949
return topic.displayName != raw
951-
// ignore: unnecessary_non_null_assertion // null topic names soon to be enabled
952950
&& topic.displayName!.toLowerCase().contains(raw.toLowerCase());
953951
}
954952

lib/widgets/action_sheet.dart

+1-3
Original file line numberDiff line numberDiff line change
@@ -304,9 +304,7 @@ void showTopicActionSheet(BuildContext context, {
304304

305305
// TODO: check for other cases that may disallow this action (e.g.: time
306306
// limit for editing topics).
307-
if (someMessageIdInTopic != null
308-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
309-
&& topic.displayName != null) {
307+
if (someMessageIdInTopic != null && topic.displayName != null) {
310308
optionButtons.add(ResolveUnresolveButton(pageContext: pageContext,
311309
topic: topic,
312310
someMessageIdInTopic: someMessageIdInTopic));

lib/widgets/autocomplete.dart

-2
Original file line numberDiff line numberDiff line change
@@ -416,13 +416,11 @@ class TopicAutocomplete extends AutocompleteField<TopicAutocompleteQuery, TopicA
416416
@override
417417
Widget buildItem(BuildContext context, int index, TopicAutocompleteResult option) {
418418
final Widget child;
419-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
420419
if (option.topic.displayName == null) {
421420
final store = PerAccountStoreWidget.of(context);
422421
child = Text(store.realmEmptyTopicDisplayName,
423422
style: const TextStyle(fontStyle: FontStyle.italic));
424423
} else {
425-
// ignore: unnecessary_non_null_assertion // null topic names soon to be enabled
426424
child = Text(option.topic.displayName!);
427425
}
428426

lib/widgets/compose_box.dart

+5-8
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,6 @@ class ComposeTopicController extends ComposeController<TopicValidationError> {
201201
}
202202

203203
void setTopic(TopicName newTopic) {
204-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
205204
value = TextEditingValue(text: newTopic.displayName ?? '');
206205
}
207206
}
@@ -636,7 +635,7 @@ class _StreamContentInputState extends State<_StreamContentInput> {
636635
}
637636

638637
/// The topic name to show in the hint text, or null to show no topic.
639-
String? _hintTopicStr() {
638+
TopicName? _hintTopic() {
640639
if (widget.controller.topic.isTopicVacuous) {
641640
if (widget.controller.topic.mandatory) {
642641
// The chosen topic can't be sent to, so don't show it.
@@ -651,7 +650,7 @@ class _StreamContentInputState extends State<_StreamContentInput> {
651650
}
652651
}
653652

654-
return widget.controller.topic.textNormalized;
653+
return TopicName(widget.controller.topic.textNormalized);
655654
}
656655

657656
@override
@@ -661,15 +660,14 @@ class _StreamContentInputState extends State<_StreamContentInput> {
661660

662661
final streamName = store.streams[widget.narrow.streamId]?.name
663662
?? zulipLocalizations.unknownChannelName;
664-
final hintTopicStr = _hintTopicStr();
665-
final hintDestination = hintTopicStr == null
663+
final hintTopic = _hintTopic();
664+
final hintDestination = hintTopic == null
666665
// No i18n of this use of "#" and ">" string; those are part of how
667666
// Zulip expresses channels and topics, not any normal English punctuation,
668667
// so don't make sense to translate. See:
669668
// https://github.com/zulip/zulip-flutter/pull/1148#discussion_r1941990585
670669
? '#$streamName'
671-
: '#$streamName > '
672-
'${hintTopicStr.isEmpty ? store.realmEmptyTopicDisplayName : hintTopicStr}';
670+
: '#$streamName > ${hintTopic.displayName ?? store.realmEmptyTopicDisplayName}';
673671

674672
return _TypingNotifier(
675673
destination: TopicNarrow(widget.narrow.streamId,
@@ -840,7 +838,6 @@ class _FixedDestinationContentInput extends StatelessWidget {
840838
// Zulip expresses channels and topics, not any normal English punctuation,
841839
// so don't make sense to translate. See:
842840
// https://github.com/zulip/zulip-flutter/pull/1148#discussion_r1941990585
843-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
844841
'#$streamName > ${topic.displayName ?? store.realmEmptyTopicDisplayName}');
845842

846843
case DmNarrow(otherRecipientIds: []): // The self-1:1 thread.

lib/widgets/inbox.dart

-2
Original file line numberDiff line numberDiff line change
@@ -546,14 +546,12 @@ class _TopicItem extends StatelessWidget {
546546
style: TextStyle(
547547
fontSize: 17,
548548
height: (20 / 17),
549-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
550549
fontStyle: topic.displayName == null ? FontStyle.italic : null,
551550
// TODO(design) check if this is the right variable
552551
color: designVariables.labelMenuButton,
553552
),
554553
maxLines: 2,
555554
overflow: TextOverflow.ellipsis,
556-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
557555
topic.displayName ?? store.realmEmptyTopicDisplayName))),
558556
const SizedBox(width: 12),
559557
if (hasMention) const _IconMarker(icon: ZulipIcons.at_sign),

lib/widgets/message_list.dart

-4
Original file line numberDiff line numberDiff line change
@@ -341,10 +341,8 @@ class MessageListAppBarTitle extends StatelessWidget {
341341
return Row(
342342
mainAxisSize: MainAxisSize.min,
343343
children: [
344-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
345344
Flexible(child: Text(topic.displayName ?? store.realmEmptyTopicDisplayName, style: TextStyle(
346345
fontSize: 13,
347-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
348346
fontStyle: topic.displayName == null ? FontStyle.italic : null,
349347
).merge(weightVariableTextStyle(context)))),
350348
if (icon != null)
@@ -1121,13 +1119,11 @@ class StreamMessageRecipientHeader extends StatelessWidget {
11211119
child: Row(
11221120
children: [
11231121
Flexible(
1124-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
11251122
child: Text(topic.displayName ?? store.realmEmptyTopicDisplayName,
11261123
// TODO: Give a way to see the whole topic (maybe a
11271124
// long-press interaction?)
11281125
overflow: TextOverflow.ellipsis,
11291126
style: recipientHeaderTextStyle(context,
1130-
// ignore: unnecessary_null_comparison // null topic names soon to be enabled
11311127
fontStyle: topic.displayName == null ? FontStyle.italic : null,
11321128
))),
11331129
const SizedBox(width: 4),

test/api/model/model_checks.dart

+1-1
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ extension ZulipStreamChecks on Subject<ZulipStream> {
2626

2727
extension TopicNameChecks on Subject<TopicName> {
2828
Subject<String> get apiName => has((x) => x.apiName, 'apiName');
29-
Subject<String> get displayName => has((x) => x.displayName, 'displayName');
29+
Subject<String?> get displayName => has((x) => x.displayName, 'displayName');
3030
}
3131

3232
extension StreamConversationChecks on Subject<StreamConversation> {

test/widgets/action_sheet_test.dart

+2-3
Original file line numberDiff line numberDiff line change
@@ -372,7 +372,6 @@ void main() {
372372
final topicRow = find.descendant(
373373
of: find.byType(ZulipAppBar),
374374
matching: find.text(
375-
// ignore: dead_null_aware_expression // null topic names soon to be enabled
376375
effectiveTopic.displayName ?? eg.defaultRealmEmptyTopicDisplayName));
377376
await tester.longPress(topicRow);
378377
// sheet appears onscreen; default duration of bottom-sheet enter animation
@@ -393,7 +392,7 @@ void main() {
393392

394393
await tester.longPress(find.descendant(
395394
of: find.byType(RecipientHeader),
396-
matching: find.text(effectiveMessage.topic.displayName)));
395+
matching: find.text(effectiveMessage.topic.displayName!)));
397396
// sheet appears onscreen; default duration of bottom-sheet enter animation
398397
await tester.pump(const Duration(milliseconds: 250));
399398
}
@@ -457,7 +456,7 @@ void main() {
457456
messages: [message]);
458457
check(findButtonForLabel('Mark as resolved')).findsNothing();
459458
check(findButtonForLabel('Mark as unresolved')).findsNothing();
460-
}, skip: true); // null topic names soon to be enabled
459+
});
461460

462461
testWidgets('show from recipient header', (tester) async {
463462
await prepare();

test/widgets/autocomplete_test.dart

+4-4
Original file line numberDiff line numberDiff line change
@@ -415,7 +415,7 @@ void main() {
415415
await tester.tap(find.text('Topic three'));
416416
await tester.pumpAndSettle();
417417
check(tester.widget<TextField>(topicInputFinder).controller!.text)
418-
.equals(topic3.name.displayName);
418+
.equals(topic3.name.displayName!);
419419
check(find.text('Topic one' )).findsNothing();
420420
check(find.text('Topic two' )).findsNothing();
421421
check(find.text('Topic three')).findsOne(); // shown in `_TopicInput` once
@@ -473,7 +473,7 @@ void main() {
473473
await tester.pumpAndSettle();
474474

475475
check(find.text('some display name')).findsOne();
476-
}, skip: true); // null topic names soon to be enabled
476+
});
477477

478478
testWidgets('match realmEmptyTopicDisplayName in autocomplete', (tester) async {
479479
final topic = eg.getStreamTopicsEntry(name: '');
@@ -486,7 +486,7 @@ void main() {
486486
await tester.pumpAndSettle();
487487

488488
check(find.text('general chat')).findsOne();
489-
}, skip: true); // null topic names soon to be enabled
489+
});
490490

491491
testWidgets('autocomplete to realmEmptyTopicDisplayName sets topic to empty string', (tester) async {
492492
final topic = eg.getStreamTopicsEntry(name: '');
@@ -502,6 +502,6 @@ void main() {
502502
await tester.tap(find.text('general chat'));
503503
await tester.pump(Duration.zero);
504504
check(controller.value).text.equals('');
505-
}, skip: true); // null topic names soon to be enabled
505+
});
506506
});
507507
}

test/widgets/compose_box_test.dart

+1-1
Original file line numberDiff line numberDiff line change
@@ -563,7 +563,7 @@ void main() {
563563
narrow: TopicNarrow(channel.streamId, TopicName('')));
564564
checkComposeBoxHintTexts(tester, contentHintText:
565565
'Message #${channel.name} > ${eg.defaultRealmEmptyTopicDisplayName}');
566-
}, skip: true); // null topic names soon to be enabled
566+
});
567567
});
568568

569569
testWidgets('to DmNarrow with self', (tester) async {

test/widgets/inbox_test.dart

+1-1
Original file line numberDiff line numberDiff line change
@@ -314,7 +314,7 @@ void main() {
314314
subscriptions: [(eg.subscription(channel))],
315315
unreadMessages: [eg.streamMessage(stream: channel, topic: '')]);
316316
check(find.text(eg.defaultRealmEmptyTopicDisplayName)).findsOne();
317-
}, skip: true); // null topic names soon to be enabled
317+
});
318318

319319
group('topic visibility', () {
320320
final channel = eg.stream();

test/widgets/message_list_test.dart

+3-3
Original file line numberDiff line numberDiff line change
@@ -204,7 +204,7 @@ void main() {
204204
messageCount: 1);
205205
checkAppBarChannelTopic(
206206
channel.name, eg.defaultRealmEmptyTopicDisplayName);
207-
}, skip: true); // null topic names soon to be enabled
207+
});
208208

209209
testWidgets('has channel-feed action for topic narrows', (tester) async {
210210
final pushedRoutes = <Route<void>>[];
@@ -955,7 +955,7 @@ void main() {
955955
await tester.pump();
956956
check(findInMessageList('stream name')).single;
957957
check(findInMessageList(eg.defaultRealmEmptyTopicDisplayName)).single;
958-
}, skip: true); // null topic names soon to be enabled
958+
});
959959

960960
testWidgets('show general chat for empty topics without channel name', (tester) async {
961961
await setupMessageListPage(tester,
@@ -964,7 +964,7 @@ void main() {
964964
await tester.pump();
965965
check(findInMessageList('stream name')).isEmpty();
966966
check(findInMessageList(eg.defaultRealmEmptyTopicDisplayName)).single;
967-
}, skip: true); // null topic names soon to be enabled
967+
});
968968

969969
testWidgets('show topic visibility icon when followed', (tester) async {
970970
await setupMessageListPage(tester,

0 commit comments

Comments
 (0)