VimPdb

VimPdb är en modul som tillhandahåller en integrering av Python debugger pdb in VIM redaktör.
Användning:
Python-kod
Använda vimpdb är enkelt - bara sätta in ett samtal till set_trace i koden nästan som vanligt:
import vimpdb; vimpdb.set_trace ()
Starta sedan din Python application / script.
När python tolk träffar den linjen, kommer vimpdb lansera en VIM instans. VIM ska få fokus; den laddar källfilen på rätt linje.
VIM kommandon
I VIM, kan du nu använda följande kommandon:
: PDBNext n pdb (n) ext
: PDBStep s pdb (er) tep
: PDBArgs ett preliminärt budgetförslag (a) rgs
: PDBUp u pdb (u) p-
: PDBDown d pdb (d) egen
: PDBReturn r pdb (r) Eturn
: PDBContinue c pdb (c) ontinue
: PDBBreak b Ställer in en brytpunkt vid linjen som markören sitter; liknande pdb b (ryt)
: PDBClear B Rensar en brytpunkt vid linjen som markören sitter; liknande pdb cl (örat)
: PDBWord w Utvärderar värdet av identifierare som markören sitter.
: PDBEval? Utvärderar ett Python uttryck efter att ha bett om det.
: PDBReset x Växla tillbaka till normal felsökning skal med standard pdb.
N / A v (im) Växla tillbaka till vimpdb; endast i vanligt pdb.
Standard pdb krok
Om du tycker att det är svårt att ändra vanor och hålla på att skriva
importera pdb; pdb.set_trace ()
du kan lägga till följande rad i .pdbrc filen sitter i din hemkatalog:
import vimpdb; vimpdb.hookPdb ()
På så sätt är kommandot v (im) som nämns ovan läggas till din vanliga pdb och du kan växla till vimpdb när som helst.
Krav
vimpdb har använts framgångsrikt under Linux, Mac OSX och Windows.
Den är kompatibel med Python 2.7, 2.6, 2.5 och 2.4. Det är inte förenligt med Python 3.1 (det bör vara densamma för 3,0).
vimpdb kräver en installation av VIM som stöder både Python och klientserver alternativ.
Ta reda på om det är fallet genom att utfärda följande kommando på VIM prompten:
: Version
Om alternativen stöds, kommer du att se + klientserver och + python i produktionen. I det motsatta fallet, kommer du att se -clientserver eller -python.
I Linux och Windows, bör standard VIM bygga redan server aktiverad.
I Windows, python alternativet sammanställts i VIM beror på en viss Python-version. Ta reda på om den specifika versionen är installerad och arbetar i VIM genom att utfärda följande kommando på VIM prompten:
: python import sys; trycket sys.version
På Mac OSX, kommer du vill använda MacVIM. MacVIM har också python alternativet sammanställts i som standard.
Installation:
Standardinstallation med easy_install
easy_install vimpdb
Du kan naturligtvis också använda pip.
& Nbsp; Om du tittar inuti förpackningen, kommer du att se en VIM skriptfil: vimpdb.vim. Flytta inte till VIM konfigurationskatalog (som ~ / .vim / plugin). vimpdb vet hur man gör manuset tillgängligt för VIM.
Konfiguration:
Kort historia
vimpdb försöker undvika beroende på alla användare konfiguration. Om det inte kan detektera rätt konfiguration av sig själv, kommer det ställa några frågor som du bör kunna svara lätt.
Lång historia
När lanseras, ser vimpdb för sin RC-fil: ~ / .vimpdbrc. Om den inte hittar det skapar vimpdb filen för dig från standardvärden.
vimpdb försöker en uppsättning standardvärden som ska fungera. Den kontrollerar om dessa standardvärden är lämpliga. Om standardvärden inte fungerar, frågar vimpdb för andra värden interaktivt förrän det har kontrollerats att de värden som faktiskt fungerar.
Standardvärdena per OS listas nedan.
För Linux:
vim_client_script = vim
vim_server_script = gvim
servernamn = gvim
port = 6666
För MacOSX:
vim_client_script = mvim
vim_server_script = mvim
servernamn = VIM
port = 6666
För Windows:
vim_client_script = vim.exe
vim_server_script = gvim.exe
servernamn = VIM
port = 6666
Se nedan för mer information om de olika alternativen.
Du uppenbarligen tillåtet att skapa och ställa som RC-fil. Icke desto mindre bör RC-filen innehålla värden för alla 4 alternativ. Om någon av dem saknas, vimpdb raster och klagar därefter.
VIM script - vim_client_script
För att kommunicera med VIM fall där felsökning händer, vimpdb behöver starta en annan VIM instans i klientläge.
vim_client_script alternativet håller manuset används för att starta att VIM instans med klientserver stöd.
I Windows, bör det hålla vim.exe, inte gvim.exe. Dessutom, inte inkludera citat i värde för att ta hand om blank i vägen.
VIM serverskriptet - vim_server_script
Om ingen VIM instansen körs, lanserar vimpdb en VIM instans i serverläge.
vim_server_script alternativet håller manuset används för att starta att VIM instans med klientserver stöd. Som felsökning i VIM instans är skriven med python, måste den instansen har python stöd.
På MacOSX och Linux, kan vim_server_script och vim_client_script hålla samma värde.
I Windows, kan bara den grafiska VIM användas som server, anledningen till de två separata standardvärden som framgår ovan.
Servernamn - server
Den VIM instans i serverläge har ett namn.
Som standard, talar vimpdb till servern som heter VIM, vilket är standard server används av VIM.
Om du vill vimpdb att använda en annan server namn, ändra servernamn alternativet. Det bör ha namnet på VIM server som du vill ska användas för felsökning.
Du kan lista som för närvarande kör VIM servrar med hjälp av:
$ Vim --serverlist
VIM
Eller, på en Mac:
$ /Applications/MacVim.app/Contents/MacOS/Vim --serverlist
VIM
När en VIM instans med klientserver stöd är igång kan du hitta sitt namn genom att utfärda följande kommando på VIM prompten:
: Echo v: server
UDP Port - port
VIM kommunicerar med vimpdb genom en UDP socket. Som standard är uttaget öppnas på port 6666.
Om detta uttag inte är tillgängligt i ditt system, kan du ange en ledig portnummer med alternativet porten.
Bakåtkompatibilitet
Innan version 0.4.1, vimpdb RC-fil (~ / .vimpdbrc) hade en enda script alternativ. Denna möjlighet har förvandlats till vim_client_script alternativet. Uppgraderingen ska vara transparent.
Innan version 0.4.0, var vimpdb konfigureras via miljövariabler. Om du hade en fungerande konfiguration, bör uppgradering vara transparent. Värdena för VIMPDB_SERVERNAME och VIMPDB_VIMSCRIPT miljövariabler är inställda i RC-fil (~ / .vimpdbrc). De sätts respektive i servernamn och manusalternativ

