VimPdb

VimPdb er en modul som gir en integrering av Python debugger PDB inn i VIM editor.
Bruk:
Python-kode
Bruke vimpdb er enkelt - bare sette inn en oppfordring til set_trace i koden din nesten som vanlig:
import vimpdb; vimpdb.set_trace ()
Deretter starter python program / script.
Når python tolken treffer den linjen, vil vimpdb lansere en VIM eksempel. VIM bør få fokus; den laster kildefilen på rett linje.
VIM kommandoer
I VIM, kan du nå bruke følgende kommandoer:
: PDBNext n PDB (n) ext
: PDBStep s PDB (s) tep
: PDBArgs en PDB (a) rgs
: PDBUp u PDB (u) p
: PDBDown d PDB (d) egen
: PDBReturn r PDB (r) eturn
: PDBContinue c PDB (c), rediger
: PDBBreak b Angir et stoppunkt på linjen som markøren sitter; lik PDB b (reak)
: PDBClear B Fjerner et stoppunkt på linjen som markøren sitter; lik PDB cl (øret)
: PDBWord w Evaluerer verdien av identifikator som markøren sitter.
: PDBEval? Evaluerer et Python uttrykk etter å ha bedt om det.
: PDBReset x Bytt tilbake til normal debugging i skallet med standard PDB.
N / A v (im) Bytt tilbake til vimpdb; bare i vanlig PDB.
Standard pdb kroken
Hvis du synes det er vanskelig å endre vaner og holde på å skrive
importere pdb; pdb.set_trace ()
Du kan legge til følgende linje til .pdbrc filen sitter i Hjem-mappen:
import vimpdb; vimpdb.hookPdb ()
På denne måten er kommandoen v (im) nevnt ovenfor lagt til din standard PDB, og du kan bytte til vimpdb når som helst.
Krav
vimpdb har blitt brukt med hell under Linux, Mac OSX og Windows.
Den er kompatibel med Python 2.7, 2.6, 2.5 og 2.4. Det er ikke forenlig med Python 3,1 (det bør være den samme for 3,0).
vimpdb krever en installasjon av VIM som støtter både python og clientserver alternativer.
Finn ut om det er tilfelle ved å gi følgende kommando ved VIM teksten:
: Versjon
Hvis støttes alternativene, vil du se + clientserver og + python i produksjonen. I motsatt fall vil du se -clientserver eller -python.
På Linux og Windows, bør standard VIM build allerede være server-aktivert.
På Windows, python alternativet samlet i VIM er avhengig av en bestemt Python versjon. Finn ut om den spesifikke versjonen er installert og fungerer i VIM ved utstedelse av følgende kommando ved VIM teksten:
: python import sys; print sys.version
På Mac OSX, vil du ønsker å bruke MacVIM. MacVIM har også python alternativet samlet i som standard.
Installasjon:
Standard installasjon med easy_install
easy_install vimpdb
Du kan selvsagt også bruke pip.
& Nbsp; Hvis du ser inne i pakken, vil du se en VIM skriptfilen: vimpdb.vim. Ikke flytt den til VIM konfigurasjonskatalog (som ~ / .vim / plugin). vimpdb vet å gjøre manuset tilgjengelig for VIM.
Configuration:
Novelle
vimpdb forsøker å unngå avhengig av hvilken som helst bruker konfigurasjon. Hvis det ikke detekterer riktig konfigurasjon av seg selv, vil det stille noen spørsmål som du bør være i stand til å svare enkelt.
Lang historie
Da den ble lansert, ser vimpdb for sin RC file: ~ / .vimpdbrc. Hvis den ikke finner det, skaper vimpdb at filen for deg fra standardverdier.
vimpdb forsøker et sett med standardverdier som skal fungere. Den sjekker om disse standardverdiene som er aktuelle. Hvis standardverdiene ikke fungerer, spør vimpdb for andre verdier interaktivt før det er sjekket at verdiene som oppgis faktisk fungerer.
Standardverdiene per OS er listet herunder.
For Linux:
vim_client_script = vim
vim_server_script = gvim
server_navn = gvim
port = 6666
For MacOSX:
vim_client_script = mvim
vim_server_script = mvim
server_navn = VIM
port = 6666
For Windows:
vim_client_script = vim.exe
vim_server_script = gvim.exe
server_navn = VIM
port = 6666
Se nedenfor for mer informasjon om hvert alternativ.
Du er tydeligvis lov til å lage og melodi som RC-fil. Likevel bør RC filen holde verdier for alle fire alternativer. Hvis en av dem mangler, vimpdb pauser og klager deretter.
VIM klient skript - vim_client_script
For å kommunisere med VIM tilfelle hvor debugging skjer, vimpdb må lansere et annet VIM eksempel i klientmodus.
vim_client_script alternativet holder manuset brukes til å lansere at VIM eksempel med clientserver støtte.
På Windows, bør det holde vim.exe, ikke gvim.exe. Videre inkluderer ikke sitatene i verdi å ta vare på mellomrom i banen.
VIM server script - vim_server_script
I sak nr VIM forekomsten kjører, lanserer vimpdb en VIM eksempel i servermodus.
vim_server_script alternativet holder manuset brukes til å lansere at VIM eksempel med clientserver støtte. Som debugging i VIM eksempel er skrevet med python, må den forekomsten ha python støtte.
På MacOSX og Linux, kan vim_server_script og vim_client_script holde samme verdi.
I Windows kan bare det grafiske VIM brukes som server, årsaken til de to separate standardverdiene som vist over.
Server Name - server_navn
VIM eksempel i servermodus har et navn.
Som standard, taler vimpdb til serveren som heter VIM, som er standard server brukes av VIM.
Hvis du ønsker vimpdb å bruke en annen server navn, endre server_navn alternativet. Det bør holde navnet på VIM serveren du vil bli brukt for debugging.
Du kan liste opp kjørende VIM servere ved hjelp av:
$ Vim --serverlist
VIM
Eller, på en Mac:
$ /Applications/MacVim.app/Contents/MacOS/Vim --serverlist
VIM
Når en VIM eksempel med clientserver støtte er i gang, kan du finne navnet sitt ved å gi følgende kommando ved VIM teksten:
: Echo v: server
UDP Port - port
VIM kommuniserer til vimpdb gjennom en UDP socket. Som standard er kontakten åpnet på port 6666.
Hvis den kontakten ikke er tilgjengelig på systemet ditt, kan du angi en ledig port nummer med port alternativet.
Bakoverkompatibilitet
Før versjon 0.4.1, vimpdb RC-fil (~ / .vimpdbrc) hadde et enkelt script alternativ. Dette alternativet har blitt omgjort til vim_client_script alternativet. Oppgraderingen skal være gjennomsiktig.
Før versjon 0.4.0, ble vimpdb konfigureres via miljøvariabler. Hvis du hadde en fungerende konfigurasjon, bør oppgradering være gjennomsiktig. Verdiene av VIMPDB_SERVERNAME og VIMPDB_VIMSCRIPT miljøvariabler er oppsett i RC-filen (~ / .vimpdbrc). De er satt i henholdsvis server_navn og skript alternativer

