7.20 `readline` -- Interfaccia a GNU readline

Disponibilità: Unix.

Il modulo readline definisce un numero di funzioni usate o direttamente o dal modulo rlcompleter per facilitare il completamento e la lettura/scrittura del file storico da parte dell'interprete Python.

Il modulo readline definisce le seguenti funzioni:

parse_and_bind( string): Analizza ed esegue una singola riga di un file di inizializzazione readline.

get_line_buffer( ): Restituisce i contenuti correnti del buffer di riga.

insert_text( string): Inserisce del testo nella riga di comando.

read_init_file( [filename]): Analizza un file di inizializzazione readline. Il filename predefinito è l'ultimo filename usato.

read_history_file( [filename]): Carica un file storico della readline. Il nome del file predefinito è ~/.history.

write_history_file( [filename]): Salva un file storico della readline. Il nome del file predefinito è ~/.history.

clear_history( ): Cancella lo storico corrente. (Nota: questa funzione non è disponibile se la versione della GNU readline installata non la supporta.) Nuovo nella versione 2.4.

get_history_length( ): Restituisce la lunghezza desiderata del file dello storico. Valori negativi implicano una dimensione illimitata del file dello storico.

set_history_length( length): Imposta il numero di righe da salvare nel file dello storico. write_history_file() sfrutta questo valore per troncare il file dello storico durante il salvataggio. Valori negativi implicano una dimensione illimitata del file dello storico.

get_current_history_length( ): Restituisce il numero di righe immagazzinate al momento nello storico. Questo è differente da get_history_length(), che restituisce il massimo numero di righe che possono essere scritte nel file dello storico. Nuovo nella versione 2.3.

get_history_item( index): Restituisce il contenuto corrente degli elementi dello storico in index. Nuovo nella versione 2.3.

redisplay( ): Cambia la visualizzazione sullo schermo per riflettere il contenuto corrente del buffer di riga. Nuovo nella versione 2.3.

set_startup_hook( [function]): Imposta o rimuove la funzione di startup_hook. Se function viene specificata, verrà usata come nuova funzione di startup_hook; se viene omessa o è None, ogni funzione di aggancio già installata viene rimossa. La funzione di startup_hook viene chiamata senza argomenti appena prima che readline stampi il primo prompt.

set_pre_input_hook( [function]): Imposta o rimuove la funzione di pre_input_hook. Se function viene specificata, sarà usata come nuova funzione di pre_input_hook; se è omessa o è None, ogni funzione di aggancio già installata viene rimossa. La funzione di startup_hook viene chiamata senza argomenti dopo che il primo prompt è stato stampato e appena prima che readline inizi la lettura dei caratteri in input.

set_completer( [function]): Imposta o rimuove la funzione di completamento. Se function viene specificata, sarà usata come nuova funzione di completamento; se viene omessa o è None, ogni funzione di completamento già installata viene rimossa. La funzione di completamento viene chiamata come function(text, state), con state in 0, 1, 2, ..., finché non restituisce un valore diverso da una stringa. Dovrebbe restituire il prossimo completamento possibile che comincia con text.

get_completer( ): Restituisce la funzione di completamento, o None se non è stata impostata alcuna funzione di completamento. Nuovo nella versione 2.3.

get_begidx( ): Restituisce l'indice iniziale da cui partirebbe con il completamento tramite tab, readline.

get_endidx( ): Restituisce l'indice finale che aggiungerebbe con il completamento tramite tab, readline.

set_completer_delims( string): Imposta i delimitatori di parola di readline per il completamento tramite tab.

get_completer_delims( ): Restituisce i delimitatori di parola di readline per il completamento tramite tab.

add_history( line): Aggiunge una riga allo storico nel buffer, come se fosse l'ultima riga digitata.

Vedete anche:

Modulo rlcompleter:: Completamento degli identificatori Python al prompt interattivo.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.

7.20 readline -- Interfaccia a GNU readline

7.20 `readline` -- Interfaccia a GNU readline