La clé pour rédiger un bon docstring Python est de suivre les normes, d'unifier les styles, d'inclure les informations nécessaires et d'utiliser des outils pour aider. 1. Suivez les spécifications de base de Pep257, utilisez trois devis pour envelopper le contenu, expliquez brièvement la fonction dans la première phrase et décrivez les paramètres et les valeurs de retour en détail après avoir violé une ligne. 2. Choisissez un style commun tel que Google Style et gardez-le unifié pour améliorer la lisibilité et l'efficacité de la collaboration. 3. Contient des informations clés telles que la description de la fonction, le type de paramètre et le sens, le type de valeur de retour et le sens, et ajoute des descriptions d'exception et une utilisation de l'exemple en fonction de la situation. 4. Utilisez le plug-in de l'éditeur pour générer automatiquement des modèles et vérifiez le format via des outils tels que Pydocstyle pour assurer l'exactitude de la spécification.
Il n'est en fait pas difficile d'écrire un bon docstring de Python, mais beaucoup de gens ignorent son importance ou l'écrivent de manière standardisée. Un docstring clairement et standard peut vous aider, vous et d'autres, à comprendre rapidement les fonctions des fonctions, des classes ou des modules, et peut également être reconnue par des outils de document automatiques tels que Sphinx pour générer des documents.

Vous trouverez ci-dessous quelques suggestions pratiques pour vous apprendre à écrire un docstring utile et standardisé.
1. Suivez les spécifications de base de PEP257
Python a quelques exigences de base pour docstring, la plus élémentaire est:

