Fix parsing

Author: akullpp

.github/workflows/update-readme.yml

@@ -24,11 +24,11 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
           fetch-depth: 0
 
-       - name: Set up Java
-         uses: actions/setup-java@v4
-         with:
-           distribution: "temurin"
-           java-version: "25"
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: "temurin"
+          java-version: "25"
 
       - name: Step 1 - Validate Input
         run: |

README.md

@@ -411,11 +411,12 @@ _Libraries that provide caching facilities._
 _Libraries for everything related to the CLI._
 
 #### Argument Parsing
+
 _Libraries to assist with parsing command line arguments._
 
 
 
-<!-- SECTION:CLI -->
+<!-- SECTION:CLI > Argument Parsing -->
 <table style="width:100%;table-layout:fixed;border-collapse:collapse;">
   <tbody>
     <tr>
@@ -458,6 +459,18 @@ _Libraries to assist with parsing command line arguments._
       <td style="width:7.5%;text-align:center;">-</td>
       <td style="width:7.5%;text-align:center;">-</td>
     </tr>
+  </tbody>
+</table>
+
+#### Text-Based User Interfaces
+
+_Libraries that provide TUI frameworks, or building blocks related functions._
+
+
+
+<!-- SECTION:CLI > Text-Based User Interfaces -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://github.com/fusesource/jansi">Jansi</a>
@@ -4676,7 +4689,8 @@ _Frameworks that are suites of multiple libraries encompassing several categorie
 #### Apache Commons
 
 
-<!-- SECTION:Platform -->
+
+<!-- SECTION:Platform > Apache Commons -->
 <table style="width:100%;table-layout:fixed;border-collapse:collapse;">
   <tbody>
     <tr>
@@ -5111,6 +5125,16 @@ _Frameworks that are suites of multiple libraries encompassing several categorie
       <td style="width:7.5%;text-align:center;">-</td>
       <td style="width:7.5%;text-align:center;">-</td>
     </tr>
+  </tbody>
+</table>
+
+#### Other
+
+
+
+<!-- SECTION:Platform > Other -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://www.cuba-platform.com/">CUBA Platform</a>
@@ -5939,11 +5963,12 @@ _Tools that substitute expressions in a template._
 _Tools that test from model to the view._
 
 #### Asynchronous
+
 _Tools that simplify testing asynchronous services._
 
 
 
-<!-- SECTION:Testing -->
+<!-- SECTION:Testing > Asynchronous -->
 <table style="width:100%;table-layout:fixed;border-collapse:collapse;">
   <tbody>
     <tr>
@@ -6002,6 +6027,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/testingisdocumenting/webtau?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/testingisdocumenting/webtau?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### BDD
+
+_Testing for the software development process that emerged from TDD and was heavily influenced by DDD and OOAD._
+
+
+
+<!-- SECTION:Testing > BDD -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://github.com/cucumber/cucumber-jvm">Cucumber</a>
@@ -6058,6 +6095,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/serenity-bdd/serenity-core?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/serenity-bdd/serenity-core?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### Fixtures
+
+_Everything related to the creation and handling of random data._
+
+
+
+<!-- SECTION:Testing > Fixtures -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://github.com/AutoParams/AutoParams">AutoParams</a>
@@ -6138,6 +6187,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/xcancloud/JMock?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/xcancloud/JMock?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### Frameworks
+
+_Provide environments to run tests for a specific use case._
+
+
+
+<!-- SECTION:Testing > Frameworks -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="http://jmeter.apache.org">Apache JMeter</a>
@@ -6226,6 +6287,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/weld/weld-testing?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/weld/weld-testing?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### Matchers
+
+_Libraries that provide custom matchers._
+
+
+
+<!-- SECTION:Testing > Matchers -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://joel-costigliola.github.io/assertj/">AssertJ</a>
@@ -6274,6 +6347,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/xmlunit/xmlunit?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/xmlunit/xmlunit?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### Miscellaneous
+
+_Other stuff related to testing._
+
+
+
+<!-- SECTION:Testing > Miscellaneous -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="https://github.com/Hakky54/console-captor">ConsoleCaptor</a>
@@ -6362,6 +6447,18 @@ _Tools that simplify testing asynchronous services._
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/stars/testcontainers/testcontainers-java?style=flat-square&label=" alt="GitHub stars"></td>
       <td style="width:7.5%;text-align:center;"><img src="https://img.shields.io/github/last-commit/testcontainers/testcontainers-java?style=flat-square&label=" alt="Last commit"></td>
     </tr>
+  </tbody>
+</table>
+
+#### Mocking
+
+_Tools which mock collaborators to help testing single, isolated units._
+
+
+
+<!-- SECTION:Testing > Mocking -->
+<table style="width:100%;table-layout:fixed;border-collapse:collapse;">
+  <tbody>
     <tr>
       <td style="width:20%;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;">
         <a href="http://jmockit.github.io">JMockit</a>

scripts/step_2_parse_projects.java

