1 /* readline.c --- line editing support for Guile */
3 /* Copyright (C) 1997,1999 Free Software Foundation, Inc.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2, or (at your option)
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this software; see the file COPYING. If not, write to
17 * the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307 USA
22 /* Software engineering face-lift by Greg J. Badros, 11-Dec-1999,
23 gjb@cs.washington.edu, http://www.cs.washington.edu/homes/gjb */
27 #include "libguile/_scm.h"
28 #if defined (HAVE_RL_GETC_FUNCTION)
29 #include "libguile/libguile.h"
30 #include "libguile/gh.h"
31 #include "libguile/iselect.h"
33 #include <readline/readline.h>
34 #include <readline/history.h>
37 #include "libguile/scm_validate.h"
40 scm_option scm_readline_opts
[] = {
41 { SCM_OPTION_BOOLEAN
, "history-file", 1,
42 "Use history file." },
43 { SCM_OPTION_INTEGER
, "history-length", 200,
45 { SCM_OPTION_INTEGER
, "bounce-parens", 500,
46 "Time (ms) to show matching opening parenthesis (0 = off)."}
49 extern void stifle_history (int max
);
51 SCM_DEFINE (scm_readline_options
, "readline-options-interface", 0, 1, 0,
54 #define FUNC_NAME s_scm_readline_options
56 SCM ans
= scm_options (setting
,
58 SCM_N_READLINE_OPTIONS
,
60 stifle_history (SCM_HISTORY_LENGTH
);
70 char *new = malloc (len
+ 1);
74 #endif /* HAVE_STRDUP */
76 #ifndef HAVE_RL_CLEANUP_AFTER_SIGNAL
78 /* These are readline functions added in release 2.3. They will work
79 * together with readline-2.1 and 2.2. (The readline interface is
80 * disabled for earlier releases.)
81 * They are declared static; if we want to use them elsewhere, then
82 * we need external declarations for them, but at the moment, I don't
83 * think anything else in Guile ought to use these.
86 extern void _rl_clean_up_for_exit ();
87 extern void _rl_kill_kbd_macro ();
88 extern int _rl_init_argument ();
91 rl_cleanup_after_signal ()
93 #ifdef HAVE_RL_CLEAR_SIGNALS
94 _rl_clean_up_for_exit ();
96 (*rl_deprep_term_function
) ();
97 #ifdef HAVE_RL_CLEAR_SIGNALS
100 rl_pending_input
= 0;
104 rl_free_line_state ()
106 register HIST_ENTRY
*entry
;
110 entry
= current_history ();
112 entry
->data
= (char *)NULL
;
114 _rl_kill_kbd_macro ();
116 _rl_init_argument ();
119 #endif /* !HAVE_RL_CLEANUP_AFTER_SIGNAL */
122 static SCM input_port
;
123 static SCM before_read
;
126 current_input_getc (FILE *in
)
129 if (promptp
&& SCM_NIMP (before_read
))
131 scm_apply (before_read
, SCM_EOL
, SCM_EOL
);
134 ans
= scm_getc (input_port
);
145 static int in_readline
= 0;
147 static scm_mutex_t reentry_barrier_mutex
;
150 static SCM
internal_readline (SCM text
);
151 static SCM
handle_error (void *data
, SCM tag
, SCM args
);
152 static void reentry_barrier ();
155 SCM_DEFINE (scm_readline
, "%readline", 0, 4, 0,
156 (SCM text
, SCM inp
, SCM outp
, SCM read_hook
),
158 #define FUNC_NAME s_scm_readline
164 before_read
= SCM_BOOL_F
;
166 if (!SCM_UNBNDP (text
))
168 if (!(SCM_NIMP (text
) && SCM_STRINGP (text
)))
171 scm_wrong_type_arg (s_scm_readline
, SCM_ARG1
, text
);
173 SCM_COERCE_SUBSTR (text
);
176 if (!((SCM_UNBNDP (inp
) && SCM_NIMP (scm_cur_inp
) && SCM_OPINFPORTP (inp
))
177 || SCM_NIMP (inp
) && SCM_OPINFPORTP (inp
)))
180 scm_misc_error (s_scm_readline
,
181 "Input port is not open or not a file port",
185 if (!((SCM_UNBNDP (outp
) && SCM_NIMP (scm_cur_outp
) && SCM_OPINFPORTP (outp
))
186 || (SCM_NIMP (outp
) && SCM_OPOUTFPORTP (outp
))))
189 scm_misc_error (s_scm_readline
,
190 "Output port is not open or not a file port",
194 if (!(SCM_UNBNDP (read_hook
) || SCM_FALSEP (read_hook
)))
196 if (!(SCM_NFALSEP (scm_thunk_p (read_hook
))))
199 scm_wrong_type_arg (s_scm_readline
, SCM_ARG4
, read_hook
);
201 before_read
= read_hook
;
204 scm_readline_init_ports (inp
, outp
);
206 ans
= scm_internal_catch (SCM_BOOL_T
,
207 (scm_catch_body_t
) internal_readline
,
211 fclose (rl_instream
);
212 fclose (rl_outstream
);
225 /* We should rather use scm_mutex_try_lock when it becomes available */
226 scm_mutex_lock (&reentry_barrier_mutex
);
233 scm_mutex_unlock (&reentry_barrier_mutex
);
236 scm_misc_error (s_scm_readline
, "readline is not reentrant", SCM_EOL
);
240 handle_error (void *data
, SCM tag
, SCM args
)
242 rl_free_line_state ();
243 rl_cleanup_after_signal ();
244 fputc ('\n', rl_outstream
); /* We don't want next output on this line */
245 fclose (rl_instream
);
246 fclose (rl_outstream
);
248 scm_handle_by_throw (data
, tag
, args
);
249 return SCM_UNSPECIFIED
; /* never reached */
253 internal_readline (SCM text
)
257 char *prompt
= SCM_UNBNDP (text
) ? "" : SCM_CHARS (text
);
260 s
= readline (prompt
);
262 ret
= scm_makfrom0str (s
);
272 stream_from_fport (SCM port
, char *mode
, const char *subr
)
277 fd
= dup (((struct scm_fport
*) SCM_STREAM (port
))->fdes
);
284 f
= fdopen (fd
, mode
);
295 scm_readline_init_ports (SCM inp
, SCM outp
)
297 if (SCM_UNBNDP (inp
))
300 if (SCM_UNBNDP (outp
))
303 if (!(SCM_NIMP (inp
) && SCM_OPINFPORTP (inp
))) {
305 "Input port is not open or not a file port",
309 if (!(SCM_NIMP (outp
) && SCM_OPOUTFPORTP (outp
))) {
311 "Output port is not open or not a file port",
316 rl_instream
= stream_from_fport (inp
, "r", s_scm_readline
);
317 rl_outstream
= stream_from_fport (outp
, "w", s_scm_readline
);
322 SCM_DEFINE (scm_add_history
, "add-history", 1, 0, 0,
325 #define FUNC_NAME s_scm_add_history
328 SCM_VALIDATE_STRING (1,text
);
329 SCM_COERCE_SUBSTR (text
);
331 s
= SCM_CHARS (text
);
332 add_history (strdup (s
));
334 return SCM_UNSPECIFIED
;
339 SCM_DEFINE (scm_read_history
, "read-history", 1, 0, 0,
342 #define FUNC_NAME s_scm_read_history
344 SCM_VALIDATE_STRING (1,file
);
345 return SCM_NEGATE_BOOL(read_history (SCM_ROCHARS (file
)));
350 SCM_DEFINE (scm_write_history
, "write-history", 1, 0, 0,
353 #define FUNC_NAME s_scm_write_history
355 SCM_VALIDATE_STRING (1,file
);
356 return SCM_NEGATE_BOOL(write_history (SCM_ROCHARS (file
)));
361 SCM_DEFINE (scm_filename_completion_function
, "filename-completion-function", 2, 0, 0,
362 (SCM text
, SCM continuep
),
364 #define FUNC_NAME s_scm_filename_completion_function
368 SCM_VALIDATE_STRING (1,text
);
369 SCM_COERCE_SUBSTR (text
);
370 s
= filename_completion_function (SCM_CHARS (text
), SCM_NFALSEP (continuep
));
371 ans
= scm_makfrom0str (s
);
378 * The following has been modified from code contributed by
379 * Andrew Archibald <aarchiba@undergrad.math.uwaterloo.ca>
382 SCM scm_readline_completion_function_var
;
385 completion_function (char *text
, int continuep
)
387 SCM compfunc
= SCM_CDR (scm_readline_completion_function_var
);
390 if (SCM_FALSEP (compfunc
))
391 return NULL
; /* #f => completion disabled */
394 SCM t
= scm_makfrom0str (text
);
395 SCM c
= continuep
? SCM_BOOL_T
: SCM_BOOL_F
;
396 res
= scm_apply (compfunc
, SCM_LIST2 (t
, c
), SCM_EOL
);
398 if (SCM_FALSEP (res
))
401 if (!(SCM_NIMP (res
) && SCM_STRINGP (res
)))
402 scm_misc_error (s_scm_readline
,
403 "Completion function returned bogus value: %S",
405 SCM_COERCE_SUBSTR (res
);
406 return strdup (SCM_CHARS (res
));
410 /*Bouncing parenthesis (reimplemented by GH, 11/23/98, since readline is strict gpl)*/
412 static void match_paren(int x
, int k
);
413 static int find_matching_paren(int k
);
414 static void init_bouncing_parens();
417 init_bouncing_parens()
419 if(strncmp(rl_get_keymap_name(rl_get_keymap()), "vi", 2)) {
420 rl_bind_key(')', match_paren
);
421 rl_bind_key(']', match_paren
);
422 rl_bind_key('}', match_paren
);
427 find_matching_paren(int k
)
431 int end_parens_found
= 0;
433 /* Choose the corresponding opening bracket. */
434 if (k
== ')') c
= '(';
435 else if (k
== ']') c
= '[';
436 else if (k
== '}') c
= '{';
438 for (i
=rl_point
-2; i
>=0; i
--)
440 /* Is the current character part of a character literal? */
442 && rl_line_buffer
[i
- 1] == '\\'
443 && rl_line_buffer
[i
- 2] == '#')
445 else if (rl_line_buffer
[i
] == k
)
447 else if (rl_line_buffer
[i
] == '"')
449 /* Skip over a string literal. */
450 for (i
--; i
>= 0; i
--)
451 if (rl_line_buffer
[i
] == '"'
453 && rl_line_buffer
[i
- 1] == '\\'))
456 else if (rl_line_buffer
[i
] == c
)
458 if (end_parens_found
==0) return i
;
459 else --end_parens_found
;
466 match_paren(int x
, int k
)
470 struct timeval timeout
;
473 if (!SCM_READLINE_BOUNCE_PARENS
)
476 /* Did we just insert a quoted paren? If so, then don't bounce. */
477 if (rl_point
- 1 >= 1
478 && rl_line_buffer
[rl_point
- 2] == '\\')
481 tmp
= 1000 * SCM_READLINE_BOUNCE_PARENS
;
482 timeout
.tv_sec
= tmp
/ 1000000;
483 timeout
.tv_usec
= tmp
% 1000000;
485 FD_SET(fileno(rl_instream
), &readset
);
489 rl_point
= find_matching_paren(k
);
492 scm_internal_select(1, &readset
, NULL
, NULL
, &timeout
);
502 #include "readline.x"
503 scm_readline_completion_function_var
504 = scm_sysintern ("*readline-completion-function*", SCM_BOOL_F
);
505 rl_getc_function
= current_input_getc
;
506 rl_redisplay_function
= redisplay
;
507 rl_completion_entry_function
= (Function
*) completion_function
;
508 rl_basic_word_break_characters
= "\t\n\"'`;()";
509 rl_readline_name
= "Guile";
512 scm_mutex_init (&reentry_barrier_mutex
);
514 scm_init_opts (scm_readline_options
,
516 SCM_N_READLINE_OPTIONS
);
517 init_bouncing_parens();
518 scm_add_feature ("readline");