python readline_16.8. readline — GNU readline 接口

16.8.readline — GNU readline 接口¶

The readline module defines a number of functions to facilitate

completion and reading/writing of history files from the Python interpreter.

This module can be used directly, or via the rlcompleter module, which

supports completion of Python identifiers at the interactive prompt. Settings

made using this module affect the behaviour of both the interpreter’s

interactive prompt and the prompts offered by the raw_input() and

input() built-in functions.

注解

The underlying Readline library API may be implemented by

the libedit library instead of GNU readline.

On MacOS X the readline module detects which library is being used

at run time.

libedit 所用的配置文件与 GNU readline 的不同。如果你要在程序中载入配置字符串你可以在 readline.__doc__ 中检测文本 “libedit” 来区分 GNU readline 和 libedit。

Readline keybindings may be configured via an initialization file, typically

.inputrc in your home directory. See Readline Init File

in the GNU Readline manual for information about the format and

allowable constructs of that file, and the capabilities of the

Readline library in general.

16.8.1.初始化文件¶

下列函数与初始化文件和用户配置有关：

readline.parse_and_bind(string)¶

执行在 string 参数中提供的初始化行。此函数会调用底层库中的 rl_parse_and_bind()。

readline.read_init_file([filename])¶

执行一个 readline 初始化文件。默认文件名为最近所使用的文件名。此函数会调用底层库中的 rl_read_init_file()。

16.8.2.行缓冲区¶

下列函数会在行缓冲区上操作。

readline.get_line_buffer()¶

返回行缓冲区的当前内容 (底层库中的 rl_line_buffer)。

readline.insert_text(string)¶

将文本插入行缓冲区的当前游标位置。该函数会调用底层库中的 rl_insert_text()，但会忽略其返回值。

readline.redisplay()¶

改变屏幕的显示以反映行缓冲区的当前内容。该函数会调用底层库中的 rl_redisplay()。

16.8.3.历史文件¶

下列函数会在历史文件上操作：

readline.read_history_file([filename])¶

载入一个 readline 历史文件，并将其添加到历史列表。默认文件名为 ~/.history。此函数会调用底层库中的 read_history()。

readline.write_history_file([filename])¶

将历史列表保存为 readline 历史文件，覆盖任何现有文件。默认文件名为 ~/.history。此函数会调用底层库中的 write_history()。

readline.get_history_length()¶

readline.set_history_length(length)¶

设置或返回需要保存到历史文件的行数。 write_history_file() 函数会通过调用底层库中的 history_truncate_file() 以使用该值来截取历史文件。负值意味着不限制历史文件的大小。

16.8.4.历史列表¶

以下函数会在全局历史列表上操作：

readline.clear_history()¶

清除当前历史。此函数会调用底层库的 clear_history()。此 Python 函数仅当 Python 编译包带有支持此功能的库版本时才会存在。

2.4 新版功能.

readline.get_current_history_length()¶

返回历史列表的当前项数。（此函数不同于 get_history_length()，后者是返回将被写入历史文件的最大行数。）

2.3 新版功能.

readline.get_history_item(index)¶

返回序号为 index 的历史条目的当前内容。条目序号从一开始。此函数会调用底层库中的 history_get()。

2.3 新版功能.

readline.remove_history_item(pos)¶

从历史列表中移除指定位置上的历史条目。条目位置从零开始。此函数会调用底层库中的 remove_history()。

2.4 新版功能.

readline.replace_history_item(pos, line)¶

将指定位置上的历史条目替换为 line。条目位置从零开始。此函数会调用底层库中的 replace_history_entry()。

2.4 新版功能.

readline.add_history(line)¶

将 line 添加到历史缓冲区，相当于是最近输入的一行。此函数会调用底层库中的 add_history()。

16.8.5.启动钩子¶

2.3 新版功能.

readline.set_startup_hook([function])¶

设置或移除底层库的 rl_startup_hook 回调所发起调用的函数。如果指定了 function，它将被用作新的钩子函数；如果省略或为 None，任何已安装的函数将被移除。钩子函数将在 readline 打印第一个提示信息之前不带参数地被调用。

readline.set_pre_input_hook([function])¶

设置或移除底层库的 rl_pre_input_hook 回调所发起调用的函数。如果指定了 function，它将被用作新的钩子函数；如果省略或为 None，任何已安装的函数将被移除。钩子函数将在打印第一个提示信息之后、readline 开始读取输入字符之前不带参数地被调用。此函数仅当 Python 编译包带有支持此功能的库版本时才会存在。

16.8.6.Completion¶

以下函数与自定义单词补全函数的实现有关。这通常使用 Tab 键进行操作，能够提示并自动补全正在输入的单词。默认情况下，Readline 设置为由 rlcompleter 来补全交互模式解释器的 Python 标识符。如果 readline 模块要配合自定义的补全函数来使用，则需要设置不同的单词分隔符。

readline.set_completer([function])¶

设置或移除补全函数。如果指定了 function，它将被用作新的补全函数；如果省略或为 None，任何已安装的补全函数将被移除。补全函数的调用形式为 function(text, state)，其中 state 为 0, 1, 2, …, 直至其返回一个非字符串值。它应当返回下一个以 text 开头的候选补全内容。