Hva er nytt i denne utgaven.

• Fix synliggjøring av gjeldende linje.

Hva er nytt i versjon 0.4.4:

• tester opprydding: kvitte seg med hjelperen klassen og funksjoner .
• kode opprydding.: Forbedre import stil
• etter c (, rediger), nøkkelen kartlegging ble brutt (igjen).

Hva er nytt i versjon 0.4.3.2:

• fix Linux standardverdier i dokumentasjonen.
• dokument PDBxx kommandoer.
• mindre støy på VIM kommandolinje.
• bedre synliggjøring av gjeldende linje.

Hva er nytt i versjon 0.4.2:

• PDBEval (tilordnet nøkkel?) Til å be om en Python uttrykk for å vurdere.
• PDBClear (kartlagt til B-tasten) for å fjerne en tidligere innstilt stoppunkt.
• åpne ny fane bare hvis det er allerede en åpnet filen i VIM.
• nært vimpdb buffer når fortsett (c), reset (x) eller slutte (q).
• lanseringen VIM server også hvis en annen server kjører.

Hva er nytt i versjon 0.4.1.2:

• polish dokumentasjon.

Hva er nytt i versjon 0.3.8:

• fix: noen versjoner av VIM trenger explicite import selv selv om de fleste ikke. (Http://github.com/gotcha/vimpdb/issues/issue/5)

Hva er nytt i versjon 0.3.7:

• fix: kunne ikke gå & quot; ned & quot; etter bytte fra PDB til vimpdb etter å ha gått & quot; opp & quot; (Http://github.com/gotcha/vimpdb/issues/issue/4)

Hva er nytt i versjon 0.3.6:

• fix: & quot; fortsette & quot; Kommandoen ble brutt etter at stoppunkt er satt (http://github.com/gotcha/vimpdb/issues/issue/3)
• fix: Nøkkel kartlegginger ble igjen ødelagt etter & quot; fortsette & quot; kommando. (Http://github.com/gotcha/vimpdb/issues/issue/2)

Hva er nytt i versjon 0.3.5:

• bedre dokumentasjon, spesielt for Windows
• fix fangst på produksjonen som ble ødelagt for Python 2.5 og 2.6
• Windows kompatibilitet (minst XP)

Krav

• Vim
• Python