cpython/Modules/clinic/readline.c.h

695 lines
20 KiB
C
Raw Normal View History

/*[clinic input]
preserve
[clinic start generated code]*/
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
# include "pycore_gc.h" // PyGC_Head
# include "pycore_runtime.h" // _Py_ID()
#endif
PyDoc_STRVAR(readline_parse_and_bind__doc__,
"parse_and_bind($module, string, /)\n"
"--\n"
"\n"
"Execute the init line provided in the string argument.");
#define READLINE_PARSE_AND_BIND_METHODDEF \
{"parse_and_bind", (PyCFunction)readline_parse_and_bind, METH_O, readline_parse_and_bind__doc__},
PyDoc_STRVAR(readline_read_init_file__doc__,
"read_init_file($module, filename=None, /)\n"
"--\n"
"\n"
"Execute a readline initialization file.\n"
"\n"
"The default filename is the last filename used.");
#define READLINE_READ_INIT_FILE_METHODDEF \
{"read_init_file", _PyCFunction_CAST(readline_read_init_file), METH_FASTCALL, readline_read_init_file__doc__},
static PyObject *
readline_read_init_file_impl(PyObject *module, PyObject *filename_obj);
static PyObject *
readline_read_init_file(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *filename_obj = Py_None;
if (!_PyArg_CheckPositional("read_init_file", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
filename_obj = args[0];
skip_optional:
return_value = readline_read_init_file_impl(module, filename_obj);
exit:
return return_value;
}
PyDoc_STRVAR(readline_read_history_file__doc__,
"read_history_file($module, filename=None, /)\n"
"--\n"
"\n"
"Load a readline history file.\n"
"\n"
"The default filename is ~/.history.");
#define READLINE_READ_HISTORY_FILE_METHODDEF \
{"read_history_file", _PyCFunction_CAST(readline_read_history_file), METH_FASTCALL, readline_read_history_file__doc__},
static PyObject *
readline_read_history_file_impl(PyObject *module, PyObject *filename_obj);
static PyObject *
readline_read_history_file(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *filename_obj = Py_None;
if (!_PyArg_CheckPositional("read_history_file", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
filename_obj = args[0];
skip_optional:
return_value = readline_read_history_file_impl(module, filename_obj);
exit:
return return_value;
}
PyDoc_STRVAR(readline_write_history_file__doc__,
"write_history_file($module, filename=None, /)\n"
"--\n"
"\n"
"Save a readline history file.\n"
"\n"
"The default filename is ~/.history.");
#define READLINE_WRITE_HISTORY_FILE_METHODDEF \
{"write_history_file", _PyCFunction_CAST(readline_write_history_file), METH_FASTCALL, readline_write_history_file__doc__},
static PyObject *
readline_write_history_file_impl(PyObject *module, PyObject *filename_obj);
static PyObject *
readline_write_history_file(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *filename_obj = Py_None;
if (!_PyArg_CheckPositional("write_history_file", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
filename_obj = args[0];
skip_optional:
return_value = readline_write_history_file_impl(module, filename_obj);
exit:
return return_value;
}
#if defined(HAVE_RL_APPEND_HISTORY)
PyDoc_STRVAR(readline_append_history_file__doc__,
"append_history_file($module, nelements, filename=None, /)\n"
"--\n"
"\n"
"Append the last nelements items of the history list to file.\n"
"\n"
"The default filename is ~/.history.");
#define READLINE_APPEND_HISTORY_FILE_METHODDEF \
{"append_history_file", _PyCFunction_CAST(readline_append_history_file), METH_FASTCALL, readline_append_history_file__doc__},
static PyObject *
readline_append_history_file_impl(PyObject *module, int nelements,
PyObject *filename_obj);
static PyObject *
readline_append_history_file(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
int nelements;
PyObject *filename_obj = Py_None;
if (!_PyArg_CheckPositional("append_history_file", nargs, 1, 2)) {
goto exit;
}
nelements = _PyLong_AsInt(args[0]);
if (nelements == -1 && PyErr_Occurred()) {
goto exit;
}
if (nargs < 2) {
goto skip_optional;
}
filename_obj = args[1];
skip_optional:
return_value = readline_append_history_file_impl(module, nelements, filename_obj);
exit:
return return_value;
}
#endif /* defined(HAVE_RL_APPEND_HISTORY) */
PyDoc_STRVAR(readline_set_history_length__doc__,
"set_history_length($module, length, /)\n"
"--\n"
"\n"
"Set the maximal number of lines which will be written to the history file.\n"
"\n"
"A negative length is used to inhibit history truncation.");
#define READLINE_SET_HISTORY_LENGTH_METHODDEF \
{"set_history_length", (PyCFunction)readline_set_history_length, METH_O, readline_set_history_length__doc__},
static PyObject *
readline_set_history_length_impl(PyObject *module, int length);
static PyObject *
readline_set_history_length(PyObject *module, PyObject *arg)
{
PyObject *return_value = NULL;
int length;
length = _PyLong_AsInt(arg);
if (length == -1 && PyErr_Occurred()) {
goto exit;
}
return_value = readline_set_history_length_impl(module, length);
exit:
return return_value;
}
PyDoc_STRVAR(readline_get_history_length__doc__,
"get_history_length($module, /)\n"
"--\n"
"\n"
"Return the maximum number of lines that will be written to the history file.");
#define READLINE_GET_HISTORY_LENGTH_METHODDEF \
{"get_history_length", (PyCFunction)readline_get_history_length, METH_NOARGS, readline_get_history_length__doc__},
static PyObject *
readline_get_history_length_impl(PyObject *module);
static PyObject *
readline_get_history_length(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_history_length_impl(module);
}
PyDoc_STRVAR(readline_set_completion_display_matches_hook__doc__,
"set_completion_display_matches_hook($module, function=None, /)\n"
"--\n"
"\n"
"Set or remove the completion display function.\n"
"\n"
"The function is called as\n"
" function(substitution, [matches], longest_match_length)\n"
"once each time matches need to be displayed.");
#define READLINE_SET_COMPLETION_DISPLAY_MATCHES_HOOK_METHODDEF \
{"set_completion_display_matches_hook", _PyCFunction_CAST(readline_set_completion_display_matches_hook), METH_FASTCALL, readline_set_completion_display_matches_hook__doc__},
static PyObject *
readline_set_completion_display_matches_hook_impl(PyObject *module,
PyObject *function);
static PyObject *
readline_set_completion_display_matches_hook(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *function = Py_None;
if (!_PyArg_CheckPositional("set_completion_display_matches_hook", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
function = args[0];
skip_optional:
return_value = readline_set_completion_display_matches_hook_impl(module, function);
exit:
return return_value;
}
PyDoc_STRVAR(readline_set_startup_hook__doc__,
"set_startup_hook($module, function=None, /)\n"
"--\n"
"\n"
"Set or remove the function invoked by the rl_startup_hook callback.\n"
"\n"
"The function is called with no arguments just\n"
"before readline prints the first prompt.");
#define READLINE_SET_STARTUP_HOOK_METHODDEF \
{"set_startup_hook", _PyCFunction_CAST(readline_set_startup_hook), METH_FASTCALL, readline_set_startup_hook__doc__},
static PyObject *
readline_set_startup_hook_impl(PyObject *module, PyObject *function);
static PyObject *
readline_set_startup_hook(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *function = Py_None;
if (!_PyArg_CheckPositional("set_startup_hook", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
function = args[0];
skip_optional:
return_value = readline_set_startup_hook_impl(module, function);
exit:
return return_value;
}
#if defined(HAVE_RL_PRE_INPUT_HOOK)
PyDoc_STRVAR(readline_set_pre_input_hook__doc__,
"set_pre_input_hook($module, function=None, /)\n"
"--\n"
"\n"
"Set or remove the function invoked by the rl_pre_input_hook callback.\n"
"\n"
"The function is called with no arguments after the first prompt\n"
"has been printed and just before readline starts reading input\n"
"characters.");
#define READLINE_SET_PRE_INPUT_HOOK_METHODDEF \
{"set_pre_input_hook", _PyCFunction_CAST(readline_set_pre_input_hook), METH_FASTCALL, readline_set_pre_input_hook__doc__},
static PyObject *
readline_set_pre_input_hook_impl(PyObject *module, PyObject *function);
static PyObject *
readline_set_pre_input_hook(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *function = Py_None;
if (!_PyArg_CheckPositional("set_pre_input_hook", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
function = args[0];
skip_optional:
return_value = readline_set_pre_input_hook_impl(module, function);
exit:
return return_value;
}
#endif /* defined(HAVE_RL_PRE_INPUT_HOOK) */
PyDoc_STRVAR(readline_get_completion_type__doc__,
"get_completion_type($module, /)\n"
"--\n"
"\n"
"Get the type of completion being attempted.");
#define READLINE_GET_COMPLETION_TYPE_METHODDEF \
{"get_completion_type", (PyCFunction)readline_get_completion_type, METH_NOARGS, readline_get_completion_type__doc__},
static PyObject *
readline_get_completion_type_impl(PyObject *module);
static PyObject *
readline_get_completion_type(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_completion_type_impl(module);
}
PyDoc_STRVAR(readline_get_begidx__doc__,
"get_begidx($module, /)\n"
"--\n"
"\n"
"Get the beginning index of the completion scope.");
#define READLINE_GET_BEGIDX_METHODDEF \
{"get_begidx", (PyCFunction)readline_get_begidx, METH_NOARGS, readline_get_begidx__doc__},
static PyObject *
readline_get_begidx_impl(PyObject *module);
static PyObject *
readline_get_begidx(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_begidx_impl(module);
}
PyDoc_STRVAR(readline_get_endidx__doc__,
"get_endidx($module, /)\n"
"--\n"
"\n"
"Get the ending index of the completion scope.");
#define READLINE_GET_ENDIDX_METHODDEF \
{"get_endidx", (PyCFunction)readline_get_endidx, METH_NOARGS, readline_get_endidx__doc__},
static PyObject *
readline_get_endidx_impl(PyObject *module);
static PyObject *
readline_get_endidx(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_endidx_impl(module);
}
PyDoc_STRVAR(readline_set_completer_delims__doc__,
"set_completer_delims($module, string, /)\n"
"--\n"
"\n"
"Set the word delimiters for completion.");
#define READLINE_SET_COMPLETER_DELIMS_METHODDEF \
{"set_completer_delims", (PyCFunction)readline_set_completer_delims, METH_O, readline_set_completer_delims__doc__},
PyDoc_STRVAR(readline_remove_history_item__doc__,
"remove_history_item($module, pos, /)\n"
"--\n"
"\n"
"Remove history item given by its zero-based position.");
#define READLINE_REMOVE_HISTORY_ITEM_METHODDEF \
{"remove_history_item", (PyCFunction)readline_remove_history_item, METH_O, readline_remove_history_item__doc__},
static PyObject *
readline_remove_history_item_impl(PyObject *module, int entry_number);
static PyObject *
readline_remove_history_item(PyObject *module, PyObject *arg)
{
PyObject *return_value = NULL;
int entry_number;
entry_number = _PyLong_AsInt(arg);
if (entry_number == -1 && PyErr_Occurred()) {
goto exit;
}
return_value = readline_remove_history_item_impl(module, entry_number);
exit:
return return_value;
}
PyDoc_STRVAR(readline_replace_history_item__doc__,
"replace_history_item($module, pos, line, /)\n"
"--\n"
"\n"
"Replaces history item given by its position with contents of line.\n"
"\n"
"pos is zero-based.");
#define READLINE_REPLACE_HISTORY_ITEM_METHODDEF \
{"replace_history_item", _PyCFunction_CAST(readline_replace_history_item), METH_FASTCALL, readline_replace_history_item__doc__},
static PyObject *
readline_replace_history_item_impl(PyObject *module, int entry_number,
PyObject *line);
static PyObject *
readline_replace_history_item(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
int entry_number;
PyObject *line;
if (!_PyArg_CheckPositional("replace_history_item", nargs, 2, 2)) {
goto exit;
}
entry_number = _PyLong_AsInt(args[0]);
if (entry_number == -1 && PyErr_Occurred()) {
goto exit;
}
if (!PyUnicode_Check(args[1])) {
_PyArg_BadArgument("replace_history_item", "argument 2", "str", args[1]);
goto exit;
}
if (PyUnicode_READY(args[1]) == -1) {
goto exit;
}
line = args[1];
return_value = readline_replace_history_item_impl(module, entry_number, line);
exit:
return return_value;
}
PyDoc_STRVAR(readline_add_history__doc__,
"add_history($module, string, /)\n"
"--\n"
"\n"
"Add an item to the history buffer.");
#define READLINE_ADD_HISTORY_METHODDEF \
{"add_history", (PyCFunction)readline_add_history, METH_O, readline_add_history__doc__},
PyDoc_STRVAR(readline_set_auto_history__doc__,
"set_auto_history($module, enabled, /)\n"
"--\n"
"\n"
"Enables or disables automatic history.");
#define READLINE_SET_AUTO_HISTORY_METHODDEF \
{"set_auto_history", (PyCFunction)readline_set_auto_history, METH_O, readline_set_auto_history__doc__},
static PyObject *
readline_set_auto_history_impl(PyObject *module,
int _should_auto_add_history);
static PyObject *
readline_set_auto_history(PyObject *module, PyObject *arg)
{
PyObject *return_value = NULL;
int _should_auto_add_history;
_should_auto_add_history = PyObject_IsTrue(arg);
if (_should_auto_add_history < 0) {
goto exit;
}
return_value = readline_set_auto_history_impl(module, _should_auto_add_history);
exit:
return return_value;
}
PyDoc_STRVAR(readline_get_completer_delims__doc__,
"get_completer_delims($module, /)\n"
"--\n"
"\n"
"Get the word delimiters for completion.");
#define READLINE_GET_COMPLETER_DELIMS_METHODDEF \
{"get_completer_delims", (PyCFunction)readline_get_completer_delims, METH_NOARGS, readline_get_completer_delims__doc__},
static PyObject *
readline_get_completer_delims_impl(PyObject *module);
static PyObject *
readline_get_completer_delims(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_completer_delims_impl(module);
}
PyDoc_STRVAR(readline_set_completer__doc__,
"set_completer($module, function=None, /)\n"
"--\n"
"\n"
"Set or remove the completer function.\n"
"\n"
"The function is called as function(text, state),\n"
"for state in 0, 1, 2, ..., until it returns a non-string.\n"
"It should return the next possible completion starting with \'text\'.");
#define READLINE_SET_COMPLETER_METHODDEF \
{"set_completer", _PyCFunction_CAST(readline_set_completer), METH_FASTCALL, readline_set_completer__doc__},
static PyObject *
readline_set_completer_impl(PyObject *module, PyObject *function);
static PyObject *
readline_set_completer(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
{
PyObject *return_value = NULL;
PyObject *function = Py_None;
if (!_PyArg_CheckPositional("set_completer", nargs, 0, 1)) {
goto exit;
}
if (nargs < 1) {
goto skip_optional;
}
function = args[0];
skip_optional:
return_value = readline_set_completer_impl(module, function);
exit:
return return_value;
}
PyDoc_STRVAR(readline_get_completer__doc__,
"get_completer($module, /)\n"
"--\n"
"\n"
"Get the current completer function.");
#define READLINE_GET_COMPLETER_METHODDEF \
{"get_completer", (PyCFunction)readline_get_completer, METH_NOARGS, readline_get_completer__doc__},
static PyObject *
readline_get_completer_impl(PyObject *module);
static PyObject *
readline_get_completer(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_completer_impl(module);
}
PyDoc_STRVAR(readline_get_history_item__doc__,
"get_history_item($module, index, /)\n"
"--\n"
"\n"
"Return the current contents of history item at one-based index.");
#define READLINE_GET_HISTORY_ITEM_METHODDEF \
{"get_history_item", (PyCFunction)readline_get_history_item, METH_O, readline_get_history_item__doc__},
static PyObject *
readline_get_history_item_impl(PyObject *module, int idx);
static PyObject *
readline_get_history_item(PyObject *module, PyObject *arg)
{
PyObject *return_value = NULL;
int idx;
idx = _PyLong_AsInt(arg);
if (idx == -1 && PyErr_Occurred()) {
goto exit;
}
return_value = readline_get_history_item_impl(module, idx);
exit:
return return_value;
}
PyDoc_STRVAR(readline_get_current_history_length__doc__,
"get_current_history_length($module, /)\n"
"--\n"
"\n"
"Return the current (not the maximum) length of history.");
#define READLINE_GET_CURRENT_HISTORY_LENGTH_METHODDEF \
{"get_current_history_length", (PyCFunction)readline_get_current_history_length, METH_NOARGS, readline_get_current_history_length__doc__},
static PyObject *
readline_get_current_history_length_impl(PyObject *module);
static PyObject *
readline_get_current_history_length(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_current_history_length_impl(module);
}
PyDoc_STRVAR(readline_get_line_buffer__doc__,
"get_line_buffer($module, /)\n"
"--\n"
"\n"
"Return the current contents of the line buffer.");
#define READLINE_GET_LINE_BUFFER_METHODDEF \
{"get_line_buffer", (PyCFunction)readline_get_line_buffer, METH_NOARGS, readline_get_line_buffer__doc__},
static PyObject *
readline_get_line_buffer_impl(PyObject *module);
static PyObject *
readline_get_line_buffer(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_get_line_buffer_impl(module);
}
#if defined(HAVE_RL_COMPLETION_APPEND_CHARACTER)
PyDoc_STRVAR(readline_clear_history__doc__,
"clear_history($module, /)\n"
"--\n"
"\n"
"Clear the current readline history.");
#define READLINE_CLEAR_HISTORY_METHODDEF \
{"clear_history", (PyCFunction)readline_clear_history, METH_NOARGS, readline_clear_history__doc__},
static PyObject *
readline_clear_history_impl(PyObject *module);
static PyObject *
readline_clear_history(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_clear_history_impl(module);
}
#endif /* defined(HAVE_RL_COMPLETION_APPEND_CHARACTER) */
PyDoc_STRVAR(readline_insert_text__doc__,
"insert_text($module, string, /)\n"
"--\n"
"\n"
"Insert text into the line buffer at the cursor position.");
#define READLINE_INSERT_TEXT_METHODDEF \
{"insert_text", (PyCFunction)readline_insert_text, METH_O, readline_insert_text__doc__},
PyDoc_STRVAR(readline_redisplay__doc__,
"redisplay($module, /)\n"
"--\n"
"\n"
"Change what\'s displayed on the screen to reflect contents of the line buffer.");
#define READLINE_REDISPLAY_METHODDEF \
{"redisplay", (PyCFunction)readline_redisplay, METH_NOARGS, readline_redisplay__doc__},
static PyObject *
readline_redisplay_impl(PyObject *module);
static PyObject *
readline_redisplay(PyObject *module, PyObject *Py_UNUSED(ignored))
{
return readline_redisplay_impl(module);
}
#ifndef READLINE_APPEND_HISTORY_FILE_METHODDEF
#define READLINE_APPEND_HISTORY_FILE_METHODDEF
#endif /* !defined(READLINE_APPEND_HISTORY_FILE_METHODDEF) */
#ifndef READLINE_SET_PRE_INPUT_HOOK_METHODDEF
#define READLINE_SET_PRE_INPUT_HOOK_METHODDEF
#endif /* !defined(READLINE_SET_PRE_INPUT_HOOK_METHODDEF) */
#ifndef READLINE_CLEAR_HISTORY_METHODDEF
#define READLINE_CLEAR_HISTORY_METHODDEF
#endif /* !defined(READLINE_CLEAR_HISTORY_METHODDEF) */
/*[clinic end generated code: output=9097fcb749c19e27 input=a9049054013a1b77]*/