umpf

UMPF - Fonctionnalité Universal Magic Patch

umpf est un outil qui vous aide à gérer les branches git et à les combiner dans une version logicielle. Il peut créer des balises et exporter les modifications sous forme de pile de correctifs. umpf a été initialement conçu pour le noyau Linux, mais il peut également être utilisé pour d'autres projets.

Motivation

Il existe plusieurs raisons pour lesquelles les commits sont divisés en plusieurs branches :

• Certaines fonctionnalités, mais pas toutes, peuvent être partagées entre plusieurs projets. Des branches séparées permettent d'éviter des modifications inutiles dans une version spécifique.
• Un ensemble de commits est développé pour l’amont. Conserver les commits sur une branche distincte facilite le développement ultérieur et la mise en amont.
• Une branche peut être créée à partir d'une série de correctifs collectés à partir d'une liste de diffusion. Le garder séparé facilite la mise à jour vers une nouvelle version.

Ainsi, travailler avec plusieurs branches facilite la gestion des correctifs et le développement ultérieur. Mais combiner ces branches dans une version peut être fastidieux et sujet aux erreurs.

C'est là qu'umpf entre en jeu. Il automatise le processus de création de versions. Il crée des balises de manière reproductible. Et il peut créer des séries de correctifs à partir de ces balises.

Installation

umpf est un script bash, aucune installation n'est donc nécessaire. Il suffit de quelques outils en ligne de commande tels que sed, grep et bien sûr git.

Pour activer la complétion bash, assurez-vous que umpf est dans votre $PATH , puis :

 $ mkdir -p ~/.local/share/bash-completion/completions
$ ln -s /chemin/vers/umpf/bash_completion ~/.local/share/bash-completion/completions/umpf

Documentation

umpf -h donne une description de base des arguments de la ligne de commande. Plus de détails sur umpf peuvent être trouvés dans la documentation.

• Qu'est-ce qu'un umpf ?
• Commencer
• umpf de l'intérieur
• Trucs et astuces

Licence et développement

Pour contribuer à l'umpf, veuillez préparer une pull request sur Github. Pour qu'il soit possible d'inclure vos modifications, il est nécessaire que vos ajouts de code soient sous licence selon les mêmes conditions que umpf lui-même. Vous devez donc accepter le document suivant :

Certificat d'origine du développeur 1.1

En apportant une contribution à ce projet, j'atteste que :

1. La contribution a été créée en tout ou en partie par moi et j'ai le droit de la soumettre sous la licence open source indiquée dans le dossier ; ou
2. La contribution est basée sur des travaux antérieurs qui, à ma connaissance, sont couverts par une licence open source appropriée et j'ai le droit, en vertu de cette licence, de soumettre ce travail avec des modifications, qu'elles soient créées en tout ou en partie par moi, sous la même licence open source (sauf si je suis autorisé à soumettre sous une licence différente), comme indiqué dans le fichier ; ou
3. La contribution m'a été fournie directement par une autre personne qui a certifié (a), (b) ou (c) et je ne l'ai pas modifiée.
4. Je comprends et j'accepte que ce projet et la contribution sont publics et qu'un enregistrement de la contribution (y compris toutes les informations personnelles que je soumets avec, y compris ma signature) est conservé indéfiniment et peut être redistribué conformément à ce projet ou à l'open source. licence(s) concernée(s).

Votre accord est exprimé en ajoutant une ligne de signature à chacun de vos commits (par exemple en utilisant git commit -s ) ressemblant à ceci :

Signé par : Développeur Random J <[email protected]>

avec votre identité et votre adresse e-mail correspondant aux métadonnées de validation.