impyrialtuto 0.1.0

A package for converting impyrial lengths and weights.

impyrialtuto

Introduction

Un package Python est une collection organisée de modules qui facilitent la réutilisation du code. Les packages permettent de structurer un projet de manière modulaire, ce qui améliore la maintenabilité, la lisibilité et le partage de code. Pour les développeurs, et en particulier en Data Science, créer et utiliser des packages permet de réutiliser des fonctionnalités complexes, de les organiser et de les partager facilement. Cela contribue également à la productivité en regroupant des fonctions spécifiques à un domaine ou à une tâche dans un ensemble cohérent.

Dans ce tutoriel, nous allons découvrir comment créer un package Python à travers l'exemple de impyrialtuto, un package simple qui permet de convertir des unités impériales de longueur et de poids.

Explication de la structure du répertoire de travail

Un package Python n'est rien d'autre qu'un dossier qui contient un fichier spécial appelé __init__.py. Ce fichier indique à Python que le dossier doit être traité comme un package. Un package peut également contenir des sous-packages, qui sont simplement des sous-dossiers avec leur propre fichier __init__.py.

Structure hiérarchique

Voici la structure du répertoire de travail pour le projet impyrialtuto :

impyrialtuto/
│
├── LICENSE
├── MANIFEST.in
├── README.md
├── requirements-dev.txt
├── setup.py
├── example_script.py
├── impyrialtuto/
    ├── __init__.py
    ├── utils.py
    ├── length/
    │   ├── __init__.py
    │   ├── core.py
    │   ├── api.py
    ├── weight/
        ├── __init__.py
        ├── core.py
        ├── api.py

Explication des éléments :

• impyrialtuto/ : Le répertoire principal de travail, qui contient le package ainsi que d'autres fichiers liés à la configuration du projet.

• LICENSE : Ce fichier contient la licence du projet qui définit les termes sous lesquels le code peut être utilisé et distribué.

• MANIFEST.in : Ce fichier permet de spécifier quels fichiers doivent être inclus lors de la distribution du package.

• README.md : Le fichier que vous êtes en train de lire. Il décrit le projet, ses fonctionnalités et son utilisation.

• requirements-dev.txt : Un fichier listant les dépendances nécessaires pour le développement du projet, par exemple pour les tests ou la documentation.

• setup.py : Le script de configuration qui permet de packager et de distribuer le projet via des outils comme PyPI (Python Package Index).

• example_script.py : Un script d'exemple utilisé pour tester l'utilisation du package impyrialtuto.

• impyrialtuto/ : Le dossier qui contient le code source du package. Ce dossier représente le cœur du projet.

  • init.py : Ce fichier fait de impyrialtuto un package Python. Il peut contenir des importations qui exposent des sous-packages ou des modules.

  • utils.py : Un module contenant des fonctions utilitaires qui peuvent être utilisées à travers le package.

  • length/ et weight/ : Ces deux dossiers représentent des sous-packages du package impyrialtuto. Chaque sous-package contient :

    • init.py : Ce fichier fait de chaque dossier un sous-package et peut être utilisé pour importer des fonctions ou modules spécifiques.

    • core.py : Contient les fonctions de conversion principales pour les unités de longueur ou de poids.

    • api.py : Fournit une interface utilisateur plus simple et plus intuitive pour appeler les fonctions du module core.py.

Description du package impyrialtuto

impyrialtuto est un package permettant de convertir des unités impériales de longueur et de poids. Ce package a été créé dans le cadre du cours DataCamp "Developing Python Packages".

Fonctionnalités

• Convertir des longueurs entre miles, yards, pieds et pouces.
• Convertir des poids entre cental, stones, livres et onces.

Utilisation

Voici comment utiliser le package impyrialtuto dans un script Python :

import impyrialtuto

# Convertir 500 yards en pieds
result = impyrialtuto.length.convert_unit(500, from_unit='yd', to_unit='ft')  # renvoie 1500.0
print(result)

# Convertir 100 onces en livres
result = impyrialtuto.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # renvoie 6.25
print(result)

Place à la démo

Dans cette section, nous allons parcourir les étapes pour démarrer le développement de votre package impyrialtuto.

1. Création d'un répertoire GitHub

• Rendez-vous sur GitHub et créez un nouveau dépôt nommé impyrialtuto. Ce dépôt contiendra tout le code de votre package.

2. Cloner le répertoire en local

• Une fois le dépôt créé, clonez-le en local sur votre machine à l'aide de la commande suivante dans votre terminal :

  git clone https://github.com/username/impyrialtuto.git
  

  Remplacez username par votre nom d'utilisateur GitHub.

3. Créer un environnement virtuel

• Une bonne pratique pour les projets Python est de travailler dans un environnement virtuel afin d'isoler les dépendances. Pour créer un environnement virtuel dans votre répertoire de travail, utilisez la commande suivante sous Linux :

  python3 -m venv .venv
  

4. Activer l'environnement virtuel

• Activez l'environnement virtuel avec la commande suivante (toujours sous Linux) :

  source .venv/bin/activate
  

  Cela vous permet de travailler avec des versions spécifiques de bibliothèques et de maintenir votre environnement de développement propre.

5. Ouvrir VSCode

• Lancez Visual Studio Code (VSCode) et ouvrez le répertoire impyrialtuto que vous avez cloné.

  code .
  

  Cela ouvrira le projet dans VSCode, où vous pouvez commencer à développer.

6. Créer la structure du package

• Créez tous les fichiers et dossiers nécessaires en suivant la structure décrite dans la section précédente du README. Assurez-vous que chaque fichier et sous-dossier est correctement positionné.

7. Développer le package

• Vous êtes maintenant prêt à commencer à coder ! Suivez les instructions ou la vidéo de démo pour développer les modules du package impyrialtuto.

Commandes Linux pour démarrer

Voici les commandes Linux pour créer la structure hiérarchique du projet impyrialtuto en étant dans le répertoire principal de travail :

# Créer le dossier du package principal
mkdir impyrialtuto

# Créer les sous-dossiers "length" et "weight"
mkdir -p impyrialtuto/length
mkdir -p impyrialtuto/weight

# Créer les fichiers initiaux
touch impyrialtuto/__init__.py
touch impyrialtuto/utils.py
touch impyrialtuto/length/__init__.py
touch impyrialtuto/length/core.py
touch impyrialtuto/length/api.py
touch impyrialtuto/weight/__init__.py
touch impyrialtuto/weight/core.py
touch impyrialtuto/weight/api.py

# Créer les fichiers dans le répertoire principal
touch LICENSE # Il est préférable de générer ce fichier pendant la création du répertoire GitHub. J'ai choisi la licence MIT
touch MANIFEST.in
touch README.md # Il est préférable de générer ce fichier pendant la création du répertoire GitHub.
touch setup.py
touch example_script.py