@@ -40,10 +40,12 @@ List<ProjectEntry> parseProjectEntries(String content) {
   var projectEntries = new ArrayList<ProjectEntry>();
   var inProjectSection = false;
   var currentSection = "";
+  var sectionStack = new ArrayList<String>();
 
   for (int i = 0; i < lines.length; i++) {
     var line = lines[i];
     var isSubsection = line.startsWith(Constants.SUBSECTION);
+    var sectionLevel = getSectionLevel(line);
 
     // Check if we're entering the Projects section
     if (line.startsWith(Constants.PROJECTS_SECTION)) {
@@ -54,16 +56,32 @@ List<ProjectEntry> parseProjectEntries(String content) {
     if (inProjectSection &&
         line.startsWith(Constants.SECTION) &&
         !isSubsection &&
+        sectionLevel == 0 &&
         !line.equals(Constants.PROJECTS_SECTION)
     ) {
       inProjectSection = false;
     }
     if (!inProjectSection) {
       continue;
     }
-    // Track current subsection
-    if (isSubsection) {
-      currentSection = line.substring(Constants.SUBSECTION.length());
+    // Track section hierarchy - maintain a stack of section levels
+    if (sectionLevel >= 3) {
+      var sectionName = line.substring(sectionLevel + 1).trim();
+
+      // Adjust stack size to match current level
+      while (sectionStack.size() >= sectionLevel - 2) {
+        sectionStack.remove(sectionStack.size() - 1);
+      }
+
+      // Add current section to stack
+      sectionStack.add(sectionName);
+
+      // Build full section path for entries
+      if (sectionStack.size() == 1) {
+        currentSection = sectionName; // Main section (###)
+      } else {
+        currentSection = String.join(" > ", sectionStack); // Subsection path
+      }
       continue;
     }
     // Skip headers and empty lines
@@ -83,6 +101,24 @@ List<ProjectEntry> parseProjectEntries(String content) {
   return projectEntries;
 }
 
+/**
+ * Determines the section level based on the number of # symbols.
+ * Returns 0 if the line is not a section header.
+ */
+int getSectionLevel(String line) {
+  if (!line.startsWith("#")) {
+    return 0;
+  }
+
+  int level = 0;
+  for (int i = 0; i < line.length() && line.charAt(i) == '#'; i++) {
+    level++;
+  }
+
+  // Must have at least 3 # symbols and a space after them
+  return (level >= 3 && line.length() > level && line.charAt(level) == ' ') ? level : 0;
+}
+
 /**
  * Parses a single project entry from the list format.
  */
@@ -102,6 +138,7 @@ ProjectEntry parseProjectEntry(String[] lines, int startIndex, String section) {
       if (nextLine.isBlank() ||
           nextLine.startsWith(Constants.SECTION) ||
           nextLine.startsWith(Constants.SUBSECTION) ||
+          getSectionLevel(nextLine) > 0 ||
           nextLine.matches(Constants.ENTRY_PATTERN)
       ) {
         break;

scripts/step_5_assemble_readme.java

@@ -47,6 +47,7 @@ String assembleReadme(String originalContent, String tablesContent) {
   // Create a mapping of sections to their tables
   var sectionToTableMap = createSectionToTableMap(tables);
 
+
   for (int i = 0; i < lines.length; i++) {
     var line = lines[i];
 
@@ -79,6 +80,11 @@ String assembleReadme(String originalContent, String tablesContent) {
       result.append(line).append("\n\n");
       continue;
     }
+    // Handle sub-subsection headers (####)
+    if (line.startsWith("#### ")) {
+      result.append(line).append("\n\n");
+      continue;
+    }
     // Handle headers
     if (line.startsWith("_") && line.endsWith("_")) {
       result.append(line).append("\n\n");
@@ -95,9 +101,10 @@ String assembleReadme(String originalContent, String tablesContent) {
       if (currentSubsection != null && sectionToTableMap.containsKey(currentSubsection)) {
         result.append(sectionToTableMap.get(currentSubsection)).append("</table>\n\n");
       }
-      // Skip ALL remaining list items in this section until we hit the next subsection or end delimiter
+      // Skip remaining list items in this subsection until we hit the next subsection or end delimiter
       while (i + 1 < lines.length &&
              !lines[i + 1].startsWith(Constants.SUBSECTION) &&
+             !lines[i + 1].startsWith("#### ") &&
              !lines[i + 1].contains(Constants.END_PROJECTS_SECTION_COMMENT)) {
         i++;
         if (lines[i].matches(Constants.ENTRY_PATTERN)) {
@@ -161,13 +168,33 @@ Map<String, String> createSectionToTableMap(String[] tables) {
 
 /**
  * Finds the current subsection by looking backwards from the given line index.
+ * Handles both flat sections (###) and hierarchical sections (####).
  */
 String findCurrentSubsection(String[] lines, int currentIndex) {
+  String currentMainSection = null;
+  String currentSubsection = null;
+
   for (int i = currentIndex; i >= 0; i--) {
     var line = lines[i];
+
+    // Check for subsection (####) first
+    if (line.startsWith("#### ") && currentSubsection == null) {
+      currentSubsection = line.substring(5).trim();
+    }
+
+    // Check for main section (###)
     if (line.startsWith(Constants.SUBSECTION)) {
-      return line.substring(Constants.SUBSECTION.length());
+      currentMainSection = line.substring(Constants.SUBSECTION.length());
+      break; // Stop when we find the main section
     }
   }
-  return null;
+
+  // If we found both main section and subsection, return hierarchical name
+  if (currentMainSection != null && currentSubsection != null) {
+    return currentMainSection + " > " + currentSubsection;
+  }
+
+  // Otherwise return just the main section
+  return currentMainSection;
 }
+