Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Калентьев Илья tg:@m1nus0ne #241

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

m1nus0ne
Copy link

No description provided.


public interface IMaker<T>
{
public T MakeFromTokens(List<StringToken> tokens);

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Мелочь. Так же как и вместо собственных классов лучше использовать интерфейсы, так и тут лучше использовать IEnumerable, чтобы не завязываться на конкретную реализацию коллекции, если нам нужно просто по ней проитерироваться

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Исправил


public class Md<TResult>
{
public string Render(string input, IParser parser, IMaker<TResult> maker, IRenderer<TResult> renderer)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Довольно много параметров в этом методе передается. Подскажи, почему решил конструктор не использовать?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Вынес в конструктор

{
public string Render(string input, IParser parser, IMaker<TResult> maker, IRenderer<TResult> renderer)
{
var tokens = new MarkdownParser().Parse(input);

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тут тоже не в конструкторе и не в методе параметром передаем. Подскажи, почему именно так решил сделать?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Вынес в конструктор

public abstract class BaseHtmlToken
{
public List<BaseHtmlToken>? Children { get; private protected set; }
public string Value { get; private protected set; }

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Подскажи, ты осознанно использовал private protected set? Я не против, но если осознанно, то можешь объяснить мотивацию?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Всегда использую private, по необходимости расширяю область видимости. Без protected сеттер из дочерних классов становится недоступным

public List<BaseHtmlToken>? Children { get; private protected set; }
public string Value { get; private protected set; }

public BaseHtmlToken(List<BaseHtmlToken>? children)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В абстрактном классе у тебя 2 поля, но в конструкторе принимается только одно. Так и задумано?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Например в токене, который будет просто хранить текст Children = {StrongCloseToken(), TextToken(), StrongOpenToken()}


public abstract class BaseHtmlToken
{
public List<BaseHtmlToken>? Children { get; private protected set; }

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

А точно ли нам нужен здесь nulluble тип? Может нас устроит и просто пустая коллекция, когда дочерних тегов нет?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Исправил


namespace Markdown;

public class Md<TResult>

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Честно говоря пока не очень понимаю мотивации использовать тут дженерик. Можешь комментарием к треду или прямо в коде объяснить вкратце мотивацию?

@@ -0,0 +1,12 @@
namespace Markdown.Tokens;

public abstract class BaseHtmlToken

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Точно ли этот класс должен содержать "Html" в названии? Мы же парсим Markdown текст, который уже в последствии преобразуем в HTML, но мы можем захотеть и не только в него преобразовать, а и в другой язык разметки. Получится ли быстро это реализовать в текущей архитектуре?
Если я не понял идеи алгоритма, то можешь вкратце ее объяснить, пожалуйста?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Изначально я хотел использовать модель-посредник для трансляции любого формата разметки текста в другой, но решил оставить IEnumerable ее упрощенной версией. Строка -> IEnumerable -> RootToken (репрезентация DOM)

}

public abstract Type OpenTypeToken { get; }
public abstract Type CloseTypeToken { get; }

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Для таких полей обычно используют Enum, подскажи, почему именно Type выбрал?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

После паринга StringToken будет преобразовываться в Open/CloseToken, далее в цельный Token

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants