TOC

Comment contribuer à l’open source: Débuter avec Git

introduction

Les projets open-source hébergés dans des référentiels publics tirent parti des contributions de la communauté des développeurs et sont généralement gérés via Git.

Système de contrôle de version distribué, Git permet aux projets logiciels basés sur des équipes et à source ouverte de contribuer et de maintenir facilement. Gratuit à télécharger et à utiliser, Git est un exemple de projet open-source.

Ce tutoriel discutera des avantages de contribuer à des projets open-source, et passera en revue l'installation et la configuration de Git afin que vous puissiez contribuer à des projets logiciels.

Contribuer à des projets open-source

Un logiciel open source est un logiciel librement disponible pour être utilisé, redistribué et modifié.

Les projets open source encouragent un processus transparent avancé grâce à une évaluation par les pairs distribuée. Les projets open source peuvent être mis à jour rapidement et en fonction des besoins. Ils offrent des logiciels fiables et flexibles qui ne reposent pas sur des systèmes propriétaires verrouillés.

Contribuer à des projets open source permet de s’assurer qu’ils sont aussi performants que possible et représentatifs de la vaste base d’utilisateurs finaux de technologies. Lorsque les utilisateurs finaux contribuent à des projets open source via du code ou desdocumentation, leurs perspectives diverses apportent une valeur ajoutée au projet, aux utilisateurs finaux du projet et à la communauté des développeurs dans son ensemble.

La meilleure façon de commencer à contribuer à des projets open-source est de commencer par contribuer aux logiciels que vous utilisez déjà. En tant qu'utilisateur d'un outil particulier, vous comprenez le mieux quelles fonctionnalités seraient les plus utiles au projet. Assurez-vous de lire tout d'abord la documentation disponible sur le logiciel. En fait, de nombreux projets open-source auront un fichierCONTRIBUTING.md dans le répertoire racine, que vous devriez lire attentivement avant de contribuer. Vous pouvez également avoir une idée des interactions entre les autres développeurs de la communauté si des forums sur le projet sont disponibles.

Enfin, si vous commencez tout juste à contribuer à des logiciels open source, c'est une bonne idée de commencer par quelque chose de petit - chaque contribution est précieuse. Vous voudrez peut-être commencer par corriger les fautes de frappe, ajouter des commentaires ou rédiger une documentation plus claire.

Git

Git est l'un des systèmes de contrôle de version les plus populaires pour les logiciels. Git a été créé en 2005 par Linus Torvalds, le créateur du noyau Linux. Utilisé à l'origine pour le développement du noyau Linux, Junio ​​Hamano est le responsable actuel du projet.

De nombreux projets conservent leurs fichiers dans un référentiel Git, et des sites tels que GitHub, GitLab et Bitbucket ont rendu le partage et la contribution au code simples, utiles et efficaces. Chaque répertoire de travail dans Git est un référentiel complet avec un historique complet et un suivi indépendant de l'accès au réseau ou d'un serveur central.

Le contrôle de version est devenu un outil indispensable dans le développement de logiciels modernes, car ces systèmes vous permettent de suivre les logiciels au niveau de la source. Vous et les autres membres d'une équipe de développement pouvez suivre les modifications, revenir aux étapes précédentes et vous éloigner du code de base pour créer des versions alternatives de fichiers et de répertoires.

Git est très utile pour les projets open-source, car il facilite les contributions de nombreux développeurs. Chaque contributeur peut se déconnecter de la branche principale ou principale du référentiel de la base de code pour isoler ses propres modifications, puis faire une demande d'extraction pour que ces modifications soient intégrées au projet principal.

Pour que Git contribue aux projets open-source, vérifions si Git est installé et, dans le cas contraire, expliquons comment l’installer sur votre ordinateur local.

Vérifier si Git est installé

Tout d’abord, vous voudrez vérifier si des outils de ligne de commande Git sont installés sur votre ordinateur. Si vous avez créé des référentiels avec votre propre code, Git est probablement installé sur votre ordinateur local. Certains systèmes d'exploitation sont également livrés avec Git, il est donc utile de vérifier avant de l'installer.

Vous pouvez vérifier si Git est installé et quelle version vous utilisez en ouvrant une fenêtre de terminal sous Linux ou Mac ou une fenêtre d'invite de commande sous Windows et en tapant la commande suivante: 

git --version

Cependant, si Git n'est pas installé, vous recevrez une erreur similaire à celle-ci: 

-bash: git: command not found
'git' is not recognized as an internal or external command, operable program or batch file.

Dans ce cas, vous devez installer Git sur votre machine. Examinons l’installation de plusieurs des principaux systèmes d’exploitation.

Installer Git sur Linux

Le moyen le plus simple d’installer Git et de l’utiliser est d’utiliser votre version des référentiels par défaut de Linux. Voyons comment installer Git sur votre machine Linux locale en utilisant cette méthode.

Installer Git sur Ubuntu 18.04 ou Debian 10

