Skip to content

Check the annotations of Facade by KSP - #121

Open
reactivestudio wants to merge 1 commit into
ksp-helper-modulefrom
facade-ksp-processor
Open

reactivestudio wants to merge 1 commit into
ksp-helper-modulefrom
facade-ksp-processor

Conversation

@reactivestudio

@reactivestudio reactivestudio commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Новый подмодуль semantic-pattern-ksp: процессор KSP останавливает сборку модуля, если нарушено правило аннотаций Facade. Ошибка указывает на строку с аннотацией. Первая из четырёх частей процессора, стоит поверх #128 — модуля общих помощников KSP.

  • Проверяет @Facade:
    • стоит на классе, не на интерфейсе и не на аннотации;
    • называет хотя бы одну подсистему;
    • каждая названная подсистема помечена @Facade.Subsystem.
  • Проверяет метки: у класса не больше одной метки подсистемы, у фасада меток нет.
  • Видит классы Kotlin и Java, вложенные классы и аннотации под typealias. Повтор @Repeatable-метки — одна подсистема.
  • Неразрешённый класс в @Facade процессор пропускает: ошибку покажет компилятор.
  • Устройство: FacadeSymbolProcessor обходит классы и передаёт их checker'ам. Один checker — одно правило, имя называет правило, которое он обеспечивает:
    • FacadeOnClassChecker — @Facade стоит на классе;
    • FacadeSubsystemsNotEmptyChecker — фасад называет хотя бы одну подсистему;
    • SubsystemAnnotationPresenceChecker — каждая подсистема помечена @Facade.Subsystem;
    • FacadeOutsideSubsystemsChecker — фасад не входит ни в одну подсистему;
    • SingleSubsystemMembershipChecker — класс входит не больше чем в одну подсистему.
  • Разбор @Facade — в FacadeAnnotation, принадлежность класса к подсистеме — в SubsystemMembership. Общие расширения KSP берутся из semantic-ksp-helper.
  • KSP находит процессор через META-INF/services. Зависимость от symbol-processing-api — compileOnly, как у Moshi.
  • Тесты компилируют исходники через kctfork и сверяют текст ошибки и номер строки.
  • README: раздел KSP с подключением и примером ошибки, в плане три шага процессора вместо одного.

Следующие части: члены фасада (#122), метки супертипов (#123), правила клиентов (#124).

Base automatically changed from facade-base-type to master November 16, 2026 11:50
@reactivestudio
reactivestudio force-pushed the facade-ksp-processor branch 2 times, most recently from d1acc3a to 6b409e1 Compare November 16, 2026 12:07
@reactivestudio
reactivestudio changed the base branch from master to ksp-helper-module November 16, 2026 18:19
@reactivestudio
reactivestudio force-pushed the facade-ksp-processor branch 3 times, most recently from 1d2dea4 to 000f2b2 Compare November 16, 2026 18:48
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.

1 participant