x h_*ddlmZddlZddlmZmZmZddlmZddlm Z ddl m Z m Z m Z ddlmZmZddlmZd d d d d dddZd dZGddeejZGddeZGddeZGddeZGddeZdS)!) annotationsN)datetime timedeltatimezone)Any) deprecated)IdleModePriorityRatioLimitMode) ContainerFile)format_timedeltastopped check pendingcheckingdownload pending downloading seed pendingseeding)rcodeintreturnstrc@t|pd|S)z-Get the torrent status using new status codeszunknown status )_STATUS_NEW_MAPPINGget)rs Q/var/www/html/mejor/venv/lib/python3.11/site-packages/transmission_rpc/torrent.py get_statusr$s$  " "4 ( ( D,Dd,D,DDceZdZdZdZ dZ dZ dZ dZ dZ dZ e dd Z e dd Z e dd Ze ddZe ddZe ddZe ddZddZdS)Statuszenum for torrent statusrrrrrrrrboolc|dkS)zif torrent stoppedrselfs r#rzStatus.stopped3y  r%c|dkS)zif torrent check pendingrr*r+s r# check_pendingzStatus.check_pending8s&&r%c|dkS)zif torrent checkingrr*r+s r#rzStatus.checking=sz!!r%c|dkS)zif download pendingrr*r+s r#download_pendingzStatus.download_pendingBs)))r%c|dkS)zif downloadingrr*r+s r#rzStatus.downloadingGs}$$r%c|dkS)zif seed pendingrr*r+s r# seed_pendingzStatus.seed_pendingLs~%%r%c|dkS)z if seedingrr*r+s r#rzStatus.seedingQr-r%rc|jS)N)valuer+s r#__str__zStatus.__str__Vs zr%Nrr(rr)__name__ __module__ __qualname____doc__STOPPED CHECK_PENDINGCHECKINGDOWNLOAD_PENDING DOWNLOADING SEED_PENDINGSEEDINGpropertyrr/rr2rr5rr9r*r%r#r'r'sE!!G #M H ) K !L G  !!!X!'''X'"""X"***X*%%%X%&&&X&!!!X!r%r'cZeZdZdZeddZeddZeddZdS) FileStatz0 type for :py:meth:`Torrent.file_stats` rrc|jdS)NbytesCompletedfieldsr+s r#rKzFileStat.bytesCompleted_{+,,r%c|jdS)NwantedrLr+s r#rPzFileStat.wantedc{8$$r%c|jdS)NpriorityrLr+s r#rSzFileStat.priorityg{:&&r%Nrr)r<r=r>r?rGrKrPrSr*r%r#rIrIZs~---X-%%%X%'''X'''r%rIcreZdZdZed dZed dZed dZed dZd S) Trackerz. type for :py:attr:`Torrent.trackers` rrc|jdSNidrLr+s r#rZz Tracker.idq{4  r%rc|jdSNannouncerLr+s r#r^zTracker.announceurTr%c|jdSNscraperLr+s r#razTracker.scrapeyrQr%c|jdSNtierrLr+s r#rdz Tracker.tier}{6""r%NrUr;) r<r=r>r?rGrZr^rardr*r%r#rWrWls!!!X!'''X'%%%X%###X###r%rWceZdZdZed"dZed"dZed#dZed"dZed$d Z ed$d Z ed#d Z ed$d Z ed"dZ ed#dZed"dZed$dZed"dZed$dZed#dZed"dZed$dZed"dZed$dZed"dZed"dZed"dZed"dZed#dZed"dZed#dZed"d Zd!S)% TrackerStatsz3 type for :py:attr:`Torrent.tracker_stats` rrc|jdSrYrLr+s r#rZzTrackerStats.idr[r%c|jdS)N announceStaterLr+s r#announce_statezTrackerStats.announce_state{?++r%rc|jdSr]rLr+s r#r^zTrackerStats.announcerTr%c|jdS)N downloadCountrLr+s r#download_countzTrackerStats.download_countrlr%r(c|jdS)N hasAnnouncedrLr+s r# has_announcedzTrackerStats.has_announced{>**r%c|jdS)N hasScrapedrLr+s r# has_scrapedzTrackerStats.has_scraped{<((r%c|jdS)NhostrLr+s r#rzzTrackerStats.hostrer%c|jdS)NisBackuprLr+s r# is_backupzTrackerStats.is_backuprTr%c|jdS)NlastAnnouncePeerCountrLr+s r#last_announce_peer_countz%TrackerStats.last_announce_peer_count{233r%c|jdS)NlastAnnounceResultrLr+s r#last_announce_resultz!TrackerStats.last_announce_result{/00r%c|jdS)NlastAnnounceStartTimerLr+s r#last_announce_start_timez%TrackerStats.last_announce_start_timerr%c|jdS)NlastAnnounceSucceededrLr+s r#last_announce_succeededz$TrackerStats.last_announce_succeededrr%c|jdS)NlastAnnounceTimerLr+s r#last_announce_timezTrackerStats.last_announce_time{-..r%c|jdS)NlastAnnounceTimedOutrLr+s r#last_announce_timed_outz$TrackerStats.last_announce_timed_outs{122r%c|jdS)NlastScrapeResultrLr+s r#last_scrape_resultzTrackerStats.last_scrape_resultrr%c|jdS)NlastScrapeStartTimerLr+s r#last_scrape_start_timez#TrackerStats.last_scrape_start_time{011r%c|jdS)NlastScrapeSucceededrLr+s r#last_scrape_succeededz"TrackerStats.last_scrape_succeededrr%c|jdS)NlastScrapeTimerLr+s r#last_scrape_timezTrackerStats.last_scrape_timerNr%c|jdS)NlastScrapeTimedOutrLr+s r#last_scrape_timed_outz"TrackerStats.last_scrape_timed_outrr%c|jdS)N leecherCountrLr+s r# leecher_countzTrackerStats.leecher_countrtr%c|jdS)NnextAnnounceTimerLr+s r#next_announce_timezTrackerStats.next_announce_timerr%c|jdS)NnextScrapeTimerLr+s r#next_scrape_timezTrackerStats.next_scrape_timerNr%c|jdS)N scrapeStaterLr+s r# scrape_statezTrackerStats.scrape_state{=))r%c|jdSr`rLr+s r#razTrackerStats.scraperQr%c|jdS)N seederCountrLr+s r# seeder_countzTrackerStats.seeder_countrr%c|jdS)NsitenamerLr+s r# site_namezTrackerStats.site_namerTr%c|jdSrcrLr+s r#rdzTrackerStats.tierrer%NrUr;r:) r<r=r>r?rGrZrkr^rprsrwrzr}rrrrrrrrrrrrrrrrarrrdr*r%r#rgrgs~!!!X!,,,X,'''X',,,X,+++X+)))X)###X#'''X'444X4111X1444X4444X4///X/333X3///X/222X2222X2---X-111X1+++X+///X/---X-***X*%%%X%***X*'''X'###X###r%rgceZdZdZdufd ZedvdZedwd Zedwd Zedwd Z edwd Z ee d dwdZ edxdZ edydZedwdZedvdZedwdZedvdZedwdZedvdZedvdZedzdZed{dZedvdZedwdZed|d!Zed|d"Zed}d$Zd~d&Zedd(Zedwd)Zedvd*Z edvd+Z!edzd,Z"edzd-Z#edzd.Z$edzd/Z%edd1Z&edvd2Z'edwd3Z(ed{d4Z)edvd5Z*edxd6Z+edvd7Z,edvd8Z-edvd9Z.edvd:Z/edvd;Z0edvd<Z1edxd=Z2edxd>Z3edwd?Z4edvd@Z5edvdAZ6edwdBZ7edvdCZ8edvdDZ9edvdEZ:edxdFZ;edvdGZedvdJZ?eddLZ@eddMZAeddOZBedvdPZCedwdQZDedvdRZEedvdSZFedzdTZGedxdUZHeddWZIeddXZJedvdYZKedvdZZLedwd[ZMedd]ZNedzd^ZOedzd_ZPedzd`ZQedzdaZRedzdbZSedzdcZTedzddZUedxdeZVedxdfZWed{dgZXed{dhZYed{diZZeddkZ[dwdlZ\edydmZ]eddoZ^edxdpZ_eddrZ`dwdsZadwdtZbxZcS)Torrentz Torrent is a class holding the data received from Transmission regarding a bittorrent transfer. Warnings: setter on Torrent's properties has been removed, please use :py:meth:`Client.change_torrent` instead rMdict[str, Any]crd|vrtdt|dS)NrZzgTorrent object requires field 'id', you need to add 'id' in your 'arguments' when calling 'get_torrent'rL) ValueErrorsuper__init__)r,rM __class__s r#rzTorrent.__init__sI v  V  '''''r%rrc|jdSrYrLr+s r#rZz Torrent.idr[r%rc|jdS)NnamerLr+s r#rz Torrent.name rer%c|jdSz8Torrent info hash string, can also be used as Torrent ID hashStringrLr+s r#rzTorrent.hashString {<((r%c|jdSrrLr+s r# hash_stringzTorrent.hash_stringrr%c|jSzalias of ``hashString``rr+s r# info_hashzTorrent.info_hashs r%z9this is a typo, do not use this. use `.info_hash` insteadc|jSrrr+s r# into_hashzTorrent.into_hashs r%floatc|j}td|jdD}|j|z}t |r||z dzndS)zAvailability in percentc3&K|] }|dV dS)rKNr*.0xs r# z$Torrent.available..&s(OO+,OOOOOOr% fileStatsdr) total_sizesumrMdesired_availabler)r, bytes_all bytes_done bytes_avails r# availablezTorrent.available"s]O OOdk+6NOOOOO ,z9  HkI-44qIIIr%r c6t|jdS)z!this torrent's bandwidth prioritybandwidthPriorityr rMr+s r#bandwidth_priorityzTorrent.bandwidth_priority/s $78999r%c|jdS)NcommentrLr+s r#rzTorrent.comment4{9%%r%c|jdS)z Byte count of all the corrupt data you've ever downloaded for this torrent. If you're on a poisoned torrent, this number can grow very large. corruptEverrLr+s r# corrupt_everzTorrent.corrupt_ever8{=))r%c|jdS)NcreatorrLr+s r#rzTorrent.creatorArr%c|jdS)z Byte count of all the piece data we want and don't have yet, but that a connected peer does have. [0...leftUntilDone] desiredAvailablerLr+s r#rzTorrent.desired_availableJs {-..r%c|jdS)zrThe download directory. :available: transmission version 1.5. :available: RPC version 4. downloadDirrLr+s r# download_dirzTorrent.download_dirRrr%c|jdS)z Byte count of all the non-corrupt data you've ever downloaded for this torrent. If you deleted the files and downloaded a second time, this will be 2*totalSize. downloadedEverrLr+s r#downloaded_everzTorrent.downloaded_ever[s {+,,r%c|jdS)N downloadLimitrLr+s r#download_limitzTorrent.download_limitcrlr%r(c|jdS)NdownloadLimitedrLr+s r#download_limitedzTorrent.download_limitedgs{,--r%rcVtj|jdtjS)a The last time during this session that a rarely-changing field changed -- e.g. any tr_torrent_metainfo field (trackers, filenames, name) or download directory. RPC clients can monitor this to know when to reload fields that rarely change. editDater fromtimestamprMrutcr+s r# edit_datezTorrent.edit_dateks %dk*&=x|LLLr%c|jdS)z/``0`` for fine task, non-zero for error torrenterrorrLr+s r#rz Torrent.errorus{7##r%c|jdS)zempty string for fine task errorStringrLr+s r# error_stringzTorrent.error_stringzs{=))r%timedelta | NonecL|jd}|dkrt|SdS)a the "eta" as datetime.timedelta. If downloading, estimated the ``timedelta`` left until the torrent is done. If seeding, estimated the ``timedelta`` left until seed ratio is reached. raw `eta` maybe negative: - `-1` for ETA Not Available. - `-2` for ETA Unknown. https://github.com/transmission/transmission/blob/3.00/libtransmission/transmission.h#L1748-L1749 etarsecondsNrMrr,rs r#rz Torrent.etas/k%  !88S))) )tr%cL|jd}|dkrt|SdS)NetaIdlerrr )r,vs r#eta_idlezTorrent.eta_idles- K " 66Q''' 'tr% int | Nonec|jdS)Nz file-countrLr+s r# file_countzTorrent.file_countrxr% list[File]c g}d|jvrr|jd}tt|}|jd}|jd}|dt ||||D|S)a Get list of files for this torrent. Note: The order of the files is guaranteed. The index of file object is the id of the file when calling :py:meth:`transmission_rpc.Client.change_torrent` .. code-block:: python from transmission_rpc import Client torrent = Client().get_torrent(0) for file in torrent.get_files(): print(file.id) files prioritiesrPc 3K|]J\}}}}tt|t||d|d|d|VKdS)lengthrrK)selectedrSsizer completedrZN)r r(r )rrZfile raw_priority raw_selecteds r#rz$Torrent.get_files..s  9BlL!,//%l33hf"#34       r%)rMrangelenextendzip)r,resultrindicesrrPs r# get_fileszTorrent.get_filess$  dk ! !K(ECJJ''G\2J[*F MM  =@PZ\bz&Torrent.file_stats..s#EEEq"""EEEr%rrLr+s r# file_statszTorrent.file_statss FEDK ,DEEEEr%c.|ddS)Ngroup)r"r+s r#r-z Torrent.groupsxx$$$r%c|jdS)z Byte count of all the partial piece data we have for this torrent. As pieces become complete, this value may decrease as portions of it are moved to "corrupt" or "haveValid". haveUncheckedrLr+s r#have_uncheckedzTorrent.have_uncheckeds{?++r%c|jdS)zFByte count of all the checksum-verified data we have for this torrent. haveValidrLr+s r# have_validzTorrent.have_valids{;''r%c|jdS)z)true if session upload limits are honoredhonorsSessionLimitsrLr+s r#honors_session_limitszTorrent.honors_session_limits{011r%c|jdS)N isFinishedrLr+s r# is_finishedzTorrent.is_finishedrxr%c|jdS)N isPrivaterLr+s r# is_privatezTorrent.is_private{;''r%c|jdS)N isStalledrLr+s r# is_stalledzTorrent.is_stalledr?r% list[str]c|jdS)NlabelsrLr+s r#rEzTorrent.labelsrQr%c|jdS)z Byte count of how much data is left to be downloaded until we've got all the pieces that we want. [0...tr_stat.sizeWhenDone] leftUntilDonerLr+s r#left_until_donezTorrent.left_until_dones {?++r%c|jdS)N magnetLinkrLr+s r# magnet_linkzTorrent.magnet_linkrxr%cVtj|jdtjS)NmanualAnnounceTimerr+s r#manual_announce_timezTorrent.manual_announce_times%dk2F&GVVVr%c|jdS)NmaxConnectedPeersrLr+s r#max_connected_peerszTorrent.max_connected_peers{.//r%c6t|jdS)z How much of the metadata the torrent has. For torrents added from a torrent this will always be 1. For magnet links, this number will from from 0 to 1 as the metadata is downloaded. Range is [0..1] metadataPercentCompleterrMr+s r#metadata_percent_completez!Torrent.metadata_percent_completesT[!:;<<**r%c|jdS)zupload rate (B/s) rateUploadrLr+s r# rate_uploadzTorrent.rate_upload_rr%c6t|jdS)NrecheckProgressrUr+s r#recheck_progresszTorrent.recheck_progressdsT[!23444r%c|jdS)NsecondsDownloadingrLr+s r#seconds_downloadingzTorrent.seconds_downloadinghrr%c|jdS)NsecondsSeedingrLr+s r#seconds_seedingzTorrent.seconds_seedinglrNr%c|jdS)N seedIdleLimitrLr+s r#seed_idle_limitzTorrent.seed_idle_limitprlr%c|jdS)N sizeWhenDonerLr+s r#size_when_donezTorrent.size_when_doneyrtr% list[Tracker]c0d|jdDS)ztrackers of torrentc.g|]}t|Sr))rWrs r#r*z$Torrent.trackers..s#CCCaq!!!CCCr%trackersrLr+s r#rzTorrent.trackers}s DC4;z+BCCCCr%cTd|jdDS)zlist of str of announce URLscg|]}||Sr*r*rs r#r*z(Torrent.tracker_list..sHHHaaHHHHr% trackerList)rM splitlinesr+s r# tracker_listzTorrent.tracker_lists,IH4;}5@@BBHHHHr%list[TrackerStats]c0d|jdDS)z.s#LLL1 A&&&LLLr% trackerStatsrLr+s r# tracker_statszTorrent.tracker_statss ML N0KLLLLr%c|jdS)N totalSizerLr+s r#rzTorrent.total_sizer?r%c|jdS)z torrent file location on transmission server Examples -------- /var/lib/transmission-daemon/.config/transmission-daemon/torrents/00000000000000000000000000.torrent torrentFilerLr+s r# torrent_filezTorrent.torrent_files{=))r%c|jdS)N uploadedEverrLr+s r# uploaded_everzTorrent.uploaded_everrtr%c|jdS)N uploadLimitrLr+s r# upload_limitzTorrent.upload_limitrr%c|jdS)N uploadLimitedrLr+s r#upload_limitedzTorrent.upload_limitedrlr%c6t|jdS)N uploadRatiorUr+s r# upload_ratiozTorrent.upload_ratiosT[/000r% list[int]c|jdS)zFif files are wanted, sorted by file index. 1 for wanted 0 for unwantedrPrLr+s r#rPzTorrent.wanted{8$$r%c|jdS)NwebseedsrLr+s r#rzTorrent.webseedsrTr%c|jdS)z/Number of webseeds that are sending data to us.webseedsSendingToUsrLr+s r#webseeds_sending_to_uszTorrent.webseeds_sending_to_usr8r%c|jdSzGet the torrent statusstatusrLr+s r#_statuszTorrent._statusrr%c6t|jdSr)r$rMr+s r# _status_strzTorrent._status_strs$+h/000r%r'c*t|jS)a Returns the torrent status. Is either one of 'check pending', 'checking', 'downloading', 'download pending', 'seeding', 'seed pending' or 'stopped'. The first two is related to verification. Examples: .. code-block:: python torrent = Torrent() torrent.status.downloading torrent.status == 'downloading' )r'rr+s r#rzTorrent.statuss d&'''r%c|jdkS)Nrrr+s r#rzTorrent.stopped|q  r%c|jdkS)Nrrr+s r#r/zTorrent.check_pendingrr%c|jdkS)Nrrr+s r#rzTorrent.checkingrr%c|jdkS)Nrrr+s r#r2zTorrent.download_pendingrr%c|jdkS)Nrrr+s r#rzTorrent.downloadingrr%c|jdkS)Nrrr+s r#r5zTorrent.seed_pendingrr%c|jdkS)Nrrr+s r#rzTorrent.seedingrr%c td|jdzdS#t$rV |jd}|jd}td||z zt|z dcYS#t$rYYdSwxYwwxYw)z/ download progress in percent. gY@rkrrrGg)roundrMKeyErrorrZeroDivisionError)r,rlefts r#progresszTorrent.progresss %$+m"<2{?3etd{3eDkkAAFFFFF$   sss   s, B?A-*B- A<7B;A<<Bc6t|jdS)z( upload/download ratio. rrUr+s r#ratioz Torrent.ratios T[/000r%cVtj|jdtjS)aW The last time we uploaded or downloaded piece data on this torrent. the attribute ``activityDate`` as ``datetime.datetime`` in **UTC timezone**. .. note:: raw ``activityDate`` value could be ``0`` for never activated torrent, therefore it can't always be converted to local timezone. activityDaterr+s r# activity_datezTorrent.activity_dates %dk.&A8<PPPr%cVtj|jdtjS)z!When the torrent was first added. addedDaterr+s r# added_datezTorrent.added_date %dk+&> MMMr%cVtj|jdtjS)zEraw field ``startDate`` as ``datetime.datetime`` in **utc timezone**. startDaterr+s r# start_datezTorrent.start_daterr%datetime | Nonecx|jd}|dkrdStj|S)zUthe attribute "doneDate" as datetime.datetime. returns None if "doneDate" is invalid.doneDaterN)rMrr astimezone)r, done_dates r#rzTorrent.done_date s=K +  >>4%i00;;===r%cv|jd}|dkrdS|dkrdStt|S)z Returns the attribute *eta* formatted as a string. * If eta is -1 the result is 'not available' * If eta is -2 the result is 'unknown' * Otherwise eta is formatted as ::. rz not availableunknownr)rMrrr s r# format_etazTorrent.format_eta*sEk%  "99"? "999 # 6 6 6777r%c6t|jdS)zq Bandwidth priority as string. Can be one of 'low', 'normal', 'high'. This is a mutator. rrr+s r#rSzTorrent.priorityCs $78999r%r c6t|jdS)z Seed idle mode as string. Can be one of 'global', 'single' or 'unlimited'. * global, use session seed idle limit. * single, use torrent seed idle limit. See seed_idle_limit. * unlimited, no seed idle limit. seedIdleMode)r rMr+s r#seed_idle_modezTorrent.seed_idle_modeLs N3444r%c6t|jdS)zi Torrent seed ratio limit as float. Also see seed_ratio_mode. This is a mutator. seedRatioLimitrUr+s r#seed_ratio_limitzTorrent.seed_ratio_limitWsT[!12333r%r c6t|jdS)a Seed ratio mode as string. Can be one of 'global', 'single' or 'unlimited'. * global, use session seed ratio limit. * single, use torrent seed ratio limit. See seed_ratio_limit. * unlimited, no seed ratio limit. seedRatioMode)r rMr+s r#seed_ratio_modezTorrent.seed_ratio_mode`sdk/:;;;r%cd|jdS)Nz%rr+s r#__repr__zTorrent.__repr__ksKtKKKKr%cd|jdS)Nzr?rrGrZrrrrrrrrrrrrrrrrrrrrrrr%r+r-r1r4r7r;r>rBrErHrKrNrQrVrXrZr]r`rcrfrirlrnrqrtrvryr|rrrrrrrrrrrrrrrrPrrrrrrr/rr2rr5rrrrrrrrrSrrrrr9 __classcell__)rs@r#rrs ((((((!!!X!###X#)))X))))X)XZKLLMLXJJJXJ:::X:&&&X&***X*&&&X&///X/***X*---X-,,,X,...X.MMMXM$$$X$***X*X&X )))X)$$$$LFFFXF%%%X%,,,X,(((X(222X2)))X)(((X((((X(%%%X%,,,X,)))X)WWWXW000X0===X=)))X)$$$X$---X-(((X( 111X1///X/555X5111X1%%%X%)))X)(((X(000X0,,,X,+++X+)))X)555X5111X1---X-,,,X,+++X+DDDXDIIIXIMMMXM(((X(***X*+++X+***X*,,,X,111X1%%%X%'''X'222X2%%%X%111X1(((X("!!!X!!!!X!!!!X!!!!X!!!!X!!!!X!!!!X!   X 111X1  Q Q QX QNNNXNNNNXN>>>X> 8 8 8 82:::X:555X5444X4<<<X<LLLL;;;;;;;;r%r)rrrr) __future__renumrrrtypingrtyping_extensionsrtransmission_rpc.constantsr r r transmission_rpc.typesr r transmission_rpc.utilsrr!r$rEnumr'rIrWrgrr*r%r#rs"""""" 2222222222((((((IIIIIIIIII22222222333333EEEE :::::S$):::z'''''y'''$#####i###,o#o#o#o#o#9o#o#o#d{ ;{ ;{ ;{ ;{ ;i{ ;{ ;{ ;{ ;{ ;r%