Comment mettre en ligne un script Python avec piFunction ?
piFunction est une micro-app qui permet de mettre en ligne votre script Python, tout en fournissant une interface web à vos utilisateurs.
Comment créer une micro-app piFunction ?
Créez votre piFunction avec l' introduction.
Attendez que la micro-app soit prête, en attendant le statut UP dans votre dashboard.
Cliquez sur le nom de votre micro-app et accédez à la section overview.
Vous pouvez vérifier que votre application est en ligne en cliquant sur le bouton 'Ouvrir' de la barre de navigation de gauche.
Quels sont les pré-requis ?
Le code Python que vous souhaitez importer doit respecter les contraintes suivantes.
Doit être écrit en Python 3.9.
Doit faire moins de 50 Mo.
Doit avoir un fichier main.py. Les entrées utilisateur y seront mappées.
L'importation peut consister en :
- .fichiers .py sans dossiers
- .fichier .zip contenant les fichiers .py et les dépendances requises.
La piFunction contient déjà des librairies Python courantes.
Vous pouvez trouver la liste complète des librairies natives ici.librairies ici.
Quelle doit être la structure du code Python ?
Si votre code n'a pas besoin de librairies externes
- Créez le fichier main.py.
- En fonction de la taille de votre projet, vous pouvez créer d'autres fichiers .py.
L'exemple suivant est un projet sans librairies externes. main.pymonfichierpersonnalise.py
- Une fois que votre code fonctionne comme prévu, vous pouvez l'uploader dans le panneau de configuration de votre piFunction :
main.py
monfichierpersonnalise.py
Si votre code a besoin de librairies externes
- Créez le fichier main.py.
- Utilisez la librairie externe dont vous avez besoin, mathdans l'exemple suivant : monfichierpersonnalise.py
Vous pouvez télécharger la librairie dans votre projet avec le code suivant.
- Une fois que votre code fonctionne comme prévu, vous pouvez compresser le dossier et le télécharger dans le panneau de configuration de votre piFunction.
Votre fichier .zip contiendra le contenu suivant :
main.py
monfichierpersonnalise.py
python_math/
python_math-0.0.1.dist-info
Comment créer le fichier main.py ?
Le fichier main.py configure les entrées et les sorties pour interagir avec les utilisateurs. Il doit respecter les contraintes suivantes.
Doit avoir une fonction main.
Les paramètres de la fonction principale doivent être déclarés dans la section Entrées. Les paramètres par défaut ne sont pas acceptés.
Les variables renvoyées par la fonction principale doivent être déclarées dans la section Sorties. Lorsque votre piFunction renvoie un fichier, votre script doit créer le fichier dans le système de stockage (voir ligne 21 de l'exemple suivant) et la fonction principale doit renvoyer le chemin du fichier. Par exemple, vous pouvez utiliser pandas.to_csv et pandas.to_excelpour enregistrer votre DataFrame dans le stockage, et renvoyer le chemin du fichier créé.
Cet exemple complet montre comment charger un texte et un fichier, et renvoyer un texte et un fichier.
La configuration des Entrées / Sorties ressemblera à ceci.
Quelles sont les fonctionnalités de la librairie Pirog ?
Vous pouvez utiliser les fonctions suivantes pour charger les fichiers de vos utilisateurs.
Pour charger un fichier dans le local distant
Pour ouvrir un CSV en tant que DataFrame Pandas
Plus d'informations dans la documentation 'pandas.read_csv'Pour ouvrir un Excel en tant que DataFrame Pandas
Plus d'informations dans la documentation 'pandas.read_excel'Vous devez traiter un autre type de données ? N'hésitez pas à nous contacter à no-reply@pirog.io.