*j@l
% S SK Jr S SKrS SKJr S SKJrJrJr S SK J
r
J r SSK J
r
JrJr SSKJrJrJr SS KJr \
R* rSS
KJrJrJrJr \" S 5 u r r r SHS jr SIS
jr \!" / SPSPSPSPSPSPSPSPSPSPSPSPSPSPS PS PS PS P\RD S :X a S!OS"QS#PS$PS%PS&PS'PS(PS)PS*PS+PS,PS-PS.PS/PS0PS1PS2PS3PS4PS5PS6PS7PS8PS9PS:P\#" \$\" S;S<5 5 V s/ s H o S=:w d M
U S>4PM sn - \#" \$\" S?S@5 5 V s/ s H o RK 5 ( d M U S>4PM sn - / SAQ- 5 r&SB\'SC' \" SDSE9 " SF SG5 5 r(gs sn f s sn f )J ) annotationsN)contextmanager) dataclassfieldfields) can_colorize
ANSIColors )commandsconsoleinput)wlen unbracketdisp_str)trace)CallbackSimpleContextManagerKeySpec CommandName c 0 n [ [ [ S5 5 H n[ X' M
[ [ [ S5 5 Vs/ s H o"R 5 ( d M UPM sn H n[
X' M
[ =U S' U S' U $ s snf )N
)mapchrrange
SYNTAX_SYMBOLisalnum SYNTAX_WORDSYNTAX_WHITESPACE)stcas 5/opt/alt/python313/lib64/python3.13/_pyrepl/reader.pymake_default_syntax_tabler& . sr B
eCj
! " S%*-
=-Aa-
= >**BtHr#w
I >s B
"B
c N 0 n [ [ 5 R 5 H n[ U[ 5 ( d M [ U[ 5 ( d M1 UR S R 5 ( d MU XUR ' XUR R SS5 ' M U $ )Nr _-)
varsr values
isinstancetype
issubclassCommand__name__islowerreplace)resultvs r% make_default_commandsr5 9 sy /1F
(^
"
"
$ a :a#9#9ajjm>S>S>U>U!"1:: 341::%%c3/ 0 % M )z\C-abeginning-of-line)z\C-bleft)z\C-c interrupt)z\C-ddelete)z\C-e end-of-line)z\C-fright)z\C-gcancel)z\C-h backspace)z\C-jaccept)z \r? )z\C-kz kill-line)z\C-lz clear-screen)z\C-mr? )z\C-tztranspose-characters)z\C-uzunix-line-discard)z\C-wzunix-word-rubout)z\C-x\C-uz
upcase-region)z\C-yyankwin32 ))z\C-zsuspend)z\M-b
backward-word)z\M-czcapitalize-word)z\M-dz kill-word)z\M-f forward-word)z\M-lz
downcase-word)z\M-tztranspose-words)z\M-uz upcase-word)z\M-yzyank-pop)z\M-- digit-arg)z\M-0rF )z\M-1rF )z\M-2rF )z\M-3rF )z\M-4rF )z\M-5rF )z\M-6rF )z\M-7rF )z\M-8rF )z\M-9rF )z\M-\nr? )z\\ self-insert)z \x1b[200~enable_bracketed_paste)z \x1b[201~disable_bracketed_paste)z\x03zctrl-c \rG r ))z\up)z\down)z\r8 )z
\C-\rD )z\r< )z \C-\rE )z \r: )z\x1b[3~r: )z \r> )z\M-\zbackward-kill-word)z\r; )z\r7 )z\help)z\z show-history)z\z
paste-mode)z\EOFend)z\EOHhome'tuple[tuple[KeySpec, CommandName], ...]default_keymapT)slotsc \ rS rSr% SrS\S' \" \S9rS\S' Sr S \S
' S r
S \S
' Sr S \S' Sr S \S' Sr
S \S' \" \S9rS\S' SrS \S' SrS\S' SrS \S ' SrS \S ' SrS \S ' SrS \S ' \" \S9rS!\S"' SrS#\S$' \" \S9rS%\S&' S'rS(\S)' \" SS*9rS+\S,' \" \S9r S-\S.' \" \S9r S\S/' \" SS*9r S0\S1' \" SS*9r S2\S3' \" SS*9r S2\S4' \" \S9r!S\S5' Sr"S \S6' Sr#S7\S8' \$ " S9 S:5 5 r%\" \%S9r&S:\S;' S_S< jr'S`S= jr(SaS> jr)\*SbS? j5 r+ScSdS@ jjr,ScSdSA jjr-ScSdSB jjr.ScSdSC jjr/SeSD jr0SfSE jr1SgShSF jjr2SiSG jr3SjSH jr4S_SI jr5SkSJ jr6SlSK jr7SmSL jr8S_SM jr9SnSN jr:S_SO jr;SoSP jrSpSR j5 r?S_SS jr@SqSrST jjrAS_SU jrBS_SV jrCSsSW jrDS_SX jrEStSuSY jjrFSvSZ jrGScSwS[ jjrHSxS\ jrISyS] jrJS^rKg)zReader a` The Reader class implements the bare bones of a command reader,
handling such details as editing and cursor motion. What it does
not support are such things as completion or history support -
these are implemented elsewhere.
Instance variables of note include:
* buffer:
A *list* (*not* a string at the moment :-) containing all the
characters that have been entered.
* console:
Hopefully encapsulates the OS dependent stuff.
* pos:
A 0-based index into `buffer' for where the insertion point
is.
* screeninfo:
Ahem. This list contains some info needed to move the
insertion point around reasonably efficiently.
* cxy, lxy:
the position of the insertion point in screen ...
* syntax_table:
Dictionary mapping characters to `syntax class'; read the
emacs docs to see what this means :-)
* commands:
Dictionary mapping command names to command classes.
* arg:
The emacs-style prefix argument. It will be None if no such
argument has been provided.
* dirty:
True if we need to refresh the display.
* kill_ring:
The emacs-style kill-ring; manipulated with yank & yank-pop
* ps1, ps2, ps3, ps4:
prompts. ps1 is the prompt for a one-line input; for a
multiline input it looks like:
ps2> first line of input goes here
ps3> second and further
ps3> lines get ps3
...
ps4> and the last one gets ps4
As with the usual top-level, you can set these to instances if
you like; str() will be called on them (once) at the beginning
of each command. Don't put really long or newline containing
strings here, please!
This is just the default policy; you can change it freely by
overriding get_prompt() (and indeed some standard subclasses
do).
* finished:
handle1 will set this to a true value if a command signals
that we're done.
zconsole.Consoler default_factory list[str]bufferr intposz->> strps1z/>> ps2z|.. ps3z\__ ps4zlist[list[str]] kill_ring msgN
int | NoneargFbooldirtyfinished
paste_modein_bracketed_pastezdict[str, type[Command]]r ztype[Command] | None last_commanddict[str, int] syntax_tablerB ztuple[tuple[str, str], ...]keymapinitinput.KeymapTranslator input_transz list[input.KeymapTranslator]input_trans_stackscreenlist[tuple[int, list[int]]]
screeninfotuple[int, int]cxylxyscheduled_commandsr Callback | Nonethreading_hookc \ rS rSr% SrS\S' \" \S9rS\S' \" SS9r S \S
' \" \S9r
S \S ' \" SS9r S
\S' \" SS9r S\S' \" SS9r
S\S' SrS\S' SS jrSS jrSS jrSrg)Reader.RefreshCache Fri rm rY r[ rw rr rx ry z list[int]line_end_offsetsr] r^ rz r{
dimensions invalidatedc . UR U l UR 5 U l UR 5 U l UR U l UR
U l UR R UR R 4U l SU l
g NF) rm copyrw ry r^ r{ r widthheightr r )selfreaderrw ry s r% update_cache Reader.RefreshCache.update_cache sk
'-&?&?D # ++-DK (oo /DO zzDH zzDH $nn 2 2FNN4I4I IDO $D r6 c U R ( a gUR R UR R 4nX R :g nUR
U R
:g nU=( d U( + $ r )r r r r r rm )r r r dimensions_changed
paste_changeds r% validReader.RefreshCache.valid s] --v~~/D/DDJ!+!> " 5 59P9P PM*;m< '>'R'RSW'X $F((// $ %,,77
( )(,(?(?(P(P% )*; <hh
# G FQJ(?4(G FG,-33D9 !%:HB4yHC#8# 7 # #q(#& )<)<< $)! -A-A-AB&.(.(8(8(>%
Av-44V<
j)!!1b'* &.
a< C!%!4!4V!< FJ!)$ E; [)J64<<;M;MMI +y AA~[Q,&-44V<
frwwu~ 56!!:{";< # !)a- 0D+,( F&1
!J.74<<;M;MM !,1, *, '2
5z$88 "66 #!" "6":: ! "188@ 27751F2F+G#H H4 OF$/0E1E$F$NMMM&) %%v}&=> !"6"7 8E"-.B.C"DK C F1 1G ;x %;;= 88 -
e$!!1b'* .
,,T:F
r6 c D [ U SS9n[ U SS9nU[ U5 4$ )zReturn a tuple with the prompt string and its visible length.
The prompt string has the zero-width brackets recognized by shells
(\x01 and \x02) removed. The length ignores anything between those
brackets as well as any ANSI escape sequences.
F)including_contentT)r r )r
out_promptvisible_prompts r% r Reader.process_prompt s, v?
"6TB4///r6 c Uc U R nU R nU R nUS- nUS: aM UR X1 [ 5 [ :w a- US- nUS: a" UR X1 [ 5 [ :w a M- US: aM UR X1 [ 5 [ :X a- US- nUS: a" UR X1 [ 5 [ :X a M- US- $ )zReturn the 0-based index of the word break preceding p most
immediately.
p defaults to self.pos; word boundaries are determined using
self.syntax_table.r
r )r^ rp r\ getr r pr" bs r% bow
Reader.bow s
9A
KK Q1fk2kA
FA 1fk2kA1fk2kA
FA 1fk2kA1u r6 c Uc U R nU R nU R nU[ U5 : aV UR X1 [
5 [
:w a6 US-
nU[ U5 : a" UR X1 [
5 [
:w a M6 U[ U5 : aV UR X1 [
5 [
:X a6 US-
nU[ U5 : a" UR X1 [
5 [
:X a M6 U$ )zReturn the 0-based index of the word break following p most
immediately.
p defaults to self.pos; word boundaries are determined using
self.syntax_table.r
)r^ rp r\ r r r r s r% eow
Reader.eow s
9A
KK#a&jRVVAD+ 6+ E
FA #a&jRVVAD+ 6+ E#a&jRVVAD+ 6+ E
FA #a&jRVVAD+ 6+ Er6 c Uc U R nU R nUS- nUS: a X! S:w a US- nUS: a
X! S:w a M US- $ )zaReturn the 0-based index of the line break preceding p most
immediately.
p defaults to self.pos.r
r r )r^ r\ r r r s r% bol
Reader.bol sV
9A KK Q1f
FA 1f 1u r6 c Uc U R nU R nU[ U5 : a& X! S:w a US-
nU[ U5 : a
X! S:w a M U$ )zaReturn the 0-based index of the line break following p most
immediately.
p defaults to self.pos.r r
)r^ r\ r r s r% eol
Reader.eol sQ
9A KK#a&jQTT\
FA #a&jQTT\r6 c ^ U R U S [ U R U S 5 - $ )z#Return the last x-offset for line yr r
)ry r )r ys r%
max_columnReader.max_column s. q!!$s4??1+=a+@'AAAr6 c 2 [ U R 5 S-
$ )Nr
)r ry r s r% max_rowReader.max_row s 4??#a''r6 c 8 U R c U$ U R $ )zmReturn any prefix argument that the user has supplied,
returning `default' if there is None. Defaults to 1.
)rh )r defaults r% get_argReader.get_arg s 88 Nxxr6 c U R b U( a SU R S3nOU R ( a U R ( d SnOxSU R ; a\ US:X a
U R nOUU R
( a+ XR R
S5 :X a
U R
nOU R nO U R nU R ( a$ [ R U [ R 3nU$ )z@Return what should be in the left-hand margin for line
`lineno'.z(arg: z) z(paste) r r )
rh rl rm r\ ra rc countrb r` r r BOLD_MAGENTARESET)r linenocursor_on_liner s r% r Reader.get_prompt s 88 N dhhZr*F
__T%<%< F
T[[
{ f (9(9$(? ? XXF "//09I9I8JKF
r6 c Z U R R U R 5 Xl g r )rv r ru )r itranss r% push_input_transReader.push_input_trans s" %%d&6&67!r6 c B U R R 5 U l g r )rv popru r s r% pop_input_transReader.pop_input_trans s 11557r6 c SnSnXB: ac U R U u pV[ U5 nU[ U5 - U R R : nU( a X7S-
-
nOX7S- -
nUS-
nXB: a Mc Sn U R U S n
X: aH U R U S U S:X a U S-
n M% XR U S U -
n
U S-
n US-
nX: a MH X0l g)z%Set pos according to coordinates x, yr r
N)ry r r r r r^ ) r xr r^ ir r r in_wrapped_linejcur_xs r% setpos_from_xyReader.setpos_from_xy s
e&*ooa&8 #J%F (3{+; ;t||?Q?Q QO z!z!
FA e
"1%iq!!$Q'1,Q __Q'*1- -E
FA 1HC
i r6 c F Su p/ nU R nSUs=:: a [ U R 5 :: d e eU[ U R 5 :X aR [ U R 5 S: a9 [ U R 5 S-
nU R U u pU[ U5 - U4$ U R H] u p[ U5 nU[ U5 - U R
R : nU( a US- nXT: a OU( d US-
nXE- nUS-
nM_ U[ USU 5 - U4$ )z.Return the x, y coordinates of position 'pos'.r r r
N)r^ r r\ ry r r r )r r r r r^ r r
s r% r
Reader.pos2xy s
!# hhC+3t{{++++++ #dkk" "s4??';a'?DOO$q(A&*ooa&8 #J K 00!3 3'+ #J%F (3{+; ;t||?Q?Q QO ! }"! MC
FA (7 C DS 1 22A55r6 c [ U5 U R U R U R & U =R [ U5 -
sl SU l g)z%Insert 'text' at the insertion point.TN)r r\ r^ r rj )r texts r% insert
Reader.insert1 s7 +/: DHHtxx( CI
r6 c t U R 5 U l U R R " U R 6 g)z.Move the cursor to reflect changes in self.posN)r r{ r move_cursorr s r%
update_cursorReader.update_cursor7 s% ;;= $((+r6 c ` [ USS5 ( a U R b SU l SU l gg)z6This function is called to allow post command cleanup.kills_digit_argTN)getattrrh rj r cmds r%
after_commandReader.after_command< s/ 3)4 0 0xx# !
DH 1r6 c U R R 5 SU l SU l U R SS2 SU l SU l SU l U R 5 U R ( aA U R R 5 nU R U/ 45 U R ( a M@ gg! [ a U R 5 e f = f)z~Get ready to run. Call restore when finished. You must not
write to the console in between the calls to prepare and
restore.NFr T)r preparerh rk r\ r^ rj rn r
BaseExceptionrestorer} r do_cmdr s r% r$ Reader.prepareC s LL "DH !DM ADH DJ $D
%%))--/C KKb " %%% LLN s A B1 1 C
c P U R ( d g[ XR 5 $ r )rn r. )r clss r% last_command_isReader.last_command_isX s # 0 011r6 c 8 U R R 5 g)zClean up after a run.N)r r& r s r% r& Reader.restore] s r6 c # V # [ U 5 Vs0 s H" oR [ XR 5 _M$ nn U R 5 Sv S H n[ XX# 5 M U R 5 gs snf ! S H n[ XX# 5 M U R 5 f = f7f)z0A context manager to delegate to another reader.N)rf r` ra rb rc rl )r namer r& setattrr$ )r f
prev_staterh s r% rC Reader.suspenda s >DD\J\ffgdFF 33\
J LLN H:?3 I LLN K
I:?3 I LLNs& B))A8B)A= -B)=)B&&B)c g)z2Called when a command signals that we're finished.NrB r s r% finish
Reader.finishm s r6 c ` SU- S- U l SU l U R R 5 g )Nz! r T)rf rj r beep)r rf s r% error Reader.errorq s) #:#
r6 c H U R ( a U R 5 g g r )rj refreshr s r%
update_screenReader.update_screenv s :: LLN r6 c U R ( a% U R ( a U R S S:X d gU R 5 U l U R R U R U R 5 SU l g)z#Recalculate and refresh the screen.r NF)rm r\ r rw r r= r{ rj r s r% r= Reader.refreshz sX " "t{{4;;r?d;R &&( T[[$((3
r6 c [ SUS9 [ US [ 5 ( a. U R R US [ R
5 nO [ US [ 5 ( a US nOgU" U /UQ76 nUR 5 U R U5 U R ( a U R 5 OU R 5 [ U[ R 5 ( d X l
[ UR 5 U l U R ( a+ U R" R 5 U R 5 gg)z`cmd` is a tuple of "event_name" and "event", which in the current
implementation is always just the "buffer" which happens to be a list
of single-character strings.zreceived command {cmd})r r N)r r, r_ r r invalid_commandr- dor! rj r= r digit_argrn ri r6 rk r )r r command_typecommands r% r'
Reader.do_cmd s
&C0 c!fc " " ==,,SVX5M5MNL
A
%
% q6L t*c*
7# :: LLN #x 1 122 , W^^,
== LL ! KKM r6 c U R nUc" S[ R ; a SSKJn U" U 5 Ub U" 5 U R R nU( a U" 5 g g ! [
a N3f = f! [
a g f = f)N threadingr
)install_threading_hook)r sysmodules_threading_handlerrL Exceptionr
input_hook)r r rL rQ s r% run_hooksReader.run_hooks s ,, !kS[[&@ B "4 ( %
\\,,
s# A$ A4 $
A10A14
B Bc U R ( a SU l SU l U R 5 U R R S5 U R R SS9nU( d
U( a MU gSnUR S:X a U R R U5 ODUR S:X a U R 5 O#UR S:X a U R 5 OSnU( a U R R 5 nOUR UR /nUc U( a GM gU R U5 g) zHandle a single event. Wait as long as it takes if block
is true (the default), otherwise return False if no event is
pending.re Td Fblockkeyscrollresize)
rf rj rR r wait get_eventevtru pushr= r datar' )r rW event translater s r% handle1Reader.handle1 s
88DH DJ NN LL c "LL***7E IyyE! %%e,h& h& ! &&**, yy%**-{ KK r6 c X U R R U5 U R SS9 g )NFrV )r push_charrb )r chars r% re Reader.push_char s" t$ 5 !r6 c * U R 5 Ub U" 5 U R 5 U R ( d# U R 5 U R ( d M# U R 5 U R 5 $ ! U R 5 f = f)z|Read a line. The implementation of this method also shows
how to drive Reader if you want more control over the event
loop.)r$ r= rk rb get_unicoder& )r startup_hooks r% readlineReader.readline sb
' LLNmm mmm##%
LLNDLLNs A B B Bc z U R X44- U l [ R " U R SSS9U l g )Nr rG r )rq r
r ru )r specrH s r% bind Reader.bind s5 kkd_$66 11 KK]-
r6 c 8 SR U R 5 $ )z.Return the current buffer as a unicode string.re )r r\ r s r% ri Reader.get_unicode s wwt{{##r6 )
rh r r{ rj rk ru rq rn r| rf r^ rw ry )r r )r rS )r r[ )r r_ r ztuple[str, int]r )r rg r r] )r r] r r] )r r] )r
)r r] r r] )r r] r ri r r_ )r rt r r )r r] r r] r r )r rz )r zstr | list[str]r r )r r/ r r )r* r- r ri )r r )none)rf r_ r r )r ztuple[str, list[str]]r r )T)rW ri r ri )rf z int | bytesr r )rj r~ r r_ )rn r rH r r r )r r_ )Lr0 r r r __doc__r r r r\ r^ r` ra rb rc rd rf rh rj rk rl rm r5 r rn r& rp rq ru rv rw ry r{ r| r} r r r r r r r r staticmethodr r r r r r r r r r r r r r r r! r$ r+ r& r rC r6 r: r> r= r' rR rb re rk ro ri r rB r6 r% rW rW sN 2h d3FI3CLCCCC!&t!$)V"
$r6 rW )r ro )r z dict[CommandName, type[Command]]))
__future__r rM
contextlibr dataclassesr r r _colorizer r re r r r
utilsr r r r r/ typesr r r r r r! r r r& r5 tupleplatformr r isalpharT r rW )r# s 0r% r s , #
% 0 0 . ' & , ,
G G
16a - ;
;@,&,, , ,
! ,
, , , , !, , ", , * , ' , &!," '#,$ %,& '"-E',( #),* %+,, -,. "/,0 #1,2 %3,4 !5,6 7,8 9,: ;,< =,> ?,@ A,B C,D E,F G,H I,J K,L M,N O,P Q,R 1S,T 2U,V W,Z $'sE"cN#;I#;aDy=#;I[-J\ $'sE#sO#<L#