Д/з Markdown #266

Azkraft · 2025-11-05T14:14:29Z

GlazProject · 2025-11-06T16:38:31Z

Markdown/Md.cs

+        return BuildConvertedString(text, onlyValidatedMdSymbols);
+    }
+
+    private IEnumerable<ReadOnlyMemory<char>> SplitIntoSubstrings(ReadOnlyMemory<char> text, Func<char, bool> predicate)


Почему решил использовать Memory?

Чтобы не плодить большое количество подстрок, так как это дорого, и в этом я не увидел необходимости

GlazProject · 2025-11-06T16:39:13Z

Markdown/Md.cs

+        return BuildConvertedString(text, onlyValidatedMdSymbols);
+    }
+
+    private IEnumerable<ReadOnlyMemory<char>> SplitIntoSubstrings(ReadOnlyMemory<char> text, Func<char, bool> predicate)


Для предикатов кстати можно использовать соответствующий тип Predicate<char>

GlazProject · 2025-11-06T16:46:21Z

Markdown/Md.cs

+    {
+        var sb = new StringBuilder();
+
+		var mdSymbols = SplitIntoSubstrings(text.AsMemory(), t => t == '\n')


А как нам быть с CRLF?

Всё будет штатно работать, так как у меня метод не убирает символы, по которым разбивка происходит. Они остаются в подстроках. Останется строка с crlf. Когда собираю html эти же переносы и использую

GlazProject · 2025-11-06T16:48:45Z

Markdown/MdKeySymbol.cs

+
+public class MdKeySymbol
+{
+    private static readonly string keySymbols = @"_#\";


Не очень хорошо получается, что теги у нас лежат в одном месте, а допустимые символы в другом. Велик риск при расширении добавить только в одном месте и словить ошибки

А ещё возникнут сложности, если я захочу добавить обработку ```. Мне придётся добавить в качестве символа `, а тег существует только с тремя.

GlazProject · 2025-11-06T16:52:20Z

Markdown/MdKeySymbol.cs

+public class MdKeySymbol
+{
+    private static readonly string keySymbols = @"_#\";
+	private static readonly Dictionary<MdKeySymbol, string> mdSymbolToHtmlTag = new()


А вот располагать тут же мапинг в HTML очень плохо. Это делает код жестким. Представь, что потребуется написать ещё транслятор из MD в какой-нибудь транспортный XML. В этом случае понадобится здесь же дописывать мапинги из md в XML. А потом попросят из HTML в md и появится ещё один мапинг. Обычно делают некоторым промежуточный язык, в который умеют транслировать и из которого умеют читать

GlazProject · 2025-11-06T17:06:13Z

Markdown/MdKeySymbol.cs

+			isFirstNonSpace = isFirstNonSpace && IsWhiteSpace(word);
+		}
+
+		symbols.Sort((x, y) => x.Position - y.Position);


А до этого символы не последовательно складывались в список?

В программе пары символов ищутся на стеке, поэтому нет никаких гарантий, что они попадут в список в порядке их возникновения в исходной строке

GlazProject · 2025-11-06T17:11:08Z

Markdown/MdKeySymbol.cs

+		MdSymbol.Quantity,
+		MdSymbol.Position) { }
+
+	public int CalculateSymbolLength()


Выглядит так, что при добавлении каждого нового тега придётся переписывать этот метод. Не получится вынести расширяющие изменения в одно место?

GlazProject · 2025-11-06T17:15:22Z

Markdown/MdKeySymbol.cs

+
+    public override int GetHashCode()
+    {
+        return HashCode.Combine(Type, RelativePosition, Quantity);


А вот здесь опасно их так использовать. Это случится при добавлении например в словарь.

var symbol = MdKeySymbol.Create('#', 0, Open); dict[symbol] = "NumberSign"; symbol.RelativePosition = Close; dict[symbol] // throw KeyNotFoundException

GlazProject · 2025-11-06T17:23:10Z

Markdown/MdKeySymbol.cs

+			yield return mdSymbol;
+	}
+
+	private static MdSymbolRelativePosition DetermineRelativePosition(int positionInWord, int wordLength)


А выделение внутри слова нормально сработает?

GlazProject · 2025-11-06T17:31:21Z

Markdown/MdSymbolQuantity.cs

@@ -0,0 +1,7 @@
+namespace Markdown;
+
+public enum MdSymbolQuantity


Кажется это отсылка к частным случаям, у нас всё-таки есть отдельно теги _ и __. Это не повторение одного и того же. Но пока пусть будет

GlazProject

Правильно понял, что в этой домашке не делаешь доп задание?

GlazProject · 2025-11-12T17:13:05Z

Markdown/Md.cs

+{
+    public string Render(string text)
+    {
+        var sb = new StringBuilder();


Он нам нужен?

GlazProject · 2025-11-12T17:15:12Z

Markdown/Md.cs

+            .SelectMany(MdKeySymbolOperations.GetMdKeySymbolsInLine)
+            .ToArray();
+
+        MdKeySymbol.Validate(mdSymbols);


А не хочешь вынести это в MdKeySymbolValidator?

GlazProject · 2025-11-12T17:16:05Z

Markdown/Md.cs

+        return BuildConvertedString(text, onlyValidatedMdSymbols);
+    }
+
+    private IEnumerable<ReadOnlyMemory<char>> SplitIntoSubstrings(ReadOnlyMemory<char> text, Predicate<char> predicate)


Я бы заменил фразу predicate на separator

GlazProject · 2025-11-12T17:30:40Z

Markdown/Md.cs

+        return BuildConvertedString(text, onlyValidatedMdSymbols);
+    }
+
+    private IEnumerable<ReadOnlyMemory<char>> SplitIntoSubstrings(ReadOnlyMemory<char> text, Predicate<char> predicate)


Можно сделать статичными (https://rules.sonarsource.com/csharp/RSPEC-2325). А по хорошему этот код не относится непосредственно к MD, поэтому есть смысл вынести в методы расширения (extensions)

GlazProject · 2025-11-12T17:35:10Z

Markdown/Md.cs

+			}
+
+            var mdSymbol = mdSymbols[mdSymbolIndex++];
+            sb.Append(mdSymbol.Render(MdToHtmlMapping.Mapping));


Смотри, это всё ещё жесткая связка между MD и HTML. Вот если бы были теги по типу жирный, курсив, заголовок - тогда их можно транслировать в любой другой язык. И точно так же сравнительно легко можно было сделать парсер html

А ещё это усложнит тестирование при расширении по тем же причинам

GlazProject · 2025-11-13T05:13:39Z