Vous pouvez utiliser les outils de gestion de paquets apt pour mettre à jour votre index de paquet local. Ensuite, vous pouvez télécharger et installer le programme: 

sudo apt update
sudo apt install git

Bien que ce soit la méthode la plus rapide pour installer Git, la version peut être plus ancienne que la version la plus récente. Si vous avez besoin de la dernière version, envisagez de compiler Git à partir des sources en utilisantthis guide.

De là, vous pouvez passer à la section surSetting Up Git.

Installer Git sur CentOS

Nous utiliseronsyum, le gestionnaire de packages natif de CentOS, pour rechercher et installer le dernier package Git disponible dans les référentiels CentOS.

Assurons d’abord que yum soit à jour en lançant cette commande: 

sudo yum -y update

L'indicateur-y est utilisé pour alerter le système que nous sommes conscients que nous apportons des modifications, empêchant le terminal de nous demander de confirmer.

Maintenant, nous pouvons aller de l'avant et installer Git: 

sudo yum install git

Bien que ce soit la méthode la plus rapide pour installer Git, la version peut être plus ancienne que la version la plus récente. Si vous avez besoin de la dernière version, envisagez de compiler Git à partir des sources en suivant l'option 2 dethis guide.

De là, vous pouvez passer à la section surSetting Up Git.

Installer Git sur Fedora

Les packages Git pour Fedora sont disponibles viayum etdnf. Introduit dans Fedora 18, DNF, ou Dandified Yum, est le gestionnaire de paquets par défaut pour Fedora depuis Fedora 22.

Depuis la fenêtre de votre terminal, mettez à jour dnf et installez Git: 

sudo dnf update
sudo dnf install git

Si vous avez une ancienne version de Fedora, vous pouvez utiliser la commandeyum à la place. Commençons par mettre à jouryum, puis installez Git: 

sudo yum update
sudo yum install git

De là, vous pouvez passer à la section surSetting Up Git.

Installer Git sur macOS

Sur un ordinateur Macintosh local, si vous tapez une commande Git dans la fenêtre de votre terminal (comme dansgit --version ci-dessus), vous serez invité à installer Git s'il n'est pas déjà sur votre système. Lorsque vous recevez cette invite, vous devez accepter l'installation de Git, suivre les instructions et répondre aux invites dans la fenêtre de votre terminal.

Vous pouvez installer la version la plus récente de Git sur votre Mac en l’installant via l’installateur binaire. Un programme d'installation OS X Git est mis à jour et disponible au téléchargement sur le site Web de Git. Cliquez surhere pour lancer automatiquement le téléchargement.

Une fois que Git est complètement installé, vous pouvez passer à la section surSetting Up Git.

Installer Git sous Windows

Pour Windows, vous pouvez télécharger la version officielle sur le site Web de Git. Cliquez surhere pour lancer automatiquement le téléchargement.

Il existe également un projet open-source appelé Git pour Windows, distinct du site Web officiel de Git. Cet outil fournit à la fois des outils de ligne de commande et d’interface graphique permettant d’utiliser efficacement Git sur votre ordinateur Windows. Pour plus d'informations sur ce projet et pour inspecter et télécharger le code, visitez le siteGit for Windows project site.

Une fois que Git est complètement installé, vous pouvez passer à la section surSetting Up Git.

Configurer Git

Maintenant que Git est installé, vous devez prendre certaines mesures pour que les messages de validation générés pour vous contiennent les informations correctes.

La manière la plus simple de procéder est d'utiliser la commandegit config. Plus précisément, nous devons fournir notre nom et notre adresse électronique, car Git intègre ces informations dans chaque engagement que nous effectuons. Nous pouvons aller de l'avant et ajouter cette information en tapant: 

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

Nous pouvons voir tous les éléments de configuration qui ont été définis en tapant: 

git config --list

configuration git 

user.name=Your Name
[email protected]

Comme vous pouvez le constater, son format est légèrement différent. Les informations sont stockées dans votre fichier de configuration Git, que vous pouvez éventuellement modifier manuellement à l'aide d'un éditeur de texte, tel que nano par exemple: 

nano ~/.gitconfig

~/.gitconfig contents

[user]
    name = Your Name
    email = [email protected]

Une fois que vous avez terminé de modifier votre fichier, vous pouvez quitter nano en tapant la commande et les touchesx, et lorsque vous êtes invité à enregistrer le fichier, appuyez sury.

Il existe de nombreuses autres options que vous pouvez définir, mais ce sont les deux indispensables pour prévenir les avertissements à l'avenir.

Conclusion

Avec Git installé et configuré sur votre ordinateur local, vous êtes maintenant prêt à utiliser Git pour le contrôle de version de vos propres projets logiciels et pour contribuer à des projets open-source ouverts au public.

L'ajout de vos propres contributions aux logiciels à code source ouvert constitue un excellent moyen de s'impliquer davantage dans la communauté des développeurs et permet de garantir que les logiciels conçus pour le public sont de haute qualité et pleinement représentatifs des utilisateurs finaux.

Related