Переработка инструмента

LICENSE.md

@@ -1,4 +1,3 @@
-
 The MIT License (MIT)
 
 Copyright (c) 2023 alkoleft

README.md

@@ -1 +1,13 @@
 # bsldoc
+
+## Запуск
+
+### Параметры запуска
+
+`bsldoc --format=<Docusaurus, Markdown> --only-subsystems=<root subsystems list> --regions=<regions filter> source destination`
+
+* `--format` - Формат
+* `--only-subsystems` - Список подсистем, по которым строится документация
+* `--regions` - Фильтр регионов, для которых строится документация
+* `source` - Каталог исходников
+* `destination` - Каталог выгрузки документации

build.gradle.kts

@@ -16,6 +16,7 @@ repositories {
     mavenLocal()
     mavenCentral()
     maven(url = "https://jitpack.io")
+    maven(url = "https://s01.oss.sonatype.org/content/repositories/snapshots/")
 }
 
 java {
@@ -28,31 +29,28 @@ java.sourceSets["main"].java {
 }
 
 dependencies {
-    // spring
-    implementation("org.springframework.boot:spring-boot-starter")
-    implementation("org.springframework.boot:spring-boot-starter-websocket")
-    implementation("info.picocli:picocli-spring-boot-starter:4.7.1")
+    implementation("info.picocli", "picocli", "4.7.5")
 
-    implementation("com.github.1c-syntax", "bsl-language-server", "0.20.0")
-
-    implementation("com.github.1c-syntax", "mdclasses", "0.10.3")
-    implementation("io.github.1c-syntax", "bsl-common-library", "f6714e4e")
-    implementation("io.github.1c-syntax", "supportconf", "0.1.1") {
-        exclude("io.github.1c-syntax", "bsl-common-library")
-    }
-    implementation("com.github.1c-syntax", "bsl-parser", "167aaad827322e09ccde4658a71152dad234de4b") {
+    implementation("com.github.1c-syntax", "mdclasses", "develop-SNAPSHOT")
+    implementation("com.github.1c-syntax", "utils", "0.5.1")
+    implementation("io.github.1c-syntax", "bsl-common-library", "0.5.0")
+    implementation("io.github.1c-syntax", "supportconf", "0.12.1")
+    implementation("com.github.1c-syntax", "bsl-parser", "develop-SNAPSHOT") {
         exclude("com.tunnelvisionlabs", "antlr4-annotations")
+        exclude("commons-beanutils", "commons-beanutils")
         exclude("com.ibm.icu", "*")
         exclude("org.antlr", "ST4")
         exclude("org.abego.treelayout", "org.abego.treelayout.core")
         exclude("org.antlr", "antlr-runtime")
         exclude("org.glassfish", "javax.json")
     }
 
+    implementation("commons-io", "commons-io", "2.14.0")
+    implementation("ch.qos.logback:logback-core:1.2.11")
+    runtimeOnly("ch.qos.logback:logback-classic:1.2.11")
+
     // template engine
     implementation("com.github.jknack:handlebars:4.3.1")
-    implementation("org.apache.velocity:velocity-engine-core:2.3")
-    implementation("org.apache.velocity:velocity-tools:2.0")
 
     testImplementation("org.junit.jupiter:junit-jupiter:$JUINT_VERSION")
     testImplementation("org.junit.jupiter:junit-jupiter-api:$JUINT_VERSION")
@@ -74,41 +72,14 @@ tasks.withType<JavaCompile> {
 }
 
 tasks.jar {
-//    manifest {
-//        attributes["Main-Class"] = "ru.alkoleft.bsl.doc.Main"
-//    }
     enabled = true
     archiveClassifier.set("")
 }
 
 tasks.bootJar {
-//    manifest {
-//        attributes["Main-Class"] = "ru.alkoleft.bsl.doc.Main"
-//    }
     archiveClassifier.set("exec")
 }
 
-tasks {
-    val fatJar = register<Jar>("fatJar") {
-        dependsOn.addAll(listOf("compileJava", "processResources")) // We need this for Gradle optimization to work
-        archiveClassifier.set("standalone") // Naming the jar
-        duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-        manifest { attributes(mapOf("Main-Class" to application.mainClass)) } // Provided we set it up in the application plugin configuration
-        val sourcesMain = sourceSets.main.get()
-        val contents = configurations.runtimeClasspath.get()
-            .map { if (it.isDirectory) it else zipTree(it) } +
-                sourcesMain.output
-        from(contents)
-    }
-    build {
-        dependsOn(fatJar) // Trigger fat jar creation during build
-    }
-
-    group = "build"
-}
-
-
-
 publishing {
     repositories {
         maven {

src/main/java/ru/alkoleft/bsl/doc/AutodocManager.java

@@ -0,0 +1,78 @@
+package ru.alkoleft.bsl.doc;
+
+import lombok.Builder;
+import lombok.SneakyThrows;
+import org.apache.commons.io.file.PathUtils;
+import ru.alkoleft.bsl.doc.bsl.BslContext;
+import ru.alkoleft.bsl.doc.bsl.Filter;
+import ru.alkoleft.bsl.doc.content.processor.TitleProcessor;
+import ru.alkoleft.bsl.doc.manual.ManualContent;
+import ru.alkoleft.bsl.doc.model.ContentModel;
+import ru.alkoleft.bsl.doc.options.ManualMergeStrategy;
+import ru.alkoleft.bsl.doc.options.OutputOptions;
+import ru.alkoleft.bsl.doc.render.BaseRender;
+import ru.alkoleft.bsl.doc.render.StructureRender;
+import ru.alkoleft.bsl.doc.render.handlebars.RenderContext;
+import ru.alkoleft.bsl.doc.render.output.OutputStrategy;
+import ru.alkoleft.bsl.doc.structure.StructureBuilder;
+
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.Objects;
+
+public class AutodocManager {
+
+  private final OutputOptions outputOptions;
+  private final Path destination;
+  private final ManualMergeStrategy manualMergeStrategy;
+  private final ManualContent manualContent;
+  private final BslContext bslContext;
+
+  @Builder
+  public AutodocManager(Filter filter, OutputOptions outputOptions, Path sources, Path destination, Path manualDocumentation, ManualMergeStrategy manualMergeStrategy) {
+    this.destination = destination;
+    this.outputOptions = outputOptions;
+    this.manualMergeStrategy = manualMergeStrategy;
+    manualContent = new ManualContent(manualDocumentation, destination);
+    bslContext = new BslContext(sources, filter);
+
+    TitleProcessor.Factory.create(outputOptions.getOutputFormat());
+  }
+
+  public void loadData() {
+    manualContent.buildModel(outputOptions.getOutputFormat());
+  }
+
+  public void generateDocumentation() {
+    manualContent.copy();
+
+    var structure = StructureBuilder.builder(outputOptions).build(bslContext);
+    StructureBuilder.print(structure);
+
+    var processor = OutputStrategy.create(manualMergeStrategy);
+    var contentModel = Objects.requireNonNullElseGet(manualContent.getContentModel(), ContentModel::new);
+    processor.init(outputOptions.getOutputFormat(), manualContent, contentModel);
+    var render = new StructureRender(outputOptions, processor, contentModel);
+
+    BaseRender.setContext(RenderContext.Factory.create(outputOptions));
+    render.render(structure, destination);
+  }
+
+  @SneakyThrows
+  public void clearOutput() {
+    if (Files.exists(destination)) {
+      Files.walk(destination)
+          .filter(it -> it != destination)
+          .forEach(this::deletePath);
+    }
+  }
+
+  private void deletePath(Path path) {
+    try {
+      PathUtils.delete(path);
+    } catch (IOException e) {
+      e.printStackTrace();
+    }
+  }
+}