已安装的补全函数将由传递给底层库中 rl_completion_matches() 的 entry_func 回调函数来发起调用。 text 字符串来自于底层库中 rl_attempted_completion_function 回调函数的第一个形参。

readline.get_completer()¶

获取补全函数，如果没有设置补全函数则返回 None。

2.3 新版功能.

readline.get_completion_type()¶

获取正在尝试的补全类型。此函数会将底层库中的 rl_completion_type 变量作为一个整数返回。

2.6 新版功能.

readline.get_begidx()¶

readline.get_endidx()¶

获取补全域的开始和结束序号。这些序号就是传给底层库中 rl_attempted_completion_function 回调函数的 start 和 end 参数。

readline.set_completer_delims(string)¶

readline.get_completer_delims()¶

设置或获取补全的单词分隔符。此分隔符确定了要考虑补全的单词的开始和结束位置（补全域）。这些函数会访问底层库的 rl_completer_word_break_characters 变量。

readline.set_completion_display_matches_hook([function])¶

设置或移除补全显示函数。如果指定了 function，它将被用作新的补全显示函数；如果省略或为 None，任何已安装的补全显示函数将被移除。此函数会设置或清除底层库的 rl_completion_display_matches_hook 回调函数。补全显示函数会在每次需要显示匹配项时以 function(substitution, [matches], longest_match_length) 的形式被调用。

2.6 新版功能.

16.8.7.示例¶

The following example demonstrates how to use the readline module’s

history reading and writing functions to automatically load and save a history

file named .pyhist from the user’s home directory. The code below would

normally be executed automatically during interactive sessions from the user’s

PYTHONSTARTUP file.

import os

import readline

histfile = os.path.join(os.path.expanduser("~"), ".pyhist")

try:

readline.read_history_file(histfile)

# default history len is -1 (infinite), which may grow unruly

readline.set_history_length(1000)

except IOError:

pass

import atexit

atexit.register(readline.write_history_file, histfile)

del os, histfile

import code

import readline

import atexit

import os

class HistoryConsole(code.InteractiveConsole):

def __init__(self, locals=None, filename="",

histfile=os.path.expanduser("~/.console-history")):

code.InteractiveConsole.__init__(self, locals, filename)

self.init_history(histfile)

def init_history(self, histfile):

readline.parse_and_bind("tab: complete")

if hasattr(readline, "read_history_file"):

try:

readline.read_history_file(histfile)

except IOError:

pass

atexit.register(self.save_history, histfile)

def save_history(self, histfile):

readline.set_history_length(1000)

readline.write_history_file(histfile)

python readline_16.8. readline — GNU readline 接口 — Python 2.7.18 文档相关推荐

Python实现识别html文本内容并截图放入word文档
需求: excel文件中存放了很多html标签文本,需要把文本内容在浏览器中打开将内容截图,放入doc文档保存. 手动过程需要逐条手动处理 1. 从excel表格中复制标签文本内容 <div& ...
python处理图片文件_python 学习（二）处理图片、TXT文档
一.尝试实现场景:将一个txt文档内容读到程序的数组内 1.新建一个文档 array.txt,写入内容 ,如: 2.使用命令行读取: 1)在上述新建文档位置相同目录下打开命令提示窗 2)打开文件,读入 ...
python的web抓取_python实现从web抓取文档的方法
本文实例讲述了Python实现从Web的一个URL中抓取文档的方法,分享给大家供大家参考.具体方法分析如下: 实例代码如下: import urllib doc = urllib.urlopen(&q ...
python写excel标记文字颜色_python3使用xlwt时写入文档字体颜色和边框样式
转自:https://www.cnblogs.com/xiaodingdong/p/8012282.html 可借鉴的网址:https://www.programcreek.com/python/ex ...
python win32转pdf 横版_使用Python3将word文档和pdf电子书进行格式互转(兼容Windows/Linux)...
一些重要文档格式之间的互转在目前显得尤为重要,pdf作为通用格式在现在各个平台上兼容性是最好的,所以写python脚本将这些word文档批量转换pdf是最好的解决方案. 由于windows系统对于wo ...
python根据模板生成pdf文件_程序生成word与PDF文档的方法(python)
程序导出word文档的方法将web/html内容导出为world文档,再java中有很多解决方案,比如使用Jacob.Apache POI.Java2Word.iText等各种方式,以及使用free ...
python批量读取图片并复制入word_提取出 Word 文档里的图片并利用 python 批量转换格式...
日常工作中,你是否遇到过这样的场景,领导发来一份 Word 文档,要求你将文档中的图片存储到一个文件夹内,并且还要将图片都改成 .jpg 或者 .png,你会怎么办?你是不是一边内心崩溃,一边开始一张 ...
python读取文件特定内容_利用python代码获取文件特定的内容，并保存为文档
import os.path import re # 1 遍历指定目录,显示目录下的所有文件名 def each_file(file_path): path_dir = os.listdir(file ...
python2.7读取csv文件_13.1. csv — CSV 文件读写 — Python 2.7.18 文档
13.1.csv - CSV 文件读写¶ 2.3 新版功能. The so-called CSV (Comma Separated Values) format is the most common ...

python readline_16.8. readline — GNU readline 接口 — Python 2.7.18 文档

python readline_16.8. readline — GNU readline 接口 — Python 2.7.18 文档相关推荐

最新文章

热门文章