VimPdb

VimPdb est un module qui fournit une intégration du débogueur pdb Python dans l'éditeur de VIM.
Utilisation:
code Python
Utilisation vimpdb est facile - il suffit d'insérer un appel à set_trace dans votre code presque comme d'habitude:
vimpdb d'importation; vimpdb.set_trace ()
Puis démarrer votre application python / script.
Lorsque l'interprète de python frappe cette ligne, vimpdb lancera une instance VIM. VIM doit obtenir le focus; il charge le fichier source à la ligne droite.
commandes VIM
Dans VIM, vous pouvez maintenant utiliser les commandes suivantes:
: PDBNext n pdb (n) poste
: La pdb de PDBStep (s) tep
: PDBArgs un pdb (a) rgs
: PDBUp u pdb (u) p
: PDBDown d pdb (d) propre
: PDBReturn r pdb (r) etour
: PDBContinue c pdb (c) ontinuer
: PDBBreak b Définit un point d'arrêt à la ligne sur laquelle le curseur est assis; similaire à pdb b (reak)
: PDBClear B Efface un point d'arrêt à la ligne sur laquelle le curseur est assis; similaire à cl pdb (oreille)
: PDBWord w évalue la valeur de l'identifiant sur lequel le curseur est assis.
: PDBEval? Evalue une expression Python après avoir demandé.
: PDBReset x Revenez à la normale dans le débogage coquille avec pdb standard.
N / A v (im) Revenez à vimpdb; seulement dans pdb plaine.
Pdb crochet standard
Si vous trouvez qu'il est difficile de changer les habitudes et de garder sur le typage
importer pdb; pdb.set_trace ()
vous pouvez ajouter la ligne suivante dans le fichier .pdbrc assis dans votre dossier de départ:
vimpdb d'importation; vimpdb.hookPdb ()
De cette façon, la commande v (im) mentionné ci-dessus est ajouté à votre pdb standard et vous pouvez passer à vimpdb à tout moment.
Exigences
vimpdb a été utilisé avec succès sous Linux, Mac OSX et Windows.
Il est compatible avec python 2,7, 2,6, 2,5 et 2,4. Il est pas compatible avec Python 3.1 (il devrait être le même pour 3.0).
vimpdb nécessite une installation de VIM qui prend en charge les deux options de python et clientserver.
Cherchez à savoir si il est le cas en exécutant la commande suivante à l'invite de VIM:
: Version
Si les options sont prises en charge, vous verrez + clientserver et + python dans la sortie. Dans le cas contraire, vous verrez -clientserver ou -python.
Sur Linux et Windows, le VIM par défaut construction devrait déjà être serveur compatible.
Sous Windows, l'option python compilées dans VIM dépend d'une version spécifique de Python. Cherchez à savoir si cette version spécifique est installé et travaille à VIM en exécutant la commande suivante à l'invite de VIM:
sys: python d'importation; print sys.version
Sur Mac OSX, vous aurez envie d'utiliser MacVim. MacVim a également la possibilité de python compilé par défaut.
Installation:
Installation standard avec easy_install
easy_install vimpdb
Vous pouvez évidemment utiliser également pip.
& Nbsp; Si vous regardez à l'intérieur du paquet, vous verrez un fichier de script VIM: vimpdb.vim. Ne pas le déplacer dans le répertoire de configuration de VIM (comme ~ / .vim / plugin). vimpdb sait comment faire le script disponible pour VIM.
Configuration:
Histoire courte
vimpdb tente d'éviter selon toute configuration de l'utilisateur. Si elle ne peut pas détecter la bonne configuration par lui-même, il sera poser quelques questions dont vous devriez être en mesure de répondre facilement.
Longue histoire
Lors de son lancement, vimpdb cherche son fichier RC: ~ / .vimpdbrc. Si elle ne trouve pas, vimpdb crée ce fichier pour vous à partir de valeurs par défaut.
vimpdb tente un ensemble de valeurs par défaut qui devraient fonctionner. Il vérifie si ces valeurs par défaut sont appropriées. Si les valeurs par défaut ne fonctionnent pas, vimpdb demande pour d'autres valeurs de manière interactive jusqu'à ce qu'il a vérifié que les valeurs fournies fonctionnent réellement.
Les valeurs par défaut par OS sont énumérés ci-dessous.
Pour Linux:
vim_client_script = vim
vim_server_script = gvim
server_name = GVIM
port = 6666
Pour MacOSX:
vim_client_script = mvim
vim_server_script = mvim
server_name = VIM
port = 6666
Pour Windows:
vim_client_script = vim.exe
vim_server_script = gvim.exe
server_name = VIM
port = 6666
Voir ci-dessous pour plus de détails sur chaque option.
Vous êtes évidemment autorisé à créer et régler ce fichier RC. Néanmoins, le fichier RC devrait contenir des valeurs pour les 4 options. Si l'un d'eux est manquant, pauses vimpdb et se plaint en conséquence.
Script client VIM - vim_client_script
Pour communiquer avec l'instance de VIM où débogage arrive, vimpdb doit lancer une autre instance de VIM en mode client.
l'option vim_client_script détient le script utilisé pour lancer cette instance de VIM avec le soutien de clientserver.
Sur Windows, il devrait tenir vim.exe, pas gvim.exe. En outre, ne pas inclure les guillemets dans la valeur pour prendre soin d'espaces dans le chemin.
Script serveur VIM - vim_server_script
Dans le cas où aucun cas de VIM est en cours d'exécution, vimpdb lance une instance de VIM en mode serveur.
l'option vim_server_script détient le script utilisé pour lancer cette instance de VIM avec le soutien de clientserver. Comme le débogage dans l'instance de VIM est écrit en Python, cette instance doit avoir l'appui de python.
Sur MacOSX et Linux, et vim_server_script vim_client_script peuvent contenir la même valeur.
Sous Windows, seul le VIM graphique peut être utilisé comme serveur, raison pour laquelle les deux valeurs par défaut séparées comme vu ci-dessus.
Nom du serveur - nom_serveur
L'instance de VIM en mode serveur a un nom.
Par défaut, vimpdb parle au serveur nommé VIM, qui est le nom du serveur par défaut utilisé par VIM.
Si vous voulez vimpdb utiliser un autre nom de serveur, modifier l'option de nom_serveur. Il doit contenir le nom du serveur VIM vous voulez être utilisée pour le débogage.
Vous pouvez lister les serveurs VIM en cours d'exécution à l'aide:
$ Vim --serverlist
VIM
Ou, sur un Mac:
$ /Applications/MacVim.app/Contents/MacOS/Vim --serverlist
VIM
Quand une instance VIM avec le soutien de clientserver est en cours d'exécution, vous pouvez trouver son nom en tapant la commande suivante à l'invite de VIM:
: Echo v: servername
UDP Port - Port
VIM communique à travers une douille vimpdb UDP. Par défaut, le socket est ouvert sur le port 6666.
Si cette prise ne sont pas disponibles dans votre système, vous pouvez spécifier un numéro de port disponible avec l'option de port.
Compatibilité avec
Avant la version 0.4.1, fichier RC de vimpdb (~ / .vimpdbrc) avaient une seule option de script. Cette option a été transformé en l'option de vim_client_script. La mise à jour devrait être transparent.
Avant la version 0.4.0, vimpdb a été configuré par le biais de variables d'environnement. Si vous aviez une configuration de travail, mise à niveau doit être transparent. Les valeurs des variables d'environnement et VIMPDB_SERVERNAME VIMPDB_VIMSCRIPT sont configurés dans le fichier RC (~ / de .vimpdbrc). Ils sont mis respectivement en nom_serveur script et les options

