/usr/lib/rads/venv/lib/python3.13/site-packages/restic/__pycache__
Edit: /usr/lib/rads/venv/lib/python3.13/site-packages/restic/__pycache__/data.cpython-313.pyc (22258B)
jOB S r SSKJrJrJrJr SSKrSSKJr SSK
r
SSK J r SSK
Jr SSKJr SSKJr SS KJrJr SS
KJr \( a S S KJr " S
S\5 r " S S\5 r\" SS9 " S S5 5 r " S S5 r S\ S\ 4S jr " S S5 r \" SS9 " S S 5 5 r! " S S \!5 r" " S S!\!5 r# " S" S#5 r$ " S$ S%\$5 r% " S& S'\$5 r&\S( r'\(\'\\)\ \)\ 4 4 r*\(\'\\)\$ \)\% 4 4 r+g))zRestic dataclasses )LiteralUnion TypedDict
TYPE_CHECKINGN)unquote)PurePath) Generator)datetime) dataclass)CompletedProcessrun)Proc )Resticc f \ rS rSr% Sr\\S' \\S' \S \S' \ \S' \\S' \
\\4 \S ' S
r g ) SQLBackupGroupDict z+Return format of SQLBackupGroup.serialize()timeusermysqlpgsqltypefailoverfindbs N) __name__
__module__ __qualname____firstlineno____doc__int__annotations__strr booldict__static_attributes__r >/usr/lib/rads/venv/lib/python3.13/site-packages/restic/data.pyr r s3 5
I
I
"
##N H
c3h r) r c R \ rS rSr% Sr\\S' \\S' \\S' \ S \S' \\S' S r
g
)
BackupDict z#Return format of Backup.serialize()r snapr )homedirdirspkgacctr r r N) r r r r! r" r& r$ r% r# r r( r r) r* r, r, s% -N
I
I
.
//
Ir) r, T)initc F \ rS rSr% SrSr\\S' \\S' \\S' \\S' Srg )
ResticRepo' zDataclass holding restic/S3 keys and bucket name
Args:
bucket(str): bucket name
restic_pass(str): restic password
access_key(str): S3 access key
secret_key(str): S3 access key
resticbucket restic_pass
access_key
secret_keyr N)r r r r! r" r% r$ r( r r) r* r4 r4 ' s# J KOOr) r4 c \ rS rSrSrSrSSS\4S jrS rS\\ - S \
\ S
4S jr S\\ - S \
\ S
S S 4 4S
jrS S SS.S\
\\ - S - S\
\\ - S - S\\ - S S4S jjrS\\ - S S4S jrSSS.S\S\4S jjrS rg ) Snapshot: aj Represents a restic snapshot
Attributes:
restic (Restic): restic instance this snapshot was found in
id (str): short snapshot ID
tags (list[str]): tags supplied when the snapshot was created
datetime (datetime.datetime): backup creation time
timestamp (int): backup creation time
paths (list[str]): top level paths the snapshot contains
r6 r datac ^ Xl [ US 5 U l UR S/ 5 Vs/ s H n[ U[
5 PM snU l [ R " US 5 U l [ U R R 5 5 U l
[ US 5 U l g s snf )Nidtagsr paths)
r6 r% r@ get
_tag_quote url_unquoterA r
fromisoformatr# timestamplistrB )selfr6 r> xs r* __init__Snapshot.__init__H s d4j/040D
0D1Jq+ &0D
#+"8"8f "F
T]] 4 4 67 $T'] 3
s B*c " SU R S3$ )Nz Snapshot<>)r@ rI s r* __repr__Snapshot.__repr__T s 477)1%%r) pathreturnSnapFileSnapDirc 4 U R R XS9$ )aH Returns a list of files/dirs in this snapshot
Args:
path (str | PurePath): full path inside the snapshot to list the
contents of
Raises:
ValueError: requested path was not a full path
ResticError: Any error listing snapshot contents from restic
Returns:
list[SnapFile | SnapDir]: files or directories
r. rR )r6 listdirrI rR s r* rY Snapshot.listdirW {{"""88r) Nc 4 U R R XS9$ )aO Iterates files/dirs in this snapshot
Args:
path (str | PurePath): full path inside the snapshot to list the
contents of
Raises:
ValueError: requested path was not a full path
ResticError: Any error listing snapshot contents from restic
Yields:
Generator[SnapFile | SnapDir, None, None]: files or directories
rX )r6 scandirrZ s r* r^ Snapshot.scandiri r\ r) /includesexcludestargetrb rc rd ResticCmdc 6 U R R XX#S9$ )ae Calls a ResticCmd to restore from this snapshot
Args:
includes (list[str | PurePath], optional): --include paths
excludes (list[str | PurePath], optional): --exclude paths
target (str | PurePath): base directory prefix to restore to.
Defaults to '/', which restores to the original path
Returns:
ResticCmd: restic command executor
ra )r6 restore)rI rb rc rd s r* rg Snapshot.restore{ s% $ {{"" h #
r) filenamec 8 U R R X5 $ )zCrafts a ResticCmd to dump a file from this snapshot
Args:
filename (str | PurePath): filename to retrieve
Returns:
ResticCmd: restic command executor
)r6 dump)rI ri s r* rk
Snapshot.dump s {{ //r) FTpruneno_limrn ro c J U R R U R XS9$ )aC Run restic forget on this snapshot
Args:
prune (bool): whether to automatically run prune if at
least one snapshot was removed. Defaults to False
no_lim (bool): do not CPU limit the command as it runs regardless
of the lim arg in Restic
Raises:
ResticError: if the restic forget command fails
rm )r6 forgetr@ )rI rn ro s r* rq Snapshot.forget s" {{!!$''!FFr) )r
r@ rB r6 rA rG )r r r r! r" r' rK rP r% r rH r rY r r^ rg rk r& rq r( r r) r* r< r< : s J
4(
4$
4&9(N9
e)* +9$9(N9 5./t; <9* 1504!$
sX~&-
sX~&-
h
, 0S8^ 0 0 ',D Gt GT G Gr) r< tagrS c V SU SS ; a U R SSS9u p#U SU" U5 3$ U $ )N:r )maxsplit)split)rs funcprefixsuffixs r* rD rD s>
c!Bi 334<.)) Jr) c . \ rS rSrSrSr SS jrS\4S jr\R \R SSSSSS .S
\ S- S \ S- S \ S- S
\S- S\ S\ \
- S- S\ S\4S jjrS r\R \R SSS.S
\ S- S \ S- S \ S- S\ S\4
S jjrSrg)re zReturn type of Restic's build() function. Can be cast to a str() to
get a shell-escaped representation of the command.
Attributes:
.cmd (list[str]): Popen arguments
r6 c Xl X l g Ncmdr6 )rI r r6 s r* rK ResticCmd.__init__ s
r) rS c B [ R " U R 5 $ r )shlexjoinr rO s r* __str__ResticCmd.__str__ s zz$((##r) NF)stdoutstderrstdininputchecktimeoutro r r r r r r ro c
J UR SU R R UUUSUS.5 Uc X8S' OXHS' U( d U R R c [ U R
40 UD6$ [ R " U R
4SU R R 0UD6$ )a Execute the restic command and return a CompletedProcess
Args:
stdout (int | None): stdout redirection. Defaults to DEVNULL
stderr (int | None): stderr redirection. Defaults to PIPE (because
ResticError will need this if you raise it using the result)
stdin (int | None): stdin redirection. Defaults to None
input (bytes | str | None): text to send to stdin. Do not use the
stdin= kwarg if you use input=
timeout (int | float | None): optional command timeout
check (bool): if set True, raise CalledProcessError on non-zero
exit codes. Defaults to False
no_lim (bool): do not CPU limit the command as it runs regardless
of the lim arg in Restic
Raises:
CalledProcessError: program exited with a non-zero exit code
and check=True was specified
TimeoutExpired: program took too long to execute and timeout=
was specified
Returns:
CompletedProcess: process results
UTF-8F)encodingenvr r r shellr r r lim)updater6 r r s_runr r r
) rI r r r r r r ro kwargss r* r
ResticCmd.run s H
#{{ "
= #7O #7O T[[__,,V, ,xx@dkkoo@@@r) c [ R R U R R 5 [ R
" U R S U R 5 g)zWruns os.execv with the given restic args/env, replacing the
current process with resticr N)osenvironr r6 r execvr rO s r* r ResticCmd.execv s8
$++//*
!dhh'r) )r r r ro c UR SU R R UUUSS.5 U( d U R R c [ U R
4SS0UD6$ [ U R
4SU R R 0UD6$ )a Start and return the command
Args:
stdout (int | None): stdout redirection. Defaults to DEVNULL
stderr (int | None): stderr redirection. Defaults to PIPE (because
ResticError will need this if you raise it using the result)
stdin (int | None): stdin redirection. Defaults to None
no_lim (bool): do not CPU limit the command as it runs regardless
of the lim arg in Restic
Returns:
cproc.Proc: Running process
r F)r r r r r r Nr )r r6 r r r r )rI r r r ro r s r* procResticCmd.proc s{ ,
#{{
T[[__,5d5f5 5DHH<$++//
>'* *~~h''r) c U R $ r )rR rO s r* r SnapPath.__str__E s yyr) r ) r r r r! r" r< r$ r% r# r r r( r r) r* r r + sZ # J
I
I
I H H
*t(3 (
r) r c & \ rS rSrSrSrSS jrSrg)rU iI a A remote file in a restic snapshot
Attributes:
snapshot (Snapshot): snapshot instance this file was found in
restic (Restic): restic instance this file was found in
name (str): base filename
type (str): "file"
path (str): full path
uid (int): original UID of the file when backed up
gid (int): original GID of the file when backed up
mode (int | None): original file mode when backed up
permissions (str | None): original file permissions when backed up
r6 c ^ U R R U R U R S9$ zaCrafts a ResticCmd to dump this file's contents
Returns:
ResticCmd: restic command executor
)r. ri )r6 rk r rR rO s r* rk
SnapFile.dumpZ s& {{ T]]TYY GGr) r N)rS re )r r r r! r" rk r( r r) r* rU rU I s JHr) rU c V \ rS rSrSrSrS\\S 4S jrS\\S SS4 4S jr S r
g)
rV ic a A remote directory in a restic snapshot
Attributes:
snapshot (Snapshot): snapshot instance this directory was found in
restic (Restic): restic instance this directory was found in
name (str): base directory name
type (str): "dir"
path (str): full path
uid (int): original UID of the directory when backed up
gid (int): original GID of the directory when backed up
mode (int): original directory mode when backed up
permissions (str | None): original directory permissions when backed up
r6 rS rT c ^ U R R U R U R S9$ )zList files/dirs found in this path
Raises:
ResticError: Any error listing snapshot contents from restic
Returns:
list[SnapFile | SnapDir]: files or directories
rX )r6 rY r rR rO s r* rY SnapDir.listdirt & {{""
DII"FFr) Nc ^ U R R U R U R S9$ )zIterates over files/dirs found in this path
Raises:
ResticError: Any error listing snapshot contents from restic
Yields:
Generator[SnapFile | SnapDir, None, None]: files or directories
rX )r6 r^ r rR rO s r* r^ SnapDir.scandir r r) r ) r r r r! r" rH r rY r r^ r( r r) r* rV rV c sG J Ge$9 :; G G5)>#?t#KL Gr) rV c f \ rS rSrSrSrS\4S jrS\4S jr\S\S\ S\ 4S j5 r
S\ 4S
jr S r
g )
Backupi a Object representing a restic snapshot formatted in a way specific to
backups3.x's backup-runner.
Args:
snap (Snapshot): snapshot from Restic.snapshots()
Raises:
KeyError: snapshot did not have required tags (created manually?)
ValueError: __new__() tried to return a sql subclass, but its start:
timestamp tag was invalid
Returns:
(Backup, SQLBackupGroup, SQLBackupItem): depending on the type of
backups 3.x snapshot
Attributes:
snap (Snapshot): snapshot object
failover (bool): whether this is a failover copy
user (str): cPanel username or root
type (str): mysql or pgsql
time (int): creation timestamp
r6 r. c [ R US5 S; aB SUR ; a [ R [
5 $ [ R [ 5 $ [ R U 5 $ )Nr r finished)r get_labelrA r r SQLBackupGroup
SQLBackupItem)r r. s r* r Backup.__new__ sQ D& )-? ?TYY& ~~n55>>-0 0~~c""r) c Xl SUR ; U l U R US5 U l U R US5 U l U R
S; a! [
U R US5 5 U l g UR U l g )Nr r r r start) r. rA r r r r r# r rG )rI r. s r* rK Backup.__init__ sj "dii/
NN40 NN40 99* *DNN4 9:DI DIr) r rS c U S3nU R H0 nUR U5 ( d M UR SS5 S s $ [ U5 e)zSearch for the value of a tag if read in the format 'name:value'
Args:
snap (Snapshot): snapshot object
name (str): name to search for
Raises:
KeyError: if the label was not found
Returns:
str: the value portion of the 'name:value' tag
ru r )rA
startswithrx KeyError)r. r rz rs s r* r Backup.get_label sN 699C~~f%%yya(++ tn r) c U R R U R U R U R U R
S.nU$ )z9Used internally by Restic.get_backups() if serialize=True)r. r r r r )r. r@ r r r r )rI rets r* serializeBackup.serialize s9 IILLIIIIII
r) )r r. r r r N)r r r r! r" r< r rK staticmethodr% r r' r r( r r) r* r r s[ . J#8 #'X ' & 4 r) r c L ^ \ rS rSrSrSrS\4U 4S jjrS\4U 4S jjrSr U =r
$ ) r i au Holds a group of SQL snapshots created by imh-backup-client, representing
one sql backup run. Backups 3.x stores each database in its own snapshot,
then artificially groups them together as one.
Attributes:
snap (Snapshot): snapshot object for the snapshot signifying the
backup's completion. This snapshot contains no SQL data. See the
``.dbs`` attribute instead for that
failover (bool): whether this is a failover copy
user (str): cPanel username or root
type (str): mysql or pgsql
time (int): creation timestamp
dbs (dict[str, SQLBackupItem]): database names mapped to SQLBackupItems
r6 r. c 2 > [ TU ] U5 0 U l g r )superrK r rI r. __class__s r* rK SQLBackupGroup.__init__ s
-/r) rS c > [ TU ] 5 nUR S5 US' U R R 5 VVs0 s H u p#X#R 5 _M snnUS' U$ s snnf )5Used internally by Restic.get_backups(serialize=True)r. r r )r r popr items)rI r kvr s r* r SQLBackupGroup.serialize s\ g !WWV_E
3788>>3CD3C41a &3CDE
Es A&)r ) r r r r! r" r< rK r r r(
__classcell__r s @r* r r s-
J0X 0- r) r c T ^ \ rS rSrSrSrS\4U 4S jjrS\4S jrS\ 4S jr
S r U =r $ )
r i a& Represents one SQL snapshot in a ``SQLBackupGroup``.
Attributes:
snap (Snapshot): snapshot object
failover (bool): whether this is a failover copy
user (str): cPanel username or root
type (str): mysql or pgsql
time (int): creation timestamp
dbname (str): database name
r6 r. c Z > [ TU ] U5 [ R US5 U l g )Ndbname)r rK r r r r s r* rK SQLBackupItem.__init__ s$
&&tX6 r) rS c r U R R R U R U R S9$ r )r. r6 rk r rO s r* rk SQLBackupItem.dump s, yy $$$))dkk$JJr) c . U R R $ )r )r. r@ rO s r* r SQLBackupItem.serialize s yy||r) )r )
r r r r! r" r< rK re rk r' r r( r r s @r* r r s: J7X 7Ki K 4 r) r )r r r/ r0 r1 ),r" typingr r r r r urllib.parser rE r pathlibr collections.abcr r
dataclassesr
subprocessr r
r cprocr r r r, r4 r< r% rD re r rU rV r r r
BakTypeStrr' rH UserBackupDicts UserBackupsr r) r* r sL ; ; / % ! 5 $nG nGbC # v= v=r :Hx H4%Gh %GPH HVV < F > C
D
d:&-?(@@AA :uT&\43G%G HHI r)