Vad är nytt i den här versionen.

• Fix markering av nuvarande rad.

Vad är nytt i version 0.4.4:

• tester sanering: bli av hjälpklass och funktioner .
• kod sanering. Förbättra importen stil
• efter c (ontinue), nyckel kartläggning bröts (igen).

Vad är nytt i version 0.4.3.2:

• fix Linux standardvärden i dokumentationen.
• dokument PDBxx kommandon.
• mindre buller på VIM kommandoraden.
• bättre markering av nuvarande rad.

Vad är nytt i version 0.4.2:

• PDBEval (mappas till nyckel?) För att be om en Python uttryck som ska utvärderas.
• PDBClear (mappas till B-tangenten) för att rensa en tidigare brytpunkt.
• Öppna ny flik om det redan finns en öppen fil i VIM.
• close vimpdb buffert när fortsätta (c), återställ (x) eller avsluta (q).
• lanseringen VIM server även om en annan server är igång.

Vad är nytt i version 0.4.1.2:

• polish dokumentationen.

Vad är nytt i version 0.3.8:

• fix: vissa versioner av VIM behöver Explicite import även även om de flesta gör det inte. (Http://github.com/gotcha/vimpdb/issues/issue/5)

Vad är nytt i version 0.3.7:

• fix: kunde inte gå & quot; ned & quot; efter byte från pdb till vimpdb efter att ha gått & quot; upp & quot; (Http://github.com/gotcha/vimpdb/issues/issue/4)

Vad är nytt i version 0.3.6:

• fix: & quot; fortsätta & quot; kommando bröts efter brytpunkten har ställts in (http://github.com/gotcha/vimpdb/issues/issue/3)
• fix: Nyckeln avbildningar lämnades bruten efter & quot; fortsätta & quot; kommando. (Http://github.com/gotcha/vimpdb/issues/issue/2)

Vad är nytt i version 0.3.5:

• bättre dokumentation, särskilt för Windows
• fix fångst av produktion som bröts för Python 2.5 och 2.6
• Windows-kompatibilitet (åtminstone XP)

Krav :

• Vim
• Python