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

Can you pls make troubleshooting easier?

Aperta
#664 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Ferma
Stack tecnologico
python

Direzione di ricerca

Inizia leggendo langkit/utils/colors.py, le istruzioni di build del README, gli entry point di manage.py e lkt/check_bootstrap.py. Separa la checklist in miglioramenti con ambito indipendente, quindi definisci i criteri di completamento per l’output della build, i controlli della modalità verbose, la gestione dei colori, la segnalazione degli errori, la denominazione e i passaggi di build documentati.

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

Descrizione

I find the build process complicated and hard to debug, a couple of suggestions:

  • can you consider improving the names, liblktlang, liblktlang_support, langkit_support, ... way too many "l"s "k"s and "lang"s.
  • the python build process obscures things - it says for example it generates files and does not say where
  • there is no obvious way to simply enable gprbuild and gprinstallverbose modes - changing python is needed
  • https://no-color.org/ has nice suggestion - you could check for the NO_COLOR environment variable (or maybe also CI) in the langkit.utils.colors
  • a mishmash of Python mixed into Ada code is not nice (and probably a horror for packaging). Until we have a first class support for Python in gprbuild maybe it could be separated somehow...
  • this looks scary - can this be surpressed? `
Subcommand failed: error while running /usr/local/bin/python3.11 /usr/home/saper/src/ada/langkit/lkt/check_bootstrap.py -q:
    Command '['/usr/local/bin/python3.11', '/usr/home/saper/src/ada/langkit/lkt/check_bootstrap.py', '-q']' returned non-zero exit status 1.
  • The steps of the process are confusing the README says

Build the Liblktlang support library:
$ python manage.py make --no-mypy --library-types=static,static-pic,relocatable

But this seems to build more than just that library.

Do I get it right that logical steps of the build process are:

  1. python3 manage.py build-langkit-support (all library types if needed)
  2. python3 manage.py install-langkit-support (all library types if needed)
  3. python3 manage.py bootstrap - this builds relocatable library only in lkt/bootstrap/lib/relocatable/dev/liblktlang.so
  4. some code generation
  5. ...
Lingua principale
Ada
Stelle
94
Fork
34
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

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 AdaCore/langkit

Tutte le issue di AdaCore/langkit

Issue simili

Altre issue su Build System

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.