loji
loji è una CLI open source pensata per semplificare e automatizzare la generazione dei changelog nei progetti Git. Nata dall’esigenza di mantenere una documentazione delle modifiche chiara, leggibile e veloce da produrre, loji analizza i commit recenti e li trasforma in changelog ordinati e pronti all’uso. Che tu stia lavorando da solo o in team, loji ti aiuta a risparmiare tempo e a mantenere traccia dell’evoluzione del tuo progetto in modo efficace.
JavaScript Docker
Visit the websiteCos’è loji ?
Scrivere changelog può diventare noioso e ripetitivo, ma tenerli aggiornati è fondamentale per qualsiasi progetto. È proprio da questa necessità che nasce loji: una CLI semplice per generare changelog partendo dai tuoi commit Git.
Loji legge i commit, capisce che tipo di modifiche hai fatto e crea un changelog pulito, ordinato, pronto da usare. Tutto in un solo comando.
Installazione
Puoi installare la CLI dal sito ufficiale di npmjs:
shell
1npm i loji -gSe il comando non dovesse funzionare puoi usare sudo:
shell
1sudo npm i loji -gUna volta installato, puoi usare il tool in qualsiasi progetto Git con semplicità.
Come funziona
Vai nella tua repo e lancia:
~/Develop/tua-repo
1loji generateLoji analizzerà i tuoi ultimi commit e genererà automaticamente un changelog, cercando di classificare i cambiamenti in sezioni (Features, Fixes, ecc.). È ispirato ai Conventional Commits, ma è abbastanza smart da funzionare anche con messaggi meno strutturati.
Esempio di Output
CHANGELOG.md
1# Changelog
2
3All notable changes to this project will be documented in this file.
4
5The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
8### Changed
9
10- 1.1 -> 1.2
11 > Updated import statements in multiple files. (@namecoder1)
12
13 <details>
14 <summary>Details</summary>
15
16 - **Date:** April 17, 2025 at 04:02 PM
17 - **Hash:** `26449d153a5b81c3d15a3774241c5197e770112b`
18 </details>
19Tutto questo con un solo comando. E sì, puoi personalizzare emoji, titoli, ordine delle sezioni e formato delle date!
Perchè usarlo?
- •Risparmi tempo evitando di scrivere changelog a mano
- •Hai una panoramica chiara delle modifiche fatte
- •Il team lavora meglio con uno standard condiviso
- •Migliora la qualità e la trasparenza del tuo progetto
Contribuisci e fammi sapere che ne pensi
loji è open-source!
Se ti piace l’idea, passa a dare un’occhiata alla repo, apri una issue o metti una ⭐️. Ogni feedback è super benvenuto.
🔗 GitHub: https://github.com/namecoder1/loji