- Utilisez trois citations (
"""
) pour envelopper le contenu - La phrase de début est concise pour expliquer la fonction, puis la décrire en détail après la ligne vide
- N'écrivez pas "Ceci est une certaine fonction", mais expliquez directement le but
Par exemple:
def add (a, b): "" "Renvoyez la somme de a et b. Args: A (int): premier numéro b (int): deuxième numéro Renvoie: Int: somme de A et B "" " retour AB
La première phrase est un résumé, suivi d'une explication des paramètres et des valeurs de retour. Cette écriture est non seulement claire, mais facilite également l'analyse des outils.

2. Choisissez un style pour l'utiliser uniformément
Il existe trois formats docstring communs: le style par défaut de PEP257, REST (TEXTURATURE TEXT), Google Style et NumpyDoc . Parmi eux, Google Style est relativement facile à lire et convient aux débutants.
Par exemple, Google Style:
Def multiplier (a, b): "" "Multipliez deux entiers et renvoyez le résultat. Args: A (int): le premier numéro. B (int): le deuxième numéro. Renvoie: INT: Le produit de A et B. "" " retourner un * b
Vous pouvez choisir des styles en fonction des spécifications de l'équipe ou des exigences du projet, et la clé est de maintenir la cohérence.
3. Inclure les informations clés, ne manquez pas les points clés
Un bon docstring devrait inclure les points suivants (pas nécessairement chacun doit être inclus, selon la situation):
- Description de la fonction
- Type de paramètre et signification
- Type de valeur de retour et signification
- Exception possible (le cas échéant)
- Exemple d'utilisation (facultatif)
Surtout pour les paramètres et les valeurs de retour, vous devez clairement écrire le type et la fonction. Ceci est particulièrement important lors de la collaboration avec plusieurs personnes.
Si vous ne savez pas comment l'écrire, vous pouvez vous référer à la bibliothèque standard ou à des projets open source populaires, tels que requests
ou pandas
.
4. Utilisez des outils pour vérifier et générer des docstring
Certains plugins d'éditeur peuvent vous aider à générer automatiquement des modèles, tels que:
- Générateur de docstring Python pour le code vs
- PyCharm est livré avec un support de modèle docstring
Ces outils peuvent vous aider à gagner du temps et à éviter les erreurs de format. De plus, vous pouvez utiliser pydocstyle
ou flake8-docstrings
pour vérifier si votre docstring est conforme à la spécification.
Fondamentalement, c'est tout. L'écriture docstring ne prend pas trop de temps, mais les avantages sont très réels - il peut être plus fluide que vous regardez en arrière sur le code vous-même ou les autres appelez l'interface. Tant que vous vous en tenez à un style et notez clairement les informations clés, ce sera formidable.
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Outils d'IA chauds

Undress AI Tool
Images de déshabillage gratuites

Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.

Clothoff.io
Dissolvant de vêtements AI

Video Face Swap
échangez les visages dans n'importe quelle vidéo sans effort grace à notre outil d'échange de visage AI entièrement gratuit?!

Article chaud

Outils chauds

Bloc-notes++7.3.1
éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise
Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1
Puissant environnement de développement intégré PHP

Dreamweaver CS6
Outils de développement Web visuel

SublimeText3 version Mac
Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Utilisez le plot conjoint de Seaborn pour visualiser rapidement la relation et la distribution entre deux variables; 2. Le tracé de diffusion de base est implémenté par sn.jointplot (data = pointes, x = "total_bill", y = "Tip", kind = "dispers"), le centre est un tracé de dispersion et l'histogramme est affiché sur les c?tés supérieur et inférieur et droit; 3. Ajouter des lignes de régression et des informations de densité à un kind = "reg" et combiner marginal_kws pour définir le style de tracé de bord; 4. Lorsque le volume de données est important, il est recommandé d'utiliser "Hex"

Les listes de cha?nes peuvent être fusionnées avec la méthode join (), telles que '' .join (mots) pour obtenir "HelloworldFrompython"; 2. Les listes de nombres doivent être converties en cha?nes avec MAP (STR, nombres) ou [STR (x) Forxinnumbers] avant de rejoindre; 3. Toute liste de types peut être directement convertie en cha?nes avec des supports et des devis, adaptées au débogage; 4. Les formats personnalisés peuvent être implémentés par des expressions de générateur combinées avec join (), telles que '|' .join (f "[{item}]" ForIteminitems)

Installez PYODBC: utilisez la commande PiPInstallpyodbc pour installer la bibliothèque; 2. Connectez SQLServer: utilisez la cha?ne de connexion contenant le pilote, le serveur, la base de données, l'UID / PWD ou TrustEd_Connection via la méthode pyoDBC.Connect () et prendre en charge l'authentification SQL ou l'authentification Windows respectivement; 3. Vérifiez le pilote installé: exécutez pyodbc.Drivers () et filtrez le nom du pilote contenant ?SQLServer? pour vous assurer que le nom du pilote correct est utilisé tel que ?ODBCDriver17 pour SQLServer?; 4. Paramètres clés de la cha?ne de connexion

pandas.melt () est utilisé pour convertir les données de format larges en format long. La réponse consiste à définir de nouveaux noms de colonne en spécifiant id_vars conserver la colonne d'identification, Value_Vars Sélectionnez la colonne à fondre, var_name et valeur_name, 1.id_vars = 'name' signifie que la colonne de nom reste inchangée, 2.Value_vars = [Math ',' English ',' Science '. du nom de colonne d'origine, 4.value_name = 'score' définit le nouveau nom de colonne de la valeur d'origine et génère enfin trois colonnes, notamment le nom, le sujet et le score.

Définissez d'abord un formulaire ContactForm contenant le nom, la bo?te aux lettres et les champs de message; 2. De l'avis, la soumission du formulaire est traitée en jugeant la demande de poste, et après la vérification, nettoyée_data est obtenue et la réponse est retournée, sinon le formulaire vide sera rendu; 3. Dans le modèle, utilisez {{form.as_p}} pour rendre le champ et ajouter {% csrf_token%} pour empêcher les attaques CSRF; 4. Configurer le routage d'URL vers Point / Contact / vers la vue Contact_View; Utilisez Modelform pour associer directement le modèle pour obtenir un stockage de données. Djangoforms implémente le traitement intégré de la vérification des données, le rendu HTML et les invites d'erreur, qui convient au développement rapide des fonctions de forme s?re.

PythonCanBeoptimizedFormemory-Boundoperations AdreductoverHeadHroughGenerators, EfficientDatastructures et ManagingObjectliFetimes.first, useGeneratorsInSteadofListStoproceSlargedataseSeItematatime, EvitingLoadingEnteryToMeToMeMory.

L'introduction à l'arbitrage statistique L'arbitrage statistique est une méthode commerciale qui capture l'inadéquation des prix sur le marché financier basé sur des modèles mathématiques. Sa philosophie principale découle de la régression moyenne, c'est-à-dire que les prix des actifs peuvent s'écarter des tendances à long terme à court terme, mais reviendront éventuellement à leur moyenne historique. Les traders utilisent des méthodes statistiques pour analyser la corrélation entre les actifs et rechercher des portefeuilles qui changent généralement de manière synchrone. Lorsque la relation de prix de ces actifs est anormalement déviée, des opportunités d'arbitrage se présentent. Sur le marché des crypto-monnaies, l'arbitrage statistique est particulièrement répandu, principalement en raison de l'inefficacité et des fluctuations drastiques du marché lui-même. Contrairement aux marchés financiers traditionnels, les crypto-monnaies fonctionnent 24h / 24 et leurs prix sont très susceptibles de briser les nouvelles, les sentiments des médias sociaux et les améliorations technologiques. Cette fluctuation des prix constante crée fréquemment un biais de prix et fournit aux arbitrageurs un

Iter () est utilisé pour obtenir l'objet Iterator, et Next () est utilisé pour obtenir l'élément suivant; 1. Utilisez Iterator () pour convertir des objets itérables tels que les listes en itérateurs; 2. Appelez Next () pour obtenir des éléments un par un et déclenchez l'exception de l'arrêt lorsque les éléments sont épuisés; 3. Utilisez Suivant (iterator, par défaut) pour éviter les exceptions; 4. Les itérateurs personnalisés doivent implémenter les méthodes __iter __ () et __Next __ () pour contr?ler la logique d'itération; L'utilisation de valeurs par défaut est un moyen courant de parcourir la traversée et l'ensemble du mécanisme est concis et pratique.
