Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

lobster_rst_report escapes list-table rows inside requirement text and produces invalid RST

Aperta
  • Qualcosa non va?
#333 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
68/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
rust
Ambito
documentation, tooling

Direzione di ricerca

Inizia in tools/lobster_rst_report e traccia il percorso di rendering o escaping per il testo del requisito incorporato in traceability_report/feature_requirements.rst. Riproduci il problema con un requisito contenente una .. list-table:: annidata, quindi verifica che la tabella generata mantenga i marcatori di riga non sottoposti a escaping e venga accettata da Sphinx/docutils.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

When a requirement description contains a valid nested .. list-table::, the generated multi-page Lobster RST report escapes the table row markers (* - becomes \* -), and Sphinx/docutils then rejects the generated page.

Observed behavior

Generated file:
traceability_report/feature_requirements.rst

Error:
Error parsing content block for the "list-table" directive: exactly one bullet list expected.

In the generated report, the table body is rendered with escaped row markers like:

.. list-table::
   :header-rows: 1

   \* - #
     - Mode 0
     - Mode 1

instead of valid rows:

.. list-table::
   :header-rows: 1

   * - #
     - Mode 0
     - Mode 1

Expected behavior

Nested RST table content inside requirement text should remain valid in the generated traceability report.

Why this looks like a tooling bug

  • The original requirement page renders the table correctly.
  • The failure appears only in the generated Lobster RST report.
  • The generated report escapes markup that must remain structural RST.

Impact

Valid migrated requirement content cannot be reused safely in Lobster-generated report pages if it contains structured RST tables.

Reproduction hint

A feature requirement with a description containing:

  • prose
  • a nested .. list-table::
  • normal feature_requirements generation
  • dependable element / Lobster traceability report generation

Suspected area

tools/lobster_rst_report rendering / escaping logic for requirement text embedded into report pages.

Lingua principale
Rust
Stelle
8
Fork
38
Merge medio
1g 2h
PR unite (30g)
33

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di eclipse-score/tooling

Tutte le issue di eclipse-score/tooling

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.