Ce qui est nouveau dans cette version:.

• Fix mise en évidence de la ligne actuelle.

Ce qui est nouveau dans la version 0.4.4:

• essais nettoyage: se débarrasser de la classe et les fonctions helper .
• nettoyage de code:. Améliorer les importations de style
• après c (ontinuer), la cartographie clé a été cassée (nouveau).

Quoi de neuf dans la version 0.4.3.2:

• fix valeurs par défaut de Linux dans la documentation.

Commandes
• Document de PDBxx.
• moins de bruit sur VIM ligne de commande.
• une meilleure signalisation de la ligne actuelle.

Ce qui est nouveau dans la version 0.4.2:

• PDBEval (mappé à clé?) Pour demander une expression Python à évaluer.
• PDBClear (mappé sur la touche B) pour effacer un point d'arrêt réglée précédemment.
• nouvel onglet ouvert seulement si il ya déjà un fichier ouvert dans le VIM.
• close tampon de vimpdb lorsque continuer (c), remis à zéro (x) ou quitter (q).
• serveur lancement VIM également si un autre serveur est en cours d'exécution.

Ce qui est nouveau dans la documentation version 0.4.1.2:

• polish.

Quoi de neuf dans la version 0.3.8:

• fix: certaines versions de VIM besoin importation explicite même bien que la plupart ne le font pas. (Http://github.com/gotcha/vimpdb/issues/issue/5)

Quoi de neuf dans la version 0.3.7:

• fix: ne pouvait pas aller & quot; & quot bas; après passage d'pdb à vimpdb après avoir passé & quot; jusqu'à & quot; (Http://github.com/gotcha/vimpdb/issues/issue/4)

Ce qui est nouveau dans la version 0.3.6:

• fix: & quot; & quot continuent; commande a été rompu après point d'arrêt a été mis (http://github.com/gotcha/vimpdb/issues/issue/3)
• fix: applications clés ont été laissées cassée après & quot; & quot continuer; commande. (Http://github.com/gotcha/vimpdb/issues/issue/2)

Ce qui est nouveau dans la version 0.3.5:

• une meilleure documentation, en particulier pour Windows
• capture fixe de sortie qui a été brisé pour Python 2.5 et 2.6
• Windows (au moins XP)

Exigences :

• Vim
• Python